1pfsoutexr(1) General Commands Manual pfsoutexr(1)
2
3
4
6 pfsoutexr - Write images or frames in OpenEXR format
7
9 pfsoutexr [--compression <method>] [--keep-xyz] (<file> [--frames
10 <range>]) [<file>...]
11
12
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
75 pfsin memorial.hdr | pfsoutexr memorial.exr
76
77 Converts from one HDR format to another
78
80 pfsout(1) pfsoutppm(1) pfsinexr(1)
81
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)