NAME

       pfsin - Read an image in one of the several formats and write pfs stream to the standard output

SYNOPSIS

       pfsin <file> [<file>...]

DESCRIPTION

       This  command  can  be  used  to read high- or low- dynamic range image in several recognized formats and
       output pfs stream on standard output. The pfs stream is usually piped  to  another  program  for  further
       processing (see examples). To get a list of recognized formats and extensions, execute:

         pfsin --help

       This  command  is  a front-end for pfsin* programs for reading images: pfsinrgbe, pfsinexr, etc. Based on
       the file extension, appropriate  program  is  executed.  If  two  different  file  format  are  given  as
       parameters,  two different program for loading images are executed. Additional options starting with dash
       '-' can be passed to pfsin* programs. The following rules apply for  passing  the  options:  the  options
       given  before  any image file name (or %d pattern) are passed to all pfsin* programs. Options given after
       image file name are only passed to the program executed for that file(s). Note also that all option  that
       take an argument (except --frames) must given in the form --option=value, that is without a space between
       an option and its argument.

OPTIONS

       The following options are shared by most pfsin* commands, although some may not accept --absolute and may
       ignore --linear.

       --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
              frames 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

       pfsin memorial.pic | pfsview

              See a hdr image in Radiance format (RGBE).

       pfsin memorial.pic | pfstmo_drago03 | pfsout memorial.jpeg

              Tone map a hdr image and save it as JPEG.

SEE ALSO

       pfsout(1) pfsinppm(1)

BUGS

       For  LDR  formats  -  JPEG,  PNG,  PNM: If pfstools are compiled without ImageMagic support, this command
       currently will not handle multiple frames given with a %d pattern.

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

                                                                                                        pfsin(1)