CGImageProperties Reference

Framework
Companion guide
Declared in
CGImageProperties.h

Overview

CGImageProperties Reference defines constants that represent characteristics of images used by the Image I/O framework.

Constants

Format-Specific Dictionaries

Properties that have an associated dictionary of file-format or metadata-format specific key-value pairs.

CFStringRef kCGImagePropertyTIFFDictionary;
CFStringRef kCGImagePropertyGIFDictionary;
CFStringRef kCGImagePropertyJFIFDictionary;
CFStringRef kCGImagePropertyExifDictionary;
CFStringRef kCGImagePropertyPNGDictionary;
CFStringRef kCGImagePropertyIPTCDictionary;
CFStringRef kCGImagePropertyGPSDictionary;
CFStringRef kCGImagePropertyRawDictionary;
CFStringRef kCGImagePropertyCIFFDictionary;
CFStringRef kCGImageProperty8BIMDictionary;
CFStringRef kCGImagePropertyDNGDictionary;
CFStringRef kCGImagePropertyExifAuxDictionary;
Constants
kCGImagePropertyTIFFDictionary

A dictionary of key-value pairs for an image that uses Tagged Image File Format (TIFF). See “TIFF Dictionary Keys.”

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGIFDictionary

A dictionary of key-value pairs for an image that uses Graphics Interchange Format (GIF). See “GIF Dictionary Keys.”

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyJFIFDictionary

A dictionary of key-value pairs for an image that uses JPEG File Interchange Format (JFIF). See “JFIF Dictionary Keys.”

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifDictionary

A dictionary of key-value pairs for an image that uses Exchangeable Image File Format (EXIF). See “EXIF Dictionary Keys.”

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyPNGDictionary

A dictionary of key-value pairs for an image that uses Portable Network Graphics (PNG) format. See “PNG Dictionary Keys.”

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCDictionary

A dictionary of key-value pairs for an image that uses International Press Telecommunications Council (IPTC) metadata. See “IPTC Dictionary Keys.”

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSDictionary

A dictionary of key-value pairs for an image that has Global Positioning System (GPS) information. See “GPS Dictionary Keys.”

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyRawDictionary

A dictionary of key-value pairs for an image that contains minimally processed, or raw, data.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyCIFFDictionary

A dictionary of key-value pairs for an image that uses Camera Image File Format (CIFF). See “CIFF Dictionary Keys.”

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImageProperty8BIMDictionary

A dictionary of key-value pairs for an Adobe Photoshop image. See “8BIM Dictionary Keys.”

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyDNGDictionary

A dictionary of key-value pairs for an image that uses the Digital Negative (DNG) archival format. See “DNG Dictionary Keys.”

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifAuxDictionary

An auxiliary dictionary of key-value pairs for an image that uses Exchangeable Image File Format (EXIF).

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

Discussion

If any of these constants are returned by the functionsCGImageSourceCopyProperties or CGImageSourceCopyPropertiesAtIndex the associated value is a dictionary of key-value pairs that are specific to that file format or metadata format.

Camera-Maker Dictionaries

Properties that have an associated dictionary of key-value pairs for a specific camera manufacturer.

CFStringRef kCGImagePropertyMakerCanonDictionary;
CFStringRef kCGImagePropertyMakerNikonDictionary;
CFStringRef kCGImagePropertyMakerMinoltaDictionary;
CFStringRef kCGImagePropertyMakerFujiDictionary;
CFStringRef kCGImagePropertyMakerOlympusDictionary;
CFStringRef kCGImagePropertyMakerPentaxDictionary;
Constants
kCGImagePropertyMakerCanonDictionary

A dictionary of key-value pairs for an image from a Canon camera. See “Canon Camera Dictionary Keys.”

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyMakerNikonDictionary

A dictionary of key-value pairs for an image from a Nikon camera. See “Nikon Camera Dictionary Keys.”

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyMakerMinoltaDictionary

A dictionary of key-value pairs for an image from a Minolta camera.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyMakerFujiDictionary

A dictionary of key-value pairs for an image from a Fuji camera.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyMakerOlympusDictionary

A dictionary of key-value pairs for an image from a Olympus camera.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyMakerPentaxDictionary

A dictionary of key-value pairs for an image from a Pentax camera.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

Image Source Container Properties

Properties that apply to the container in general but not necessarily to any individual image in the container.

CFStringRef kCGImagePropertyFileSize;
Constants
kCGImagePropertyFileSize

The size of the image file in bytes, if known. If present, this key is a CFNumber value.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

Discussion

These properties can be returned by the function CGImageSourceCopyProperties.

Individual Image Properties

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

CFStringRef kCGImagePropertyDPIHeight;
CFStringRef kCGImagePropertyDPIWidth;
CFStringRef kCGImagePropertyPixelWidth;
CFStringRef kCGImagePropertyPixelHeight;
CFStringRef kCGImagePropertyDepth;
CFStringRef kCGImagePropertyOrientation;
CFStringRef kCGImagePropertyIsFloat;
CFStringRef kCGImagePropertyIsIndexed;
CFStringRef kCGImagePropertyHasAlpha;
CFStringRef kCGImagePropertyColorModel;
CFStringRef kCGImagePropertyProfileName;
Constants
kCGImagePropertyDPIHeight

The resolution, in dots per inch, in the x dimension. If present, this key is a CFNumber value.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyDPIWidth

The resolution, in dots per inch, in the y dimension. If present, this key is a CFNumber value.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyPixelWidth

