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

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

Разработчик

Ссылка платформы QuartzCore ссылка класса CIColor

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

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

CIColor

CIColor класс содержит значения цвета и цветовое пространство, для которого значения цвета допустимы. Вы используете CIColor объекты в сочетании с другими Базовыми классами Изображения, такой как CIFilter, CIContext, и CIImage, использовать в своих интересах встроенные Базовые фильтры Изображения при обработке изображений.

Цветовое пространство определяет один - два - три - или четырехмерная среда, компоненты цвета которой представляют значения интенсивности. Компонент цвета также упоминается как цветовой канал. Цветовое пространство RGB, например, является трехмерным цветовым пространством, стимулы которого являются красной, зеленой, и синей интенсивностью, составляющей данный цвет. Независимо от цветового пространства, в Базовом Изображении, значения цвета располагаются от 0.0 к 1.0, с 0.0 представление отсутствия того компонента (0 процентов) и 1.0 представление 100 процентов.

Цвета также имеют альфа-компонент, представляющий непрозрачность цвета, с 0.0 абсолютно прозрачное значение и 1.0 абсолютно непрозрачное значение. Если цвет не имеет явного альфа-компонента, Базовое Изображение красит цвет, как будто альфа-компонент равняется 1.0. Вы всегда обеспечиваете unpremultiplied компоненты цвета для Базового Изображения, и Базовое Изображение предоставляет unpremultiplied компоненты цвета Вам. Базовое Изображение предварительно умножает каждый компонент цвета с альфа-значением для оптимизации вычислений. Для получения дополнительной информации о предварительно умноженной альфе значения видят Базовое Руководство по программированию Изображения.

Наследование

Соответствует

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

Swift

import QuartzCore

Objective C

@import QuartzCore;

Доступность

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

Инициализация цветовых объектов
  • init (CGColor:) - initWithCGColor:

    Инициализирует Базовый объект цвета изображения с Базовым Графическим цветом.

    Объявление

    Swift

    init!(CGColor c: CGColor!)

    Objective C

    - (id)initWithCGColor:(CGColorRef)c

    Параметры

    c

    Базовое Графическое значение цвета.

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

    Получающийся Базовый цвет изображения.

    Обсуждение

    A CGColorRef объект является фундаментальным непрозрачным типом данных, используемым внутренне Базовой Графикой для представления цветов. Для получения дополнительной информации о Базовых Графических цветовых и цветовых пространствах посмотрите Кварц 2D Руководство по программированию.

    Можно передать a CGColorRef объект, представляющий любое цветовое пространство, включая CMYK, но Базовое Изображение преобразовывает все цветовые пространства в Базовое Изображение, работающее цветовое пространство, прежде чем это передаст цветовое пространство ядру фильтра. Базовое Изображение, работающее цветовое пространство, использует три компонента цвета плюс альфа.

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

  • init (цвет:) - initWithColor:

    Инициализирует Базовый объект цвета изображения использование цветового объекта AppKit.

    Объявление

    Swift

    init?(color color: NSColor)

    Objective C

    - (instancetype)initWithColor:(NSColor *)color

    Параметры

    color

    Начальное значение цвета, которое может принадлежать любому доступному цветовому пространству.

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Создание цветовых объектов
  • colorWithCGColor: + colorWithCGColor:

    Создает цветовой объект из Кварцевого цвета.

    Объявление

    Objective C

    + (CIColor *)colorWithCGColor:(CGColorRef)c

    Параметры

    c

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

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

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

    Обсуждение

    A CGColorRef объект является фундаментальным непрозрачным типом данных, используемым внутренне Кварцем для представления цветов. Для получения дополнительной информации о Кварце 2D цветовые и цветовые пространства посмотрите Кварц 2D Руководство по программированию.

    Можно передать a CGColorRef объект, представляющий любое цветовое пространство, включая CMYK, но Базовое Изображение преобразовывает все цветовые пространства в Базовое Изображение, работающее цветовое пространство, прежде чем это передаст цветовое пространство ядру фильтра. Базовое Изображение, работающее цветовое пространство, использует три компонента цвета плюс альфа.

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

    Objective C

    @import QuartzCore;

    Доступность

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

    См. также

    + colorWithRed:green:blue:
    + colorWithRed:green:blue:alpha:
    + colorWithString:

  • init (red:green:blue:) + colorWithRed:green:blue:

    Создает цветовой объект с помощью указанных значений компонента цвета RGB

    Объявление

    Swift

    init!(red r: CGFloat, green g: CGFloat, blue b: CGFloat) -> CIColor

    Objective C

    + (CIColor *)colorWithRed:(CGFloat)r green:(CGFloat)g blue:(CGFloat)b

    Параметры

    r

    Значение красного компонента.

    g

    Значение зеленого компонента.

    b

    Значение синего компонента.

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

    Базовый объект цвета изображения, представляющий RGB, раскрашивает цветовое пространство, указанное Кварцем 2D константа kCGColorSpaceGenericRGB.

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

    См. также

    + colorWithCGColor:
    + colorWithRed:green:blue:alpha:
    + colorWithString:

  • init (red:green:blue:alpha:) + colorWithRed:green:blue:alpha:

    Создает цветовой объект с помощью указанных значений компонента цвета RGBA.

    Объявление

    Swift

    init!(red r: CGFloat, green g: CGFloat, blue b: CGFloat, alpha a: CGFloat) -> CIColor

    Objective C

    + (CIColor *)colorWithRed:(CGFloat)r green:(CGFloat)g blue:(CGFloat)b alpha:(CGFloat)a

    Параметры

    r

    Значение красного компонента.

    g

    Значение зеленого компонента.

    b

    Значение синего компонента.

    a

    Значение альфа-компонента.

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

    Базовый объект цвета изображения, представляющий RGB, раскрашивает цветовое пространство, указанное Кварцем 2D константа kCGColorSpaceGenericRGB и альфа-значение.

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

    См. также

    + colorWithCGColor:
    + colorWithRed:green:blue:
    + colorWithString:

  • init (строка:) + colorWithString:

    Создает цветовой объект с помощью значений компонента цвета RGBA, указанных строкой.

    Объявление

    Swift

    init!(string representation: String!) -> CIColor

    Objective C

    + (CIColor *)colorWithString:(NSString *)representation

    Параметры

    representation

    Строка, которая находится в одном из форматов, возвращенных stringRepresentation метод. Например, строка:

    @"0.5 0.7 0.3 1.0"

    указывает цвет RGB, компоненты которого являются 50%-м красным, 70%-м зеленым, 30%-м синим цветом, и непрозрачных 100% (альфа-значение 1,0). Строковое представление всегда имеет четыре компонента — красный, зеленый, синий, и альфа. Значение по умолчанию для альфа-компонента 1.0.

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

    Базовый объект цвета изображения, представляющий RGB, раскрашивает цветовое пространство, указанное Кварцем 2D константа kCGColorSpaceGenericRGB.

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

    См. также

    + colorWithCGColor:
    + colorWithRed:green:blue:
    + colorWithRed:green:blue:alpha:

