Ссылка CGColorSpace

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

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

Кварц поддерживает несколько видов цветовых пространств:

Калиброванные цветовые пространства гарантируют, чтобы цвета появились то же, когда выведено на экран на различных устройствах. Визуальное появление цвета сохраняется, насколько возможности устройства позволяют.
Зависящие от устройств цветовые пространства связываются к системе цветного представления определенного устройства. Когда высокочастотное цветное сохранение важно, цветовые пространства устройства не рекомендуются.
Пробелы особого цвета — индексированный и образец. Пространство индексированного цвета содержит таблицу цветов максимум с 256 записями и пространством основного цвета, на котором отображаются записи таблицы цветов. Каждая запись в таблице цветов указывает один цвет в пространстве основного цвета. Цветовое пространство образца используется при перечеркивании или заполнении образцом. Цветовые пространства образца поддерживаются в версии 10.1 OS X и позже.

Функции

Создавание независящих от устройств цветовых пространств


    
    CGColorSpaceCreateCalibratedGray (_: _: _:)
    CGColorSpaceCreateCalibratedGray

Создает калиброванное полутоновое цветовое пространство.

Объявление

Swift

func CGColorSpaceCreateCalibratedGray(_ whitePoint: UnsafePointer<CGFloat>, _ blackPoint: UnsafePointer<CGFloat>, _ gamma: CGFloat) -> CGColorSpace!

Objective C

CGColorSpaceRef CGColorSpaceCreateCalibratedGray ( const CGFloat whitePoint[3], const CGFloat blackPoint[3], CGFloat gamma );

Параметры

`whitePoint`	Массив 3 чисел, указывающих трехцветное значение, в XYZ-пространстве CIE 1931 года, рассеянной белой точки.
`blackPoint`	Массив 3 чисел, указывающих трехцветное значение, в XYZ-пространстве CIE 1931 года, рассеянной черной точки.
`gamma`	Гамма значение, подходящее для устройства отображения.

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

Новое калиброванное серое цветовое пространство. Вы ответственны за выпуск этого объекта путем вызова CGColorSpaceRelease. Если неуспешный, возвраты NULL.

Обсуждение

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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


    
    CGColorSpaceCreateCalibratedRGB (_: _: _: _:)
    CGColorSpaceCreateCalibratedRGB

Создает калиброванное цветовое пространство RGB.

Объявление

Swift

func CGColorSpaceCreateCalibratedRGB(_ whitePoint: UnsafePointer<CGFloat>, _ blackPoint: UnsafePointer<CGFloat>, _ gamma: UnsafePointer<CGFloat>, _ matrix: UnsafePointer<CGFloat>) -> CGColorSpace!

Objective C

CGColorSpaceRef CGColorSpaceCreateCalibratedRGB ( const CGFloat whitePoint[3], const CGFloat blackPoint[3], const CGFloat gamma[3], const CGFloat matrix[9] );

Параметры

`whitePoint`	Массив 3 чисел, указывающих трехцветное значение, в XYZ-пространстве CIE 1931 года, рассеянной белой точки.
`blackPoint`	Массив 3 чисел, указывающих трехцветное значение, в XYZ-пространстве CIE 1931 года, рассеянной черной точки.
`gamma`	Массив 3 чисел, указывающих гамму для красных, зеленых, и синих компонентов цветового пространства.
`matrix`	Массив 9 чисел, указывающих линейную интерпретацию измененных гаммой значений RGB цветового пространства относительно заключительного представления XYZ.

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

Новое калиброванное цветовое пространство RGB. Вы ответственны за выпуск этого объекта путем вызова CGColorSpaceRelease. Если неуспешный, возвраты NULL.

Обсуждение

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

Для цветовых пространств, требующих подробной гаммы, такой как кусочная функция передачи, используемая в sRGB или Купленном 709 ITU-R, можно хотеть использовать функцию CGColorSpaceCreateICCBased вместо этого, потому что это может точно представлять эти гамма кривые.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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


    
    CGColorSpaceCreateICCBased (_: _: _: _:)
    CGColorSpaceCreateICCBased

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