The number of pixels in the x dimension. If present, this key is a CFNumber value.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyPixelHeight

The number of pixels in the y dimension. If present, this key is a CFNumber value.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyDepth

The number of bits in each color sample of each pixel. If present, this key is a CFNumber value.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyOrientation

The intended display orientation of the image. If present, this key is a CFNumber value with the same value as defined by the TIFF and EXIF specifications. The value specifies where the origin (0,0) of the image is located, as shown in Table 1. If not present, a value of 1 is assumed.

Table 1  

Value

Location of the origin of the image

1

Top, left

2

Top, right

3

Bottom, right

4

Bottom, left

5

Left, top

6

Right, top

7

Right, bottom

8

Left, bottom

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIsFloat

Whether or not the image contains floating-point pixel samples. The value of this key is kCFBooleanTrue if the image contains them.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIsIndexed

Whether or not the image contains indexed pixel samples (sometimes called paletted samples). The value of this key is kCFBooleanTrue if the image contains them.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyHasAlpha

Whether or not the image has an alpha channel. The value of this key is kCFBooleanTrue if the image contains an alpha channel.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyColorModel

The color model of the image such as, RGB, CMYK, Gray, or Lab. The value of this key is of type CFStringRef.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyProfileName

The name of the optional ICC profile embedded in the image, if known. If present, the value of this key is of type CFStringRef.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

Discussion

These properties can be returned by the function CGImageSourceCopyPropertiesAtIndex.

Color Model Values

Values for the color model property.

const CFStringRef kCGImagePropertyColorModelRGB;
const CFStringRef kCGImagePropertyColorModelGray;
const CFStringRef kCGImagePropertyColorModelCMYK;
const CFStringRef kCGImagePropertyColorModelLab;
Constants
kCGImagePropertyColorModelRGB

An RGB color model.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyColorModelGray

A grayscale color model.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyColorModelCMYK

A CMYK color model.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyColorModelLab

A Lab color model.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

Discussion

A color model describes how color values are represented mathematically. A color space is a color model combined with a definition of how to interpret values within the model.

EXIF Dictionary Keys

Keys for an image that uses Exchangeable Image File Format (EXIF).

const CFStringRef kCGImagePropertyExifExposureTime;
const CFStringRef kCGImagePropertyExifFNumber;
const CFStringRef kCGImagePropertyExifExposureProgram;
const CFStringRef kCGImagePropertyExifSpectralSensitivity;
const CFStringRef kCGImagePropertyExifISOSpeedRatings;
const CFStringRef kCGImagePropertyExifOECF;
const CFStringRef kCGImagePropertyExifVersion;
const CFStringRef kCGImagePropertyExifDateTimeOriginal;
const CFStringRef kCGImagePropertyExifDateTimeDigitized;
const CFStringRef kCGImagePropertyExifComponentsConfiguration;
const CFStringRef kCGImagePropertyExifCompressedBitsPerPixel;
const CFStringRef kCGImagePropertyExifShutterSpeedValue;
const CFStringRef kCGImagePropertyExifApertureValue;
const CFStringRef kCGImagePropertyExifBrightnessValue;
const CFStringRef kCGImagePropertyExifExposureBiasValue;
const CFStringRef kCGImagePropertyExifMaxApertureValue;
const CFStringRef kCGImagePropertyExifSubjectDistance;
const CFStringRef kCGImagePropertyExifMeteringMode;
const CFStringRef kCGImagePropertyExifLightSource;
const CFStringRef kCGImagePropertyExifFlash;
const CFStringRef kCGImagePropertyExifFocalLength;
const CFStringRef kCGImagePropertyExifSubjectArea;
const CFStringRef kCGImagePropertyExifMakerNote;
const CFStringRef kCGImagePropertyExifUserComment;
const CFStringRef kCGImagePropertyExifSubsecTime;
const CFStringRef kCGImagePropertyExifSubsecTimeOrginal;
const CFStringRef kCGImagePropertyExifSubsecTimeDigitized;
const CFStringRef kCGImagePropertyExifFlashPixVersion;
const CFStringRef kCGImagePropertyExifColorSpace;
const CFStringRef kCGImagePropertyExifPixelXDimension;
const CFStringRef kCGImagePropertyExifPixelYDimension;
const CFStringRef kCGImagePropertyExifRelatedSoundFile;
const CFStringRef kCGImagePropertyExifFlashEnergy;
const CFStringRef kCGImagePropertyExifSpatialFrequencyResponse;
const CFStringRef kCGImagePropertyExifFocalPlaneXResolution;
const CFStringRef kCGImagePropertyExifFocalPlaneYResolution;
const CFStringRef kCGImagePropertyExifFocalPlaneResolutionUnit;
const CFStringRef kCGImagePropertyExifSubjectLocation;
const CFStringRef kCGImagePropertyExifExposureIndex;
const CFStringRef kCGImagePropertyExifSensingMethod;
const CFStringRef kCGImagePropertyExifFileSource;
const CFStringRef kCGImagePropertyExifSceneType;
const CFStringRef kCGImagePropertyExifCFAPattern;
const CFStringRef kCGImagePropertyExifCustomRendered;
const CFStringRef kCGImagePropertyExifExposureMode;
const CFStringRef kCGImagePropertyExifWhiteBalance;
const CFStringRef kCGImagePropertyExifDigitalZoomRatio;
const CFStringRef kCGImagePropertyExifFocalLenIn35mmFilm;
const CFStringRef kCGImagePropertyExifSceneCaptureType;
const CFStringRef kCGImagePropertyExifGainControl;
const CFStringRef kCGImagePropertyExifContrast;
const CFStringRef kCGImagePropertyExifSaturation;
const CFStringRef kCGImagePropertyExifSharpness;
const CFStringRef kCGImagePropertyExifDeviceSettingDescription;
const CFStringRef kCGImagePropertyExifSubjectDistRange;
const CFStringRef kCGImagePropertyExifImageUniqueID;
const CFStringRef kCGImagePropertyExifGamma;
const CFStringRef kCGImagePropertyExifCameraOwnerName;
const CFStringRef kCGImagePropertyExifBodySerialNumber;
const CFStringRef kCGImagePropertyExifLensSpecification;
const CFStringRef kCGImagePropertyExifLensMake;
const CFStringRef kCGImagePropertyExifLensModel;
const CFStringRef kCGImagePropertyExifLensSerialNumber;
Constants
kCGImagePropertyExifExposureTime

