Quartz Display Services

Overview

You can use Quartz Display Services to:

• Examine and change display mode properties such as width, height, and pixel depth

• Configure a set of displays in a single operation

• Capture one or more displays for exclusive use

• Stream the contents of a display

• Perform fade effects

• Activate display mirroring

• Configure gamma color correction tables

• Receive notification of screen update operations

Topics

Finding Displays

• CGMainDisplayID()
• CGGetOnlineDisplayList(_:_:_:)
• CGGetActiveDisplayList(_:_:_:)
• CGGetDisplaysWithOpenGLDisplayMask(_:_:_:_:)
• CGGetDisplaysWithPoint(_:_:_:_:)
• CGGetDisplaysWithRect(_:_:_:_:)
• CGOpenGLDisplayMaskToDisplayID(_:)
• CGDisplayIDToOpenGLDisplayMask(_:)

Capturing and Releasing Displays

• CGDisplayCapture(_:)
• CGDisplayCaptureWithOptions(_:_:)
• CGDisplayRelease(_:)
• CGDisplayIsCaptured(_:)
• CGCaptureAllDisplays()
• CGCaptureAllDisplaysWithOptions(_:)
• CGReleaseAllDisplays()
• CGShieldingWindowID(_:)
• CGShieldingWindowLevel()
• CGDisplayGetDrawingContext(_:)

Creating Images from the Display

• CGDisplayCreateImage(_:)
• CGDisplayCreateImage(_:rect:)

Configuring Displays

• CGBeginDisplayConfiguration(_:)
• CGCancelDisplayConfiguration(_:)
• CGCompleteDisplayConfiguration(_:_:)
• CGConfigureDisplayMirrorOfDisplay(_:_:_:)
• CGConfigureDisplayMode(_:_:_:)
• CGConfigureDisplayOrigin(_:_:_:_:)
• CGRestorePermanentDisplayConfiguration()
• CGConfigureDisplayStereoOperation(_:_:_:_:)
• CGDisplaySetStereoOperation(_:_:_:_:)
• CGConfigureDisplayWithDisplayMode(_:_:_:_:)

Getting the Display Configuration

• CGDisplayCopyColorSpace(_:)
• CGDisplayIOServicePort(_:)
• CGDisplayIsActive(_:)
• CGDisplayIsAlwaysInMirrorSet(_:)
• CGDisplayIsAsleep(_:)
• CGDisplayIsBuiltin(_:)
• CGDisplayIsInHWMirrorSet(_:)
• CGDisplayIsInMirrorSet(_:)
• CGDisplayIsMain(_:)
• CGDisplayIsOnline(_:)
• CGDisplayIsStereo(_:)
• CGDisplayMirrorsDisplay(_:)
• CGDisplayModelNumber(_:)
• CGDisplayPrimaryDisplay(_:)
• CGDisplayRotation(_:)
• CGDisplayScreenSize(_:)
• CGDisplaySerialNumber(_:)
• CGDisplayUnitNumber(_:)
• CGDisplayUsesOpenGLAcceleration(_:)
• CGDisplayVendorNumber(_:)

Registering for Notification of Display Configuration Changes

• CGDisplayRegisterReconfigurationCallback(_:_:)
• CGDisplayRemoveReconfigurationCallback(_:_:)

Retrieving Display Parameters

• CGDisplayBounds(_:)
• CGDisplayPixelsHigh(_:)
• CGDisplayPixelsWide(_:)

Creating and Managing Display Modes

• CGDisplayAvailableModes(_:)
• CGDisplayBestModeForParameters(_:_:_:_:_:)
• CGDisplayBestModeForParametersAndRefreshRate(_:_:_:_:_:_:)
• CGDisplayCurrentMode(_:)
• CGDisplaySwitchToMode(_:_:)
• CGDisplayCopyDisplayMode(_:)
• CGDisplayCopyAllDisplayModes(_:_:)
• CGDisplaySetDisplayMode(_:_:_:)

Getting Information About a Display Mode

