Debian Codegraph @

website/bin/exr2aces.rst

raw
1 ..
2 SPDX-License-Identifier: BSD-3-Clause
3 Copyright Contributors to the OpenEXR Project.
4
5 exr2aces
6 ########
7
8 ::
9
10 exr2aces [options] infile outfile
11
12 Description
13 -----------
14
15 Read an OpenEXR file from infile and save the contents
16 in ACES image file outfile.
17
18 The ACES Image Container File Format specified in SMPTE ST 2065-4
19 is a subset of the OpenEXR file format defined by the implementation
20 of the time (roughly OpenEXR 1.6).
21
22 This imposes considerable restrictions on what image data and metadata
23 can be transported from a modern OpenEXR file into an ACES Image
24 Container File, including (but not limited to) the following:
25
26 - The version field must be either be 2 or 1026; a value of 2 implies
27 attribute names cannot be longer than 31 characters in length,
28 as was the case prior to OpenEXR 1.7.
29
30 - Images must be stored as scanlines; tiles are not allowed.
31
32 - Images must contain RGB and possibly an A channel if they are monoscopic;
33 images representing stereo pairs would add another three (or four if A is
34 present) channels. Other channels are not permitted, including channels
35 that otherwise might represent a combination of a luminance channel and
36 chromaticity channels.
37
38 - The image must not be compressed.
39
40 - The `chromaticities` attribute must specify the ACES RGB primaries and
41 the ACES neutral as specified in SMPTE ST 2065-1.
42
43 - The `acesImageContainerFlag` flat must be present and have the value 1.
44
45 For the full set of restrictions, see `SMTPE ST 2065-4 <https://doi.org/10.5594/SMPTE.ST2065-4.2013>`_ (or any
46 superseding later version of that standard).
47
48 In practice, facilities and productions often use the term "ACES file"
49 to mean OpenEXR files containing linear scene data expressed as
50 combinations of R, G and B whose chromaticities match those found in
51 ST 2065-1, where equal amounts of those primaries produce a color the
52 chromaticity of which matches that of the ACES neutral. The image data
53 might be compressed using one of the OpenEXR's library's built-in compression
54 functions, even though strict compliance with ST 2065-4 would forbid such
55 compression; the `acesImageContainerFile` flag might be missing; and the
56 `chromaticities` attribute might contain chromaticities that do not actually
57 match those found in ST 2065-1.
58
59 Options:
60 --------
61
62 .. describe:: -v, --verbose
63
64 verbose mode
65
66 .. describe:: -h, --help
67
68 print this message
69
70 .. describe:: --version
71
72 print version information
73
74