The exposure time.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifFNumber

The F-number.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifExposureProgram

The exposure program.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifSpectralSensitivity

The spectral sensitivity of each channel.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifISOSpeedRatings

The ISO speed ratings.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifOECF

The opto-electrical conversion function (OECF), which defines the relationship between the optical input of the camera and the image values.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifVersion

The Exif version.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifDateTimeOriginal

The original date and time.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifDateTimeDigitized

The digitized date and time.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifComponentsConfiguration

The components configuration. For compressed data, specifies that the channels of each component are arranged in increasing numeric order (from first component to the fourth).

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifCompressedBitsPerPixel

The bits per pixel of the compression mode.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifShutterSpeedValue

The shutter speed value.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifApertureValue

The aperture value.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifBrightnessValue

The brightness value.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifExposureBiasValue

The exposure bias value.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifMaxApertureValue

The maximum aperture value.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifSubjectDistance

The distance to the subject, in meters.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifMeteringMode

The metering mode.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifLightSource

The light source.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifFlash

The flash status when the image was shot.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifFocalLength

The focal length.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifSubjectArea

The subject area.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifMakerNote

Information specified by the camera manufacturer.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifUserComment

A user comment.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifSubsecTime

The fraction of seconds for the date and time tag.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifSubsecTimeOrginal

The fraction of seconds for the original date and time tag.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifSubsecTimeDigitized

The fraction of seconds for the digitized time and date tag.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifFlashPixVersion

The FlashPix version supported by an FPXR file. FlashPix is a format for multiresolution tiled images that facilitates fast onscreen viewing.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifColorSpace

The color space.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifPixelXDimension

The x dimension of a pixel.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifPixelYDimension

The y dimension of a pixel.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifRelatedSoundFile

A sound file related to the image.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifFlashEnergy

The strobe energy when the image was captured, in beam candle power seconds.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifSpatialFrequencyResponse

The spatial frequency table and spatial frequency response values in the direction of image width, image height, and diagonal directions. See ISO 12233.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifFocalPlaneXResolution

The number of image-width pixels (x) per focal plane resolution unit.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifFocalPlaneYResolution

The number of image-height pixels (y)per focal plane resolution unit.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifFocalPlaneResolutionUnit

The unit of measurement for the focal plane x and y tags.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifSubjectLocation

The location of the image’s primary subject.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifExposureIndex

The selected exposure index.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifSensingMethod

The sensor type of the camera or input device.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifFileSource

The image source.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifSceneType

The scene type.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifCFAPattern

The color filter array (CFA) pattern, which is the geometric pattern of the image sensor for a 1-chip color sensor area.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifCustomRendered

Special rendering performed on the image data.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifExposureMode

The exposure mode setting.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifWhiteBalance

The white balance mode.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifDigitalZoomRatio

The digital zoom ratio.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifFocalLenIn35mmFilm

The equivalent focal length in 35 mm film.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifSceneCaptureType

The scene capture type (standard, landscape, portrait, night).

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifGainControl

The gain adjustment applied to the image.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifContrast

The contrast applied to the image.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifSaturation

The saturation applied to the image.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifSharpness

The sharpness applied to the image.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifDeviceSettingDescription

For a particular camera mode, indicates the conditions for taking the picture.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifSubjectDistRange

The distance to the subject.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifImageUniqueID

The unique ID of the image.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifGamma

The gamma setting.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifCameraOwnerName

The value associated with this key is a string that provides the name of the camera’s owner.

Available in OS X v10.7 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifBodySerialNumber

The value associated with this key is a string that provides the serial number of the camera.

Available in OS X v10.7 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifLensSpecification

The values associated with this key provide the specification information for the lens used to photograph the image.

Available in OS X v10.7 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifLensMake

The value associated with this key is a string that provides the name of the lens’s manufacturer.

Available in OS X v10.7 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifLensModel

The value associated with this key is a string that provides the lens’s model.

Available in OS X v10.7 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifLensSerialNumber

The value associated with this key is a string that provides the lens’s serial number.

Available in OS X v10.7 and later.

Declared in CGImageProperties.h.

EXIF Auxiliary Dictionary Keys

Auxiliary keys for an image that uses Exchangeable Image File Format (EXIF).

