<!--
{
  "availability" : [
    "iOS: 27.0.0 -",
    "iPadOS: 27.0.0 -",
    "macCatalyst: 27.0.0 -",
    "macOS: 27.0.0 -",
    "tvOS: 27.0.0 -",
    "visionOS: 27.0.0 -",
    "watchOS: 27.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "ColorSync",
  "identifier" : "/documentation/ColorSync/ColorSyncProfile/HeadroomAdaptiveGainCurve-swift.struct/ColorVolumeTransform-swift.struct/ToneMapping",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "ColorSync"
    ],
    "preciseIdentifier" : "s:So19ColorSyncProfileRefa0aB0E25HeadroomAdaptiveGainCurveV0A15VolumeTransformV11ToneMappingV"
  },
  "title" : "ColorSyncProfile.HeadroomAdaptiveGainCurve.ColorVolumeTransform.ToneMapping"
}
-->

# ColorSyncProfile.HeadroomAdaptiveGainCurve.ColorVolumeTransform.ToneMapping

Headroom-adaptive tone mapping that adjusts HDR content to the
display’s available headroom.

```
struct ToneMapping
```

## Overview

A tone mapping pairs a baseline headroom with a [`ColorSyncProfile.HeadroomAdaptiveGainCurve.ColorVolumeTransform.ToneMapping.Method`](/documentation/ColorSync/ColorSyncProfile/HeadroomAdaptiveGainCurve-swift.struct/ColorVolumeTransform-swift.struct/ToneMapping/Method-swift.enum) that
describes how to map content above reference white.

## Topics

### Initializers

[`init(baselineHeadroomStops: Float, method: ColorSyncProfile.HeadroomAdaptiveGainCurve.ColorVolumeTransform.ToneMapping.Method) throws`](/documentation/ColorSync/ColorSyncProfile/HeadroomAdaptiveGainCurve-swift.struct/ColorVolumeTransform-swift.struct/ToneMapping/init(baselineHeadroomStops:method:))

Creates a headroom-adaptive tone mapping.

### Instance Properties

[`var baselineHeadroomStops: Float`](/documentation/ColorSync/ColorSyncProfile/HeadroomAdaptiveGainCurve-swift.struct/ColorVolumeTransform-swift.struct/ToneMapping/baselineHeadroomStops)

Baseline headroom in stops above reference white.

[`var method: ColorSyncProfile.HeadroomAdaptiveGainCurve.ColorVolumeTransform.ToneMapping.Method`](/documentation/ColorSync/ColorSyncProfile/HeadroomAdaptiveGainCurve-swift.struct/ColorVolumeTransform-swift.struct/ToneMapping/method-swift.property)

The method used to tone map content above reference white.

### Enumerations

[`enum Method`](/documentation/ColorSync/ColorSyncProfile/HeadroomAdaptiveGainCurve-swift.struct/ColorVolumeTransform-swift.struct/ToneMapping/Method-swift.enum)

The tone-mapping method: reference-white-based, or a headroom-adaptive gain curve.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)