Получение компонентов цвета
  • альфа () - альфа

    Возвращает альфа-значение цвета.

    Объявление

    Swift

    func alpha() -> CGFloat

    Objective C

    - (CGFloat)alpha

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

    Альфа-значение. Цвет, создаваемый без явного альфа-значения, имеет альфу 1,0 по умолчанию.

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

    См. также

    – компоненты

  • синий () - синий

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

    Объявление

    Swift

    func blue() -> CGFloat

    Objective C

    - (CGFloat)blue

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

    unpremultiplied синий компонент цвета.

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

    См. также

    – компоненты

  • цветовое пространство () - цветовое пространство

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

    Объявление

    Swift

    func colorSpace() -> Unmanaged<CGColorSpace>!

    Objective C

    - (CGColorSpaceRef)colorSpace

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

    Кварц 2D цветовое пространство (CGColorSpaceRef объект).

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

    См. также

    – компоненты

  • компоненты () - компоненты

    Возвращает компоненты цвета цвета.

    Объявление

    Swift

    func components() -> UnsafePointer<CGFloat>

    Objective C

    - (const CGFloat *)components

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

    Массив компонентов цвета, указанных как значения с плавающей точкой в диапазоне от 0,0 до 1,0. Если существует тот, этот массив включает альфа-компонент.

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

    См. также

    – numberOfComponents
    – stringRepresentation

  • зеленый () - зеленый

    Возвращает зеленый компонент цвета.

    Объявление

    Swift

    func green() -> CGFloat

    Objective C

    - (CGFloat)green

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

    unpremultiplied зеленый компонент цвета.

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

    См. также

    – компоненты

  • numberOfComponents () - numberOfComponents

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

    Объявление

    Swift

    func numberOfComponents() -> UInt

    Objective C

    - (size_t)numberOfComponents

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

    Число компонентов цвета, включающее альфа-компонент, если существует тот.

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

    См. также

    – компоненты

  • красный () - красный

    Возвращает красный компонент цвета.

    Объявление

    Swift

    func red() -> CGFloat

    Objective C

    - (CGFloat)red

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

    unpremultiplied красный компонент цвета.

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

    См. также

    – компоненты

  • stringRepresentation () - stringRepresentation

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

    Объявление

    Swift

    func stringRepresentation() -> String!

    Objective C

    - (NSString *)stringRepresentation

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

    Отформатированная строка.

    Обсуждение

    Строковое представление всегда имеет четыре компонента — красный, зеленый, синий, и альфа. Значение по умолчанию для альфа-компонента 1.0. Например, эта строка:

    @"0.5 0.7 0.3 1.0"

    указывает цвет RGB, компоненты которого являются 50%-м красным, 70%-м зеленым, 30%-м синим цветом, и непрозрачных 100% (альфа-значение 1,0).

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

    Objective C

    @import QuartzCore;

    Swift

    import QuartzCore

    Доступность

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

    См. также

    – компоненты