€•à«      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ*/translations/zh_CN/gpu/rfc/color_pipeline”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ*/translations/zh_TW/gpu/rfc/color_pipeline”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ*/translations/it_IT/gpu/rfc/color_pipeline”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ*/translations/ja_JP/gpu/rfc/color_pipeline”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ*/translations/ko_KR/gpu/rfc/color_pipeline”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ*/translations/sp_SP/gpu/rfc/color_pipeline”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ SPDX-License-Identifier: GPL-2.0”h]”hŒ SPDX-License-Identifier: GPL-2.0”…””}”hh£sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1h¡hhhžhhŸŒD/var/lib/git/docbuild/linux/Documentation/gpu/rfc/color_pipeline.rst”h KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒLinux Color Pipeline API”h]”hŒLinux Color Pipeline API”…””}”(hh»hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hh¶hžhhŸh³h Kubhµ)”}”(hhh]”(hº)”}”(hŒWhat problem are we solving?”h]”hŒWhat problem are we solving?”…””}”(hhÌhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hhÉhžhhŸh³h KubhŒ	paragraph”“”)”}”(hŒüWe would like to support pre-, and post-blending complex color
transformations in display controller hardware in order to allow for
HW-supported HDR use-cases, as well as to provide support to
color-managed applications, such as video or image editors.”h]”hŒüWe would like to support pre-, and post-blending complex color
transformations in display controller hardware in order to allow for
HW-supported HDR use-cases, as well as to provide support to
color-managed applications, such as video or image editors.”…””}”(hhÜhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K
hhÉhžhubhÛ)”}”(hX  It is possible to support an HDR output on HW supporting the Colorspace
and HDR Metadata drm_connector properties, but that requires the
compositor or application to render and compose the content into one
final buffer intended for display. Doing so is costly.”h]”hX  It is possible to support an HDR output on HW supporting the Colorspace
and HDR Metadata drm_connector properties, but that requires the
compositor or application to render and compose the content into one
final buffer intended for display. Doing so is costly.”…””}”(hhêhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KhhÉhžhubhÛ)”}”(hX  Most modern display HW offers various 1D LUTs, 3D LUTs, matrices, and other
operations to support color transformations. These operations are often
implemented in fixed-function HW and therefore much more power efficient than
performing similar operations via shaders or CPU.”h]”hX  Most modern display HW offers various 1D LUTs, 3D LUTs, matrices, and other
operations to support color transformations. These operations are often
implemented in fixed-function HW and therefore much more power efficient than
performing similar operations via shaders or CPU.”…””}”(hhøhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KhhÉhžhubhÛ)”}”(hX"  We would like to make use of this HW functionality to support complex color
transformations with no, or minimal CPU or shader load. The switch between HW
fixed-function blocks and shaders/CPU must be seamless with no visible
difference when fallback to shaders/CPU is neceesary at any time.”h]”hX"  We would like to make use of this HW functionality to support complex color
transformations with no, or minimal CPU or shader load. The switch between HW
fixed-function blocks and shaders/CPU must be seamless with no visible
difference when fallback to shaders/CPU is neceesary at any time.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KhhÉhžhubeh}”(h]”Œwhat-problem-are-we-solving”ah ]”h"]”Œwhat problem are we solving?”ah$]”h&]”uh1h´hh¶hžhhŸh³h Kubhµ)”}”(hhh]”(hº)”}”(hŒ(How are other OSes solving this problem?”h]”hŒ(How are other OSes solving this problem?”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj  hžhhŸh³h K ubhÛ)”}”(hŒPThe most widely supported use-cases regard HDR content, whether video or
gaming.”h]”hŒPThe most widely supported use-cases regard HDR content, whether video or
gaming.”…””}”(hj-  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K"hj  hžhubhÛ)”}”(hX!  Most OSes will specify the source content format (color gamut, encoding transfer
function, and other metadata, such as max and average light levels) to a driver.
Drivers will then program their fixed-function HW accordingly to map from a
source content buffer's space to a display's space.”h]”hX%  Most OSes will specify the source content format (color gamut, encoding transfer
function, and other metadata, such as max and average light levels) to a driver.
Drivers will then program their fixed-function HW accordingly to map from a
source content bufferâ€™s space to a displayâ€™s space.”…””}”(hj;  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K%hj  hžhubhÛ)”}”(hŒ²When fixed-function HW is not available the compositor will assemble a shader to
ask the GPU to perform the transformation from the source content format to the
display's format.”h]”hŒ´When fixed-function HW is not available the compositor will assemble a shader to
ask the GPU to perform the transformation from the source content format to the
displayâ€™s format.”…””}”(hjI  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K*hj  hžhubhÛ)”}”(hXx  A compositor's mapping function and a driver's mapping function are usually
entirely separate concepts. On OSes where a HW vendor has no insight into
closed-source compositor code such a vendor will tune their color management
code to visually match the compositor's. On other OSes, where both mapping
functions are open to an implementer they will ensure both mappings match.”h]”hX~  A compositorâ€™s mapping function and a driverâ€™s mapping function are usually
entirely separate concepts. On OSes where a HW vendor has no insight into
closed-source compositor code such a vendor will tune their color management
code to visually match the compositorâ€™s. On other OSes, where both mapping
functions are open to an implementer they will ensure both mappings match.”…””}”(hjW  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K.hj  hžhubhÛ)”}”(hŒÍThis results in mapping algorithm lock-in, meaning that no-one alone can
experiment with or introduce new mapping algorithms and achieve
consistent results regardless of which implementation path is taken.”h]”hŒÍThis results in mapping algorithm lock-in, meaning that no-one alone can
experiment with or introduce new mapping algorithms and achieve
consistent results regardless of which implementation path is taken.”…””}”(hje  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K4hj  hžhubeh}”(h]”Œ'how-are-other-oses-solving-this-problem”ah ]”h"]”Œ(how are other oses solving this problem?”ah$]”h&]”uh1h´hh¶hžhhŸh³h K ubhµ)”}”(hhh]”(hº)”}”(hŒWhy is Linux different?”h]”hŒWhy is Linux different?”…””}”(hj~  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj{  hžhhŸh³h K9ubhÛ)”}”(hX)  Unlike other OSes, where there is one compositor for one or more drivers, on
Linux we have a many-to-many relationship. Many compositors; many drivers.
In addition each compositor vendor or community has their own view of how
color management should be done. This is what makes Linux so beautiful.”h]”hX)  Unlike other OSes, where there is one compositor for one or more drivers, on
Linux we have a many-to-many relationship. Many compositors; many drivers.
In addition each compositor vendor or community has their own view of how
color management should be done. This is what makes Linux so beautiful.”…””}”(hjŒ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K;hj{  hžhubhÛ)”}”(hŒ³This means that a HW vendor can now no longer tune their driver to one
compositor, as tuning it to one could make it look fairly different from
another compositor's color mapping.”h]”hŒµThis means that a HW vendor can now no longer tune their driver to one
compositor, as tuning it to one could make it look fairly different from
another compositorâ€™s color mapping.”…””}”(hjš  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K@hj{  hžhubhÛ)”}”(hŒWe need a better solution.”h]”hŒWe need a better solution.”…””}”(hj¨  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KDhj{  hžhubeh}”(h]”Œwhy-is-linux-different”ah ]”h"]”Œwhy is linux different?”ah$]”h&]”uh1h´hh¶hžhhŸh³h K9ubhµ)”}”(hhh]”(hº)”}”(hŒDescriptive API”h]”hŒDescriptive API”…””}”(hjÁ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj¾  hžhhŸh³h KHubhÛ)”}”(hX&  An API that describes the source and destination colorspaces is a descriptive
API. It describes the input and output color spaces but does not describe
how precisely they should be mapped. Such a mapping includes many minute
design decision that can greatly affect the look of the final result.”h]”hX&  An API that describes the source and destination colorspaces is a descriptive
API. It describes the input and output color spaces but does not describe
how precisely they should be mapped. Such a mapping includes many minute
design decision that can greatly affect the look of the final result.”…””}”(hjÏ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KJhj¾  hžhubhÛ)”}”(hŒ«It is not feasible to describe such mapping with enough detail to ensure the
same result from each implementation. In fact, these mappings are a very active
research area.”h]”hŒ«It is not feasible to describe such mapping with enough detail to ensure the
same result from each implementation. In fact, these mappings are a very active
research area.”…””}”(hjÝ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KOhj¾  hžhubeh}”(h]”Œdescriptive-api”ah ]”h"]”Œdescriptive api”ah$]”h&]”uh1h´hh¶hžhhŸh³h KHubhµ)”}”(hhh]”(hº)”}”(hŒPrescriptive API”h]”hŒPrescriptive API”…””}”(hjö  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjó  hžhhŸh³h KUubhÛ)”}”(hŒ¬A prescriptive API describes not the source and destination colorspaces. It
instead prescribes a recipe for how to manipulate pixel values to arrive at the
desired outcome.”h]”hŒ¬A prescriptive API describes not the source and destination colorspaces. It
instead prescribes a recipe for how to manipulate pixel values to arrive at the
desired outcome.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KWhjó  hžhubhÛ)”}”(hŒÐThis recipe is generally an ordered list of straight-forward operations,
with clear mathematical definitions, such as 1D LUTs, 3D LUTs, matrices,
or other operations that can be described in a precise manner.”h]”hŒÐThis recipe is generally an ordered list of straight-forward operations,
with clear mathematical definitions, such as 1D LUTs, 3D LUTs, matrices,
or other operations that can be described in a precise manner.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K[hjó  hžhubeh}”(h]”Œprescriptive-api”ah ]”h"]”Œprescriptive api”ah$]”h&]”uh1h´hh¶hžhhŸh³h KUubhµ)”}”(hhh]”(hº)”}”(hŒThe Color Pipeline API”h]”hŒThe Color Pipeline API”…””}”(hj+  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj(  hžhhŸh³h KaubhÛ)”}”(hX€  HW color management pipelines can significantly differ between HW
vendors in terms of availability, ordering, and capabilities of HW
blocks. This makes a common definition of color management blocks and
their ordering nigh impossible. Instead we are defining an API that
allows user space to discover the HW capabilities in a generic manner,
agnostic of specific drivers and hardware.”h]”hX€  HW color management pipelines can significantly differ between HW
vendors in terms of availability, ordering, and capabilities of HW
blocks. This makes a common definition of color management blocks and
their ordering nigh impossible. Instead we are defining an API that
allows user space to discover the HW capabilities in a generic manner,
agnostic of specific drivers and hardware.”…””}”(hj9  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h Kchj(  hžhubeh}”(h]”Œthe-color-pipeline-api”ah ]”h"]”Œthe color pipeline api”ah$]”h&]”uh1h´hh¶hžhhŸh³h Kaubhµ)”}”(hhh]”(hº)”}”(hŒdrm_colorop Object”h]”hŒdrm_colorop Object”…””}”(hjR  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjO  hžhhŸh³h KlubhÛ)”}”(hX}  To support the definition of color pipelines we define the DRM core
object type drm_colorop. Individual drm_colorop objects will be chained
via the NEXT property of a drm_colorop to constitute a color pipeline.
Each drm_colorop object is unique, i.e., even if multiple color
pipelines have the same operation they won't share the same drm_colorop
object to describe that operation.”h]”hX  To support the definition of color pipelines we define the DRM core
object type drm_colorop. Individual drm_colorop objects will be chained
via the NEXT property of a drm_colorop to constitute a color pipeline.
Each drm_colorop object is unique, i.e., even if multiple color
pipelines have the same operation they wonâ€™t share the same drm_colorop
object to describe that operation.”…””}”(hj`  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KnhjO  hžhubhÛ)”}”(hX  Note that drivers are not expected to map drm_colorop objects statically
to specific HW blocks. The mapping of drm_colorop objects is entirely a
driver-internal detail and can be as dynamic or static as a driver needs
it to be. See more in the Driver Implementation Guide section below.”h]”hX  Note that drivers are not expected to map drm_colorop objects statically
to specific HW blocks. The mapping of drm_colorop objects is entirely a
driver-internal detail and can be as dynamic or static as a driver needs
it to be. See more in the Driver Implementation Guide section below.”…””}”(hjn  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KuhjO  hžhubhÛ)”}”(hŒ+Each drm_colorop has three core properties:”h]”hŒ+Each drm_colorop has three core properties:”…””}”(hj|  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KzhjO  hžhubhÛ)”}”(hŒ¢TYPE: An enumeration property, defining the type of transformation, such as
* enumerated curve
* custom (uniform) 1D LUT
* 3x3 matrix
* 3x4 matrix
* 3D LUT
* etc.”h]”hŒ¢TYPE: An enumeration property, defining the type of transformation, such as
* enumerated curve
* custom (uniform) 1D LUT
* 3x3 matrix
* 3x4 matrix
* 3D LUT
* etc.”…””}”(hjŠ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K|hjO  hžhubhÛ)”}”(hŒTDepending on the type of transformation other properties will describe
more details.”h]”hŒTDepending on the type of transformation other properties will describe
more details.”…””}”(hj˜  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K„hjO  hžhubhÛ)”}”(hŒèBYPASS: A boolean property that can be used to easily put a block into
bypass mode. The BYPASS property is not mandatory for a colorop, as long
as the entire pipeline can get bypassed by setting the COLOR_PIPELINE on
a plane to '0'.”h]”hŒìBYPASS: A boolean property that can be used to easily put a block into
bypass mode. The BYPASS property is not mandatory for a colorop, as long
as the entire pipeline can get bypassed by setting the COLOR_PIPELINE on
a plane to â€˜0â€™.”…””}”(hj¦  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K‡hjO  hžhubhÛ)”}”(hŒlNEXT: The ID of the next drm_colorop in a color pipeline, or 0 if this
drm_colorop is the last in the chain.”h]”hŒlNEXT: The ID of the next drm_colorop in a color pipeline, or 0 if this
drm_colorop is the last in the chain.”…””}”(hj´  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KŒhjO  hžhubhÛ)”}”(hŒAAn example of a drm_colorop object might look like one of these::”h]”hŒ@An example of a drm_colorop object might look like one of these:”…””}”(hjÂ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KhjO  hžhubhŒliteral_block”“”)”}”(hXœ  /* 1D enumerated curve */
Color operation 42
â”œâ”€ "TYPE": immutable enum {1D enumerated curve, 1D LUT, 3x3 matrix, 3x4 matrix, 3D LUT, etc.} = 1D enumerated curve
â”œâ”€ "BYPASS": bool {true, false}
â”œâ”€ "CURVE_1D_TYPE": enum {sRGB EOTF, sRGB inverse EOTF, PQ EOTF, PQ inverse EOTF, â€¦}
â””â”€ "NEXT": immutable color operation ID = 43

/* custom 4k entry 1D LUT */
Color operation 52
â”œâ”€ "TYPE": immutable enum {1D enumerated curve, 1D LUT, 3x3 matrix, 3x4 matrix, 3D LUT, etc.} = 1D LUT
â”œâ”€ "BYPASS": bool {true, false}
â”œâ”€ "SIZE": immutable range = 4096
â”œâ”€ "DATA": blob
â””â”€ "NEXT": immutable color operation ID = 0

/* 17^3 3D LUT */
Color operation 72
â”œâ”€ "TYPE": immutable enum {1D enumerated curve, 1D LUT, 3x3 matrix, 3x4 matrix, 3D LUT, etc.} = 3D LUT
â”œâ”€ "BYPASS": bool {true, false}
â”œâ”€ "SIZE": immutable range = 17
â”œâ”€ "DATA": blob
â””â”€ "NEXT": immutable color operation ID = 73”h]”hXœ  /* 1D enumerated curve */
Color operation 42
â”œâ”€ "TYPE": immutable enum {1D enumerated curve, 1D LUT, 3x3 matrix, 3x4 matrix, 3D LUT, etc.} = 1D enumerated curve
â”œâ”€ "BYPASS": bool {true, false}
â”œâ”€ "CURVE_1D_TYPE": enum {sRGB EOTF, sRGB inverse EOTF, PQ EOTF, PQ inverse EOTF, â€¦}
â””â”€ "NEXT": immutable color operation ID = 43

/* custom 4k entry 1D LUT */
Color operation 52
â”œâ”€ "TYPE": immutable enum {1D enumerated curve, 1D LUT, 3x3 matrix, 3x4 matrix, 3D LUT, etc.} = 1D LUT
â”œâ”€ "BYPASS": bool {true, false}
â”œâ”€ "SIZE": immutable range = 4096
â”œâ”€ "DATA": blob
â””â”€ "NEXT": immutable color operation ID = 0

/* 17^3 3D LUT */
Color operation 72
â”œâ”€ "TYPE": immutable enum {1D enumerated curve, 1D LUT, 3x3 matrix, 3x4 matrix, 3D LUT, etc.} = 3D LUT
â”œâ”€ "BYPASS": bool {true, false}
â”œâ”€ "SIZE": immutable range = 17
â”œâ”€ "DATA": blob
â””â”€ "NEXT": immutable color operation ID = 73”…””}”hjÒ  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jÐ  hŸh³h K‘hjO  hžhubhµ)”}”(hhh]”(hº)”}”(hŒdrm_colorop extensibility”h]”hŒdrm_colorop extensibility”…””}”(hjã  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjà  hžhhŸh³h K©ubhÛ)”}”(hŒÀUnlike existing DRM core objects, like &drm_plane, drm_colorop is not
extensible. This simplifies implementations and keeps all functionality
for managing &drm_colorop objects in the DRM core.”h]”hŒÀUnlike existing DRM core objects, like &drm_plane, drm_colorop is not
extensible. This simplifies implementations and keeps all functionality
for managing &drm_colorop objects in the DRM core.”…””}”(hjñ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K«hjà  hžhubhÛ)”}”(hŒŸIf there is a need one may introduce a simple &drm_colorop_funcs
function table in the future, for example to support an IN_FORMATS
property on a &drm_colorop.”h]”hŒŸIf there is a need one may introduce a simple &drm_colorop_funcs
function table in the future, for example to support an IN_FORMATS
property on a &drm_colorop.”…””}”(hjÿ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K¯hjà  hžhubhÛ)”}”(hŒçIf a driver requires the ability to create a driver-specific colorop
object they will need to add &drm_colorop func table support with
support for the usual functions, like destroy, atomic_duplicate_state,
and atomic_destroy_state.”h]”hŒçIf a driver requires the ability to create a driver-specific colorop
object they will need to add &drm_colorop func table support with
support for the usual functions, like destroy, atomic_duplicate_state,
and atomic_destroy_state.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K³hjà  hžhubeh}”(h]”Œdrm-colorop-extensibility”ah ]”h"]”Œdrm_colorop extensibility”ah$]”h&]”uh1h´hjO  hžhhŸh³h K©ubeh}”(h]”Œdrm-colorop-object”ah ]”h"]”Œdrm_colorop object”ah$]”h&]”uh1h´hh¶hžhhŸh³h Klubhµ)”}”(hhh]”(hº)”}”(hŒCOLOR_PIPELINE Plane Property”h]”hŒCOLOR_PIPELINE Plane Property”…””}”(hj.  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj+  hžhhŸh³h KºubhÛ)”}”(hXá  Color Pipelines are created by a driver and advertised via a new
COLOR_PIPELINE enum property on each plane. Values of the property
always include object id 0, which is the default and means all color
processing is disabled. Additional values will be the object IDs of the
first drm_colorop in a pipeline. A driver can create and advertise none,
one, or more possible color pipelines. A DRM client will select a color
pipeline by setting the COLOR PIPELINE to the respective value.”h]”hXá  Color Pipelines are created by a driver and advertised via a new
COLOR_PIPELINE enum property on each plane. Values of the property
always include object id 0, which is the default and means all color
processing is disabled. Additional values will be the object IDs of the
first drm_colorop in a pipeline. A driver can create and advertise none,
one, or more possible color pipelines. A DRM client will select a color
pipeline by setting the COLOR PIPELINE to the respective value.”…””}”(hj<  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K¼hj+  hžhubhÛ)”}”(hX  NOTE: Many DRM clients will set enumeration properties via the string
value, often hard-coding it. Since this enumeration is generated based
on the colorop object IDs it is important to perform the Color Pipeline
Discovery, described below, instead of hard-coding color pipeline
assignment. Drivers might generate the enum strings dynamically.
Hard-coded strings might only work for specific drivers on a specific
pieces of HW. Color Pipeline Discovery can work universally, as long as
drivers implement the required color operations.”h]”hX  NOTE: Many DRM clients will set enumeration properties via the string
value, often hard-coding it. Since this enumeration is generated based
on the colorop object IDs it is important to perform the Color Pipeline
Discovery, described below, instead of hard-coding color pipeline
assignment. Drivers might generate the enum strings dynamically.
Hard-coded strings might only work for specific drivers on a specific
pieces of HW. Color Pipeline Discovery can work universally, as long as
drivers implement the required color operations.”…””}”(hjJ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KÄhj+  hžhubhÛ)”}”(hXµ  The COLOR_PIPELINE property is only exposed when the
DRM_CLIENT_CAP_PLANE_COLOR_PIPELINE is set. Drivers shall ignore any
existing pre-blend color operations when this cap is set, such as
COLOR_RANGE and COLOR_ENCODING. If drivers want to support COLOR_RANGE
or COLOR_ENCODING functionality when the color pipeline client cap is
set, they are expected to expose colorops in the pipeline to allow for
the appropriate color transformation.”h]”hXµ  The COLOR_PIPELINE property is only exposed when the
DRM_CLIENT_CAP_PLANE_COLOR_PIPELINE is set. Drivers shall ignore any
existing pre-blend color operations when this cap is set, such as
COLOR_RANGE and COLOR_ENCODING. If drivers want to support COLOR_RANGE
or COLOR_ENCODING functionality when the color pipeline client cap is
set, they are expected to expose colorops in the pipeline to allow for
the appropriate color transformation.”…””}”(hjX  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KÍhj+  hžhubhÛ)”}”(hŒSetting of the COLOR_PIPELINE plane property or drm_colorop properties
is only allowed for userspace that sets this client cap.”h]”hŒSetting of the COLOR_PIPELINE plane property or drm_colorop properties
is only allowed for userspace that sets this client cap.”…””}”(hjf  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KÕhj+  hžhubhÛ)”}”(hŒIAn example of a COLOR_PIPELINE property on a plane might look like this::”h]”hŒHAn example of a COLOR_PIPELINE property on a plane might look like this:”…””}”(hjt  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KØhj+  hžhubjÑ  )”}”(hŒ„Plane 10
â”œâ”€ "TYPE": immutable enum {Overlay, Primary, Cursor} = Primary
â”œâ”€ â€¦
â””â”€ "COLOR_PIPELINE": enum {0, 42, 52} = 0”h]”hŒ„Plane 10
â”œâ”€ "TYPE": immutable enum {Overlay, Primary, Cursor} = Primary
â”œâ”€ â€¦
â””â”€ "COLOR_PIPELINE": enum {0, 42, 52} = 0”…””}”hj‚  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jÐ  hŸh³h KÚhj+  hžhubeh}”(h]”Œcolor-pipeline-plane-property”ah ]”h"]”Œcolor_pipeline plane property”ah$]”h&]”uh1h´hh¶hžhhŸh³h Kºubhµ)”}”(hhh]”(hº)”}”(hŒColor Pipeline Discovery”h]”hŒColor Pipeline Discovery”…””}”(hj›  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj˜  hžhhŸh³h KáubhÛ)”}”(hŒ:A DRM client wanting color management on a drm_plane will:”h]”hŒ:A DRM client wanting color management on a drm_plane will:”…””}”(hj©  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h Kãhj˜  hžhubhŒenumerated_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hŒ,Get the COLOR_PIPELINE property of the plane”h]”hÛ)”}”(hjÀ  h]”hŒ,Get the COLOR_PIPELINE property of the plane”…””}”(hjÂ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h Kåhj¾  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j¼  hj¹  hžhhŸh³h Nubj½  )”}”(hŒ&iterate all COLOR_PIPELINE enum values”h]”hÛ)”}”(hj×  h]”hŒ&iterate all COLOR_PIPELINE enum values”…””}”(hjÙ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KæhjÕ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j¼  hj¹  hžhhŸh³h Nubj½  )”}”(hŒ§for each enum value walk the color pipeline (via the NEXT pointers)
and see if the available color operations are suitable for the
desired color management operations
”h]”hÛ)”}”(hŒ¦for each enum value walk the color pipeline (via the NEXT pointers)
and see if the available color operations are suitable for the
desired color management operations”h]”hŒ¦for each enum value walk the color pipeline (via the NEXT pointers)
and see if the available color operations are suitable for the
desired color management operations”…””}”(hjð  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h Kçhjì  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j¼  hj¹  hžhhŸh³h Nubeh}”(h]”h ]”h"]”h$]”h&]”Œenumtype”Œarabic”Œprefix”hŒsuffix”Œ.”uh1j·  hj˜  hžhhŸh³h KåubhÛ)”}”(hX  If userspace encounters an unknown or unsuitable color operation during
discovery it does not need to reject the entire color pipeline outright,
as long as the unknown or unsuitable colorop has a "BYPASS" property.
Drivers will ensure that a bypassed block does not have any effect.”h]”hX  If userspace encounters an unknown or unsuitable color operation during
discovery it does not need to reject the entire color pipeline outright,
as long as the unknown or unsuitable colorop has a â€œBYPASSâ€ property.
Drivers will ensure that a bypassed block does not have any effect.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h Këhj˜  hžhubhÛ)”}”(hŒdAn example of chained properties to define an AMD pre-blending color
pipeline might look like this::”h]”hŒcAn example of chained properties to define an AMD pre-blending color
pipeline might look like this:”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h Kðhj˜  hžhubjÑ  )”}”(hX  Plane 10
â”œâ”€ "TYPE" (immutable) = Primary
â””â”€ "COLOR_PIPELINE": enum {0, 44} = 0

Color operation 44
â”œâ”€ "TYPE" (immutable) = 1D enumerated curve
â”œâ”€ "BYPASS": bool
â”œâ”€ "CURVE_1D_TYPE": enum {sRGB EOTF, PQ EOTF} = sRGB EOTF
â””â”€ "NEXT" (immutable) = 45

Color operation 45
â”œâ”€ "TYPE" (immutable) = 3x4 Matrix
â”œâ”€ "BYPASS": bool
â”œâ”€ "DATA": blob
â””â”€ "NEXT" (immutable) = 46

Color operation 46
â”œâ”€ "TYPE" (immutable) = 1D enumerated curve
â”œâ”€ "BYPASS": bool
â”œâ”€ "CURVE_1D_TYPE": enum {sRGB Inverse EOTF, PQ Inverse EOTF} = sRGB EOTF
â””â”€ "NEXT" (immutable) = 47

Color operation 47
â”œâ”€ "TYPE" (immutable) = 1D LUT
â”œâ”€ "SIZE": immutable range = 4096
â”œâ”€ "DATA": blob
â””â”€ "NEXT" (immutable) = 48

Color operation 48
â”œâ”€ "TYPE" (immutable) = 3D LUT
â”œâ”€ "DATA": blob
â””â”€ "NEXT" (immutable) = 49

Color operation 49
â”œâ”€ "TYPE" (immutable) = 1D enumerated curve
â”œâ”€ "BYPASS": bool
â”œâ”€ "CURVE_1D_TYPE": enum {sRGB EOTF, PQ EOTF} = sRGB EOTF
â””â”€ "NEXT" (immutable) = 0”h]”hX  Plane 10
â”œâ”€ "TYPE" (immutable) = Primary
â””â”€ "COLOR_PIPELINE": enum {0, 44} = 0

Color operation 44
â”œâ”€ "TYPE" (immutable) = 1D enumerated curve
â”œâ”€ "BYPASS": bool
â”œâ”€ "CURVE_1D_TYPE": enum {sRGB EOTF, PQ EOTF} = sRGB EOTF
â””â”€ "NEXT" (immutable) = 45

Color operation 45
â”œâ”€ "TYPE" (immutable) = 3x4 Matrix
â”œâ”€ "BYPASS": bool
â”œâ”€ "DATA": blob
â””â”€ "NEXT" (immutable) = 46

Color operation 46
â”œâ”€ "TYPE" (immutable) = 1D enumerated curve
â”œâ”€ "BYPASS": bool
â”œâ”€ "CURVE_1D_TYPE": enum {sRGB Inverse EOTF, PQ Inverse EOTF} = sRGB EOTF
â””â”€ "NEXT" (immutable) = 47

Color operation 47
â”œâ”€ "TYPE" (immutable) = 1D LUT
â”œâ”€ "SIZE": immutable range = 4096
â”œâ”€ "DATA": blob
â””â”€ "NEXT" (immutable) = 48

Color operation 48
â”œâ”€ "TYPE" (immutable) = 3D LUT
â”œâ”€ "DATA": blob
â””â”€ "NEXT" (immutable) = 49

Color operation 49
â”œâ”€ "TYPE" (immutable) = 1D enumerated curve
â”œâ”€ "BYPASS": bool
â”œâ”€ "CURVE_1D_TYPE": enum {sRGB EOTF, PQ EOTF} = sRGB EOTF
â””â”€ "NEXT" (immutable) = 0”…””}”hj+  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jÐ  hŸh³h Kóhj˜  hžhubeh}”(h]”Œcolor-pipeline-discovery”ah ]”h"]”Œcolor pipeline discovery”ah$]”h&]”uh1h´hh¶hžhhŸh³h Káubhµ)”}”(hhh]”(hº)”}”(hŒColor Pipeline Programming”h]”hŒColor Pipeline Programming”…””}”(hjD  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjA  hžhhŸh³h MubhÛ)”}”(hŒ8Once a DRM client has found a suitable pipeline it will:”h]”hŒ8Once a DRM client has found a suitable pipeline it will:”…””}”(hjR  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h MhjA  hžhubj¸  )”}”(hhh]”(j½  )”}”(hŒmSet the COLOR_PIPELINE enum value to the one pointing at the first
drm_colorop object of the desired pipeline”h]”hÛ)”}”(hŒmSet the COLOR_PIPELINE enum value to the one pointing at the first
drm_colorop object of the desired pipeline”h]”hŒmSet the COLOR_PIPELINE enum value to the one pointing at the first
drm_colorop object of the desired pipeline”…””}”(hjg  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h M hjc  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j¼  hj`  hžhhŸh³h Nubj½  )”}”(hŒ´Set the properties for all drm_colorop objects in the pipeline to the
desired values, setting BYPASS to true for unused drm_colorop blocks,
and false for enabled drm_colorop blocks”h]”hÛ)”}”(hŒ´Set the properties for all drm_colorop objects in the pipeline to the
desired values, setting BYPASS to true for unused drm_colorop blocks,
and false for enabled drm_colorop blocks”h]”hŒ´Set the properties for all drm_colorop objects in the pipeline to the
desired values, setting BYPASS to true for unused drm_colorop blocks,
and false for enabled drm_colorop blocks”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h M"hj{  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j¼  hj`  hžhhŸh³h Nubj½  )”}”(hŒ[Perform (TEST_ONLY or not) atomic commit with all the other KMS
states it wishes to change
”h]”hÛ)”}”(hŒZPerform (TEST_ONLY or not) atomic commit with all the other KMS
states it wishes to change”h]”hŒZPerform (TEST_ONLY or not) atomic commit with all the other KMS
states it wishes to change”…””}”(hj—  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h M%hj“  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j¼  hj`  hžhhŸh³h Nubeh}”(h]”h ]”h"]”h$]”h&]”j
  j  j  hj  j  uh1j·  hjA  hžhhŸh³h M ubhÛ)”}”(hŒžTo configure the pipeline for an HDR10 PQ plane and blending in linear
space, a compositor might perform an atomic commit with the following
property values::”h]”hŒTo configure the pipeline for an HDR10 PQ plane and blending in linear
space, a compositor might perform an atomic commit with the following
property values:”…””}”(hj±  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h M(hjA  hžhubjÑ  )”}”(hX„  Plane 10
â””â”€ "COLOR_PIPELINE" = 42

Color operation 42
â””â”€ "BYPASS" = true

Color operation 44
â””â”€ "BYPASS" = true

Color operation 45
â””â”€ "BYPASS" = true

Color operation 46
â””â”€ "BYPASS" = true

Color operation 47
â”œâ”€ "DATA" = Gamut mapping + tone mapping + night mode
â””â”€ "BYPASS" = false

Color operation 48
â”œâ”€ "CURVE_1D_TYPE" = PQ EOTF
â””â”€ "BYPASS" = false”h]”hX„  Plane 10
â””â”€ "COLOR_PIPELINE" = 42

Color operation 42
â””â”€ "BYPASS" = true

Color operation 44
â””â”€ "BYPASS" = true

Color operation 45
â””â”€ "BYPASS" = true

Color operation 46
â””â”€ "BYPASS" = true

Color operation 47
â”œâ”€ "DATA" = Gamut mapping + tone mapping + night mode
â””â”€ "BYPASS" = false

Color operation 48
â”œâ”€ "CURVE_1D_TYPE" = PQ EOTF
â””â”€ "BYPASS" = false”…””}”hj¿  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jÐ  hŸh³h M,hjA  hžhubeh}”(h]”Œcolor-pipeline-programming”ah ]”h"]”Œcolor pipeline programming”ah$]”h&]”uh1h´hh¶hžhhŸh³h Mubhµ)”}”(hhh]”(hº)”}”(hŒDriver Implementer's Guide”h]”hŒDriver Implementerâ€™s Guide”…””}”(hjØ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjÕ  hžhhŸh³h MEubhÛ)”}”(hŒÎWhat does this all mean for driver implementations? As noted above the
colorops can map to HW directly but don't need to do so. Here are some
suggestions on how to think about creating your color pipelines:”h]”hŒÐWhat does this all mean for driver implementations? As noted above the
colorops can map to HW directly but donâ€™t need to do so. Here are some
suggestions on how to think about creating your color pipelines:”…””}”(hjæ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h MGhjÕ  hžhubhŒbullet_list”“”)”}”(hhh]”(j½  )”}”(hŒ¾Try to expose pipelines that use already defined colorops, even if
your hardware pipeline is split differently. This allows existing
userspace to immediately take advantage of the hardware.
”h]”hÛ)”}”(hŒ½Try to expose pipelines that use already defined colorops, even if
your hardware pipeline is split differently. This allows existing
userspace to immediately take advantage of the hardware.”h]”hŒ½Try to expose pipelines that use already defined colorops, even if
your hardware pipeline is split differently. This allows existing
userspace to immediately take advantage of the hardware.”…””}”(hjý  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h MKhjù  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j¼  hjö  hžhhŸh³h Nubj½  )”}”(hŒ·Additionally, try to expose your actual hardware blocks as colorops.
Define new colorop types where you believe it can offer significant
benefits if userspace learns to program them.
”h]”hÛ)”}”(hŒ¶Additionally, try to expose your actual hardware blocks as colorops.
Define new colorop types where you believe it can offer significant
benefits if userspace learns to program them.”h]”hŒ¶Additionally, try to expose your actual hardware blocks as colorops.
Define new colorop types where you believe it can offer significant
benefits if userspace learns to program them.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h MOhj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j¼  hjö  hžhhŸh³h Nubj½  )”}”(hXC  Avoid defining new colorops for compound operations with very narrow
scope. If you have a hardware block for a special operation that
cannot be split further, you can expose that as a new colorop type.
However, try to not define colorops for "use cases", especially if
they require you to combine multiple hardware blocks.
”h]”hÛ)”}”(hXB  Avoid defining new colorops for compound operations with very narrow
scope. If you have a hardware block for a special operation that
cannot be split further, you can expose that as a new colorop type.
However, try to not define colorops for "use cases", especially if
they require you to combine multiple hardware blocks.”h]”hXF  Avoid defining new colorops for compound operations with very narrow
scope. If you have a hardware block for a special operation that
cannot be split further, you can expose that as a new colorop type.
However, try to not define colorops for â€œuse casesâ€, especially if
they require you to combine multiple hardware blocks.”…””}”(hj-  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h MShj)  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j¼  hjö  hžhhŸh³h Nubj½  )”}”(hŒxDesign new colorops as prescriptive, not descriptive; by the
mathematical formula, not by the assumed input and output.
”h]”hÛ)”}”(hŒwDesign new colorops as prescriptive, not descriptive; by the
mathematical formula, not by the assumed input and output.”h]”hŒwDesign new colorops as prescriptive, not descriptive; by the
mathematical formula, not by the assumed input and output.”…””}”(hjE  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h MYhjA  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j¼  hjö  hžhhŸh³h Nubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1jô  hŸh³h MKhjÕ  hžhubhÛ)”}”(hX  A defined colorop type must be deterministic. The exact behavior of the
colorop must be documented entirely, whether via a mathematical formula
or some other description. Its operation can depend only on its
properties and input and nothing else, allowed error tolerance
notwithstanding.”h]”hX  A defined colorop type must be deterministic. The exact behavior of the
colorop must be documented entirely, whether via a mathematical formula
or some other description. Its operation can depend only on its
properties and input and nothing else, allowed error tolerance
notwithstanding.”…””}”(hja  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h M\hjÕ  hžhubeh}”(h]”Œdriver-implementer-s-guide”ah ]”h"]”Œdriver implementer's guide”ah$]”h&]”uh1h´hh¶hžhhŸh³h MEubhµ)”}”(hhh]”(hº)”}”(hŒ%Driver Forward/Backward Compatibility”h]”hŒ%Driver Forward/Backward Compatibility”…””}”(hjz  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjw  hžhhŸh³h MdubhÛ)”}”(hXY  As this is uAPI drivers can't regress color pipelines that have been
introduced for a given HW generation. New HW generations are free to
abandon color pipelines advertised for previous generations.
Nevertheless, it can be beneficial to carry support for existing color
pipelines forward as those will likely already have support in DRM
clients.”h]”hX[  As this is uAPI drivers canâ€™t regress color pipelines that have been
introduced for a given HW generation. New HW generations are free to
abandon color pipelines advertised for previous generations.
Nevertheless, it can be beneficial to carry support for existing color
pipelines forward as those will likely already have support in DRM
clients.”…””}”(hjˆ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h Mfhjw  hžhubhÛ)”}”(hX  Introducing new colorops to a pipeline is fine, as long as they can be
bypassed or are purely informational. DRM clients implementing support
for the pipeline can always skip unknown properties as long as they can
be confident that doing so will not cause unexpected results.”h]”hX  Introducing new colorops to a pipeline is fine, as long as they can be
bypassed or are purely informational. DRM clients implementing support
for the pipeline can always skip unknown properties as long as they can
be confident that doing so will not cause unexpected results.”…””}”(hj–  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h Mmhjw  hžhubhÛ)”}”(hŒÃIf a new colorop doesn't fall into one of the above categories
(bypassable or informational) the modified pipeline would be unusable
for user space. In this case a new pipeline should be defined.”h]”hŒÅIf a new colorop doesnâ€™t fall into one of the above categories
(bypassable or informational) the modified pipeline would be unusable
for user space. In this case a new pipeline should be defined.”…””}”(hj¤  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h Mrhjw  hžhubeh}”(h]”Œ%driver-forward-backward-compatibility”ah ]”h"]”Œ%driver forward/backward compatibility”ah$]”h&]”uh1h´hh¶hžhhŸh³h Mdubhµ)”}”(hhh]”(hº)”}”(hŒ
References”h]”hŒ
References”…””}”(hj½  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjº  hžhhŸh³h Mxubj¸  )”}”(hhh]”j½  )”}”(hŒ›https://lore.kernel.org/dri-devel/QMers3awXvNCQlyhWdTtsPwkp5ie9bze_hD5nAccFW7a_RXlWjYB7MoUW_8CKLT2bSQwIXVi5H6VULYIxCdgvryZoAoJnC5lZgyK1QWn488=@emersion.fr/”h]”hÛ)”}”(hjÐ  h]”hŒ	reference”“”)”}”(hjÐ  h]”hŒ›https://lore.kernel.org/dri-devel/QMers3awXvNCQlyhWdTtsPwkp5ie9bze_hD5nAccFW7a_RXlWjYB7MoUW_8CKLT2bSQwIXVi5H6VULYIxCdgvryZoAoJnC5lZgyK1QWn488=@emersion.fr/”…””}”(hj×  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jÐ  uh1jÕ  hjÒ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h MzhjÎ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j¼  hjË  hžhhŸh³h Nubah}”(h]”h ]”h"]”h$]”h&]”j
  j  j  hj  j  uh1j·  hjº  hžhhŸh³h Mzubeh}”(h]”Œ
references”ah ]”h"]”Œ
references”ah$]”h&]”uh1h´hh¶hžhhŸh³h Mxubeh}”(h]”Œlinux-color-pipeline-api”ah ]”h"]”Œlinux color pipeline api”ah$]”h&]”uh1h´hhhžhhŸh³h Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”h³uh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(h¹NŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”j*  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h³Œ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(j  j  j  j  jx  ju  j»  j¸  jð  jí  j%  j"  jL  jI  j(  j%  j   j  j•  j’  j>  j;  jÒ  jÏ  jt  jq  j·  j´  jü  jù  uŒ	nametypes”}”(j  ‰j  ‰jx  ‰j»  ‰jð  ‰j%  ‰jL  ‰j(  ‰j   ‰j•  ‰j>  ‰jÒ  ‰jt  ‰j·  ‰jü  ‰uh}”(j  h¶j  hÉju  j  j¸  j{  jí  j¾  j"  jó  jI  j(  j%  jO  j  jà  j’  j+  j;  j˜  jÏ  jA  jq  jÕ  j´  jw  jù  jº  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nhžhub.