Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ссылочная кварцевая ссылка служб дисплея платформы ApplicationServices

Опции
Развертывание Target:

На этой странице
Язык:

Кварцевая ссылка служб дисплея

Quartz Display Services обеспечивает прямой доступ к определенным низкоуровневым функциям в сервере окна OS X, связанном с конфигурацией и управлением аппаратных средств дисплея. Например, можно использовать Quartz Display Services для:

  • Исследуйте и измените свойства режима отображения, такие как ширина, высота и пиксельная глубина

  • Сконфигурируйте ряд дисплеев в единственной работе

  • Получите один или несколько дисплеев для монопольного использования

  • Передайте содержание потоком дисплея

  • Выполните исчезают эффекты

  • Активируйте зеркальное отражение дисплея

  • Сконфигурируйте гамма таблицы коррекции цвета

  • Получите уведомление об экранных операциях обновления

Функции

Нахождение дисплеев
  • CGMainDisplayID () CGMainDisplayID

    Возвращает дисплей ID основного дисплея.

    Объявление

    Swift

    func CGMainDisplayID() -> CGDirectDisplayID

    Objective C

    CGDirectDisplayID CGMainDisplayID ( void );

    Возвращаемое значение

    Дисплей ID присвоился к основному дисплею.

    Обсуждение

    Основной дисплей является дисплеем со своим расположением на экране в (0,0) в глобальном координатном пространстве дисплея. В системе без зеркального отражения дисплея дисплей со строкой меню обычно является основным дисплеем.

    Если зеркальное отражение включено, и строка меню появляется больше чем на одном дисплее, эта функция обеспечивает надежный способ найти основной дисплей.

    В случае аппаратного зеркального отражения drawable дисплей становится основным дисплеем. В случае зеркального отражения программного обеспечения дисплей с самым высоким разрешением и самой глубокой пиксельной глубиной обычно становится основным дисплеем.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.2 и позже.

  • CGGetOnlineDisplayList (_: _: _:) CGGetOnlineDisplayList

    Обеспечивает список дисплеев, которые являются онлайновыми (активный, зеркально отраженный, или спящий).

    Объявление

    Swift

    func CGGetOnlineDisplayList(_ maxDisplays: UInt32, _ onlineDspys: UnsafeMutablePointer<CGDirectDisplayID>, _ dspyCnt: UnsafeMutablePointer<UInt32>) -> CGError

    Objective C

    CGError CGGetOnlineDisplayList ( uint32_t maxDisplays, CGDirectDisplayID *onlineDisplays, uint32_t *displayCount );

    Параметры

    maxDisplays

    Размер onlineDspys массив. Это значение определяет максимальное количество дисплея IDs, который может быть возвращен.

    onlineDspys

    Указатель на хранение, предоставленное вызывающей стороной для массива дисплея IDs. По возврату массив содержит список онлайновых дисплеев. Если Вы передаете NULL, по возврату количество дисплея содержит общее количество онлайновых дисплеев.

    dspyCnt

    Указатель на дисплей считает переменную предоставленной вызывающей стороной. По возврату количество дисплея содержит фактическое число дисплеев, возвращенных в onlineDspys массив. Это значение самое большее maxDisplays.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Если аппаратные средства кадрового буфера подключаются, дисплей считают подключенным или онлайновым.

    Когда аппаратное зеркальное отражение используется, дисплей может быть онлайновым, но не активным или drawable. Для программ, управляющих настройками дисплея (такими как гамма таблицы) нужен доступ ко всем дисплеям, включая аппаратные зеркала, которые не drawable.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.2 и позже.

  • CGGetActiveDisplayList (_: _: _:) CGGetActiveDisplayList

    Обеспечивает список дисплеев, которые активны (или drawable).

    Объявление

    Swift

    func CGGetActiveDisplayList(_ maxDisplays: UInt32, _ activeDspys: UnsafeMutablePointer<CGDirectDisplayID>, _ dspyCnt: UnsafeMutablePointer<UInt32>) -> CGError

    Objective C

    CGError CGGetActiveDisplayList ( uint32_t maxDisplays, CGDirectDisplayID *activeDisplays, uint32_t *displayCount );

    Параметры

    maxDisplays

    Размер activeDspys массив. Это значение определяет максимальное количество дисплеев, которые могут быть возвращены.

    activeDspys

    Указатель на хранение, предоставленное вызывающей стороной для массива дисплея IDs. По возврату массив содержит список активных дисплеев. Если Вы передаете NULL, по возврату количество дисплея содержит общее количество активных дисплеев.

    dspyCnt

    Указатель на дисплей считает переменную предоставленной вызывающей стороной. По возврату количество дисплея содержит фактическое число дисплеев, возвращенных в activeDspys массив. Это значение самое большее maxDisplays.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Первая запись в списке активных дисплеев является основным дисплеем. В случае зеркального отражения первая запись является самым большим drawable дисплеем или, если все - тот же размер, дисплей с самой большой пиксельной глубиной.

    Обратите внимание на то, что, когда аппаратное зеркальное отражение используется между дисплеями, только главный дисплей активен и появляется в списке. Когда зеркальное отражение программного обеспечения используется, все зеркальные дисплеи активны и появляются в списке. Для получения дополнительной информации о зеркальном отражении, посмотрите CGConfigureDisplayMirrorOfDisplay.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGGetDisplaysWithOpenGLDisplayMask (_: _: _: _:) CGGetDisplaysWithOpenGLDisplayMask

    Обеспечивает список дисплеев, соответствующий набору битов в маске дисплея OpenGL.

    Объявление

    Swift

    func CGGetDisplaysWithOpenGLDisplayMask(_ mask: CGOpenGLDisplayMask, _ maxDisplays: UInt32, _ dspys: UnsafeMutablePointer<CGDirectDisplayID>, _ dspyCnt: UnsafeMutablePointer<UInt32>) -> CGError

    Objective C

    CGError CGGetDisplaysWithOpenGLDisplayMask ( CGOpenGLDisplayMask mask, uint32_t maxDisplays, CGDirectDisplayID *displays, uint32_t *matchingDisplayCount );

    Параметры

    mask

    Маска дисплея OpenGL, идентифицирующая один или несколько дисплеев.

    maxDisplays

    Размер dspys массив. Это значение определяет максимальное количество дисплеев, которые могут быть возвращены.

    dspys

    Указатель на хранение, предоставленное вызывающей стороной для массива дисплея IDs. По возврату массив содержит список дисплеев, соответствующий набору битов в маске. Если Вы передаете NULL, по возврату количество дисплея содержит общее количество дисплеев, указанных в маске.

    dspyCnt

    Указатель на дисплей считает переменную предоставленной вызывающей стороной. По возврату количество дисплея содержит фактическое число дисплеев, возвращенных в dspys массив. Это значение самое большее maxDisplays.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGGetDisplaysWithPoint (_: _: _: _:) CGGetDisplaysWithPoint

    Обеспечивает список онлайновых дисплеев с границами, включающими указанную точку.

    Объявление

    Swift

    func CGGetDisplaysWithPoint(_ point: CGPoint, _ maxDisplays: UInt32, _ dspys: UnsafeMutablePointer<CGDirectDisplayID>, _ dspyCnt: UnsafeMutablePointer<UInt32>) -> CGError

    Objective C

    CGError CGGetDisplaysWithPoint ( CGPoint point, uint32_t maxDisplays, CGDirectDisplayID *displays, uint32_t *matchingDisplayCount );

    Параметры

    point

    Координаты точки в глобальном координатном пространстве дисплея. Источник является верхним левым углом основного дисплея.

    maxDisplays

    Размер dspys массив. Это значение определяет максимальное количество дисплеев, которые могут быть возвращены.

    dspys

    Указатель на хранение, предоставленное вызывающей стороной для массива дисплея IDs. По возврату массив содержит список дисплеев с границами, включающими точку. Если Вы передаете NULL, по возврату количество дисплея содержит общее количество дисплеев с границами, включающими точку.

    dspyCnt

    Указатель на дисплей считает переменную предоставленной вызывающей стороной. По возврату количество дисплея содержит фактическое число дисплеев, возвращенных в dspys массив. Это значение самое большее maxDisplays.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Если dspys массив NULL, эта функция игнорирует maxDisplays параметр. Если maxDisplays параметр 0, эта функция игнорирует dspys массив. В любом случае эта функция заполняет dspyCnt указатель с числом дисплеев, содержащих указанную точку.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGGetDisplaysWithRect (_: _: _: _:) CGGetDisplaysWithRect

    Получает список онлайновых дисплеев с границами, пересекающими указанный прямоугольник.

    Объявление

    Swift

    func CGGetDisplaysWithRect(_ rect: CGRect, _ maxDisplays: UInt32, _ dspys: UnsafeMutablePointer<CGDirectDisplayID>, _ dspyCnt: UnsafeMutablePointer<UInt32>) -> CGError

    Objective C

    CGError CGGetDisplaysWithRect ( CGRect rect, uint32_t maxDisplays, CGDirectDisplayID *displays, uint32_t *matchingDisplayCount );

    Параметры

    rect

    Расположение и размер прямоугольника в глобальном координатном пространстве дисплея. Источник является верхним левым углом основного дисплея.

    maxDisplays

    Размер dspys массив. Это значение определяет максимальное количество дисплеев, которые могут быть возвращены в dspys параметр. Обычно необходимо указать число, больше, чем 0 для этого параметра. Если Вы указываете 0, значение возвратилось в dspyCnt не определено, и эта функция устанавливает dspys параметр к NULL.

    dspys

    Указатель на хранение, предоставленное вызывающей стороной для массива дисплея IDs. По возврату массив содержит список дисплеев, границы которых пересекают указанный прямоугольник.

    dspyCnt

    Указатель на дисплей считает переменную предоставленной вызывающей стороной. По возврату эта переменная содержит число дисплеев, возвращенных в dspys параметр. Необходимо обеспечить не -NULL значение для этого параметра.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Если dspys массив NULL, эта функция игнорирует maxDisplays параметр. Если maxDisplays параметр 0, эта функция игнорирует dspys массив. В любом случае эта функция заполняет dspyCnt указатель с числом дисплеев, пересекающих указанный прямоугольник.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGOpenGLDisplayMaskToDisplayID (_:) CGOpenGLDisplayMaskToDisplayID

    Отображает маску дисплея OpenGL на дисплей ID.

    Объявление

    Swift

    func CGOpenGLDisplayMaskToDisplayID(_ mask: CGOpenGLDisplayMask) -> CGDirectDisplayID

    Objective C

    CGDirectDisplayID CGOpenGLDisplayMaskToDisplayID ( CGOpenGLDisplayMask mask );

    Параметры

    mask

    Маска дисплея OpenGL, которая будет преобразована.

    Возвращаемое значение

    Дисплей ID присвоился к указанной маске дисплея, или kCGNullDirectDisplay если никакой дисплей не соответствует маску.

    Обсуждение

    OpenGL иногда идентифицирует дисплей с помощью битовой маски с одним набором битов. Эта функция отображает такую маску дисплея на соответствующий дисплей ID. Если Вы передаете в маске с многократным набором битов, эта функция возвращает дисплей ID, соответствующий один из этих битов.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.2 и позже.

  • CGDisplayIDToOpenGLDisplayMask (_:) CGDisplayIDToOpenGLDisplayMask

    Отображает дисплей ID на маску дисплея OpenGL.

    Объявление

    Swift

    func CGDisplayIDToOpenGLDisplayMask(_ display: CGDirectDisplayID) -> CGOpenGLDisplayMask

    Objective C

    CGOpenGLDisplayMask CGDisplayIDToOpenGLDisplayMask ( CGDirectDisplayID display );

    Параметры

    display

    Дисплей ID, который будет преобразован.

    Возвращаемое значение

    Маска дисплея OpenGL, соответствующая указанному дисплею.

    Обсуждение

    OpenGL иногда идентифицирует дисплей с помощью битовой маски с одним набором битов. Эта функция отображает дисплей ID на соответствующую маску дисплея OpenGL.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

Получение и выпуск дисплеев
  • CGDisplayCapture (_:) CGDisplayCapture

    Получает дисплей для монопольного использования приложением.

    Объявление

    Swift

    func CGDisplayCapture(_ display: CGDirectDisplayID) -> CGError

    Objective C

    CGError CGDisplayCapture ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, который будет получен.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Когда приложение получает дисплей, Кварц не позволяет другим приложениям и системным службам использовать дисплей или изменять его конфигурацию.

    Если зеркальное отражение аппаратных средств или программного обеспечения имеет силу, самый простой способ получить главный дисплей и все зеркальные дисплеи состоит в том, чтобы использовать функцию CGCaptureAllDisplays. В случае зеркального отражения программного обеспечения приложения, рисующие непосредственно к дисплею, должны удостовериться, что нарисовали то же содержание ко всем дисплеям в зеркальном наборе.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGDisplayCaptureWithOptions (_: _:) CGDisplayCaptureWithOptions

    Получает дисплей для монопольного использования приложением, с помощью указанных опций.

    Объявление

    Swift

    func CGDisplayCaptureWithOptions(_ display: CGDirectDisplayID, _ options: CGCaptureOptions) -> CGError

    Objective C

    CGError CGDisplayCaptureWithOptions ( CGDirectDisplayID display, CGCaptureOptions options );

    Параметры

    display

    Идентификатор дисплея, который будет получен.

    options

    Опции использовать. Посмотрите Опции Получения Дисплея.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Эта функция позволяет Вам указывать одну или более опций использовать во время получения дисплея.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.3 и позже.

    См. также

    CGDisplayCapture

  • CGDisplayRelease (_:) CGDisplayRelease

    Выпускает полученный дисплей.

    Объявление

    Swift

    func CGDisplayRelease(_ display: CGDirectDisplayID) -> CGError

    Objective C

    CGError CGDisplayRelease ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, который будет выпущен.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGDisplayIsCaptured CGDisplayIsCaptured (OS X v10.9)

    Возвращает булево значение, указывающее, получен ли дисплей.

    Оператор осуждения

    Нет никакой замены.

    Объявление

    Objective C

    boolean_t CGDisplayIsCaptured ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Если true, указанный дисплей получен; иначе, false.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.9.

  • CGCaptureAllDisplays () CGCaptureAllDisplays

    Получения все присоединенные дисплеи.

    Объявление

    Swift

    func CGCaptureAllDisplays() -> CGError

    Objective C

    CGError CGCaptureAllDisplays ( void );

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Эта функция получает все присоединенные дисплеи в единственной работе. Эта работа обеспечивает иммерсивную среду для Вашего приложения, и это препятствует тому, чтобы другие приложения пытались корректироваться к изменениям дисплея.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    CGDisplayCapture

  • CGCaptureAllDisplaysWithOptions (_:) CGCaptureAllDisplaysWithOptions

    Получения все присоединенные дисплеи, с помощью указанных опций.

    Объявление

    Swift

    func CGCaptureAllDisplaysWithOptions(_ options: CGCaptureOptions) -> CGError

    Objective C

    CGError CGCaptureAllDisplaysWithOptions ( CGCaptureOptions options );

    Параметры

    options

    Опции использовать. Посмотрите Опции Получения Дисплея.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Эта функция позволяет Вам указывать одну или более опций использовать во время получения всех присоединенных дисплеев.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.3 и позже.

    См. также

    CGCaptureAllDisplays

  • CGReleaseAllDisplays () CGReleaseAllDisplays

    Выпуски все полученные дисплеи.

    Объявление

    Swift

    func CGReleaseAllDisplays() -> CGError

    Objective C

    CGError CGReleaseAllDisplays ( void );

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Эта функция выпускает все полученные дисплеи и восстанавливает режимы отображения к предпочтениям пользователя. Это может использоваться в сочетании с любой из функций, получающих дисплеи, такой как CGCaptureAllDisplays.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGShieldingWindowID (_:) CGShieldingWindowID

    Возвращает окно ID окна экрана для полученного дисплея.

    Объявление

    Swift

    func CGShieldingWindowID(_ display: CGDirectDisplayID) -> UInt32

    Objective C

    uint32_t CGShieldingWindowID ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Окно ID окна экрана для указанного дисплея, или NULL если не экранируется дисплей.

    Обсуждение

    Для предотвращения обновлений программами прямо к экрану Кварц рисует окно экрана, заполняющее весь экран полученного дисплея.

    Эта функция не рекомендуется для использования в приложениях. Обратите внимание на то, что графический контекст, связанный с этим окном, не является полнофункциональным контекстом получения. Для получения полнофункционального контекста получения для полученного дисплея необходимо использовать функцию CGDisplayGetDrawingContext.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGShieldingWindowLevel () CGShieldingWindowLevel

    Возвращает уровень окна окна экрана для полученного дисплея.

    Объявление

    Swift

    func CGShieldingWindowLevel() -> Int32

    Objective C

    int32_t CGShieldingWindowLevel ( void );

    Возвращаемое значение

    Уровень окна окна экрана для полученного дисплея.

    Обсуждение

    Эта функция возвращает значение, иногда использующееся для расположения окна по окну экрана для полученного дисплея. Попытка расположить окно по полученному дисплею может быть неуспешной — или она может представить нежелательные результаты, такие как неразборчивое или невидимое содержание — из-за взаимодействий между полноэкранной графикой (таких как OpenGL полноэкранные контексты получения) и аппаратным обеспечением машинной графики. Из-за этих ограничений не рекомендуется этот метод.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGDisplayAddressForPosition CGDisplayAddressForPosition Доступный в OS X v10.0 через OS X v10.6

    Возвращает адрес в памяти кадрового буфера, соответствующей позиции на онлайновом дисплее.

    Оператор осуждения

    Нет никакой замены; потому что прямой доступ к необработанному кадровому буферу не необходим, нет никакой потребности получить ее адрес памяти.

    Объявление

    Objective C

    void * CGDisplayAddressForPosition ( CGDirectDisplayID display, int32_t x, int32_t y );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    x

    X-координата позиции в глобальном координатном пространстве дисплея. Источник является верхним левым углом основного дисплея.

    y

    Y-координата позиции в глобальном координатном пространстве дисплея. Источник является верхним левым углом основного дисплея, и ось y ориентирована вниз.

    Возвращаемое значение

    Адрес в памяти кадрового буфера, соответствующей указанной позиции. Если дисплей, ID недопустим или точка, находится вне границ дисплея, возвращаемое значение NULL.

    Обсуждение

    Если дисплей не был получен, возвращенный адрес может относиться к постоянной памяти.

    Специальные замечания

    Эта осуждаемая функция возвратила адрес в памяти кадрового буфера. Вместо того, чтобы использовать необработанный кадровый буфер для рисования на экран необходимо вместо этого использовать поддерживаемый механизм получения, такой как Кварц или OpenGL. В то время как доступ к кадровому буферу непосредственно был осужден, возможно скопировать экранное использование данных CGDisplayCreateImageForRect.

    Оператор импорта

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.6.

    Осуждаемый в OS X v10.6.

  • CGDisplayBaseAddress CGDisplayBaseAddress Доступный в OS X v10.0 через OS X v10.6

    Возвращает базовый адрес в памяти кадрового буфера онлайнового дисплея.

    Оператор осуждения

    Нет никакой замены; потому что прямой доступ к необработанному кадровому буферу не необходим, нет никакой потребности получить ее адрес памяти.

    Объявление

    Objective C

    void * CGDisplayBaseAddress ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Базовый адрес в памяти кадрового буфера указанного дисплея. Если дисплей, ID недопустим, возвращаемое значение, NULL.

    Обсуждение

    Если дисплей не был получен, возвращенный адрес может относиться к постоянной памяти.

    Специальные замечания

    Эта осуждаемая функция возвратила адрес в памяти кадрового буфера. Вместо того, чтобы использовать необработанный кадровый буфер для рисования на экран необходимо вместо этого использовать поддерживаемый механизм получения, такой как Кварц или OpenGL. В то время как доступ к кадровому буферу непосредственно был осужден, возможно скопировать экранное использование данных CGDisplayCreateImage.

    Оператор импорта

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.6.

    Осуждаемый в OS X v10.6.

  • CGDisplayGetDrawingContext (_:) CGDisplayGetDrawingContext

    Возвращает графический контекст, подходящий для рисования к полученному дисплею.

    Объявление

    Swift

    func CGDisplayGetDrawingContext(_ display: CGDirectDisplayID) -> Unmanaged<CGContext>!

    Objective C

    CGContextRef CGDisplayGetDrawingContext ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Кварцевый контекст графики, подходящий для рисования к полученному дисплею, или NULL если не был получен дисплей. Контекст принадлежит системе, и Вы не должны выпускать его.

    Обсуждение

    После получения дисплея или изменения конфигурации полученного дисплея, можно использовать эту функцию для получения текущего графического контекста для дисплея. Графический контекст остается допустимым, в то время как дисплей получен, и конфигурация дисплея неизменна. Выпуск полученного дисплея или реконфигурирование дисплея лишают законной силы контекст. Для определения, когда конфигурация дисплея изменяется можно использовать функцию CGDisplayRegisterReconfigurationCallback зарегистрировать обратный вызов реконфигурирования дисплея.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.3 и позже.

Создание изображений от дисплея
  • CGDisplayCreateImage (_:) CGDisplayCreateImage

    Возвращает изображение, содержащее содержание указанного дисплея.

    Объявление

    Swift

    func CGDisplayCreateImage(_ display: CGDirectDisplayID) -> Unmanaged<CGImage>!

    Objective C

    CGImageRef CGDisplayCreateImage ( CGDirectDisplayID displayID );

    Параметры

    display

    Идентификатор дисплея, для которого создается изображение.

    Возвращаемое значение

    Изображение, содержащее содержание указанного дисплея. Если дисплей, ID недопустим, возвращаемое значение, NULL. Вызывающая сторона ответственна за выпуск изображения, создаваемого путем вызова CGImageRelease.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.6 и позже.

  • CGDisplayCreateImageForRect (_: _:) CGDisplayCreateImageForRect

    Возвращает изображение, содержащее содержание части указанного дисплея.

    Объявление

    Swift

    func CGDisplayCreateImageForRect(_ display: CGDirectDisplayID, _ rect: CGRect) -> Unmanaged<CGImage>!

    Objective C

    CGImageRef CGDisplayCreateImageForRect ( CGDirectDisplayID display, CGRect rect );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    rect

    Прямоугольник, указанный в выставочном пространстве, для части дисплея, скопированного в изображение.

    Возвращаемое значение

    Изображение, содержащее содержание указанного прямоугольника. Если дисплей, ID недопустим, возвращаемое значение, NULL. Вызывающая сторона ответственна за выпуск изображения, создаваемого путем вызова CGImageRelease.

    Обсуждение

    Фактический используемый прямоугольник является прямоугольником, возвращенным CGRectIntegral с rect в качестве параметра.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.6 и позже.

