<!--
{
  "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" : "CoreVideo",
  "identifier" : "/documentation/CoreVideo/CVProResRawMetadata",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "Core Video"
    ],
    "preciseIdentifier" : "s:9CoreVideo19CVProResRawMetadataV"
  },
  "title" : "CVProResRawMetadata"
}
-->

# CVProResRawMetadata

Metadata associated with ProRes RAW images.

```
struct CVProResRawMetadata
```

## Topics

### Structures

[`struct RecommendedCrop`](/documentation/CoreVideo/CVProResRawMetadata/RecommendedCrop-swift.struct)

Recommended pixels to discard in the image after raw conversion.

### Initializers

[`init(senselSitingOffsets: CVSenselSitingOffsets, blackLevel: Int32, whiteLevel: Int32, whiteBalanceCCT: Float32?, whiteBalanceRedFactor: Float32, whiteBalanceBlueFactor: Float32, colorMatrix: InlineArray<9, Float32>, gainFactor: Float32, recommendedCrop: CVProResRawMetadata.RecommendedCrop, extensions: Data?)`](/documentation/CoreVideo/CVProResRawMetadata/init(senselSitingOffsets:blackLevel:whiteLevel:whiteBalanceCCT:whiteBalanceRedFactor:whiteBalanceBlueFactor:colorMatrix:gainFactor:recommendedCrop:extensions:))

### Instance Properties

[`var blackLevel: Int32`](/documentation/CoreVideo/CVProResRawMetadata/blackLevel)

The sensel level corresponding to no light exposure.

[`var colorMatrix: InlineArray<9, Float32>`](/documentation/CoreVideo/CVProResRawMetadata/colorMatrix)

This is a 3x3 matrix which transforms linear RGB pixel values in the camera native color space to CIE 1931 XYZ
values relative to the D65 illuminant, where the matrix entries are stored in row-major order.

[`var extensions: Data?`](/documentation/CoreVideo/CVProResRawMetadata/extensions)

ProRes RAW metadata extensions.
This Data contains a big-endian UInt32 representing the size of the item in bytes followed by a 4-character code
(‘psim’) followed by a variable-length pascal string identifying the metadata (like a key string) followed by
the metadata payload.

[`var gainFactor: Float32`](/documentation/CoreVideo/CVProResRawMetadata/gainFactor)

The overall gain factor for raw conversion.

[`var recommendedCrop: CVProResRawMetadata.RecommendedCrop`](/documentation/CoreVideo/CVProResRawMetadata/recommendedCrop-swift.property)

The recommended number of: pixels to discard from the start (left) of each row of the image; pixels to discard
from the end (right) of each row of the image; rows of pixels to discard from the top of the image; and rows of
pixels to discard from the bottom of the image. Pixels/rows are discarded after raw conversion.

[`var senselSitingOffsets: CVSenselSitingOffsets`](/documentation/CoreVideo/CVProResRawMetadata/senselSitingOffsets)

Siting offsets, relative to pixel center, of individual sensels/components constituting each pixel.

[`var whiteBalanceBlueFactor: Float32`](/documentation/CoreVideo/CVProResRawMetadata/whiteBalanceBlueFactor)

The white balance multiplication factor for blue-filtered sensels.

[`var whiteBalanceCCT: Float32?`](/documentation/CoreVideo/CVProResRawMetadata/whiteBalanceCCT)

The illuminant correlated color temperature (CCT), in kelvins, selected at the time of capture. If not present,
the CCT is considered unknown or unspecified.

[`var whiteBalanceRedFactor: Float32`](/documentation/CoreVideo/CVProResRawMetadata/whiteBalanceRedFactor)

The white balance multiplication factor for red-filtered sensels.

[`var whiteLevel: Int32`](/documentation/CoreVideo/CVProResRawMetadata/whiteLevel)

The sensel level corresponding to sensor (or camera A-to-D converter) saturation.

## Relationships

### Conforms To

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

[`CVAttachmentValueRepresentable`](/documentation/CoreVideo/CVAttachmentValueRepresentable)

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

---

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)