---
title: ColorSyncProfile.HeadroomAdaptiveGainCurve
framework: colorsync
role: symbol
role_heading: Structure
platforms: [iOS 27.0+, iPadOS 27.0+, Mac Catalyst 27.0+, macOS 27.0+, tvOS 27.0+, visionOS 27.0+, watchOS 27.0+]
path: colorsync/colorsyncprofile/headroomadaptivegaincurve-swift.struct
---

# ColorSyncProfile.HeadroomAdaptiveGainCurve

Headroom Adaptive Gain Curve metadata that describes how to tone map a profile’s HDR content to the dynamic range available on the display.

## Declaration

```swift
struct HeadroomAdaptiveGainCurve
```

## Overview

Overview A profile stores this metadata in its HAGC tag; it applies only to profiles whose transfer function is PQ, HLG, or linear. Use colorVolumeTransform to describe the tone mapping to perform, then embed the curve in a profile with ColorSyncProfileCreateCopyWithHeadroomAdaptiveGainCurveInfoDictionary.

## Topics

### Structures

- [ColorSyncProfile.HeadroomAdaptiveGainCurve.ColorVolumeTransform](colorsync/colorsyncprofile/headroomadaptivegaincurve-swift.struct/colorvolumetransform-swift.struct.md)

### Initializers

- [init(applicationVersion:colorVolumeTransform:)](colorsync/colorsyncprofile/headroomadaptivegaincurve-swift.struct/init(applicationversion:colorvolumetransform:).md)

### Instance Properties

- [applicationVersion](colorsync/colorsyncprofile/headroomadaptivegaincurve-swift.struct/applicationversion.md)
- [colorVolumeTransform](colorsync/colorsyncprofile/headroomadaptivegaincurve-swift.struct/colorvolumetransform-swift.property.md)

### Enumerations

- [ColorSyncProfile.HeadroomAdaptiveGainCurve.Error](colorsync/colorsyncprofile/headroomadaptivegaincurve-swift.struct/error.md)

## See Also

### Describing a curve in Swift

- [ColorSyncProfile.HeadroomAdaptiveGainCurve.ColorVolumeTransform](colorsync/colorsyncprofile/headroomadaptivegaincurve-swift.struct/colorvolumetransform-swift.struct.md)
- [ColorSyncProfile.HeadroomAdaptiveGainCurve.ColorVolumeTransform.ToneMapping](colorsync/colorsyncprofile/headroomadaptivegaincurve-swift.struct/colorvolumetransform-swift.struct/tonemapping.md)
- [ColorSyncProfile.HeadroomAdaptiveGainCurve.ColorVolumeTransform.ToneMapping.Method](colorsync/colorsyncprofile/headroomadaptivegaincurve-swift.struct/colorvolumetransform-swift.struct/tonemapping/method-swift.enum.md)
- [ColorSyncProfile.HeadroomAdaptiveGainCurve.Error](colorsync/colorsyncprofile/headroomadaptivegaincurve-swift.struct/error.md)