const CFStringRef kCGImagePropertyExifAuxLensInfo;
const CFStringRef kCGImagePropertyExifAuxLensModel;
const CFStringRef kCGImagePropertyExifAuxSerialNumber;
const CFStringRef kCGImagePropertyExifAuxLensID;
const CFStringRef kCGImagePropertyExifAuxLensSerialNumber;
const CFStringRef kCGImagePropertyExifAuxImageNumber;
const CFStringRef kCGImagePropertyExifAuxFlashCompensation;
const CFStringRef kCGImagePropertyExifAuxOwnerName;
const CFStringRef kCGImagePropertyExifAuxFirmware;
Constants
kCGImagePropertyExifAuxLensInfo

Lens information.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifAuxLensModel

The lens model.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifAuxSerialNumber

The serial number.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifAuxLensID

The lens ID.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifAuxLensSerialNumber

The lens serial number.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifAuxImageNumber

The image number.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifAuxFlashCompensation

Flash compensation.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifAuxOwnerName

The owner name.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyExifAuxFirmware

Firmware information.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

GIF Dictionary Keys

Keys for an image that uses Graphics Interchange Format (GIF).

const CFStringRef kCGImagePropertyGIFLoopCount;
const CFStringRef kCGImagePropertyGIFDelayTime;
const CFStringRef kCGImagePropertyGIFImageColorMap;
const CFStringRef kCGImagePropertyGIFHasGlobalColorMap;
const CFStringRef kCGImagePropertyGIFUnclampedDelayTime;
Constants
kCGImagePropertyGIFLoopCount

The number of times to repeat an animated sequence.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGIFDelayTime

The amount of time, in hundredths of a second, to wait before displaying the next image in an animated sequence.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGIFImageColorMap

The image color map.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGIFHasGlobalColorMap

Whether or not the GIF has a global color map.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGIFUnclampedDelayTime

The unclamped delay time.

Available in OS X v10.7 and later.

Declared in CGImageProperties.h.

GPS Dictionary Keys

Keys for an image that has Global Positioning System (GPS) information.

const CFStringRef kCGImagePropertyGPSVersion;
const CFStringRef kCGImagePropertyGPSLatitudeRef;
const CFStringRef kCGImagePropertyGPSLatitude;
const CFStringRef kCGImagePropertyGPSLongitudeRef;
const CFStringRef kCGImagePropertyGPSLongitude;
const CFStringRef kCGImagePropertyGPSAltitudeRef;
const CFStringRef kCGImagePropertyGPSAltitude;
const CFStringRef kCGImagePropertyGPSTimeStamp;
const CFStringRef kCGImagePropertyGPSSatellites;
const CFStringRef kCGImagePropertyGPSStatus;
const CFStringRef kCGImagePropertyGPSMeasureMode;
const CFStringRef kCGImagePropertyGPSDOP;
const CFStringRef kCGImagePropertyGPSSpeedRef;
const CFStringRef kCGImagePropertyGPSSpeed;
const CFStringRef kCGImagePropertyGPSTrackRef;
const CFStringRef kCGImagePropertyGPSTrack;
const CFStringRef kCGImagePropertyGPSImgDirectionRef;
const CFStringRef kCGImagePropertyGPSImgDirection;
const CFStringRef kCGImagePropertyGPSMapDatum;
const CFStringRef kCGImagePropertyGPSDestLatitudeRef;
const CFStringRef kCGImagePropertyGPSDestLatitude;
const CFStringRef kCGImagePropertyGPSDestLongitudeRef;
const CFStringRef kCGImagePropertyGPSDestLongitude;
const CFStringRef kCGImagePropertyGPSDestBearingRef;
const CFStringRef kCGImagePropertyGPSDestBearing;
const CFStringRef kCGImagePropertyGPSDestDistanceRef;
const CFStringRef kCGImagePropertyGPSDestDistance;
const CFStringRef kCGImagePropertyGPSProcessingMethod;
const CFStringRef kCGImagePropertyGPSAreaInformation;
const CFStringRef kCGImagePropertyGPSDateStamp;
const CFStringRef kCGImagePropertyGPSDifferental;
Constants
kCGImagePropertyGPSVersion

The version.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSLatitudeRef

Whether the latitude is north or south.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSLatitude

The latitude.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSLongitudeRef

Whether the longitude is east or west.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSLongitude

The longitude.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSAltitudeRef

The reference altitude.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSAltitude

The altitude.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSTimeStamp

The time as UTC (Coordinated Universal Time).

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSSatellites

The satellites used for GPS measurements.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSStatus

The status of the GPS receiver.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSMeasureMode

The measurement mode.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSDOP

The degree of precision (DOP) of the data.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSSpeedRef

The unit for expressing the GPS receiver speed of movement.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSSpeed

The GPS receiver speed of movement.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSTrackRef

The reference for the direction of GPS receiver movement.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSTrack

The direction of GPS receiver movement.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSImgDirectionRef

The reference for the direction of the image.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSImgDirection

The direction of the image.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSMapDatum

The geodetic survey data used by the GPS receiver.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSDestLatitudeRef

Whether the latitude of the destination point is northern or southern.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSDestLatitude

The latitude of the destination point.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSDestLongitudeRef

Whether the longitude of the destination point is east or west.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSDestLongitude

The longitude of the destination point.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSDestBearingRef

The reference for giving the bearing to the destination point.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSDestBearing

The bearing to the destination point.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSDestDistanceRef

The units for expressing the distance to the destination point.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSDestDistance

The distance to the destination point.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSProcessingMethod

The name of the method used for finding a location.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSAreaInformation

The name of the GPS area.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSDateStamp

