DOCM to PGM Converter

PGM (Portable Graymap) is the grayscale member of the Netpbm image format family, created by Jef Poskanzer in 1988 as part of the Pbmplus toolkit for Unix systems. PGM stores single-channel intensity images where each pixel holds a gray value from 0 (black) to a user-specified maximum (typically 255 for 8-bit or 65535 for 16-bit). The format exists in ASCII (magic number P2), where pixel values are written as decimal text numbers separated by whitespace, and binary (magic number P5), where values are stored as raw bytes. Both variants begin with a header specifying the magic number, width, height, and maximum gray value. PGM was designed as the grayscale intermediate in Netpbm's convert-process-convert pipeline philosophy: source images from any format are converted to PGM, processed using Netpbm's extensive command-line tool library, then converted to the target format. One advantage is format transparency — the ASCII variant makes image data directly readable by humans and trivially processable by text tools like awk and grep, invaluable for debugging and education. The scientific and computer vision community's adoption is another strength: PGM's straightforward single-channel representation makes it a natural format for image analysis algorithms, and many academic papers and course materials use PGM examples. The format is supported by ImageMagick, GIMP, and countless image processing libraries, and remains standard input for many research tools and benchmarks.