Конфигурирование дисплеев
  • CGBeginDisplayConfiguration (_:) CGBeginDisplayConfiguration

    Начинает новый набор изменений конфигурации дисплея.

    Объявление

    Swift

    func CGBeginDisplayConfiguration(_ pConfigRef: UnsafeMutablePointer<Unmanaged<CGDisplayConfig>?>) -> CGError

    Objective C

    CGError CGBeginDisplayConfiguration ( CGDisplayConfigRef *config );

    Параметры

    pConfigRef

    Указатель на хранение Вы предусматриваете конфигурацию дисплея. По возврату Ваше хранение содержит новую конфигурацию дисплея.

    Возвращаемое значение

    Код результата. Если объект успешно создается, результат kCGErrorSuccess. Для других возможных значений посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Эта функция создает объект конфигурации дисплея, обеспечивающий контекст для ряда изменений конфигурации дисплея. После указания желаемых изменений Вы используете CGCompleteDisplayConfiguration применять их в единственной транзакции.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGCancelDisplayConfiguration (_:) CGCancelDisplayConfiguration

    Отмены ряд изменений конфигурации дисплея.

    Объявление

    Swift

    func CGCancelDisplayConfiguration(_ configRef: CGDisplayConfig!) -> CGError

    Objective C

    CGError CGCancelDisplayConfiguration ( CGDisplayConfigRef config );

    Параметры

    configRef

    Конфигурация дисплея для отмены. По возврату конфигурация отменяется и больше не действительна.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Эта функция используется для отказа от конфигурации дисплея. Как побочный эффект, выпущен объект конфигурации дисплея.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGCompleteDisplayConfiguration (_: _:) CGCompleteDisplayConfiguration

    Завершает ряд изменений конфигурации дисплея.

    Объявление

    Swift

    func CGCompleteDisplayConfiguration(_ configRef: CGDisplayConfig!, _ option: CGConfigureOption) -> CGError

    Objective C

    CGError CGCompleteDisplayConfiguration ( CGDisplayConfigRef config, CGConfigureOption option );

    Параметры

    configRef

    Конфигурация дисплея с желаемыми изменениями. По возврату эта конфигурация больше не действительна.

    option

    Объем изменений конфигурации дисплея. Передайте одну из констант, перечисленных в Объемах Конфигурации Дисплея.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Эта функция применяет ряд изменений конфигурации дисплея как единственная атомарная транзакция. Продолжительность или объем изменений зависят от значения option параметр. Возможные объемы полностью описаны в Объемах Конфигурации Дисплея.

    Изменение конфигурации может перестать работать, если неподдерживаемый режим отображения требуют или если другое приложение работает в полноэкранном режиме.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGConfigureDisplayMirrorOfDisplay (_: _: _:) CGConfigureDisplayMirrorOfDisplay

    Изменяет конфигурацию набора зеркального отражения.

    Объявление

    Swift

    func CGConfigureDisplayMirrorOfDisplay(_ configRef: CGDisplayConfig!, _ display: CGDirectDisplayID, _ masterDisplay: CGDirectDisplayID) -> CGError

    Objective C

    CGError CGConfigureDisplayMirrorOfDisplay ( CGDisplayConfigRef config, CGDirectDisplayID display, CGDirectDisplayID master );

    Параметры

    configRef

    Конфигурация дисплея, полученная путем вызова CGBeginDisplayConfiguration.

    display

    Идентификатор дисплея для добавления к набору зеркального отражения.

    masterDisplay

    Дисплей в наборе зеркального отражения, или kCGNullDirectDisplay отключить зеркальное отражение. Для указания основного дисплея использовать CGMainDisplayID.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Зеркальное отражение дисплея и генерация матового стекла дисплея реализованы или в (предпочтенных) аппаратных средствах или в программном обеспечении, на усмотрение драйвера устройства.

    • Аппаратное зеркальное отражение

      С аппаратным включенным зеркальным отражением все получение направлено к главному дисплею — посмотрите CGDisplayPrimaryDisplay.

      Если драйвер устройства выбирает аппаратную генерацию матового стекла, границы дисплея и значения байтов строки корректируются для отражения активной drawable области.

    • Зеркальное отражение программного обеспечения

      В этой форме зеркального отражения идентичное содержание вовлечено в каждый дисплей в наборе зеркального отражения. Приложения, использующие оконную систему, не должны касаться зеркального отражения, поскольку оконная система заботится обо всем сбрасывании содержания окна к надлежащим дисплеям.

      Приложения, рисующие непосредственно к дисплею, как с получением дисплея, должны удостовериться, что нарисовали то же содержание ко всем зеркальным дисплеям в зеркальном наборе программного обеспечения. Когда рисование к программному обеспечению зеркально отразило дисплеи с помощью полного экрана контекст OpenGL (не рисующий через окно), необходимо создать, совместно использовал контексты OpenGL для каждого дисплея и перерендеринг для каждого дисплея.

    Можно использовать функцию CGGetActiveDisplayList определить, какие дисплеи активны, или drawable. Это автоматически высказывает Вашему приложению корректное мнение текущих дисплеев.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.2 и позже.

  • CGConfigureDisplayMode CGConfigureDisplayMode (OS X v10.6)

    Конфигурирует режим отображения дисплея.

    Оператор осуждения

    Использовать CGConfigureDisplayWithDisplayMode вместо этого.

    Объявление

    Objective C

    CGError CGConfigureDisplayMode ( CGDisplayConfigRef config, CGDirectDisplayID display, CFDictionaryRef mode );

    Параметры

    configRef

    Конфигурация дисплея, полученная путем вызова CGBeginDisplayConfiguration.

    display

    Идентификатор сконфигурированного дисплея.

    mode

    Словарь режима отображения (см. обсуждение ниже).

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Режим отображения является рядом свойств, таких как ширина, высота, пиксельная глубина, и частота обновления и опции, такие как расширенное заполнение ЖК-панели.

    Режим отображения, который Вы обеспечиваете, должен быть одним из следующего:

    При использовании этой функции для изменения режима дисплея в наборе зеркального отражения, Кварц может скорректировать границы, разрешения и глубину других дисплеев в наборе к безопасному режиму, с соответствием глубины и самого маленького размера включения.

    Специальные замечания

    Эта осуждаемая функция берет в качестве параметра словарь режима отображения. Запускаясь в OS X v10.6, словари режима отображения были заменены CGDisplayMode непрозрачный тип. Для получения информации о CGDisplayMode непрозрачный тип, посмотрите “Getting Information About a Display Mode”.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.6.

  • CGConfigureDisplayOrigin (_: _: _: _:) CGConfigureDisplayOrigin

    Конфигурирует источник дисплея в глобальном координатном пространстве дисплея.

    Объявление

    Swift

    func CGConfigureDisplayOrigin(_ configRef: CGDisplayConfig!, _ display: CGDirectDisplayID, _ x: Int32, _ y: Int32) -> CGError

    Objective C

    CGError CGConfigureDisplayOrigin ( CGDisplayConfigRef config, CGDirectDisplayID display, int32_t x, int32_t y );

    Параметры

    configRef

    Конфигурация дисплея, полученная путем вызова CGBeginDisplayConfiguration.

    display

    Идентификатор сконфигурированного дисплея.

    x

    Желаемая x-координата для верхнего левого угла дисплея.

    y

    Желаемая y-координата для верхнего левого угла дисплея.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    В Кварце верхний левый угол дисплея вызывают источником. Источник дисплея всегда указывается в глобальном координатном пространстве дисплея. Источник основного или главного дисплея (0,0).

    Новый источник помещается максимально близко в требуемое расположение, не накладываясь или оставляя разрыв между дисплеями.

    При использовании этой функции для изменения источника зеркального дисплея, дисплей может быть удален из набора зеркального отражения.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGRestorePermanentDisplayConfiguration () CGRestorePermanentDisplayConfiguration

    Восстанавливает постоянные параметры конфигурации дисплея для текущего пользователя.

    Объявление

    Swift

    func CGRestorePermanentDisplayConfiguration()

    Objective C

    void CGRestorePermanentDisplayConfiguration ( void );

    Обсуждение

    Эта функция обеспечивает удобный способ восстановить постоянную конфигурацию дисплея.

    Приложения, временно изменяющие конфигурацию дисплея — такую как приложения и игры, переключающиеся на полноэкранный режим отображения — могут использовать эту функцию для отмены изменений.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.2 и позже.

  • CGConfigureDisplayStereoOperation (_: _: _: _:) CGConfigureDisplayStereoOperation

    Включает или отключает работу стерео для дисплея, как часть конфигурации дисплея.

    Объявление

    Swift

    func CGConfigureDisplayStereoOperation(_ configRef: CGDisplayConfig!, _ display: CGDirectDisplayID, _ stereo: boolean_t, _ forceBlueLine: boolean_t) -> CGError

    Objective C

    CGError CGConfigureDisplayStereoOperation ( CGDisplayConfigRef config, CGDirectDisplayID display, boolean_t stereo, boolean_t forceBlueLine );

    Параметры

    configRef

    Конфигурация дисплея, полученная путем вызова CGBeginDisplayConfiguration.

    display

    Идентификатор сконфигурированного дисплея.

    stereo

    Передача true если Вы хотите включить работу стерео. Отключить его, передача false.

    forceBlueLine

    Когда в работе стерео, дисплей, возможно, должен генерировать специальный синхросигнал стерео как часть видеовыхода. Синхросигнал состоит из синей строки, занимающей первые 25% последней строки развертки для представления левого глаза и первые 75% последней строки развертки для представления правого глаза. Остаток от строки развертки является черным. Вынудить дисплей генерировать этот синхросигнал, передачу true; иначе, передача false.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Система обычно обнаруживает присутствие окна стерео и автоматически переключает дисплей, содержащий окно стерео к работе стерео. Эта функция обеспечивает механизм, чтобы вызвать дисплей к работе стерео и установить опции (синий синхросигнал строки) когда в работе стерео.

    На успехе разрешение дисплея, зеркально отражая режим и доступные режимы отображения может измениться вследствие специфичных для аппаратных средств возможностей и ограничений. Необходимо проверить эти настройки, чтобы проверить, что они являются подходящими для приложения.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.4 и позже.

  • CGDisplaySetStereoOperation (_: _: _: _:) CGDisplaySetStereoOperation

    Сразу включает или отключает работу стерео для дисплея.

    Объявление

    Swift

    func CGDisplaySetStereoOperation(_ display: CGDirectDisplayID, _ stereo: boolean_t, _ forceBlueLine: boolean_t, _ option: CGConfigureOption) -> CGError

    Objective C

    CGError CGDisplaySetStereoOperation ( CGDirectDisplayID display, boolean_t stereo, boolean_t forceBlueLine, CGConfigureOption option );

    Параметры

    display

    Идентификатор сконфигурированного дисплея.

    stereo

    Передача true если Вы хотите включить работу стерео. Отключить его, передача false.

    forceBlueLine

    Когда в работе стерео, дисплей, возможно, должен генерировать специальный синхросигнал стерео как часть видеовыхода. Синхросигнал состоит из синей строки, занимающей первые 25% последней строки развертки (для представления левого глаза), и первые 75% последней строки развертки (для представления правого глаза). Остаток от строки развертки является черным. Вынудить дисплей генерировать этот синхросигнал, передачу true; иначе передача false.

    option

    Константа, указывающая объем изменений конфигурации дисплея. Для получения дополнительной информации посмотрите Объемы Конфигурации Дисплея.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Система обычно обнаруживает присутствие окна стерео и автоматически переключает дисплей, содержащий окно стерео к работе стерео. Эта функция вызывает дисплей к работе стерео сразу и устанавливает опции (синий синхросигнал строки) когда в работе стерео.

    На успехе разрешение дисплея, зеркально отражая режим и доступные режимы отображения может измениться вследствие специфичных для аппаратных средств возможностей и ограничений. Необходимо проверить эти настройки, чтобы проверить, что они являются подходящими для приложения.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.4 и позже.

  • CGConfigureDisplayWithDisplayMode (_: _: _: _:) CGConfigureDisplayWithDisplayMode

    Конфигурирует режим отображения дисплея.

    Объявление

    Swift

    func CGConfigureDisplayWithDisplayMode(_ config: CGDisplayConfig!, _ display: CGDirectDisplayID, _ mode: CGDisplayMode!, _ options: CFDictionary!) -> CGError

    Objective C

    CGError CGConfigureDisplayWithDisplayMode ( CGDisplayConfigRef config, CGDirectDisplayID display, CGDisplayModeRef mode, CFDictionaryRef options );

    Параметры

    config

    Конфигурация дисплея, полученная путем вызова CGBeginDisplayConfiguration.

    display

    Идентификатор сконфигурированного дисплея.

    mode

    Режим отображения для конфигурирования.

    options

    Зарезервированный для будущего расширения. Передача NULL на данный момент.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Эта функция вызвана для указания режима отображения, с которым можно сконфигурировать дисплей с помощью транзакции. Перед использованием этой функции вызвать CGBeginDisplayConfiguration получать маркер конфигурации дисплея для желаемого дисплея. Когда транзакция будет подготовлена, вызвать CGCompleteDisplayConfiguration выполнить его.

    При использовании этой функции для изменения режима дисплея в наборе зеркального отражения, Кварц может скорректировать границы, разрешения и глубину других дисплеев в наборе к безопасному режиму, с соответствием глубины и самого маленького размера включения.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.6 и позже.

Получение конфигурации дисплея
  • CGDisplayCopyColorSpace (_:) CGDisplayCopyColorSpace

    Возвращает цветовое пространство для дисплея.

    Объявление

    Swift

    func CGDisplayCopyColorSpace(_ display: CGDirectDisplayID) -> Unmanaged<CGColorSpace>!

    Objective C

    CGColorSpaceRef CGDisplayCopyColorSpace ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, цветовое пространство которого Вы хотите получить.

    Возвращаемое значение

    Пространство текущего цвета для указанного дисплея. Вызывающая сторона ответственна за освобождение цветового пространства с CGColorSpaceRelease функция.

    Обсуждение

    Эта функция возвращает зависимое от дисплея основанное на ICC цветовое пространство. Можно использовать эту функцию при рендеринге содержания для определенного дисплея для создания соответствующего цвету вывода для того дисплея.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.5 и позже.

  • CGDisplayIOServicePort CGDisplayIOServicePort (OS X v10.9)

    Возвращает порт услуг Набора I/O указанного дисплея.

    Оператор осуждения

    Нет никакой замены.

    Объявление

    Objective C

    io_service_t CGDisplayIOServicePort ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Порт услуг Набора I/O для указанного дисплея.

    Обсуждение

    Порт услуг Набора I/O может быть передан Набору I/O для получения дополнительной информации о дисплее.

    Порт принадлежит графической системе и не должен быть уничтожен.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Доступность

    Доступный в OS X v10.2 и позже.

    Осуждаемый в OS X v10.9.

  • CGDisplayIsActive (_:) CGDisplayIsActive

    Возвращает булево значение, указывающее, активен ли дисплей.

    Объявление

    Swift

    func CGDisplayIsActive(_ display: CGDirectDisplayID) -> boolean_t

    Objective C

    boolean_t CGDisplayIsActive ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Если true, указанный дисплей активен; иначе, false.

    Обсуждение

    Активный дисплей подключается, не спит и доступный для рисования. В аппаратном наборе зеркального отражения только главный дисплей активен.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.2 и позже.

  • CGDisplayIsAlwaysInMirrorSet (_:) CGDisplayIsAlwaysInMirrorSet

    Возвращает булево значение, указывающее, является ли дисплей всегда в наборе зеркального отражения.

    Объявление

    Swift

    func CGDisplayIsAlwaysInMirrorSet(_ display: CGDirectDisplayID) -> boolean_t

    Objective C

    boolean_t CGDisplayIsAlwaysInMirrorSet ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Если true, указанный дисплей находится в наборе зеркального отражения и не может быть удален из этого набора.

    Обсуждение

    Некоторые аппаратные конфигурации поддерживают соединение вспомогательных дисплеев, которые всегда зеркально отражают основной дисплей и поэтому не могут быть демонтированы от набора зеркального отражения, до которого они принадлежат.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.2 и позже.

  • CGDisplayIsAsleep (_:) CGDisplayIsAsleep

    Возвращает булево значение, указывающее, спит ли дисплей (и поэтому не drawable.)

    Объявление

    Swift

    func CGDisplayIsAsleep(_ display: CGDirectDisplayID) -> boolean_t

    Objective C

    boolean_t CGDisplayIsAsleep ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Если true, указанный дисплей находится в режиме ожидания; иначе, false.

    Обсуждение

    Когда его кадровый буфер и присоединенный монитор находятся в сокращенном режиме питания, дисплей спит. Дисплей сна все еще считается частью глобального дисплея (настольным) пространством, но это не drawable.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.2 и позже.

  • CGDisplayIsBuiltin (_:) CGDisplayIsBuiltin

    Возвращает булево значение, указывающее, встроен ли дисплей, таков как внутренний дисплей в переносимых системах.

    Объявление

    Swift

    func CGDisplayIsBuiltin(_ display: CGDirectDisplayID) -> boolean_t

    Objective C

    boolean_t CGDisplayIsBuiltin ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Если true, указанный дисплей считается встроенным дисплеем; иначе, false.

    Обсуждение

    Переносимые системы обычно идентифицируют внутреннюю ЖК-панель как встроенный дисплей.

    Обратите внимание на то, что это возможно и разумно для системы не иметь никаких дисплеев, отмеченных как встроенные. Например, переносимая система, работающая с закрытой крышкой, не может сообщить ни о каких встроенных дисплеях.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.2 и позже.

  • CGDisplayIsInHWMirrorSet (_:) CGDisplayIsInHWMirrorSet

    Возвращает булево значение, указывающее, является ли дисплей в аппаратном наборе зеркального отражения.

    Объявление

    Swift

    func CGDisplayIsInHWMirrorSet(_ display: CGDirectDisplayID) -> boolean_t

    Objective C

    boolean_t CGDisplayIsInHWMirrorSet ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Если true, указанный дисплей является элементом аппаратного набора зеркального отражения; иначе, false.

    Обсуждение

    Когда аппаратное зеркальное отражение включено, содержание единственного кадрового буфера представляется во всех дисплеях в аппаратном наборе зеркального отражения. Все операции рисования направлены к главному дисплею в наборе — посмотрите CGDisplayPrimaryDisplay.

    Для получения дополнительной информации о зеркальном отражении дисплея, посмотрите CGConfigureDisplayMirrorOfDisplay.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.2 и позже.

  • CGDisplayIsInMirrorSet (_:) CGDisplayIsInMirrorSet

    Возвращает булево значение, указывающее, является ли дисплей в наборе зеркального отражения.

    Объявление

    Swift

    func CGDisplayIsInMirrorSet(_ display: CGDirectDisplayID) -> boolean_t

    Objective C

    boolean_t CGDisplayIsInMirrorSet ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Если true, указанный дисплей является элементом программного обеспечения или аппаратного набора зеркального отражения; иначе, false.

    Обсуждение

    Для получения дополнительной информации о зеркальном отражении дисплея, посмотрите CGConfigureDisplayMirrorOfDisplay.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.2 и позже.

  • CGDisplayIsMain (_:) CGDisplayIsMain

    Возвращает булево значение, указывающее, является ли дисплей основным дисплеем.

    Объявление

    Swift

    func CGDisplayIsMain(_ display: CGDirectDisplayID) -> boolean_t

    Objective C

    boolean_t CGDisplayIsMain ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Если true, указанный дисплей в настоящее время является основным дисплеем; иначе, false.

    Обсуждение

    Для получения информации о характеристиках основного дисплея посмотрите CGMainDisplayID.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.2 и позже.

  • CGDisplayIsOnline (_:) CGDisplayIsOnline

    Возвращает булево значение, указывающее, подключается ли дисплей или онлайн.

    Объявление

    Swift

    func CGDisplayIsOnline(_ display: CGDirectDisplayID) -> boolean_t

    Objective C

    boolean_t CGDisplayIsOnline ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Если true, указанный дисплей подключается; иначе, false.

    Обсуждение

    Когда аппаратные средства кадрового буфера подключены к монитору, дисплей считают подключенным или онлайновым.

    Можно использовать эту функцию, чтобы определить, включил ли кто-то дисплей в систему, в то время как шло основное питание. Эта аппаратная функция, названная заменой в горячем режиме, может не присутствовать на всех дисплеях.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.2 и позже.

  • CGDisplayIsStereo (_:) CGDisplayIsStereo

    Возвращает булево значение, указывающее, работает ли дисплей в графическом режиме стерео.

    Объявление

    Swift

    func CGDisplayIsStereo(_ display: CGDirectDisplayID) -> boolean_t

    Objective C

    boolean_t CGDisplayIsStereo ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Если true, указанный дисплей работает в графическом режиме стерео; иначе, false.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.4 и позже.

  • CGDisplayMirrorsDisplay (_:) CGDisplayMirrorsDisplay

    Для вторичного дисплея в наборе зеркального отражения, возвращает главный дисплей.

    Объявление

    Swift

    func CGDisplayMirrorsDisplay(_ display: CGDirectDisplayID) -> CGDirectDisplayID

    Objective C

    CGDirectDisplayID CGDisplayMirrorsDisplay ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор вторичного дисплея в зеркальном отражении установлен.

    Возвращаемое значение

    Возвращает главный дисплей в наборе зеркального отражения. Возвраты kCGNullDirectDisplay если указанный дисплей является фактически главным дисплеем или не находится в наборе зеркального отражения.

    Обсуждение

    Для получения дополнительной информации о зеркальном отражении дисплея, посмотрите CGConfigureDisplayMirrorOfDisplay.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.2 и позже.

  • CGDisplayModelNumber (_:) CGDisplayModelNumber

    Возвращает номер модели монитора.

    Объявление

    Swift

    func CGDisplayModelNumber(_ display: CGDirectDisplayID) -> UInt32

    Objective C

    uint32_t CGDisplayModelNumber ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Номер модели для монитора, связанного с указанным дисплеем или константой для указания исключения — видит обсуждение ниже.

    Обсуждение

    Эта функция использует Набор I/O для идентификации монитора, связанного с указанным дисплеем. Возвращаемое значение зависит от следующего:

    • Если Набор I/O может идентифицировать монитор, код идентификатора продукта для монитора возвращается.

    • Если Набор I/O не может идентифицировать монитор, kDisplayProductIDGeneric возвращается.

    • Если никакой монитор не подключается, значение 0xFFFFFFFF возвращается.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.2 и позже.

  • CGDisplayPrimaryDisplay (_:) CGDisplayPrimaryDisplay

    Возвращает главный дисплей в аппаратном наборе зеркального отражения.

    Объявление

    Swift

    func CGDisplayPrimaryDisplay(_ display: CGDirectDisplayID) -> CGDirectDisplayID

    Objective C

    CGDirectDisplayID CGDisplayPrimaryDisplay ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея в аппаратном зеркальном наборе.

    Возвращаемое значение

    Главный дисплей в зеркальном наборе. Если display не зеркально отражается аппаратными средствами, эта функция просто возвращается display.

    Обсуждение

    В аппаратном зеркальном отражении содержание единственного кадрового буфера представляется в двух или больше дисплеях одновременно. Зеркальные дисплеи, как говорят, находятся в аппаратном наборе зеркального отражения.

    На усмотрение драйвера устройства один из дисплеев в аппаратном наборе зеркального отражения определяется как главный дисплей. Драйвер устройства связывает механизм получения, аппаратный акселератор и 3D механизм к главному дисплею и направляет все операции рисования к этому дисплею.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.2 и позже.

  • CGDisplayRotation (_:) CGDisplayRotation

    Возвращает угол вращения дисплея в градусах.

    Объявление

    Swift

    func CGDisplayRotation(_ display: CGDirectDisplayID) -> Double

    Objective C

    double CGDisplayRotation ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Угол вращения дисплея в градусах, или 0, если дисплей не допустим.

    Обсуждение

    Эта функция возвращает угол вращения дисплея в направлении по часовой стрелке. Например, если указанный дисплей повернут по часовой стрелке 90 градусов, то эта функция возвращается 90.0. После на 90 градусов по часовой стрелке вращение, физическая нижняя часть дисплея находится на левой стороне, и физическая вершина находится на правой стороне.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.5 и позже.

  • CGDisplayScreenSize (_:) CGDisplayScreenSize

    Возвращает ширину и высоту дисплея в миллиметрах.

    Объявление

    Swift

    func CGDisplayScreenSize(_ display: CGDirectDisplayID) -> CGSize

    Objective C

    CGSize CGDisplayScreenSize ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Размер указанного дисплея в миллиметрах, или 0, если дисплей не допустим.

    Обсуждение

    Если Extended Display Identification Data (EDID) для дисплея не доступны, размер оценивается на основе ширины устройства и высоты в пикселях от CGDisplayBounds, с принятым разрешением 2,835 пикселей/мм или 72 точек на дюйм, разумным предположением для дисплеев, предшествующих поддержке EDID.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.3 и позже.

  • CGDisplaySerialNumber (_:) CGDisplaySerialNumber

    Возвращает порядковый номер монитора.

    Объявление

    Swift

    func CGDisplaySerialNumber(_ display: CGDirectDisplayID) -> UInt32

    Objective C

    uint32_t CGDisplaySerialNumber ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Порядковый номер для монитора, связанного с указанным дисплеем или константой для указания исключения — видит обсуждение ниже.

    Обсуждение

    Эта функция использует Набор I/O для идентификации монитора, связанного с указанным дисплеем.

    Если Набор I/O может идентифицировать монитор:

    • Если производитель закодировал порядковый номер для монитора, число возвращается.

    • Если нет никакого закодированного порядкового номера, 0x00000000 возвращается.

    Если Набор I/O не может идентифицировать монитор:

    • Если монитор подключен к дисплею, 0x00000000 возвращается.

    • Если никакой монитор не подключен к аппаратным средствам дисплея, 0xFFFFFFFF возвращается.

    Обратите внимание на то, что порядковый номер значим только в сочетании с определенным поставщиком и продуктом или моделью.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.2 и позже.

  • CGDisplayUnitNumber (_:) CGDisplayUnitNumber

    Возвращает число логической единицы дисплея.

    Объявление

    Swift

    func CGDisplayUnitNumber(_ display: CGDirectDisplayID) -> UInt32

    Objective C

    uint32_t CGDisplayUnitNumber ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Число логической единицы для указанного дисплея.

    Обсуждение

    Число логической единицы представляет определенный узел в дереве устройств Набора I/O, связанном с кадровым буфером дисплея.

    Когда присоединенный монитор будет изменен, для определенной аппаратной конфигурации не изменится это значение. Число изменится, тем не менее, если дерево устройств Набора I/O изменится, например, когда аппаратные средства реконфигурированы, драйверы заменяются, или существенные изменения происходят с Набором I/O. Поэтому имейте в виду, что это число может варьироваться через сеансы входа в систему.

    Для получения дополнительной информации о Наборе I/O, см. Основные принципы IOKit.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.2 и позже.

  • CGDisplayUsesOpenGLAcceleration (_:) CGDisplayUsesOpenGLAcceleration

    Возвращает булево значение, указывающее, использует ли Кварц основанное на OpenGL ускорение окна (Кварцевое Экстремальное значение) для рендеринга в дисплее.

    Объявление

    Swift

    func CGDisplayUsesOpenGLAcceleration(_ display: CGDirectDisplayID) -> boolean_t

    Objective C

    boolean_t CGDisplayUsesOpenGLAcceleration ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Если true, Кварцевое Экстремальное значение используется для рендеринга в указанном дисплее; иначе, false.

    Обсуждение

    Кварцевое Экстремальное значение является основанным на OpenGL, аппаратно ускоренным наборщиком окна, доступным в версии 10.2 OS X и позже. Кварцевое Экстремальное значение требует, чтобы работала минимальная аппаратная конфигурация.

    Информация, которую предоставляет эта функция, обычно используется для корректировки требований операций рисования к возможностям аппаратных средств дисплея. Например, приложение, работающее на неускоренной системе, могло отключить живое изменение размеров окна.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.2 и позже.

  • CGDisplayVendorNumber (_:) CGDisplayVendorNumber

    Возвращает число поставщика монитора указанного дисплея.

    Объявление

    Swift

    func CGDisplayVendorNumber(_ display: CGDirectDisplayID) -> UInt32

    Objective C

    uint32_t CGDisplayVendorNumber ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Число поставщика для монитора, связанного с указанным дисплеем или константой для указания исключения — видит обсуждение ниже.

    Обсуждение

    Эта функция использует Набор I/O для идентификации монитора, связанного с указанным дисплеем.

    Существует три случая:

    • Если Набор I/O может идентифицировать монитор, идентификатор поставщика возвращается.

    • Если Набор I/O не может идентифицировать монитор, kDisplayVendorIDUnknown возвращается.

    • Если нет никакого монитора, связанного с дисплеем, 0xFFFFFFFF возвращается.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.2 и позже.

