pamtopnm(1) [redhat man page]

pamtopnm(1)						      General Commands Manual						       pamtopnm(1)

NAME

       pamtopnm - convert PAM image to PBM, PGM, or PPM

SYNOPSIS

       pamtopnm [-assume] [pnmfile]

       All options may be abbreviated to the shortest unique prefix.

DESCRIPTION

       Reads a PAM image as input.  Produces an equivalent PBM, PGM, or PPM (i.e. PNM) image, whichever is most appropriate, as output.

       pamtopnm  assumes  the  PAM  image  represents  the information required for a PBM, PGM, or PPM image if its tuple type is "BLACKANDWHITE",
       "GRAYSCALE", or "RGB" and its depth and maxval are appropriate.	If this is not the case, pamtopnm fails.

       However, you can override the tuple type requirement with the -assume option.

       As with any Netpbm program that reads PAM images, pamtopnm also reads PNM images as if they were PAM.  In that case,  pamtopnm's  functions
       reduces	to  simply copying the input to the output.  But this can be useful in a program that doesn't know whether its input is PAM or PNM
       but needs to feed it to a program that only recognizes PNM.

OPTIONS

       -assume
	      When you specify -assume, you tell pamtopnm that you personally vouch for the fact that the tuples contain the same data as  belongs
	      in  the  channels of a PBM, PGM, or PPM file.  The depth must still conform, though, so to truly force a conversion, you may have to
	      run the input through pamchannel first.  But be careful with -assume.  When you -assume, you make an -ass of u and me.

SEE ALSO

       pbmtopgm(1), pgmtopbm(1), pgmtoppm(1), ppmtopgm(1), pam(5), pnm(5), pbm(5), pgm(5), ppm(5)

								  03 August 2000						       pamtopnm(1)

Libnetpbm manual(3)                                          Library Functions Manual                                          Libnetpbm manual(3)

NAME

       libnetpbm - general introduction to the netpbm library

DESCRIPTION

       libnetpbm is a C programming library for reading, writing, and manipulating Netpbm images.  It also contains a few general graphics manipu-
       lation tools, but it is not intended to be a graphics tools library.  For graphics tools, Netpbm expects you to run  the  Netpbm  programs.
       From a C program, the libnetpbm function pm_system() makes this easy.  However, since it creates a process and execs a program, this may be
       too heavyweight for some applications.

       To use libnetpbm services in your C program, #include the pam.h interface header file.  For historical reasons, you can also get by in some
       cases with pbm.h, pgm.h, ppm.h, or pnm.h, but there's really no point to that anymore.

       The libnetpbm functions are divided into these categories:

       o      PBM functions.  These have names that start with pbm and work only on PBM images.

       o      PGM functions.  These have names that start with pgm and work only on PGM images.

       o      PPM functions.  These have names that start with ppm and work only on PPM images.

       o      PNM functions.  These have names that start with pnm and work on PBM, PGM, and PPM images.

       o      PAM functions.  These also have names that start with pnm and work on all the Netpbm image types.

       o      PM functions.  These are utility functions that aren't specific to any particular image format.

       For  new programming, you rarely need to concern yourself with the PBM, PGM, PPM, and PNM functions, because the newer PAM functions do the
       same thing and are easier to use.  For certain processing of bi-level images, the PBM functions are significantly more efficient, though.

       libnetpbm has a backward compatibility feature that means a function designed to read one format can read some others  too,  converting  on
       the  fly.  In particular, a function that reads a PGM image will also read a PBM image, but converts it as it reads it so that for program-
       ming purposes, it is a PGM image.  Similarly, a function that reads PPM can read PBM and PGM as well.  And a function that reads PBM,  PGM,
       or PPM can read a PAM that has an equivalent tuple type.

       For  each  of the five classes of libnetpbm image processing functions, libnetpbm has in in-memory representation for a pixel, a row, and a
       whole image.  Do not confuse this format with the actual image format, as you would see in a  file.   The  libnetpbm  in-memory  format  is
       designed  to  make  programming  very easy.  It is sometimes extremely inefficient, even more than the actual image format.  For example, a
       pixel that a PPM image represents with 3 bytes, libnetpbm's PAM functions represent with 16 bytes.  A pixel in a PBM image  is  represented
       by a single bit, but the PNM functions represent that pixel in memory with 96 bits.

       See LibnetpbmUser'sManual(3)
        for the basics on using libnetpbm in a program.

       You can look up the reference information for a particular function in ThelibnetpbmDirectory(1)

       Before  Netpbm release 10 (June 2002), this library was split into four: libpbm, libpgm, libppm, and libpnm.  That's largely the reason for
       the multiple sets of functions and scattered documentation.

netpbm documentation                                               December 2003                                               Libnetpbm manual(3)