<!--
{
  "documentType" : "article",
  "framework" : "CoreGraphics",
  "identifier" : "/documentation/CoreGraphics/display-mode-standard-properties",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Display Mode Standard Properties"
}
-->

# Display Mode Standard Properties

Keys for the standard properties in a display mode dictionary.

## Discussion

To learn how to use these keys to access the values in a display mode dictionary, see <doc://com.apple.documentation/documentation/CoreFoundation/CFDictionary>.

### Special Considerations

Starting in OS X v10.6, display mode dictionaries have been made obsolete by the display mode opaque type. For more information on display modes, see[Changing Display Modes (OS X v10.6 or later)](https://developer.apple.com/library/archive/documentation/GraphicsImaging/Conceptual/QuartzDisplayServicesConceptual/Articles/DisplayModes.html#//apple_ref/doc/uid/TP40004234).

## Topics

### Constants

[`var kCGDisplayWidth: String`](/documentation/CoreGraphics/kCGDisplayWidth)

Specifies a CFNumber integer value that represents the width of the display in pixels.

[`var kCGDisplayHeight: String`](/documentation/CoreGraphics/kCGDisplayHeight)

Specifies a CFNumber integer value that represents the height of the display in pixels.

[`var kCGDisplayMode: String`](/documentation/CoreGraphics/kCGDisplayMode)

Specifies a `CFNumber` integer value that represents the I/O Kit display mode number.

[`var kCGDisplayBitsPerPixel: String`](/documentation/CoreGraphics/kCGDisplayBitsPerPixel)

Specifies a CFNumber integer value that represents the number of bits in a pixel.

[`var kCGDisplayBitsPerSample: String`](/documentation/CoreGraphics/kCGDisplayBitsPerSample)

Specifies a CFNumber integer value that represents the number of bits in an individual sample (for example, a color value in an RGB pixel).

[`var kCGDisplaySamplesPerPixel: String`](/documentation/CoreGraphics/kCGDisplaySamplesPerPixel)

Specifies a CFNumber integer value that represents the number of samples in a pixel.

[`var kCGDisplayRefreshRate: String`](/documentation/CoreGraphics/kCGDisplayRefreshRate)

Specifies a `CFNumber` double-precision floating point value that represents the refresh rate of a CRT display.

[`var kCGDisplayModeUsableForDesktopGUI: String`](/documentation/CoreGraphics/kCGDisplayModeUsableForDesktopGUI)

Specifies a CFBoolean value that indicates whether the display is suitable for use with the macOS graphical user interface. The criteria include factors such as sufficient width and height and adequate pixel depth.

[`var kCGDisplayIOFlags: String`](/documentation/CoreGraphics/kCGDisplayIOFlags)

Specifies a CFNumber integer value that contains the I/O Kit display mode flags. For more information, see the header file `IOKit/IOGraphicsTypes.h`.

[`var kCGDisplayBytesPerRow: String`](/documentation/CoreGraphics/kCGDisplayBytesPerRow)

Specifies a CFNumber integer value that represents the number of bytes in a row on the display.


---

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)