<!--
{
  "availability" : [
    "macCatalyst: -",
    "macOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "CoreGraphics",
  "identifier" : "/documentation/CoreGraphics/CGDisplayMode",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Core Graphics"
    ],
    "preciseIdentifier" : "c:@T@CGDisplayModeRef"
  },
  "title" : "CGDisplayMode"
}
-->

# CGDisplayMode

A reference to a display mode object.

```
class CGDisplayMode
```

## Overview

A display mode is a set of properties (such as width, height, pixel depth, and refresh rate), and options (such as stretched LCD panel filling). For more information see [Creating and Managing Display Modes](/documentation/CoreGraphics/quartz-display-services#Creating-and-Managing-Display-Modes) or [Getting Information About a Display Mode](/documentation/CoreGraphics/quartz-display-services#Getting-Information-About-a-Display-Mode).

## Topics

### Instance Properties

[`height`](/documentation/CoreGraphics/CGDisplayMode/height)

Returns the height of the specified display mode.

[`ioDisplayModeID`](/documentation/CoreGraphics/CGDisplayMode/ioDisplayModeID)

Returns the I/O Kit display mode ID of the specified display mode.

[`ioFlags`](/documentation/CoreGraphics/CGDisplayMode/ioFlags)

Returns the I/O Kit flags of the specified display mode.

[`pixelHeight`](/documentation/CoreGraphics/CGDisplayMode/pixelHeight)

[`pixelWidth`](/documentation/CoreGraphics/CGDisplayMode/pixelWidth)

[`refreshRate`](/documentation/CoreGraphics/CGDisplayMode/refreshRate)

Returns the refresh rate of the specified display mode.

[`width`](/documentation/CoreGraphics/CGDisplayMode/width)

Returns the width of the specified display mode.

### Type Properties

[`typeID`](/documentation/CoreGraphics/CGDisplayMode/typeID)

Returns the type identifier of Quartz display modes.

### Instance Methods

[`pixelEncoding`](/documentation/CoreGraphics/CGDisplayMode/pixelEncoding)

Returns the pixel encoding of the specified display mode.

[`isUsableForDesktopGUI()`](/documentation/CoreGraphics/CGDisplayMode/isUsableForDesktopGUI())

Returns a Boolean value indicating whether the specified display mode is usable for a desktop graphical user interface.


---

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)