Ссылка CGColor

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

См. также эти связанные ссылки: Ссылка CGContext, Ссылка CGColorSpace и Ссылка CGPattern.

Функции

Получение постоянного цвета

CGColorGetConstantColor (_:) CGColorGetConstantColor

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

Объявление

Swift

func CGColorGetConstantColor(_ colorName: CFString!) -> CGColor!

Objective C

CGColorRef CGColorGetConstantColor ( CFStringRef colorName );

Параметры

colorName

Цветное имя. Можно передать любой из “Constant Colors” постоянный.

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

Цветовой объект.

Обсуждение

Как CGColorGetConstantColor не «Копия», или «Создайте» функцию, это не обязательно возвращает новую ссылку каждый раз, когда это вызывают. Как следствие Вы не должны выпускать возвращенное значение. Однако цвета возвратились из CGColorGetConstantColor может быть сохранен и выпущен должным образом вложенным способом, как любой другой Базовый тип Основы может.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

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

CGColorRelease CGColorRelease

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

Объявление

Objective C

void CGColorRelease ( CGColorRef color );

Параметры

color

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

Обсуждение

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

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

Objective C

@import CoreGraphics;

Доступность

Доступный в версии 10.3 OS X и позже.
CGColorRetain CGColorRetain

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

Объявление

Objective C

CGColorRef CGColorRetain ( CGColorRef color );

Параметры

color

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

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

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

Обсуждение

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

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

Objective C

@import CoreGraphics;

Доступность

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

Создание кварцевых цветов


    
    CGColorCreate (_: _:)
    CGColorCreate

Создает Кварцевый цвет использование списка значений интенсивности (включая альфу) и связанное цветовое пространство.

Объявление

Swift

func CGColorCreate(_ colorspace: CGColorSpace!, _ components: UnsafePointer<CGFloat>) -> CGColor!

Objective C

CGColorRef CGColorCreate ( CGColorSpaceRef space, const CGFloat components[] );

Параметры


      colorspace

Цветовое пространство для нового цвета. Кварц сохраняет этот объект; по возврату можно безопасно выпустить его.


      components

Массив интенсивности оценивает описание цвета. Массив должен содержать значения n+1, соответствующие n компонентам цвета в указанном цветовом пространстве, сопровождаемом альфа-компонентом. Каждое значение компонента должно быть в диапазоне, подходящем для цветового пространства. Значения вне этого диапазона будут зафиксированы к самому близкому правильному значению.

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

Новый Кварцевый цвет. Вы ответственны за выпуск этого объектного использования CGColorRelease.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

CGColorCreateCopy (_:) CGColorCreateCopy

Создает копию существующего Кварцевого цвета.

Объявление

Swift

func CGColorCreateCopy(_ color: CGColor!) -> CGColor!

Objective C

CGColorRef CGColorCreateCopy ( CGColorRef color );

Параметры

color

Кварцевый цвет.

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

Копия указанного цвета. Вы ответственны за выпуск этого объектного использования CGColorRelease.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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


    
    CGColorCreateGenericGray (_: _:)
    CGColorCreateGenericGray

Создает цвет в Универсальном сером цветовом пространстве.

Объявление

Swift

func CGColorCreateGenericGray(_ gray: CGFloat, _ alpha: CGFloat) -> CGColor!

Objective C

CGColorRef CGColorCreateGenericGray ( CGFloat gray, CGFloat alpha );

Параметры

`gray`	Полутоновое значение (`0.0` - `1.0`).
`alpha`	Альфа-значение (`0.0` - `1.0`).

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

Цветовой объект.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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


    
    CGColorCreateGenericRGB (_: _: _: _:)
    CGColorCreateGenericRGB

Создает цвет в Универсальном цветовом пространстве RGB.

Объявление

Swift

func CGColorCreateGenericRGB(_ red: CGFloat, _ green: CGFloat, _ blue: CGFloat, _ alpha: CGFloat) -> CGColor!

Objective C

