NAME

       pfsoutexr - Write images or frames in OpenEXR format

SYNOPSIS

       pfsoutexr [--compression <method>] [--keep-xyz] (<file> [--frames <range>])  [<file>...]

DESCRIPTION

       Use  this  command to write frames in OpenEXR format. Source pfs frames should be piped to
       the Standard Input. This command can write arbitrary channels to OpenEXR,  color  channels
       XYZ however are specially handled (see option keep-xyz).

       All tags from pfs stream are stored in an OpenEXR file as String attributes. Tags assigned
       to channels are stored in the format <channel_name>:<tag_name>, so that pfsinexr can later
       restore tags in the appropriate channels.

       The  depth  channel  DEPTH  is  renamed  to  Z to keep compatibility with pfsinexr. If the
       luminance is absolute (tag LUMINANCE set to ABSOLUTE), WhiteLuminance attribute in OpenEXR
       file is set to 1.

       Details  on  the  format  of  the  pattern  file names, which are used for saving multiple
       frames, can be found in the manual page of pfsoutppm.

       --compression <method>, -c <method>
              Use one the the available compression methods:

              NO - no compression

              RLE - run length encoding

              ZIPS - zlib compression, one scan line at a time

              ZIP - zlib compression, in blocks of 16 scan lines

              PIZ - piz-based wavelet compression (default)

              PXR24 - lossy 24-bit float compression

       --keep-xyz
              By default, color channels XYZ from pfs stream are converted to RGB color space and
              HALF  format,  which  is  a  standard  format for color data in OpenEXR. Since Half
              format is 16-bit and floating points values used in pfs  stream  are  32-bit,  this
              conversion  causes  loss  of  precision.  When  keep-xyz option is specified, color
              channels XYZ are stored as they  are  without  any  conversion  (32-bit  float  XYZ
              channels). Note however, that most OpenEXR applications can recognize only RGB Half
              format images and can not handle 32-bit XYZ.

       --fix-halfmax
              The maximum value that can be stored in OpenEXR file is limited to 65504 if  16-bit
              HALF  float  is  used  (color  channels are stored by default in this format unless
              --keep-xyz switch is specified). If the luminance data is  calibrated  in  absolute
              values  (cd/m^2),  pixel  values  can  easily exceed 65504. To avoid clamping large
              pixel values, pfsoutexr can rescale data to the range that is valid for 16-bit HALF
              float  format  when --fix-halfmax switch is specified. If this switch is missing, a
              warning message is displayed. Scale factor used for rescaling is stored in  OpenEXR
              file  as  OpenEXR  standard  attribute  WhiteLuminance,  so that pfsinexr can later
              restore the absolute values.

EXAMPLES

        pfsin memorial.hdr | pfsoutexr memorial.exr

              Converts from one HDR format to another

SEE ALSO

       pfsout(1) pfsoutppm(1) pfsinexr(1)

BUGS

       pfsinexr and pfsoutexr can not take stdin / stdout as an input/output (dash '-' instead of
       file name).

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

                                                                                     pfsoutexr(1)