<!--
{
  "documentType" : "article",
  "framework" : "VideoToolbox",
  "identifier" : "/documentation/VideoToolbox/VTHDRPerFrameMetadataGenerationSession-api-collection",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "VTHDRPerFrameMetadataGenerationSession"
}
-->

# VTHDRPerFrameMetadataGenerationSession

An object that generates per-frame HDR metadata.

## Topics

### Creating a session

[`VTHDRPerFrameMetadataGenerationSessionCreate`](/documentation/VideoToolbox/VTHDRPerFrameMetadataGenerationSessionCreate)

Creates a metadata generation session object.

### Attaching metadata

[`VTHDRPerFrameMetadataGenerationSessionAttachMetadata`](/documentation/VideoToolbox/VTHDRPerFrameMetadataGenerationSessionAttachMetadata)

Attaches per-frame metadata to the pixel buffer and the backing IOSurface.

### Accessing the type identifier

[`VTHDRPerFrameMetadataGenerationSessionGetTypeID`](/documentation/VideoToolbox/VTHDRPerFrameMetadataGenerationSessionGetTypeID)

Retrieves the Core Foundation type identifier for the session.

### Data types

[`VTHDRPerFrameMetadataGenerationSession`](/documentation/VideoToolbox/VTHDRPerFrameMetadataGenerationSession)

An object that generates per-frame HDR metadata.

[`VTHDRPerFrameMetadataGenerationSessionRef`](/documentation/VideoToolbox/VTHDRPerFrameMetadataGenerationSessionRef)

A mechanism for generating HDR Per Frame Metadata and attaching that metadata to a pixel buffer and the backing IOSurface.

[`VTHDRPerFrameMetadataGenerationHDRFormatType`](/documentation/VideoToolbox/VTHDRPerFrameMetadataGenerationHDRFormatType)

The HDR format type.

[`kVTHDRPerFrameMetadataGenerationHDRFormatType_DolbyVision`](/documentation/VideoToolbox/kVTHDRPerFrameMetadataGenerationHDRFormatType_DolbyVision)

Specifies that DolbyVision data should be generated and attached for each pixel buffer.

[`kVTHDRPerFrameMetadataGenerationOptionsKey_HDRFormats`](/documentation/VideoToolbox/kVTHDRPerFrameMetadataGenerationOptionsKey_HDRFormats)

Specifies an array of HDR formats to generate.


---

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)