CGColorRef CGColorCreateGenericRGB ( CGFloat red, CGFloat green, CGFloat blue, CGFloat alpha );

Параметры

`red`	Красное значение компонента (`0.0` - `1.0`).
`green`	Зеленое значение компонента (`0.0` - `1.0`).
`blue`	Синее значение компонента (`0.0` - `1.0`).
`alpha`	Альфа-значение (`0.0` - `1.0`).

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

Цветовой объект.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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


    
    CGColorCreateGenericCMYK (_: _: _: _: _:)
    CGColorCreateGenericCMYK

Создает цвет в Универсальном цветовом пространстве CMYK.

Объявление

Swift

func CGColorCreateGenericCMYK(_ cyan: CGFloat, _ magenta: CGFloat, _ yellow: CGFloat, _ black: CGFloat, _ alpha: CGFloat) -> CGColor!

Objective C

CGColorRef CGColorCreateGenericCMYK ( CGFloat cyan, CGFloat magenta, CGFloat yellow, CGFloat black, CGFloat alpha );

Параметры

`cyan`	Голубое значение (`0.0` - `1.0`).
`magenta`	Пурпурное значение (`0.0` - `1.0`).
`yellow`	Желтое значение (`0.0` - `1.0`).
`black`	Черное значение (`0.0` - `1.0`).
`alpha`	Альфа-значение (0.0 - 1.0).

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

Цветовой объект.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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


    
    CGColorCreateCopyWithAlpha (_: _:)
    CGColorCreateCopyWithAlpha

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

Объявление

Swift

func CGColorCreateCopyWithAlpha(_ color: CGColor!, _ alpha: CGFloat) -> CGColor!

Objective C

CGColorRef CGColorCreateCopyWithAlpha ( CGColorRef color, CGFloat alpha );

Параметры

`color`	Кварцевый цвет для копирования.
`alpha`	Значение, указывающее желаемую непрозрачность копии. Значения вне диапазона `[0,1]` фиксируются к `0` или `1`.

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

Копия указанного цвета, с помощью указанного альфа-значения. Вы ответственны за выпуск этого объектного использования CGColorRelease.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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


    
    CGColorCreateWithPattern (_: _: _:)
    CGColorCreateWithPattern

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

Объявление

Swift

func CGColorCreateWithPattern(_ colorspace: CGColorSpace!, _ pattern: CGPattern!, _ components: UnsafePointer<CGFloat>) -> CGColor!

Objective C

CGColorRef CGColorCreateWithPattern ( CGColorSpaceRef space, CGPatternRef pattern, const CGFloat components[] );

Параметры

`colorspace`	Цветовое пространство образца для нового цвета. Кварц сохраняет цветовое пространство, в котором Вы передаете. По возврату можно безопасно выпустить его.
`pattern`	Образец для нового цветового объекта. Кварц сохраняет образец, в котором Вы передаете. По возврату можно безопасно выпустить его.
`components`	Массив интенсивности оценивает описание цвета. Массив должен содержать `n + 1` значения, соответствующие `n` компоненты цвета в указанном цветовом пространстве, сопровождаемом альфа-компонентом. Каждое значение компонента должно быть в диапазоне, подходящем для цветового пространства. Значения вне этого диапазона будут зафиксированы к самому близкому правильному значению.

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

Новый Кварцевый цвет. Вы ответственны за выпуск этого объектного использования CGColorRelease.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

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


    
    CGColorEqualToColor (_: _:)
    CGColorEqualToColor

Указывает, равны ли два цвета.

Объявление

Swift

func CGColorEqualToColor(_ color1: CGColor!, _ color2: CGColor!) -> Bool

Objective C

bool CGColorEqualToColor ( CGColorRef color1, CGColorRef color2 );

Параметры

`color1`	Первый Кварц окрашивает для сравнения.
`color2`	Второй Кварц окрашивает для сравнения.

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

Булево значение это, если true, указывает, что указанные цвета равны. Если цвета не равны, значение false.

Обсуждение

