<!--
{
  "availability" : [
    "FxPlug: 4.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "professional_video_applications",
  "identifier" : "/documentation/professional_video_applications/FxColorGamutAPI_v2",
  "metadataVersion" : "0.1.0",
  "role" : "Protocol",
  "symbol" : {
    "kind" : "Protocol",
    "modules" : [
      "Professional Video Applications"
    ],
    "preciseIdentifier" : "c:objc(pl)FxColorGamutAPI_v2"
  },
  "title" : "FxColorGamutAPI_v2"
}
-->

# FxColorGamutAPI_v2

A protocol that handles plug-in queries to the host for the project’s color gamut.

```
protocol FxColorGamutAPI_v2
```

## Overview

The `FxColorGamutAPI` retrieves the matrices for converting between RGB (in the project’s color gamut) and YCbCr. Use this protocol when your plug-in converts to YCbCr or from color pixels to grayscale.

> Note:
> This is version 2 of the Color Gamut API and does not require `FxTime`.

## Topics

### Getting Color Gamut Information

[`func colorMatrixFromDesiredRGBToYCbCr() -> FxMatrix44!`](/documentation/professional_video_applications/FxColorGamutAPI_v2/colorMatrixFromDesiredRGBToYCbCr())

Returns a color matrix that is appropriate for converting RGB values in the project’s working gamut into YCbCr values.

[`func colorMatrixFromYCbCrToDesiredRGB() -> FxMatrix44!`](/documentation/professional_video_applications/FxColorGamutAPI_v2/colorMatrixFromYCbCrToDesiredRGB())

Returns a color matrix that is appropriate for converting RGB values from YCbCr to an RGB value in the project’s working gamut.

[`func colorPrimaries() -> FxColorPrimaries`](/documentation/professional_video_applications/FxColorGamutAPI_v2/colorPrimaries())

Provides an enumerated type that describes the color primaries of the project’s working gamut.

### Constants

[`typealias FxColorPrimaries`](/documentation/professional_video_applications/FxColorPrimaries)

Constants used to describe a set of color primaries.



---

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)