---
title: ColorSyncProfileCreateCopyWithHeadroomAdaptiveGainCurveMetadata
framework: colorsync
role: symbol
role_heading: Function
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/colorsyncprofilecreatecopywithheadroomadaptivegaincurvemetadata
---

# ColorSyncProfileCreateCopyWithHeadroomAdaptiveGainCurveMetadata

Returns a copy of a profile with the supplied Headroom Adaptive Gain Curve data embedded as an HAGC tag.

## Declaration

```occ
extern ColorSyncProfileRefColorSyncProfileCreateCopyWithHeadroomAdaptiveGainCurveMetadata(ColorSyncProfileRef profile, CFDataRef data, CFDictionaryRef options);
```

## Parameters

- `profile`: A profile whose CICP tag indicates a PQ, HLG, or linear transfer function. (Use linear for extended-range data.) Passing an SDR profile returns NULL.
- `data`: The raw Headroom Adaptive Gain Curve data to embed. Must be non-NULL.
- `options`: Reserved for future use. Pass NULL.

## Mentioned in

Authoring Headroom Adaptive Gain Curve metadata

## Return Value

Return Value A new profile that the caller must release with CFRelease, or NULL on failure.

## See Also

### Attaching a curve (C API)

- [ColorSyncProfileCreateCopyWithHeadroomAdaptiveGainCurveInfoDictionary](colorsync/colorsyncprofilecreatecopywithheadroomadaptivegaincurveinfodictionary.md)