Объявление

Swift

func CGColorSpaceCreateICCBased(_ nComponents: UInt, _ range: UnsafePointer<CGFloat>, _ profile: CGDataProvider!, _ alternateSpace: CGColorSpace!) -> CGColorSpace!

Objective C

CGColorSpaceRef CGColorSpaceCreateICCBased ( size_t nComponents, const CGFloat *range, CGDataProviderRef profile, CGColorSpaceRef alternate );

Параметры

`nComponents`	Число компонентов цвета в цветовом пространстве, определенном ICC, профилирует данные. Это должно соответствовать число компонентов фактически в профиле ICC и должно равняться 1, 3, или 4.
`range`	Массив чисел, указывающих минимальные и максимальные допустимые значения соответствующих компонентов цвета. Размер массива является два раза числом компонентов. Если `c[k]` `k`компонент цвета, допустимый диапазон является диапазоном`[2k] [≤] c[k] [≤]` диапазон`[2k+1]`.
`profile`	Провайдер данных, предоставляющий профиль ICC.
`alternateSpace`	Дополнительное цветовое пространство для использования в случае, если не поддерживается профиль ICC. Дополнительное цветовое пространство должно иметь `nComponents` компоненты цвета. Необходимо предоставить дополнительное цветовое пространство. Если этот параметр `NULL`, тогда функциональные возвраты `NULL`.

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

Новый основанный на ICC объект цветового пространства. Вы ответственны за выпуск этого объекта путем вызова CGColorSpaceRelease. Если неуспешный, возвраты NULL.

Обсуждение

Эта функция создает основанное на ICC цветовое пространство от цветового профиля ICC, как определено Международным Цветным Консорциумом. Профили ICC определяют восстанавливаемый цветовой охват (диапазон цветов, поддерживаемых устройством) и другие характеристики определенного устройства вывода, обеспечивая способ точно преобразовать цветовое пространство одного устройства к цветовому пространству другого. Профиль ICC обычно предоставлен производителем устройства. Кроме того, некоторые цветные мониторы и принтеры содержат, электронно встроил информацию о профиле ICC, также, как и некоторые растровые форматы, такие как TIFF. Раскрашивает независящее от устройств цветовое пространство, должен появиться то же, когда выведено на экран на различных устройствах, до такой степени, что возможности устройства позволяют.

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

См. также

CGColorSpaceCreateWithICCProfile


    
    CGColorSpaceCreateWithICCProfile (_:)
    CGColorSpaceCreateWithICCProfile

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

Объявление

Swift

func CGColorSpaceCreateWithICCProfile(_ data: CFData!) -> CGColorSpace!

Objective C

CGColorSpaceRef CGColorSpaceCreateWithICCProfile ( CFDataRef data );

Параметры


      data

Данные, содержащие ICC, профилируют для установки для нового цветового пространства.

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

Новое цветовое пространство на основе указанного профиля.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

См. также

CGColorSpaceCreateICCBased


    
    CGColorSpaceCreateLab (_: _: _:)
    CGColorSpaceCreateLab

Создает независящее от устройств цветовое пространство, которое является относительно человеческого цветного восприятия, согласно CIE L*a*b* стандарт.

Объявление

Swift

func CGColorSpaceCreateLab(_ whitePoint: UnsafePointer<CGFloat>, _ blackPoint: UnsafePointer<CGFloat>, _ range: UnsafePointer<CGFloat>) -> CGColorSpace!

Objective C

CGColorSpaceRef CGColorSpaceCreateLab ( const CGFloat whitePoint[3], const CGFloat blackPoint[3], const CGFloat range[4] );

Параметры

`whitePoint`	Массив 3 чисел, указывающих трехцветное значение, в XYZ-пространстве CIE 1931 года, рассеянной белой точки.
`blackPoint`	Массив 3 чисел, указывающих трехцветное значение, в XYZ-пространстве CIE 1931 года, рассеянной черной точки.
`range`	Массив 4 чисел, указывающих диапазон допустимых значений для* и b* компоненты цветового пространства.* компонент представляет значения, работающие от зеленого до красного, и b*, компонент представляет значения, работающие от синего до желтого.

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

