<!--
{
  "availability" : [
    "iOS: 10.0.0 -",
    "iPadOS: 10.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.12.0 -",
    "tvOS: 10.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "PhotoKit",
  "identifier" : "/documentation/Photos/PHLivePhotoFrame",
  "metadataVersion" : "0.1.0",
  "role" : "Protocol",
  "symbol" : {
    "kind" : "Protocol",
    "modules" : [
      "Photos"
    ],
    "preciseIdentifier" : "c:objc(pl)PHLivePhotoFrame"
  },
  "title" : "PHLivePhotoFrame"
}
-->

# PHLivePhotoFrame

A container that provides image content for a single frame of a Live Photo in an editing context.

```
protocol PHLivePhotoFrame
```

## Overview

You don’t create classes that implement this protocol. Instead, you provide a [`frameProcessor`](/documentation/Photos/PHLivePhotoEditingContext/frameProcessor) block when editing a Live Photo with the [`PHLivePhotoEditingContext`](/documentation/Photos/PHLivePhotoEditingContext) class. When you process your edits for output or display, Photos calls your block repeatedly to process each frame of the Live Photo’s video and still photo content. On each call, Photos provides the frame’s image content and associated information in an object that adopts this protocol. In that block, you use that object’s [`image`](/documentation/Photos/PHLivePhotoFrame/image) property to access the image to be edited, then perform your edits and return another <doc://com.apple.documentation/documentation/CoreImage/CIImage> object representing the result of processing the input image.

## Topics

### Editing the Frame Image

[`image`](/documentation/Photos/PHLivePhotoFrame/image)

The image content of the frame to be processed.

### Getting Information About the Frame

[`renderScale`](/documentation/Photos/PHLivePhotoFrame/renderScale)

The scale factor of the frame image relative to the Live Photo’s photo content.

[`time`](/documentation/Photos/PHLivePhotoFrame/time)

The time offset, in seconds, of this frame relative to the start of the Live Photo.

[`type`](/documentation/Photos/PHLivePhotoFrame/type)

The type of image content in this frame.

[`PHLivePhotoFrameType`](/documentation/Photos/PHLivePhotoFrameType)

Identifiers for the type of frame image to be processed. Used with the [`type`](/documentation/Photos/PHLivePhotoFrame/type) property.


---

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)