A color volume transform that maps HDR content into a display's
dynamic range.
A color volume transform can override the standard HDR reference white
and, optionally, supply headroom-adaptive tone mapping.
Members (5)
get · iOS 27.0+
adaptiveToneMapping
TypeScript
get adaptiveToneMapping(): (ColorSyncProfile_HeadroomAdaptiveGainCurve_ColorVolumeTransform_ToneMapping) | null
Swift declaration
var adaptiveToneMapping: ColorSyncProfile.HeadroomAdaptiveGainCurve.ColorVolumeTransform.ToneMapping?
The adaptive tone mapping to apply, if any.
set · iOS 27.0+
adaptiveToneMapping
TypeScript
set adaptiveToneMapping(value: (ColorSyncProfile_HeadroomAdaptiveGainCurve_ColorVolumeTransform_ToneMapping) | null)
Swift declaration
var adaptiveToneMapping: ColorSyncProfile.HeadroomAdaptiveGainCurve.ColorVolumeTransform.ToneMapping?
Creates a color volume transform.
- Parameters:
- customHDRReferenceWhite: A custom HDR reference white luminance
in nits, or `nil` to use the standard 203-nit reference white.
Must be greater than `0` when specified.
- adaptiveToneMapping: The headroom-adaptive tone mapping to apply,
or `nil` for none.
- Throws: ``Error/invalidHDRReferenceWhite(_:)`` if
`customHDRReferenceWhite` is less than or equal to `0`.
get · iOS 27.0+
customHDRReferenceWhite
TypeScript
get customHDRReferenceWhite(): (number) | null
Swift declaration
var customHDRReferenceWhite: Float?
A custom HDR reference white value, if specified.
set · iOS 27.0+
customHDRReferenceWhite
TypeScript
set customHDRReferenceWhite(value: (number) | null)