Provided by: netpbm_10.0-12.2_i386 bug

NAME

       pngtopnm  -  convert  a  Portable  Network  Graphics file into portable
       anymap

SYNOPSIS

       pngtopnm [-verbose] [-alpha | -mix] [-background color]
       [-gamma value] [-text file] [-time] [pngfile]

DESCRIPTION

       Reads a Portable Network Graphics as input.  Produces a portable anymap
       as  output.  The type of the output file depends on the input file - if
       it's black & white, a pbm file is written, else if it's grayscale a pgm
       file, else a ppm file.

OPTIONS

       -verbose
              Display  the format of the input file and the type of the output
              file. If the  chunks  are  part  of  the  png-file,  the  alpha,
              transparency and gamma-values will be indicated.

       -alpha Output  the alpha channel or transparency mask of the image. The
              result is either a pbm file or pgm file,  depending  on  whether
              different levels of transparency appear.

       -mix   Compose  the image with the transparency or alpha mask against a
              the background. When a background chunk is available that  color
              is taken, else black will do.

       -background color
              If  no  background  color  chunck is present in the png-file, or
              when another color is required this parameter can be used to set
              the  background  color  of images. This is especially useful for
              alpha-channel images or  those  with  transparency  chunks.  The
              format,  to  specify  the  color  in,  is either (in the case of
              orange) "1.0,0.5,0.0", where the values are floats between  zero
              and one, or with the syntax "#RGB", "#RRGGBB" or "#RRRRGGGGBBBB"
              where R, G and B are hexa-decimal numbers.

       -gamma value
              Converts the image to a new display-gamma  value.  When  a  gAMA
              chunk  is present in the png-file, the image-gamma value will be
              used. When not, the image-gamma is considered to be  1.0.  Based
              on  the image-gamma and the display-gamma given with this option
              the colors written to the pnm-file will be adjusted.
              Because the gamma's of uncompensated monitors  are  around  2.6,
              which results in an image-gamma of 0.45, some typical situations
              are: when the image-gamma is 0.45 (use -verbose  to  check)  and
              the  picture  is  too  light, your system is gamma-corrected, so
              convert with "-gamma 1.0".  When no gAMA chunk is present or the
              image-gamma is 1.0, use 2.2 to make the picture lighter and 0.45
              to make the picture darker.

       -text file
              Writes the tEXt and zTXt chunks  to  a  file,  in  a  format  as
              described  in  the pnmtopng man-page.  These chunks contain text
              comments or annotations.

       -time  Prints the tIME chunk to stderr.

       All flags can be abbreviated to their shortest unique prefix.

SEE ALSO

       pnmtopng(1), ptot(1), pnmgamma(1), pnm(5)

NOTE

       Instead of pngtopnm|pnmtoxxx, a specific converter should be  used,  if
       available. E.g.  ptot (PNG to TIFF conversion), etc.

BUGS

       There  could  be  an  option to read the comment text from pnm comments
       instead of a separate file.

       The program could be much faster, with a bit of code optimizing.

AUTHORS

       Copyright (C) 1995-1997 by Alexander Lehmann
                               and Willem van Schaik.

                                6 January 1997                     pngtopnm(1)