NAME

       pfsinimgmagick - Load images or frames using ImageMagick++ library

SYNOPSIS

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

DESCRIPTION

       This command can load images or frames in the multitude of image formats  supported  by  the  ImageMagick
       library.  This includes but is not limited to: BMP, JPG, PNG, GIF, EPS, TIFF, DPX. See the manual page of
       ImageMagick for the full list of available formats.

       pfsinimgmagick reads images or frames from files 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.

       The output of pfsinimgmagick is scaled to 0-1 range, unless '--absolute' option is specified. By default,
       the  'LUMINANCE'  tag is set to 'DISPLAY' contents. Using the '--linear' switch you can force the inverse
       sRGB transformation to provide linear data. In this  case  the  'LUMINANCE'  tag  is  set  to  'RELATIVE'
       contents. '--absolute' switch can be used to convert pixels to absolute luminance values.

       This command handles properly 'alpha' channel (transparency) stored in images.

       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.  You  can  select  the frames using the following options (the options must be always
       given after the file name):

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

       pfsinimgmagick frame%04d.dpx --frames 0:10 | pfsview

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

BUGS

       pfsinimgmagick can not read frames from the Standard Input.

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

SEE ALSO

       pfsin(1), pfsout(1) ImageMagick(1)

                                                                                               pfsinimgmagick(1)