Новый L*a*b* цветовое пространство. Вы ответственны за выпуск этого объекта путем вызова CGColorSpaceRelease. Если неуспешный, возвраты NULL.

Обсуждение

CIE L*a*b* пространство является нелинейной трансформацией системы нотации цвета Манселла (система, указывающая цвета оттенком, значением и насыщенностью — или «цветность» — значения), разработанный для соответствия воспринятого цветового различия для количественного расстояния в цвете располагают с интервалами. L* компонент представляет значение легкости,* компонент представляет значения, работающие от зеленого до красного, и b*, компонент представляет значения, работающие от синего до желтого. Это примерно соответствует способу, которым человеческий мозг, как думают, декодирует цвета. Раскрашивает независящее от устройств цветовое пространство, должен появиться то же, когда выведено на экран на различных устройствах, до такой степени, что возможности устройства позволяют.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

Создавание универсальных или зависящих от устройств цветовых пространств

CGColorSpaceCreateDeviceCMYK () CGColorSpaceCreateDeviceCMYK

Создает зависящее от устройств цветовое пространство CMYK.

Объявление

Swift

func CGColorSpaceCreateDeviceCMYK() -> CGColorSpace!

Objective C

CGColorSpaceRef CGColorSpaceCreateDeviceCMYK ( void );

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

Зависящее от устройств цветовое пространство CMYK. Вы ответственны за выпуск этого объекта путем вызова CGColorSpaceRelease. Если неуспешный, возвраты NULL.

Обсуждение

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

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

Объявление

Swift

func CGColorSpaceCreateDeviceGray() -> CGColorSpace!

Objective C

CGColorSpaceRef CGColorSpaceCreateDeviceGray ( void );

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

Зависящее от устройств серое цветовое пространство. Вы ответственны за выпуск этого объекта путем вызова CGColorSpaceRelease. Если неуспешный, возвраты NULL.

Обсуждение

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

Создает зависящее от устройств цветовое пространство RGB.

Объявление

Swift

func CGColorSpaceCreateDeviceRGB() -> CGColorSpace!

Objective C

CGColorSpaceRef CGColorSpaceCreateDeviceRGB ( void );

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

Зависящее от устройств цветовое пространство RGB. Вы ответственны за выпуск этого объекта путем вызова CGColorSpaceRelease. Если неуспешный, возвраты NULL.

Обсуждение

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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


    
    CGColorSpaceCreateWithPlatformColorSpace (_:)
    CGColorSpaceCreateWithPlatformColorSpace

Создает специфичное для платформы цветовое пространство.

Объявление

Swift

func CGColorSpaceCreateWithPlatformColorSpace(_ platformColorSpace: UnsafePointer<Void>) -> CGColorSpace!

Objective C

CGColorSpaceRef CGColorSpaceCreateWithPlatformColorSpace ( const void *ref );

Параметры


      platformColorSpace

Универсальный указатель на специфичное для платформы цветовое пространство. В OS X, передача a CMProfileRef— профиль ColorSync. Кварц использует этот указатель (и базовая информация) только во время вызова функции.

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

Новое цветовое пространство. Вы ответственны за выпуск этого объекта путем вызова CGColorSpaceRelease. Если неуспешный, возвраты NULL.

Обсуждение

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

Создавание пространств особого цвета


    
    CGColorSpaceCreateIndexed (_: _: _:)
    CGColorSpaceCreateIndexed

Создает пространство индексированного цвета, состоя из цветов, указанных таблицей цветов.

Объявление

Swift

func CGColorSpaceCreateIndexed(_ baseSpace: CGColorSpace!, _ lastIndex: UInt, _ colorTable: UnsafePointer<UInt8>) -> CGColorSpace!

Objective C

CGColorSpaceRef CGColorSpaceCreateIndexed ( CGColorSpaceRef baseSpace, size_t lastIndex, const unsigned char *colorTable );

Параметры

