NAME

       pfsinrgbe - Load images or frames in Radiance RGBE format

SYNOPSIS

       pfsinrgbe [--linear] (<file> [--frames <range>] [--skip-missing])  [<file>...]

DESCRIPTION

       pfsinrgbe  command loads images in Radiance RGBE format 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.

       Since RGBE is an HDR format, 'LUMINANCE' tag is set to 'RELATIVE' (relative linear 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.  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
              Ignored for compatibility with pfsinppm.

EXAMPLES

       pfsinrgbe intro%d.hdr frame%d.hdr | ...

              Concatenate two animations into one and pass it to pipe for further processing.

IMPORTANT NOTE

       There  is  an  incompatibility  between viewers of RGBE format in terms of absolute luminance values. The
       ximage viewer from Radiance package expects radiance values in RGBE files  and  uses  the  WHITE_EFFICACY
       constant  equal  to  179.0f to convert from radiance to luminance. This in practice means that the values
       displayed with pfsview maybe higher than expected. To compensate for this incompatibility we  suggest  to
       use pfsabsolute command:

       pfsinrgbe measured_luminance.hdr | pfsabsolute 1 179 | pfsview

       This  is  not  necessary  when  RGBE  files  are  saved  using  pfsoutrgbe,  Radiance  package,  mkhdr or
       Photospheare. This is also not relevant when only relative absolute values are considered.

BUGS

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

SEE ALSO

       pfsin(1), pfsout(1)

                                                                                                    pfsinrgbe(1)