The data and time information relative to Coordinated Universal Time (UTC).

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyGPSDifferental

Whether differential correction is applied to the GPS receiver.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

IPTC Dictionary Keys

Keys for an image that uses International Press Telecommunications Council (IPTC) metadata.

const CFStringRef kCGImagePropertyIPTCObjectTypeReference;
const CFStringRef kCGImagePropertyIPTCObjectAttributeReference;
const CFStringRef kCGImagePropertyIPTCObjectName;
const CFStringRef kCGImagePropertyIPTCEditStatus;
const CFStringRef kCGImagePropertyIPTCEditorialUpdate;
const CFStringRef kCGImagePropertyIPTCUrgency;
const CFStringRef kCGImagePropertyIPTCSubjectReference;
const CFStringRef kCGImagePropertyIPTCCategory;
const CFStringRef kCGImagePropertyIPTCSupplementalCategory;
const CFStringRef kCGImagePropertyIPTCFixtureIdentifier;
const CFStringRef kCGImagePropertyIPTCKeywords;
const CFStringRef kCGImagePropertyIPTCContentLocationCode;
const CFStringRef kCGImagePropertyIPTCContentLocationName;
const CFStringRef kCGImagePropertyIPTCReleaseDate;
const CFStringRef kCGImagePropertyIPTCReleaseTime;
const CFStringRef kCGImagePropertyIPTCExpirationDate;
const CFStringRef kCGImagePropertyIPTCExpirationTime;
const CFStringRef kCGImagePropertyIPTCSpecialInstructions;
const CFStringRef kCGImagePropertyIPTCActionAdvised;
const CFStringRef kCGImagePropertyIPTCReferenceService;
const CFStringRef kCGImagePropertyIPTCReferenceDate;
const CFStringRef kCGImagePropertyIPTCReferenceNumber;
const CFStringRef kCGImagePropertyIPTCDateCreated;
const CFStringRef kCGImagePropertyIPTCTimeCreated;
const CFStringRef kCGImagePropertyIPTCDigitalCreationDate;
const CFStringRef kCGImagePropertyIPTCDigitalCreationTime;
const CFStringRef kCGImagePropertyIPTCOriginatingProgram;
const CFStringRef kCGImagePropertyIPTCProgramVersion;
const CFStringRef kCGImagePropertyIPTCObjectCycle;
const CFStringRef kCGImagePropertyIPTCByline;
const CFStringRef kCGImagePropertyIPTCBylineTitle;
const CFStringRef kCGImagePropertyIPTCCity;
const CFStringRef kCGImagePropertyIPTCSubLocation;
const CFStringRef kCGImagePropertyIPTCProvinceState;
const CFStringRef kCGImagePropertyIPTCCountryPrimaryLocationCode;
const CFStringRef kCGImagePropertyIPTCCountryPrimaryLocationName;
const CFStringRef kCGImagePropertyIPTCOriginalTransmissionReference;
const CFStringRef kCGImagePropertyIPTCHeadline;
const CFStringRef kCGImagePropertyIPTCCredit;
const CFStringRef kCGImagePropertyIPTCSource;
const CFStringRef kCGImagePropertyIPTCCopyrightNotice;
const CFStringRef kCGImagePropertyIPTCContact;
const CFStringRef kCGImagePropertyIPTCCaptionAbstract;
const CFStringRef kCGImagePropertyIPTCWriterEditor;
const CFStringRef kCGImagePropertyIPTCImageType;
const CFStringRef kCGImagePropertyIPTCImageOrientation;
const CFStringRef kCGImagePropertyIPTCLanguageIdentifier;
const CFStringRef kCGImagePropertyIPTCStarRating;
const CFStringRef kCGImagePropertyIPTCCreatorContactInfo;
const CFStringRef kCGImagePropertyIPTCRightsUsageTerms
const CFStringRef kCGImagePropertyIPTCScene;
Constants
kCGImagePropertyIPTCObjectTypeReference

The object type.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCObjectAttributeReference

The object attribute.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCObjectName

The object name.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCEditStatus

The edit status.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCEditorialUpdate

An editorial update.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCUrgency

The urgency level.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCSubjectReference

The subject.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCCategory

The category.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCSupplementalCategory

A supplemental category.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCFixtureIdentifier

A fixture identifier.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCKeywords

Keywords.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCContentLocationCode

The content location code.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCContentLocationName

The content location name.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCReleaseDate

The earliest date the image is to be used, in the form CCYYMMDD.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCReleaseTime

The earliest time on the release date the image is to be used, in the form HHMMSS.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCExpirationDate

The latest date the image is to be used, in the form CCYYMMDD.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCExpirationTime

The latest time on the expiration date the image is to be used, in the form HHMMSS.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCSpecialInstructions

Special instructions about the use of the image.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCActionAdvised

The advised action.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCReferenceService

The reference service.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCReferenceDate

The reference date.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCReferenceNumber

The reference number.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCDateCreated

The date created.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCTimeCreated

The time created.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCDigitalCreationDate

The digital creation date.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCDigitalCreationTime

The digital creation time.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCOriginatingProgram

The originating application.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCProgramVersion

The application version.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCObjectCycle

The editorial cycle (morning, evening, or both) of the image.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCByline

The name of the person who created the image.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCBylineTitle

The title of the person who created the image.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCCity

The city where the image was created.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCSubLocation

The location within the city where the image was created.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCProvinceState

The province or state.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCCountryPrimaryLocationCode

The country primary location code, a three-letter code defined by ISO 3166-1

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCCountryPrimaryLocationName

