PGMA_IO
ASCII Portable Gray Map (PGM) Files
Read and Write Utilities

PGMA_IO is a C++ library which reads and writes files in the ASCII Portable Gray Map (PGM) format for 2D grayscale graphics information.

There are many graphics programs, such as XV and GIMP, that can display images in this format, or translate them to other formats such as BMP, GIF, JPEG, MacPaint, X Window, and so on.

Licensing:

The computer code and data files described and made available on this web page are distributed under the GNU LGPL license.

Languages:

PGMA_IO is available in a C version and a C++ version and a FORTRAN77 version and a FORTRAN90 version and a MATLAB version.

Related Data and Programs:

PBMA_IO, a C++ library which handles the ASCII Portable Bit Map (PBM) format.

PGMA, a data directory which contains examples of ASCII Portable Gray Map (PGM) files.

PGMA_TO_PGMB, a C++ program which converts an ASCII Portable Gray Map (PGM) file to a binary PGM file.

PGMB_IO, a C++ library which handles the binary Portable Gray Map (PGM) format.

PGMB_TO_PGMA, a C++ program which converts a binary Portable Gray Map (PGM) file to an ASCII PGM file.

PPMA_IO, a C++ library which handles the ASCII Portable Pixel Map (PPM) format.

1. the NETPBM homepage.

Source Code:

• pgma_io.cpp, the source code;
• pgma_io.hpp, the include file;
• pgma_io.sh, commands to compile the source code;

Examples and Tests:

• pgma_io_prb.cpp, the sample calling program.
• pgma_io_prb.sh, commands to compile, link and run the sample calling program.
• pgma_io_prb_output.txt, the output file.

List of Routines:

• I4_MIN returns the smaller of two integers.
• PGMA_CHECK_DATA checks the data for an ASCII portable gray map file.
• PGMA_EXAMPLE sets up some data for an ASCII portable gray map file.
• PGMA_READ reads the header and data from an ASCII portable gray map file.
• PGMA_READ_DATA reads the data in an ASCII portable gray map file.
• PGMA_READ_HEADER reads the header of an ASCII portable gray map file.
• PGMA_READ_TEST tests the ASCII portable gray map read routines.
• PGMA_WRITE writes the header and data for an ASCII portable gray map file.
• PGMA_WRITE_DATA writes the data for an ASCII portable gray map file.
• PGMA_WRITE_HEADER writes the header of an ASCII portable gray map file.
• PGMA_WRITE_TEST tests the ASCII portable gray map write routines.

You can go up one level to the C++ source codes.