<!--
{
  "documentType" : "article",
  "framework" : "ImageIO",
  "identifier" : "/documentation/ImageIO/heic-image-properties",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "HEIC Image Properties"
}
-->

# HEIC Image Properties

Metadata keys for the High Efficiency Image Container (HEIC) format.

## Topics

### Dictionary

[`kCGImagePropertyHEICSDictionary`](/documentation/ImageIO/kCGImagePropertyHEICSDictionary)

A dictionary of properties related to an HEIC container.

### Image Properties

[`kCGImagePropertyHEICSCanvasPixelHeight`](/documentation/ImageIO/kCGImagePropertyHEICSCanvasPixelHeight)

The height of the main image, in pixels.

[`kCGImagePropertyHEICSCanvasPixelWidth`](/documentation/ImageIO/kCGImagePropertyHEICSCanvasPixelWidth)

The width of the main image, in pixels.

[`kCGImagePropertyNamedColorSpace`](/documentation/ImageIO/kCGImagePropertyNamedColorSpace)

The name of the image’s color space.

### Sequence Timing

[`kCGImagePropertyHEICSFrameInfoArray`](/documentation/ImageIO/kCGImagePropertyHEICSFrameInfoArray)

An array of dictionaries that contain timing information for the image sequence.

[`kCGImagePropertyHEICSDelayTime`](/documentation/ImageIO/kCGImagePropertyHEICSDelayTime)

The number of seconds to wait before displaying the next image in the sequence, clamped to a minimum of `0.1` seconds.

[`kCGImagePropertyHEICSUnclampedDelayTime`](/documentation/ImageIO/kCGImagePropertyHEICSUnclampedDelayTime)

The unclamped number of seconds to wait before displaying the next image in the sequence.

[`kCGImagePropertyHEICSLoopCount`](/documentation/ImageIO/kCGImagePropertyHEICSLoopCount)

The number of times to play the sequence.


---

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)