The country primary location name.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCOriginalTransmissionReference

The call letter/number combination associated with the originating point of an image.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCHeadline

A summary of the contents of the image.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCCredit

The name of the service that provided the image.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCSource

The original owner of the image.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCCopyrightNotice

The copyright notice.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCContact

Contact information for further information on the image.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCCaptionAbstract

The description of the image.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCWriterEditor

The name of the person who wrote or edited the description of the image.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCImageType

The image type.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCImageOrientation

The image orientation (portrait, landscape, or square).

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCLanguageIdentifier

The language identifier, a two-letter code defined by ISO 639:1988.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCStarRating

The star rating.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCCreatorContactInfo

The creator’s contact info. See “IPTC Creator Contact Info Dictionary Keys.”

Available in OS X v10.6 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCRightsUsageTerms

The usage rights for the image.

Available in OS X v10.6 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCScene

The scene codes for the image; a scene code is a six-digit string.

Available in OS X v10.6 and later.

Declared in CGImageProperties.h.

Discussion

IPTC constants are metadata elements of the Information Interchange Model (IIM) used to provide information about images. The IIM was developed by the Newspaper Association of America (NAA) and the International Press Telecommunications Council (IPTC).

IPTC Creator Contact Info Dictionary Keys

Keys for an image that uses International Press Telecommunications Council (IPTC) metadata. These keys are used to reference data stored in the dictionary attached to the kCGImagePropertyIPTCCreatorContactInfo key.

const CFStringRef kCGImagePropertyIPTCContactInfoCity;
const CFStringRef kCGImagePropertyIPTCContactInfoCountry;
const CFStringRef kCGImagePropertyIPTCContactInfoAddress;
const CFStringRef kCGImagePropertyIPTCContactInfoPostalCode;
const CFStringRef kCGImagePropertyIPTCContactInfoStateProvince;
const CFStringRef kCGImagePropertyIPTCContactInfoEmails;
const CFStringRef kCGImagePropertyIPTCContactInfoPhones;
const CFStringRef kCGImagePropertyIPTCContactInfoWebURLs;
Constants
kCGImagePropertyIPTCContactInfoCity

The city portion of the contact information.

Available in OS X v10.6 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCContactInfoCountry

The country portion of the contact information.

Available in OS X v10.6 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCContactInfoAddress

The address portion of the contact information.

Available in OS X v10.6 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCContactInfoPostalCode

The postal code portion of the contact information.

Available in OS X v10.6 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCContactInfoStateProvince

The state or province for the contact.

Available in OS X v10.6 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCContactInfoEmails

Email addresses for the contact.

Available in OS X v10.6 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCContactInfoPhones

Phone numbers for the contact.

Available in OS X v10.6 and later.

Declared in CGImageProperties.h.

kCGImagePropertyIPTCContactInfoWebURLs

Web addresses for the contact.

Available in OS X v10.6 and later.

Declared in CGImageProperties.h.

Discussion

IPTC constants are metadata elements of the Information Interchange Model (IIM) used to provide information about images. The IIM was developed by the Newspaper Association of America (NAA) and the International Press Telecommunications Council (IPTC).

Declared In
CGImageProperties.h

JFIF Dictionary Keys

Keys for an image that uses JPEG File Interchange Format (JFIF).

const CFStringRef kCGImagePropertyJFIFVersion;
const CFStringRef kCGImagePropertyJFIFXDensity;
const CFStringRef kCGImagePropertyJFIFYDensity;
const CFStringRef kCGImagePropertyJFIFDensityUnit;
const CFStringRef kCGImagePropertyJFIFIsProgressive;
Constants
kCGImagePropertyJFIFVersion

The version of JFIF.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyJFIFXDensity

The x pixel density.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyJFIFYDensity

The y pixel density.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyJFIFDensityUnit

The units for the x and y density fields.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyJFIFIsProgressive

Whether there are versions of the image of increasing quality.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

PNG Dictionary Keys

Keys for an image that uses Portable Network Graphics (PNG) format.

const CFStringRef kCGImagePropertyPNGGamma;
const CFStringRef kCGImagePropertyPNGInterlaceType;
const CFStringRef kCGImagePropertyPNGXPixelsPerMeter;
const CFStringRef kCGImagePropertyPNGYPixelsPerMeter;
const CFStringRef kCGImagePropertyPNGsRGBIntent;
const CFStringRef kCGImagePropertyPNGChromaticities;
const CFStringRef kCGImagePropertyPNGAuthor;
const CFStringRef kCGImagePropertyPNGCopyright;
const CFStringRef kCGImagePropertyPNGCreationTime;
const CFStringRef kCGImagePropertyPNGDescription;
const CFStringRef kCGImagePropertyPNGModificationTime;
const CFStringRef kCGImagePropertyPNGSoftware;
const CFStringRef kCGImagePropertyPNGTitle;
Constants
kCGImagePropertyPNGGamma

The gamma value.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyPNGInterlaceType

The interlace type.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyPNGXPixelsPerMeter

The number of x pixels per meter.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyPNGYPixelsPerMeter

The number of y pixels per meter.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyPNGsRGBIntent

The sRGB intent.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyPNGChromaticities

The chromaticities.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyPNGAuthor

The content is a string that identifies the author of the image.

Available in OS X v10.7 and later.

Declared in CGImageProperties.h.

kCGImagePropertyPNGCopyright

The content is a string that identifies the copyright of the image.

Available in OS X v10.7 and later.

