Skip to content

Commit

Permalink
merge branch 'dev' into 'master' for v1.2
Browse files Browse the repository at this point in the history
  • Loading branch information
@scottdyer
scottdyer committed Apr 1, 2020
2 parents 76ea982 + 3610c11 commit 518c27f
Show file tree
Hide file tree
Showing 1,140 changed files with 7,911 additions and 2,667 deletions.
33 changes: 31 additions & 2 deletions CHANGELOG.md
View file
@@ -1,3 +1,33 @@
**Version 1.2 (April 1, 2020):**

* New Features:
* Add ACES Metadata File specification document (S-2019-001), XML schema, and example files
* Add new version of Common LUT Format specification document (S-2014-006)
* Add new ACES Project Organization and Development Procedure document (P-2019-001)
* Add ACES Color Space Conversion transforms between:
* ACES and Canon Canon Log 2 Cinema Gamut
* ACES and Canon Canon Log 3 Cinema Gamut
* ACES and ARRI ALEXA LogC (EI800) WideGamut
* ACES and RED Log3G10 REDWideGamutRGB
* ACES and Sony S-Log3 S-Gamut3
* ACES and Sony S-Log3 S-Gamut3.Cine
* ACES and Panasonic Varicam V-Log V-Gamut
* Add HDR Output Transforms (RRT+ODT):
* P3D65 (1000 cd/m^2) ST.2084 (and inverse)
* P3D65 (2000 cd/m^2) ST.2084 (and inverse)
* P3D65 (4000 cd/m^2) ST.2084 (and inverse)
* Add vendor-supplied IDTs for Sony VENICE
* Bug Fixes:
* Add missing D65 to D60 CAT to 'InvODT.Academy.P3DCI_D65sim_48nits.ctl'
* Other:
* Revert function parameters of ODTs with full/legal option from 'uniform bool' to 'varying int'
* Update ACES System Versioning document (S-2014-002)
* Update TransformIDs of ACES reference implementation transforms
* Remove "Academy Color Encoding System (ACES) Clip-level Metadata File Format Definition and Usage" (TB-2014-009)
* Add reference images to accompany new ACEScsc transforms
* Various minor typo fixes in document LaTeX source files


**Version 1.1 (June 21, 2018):**

* New Features:
Expand Down Expand Up @@ -26,7 +56,6 @@
* DolbyPQ_to_HLG_1000nits
* HLG_to_DolbyPQ_1000nits
* Add HDR Output Transforms (RRT+ODT):
* P3D65 (108 cd/m^2) ST.2084 - designed for use in Dolby Cinema (and inverse)
* Rec.2020 (1000 cd/m^2) ST.2084 (and inverse)
* Rec.2020 (2000 cd/m^2) ST.2084 (and inverse)
* Rec.2020 (4000 cd/m^2) ST.2084 (and inverse)
Expand Down Expand Up @@ -57,7 +86,7 @@
* Miscellaneous typo fixes in CTL transform comments
* Miscellaneous README and CTL comment updates
* Miscellaneous LaTeX documentation typo and code fixes
* Update ACEStranformIDs where appropriate
* Update ACEStransformIDs where appropriate
* Update README and CHANGELOG

**Version 1.0.3 (September 20, 2016):**
Expand Down
79 changes: 31 additions & 48 deletions README.md
View file
Expand Up @@ -14,71 +14,54 @@ This toolkit is intended to serve as a distribution mechanism for key components
### Package Contents ###

* [`documents/`](./documents) – ACES-related documents
* [`formats/`](./formats) - ACES file formats code and examples
* [`images/`](./images) - "golden" images created using the reference implementation transforms
* [`transforms/`](./transforms) - ACES reference implementation transforms

### Changes from Previous Release ###

Though the "master" branch is 1.1, the current major version of ACES remains 1. This means the 1.1 update adds a number of transforms but does not change the look or modify the existing core transforms (beyond addressing reported bugs and/or inconsequential formatting/whitespace changes).
Though the "master" branch is 1.2, the current major version of ACES remains 1. This means the 1.2 update adds a number of transforms but does not change the look or modify the existing core transforms (beyond addressing reported bugs and/or inconsequential formatting/whitespace changes).

As always, you should check the hotfixes and dev branches for the latest bug fixes and new features that will ultimately be rolled into a future version of ACES. Improvements will continue to be staged on the dev branch for testing as they become available.

Included in ACES 1.1:
Included in ACES 1.2:

