Ссылка CGContext
CGContextRef
непрозрачный тип представляет Кварц 2D место назначения получения. Графический контекст содержит параметры получения, и вся специфичная для устройства информация должна была представить краску на странице месту назначения, является ли место назначения окном в приложении, растровом изображении, документе в формате PDF или принтере. Можно получить графический контекст при помощи Кварцевых функций создания контекста графики или при помощи высокоуровневых функций, предоставленных в Углероде, Какао или платформах Печати. Кварц обеспечивает функции создания для различных разновидностей Кварцевых контекстов графики включая растровые изображения и PDF. Платформа Какао обеспечивает функции для получения контекстов графики окна. Платформа Печати обеспечивает функции, получающие графический контекст, подходящий для целевого принтера.
-
Силы все незаконченные операции рисования в контексте окна, который будет сразу представлен к устройству назначения.
Объявление
Swift
func CGContextFlush(_
c
: CGContext!)Objective C
void CGContextFlush ( CGContextRef c );
Параметры
c
Контекст окна для сбрасывания. При передаче контекста PDF или растрового контекста эта функция ничего не делает.
Обсуждение
Когда Вы вызываете эту функцию, Кварц сразу сбрасывает текущее получение к устройству назначения (например, экран). Поскольку системное программное обеспечение сбрасывает контекст автоматически в подходящее время, вызывание этой функции могло иметь неблагоприятный эффект на производительность. Под нормальными условиями Вы не должны вызывать эту функцию.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает идентификатор типа для Кварцевых контекстов графики.
Объявление
Swift
func CGContextGetTypeID() -> CFTypeID
Objective C
CFTypeID CGContextGetTypeID ( void );
Возвращаемое значение
Идентификатор для непрозрачного типа
CGContextRef
.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.2 и позже.
-
Декременты сохранить количество графического контекста.
Объявление
Objective C
void CGContextRelease ( CGContextRef c );
Параметры
c
Графический контекст для выпуска.
Обсуждение
Эта функция эквивалентна
CFRelease
, кроме него не вызывает ошибку еслиc
NULL
.Оператор импорта
Objective C
@import CoreGraphics;
Доступность
Доступный в OS X v10.0 и позже.
-
Инкременты сохранить количество графического контекста.
Объявление
Objective C
CGContextRef CGContextRetain ( CGContextRef c );
Параметры
c
Графический контекст для сохранения.
Возвращаемое значение
Тот же графический контекст Вы передали в как
context
параметр.Обсуждение
Эта функция эквивалентна
CFRetain
, кроме него не вызывает ошибку еслиc
NULL
.Оператор импорта
Objective C
@import CoreGraphics;
Доступность
Доступный в OS X v10.0 и позже.
-
Отмечает контекст окна для обновления.
Объявление
Swift
func CGContextSynchronize(_
c
: CGContext!)Objective C
void CGContextSynchronize ( CGContextRef c );
Параметры
c
Контекст окна для синхронизации. При передаче контекста PDF или растрового контекста эта функция ничего не делает.
Обсуждение
Когда Вы вызываете эту функцию, все операции рисования, так как последнее обновление сбрасывается в следующей регулярной возможности. Под нормальными условиями Вы не должны вызывать эту функцию.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Продвигает копию текущего состояния графики на штабель состояния графики для контекста.
Объявление
Swift
func CGContextSaveGState(_
c
: CGContext!)Objective C
void CGContextSaveGState ( CGContextRef c );
Параметры
c
Графический контекст, текущее состояние графики которого Вы хотите сохранить.
Обсуждение
Каждый графический контекст поддерживает штабель состояний графики. Обратите внимание на то, что не всеми аспектами текущей среды получения являются элементы состояния графики. Например, когда Вы вызываете, текущий путь не считают частью состояния графики и поэтому не сохраняют
CGContextSaveGState
функция. Сохраняющиеся параметры состояния графики:CTM (текущая матрица преобразования)
область клипа
качество интерполяции изображения
ширина строки
соединение строки
предельный угол стыка
окончание линии
тире строки
плоскость
должен сгладиться
рендеринг намерения
пространство цвета заливки
пространство цвета обводки
цвет заливки
цвет обводки
альфа-значение
шрифт
размер шрифта
межсимвольный интервал
текстовый режим получения
теневые параметры
фаза образца
параметр сглаживания шрифта
режим смешивания
Для восстановления среды получения к ранее сохраненному состоянию можно использовать
CGContextRestoreGState
.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает текущее состояние графики в состояние, последний раз сохраненное.
Объявление
Swift
func CGContextRestoreGState(_
c
: CGContext!)Objective C
void CGContextRestoreGState ( CGContextRef c );
Параметры
c
Графический контекст, состояние которого Вы хотите изменить.
Обсуждение
Кварц удаляет состояние графики, которое является наверху штабеля так, чтобы последний раз сохраненное состояние стало текущим состоянием графики.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает текущий уровень качества интерполяции для графического контекста.
Объявление
Swift
func CGContextGetInterpolationQuality(_
c
: CGContext!) -> CGInterpolationQualityObjective C
CGInterpolationQuality CGContextGetInterpolationQuality ( CGContextRef context );
Параметры
c
Графический контекст для исследования.
Возвращаемое значение
Текущий уровень качества интерполяции.
Обсуждение
Качество интерполяции является параметром состояния графики, обеспечивающим подсказку для уровня качества для использования для интерполяции изображения (например, при масштабировании изображения). Не все контексты поддерживают все уровни качества интерполяции.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает точность изогнутых контуров в графическом контексте.
Объявление
Swift
func CGContextSetFlatness(_
c
: CGContext!, _flatness
: CGFloat)Objective C
void CGContextSetFlatness ( CGContextRef c, CGFloat flatness );
Параметры
c
Графический контекст для изменения.
flatness
Самое большое допустимое расстояние, измеренное в пикселях устройства, между точкой на истинной кривой и точкой на приближенной кривой.
Обсуждение
Эта функция управляет, как представляются точно изогнутые контуры. Установка плоскости оценивает меньше, чем
1.0
представляет очень точные кривые, но удлиняет времена рендеринга.В большинстве случаев Вы не должны изменять значение плоскости. Настройка значения плоскости для возможностей определенного устройства вывода повреждает возможность Вашего приложения представить к другим устройствам.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает уровень качества интерполяции для графического контекста.
Объявление
Swift
func CGContextSetInterpolationQuality(_
c
: CGContext!, _quality
: CGInterpolationQuality)Objective C
void CGContextSetInterpolationQuality ( CGContextRef context, CGInterpolationQuality quality );
Параметры
c
Графический контекст для изменения.
quality
A
CGInterpolationQuality
постоянный, который указывает требуемый уровень качества интерполяции. Для возможных значений посмотрите“CGInterpolationQuality”
.Обсуждение
Качество интерполяции является просто подсказкой к контексту — не, все контексты поддерживают все уровни качества интерполяции.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает стиль для конечных точек линий, проведенных в графическом контексте.
Объявление
Swift
func CGContextSetLineCap(_
c
: CGContext!, _cap
: CGLineCap)Objective C
void CGContextSetLineCap ( CGContextRef c, CGLineCap cap );
Параметры
c
Графический контекст для изменения.
cap
Постоянный стиль окончания линии —
kCGLineCapButt
(значение по умолчанию),kCGLineCapRound
, илиkCGLineCapSquare
. См. ссылку CGPath.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает образец для пунктирных линий в графическом контексте.
Объявление
Swift
func CGContextSetLineDash(_
c
: CGContext!, _phase
: CGFloat, _lengths
: UnsafePointer<CGFloat>, _count
: UInt)Objective C
void CGContextSetLineDash ( CGContextRef c, CGFloat phase, const CGFloat lengths[], size_t count );
Параметры
c
Графический контекст для изменения.
phase
Значение, указывающее, как далеко в пунктирный узор строка запускается в модулях пространства пользователя. Например, передавая значение
3
означает, что линия проведена с пунктирным узором, запускающимся в трех модулях с его начала. Передача значения0
чертит линию начиная с начала пунктирного узора.lengths
Массив значений, указывающих длины нарисованных сегментов и непокрашенных сегментов, соответственно, пунктирного узора — или
NULL
ни для какого пунктирного узора.Например, передавая массив со значениями
[2,3]
устанавливает пунктирный узор, чередующий между 2 пользовательскими модулями пространства долго красившийся сегмент и 3 пользовательскими модулями пространства длинный непокрашенный сегмент. Передача значений[1,3,4,2]
устанавливает образец в 1 модуль нарисованный сегмент, непокрашенный сегмент с 3 модулями, нарисованный сегмент с 4 модулями и непокрашенный сегмент с 2 модулями.count
Если
lengths
параметр указывает массив, передайте число элементов в массиве. Иначе, передача0
.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает стиль для соединений связанных строк в графическом контексте.
Объявление
Swift
func CGContextSetLineJoin(_
c
: CGContext!, _join
: CGLineJoin)Objective C
void CGContextSetLineJoin ( CGContextRef c, CGLineJoin join );
Параметры
c
Графический контекст для изменения.
join
Значение соединения строки —
kCGLineJoinMiter
(значение по умолчанию),kCGLineJoinRound
, илиkCGLineJoinBevel
. См. ссылку CGPath.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает ширину строки для графического контекста.
Объявление
Swift
func CGContextSetLineWidth(_
c
: CGContext!, _width
: CGFloat)Objective C
void CGContextSetLineWidth ( CGContextRef c, CGFloat width );
Параметры
c
Графический контекст для изменения.
width
Ширина новой строки для использования, в модулях пространства пользователя. Значение должно быть больше, чем
0
.Обсуждение
Ширина строки по умолчанию
1
модуль. Когда перечеркиваемый, строка одновременно покупает и продает путь с половиной общей ширины с обеих сторон.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает предельный угол стыка для соединений связанных строк в графическом контексте.
Объявление
Swift
func CGContextSetMiterLimit(_
c
: CGContext!, _limit
: CGFloat)Objective C
void CGContextSetMiterLimit ( CGContextRef c, CGFloat limit );
Параметры
c
Графический контекст для изменения.
limit
Предельный угол стыка для использования.
Обсуждение
Если текущий стиль соединения строки установлен в
kCGLineJoinMiter
(см.CGContextSetLineJoin
), Кварц использует предельный угол стыка, чтобы определить, нужно ли к строкам присоединиться со скосом вместо среза. Кварц делит длину среза шириной строки. Если результат больше, чем предельный угол стыка, Кварц преобразовывает стиль в скос.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает фазу образца контекста.
Объявление
Swift
func CGContextSetPatternPhase(_
c
: CGContext!, _phase
: CGSize)Objective C
void CGContextSetPatternPhase ( CGContextRef context, CGSize phase );
Параметры
c
Графический контекст для изменения.
phase
Фаза образца, указанная в пространстве пользователя.
Обсуждение
Фаза образца является переводом, который Кварц применяет до рисования образца в контексте. Фаза образца является частью состояния графики контекста, и фаза образца по умолчанию
(0,0)
. Установка фазы образца имеет эффект временного изменения матрицы образца любого образца, который Вы рисуете. Например, устанавливая фазу образца контекста в(2,3)
имеет эффект перемещения запуска мозаичного размещения ячейки образца к точке(2,3)
в пространстве пользователя по умолчанию.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает узор заливки в указанном графическом контексте.
Объявление
Swift
func CGContextSetFillPattern(_
c
: CGContext!, _pattern
: CGPattern!, _components
: UnsafePointer<CGFloat>)Objective C
void CGContextSetFillPattern ( CGContextRef context, CGPatternRef pattern, const CGFloat components[] );
Параметры
c
Графический контекст для изменения.
pattern
Узор заливки. Кварц сохраняет этот объект; по возврату можно безопасно выпустить его.
components
Если образец является бесцветным (или маскирование) образец, передайте массив значений интенсивности, указывающих цвет для использования, когда красится образец. Число элементов матрицы должно равняться числу компонентов в основном пространстве цветового пространства узора заливки плюс дополнительный компонент для альфа-значения.
Если образец является цветным образцом, передайте альфа-значение.
Обсуждение
Текущее пространство цвета заливки должно быть цветовым пространством образца. Иначе, результат вызывания этой функции не определен. Если Вы хотите установить цвет заливки, не образец, использовать
CGContextSetFillColorWithColor
.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает намерение рендеринга в текущем состоянии графики.
Объявление
Swift
func CGContextSetRenderingIntent(_
c
: CGContext!, _intent
: CGColorRenderingIntent)Objective C
void CGContextSetRenderingIntent ( CGContextRef context, CGColorRenderingIntent intent );
Параметры
c
Графический контекст для изменения.
intent
Постоянное намерение рендеринга —
kCGRenderingIntentDefault
,kCGRenderingIntentAbsoluteColorimetric
,kCGRenderingIntentRelativeColorimetric
,kCGRenderingIntentPerceptual
, илиkCGRenderingIntentSaturation
. Для обсуждения этих констант посмотрите Ссылку CGColorSpace.Обсуждение
Намерение рендеринга указывает, как Кварц должен обработать цвета, не расположенные в палитре целевого цветового пространства графического контекста. Если Вы явно не устанавливаете намерение рендеринга, Кварц использует перцепционное намерение рендеринга для рисования выбранных изображений и относительного колориметрического намерения рендеринга для всего другого получения.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Наборы, сглаживающиеся на или прочь для графического контекста.
Объявление
Swift
func CGContextSetShouldAntialias(_
c
: CGContext!, _shouldAntialias
: Bool)Objective C
void CGContextSetShouldAntialias ( CGContextRef context, bool shouldAntialias );
Параметры
c
Графический контекст для изменения.
shouldAntialias
Булево значение, указывающее, должно ли быть включено сглаживание. Когда окно или растровый контекст создаются, сглаживание включено по умолчанию. Это выключено для других типов контекстов.
Обсуждение
Сглаживание является параметром состояния графики.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает штриховой образец в указанном графическом контексте.
Объявление
Swift
func CGContextSetStrokePattern(_
c
: CGContext!, _pattern
: CGPattern!, _components
: UnsafePointer<CGFloat>)Objective C
void CGContextSetStrokePattern ( CGContextRef context, CGPatternRef pattern, const CGFloat components[] );
Параметры
c
Графический контекст для изменения.
pattern
Образец для перечеркивания. Кварц сохраняет этот объект; по возврату можно безопасно выпустить его.
components
Если указанный образец является бесцветным (или маскирующий) образец, передайте массив значений интенсивности, указывающих цвет для использования, когда красится образец. Число элементов матрицы должно равняться числу компонентов в основном пространстве штрихового цветового пространства образца плюс дополнительный компонент для альфа-значения.
Если указанный образец является цветным образцом, передайте альфа-значение.
Обсуждение
Текущее пространство цвета обводки должно быть цветовым пространством образца. Иначе, результат вызывания этой функции не определен. Если Вы хотите выбрать цвет обводки, не штриховой образец, использовать
CGContextSetStrokeColorWithColor
.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Наборы, как Кварц составляет демонстрационные значения для графического контекста.
Объявление
Swift
func CGContextSetBlendMode(_
context
: CGContext!, _mode
: CGBlendMode)Objective C
void CGContextSetBlendMode ( CGContextRef context, CGBlendMode mode );
Параметры
context
Графический контекст для изменения.
mode
Режим смешивания. Посмотрите
“CGBlendMode”
для списка констант можно предоставить.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.4 и позже.
-
Наборы, позволить ли сглаживаться для графического контекста.
Объявление
Swift
func CGContextSetAllowsAntialiasing(_
context
: CGContext!, _allowsAntialiasing
: Bool)Objective C
void CGContextSetAllowsAntialiasing ( CGContextRef context, bool allowsAntialiasing );
Параметры
context
Графический контекст.
allowsAntialiasing
Булево значение, указывающее, позволить ли сглаживаться. Передача
true
позволить сглаживаться;false
иначе. Этот параметр не является частью состояния графики.Обсуждение
Кварц выполняет сглаживание для графического контекста если оба
allowsAntialiasing
параметр и параметр состояния графикиshouldAntialias
true
.Этот параметр не является частью состояния графики.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.4 и позже.
-
Наборы, позволить ли сглаживание шрифта для графического контекста.
Объявление
Swift
func CGContextSetAllowsFontSmoothing(_
context
: CGContext!, _allowsFontSmoothing
: Bool)Objective C
void CGContextSetAllowsFontSmoothing ( CGContextRef context, bool allowsFontSmoothing );
Параметры
context
Графический контекст.
allowsFontSmoothing
Булево значение, указывающее, позволяется ли сглаживание шрифта в указанном контексте.
Обсуждение
Шрифт сглаживается, если они сглаживаются, когда нарисовано и если сглаживание шрифта и позволено и включено. Для получения информации о том, как включить сглаживание шрифта, посмотрите
CGContextSetShouldSmoothFonts
функция. Не обычно необходимо внести изменения в оба параметра одновременно; любой может использоваться для отключения сглаживания шрифта.Этот параметр не является частью состояния графики.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.2 и позже.
-
Включает или отключает сглаживание шрифта в графическом контексте.
Объявление
Swift
func CGContextSetShouldSmoothFonts(_
c
: CGContext!, _shouldSmoothFonts
: Bool)Objective C
void CGContextSetShouldSmoothFonts ( CGContextRef context, bool shouldSmoothFonts );
Параметры
c
Графический контекст для изменения.
shouldSmoothFonts
Булево значение, указывающее, разрешить ли сглаживание шрифта.
Обсуждение
Когда сглаживание шрифта не является надлежащим и должно быть отключено, существуют случаи, такие как рендеринг к битовому массиву. Обратите внимание на то, что некоторые контексты (такие как контексты PostScript) не поддерживают сглаживание шрифта.
Этот параметр является частью состояния графики. Когда Вы хотите временно переопределить эту установку в методе рисования, из-за этого Вы используете это.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.2 и позже.
-
Наборы, позволить ли субпиксельное расположение для графического контекста
Объявление
Swift
func CGContextSetAllowsFontSubpixelPositioning(_
context
: CGContext!, _allowsFontSubpixelPositioning
: Bool)Objective C
void CGContextSetAllowsFontSubpixelPositioning ( CGContextRef context, bool allowsFontSubpixelPositioning );
Параметры
context
Графический контекст.
allowsFontSubpixelPositioning
Булево значение, указывающее, позволяется ли субпиксельное расположение глифов в указанном контексте.
Обсуждение
Субпиксельное расположение используется графическим контекстом, если это позволено, включено, и если сам шрифт сглаживается, когда нарисовано. Для получения информации о том, как включить субпиксельное расположение, посмотрите
CGContextSetShouldSubpixelPositionFonts
функция.Этот параметр не является частью состояния графики.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.5 и позже.
-
Включает или отключает субпиксельное расположение в графический контекст.
Объявление
Swift
func CGContextSetShouldSubpixelPositionFonts(_
context
: CGContext!, _shouldSubpixelPositionFonts
: Bool)Objective C
void CGContextSetShouldSubpixelPositionFonts ( CGContextRef context, bool shouldSubpixelPositionFonts );
Параметры
context
Графический контекст.
shouldSubpixelPositionFonts
Булево значение, указывающее, разрешить ли субпиксельное расположение.
Обсуждение
Когда включено, графический контекст может расположить глифы на неинтегральные границы пикселей. Когда отключено, позиция глифов всегда вызываются к интегральным границам пикселей.
Этот параметр является частью состояния графики.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.5 и позже.
-
Наборы, позволить ли субпиксельное квантование для графического контекста
Объявление
Swift
func CGContextSetAllowsFontSubpixelQuantization(_
context
: CGContext!, _allowsFontSubpixelQuantization
: Bool)Objective C
void CGContextSetAllowsFontSubpixelQuantization ( CGContextRef context, bool allowsFontSubpixelQuantization );
Параметры
context
Графический контекст.
allowsFontSubpixelQuantization
Булево значение, указывающее, позволяется ли субпиксельное квантование глифов в указанном контексте.
Обсуждение
Субпиксельное квантование используется графическим контекстом, если бы это позволено, включено, и если глифы были бы нарисованы в субпиксельных позициях. Для получения информации о том, как включить субпиксельное квантование, посмотрите
CGContextSetShouldSubpixelQuantizeFonts
функция.Этот параметр не является частью состояния графики.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.5 и позже.
-
Включает или отключает субпиксельное квантование в графическом контексте.
Объявление
Swift
func CGContextSetShouldSubpixelQuantizeFonts(_
context
: CGContext!, _shouldSubpixelQuantizeFonts
: Bool)Objective C
void CGContextSetShouldSubpixelQuantizeFonts ( CGContextRef context, bool shouldSubpixelQuantizeFonts );
Параметры
context
Графический контекст.
shouldSubpixelQuantizeFonts
Булево значение, указывающее, разрешить ли субпиксельное квантование.
Обсуждение
Когда включено, графический контекст может квантовать субпиксельные позиции глифов.
Этот параметр является частью состояния графики.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.5 и позже.
Эти функции используются для определения геометрии текущего пути. Для получения дополнительной информации о том, как пути определяются, видят Ссылку CGPath.
-
Добавляет дуга круга к текущему пути, которому возможно предшествует сегмент прямой линии
Объявление
Swift
func CGContextAddArc(_
c
: CGContext!, _x
: CGFloat, _y
: CGFloat, _radius
: CGFloat, _startAngle
: CGFloat, _endAngle
: CGFloat, _clockwise
: Int32)Параметры
c
Графический контекст.
x
X-значение, в координатах пространства пользователя, для центра дуги.
y
Y-значение, в координатах пространства пользователя, для центра дуги.
radius
Радиус дуги, в координатах пространства пользователя.
startAngle
Угол к начальной точке дуги, измеренной в радианах от положительной оси X.
endAngle
Угол до конца точка дуги, измеренной в радианах от положительной оси X.
clockwise
Указать
1
для создания по часовой стрелке образуют дугу или0
для создания против часовой стрелки образуют дугу.Обсуждение
Дуга является сегментом круга с радиусом r центрируемый в точке
(x,y)
. Когда Вы вызываете эту функцию, Вы обеспечиваете центральную точку, радиус и два угла в радианах. Кварц использует эту информацию для определения конечных точек дуги, и затем приближает новую дугу с помощью последовательности кубических кривых Bézier.clockwise
параметр определяет направление, в котором создается дуга; фактическое направление заключительного пути зависит от текущей матрицы преобразования графического контекста. Например, на iOS, aUIView
зеркально отражает Y-координату путем масштабирования значений Y-1
. В зеркально отраженной системе координат указывая по часовой стрелке результаты дуги в против часовой стрелки дуге после того, как применяется трансформация.Если текущий путь уже содержит подпуть, Кварц добавляет строку, подключающую текущую точку к начальной точке дуги. Если текущий путь пуст, Кварц создает новый новый подпуть с набором начальной точки к начальной точке дуги.
Конечная точка дуги становится новой текущей точкой пути.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Добавляет дуга круга к текущему пути, с помощью точек касательной и радиуса.
Объявление
Swift
func CGContextAddArcToPoint(_
c
: CGContext!, _x1
: CGFloat, _y1
: CGFloat, _x2
: CGFloat, _y2
: CGFloat, _radius
: CGFloat)Параметры
c
Графический контекст, текущий путь которого не пуст.
x1
X-значение, в координатах пространства пользователя, для конечной точки первой строки касательной. Первая линия касательной проведена от текущей точки до (x1, y1).
y1
Y-значение, в координатах пространства пользователя, для конечной точки первой строки касательной. Первая линия касательной проведена от текущей точки до (x1, y1).
x2
X-значение, в координатах пространства пользователя, для конечной точки второй строки касательной. Вторая линия касательной проведена от (x1, y1) к (x2, y2).
y2
Y-значение, в координатах пространства пользователя, для конечной точки второй строки касательной. Вторая линия касательной проведена от (x1, y1) к (x2, y2).
radius
Радиус дуги, в координатах пространства пользователя.
Обсуждение
Эта функция использует последовательность кубических кривых Bézier для создания дуги, которая является касательной к строке от текущей точки до (x1, y1) и к строке от (x1, y1) к (x2, y2). Запуск и конечные точки дуги расположены на первых и вторых строках касательной, соответственно. Запуск и конечные точки дуги являются также “точками касательной” строк.
Если текущая точка и первая точка касательной дуги (начальная точка) не равны, Кварц добавляет сегмент прямой линии от текущей точки до первой точки касательной.
Конечная точка дуги становится новой текущей точкой пути.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Добавляет кубическую кривую Bézier от текущей точки, с помощью предоставленных контрольных точек и конечной точки.
Объявление
Swift
func CGContextAddCurveToPoint(_
c
: CGContext!, _cp1x
: CGFloat, _cp1y
: CGFloat, _cp2x
: CGFloat, _cp2y
: CGFloat, _x
: CGFloat, _y
: CGFloat)Параметры
c
Графический контекст, текущий путь которого не пуст.
cp1x
X-значение, в координатах пространства пользователя, для первой контрольной точки кривой.
cp1y
Y-значение, в координатах пространства пользователя, для первой контрольной точки кривой.
cp2x
X-значение, в координатах пространства пользователя, для второй контрольной точки кривой.
cp2y
Y-значение, в координатах пространства пользователя, для второй контрольной точки кривой.
x
X-значение, в координатах пространства пользователя, в которых можно закончить кривую.
y
Y-значение, в координатах пространства пользователя, в которых можно закончить кривую.
Обсуждение
Эта функция добавляет кубическую кривую к текущему пути. По возврату текущая точка установлена до конца точка того сегмента.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Добавляет последовательность связанных прямолинейных сегментов к текущему пути.
Объявление
Swift
func CGContextAddLines(_
c
: CGContext!, _points
: UnsafePointer<CGPoint>, _count
: UInt)Objective C
void CGContextAddLines ( CGContextRef c, const CGPoint points[], size_t count );
Параметры
c
Графический контекст.
points
Массив значений, указывающих запуск и конечные точки линейных сегментов для рисования. Каждая точка в массиве указывает позицию в пространстве пользователя. Первая точка в массиве указывает начальную начальную точку.
count
Число элементов в
points
массив.Обсуждение
Это - функция удобства, добавляющая последовательность связанных линейных сегментов к пути, с помощью следующей работы:
CGContextMoveToPoint (c, points[0].x, points[0].y);
for (k = 1; k < count; k++) {
CGContextAddLineToPoint (c, points[k].x, points[k].y);
}
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Добавляет сегмент прямой линии от текущей точки до предоставленной точки.
Объявление
Swift
func CGContextAddLineToPoint(_
c
: CGContext!, _x
: CGFloat, _y
: CGFloat)Objective C
void CGContextAddLineToPoint ( CGContextRef c, CGFloat x, CGFloat y );
Параметры
c
Графический контекст, текущий путь которого не пуст.
x
X-значение, в координатах пространства пользователя, для конца линейного сегмента.
y
Y-значение, в координатах пространства пользователя, для конца линейного сегмента.
Обсуждение
После добавления линейного сегмента текущая точка установлена в конечную точку линейного сегмента.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Добавляет ранее создаваемый Кварцевый объект контуров к текущему пути в графическом контексте.
Объявление
Swift
func CGContextAddPath(_
context
: CGContext!, _path
: CGPath!)Objective C
void CGContextAddPath ( CGContextRef context, CGPathRef path );
Параметры
context
Графический контекст.
path
Ранее создаваемый Кварцевый объект контуров. См. Ссылку CGPath.
Обсуждение
Если исходный путь непуст, то его элементы пути добавляются в порядке на текущий путь. Кварц применяет текущую матрицу преобразования (CTM) к точкам прежде, чем добавить их к пути.
После того, как вызов завершается, стартовая точка и текущая точка пути являются теми из последнего подпути в
path
.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.2 и позже.
-
Возвращает Кварцевый объект контуров, созданный из текущей информации о пути в графическом контексте.
Объявление
Swift
func CGContextCopyPath(_
context
: CGContext!) -> CGPath!Objective C
CGPathRef CGContextCopyPath ( CGContextRef context );
Параметры
context
Графический контекст, текущий путь которого не пуст.
Возвращаемое значение
Кварцевый объект контуров, содержащий текущие данные пути.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.2 и позже.
-
Добавляет квадратичную кривую Bézier от текущей точки, с помощью контрольной точки и конечной точки, которую Вы указываете.
Объявление
Swift
func CGContextAddQuadCurveToPoint(_
c
: CGContext!, _cpx
: CGFloat, _cpy
: CGFloat, _x
: CGFloat, _y
: CGFloat)Objective C
void CGContextAddQuadCurveToPoint ( CGContextRef c, CGFloat cpx, CGFloat cpy, CGFloat x, CGFloat y );
Параметры
c
Графический контекст, текущий путь которого не пуст.
cpx
X-координата пространства пользователя для контрольной точки кривой.
cpy
Y-координата пространства пользователя для контрольной точки кривой.
x
X-координата пространства пользователя, в котором можно закончить кривую.
y
Y-координата пространства пользователя, в котором можно закончить кривую.
Обсуждение
Эта функция добавляет квадратичную кривую к текущему подпути. После добавления сегмента текущая точка установлена до конца точка кривой.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Добавляет прямоугольный контур к текущему пути.
Объявление
Swift
func CGContextAddRect(_
c
: CGContext!, _rect
: CGRect)Objective C
void CGContextAddRect ( CGContextRef c, CGRect rect );
Параметры
c
Графический контекст.
rect
Прямоугольник, указанный в координатах пространства пользователя.
Обсуждение
Это - функция удобства, добавляющая прямоугольник к пути, с помощью следующей последовательности операций:
// start at origin
CGContextMoveToPoint (c, CGRectGetMinX(rect), CGRectGetMinY(rect));
// add bottom edge
CGContextAddLineToPoint (c, CGRectGetMaxX(rect), CGRectGetMinY(rect));
// add right edge
CGContextAddLineToPoint (c, CGRectGetMaxX(rect), CGRectGetMaxY(rect);
// add top edge
CGContextAddLineToPoint (c, CGRectGetMinX(rect), CGRectGetMaxY(rect));
// add left edge and close
CGContextClosePath (c);
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Добавляет набор прямоугольные контуры к текущему пути.
Объявление
Swift
func CGContextAddRects(_
c
: CGContext!, _rects
: UnsafePointer<CGRect>, _count
: UInt)Objective C
void CGContextAddRects ( CGContextRef c, const CGRect rects[], size_t count );
Параметры
c
Графический контекст.
rects
Массив прямоугольников, указанных в координатах пространства пользователя.
count
Число прямоугольников в
rects
массив.Обсуждение
Это - функция удобства, добавляющая массив прямоугольников к пути, с помощью следующей работы:
for (k = 0; k < count; k++) {
CGContextAddRect (c, m, rects[k]);
}
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Создает новый пустой путь в графическом контексте.
Объявление
Swift
func CGContextBeginPath(_
c
: CGContext!)Objective C
void CGContextBeginPath ( CGContextRef c );
Параметры
c
Графический контекст.
Обсуждение
Графический контекст может иметь только единственный путь в использовании в любое время. Если указанный контекст уже содержит текущий путь, когда Вы вызываете эту функцию, Кварц отбрасывает старый путь и любые данные, связанные с ним.
Текущий путь не является частью состояния графики. Следовательно, сохранение и восстановление состояния графики не имеют никакого эффекта на текущий путь.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Завершения и завершают подпуть текущего пути.
Объявление
Swift
func CGContextClosePath(_
c
: CGContext!)Objective C
void CGContextClosePath ( CGContextRef c );
Параметры
c
Графический контекст.
Обсуждение
Добавляет строку от текущей точки до начальной точки текущего подпути и заканчивает подпуть.
После закрытия подпути Ваше приложение может начать новый подпуть без первого вызова
CGContextMoveToPoint
. В этом случае новый подпуть неявно создается с начальной и текущей точкой, равной начальной точке предыдущего подпути.Если текущий путь пуст, или текущий подпуть уже закрывается, эта функция ничего не делает.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Начинает новый подпуть в точке, которую Вы указываете.
Объявление
Swift
func CGContextMoveToPoint(_
c
: CGContext!, _x
: CGFloat, _y
: CGFloat)Objective C
void CGContextMoveToPoint ( CGContextRef c, CGFloat x, CGFloat y );
Параметры
c
Графический контекст.
x
X-значение, в координатах пространства пользователя, для точки.
y
Y-значение, в координатах пространства пользователя, для точки.
Обсуждение
Эта точка, которую Вы указываете, становится стартовой точкой нового подпути. Текущая точка установлена в эту стартовую точку.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Добавляет эллипс, соответствующий в указанном прямоугольнике.
Объявление
Swift
func CGContextAddEllipseInRect(_
context
: CGContext!, _rect
: CGRect)Objective C
void CGContextAddEllipseInRect ( CGContextRef context, CGRect rect );
Параметры
context
Графический контекст.
rect
Прямоугольник, определяющий область для эллипса для вписываний.
Обсуждение
Эллипс приближен последовательностью кривых Bézier. Его центр является средней точкой прямоугольника, определенного
rect
параметр. Если прямоугольник является квадратным, то эллипс является проспектом с радиусом, равным половине ширины (или высота) прямоугольника. Еслиrect
параметр указывает прямоугольную форму, тогда главные и незначительные оси эллипса определяются шириной и высотой прямоугольника.Эллипс формирует полный подпуть пути — т.е. получение эллипса запускается с перемещения - к работе и заканчивается работой подпути завершения всеми перемещениями, ориентированными в направлении по часовой стрелке.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.4 и позже.
Эти функции используются, чтобы перечеркнуть вперед или заполнить текущий путь.
-
Красит прозрачный прямоугольник.
Объявление
Swift
func CGContextClearRect(_
c
: CGContext!, _rect
: CGRect)Objective C
void CGContextClearRect ( CGContextRef c, CGRect rect );
Параметры
c
Графический контекст, в котором можно нарисовать прямоугольник.
rect
Прямоугольник, в координатах пространства пользователя.
Обсуждение
Если предоставленный контекст является окном или растровым контекстом, Кварц эффективно очищает прямоугольник. Для других типов контекста Кварц заполняет прямоугольник зависящим от устройств способом. Однако Вы не должны использовать эту функцию в контекстах кроме окна или растровых контекстах.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Рисует текущий путь с помощью предоставленного режима получения.
Объявление
Swift
func CGContextDrawPath(_
c
: CGContext!, _mode
: CGPathDrawingMode)Objective C
void CGContextDrawPath ( CGContextRef c, CGPathDrawingMode mode );
Параметры
c
Графический контекст, содержащий путь к краске.
mode
Постоянный режим рисования пути —
kCGPathFill
,kCGPathEOFill
,kCGPathStroke
,kCGPathFillStroke
, илиkCGPathEOFillStroke
. Для обсуждения этих констант см. Ссылку CGPath.Обсуждение
Поскольку побочный эффект, когда Вы вызываете эту функцию, Кварц, очищает текущий путь.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Красит область в текущем пути, с помощью ровно-нечетного правила заливки.
Объявление
Swift
func CGContextEOFillPath(_
c
: CGContext!)Objective C
void CGContextEOFillPath ( CGContextRef c );
Параметры
c
Графический контекст, содержащий путь к заливке.
Обсуждение
Кварц обрабатывает каждый подпуть, как будто это было закрыто путем вызова
CGContextClosePath
. Ровно-нечетное правило описано в Заполнении Пути в Кварце 2D Руководство по программированию. Поскольку побочный эффект, когда Вы вызываете эту функцию, Кварц, очищает текущий путь.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Красит область в текущем пути, с помощью ненулевого вьющегося правила числа.
Объявление
Swift
func CGContextFillPath(_
c
: CGContext!)Objective C
void CGContextFillPath ( CGContextRef c );
Параметры
c
Графический контекст, содержащий путь к заливке.
Обсуждение
Кварц обрабатывает каждый подпуть, как будто это было закрыто путем вызова
CGContextClosePath
. Ненулевое вьющееся правило числа описано в Заполнении Пути в Кварце 2D Руководство по программированию. Поскольку побочный эффект, когда Вы вызываете эту функцию, Кварц, очищает текущий путь.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Красит область содержавшей в предоставленном прямоугольнике, с помощью цвета заливки в текущем состоянии графики.
Объявление
Swift
func CGContextFillRect(_
c
: CGContext!, _rect
: CGRect)Objective C
void CGContextFillRect ( CGContextRef c, CGRect rect );
Параметры
c
Графический контекст.
rect
Прямоугольник, в координатах пространства пользователя.
Обсуждение
Поскольку побочный эффект, когда Вы вызываете эту функцию, Кварц, очищает текущий путь.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Красит области содержавшими в предоставленных прямоугольниках, с помощью цвета заливки в текущем состоянии графики.
Объявление
Swift
func CGContextFillRects(_
c
: CGContext!, _rects
: UnsafePointer<CGRect>, _count
: UInt)Objective C
void CGContextFillRects ( CGContextRef c, const CGRect rects[], size_t count );
Параметры
c
Графический контекст.
rects
Массив прямоугольников, в координатах пространства пользователя.
count
Прямоугольники числа в
rects
массив.Обсуждение
Поскольку побочный эффект, когда Вы вызываете эту функцию, Кварц, очищает текущий путь.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Красит область эллипса, соответствующего в предоставленном прямоугольнике, с помощью цвета заливки в текущем состоянии графики.
Объявление
Swift
func CGContextFillEllipseInRect(_
context
: CGContext!, _rect
: CGRect)Objective C
void CGContextFillEllipseInRect ( CGContextRef context, CGRect rect );
Параметры
context
Графический контекст.
rect
Прямоугольник, определяющий область для эллипса для вписываний.
Обсуждение
Поскольку побочный эффект, когда Вы вызываете эту функцию, Кварц, очищает текущий путь.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.4 и позже.
-
Красит строку вдоль текущего пути.
Объявление
Swift
func CGContextStrokePath(_
c
: CGContext!)Objective C
void CGContextStrokePath ( CGContextRef c );
Параметры
c
Графический контекст.
Обсуждение
Кварц использует ширину строки и цвет обводки состояния графики для рисования пути. Поскольку побочный эффект, когда Вы вызываете эту функцию, Кварц, очищает текущий путь.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Красит прямоугольный контур.
Объявление
Swift
func CGContextStrokeRect(_
c
: CGContext!, _rect
: CGRect)Objective C
void CGContextStrokeRect ( CGContextRef c, CGRect rect );
Параметры
c
Графический контекст.
rect
Прямоугольник, указанный в координатах пространства пользователя.
Обсуждение
Кварц использует ширину строки и цвет обводки состояния графики для рисования пути. Поскольку побочный эффект, когда Вы вызываете эту функцию, Кварц, очищает текущий путь.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Красит прямоугольный контур, с помощью указанной ширины строки.
Объявление
Swift
func CGContextStrokeRectWithWidth(_
c
: CGContext!, _rect
: CGRect, _width
: CGFloat)Objective C
void CGContextStrokeRectWithWidth ( CGContextRef c, CGRect rect, CGFloat width );
Параметры
c
Графический контекст.
rect
Прямоугольник, в координатах пространства пользователя.
width
Значение, в модулях пространства пользователя, который больше, чем нуль. Это значение не влияет на значения ширины строки в текущем состоянии графики.
Обсуждение
Кроме значения ширины строки, Кварц использует текущие атрибуты состояния графики (такие как цвет обводки) для рисования строки. Строка одновременно покупает и продает путь с половиной общей ширины с обеих сторон.
Поскольку побочный эффект, когда Вы вызываете эту функцию, Кварц, очищает текущий путь.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Заменяет путь в графическом контексте с перечеркиваемой версией пути.
Объявление
Swift
func CGContextReplacePathWithStrokedPath(_
c
: CGContext!)Objective C
void CGContextReplacePathWithStrokedPath ( CGContextRef c );
Параметры
c
Графический контекст.
Обсуждение
Кварц создает перечеркиваемый путь с помощью параметров текущего графического контекста. Новый путь создается так, чтобы заполнение его нарисовало те же пиксели как перечеркивание первоначального тракта. Можно использовать этот путь таким же образом, Вы используете путь любого контекста. Например, можно отсечь к перечеркиваемой версии пути путем вызывания этой функции, сопровождаемой вызовом к функции
CGContextClip
.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.4 и позже.
-
Перечеркивает эллипс, соответствующий в указанном прямоугольнике.
Объявление
Swift
func CGContextStrokeEllipseInRect(_
context
: CGContext!, _rect
: CGRect)Objective C
void CGContextStrokeEllipseInRect ( CGContextRef context, CGRect rect );
Параметры
context
Графический контекст.
rect
Прямоугольник, определяющий область для эллипса для вписываний.
Обсуждение
Поскольку побочный эффект, когда Вы вызываете эту функцию, Кварц, очищает текущий путь.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.4 и позже.
-
Перечеркивает последовательность линейных сегментов.
Объявление
Swift
func CGContextStrokeLineSegments(_
c
: CGContext!, _points
: UnsafePointer<CGPoint>, _count
: UInt)Objective C
void CGContextStrokeLineSegments ( CGContextRef c, const CGPoint points[], size_t count );
Параметры
c
Графический контекст.
points
Массив точек, организованных как пары — начальная точка линейного сегмента, сопровождаемого конечной точкой линейного сегмента. Например, первая точка в массиве указывает стартовую позицию первой строки, вторая точка указывает конечную позицию первой строки, третья точка указывает стартовую позицию второй строки и т.д.
count
Число очков в
points
массив.Обсуждение
Эта функция эквивалентна следующему коду:
CGContextBeginPath (context);
for (k = 0; k < count; k += 2) {
CGContextMoveToPoint(context, s[k].x, s[k].y);
CGContextAddLineToPoint(context, s[k+1].x, s[k+1].y);
}
CGContextStrokePath(context);
Поскольку побочный эффект, когда Вы вызываете эту функцию, Кварц, очищает текущий путь.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.4 и позже.
-
Указывает, содержит ли текущий путь какие-либо подпути.
Объявление
Swift
func CGContextIsPathEmpty(_
c
: CGContext!) -> BoolObjective C
bool CGContextIsPathEmpty ( CGContextRef context );
Параметры
c
Графический контекст, содержащий путь для исследования.
Возвращаемое значение
Возвраты
1
если путь контекста не содержит подпутей, иначе возвраты0
.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает текущую точку по непустому пути.
Объявление
Swift
func CGContextGetPathCurrentPoint(_
c
: CGContext!) -> CGPointObjective C
CGPoint CGContextGetPathCurrentPoint ( CGContextRef context );
Параметры
c
Графический контекст, содержащий путь для исследования.
Возвращаемое значение
A
CGPoint
значение, указывающее расположение, в пространстве пользователя, текущей точки по пути контекста. Если нет никакого пути, функциональных возвратовCGPointZero
.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает наименьший прямоугольник, содержащий текущий путь.
Объявление
Swift
func CGContextGetPathBoundingBox(_
c
: CGContext!) -> CGRectObjective C
CGRect CGContextGetPathBoundingBox ( CGContextRef context );
Параметры
c
Графический контекст, содержа путь, для исследования.
Возвращаемое значение
A
CGRect
значение, указывающее размерности и расположение, в пространстве пользователя, ограничительной рамки пути. Если нет никакого пути, функциональных возвратовCGRectNull
.Обсуждение
Ограничительная рамка является наименьшим прямоугольником, полностью включающим все точки в путь, включая контрольные точки для Bézier кубические и квадратичные кривые.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Проверки, чтобы видеть, содержится ли указанная точка в текущем пути.
Объявление
Swift
func CGContextPathContainsPoint(_
context
: CGContext!, _point
: CGPoint, _mode
: CGPathDrawingMode) -> BoolObjective C
bool CGContextPathContainsPoint ( CGContextRef context, CGPoint point, CGPathDrawingMode mode );
Параметры
context
Графический контекст.
point
Точка для проверки, указанный в модулях пространства пользователя.
mode
Режим рисования пути —
kCGPathFill
,kCGPathEOFill
,kCGPathStroke
,kCGPathFillStroke
, илиkCGPathEOFillStroke
. См. ссылку CGPath.Возвращаемое значение
Возвраты
true
еслиpoint
в текущем пути графического контекста;false
иначе.Обсуждение
Точка содержится в пути графического контекста, если точка в нарисованной области, когда путь перечеркивается или заполняется непрозрачными цветами с помощью указанного режима рисования пути. Точка может быть в пути, только если путь явно закрывается путем вызывания функции
CGContextClosePath
, для путей, нарисованных непосредственно к текущему контексту, илиCGPathCloseSubpath
, для путей, сначала создаваемых какCGPath
объекты и затем нарисованный к текущему контексту.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.4 и позже.
-
Изменяет текущую траекторию отсечения, с помощью ненулевого вьющегося правила числа.
Объявление
Swift
func CGContextClip(_
c
: CGContext!)Objective C
void CGContextClip ( CGContextRef c );
Параметры
c
Графический контекст, содержащий путь. Если контекст не имеет текущего пути, функция ничего не делает.
Обсуждение
Функция использует ненулевое вьющееся правило числа вычислить пересечение текущего пути с текущей траекторией отсечения. Кварц тогда использует путь, следующий из пересечения как новая текущая траектория отсечения для последующих операций рисования.
Если текущий путь включает какие-либо открытые подпути, Кварц обрабатывает их, как будто они были закрыты путем вызова
CGContextClosePath
.В отличие от текущего пути, текущая траектория отсечения является частью состояния графики. Поэтому, чтобы повторно увеличить paintable область путем восстановления траектории отсечения к предшествующему состоянию, необходимо сохранить состояние графики, прежде чем Вы отсечете и восстановите состояние графики после завершения любого отсеченного получения.
После определения новой траектории отсечения функция сбрасывает текущий путь контекста к пустому пути.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Изменяет текущую траекторию отсечения, с помощью ровно-нечетного правила.
Объявление
Swift
func CGContextEOClip(_
c
: CGContext!)Objective C
void CGContextEOClip ( CGContextRef c );
Параметры
c
Графический контекст, содержащий путь. Если контекст не имеет текущего пути, функция ничего не делает.
Обсуждение
Функция использует ровно-нечетное правило вычислить пересечение текущего пути с текущей траекторией отсечения. Кварц тогда использует путь, следующий из пересечения как новая текущая траектория отсечения для последующих операций рисования.
Если текущий путь включает какие-либо открытые подпути, Кварц обрабатывает их, как будто они были закрыты путем вызова
CGContextClosePath
.В отличие от текущего пути, текущая траектория отсечения является частью состояния графики. Поэтому, чтобы повторно увеличить paintable область путем восстановления траектории отсечения к предшествующему состоянию, необходимо сохранить состояние графики, прежде чем Вы отсечете и восстановите состояние графики после завершения любого отсеченного получения.
После определения новой траектории отсечения функция сбрасывает текущий путь контекста к пустому пути.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает траекторию отсечения в пересечение текущей траектории отсечения с областью, определенной указанным прямоугольником.
Объявление
Swift
func CGContextClipToRect(_
c
: CGContext!, _rect
: CGRect)Objective C
void CGContextClipToRect ( CGContextRef c, CGRect rect );
Параметры
c
Графический контекст, для которого можно установить траекторию отсечения.
rect
A
CGRect
значение, указывающее, в пространстве пользователя, расположении и размерностях прямоугольника, который будет использоваться в определении новой траектории отсечения.Обсуждение
Эта функция устанавливает область отсечения указанного графического контекста в область, пересекающую и текущую траекторию отсечения и указанный прямоугольник.
После определения новой траектории отсечения,
CGContextClipToRect
функционируйте сбрасывает текущий путь контекста к пустому пути.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает траекторию отсечения в пересечение текущей траектории отсечения с областью, определенной массивом прямоугольников.
Объявление
Swift
func CGContextClipToRects(_
c
: CGContext!, _rects
: UnsafePointer<CGRect>, _count
: UInt)Objective C
void CGContextClipToRects ( CGContextRef c, const CGRect rects[], size_t count );
Параметры
c
Графический контекст, для которого можно установить траекторию отсечения.
rects
Массив прямоугольников. Расположения и размерности прямоугольников указаны в системе координат пространства пользователя.
count
Общее количество записей массива в
rects
параметр.Обсуждение
Эта функция устанавливает траекторию отсечения в пересечение текущей траектории отсечения и области в указанных прямоугольниках.
После определения новой траектории отсечения функция сбрасывает текущий путь контекста к пустому пути.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает ограничительную рамку траектории отсечения.
Объявление
Swift
func CGContextGetClipBoundingBox(_
c
: CGContext!) -> CGRectObjective C
CGRect CGContextGetClipBoundingBox ( CGContextRef c );
Параметры
c
Графический контекст для изменения.
Возвращаемое значение
Ограничительная рамка траектории отсечения, указанной в пространстве пользователя.
Обсуждение
Ограничительная рамка является наименьшим прямоугольником, полностью включающим все точки в траекторию отсечения, включая контрольные точки для любых Кривых Безье по пути.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.3 и позже.
-
Отображает маску в указанный прямоугольник и пересекает его с текущей областью отсечения графического контекста.
Объявление
Swift
func CGContextClipToMask(_
c
: CGContext!, _rect
: CGRect, _mask
: CGImage!)Objective C
void CGContextClipToMask ( CGContextRef c, CGRect rect, CGImageRef mask );
Параметры
c
Графический контекст.
rect
Прямоугольник для отображения
mask
параметр к.mask
Изображение или маска изображения. Если
mask
изображение, тогда это должно быть в цветовом пространстве DeviceGray, может не иметь альфа-компонента и не может быть замаскировано маской изображения или маскирующий цвет.Обсуждение
Если
mask
параметр является маской изображения, затем Кварцевые клипы способом, идентичным поведению, замеченному с функциейCGContextDrawImage
— маска указывает область, которая будет оставлена без изменений при рисовании. Исходные выборки маски изображения определяют, какие точки области отсечения изменяются, действуя как «обратная альфа» значение. Если значение исходной выборки в маске изображенияS
, тогда соответствующая точка в текущей области отсечения умножается на альфа-значение (1–S
). Например, еслиS
1
тогда точка в области отсечения становится прозрачной. ЕслиS
0
, точка в области отсечения неизменна.Если
mask
параметр является изображением, тогдаmask
действия как альфа-маска и смешиваются с текущей областью отсечения. Исходные выборки маски определяют, какие точки области отсечения изменяются. Если значение исходной выборки в маскеS
, тогда соответствующая точка в текущей области отсечения умножается на альфуS
. Например, еслиS
0
, тогда точка в области отсечения становится прозрачной. ЕслиS
1
, точка в области отсечения неизменна.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.4 и позже.
-
Устанавливает уровень непрозрачности для объектов, нарисованных в графическом контексте.
Объявление
Swift
func CGContextSetAlpha(_
c
: CGContext!, _alpha
: CGFloat)Objective C
void CGContextSetAlpha ( CGContextRef c, CGFloat alpha );
Параметры
c
Графический контекст, для которого можно установить альфа-параметр, передаваемый по значению текущего состояния графики.
alpha
Значение, указывающее уровень непрозрачности. Значения могут расположиться от
0.0
(очевидный) для1.0
(непрозрачный). Значения вне этого диапазона отсекаются к0.0
или1.0
.Обсуждение
Эта функция устанавливает альфа-параметр, передаваемый по значению для указанного графического контекста. Для очистки содержания холста получения использовать
CGContextClearRect
.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает текущий цвет заливки в значение в цветовом пространстве DeviceCMYK.
Объявление
Swift
func CGContextSetCMYKFillColor(_
c
: CGContext!, _cyan
: CGFloat, _magenta
: CGFloat, _yellow
: CGFloat, _black
: CGFloat, _alpha
: CGFloat)Параметры
c
Графический контекст, для которого можно установить текущий цвет заливки.
cyan
Голубая интенсивность оценивает за цвет для установки. Цветовое пространство DeviceCMYK разрешает спецификацию значения в пределах от 0,0 (не поглощает дополнительный цвет) к 1,0 (полностью поглощает дополнительный цвет).
magenta
Пурпурная интенсивность оценивает за цвет для установки. Цветовое пространство DeviceCMYK разрешает спецификацию значения в пределах от 0,0 (не поглощает дополнительный цвет) к 1,0 (полностью поглощает дополнительный цвет).
yellow
Желтая интенсивность оценивает за цвет для установки. Цветовое пространство DeviceCMYK разрешает спецификацию значения в пределах от 0,0 (не поглощает дополнительный цвет) к 1,0 (полностью поглощает дополнительный цвет).
black
Черная интенсивность оценивает за цвет для установки. Цветовое пространство DeviceCMYK разрешает спецификацию значения в пределах от 0,0 (не поглощает дополнительный цвет) к 1,0 (полностью поглощает дополнительный цвет).
alpha
Значение, указывающее уровень непрозрачности. Значения могут расположиться от
0.0
(очевидный) для1.0
(непрозрачный). Значения вне этого диапазона отсекаются к0.0
или1.0
.Обсуждение
Кварц обеспечивает функции удобства для каждого из цветовых пространств устройства, позволяющих Вам устанавливать пространство цвета заливки или цвета обводки и цвет заливки или цвет обводки с одним вызовом функции.
Когда Вы вызываете эту функцию, две вещи происходят:
Кварц устанавливает текущее пространство цвета заливки в DeviceCMYK.
Кварц устанавливает текущий цвет заливки в значение, указанное
cyan
,magenta
,yellow
,black
, иalpha
параметры.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает текущий цвет заливки.
Объявление
Swift
func CGContextSetFillColor(_
c
: CGContext!, _components
: UnsafePointer<CGFloat>)Objective C
void CGContextSetFillColor ( CGContextRef context, const CGFloat components[] );
Параметры
c
Графический контекст, для которого можно установить текущий цвет заливки.
components
Массив интенсивности оценивает описание цвета для установки. Число элементов матрицы должно равняться числу компонентов в текущем пространстве цвета заливки плюс дополнительный компонент для альфа-значения.
Обсуждение
Текущее пространство цвета заливки не должно быть цветовым пространством образца. Для получения информации об установке цвета заливки при использовании цветового пространства образца посмотрите
CGContextSetFillPattern
. Обратите внимание на то, что предпочтительный API для использования теперьCGContextSetFillColorWithColor
.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Выбирает текущий цвет обводки к значению в цветовом пространстве DeviceCMYK.
Объявление
Swift
func CGContextSetCMYKStrokeColor(_
c
: CGContext!, _cyan
: CGFloat, _magenta
: CGFloat, _yellow
: CGFloat, _black
: CGFloat, _alpha
: CGFloat)Параметры
c
Графический контекст, для которого можно выбрать текущий цвет обводки.
cyan
Голубая интенсивность оценивает за цвет для установки. Цветовое пространство DeviceCMYK разрешает спецификацию значения в пределах от
0.0
(не поглощает дополнительный цвет) к1.0
(полностью поглощает дополнительный цвет).magenta
Пурпурная интенсивность оценивает за цвет для установки. Цветовое пространство DeviceCMYK разрешает спецификацию значения в пределах от
0.0
(не поглощает дополнительный цвет) к1.0
(полностью поглощает дополнительный цвет).yellow
Желтая интенсивность оценивает за цвет для установки. Цветовое пространство DeviceCMYK разрешает спецификацию значения в пределах от
0.0
(не поглощает дополнительный цвет) к1.0
(полностью поглощает дополнительный цвет).black
Черная интенсивность оценивает за цвет для установки. Цветовое пространство DeviceCMYK разрешает спецификацию значения в пределах от
0.0
(не поглощает дополнительный цвет) к1.0
(полностью поглощает дополнительный цвет).alpha
Значение, указывающее уровень непрозрачности. Значения могут расположиться от
0.0
(очевидный) для1.0
(непрозрачный). Значения вне этого диапазона отсекаются к0.0
или1.0
.Обсуждение
Когда Вы вызываете эту функцию, две вещи происходят:
Кварц устанавливает текущее пространство цвета обводки в DeviceCMYK.
Кварц выбирает текущий цвет обводки к значению, указанному
cyan
,magenta
,yellow
,black
, иalpha
параметры.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает пространство цвета заливки в графическом контексте.
Объявление
Swift
func CGContextSetFillColorSpace(_
c
: CGContext!, _colorspace
: CGColorSpace!)Objective C
void CGContextSetFillColorSpace ( CGContextRef context, CGColorSpaceRef space );
Параметры
c
Графический контекст, для которого можно установить пространство цвета заливки.
colorspace
Новое пространство цвета заливки. Кварц сохраняет этот объект; по возврату можно безопасно выпустить его.
Обсуждение
Как побочный эффект этой функции, Кварц присваивает надлежащее начальное значение цвету заливки, на основе указанного цветового пространства. Для изменения этого значения вызвать
CGContextSetFillColor
. Обратите внимание на то, что предпочтительный API для использования теперьCGContextSetFillColorWithColor
.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает текущий цвет заливки в графическом контексте, с помощью Кварцевого цвета.
Объявление
Swift
func CGContextSetFillColorWithColor(_
c
: CGContext!, _color
: CGColor!)Objective C
void CGContextSetFillColorWithColor ( CGContextRef c, CGColorRef color );
Параметры
c
Графический контекст, для которого можно установить цвет заливки.
color
Новый цвет заливки.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.3 и позже.
См. также
-
Устанавливает текущий цвет заливки в значение в цветовом пространстве DeviceGray.
Объявление
Swift
func CGContextSetGrayFillColor(_
c
: CGContext!, _gray
: CGFloat, _alpha
: CGFloat)Objective C
void CGContextSetGrayFillColor ( CGContextRef context, CGFloat gray, CGFloat alpha );
Параметры
c
Графический контекст, для которого можно установить текущий цвет заливки.
gray
Значение, указывающее желаемый уровень серого. Цветовое пространство DeviceGray разрешает спецификацию значения в пределах от
0.0
(абсолютный черный цвет) к1.0
(абсолютный белый). Значения вне этого диапазона фиксируются к0.0
или1.0
.alpha
Значение, указывающее уровень непрозрачности. Значения могут расположиться от
0.0
(очевидный) для1.0
(непрозрачный). Значения вне этого диапазона отсекаются к0.0
или1.0
.Обсуждение
Когда Вы вызываете эту функцию, две вещи происходят:
Кварц устанавливает текущее пространство цвета заливки в DeviceGray.
Кварц устанавливает текущий цвет заливки в значение, которое Вы указываете в
gray
иalpha
параметры.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Выбирает текущий цвет обводки к значению в цветовом пространстве DeviceGray.
Объявление
Swift
func CGContextSetGrayStrokeColor(_
c
: CGContext!, _gray
: CGFloat, _alpha
: CGFloat)Objective C
void CGContextSetGrayStrokeColor ( CGContextRef context, CGFloat gray, CGFloat alpha );
Параметры
c
Графический контекст, для которого можно выбрать текущий цвет обводки.
gray
Значение, указывающее желаемый уровень серого. Цветовое пространство DeviceGray разрешает спецификацию значения в пределах от
0.0
(абсолютный черный цвет) к1.0
(абсолютный белый). Значения вне этого диапазона фиксируются к0.0
или1.0
.alpha
Значение, указывающее уровень непрозрачности. Значения могут расположиться от
0.0
(очевидный) для1.0
(непрозрачный). Значения вне этого диапазона отсекаются к0.0
или1.0
.Обсуждение
Когда Вы вызываете эту функцию, две вещи происходят:
Кварц устанавливает текущее пространство цвета обводки в DeviceGray. Цветовое пространство DeviceGray является пространством единственной размерности, в котором значения цвета указаны исключительно интенсивностью уровня яркости (от абсолютного черного цвета до абсолютного белого).
Кварц выбирает текущий цвет обводки к значению, которое Вы указываете в
gray
иalpha
параметры.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает текущий цвет заливки в значение в цветовом пространстве DeviceRGB.
Объявление
Swift
func CGContextSetRGBFillColor(_
c
: CGContext!, _red
: CGFloat, _green
: CGFloat, _blue
: CGFloat, _alpha
: CGFloat)Objective C
void CGContextSetRGBFillColor ( CGContextRef context, CGFloat red, CGFloat green, CGFloat blue, CGFloat alpha );
Параметры
c
Графический контекст, для которого можно установить текущий цвет заливки.
red
Красная интенсивность оценивает за цвет для установки. Цветовое пространство DeviceRGB разрешает спецификацию значения в пределах от
0.0
(обнулите интенсивность) к1.0
(полная интенсивность).green
Зеленая интенсивность оценивает за цвет для установки. Цветовое пространство DeviceRGB разрешает спецификацию значения в пределах от
0.0
(обнулите интенсивность) к1.0
(полная интенсивность).blue
Синяя интенсивность оценивает за цвет для установки. Цветовое пространство DeviceRGB разрешает спецификацию значения в пределах от
0.0
(обнулите интенсивность) к1.0
(полная интенсивность).alpha
Значение, указывающее уровень непрозрачности. Значения могут расположиться от
0.0
(очевидный) для1.0
(непрозрачный). Значения вне этого диапазона отсекаются к0.0
или1.0
.Обсуждение
Когда Вы вызываете эту функцию, две вещи происходят:
Кварц устанавливает текущее пространство цвета заливки в DeviceRGB.
Кварц устанавливает текущий цвет заливки в значение, указанное
red
,green
,blue
, иalpha
параметры.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Выбирает текущий цвет обводки к значению в цветовом пространстве DeviceRGB.
Объявление
Swift
func CGContextSetRGBStrokeColor(_
c
: CGContext!, _red
: CGFloat, _green
: CGFloat, _blue
: CGFloat, _alpha
: CGFloat)Objective C
void CGContextSetRGBStrokeColor ( CGContextRef context, CGFloat red, CGFloat green, CGFloat blue, CGFloat alpha );
Параметры
c
Графический контекст, для которого можно выбрать текущий цвет обводки.
red
Красная интенсивность оценивает за цвет для установки. Цветовое пространство DeviceRGB разрешает спецификацию значения в пределах от
0.0
(обнулите интенсивность) к1.0
(полная интенсивность).green
Зеленая интенсивность оценивает за цвет для установки. Цветовое пространство DeviceRGB разрешает спецификацию значения в пределах от
0.0
(обнулите интенсивность) к1.0
(полная интенсивность).blue
Синяя интенсивность оценивает за цвет для установки. Цветовое пространство DeviceRGB разрешает спецификацию значения в пределах от
0.0
(обнулите интенсивность) к1.0
(полная интенсивность).alpha
Значение, указывающее уровень непрозрачности. Значения могут расположиться от
0.0
(очевидный) для1.0
(непрозрачный). Значения вне этого диапазона отсекаются к0.0
или1.0
.Обсуждение
Когда Вы вызываете эту функцию, две вещи происходят:
Кварц устанавливает текущее пространство цвета обводки в DeviceRGB.
Кварц выбирает текущий цвет обводки к значению, указанному
red
,green
,blue
, иalpha
параметры.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Включает затенение в графическом контексте.
Объявление
Swift
func CGContextSetShadow(_
context
: CGContext!, _offset
: CGSize, _blur
: CGFloat)Objective C
void CGContextSetShadow ( CGContextRef context, CGSize offset, CGFloat blur );
Параметры
context
Графический контекст.
offset
Указывает перевод системы координат контекста, для установления смещения для тени (
{0,0}
сразу указывает источник света выше экрана).blur
Неотрицательное число, указывающее сумму размытости.
Обсуждение
Теневые параметры являются частью состояния графики в контексте. После того, как затенение установлено, все нарисованные объекты являются затененным использованием черного цвета с 1/3 альфой (т.е. RGBA =
{0, 0, 0, 1.0/3.0}
) в цветовом пространстве DeviceRGB.Выключить затенение:
Использование стандарт сохраняет/восстанавливает механизм для состояния графики.
Использовать
CGContextSetShadowWithColor
выбирать цвет тени к полностью прозрачному цвету (или передачаNULL
как цвет).
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.3 и позже.
-
Включает затенение с цветом графический контекст.
Объявление
Swift
func CGContextSetShadowWithColor(_
context
: CGContext!, _offset
: CGSize, _blur
: CGFloat, _color
: CGColor!)Objective C
void CGContextSetShadowWithColor ( CGContextRef context, CGSize offset, CGFloat blur, CGColorRef color );
Параметры
context
Графический контекст для изменения.
offset
Указывает перевод в основном пространстве.
blur
Неотрицательное число, указывающее сумму размытости.
color
Указывает цвет тени, которая может содержать ненепрозрачное альфа-значение. Если
NULL
, тогда затенение отключено.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.3 и позже.
См. также
-
Выбирает текущий цвет обводки.
Объявление
Swift
func CGContextSetStrokeColor(_
c
: CGContext!, _components
: UnsafePointer<CGFloat>)Objective C
void CGContextSetStrokeColor ( CGContextRef context, const CGFloat components[] );
Параметры
c
Графический контекст, для которого можно выбрать текущий цвет обводки.
components
Массив интенсивности оценивает описание цвета для установки. Число элементов матрицы должно равняться числу компонентов в текущем пространстве цвета обводки плюс дополнительный компонент для альфа-значения.
Обсуждение
Текущее пространство цвета обводки не должно быть цветовым пространством образца. Для получения информации о выбирании цвета обводки при использовании цветового пространства образца посмотрите
CGContextSetStrokePattern
. Обратите внимание на то, что предпочтительный API теперьCGContextSetStrokeColorWithColor
.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает пространство цвета обводки в графическом контексте.
Объявление
Swift
func CGContextSetStrokeColorSpace(_
c
: CGContext!, _colorspace
: CGColorSpace!)Objective C
void CGContextSetStrokeColorSpace ( CGContextRef context, CGColorSpaceRef space );
Параметры
c
Графический контекст для нового пространства цвета обводки.
colorspace
Новое пространство цвета обводки. Кварц сохраняет этот объект; по возврату можно безопасно выпустить его.
Обсуждение
Поскольку побочный эффект, когда Вы вызываете эту функцию, Кварц, присваивает надлежащее начальное значение цвету обводки, на основе цветового пространства, которое Вы указываете. Для изменения этого значения вызвать
CGContextSetStrokeColor
. Обратите внимание на то, что предпочтительный API теперьCGContextSetStrokeColorWithColor
.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Выбирает текущий цвет обводки в контексте, с помощью Кварцевого цвета.
Объявление
Swift
func CGContextSetStrokeColorWithColor(_
c
: CGContext!, _color
: CGColor!)Objective C
void CGContextSetStrokeColorWithColor ( CGContextRef c, CGColorRef color );
Параметры
c
Графический контекст для изменения.
color
Новый цвет обводки.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.3 и позже.
См. также
Эти функции позволяют Вам исследовать и изменять текущую матрицу преобразования (CTM) в графическом контексте.
-
Преобразовывает пользовательскую систему координат в контекст с помощью указанной матрицы.
Объявление
Swift
func CGContextConcatCTM(_
c
: CGContext!, _transform
: CGAffineTransform)Objective C
void CGContextConcatCTM ( CGContextRef c, CGAffineTransform transform );
Параметры
c
Графический контекст.
transform
Матрица преобразования для применения к текущей матрице преобразования указанного контекста.
Обсуждение
Когда Вы вызываете функцию
CGContextConcatCTM
, это конкатенирует (т.е. это объединяется), две матрицы, путем умножения их вместе. Порядок, в котором связываются матрицы, важен, поскольку операции не являются коммутативными. Когда Вы вызываетеCGContextConcatCTM
, получающийся CTM в контексте:CTMnew = transform * CTMcontext.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает текущую матрицу преобразования.
Объявление
Swift
func CGContextGetCTM(_
c
: CGContext!) -> CGAffineTransformObjective C
CGAffineTransform CGContextGetCTM ( CGContextRef c );
Параметры
c
Графический контекст.
Возвращаемое значение
Матрица преобразования для текущего состояния графики указанного контекста.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Поворачивает пользовательскую систему координат в контексте.
Объявление
Swift
func CGContextRotateCTM(_
c
: CGContext!, _angle
: CGFloat)Objective C
void CGContextRotateCTM ( CGContextRef c, CGFloat angle );
Параметры
c
Графический контекст.
angle
Угол, в радианах, на которые можно повернуть координатное пространство указанного контекста. Положительные значения вращаются против часовой стрелки, и отрицательные величины вращаются по часовой стрелке.)
Обсуждение
Направление, что контекст повернут, может казаться, изменено состоянием текущей матрицы преобразования до выполнения этой функции. Например, на iOS, a
UIView
применяет трансформацию к графическому контексту, инвертирующему ось Y (путем умножения его на-1
). Вращение пользовательской системы координат в системе координат, ранее зеркально отраженной результаты во вращении в противоположном направлении (т.е. положительные значения, кажется, поворачивают систему координат в направлении по часовой стрелке).Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Изменяет масштаб пользовательской системы координат в контексте.
Объявление
Swift
func CGContextScaleCTM(_
c
: CGContext!, _sx
: CGFloat, _sy
: CGFloat)Objective C
void CGContextScaleCTM ( CGContextRef c, CGFloat sx, CGFloat sy );
Параметры
c
Графический контекст.
sx
Фактор, которым можно масштабировать ось X координатного пространства указанного контекста.
sy
Фактор, которым можно масштабировать ось y координатного пространства указанного контекста.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Изменяет источник пользовательской системы координат в контексте.
Объявление
Swift
func CGContextTranslateCTM(_
c
: CGContext!, _tx
: CGFloat, _ty
: CGFloat)Objective C
void CGContextTranslateCTM ( CGContextRef c, CGFloat tx, CGFloat ty );
Параметры
c
Графический контекст.
tx
Сумма для перемещения оси X координатного пространства, в модулях пространства пользователя, указанного контекста.
ty
Сумма для перемещения оси y координатного пространства, в модулях пространства пользователя, указанного контекста.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Начинает слой прозрачности.
Объявление
Swift
func CGContextBeginTransparencyLayer(_
context
: CGContext!, _auxiliaryInfo
: CFDictionary!)Objective C
void CGContextBeginTransparencyLayer ( CGContextRef context, CFDictionaryRef auxiliaryInfo );
Параметры
context
Графический контекст.
auxiliaryInfo
Словарь, указывающий любую дополнительную информацию, или
NULL
.Обсуждение
До соответствующего вызова к
CGContextEndTransparencyLayer
, все последующие операции рисования в указанном контексте составляются в полностью прозрачный фон (который обрабатывается как отдельный целевой буфер от контекста).После вызова к
CGContextEndTransparencyLayer
, результат составляется в контекст с помощью глобальной альфы и теневого состояния контекста. Эта работа уважает область отсечения контекста.После вызова к этой функции все параметры в состоянии графики остаются неизменными за исключением следующего:
Глобальная альфа установлена в
1
.Тень выключена.
Окончание слоя прозрачности восстанавливает эти параметры к их предыдущим значениям. Кварц поддерживает штабель слоя прозрачности для каждого контекста, и слои прозрачности могут быть вложены.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.3 и позже.
-
Начинает слой прозрачности, содержание которого ограничено указанным прямоугольником.
Объявление
Swift
func CGContextBeginTransparencyLayerWithRect(_
context
: CGContext!, _rect
: CGRect, _auxiliaryInfo
: CFDictionary!)Objective C
void CGContextBeginTransparencyLayerWithRect ( CGContextRef context, CGRect rect, CFDictionaryRef auxiliaryInfo );
Параметры
context
Графический контекст.
rect
Прямоугольник, указанный в пространстве пользователя, ограничивающем слой прозрачности.
auxiliaryInfo
Словарь, указывающий любую дополнительную информацию, или
NULL
.Обсуждение
Эта функция идентична
CGContextBeginTransparencyLayer
за исключением того, что содержание слоя прозрачности в границах предоставленного прямоугольника.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.5 и позже.
-
Заканчивает слой прозрачности.
Объявление
Swift
func CGContextEndTransparencyLayer(_
context
: CGContext!)Objective C
void CGContextEndTransparencyLayer ( CGContextRef context );
Параметры
context
Графический контекст.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.3 и позже.
См. также
-
Неоднократно рисует изображение, масштабируемое к предоставленному прямоугольнику, для заполнения текущей области клипа.
Объявление
Swift
func CGContextDrawTiledImage(_
context
: CGContext!, _rect
: CGRect, _image
: CGImage!)Objective C
void CGContextDrawTiledImage ( CGContextRef c, CGRect rect, CGImageRef image );
Параметры
context
Графический контекст, в котором можно нарисовать изображение.
rect
Прямоугольник, указывающий источник и размер целевой мозаики. Кварц масштабирует изображение — диспропорционально, если необходимый — для адаптации границам, указанным
rect
параметр.image
Изображение для рисования.
Обсуждение
Кварц рисует масштабированное изображение, запускающееся в источнике прямоугольника в пространстве пользователя, затем перемещается в новую точку (горизонтально шириной мозаики и/или вертикально высотой мозаики), рисует масштабированное изображение, перемещает снова, рисует снова, и т.д., пока текущая область клипа не размещается рядом с копиями изображения. В отличие от образцов, изображение размещается рядом в пространстве пользователя, таким образом, трансформации применились к влиянию CTM конечный результат.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.5 и позже.
-
Вовлекает изображение в графический контекст.
Объявление
Swift
func CGContextDrawImage(_
c
: CGContext!, _rect
: CGRect, _image
: CGImage!)Objective C
void CGContextDrawImage ( CGContextRef c, CGRect rect, CGImageRef image );
Параметры
c
Графический контекст, в котором можно нарисовать изображение.
rect
Расположение и размерности в пространстве пользователя ограничительной рамки, в которой можно нарисовать изображение.
image
Изображение для рисования.
Обсуждение
Кварц масштабирует изображение — диспропорционально, если необходимый — для адаптации границам, указанным
rect
параметр.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Рисует страницу в текущем пространстве пользователя контекста PDF.
Объявление
Swift
func CGContextDrawPDFPage(_
c
: CGContext!, _page
: CGPDFPage!)Objective C
void CGContextDrawPDFPage ( CGContextRef c, CGPDFPageRef page );
Параметры
c
Графический контекст, в котором можно нарисовать страницу PDF.
page
Страница Quartz PDF.
Обсуждение
Эта функция работает в сочетании с непрозрачным типом
CGPDFPageRef
вовлекать отдельные страницы в контекст PDF.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.3 и позже.
-
Красит заливку градиента, варьирующуюся вдоль строки, определенной предоставленными начальными и конечными точками.
Объявление
Swift
func CGContextDrawLinearGradient(_
context
: CGContext!, _gradient
: CGGradient!, _startPoint
: CGPoint, _endPoint
: CGPoint, _options
: CGGradientDrawingOptions)Objective C
void CGContextDrawLinearGradient ( CGContextRef context, CGGradientRef gradient, CGPoint startPoint, CGPoint endPoint, CGGradientDrawingOptions options );
Параметры
context
Кварцевый контекст графики.
gradient
A
CGGradient
объект.startPoint
Координата, определяющая начальную точку градиента.
endPoint
Координата, определяющая конечную точку градиента.
options
Флаги опции (
kCGGradientDrawsBeforeStartLocation
илиkCGGradientDrawsAfterEndLocation
) то управление, расширяется ли заливка вне начальной или конечной точки.Обсуждение
Цвет в расположении 0 в объекте CGGradient отображается на начальной точке. Цвет в расположении 1 в объекте CGGradient отображается на конечной точке. Цвета линейно интерполированы между этими двумя точками на основе значений расположения градиента. Опция отмечает управление, нарисован ли градиент перед стартовой точкой или после конечной точки.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.5 и позже.
-
Красит заливку градиента, варьирующуюся вдоль области, определенной предоставленным запуском и конечными кругами.
Объявление
Swift
func CGContextDrawRadialGradient(_
context
: CGContext!, _gradient
: CGGradient!, _startCenter
: CGPoint, _startRadius
: CGFloat, _endCenter
: CGPoint, _endRadius
: CGFloat, _options
: CGGradientDrawingOptions)Objective C
void CGContextDrawRadialGradient ( CGContextRef context, CGGradientRef gradient, CGPoint startCenter, CGFloat startRadius, CGPoint endCenter, CGFloat endRadius, CGGradientDrawingOptions options );
Параметры
context
Кварцевый контекст графики.
gradient
Объект CGGradient.
startCenter
Координата, определяющая центр стартового круга.
startRadius
Радиус стартового круга.
endCenter
Координата, определяющая центр конечного круга.
endRadius
Радиус конечного круга.
options
Флаги опции (
kCGGradientDrawsBeforeStartLocation
илиkCGGradientDrawsAfterEndLocation
) то управление, нарисован ли градиент перед стартовым кругом или после конечного круга.Обсуждение
Цвет в расположении 0 в объекте CGGradient отображается на круге, определенном
startCenter
иstartRadius
. Цвет в расположении 1 в объекте CGGradient отображается на круге, определенномendCenter
иendRadius
. Цвета линейно интерполированы между запуском и конечными кругами на основе значений расположения градиента. Опция отмечает управление, нарисован ли градиент перед стартовой точкой или после конечной точки.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.5 и позже.
-
Заполняет траекторию отсечения контекста с указанной штриховкой.
Объявление
Swift
func CGContextDrawShading(_
c
: CGContext!, _shading
: CGShading!)Objective C
void CGContextDrawShading ( CGContextRef context, CGShadingRef shading );
Параметры
c
Графический контекст, в котором можно нарисовать штриховку.
shading
Кварцевая штриховка. Кварц сохраняет этот объект; по возврату можно безопасно выпустить его.
Обсуждение
В OS X v10.5 и позже, предпочтительный способ нарисовать градиенты состоит в том, чтобы использовать объект CGGradient. См. Ссылку CGGradient.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.2 и позже.
-
Запускает новую страницу в основанном на странице графическом контексте.
Объявление
Swift
func CGContextBeginPage(_
c
: CGContext!, _mediaBox
: UnsafePointer<CGRect>)Objective C
void CGContextBeginPage ( CGContextRef c, const CGRect *mediaBox );
Параметры
c
Основанный на странице графический контекст, такой как контекст PDF. Если Вы указываете контекст, не поддерживающий многократные страницы, эта функция ничего не делает.
mediaBox
Кварцевый прямоугольник, определяющий границы новой страницы, выраженной в модулях пространства пользователя по умолчанию, или
NULL
. Эти границы заменяют любого предоставленного для поля носителей при создании контекста. Если Вы передаетеNULL
, Кварц использует прямоугольник, который Вы предоставили для поля носителей, когда создавался графический контекст.Обсуждение
При использовании графического контекста, поддерживающего многократные страницы, необходимо вызвать эту функцию вместе с
CGContextEndPage
формировать рисунок границ страницы в выводе. Другими словами, каждая страница должна быть заключена в скобки вызовами кCGContextBeginPage
иCGContextEndPage
. Кварц игнорирует все операции рисования, выполняемые вне границы страницы в основанном на странице контексте.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Заканчивает текущую страницу в основанном на странице графическом контексте.
Объявление
Swift
func CGContextEndPage(_
c
: CGContext!)Objective C
void CGContextEndPage ( CGContextRef c );
Параметры
c
Основанный на странице графический контекст.
Обсуждение
При использовании графического контекста, поддерживающего многократные страницы, необходимо вызвать эту функцию для завершения получения на текущей странице.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
CGContextShowGlyphs CGContextShowGlyphs
(OS X v10.9)Выводит на экран массив глифов в позиции текущего текста.
Оператор осуждения
Используйте Базовый текст вместо этого.
Объявление
Objective C
void CGContextShowGlyphs ( CGContextRef c, const CGGlyph g[], size_t count );
Параметры
c
Графический контекст, в котором можно вывести на экран глифы.
glyphs
Массив глифов для отображения.
count
Общее количество глифов передало в
g
параметр.Обсуждение
Эта функция выводит на экран массив глифов в позиции текущего текста, точка, указанная матрицей текущего текста.
Оператор импорта
Objective C
@import CoreGraphics;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
-
CGContextShowGlyphsAtPoint CGContextShowGlyphsAtPoint
(OS X v10.9)Выводит на экран массив глифов в позиции, которую Вы указываете.
Оператор осуждения
Используйте Базовый текст вместо этого.
Объявление
Objective C
void CGContextShowGlyphsAtPoint ( CGContextRef context, CGFloat x, CGFloat y, const CGGlyph glyphs[], size_t count );
Параметры
c
Графический контекст, в котором можно вывести на экран глифы.
x
Значение для x-координаты пространства пользователя, в котором можно вывести на экран глифы.
y
Значение для y-координаты пространства пользователя, в котором можно вывести на экран глифы.
glyphs
Массив глифов для отображения.
count
Общее количество глифов передало в
glyphs
параметр.Обсуждение
Эта функция выводит на экран массив глифов в указанной позиции в пространстве пользователя.
Оператор импорта
Objective C
@import CoreGraphics;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
-
Рисует массив глифов с переменными смещениями.
Оператор осуждения
Используйте Базовый текст вместо этого.
Объявление
Objective C
void CGContextShowGlyphsWithAdvances ( CGContextRef context, const CGGlyph glyphs[], const CGSize advances[], size_t count );
Параметры
c
Графический контекст, в котором можно вывести на экран глифы.
glyphs
Массив Кварцевых глифов.
advances
Массив значений смещения связался с каждым глифом в массиве. Каждое значение указывает смещение от источника предыдущего глифа до источника соответствующего глифа. Смещения указаны в пространстве пользователя.
count
Число глифов в указанном массиве.
Обсуждение
Эта функция рисует массив глифов в текущей точке, указанной текстовой матрицей.
Оператор импорта
Objective C
@import CoreGraphics;
Доступность
Доступный в OS X v10.3 и позже.
Осуждаемый в OS X v10.9.
-
Рисует глифы в предоставленной позиции.
Объявление
Swift
func CGContextShowGlyphsAtPositions(_
c
: CGContext!, _glyphs
: UnsafePointer<CGGlyph>, _positions
: UnsafePointer<CGPoint>, _count
: UInt)Objective C
void CGContextShowGlyphsAtPositions ( CGContextRef context, const CGGlyph glyphs[], const CGPoint positions[], size_t count );
Параметры
c
Графический контекст, в котором можно вывести на экран глифы.
glyphs
Массив Кварцевых глифов.
positions
Позиции для глифов. Каждый элемент в этом массиве соответствует с глифом в соответствующем индексе в
glyphs
массив. Позиция каждого глифа указана в текстовом пространстве, и, как следствие, преобразовывается через текстовую матрицу к пространству пользователя.count
Число элементов в
glyphs
массив.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.5 и позже.
-
Возвращает матрицу текущего текста.
Объявление
Swift
func CGContextGetTextMatrix(_
c
: CGContext!) -> CGAffineTransformObjective C
CGAffineTransform CGContextGetTextMatrix ( CGContextRef c );
Параметры
c
Графический контекст, для которого можно получить текстовую матрицу.
Возвращаемое значение
Матрица текущего текста.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает расположение, в котором составлен текст.
Объявление
Swift
func CGContextGetTextPosition(_
c
: CGContext!) -> CGPointObjective C
CGPoint CGContextGetTextPosition ( CGContextRef context );
Параметры
c
Графический контекст, из которого можно получить позицию текущего текста.
Возвращаемое значение
Возвраты a
CGPoint
значение, указывающее значения x и y, в которых текст должен быть составлен в координатах пространства пользователя.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
CGContextSelectFont CGContextSelectFont
(OS X v10.9)Устанавливает размер шрифта и размер шрифта в графическом контексте.
Оператор осуждения
Используйте Базовый текст вместо этого.
Объявление
Objective C
void CGContextSelectFont ( CGContextRef c, const char *name, CGFloat size, CGTextEncoding textEncoding );
Параметры
c
Графический контекст, для которого можно установить размер шрифта и размер шрифта.
name
Завершенная нулем строка, содержащая имя PostScript шрифта для установки.
size
Значение, указывающее размер шрифта для установки в модулях текстового пространства.
textEncoding
A
CGTextEncoding
значение, указывающее кодирование, используемое для шрифта. Для описания доступных значений посмотрите“CGTextEncoding”
.Оператор импорта
Objective C
@import CoreGraphics;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
-
Устанавливает интервал текущего символа.
Объявление
Swift
func CGContextSetCharacterSpacing(_
c
: CGContext!, _spacing
: CGFloat)Objective C
void CGContextSetCharacterSpacing ( CGContextRef context, CGFloat spacing );
Параметры
c
Графический контекст, для которого можно установить межсимвольный интервал.
spacing
Значение, представляющее сумму дополнительного пространства для размещения между глифами в координатах текстового пространства.
Обсуждение
Кварц добавляет дополнительное пространство к усовершенствованию между источником одного символа и источником следующего символа. Для получения информации о текстовой системе координат посмотрите
CGContextSetTextMatrix
.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает шрифт платформы в графическом контексте.
Объявление
Swift
func CGContextSetFont(_
c
: CGContext!, _font
: CGFont!)Objective C
void CGContextSetFont ( CGContextRef c, CGFontRef font );
Параметры
c
Графический контекст, для которого можно установить шрифт.
font
Кварцевый шрифт.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает размер текущего шрифта.
Объявление
Swift
func CGContextSetFontSize(_
c
: CGContext!, _size
: CGFloat)Objective C
void CGContextSetFontSize ( CGContextRef c, CGFloat size );
Параметры
c
Графический контекст.
size
Размер шрифта, выраженный в модулях текстового пространства.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает режим получения текущего текста.
Объявление
Swift
func CGContextSetTextDrawingMode(_
c
: CGContext!, _mode
: CGTextDrawingMode)Objective C
void CGContextSetTextDrawingMode ( CGContextRef c, CGTextDrawingMode mode );
Параметры
c
Графический контекст.
mode
Текстовый режим получения (такой как
kCGTextFill
илиkCGTextStroke
) это указывает, как Кварц представляет отдельные глифы в графическом контексте. Посмотрите“CGTextDrawingMode”
для полного списка.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает матрицу текущего текста.
Объявление
Swift
func CGContextSetTextMatrix(_
c
: CGContext!, _transform
: CGAffineTransform)Objective C
void CGContextSetTextMatrix ( CGContextRef c, CGAffineTransform t );
Параметры
c
Графический контекст.
transform
Текстовая матрица для установки.
Обсуждение
Текстовая матрица указывает преобразование от текстового пространства до пространства пользователя. Для создания окончательного текста, представляющего матрицу, использующуюся для фактического рисования текста на странице, Кварц связывает текстовую матрицу с текущей матрицей преобразования и другими параметрами от состояния графики.
Обратите внимание на то, что текстовая матрица не является частью состояния графики — сохранение или восстановление состояния графики не имеют никакого эффекта на текстовую матрицу. Текстовая матрица является атрибутом графического контекста, не текущего шрифта.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает расположение, в котором составлен текст.
Объявление
Swift
func CGContextSetTextPosition(_
c
: CGContext!, _x
: CGFloat, _y
: CGFloat)Objective C
void CGContextSetTextPosition ( CGContextRef c, CGFloat x, CGFloat y );
Параметры
c
Графический контекст.
x
Значение для x-координаты, в которой можно составить текст в координатах пространства пользователя.
y
Значение для y-координаты, в которой можно составить текст в координатах пространства пользователя.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
CGContextShowText CGContextShowText
(OS X v10.9)Выводит на экран символьный массив в позиции текущего текста, точка, указанная матрицей текущего текста.
Оператор осуждения
Используйте Базовый текст вместо этого.
Объявление
Objective C
void CGContextShowText ( CGContextRef c, const char *string, size_t length );
Параметры
c
Графический контекст.
string
Массив символов для рисования.
length
Длина массива, указанного в
bytes
параметр.Обсуждение
Кварц использует данные шрифта, предоставленные системой для отображения каждого байта массива через вектор кодирования текущего шрифта для получения глифа для отображения. Обратите внимание на то, что шрифт, должно быть, был установлен с помощью
CGContextSelectFont
. Не использоватьCGContextShowText
в сочетании сCGContextSetFont
.Оператор импорта
Objective C
@import CoreGraphics;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
-
CGContextShowTextAtPoint CGContextShowTextAtPoint
(OS X v10.9)Выводит на экран символьную строку в позиции, которую Вы указываете.
Оператор осуждения
Используйте Базовый текст вместо этого.
Объявление
Objective C
void CGContextShowTextAtPoint ( CGContextRef c, CGFloat x, CGFloat y, const char *string, size_t length );
Параметры
c
Графический контекст.
x
Значение для x-координаты (в пространстве пользователя), в котором можно вывести на экран текст.
y
Значение для y-координаты (в пространстве пользователя), в котором можно вывести на экран текст.
string
Массив символов для рисования.
length
Длина массива, указанного в
string
параметр.Обсуждение
Кварц использует данные шрифта, предоставленные системой для отображения каждого байта массива через вектор кодирования текущего шрифта для получения глифа для отображения. Обратите внимание на то, что шрифт, должно быть, был установлен с помощью
CGContextSelectFont
. Не использоватьCGContextShowTextAtPoint
в сочетании сCGContextSetFont
.Оператор импорта
Objective C
@import CoreGraphics;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
-
Возвращает аффинное преобразование, отображающее координаты пространства пользователя на координаты пространства устройства.
Объявление
Swift
func CGContextGetUserSpaceToDeviceSpaceTransform(_
c
: CGContext!) -> CGAffineTransformObjective C
CGAffineTransform CGContextGetUserSpaceToDeviceSpaceTransform ( CGContextRef context );
Параметры
c
Графический контекст.
Возвращаемое значение
Аффинные преобразования, который отображает пространство пользователя графического контекста к пространству устройства.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.4 и позже.
-
Возвращает точку, преобразовывающуюся от координат пространства пользователя до координат пространства устройства.
Объявление
Objective C
CGPoint CGContextConvertPointToDeviceSpace ( CGContextRef context, CGPoint point );
Параметры
c
Графический контекст.
point
Точка, в координатах пространства пользователя, для преобразования.
Возвращаемое значение
Координаты точки в координатах пространства устройства.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
Возвращает точку, преобразовывающуюся от координат пространства устройства до координат пространства пользователя.
Объявление
Objective C
CGPoint CGContextConvertPointToUserSpace ( CGContextRef context, CGPoint point );
Параметры
c
Графический контекст.
point
Точка, в координатах пространства устройства, для преобразования.
Возвращаемое значение
Координаты точки в координатах пространства пользователя.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
Возвращает размер, преобразовывающийся от координат пространства пользователя до координат пространства устройства.
Объявление
Objective C
CGSize CGContextConvertSizeToDeviceSpace ( CGContextRef context, CGSize size );
Параметры
c
Графический контекст.
size
Размер, в координатах пространства пользователя, для преобразования.
Возвращаемое значение
Размер в координатах пространства устройства.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
Возвращает размер, преобразовывающийся от координат пространства устройства до координат пространства пользователя
Объявление
Objective C
CGSize CGContextConvertSizeToUserSpace ( CGContextRef context, CGSize size );
Параметры
c
Графический контекст.
size
Размер, в координатах пространства устройства, для преобразования.
Возвращаемое значение
Размер в координатах пространства пользователя.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
Возвращает прямоугольник, преобразовывающийся от координаты пространства пользователя до координат пространства устройства.
Объявление
Objective C
CGRect CGContextConvertRectToDeviceSpace ( CGContextRef context, CGRect rect );
Параметры
c
Графический контекст.
rect
Прямоугольник, в координатах пространства пользователя, для преобразования.
Возвращаемое значение
Прямоугольник в координатах пространства устройства.
Обсуждение
В общих аффинных преобразованиях не сохраняют прямоугольники. В результате эта функция возвращает наименьший прямоугольник, содержащий преобразованные угловые точки прямоугольника.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
Возвращает прямоугольник, преобразовывающийся от координаты пространства устройства до координат пространства пользователя.
Объявление
Objective C
CGRect CGContextConvertRectToUserSpace ( CGContextRef context, CGRect rect );
Параметры
c
Графический контекст.
rect
Прямоугольник, в координатах пространства устройства, для преобразования.
Возвращаемое значение
Прямоугольник в координатах пространства пользователя.
Обсуждение
В целом аффинные преобразования не сохраняют прямоугольники. В результате эта функция возвращает наименьший прямоугольник, содержащий преобразованные угловые точки прямоугольника.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
Непрозрачный тип, представляющий Кварц 2D среда получения.
Объявление
Swift
typealias CGContextRef = CGContext
Objective C
typedef struct CGContext * CGContextRef;
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
Составление композита операций для изображений.
Объявление
Swift
struct CGBlendMode { init(_
value
: UInt32) var value: UInt32 }Objective C
enum CGBlendMode { kCGBlendModeNormal, kCGBlendModeMultiply, kCGBlendModeScreen, kCGBlendModeOverlay, kCGBlendModeDarken, kCGBlendModeLighten, kCGBlendModeColorDodge, kCGBlendModeColorBurn, kCGBlendModeSoftLight, kCGBlendModeHardLight, kCGBlendModeDifference, kCGBlendModeExclusion, kCGBlendModeHue, kCGBlendModeSaturation, kCGBlendModeColor, kCGBlendModeLuminosity, kCGBlendModeClear, kCGBlendModeCopy, kCGBlendModeSourceIn, kCGBlendModeSourceOut, kCGBlendModeSourceAtop, kCGBlendModeDestinationOver, kCGBlendModeDestinationIn, kCGBlendModeDestinationOut, kCGBlendModeDestinationAtop, kCGBlendModeXOR, kCGBlendModePlusDarker, kCGBlendModePlusLighter }; typedef enum CGBlendMode CGBlendMode;
Константы
-
kCGBlendModeNormal
kCGBlendModeNormal
Красит выборки исходного изображения по выборкам фонового изображения.
Доступный в OS X v10.4 и позже.
-
kCGBlendModeMultiply
kCGBlendModeMultiply
Умножает выборки исходного изображения с выборками фонового изображения. Это приводит к цветам, которые являются, по крайней мере, столь же темными как любой из двух способствующих демонстрационных цветов.
Доступный в OS X v10.4 и позже.
-
kCGBlendModeScreen
kCGBlendModeScreen
Умножает инверсию выборок исходного изображения с инверсией выборок фонового изображения. Это приводит к цветам, которые, по крайней мере, так же легки как любой из двух способствующих демонстрационных цветов.
Доступный в OS X v10.4 и позже.
-
kCGBlendModeOverlay
kCGBlendModeOverlay
Или умножает или экранирует выборки исходного изображения с выборками фонового изображения, в зависимости от цвета фона. Результат состоит в том, чтобы наложить существующие выборки изображения при сохранении выделений и теней фона. Цвет фона смешивается с исходным изображением для отражения легкости или темноты фона.
Доступный в OS X v10.4 и позже.
-
kCGBlendModeDarken
kCGBlendModeDarken
Создает составные выборки изображения путем выбора более темных выборок (или из исходного изображения или из фона). Результат состоит в том, что выборки фонового изображения заменяются любыми выборками исходного изображения, которые являются более темными. Иначе, выборки фонового изображения оставлены без изменений.
Доступный в OS X v10.4 и позже.
-
kCGBlendModeLighten
kCGBlendModeLighten
Создает составные выборки изображения путем выбора более легких выборок (или из исходного изображения или из фона). Результат состоит в том, что выборки фонового изображения заменяются любыми выборками исходного изображения, которые легче. Иначе, выборки фонового изображения оставлены без изменений.
Доступный в OS X v10.4 и позже.
-
kCGBlendModeColorDodge
kCGBlendModeColorDodge
Украшает выборки фонового изображения для отражения выборок исходного изображения. Демонстрационные значения исходного изображения, указывающие черный, не вызывают изменение.
Доступный в OS X v10.4 и позже.
-
kCGBlendModeColorBurn
kCGBlendModeColorBurn
Затемняет выборки фонового изображения для отражения выборок исходного изображения. Демонстрационные значения исходного изображения, указывающие белый, не вызывают изменение.
Доступный в OS X v10.4 и позже.
-
kCGBlendModeSoftLight
kCGBlendModeSoftLight
Или затемняет или освещает цвета, в зависимости от демонстрационного цвета исходного изображения. Если демонстрационный цвет исходного изображения легче, чем 50%-й серый, фон освещается, подобен уклонению. Если демонстрационный цвет исходного изображения является более темным, чем 50%-й серый, фон затемняется, подобен записи. Если демонстрационный цвет исходного изображения равен 50%-му серому, фон не изменяется. Выборки изображения, которые равны чистому черному или чистому белому продукту более темные или более легкие области, но не приводят к чистому черному или белый. Полный эффект подобен тому, чего Вы достигли бы путем блистания рассеянный центр внимания на исходном изображении. Используйте это для добавления выделений к сцене.
Доступный в OS X v10.4 и позже.
-
kCGBlendModeHardLight
kCGBlendModeHardLight
Или умножает или экранирует цвета, в зависимости от демонстрационного цвета исходного изображения. Если демонстрационный цвет исходного изображения легче, чем 50%-й серый, фон освещается, подобен экранированию. Если демонстрационный цвет исходного изображения является более темным, чем 50%-й серый, фон затемняется, подобен умножению. Если демонстрационный цвет исходного изображения равен 50%-му серому, исходное изображение не изменяется. Выборки изображения, которые являются равными чистому черному или чистому белому результату в чистом черном или белыми. Полный эффект подобен тому, чего Вы достигли бы путем блистания резкий центр внимания на исходном изображении. Используйте это для добавления выделений к сцене.
Доступный в OS X v10.4 и позже.
-
kCGBlendModeDifference
kCGBlendModeDifference
Вычитает или демонстрационный цвет исходного изображения из демонстрационного цвета фонового изображения или реверс, в зависимости от которого выборка имеет большее значение яркости. Демонстрационные значения исходного изображения, которые являются черными, не вызывают изменения; белое инвертирование значения цвета фона.
Доступный в OS X v10.4 и позже.
-
kCGBlendModeExclusion
kCGBlendModeExclusion
Производит эффект, подобный произведенному
kCGBlendModeDifference
, но с более низким контрастом. Демонстрационные значения исходного изображения, которые являются черными, не вызывают изменение; белое инвертирование значения цвета фона.Доступный в OS X v10.4 и позже.
-
kCGBlendModeHue
kCGBlendModeHue
Использует яркость и степени насыщения фона с оттенком исходного изображения.
Доступный в OS X v10.4 и позже.
-
kCGBlendModeSaturation
kCGBlendModeSaturation
Использует яркость и значения оттенка фона с насыщенностью исходного изображения. Области фона, не имеющие никакой насыщенности (т.е. чистые серые области) не вызывают изменение.
Доступный в OS X v10.4 и позже.
-
kCGBlendModeColor
kCGBlendModeColor
Использует значения яркости фона с оттенком и степенями насыщения исходного изображения. Этот режим сохраняет уровни серого в изображении. Можно использовать этот режим, чтобы окрасить монохромные изображения или окрасить цветные изображения.
Доступный в OS X v10.4 и позже.
-
kCGBlendModeLuminosity
kCGBlendModeLuminosity
Использует оттенок и насыщенность фона с яркостью исходного изображения. Этот режим создает эффект, который является обратным к эффекту, создаваемому
kCGBlendModeColor
.Доступный в OS X v10.4 и позже.
-
kCGBlendModeClear
kCGBlendModeClear
R = 0
Доступный в OS X v10.5 и позже.
-
kCGBlendModeCopy
kCGBlendModeCopy
R = S
Доступный в OS X v10.5 и позже.
-
kCGBlendModeSourceIn
kCGBlendModeSourceIn
R = S*Da
Доступный в OS X v10.5 и позже.
-
kCGBlendModeSourceOut
kCGBlendModeSourceOut
R = S*(1 - Da)
Доступный в OS X v10.5 и позже.
-
kCGBlendModeSourceAtop
kCGBlendModeSourceAtop
R = S*Da + D*(1 - Sa)
Доступный в OS X v10.5 и позже.
-
kCGBlendModeDestinationOver
kCGBlendModeDestinationOver
R = S*(1 - Da) + D
Доступный в OS X v10.5 и позже.
-
kCGBlendModeDestinationIn
kCGBlendModeDestinationIn
R = D*Sa
Доступный в OS X v10.5 и позже.
-
kCGBlendModeDestinationOut
kCGBlendModeDestinationOut
R = D*(1 - Sa)
Доступный в OS X v10.5 и позже.
-
kCGBlendModeDestinationAtop
kCGBlendModeDestinationAtop
R = S*(1 - Da) + D*Sa
Доступный в OS X v10.5 и позже.
-
kCGBlendModeXOR
kCGBlendModeXOR
R = S*(1 - Da) + D*(1 - Sa)
. Этот режим XOR только номинально связан с классической растровой операцией «исключающее ИЛИ», не поддерживающейся 2D Кварцем.Доступный в OS X v10.5 и позже.
-
kCGBlendModePlusDarker
kCGBlendModePlusDarker
R = MAX(0, 1 - ((1 - D) + (1 - S)))
Доступный в OS X v10.5 и позже.
-
kCGBlendModePlusLighter
kCGBlendModePlusLighter
R = MIN(1, S + D)
Доступный в OS X v10.5 и позже.
Обсуждение
Константы режима смешивания, представленные в OS X v10.5, представляют режимы смешивания Вареного пудинга швейцара. Символы в уравнениях для этих режимов смешивания:
R является предварительно умноженным результатом
S является исходным цветом и включает альфу
D является целевым цветом и включает альфу
Ra, Sa и Da являются альфа-компонентами R, S, и D
Можно счесть больше информации о режимах смешивания, включая примеры изображений произведенным с помощью них и многих математических описаний режимов, в Ссылке PDF, Четвертом Выпуске, Версии 1.5, Adobe Systems, Inc. Если Вы - бывший разработчик QuickDraw, может быть полезно для Вас думать о режимах смешивания как об альтернативе для передачи режимов
Для примеров использования режимов смешивания см. «Режимы смешивания Установки» и «Используя Режимы смешивания С Изображениями» в Кварце 2D Руководство по программированию.
Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.4 и позже.
-
-
Уровни качества интерполяции для рендеринга изображения.
Объявление
Swift
struct CGInterpolationQuality { init(_
value
: UInt32) var value: UInt32 }Objective C
enum CGInterpolationQuality { kCGInterpolationDefault = 0, kCGInterpolationNone = 1, kCGInterpolationLow = 2, kCGInterpolationMedium = 4, kCGInterpolationHigh = 3 }; typedef enum CGInterpolationQuality CGInterpolationQuality;
Константы
-
kCGInterpolationDefault
kCGInterpolationDefault
Уровень по умолчанию качества.
Доступный в OS X v10.1 и позже.
-
kCGInterpolationNone
kCGInterpolationNone
Никакая интерполяция.
Доступный в OS X v10.1 и позже.
-
kCGInterpolationLow
kCGInterpolationLow
Низкий уровень качества интерполяции. Эта установка может ускорить рендеринг изображения.
Доступный в OS X v10.1 и позже.
-
kCGInterpolationMedium
kCGInterpolationMedium
Средний уровень качества интерполяции. Эта установка медленнее, чем низкая установка, но быстрее, чем высокая установка.
Доступный в OS X v10.6 и позже.
-
kCGInterpolationHigh
kCGInterpolationHigh
Высокий уровень качества интерполяции. Эта установка может замедлить рендеринг изображения.
Доступный в OS X v10.1 и позже.
Обсуждение
Вы используете функцию
CGContextSetInterpolationQuality
установить качество интерполяции в графическом контексте.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.1 и позже.
-
-
Режимы для рендеринга текста.
Объявление
Swift
struct CGTextDrawingMode { init(_
value
: UInt32) var value: UInt32 }Objective C
enum CGTextDrawingMode { kCGTextFill, kCGTextStroke, kCGTextFillStroke, kCGTextInvisible, kCGTextFillClip, kCGTextStrokeClip, kCGTextFillStrokeClip, kCGTextClip }; typedef enum CGTextDrawingMode CGTextDrawingMode;
Константы
-
kCGTextFill
kCGTextFill
Выполните операцию заполнения на тексте.
Доступный в OS X v10.0 и позже.
-
kCGTextStroke
kCGTextStroke
Выполните штриховую работу на тексте.
Доступный в OS X v10.0 и позже.
-
kCGTextFillStroke
kCGTextFillStroke
Выполните заливку, затем штриховые операции на тексте.
Доступный в OS X v10.0 и позже.
-
kCGTextInvisible
kCGTextInvisible
Не составляйте текст, но действительно обновите текстовую позицию.
Доступный в OS X v10.0 и позже.
-
kCGTextFillClip
kCGTextFillClip
Выполните операцию заполнения, затем пересеките текст с текущей траекторией отсечения.
Доступный в OS X v10.0 и позже.
-
kCGTextStrokeClip
kCGTextStrokeClip
Выполните штриховую работу, затем пересеките текст с текущей траекторией отсечения.
Доступный в OS X v10.0 и позже.
-
kCGTextFillStrokeClip
kCGTextFillStrokeClip
Выполните заливку, тогда перечеркивают операции, затем пересекают текст с текущей траекторией отсечения.
Доступный в OS X v10.0 и позже.
-
kCGTextClip
kCGTextClip
Указывает для пересечения текста с текущей траекторией отсечения. Этот режим не красит текст.
Доступный в OS X v10.0 и позже.
Обсуждение
Вы обеспечиваете текстовый режим получения, постоянный для функции
CGContextSetTextDrawingMode
установить режим получения текущего текста для графического контекста. Текстовые режимы получения определяют, как Кварц представляет отдельные глифы на экране. Например, можно установить текстовый режим получения для рисования текста, заполненного или обрисованного в общих чертах (перечеркиваемый) или оба. Можно также создать специальные эффекты с текстовыми режимами рисования отсечения, такими как отсечение изображения к форме глифа.Оператор импорта
Objective C
@import CoreGraphics;
Swift
import CoreGraphics
Доступность
Доступный в OS X v10.0 и позже.
-
-
Текстовые кодировки для шрифтов.
Объявление
Objective C
enum CGTextEncoding { kCGEncodingFontSpecific, kCGEncodingMacRoman }; typedef enum CGTextEncoding CGTextEncoding;
Константы
-
kCGEncodingFontSpecific
kCGEncodingFontSpecific
Встроенное кодирование шрифта.
Доступный в OS X v10.0 и позже.
-
kCGEncodingMacRoman
kCGEncodingMacRoman
Макрочеловек, кодирующий. Макрочеловек является вариантом ASCII, первоначально создаваемым для использования в Mac OS, в котором символы 127 и ниже являются ASCII и символами 128 и выше являются неанглийскими символами и символами.
Доступный в OS X v10.0 и позже.
Обсуждение
Для получения дополнительной информации об установке шрифта в графическом контексте посмотрите
CGContextSelectFont
.Оператор импорта
Objective C
@import CoreGraphics;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
-