Declared in CGImageProperties.h.

kCGImagePropertyPNGCreationTime

The content is a string that identifies the date and time the image was created.

Available in OS X v10.7 and later.

Declared in CGImageProperties.h.

kCGImagePropertyPNGDescription

The content is a string that describes the image.

Available in OS X v10.7 and later.

Declared in CGImageProperties.h.

kCGImagePropertyPNGModificationTime

The content is a string that identifies the last date and time the image was modified.

Available in OS X v10.7 and later.

Declared in CGImageProperties.h.

kCGImagePropertyPNGSoftware

The content is a string that identifies the software used to create the image.

Available in OS X v10.7 and later.

Declared in CGImageProperties.h.

kCGImagePropertyPNGTitle

The content is a string that holds the image’s title.

Available in OS X v10.7 and later.

Declared in CGImageProperties.h.

TIFF Dictionary Keys

Keys for an image that uses Tagged Image File Format (TIFF).

const CFStringRef kCGImagePropertyTIFFCompression;
const CFStringRef kCGImagePropertyTIFFPhotometricInterpretation;
const CFStringRef kCGImagePropertyTIFFDocumentName;
const CFStringRef kCGImagePropertyTIFFImageDescription;
const CFStringRef kCGImagePropertyTIFFMake;
const CFStringRef kCGImagePropertyTIFFModel;
const CFStringRef kCGImagePropertyTIFFOrientation;
const CFStringRef kCGImagePropertyTIFFXResolution;
const CFStringRef kCGImagePropertyTIFFYResolution;
const CFStringRef kCGImagePropertyTIFFResolutionUnit;
const CFStringRef kCGImagePropertyTIFFSoftware;
const CFStringRef kCGImagePropertyTIFFTransferFunction;
const CFStringRef kCGImagePropertyTIFFDateTime;
const CFStringRef kCGImagePropertyTIFFArtist;
const CFStringRef kCGImagePropertyTIFFHostComputer;
const CFStringRef kCGImagePropertyTIFFCopyright;
const CFStringRef kCGImagePropertyTIFFWhitePoint;
const CFStringRef kCGImagePropertyTIFFPrimaryChromaticities;
Constants
kCGImagePropertyTIFFCompression

The compression scheme used on the image data.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyTIFFPhotometricInterpretation

The color space of the image data.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyTIFFDocumentName

The document name.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyTIFFImageDescription

The image description.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyTIFFMake

The name of the manufacturer of the camera or input device.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyTIFFModel

The camera or input device model.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyTIFFOrientation

The image orientation.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyTIFFXResolution

The number of pixels per resolution unit in the image width direction.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyTIFFYResolution

The number of pixels per resolution unit in the image height direction.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyTIFFResolutionUnit

The units of resolution.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyTIFFSoftware

The name and version of the software used for image creation.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyTIFFTransferFunction

The transfer function, in tabular format, used to map pixel components from a nonlinear form into a linear form.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyTIFFDateTime

The date and time that the image was created.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyTIFFArtist

The artist who created the image.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyTIFFHostComputer

The computer or operating system used when the image was created.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyTIFFCopyright

Copyright information.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyTIFFWhitePoint

The white point of the image.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

kCGImagePropertyTIFFPrimaryChromaticities

The chromaticities of the primaries of the image.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

DNG Dictionary Keys

Keys for an image that uses the Digital Negative (DNG) archival format.

CFStringRef kCGImagePropertyDNGVersion;
CFStringRef kCGImagePropertyDNGBackwardVersion;
CFStringRef kCGImagePropertyDNGUniqueCameraModel;
CFStringRef kCGImagePropertyDNGLocalizedCameraModel;
CFStringRef kCGImagePropertyDNGCameraSerialNumber;
CFStringRef kCGImagePropertyDNGLensInfo;
Constants
kCGImagePropertyDNGVersion

An encoding of the four-tier version number.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyDNGBackwardVersion

The oldest version for which a file is compatible.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyDNGUniqueCameraModel

A unique, nonlocalized name for the camera model.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyDNGLocalizedCameraModel

The localized camera model name.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyDNGCameraSerialNumber

The camera serial number.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyDNGLensInfo

Information about the lens used for the image.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

8BIM Dictionary Keys

A key for an Adobe Photoshop image.

CFStringRef kCGImageProperty8BIMLayerNames;
Constants
kCGImageProperty8BIMLayerNames

The layer names for an Adobe Photoshop file.

Available in OS X v10.4 and later.

Declared in CGImageProperties.h.

CIFF Dictionary Keys

Keys for an image that uses Camera Image File Format (CIFF).

CFStringRef kCGImagePropertyCIFFDescription;
CFStringRef kCGImagePropertyCIFFFirmware;
CFStringRef kCGImagePropertyCIFFOwnerName;
CFStringRef kCGImagePropertyCIFFImageName;
CFStringRef kCGImagePropertyCIFFImageFileName;
CFStringRef kCGImagePropertyCIFFReleaseMethod;
CFStringRef kCGImagePropertyCIFFReleaseTiming;
CFStringRef kCGImagePropertyCIFFRecordID;
CFStringRef kCGImagePropertyCIFFSelfTimingTime;
CFStringRef kCGImagePropertyCIFFCameraSerialNumber;
CFStringRef kCGImagePropertyCIFFImageSerialNumber;
CFStringRef kCGImagePropertyCIFFContinuousDrive;
CFStringRef kCGImagePropertyCIFFFocusMode;
CFStringRef kCGImagePropertyCIFFMeteringMode;
CFStringRef kCGImagePropertyCIFFShootingMode;
CFStringRef kCGImagePropertyCIFFLensMaxMM;
CFStringRef kCGImagePropertyCIFFLensMinMM;
CFStringRef kCGImagePropertyCIFFLensModel;
CFStringRef kCGImagePropertyCIFFWhiteBalanceIndex;
CFStringRef kCGImagePropertyCIFFFlashExposureComp;
CFStringRef kCGImagePropertyCIFFMeasuredEV;
Constants
kCGImagePropertyCIFFDescription

