NAME

       pfsinppm - Load images or frames in PBM formats

SYNOPSIS

       pfsinppm (<file> [--linear] [--absolute <max_lum>] [--frames <range>] [--skip-missing])  [<file>...]

DESCRIPTION

       pfsinppm  command  loads  images  in  PBM formats (PPM, PNM or PGM) and writes pfs stream to the standard
       output. The pfs stream is usually piped to another program for further processing. To detect  the  format
       automatically  based  on  the extension, use pfsin command. For more information on PBM formats, refer to
       the NetPBM web page (http://netpbm.sourceforge.net/).

       Note that PPM or PNM images are low dynamic range. Therefore pixel  values  (0-255)  are  scaled  to  0-1
       before  storing  them  in  pfs stream. Similarly, before writing low dynamic range image from pfs stream,
       pixel values are multiplied by 255.  By default, the 'LUMINANCE' tag is set to 'DISPLAY'. The  '--linear'
       switch  can  force  the inverse sRGB transformation and provide linear data. In this case the 'LUMINANCE'
       tag is set to 'RELATIVE'. '--absolute' switch can be used to convert pixels to absolute luminance values.

       To read images from standard input use a single dash '-' instead of filename. The images are  read  until
       EOF is reached.

       Each  file  can  contain  a %d pattern, which is substituted with frame numbers. The pattern has the same
       syntax as C printf command. For example, you can use %04d to  make  the  frame  number  four  digit  with
       proceedings zeros. See the OPTIONS section below for details.

OPTIONS

       --frames <range>
              Range is given in mathlab / octave format:

              startframe:step:endframe

              Frame  numbers  start  with  startframe (default 0), are increased by step (default 1) and stop at
              endframe You can skip one of those values, for example 1:100 for frames 1,2,...,100 and  0:2:  for
              frame 0,2,4,... up to the last file that exists.

       --skip-missing
              Skip  up  to  ten  frames in a row if corresponding files are missing. Otherwise the program stops
              reading sequence at the first file that does not exists. This switch does not apply to  the  first
              frame  in a sequence. This switch can be useful if there is a rendered animation where some of the
              frame has not been generated.

       --linear, -l
              Converts pixel values to linear luminance (XYZ), assuming the  sRGB  color  space  for  the  input
              image. The maximum pixel value (255,255,255) is mapped to Y=1. LUMINANCE tag is set to RELATIVE.

       --absolute <max_lum>, -a <max_lum>
              --absolute  converts  pixel values to an absolute linear luminance (XYZ), that is the color space,
              in which channel Y contains luminance given in cd/m^2. The sRGB color space  is  assumed  for  the
              input  image.  The  maximum  pixel  value  (255,255,255)  is  mapped  to Y=<max_lum>. <max_lum> is
              typically set to 80 [cd/m^2] for a CRT monitor. LUMINANCE  tag  is  set  to  ABSOLUTE.  --absolute
              process images almost the same as --relative, but additionally it scales all pixels by <max_lum>.

EXAMPLES

       pfsinppm frame%04d.ppm --frames 0:10 | pfsview

              Read  frames  from  files  frame0000.ppm,  frame0001.ppm,  ...,  frame0010.ppm and show them using
              pfsview.

BUGS

       Please    report    bugs    and    comments    on    implementation    to    the     discussion     group
       http://groups.google.com/group/pfstools

SEE ALSO

       pfsin(1), pfsout(1)

                                                                                                     pfsinppm(1)