1 OpenColorIO Configuration for ACES¶
The OpenColorIO Configuration for ACES is an open-source Python package implementing support for the generation of the OCIO configurations for the Academy Color Encoding System (ACES).
It is freely available under the New BSD License terms.
Table of Contents
1.1 Features¶
The following features are available:
Automatic OCIO Reference configuration generation for aces-dev CTL reference implementation.
Configurable generator producing the OCIO Studio configuration.
1.2 Installation¶
1.2.1 Docker¶
Installing the dependencies for the previous config generator was not a trivial task. For ease of use an aswf-docker based container is now available.
Creating the container from the Dockerfile is done as follows:
docker build -t aswf/opencolorio-config-aces:latest .
or alternatively, if the dependencies described in the next section are satisfied:
invoke docker build
Then, to run bash in the container:
docker run -it -v ${PWD}:/home/aswf/OpenColorIO-Config-ACES aswf/opencolorio-config-aces:latest /bin/bash
1.2.2 Pypi¶
The OpenColorIO Configuration for ACES package requires various dependencies in order to run and be able to generate the OCIO configurations:
1.2.2.1 Primary Dependencies¶
1.2.2.2 Plotting Dependencies¶
1.2.2.3 Development Dependencies¶
Once the dependencies are satisfied, the OpenColorIO Configuration for ACES package can be installed from the Python Package Index by issuing this command in a shell:
pip install --user opencolorio-config-aces
1.3 Usage¶
1.3.1 Tasks¶
Various tasks are currently exposed via invoke.
This is currently the recommended way to build the configuration until a dedicated CLI is provided.
Listing the tasks is done as follows:
invoke --list
Assuming the dependencies are satisfied, the task to build the reference configuration is:
invoke build-reference-config
Alternatively, with the docker container built:
invoke docker-run-build-reference-config
1.3.2 API¶
The main reference for OpenColorIO Configuration for ACES is the manual.