NSGradient

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

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

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

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

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

NSObject
NSGradient

NSObject
NSGradient

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

AnyObject
CVarArgType
Сопоставимый
Hashable
NSCoding
NSCopying
NSObjectProtocol
Печатаемый
NSCoding
NSCopying
NSObject

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

Инициализация


    
    init (startingColor:endingColor:)
    - initWithStartingColor:endingColor:

Инициализирует недавно выделенный объект градиента с двумя цветами.

Объявление

Swift

convenience init(startingColor startingColor: NSColor, endingColor endingColor: NSColor)

Objective C

- (instancetype)initWithStartingColor:(NSColor *)startingColor endingColor:(NSColor *)endingColor

Параметры

`startingColor`	Начальный цвет градиента. Расположение этого цвета фиксируется в 0,0.
`endingColor`	Конечный цвет градиента. Расположение этого цвета фиксируется в 1,0.

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

Инициализированный NSGradient объект.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– initWithColors:atLocations:colorSpace:


    
    init (цвета:)
    - initWithColors:

Инициализирует недавно выделенный объект градиента с массивом цветов.

Объявление

Swift

convenience init!(colors colorArray: [AnyObject])

Objective C

- (instancetype)initWithColors:(NSArray *)colorArray

Параметры


      colorArray

Массив NSColor объекты, представляющие цвета для использования для инициализации градиента. Должен быть, по крайней мере два раскрашивают массив. Первый цвет помещается в расположение 0.0 и последнее в расположении 1.0. Если существует больше чем два цвета, дополнительные цвета помещаются в равномерно расположенные с интервалами интервалы между первыми и последними цветами.

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

Инициализированный NSGradient объект.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– initWithColors:atLocations:colorSpace:


    
    initWithColorsAndLocations:
    - initWithColorsAndLocations:

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

Объявление

Objective C

- (instancetype)initWithColorsAndLocations:(NSColor *)firstColor, ...

Параметры


      firstColor

Первые раскрашивают градиент.

...

Список разделенных запятой значений чередования NSColor объекты и параметры расположения (указанный как CGFloat значения). Первое значение после firstColor должно быть расположение. Каждое значение расположения должно быть между 0,0 и 1.0. Список должен быть nil- завершенный.

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

Инициализированный NSGradient объект.

Обсуждение

Как правило, по крайней мере один цвет должен иметь расположение 0,0, и нужно иметь расположение 1,0. Если эти расположения не указаны, цвет на самой близкой цветной остановке используется для устранения разрыва.

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

Objective C

@import AppKit;

Доступность

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

См. также

– initWithColors:atLocations:colorSpace:


    
    init (colors:atLocations:colorSpace:)
    - initWithColors:atLocations:colorSpace:

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

Объявление

Swift

init(colors colorArray: [AnyObject], atLocations locations: UnsafePointer<CGFloat>, colorSpace colorSpace: NSColorSpace)

Objective C

- (instancetype)initWithColors:(NSArray *)colorArray atLocations:(const CGFloat *)locations colorSpace:(NSColorSpace *)colorSpace

Параметры

`colorArray`	Массив `NSColor` объекты, представляющие цвета в градиенте.
`locations`	Массив `CGFloat` значения, содержащие расположение для каждого, раскрашивают градиент. Каждое значение должно быть в диапазоне 0.0 к 1,0. Должно быть то же число расположений, как, раскрашивает `colorArray` параметр.
`colorSpace`	Цветовое пространство для использования для градиента.

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

Инициализированный NSGradient объект.

Обсуждение

Этот метод является определяемым инициализатором NSGradient. Цвета в colorArray параметр преобразовывается в указанное цветовое пространство, если они уже не находятся в том цветовом пространстве.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Примитивные методы рисования


    
    drawFromPoint (_: toPoint:options:)
    - drawFromPoint:toPoint:options:

Рисует линейный градиент между указанным запуском и конечными точками.

Объявление

Swift

func drawFromPoint(_ startingPoint: NSPoint, toPoint endingPoint: NSPoint, options options: NSGradientDrawingOptions)

Objective C

- (void)drawFromPoint:(NSPoint)startingPoint toPoint:(NSPoint)endingPoint options:(NSGradientDrawingOptions)options

Параметры

`startingPoint`	Начальная точка для градиента, в системе локальной координаты. Первый цвет градиента нарисован в этой точке.
`endingPoint`	Конечная точка для градиента, в системе локальной координаты. Последний цвет градиента нарисован в этой точке.
`options`	Параметры градиента, если таковые имеются. Можно использовать эти опции расширить размер градиента вне запуска и конечных точек. Для получения дополнительной информации посмотрите `“Gradient Drawing Options”`.

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    drawFromCenter (_: radius:toCenter:radius:options:)
    - drawFromCenter:radius:toCenter:radius:options:

Рисует радиальный градиент между указанными кругами.

Объявление

Swift

func drawFromCenter(_ startCenter: NSPoint, radius startRadius: CGFloat, toCenter endCenter: NSPoint, radius endRadius: CGFloat, options options: NSGradientDrawingOptions)

Objective C

- (void)drawFromCenter:(NSPoint)startCenter radius:(CGFloat)startRadius toCenter:(NSPoint)endCenter radius:(CGFloat)endRadius options:(NSGradientDrawingOptions)options

Параметры

`startCenter`	Центральная точка круга, представляющего начало градиента.
`startRadius`	Радиус круга, представляющего начало градиента.
`endCenter`	Центральная точка круга, представляющего конец градиента.
`endRadius`	Радиус круга, представляющего конец градиента.
`options`	Параметры градиента, если таковые имеются. Можно использовать эти опции расширить размер градиента вне кругов конца и запуска. Для получения дополнительной информации посмотрите `“Gradient Drawing Options”`.

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Рисование линейных градиентов


    
    drawInRect (_: угол:)
    - drawInRect:angle:

Заполняет указанный прямоугольник линейным градиентом.

Объявление

Swift

func drawInRect(_ rect: NSRect, angle angle: CGFloat)

Objective C

- (void)drawInRect:(NSRect)rect angle:(CGFloat)angle

Параметры

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

Обсуждение

Этот удобный метод рисует линейный градиент в указанном прямоугольнике. Градиент нарисован так, чтобы запуск и конечные цвета, как гарантировали, будут видимы в противоположных углах прямоугольника. Угол вращения определяет, какой угол содержит исходный цвет; посмотрите Таблицу 1.

**Табличные 1Linear** начальные точки градиента.
Угол вращения	Запустите угол
0-89 градусов	Нижний левый
90-179 градусов	Нижний правый
180-269 градусов	Верхний правый
270-359 градусов	Верхний левый

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

Градиент, нарисованный этим методом, отсекается к rect.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– drawInBezierPath:angle:
– drawFromPoint:toPoint:options:


    
    drawInBezierPath (_: угол:)
    - drawInBezierPath:angle:

Заполняет указанный путь линейным градиентом.

Объявление

Swift

func drawInBezierPath(_ path: NSBezierPath, angle angle: CGFloat)

Objective C

- (void)drawInBezierPath:(NSBezierPath *)path angle:(CGFloat)angle

Параметры

`path`	Объект контуров для заполнения.
`angle`	Угол линейного градиента, указанного в градусах. Положительные значения указывают вращение в направлении против часовой стрелки относительно горизонтальной оси.

Обсуждение

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

Градиент, сформированный этим методом, отсекается к path.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– drawInRect:angle:
– drawFromPoint:toPoint:options:

Рисование радиальных градиентов


    
    drawInRect (_: relativeCenterPosition:)
    - drawInRect:relativeCenterPosition:

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

Объявление

Swift

func drawInRect(_ rect: NSRect, relativeCenterPosition relativeCenterPosition: NSPoint)

Objective C

- (void)drawInRect:(NSRect)rect relativeCenterPosition:(NSPoint)relativeCenterPosition

Параметры


      rect

Прямоугольник для заполнения.


      relativeCenterPosition

Относительное расположение в прямоугольнике для использования в качестве центральной точки круга конца градиента. Каждая координата должна содержать значение между-1.0 и 1.0. Координатное значение 0 представляет центр rect вдоль данной оси. В системе координат по умолчанию значение-1.0 соответствует базовому или левому краю прямоугольника, и значение 1,0 соответствует главному или правому краю.

Обсуждение

Центральная точка стартового круга совпадает с центральной точкой rect. Радиус стартового круга 0, приводя к стартовому кругу, являющемуся только что точкой.

Центральная точка круга конца запускается в центральную точку rect и изменяется значением в relativeCenterPosition параметр. Например, если relativeCenterPosition содержит точку (1.0, 1.0), центр круга конца расположен в верхнем правом углу rect. Радиус круга конца установлен в гарантирующее самое маленькое значение rect покрыт кругом конца.

Градиент, сформированный этим методом, отсекается к rect.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– drawInRect:relativeCenterPosition:
– drawFromCenter:radius:toCenter:radius:options:


    
    drawInBezierPath (_: relativeCenterPosition:)
    - drawInBezierPath:relativeCenterPosition:

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