Регистрация для уведомления об изменениях конфигурации дисплея

Эти функции используются, чтобы зарегистрировать и не зарегистрировать функцию обратного вызова для уведомления об изменениях конфигурации дисплея.

  • CGDisplayRegisterReconfigurationCallback (_: _:) CGDisplayRegisterReconfigurationCallback

    Регистрирует функцию обратного вызова, которая будет вызвана каждый раз, когда реконфигурирован локальный дисплей.

    Объявление

    Swift

    func CGDisplayRegisterReconfigurationCallback(_ proc: CGDisplayReconfigurationCallBack, _ userInfo: UnsafeMutablePointer<Void>) -> CGError

    Objective C

    CGError CGDisplayRegisterReconfigurationCallback ( CGDisplayReconfigurationCallBack callback, void *userInfo );

    Параметры

    proc

    Указатель на функцию обратного вызова, которая будет зарегистрирована.

    userInfo

    Указатель на определяемые пользователем данные, или NULL. userInfo параметр пасуется назад к функции обратного вызова каждый раз, когда это вызывается.

    Обсуждение

    Каждый раз, когда локальные дисплеи реконфигурированы, функция обратного вызова, которую Вы регистрируете, вызывается дважды для каждого дисплея, это добавлено, удалено, или в настоящее время онлайн — однажды реконфигурирование, и один раз после реконфигурирования. Для получения дополнительной информации посмотрите тип обратного вызова CGDisplayReconfigurationCallBack.

    Функция обратного вызова может быть зарегистрирована многократно с различными определяемыми пользователем указателями данных, приводящими к многократным регистрационным записям. Для каждой регистрации, когда уведомление больше не необходимо, необходимо удалить регистрацию путем вызывания функции CGDisplayRemoveReconfigurationCallback.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.3 и позже.

  • CGDisplayRemoveReconfigurationCallback (_: _:) CGDisplayRemoveReconfigurationCallback

    Удаляет регистрацию функции обратного вызова, это вызывается каждый раз, когда реконфигурирован локальный дисплей.

    Объявление

    Swift

    func CGDisplayRemoveReconfigurationCallback(_ proc: CGDisplayReconfigurationCallBack, _ userInfo: UnsafeMutablePointer<Void>) -> CGError

    Objective C

    CGError CGDisplayRemoveReconfigurationCallback ( CGDisplayReconfigurationCallBack callback, void *userInfo );

    Параметры

    proc

    Указатель на функцию обратного вызова связался с регистрацией, которая будет удалена.

    userInfo

    Указатель на определяемые пользователем данные связался с регистрацией, которая будет удалена, или NULL. Это - тот же указатель, это передается функции CGDisplayRegisterReconfigurationCallback при регистрации обратного вызова.

    Обсуждение

    Когда Вы вызываете эту функцию, эти два параметра должны соответствовать зарегистрированную запись, которая будет удалена.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.3 и позже.

Получение параметров дисплея
  • CGDisplayBounds (_:) CGDisplayBounds

    Возвращает границы дисплея в глобальном координатном пространстве дисплея.

    Объявление

    Swift

    func CGDisplayBounds(_ display: CGDirectDisplayID) -> CGRect

    Objective C

    CGRect CGDisplayBounds ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Границы дисплея, выраженного как прямоугольник в глобальном координатном пространстве дисплея (относительно верхнего левого угла основного дисплея).

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGDisplayPixelsHigh (_:) CGDisplayPixelsHigh

    Возвращает высоту дисплея в пиксельных модулях.

    Объявление

    Swift

    func CGDisplayPixelsHigh(_ display: CGDirectDisplayID) -> UInt

    Objective C

    size_t CGDisplayPixelsHigh ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Высота дисплея в пиксельных модулях.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGDisplayPixelsWide (_:) CGDisplayPixelsWide

    Возвращает ширину дисплея в пиксельных модулях.

    Объявление

    Swift

    func CGDisplayPixelsWide(_ display: CGDirectDisplayID) -> UInt

    Objective C

    size_t CGDisplayPixelsWide ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Ширина дисплея в пиксельных модулях.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGDisplayBitsPerPixel CGDisplayBitsPerPixel Доступный в OS X v10.0 через OS X v10.6

    Возвращается число битов раньше представляло пиксель в кадровом буфере.

    Оператор осуждения

    Использовать CGDisplayModeCopyPixelEncoding вместо этого.

    Объявление

    Objective C

    size_t CGDisplayBitsPerPixel ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Число битов раньше представляло пиксель в кадровом буфере.

    Специальные замечания

    Эта осуждаемая функция позволяет приложению получать число битов, используемых для представления пикселя в кадровом буфере. Запуск в OS X v10.6 CGDisplayModeCopyPixelEncoding должен использоваться, потому что это возвращает пользователю Графический режим Набора I/O, который может использоваться для определения бит на пиксель, а также их кодирования. Это может предотвратить режимы отображения обработки с различными кодировками, но подобное общее количество бит на пиксель, таким же образом.

    Оператор импорта

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.6.

    Осуждаемый в OS X v10.6.

  • CGDisplayBitsPerSample CGDisplayBitsPerSample Доступный в OS X v10.0 через OS X v10.6

    Возвращается число битов раньше представляло пиксельный компонент в кадровом буфере.

    Оператор осуждения

    Использовать CGDisplayModeCopyPixelEncoding вместо этого.

    Объявление

    Objective C

    size_t CGDisplayBitsPerSample ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Число битов раньше представляло пиксельный компонент, такой как значение цвета в кадровом буфере.

    Специальные замечания

    Эта осуждаемая функция позволяет приложению получать число битов, используемых для представления пиксельного компонента в кадровом буфере. Запуск в OS X v10.6 CGDisplayModeCopyPixelEncoding должен использоваться, потому что это возвращает пользователю Графический режим Набора I/O, который может использоваться для определения битов на выборку, а также их кодирование. Это может предотвратить режимы отображения обработки с различными кодировками, но подобное общее количество битов на выборку, таким же образом.

    Оператор импорта

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.6.

    Осуждаемый в OS X v10.6.

  • CGDisplaySamplesPerPixel CGDisplaySamplesPerPixel Доступный в OS X v10.0 через OS X v10.6

    Возвращается число компонентов цвета раньше представляло пиксель.

    Оператор осуждения

    Использовать CGDisplayModeCopyPixelEncoding вместо этого.

    Объявление

    Objective C

    size_t CGDisplaySamplesPerPixel ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Число компонентов цвета раньше представляло пиксель.

    Специальные замечания

    Эта осуждаемая функция позволяет приложению получать число компонентов цвета, используемых для представления пикселя в кадровом буфере. Запуск в OS X v10.6 CGDisplayModeCopyPixelEncoding должен использоваться, потому что это возвращает пользователю Графический режим Набора I/O, который может использоваться для определения выборок на пиксель, а также их кодирования. Это может предотвратить режимы отображения обработки с различными кодировками, но подобное общее количество выборок на пиксель, таким же образом.

    Оператор импорта

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.6.

    Осуждаемый в OS X v10.6.

  • CGDisplayBytesPerRow CGDisplayBytesPerRow Доступный в OS X v10.0 через OS X v10.6

    Возвращает число байтов на строку в дисплее.

    Оператор осуждения

    Использовать CGDisplayCreateImage или CGDisplayCreateImageForRect вместо этого.

    Объявление

    Objective C

    size_t CGDisplayBytesPerRow ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Число байтов на строку в дисплее. Это число также представляет шаг между пикселями в том же столбце дисплея.

    Специальные замечания

    Эта осуждаемая функция потребовала, чтобы пиксельные данные были получены вручную. Запуск в OS X v10.6 один из CGDisplayCreateImage функции должны использоваться для создания изображения из дисплея. Для получения дополнительной информации см. Ссылку CGImage.

    Оператор импорта

    Objective C

    @import ApplicationServices;

    Доступность

    Доступный в OS X v10.0 через OS X v10.6.

    Осуждаемый в OS X v10.6.

Создание и управление режимами отображения
  • CGDisplayAvailableModes CGDisplayAvailableModes (OS X v10.6)

    Информация о возвратах о в настоящее время доступных режимах отображения.

    Оператор осуждения

    Использовать CGDisplayCopyAllDisplayModes вместо этого.

    Объявление

    Objective C

    CFArrayRef CGDisplayAvailableModes ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Массив словарей с информацией о режиме отображения, или NULL если дисплей недопустим. Массив принадлежит системе, и Вы не должны выпускать его. Каждый словарь в массиве содержит информацию о режиме, который поддерживает дисплей. Для списка свойств в словаре режима отображения посмотрите Свойства Стандарта Режима отображения и Режим отображения Дополнительные Свойства. Для получения общей информации об использовании словарей, см. Ссылку CFDictionary.

    Специальные замечания

    Эта осуждаемая функция возвращает массив словаря режима отображения. Запускаясь в OS X v10.6, словари режима отображения были заменены CGDisplayMode непрозрачный тип. Принимая во внимание, что словари режима отображения, возвращенные CGDisplayAvailableModes принадлежат системе и не должны быть выпущены, режим отображения непрозрачные ссылки типа, возвращенные CGDisplayCopyAllDisplayModes принадлежат вызывающей стороне, и необходимо выпустить их.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.6.

  • CGDisplayBestModeForParameters CGDisplayBestModeForParameters (OS X v10.6)

    Информация о возвратах о режиме отображения, самом близком к указанной глубине и размеру экрана.

    Оператор осуждения

    Используйте функции запроса режима отображения вместо этого; посмотрите “Getting Information About a Display Mode”.

    Объявление

    Objective C

    CFDictionaryRef CGDisplayBestModeForParameters ( CGDirectDisplayID display, size_t bitsPerPixel, size_t width, size_t height, boolean_t *exactMatch );

    Параметры

    display

    Идентификатор дисплея для оптимизации.

    bitsPerPixel

    Оптимальная глубина дисплея в битах на пиксель. Обратите внимание на то, что это значение не является тем же как пиксельной глубиной, которая является числом битов на канал или компонент.

    width

    Оптимальная ширина дисплея в пиксельных модулях.

    height

    Оптимальная высота дисплея в пиксельных модулях.

    exactMatch

    Указатель на Логическую переменную. По возврату его значение true если найдено точное совпадение в глубине дисплея, ширине и высоте; иначе, false. Если эта информация не необходима, передача NULL.

    Возвращаемое значение

    Словарь режима отображения, или NULL если дисплей недопустим. Словарь принадлежит системе, и Вы не должны выпускать его. Словарь содержит информацию о режиме отображения, самом близком к указанной глубине и размеру экрана. Для списка свойств в словаре режима отображения посмотрите Свойства Стандарта Режима отображения и Режим отображения Дополнительные Свойства. Для получения общей информации об использовании словарей, см. Ссылку CFDictionary.

    Обсуждение

    Эта функция пытается найти оптимальный режим отображения для указанного дисплея. Функция сначала пытается счесть режим с указанной пиксельной глубиной и размерностями равным или больше, чем указанная ширина и высота. Если никакое соответствие глубины не найдено, это пытается найти режим с большей глубиной и теми же или большими размерностями. Если подходящий режим отображения не найден, эта функция просто возвращает текущий режим отображения.

    Специальные замечания

    Эта осуждаемая функция выбирает режим отображения, самый близкий к указанным параметрам. Запуск в OS X v10.6 новый режим отображения, APIs должен использоваться для запросов режимов отображения так, чтобы приложение могло адаптировать свое определение «лучше всего» к его графике и потребностям памяти.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.6.

  • CGDisplayBestModeForParametersAndRefreshRate CGDisplayBestModeForParametersAndRefreshRate (OS X v10.6)

    Информация о возвратах о режиме отображения, самом близком к указанной глубине, размеру экрана и частоте обновления.

    Оператор осуждения

    Используйте функции запроса режима отображения вместо этого; посмотрите “Getting Information About a Display Mode”.

    Объявление

    Objective C

    CFDictionaryRef CGDisplayBestModeForParametersAndRefreshRate ( CGDirectDisplayID display, size_t bitsPerPixel, size_t width, size_t height, CGRefreshRate refreshRate, boolean_t *exactMatch );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    bitsPerPixel

    Оптимальная глубина дисплея, в битах на пиксель. Обратите внимание на то, что это значение не является тем же как пиксельной глубиной, которая является числом битов на канал или компонент.

    width

    Оптимальная ширина дисплея, в пиксельных модулях.

    height

    Оптимальная высота дисплея, в пиксельных модулях.

    refresh

    Оптимальная частота обновления дисплея, в кадрах в секунду.

    exactMatch

    Указатель на Логическую переменную. По возврату его значение true если найдено точное совпадение в глубине дисплея, ширине, высоте и частоте обновления; иначе, false. Если эта информация не необходима, передача NULL.

    Возвращаемое значение

    Словарь режима отображения, или NULL если дисплей недопустим. Словарь принадлежит системе, и Вы не должны выпускать его. Словарь содержит информацию о режиме отображения, самом близком к указанной глубине, размеру экрана и частоте обновления. Для списка свойств в словаре режима отображения посмотрите Свойства Стандарта Режима отображения и Режим отображения Дополнительные Свойства. Для получения общей информации об использовании словарей, см. Ссылку CFDictionary.

    Обсуждение

    Эта функция ищет список доступных режимов отображения для режима, прибывающего самый близкий к удовлетворению этих критериев:

    • Имеет пиксельную глубину, равную или больше, чем указанная глубина

    • Имеет размерности, равные или больше, чем заданная высота и ширина

    • Использует частоту обновления, равную или около указанного уровня

    Если подходящий режим отображения не найден, эта функция просто возвращает текущий режим отображения.

    Специальные замечания

    Эта осуждаемая функция выбирает режим отображения, самый близкий к указанным параметрам. Запуск в OS X v10.6 новый режим отображения, APIs должен использоваться для запросов режимов отображения так, чтобы приложение могло адаптировать свое определение «лучше всего» к его графике и потребностям памяти.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.6.

  • CGDisplayCurrentMode CGDisplayCurrentMode (OS X v10.6)

    Информация о возвратах о текущем режиме отображения.

    Оператор осуждения

    Использовать CGDisplayCopyDisplayMode вместо этого.

    Объявление

    Objective C

    CFDictionaryRef CGDisplayCurrentMode ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Словарь режима отображения, или NULL если дисплей недопустим. Словарь принадлежит системе, и Вы не должны выпускать его. Словарь содержит информацию о текущем режиме отображения. Для списка свойств в словаре режима отображения посмотрите Свойства Стандарта Режима отображения и Режим отображения Дополнительные Свойства. Для получения общей информации об использовании словарей, см. Ссылку CFDictionary.

    Специальные замечания

    Эта осуждаемая функция возвращает словарь режима отображения. Запускаясь в OS X v10.6, словари режима отображения были заменены CGDisplayMode непрозрачный тип. Принимая во внимание, что словари режима отображения, возвращенные CGDisplayCurrentModes принадлежат системе и не должны быть выпущены, режим отображения непрозрачные ссылки типа, возвращенные CGDisplayCopyDisplayMode принадлежат вызывающей стороне, и необходимо выпустить их.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.6.

  • CGDisplaySwitchToMode CGDisplaySwitchToMode (OS X v10.6)

    Переключает дисплей на различный режим.

    Оператор осуждения

    Использовать CGDisplaySetDisplayMode вместо этого.

    Объявление

    Objective C

    CGError CGDisplaySwitchToMode ( CGDirectDisplayID display, CFDictionaryRef mode );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    mode

    Словарь режима отображения, содержащий информацию о режиме отображения для установки. Словарь передал в, должен быть словарь, возвращенный другой Кварцевой функцией дисплея такой как CGDisplayAvailableModes или CGDisplayBestModeForParameters. Для списка свойств в словаре режима отображения посмотрите Свойства Стандарта Режима отображения и Режим отображения Дополнительные Свойства. Для получения общей информации об использовании словарей, см. Ссылку CFDictionary.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Это функциональные переключатели режим отображения указанного дисплея. Работа всегда синхронна; функция не возвращается, пока переключатель режимов не завершен. Обратите внимание на то, что после переключения, параметры дисплея и адреса могут измениться.

    Режим выбранного дисплея сохраняется для срока действия программы вызова. Когда программа завершается, режим отображения автоматически возвращается к постоянной установке в панели Displays Установок системы.

    При изменении режима отображения дисплея в наборе зеркального отражения другие дисплеи в наборе зеркального отражения будут присвоены режим, это способно к зеркальному отражению границ скорректированного дисплея. Для предотвращения этого автоматического поведения можно использовать следующую процедуру: вызватьCGBeginDisplayConfiguration, вызвать CGConfigureDisplayMode для каждого дисплея для явной установки режима, и наконец вызывают CGCompleteDisplayConfiguration

    Специальные замечания

    Эта осуждаемая функция берет в качестве параметра словарь режима отображения. Запускаясь в OS X v10.6, словари режима отображения были заменены CGDisplayMode непрозрачный тип.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.6.

  • CGDisplayCopyDisplayMode (_:) CGDisplayCopyDisplayMode

    Информация о возвратах о текущей конфигурации дисплея.

    Объявление

    Swift

    func CGDisplayCopyDisplayMode(_ display: CGDirectDisplayID) -> Unmanaged<CGDisplayMode>!

    Objective C

    CGDisplayModeRef CGDisplayCopyDisplayMode ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Ссылка непрозрачного типа режима отображения, или NULL если дисплей недопустим. Вызывающая сторона ответственна за выпуск использования режима отображения CGDisplayModeRelease.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.6 и позже.

  • CGDisplayCopyAllDisplayModes (_: _:) CGDisplayCopyAllDisplayModes

    Информация о возвратах о в настоящее время доступных режимах отображения.

    Объявление

    Swift

    func CGDisplayCopyAllDisplayModes(_ display: CGDirectDisplayID, _ options: CFDictionary!) -> Unmanaged<CFArray>!

    Objective C

    CFArrayRef CGDisplayCopyAllDisplayModes ( CGDirectDisplayID display, CFDictionaryRef options );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    options

    Зарезервированный для будущего расширения. Передача NULL на данный момент.

    Возвращаемое значение

    Массив режимов отображения, которые дисплей поддерживает, или NULL если дисплей недопустим. Вызывающая сторона ответственна за выпуск массива. Для получения дополнительной информации о доступе к свойствам режима отображения посмотрите Получающую информацию О Режиме отображения.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.6 и позже.

  • CGDisplaySetDisplayMode (_: _: _:) CGDisplaySetDisplayMode

    Переключает дисплей на различный режим.

    Объявление

    Swift

    func CGDisplaySetDisplayMode(_ display: CGDirectDisplayID, _ mode: CGDisplayMode!, _ options: CFDictionary!) -> CGError

    Objective C

    CGError CGDisplaySetDisplayMode ( CGDirectDisplayID display, CGDisplayModeRef mode, CFDictionaryRef options );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    mode

    Режим отображения, содержащий информацию о режиме отображения для установки. Для получения информации о свойствах непрозрачного типа режима отображения посмотрите“Getting Information About a Display Mode”.

    options

    Зарезервированный для будущего расширения. Передача NULL на данный момент.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Это функциональные переключатели режим отображения указанного дисплея. Работа всегда синхронна; функция не возвращается, пока переключатель режимов не завершен. Обратите внимание на то, что после переключения, параметры дисплея и адреса могут измениться.

    Режим выбранного дисплея сохраняется для срока действия программы вызова. Когда программа завершается, режим отображения автоматически возвращается к постоянной установке в панели Displays Установок системы.

    При изменении режима отображения дисплея в наборе зеркального отражения другие дисплеи в наборе зеркального отражения присваиваются режим, это способно к зеркальному отражению границ скорректированного дисплея. Для предотвращения этого автоматического поведения можно использовать следующую процедуру: вызвать CGBeginDisplayConfiguration, вызвать CGConfigureDisplayWithDisplayMode для каждого дисплея для явной установки режима, и наконец вызывают CGCompleteDisplayConfiguration.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.6 и позже.

  • CGDisplayModeRetain CGDisplayModeRetain

    Сохраняет Базовый режим Графического дисплея.

    Объявление

    Objective C

    CGDisplayModeRef CGDisplayModeRetain ( CGDisplayModeRef mode );

    Параметры

    mode

    Режим отображения, который будет сохранен.

    Возвращаемое значение

    Входное значение mode.

    Обсуждение

    Эта функция эквивалентна CFRetain, за исключением того, что это не вызывает ошибку если mode параметр NULL.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Доступность

    Доступный в OS X v10.6 и позже.

  • CGDisplayModeRelease CGDisplayModeRelease

    Выпускает Базовый режим Графического дисплея.

    Объявление

    Objective C

    void CGDisplayModeRelease ( CGDisplayModeRef mode );

    Параметры

    mode

    Режим отображения, который будет выпущен.

    Обсуждение

    Эта функция эквивалентна CFRelease, за исключением того, что это не вызывает ошибку если mode параметр NULL.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Доступность

    Доступный в OS X v10.6 и позже.