* New Features:
* Add P3 ODTs:
* P3D65 (and inverse)
* P3D65 "D60 simulation" (i.e. D60 adapted white point) (and inverse)
* P3DCI "D65 simulation" (i.e. D65 adapted white point) (and inverse)
* P3D65 limited to Rec.709 (inverse not required)
* Add Rec.2020 ODTs:
* Rec.2020 limited to Rec.709 (inverse not required)
* Rec.2020 limited to P3D65 (inverse not required)
* Add DCDM ODT:
* DCDM with D65 adapted white point and limited to P3D65 (and inverse)
* Add new ACESlib files:
* SSTS: code for the Single Stage Tone Scale used in HDR Output Transforms
* OutputTransforms: beginning of modules needed for parameterizing Output Transforms
* Add ACES Metadata File specification document (S-2019-001), XML schema, and example files
* Add new version of Common LUT Format specification document (S-2014-006)
* Add new ACES Project Organization and Development Procedure document (P-2019-001)
* Add ACES Color Space Conversion transforms between:
* ACES and Canon Canon Log 2 Cinema Gamut
* ACES and Canon Canon Log 3 Cinema Gamut
* ACES and ARRI ALEXA LogC (EI800) WideGamut
* ACES and RED Log3G10 REDWideGamutRGB
* ACES and Sony S-Log3 S-Gamut3
* ACES and Sony S-Log3 S-Gamut3.Cine
* ACES and Panasonic Varicam V-Log V-Gamut
* Add HDR Output Transforms (RRT+ODT):
* P3D65 (108 cd/m^2) ST.2084 - designed for use in Dolby Cinema (and inverse)
* Rec.2020 (1000 cd/m^2) ST.2084 (and inverse)
* Rec.2020 (2000 cd/m^2) ST.2084 (and inverse)
* Rec.2020 (4000 cd/m^2) ST.2084 (and inverse)
* Rec.2020 (1000 cd/m^2) HLG (and inverse)
* Add new subfunctions to existing ACESlib files
* Add new ACESutil functions
* Remove HDR ODTs (and inverses)
* Rename some existing transforms for clarity:
* Rename `DCDM_P3D60` to `DCDM_P3D60limited`
* Rename `P3DCI` to `P3DCI_D60sim`
* Rename `RGBmonitor` to `sRGB`
* Add LMT that can help correct bright blue light clipping or hue shifts
* Add new reference images for new transforms
* Add documentation:
* TB-2018-001 - Derivation of the ACES White Point CIE Chromaticity Coordinates
* Bug Fixes:
* Arri IDT - Improve linearization of LogC data
* P3D65 (1000 cd/m^2) ST.2084 (and inverse)
* P3D65 (2000 cd/m^2) ST.2084 (and inverse)
* P3D65 (4000 cd/m^2) ST.2084 (and inverse)
* Add vendor-supplied IDTs for Sony VENICE
* Other:
* Miscellaneous white space, line wrap, and typo fixes
* Miscellaneous README and CTL comment updates
* Miscellaneous LaTeX documentation typo and code fixes
* Update ACEStranformIDs where appropriate
* Update README and CHANGELOG
* Update ACES System Versioning document (S-2014-002)
* Update TransformIDs of ACES reference implementation transforms
* Remove "Academy Color Encoding System (ACES) Clip-level Metadata File Format Definition and Usage" (TB-2014-009)
* Add reference images to accompany new ACEScsc transforms

