Transform IDs and User Names

ACES transforms, which are provided as CTL files in the reference implementation, shall be assigned both a Transform Identifier (<ACEStransformID>) and a user-facing name (<ACESuserName>).

Transform Identifiers (Transform IDs)

ACES transforms shall be assigned a Transform Identifier ("Transform ID") contained in an XML tag of in the file header. The Transform ID describes the transform and includes versioning information specific to that transform file.

A Transform ID is required metadata in AMF files. Transform IDs can also be used for tracking in software implementations that are intended to match the reference ACES transforms, where appropriate, such as in code comments implementing a specific ACES Transform.

Transform implementations that may be intended to combine a sequence of ACES CTL transforms (e.g. a Color Space Conversion (CSC) + Look Transform (LMT) + Output Transform) should reference each of the relevant ACES Transform IDs in the implementation transform.

String format for Transform Identifiers¶

The Transform ID serves as a unique identifier for a particular release version of an ACES component. It includes versioning information relevant to three different attributes:

• the version of the Transform ID specification to which it conforms,
• the version of the ACES system release with which the transform is compatible, and
• the version of the individual transform itself.

Transform IDs are constructed using a set of specified tokens such that it will be more human-readable than a typical Universally Unique Identifier (UUID) but maintain enough structure that intelligent parsing can still be performed.

In the following definitions, italics represent a changeable placeholder and boldface represents a required character or string. The allowed substrings for each of the changeable placeholders are described in the following subclauses. The substrings shall not contain spaces or periods and shall be limited to the ASCII character set.

All ACES system components, whether Academy-supplied or vendor/user-supplied, shall use the generic versioning string format:

URN : TransformType . Namespace . Name . aACESReleaseMajorVersionNumber . vTransformVersionNumber

Where:

URN¶

URN is a unique reference number to identify the version of the Transform ID specification used. For new implementations, it shall conform to the first data row in Table 1.

Table 1 - String specification for Transform ID URN

	Transform ID URN
Current Version String:	urn:ampas:aces:transformId:v2.0:
Previous values:	urn:ampas:aces:transformId:v1.5:

Note

Throughout the remainder of this document, urn:ampas:aces:transformId:v2.0 will be shortened to URN for brevity.

TransformType¶

TransformType indicates the type, or category, of transform, and shall be equal to one of the values defined in Table 2.

Table 2 - Options for TransformType

Value	Description
CSC	"Color Space Conversion" For converting between specified sets of color primary encodings and/or non-linear functions; original camera native data to ACES2065-1; also for converting between common color space representations such as Hellwig JMh.
Output	“Output Transform” For converting an ACES scene-referred image to a display-referred output; applies the combined Reference Rendering Transform and Output Device Transform
InvOutput	“Inverse direction of an Output Transform” Used to convert display-referred image into equivalent ACES values that will, upon application of the equivalent forward Output Transform, produce an output that is equal to the original input; useful for titles, pre-rendered logos/graphics, or incorporating archival video into an ACES project
Look	“Look Transform”, a.k.a. Look Modification Transform (LMT) For applying preset creative or technical grades that modify ACES data so that the starting look is different than the default rendering associated with an Output Transform.
InvLook	“Inverse direction of a Look Transform” For VFX to “undo” a modification of ACES data, if the Look has an analytical inverse.
Lib	“Library Transform” For “under-the-hood” transforms that are called and re-used by core transforms.
Util	“Utility Transform” For miscellaneous associated transforms that do not implement core ACES Transforms but may be helpful when testing and or constructing pipelines. Examples: Adjust_Exposure, Unity, etc.

Interchangeability of Input and Color Space Conversion Transforms

In effect, all Input transforms are also Color Space Conversion transforms, but all Color Space Conversion transforms are not necessarily Input Transforms. Specifically, CSC Transforms that convert from a camera manufacturer’s encoding space to ACES could also be labeled “Input” transforms. Technically speaking, however, an Input Transform typically might include an extra step or steps that differ slightly from a “nominal” camera encoding transform.

When the CSC and Input transform are otherwise identical, the Input and CSC tokens can be used interchangeably, and the CSC token is preferred. It is not required to provide duplicate transforms where the filename and Transform ID are the only differences. Providing the CSC only is sufficient.

