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

# Image Properties

Properties that apply to the container in general, and not necessarily to an individual image in the container.

## Discussion

Access these properties using the [`CGImageSourceCopyProperties(_:_:)`](/documentation/ImageIO/CGImageSourceCopyProperties(_:_:)) function.

## Topics

### Dictionary

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

A dictionary of properties related to the image’s on-disk file.

### Container File Size

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

The size of the image file in bytes, if known.

### Image Information

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

The number of images in the file.

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

A Boolean value that indicates whether the image contains indexed pixel samples.

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

An array of dictionaries, each of which contains metadata for one of the images in the file.

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

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

The index of the primary image in the file.

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

A Boolean value that indicates whether the image contains floating-point pixel samples.

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

The intended display orientation of the image.

[Individual Image Properties](/documentation/ImageIO/individual-image-properties)

Properties that apply to an individual image in an image source.

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

A value describing the intended display orientation for an image.

### Pixel Information

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

The format of the image’s individual pixels.

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

The number of pixels along the x-axis of the image.

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

The number of pixels along the y-axis of the image.

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

The resolution, in dots per inch, in the y dimension.

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

The resolution, in dots per inch, in the x dimension.

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

The number of bits in the color sample of a pixel.

### Color Information

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

A Boolean value that indicates whether the image has an alpha channel.

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

The name of the image’s color space.

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

The name of the optional International Color Consortium (ICC) profile embedded in the image, if known.

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

The color model of the image, such as RGB, CMYK, grayscale, or Lab.

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

A Red Green Blue (RGB) color model.

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

A Cyan Magenta Yellow Black (CMYK) color model.

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

A grayscale color model.

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

A Lab color model, where color values contain the amount of light and the amounts of four human-perceivable colors.


---

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)