<!--
{
  "availability" : [
    "iOS: 27.0.0 -",
    "iPadOS: 27.0.0 -",
    "macCatalyst: 18.2.0 -",
    "macOS: 12.3.0 -",
    "tvOS: 27.0.0 -",
    "visionOS: 27.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "ScreenCaptureKit",
  "identifier" : "/documentation/ScreenCaptureKit/SCStreamFrameInfo",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "ScreenCaptureKit"
    ],
    "preciseIdentifier" : "c:@T@SCStreamFrameInfo"
  },
  "title" : "SCStreamFrameInfo"
}
-->

# SCStreamFrameInfo

An instance that defines metadata keys for a stream frame.

```
struct SCStreamFrameInfo
```

## Overview

Use [`SCStreamFrameInfo`](/documentation/ScreenCaptureKit/SCStreamFrameInfo) keys to retrieve values from the dictionary of metadata attached to the sample buffers that a stream produces. For example, you can retrieve the display time, content scale, and scaling factor, as shown below:

```swift
// A dictionary of attachments for a streamed sample buffer.
let attachments: [SCStreamFrameInfo: Any] = // Retrieve attachments from a sample buffer.

let displayTime = attachments[.displayTime] as? UInt64 ?? 0
let contentScale = attachments[.contentScale] as? Double ?? 0.0
let scaleFactor = attachments[.scaleFactor] as? Double ?? 0.0
```

## Topics

### Frame information constants

[`status`](/documentation/ScreenCaptureKit/SCStreamFrameInfo/status)

A key to retrieve the status of a video frame.

[`displayTime`](/documentation/ScreenCaptureKit/SCStreamFrameInfo/displayTime)

A key to retrieve the display time of a video frame.

[`scaleFactor`](/documentation/ScreenCaptureKit/SCStreamFrameInfo/scaleFactor)

A key to retrieve the scale factor of a video frame.

[`contentScale`](/documentation/ScreenCaptureKit/SCStreamFrameInfo/contentScale)

A key to retrieve the content scale of a video frame.

[`contentRect`](/documentation/ScreenCaptureKit/SCStreamFrameInfo/contentRect)

A key to retrieve the content rectangle of a video frame.

[`boundingRect`](/documentation/ScreenCaptureKit/SCStreamFrameInfo/boundingRect)

A key to retrieve the bounding rectangle for a video frame.

[`screenRect`](/documentation/ScreenCaptureKit/SCStreamFrameInfo/screenRect)

A key to retrieve the onscreen location of captured content.

[`dirtyRects`](/documentation/ScreenCaptureKit/SCStreamFrameInfo/dirtyRects)

A key to retrieve the areas of a video frame that contain changes.

[`presenterOverlayContentRect`](/documentation/ScreenCaptureKit/SCStreamFrameInfo/presenterOverlayContentRect)


---

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)