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>]  [--keep-xyz]  (<file>  [--frames
10       <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, color channels XYZ however are  specially  handled
17       (see option keep-xyz).
18
19       All  tags  from  pfs  stream  are  stored  in an OpenEXR file as String
20       attributes. Tags assigned to channels are stored in the  format  <chan‐
21       nel_name>:<tag_name>,  so  that  pfsinexr can later restore tags in the
22       appropriate channels.
23
24       The depth channel DEPTH is renamed to  Z  to  keep  compatibility  with
25       pfsinexr. If the luminance is absolute (tag LUMINANCE set to ABSOLUTE),
26       WhiteLuminance attribute in OpenEXR file is set to 1.
27
28       Details on the format of the pattern file names,  which  are  used  for
29       saving multiple frames, can be found in the manual page of pfsoutppm.
30
31
32       --compression <method>, -c <method>
33              Use one the the available compression methods:
34
35              NO - no compression
36
37              RLE - run length encoding
38
39              ZIPS - zlib compression, one scan line at a time
40
41              ZIP - zlib compression, in blocks of 16 scan lines
42
43              PIZ - piz-based wavelet compression (default)
44
45              PXR24 - lossy 24-bit float compression
46
47
48       --keep-xyz
49              By  default, color channels XYZ from pfs stream are converted to
50              RGB color space and HALF format, which is a standard format  for
51              color  data in OpenEXR. Since Half format is 16-bit and floating
52              points values used in pfs stream  are  32-bit,  this  conversion
53              causes  loss  of  precision.  When keep-xyz option is specified,
54              color channels XYZ are stored as they are without any conversion
55              (32-bit  float  XYZ  channels).  Note however, that most OpenEXR
56              applications can recognize only RGB Half format images  and  can
57              not handle 32-bit XYZ.
58
59
60       --fix-halfmax
61              The  maximum value that can be stored in OpenEXR file is limited
62              to 65504 if 16-bit HALF float is used (color channels are stored
63              by  default  in  this  format unless --keep-xyz switch is speci‐
64              fied). If the luminance data is calibrated  in  absolute  values
65              (cd/m^2),  pixel values can easily exceed 65504. To avoid clamp‐
66              ing large pixel values, pfsoutexr can rescale data to the  range
67              that  is  valid  for 16-bit HALF float format when --fix-halfmax
68              switch is specified. If this switch is missing, a  warning  mes‐
69              sage  is displayed. Scale factor used for rescaling is stored in
70              OpenEXR file as OpenEXR standard  attribute  WhiteLuminance,  so
71              that pfsinexr can later restore the absolute values.
72
73

EXAMPLES

75        pfsin memorial.hdr | pfsoutexr memorial.exr
76
77              Converts from one HDR format to another
78

SEE ALSO

80       pfsout(1) pfsoutppm(1) pfsinexr(1)
81

BUGS

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