Note

CSC transforms that convert from ACES to a camera manufacturer’s encoding space could be thought of as "inverse input transforms", though a token of InvInput is not defined.

Namespace¶

Namespace shall identify the creator of the transform. This is usually the name of a manufacturer or facility but could also be the name of an individual.

The namespace Academy is reserved for Academy-supplied transforms.

Transforms provided by users or vendors to ACES Github repositories shall maintain the namespace of the user or vendor that created it.

Name¶

Name shall describe the transform. The level of detail is left up to the user but it should be adequate to uniquely describe the transform and its intended usage. It does not need to try to include the setting for every possible parameter.

For example, if there is a standard that describes an output display type, such as Rec. 2100, that can be used in the filename and Transform ID to imply the primaries to be Rec. 2020 with the transfer function of SMPTE ST 2084. If a transform imposes some sort of variant or limitation making it different from a standard display type, then those differences should be included in the filename and Transform ID to clue the user in that different behavior should be expected.

Academy supplied transforms will provide more details in header comments about the specific intended usage of or any caveats pertaining to a particular Output Transform. [In addition, a full list of specific parameters associated with a particular Transform ID can be found in a registry of Transform IDs.]

Output Transforms

For Output Transforms, the Name shall describe the device and/or output data encoding in as much detail as necessary.

ACES 2.0 adopted verbose filenames to provide consistent amout of information to implementers in the filename - including the peak luminance, limiting color primaries and white point, encoding color primaries and white point, and transfer function. The generalized format is: LimitingColorPrimaries-White _ ###nit _in_ EncodingColorPrimaries-White _ TransferFunction

Examples:

• URN:Output.Academy.P3-D65_100nit_in_P3-D65_Gamma2pt2.a2.v1
• URN:Output.Academy.P3-D65_500nit_in_Rec2100-D65_ST2084.a2.v1
• URN:Output.Academy.P3-D60_300nit_in_XYZ-E_ST2084.ctl.a2.v1

CSC Transforms

For Color Space Conversion (CSC) Transforms, Name shall describe the device. If the creator of the transforms is the same as the camera manufacturer, then the Name need not repeat the manufacturer name because it should already be in the Namespace. If the Input Transform creator is not the camera manufacturer, then the manufacturer name shall be prepended to the device name in the Name field.

For transforms from one color space to another, the Name shall describe the source color space to the destination color space, using the general form of fromSpace _to_ toSpace.

Example Input Transform names:

• URN:CSC.Academy.ACES_to_ACEScg.a2.v1
• URN:CSC.Blackmagic.ACES_to_BMDFilm_WideGamut_Gen5.a2.v2
• URN:CSC.Red.Log3G10_RWG_to_ACES.a2.v1

ACES Major Version Number

This component of the Transform ID shall be a string consisting of the letter ‘a’ followed by the major version number of the current ACES system release. This indicates the ACES system version with which a particular transform is compatible. For new implementations, it shall be equal to the first data row in Table 3.

Table 3 - String specification for ACES Major Version Number

	ACES Major Version Number
Current Version String:	a2
Previous values:	a1

Transform Version Number

The Transform ID shall conclude with the TransformVersionNumber, which is a string consisting of the letter ‘v’ followed by the version number of that transform.

Output, Input, and Look Transforms may import sub-functions or constants that are included in separate Library-type CTL files. Library files usually contain more than one sub-function or constant. If a change is made to a Library file that will change the resulting output from a transform that depends on that Library function, then the version number of the calling transform’s Transform ID shall also be incremented. However, modifications to a Library file that do not affect the numerical output of a calling function (e.g. adding new subfunctions used by other importing files) do not require the Transform ID of a file importing it to be incremented.

Any updates to a Transform file that do not change the output of that transform (e.g. whitespace changes, modifications to code comments, etc.) shall not require the transform version number to be incremented.

User-Name (ACESuserName)

Though designed to be human-readable, ACES Transform IDs can be overly complex for presentation to end users for selection in menus. Therefore, all transforms shall include a user-friendly name, contained in an XML tag of <ACESuserName>. Software applications should reference this more user-friendly name for presentation in their user interfaces.