`baseSpace`	Цветовое пространство, на котором базируется таблица цветов.
`lastIndex`	Максимальный допустимый индекс оценивает за таблицу цветов. Значение должно быть меньше чем или равно 255.
`colorTable`	Массив `m*(lastIndex+1)` байты, где `m` число компонентов цвета в пространстве основного цвета. Каждый байт является целым без знака в диапазоне `0` к `255` это масштабируется к диапазону соответствующего компонента цвета в пространстве основного цвета.

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

Новый индексированный цвет располагает объект с интервалами. Вы ответственны за выпуск этого объекта путем вызова CGColorSpaceRelease. Если неуспешный, возвраты NULL.

Обсуждение

Пространство индексированного цвета содержит таблицу цветов максимум с 255 записями и пространство основного цвета, на котором отображаются записи таблицы цветов. Каждая запись в таблице цветов указывает один цвет в пространстве основного цвета. Значение в пространстве индексированного цвета обрабатывается как индекс в таблицу цветов цветового пространства. Данные в таблице находятся в решетчатом формате. (Например, для цветового пространства RGB значения являются R, G, B, R, G, B, и т.д.)

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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


    
    CGColorSpaceCreatePattern (_:)
    CGColorSpaceCreatePattern

Создает цветовое пространство образца.

Объявление

Swift

func CGColorSpaceCreatePattern(_ baseSpace: CGColorSpace!) -> CGColorSpace!

Objective C

CGColorSpaceRef CGColorSpaceCreatePattern ( CGColorSpaceRef baseSpace );

Параметры


      baseSpace

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

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

Новое цветовое пространство образца. Вы ответственны за выпуск этого объекта путем вызова CGColorSpaceRelease. Если неуспешный, возвраты NULL.

Обсуждение

Для получения информации о создании и использовании образцов, посмотрите Кварц 2D Руководство по программированию и Ссылка CGPattern. Кварц сохраняет цветовое пространство, в котором Вы передаете. По возврату можно безопасно выпустить его путем вызова CGColorSpaceRelease.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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


    
    CGColorSpaceCreateWithName (_:)
    CGColorSpaceCreateWithName

Создает указанный тип Кварцевого цветового пространства.

Объявление

Swift

func CGColorSpaceCreateWithName(_ name: CFString!) -> CGColorSpace!

Objective C

CGColorSpaceRef CGColorSpaceCreateWithName ( CFStringRef name );

Параметры


      name

Имя цветового пространства. Посмотрите “Color Space Names” для списка допустимых Определенных с помощью кварца имен.

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

Новое универсальное цветовое пространство. Вы ответственны за выпуск этого объекта путем вызова CGColorSpaceRelease. Если неуспешный, возвраты NULL.

Обсуждение

Можно использовать эту функцию для создавания универсального цветового пространства. Для получения дополнительной информации посмотрите “Color Space Names”.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

См. также

CGColorSpaceCopyName

Получение информации о цветовых пространствах

CGColorSpaceCopyICCProfile (_:) CGColorSpaceCopyICCProfile

Возвращает копию профиля ICC предоставленного цветового пространства.

Объявление

Swift

func CGColorSpaceCopyICCProfile(_ space: CGColorSpace!) -> CFData!

Objective C

CFDataRef CGColorSpaceCopyICCProfile ( CGColorSpaceRef space );

Параметры

space

Цветовое пространство, профиль ICC которого Вы хотите получить.

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

Профиль ICC или NULL если цветовое пространство не имеет профиля ICC.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

Доступный в OS X v10.5 и позже.
CGColorSpaceGetNumberOfComponents (_:) CGColorSpaceGetNumberOfComponents

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

Объявление

Swift

func CGColorSpaceGetNumberOfComponents(_ cs: CGColorSpace!) -> UInt

Objective C

size_t CGColorSpaceGetNumberOfComponents ( CGColorSpaceRef space );

Параметры

cs

Кварцевое цветовое пространство для исследования.

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

Число компонентов цвета в указанном цветовом пространстве, не включая альфа-значение. Например, для цветового пространства RGB, CGColorSpaceGetNumberOfComponents возвращает значение 3.

Обсуждение

