Ссылка CGShading

CGShadingRef непрозрачный тип, используемый для определения линейных заливок (осевого) и радиального градиента, цветовыми переходами которых управляет функция (CGFunctionRef) то, что Вы обеспечиваете. Штриховка средних значений для заполнения использования плавного перехода между цветами через область. Для рисования Кварцевой штриховкой Вы вызываете CGContextDrawShading. Эта функция заполняет текущую траекторию отсечения с помощью указанного цветового градиента, вызывая параметрическую функцию неоднократно, как это рисует

Альтернатива использованию объекта CGShading должна использовать CGGradientRef непрозрачный тип. Для приложений, работающих в OS X v10.5 и позже, объекты CGGradient намного более просты использовать. (См. Ссылку CGGradient.)

Функции

Создание объектов штриховки


    
    CGShadingCreateAxial (_: _: _: _: _: _:)
    CGShadingCreateAxial

Создает объект штриховки использовать для осевой штриховки.

Объявление

Swift

func CGShadingCreateAxial(_ colorspace: CGColorSpace!, _ start: CGPoint, _ end: CGPoint, _ function: CGFunction!, _ extendStart: Bool, _ extendEnd: Bool) -> CGShading!

Objective C

CGShadingRef CGShadingCreateAxial ( CGColorSpaceRef space, CGPoint start, CGPoint end, CGFunctionRef function, bool extendStart, bool extendEnd );

Параметры

`colorspace`	Цветовое пространство, в котором выражены значения цвета. Кварц сохраняет этот объект; по возврату можно безопасно выпустить его.
`start`	Начальная точка оси, в целевом координатном пространстве штриховки.
`end`	Конечная точка оси, в целевом координатном пространстве штриховки.
`function`	Объект CGFunction создается функцией `CGFunctionCreate`. Этот объект относится к Вашей функции для создания осевой штриховки. Кварц сохраняет этот объект; по возврату можно безопасно выпустить его.
`extendStart`	Булево значение, указывающее, расширить ли штриховку вне начальной точки оси.
`extendEnd`	Булево значение, указывающее, расширить ли штриховку вне конечной точки оси.

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

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

Обсуждение

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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


    
    CGShadingCreateRadial (_: _: _: _: _: _: _: _:)
    CGShadingCreateRadial

Создает объект штриховки использовать для радиальной штриховки.

Объявление

Swift

func CGShadingCreateRadial(_ colorspace: CGColorSpace!, _ start: CGPoint, _ startRadius: CGFloat, _ end: CGPoint, _ endRadius: CGFloat, _ function: CGFunction!, _ extendStart: Bool, _ extendEnd: Bool) -> CGShading!

Objective C

CGShadingRef CGShadingCreateRadial ( CGColorSpaceRef space, CGPoint start, CGFloat startRadius, CGPoint end, CGFloat endRadius, CGFunctionRef function, bool extendStart, bool extendEnd );

Параметры

`colorspace`	Цветовое пространство, в котором выражены значения цвета. Кварц сохраняет этот объект; по возврату можно безопасно выпустить его.
`start`	Центр стартового круга, в целевом координатном пространстве штриховки.
`startRadius`	Радиус стартового круга, в целевом координатном пространстве штриховки.
`end`	Центр конечного круга, в целевом координатном пространстве штриховки.
`endRadius`	Радиус конечного круга, в целевом координатном пространстве штриховки.
`function`	Объект CGFunction создается функцией `CGFunctionCreate`. Этот объект относится к Вашей функции для создания радиальной штриховки. Кварц сохраняет этот объект; по возврату можно безопасно выпустить его.
`extendStart`	Булево значение, указывающее, расширить ли штриховку вне стартового круга.
`extendEnd`	Булево значение, указывающее, расширить ли штриховку вне конечного круга.

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

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

Обсуждение

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

Сохранение и выпуск заштриховывающих объектов

CGShadingRetain CGShadingRetain

Инкременты сохранить количество объекта штриховки.

Объявление

Objective C

CGShadingRef CGShadingRetain ( CGShadingRef shading );

Параметры

shading

Объект штриховки сохранить.

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

Та же штриховка возражает, что Вы передали в как shading параметр.

Обсуждение

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

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

Objective C

@import CoreGraphics;

Доступность

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

Декременты сохранить количество объекта штриховки.

Объявление

Objective C

void CGShadingRelease ( CGShadingRef shading );

Параметры

shading

Объект штриховки выпустить.

Обсуждение

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

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

Objective C

@import CoreGraphics;

Доступность

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

Получение ID CFType

CGShadingGetTypeID () CGShadingGetTypeID

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

Объявление

Swift

func CGShadingGetTypeID() -> CFTypeID

Objective C

CFTypeID CGShadingGetTypeID ( void );

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

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

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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

Типы данных

CGShadingRef CGShadingRef

Непрозрачный тип, представляющий Кварцевую штриховку.

Объявление

Swift

typealias CGShadingRef = CGShading

Objective C

typedef struct CGShading *CGShadingRef;

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

Objective C

@import CoreGraphics;

Swift

import CoreGraphics

Доступность

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