Получение информации о режиме отображения
  • CGDisplayModeGetWidth (_:) CGDisplayModeGetWidth

    Возвращает ширину указанного режима отображения.

    Объявление

    Swift

    func CGDisplayModeGetWidth(_ mode: CGDisplayMode!) -> UInt

    Objective C

    size_t CGDisplayModeGetWidth ( CGDisplayModeRef mode );

    Параметры

    mode

    Режим отображения.

    Возвращаемое значение

    Ширина, в пикселях, указанного режима отображения.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.6 и позже.

  • CGDisplayModeGetHeight (_:) CGDisplayModeGetHeight

    Возвращает высоту указанного режима отображения.

    Объявление

    Swift

    func CGDisplayModeGetHeight(_ mode: CGDisplayMode!) -> UInt

    Objective C

    size_t CGDisplayModeGetHeight ( CGDisplayModeRef mode );

    Параметры

    mode

    Режим отображения.

    Возвращаемое значение

    Высота, в пикселях, указанного режима отображения.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.6 и позже.

  • CGDisplayModeCopyPixelEncoding (_:) CGDisplayModeCopyPixelEncoding

    Возвращает пиксельное кодирование указанного режима отображения.

    Объявление

    Swift

    func CGDisplayModeCopyPixelEncoding(_ mode: CGDisplayMode!) -> Unmanaged<CFString>!

    Objective C

    CFStringRef CGDisplayModeCopyPixelEncoding ( CGDisplayModeRef mode );

    Параметры

    mode

    Режим отображения, для которого можно найти связанное пиксельное кодирование.

    Возвращаемое значение

    Строка, представляющая пиксельное кодирование указанного режима отображения. Эта строка выражена как a CFString введите содержащий графический режим Набора I/O. Вызывающая сторона ответственна за выпуск строки.

    Обсуждение

    Возвращаемая строка может использоваться для определения различных аспектов пиксельного кодирования, таких как биты на пиксель и биты на выборку. Для получения дополнительной информации посмотрите заголовочный файл IOKit/IOGraphicsTypes.h в Ссылке Платформы Набора I/O.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.6 и позже.

  • CGDisplayModeGetRefreshRate (_:) CGDisplayModeGetRefreshRate

    Возвращает частоту обновления указанного режима отображения.

    Объявление

    Swift

    func CGDisplayModeGetRefreshRate(_ mode: CGDisplayMode!) -> Double

    Objective C

    double CGDisplayModeGetRefreshRate ( CGDisplayModeRef mode );

    Параметры

    mode

    Режим отображения, для которого можно найти связанную частоту обновления.

    Возвращаемое значение

    Частота обновления, в герц, указанного режима отображения для дисплея CRT. Некоторые дисплеи могут не использовать стандартную видео вертикальную и горизонтальную развертку в рисовании экрана; для этих дисплеев возвращаемое значение 0.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.6 и позже.

  • CGDisplayModeGetIOFlags (_:) CGDisplayModeGetIOFlags

    Возвращает флаги Набора I/O указанного режима отображения.

    Объявление

    Swift

    func CGDisplayModeGetIOFlags(_ mode: CGDisplayMode!) -> UInt32

    Objective C

    uint32_t CGDisplayModeGetIOFlags ( CGDisplayModeRef mode );

    Параметры

    mode

    Режим отображения, для которого можно найти связанные флаги.

    Возвращаемое значение

    Флаги Набора I/O указанного режима отображения. Для получения дополнительной информации посмотрите заголовочный файл IOKit/IOGraphicsTypes.h.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.6 и позже.

  • CGDisplayModeGetIODisplayModeID (_:) CGDisplayModeGetIODisplayModeID

    Возвращает режим отображения Набора I/O ID указанного режима отображения.

    Объявление

    Swift

    func CGDisplayModeGetIODisplayModeID(_ mode: CGDisplayMode!) -> Int32

    Objective C

    int32_t CGDisplayModeGetIODisplayModeID ( CGDisplayModeRef mode );

    Параметры

    mode

    Режим отображения, для которого можно счесть связанный режим отображения ID.

    Возвращаемое значение

    Режим отображения Набора I/O ID указанного режима отображения.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.6 и позже.

  • CGDisplayModeIsUsableForDesktopGUI (_:) CGDisplayModeIsUsableForDesktopGUI

    Возвращает булево значение, указывающее, применим ли указанный режим отображения для настольного графического интерфейса пользователя.

    Объявление

    Swift

    func CGDisplayModeIsUsableForDesktopGUI(_ mode: CGDisplayMode!) -> Bool

    Objective C

    bool CGDisplayModeIsUsableForDesktopGUI ( CGDisplayModeRef mode );

    Параметры

    mode

    Режим отображения, который будет проверен на удобство пользования.

    Возвращаемое значение

    Если true, указанный режим отображения применим для настольного графического интерфейса пользователя; иначе, false.

    Обсуждение

    Критерии этой функции включают факторы, такие как достаточная ширина и высота и соответствующая пиксельная глубина.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.6 и позже.

  • CGDisplayModeGetTypeID () CGDisplayModeGetTypeID

    Возвращает идентификатор типа Кварцевых режимов отображения.

    Объявление

    Swift

    func CGDisplayModeGetTypeID() -> CFTypeID

    Objective C

    CFTypeID CGDisplayModeGetTypeID ( void );

    Возвращаемое значение

    Идентификатор типа CGDisplayMode непрозрачный тип.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.6 и позже.

Корректировка гаммы дисплея
  • CGSetDisplayTransferByFormula (_: _: _: _: _: _: _: _: _: _:) CGSetDisplayTransferByFormula

    Устанавливает гамма-функцию для дисплея путем указания коэффициентов гамма формулы передачи.

    Объявление

    Swift

    func CGSetDisplayTransferByFormula(_ display: CGDirectDisplayID, _ redMin: CGGammaValue, _ redMax: CGGammaValue, _ redGamma: CGGammaValue, _ greenMin: CGGammaValue, _ greenMax: CGGammaValue, _ greenGamma: CGGammaValue, _ blueMin: CGGammaValue, _ blueMax: CGGammaValue, _ blueGamma: CGGammaValue) -> CGError

    Objective C

    CGError CGSetDisplayTransferByFormula ( CGDirectDisplayID display, CGGammaValue redMin, CGGammaValue redMax, CGGammaValue redGamma, CGGammaValue greenMin, CGGammaValue greenMax, CGGammaValue greenGamma, CGGammaValue blueMin, CGGammaValue blueMax, CGGammaValue blueGamma );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    redMin

    Минимальное значение красного канала в гамма таблице. Значение должно быть числом в интервале [0, redMax).

    redMax

    Максимальное значение красного канала в гамма таблице. Значение должно быть числом в интервале (redMin, 1].

    redGamma

    Положительное значение раньше вычисляло красный канал в гамма таблице.

    greenMin

    Минимальное значение зеленого канала в гамма таблице. Значение должно быть числом в интервале [0, greenMax).

    greenMax

    Максимальное значение зеленого канала в гамма таблице. Значение должно быть числом в интервале (greenMin, 1].

    greenGamma

    Положительное значение раньше вычисляло зеленый канал в гамма таблице.

    blueMin

    Минимальное значение синего канала в гамма таблице. Значение должно быть числом в интервале [0, blueMax).

    blueMax

    Максимальное значение синего канала в гамма таблице. Значение должно быть числом в интервале (blueMin, 1].

    blueGamma

    Положительное значение раньше вычисляло синий канал в гамма таблице.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Эта функция использует указанные значения параметров для вычислений таблицы гамма-коррекции для указанного дисплея. Значения в таблице вычислены путем выборки следующей гамма формулы передачи для диапазона индексов от 0 до 1:

    • value = Min + ((Max - Min) * pow(index, Gamma))

    Получающиеся значения преобразовываются в специфичный для машины формат и загружаются в аппаратные средства дисплея.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGGetDisplayTransferByFormula (_: _: _: _: _: _: _: _: _: _:) CGGetDisplayTransferByFormula

    Получает коэффициенты гамма формулы передачи для дисплея.

    Объявление

    Swift

    func CGGetDisplayTransferByFormula(_ display: CGDirectDisplayID, _ redMin: UnsafeMutablePointer<CGGammaValue>, _ redMax: UnsafeMutablePointer<CGGammaValue>, _ redGamma: UnsafeMutablePointer<CGGammaValue>, _ greenMin: UnsafeMutablePointer<CGGammaValue>, _ greenMax: UnsafeMutablePointer<CGGammaValue>, _ greenGamma: UnsafeMutablePointer<CGGammaValue>, _ blueMin: UnsafeMutablePointer<CGGammaValue>, _ blueMax: UnsafeMutablePointer<CGGammaValue>, _ blueGamma: UnsafeMutablePointer<CGGammaValue>) -> CGError

    Objective C

    CGError CGGetDisplayTransferByFormula ( CGDirectDisplayID display, CGGammaValue *redMin, CGGammaValue *redMax, CGGammaValue *redGamma, CGGammaValue *greenMin, CGGammaValue *greenMax, CGGammaValue *greenGamma, CGGammaValue *blueMin, CGGammaValue *blueMax, CGGammaValue *blueGamma );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    redMin

    Минимальное значение красного канала в гамма таблице. Значение является числом в интервале [0, redMax).

    redMax

    Максимальное значение красного канала в гамма таблице. Значение является числом в интервале (redMin, 1].

    redGamma

    Положительное значение раньше вычисляло красный канал в гамма таблице.

    greenMin

    Минимальное значение зеленого канала в гамма таблице. Значение является числом в интервале [0, greenMax).

    greenMax

    Максимальное значение зеленого канала в гамма таблице. Значение является числом в интервале (greenMin, 1].

    greenGamma

    Положительное значение раньше вычисляло зеленый канал в гамма таблице.

    blueMin

    Минимальное значение синего канала в гамма таблице. Значение является числом в интервале [0, blueMax).

    blueMax

    Максимальное значение синего канала в гамма таблице. Значение является числом в интервале (blueMin, 1].

    blueGamma

    Положительное значение раньше вычисляло синий канал в гамма таблице.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Для получения информации о гамма формуле передачи см. описание функции CGSetDisplayTransferByFormula.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGSetDisplayTransferByTable (_: _: _: _: _:) CGSetDisplayTransferByTable

    Устанавливает цветную гамма-функцию для дисплея путем указания значений в гамма таблицах RGB.

    Объявление

    Swift

    func CGSetDisplayTransferByTable(_ display: CGDirectDisplayID, _ tableSize: UInt32, _ redTable: UnsafePointer<CGGammaValue>, _ greenTable: UnsafePointer<CGGammaValue>, _ blueTable: UnsafePointer<CGGammaValue>) -> CGError

    Objective C

    CGError CGSetDisplayTransferByTable ( CGDirectDisplayID display, uint32_t tableSize, const CGGammaValue *redTable, const CGGammaValue *greenTable, const CGGammaValue *blueTable );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    tableSize

    Число записей в каждой таблице.

    redTable

    Массив размера tableSize содержа значения красного канала в гамма таблице дисплея. Значения должны быть в диапазоне 0.0 к 1,0.

    greenTable

    Массив размера tableSize содержа значения зеленого канала в гамма таблице дисплея. Значения должны быть в диапазоне 0.0 к 1,0.

    blueTable

    Массив размера tableSize содержа значения синего канала в гамма таблице дисплея. Значения должны быть в диапазоне 0.0 к 1,0.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Та же таблица может быть передана в для красных, зеленых, и синих каналов. Таблицы интерполированы по мере необходимости для генерации числа выборок, требуемых аппаратным обеспечением машинной графики.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGGetDisplayTransferByTable (_: _: _: _: _: _:) CGGetDisplayTransferByTable

    Получает значения в гамма таблицах RGB для дисплея.

    Объявление

    Swift

    func CGGetDisplayTransferByTable(_ display: CGDirectDisplayID, _ capacity: UInt32, _ redTable: UnsafeMutablePointer<CGGammaValue>, _ greenTable: UnsafeMutablePointer<CGGammaValue>, _ blueTable: UnsafeMutablePointer<CGGammaValue>, _ sampleCount: UnsafeMutablePointer<UInt32>) -> CGError

    Objective C

    CGError CGGetDisplayTransferByTable ( CGDirectDisplayID display, uint32_t capacity, CGGammaValue *redTable, CGGammaValue *greenTable, CGGammaValue *blueTable, uint32_t *sampleCount );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    capacity

    Число записей каждая таблица может содержать.

    redTable

    Указатель на массив типа CGGammaValue с размером capacity. По возврату массив содержит значения красного канала в гамма таблице дисплея.

    greenTable

    Указатель на массив типа CGGammaValue с размером capacity. По возврату массив содержит значения зеленого канала в гамма таблице дисплея.

    blueTable

    Указатель на массив типа CGGammaValue с размером capacity. По возврату массив содержит значения синего канала в гамма таблице дисплея.

    sampleCount

    Число выборок фактически скопировано в каждый массив.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGSetDisplayTransferByByteTable (_: _: _: _: _:) CGSetDisplayTransferByByteTable

    Устанавливает значения байта в 8-разрядных гамма таблицах RGB для дисплея.

    Объявление

    Swift

    func CGSetDisplayTransferByByteTable(_ display: CGDirectDisplayID, _ tableSize: UInt32, _ redTable: UnsafePointer<UInt8>, _ greenTable: UnsafePointer<UInt8>, _ blueTable: UnsafePointer<UInt8>) -> CGError

    Objective C

    CGError CGSetDisplayTransferByByteTable ( CGDirectDisplayID display, uint32_t tableSize, const uint8_t *redTable, const uint8_t *greenTable, const uint8_t *blueTable );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    tableSize

    Число записей в каждой таблице.

    redTable

    Массив размера tableSize содержа значения байта красного канала в гамма таблице дисплея.

    greenTable

    Массив размера tableSize содержа значения байта зеленого канала в гамма таблице дисплея.

    blueTable

    Массив размера tableSize содержа значения байта синего канала в гамма таблице дисплея.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Та же таблица может быть передана в для красных, зеленых, и синих каналов. Таблицы интерполированы по мере необходимости для генерации числа выборок, требуемых аппаратным обеспечением машинной графики.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGDisplayRestoreColorSyncSettings () CGDisplayRestoreColorSyncSettings

    Восстанавливает гамма таблицы к значениям в профиле дисплея ColorSync пользователя.

    Объявление

    Swift

    func CGDisplayRestoreColorSyncSettings()

    Objective C

    void CGDisplayRestoreColorSyncSettings ( void );

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGDisplayGammaTableCapacity (_:) CGDisplayGammaTableCapacity

    Возвращает способность или число записей, в гамма таблице для дисплея.

    Объявление

    Swift

    func CGDisplayGammaTableCapacity(_ display: CGDirectDisplayID) -> UInt32

    Objective C

    uint32_t CGDisplayGammaTableCapacity ( CGDirectDisplayID display );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    Возвращаемое значение

    Число записей в гамма таблице для дисплея.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.3 и позже.

