<!--
{
  "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/Error",
  "metadataVersion" : "0.1.0",
  "role" : "Enumeration",
  "symbol" : {
    "kind" : "Enumeration",
    "modules" : [
      "ColorSync"
    ],
    "preciseIdentifier" : "s:So19ColorSyncProfileRefa0aB0E25HeadroomAdaptiveGainCurveV5ErrorO"
  },
  "title" : "ColorSyncProfile.HeadroomAdaptiveGainCurve.Error"
}
-->

# ColorSyncProfile.HeadroomAdaptiveGainCurve.Error

An error thrown while constructing Headroom Adaptive Gain Curve metadata.

```
enum Error
```

## Topics

### Enumeration Cases

[`case invalidCustomChromaticities`](/documentation/ColorSync/ColorSyncProfile/HeadroomAdaptiveGainCurve-swift.struct/Error/invalidCustomChromaticities)

The custom chromaticities fall outside the valid range.

[`case invalidHDRReferenceWhite(Float)`](/documentation/ColorSync/ColorSyncProfile/HeadroomAdaptiveGainCurve-swift.struct/Error/invalidHDRReferenceWhite(_:))

The custom HDR reference white luminance isn’t greater than `0`.

[`case mismatchedControlPointArrays(x: Int, y: Int)`](/documentation/ColorSync/ColorSyncProfile/HeadroomAdaptiveGainCurve-swift.struct/Error/mismatchedControlPointArrays(x:y:))

The control points’ `x` and `y` arrays have different counts.

[`case mismatchedTangentCount(got: Int, expected: Int)`](/documentation/ColorSync/ColorSyncProfile/HeadroomAdaptiveGainCurve-swift.struct/Error/mismatchedTangentCount(got:expected:))

The number of explicit tangent slopes doesn’t match the control point count.

[`case negativeBaselineHeadroom(Float)`](/documentation/ColorSync/ColorSyncProfile/HeadroomAdaptiveGainCurve-swift.struct/Error/negativeBaselineHeadroom(_:))

The baseline headroom is negative.

[`case negativeHeadroomStops(Float)`](/documentation/ColorSync/ColorSyncProfile/HeadroomAdaptiveGainCurve-swift.struct/Error/negativeHeadroomStops(_:))

An alternate curve’s headroom is negative.

[`case tooManyAlternateCurves(count: Int, limit: Int)`](/documentation/ColorSync/ColorSyncProfile/HeadroomAdaptiveGainCurve-swift.struct/Error/tooManyAlternateCurves(count:limit:))

The number of alternate curves exceeds the limit.

[`case tooManyControlPoints(count: Int, limit: Int)`](/documentation/ColorSync/ColorSyncProfile/HeadroomAdaptiveGainCurve-swift.struct/Error/tooManyControlPoints(count:limit:))

The number of control points exceeds the limit.

[`case unsupportedApplicationVersion(UInt8)`](/documentation/ColorSync/ColorSyncProfile/HeadroomAdaptiveGainCurve-swift.struct/Error/unsupportedApplicationVersion(_:))

The application version isn’t supported. Only `0` is valid.

[`case zeroFreeStyleWeights`](/documentation/ColorSync/ColorSyncProfile/HeadroomAdaptiveGainCurve-swift.struct/Error/zeroFreeStyleWeights)

A free-style component mix has all-zero weights.

## Relationships

### Conforms To

[`Error`](/documentation/Swift/Error)

[`Sendable`](/documentation/Swift/Sendable)

[`SendableMetatype`](/documentation/Swift/SendableMetatype)

---

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)