Цветовое пространство определяет n-мерное пространство, размерности которого (или компоненты) представляют значения интенсивности. Например, Вы указываете, раскрашивает пространство RGB как три значения интенсивности: красный, зеленый, и синий. Можно использовать CGColorSpaceGetNumberOfComponents функция для получения числа компонентов в данном цветовом пространстве.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

Возвращает Базовый идентификатор типа Основы для Кварцевых цветовых пространств.

Объявление

Swift

func CGColorSpaceGetTypeID() -> CFTypeID

Objective C

CFTypeID CGColorSpaceGetTypeID ( void );

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

Идентификатор для непрозрачного типа CGColorSpaceRef.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

Доступный в OS X v10.2 и позже.
CGColorSpaceGetModel (_:) CGColorSpaceGetModel

Возвращает модель цветового пространства предоставленного цветового пространства.

Объявление

Swift

func CGColorSpaceGetModel(_ space: CGColorSpace!) -> CGColorSpaceModel

Objective C

CGColorSpaceModel CGColorSpaceGetModel ( CGColorSpaceRef space );

Параметры

space

Объект цветового пространства.

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

Одна из констант, описанных в “Color Space Models”.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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


    
    CGColorSpaceGetBaseColorSpace (_:)
    CGColorSpaceGetBaseColorSpace

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

Объявление

Swift

func CGColorSpaceGetBaseColorSpace(_ space: CGColorSpace!) -> CGColorSpace!

Objective C

CGColorSpaceRef CGColorSpaceGetBaseColorSpace ( CGColorSpaceRef space );

Параметры


      space

Объект цветового пространства для образца или пространства индексированного цвета.

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

Пространство основного цвета, если space параметр является пространством индексированного цвета или образцом; иначе, NULL.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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


    
    CGColorSpaceGetColorTableCount (_:)
    CGColorSpaceGetColorTableCount

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

Объявление

Swift

func CGColorSpaceGetColorTableCount(_ space: CGColorSpace!) -> UInt

Objective C

size_t CGColorSpaceGetColorTableCount ( CGColorSpaceRef space );

Параметры


      space

Объект цветового пространства для пространства индексированного цвета.

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

Число записей в таблице цветов space параметр, если цветовое пространство является пространством индексированного цвета; иначе, возвраты 0.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

См. также

CGColorSpaceGetColorTable


    
    CGColorSpaceGetColorTable (_: _:)
    CGColorSpaceGetColorTable

Копирует записи в таблице цветов пространства индексированного цвета.

Объявление

Swift

func CGColorSpaceGetColorTable(_ space: CGColorSpace!, _ table: UnsafeMutablePointer<UInt8>)

Objective C

void CGColorSpaceGetColorTable ( CGColorSpaceRef space, uint8_t *table );

Параметры

`space`	Объект цветового пространства для пространства индексированного цвета.
`table`	Массив, на который указывает таблица, должен быть, по крайней мере, столь же большим как число записей в таблице цветов. На выводе массив содержит табличные данные в том же формате, как это передало `CGColorSpaceCreateIndexed`.

Обсуждение

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

См. также

CGColorSpaceGetColorTableCount

CGColorSpaceCopyName (_:) CGColorSpaceCopyName

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

Объявление

Swift

func CGColorSpaceCopyName(_ space: CGColorSpace!) -> CFString!

Objective C

CFStringRef CGColorSpaceCopyName ( CGColorSpaceRef space );

Параметры

space

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

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

Имя раньше создавало указанное цветовое пространство, или NULL если цветовое пространство не было создано с помощью CGColorSpaceCreateWithName функция.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

См. также

CGColorSpaceCreateWithName

Сохранение и выпуск цветовых пространств

CGColorSpaceRelease CGColorSpaceRelease

Декременты сохранить количество цветового пространства.

Объявление

Objective C

void CGColorSpaceRelease ( CGColorSpaceRef space );

Параметры

cs

Кварцевое цветовое пространство для выпуска.

Обсуждение

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

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

Objective C

@import CoreGraphics;

Доступность

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

Инкременты сохранить количество цветового пространства.

Объявление