Дисплей исчезает эффекты
  • CGConfigureDisplayFadeEffect (_: _: _: _: _: _:) CGConfigureDisplayFadeEffect

    Изменяет настройки встроенного, исчезают эффект, происходящий во время конфигурации дисплея.

    Объявление

    Swift

    func CGConfigureDisplayFadeEffect(_ configRef: CGDisplayConfig!, _ fadeOutSeconds: CGDisplayFadeInterval, _ fadeInSeconds: CGDisplayFadeInterval, _ fadeRed: Float, _ fadeGreen: Float, _ fadeBlue: Float) -> CGError

    Objective C

    CGError CGConfigureDisplayFadeEffect ( CGDisplayConfigRef config, CGDisplayFadeInterval fadeOutSeconds, CGDisplayFadeInterval fadeInSeconds, float fadeRed, float fadeGreen, float fadeBlue );

    Параметры

    configRef

    Конфигурация дисплея, полученная путем вызова CGBeginDisplayConfiguration.

    fadeOutSeconds

    Время, в секундах, для исчезновения от нормального дисплея до указанного исчезает цвет. Исчезновение завершается, прежде чем конфигурация дисплея изменяется. Если интервал 0, Кварц сразу применяет цвет.

    fadeInSeconds

    Время, в секундах, для возврата из указанного исчезает цвет к нормальному дисплею. Постепенное появление выполняется асинхронно после того, как конфигурация дисплея изменяется.

    fadeRed

    Значение интенсивности в интервале [0, 1], который представляет красный компонент желаемого совмещенного цвета.

    fadeGreen

    Значение интенсивности в интервале [0, 1], который представляет зеленый компонент желаемого совмещенного цвета.

    fadeBlue

    Значение интенсивности в интервале [0, 1], который представляет синий компонент желаемого совмещенного цвета.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Эта функция обеспечивает, способ настроить встроенное исчезают эффект, который выполняет Кварц, когда реконфигурированы дисплеи. Настройки времени по умолчанию для этого исчезают, эффект составляет 0,3 секунды для постепенного исчезновения, и 0,5 секунды для отхождения назад в. Значение по умолчанию исчезает, цвет является французским Синим для нормального рабочего стола, и черный для полученного дисплея.

    Перед использованием этой функции необходимо вызвать CGBeginDisplayConfiguration получать маркер конфигурации дисплея для желаемого дисплея. Нет исчезните, резервирование необходимо — когда Вы вызываете CGCompleteDisplayConfiguration, Кварц резервирует исчезнуть аппаратные средства (предполагающий, что это доступно), и выполняет исчезновение.

    Вызывание этой функции изменяет исчезнуть поведение для единственной конфигурации дисплея и не имеет никакого постоянного эффекта.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.2 и позже.

  • CGAcquireDisplayFadeReservation (_: _:) CGAcquireDisplayFadeReservation

    Резервы исчезнуть аппаратные средства для интервала требуемого времени.

    Объявление

    Swift

    func CGAcquireDisplayFadeReservation(_ seconds: CGDisplayReservationInterval, _ pNewToken: UnsafeMutablePointer<CGDisplayFadeReservationToken>) -> CGError

    Objective C

    CGError CGAcquireDisplayFadeReservation ( CGDisplayReservationInterval seconds, CGDisplayFadeReservationToken *token );

    Параметры

    seconds

    Желаемое число секунд для резервирования исчезнуть аппаратных средств. Приложение может указать любое значение в интервале (0, kCGMaxDisplayReservationInterval].

    pNewToken

    Указатель на хранение (предоставленный вызывающей стороной) для исчезнуть маркера резервирования. По возврату хранение содержит новый маркер.

    Возвращаемое значение

    Возвраты kCGErrorNoneAvailable если другой исчезает, резервирование имеет силу. Иначе, возвраты kCGErrorSuccess.

    Обсуждение

    Прежде, чем выполнить исчезнуть работу, приложение должно зарезервировать исчезнуть аппаратные средства в течение установленного периода времени. Кварц возвращает маркер, представляющий новое, исчезают резервирование. Использование приложения этот маркер как параметр в последующих вызовах к другому дисплею исчезает функции.

    Во время исчезнуть интервала резервирования приложение имеет исключительные права использовать исчезнуть аппаратные средства. В конце интервала маркер становится недопустимым, и аппаратные средства автоматически возвращаются к нормальному состоянию. Как правило, вызовы приложения CGReleaseDisplayFadeReservation выпускать исчезнуть резервирование, прежде чем это истечет.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.2 и позже.

  • CGDisplayFade (_: _: _: _: _: _: _: _:) CGDisplayFade

    Выполняет сингл, исчезают работа.

    Объявление

    Swift

    func CGDisplayFade(_ myToken: CGDisplayFadeReservationToken, _ seconds: CGDisplayFadeInterval, _ startBlend: CGDisplayBlendFraction, _ endBlend: CGDisplayBlendFraction, _ redBlend: Float, _ greenBlend: Float, _ blueBlend: Float, _ synchronous: boolean_t) -> CGError

    Objective C

    CGError CGDisplayFade ( CGDisplayFadeReservationToken token, CGDisplayFadeInterval duration, CGDisplayBlendFraction startBlend, CGDisplayBlendFraction endBlend, float redBlend, float greenBlend, float blueBlend, boolean_t synchronous );

    Параметры

    myToken

    Маркер резервирования для исчезнуть аппаратных средств, полученных путем вызова CGAcquireDisplayFadeReservation.

    seconds

    Желаемое число секунд для исчезнуть работы. Необходимо использовать значение в интервале [0, kCGMaxDisplayReservationInterval]. Если значение 0, конечный совмещенный цвет сразу применяется.

    startBlend

    Значение интенсивности в интервале [0, 1], который указывает альфа-компонент желаемого совмещенного цвета в начале исчезнуть работы. Посмотрите, что Дисплей Исчезает Части Смешения.

    endBlend

    Значение интенсивности в интервале [0, 1], который указывает альфа-компонент желаемого совмещенного цвета в конце исчезнуть работы. Посмотрите, что Дисплей Исчезает Части Смешения.

    redBlend

    Значение интенсивности в интервале [0, 1], который указывает красный компонент желаемого совмещенного цвета.

    greenBlend

    Значение интенсивности в интервале [0, 1], который указывает зеленый компонент желаемого совмещенного цвета.

    blueBlend

    Значение интенсивности в интервале [0, 1], который указывает синий компонент желаемого совмещенного цвета.

    synchronous

    Передача true если Вы хотите, чтобы исчезнуть работа была синхронна; иначе, передача false. Если исчезнуть работа синхронна, функция не возвращается, пока работа не завершена.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    По исчезнуть временному интервалу работы Кварц интерполирует смешивающийся коэффициент между запуском и окончанием данных значений, применяя нелинейный (основанный на синусе) термин смещения. Используя этот коэффициент, видеовыход смешивается с указанным цветом.

    Следующий пример показывает, как выполнить 2-секундное синхронное постепенное исчезновение к черному цвету:

    • CGDisplayFade (
    • myToken,
    • 2.0, // 2 seconds
    • kCGDisplayBlendNormal, // starting state
    • kCGDisplayBlendSolidColor, // ending state
    • 0.0, 0.0, 0.0, // black
    • true // wait for completion
    • );

    Выполнять 2-секундное асинхронное постепенное появление от черного цвета:

    • CGDisplayFade (
    • myToken,
    • 2.0, // 2 seconds
    • kCGDisplayBlendSolidColor, // starting state
    • kCGDisplayBlendNormal, // ending state
    • 0.0, 0.0, 0.0, // black
    • false // don't wait for completion
    • );

    Если Вы указываете, что асинхронное исчезает работа, безопасно вызвать CGReleaseDisplayFadeReservation сразу после этой функции возвраты.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.2 и позже.

  • CGDisplayFadeOperationInProgress CGDisplayFadeOperationInProgress (OS X v10.9)

    Возвращает булево значение, указывающее, в настоящее время происходит ли исчезнуть работа.

    Оператор осуждения

    Нет никакой замены.

    Объявление

    Objective C

    boolean_t CGDisplayFadeOperationInProgress ( void );

    Возвращаемое значение

    Если true, исчезнуть работа в настоящее время происходит; иначе, false.

    Обсуждение

    Можно вызвать эту функцию от любой задачи, работающей в системе. Задача вызова не должна иметь допустимого, исчезают резервирование.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Доступность

    Доступный в OS X v10.2 и позже.

    Осуждаемый в OS X v10.9.

  • CGReleaseDisplayFadeReservation (_:) CGReleaseDisplayFadeReservation

    Выпуски дисплей исчезает резервирование, и не исчезает дисплей в случае необходимости.

    Объявление

    Swift

    func CGReleaseDisplayFadeReservation(_ myToken: CGDisplayFadeReservationToken) -> CGError

    Objective C

    CGError CGReleaseDisplayFadeReservation ( CGDisplayFadeReservationToken token );

    Параметры

    myToken

    Ток исчезает маркер резервирования, который будет выпущен. По возврату маркер резервирования больше не действителен и должен быть отброшен.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Если Вы вызываете эту функцию, в то время как асинхронное исчезает, работа работает, существует два возможных исхода:

    • Если конечное значение смешения kCGDisplayBlendNormal, исчезнуть работе позволяют работать к завершению.

    • Если конечное значение смешения не kCGDisplayBlendNormal, исчезнуть работа сразу завершается, и дисплей возвращается к нормальному.

    В обоих случаях, когда исчезнуть работа завершается, резервирование фактически выпущено.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.2 и позже.

Управление курсором мыши
  • CGDisplayHideCursor (_:) CGDisplayHideCursor

    Скрывает курсор мыши и постепенно увеличивает скрыть количество курсора.

    Объявление

    Swift

    func CGDisplayHideCursor(_ display: CGDirectDisplayID) -> CGError

    Objective C

    CGError CGDisplayHideCursor ( CGDirectDisplayID display );

    Параметры

    display

    Этот параметр не используется. По умолчанию можно передать kCGDirectMainDisplay.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Эта функция скрывает курсор независимо от своего текущего расположения; display параметр проигнорирован. В большинстве случаев вызывающая сторона должна быть приоритетным приложением для влияния на курсор.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    CGDisplayShowCursor

  • CGDisplayShowCursor (_:) CGDisplayShowCursor

    Декременты, которые скрыть количество курсора, и показывает курсору мыши, если количество 0.

    Объявление

    Swift

    func CGDisplayShowCursor(_ display: CGDirectDisplayID) -> CGError

    Objective C

    CGError CGDisplayShowCursor ( CGDirectDisplayID display );

    Параметры

    display

    Этот параметр не используется. По умолчанию можно передать kCGDirectMainDisplay.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Если скрыть количество курсора 0, эта функция показывает курсор независимо от своего текущего расположения; display параметр проигнорирован. В большинстве случаев вызывающая сторона должна быть приоритетным приложением для влияния на курсор.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    CGDisplayHideCursor

  • CGDisplayMoveCursorToPoint (_: _:) CGDisplayMoveCursorToPoint

    Перемещает курсор мыши в указанную точку относительно источника дисплея (верхний левый угол дисплея).

    Объявление

    Swift

    func CGDisplayMoveCursorToPoint(_ display: CGDirectDisplayID, _ point: CGPoint) -> CGError

    Objective C

    CGError CGDisplayMoveCursorToPoint ( CGDirectDisplayID display, CGPoint point );

    Параметры

    display

    Идентификатор дисплея, к которому получат доступ.

    point

    Координаты точки в локальном выставочном пространстве. Источник является верхним левым углом указанного дисплея.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Никакие события не сгенерированы в результате этого перемещения. Точки, лежащие вне рабочего стола, отсекаются на рабочий стол.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGCursorIsVisible CGCursorIsVisible (OS X v10.9)

    Возвращает булево значение, указывающее, видим ли курсор мыши.

    Оператор осуждения

    Нет никакой замены.

    Объявление

    Objective C

    boolean_t CGCursorIsVisible ( void );

    Возвращаемое значение

    Если true, курсор видим на любом дисплее; иначе, false.

    Обсуждение

    Чтобы скрыть или показать курсор, можно использовать функции CGDisplayHideCursor и CGDisplayShowCursor.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Доступность

    Доступный в OS X v10.3 и позже.

    Осуждаемый в OS X v10.9.

  • CGCursorIsDrawnInFramebuffer CGCursorIsDrawnInFramebuffer (OS X v10.9)

    Возвращает булево значение, указывающее, нарисован ли курсор мыши в памяти кадрового буфера.

    Оператор осуждения

    Нет никакой замены.

    Объявление

    Objective C

    boolean_t CGCursorIsDrawnInFramebuffer ( void );

    Возвращаемое значение

    Если true, курсор нарисован в памяти кадрового буфера; иначе, false.

    Обсуждение

    Эта функция возвращает булево значение, указывающее, нарисован ли курсор в кадровом буфере. (Курсор мог существовать в плоскости перекрытия или подобном механизме, помещающем пиксели на экране, не изменяя содержание кадрового буфера.), Если курсор нарисован в кадровом буфере, он читается назад вместе с данными окна.

    Булево значение, о котором сообщают, основывается на объединении состояния курсора на всех дисплеях. Если курсор нарисован в кадровом буфере на каком-либо дисплее, функциональных возвратах true.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Доступность

    Доступный в OS X v10.3 и позже.

    Осуждаемый в OS X v10.9.

  • CGAssociateMouseAndMouseCursorPosition (_:) CGAssociateMouseAndMouseCursorPosition

    Подключения или разъединения мышь и курсор, в то время как приложение находится на переднем плане.

    Объявление

    Swift

    func CGAssociateMouseAndMouseCursorPosition(_ connected: boolean_t) -> CGError

    Objective C

    CGError CGAssociateMouseAndMouseCursorPosition ( boolean_t connected );

    Параметры

    connected

    Передача true если должны быть подключены мышь и курсор; иначе, передача false.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Когда Вы вызываете эту функцию для разъединения курсора и мыши, все события, полученные приложением, имеют постоянное абсолютное расположение, но содержат дельту мыши (изменение в X и y) данные. Можно скрыть курсор или изменить его во что-то подходящее для приложения. Можно изменить местоположение курсора при помощи функции CGDisplayMoveCursorToPoint или функция CGWarpMouseCursorPosition.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGWarpMouseCursorPosition (_:) CGWarpMouseCursorPosition

    Перемещает курсор мыши, не генерируя события.

    Объявление

    Swift

    func CGWarpMouseCursorPosition(_ newCursorPosition: CGPoint) -> CGError

    Objective C

    CGError CGWarpMouseCursorPosition ( CGPoint newCursorPosition );

    Параметры

    newCursorPosition

    Новое положение курсора мыши в глобальном координатном пространстве дисплея.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Можно использовать эту функцию, чтобы «деформировать» или изменить позицию курсора, не генерируя или отправляя событие. Например, эта функция часто используется для положения обратно позиции курсора к центру экрана играми, не хотящими курсор, прикрепленный краями дисплея.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGGetLastMouseDelta (_: _:) CGGetLastMouseDelta

    Сообщает изменение в положении мыши начиная с последнего события движения мыши, полученного приложением.

    Объявление

    Swift

    func CGGetLastMouseDelta(_ deltaX: UnsafeMutablePointer<Int32>, _ deltaY: UnsafeMutablePointer<Int32>)

    Objective C

    void CGGetLastMouseDelta ( int32_t *deltaX, int32_t *deltaY );

    Параметры

    deltaX

    Указатель на a int32_t переменная. По возврату эта переменная содержит горизонтальное изменение в положении мыши начиная с последнего события движения мыши.

    deltaY

    Указатель на a int32_t переменная. По возврату эта переменная содержит вертикальное изменение в положении мыши начиная с последнего события движения мыши.

    Обсуждение

    Эта функция не рекомендуется для общего использования. Вместо этого необходимо использовать отслеживающие мышь функции, предоставленные NSEvent класс.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

Получение информации сервера окна
  • CGSessionCopyCurrentDictionary () CGSessionCopyCurrentDictionary

    Информация о возвратах о сеансе сервера окна вызывающей стороны.

    Объявление

    Swift

    func CGSessionCopyCurrentDictionary() -> Unmanaged<CFDictionary>!

    Objective C

    CFDictionaryRef CGSessionCopyCurrentDictionary ( void );

    Возвращаемое значение

    Словарь сеанса сервера окна, или NULL если вызывающая сторона не работает в Кварце, сеанс GUI или сервер окна отключены. Необходимо выпустить словарь, когда Вы закончены с помощью него. Для получения информации о парах ключ/значение в этом словаре посмотрите Свойства Сеанса Сервера Окна.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.3 и позже.

  • CGWindowServerCFMachPort CGWindowServerCFMachPort (OS X v10.8)

    Возвращает порт Кора Фундэйшна Маха (CFMachPort), соответствующий серверу окна OS X.

    Оператор осуждения

    Нет никакой замены.

    Объявление

    Objective C

    CFMachPortRef CGWindowServerCFMachPort ( void );

    Возвращаемое значение

    Порт Кора Фундэйшна Маха, или NULL если не работает сервер окна. Когда Вам больше не нужен порт, необходимо выпустить его с помощью функции CFRelease.

    Обсуждение

    Можно использовать эту функцию, чтобы обнаружить, выходит ли серверный процесс окна или не работает. Если возвращается эта функция NULL, сервер окна не работает. Этот пример кода показывает, как зарегистрировать функцию обратного вызова для обнаружения, когда выходит сервер окна:

    • static void handleWindowServerDeath( CFMachPortRef port, void *info )
    • {
    • printf( "Window Server port death detected!\n" );
    • CFRelease(port);
    • exit(1);
    • }
    • static void watchForWindowServerDeath()
    • {
    • CFMachPortRef port = CGWindowServerCFMachPort();
    • CFMachPortSetInvalidationCallBack(port, handleWindowServerDeath);
    • }

    Если Ваша программа имеет активный цикл выполнения, Обратите внимание на то, что этот обратный вызов только работает.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Доступность

    Доступный в OS X v10.1 и позже.

    Осуждаемый в OS X v10.8.

  • CGWindowLevelForKey (_:) CGWindowLevelForKey

    Возвращает уровень окна, соответствующий одному из стандартных типов окна.

    Объявление

    Swift

    func CGWindowLevelForKey(_ key: CGWindowLevelKey) -> CGWindowLevel

    Objective C

    CGWindowLevel CGWindowLevelForKey ( CGWindowLevelKey key );

    Параметры

    key

    Ключ уровня окна, постоянный, который представляет один из стандартных типов окна. Посмотрите Ключи Уровня Окна.

    Возвращаемое значение

    Уровень окна, соответствующий указанному ключу.

    Обсуждение

    Эта функция не рекомендуется для использования в приложениях. (Эта функция предоставлена для сред разработки приложения, создающих и управляющих окнами, как Какао.)

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

Получение информации об обновлении и операциях пересылки

Можно использовать эти функции для обнаружения, какие области на локальных дисплеях изменяют свое появление как результат операций, таких как получение, перемещение окна или прокрутка, и выводят на экран реконфигурирование.

  • CGRegisterScreenRefreshCallback CGRegisterScreenRefreshCallback (OS X v10.8)

    Регистрирует функцию обратного вызова, которая будет вызвана, когда локальные дисплеи обновляются или изменяются.

    Оператор осуждения

    Используйте дисплей, передающий потоком вместо этого. Посмотрите Потоковую передачу Содержания Дисплея.

    Объявление

    Objective C

    CGError CGRegisterScreenRefreshCallback ( CGScreenRefreshCallback callback, void *userInfo );

    Параметры

    function

    Указатель на функцию обратного вызова, которая будет зарегистрирована.

    userParameter

    Указатель на определяемые пользователем данные, или NULL. userParameter параметр пасуется назад к функции обратного вызова каждый раз, когда это вызывается.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Функция обратного вызова может быть зарегистрирована многократно с различными определяемыми пользователем указателями данных, приводящими к многократным регистрационным записям. Для каждой регистрации, когда уведомление больше не необходимо, необходимо вызвать функцию CGUnregisterScreenRefreshCallback удалить регистрацию.

    Функция обратного вызова, которую Вы регистрируете, вызывается, только если Ваше приложение имеет активный цикл событий. Обратный вызов вызывается в том же потоке выполнения, обрабатывающего события в Вашем приложении.

    Специальные замечания

    В OS X v10.4 и ранее, код результата, возвращенный этой функцией, является случайным значением и должен быть проигнорирован. В OS X v10.5 и позже, код результата допустим.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.8.

  • CGUnregisterScreenRefreshCallback CGUnregisterScreenRefreshCallback (OS X v10.8)

    Когда локальные дисплеи обновляются или изменяются, удаляет ранее зарегистрированную функцию обратного вызова, вызванную.

    Оператор осуждения

    Используйте дисплей, передающий потоком вместо этого. Посмотрите Потоковую передачу Содержания Дисплея.

    Объявление

    Objective C

    void CGUnregisterScreenRefreshCallback ( CGScreenRefreshCallback callback, void *userInfo );

    Параметры

    function

    Указатель на функцию обратного вызова, чтобы быть незарегистрированным.

    userParameter

    Указатель на определяемые пользователем данные, или NULL. Необходимо передать то же значение, которое Вы использовали при регистрации функции обратного вызова.

    Обсуждение

    Когда Вы вызываете эту функцию, эти два параметра должны соответствовать зарегистрированную запись, которая будет удалена.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.8.

  • CGWaitForScreenRefreshRects CGWaitForScreenRefreshRects (OS X v10.8)

    Ожидает экранных операций обновления.

    Оператор осуждения

    Используйте дисплей, передающий потоком вместо этого. Посмотрите Потоковую передачу Содержания Дисплея.

    Объявление

    Objective C

    CGError CGWaitForScreenRefreshRects ( CGRect **rects, uint32_t *count );

    Параметры

    pRectArray

    Указатель на a CGRect* переменная. По возврату переменная содержит массив прямоугольников, связавших обновленные области, указанные в глобальном координатном пространстве дисплея. Когда Вам больше не нужен массив, необходимо освободить его путем вызова CGReleaseScreenRefreshRects.

    pCount

    Указатель на a CGRectCount переменная. По возврату переменная содержит число записей в возвращенном массиве прямоугольников.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    В некоторых приложениях может быть предпочтительно ожидать данных экранного обновления синхронно, с помощью этой функции. Необходимо вызвать эту функцию в потоке кроме основного потока обработки событий.

    Как альтернатива, Кварц также поддерживает асинхронное уведомление — посмотрите CGRegisterScreenRefreshCallback. Если функции обратного вызова обновления регистрируются, эта функция не должна использоваться.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.8.

  • CGScreenRegisterMoveCallback CGScreenRegisterMoveCallback (OS X v10.8)

    Регистрирует функцию обратного вызова, которая будет вызвана, когда перемещена область дисплея.

    Оператор осуждения

    Используйте дисплей, передающий потоком вместо этого. Посмотрите Потоковую передачу Содержания Дисплея.

    Объявление

    Objective C

    CGError CGScreenRegisterMoveCallback ( CGScreenUpdateMoveCallback callback, void *userInfo );

    Параметры

    function

    Указатель на функцию обратного вызова, которая будет зарегистрирована.

    userParameter

    Указатель на определяемые пользователем данные, или NULL. userParameter параметр пасуется назад к функции обратного вызова каждый раз, когда это вызывается.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Функция обратного вызова может быть зарегистрирована многократно с различными определяемыми пользователем указателями данных, приводящими к многократным регистрационным записям. Для каждой регистрации, когда уведомление больше не необходимо, необходимо удалить регистрацию путем вызывания функции CGScreenUnregisterMoveCallback.

    Функция обратного вызова, которую Вы регистрируете, вызывается, только если Ваше приложение имеет активный цикл событий. Обратный вызов вызывается в том же потоке выполнения, обрабатывающего события в Вашем приложении.

    Специальные замечания

    Эта функция реализована в версии 10.4.3 OS X и позже.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Доступность

    Доступный в OS X v10.3 и позже.

    Осуждаемый в OS X v10.8.

  • CGScreenUnregisterMoveCallback CGScreenUnregisterMoveCallback (OS X v10.8)

    Когда область дисплея перемещена, удаляет ранее зарегистрированную функцию обратного вызова, вызванную.

    Оператор осуждения

    Используйте дисплей, передающий потоком вместо этого. Посмотрите Потоковую передачу Содержания Дисплея.

    Объявление

    Objective C

    void CGScreenUnregisterMoveCallback ( CGScreenUpdateMoveCallback callback, void *userInfo );

    Параметры

    function

    Указатель на функцию обратного вызова, чтобы быть незарегистрированным.

    userParameter

    Указатель на определяемые пользователем данные, или NULL. Необходимо передать то же значение, которое Вы использовали при регистрации функции обратного вызова.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    Когда Вы вызываете эту функцию, эти два параметра должны соответствовать зарегистрированную запись, которая будет удалена.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Доступность

    Доступный в OS X v10.3 и позже.

    Осуждаемый в OS X v10.8.

  • CGWaitForScreenUpdateRects CGWaitForScreenUpdateRects (OS X v10.8)

    Ожидает экранных операций обновления.

    Оператор осуждения

    Используйте дисплей, передающий потоком вместо этого. Посмотрите Потоковую передачу Содержания Дисплея.

    Объявление

    Objective C

    CGError CGWaitForScreenUpdateRects ( CGScreenUpdateOperation requestedOperations, CGScreenUpdateOperation *currentOperation, CGRect **rects, size_t *rectCount, CGScreenUpdateMoveDelta *delta );

    Параметры

    requestedOperations

    Желаемые типы экрана обновляют операции. Существует несколько возможного выбора:

    • Указать kCGScreenUpdateOperationRefresh если Вы хотите, чтобы все операции пересылки были возвращены как операции обновления.

    • Указать (kCGScreenUpdateOperationRefresh | kCGScreenUpdateOperationMove) если Вы хотите различить операции обновления и перемещение.

    • Добавить kCGScreenUpdateOperationReducedDirtyRectangleCount к экранным операциям, если Вы хотите минимизировать число прямоугольников, возвратился для представления измененных областей дисплея.

    currentOperation

    Указатель на a CGScreenUpdateOperation переменная. По возврату переменная указывает тип работы обновления (обновление или перемещение).

    pRectArray

    Указатель на a CGRect* переменная. По возврату переменная содержит массив прямоугольников, связавших обновленные области, указанные в глобальном координатном пространстве дисплея. Когда Вам больше не нужен массив, необходимо освободить его путем вызова CGReleaseScreenRefreshRects.

    pCount

    Указатель на a size_t переменная. По возврату переменная содержит число записей в возвращенном массиве прямоугольников.

    pDelta

    Указатель на a CGScreenUpdateMoveDelta переменная. По возврату, если значение currentOperation параметр kCGScreenUpdateOperationMove, переменная содержит перемещенное расстояние.

    Возвращаемое значение

    Код результата. Посмотрите Базовую Графическую Ссылку Типов данных и Констант.

    Обсуждение

    В некоторых приложениях может быть предпочтительно ожидать данных экранного обновления синхронно, с помощью этой функции. Необходимо вызвать эту функцию в потоке кроме основного потока обработки событий.

    Как альтернатива, Кварц также поддерживает асинхронное уведомление — посмотрите CGRegisterScreenRefreshCallback и CGScreenRegisterMoveCallback. Если обновление или функции обратного вызова перемещения регистрируются, эта функция не должна использоваться.

    Специальные замечания

    Эта функция реализована в версии 10.4.3 OS X и позже.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Доступность

    Доступный в OS X v10.3 и позже.

    Осуждаемый в OS X v10.8.

  • CGReleaseScreenRefreshRects CGReleaseScreenRefreshRects (OS X v10.8)

    Освобождает список прямоугольников, представляющих измененные области на локальных дисплеях.

    Оператор осуждения

    Нет никакой замены.

    Объявление

    Objective C

    void CGReleaseScreenRefreshRects ( CGRect *rects );

    Параметры

    rectArray

    Список прямоугольников получен путем вызова CGWaitForScreenRefreshRects или CGWaitForScreenUpdateRects.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.8.