Два цвета равны, если они имеют равные цветовые пространства и численно равняются компонентам цвета.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

CGColorGetAlpha (_:) CGColorGetAlpha

Возвращает значение альфа-компонента, связанного с Кварцевым цветом.

Объявление

Swift

func CGColorGetAlpha(_ color: CGColor!) -> CGFloat

Objective C

CGFloat CGColorGetAlpha ( CGColorRef color );

Параметры

color

Кварцевый цвет.

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

Альфа-интенсивность оценивает в диапазоне [0,1]. Значение представляет непрозрачность цвета.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

Доступный в версии 10.3 OS X и позже.
CGColorGetColorSpace (_:) CGColorGetColorSpace

Возвращает цветовое пространство, связанное с Кварцевым цветом.

Объявление

Swift

func CGColorGetColorSpace(_ color: CGColor!) -> CGColorSpace!

Objective C

CGColorSpaceRef CGColorGetColorSpace ( CGColorRef color );

Параметры

color

Кварцевый цвет.

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

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

Доступный в версии 10.3 OS X и позже.
CGColorGetComponents (_:) CGColorGetComponents

Возвращает значения компонентов цвета (включая альфу) связанный с Кварцевым цветом.

Объявление

Swift

func CGColorGetComponents(_ color: CGColor!) -> UnsafePointer<CGFloat>

Objective C

const CGFloat * CGColorGetComponents ( CGColorRef color );

Параметры

color

Кварцевый цвет.

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

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

Доступный в версии 10.3 OS X и позже.
CGColorGetNumberOfComponents (_:) CGColorGetNumberOfComponents

Возвращает число компонентов цвета (включая альфу) связанный с Кварцевым цветом.

Объявление

Swift

func CGColorGetNumberOfComponents(_ color: CGColor!) -> UInt

Objective C

size_t CGColorGetNumberOfComponents ( CGColorRef color );

Параметры

color

Кварцевый цвет.

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

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

Доступный в версии 10.3 OS X и позже.
CGColorGetPattern (_:) CGColorGetPattern

Возвращается образец, связанный с Кварцем, раскрашивают цветовое пространство образца.

Объявление

Swift

func CGColorGetPattern(_ color: CGColor!) -> CGPattern!

Objective C

CGPatternRef CGColorGetPattern ( CGColorRef color );

Параметры

color

Кварцевый цвет.

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

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

Доступный в версии 10.3 OS X и позже.
CGColorGetTypeID () CGColorGetTypeID

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

Объявление

Swift

func CGColorGetTypeID() -> CFTypeID

Objective C

CFTypeID CGColorGetTypeID ( void );

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

Базовый идентификатор типа Основы для CGColorRef.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

Типы данных

CGColorRef CGColorRef

Непрозрачный тип, представляющий цвет, используемый в Кварце 2D получение.

Объявление

Swift

typealias CGColorRef = CGColor

Objective C

typedef struct CGColor *CGColorRef;

Обсуждение

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

В версии 10.3 OS X и позже, CGColorRef получен из CFTypeRef и наследовал свойства, которые все Базовые типы Основы имеют вместе. Для получения дополнительной информации см. Ссылку CFType.

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

Константы

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

Объявление

Swift

let kCGColorWhite: CFString! let kCGColorBlack: CFString! let kCGColorClear: CFString!

Objective C

const CFStringRef kCGColorWhite; const CFStringRef kCGColorBlack; const CFStringRef kCGColorClear;

Константы
- kCGColorWhite
  
  kCGColorWhite
  
  Белый цвет в Универсальном сером цветовом пространстве.
  
  Доступный в OS X v10.5 и позже.
- kCGColorBlack
  
  kCGColorBlack
  
  Черный цвет в Универсальном сером цветовом пространстве.
  
  Доступный в OS X v10.5 и позже.
- kCGColorClear
  
  kCGColorClear
  
  Ясные раскрашивают Универсальное серое цветовое пространство.
  
  Доступный в OS X v10.5 и позже.