opencolorio_config_aces.generate_config_cg#

opencolorio_config_aces.generate_config_cg(data=None, config_name=None, profile_version=ProfileVersion('2.0'), validate=True, describe=ColorspaceDescriptionStyle.SHORT_UNION, config_mapping_file_path=PosixPath('/home/docs/checkouts/readthedocs.org/user_builds/opencolorio-config-aces/envs/latest/lib/python3.9/site-packages/opencolorio_config_aces/config/cg/generate/resources/OpenColorIO-Config-ACES CG and Studio Transforms - v1.0.0 - CG Config - Mapping.csv'), scheme='Modern 1', additional_data=False)[source]#

Generate the ACES Computer Graphics (CG) OpenColorIO config.

The default process is as follows:

  • The ACES CG OpenColorIO config generator invokes the aces-dev reference implementation OpenColorIO config generator via the opencolorio_config_aces.generate_config_aces() definition and the default reference config mapping file.

  • The ACES CG OpenColorIO config generator filters and extends the data from the aces-dev reference implementation OpenColorIO config with the given CG config mapping file:

    • The builtin CLF transforms are discovered and classified.

    • The CG config mapping file is parsed.

    • The list of implicit colorspaces is built, e.g. ACES2065-1, Raw, etc…

    • The colorspaces, looks and view transforms are filtered according to the parsed CG config mapping file data.

    • The displays, views, and shared views are filtered similarly.

    • The active displays and views are also filtered.

    • The builtin CLF transforms are filtered according to the parsed CG config mapping file data and converted to colorspaces (or named transforms).

    • Finally, the roles and aliases are updated.

Parameters:

  • data (ConfigData, optional) – OpenColorIO config data to derive the config from, the default is to use the aces-dev reference implementation OpenColorIO config.

  • config_name (unicode, optional) – OpenColorIO config file name, if given the config will be written to disk.

  • profile_version (ProfileVersion, optional) – OpenColorIO config profile version.

  • validate (bool, optional) – Whether to validate the config.

  • describe (int, optional) – Any value from the opencolorio_config_aces.ColorspaceDescriptionStyle enum.

  • config_mapping_file_path (unicode, optional) – Path to the CSV mapping file used to describe the transforms mapping.

  • scheme (str, optional) – {“Legacy”, “Modern 1”}, Naming convention scheme to use.

  • additional_data (bool, optional) – Whether to return additional data.

Returns:

OpenColorIO config or tuple of OpenColorIO config and opencolorio_config_aces.ConfigData class instance.

Return type:

Config or tuple