| 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 |
|