<!--
{
  "availability" : [
    "iOS: 13.0.0 -",
    "iPadOS: 13.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.4.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "ImageCaptureCore",
  "identifier" : "/documentation/ImageCaptureCore/ICCameraFile",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "ImageCaptureCore"
    ],
    "preciseIdentifier" : "c:objc(cs)ICCameraFile"
  },
  "title" : "ICCameraFile"
}
-->

# ICCameraFile

An object that represents a file on a camera.

```
class ICCameraFile
```

## Topics

### Requesting Metadata

[`requestMetadataDictionary(options:completion:)`](/documentation/ImageCaptureCore/ICCameraFile/requestMetadataDictionary(options:completion:))

Requests metadata and executes the completion block in place of the delegate.

### Requesting Thumbnails

[`requestThumbnailData(options:completion:)`](/documentation/ImageCaptureCore/ICCameraFile/requestThumbnailData(options:completion:))

Requests a thumbnail and executes the completion block in place of the delegate.

### Requesting Downloads

[`requestDownload(options:completion:)`](/documentation/ImageCaptureCore/ICCameraFile/requestDownload(options:completion:))

Requests a download and executes the completion block in place of the delegate.

### Requesting Data

[`requestReadData(atOffset:length:completion:)`](/documentation/ImageCaptureCore/ICCameraFile/requestReadData(atOffset:length:completion:))

Requests to asynchronously read data of a specified length from a specified offset, then executes the completion block.

### Inspecting a File’s Name

[`originalFilename`](/documentation/ImageCaptureCore/ICCameraFile/originalFilename)

The original name of the file on disk.

[`createdFilename`](/documentation/ImageCaptureCore/ICCameraFile/createdFilename)

The created name of the file.

### Inspecting a File’s Identity

[`groupUUID`](/documentation/ImageCaptureCore/ICCameraFile/groupUUID)

The group `UUID` of the file.

[`relatedUUID`](/documentation/ImageCaptureCore/ICCameraFile/relatedUUID)

A related UUID correlating several images from an Apple device.

[`originatingAssetID`](/documentation/ImageCaptureCore/ICCameraFile/originatingAssetID)

The originating asset ID of an `HEIF` or `HVEC` file.

### Determining When a File Was Created or Modified

[`fileCreationDate`](/documentation/ImageCaptureCore/ICCameraFile/fileCreationDate)

The creation date of the file.

[`fileModificationDate`](/documentation/ImageCaptureCore/ICCameraFile/fileModificationDate)

The modification date of the file.

### Inspecting a File’s Size

[`fileSize`](/documentation/ImageCaptureCore/ICCameraFile/fileSize)

The size of the file, in bytes.

### Inspecting a File’s Dimensions

[`width`](/documentation/ImageCaptureCore/ICCameraFile/width)

The width of an image or movie frame.

[`height`](/documentation/ImageCaptureCore/ICCameraFile/height)

The height of an image or movie frame.

### Inspecting a File’s EXIF Data

[`orientation`](/documentation/ImageCaptureCore/ICCameraFile/orientation)

The orientation to use when downloading the image.

[`ICEXIFOrientationType`](/documentation/ImageCaptureCore/ICEXIFOrientationType)

The file’s orientation type.

[`exifCreationDate`](/documentation/ImageCaptureCore/ICCameraFile/exifCreationDate)

The `EXIF` creation date of the file.

[`exifModificationDate`](/documentation/ImageCaptureCore/ICCameraFile/exifModificationDate)

The `EXIF` modification date of the file.

### Identifying a File’s Location

[`gpsString`](/documentation/ImageCaptureCore/ICCameraFile/gpsString)

The GPS String of the file in standard format.

### Inspecting a File in a Burst

[`firstPicked`](/documentation/ImageCaptureCore/ICCameraFile/firstPicked)

A Boolean value that indicates whether a file is autopicked by Photos to represent the burst.

[`burstUUID`](/documentation/ImageCaptureCore/ICCameraFile/burstUUID)

The burst UUID of the file if it is in a burst.

[`burstFavorite`](/documentation/ImageCaptureCore/ICCameraFile/burstFavorite)

A Boolean value that indicates this file is the burst favorite in a burst.

[`burstPicked`](/documentation/ImageCaptureCore/ICCameraFile/burstPicked)

A Boolean value that indicates whether this file is user picked in a burst.

### Inspecting Video Properties

[`duration`](/documentation/ImageCaptureCore/ICCameraFile/duration)

The duration, in seconds, of an audio or video file.

[`highFramerate`](/documentation/ImageCaptureCore/ICCameraFile/highFramerate)

A Boolean value that indicates whether the file is a slow motion or high-frame-rate video file.

[`timeLapse`](/documentation/ImageCaptureCore/ICCameraFile/timeLapse)

A Boolean value that indicates whether the file is a time-lapse video file.

### Identifying Related Files

[`sidecarFiles`](/documentation/ImageCaptureCore/ICCameraFile/sidecarFiles)

An array of two camera files associated with this file.

[`pairedRawImage`](/documentation/ImageCaptureCore/ICCameraFile/pairedRawImage)

A sidecar file containing the logical `RAW` compliment of a `JPG` or other two-format image.


---

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)