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)