Потоковая передача содержания дисплея
  • CGDisplayStreamCreate (_: _: _: _: _: _:) CGDisplayStreamCreate

    Создает новый поток дисплея, который будет использоваться с a CFRunloop.

    Объявление

    Swift

    func CGDisplayStreamCreate(_ display: CGDirectDisplayID, _ outputWidth: UInt, _ outputHeight: UInt, _ pixelFormat: Int32, _ properties: CFDictionary!, _ handler: CGDisplayStreamFrameAvailableHandler!) -> Unmanaged<CGDisplayStream>!

    Objective C

    CGDisplayStreamRef CGDisplayStreamCreate ( CGDirectDisplayID display, size_t outputWidth, size_t outputHeight, int32_t pixelFormat, CFDictionaryRef properties, CGDisplayStreamFrameAvailableHandler handler );

    Параметры

    display

    Идентификатор дисплея, который будет передан потоком.

    outputWidth

    Ширина вывода структурирует в пикселях. Ширина не должна быть нулем.

    outputHeight

    Высота вывода структурирует в пикселях. Высота не должна быть нулем.

    pixelFormat

    Желаемый Базовый формат пикселя Носителей выходных данных кадра. Значение должно быть одним из следующего:

    • 'BGRA': Упакованный ARGB8888 С прямым порядком байтов

    • 'l10r': Упакованный ARGB2101010 С прямым порядком байтов

    • '420v': «Видео» YCbCr 4:2:0 диапазона с 2 плоскостями

    • '420f': «Полный» YCbCr 4:2:0 диапазона с 2 плоскостями

    properties

    Словарь дополнительных свойств для потока дисплея. Посмотрите Поток Дисплея Дополнительные Ключи Свойства для возможных ключей и значений, которые могут быть предоставлены в словаре опций.

    handler

    Блок, который вызовут, когда новые кадры готовы.

    Возвращаемое значение

    Новое CGDisplayStream объект.

    Обсуждение

    Прежде чем поток может быть запущен, он должен быть добавлен к циклу выполнения. Используйте CGDisplayStreamGetRunLoopSource функция, чтобы заставить источник события добавлять к циклу выполнения.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.8 и позже.

  • CGDisplayStreamCreateWithDispatchQueue (_: _: _: _: _: _: _:) CGDisplayStreamCreateWithDispatchQueue

    Создает новый поток дисплея, обновления которого поставлены очереди отгрузки.

    Объявление

    Swift

    func CGDisplayStreamCreateWithDispatchQueue(_ display: CGDirectDisplayID, _ outputWidth: UInt, _ outputHeight: UInt, _ pixelFormat: Int32, _ properties: CFDictionary!, _ queue: dispatch_queue_t!, _ handler: CGDisplayStreamFrameAvailableHandler!) -> Unmanaged<CGDisplayStream>!

    Objective C

    CGDisplayStreamRef CGDisplayStreamCreateWithDispatchQueue ( CGDirectDisplayID display, size_t outputWidth, size_t outputHeight, int32_t pixelFormat, CFDictionaryRef properties, dispatch_queue_t queue, CGDisplayStreamFrameAvailableHandler handler );

    Параметры

    display

    Идентификатор дисплея, который будет передан потоком.

    outputWidth

    Ширина вывода структурирует в пикселях. Ширина не должна быть нулем.

    outputHeight

    Высота вывода структурирует в пикселях. Высота не должна быть нулем.

    pixelFormat

    Желаемый Базовый формат пикселя Носителей выходных данных кадра. Значение должно быть одним из следующего:

    • 'BGRA': Упакованный ARGB8888 С прямым порядком байтов

    • 'l10r': Упакованный ARGB2101010 С прямым порядком байтов

    • '420v': «Видео» YCbCr 4:2:0 диапазона с 2 плоскостями

    • '420f': «Полный» YCbCr 4:2:0 диапазона с 2 плоскостями

    properties

    Словарь дополнительных свойств для потока дисплея. Посмотрите Поток Дисплея Дополнительные Ключи Свойства для возможных ключей и значений, которые могут быть предоставлены в словаре опций.

    queue

    Очередь отгрузки GCD использовала при вызове обработчика обновления.

    handler

    Блок, который вызовут, когда новые кадры готовы.

    Возвращаемое значение

    Новое CGDisplayStream объект.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.8 и позже.

  • CGDisplayStreamStart (_:) CGDisplayStreamStart

    Говорит потоку начинать отправлять обновления.

    Объявление

    Swift

    func CGDisplayStreamStart(_ displayStream: CGDisplayStream!) -> CGError

    Objective C

    CGError CGDisplayStreamStart ( CGDisplayStreamRef displayStream );

    Параметры

    displayStream

    Поток дисплея, который должен начать передавать данные потоком.

    Возвращаемое значение

    kCGErrorSuccess если поток запустился, иначе надлежащий код ошибки.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.8 и позже.

  • CGDisplayStreamStop (_:) CGDisplayStreamStop

    Говорит потоку прекращать отправлять обновления.

    Объявление

    Swift

    func CGDisplayStreamStop(_ displayStream: CGDisplayStream!) -> CGError

    Objective C

    CGError CGDisplayStreamStop ( CGDisplayStreamRef displayStream );

    Параметры

    displayStream

    Поток дисплея, который должен прекратить передавать данные потоком.

    Возвращаемое значение

    kCGErrorSuccess если поток запустился, иначе надлежащий код ошибки.

    Обсуждение

    После этого вызова возвраты останавливается поток. Когда поток останавливается, его обратный вызов вызывают с состоянием kCGDisplayStreamFrameStatusStopped. Необходимо ожидать, пока этот обратный вызов не получен прежде, чем выпустить потоковый объект дисплея.

    Безопасно вызвать эту функцию из блока обработчика.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.8 и позже.

  • CGDisplayStreamGetRunLoopSource (_:) CGDisplayStreamGetRunLoopSource

    Получает источник цикла выполнения для потока дисплея.

    Объявление

    Swift

    func CGDisplayStreamGetRunLoopSource(_ displayStream: CGDisplayStream!) -> Unmanaged<CFRunLoopSource>!

    Objective C

    CFRunLoopSourceRef CGDisplayStreamGetRunLoopSource ( CGDisplayStreamRef displayStream );

    Параметры

    displayStream

    Потоковая ссылка дисплея создала использование CGDisplayStreamCreate функция.

    Возвращаемое значение

    Источник события для потока дисплея. Эта функция возвраты NULL если Вы передаете в потоке дисплея, создававшемся путем вызова CGDisplayStreamCreateWithDispatchQueue функция.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.8 и позже.

  • CGDisplayStreamUpdateGetRects (_: _: _:) CGDisplayStreamUpdateGetRects

    Возвращает массив прямоугольников, описывающих, где кадр изменился начиная с предыдущего кадра.

    Объявление

    Swift

    func CGDisplayStreamUpdateGetRects(_ updateRef: CGDisplayStreamUpdate!, _ rectType: CGDisplayStreamUpdateRectType, _ rectCount: UnsafeMutablePointer<UInt>) -> UnsafePointer<CGRect>

    Objective C

    const CGRect * CGDisplayStreamUpdateGetRects ( CGDisplayStreamUpdateRef updateRef, CGDisplayStreamUpdateRectType rectType, size_t *rectCount );

    Параметры

    updateRef

    A CGDisplayStreamUpdate ссылка для обновления кадра.

    rectType

    Прямоугольники Вы интересуетесь. Посмотрите Потоковое Обновление Дисплея Типы Rect.

    rectCount

    Указатель на a size_t. Это значение не должно быть NULL. По возврату это расположение обновляется для содержания числа прямоугольников в возвращенном массиве.

    Возвращаемое значение

    Массив CGRect структуры.

    Обсуждение

    Не освобождайте массив. Когда объект обновления уничтожается, этим управляет автоматически обновление и избавляются.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.8 и позже.

  • CGDisplayStreamUpdateCreateMergedUpdate (_: _:) CGDisplayStreamUpdateCreateMergedUpdate

    Объединения два обновления в новое обновление, включающее метаданные для обоих исходных обновлений.

    Объявление

    Swift

    func CGDisplayStreamUpdateCreateMergedUpdate(_ firstUpdate: CGDisplayStreamUpdate!, _ secondUpdate: CGDisplayStreamUpdate!) -> Unmanaged<CGDisplayStreamUpdate>!

    Objective C

    CGDisplayStreamUpdateRef CGDisplayStreamUpdateCreateMergedUpdate ( CGDisplayStreamUpdateRef firstUpdate, CGDisplayStreamUpdateRef secondUpdate );

    Параметры

    firstUpdate

    A CGDisplayStreamUpdate ссылка. Это должно быть ранее двух ссылок обновления.

    secondUpdate

    A CGDisplayStreamUpdate ссылка. Это должно быть позже двух ссылок обновления.

    Возвращаемое значение

    Новое обновление, содержащее объединение информации, хранившей в двух исходных обновлениях.

    Обсуждение

    Если Ваше приложение должно отбросить кадр, не обрабатывая его, используйте эту функцию для слияния, данные обновления того кадра с данными предусмотрели более позднее обновление кадра.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.8 и позже.

  • CGDisplayStreamUpdateGetMovedRectsDelta (_: _: _:) CGDisplayStreamUpdateGetMovedRectsDelta

    Возвратите значения дельты перемещения для единственного обновления.

    Объявление

    Swift

    func CGDisplayStreamUpdateGetMovedRectsDelta(_ updateRef: CGDisplayStreamUpdate!, _ dx: UnsafeMutablePointer<CGFloat>, _ dy: UnsafeMutablePointer<CGFloat>)

    Objective C

    void CGDisplayStreamUpdateGetMovedRectsDelta ( CGDisplayStreamUpdateRef updateRef, CGFloat *dx, CGFloat *dy );

    Параметры

    updateRef

    A CGDisplayStreamUpdate ссылка.

    dx

    Указатель на a CGFloat сохранить x компонент дельты перемещения

    dy

    Указатель на a CGFloat сохранить y компонент дельты перемещения

    Обсуждение

    Значения дельты описывают смещение от положенных обратно прямоугольников до исходного расположения.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.8 и позже.

  • CGDisplayStreamUpdateGetDropCount (_:) CGDisplayStreamUpdateGetDropCount

    Возвращает число кадров, отброшенных начиная с последней возможности к Вашему обработчику обновления.

    Объявление

    Swift

    func CGDisplayStreamUpdateGetDropCount(_ updateRef: CGDisplayStreamUpdate!) -> UInt

    Objective C

    size_t CGDisplayStreamUpdateGetDropCount ( CGDisplayStreamUpdateRef updateRef );

    Параметры

    updateRef

    A CGDisplayStreamUpdate ссылка.

    Возвращаемое значение

    Число отброшенных кадров.

    Обсуждение

    Используйте этот вызов при измерении производительности клиента, чтобы гарантировать, что это не отстает от обновлений сервера окна.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.8 и позже.

  • CGDisplayStreamGetTypeID () CGDisplayStreamGetTypeID

    Возвращает идентификатор типа Кварцевого потока дисплея.

    Объявление

    Swift

    func CGDisplayStreamGetTypeID() -> CFTypeID

    Objective C

    CFTypeID CGDisplayStreamGetTypeID ( void );

    Возвращаемое значение

    Идентификатор типа CGDisplayStream непрозрачный тип.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.8 и позже.

  • CGDisplayStreamUpdateGetTypeID () CGDisplayStreamUpdateGetTypeID

    Возвращает идентификатор типа Кварцевого потокового обновления дисплея.

    Объявление

    Swift

    func CGDisplayStreamUpdateGetTypeID() -> CFTypeID

    Objective C

    CFTypeID CGDisplayStreamUpdateGetTypeID ( void );

    Возвращаемое значение

    Идентификатор типа CGDisplayStreamUpdate непрозрачный тип.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.8 и позже.

Обратные вызовы

Кварцевые обратные вызовы служб дисплея
  • CGDisplayReconfigurationCallBack CGDisplayReconfigurationCallBack

    Предоставленная клиентами функция обратного вызова это вызывается каждый раз, когда изменяется конфигурация локального дисплея.

    Объявление

    Swift

    typealias CGDisplayReconfigurationCallBack = CFunctionPointer<((CGDirectDisplayID, CGDisplayChangeSummaryFlags, UnsafeMutablePointer<Void>) -> Void)>

    Objective C

    typedef void (*CGDisplayReconfigurationCallBack) ( CGDirectDisplayID display, CGDisplayChangeSummaryFlags flags, void *userInfo );

    Параметры

    display

    Реконфигурированный дисплей.

    flags

    Флаги, указывающие, какие параметры конфигурации дисплея изменяются.

    userInfo

    userInfo параметр передал функции CGDisplayRegisterReconfigurationCallback когда регистрируется функция обратного вызова.

    Обсуждение

    Для регистрации функции обратного вызова реконфигурирования дисплея Вы вызываете функцию CGDisplayRegisterReconfigurationCallback. Кварц вызывает Вашу функцию обратного вызова когда:

    • Ваше приложение вызывает функцию для реконфигурирования локального дисплея.

    • Ваше приложение прислушивается к событиям в потоке обработки событий, и другое приложение вызывает функцию для реконфигурирования локального дисплея.

    • Пользователь изменяет аппаратную конфигурацию дисплея — например, путем разъединения дисплея или изменения настроек установок системы.

    Перед реконфигурированием дисплея Кварц вызывает Вашу функцию обратного вызова один раз для каждого онлайнового дисплея для указания незаконченного изменения конфигурации. flags параметр всегда устанавливается в kCGDisplayBeginConfigurationFlag. Единственной специфичной для дисплея информацией, содержавшей этим обратным вызовом, является Идентификационный номер дисплея. Причина состоит в том, что подробные данные того, как реконфигурирование влияет на определенное устройство, полагаются на специфичные для устройства способы поведения, которые могут не быть доступны драйверу устройства.

    После реконфигурирования дисплея Кварц вызывает Вашу функцию обратного вызова один раз для каждого добавленный, демонтированный, и онлайновый дисплей. В это время все состояние дисплея, о котором сообщает Базовая Графика и QuickDraw, будет актуально. flags параметр указывает, как изменилась конфигурация дисплея. Обратите внимание на то, что в случае демонтированных дисплеев, вызовов в Кварц с демонтированным дисплеем ID перестанет работать.

    Следующий пример кода иллюстрирует, как протестировать на особые условия:

    • void MyDisplayReconfigurationCallBack (
    • CGDirectDisplayID display,
    • CGDisplayChangeSummaryFlags flags,
    • void *userInfo)
    • {
    • if (flags & kCGDisplayAddFlag) {
    • // display has been added
    • }
    • else if (flags & kCGDisplayRemoveFlag) {
    • // display has been removed
    • }
    • }

    Ваша функция обратного вызова должна избежать пытаться изменить конфигурации дисплея и не должна повышать исключения или выполнять нелокальный возврат, такой как вызов longjmp. Когда Вы закончены с помощью регистрации обратного вызова, необходимо вызвать функцию CGDisplayRemoveReconfigurationCallback удалить его.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.3 и позже.

  • CGScreenRefreshCallback CGScreenRefreshCallback

    Предоставленная клиентами функция обратного вызова это вызывается, когда область дисплея изменяется или обновляется.

    Объявление

    Swift

    typealias CGScreenRefreshCallback = CFunctionPointer<((UInt32, UnsafePointer<CGRect>, UnsafeMutablePointer<Void>) -> Void)>

    Objective C

    typedef void (*CGScreenRefreshCallback) ( CGRectCount count, const CGRect * rectArray, void * userParameter );

    Параметры

    count

    Число прямоугольников в rectArray параметр.

    rectArray

    Список прямоугольников в обновленных областях, указанных в глобальном координатном пространстве дисплея. Источник является верхним левым углом основного дисплея. Вы не должны изменять или освобождать память, которой указывают rectArray.

    userParameter

    Пользовательские данные, которые Вы указываете при регистрации этого обратного вызова.

    Обсуждение

    Для регистрации функции обратного вызова экранного обновления Вы вызываете функцию CGRegisterScreenRefreshCallback. Когда операции, такие как получение, перемещение окна, прокрутка или реконфигурирование дисплея происходят на локальных дисплеях, кварц вызывает Вашу функцию обратного вызова. Когда Вы закончены с помощью регистрации обратного вызова, необходимо вызвать функцию CGUnregisterScreenRefreshCallback удалить его.

    Когда зеркальное отражение активно, Обратите внимание на то, что единственный прямоугольник может занять многократные дисплеи, или путем наложения дисплеев или путем нахождения на совпадающих дисплеях. Можно использовать функцию CGGetDisplaysWithRect для определения дисплеев, прямоугольник занимает.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGScreenUpdateMoveCallback CGScreenUpdateMoveCallback

    Когда область дисплея перемещена, предоставленная клиентами функция обратного вызова вызвала.

    Объявление

    Swift

    typealias CGScreenUpdateMoveCallback = CFunctionPointer<((CGScreenUpdateMoveDelta, UInt, UnsafePointer<CGRect>, UnsafeMutablePointer<Void>) -> Void)>

    Objective C

    typedef void (*CGScreenUpdateMoveCallback) ( CGScreenUpdateMoveDelta delta, CGRectCount count, const CGRect * rectArray, void * userParameter );

    Параметры

    delta

    Расстояние, в пикселе объединяется, что переместилась область дисплея.

    count

    Число прямоугольников в rectArray параметр.

    rectArray

    Список прямоугольников в перемещенных областях, указанных в глобальном координатном пространстве дисплея. Источник является верхним левым углом основного дисплея. Прямоугольники описывают область до операции пересылки. Вы не должны изменять или освобождать память, которой указывают rectArray.

    userParameter

    Пользовательские данные, которые Вы указываете при регистрации этого обратного вызова.

    Обсуждение

    Для регистрации функции обратного вызова экранного перемещения Вы вызываете функцию CGScreenRegisterMoveCallback. Когда операции, такие как перемещение окна или прокрутка происходят на локальных дисплеях, кварц вызывает Вашу функцию обратного вызова. Когда Вы закончены с помощью регистрации обратного вызова, необходимо вызвать функцию CGScreenUnregisterMoveCallback удалить его.

    Когда зеркальное отражение активно, Обратите внимание на то, что единственный прямоугольник может занять многократные дисплеи, или путем наложения дисплеев или путем нахождения на совпадающих дисплеях. Можно использовать функцию CGGetDisplaysWithRect для определения дисплеев, прямоугольник занимает.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.3 и позже.

