Skip to content
This repository was archived by the owner on Sep 19, 2024. It is now read-only.

Commit 5c38100

Browse files
committed
Update "README.md" file.
1 parent aedc19a commit 5c38100

File tree

1 file changed

+106
-63
lines changed

1 file changed

+106
-63
lines changed

aces_1.1/README.md

Lines changed: 106 additions & 63 deletions
Original file line numberDiff line numberDiff line change
@@ -31,59 +31,77 @@ For ease of use across a broader number of applications, the family name of each
3131
- ACESproxy
3232
- ACEScg
3333

34+
3435
##### Description
3536

3637
Colorspaces and transforms representing the core ACES working and interchange colorspaces.
3738

39+
3840
##### Technical information
3941

4042
Transforms generated based on the [ACES CTL Transforms](https://github.com/ampas/aces-dev/tree/v1.1/transforms/ctl)
4143

44+
4245
### Output
4346

4447
##### Colorspaces
4548

46-
- sRGB
47-
- sRGB (D60 sim.)
48-
- Rec.709
49-
- Rec.709 (D60 sim.)
50-
- Rec.2020
51-
- Rec.2020 ST2048 (1000 nits)
52-
- DCDM (P3 gamut clip)
5349
- DCDM
54-
- P3-D60 ST2048 (1000 nits)
55-
- P3-D60 ST2048 (2000 nits)
56-
- P3-D60 ST2048 (4000 nits)
50+
- DCDM (P3D60 Limited)
51+
- DCDM (P3D65 Limited)
5752
- P3-D60
58-
- P3-DCI
53+
- P3-DCI (D60 simulation)
54+
- P3-DCI (D65 simulation)
55+
- P3D65
56+
- P3D65 (D60 simulation)
57+
- P3D65 (Rec.709 Limited)
58+
- P3D65 ST2084 (108 nits)
59+
- Rec.2020
60+
- Rec.2020 (P3D65 Limited)
61+
- Rec.2020 (Rec.709 Limited)
62+
- Rec.2020 HLG (1000 nits)
63+
- Rec.2020 ST2084 (1000 nits)
64+
- Rec.2020 ST2084 (2000 nits)
65+
- Rec.2020 ST2084 (4000 nits)
66+
- Rec.709
67+
- Rec.709 (D60 sim.)
68+
- sRGB
69+
- sRGB (D60 sim.)
70+
5971

6072
##### Description
6173

6274
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.
6375

76+
6477
##### Technical information
78+
6579
- Transforms generated based on the [ACES CTL Transforms](https://github.com/ampas/aces-dev/tree/v1.1/transforms/ctl)
6680
- All transforms produce full-range output. Host applications should be used to apply an full-to-legal scaling needed.
6781

82+
6883
### Input
6984

7085
##### Colorspaces
7186

7287
There are a variety of Input Transforms covering different cameras manufacturers, gamuts, transfer functions and camera settings. See below for specifics.
7388

89+
7490
##### Description
7591

7692
Colorspaces and transforms that implement the ACES Input Transforms. These colorspaces are used to convert from camera-specific formats and encodings to ACES.
7793

94+
7895
##### Technical information
7996

8097
References and descriptions are provided for each group of Input Transforms below.
8198
- The colorspaces whose names include a transfer function and a gamut name are full implementations of ACES Input Transforms.
82-
- Ex. The ARRI 'V3 LogC (EI160) - Wide Gamut' colorspace
83-
- Ex. The RED 'REDlogFilm - DRAGONcolor2' colorspace
84-
- Ex. The Canon 'Canon-Log - DCI-P3 Daylight' colorspace
85-
- The colorspaces that start with 'Linear - ' will convert to or from a specific gamut but not apply a transfer function.
86-
- The colorspaces that start with 'Curve - ' will apply a transfer function but not convert between gamuts.
99+
- Ex. The ARRI 'V3 LogC (EI160) - Wide Gamut' colorspace
100+
- Ex. The RED 'REDlogFilm - DRAGONcolor2' colorspace
101+
- Ex. The Canon 'Canon-Log - DCI-P3 Daylight' colorspace
102+
- The colorspaces starting with 'Linear - ' convert to or from a specific gamut but do not apply a transfer function.
103+
- The colorspaces starting with 'Curve - ' apply a transfer function but do not convert between gamuts.
104+
87105

88106
#### ADX
89107

@@ -92,24 +110,29 @@ References and descriptions are provided for each group of Input Transforms belo
92110
- ADX10
93111
- ADX16
94112

113+
95114
##### Description
96115

97116
Colorspaces and transforms representing the ACES ADX spaces used for film scanning and printing.
98117

118+
99119
##### Technical information
100120

101121
- Transforms generated based on the [ACES CTL Transforms](https://github.com/ampas/aces-dev/tree/v1.1/transforms/ctl)
102-
- [Alex Fry's ACES 0.7.1 OCIO config](https://github.com/imageworks/OpenColorIO-Configs/tree/master/aces_0.7.1) was also a valuable resource.
122+
- [Alex Fry's ACES 0.7.1 OCIO config](https://github.com/imageworks/OpenColorIO-Configs/tree/master/aces_0.7.1) was also a valuable resource
123+
103124

104125
#### ARRI
126+
105127
- [ARRI 'Working with ACES'](http://www.arri.com/camera/alexa_mini/learn/working_with_aces/)
106128
- [ARRI Input Transforms](https://github.com/ampas/aces-dev/tree/v1.1/transforms/ctl/idt/vendorSupplied/arri/alexa)
107129
- Conversations with Joseph Goldstone of ARRI
108130

131+
109132
#### Canon
133+
110134
- [Canon ACES landing page](http://usa.canon.com/cusa/professional/standard_display/aces)
111135
- [Clog white paper](http://learn.usa.canon.com/app/pdfs/white_papers/White_Paper_Clog_optoelectronic.pdf)
112-
113136
- [C700 Drivers and Software](https://www.usa.canon.com/internet/portal/us/home/support/details/cameras/cinema-eos/eos-c300-mark-ii?tab=drivers#Z7_MQH8HIC0L88RB0AMD0F1Q42K25)
114137
- [C500 Drivers and Software](http://www.usa.canon.com/cusa/professional/products/professional_cameras/cinema_eos_cameras/eos_c500#DriversAndSoftware)
115138
- [C300 Drivers and Software](http://www.usa.canon.com/cusa/professional/products/professional_cameras/cinema_eos_cameras/eos_c300#DriversAndSoftware)
@@ -119,19 +142,27 @@ Colorspaces and transforms representing the ACES ADX spaces used for film scanni
119142
- [C100 Drivers and Software](http://www.usa.canon.com/cusa/professional/products/professional_cameras/cinema_eos_cameras/eos_c100#DriversAndSoftware)
120143
- Choose *OSX Mountain Lion v10.8* to download the IDTs
121144

145+
122146
#### Panasonic
147+
123148
- [Vlog/V-Gamut white paper](http://pro-av.panasonic.net/en/varicam/common/pdf/VARICAM_V-Log_V-Gamut.pdf)
124149
- [Varicam Drivers and Software](http://pro-av.panasonic.net/en/varicam/35/dl.html)
125150

151+
126152
#### RED
153+
127154
- [Understanding REDlogFilm and REDgamma](http://www.red.com/learn/red-101/redlogfilm-redgamma)
128155
- Conversations with Graeme Nattress of RED
129156

157+
130158
#### Sony
159+
131160
- [Sony Input Transforms](https://github.com/ampas/aces-dev/tree/v1.1/transforms/ctl/idt/vendorSupplied/sony)
132161

133-
#### GoPro Experimental
134-
- The quality and consistency of these transforms has not been verified.
162+
163+
#### GoPro (Experimental)
164+
165+
- The quality and consistency of these transforms has not been verified
135166
- Conversations with David Newman of GoPro
136167

137168

@@ -141,12 +172,14 @@ Colorspaces and transforms representing the ACES ADX spaces used for film scanni
141172

142173
A collection of colorspaces that are used to facilitate the creation of LUTs and other basic functionality.
143174

175+
144176
##### Technical information
145177

146-
- The 'Log2 xx nits Shaper' and 'Dolby PQ xx nits Shaper' spaces cover the linear range centered around 18% grey. The 48 nits spaces cover -6.5 stops (0.0028125) to +6.5 stops(16.291740). The 1000 nits spaces cover -12 stops to +10 stops. The 2000 nits spaces cover -12 stops to +11 stops. The 4000 nits spaces cover -12 stops to +12 stops.
147-
- 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)
148-
- The colorspaces starting with 'Linear - ' will convert to or from a specific gamut but not apply a transfer function.
149-
- The colorspaces starting with 'Curve - ' will apply a transfer function but not convert between gamuts.
178+
- The 'Log2 xx nits Shaper' and 'Dolby PQ xx nits Shaper' spaces cover the linear range centered around 18% grey. The 48 nits spaces cover -7.2460688 stops (0.0011857) to +10.2739312 stops (222.8609442), effectively matching ACEScc. The 1000 nits spaces cover -12 stops to +10 stops. The 2000 nits spaces cover -12 stops to +11 stops. The 4000 nits spaces cover -12 stops to +12 stops.
179+
- The LMT shaper spaces cover the linear range going from 10 stops below 18% grey (0.0001758) to 6.5 stops above 18% grey (16.2917402)
180+
- The colorspaces starting with 'Linear - ' convert to or from a specific gamut but do not apply a transfer function.
181+
- The colorspaces starting with 'Curve - ' apply a transfer function but do not convert between gamuts.
182+
150183

151184
#### Look
152185

@@ -155,24 +188,29 @@ A collection of colorspaces that are used to facilitate the creation of LUTs and
155188
- ACES 1.0 to 0.1 emulation
156189
- ACES 1.0 to 0.2 emulation
157190
- ACES 1.0 to 0.7 emulation
191+
- Blue Light Artifact Fix
192+
158193

159194
##### Description
160195

161-
Colorspaces and transforms emulating the look of the ACES 0.1, 0.2 and 0.7 release.
196+
Colorspaces and transforms emulating the look of the ACES 0.1, 0.2 and 0.7 release. The Blue Light Artifact Fix is intended to address [issues occurring with highly saturated emitters](https://acescentral.com/t/colour-artefacts-or-breakup-using-aces/520/63) such as LED lights.
162197

163198
- Should be applied to data in the ACES2065-1 colorspace.
164199
- Should be used before an ACES Output Transform.
165200

201+
166202
##### Technical information
167203

168204
Transforms generated based on the [ACES CTL Transforms](https://github.com/ampas/aces-dev/tree/v1.1/transforms/ctl)
169205

206+
170207
#### Roles
171208

172209
##### Description
173210

174211
The role colorspaces are aliases to the colorspaces used for the *OCIO* 'roles' functionality.
175212

213+
176214
#### Aliases
177215

178216
##### Description
@@ -209,43 +247,55 @@ Displays and Views
209247
The default config has one Display named **ACES**, which contains the following Views / colorspaces:
210248

211249
- sRGB, colorspace: sRGB
212-
- sRGB D60 sim., colorspace: sRGB (D60 sim.)
213250
- DCDM, colorspace: DCDM
214-
- DCDM P3 gamut clip, colorspace: DCDM (P3 gamut clip)
251+
- DCDM P3D60 Limited, colorspace: DCDM (P3D60 Limited)
252+
- DCDM P3D65 Limited, colorspace: DCDM (P3D65 Limited)
215253
- P3-D60, colorspace: P3-D60
216-
- P3-D60 PQ 1000 nits, colorspace: P3-D60 PQ (1000 nits)
217-
- P3-D60 PQ 2000 nits, colorspace: P3-D60 PQ (2000 nits)
218-
- P3-D60 PQ 4000 nits, colorspace: P3-D60 PQ (4000 nits)
219-
- P3-DCI, colorspace: P3-DCI
254+
- P3-DCI D60 simulation, colorspace: P3-DCI (D60 simulation)
255+
- P3-DCI D65 simulation, colorspace: P3-DCI (D65 simulation)
256+
- P3D65, colorspace: P3D65
257+
- P3D65 D60 simulation, colorspace: P3D65 (D60 simulation)
258+
- P3D65 Rec.709 Limited, colorspace: P3D65 (Rec.709 Limited)
259+
- P3D65 ST2084 108 nits, colorspace: P3D65 ST2084 (108 nits)
220260
- Rec.2020, colorspace: Rec.2020
221-
- Rec.2020 ST2048 1000 nits, colorspace: Rec.2020 ST2048 (1000 nits)
261+
- Rec.2020 P3D65 Limited, colorspace: Rec.2020 (P3D65 Limited)
262+
- Rec.2020 Rec.709 Limited, colorspace: Rec.2020 (Rec.709 Limited)
263+
- Rec.2020 HLG 1000 nits, colorspace: Rec.2020 HLG (1000 nits)
264+
- Rec.2020 ST2084 1000 nits, colorspace: Rec.2020 ST2084 (1000 nits)
265+
- Rec.2020 ST2084 2000 nits, colorspace: Rec.2020 ST2084 (2000 nits)
266+
- Rec.2020 ST2084 4000 nits, colorspace: Rec.2020 ST2084 (4000 nits)
222267
- Rec.709, colorspace: Rec.709
223268
- Rec.709 D60 sim., colorspace: Rec.709 (D60 sim.)
269+
- sRGB D60 sim., colorspace: sRGB (D60 sim.)
224270
- Raw, colorspace: Raw
225-
- Log, colorspace: ACEScc
271+
- Log, colorspace: ADX - ADX10
226272

227273
Considerations for custom config generation:
228274

229275
- The choice of a single Display and many Views may not align well with the implementation of OCIO in an application.
230-
- 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.
276+
- 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.
231277
- 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.
232-
- To add a custom Look to the config, review the config generation script's '--addACESLookLUT', '--addACESLookCDL', '--addCustomLookLUT' and '--addCustomLookCDL' options.
278+
- To add a custom Look to the config, review the config generation script's '--addACESLookLUT', '--addACESLookCDL', '--addCustomLookLUT' and '--addCustomLookCDL' options.
233279

234280

235281
LUTs
236282
-
237283

238284
The default resolution is 65x65x65 for the 3D LUTs and 4096 for the 1D LUTs.
239285

286+
240287
### OCIO LUTs
288+
241289
The LUTs used internally by OCIO can be can be retrieved [from the repository here.](https://github.com/imageworks/OpenColorIO-Configs/tree/master/aces_1.1/luts)
242290

291+
243292
### Baked LUTs
293+
244294
LUTs that can be used outside of OCIO are included in the ['baked' directory here.](https://github.com/imageworks/OpenColorIO-Configs/tree/master/aces_1.1/baked)
245295

246296
- The LUTs encode the ACES Output Transform for a specific colorspace input and are generally named:
247-
- 'Output Transform name' for 'Input colorspace name'.extension
248-
- Ex. 'sRGB (D60 sim.) for ACEScc.icc'
297+
- 'Output Transform name' for 'Input colorspace name'.extension
298+
- Ex. 'sRGB (D60 sim.) for ACEScc.icc'
249299

250300
The LUTs included in the 'baked' directory cover the following formats and applications:
251301

@@ -260,6 +310,7 @@ Generating Configurations
260310
-
261311

262312
### Python
313+
263314
Configurations can be generated by the following *Python* package: [aces_1.1/python](https://github.com/imageworks/OpenColorIO-Configs/tree/master/aces_1.1/python)
264315

265316
Usage is described on the command line and in the package root [\_\_init__.py](https://github.com/imageworks/OpenColorIO-Configs/blob/master/aces_1.1/python/aces_ocio/__init__.py) file.
@@ -271,8 +322,10 @@ Features exposed for customization by the user include:
271322
- Two modes of creating the list of OCIO Displays and Views
272323
- Selection of shaper function: Log2 or Dolby PQ
273324

325+
274326
### CTL Source
275-
The configuration depends on the **ACES 1.1** release. The release contains a number of file renames and the new ACEScct color space and a number of minor bug fixes and small additions, but is otherwise very similar as the master **ACES 1.0.2** release.
327+
328+
The configuration depends on the **ACES 1.1** release.
276329

277330
The CTL is available here:
278331

@@ -285,37 +338,20 @@ Clone this repo using the following command:
285338

286339
Dependencies
287340
-
341+
288342
The *Python* configuration generation package depends on the following
289343
libraries:
290344

291345
- **OpenImageIO**: http://openimageio.org
292-
- Detailed build instructions can be found here: [OpenImageIO Build Instructions](https://sites.google.com/site/openimageio/checking-out-and-building-openimageio)
346+
- Detailed build instructions can be found here: [OpenImageIO Build Instructions](https://sites.google.com/site/openimageio/checking-out-and-building-openimageio)
293347
- **OpenColorIO**: http://opencolorio.org
294-
- Detailed build instructions can be found here: [OpenColorIO Build Instructions](http://opencolorio.org/installation.html)
348+
- Detailed build instructions can be found here: [OpenColorIO Build Instructions](http://opencolorio.org/installation.html)
295349
- **CTL**: https://github.com/ampas/CTL
296350

297351

298-
Building on Mac OSX
299-
-
300-
Use the following commands to build these packages on Mac OSX
301-
302-
- OpenColorIO
303-
- brew install -vd opencolorio --with-python
304-
- Update the homebrew repository of install scripts to make sure that OpenImageIO is included.
305-
- brew tap homebrew/science
306-
- Optional Dependencies for OpenImageIO
307-
- brew install -vd libRaw
308-
- brew install -vd OpenCV
309-
- OpenImageIO
310-
- brew install -vd openimageio --with-python
311-
- CTL
312-
- brew install -vd CTL
313-
- OpenColorIO, a second time. *ociolutimage* will build with *openimageio* installed.
314-
- brew uninstall -vd opencolorio
315-
- brew install -vd opencolorio --with-python
316-
317-
Thanks
318-
------
352+
Acknowledgements
353+
-
354+
319355
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:
320356

321357
- Steve Agland
@@ -338,8 +374,15 @@ The script used to generate these transforms and the transforms themselves were
338374
- Doug Walker
339375
- Kevin Wheatley
340376

341-
Author
342-
------
377+
378+
Authorship and Maintenance
379+
--------------------------
380+
343381
The original author of this OCIO config is:
344382

345383
- Haarm-Pieter Duiker
384+
385+
The current maintainers are:
386+
387+
- Thomas Mansencal
388+
- Michael Parsons

0 commit comments

Comments
 (0)