---
title: PGDisplay
framework: Paravirtualized Graphics
role: symbol
role_heading: Protocol
platforms: [Mac Catalyst 14.0+, macOS 11.0+]
path: paravirtualizedgraphics/pgdisplay
---

# PGDisplay

An object that provides display functionality to the guest operating system in a way that the host-side virtual machine app can intercept.

## Declaration

```swift
protocol PGDisplay : NSObjectProtocol
```

## Overview

Overview The framework emulates hot-plugging to the display. After you create the display object, set the modeList property to a list of modes you want the display to use. The first time you set the mode list, the framework connects the display to the virtualized graphics card. When you release the display object, the device simulates unplugging the display.

## Topics

### Setting Display Modes

- [modeList](paravirtualizedgraphics/pgdisplay/modelist.md)

### Getting the Guest Cursor Position

- [cursorPosition](paravirtualizedgraphics/pgdisplay/cursorposition.md)

### Handling Frame Updates

- [guestPresentCount](paravirtualizedgraphics/pgdisplay/guestpresentcount.md)
- [hostPresentCount](paravirtualizedgraphics/pgdisplay/hostpresentcount.md)
- [minimumTextureUsage](paravirtualizedgraphics/pgdisplay/minimumtextureusage.md)
- [encodeCurrentFrame(to:texture:region:)](paravirtualizedgraphics/pgdisplay/encodecurrentframe(to:texture:region:).md)

### Inspecting Display Properties

- [name](paravirtualizedgraphics/pgdisplay/name.md)
- [serialNum](paravirtualizedgraphics/pgdisplay/serialnum.md)
- [port](paravirtualizedgraphics/pgdisplay/port.md)
- [sizeInMillimeters](paravirtualizedgraphics/pgdisplay/sizeinmillimeters.md)

### Inspecting the Display Handlers

- [queue](paravirtualizedgraphics/pgdisplay/queue.md)
- [cursorShowHandler](paravirtualizedgraphics/pgdisplay/cursorshowhandler.md)
- [modeChangeHandler](paravirtualizedgraphics/pgdisplay/modechangehandler.md)
- [newFrameEventHandler](paravirtualizedgraphics/pgdisplay/newframeeventhandler.md)

### Instance Properties

- [cursorMoveHandler](paravirtualizedgraphics/pgdisplay/cursormovehandler.md)

## Relationships

### Inherits From

- [NSObjectProtocol](objectivec/nsobjectprotocol.md)

## See Also

### Displays

- [PGDisplayDescriptor](paravirtualizedgraphics/pgdisplaydescriptor.md)
- [PGDisplayMode](paravirtualizedgraphics/pgdisplaymode.md)
- [PGDisplayCoord_t](paravirtualizedgraphics/pgdisplaycoord_t.md)