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)