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

Commit 5533cfa

Browse files
committed
Update "README.md" file.
1 parent 5bf2f9a commit 5533cfa

File tree

1 file changed

+60
-54
lines changed

1 file changed

+60
-54
lines changed

aces_1.2/README.md

Lines changed: 60 additions & 54 deletions
Original file line numberDiff line numberDiff line change
@@ -16,9 +16,9 @@ The latest documentation on the ACES transforms and specifications can be found
1616
Colorspaces
1717
-
1818

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

21-
For ease of use across a broader number of applications, the family name of each colorspace is pre-pended 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.
21+
For ease of use across a broader number of applications, the family name of each colorspace is prepended to the colorspace name when the configuration is authored. Those prefixes are omitted in this document, but will show up when the configuration is loaded and used.
2222

2323

2424
### ACES
@@ -39,7 +39,7 @@ Colorspaces and transforms representing the core ACES working and interchange co
3939

4040
##### Technical information
4141

42-
Transforms generated based on the [ACES CTL Transforms](https://github.com/ampas/aces-dev/tree/v1.2/transforms/ctl)
42+
The generated transforms are based on the [ACES CTL Transforms](https://github.com/ampas/aces-dev/tree/v1.2/transforms/ctl)
4343

4444

4545
### Output
@@ -50,6 +50,9 @@ Transforms generated based on the [ACES CTL Transforms](https://github.com/ampas
5050
- DCDM (P3D60 Limited)
5151
- DCDM (P3D65 Limited)
5252
- P3-D60
53+
- P3-D65 ST2084 (1000 nits)
54+
- P3-D65 ST2084 (2000 nits)
55+
- P3-D65 ST2084 (4000 nits)
5356
- P3-DCI (D60 simulation)
5457
- P3-DCI (D65 simulation)
5558
- P3D65
@@ -71,13 +74,13 @@ Transforms generated based on the [ACES CTL Transforms](https://github.com/ampas
7174

7275
##### Description
7376

74-
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.
77+
Colorspaces and transforms implementing the ACES Output Transforms. These colorspaces produce code values ready for display on display devices calibrated to the standard used to name the colorspace.
7578

7679

7780
##### Technical information
7881

7982
- Transforms generated based on the [ACES CTL Transforms](https://github.com/ampas/aces-dev/tree/v1.2/transforms/ctl)
80-
- All transforms produce full-range output. Host applications should be used to apply an full-to-legal scaling needed.
83+
- All transforms produce full-range output. Host applications should be used to apply an full-to-legal scaling if required.
8184

8285

8386
### Input
@@ -94,13 +97,14 @@ Colorspaces and transforms that implement the ACES Input Transforms. These color
9497

9598
##### Technical information
9699

97-
References and descriptions are provided for each group of Input Transforms below.
100+
References and descriptions are provided for each group of Input Transforms below:
101+
98102
- The colorspaces whose names include a transfer function and a gamut name are full implementations of ACES Input Transforms.
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.
103+
- Ex. The ARRI `V3 LogC (EI160) - Wide Gamut` colorspace
104+
- Ex. The RED `REDlogFilm - DRAGONcolor2` colorspace
105+
- Ex. The Canon `Canon-Log - DCI-P3 Daylight` colorspace
106+
- The colorspaces starting with `Linear - ` convert to or from a specific gamut but do not apply a transfer function.
107+
- The colorspaces starting with `Curve - ` apply a transfer function but do not convert between gamuts.
104108

105109

106110
#### ADX
@@ -175,10 +179,10 @@ A collection of colorspaces that are used to facilitate the creation of LUTs and
175179

176180
##### Technical information
177181

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.
182+
- 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.
179183
- 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.
184+
- The colorspaces starting with `Linear - ` convert to or from a specific gamut but do not apply a transfer function.
185+
- The colorspaces starting with `Curve - ` apply a transfer function but do not convert between gamuts.
182186

183187

184188
#### Look
@@ -208,7 +212,7 @@ Transforms generated based on the [ACES CTL Transforms](https://github.com/ampas
208212

209213
##### Description
210214

211-
The role colorspaces are aliases to the colorspaces used for the *OCIO* 'roles' functionality.
215+
The role colorspaces are aliases to the colorspaces used for the *OCIO* *roles* functionality.
212216

213217

214218
#### Aliases
@@ -225,15 +229,15 @@ Roles
225229

226230
The standard *OCIO* roles are defined. They role assignments are:
227231

228-
- **color_picking**: Output - Rec.709
229-
- **color_timing**: ACEScc
230-
- **compositing_log**: ADX10
231-
- **data**: Raw
232-
- **default**: ACES2065-1
233-
- **matte_paint**: ACEScc
234-
- **reference**: Raw
235-
- **scene_linear**: ACEScg
236-
- **texture_paint**: Raw
232+
- `color_picking`: Output - sRGB
233+
- `color_timing`: ACEScc
234+
- `compositing_log`: ADX10
235+
- `data`: Raw
236+
- `default`: ACES2065-1
237+
- `matte_paint`: ACEScc
238+
- `reference`: Raw
239+
- `scene_linear`: ACEScg
240+
- `texture_paint`: Raw
237241

238242
Additionally, a number of colorspaces that are gaining wider adoption have been added to the config. Their names and assignment are:
239243

@@ -246,36 +250,39 @@ Displays and Views
246250

247251
The default config has one Display named **ACES**, which contains the following Views / colorspaces:
248252

249-
- sRGB, colorspace: sRGB
250-
- DCDM, colorspace: DCDM
251-
- DCDM P3D60 Limited, colorspace: DCDM (P3D60 Limited)
252-
- DCDM P3D65 Limited, colorspace: DCDM (P3D65 Limited)
253-
- P3-D60, colorspace: P3-D60
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)
260-
- Rec.2020, colorspace: Rec.2020
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)
267-
- Rec.709, colorspace: Rec.709
268-
- Rec.709 D60 sim., colorspace: Rec.709 (D60 sim.)
269-
- sRGB D60 sim., colorspace: sRGB (D60 sim.)
270-
- Raw, colorspace: Raw
271-
- Log, colorspace: ADX - ADX10
253+
- DCDM P3D60 Limited, colorspace: Output - DCDM (P3D60 Limited)
254+
- DCDM P3D65 Limited, colorspace: Output - DCDM (P3D65 Limited)
255+
- DCDM, colorspace: Output - DCDM
256+
- P3-D60, colorspace: Output - P3-D60
257+
- P3-D65 ST2084 1000 nits, colorspace: Output - P3-D65 ST2084 (1000 nits)
258+
- P3-D65 ST2084 2000 nits, colorspace: Output - P3-D65 ST2084 (2000 nits)
259+
- P3-D65 ST2084 4000 nits, colorspace: Output - P3-D65 ST2084 (4000 nits)
260+
- P3-DCI D60 simulation, colorspace: Output - P3-DCI (D60 simulation)
261+
- P3-DCI D65 simulation, colorspace: Output - P3-DCI (D65 simulation)
262+
- P3D65 D60 simulation, colorspace: Output - P3D65 (D60 simulation)
263+
- P3D65 Rec.709 Limited, colorspace: Output - P3D65 (Rec.709 Limited)
264+
- P3D65 ST2084 108 nits, colorspace: Output - P3D65 ST2084 (108 nits)
265+
- P3D65, colorspace: Output - P3D65
266+
- Rec.2020 HLG 1000 nits, colorspace: Output - Rec.2020 HLG (1000 nits)
267+
- Rec.2020 P3D65 Limited, colorspace: Output - Rec.2020 (P3D65 Limited)
268+
- Rec.2020 Rec.709 Limited, colorspace: Output - Rec.2020 (Rec.709 Limited)
269+
- Rec.2020 ST2084 1000 nits, colorspace: Output - Rec.2020 ST2084 (1000 nits)
270+
- Rec.2020 ST2084 2000 nits, colorspace: Output - Rec.2020 ST2084 (2000 nits)
271+
- Rec.2020 ST2084 4000 nits, colorspace: Output - Rec.2020 ST2084 (4000 nits)
272+
- Rec.2020, colorspace: Output - Rec.2020
273+
- Rec.709 D60 sim., colorspace: Output - Rec.709 (D60 sim.)
274+
- Rec.709, colorspace: Output - Rec.709
275+
- sRGB D60 sim., colorspace: Output - sRGB (D60 sim.)
276+
- sRGB, colorspace: Output - sRGB
277+
- Raw, colorspace: Utility - Raw
278+
- Log, colorspace: Input - ADX - ADX10
272279

273280
Considerations for custom config generation:
274281

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

280287

281288
LUTs
@@ -293,11 +300,9 @@ The LUTs used internally by OCIO can be can be retrieved [from the repository he
293300

294301
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.2/baked)
295302

296-
- The LUTs encode the ACES Output Transform for a specific colorspace input and are generally named:
297-
- 'Output Transform name' for 'Input colorspace name'.extension
298-
- Ex. 'sRGB (D60 sim.) for ACEScc.icc'
303+
- The LUTs encode the ACES Output Transform for a specific colorspace input and are generally named *{OUTPUT_TRANSFORM_NAME} for {INPUT_COLORSPACE_NAME}.extension* e.g. `sRGB (D60 sim.) for ACEScc.icc`
299304

300-
The LUTs included in the 'baked' directory cover the following formats and applications:
305+
The LUTs included in the `baked` directory cover the following formats and applications:
301306

302307
- .3dl for Autodesk Flame
303308
- .3dl for Autodesk Lustre
@@ -320,7 +325,7 @@ Features exposed for customization by the user include:
320325
- The resolution of 1D and 3D LUTs
321326
- Inclusion of custom Looks
322327
- Two modes of creating the list of OCIO Displays and Views
323-
- Selection of shaper function: Log2 or Dolby PQ
328+
- Selection of shaper function: *Log2* or Dolby *PQ*
324329

325330

326331
### CTL Source
@@ -347,6 +352,7 @@ libraries:
347352
- **OpenColorIO**: http://opencolorio.org
348353
- Detailed build instructions can be found here: [OpenColorIO Build Instructions](http://opencolorio.org/installation.html)
349354
- **CTL**: https://github.com/ampas/CTL
355+
- **Numpy**: https://numpy.org/
350356

351357

352358
Acknowledgements

0 commit comments

Comments
 (0)