The camera description.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyCIFFFirmware

The firmware version of the camera.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyCIFFOwnerName

The name of the camera’s owner.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyCIFFImageName

The image name.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyCIFFImageFileName

The image file name.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyCIFFReleaseMethod

The method of shutter release—single-shot or continuous.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyCIFFReleaseTiming

The priority for shutter release timing—shutter or focus.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyCIFFRecordID

The number of images taken since the camera shipped.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyCIFFSelfTimingTime

The time in milliseconds until shutter release when using the self-timer.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyCIFFCameraSerialNumber

The camera serial number.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyCIFFImageSerialNumber

The image serial number.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyCIFFContinuousDrive

The continuous drive mode.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyCIFFFocusMode

The focus mode.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyCIFFMeteringMode

The metering mode.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyCIFFShootingMode

The shooting mode.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyCIFFLensMaxMM

The maximum lens length in millimeters.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyCIFFLensMinMM

The minimum lens length in millimeters.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyCIFFLensModel

The lens model.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyCIFFWhiteBalanceIndex

The white balance index.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyCIFFFlashExposureComp

The flash exposure compensation.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyCIFFMeasuredEV

The measured exposure value.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

Declared In
CGImageProperties.h

Nikon Camera Dictionary Keys

Keys for an image from a Nikon camera.

CFStringRef kCGImagePropertyMakerNikonISOSetting;
CFStringRef kCGImagePropertyMakerNikonColorMode;
CFStringRef kCGImagePropertyMakerNikonQuality;
CFStringRef kCGImagePropertyMakerNikonWhiteBalanceMode;
CFStringRef kCGImagePropertyMakerNikonSharpenMode;
CFStringRef kCGImagePropertyMakerNikonFocusMode;
CFStringRef kCGImagePropertyMakerNikonFlashSetting;
CFStringRef kCGImagePropertyMakerNikonISOSelection;
CFStringRef kCGImagePropertyMakerNikonFlashExposureComp;
CFStringRef kCGImagePropertyMakerNikonImageAdjustment;
CFStringRef kCGImagePropertyMakerNikonLensAdapter;
CFStringRef kCGImagePropertyMakerNikonLensType;
CFStringRef kCGImagePropertyMakerNikonLensInfo;
CFStringRef kCGImagePropertyMakerNikonFocusDistance;
CFStringRef kCGImagePropertyMakerNikonDigitalZoom;
CFStringRef kCGImagePropertyMakerNikonShootingMode;
CFStringRef kCGImagePropertyMakerNikonShutterCount;
CFStringRef kCGImagePropertyMakerNikonCameraSerialNumber;
Constants
kCGImagePropertyMakerNikonISOSetting

The ISO setting.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyMakerNikonColorMode

The color mode.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyMakerNikonQuality

The quality setting.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyMakerNikonWhiteBalanceMode

The white balance mode.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyMakerNikonSharpenMode

The sharpening mode.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyMakerNikonFocusMode

The focus mode.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyMakerNikonFlashSetting

The flash setting.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyMakerNikonISOSelection

The ISO selection.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyMakerNikonFlashExposureComp

The flash exposure compensation.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyMakerNikonImageAdjustment

The image adjustment setting.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyMakerNikonLensAdapter

The lens adapter.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyMakerNikonLensType

The lens type.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyMakerNikonLensInfo

Lens information.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyMakerNikonFocusDistance

The focus distance.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyMakerNikonDigitalZoom

The digital zoom setting.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyMakerNikonShootingMode

The shooting mode.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyMakerNikonShutterCount

The number of times the shutter has been actuated.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyMakerNikonCameraSerialNumber

The camera serial number.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

Canon Camera Dictionary Keys

Keys for an image from a Canon camera.

CFStringRef kCGImagePropertyMakerCanonOwnerName;
CFStringRef kCGImagePropertyMakerCanonCameraSerialNumber;
CFStringRef kCGImagePropertyMakerCanonImageSerialNumber;
CFStringRef kCGImagePropertyMakerCanonFlashExposureComp;
CFStringRef kCGImagePropertyMakerCanonContinuousDrive;
CFStringRef kCGImagePropertyMakerCanonLensModel;
CFStringRef kCGImagePropertyMakerCanonFirmware;
CFStringRef kCGImagePropertyMakerCanonAspectRatioInfo;
Constants
kCGImagePropertyMakerCanonOwnerName

The name of the camera's owner.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyMakerCanonCameraSerialNumber

The camera serial number.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyMakerCanonImageSerialNumber

The image serial number.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyMakerCanonFlashExposureComp

The flash exposure compensation setting.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyMakerCanonContinuousDrive

The presence of a continuous drive.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyMakerCanonLensModel

The lens model.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyMakerCanonFirmware

The firmware version.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.

kCGImagePropertyMakerCanonAspectRatioInfo

The image aspect ratio.

Available in OS X v10.5 and later.

Declared in CGImageProperties.h.