1pfsoutexr(1)                General Commands Manual               pfsoutexr(1)
2
3
4

NAME

6       pfsoutexr - Write images or frames in OpenEXR format
7

SYNOPSIS

9       pfsoutexr   [--compression   <method>]   [--float32]  [--clamp-halfmax]
10       (<file> [--frames <range>])  [<file>...]
11
12

DESCRIPTION

14       Use this command to write frames in OpenEXR format. Source  pfs  frames
15       should be piped to the Standard Input. This command can write arbitrary
16       channels to OpenEXR as 32-bit floating point  numbers.  However,  color
17       channels  are  converted  to 16-bit half-float format by default unless
18       --float32 option is specified.
19
20       All tags from pfs stream are  stored  in  an  OpenEXR  file  as  String
21       attributes.  Tags  assigned to channels are stored in the format <chan‐
22       nel_name>:<tag_name>, so that pfsinexr can later restore  tags  in  the
23       appropriate channels.
24
25       The  depth  channel  DEPTH  is  renamed to Z to keep compatibility with
26       pfsinexr. If the luminance is absolute (tag LUMINANCE set to ABSOLUTE),
27       WhiteLuminance attribute in OpenEXR file is set to 1.
28
29       Details  on  the  format  of the pattern file names, which are used for
30       saving multiple frames, can be found in the manual page of pfsoutppm.
31
32
33       --compression <method>, -c <method>
34              Use one the the available compression methods:
35
36              NO - no compression
37
38              RLE - run length encoding
39
40              ZIPS - zlib compression, one scan line at a time
41
42              ZIP - zlib compression, in blocks of 16 scan lines
43
44              PIZ - piz-based wavelet compression (default)
45
46              PXR24 - lossy 24-bit float compression
47
48
49       --float32, -3
50              If this option is specified, color channels are stored as 32-bit
51              floating  point  numbers  instead of 16-bit half-floats. In most
52              cases half-float numbers offer sufficient precision so this  the
53              default  behavior.  Note  that  storing color channels in 32-bit
54              format makes resulting files very large.
55
56
57       --clamp-halfmax, -p
58              The maximum value that can be stored in OpenEXR file is  limited
59              to 65504 if 16-bit HALF float is used (color channels are stored
60              by default in this format unless --float32 switch is specified).
61              If the luminance data is calibrated in absolute values (cd/m^2),
62              pixel values can easily exceed 65504. To  avoid  clamping  large
63              pixel values, pfsoutexr rescales data to the range that is valid
64              for 16-bit HALF float format  and  the  scale  factor  used  for
65              rescaling   is  stored  in  OpenEXR  file  as  OpenEXR  standard
66              attribute WhiteLuminance, so that pfsinexr can later restore the
67              absolute  values. Use the option --clamp-halfmax to disable this
68              behavior and clamp half-float values instead.
69
70

EXAMPLES

72        pfsin memorial.hdr | pfsoutexr memorial.exr
73
74              Converts from one HDR format to another
75

SEE ALSO

77       pfsout(1) pfsoutppm(1) pfsinexr(1)
78

BUGS

80       pfsinexr and pfsoutexr can not take stdin / stdout as  an  input/output
81       (dash '-' instead of file name).
82
83       Please  report  bugs  and  comments on implementation to the discussion
84       group http://groups.google.com/group/pfstools
85
86
87
88                                                                  pfsoutexr(1)