1 ACES 1.0.0 OpenColorIO configuration
4 Informations about ACES
7 The **ACES** project home page is here:
9 - http://www.oscars.org/aces
11 The latest documentation on the ACES transforms and specifications can be found here:
13 - http://www.oscars.org/science-technology/aces/aces-documentation
19 Colorspaces in this configurations are grouped into the following families: ACES, ADX, Look, Output, Input, Utility, Aliases. Descriptions for the colorspaces in the different families are provided below.
21 For ease of use across a broader number of applications, the family name of each colorspace is pre-prended to the colorspace name when the configuration is authored. Those prefixes will be omitted in this document, but will show up when the configuration is loaded and used.
32 - Description: Colorspaces and transforms representing the core ACES working and interchange color spaces.
34 - Technical information: Transforms generated based on the [ACES CTL Transforms](https://github.com/ampas/aces-dev/tree/v1.0/transforms/ctl)
42 - Description: Colorspaces and transforms representing the ACES ADX spaces used for film scanning and printing.
44 - Technical information: Transforms generated based on the [ACES CTL Transforms](https://github.com/ampas/aces-dev/tree/v1.0/transforms/ctl)
45 - [Alex Fry's ACES 0.7.1 OCIO config](https://github.com/imageworks/OpenColorIO-Configs/tree/master/aces_0.7.1) as also a valuable resource.
50 - ACES 1.0 to 0.1 emulation
51 - ACES 1.0 to 0.2 emulation
52 - ACES 1.0 to 0.7 emulation
54 - Description: Colorspaces and transforms emulating the look of the ACES 0.1, 0.2 and 0.7 release.
55 - Should be used before an ACES Output Transform
57 - Technical information: Transforms generated based on the [ACES CTL Transforms](https://github.com/ampas/aces-dev/tree/v1.0/transforms/ctl)
66 - DCDM (P3 gamut clip)
68 - P3-D60 PQ (1000 nits)
69 - P3-D60 PQ (2000 nits)
70 - P3-D60 PQ (4000 nits)
74 - Description: Colorspaces and transforms implementing the ACES Output Transforms. These colorspaces produce code values ready for display on hardware devices calibrated to the standard used to name the colorspace.
76 - Technical information
77 - Transforms generated based on the [ACES CTL Transforms](https://github.com/ampas/aces-dev/tree/v1.0/transforms/ctl)
78 - All transforms produce full-range output. Host applications should be used to apply an full-to-legal scaling needed.
82 - Description: Colorspaces and transforms that implement the ACES Input Transforms. These colorspaces are used to convert from camera-specific formats and encodings to ACES.
83 - Colorspaces: There are a variety of Input Transforms covering different cameras manufacturers, gamuts, transfer functions and camera settings. See below for specifics.
85 - Technical information: References and descriptions are provided for each group of Input Transforms below.
86 - The colorspaces whose names include a transfer function and a gamut name are full implementations of ACES Input Transforms.
87 - Ex. The ARRI 'V3 LogC (EI160) - Wide Gamut' colorspace
88 - Ex. The RED 'REDlogFilm - DRAGONcolor2' colorspace
89 - Ex. The Canon 'Canon-Log - DCI-P3 Daylight' colorspace
90 - The colorspaces that start with "Linear - " will convert to or from a specific gamut but not apply a transfer function.
91 - The colorspaces that start with "Curve - " will apply a transfer function but not convert between gamuts.
94 - [ARRI Input Transforms](https://github.com/ampas/aces-dev/tree/v1.0/transforms/ctl/idt/vendorSupplied/arri/alexa)
95 - Conversations with Joseph Goldstone of ARRI
98 - [Canon ACES landing page](http://usa.canon.com/cusa/professional/standard_display/aces)
99 - [Clog white paper](http://learn.usa.canon.com/app/pdfs/white_papers/White_Paper_Clog_optoelectronic.pdf)
100 - [C500 Drivers and Software](http://www.usa.canon.com/cusa/professional/products/professional_cameras/cinema_eos_cameras/eos_c500#DriversAndSoftware)
101 - [C300 Drivers and Software](http://www.usa.canon.com/cusa/professional/products/professional_cameras/cinema_eos_cameras/eos_c300#DriversAndSoftware)
102 - Choose *OSX Mountain Lion v10.8* to download the IDTs
103 - [C100 Drivers and Software](http://www.usa.canon.com/cusa/professional/products/professional_cameras/cinema_eos_cameras/eos_c100#DriversAndSoftware)
104 - Choose *OSX Mountain Lion v10.8* to download the IDTs
107 - [Vlog/V-Gamut white paper](http://pro-av.panasonic.net/en/varicam/common/pdf/VARICAM_V-Log_V-Gamut.pdf)
108 - [Varicam Drivers and Software](http://pro-av.panasonic.net/en/varicam/35/dl.html)
111 - [Understanding REDlogFilm and REDgamma](http://www.red.com/learn/red-101/redlogfilm-redgamma)
112 - Conversations with Graeme Nattress of RED
115 - [Sony Input Transforms](https://github.com/ampas/aces-dev/tree/v1.0/transforms/ctl/idt/vendorSupplied/sony)
117 #### GoPro Experimental
118 - The quality and consistency of these transforms has not been verified.
119 - Conversations with David Newman of GoPro
124 - Description: A collection of colorspaces that are used to facilitate the creation of LUTs and other basic functionality.
126 - Technical information:
127 - The Log2 shaper, Output shaper and 'Dolby PQ Scaled' spaces cover the linear range going from 6 stops below 18% grey (0.0028125) to 6.5 stops above 18% grey (16.291740)
128 - The LMT shaper spaces cover the linear range going from 10 stops below 18% grey (0.00017578125) to 6.5 stops above 18% grey (16.291740)
129 - The colorspaces that start with "Linear - " will convert to or from a specific gamut but not apply a transfer function.
130 - The colorspaces that start with "Curve - " will apply a transfer function but not convert between gamuts.
135 - Description: The alias colorspaces are named with all lower-case letters and no spaces, dashes, parentheses or other characters that would not work well in a filename. They are only references, aliases for the base colorspaces with more user-friendly names. These spaces were added to enable OCIO's token-based colorspace / filename matching.
136 - These colorspaces should not generally be used by most artists.
141 The standard OCIO roles are defined. They role assignments are:
143 - color_picking: ACEScg
144 - color_timing: ACEScc
145 - compositing_log: ACEScc
147 - default: ACES2065-1
148 - matte_paint: ACEScc
150 - scene_linear: ACEScg
153 Additionally, a number of colorspaces that are gaining wider adoption have been added to the config. Their names and assignment are:
155 - compositing_linear: ACEScg
161 The default config has one Display named **ACES**, which contains the following Views / colorspaces:
163 - sRGB D60 sim., colorspace: sRGB (D60 sim.)
164 - DCDM, colorspace: DCDM
165 - DCDM P3 gamut clip, colorspace: DCDM (P3 gamut clip)
166 - P3-D60, colorspace: P3-D60
167 - P3-D60 PQ 1000 nits, colorspace: P3-D60 PQ (1000 nits)
168 - P3-D60 PQ 2000 nits, colorspace: P3-D60 PQ (2000 nits)
169 - P3-D60 PQ 4000 nits, colorspace: P3-D60 PQ (4000 nits)
170 - P3-DCI, colorspace: P3-DCI
171 - Rec.2020, colorspace: Rec.2020
172 - Rec.709, colorspace: Rec.709
173 - Rec.709 D60 sim., colorspace: Rec.709 (D60 sim.)
174 - Raw, colorspace: Raw
175 - Log, colorspace: ACEScc
177 Considerations for custom config generation
179 - The choice of a single Display and many Views may not align well with the implementation of OCIO in an application.
180 - If you would like to generate a config that contains multiple Displays, with a small number of Views for each, review the config generation script's '--createMultipleDisplays' option.
181 - If a Look is added to the config, a new set of Views will be added, one for each of the Views listed above except Raw and Log, that includes the Look. The Views with Looks will be interleaved in the View list with the original Views.
182 - To add a custom Look to the config, review the config generation script's '--addACESLookLUT', '--addACESLookCDL', '--addCustomLookLUT' and '--addCustomLookCDL' optoins.
188 The default resolution is 33x33x33 for the 3D LUTs and 1024 for the 1D LUTs.
191 The LUTs used internally by OCIO can be can be retrieved [from the repository here.](https://github.com/hpd/OpenColorIO-Configs/tree/master/aces_1.0.0/luts)
194 LUTs that can be used outside of OCIO are included in the ['baked' directory here.](https://github.com/hpd/OpenColorIO-Configs/tree/master/aces_1.0.0/baked)
196 - The LUTs encode the ACES Output Transform for a specific colorspace input and are generally named:
197 - 'Ouput Transform name' for 'Input colorspace name'.extension
198 - Ex. 'sRGB (D60 sim.) for ACEScc.icc'
200 The LUTs included in the 'baked' directory cover the following formats and applications:
202 - .3dl for Autodesk Flame
203 - .3dl for Autodesk Lustre
204 - .lut for SideFX Houdini
205 - .csp for Autodesk Maya
206 - .icc for Adobe Photoshop
209 Generating Configurations
213 Configurations can be generated by the following *Python* package: [aces_1.0.0/python](https://github.com/hpd/OpenColorIO-Configs/tree/master/aces_1.0.0/python)
215 Usage is described on the command line and in the package root [\_\_init__.py](https://github.com/hpd/OpenColorIO-Configs/blob/master/aces_1.0.0/python/aces_ocio/__init__.py) file.
217 Features exposed for customization by the user include:
219 - The resolution of 1D and 3D LUTs
220 - Inclusion of custom Looks
221 - Two modes of creating the list of OCIO Displays and Views
224 The configuration depends on the **'hotfixes' fork of the 1.0 ACES CTL** that is available here:
226 - https://github.com/ampas/aces-dev/tree/hotfixes/transforms/ctl
227 - The fork contains a number of minor bug fixes and small additions in the utilities folder but is otherwise the same as the master ACES 1.0 release.
232 The *Python* configuration generation package depends on the following
235 - **OpenImageIO**: http://openimageio.org
236 - Detailed build instructions can be found here: [OpenImageIO Build Instructions](https://sites.google.com/site/openimageio/checking-out-and-building-openimageio)
237 - **OpenColorIO**: http://opencolorio.org
238 - Detailed build instructions can be found here: [OpenColorIO Build Instructions](http://opencolorio.org/installation.html)
239 - **CTL**: https://github.com/ampas/CTL
244 Use the following commands to build these packages on Mac OSX
247 - brew install -vd opencolorio --with-python
248 - Update the homebrew repository of install scripts to make sure that OpenImageIO is included.
249 - brew tap homebrew/science
250 - Optional Dependencies for OpenImageIO
251 - brew install -vd libRaw
252 - brew install -vd OpenCV
254 - brew install -vd openimageio --with-python
256 - brew install -vd CTL
257 - OpenColorIO, a second time. *ociolutimage* will build with *openimageio* installed.
258 - brew uninstall -vd opencolorio
259 - brew install -vd opencolorio --with-python
263 The script used to generate these transforms and the transforms themselves were the product of work and conversations with a number of people. Thanks go to:
286 The original author of this OCIO config is:
288 - Haarm-Pieter Duiker