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)