Типы данных

  • CGDirectDisplayID CGDirectDisplayID

    Уникальный идентификатор для присоединенного дисплея.

    Объявление

    Swift

    typealias CGDirectDisplayID = UInt32

    Objective C

    typedef uint32_t CGDirectDisplayID;

    Обсуждение

    В Кварце термин дисплей относится к системе аппаратного обеспечения машинной графики, состоящей из кадрового буфера, коррекция цвета (гамма) таблица, и возможно присоединенный монитор. Если никакой монитор не присоединяется, дисплей характеризуется как оффлайновый.

    Когда монитор присоединяется, Кварц присваивает уникальный идентификатор дисплея (ID). ID дисплея может сохраниться через процессы и обычно остается постоянным, пока не перезапущена машина.

    При присвоении дисплея ID Кварц рассматривает следующие параметры:

    • Поставщик

    • Модель

    • Порядковый номер

    • Позиция в реестре Набора I/O

    Для получения информации о том, как получить дисплей ID, посмотрите Дисплеи Открытия.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGDisplayBlendFraction CGDisplayBlendFraction

    Процент совмещенного цвета, используемого в исчезнуть работе.

    Объявление

    Swift

    typealias CGDisplayBlendFraction = Float

    Objective C

    typedef float CGDisplayBlendFraction;

    Обсуждение

    Часть смешения колеблется от 0 (никакой цвет) к 1 (полная интенсивность). Если Вы указываете 0, совмещенный цвет не применяется. Если Вы указываете 1, пользователь видит только совмещенный цвет на экране.

    В исчезнуть работе Кварц смешивает цвет, указанный приложением с текущим содержанием кадрового буфера. Совмещенный цвет может быть применен и вначале и в конце исчезнуть работы.

    Смешение цветов во время исчезнуть работы походит на альфу, смешивающую 2D Кварц, и появление подобно. Однако реализация очень отличается. Когда кадровый буфер передается видеовыходу, в исчезнуть работе совмещенный цвет применяется в самом конце графического конвейера.

    Например, Универсальная предпочтительная панель Доступа в OS X позволяет Вам выбирать высвечивающийся экранный эффект (иногда называемый визуальным звонком) для сопровождения системного звука предупреждения. При выборе этой опции системное использование, Кварц исчезает работа для создания флэш-памяти. Совмещенный цвет применяется с помощью части смешения 0,5 или 50%.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.2 и позже.

  • CGDisplayConfigRef CGDisplayConfigRef

    Ссылка на транзакцию конфигурации дисплея.

    Объявление

    Swift

    typealias CGDisplayConfigRef = CGDisplayConfig

    Objective C

    typedef struct _CGDisplayConfigRef * CGDisplayConfigRef;

    Обсуждение

    Этот тип данных позволяет:

    • Создайте новую транзакцию конфигурации дисплея с помощью функции CGBeginDisplayConfiguration

    • Рекордный ряд изменений конфигурации, каждый связанный с одним или более дисплеями

    • Примените изменения в единственной транзакции с помощью функции CGCompleteDisplayConfiguration, или отбросьте изменения с помощью функции CGCancelDisplayConfiguration

    Нет никаких ограничений на порядок, в котором Вы накапливаете изменения конфигурации в транзакции.

    Изменения конфигурации иногда конфликтуют друг с другом. Например, новый источник мог бы быть представлен недопустимый последующим изменением конфигурации.

    Если возможно, Кварц использует «наиболее подходящую» стратегию разрешить конфликты между изменениями конфигурации. Например, при изменении разрешения единственного дисплея в двух системах отображения Кварц автоматически повторно размещает дисплеи рядом для предотвращения разделения или перекрытия смежных краев.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.2 и позже.

  • CGDisplayCount CGDisplayCount

    Число дисплеев в различных списках.

    Используйте uint32_t вместо этого.

    Объявление

    Swift

    typealias CGDisplayCount = UInt32

    Objective C

    typedef uint32_t CGDisplayCount;

    Обсуждение

    Кварцевое использование CGDisplayCount представлять количество или тока или максимального количества дисплеев в дисплейном списке. Например, посмотрите функцию CGGetActiveDisplayList.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGDisplayErr CGDisplayErr

    Универсальный тип для кодов результата, возвращенных функциями в Quartz Display Services.

    Использовать CGError вместо этого.

    Объявление

    Swift

    typealias CGDisplayErr = CGError

    Objective C

    typedef CGError CGDisplayErr;

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGDisplayFadeInterval CGDisplayFadeInterval

    Продолжительность в секундах исчезнуть работы или исчезнуть аппаратного резервирования.

    Объявление

    Swift

    typealias CGDisplayFadeInterval = Float

    Objective C

    typedef float CGDisplayFadeInterval;

    Обсуждение

    Кварц использует этот тип данных для указания продолжительности и постепенного исчезновения и операций постепенного появления. Значения могут колебаться от 0 до kCGMaxDisplayReservationInterval секунды. 0 значений средние значения сразу исчезают — видят CGDisplayFade.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.2 и позже.

  • CGDisplayFadeReservationToken CGDisplayFadeReservationToken

    Маркер, выпущенный Кварцем при резервировании одного или более дисплеев для исчезнуть работы во время указанного интервала.

    Объявление

    Swift

    typealias CGDisplayFadeReservationToken = UInt32

    Objective C

    typedef uint32_t CGDisplayFadeReservationToken;

    Обсуждение

    Кварц позволяет Вам зарезервировать аппаратные средства дисплея для выполнения исчезнуть работы. Исчезните резервирование допустимо в течение максимум 15 секунд. Только один маркер необходим и для постепенного исчезновения и для постепенного появления.

    Вы должны выпуск a исчезнуть резервирование сразу, когда Вам больше не нужен он. Если резервирование истекает, выпущение его безопасно, но не необходимо.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.2 и позже.

  • CGDisplayModeRef CGDisplayModeRef

    Ссылка на объект режима отображения.

    Объявление

    Swift

    typealias CGDisplayModeRef = CGDisplayMode

    Objective C

    typedef struct CGDisplayMode *CGDisplayModeRef

    Обсуждение

    Режим отображения является рядом свойств (таких как ширина, высота, пиксельная глубина и частота обновления), и опции (такие как расширенное заполнение ЖК-панели). Для получения дополнительной информации посмотрите Создание и Управление Режимами отображения или Получение информации О Режиме отображения.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.6 и позже.

  • CGDisplayReservationInterval CGDisplayReservationInterval

    Временной интервал для исчезнуть резервирования.

    Объявление

    Swift

    typealias CGDisplayReservationInterval = Float

    Objective C

    typedef float CGDisplayReservationInterval;

    Обсуждение

    Исчезнуть интервал резервирования является промежутком времени, в течение которого определенный дисплей резервируется для исчезнуть работы. Исчезните диапазон интервалов резервирования от 1 до kCGMaxDisplayReservationInterval секунды.

    Для получения дополнительной информации об исчезните резервирование, посмотрите функцию CGAcquireDisplayFadeReservation. Исчезните маркеры резервирования обсуждены в CGDisplayFadeReservationToken.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.2 и позже.

  • CGGammaValue CGGammaValue

    Значение раньше отображало цвет, сгенерированный в программном обеспечении к цвету, поддерживаемому аппаратными средствами дисплея.

    Объявление

    Swift

    typealias CGGammaValue = Float

    Objective C

    typedef float CGGammaValue;

    Обсуждение

    В OS X Панель в Установках системы используется для установки гаммы по умолчанию для дисплея. Кварц также позволяет приложению предоставлять свою собственную гамма информацию, с помощью функций такой как CGSetDisplayTransferByTable и CGSetDisplayTransferByFormula.

    Эти функции берут CGGammaValue параметры, указывающие:

    • Ряд гамма записей таблицы в пределах от от 0 до 1

    • Положительные реальные коэффициенты в гамма уравнении

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGOpenGLDisplayMask CGOpenGLDisplayMask

    Битовая маска, используемая в OpenGL для указания ряда присоединенных дисплеев.

    Объявление

    Swift

    typealias CGOpenGLDisplayMask = UInt32

    Objective C

    typedef uint32_t CGOpenGLDisplayMask;

    Обсуждение

    В OS X OpenGL может предоставить информацию о возможностях аппаратных средств рендеринга, управляющих указанным набором дисплеев. 32-разрядная маска используется для указания дисплеев — каждый бит в маске представляет единственный дисплей.

    Чтобы изучить, как найти, маска укусила, который соответствует данному дисплею, посмотрите функцию CGDisplayIDToOpenGLDisplayMask.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGRectCount CGRectCount

    Размер массива Кварцевых прямоугольников.

    Объявление

    Swift

    typealias CGRectCount = UInt32

    Objective C

    typedef uint32_t CGRectCount;

    Обсуждение

    Например, посмотрите функцию CGWaitForScreenRefreshRects.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGRefreshRate CGRefreshRate

    Частота обновления дисплея в кадрах в секунду.

    Объявление

    Swift

    typealias CGRefreshRate = Double

    Objective C

    typedef double CGRefreshRate;

    Обсуждение

    При запросе нового режима отображения можно указать желаемую частоту обновления как подсказку к Кварцу. Например, посмотрите функцию CGDisplayBestModeForParametersAndRefreshRate.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGScreenUpdateMoveDelta

    Расстояние, в пиксельных модулях, что перемещается экранная область.

    Объявление

    Swift

    struct CGScreenUpdateMoveDelta { var dX: Int32 var dY: Int32 }

    Objective C

    struct CGScreenUpdateMoveDelta { int32_t dX, dY; }; typedef struct CGScreenUpdateMoveDelta CGScreenUpdateMoveDelta;

    Обсуждение

    Уведомления операции пересылки ограничиваются изменениями, перемещающими область целым числом пикселей. Поля dX и dY опишите направление перемещения:

    • Положительные значения dX укажите перемещение вправо.

    • Отрицательные величины dX укажите перемещение налево.

    • Положительные значения dY укажите перемещение вниз.

    • Отрицательные величины dY укажите перемещение вверх.

    Доступность

    Доступный в OS X v10.3 и позже.

  • CGWindowLevel CGWindowLevel

    Уровень присвоился к окну средой разработки приложения.

    Объявление

    Swift

    typealias CGWindowLevel = Int32

    Objective C

    typedef int32_t CGWindowLevel;

    Обсуждение

    В OS X среды разработки приложения поддерживают понятие многократных уровней окна (или уровни). Уровни окна присваиваются и управляются каждой отдельной платформой.

    Обратите внимание на то, что в Совместимом водой приложении, каждое окно документа существует в своем собственном уровне. В результате окна, создаваемые различными приложениями, могут быть чередованы.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • CGDisplayStreamRef CGDisplayStreamRef

    Ссылка на потоковый объект дисплея.

    Объявление

    Swift

    typealias CGDisplayStreamRef = CGDisplayStream

    Objective C

    typedef struct CGDisplayStream *CGDisplayStreamRef;

    Обсуждение

    Этот тип данных передает содержание потоком дисплея к Вашему приложению. Содержание может масштабироваться или преобразовываться в различное цветовое пространство. Можно также принять решение получить только часть дисплея. Ваш обработчик обновления можно вызвать любым от традиционногоCFRunLoop или на очереди отгрузки.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.8 и позже.

  • CGDisplayStreamUpdate CGDisplayStreamUpdate

    Ссылка для структурирования метаданных обновления.

    Объявление

    Swift

    typealias CGDisplayStreamUpdateRef = CGDisplayStreamUpdate

    Objective C

    typedef const struct CGDisplayStreamUpdate *CGDisplayStreamUpdateRef;

    Обсуждение

    Этот тип данных инкапсулирует информацию о том, как кадр изменился начиная с предыдущего кадра, поставленного потоком дисплея. Метаданные о кадре описывают части экрана, перерисованные и части экрана, перемещенные от одного места до другого. Можно объединить многократные обновления в единственное обновление.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.8 и позже.

  • CGDisplayStreamFrameAvailableHandler CGDisplayStreamFrameAvailableHandler

    Когда поток данных имеет новое событие кадра для обработки, блок вызвал.

    Объявление

    Swift

    typealias CGDisplayStreamFrameAvailableHandler = (CGDisplayStreamFrameStatus, UInt64, IOSurface!, CGDisplayStreamUpdate!) -> Void

    Objective C

    typedef void (^CGDisplayStreamFrameAvailableHandler)( CGDisplayStreamFrameStatus status, uint64_t displayTime, IOSurfaceRef frameSurface, CGDisplayStreamUpdateRef updateRef );

    Обсуждение

    Обработчик вызывают каждый раз, когда поток дисплея обновил содержание для обработки, а также когда другие события имеют место. Каждый раз, когда новый кадр сгенерирован, блок получает IOSurface объект, содержащий пиксельные данные, а также объект обновления, описывающий обновление кадра.

    Обработчик получает следующие параметры:

    status

    Описывает вид обновления, передаваемого обработчику. Посмотрите Потоковое Состояние Обновления Дисплея.

    displayTime

    Абсолютное время Маха, когда событие имело место. Когда кадр был выведен на экран сервером окна, для события кадра это.

    frameSurface

    IOSurface объект, содержащий пиксельные данные. Может быть NULL в некоторых случаях.

    Если необходимо поддержать ссылку на поверхность вне времени жизни вызова обработчика, необходимо вызвать CFRetain функция для сохранения поверхности и IOSurfaceIncrementUseCount функционируйте, чтобы позволить потоку дисплея знать, что кадр не готов к повторному использованию. Как только Вы закончены с помощью поверхности, необходимо вызвать IOSurfaceDecrementUseCount функционируйте и затем вызовите CFRelease функция. При поддержании кэша информации о поверхности (такой как объект текстуры GL, создаваемый из содержания поверхности), Вы не должны разъединение вызова это после удаления его из кэша.

    Вы не можете зависеть от набора поверхностей, используемых потоком дисплея, как являющимся статичным, таким образом, необходимо удалить поверхности из кэша, когда они не были снова использованы в некоторое время.

    updateRef

    A CGDisplayStreamUpdate ссылка, содержащая метаданные обновления для текущего кадра.

    Если необходимо содержать на метаданные вне времени жизни вызова обработчика, необходимо вызвать CFRetain функция на ссылке обновления перед концом обработчика. Когда Вы закончите с обновлением, вызовите вызов CFRelease функция.

    Этот параметр содержит NULL когда status параметр имеет любое значение кроме kCGDisplayStreamFrameStatusFrameComplete.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.8 и позже.

