Skip to content

Commit

Permalink
update ACES system components
Browse files Browse the repository at this point in the history
  * update RRT
  * update all ODTs
  * add new ODTs for display devices which conform to ITU-R BT.2020
  * rename ODTs to better reflect their intended usage
  * add Inverse RRT and ODT transforms
  * add ACESlog and ACESproxy reference implementations
  * documents binaries removed and replaced with links
  • Loading branch information
scottdyer committed Jul 26, 2013
1 parent 25ee3c5 commit 339318f
Show file tree
Hide file tree
Showing 950 changed files with 10,148 additions and 2,455 deletions.
26 changes: 0 additions & 26 deletions .gitignore

This file was deleted.

13 changes: 0 additions & 13 deletions CHANGELOG

This file was deleted.

24 changes: 24 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
**Version 0.2 (August 2, 2013):**
* Updates RRT
* Updates ODTs
* Adds ODTs for display devices which conform to ITU-R BT.2020
* ODTs renamed to better reflect their intended usage
* Adds Inverse RRT and ODT transforms
* Adds ACESlog and ACESproxy documentation, reference implementations, and images
* ctlrender removed - now part of CTL
* Documents binaries removed and replaced with links
* New distribution links for golden reference images

**Version 0.1.1 (June 25, 2012):**
* Adds dw ratio preserving ODT tone curve
* Fixes possible underflow conditions in RRT and ODT CTL transforms
* Bug fix in ctlrender to avoid streaks in output images
* Adds reverse RRT and RDT splines
* Modifies RDT spline coefficients to tweak shadow reproduction

**Version 0.1 (March 1, 2012):**
* Initial Release
* Transforms including RRT
* Test Images
* ctlrender sample application for processing images through CTL transforms
* ACES, ADX, and CTL documentation
17 changes: 9 additions & 8 deletions LICENSE → LICENSE.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,20 @@
License Terms for Academy Color Encoding System Components
# License Terms for Academy Color Encoding System Components #

Academy Color Encoding System (ACES) software and tools are provided by the
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 © 2013 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
by the following terms and conditions:

Copies of source code, in whole or in part, must retain the above copyright
* Copies of source code, in whole or in part, must retain the above copyright
notice, this list of conditions and the Disclaimer of Warranty.

Use in binary form must retain the copyright notice (below), this list of
* Use in binary form must retain the above copyright notice, this list of
conditions and the Disclaimer of Warranty in the documentation and/or other
materials provided with the distribution.

Expand All @@ -23,13 +27,10 @@ software may be used to endorse or promote products derivative of or based on
this software without express prior written permission of A.M.P.A.S. or the
contributors, as appropriate.

* This license shall be construed pursuant to the laws of the State of
This license shall be construed pursuant to the laws of the State of
California, and any disputes related thereto shall be subject to the
jurisdiction of the courts therein.

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

Disclaimer of Warranty: THIS SOFTWARE IS PROVIDED BY A.M.P.A.S. AND CONTRIBUTORS
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND
Expand All @@ -46,4 +47,4 @@ WITHOUT LIMITING THE GENERALITY OF THE FOREGOING, THE ACADEMY SPECIFICALLY
DISCLAIMS ANY REPRESENTATIONS OR WARRANTIES WHATSOEVER RELATED TO PATENT OR
OTHER INTELLECTUAL PROPERTY RIGHTS IN THE ACADEMY COLOR ENCODING SYSTEM, OR
APPLICATIONS THEREOF, HELD BY PARTIES OTHER THAN A.M.P.A.S.,WHETHER DISCLOSED OR
UNDISCLOSED.
UNDISCLOSED.
181 changes: 181 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,181 @@
## Academy Color Encoding System Developer Resources ##

The Academy Color Encoding System (ACES) is a set of components that facilitates
a wide range of motion picture workflows while eliminating the ambiguity of
today's file formats. The framework is designed to support both all digital and
hybrid film-digital motion picture workflows.

The basic ACES components are:

* Color encoding and metric specifications, file format specifications, color
transformations, and an open source reference implementation.
* A set of reference images and calibration targets for film scanners and
recorders
* Documentation on the architecture and software tools

This toolkit is intended to serve as a distribution mechanism for key components
of the framework including the reference implementation transforms, reference
images, and documentation.

### Package Contents ###

* [`documents/`](./documents) - ACES related documents
* [`images/`](./images) - "golden" images created using the reference implementation transforms
* [`transforms/`](./transforms) - ACES reference implementation transforms

### Changes from Previous Releases ###

__Reference Rendering Transform__

The Reference Rendering Transform (RRT) included with this release has changed
substantially from previous versions. These changes greatly simplify the
algorithm while also changing the default look of the images to something that
is believed to be a better starting point for creative adjustments.

The algorithmic complexity of previous RRT versions prohibited the creation of a
closed-form inverse. This complicated the creation of custom looks that
required an inverse RRT. This package includes both forward and
inverse RRT and ODTs enabling the creation of Look Modification Transforms
(LMTs) using those transforms. Gamut coverage has been increased compared to
previous versions in both OCES and the output display color spaces ensuring full
compatibility with existing and future display devices. Through the use of LMTs
an infinite number of custom looks is now possible.

Feedback on previous versions of the RRT indicated deficiencies in some highly
saturated colors and a decreased ability to grade around the default look using
common color grading tools. Both these issues have been addressed with the
version of the RRT included in this package. As noted earlier, this alters the
default look associated with the ACES system but an LMT has been provided for
those who preferred the look associated with ACES v0.1.1.

__Output Device Transforms__

The form of the Output Device Transforms (ODTs) included with this release has
changed from previous versions. These ODTs better handle differences between
display devices such as black point, white point, and gamut differences. These
changes represent the latest work from the ACES committee, however, work on ODTs
is on-going and future improvements are expected.

This package includes numerous ODTs not in the previous release. See the
comments in the CTL transforms located in [`transforms/ctl/odt`](./transforms/ctl/odt) for more details.

__Look Modification Transforms__

This version of the ACES developer resources package includes sample Look
Modification Transforms (LMTs). These LMTs are provided as proof-of-concept
implementations. See [`transforms/ctl/lmt/README.md`](./transforms/ctl/lmt/README.md) for more information.

__Input Device Transforms__

The Input Device Transforms (IDTs) included with this package have been moved to
a subdirectory labeled `vendorSupplied`. Additional camera IDTs are now
available from that directory. They are provided as part of this repository for
convenience only. Users should always contact the manufacturer directly to
confirm they have the latest IDTs for their camera. See
[`transforms/ctl/idt/README.md`](./transforms/ctl/idt/README.md) for more information

__ACESproxy and ACESlog__

Two new encodings known as ACESproxy and ACESlog are now included with this
package. They are intended to enable consistent on-set preview and color
grading of ACES images. See the associated documents, images, and reference
implementations for more details.

__Package Contents Changes__

The package contents has changed from previous releases. All image and
document binary files have been moved out of the git repository and are now
hosted on dropbox. This was done to avoid the git repository becoming
unmanageably large. The ctlrender application previously supplied as part of
this package has now been moved to the official CTL git repository.

### Versioning ###

The links to the current and all past versions of the ACES Developer Resources
can be found version controlled with the git source control management system
and hosted on Github at https://github.com/ampas/aces-dev.

### Branch Structure ###

__Master Branch__

The current release version of ACES can always be found at the HEAD of the
master branch. Previous release versions are tagged and are also commits on the
master. The master branch contains no intermediate commits so all commits on
the master branch are tagged and represent a release of ACES.

__Dev Branch__

All commits between releases will be on the dev branch. Commits on the dev
branch will be included in the next release version. Commits staged on the dev
branch, but not yet merged into the master, should be considered non-critical.
All intermediate commits for a release will be staged on the dev branch before
being merged into the master and tagged.

__Hotfixes Branch__