Objective C

CGColorSpaceRef CGColorSpaceRetain ( CGColorSpaceRef space );

Параметры

cs

Кварцевое цветовое пространство для сохранения.

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

То же цветовое пространство Вы передали в как cs параметр.

Обсуждение

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

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

Objective C

@import CoreGraphics;

Доступность

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

Типы данных

CGColorSpaceRef CGColorSpaceRef

Непрозрачный тип, инкапсулирующий информацию о цветовом пространстве.

Объявление

Swift

typealias CGColorSpaceRef = CGColorSpace

Objective C

typedef struct CGColorSpace *CGColorSpaceRef;

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

Константы

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

Объявление

Swift

let kCGColorSpaceGenericGray: CFString! let kCGColorSpaceGenericRGB: CFString! let kCGColorSpaceGenericCMYK: CFString! let kCGColorSpaceGenericRGBLinear: CFString! let kCGColorSpaceAdobeRGB1998: CFString! let kCGColorSpaceSRGB: CFString! let kCGColorSpaceGenericGrayGamma2_2: CFString!

Objective C

CFStringRef kCGColorSpaceGenericGray CFStringRef kCGColorSpaceGenericRGB CFStringRef kCGColorSpaceGenericCMYK CFStringRef kCGColorSpaceGenericRGBLinear CFStringRef kCGColorSpaceAdobeRGB1998 CFStringRef kCGColorSpaceSRGB CFStringRef kCGColorSpaceGenericGrayGamma2_2

Константы
- kCGColorSpaceGenericGray
  
  kCGColorSpaceGenericGray
  
  Имя универсального серого цветового пространства.
  
  Доступный в OS X v10.4 и позже.
- kCGColorSpaceGenericRGB
  
  kCGColorSpaceGenericRGB
  
  Имя универсального цветового пространства RGB.
  
  Доступный в OS X v10.4 и позже.
- kCGColorSpaceGenericCMYK
  
  kCGColorSpaceGenericCMYK
  
  Имя универсального цветового пространства CMYK.
  
  Доступный в OS X v10.4 и позже.
- kCGColorSpaceGenericRGBLinear
  
  kCGColorSpaceGenericRGBLinear
  
  Имя универсального линейного цветового пространства RGB. Это совпадает с kCGColorSpaceGenericRGB, но с гаммой равняются 1.0.
  
  Доступный в OS X v10.5 и позже.