• width
• height
• pixelEncoding
• refreshRate
• ioFlags
• ioDisplayModeID
• isUsableForDesktopGUI()
• typeID

Adjusting the Display Gamma

• CGSetDisplayTransferByFormula(_:_:_:_:_:_:_:_:_:_:)
• CGGetDisplayTransferByFormula(_:_:_:_:_:_:_:_:_:_:)
• CGSetDisplayTransferByTable(_:_:_:_:_:)
• CGGetDisplayTransferByTable(_:_:_:_:_:_:)
• CGSetDisplayTransferByByteTable(_:_:_:_:_:)
• CGDisplayRestoreColorSyncSettings()
• CGDisplayGammaTableCapacity(_:)

Display Fade Effects

• CGConfigureDisplayFadeEffect(_:_:_:_:_:_:)
• CGAcquireDisplayFadeReservation(_:_:)
• CGDisplayFade(_:_:_:_:_:_:_:_:)
• CGDisplayFadeOperationInProgress()
• CGReleaseDisplayFadeReservation(_:)

Controlling the Mouse Cursor

• CGDisplayHideCursor(_:)
• CGDisplayShowCursor(_:)
• CGDisplayMoveCursorToPoint(_:_:)
• CGCursorIsVisible()
• CGCursorIsDrawnInFramebuffer()
• CGAssociateMouseAndMouseCursorPosition(_:)
• CGWarpMouseCursorPosition(_:)
• CGGetLastMouseDelta()

Getting Window Server Information

• CGSessionCopyCurrentDictionary()
• CGWindowServerCFMachPort()
• CGWindowLevelForKey(_:)

Getting Information About Refresh and Move Operations

• CGRegisterScreenRefreshCallback(_:_:)
• CGUnregisterScreenRefreshCallback(_:_:)
• CGWaitForScreenRefreshRects(_:_:)
• CGScreenRegisterMoveCallback(_:_:)
• CGScreenUnregisterMoveCallback(_:_:)
• CGWaitForScreenUpdateRects(_:_:_:_:_:)
• CGReleaseScreenRefreshRects(_:)

Streaming the Contents of a Display

• init(display:outputWidth:outputHeight:pixelFormat:properties:handler:)
• init(dispatchQueueDisplay:outputWidth:outputHeight:pixelFormat:properties:queue:handler:)
• start()
• stop()
• runLoopSource
• getRects(_:rectCount:)
• init(mergedUpdateFirstUpdate:secondUpdate:)
• getMovedRectsDelta(dx:dy:)
• dropCount
• typeID
• typeID

Callbacks

• CGDisplayReconfigurationCallBack
• CGScreenRefreshCallback
• CGScreenUpdateMoveCallback

Data Types

• CGDirectDisplayID
• CGDisplayBlendFraction
• CGDisplayConfigRef
• CGDisplayCount
• CGDisplayErr
• CGDisplayFadeInterval
• CGDisplayFadeReservationToken
• CGDisplayMode
• CGDisplayReservationInterval
• CGGammaValue
• CGOpenGLDisplayMask
• CGRectCount
• CGRefreshRate
• CGScreenUpdateMoveDelta
• CGWindowLevel
• CGDisplayStream
• CGDisplayStreamUpdate
• CGDisplayStreamFrameAvailableHandler

Constants

• CGCaptureOptions
• CGDisplayChangeSummaryFlags
• CGConfigureOption
• Display Fade Blend Fractions
• Display Fade Constants
• Display ID Defaults
• Display Mode Standard Properties
• Display Mode Optional Properties
• Reserved Window Levels
• CGScreenUpdateOperation
• CGWindowLevelKey
• Window Server Session Properties
• CGDisplayStreamUpdateRectType
• CGDisplayStreamFrameStatus
• Display Stream Optional Property Keys
• Display Stream YCbCr to RGB conversion Matrix Options

See Also

Related Documentation

• Quartz Display Services Programming Topics

Services

• Quartz Event Services
• Quartz Window Services