In some cases it may be necessary to create a hotfixes branch. The hotfixes
branch will include important, but not fully tested, fixes for bugs found in a
particular release.
Hotfixes should only be implemented by developers if the bug they are intended
to correct is encountered in the course of production and is deemed to be a
barrier to using a particular ACES release. Hotfixes, once fully tested, will
be merged into dev branch, and ultimately the master.

## Prerequisites ##

### Color Transformation Language ###

Color Transformation Language (CTL) can be downloaded from
https://github.com/ampas/CTL

## License Terms for Academy Color Encoding System Components ##

Academy Color Encoding System (ACES) software and tools are provided by the
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 © 2013 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
by the following terms and conditions:

* Copies of source code, in whole or in part, must retain the above copyright
notice, this list of conditions and the Disclaimer of Warranty.

* Use in binary form must retain the above copyright notice, this list of
conditions and the Disclaimer of Warranty in the documentation and/or other
materials provided with the distribution.

* Nothing in this license shall be deemed to grant any rights to trademarks,
copyrights, patents, trade secrets or any other intellectual property of
A.M.P.A.S. or any contributors, except as expressly stated herein.

* Neither the name "A.M.P.A.S." nor the name of any other contributors to this
software may be used to endorse or promote products derivative of or based on
this software without express prior written permission of A.M.P.A.S. or the
contributors, as appropriate.

This license shall be construed pursuant to the laws of the State of
California, and any disputes related thereto shall be subject to the
jurisdiction of the courts therein.

Disclaimer of Warranty: THIS SOFTWARE IS PROVIDED BY A.M.P.A.S. AND CONTRIBUTORS
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND
NON-INFRINGEMENT ARE DISCLAIMED. IN NO EVENT SHALL A.M.P.A.S., OR ANY
CONTRIBUTORS OR DISTRIBUTORS, BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, RESITUTIONARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

WITHOUT LIMITING THE GENERALITY OF THE FOREGOING, THE ACADEMY SPECIFICALLY
DISCLAIMS ANY REPRESENTATIONS OR WARRANTIES WHATSOEVER RELATED TO PATENT OR
OTHER INTELLECTUAL PROPERTY RIGHTS IN THE ACADEMY COLOR ENCODING SYSTEM, OR
APPLICATIONS THEREOF, HELD BY PARTIES OTHER THAN A.M.P.A.S.,WHETHER DISCLOSED OR
UNDISCLOSED.
18 changes: 0 additions & 18 deletions README.rst

This file was deleted.

Binary file removed docs/ACES_1.0.1.pdf
Binary file not shown.
Binary file removed docs/APD-ADX_v1.1.pdf
Binary file not shown.
Binary file removed docs/CtlManual.doc
Binary file not shown.
Binary file removed docs/CtlManual.pdf
Binary file not shown.
8 changes: 0 additions & 8 deletions docs/README.rst

This file was deleted.

26 changes: 26 additions & 0 deletions documents/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
## IMPORTANT ##

ACES related documents can be downloaded from:
https://www.dropbox.com/sh/nt9z9m6utzvkc5m/ebopy8K7Y6

#### Documents Superseded by International Standards ####

In some cases the linked documents have been superseded by various international standards. In those cases the information and data included in the standards documents take precedent.

The following lists Academy documents that have an international standards counterpart:

* __ACES_1.0.1.pdf__
* SMPTE ST 2065-1:2012 - Academy Color Encoding Specification (ACES)

* __APD-ADX_v1.1.pdf__
* SMPTE ST 2065-2:2012 - Academy Printing Density (APD) — Spectral
Responsivities, Reference Measurement Device and Spectral Calculation
* SMPTE ST 2065-3:2012 - Academy Density Exchange Encoding (ADX) — Encoding
Academy Printing Density (APD) Values

#### International Standards ####

Some ACES related documents are _only_ available as international standards and
so can not be distributed via the link above. The following is a list of such documents:

* SMPTE ST 2065-4:2013 - ACES Image Container File Layout
Loading

0 comments on commit 339318f

Please sign in to comment.