- kCGColorSpaceAdobeRGB1998
  
  kCGColorSpaceAdobeRGB1998
  
  Имя цветового пространства Adobe RGB (1998). Для получения дополнительной информации см., «что Цветное изображение Adobe RGB (1998) Кодирует», Версия 2005-05, Adobe Systems Inc. (http://www .adobe.com).
  
  Доступный в OS X v10.5 и позже.
- kCGColorSpaceSRGB
  
  kCGColorSpaceSRGB
  
  Имя цветового пространства SRGB.
  
  Доступный в OS X v10.5 и позже.
- kCGColorSpaceGenericGrayGamma2_2
  
  kCGColorSpaceGenericGrayGamma2_2
  
  Имя универсального серого цветового пространства с гамма значением 2,2.
  
  Доступный в OS X v10.6 и позже.
Обсуждение

Постоянное имя цветового пространства может быть передано в качестве параметра функции CGColorSpaceCreateWithName.
Модели цветового пространства
Модели для цветовых пространств.

Объявление

Swift

struct CGColorSpaceModel { init(_ value: Int32) var value: Int32 }

Objective C

enum CGColorSpaceModel { kCGColorSpaceModelUnknown = -1, kCGColorSpaceModelMonochrome, kCGColorSpaceModelRGB, kCGColorSpaceModelCMYK, kCGColorSpaceModelLab, kCGColorSpaceModelDeviceN, kCGColorSpaceModelIndexed, kCGColorSpaceModelPattern }; typedef int32_t CGColorSpaceModel;

Константы
- kCGColorSpaceModelUnknown
  
  kCGColorSpaceModelUnknown
  
  Неизвестная модель цветового пространства.
  
  Доступный в OS X v10.5 и позже.
- kCGColorSpaceModelMonochrome
  
  kCGColorSpaceModelMonochrome
  
  Монохромная модель цветового пространства.
  
  Доступный в OS X v10.5 и позже.
- kCGColorSpaceModelRGB
  
  kCGColorSpaceModelRGB
  
  Модель цветового пространства RGB.
  
  Доступный в OS X v10.5 и позже.
- kCGColorSpaceModelCMYK
  
  kCGColorSpaceModelCMYK
  
  Модель цветового пространства CMYK.
  
  Доступный в OS X v10.5 и позже.
- kCGColorSpaceModelLab
  
  kCGColorSpaceModelLab
  
  Модель цветового пространства Лаборатории.
  
  Доступный в OS X v10.5 и позже.
- kCGColorSpaceModelDeviceN
  
  kCGColorSpaceModelDeviceN
  
  Модель цветового пространства DeviceN.
  
  Доступный в OS X v10.5 и позже.
- kCGColorSpaceModelIndexed
  
  kCGColorSpaceModelIndexed
  
  Модель пространства индексированного цвета.
  
  Доступный в OS X v10.5 и позже.
- kCGColorSpaceModelPattern
  
  kCGColorSpaceModelPattern
  
  Модель цветового пространства образца.
  
  Доступный в OS X v10.5 и позже.
Оператор импорта

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

Доступный в OS X v10.5 и позже.
Намерения рендеринга цвета
Обработка опций для цветов, не расположенных в целевом цветовом пространстве графического контекста.

Объявление

Swift

struct CGColorRenderingIntent { init(_ value: UInt32) var value: UInt32 }

Objective C

enum CGColorRenderingIntent { kCGRenderingIntentDefault, kCGRenderingIntentAbsoluteColorimetric, kCGRenderingIntentRelativeColorimetric, kCGRenderingIntentPerceptual, kCGRenderingIntentSaturation }; typedef enum CGColorRenderingIntent CGColorRenderingIntent;

Константы
- kCGRenderingIntentDefault
  
  kCGRenderingIntentDefault
  
  Намерение рендеринга значения по умолчанию для графического контекста.
  
  Доступный в OS X v10.0 и позже.
- kCGRenderingIntentAbsoluteColorimetric
  
  kCGRenderingIntentAbsoluteColorimetric
  
  Карта окрашивает за пределами палитры устройства вывода к самому близкому соответствию в палитре устройства вывода. Это может произвести эффект отсечения, где два различных значения цвета в палитре графического контекста отображаются на том же значении цвета в палитре устройства вывода. В отличие от относительного колориметрического, колориметрического абсолютного не изменяет цвета в палитре устройства вывода.
  
  Доступный в OS X v10.0 и позже.
- kCGRenderingIntentRelativeColorimetric
  
  kCGRenderingIntentRelativeColorimetric
  
  Карта окрашивает за пределами палитры устройства вывода к самому близкому соответствию в палитре устройства вывода. Это может произвести эффект отсечения, где два различных значения цвета в палитре графического контекста отображаются на том же значении цвета в палитре устройства вывода. Относительные колориметрические сдвиги все цвета (включая тех в палитре) для учета различия между белой точкой графического контекста и белой точкой устройства вывода.
  
  Доступный в OS X v10.0 и позже.
- kCGRenderingIntentPerceptual
  
  kCGRenderingIntentPerceptual
  
  Сохраните визуальное отношение между цветами путем сжатия палитры графического контекста для адаптации в палитре устройства вывода. Перцепционное намерение хорошо для фотографий и другого комплекса, подробных изображений.
  
  Доступный в OS X v10.0 и позже.
- kCGRenderingIntentSaturation
  
  kCGRenderingIntentSaturation
  
  Сохраните относительную степень насыщения цветов при преобразовании в палитру устройства вывода. Результатом является изображение с яркими, насыщенными цветами. Намерение насыщенности хорошо для репродуцирования изображений с низкой подробностью, таково как диаграммы представления и графики.
  
  Доступный в OS X v10.0 и позже.
Обсуждение

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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