Константы

  • Опции получения дисплея

    Параметры конфигурации, использующиеся при получении дисплеев.

    Объявление

    Swift

    typealias CGCaptureOptions = UInt32

    Objective C

    enum { kCGCaptureNoOptions = 0, kCGCaptureNoFill = (1 << 0) }; typedef uint32_t CGCaptureOptions;

    Константы

    • kCGCaptureNoOptions

      kCGCaptureNoOptions

      Система должна использовать поведение заливки по умолчанию, которое является заливкой с черным цветом.

      Доступный в OS X v10.3 и позже.

    • kCGCaptureNoFill

      kCGCaptureNoFill

      Отключает заливку с черным цветом.

      Доступный в OS X v10.3 и позже.

      Осуждаемый в OS X v10.10.

    Обсуждение

    Для получения информации о том, как эти константы используются, видят функции CGDisplayCaptureWithOptions и CGCaptureAllDisplaysWithOptions.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.3 и позже.

  • Выведите на экран флаги изменения конфигурации

    Параметры конфигурации, передающиеся функции обратного вызова реконфигурирования дисплея.

    Объявление

    Swift

    typealias CGDisplayChangeSummaryFlags = UInt32

    Objective C

    enum { kCGDisplayBeginConfigurationFlag = (1 << 0), kCGDisplayMovedFlag = (1 << 1), kCGDisplaySetMainFlag = (1 << 2), kCGDisplaySetModeFlag = (1 << 3), kCGDisplayAddFlag = (1 << 4), kCGDisplayRemoveFlag = (1 << 5), kCGDisplayEnabledFlag = (1 << 8), kCGDisplayDisabledFlag = (1 << 9), kCGDisplayMirrorFlag = (1 << 10), kCGDisplayUnMirrorFlag = (1 << 11), kCGDisplayDesktopShapeChangedFlag = (1 << 12) }; typedef u_int32_t CGDisplayChangeSummaryFlags;

    Константы

    • kCGDisplayBeginConfigurationFlag

      kCGDisplayBeginConfigurationFlag

      Конфигурация дисплея собирается измениться.

      Доступный в OS X v10.3 и позже.

    • kCGDisplayMovedFlag

      kCGDisplayMovedFlag

      Расположение верхнего левого угла дисплея в глобальном координатном пространстве дисплея изменилось.

      Доступный в OS X v10.3 и позже.

    • kCGDisplaySetMainFlag

      kCGDisplaySetMainFlag

      Дисплей является теперь основным дисплеем.

      Доступный в OS X v10.3 и позже.

    • kCGDisplaySetModeFlag

      kCGDisplaySetModeFlag

      Режим отображения изменился.

      Доступный в OS X v10.3 и позже.

    • kCGDisplayAddFlag

      kCGDisplayAddFlag

      Дисплей был добавлен к активному дисплейному списку.

      Доступный в OS X v10.3 и позже.

    • kCGDisplayRemoveFlag

      kCGDisplayRemoveFlag

      Дисплей был удален из активного дисплейного списка.

      Доступный в OS X v10.3 и позже.

    • kCGDisplayEnabledFlag

      kCGDisplayEnabledFlag

      Дисплей был включен.

      Доступный в OS X v10.3 и позже.

    • kCGDisplayDisabledFlag

      kCGDisplayDisabledFlag

      Дисплей был отключен.

      Доступный в OS X v10.3 и позже.

    • kCGDisplayMirrorFlag

      kCGDisplayMirrorFlag

      Дисплей теперь зеркально отражает другой дисплей.

      Доступный в OS X v10.3 и позже.

    • kCGDisplayUnMirrorFlag

      kCGDisplayUnMirrorFlag

      Дисплей больше не зеркально отражает другой дисплей.

      Доступный в OS X v10.3 и позже.

    • kCGDisplayDesktopShapeChangedFlag

      kCGDisplayDesktopShapeChangedFlag

      Форма рабочего стола (объединение областей дисплея) изменилась.

      Доступный в OS X v10.5 и позже.

    Обсуждение

    Для получения информации о том, как эти константы используются, видят обратный вызов CGDisplayReconfigurationCallBack.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.3 и позже.

  • Объемы конфигурации дисплея

    Объем изменений в транзакции конфигурации дисплея.

    Объявление

    Swift

    var kCGConfigureForAppOnly: Int { get } var kCGConfigureForSession: Int { get } var kCGConfigurePermanently: Int { get }

    Objective C

    enum { kCGConfigureForAppOnly = 0, kCGConfigureForSession = 1, kCGConfigurePermanently = 2 };

    Константы

    • kCGConfigureForAppOnly

      kCGConfigureForAppOnly

      Изменения сохраняются для времени жизни текущего приложения. После того, как приложение завершается, параметры конфигурации дисплея возвращаются к текущему сеансу входа в систему.

      Доступный в OS X v10.2 и позже.

    • kCGConfigureForSession

      kCGConfigureForSession

      Изменения сохраняются для времени жизни текущего сеанса входа в систему. После того, как текущий сеанс завершается, дисплеи возвращаются к последней сохраненной постоянной конфигурации.

      Доступный в OS X v10.2 и позже.

    • kCGConfigurePermanently

      kCGConfigurePermanently

      Изменения сохраняются в будущих сеансах входа в систему тем же пользователем. Если требуемые изменения не могут поддерживаться Водой UI (разрешение, и ограничения пиксельной глубины применяются), настройки для текущего сеанса входа в систему используются вместо этого, и любые изменения имеют объем сеанса.

      Доступный в OS X v10.2 и позже.

    Обсуждение

    Для получения информации о том, как эти константы используются, видят функцию CGCompleteDisplayConfiguration.

  • Дисплей исчезает части смешения

    Нижние и верхние границы для частей совмещенного цвета во время дисплея исчезают работа.

    Объявление

    Swift

    var kCGDisplayBlendNormal: Double { get } var kCGDisplayBlendSolidColor: Double { get }

    Objective C

    #define kCGDisplayBlendNormal (0.0) #define kCGDisplayBlendSolidColor (1.0)

    Константы

    • kCGDisplayBlendNormal

      kCGDisplayBlendNormal

      Совмещенный цвет не применяется в запуске или конце исчезнуть работы.

      Доступный в OS X v10.2 и позже.

    • kCGDisplayBlendSolidColor

      kCGDisplayBlendSolidColor

      Пользователь видит только совмещенный цвет в запуске или конце исчезнуть работы.

      Доступный в OS X v10.2 и позже.

    Обсуждение

    Для получения общей информации о частях смешения, посмотрите тип данных CGDisplayBlendFraction. Для получения информации о том, как эти константы используются, видят функцию CGDisplayFade.

  • Дисплей исчезает константы

    Значения, имеющие отношение для исчезновения операции.

    Объявление

    Swift

    var kCGDisplayFadeReservationInvalidToken: Int32 { get }

    Objective C

    #define kCGMaxDisplayReservationInterval (15.0) #define kCGDisplayFadeReservationInvalidToken (0)

    Константы

    • kCGMaxDisplayReservationInterval

      kCGMaxDisplayReservationInterval

      Максимальное количество секунд для исчезает, аппаратное резервирование и дисплей исчезают операции. Для получения общей информации об исчезните интервалы, посмотрите тип данных CGDisplayFadeInterval.

      Доступный в OS X v10.2 и позже.

    • kCGDisplayFadeReservationInvalidToken

      kCGDisplayFadeReservationInvalidToken

      Недопустимое исчезает маркер резервирования. Для получения общей информации об исчезните маркеры резервирования, посмотрите тип данных CGDisplayFadeReservationToken.

      Доступный в OS X v10.2 и позже.

  • Выведите на экран значения по умолчанию ID

    Значения по умолчанию для дисплея ID.

    Объявление

    Objective C

    #define kCGDirectMainDisplay (CGMainDisplayID()) #define kCGNullDirectDisplay ((CGDirectDisplayID)0)

    Константы

    • kCGDirectMainDisplay

      kCGDirectMainDisplay

      Текущий основной дисплей ID.

      Доступный в OS X v10.0 и позже.

    • kCGNullDirectDisplay

      kCGNullDirectDisplay

      Значение, которое никогда не будет соответствовать фактическим аппаратным средствам.

      Доступный в OS X v10.2 и позже.

  • Свойства стандарта режима отображения

    Ключи для стандартных свойств в словаре режима отображения.

    Нет никакой замены; поскольку словари режима отображения осуждаются в OS X v10.6, эти свойства не необходимы.

    Объявление

    Objective C

    #define kCGDisplayWidth CFSTR("Width") #define kCGDisplayHeight CFSTR("Height") #define kCGDisplayMode CFSTR("Mode") #define kCGDisplayBitsPerPixel CFSTR("BitsPerPixel") #define kCGDisplayBitsPerSample CFSTR("BitsPerSample") #define kCGDisplaySamplesPerPixel CFSTR("SamplesPerPixel") #define kCGDisplayRefreshRate CFSTR("RefreshRate") #define kCGDisplayModeUsableForDesktopGUICFSTR ("UsableForDesktopGUI") #define kCGDisplayIOFlags CFSTR("IOFlags") #define kCGDisplayBytesPerRow CFSTR("kCGDisplayBytesPerRow")

    Константы

    • kCGDisplayWidth

      kCGDisplayWidth

      Указывает целочисленное значение CFNumber, представляющее ширину дисплея в пикселях.

      Доступный в OS X v10.2 и позже.

    • kCGDisplayHeight

      kCGDisplayHeight

      Указывает целочисленное значение CFNumber, представляющее высоту дисплея в пикселях.

      Доступный в OS X v10.2 и позже.

    • kCGDisplayMode

      kCGDisplayMode

      Указывает целочисленное значение CFNumber, представляющее число режима отображения Набора I/O.

      Доступный в OS X v10.2 и позже.

    • kCGDisplayBitsPerPixel

      kCGDisplayBitsPerPixel

      Указывает целочисленное значение CFNumber, представляющее число битов в пикселе.

      Доступный в OS X v10.2 и позже.

    • kCGDisplayBitsPerSample

      kCGDisplayBitsPerSample

      Указывает целочисленное значение CFNumber, представляющее число битов в отдельной выборке (например, значение цвета в пикселе RGB).

      Доступный в OS X v10.2 и позже.

    • kCGDisplaySamplesPerPixel

      kCGDisplaySamplesPerPixel

      Указывает целочисленное значение CFNumber, представляющее число выборок в пикселе.

      Доступный в OS X v10.2 и позже.

    • kCGDisplayRefreshRate

      kCGDisplayRefreshRate

      Указывает значение с плавающей точкой двойной точности CFNumber, представляющее частоту обновления дисплея CRT. Некоторые дисплеи могут не использовать стандартную видео вертикальную и горизонтальную развертку в рисовании экрана; эти дисплеи сообщают о частоте обновления 0.

      Доступный в OS X v10.2 и позже.

    • kCGDisplayModeUsableForDesktopGUI

      kCGDisplayModeUsableForDesktopGUI

      Указывает значение CFBoolean, указывающее, подходит ли дисплей для использования с графическим интерфейсом пользователя OS X. Критерии включают факторы, такие как достаточная ширина и высота и соответствующая пиксельная глубина.

      Доступный в OS X v10.2 и позже.

    • kCGDisplayIOFlags

      kCGDisplayIOFlags

      Указывает целочисленное значение CFNumber, содержащее флаги режима отображения Набора I/O. Для получения дополнительной информации посмотрите заголовочный файл IOKit/IOGraphicsTypes.h.

      Доступный в OS X v10.2 и позже.

    • kCGDisplayBytesPerRow

      kCGDisplayBytesPerRow

      Указывает целочисленное значение CFNumber, представляющее число байтов подряд на дисплее.

      Доступный в OS X v10.2 и позже.

    Обсуждение

    Чтобы изучить, как использовать эти ключи для доступа к значениям в словаре режима отображения, см. Ссылку CFDictionary.

  • Режим отображения дополнительные свойства

    Ключи для дополнительных свойств в словаре режима отображения.

    Нет никакой замены; поскольку словари режима отображения осуждаются в OS X v10.6, эти свойства не необходимы.

    Объявление

    Objective C

    #define kCGDisplayModeIsSafeForHardware CFSTR ("kCGDisplayModeIsSafeForHardware") #define kCGDisplayModeIsInterlaced CFSTR("kCGDisplayModeIsInterlaced") #define kCGDisplayModeIsStretched CFSTR("kCGDisplayModeIsStretched") #define kCGDisplayModeIsTelevisionOutput CFSTR ("kCGDisplayModeIsTelevisionOutput")

    Константы

    • kCGDisplayModeIsSafeForHardware

      kCGDisplayModeIsSafeForHardware

      Указывает значение CFBoolean, указывающее, что режиму отображения не нужно диалоговое окно подтверждения, которое будет установлено.

      Доступный в OS X v10.2 и позже.

    • kCGDisplayModeIsInterlaced

      kCGDisplayModeIsInterlaced

      Указывает значение CFBoolean, указывающее, что установлен флаг режима чередования Набора I/O.

      Доступный в OS X v10.2 и позже.

    • kCGDisplayModeIsStretched

      kCGDisplayModeIsStretched

      Указывает значение CFBoolean, указывающее, что Набор I/O простирался, флаг режима установлен.

      Доступный в OS X v10.2 и позже.

    • kCGDisplayModeIsTelevisionOutput

      kCGDisplayModeIsTelevisionOutput

      Указывает значение CFBoolean, указывающее, что установлен флаг режима вывода телевидения Набора I/O.

      Доступный в OS X v10.2 и позже.

    Обсуждение

    Данный ключ присутствует в словаре режима отображения, только если свойство применяется и всегда связывается со значением kCFBooleanTrue. Ключи, не относящиеся к определенному режиму отображения, не появятся в словаре режима.

  • Зарезервированные уровни окна

    Константы уровня окна.

    Объявление

    Swift

    var kCGNumReservedWindowLevels: Int32 { get }

    Objective C

    #define kCGNumReservedWindowLevels (16)

    Константы

    • kCGNumReservedWindowLevels

      kCGNumReservedWindowLevels

      Число уровней окна зарезервировано Apple для внутреннего использования. Какао использует эту константу во время компиляции.

      Доступный в OS X v10.0 и позже.

  • Экранные операции обновления

    Типы операций экранного обновления.

    Объявление

    Swift

    typealias CGScreenUpdateOperation = UInt32

    Objective C

    enum _CGScreenUpdateOperation { kCGScreenUpdateOperationRefresh = 0, kCGScreenUpdateOperationMove = (1 << 0), kCGScreenUpdateOperationReducedDirtyRectangleCount = (1 << 31) }; typedef uint32_t CGScreenUpdateOperation;

    Константы

    • kCGScreenUpdateOperationRefresh

      kCGScreenUpdateOperationRefresh

      Работа экранного обновления.

      Доступный в OS X v10.3 и позже.

    • kCGScreenUpdateOperationMove

      kCGScreenUpdateOperationMove

      Экранная операция пересылки.

      Доступный в OS X v10.3 и позже.

    • kCGScreenUpdateOperationReducedDirtyRectangleCount

      kCGScreenUpdateOperationReducedDirtyRectangleCount

      Когда представлено как часть требуемых операций к функции CGWaitForScreenUpdateRects, указывает, что функция должна попытаться минимизировать число прямоугольников, возвращенных для представления измененных областей дисплея. Функция может объединить смежные прямоугольники в большем ограничительном прямоугольнике, который может включать неизмененные области дисплея.

      Доступный в OS X v10.4 и позже.

    Обсуждение

    Для получения информации о том, как эти константы используются, видят функцию CGWaitForScreenUpdateRects.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.3 и позже.

  • Ключи уровня окна

    Ключи, представляющие стандартные уровни окна в OS X. Кварц включает эти ключи для поддержки сред разработки приложения как Какао. Приложения не должны использовать их непосредственно.

    Объявление

    Swift

    typealias CGWindowLevelKey = Int32

    Objective C

    enum _CGCommonWindowLevelKey { kCGBaseWindowLevelKey = 0, kCGMinimumWindowLevelKey, kCGDesktopWindowLevelKey, kCGBackstopMenuLevelKey, kCGNormalWindowLevelKey, kCGFloatingWindowLevelKey, kCGTornOffMenuWindowLevelKey, kCGDockWindowLevelKey, kCGMainMenuWindowLevelKey, kCGStatusWindowLevelKey, kCGModalPanelWindowLevelKey, kCGPopUpMenuWindowLevelKey, kCGDraggingWindowLevelKey, kCGScreenSaverWindowLevelKey, kCGMaximumWindowLevelKey, kCGOverlayWindowLevelKey, kCGHelpWindowLevelKey, kCGUtilityWindowLevelKey, kCGDesktopIconWindowLevelKey, kCGCursorWindowLevelKey, kCGAssistiveTechHighWindowLevelKey, kCGNumberOfWindowLevelKeys }; typedef int32_t CGWindowLevelKey;

    Константы

    • kCGBaseWindowLevelKey

      kCGBaseWindowLevelKey

      Основной ключ раньше определял уровни окна. Не использовать.

      Доступный в OS X v10.0 и позже.

    • kCGMinimumWindowLevelKey

      kCGMinimumWindowLevelKey

      Самый низкий доступный уровень окна.

      Доступный в OS X v10.0 и позже.

    • kCGDesktopWindowLevelKey

      kCGDesktopWindowLevelKey

      Уровень для рабочего стола.

      Доступный в OS X v10.0 и позже.

    • kCGBackstopMenuLevelKey

      kCGBackstopMenuLevelKey

      Уровень меню поддержки.

      Доступный в OS X v10.0 и позже.

    • kCGNormalWindowLevelKey

      kCGNormalWindowLevelKey

      Уровень для нормальных окон.

      Доступный в OS X v10.0 и позже.

    • kCGFloatingWindowLevelKey

      kCGFloatingWindowLevelKey

      Уровень для плавающих окон.

      Доступный в OS X v10.0 и позже.

    • kCGTornOffMenuWindowLevelKey

      kCGTornOffMenuWindowLevelKey

      Уровень для порванного - от меню.

      Доступный в OS X v10.0 и позже.

    • kCGDockWindowLevelKey

      kCGDockWindowLevelKey

      Уровень для прикрепления.

      Доступный в OS X v10.0 и позже.

    • kCGMainMenuWindowLevelKey

      kCGMainMenuWindowLevelKey

      Уровень для меню выведен на экран в строке меню.

      Доступный в OS X v10.0 и позже.

    • kCGStatusWindowLevelKey

      kCGStatusWindowLevelKey

      Уровень для окон состояния.

      Доступный в OS X v10.0 и позже.

    • kCGModalPanelWindowLevelKey

      kCGModalPanelWindowLevelKey

      Уровень для модальных панелей.

      Доступный в OS X v10.0 и позже.

    • kCGPopUpMenuWindowLevelKey

      kCGPopUpMenuWindowLevelKey

      Уровень для всплывающих меню.

      Доступный в OS X v10.0 и позже.

    • kCGDraggingWindowLevelKey

      kCGDraggingWindowLevelKey

      Уровень для перетаскиваемого окна.

      Доступный в OS X v10.0 и позже.

    • kCGScreenSaverWindowLevelKey

      kCGScreenSaverWindowLevelKey

      Уровень для экранных заставок.

      Доступный в OS X v10.0 и позже.

    • kCGMaximumWindowLevelKey

      kCGMaximumWindowLevelKey

      Самый высокий позволенный уровень окна.

      Доступный в OS X v10.0 и позже.

    • kCGOverlayWindowLevelKey

      kCGOverlayWindowLevelKey

      Уровень для окон наложения.

      Доступный в OS X v10.1 и позже.

    • kCGHelpWindowLevelKey

      kCGHelpWindowLevelKey

      Уровень для окон справки.

      Доступный в OS X v10.1 и позже.

    • kCGUtilityWindowLevelKey

      kCGUtilityWindowLevelKey

      Уровень для служебных окон.

      Доступный в OS X v10.1 и позже.

    • kCGDesktopIconWindowLevelKey

      kCGDesktopIconWindowLevelKey

      Уровень для значков на рабочем столе.

      Доступный в OS X v10.1 и позже.

    • kCGCursorWindowLevelKey

      kCGCursorWindowLevelKey

      Уровень для курсора.

      Доступный в OS X v10.2 и позже.

    • kCGAssistiveTechHighWindowLevelKey

      kCGAssistiveTechHighWindowLevelKey

      Уровень для вспомогательной технологии.

      Доступный в OS X v10.3 и позже.

    • kCGNumberOfWindowLevelKeys

      kCGNumberOfWindowLevelKeys

      Общее количество уровней окна.

      Доступный в OS X v10.0 и позже.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.0 и позже.

  • Свойства сеанса сервера окна

    Ключи для стандартных свойств в словаре сеанса сервера окна.

    Объявление

    Objective C

    #define kCGSessionUserIDKey CFSTR("kCGSSessionUserIDKey") #define kCGSessionUserNameKey CFSTR("kCGSSessionUserNameKey") #define kCGSessionConsoleSetKey CFSTR("kCGSSessionConsoleSetKey") #define kCGSessionOnConsoleKey CFSTR("kCGSSessionOnConsoleKey") #define kCGSessionLoginDoneKey CFSTR("kCGSessionLoginDoneKey")

    Константы

    • kCGSessionUserIDKey

      kCGSessionUserIDKey

      A CFNumber 32-разрядное значение целого без знака, кодирующее идентификатор пользователя для текущего пользователя сеанса.

      Доступный в OS X v10.3 и позже.

    • kCGSessionUserNameKey

      kCGSessionUserNameKey

      A CFString значение, кодирующее короткое имя пользователя сеанса, как установлено работой входа в систему.

      Доступный в OS X v10.3 и позже.

    • kCGSessionConsoleSetKey

      kCGSessionConsoleSetKey

      A CFNumber 32-разрядное значение целого без знака, представляющее ряд аппаратных средств, составляющих консоль.

      Доступный в OS X v10.3 и позже.

    • kCGSessionOnConsoleKey

      kCGSessionOnConsoleKey

      A CFBoolean значение, указывающее, является ли сеанс на консоли.

      Доступный в OS X v10.3 и позже.

    • kCGSessionLoginDoneKey

      kCGSessionLoginDoneKey

      A CFBoolean значение, указывающее, была ли сделана работа входа в систему.

      Доступный в OS X v10.3 и позже.

    Обсуждение

    Чтобы изучить, как использовать эти ключи для доступа к значениям в словаре сеанса, см. Ссылку CFDictionary.

  • Потоковое обновление дисплея типы Rect

    Используйте эти константы для определения, какими прямоугольниками приложение интересуется.

    Объявление

    Swift

    typealias CGDisplayStreamUpdateRectType = Int32

    Objective C

    enum { kCGDisplayStreamUpdateRefreshedRects, kCGDisplayStreamUpdateMovedRects, kCGDisplayStreamUpdateDirtyRects, kCGDisplayStreamUpdateReducedDirtyRects, }; typedef int32_t CGDisplayStreamUpdateRectType;

    Константы

    • kCGDisplayStreamUpdateRefreshedRects

      kCGDisplayStreamUpdateRefreshedRects

      Прямоугольники для перерисованных частей дисплея.

      Доступный в OS X v10.8 и позже.

    • kCGDisplayStreamUpdateMovedRects

      kCGDisplayStreamUpdateMovedRects

      Прямоугольники для частей дисплея, просто перемещенных от одной части дисплея другому.

      Доступный в OS X v10.8 и позже.

    • kCGDisplayStreamUpdateDirtyRects

      kCGDisplayStreamUpdateDirtyRects

      Объединение и прямоугольников, перерисованных и перемещенные прямоугольники.

      Доступный в OS X v10.8 и позже.

    • kCGDisplayStreamUpdateReducedDirtyRects

      kCGDisplayStreamUpdateReducedDirtyRects

      Объединение вычислено и затем упрощено. Это сокращает количество прямоугольников, возвращенных к Вашему приложению, но это может сообщить о некоторых фактически не измененных пикселях.

      Доступный в OS X v10.8 и позже.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.8 и позже.

  • Потоковое состояние обновления дисплея

    Описывает событие обновления кадра.

    Объявление

    Swift

    typealias CGDisplayStreamFrameStatus = Int32

    Objective C

    enum { kCGDisplayStreamFrameStatusFrameComplete, kCGDisplayStreamFrameStatusFrameIdle, kCGDisplayStreamFrameStatusFrameBlank, kCGDisplayStreamFrameStatusStopped, }; typedef int32_t CGDisplayStreamFrameStatus;

    Константы

    • kCGDisplayStreamFrameStatusFrameComplete

      kCGDisplayStreamFrameStatusFrameComplete

      Был сгенерирован новый кадр.

      Доступный в OS X v10.8 и позже.

    • kCGDisplayStreamFrameStatusFrameIdle

      kCGDisplayStreamFrameStatusFrameIdle

      Новый кадр не был сгенерирован, потому что не изменялся дисплей.

      Доступный в OS X v10.8 и позже.

    • kCGDisplayStreamFrameStatusFrameBlank

      kCGDisplayStreamFrameStatusFrameBlank

      Новый кадр не был сгенерирован, потому что дисплей пошел пробел.

      Доступный в OS X v10.8 и позже.

    • kCGDisplayStreamFrameStatusStopped

      kCGDisplayStreamFrameStatusStopped

      Поток дисплея был остановлен.

      Доступный в OS X v10.8 и позже.

    Оператор импорта

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

    Доступный в OS X v10.8 и позже.

  • Поток дисплея дополнительные ключи свойства

    Эти ключи используются для заполнения properties словарь, используемый при создании нового потока дисплея.

    Объявление

    Swift

    let kCGDisplayStreamSourceRect: CFString! let kCGDisplayStreamDestinationRect: CFString! let kCGDisplayStreamPreserveAspectRatio: CFString! let kCGDisplayStreamColorSpace: CFString! let kCGDisplayStreamMinimumFrameTime: CFString! let kCGDisplayStreamShowCursor: CFString! let kCGDisplayStreamQueueDepth: CFString! let kCGDisplayStreamYCbCrMatrix: CFString!

    Objective C

    const CFStringRef kCGDisplayStreamSourceRect; const CFStringRef kCGDisplayStreamDestinationRect; const CFStringRef kCGDisplayStreamPreserveAspectRatio; const CFStringRef kCGDisplayStreamColorSpace; const CFStringRef kCGDisplayStreamMinimumFrameTime; const CFStringRef kCGDisplayStreamShowCursor; const CFStringRef kCGDisplayStreamQueueDepth; const CFStringRef kCGDisplayStreamYCbCrMatrix;

    Константы

    • kCGDisplayStreamSourceRect

      kCGDisplayStreamSourceRect

      Этот ключ указывает, что поток дисплея только выбирает подмножество кадрового буфера дисплея. Если этот ключ не включен в словарь, то весь дисплей передается потоком. Ценность должна быть создана с помощью CGRectCreateDictionaryRepresentation функция. Прямоугольник указан в точках в логической системе координат дисплея.

      Доступный в OS X v10.8 и позже.

    • kCGDisplayStreamDestinationRect

      kCGDisplayStreamDestinationRect

      Этот ключ указывает, что поток дисплея выводит данные кадра в подмножество вывода IOSurface объект. Если этот ключ не включен в словарь, то вся выходная поверхность используется. Ценность должна быть создана с помощью CGRectCreateDictionaryRepresentation функция. Прямоугольник указан в пикселях в системе координат поверхности.

      Доступный в OS X v10.8 и позже.

    • kCGDisplayStreamPreserveAspectRatio

      kCGDisplayStreamPreserveAspectRatio

      Этот ключ указывает, сохраняет ли поток дисплея форматное соотношение данных исходного пикселя. Если этот ключ не включен в словарь, то форматное соотношение сохраняется. Если форматное соотношение сохраняется, то поток дисплея добавляет черные полосы к выходным данным. Если форматное соотношение не сохраняется, то пиксельные данные расширяются для адаптации размерностям буфера вывода. Значение, связанное с ключом, должно быть a CFBoolean.

      Доступный в OS X v10.8 и позже.

    • kCGDisplayStreamColorSpace

      kCGDisplayStreamColorSpace

      Этот ключ указывает цветовое пространство буфера вывода. Если этот ключ не включен в словарь, буфер вывода использует то же цветовое пространство как дисплей. Значение, связанное с этим ключом, должно быть a CGColorSpaceRef для пространства требуемого цвета.

      Доступный в OS X v10.8 и позже.

    • kCGDisplayStreamMinimumFrameTime

      kCGDisplayStreamMinimumFrameTime

      Этот ключ указывает желаемое минимальное время между обновлениями кадра, позволяя Вам отрегулировать уровень, на котором получены обновления. Если этот ключ не включен в словарь, значение по умолчанию 0, подразумевать, что не регулируют обновления. Значение должно быть указано как a CFNumber.

      Доступный в OS X v10.8 и позже.

    • kCGDisplayStreamShowCursor

      kCGDisplayStreamShowCursor

      Этот ключ указывает, должен ли курсор появиться в потоке. Если этот ключ не включен в словарь, курсор видим. Значение должно быть указано как a CFBoolean.

      Доступный в OS X v10.8 и позже.

    • kCGDisplayStreamQueueDepth

      kCGDisplayStreamQueueDepth

      Этот ключ указывает число кадров для хранения в очереди. Если этот ключ не включен в словарь, значение по умолчанию 3 кадры. Указание большего количества кадров использует больше памяти, но может позволить Вам обрабатывать данные кадра, не останавливая поток дисплея. Значение, связанное с этим ключом, должно быть указано как a CFNumber, и не должен превышать 8 кадры.

      Доступный в OS X v10.8 и позже.

    • kCGDisplayStreamYCbCrMatrix

      kCGDisplayStreamYCbCrMatrix

      Этот ключ должен только быть включен поток дисплея при создании выходных кадров или в 420v или в 420f форматы. Это используется, чтобы указать, что матрица YCbCr применилась к выходной поверхности. Значение, связанное с этим ключом, должно быть одной из строк, указанных в Потоке Дисплея YCbCr к Опциям Матрицы преобразования RGB.

      Доступный в OS X v10.8 и позже.

  • Поток дисплея YCbCr к Опциям Матрицы преобразования RGB

    Эти строки используются для указания матрицы для kCGDisplayStreamYCbCrMatrix опция.

    Объявление

    Swift

    let kCGDisplayStreamYCbCrMatrix_ITU_R_709_2: CFString! let kCGDisplayStreamYCbCrMatrix_ITU_R_601_4: CFString! let kCGDisplayStreamYCbCrMatrix_SMPTE_240M_1995: CFString!

    Objective C

    CFStringRef kCGDisplayStreamYCbCrMatrix_ITU_R_709_2; CFStringRef kCGDisplayStreamYCbCrMatrix_ITU_R_601_4; CFStringRef kCGDisplayStreamYCbCrMatrix_SMPTE_240M_1995

    Константы

    • kCGDisplayStreamYCbCrMatrix_ITU_R_709_2

      kCGDisplayStreamYCbCrMatrix_ITU_R_709_2

      Указывает YCbCr к матрице преобразования RGB для цифрового телевидения HDTV (ITU R 709) изображения.

      Доступный в OS X v10.8 и позже.

    • kCGDisplayStreamYCbCrMatrix_ITU_R_601_4

      kCGDisplayStreamYCbCrMatrix_ITU_R_601_4

      Указывает YCbCr к матрице преобразования RGB для стандартного цифрового телевидения (ITU R 601) изображения.

      Доступный в OS X v10.8 и позже.

    • kCGDisplayStreamYCbCrMatrix_SMPTE_240M_1995

      kCGDisplayStreamYCbCrMatrix_SMPTE_240M_1995

      Указывает YCbCR к матрице преобразования RGB на 1920 x 1 135 HDTV (SMPTE 240M 1995).

      Доступный в OS X v10.8 и позже.