Объявление

Swift

func drawInBezierPath(_ path: NSBezierPath, relativeCenterPosition relativeCenterPosition: NSPoint)

Objective C

- (void)drawInBezierPath:(NSBezierPath *)path relativeCenterPosition:(NSPoint)relativeCenterPosition

Параметры


      path

Путь к заливке.


      relativeCenterPosition

Относительное расположение в ограничительном прямоугольнике path использовать в качестве центральной точки круга конца градиента. Каждая координата должна содержать значение между-1.0 и 1.0. Координатное значение 0 представляет центр ограничительного прямоугольника пути вдоль данной оси. В системе координат по умолчанию значение-1.0 соответствует базовому или левому краю ограничительного прямоугольника, и значение 1,0 соответствует главному или правому краю.

Обсуждение

Центральная точка стартового круга совпадает с центральной точкой path. Радиус стартового круга 0, приводя к стартовому кругу, являющемуся только что точкой.

Центральная точка круга конца запускается в центральную точку path и изменяется значением в relativeCenterPosition параметр. Например, если relativeCenterPosition содержит точку (1.0, 1.0), центр круга конца расположен в верхнем правом углу ограничительного прямоугольника пути. Радиус круга конца установлен в гарантирующее самое маленькое значение rect покрыт кругом конца.

Градиент, сформированный этим методом, отсекается к path.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– drawInRect:relativeCenterPosition:
– drawFromCenter:radius:toCenter:radius:options:

Получение свойств градиента

цветовое пространство цветовое пространство Свойство

Цветовое пространство цветов связалось с градиентом. (только для чтения)

Объявление

Swift

var colorSpace: NSColorSpace { get }

Objective C

@property(readonly, strong) NSColorSpace *colorSpace

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Число цветных остановок связалось с градиентом. (только для чтения)

Объявление

Swift

var numberOfColorStops: Int { get }

Objective C

@property(readonly) NSInteger numberOfColorStops

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    getColor (_: location:atIndex:)
    - getColor:location:atIndex:

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

Объявление

Swift

func getColor(_ color: AutoreleasingUnsafeMutablePointer<NSColor?>, location location: UnsafeMutablePointer<CGFloat>, atIndex index: Int)

Objective C

- (void)getColor:(NSColor **)color location:(CGFloat *)location atIndex:(NSInteger)index

Параметры

`color`	На вводе, указателе на цветовой объект. На выводе, цвете в указанном индексе в цветовой гамме получателя. Можно указать `nil` если Вы не интересуетесь этим параметром.
`location`	На вводе, указателе на число с плавающей точкой. На выводе, содержит значение расположения, связанное с цветом. Это значение между 0,0 и 1.0. Это используется для определения позиции цвета относительно запуска и конечных точек градиента. Можно указать `NULL` если Вы не интересуетесь этим параметром.
`index`	Индекс цвета Вы хотите.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

numberOfColorStops
– interpolatedColorAtLocation:


    
    interpolatedColorAtLocation (_:)
    - interpolatedColorAtLocation:

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

Объявление

Swift

func interpolatedColorAtLocation(_ location: CGFloat) -> NSColor

Objective C

- (NSColor *)interpolatedColorAtLocation:(CGFloat)location

Параметры


      location

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

Обсуждение

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

Исходный цвет градиента всегда располагается в 0,0, и конечный цвет всегда в 1,0.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Типы данных

NSGradientDrawingOptions NSGradientDrawingOptions

Указывает опции рисования градиента.

Объявление

Swift

typealias NSGradientDrawingOptions = Int

Objective C

typedef NSUInteger NSGradientDrawingOptions;

Обсуждение

Постоянные значения, связанные с этим типом, перечислены в Опциях Рисования Градиента.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Константы

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

Объявление

Swift

var NSGradientDrawsBeforeStartingLocation: Int { get } var NSGradientDrawsAfterEndingLocation: Int { get }

Objective C

enum { NSGradientDrawsBeforeStartingLocation = (1 << 0), NSGradientDrawsAfterEndingLocation = (1 << 1), };

Константы
- NSGradientDrawsBeforeStartingLocation
  
  NSGradientDrawsBeforeStartingLocation
  
  Получение расширяется перед начальной точкой градиента.
  
  Доступный в OS X v10.5 и позже.
- NSGradientDrawsAfterEndingLocation
  
  NSGradientDrawsAfterEndingLocation
  
  Получение расширяется вне конечной точки градиента.
  
  Доступный в OS X v10.5 и позже.