For a more detailed list of changes see the [CHANGELOG](./CHANGELOG.md) and in the [commit history](https://github.com/ampas/aces-dev/commits/master).

#### Notes on New ODTs ####
#### Notes on the new ACES Metadata Files (AMF) specification ####
ACES 1.2 includes the new ACES Metadata File (AMF) specification that replaces the ACES Clip-level Metadata File Format (ACESclip). AMF is documented in Academy Specification S-2019-001 and TB-2014-009 has been retracted. AMF offers a simplified means to describe the transforms necessary to configure an ACES viewing pipeline for a collection of related ACES image files. AMF supports a mechanism to communicate the ACES Look Transforms and the working color space in which ASC-CDL based Looks are applied enabling the communication of Look information throughout production and post-production. A series of new ACES Color Space Conversion (ACEScsc) transforms have been added with the expectation that these transforms may be useful working spaces for the application of ACES ASC-CDL based Look Transforms. Also included in the release is an XML schema for the AMF and example AMF files.

A series of new standard dynamic range (SDR) ODTs are included in this release. These ODTs were added at the request of the ACES Community based on their production needs. Examples include: P3 ODTs for devices with a D65 calibration white point, simulation of a D65 white point on a P3 device with a DCI calibration white point, and limiting of output image colorimetry to Rec.709 when using a P3D65 calibrated device. Additional limiting ODTs were also added for Rec.2020 to restrict the image colorimetry to Rec.709 and P3. A DCDM ODT with limiting to P3D65 were added to compliment the existing DCDM ODT with limiting to P3D60. These transforms provide support for additional use cases not included in previous ACES releases.
#### Notes on the updated Common LUT Format (CLF) specification ####
ACES 1.2 also includes an updated version of the Common LUT Format (CLF) specification. This new version includes changes based on feedback from the ACES community. It adds additional operators to the specification and the document has been substantially revised to more clearly communicate its intent.

#### Notes on New HDR Output Transforms ####
#### Notes on the updated ACES System Versioning Documentation ####
The ACES System Versioning Documentation has been updated to support additional vendor- and user-supplied transform types, improve TransformID format consistency, version control for the TransformID format, and to provide a means for automated systems to recognize the presence of ACES TransformIDs and identify their version. All transforms in the ACES reference implementation have been updated to conform to the new TransformID format.

ACES 1.1 also includes the first release of a series of Output Transforms that combine the RRT and an ODT into a single transform. The new Output Transforms replace the previous HDR ODTs. The new Output Transforms are based on a unified, parametric output function. These individual Output Transforms pass a series of parameters to the underlying output function to improve the consistency of the image processing operations. Examples of the parameters that that are specified in the Output Transforms include: display primaries, display white point, display max luminance, display min luminance, luminance reproduction of mid-gray, limiting primaries (if any), surround, display EOTF, etc. In the future, this will make it trivial to generate Output Transforms for non-standard devices.

Output Transforms using the underlying parametric output function are only provided for HDR devices in dark surround environments at this time, although the transforms are suitable for use in both dark and dim surround environments (they’ve been used this way on several major motion pictures with a corresponding “trim pass” to adjust contrast and saturation). Modifying the surround parameter inside the individual HDR Output Transforms has no effect when the EOTF is set to either ST-2084(PQ) or HLG. A functional dim surround compensation for HDR devices will be addressed in a future ACES release.

#### Notes on rename of some existing transforms ####
The CTL file names and values of <ACESuserName> of some of the existing ACES transforms have been modified for clarity. In each case, the output code values from the transform remains the same. Academy S-2014-002 states “Any transform updates that do not change the output of that transform shall not require the Transform Identifier to be incremented – e.g. whitespace changes, modifications to code comments, etc.” For this reason, the values <ACEStransformID> have not been changed. Implementors should take care to update their user interfaces to display the new values of <ACESuserName> where applicable and to alert end-users of the name changes in their product documentation.
#### Notes on the new ACES Project Organization and Development Procedure ###
In early 2019, ACES leadership established a revised organizational structure and development procedures for the ACES project. The new structure and development procedures were modeled after those adopted by the Academy Software Foundation, with the goals of increasing visibility into the development of ACES, enabling greater global participation in the ACES development process, providing accountability mechanisms, and better documenting the decision making process. The revised structure and development procedures are detailed in Academy Procedure P-2019-001.

### Versioning ###

Expand Down Expand Up @@ -117,7 +100,7 @@ Academy under the following terms and conditions: A worldwide, royalty-free,
non-exclusive right to copy, modify, create derivatives, and use, in source and
binary forms, is hereby granted, subject to acceptance of this license.

Copyright 2018 Academy of Motion Picture Arts and Sciences (A.M.P.A.S.).
Copyright 2019 Academy of Motion Picture Arts and Sciences (A.M.P.A.S.).
Portions contributed by others as indicated. All rights reserved.

Performance of any of the aforementioned acts indicates acceptance to be bound
Expand Down
13 changes: 7 additions & 6 deletions documents/LaTeX/ACES-Document-Manifest/ACES-Document-Manifest.tex
View file
Expand Up @@ -9,14 +9,15 @@
\regularsectionformat

\section*{ACES Document Manifest}
Current document versions as of 06/15/2018.
Current document versions as of 04/01/2020.

\subsection*{Procedures}
\begin{tabularx}{\linewidth}{|l X|c|}
% Document Number | Document Name | Date
\hline
\textbf{Document} & & \textbf{Date Modified} \\ \hline
P-2013-001 & Recommended Procedures for the Creation and Use of Digital Camera System Input Device Transforms (IDTs) & 03/29/2016 \\ \hline
P-2013-001 & Recommended Procedures for the Creation and Use of Digital Camera System Input Device Transforms (IDTs) & 01/23/2020 \\ \hline
P-2019-001 & ACES Project Organization and Development Procedure & 04/08/2019 \\ \hline
\end{tabularx}

\subsection*{Specifications}
Expand All @@ -25,25 +26,25 @@ \subsection*{Specifications}
\hline
\textbf{Document} & & \textbf{Date Modified} \\ \hline
S-2013-001 & ACESproxy -- An Integer Log Encoding of ACES Image Data & 07/18/2016 \\ \hline
S-2014-002 & Academy Color Encoding System -- Versioning System & 06/07/2016 \\ \hline
S-2014-002 & Academy Color Encoding System -- Versioning System & 12/13/2019 \\ \hline
S-2014-003 & ACEScc -- A Logarithmic Encoding of ACES Data for use within Color Grading Systems & 07/18/2016 \\ \hline
S-2014-004 & ACEScg -- A Working Space for CGI Render and Compositing & 03/29/2016 \\ \hline
S-2014-006 & A Common File Format for Look-Up Tables & 03/29/2016 \\ \hline
S-2014-006 & Common LUT Format (CLF) -- A Common File Format for Look-Up Tables & 03/30/2020 \\ \hline
S-2016-001 & ACEScct -- A Quasi-Logarithmic Encoding of ACES Data for use within Color Grading Systems & 09/20/2016 \\ \hline
S-2019-001 & ACES Metadata File (AMF) & 03/26/2020 \\ \hline
\end{tabularx}

\subsection*{Technical Bulletins}
\begin{tabularx}{\linewidth}{|l X|c|}
% Document Number | Document Name | Date
\hline
\textbf{Document} & & \textbf{Date Modified} \\ \hline
TB-2014-001 & Academy Color Encoding System (ACES) Documentation Guide & 03/29/2016 \\ \hline
TB-2014-001 & Academy Color Encoding System (ACES) Documentation Guide & 04/01/2020 \\ \hline
TB-2014-002 & Academy Color Encoding System (ACES) Version 1.0 User Experience Guidelines & 03/29/2016 \\ \hline
TB-2014-004 & Informative Notes on SMPTE ST 2065-1 -- Academy Color Encoding Specification (ACES) & 03/29/2016 \\ \hline
TB-2014-005 & Informative Notes on SMPTE ST 2065-2 -- Academy Printing Density (APD) -- Spectral Responsivities, Reference Measurement Device and Spectral Calculation and SMPTE ST 2065-3 Academy Density Exchange Encoding (ADX) -- Encoding Printing Density (APD) Values & 03/29/2016 \\ \hline
TB-2014-006 & Informative Notes on SMPTE ST 2065-4 -- ACES Image Container File Layout & 03/29/2016 \\ \hline
TB-2014-007 & Informative Notes on SMPTE ST 268:2014 -- File Format for Digital Moving Picture Exchange (DPX) & 03/29/2016 \\ \hline
TB-2014-009 & Academy Color Encoding System (ACES) Clip-level Metadata File Format Definition and Usage & 03/29/2016 \\ \hline
TB-2014-010 & Design, Integration and Use of ACES Look Modification Transforms & 03/29/2016 \\ \hline
TB-2014-012 & Academy Color Encoding System (ACES) Version 1.0 Component Names & 03/29/2016 \\ \hline
TB-2014-013 & Alternate ACES Viewing Pipeline User Experience & 03/29/2016 \\ \hline
Expand Down
2 changes: 1 addition & 1 deletion documents/LaTeX/P-2013-001/P-2013-001.tex
View file
Expand Up @@ -8,7 +8,7 @@
% Sets the document name used in header - usually an abbreviated document title
\docnumber{P-2013-001}
\committeename{Academy Color Encoding System (ACES) Project Committee}
\docdate{March 29, 2016}
\docdate{January 23, 2020}
\summary{
In the Academy Color Encoding System, an Input Device Transform (IDT) processes non-color-rendered RGB image values from a digital camera system's capture of a scene lit by an assumed illumination source (the scene adopted white). The results of this process are white-balanced ACES RGB relative exposure values.

Expand Down

0 comments on commit 518c27f

Please sign in to comment.