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

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

Разработчик

Ссылка платформы ApplicationServices ссылка CGContext

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

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

Ссылка CGContext

CGContextRef непрозрачный тип представляет Кварц 2D место назначения получения. Графический контекст содержит параметры получения, и вся специфичная для устройства информация должна была представить краску на странице месту назначения, является ли место назначения окном в приложении, растровом изображении, документе в формате PDF или принтере. Можно получить графический контекст при помощи Кварцевых функций создания контекста графики или при помощи высокоуровневых функций, предоставленных в Углероде, Какао или платформах Печати. Кварц обеспечивает функции создания для различных разновидностей Кварцевых контекстов графики включая растровые изображения и PDF. Платформа Какао обеспечивает функции для получения контекстов графики окна. Платформа Печати обеспечивает функции, получающие графический контекст, подходящий для целевого принтера.

Функции

Управление графическими контекстами
  • CGContextFlush (_:) CGContextFlush

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

    Объявление

    Swift

    func CGContextFlush(_ c: CGContext!)

    Objective C

    void CGContextFlush ( CGContextRef c );

    Параметры

    c

    Контекст окна для сбрасывания. При передаче контекста PDF или растрового контекста эта функция ничего не делает.

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGContextGetTypeID () CGContextGetTypeID

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

    Объявление

    Swift

    func CGContextGetTypeID() -> CFTypeID

    Objective C

    CFTypeID CGContextGetTypeID ( void );

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

    Идентификатор для непрозрачного типа CGContextRef.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGContextRelease CGContextRelease

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

    Объявление

    Objective C

    void CGContextRelease ( CGContextRef c );

    Параметры

    c

    Графический контекст для выпуска.

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Доступность

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

  • CGContextRetain CGContextRetain

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

    Объявление

    Objective C

    CGContextRef CGContextRetain ( CGContextRef c );

    Параметры

    c

    Графический контекст для сохранения.

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

    Тот же графический контекст Вы передали в как context параметр.

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Доступность

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

  • CGContextSynchronize (_:) CGContextSynchronize

    Отмечает контекст окна для обновления.

    Объявление

    Swift

    func CGContextSynchronize(_ c: CGContext!)

    Objective C

    void CGContextSynchronize ( CGContextRef c );

    Параметры

    c

    Контекст окна для синхронизации. При передаче контекста PDF или растрового контекста эта функция ничего не делает.

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

Сохранение и восстановление текущего состояния графики
  • CGContextSaveGState (_:) CGContextSaveGState

    Продвигает копию текущего состояния графики на штабель состояния графики для контекста.

    Объявление

    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 и позже.

  • CGContextRestoreGState (_:) CGContextRestoreGState

    Устанавливает текущее состояние графики в состояние, последний раз сохраненное.

    Объявление

    Swift

    func CGContextRestoreGState(_ c: CGContext!)

    Objective C

    void CGContextRestoreGState ( CGContextRef c );

    Параметры

    c

    Графический контекст, состояние которого Вы хотите изменить.

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

    См. также

    CGContextSaveGState

Получение и установка параметров состояния графики
  • CGContextGetInterpolationQuality (_:) CGContextGetInterpolationQuality

    Возвращает текущий уровень качества интерполяции для графического контекста.

    Объявление

    Swift

    func CGContextGetInterpolationQuality(_ c: CGContext!) -> CGInterpolationQuality

    Objective C

    CGInterpolationQuality CGContextGetInterpolationQuality ( CGContextRef context );

    Параметры

    c

    Графический контекст для исследования.

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

    Текущий уровень качества интерполяции.

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

    См. также

    CGContextSetInterpolationQuality

  • CGContextSetFlatness (_: _:) CGContextSetFlatness

    Устанавливает точность изогнутых контуров в графическом контексте.

    Объявление

    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 и позже.

  • CGContextSetInterpolationQuality (_: _:) CGContextSetInterpolationQuality

    Устанавливает уровень качества интерполяции для графического контекста.

    Объявление

    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 и позже.

    См. также

    CGContextGetInterpolationQuality

  • CGContextSetLineCap (_: _:) CGContextSetLineCap

    Устанавливает стиль для конечных точек линий, проведенных в графическом контексте.

    Объявление

    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 и позже.

  • CGContextSetLineDash (_: _: _: _:) CGContextSetLineDash

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

    Объявление

    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 и позже.

  • CGContextSetLineJoin (_: _:) CGContextSetLineJoin

    Устанавливает стиль для соединений связанных строк в графическом контексте.

    Объявление

    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 и позже.

  • CGContextSetLineWidth (_: _:) CGContextSetLineWidth

    Устанавливает ширину строки для графического контекста.

    Объявление

    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 и позже.

  • CGContextSetMiterLimit (_: _:) CGContextSetMiterLimit

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

    Объявление

    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 и позже.

  • CGContextSetPatternPhase (_: _:) CGContextSetPatternPhase

    Устанавливает фазу образца контекста.

    Объявление

    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 и позже.

  • CGContextSetFillPattern (_: _: _:) CGContextSetFillPattern

    Устанавливает узор заливки в указанном графическом контексте.

    Объявление

    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 и позже.

  • CGContextSetRenderingIntent (_: _:) CGContextSetRenderingIntent

    Устанавливает намерение рендеринга в текущем состоянии графики.

    Объявление

    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 и позже.

  • CGContextSetShouldAntialias (_: _:) CGContextSetShouldAntialias

    Наборы, сглаживающиеся на или прочь для графического контекста.

    Объявление

    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 и позже.

  • CGContextSetStrokePattern (_: _: _:) CGContextSetStrokePattern

    Устанавливает штриховой образец в указанном графическом контексте.

    Объявление

    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 и позже.

  • CGContextSetBlendMode (_: _:) CGContextSetBlendMode

    Наборы, как Кварц составляет демонстрационные значения для графического контекста.

    Объявление

    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 и позже.

  • CGContextSetAllowsAntialiasing (_: _:) CGContextSetAllowsAntialiasing

    Наборы, позволить ли сглаживаться для графического контекста.

    Объявление

    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 и позже.

  • CGContextSetAllowsFontSmoothing (_: _:) CGContextSetAllowsFontSmoothing

    Наборы, позволить ли сглаживание шрифта для графического контекста.

    Объявление

    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 и позже.

  • CGContextSetShouldSmoothFonts (_: _:) CGContextSetShouldSmoothFonts

    Включает или отключает сглаживание шрифта в графическом контексте.

    Объявление

    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 и позже.

  • CGContextSetAllowsFontSubpixelPositioning (_: _:) CGContextSetAllowsFontSubpixelPositioning

    Наборы, позволить ли субпиксельное расположение для графического контекста

    Объявление

    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 и позже.

  • CGContextSetShouldSubpixelPositionFonts (_: _:) CGContextSetShouldSubpixelPositionFonts

    Включает или отключает субпиксельное расположение в графический контекст.

    Объявление

    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 и позже.

  • CGContextSetAllowsFontSubpixelQuantization (_: _:) CGContextSetAllowsFontSubpixelQuantization

    Наборы, позволить ли субпиксельное квантование для графического контекста

    Объявление

    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 и позже.

  • CGContextSetShouldSubpixelQuantizeFonts (_: _:) CGContextSetShouldSubpixelQuantizeFonts

    Включает или отключает субпиксельное квантование в графическом контексте.

    Объявление

    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.

  • CGContextAddArc (_: _: _: _: _: _: _:) CGContextAddArc

    Добавляет дуга круга к текущему пути, которому возможно предшествует сегмент прямой линии

    Объявление

    Swift

    func CGContextAddArc(_ c: CGContext!, _ x: CGFloat, _ y: CGFloat, _ radius: CGFloat, _ startAngle: CGFloat, _ endAngle: CGFloat, _ clockwise: Int32)

    Objective C

    void CGContextAddArc ( CGContextRef c, CGFloat x, CGFloat y, CGFloat radius, CGFloat startAngle, CGFloat endAngle, int clockwise );

    Параметры

    c

    Графический контекст.

    x

    X-значение, в координатах пространства пользователя, для центра дуги.

    y

    Y-значение, в координатах пространства пользователя, для центра дуги.

    radius

    Радиус дуги, в координатах пространства пользователя.

    startAngle

    Угол к начальной точке дуги, измеренной в радианах от положительной оси X.

    endAngle

    Угол до конца точка дуги, измеренной в радианах от положительной оси X.

    clockwise

    Указать 1 для создания по часовой стрелке образуют дугу или 0 для создания против часовой стрелки образуют дугу.

    Обсуждение

    Дуга является сегментом круга с радиусом r центрируемый в точке (x,y). Когда Вы вызываете эту функцию, Вы обеспечиваете центральную точку, радиус и два угла в радианах. Кварц использует эту информацию для определения конечных точек дуги, и затем приближает новую дугу с помощью последовательности кубических кривых Bézier. clockwise параметр определяет направление, в котором создается дуга; фактическое направление заключительного пути зависит от текущей матрицы преобразования графического контекста. Например, на iOS, a UIView зеркально отражает Y-координату путем масштабирования значений Y -1. В зеркально отраженной системе координат указывая по часовой стрелке результаты дуги в против часовой стрелки дуге после того, как применяется трансформация.

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

    Конечная точка дуги становится новой текущей точкой пути.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

    См. также

    CGContextAddArcToPoint

  • CGContextAddArcToPoint (_: _: _: _: _: _:) CGContextAddArcToPoint

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

    Объявление

    Swift

    func CGContextAddArcToPoint(_ c: CGContext!, _ x1: CGFloat, _ y1: CGFloat, _ x2: CGFloat, _ y2: CGFloat, _ radius: CGFloat)

    Objective C

    void CGContextAddArcToPoint ( CGContextRef c, CGFloat x1, CGFloat y1, CGFloat x2, CGFloat y2, CGFloat radius );

    Параметры

    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 и позже.

    См. также

    CGContextAddArc
    CGContextAddArcToPoint

  • CGContextAddCurveToPoint (_: _: _: _: _: _: _:) CGContextAddCurveToPoint

    Добавляет кубическую кривую Bézier от текущей точки, с помощью предоставленных контрольных точек и конечной точки.

    Объявление

    Swift

    func CGContextAddCurveToPoint(_ c: CGContext!, _ cp1x: CGFloat, _ cp1y: CGFloat, _ cp2x: CGFloat, _ cp2y: CGFloat, _ x: CGFloat, _ y: CGFloat)

    Objective C

    void CGContextAddCurveToPoint ( CGContextRef c, CGFloat cp1x, CGFloat cp1y, CGFloat cp2x, CGFloat cp2y, CGFloat x, CGFloat y );

    Параметры

    c

    Графический контекст, текущий путь которого не пуст.

    cp1x

    X-значение, в координатах пространства пользователя, для первой контрольной точки кривой.

    cp1y

    Y-значение, в координатах пространства пользователя, для первой контрольной точки кривой.

    cp2x

    X-значение, в координатах пространства пользователя, для второй контрольной точки кривой.

    cp2y

    Y-значение, в координатах пространства пользователя, для второй контрольной точки кривой.

    x

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

    y

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

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

    См. также

    CGContextAddQuadCurveToPoint
    CGContextAddArcToPoint

  • CGContextAddLines (_: _: _:) CGContextAddLines

    Добавляет последовательность связанных прямолинейных сегментов к текущему пути.

    Объявление

    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 и позже.

    См. также

    CGContextAddLineToPoint

  • CGContextAddLineToPoint (_: _: _:) CGContextAddLineToPoint

    Добавляет сегмент прямой линии от текущей точки до предоставленной точки.

    Объявление

    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 и позже.

    См. также

    CGContextAddLines

  • CGContextAddPath (_: _:) CGContextAddPath

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

    Объявление

    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 и позже.

  • CGContextCopyPath (_:) CGContextCopyPath

    Возвращает Кварцевый объект контуров, созданный из текущей информации о пути в графическом контексте.

    Объявление

    Swift

    func CGContextCopyPath(_ context: CGContext!) -> CGPath!

    Objective C

    CGPathRef CGContextCopyPath ( CGContextRef context );

    Параметры

    context

    Графический контекст, текущий путь которого не пуст.

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

    Кварцевый объект контуров, содержащий текущие данные пути.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGContextAddQuadCurveToPoint (_: _: _: _: _:) CGContextAddQuadCurveToPoint

    Добавляет квадратичную кривую 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 и позже.

    См. также

    CGContextAddCurveToPoint
    CGContextAddArcToPoint

  • CGContextAddRect (_: _:) CGContextAddRect

    Добавляет прямоугольный контур к текущему пути.

    Объявление

    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 и позже.

    См. также

    CGContextAddRects

  • CGContextAddRects (_: _: _:) CGContextAddRects

    Добавляет набор прямоугольные контуры к текущему пути.

    Объявление

    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 и позже.

    См. также

    CGContextAddRect

  • CGContextBeginPath (_:) CGContextBeginPath

    Создает новый пустой путь в графическом контексте.

    Объявление

    Swift

    func CGContextBeginPath(_ c: CGContext!)

    Objective C

    void CGContextBeginPath ( CGContextRef c );

    Параметры

    c

    Графический контекст.

    Обсуждение

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

    Текущий путь не является частью состояния графики. Следовательно, сохранение и восстановление состояния графики не имеют никакого эффекта на текущий путь.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

    См. также

    CGContextClosePath

  • CGContextClosePath (_:) CGContextClosePath

    Завершения и завершают подпуть текущего пути.

    Объявление

    Swift

    func CGContextClosePath(_ c: CGContext!)

    Objective C

    void CGContextClosePath ( CGContextRef c );

    Параметры

    c

    Графический контекст.

    Обсуждение

    Добавляет строку от текущей точки до начальной точки текущего подпути и заканчивает подпуть.

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

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

    См. также

    CGContextAddPath

  • CGContextMoveToPoint (_: _: _:) CGContextMoveToPoint

    Начинает новый подпуть в точке, которую Вы указываете.

    Объявление

    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 и позже.

  • CGContextAddEllipseInRect (_: _:) CGContextAddEllipseInRect

    Добавляет эллипс, соответствующий в указанном прямоугольнике.

    Объявление

    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 и позже.

Рисование путей

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

  • CGContextClearRect (_: _:) CGContextClearRect

    Красит прозрачный прямоугольник.

    Объявление

    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 и позже.

  • CGContextDrawPath (_: _:) CGContextDrawPath

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

    Объявление

    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 и позже.

    См. также

    CGContextFillPath
    CGContextEOFillPath
    CGContextStrokePath

  • CGContextEOFillPath (_:) CGContextEOFillPath

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

    Объявление

    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 и позже.

    См. также

    CGContextFillPath
    CGContextStrokePath
    CGContextDrawPath

  • CGContextFillPath (_:) CGContextFillPath

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

    Объявление

    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 и позже.

    См. также

    CGContextEOFillPath
    CGContextStrokePath
    CGContextDrawPath

  • CGContextFillRect (_: _:) CGContextFillRect

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

    Объявление

    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 и позже.

    См. также

    CGContextFillRects

  • CGContextFillRects (_: _: _:) CGContextFillRects

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

    Объявление

    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 и позже.

    См. также

    CGContextFillRect

  • CGContextFillEllipseInRect (_: _:) CGContextFillEllipseInRect

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

    Объявление

    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 и позже.

  • CGContextStrokePath (_:) CGContextStrokePath

    Красит строку вдоль текущего пути.

    Объявление

    Swift

    func CGContextStrokePath(_ c: CGContext!)

    Objective C

    void CGContextStrokePath ( CGContextRef c );

    Параметры

    c

    Графический контекст.

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

    См. также

    CGContextDrawPath
    CGContextFillPath
    CGContextEOFillPath

  • CGContextStrokeRect (_: _:) CGContextStrokeRect

    Красит прямоугольный контур.

    Объявление

    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 и позже.

    См. также

    CGContextStrokeRectWithWidth

  • CGContextStrokeRectWithWidth (_: _: _:) CGContextStrokeRectWithWidth

    Красит прямоугольный контур, с помощью указанной ширины строки.

    Объявление

    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 и позже.

    См. также

    CGContextStrokeRect

  • CGContextReplacePathWithStrokedPath (_:) CGContextReplacePathWithStrokedPath

    Заменяет путь в графическом контексте с перечеркиваемой версией пути.

    Объявление

    Swift

    func CGContextReplacePathWithStrokedPath(_ c: CGContext!)

    Objective C

    void CGContextReplacePathWithStrokedPath ( CGContextRef c );

    Параметры

    c

    Графический контекст.

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGContextStrokeEllipseInRect (_: _:) CGContextStrokeEllipseInRect

    Перечеркивает эллипс, соответствующий в указанном прямоугольнике.

    Объявление

    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 и позже.

  • CGContextStrokeLineSegments (_: _: _:) CGContextStrokeLineSegments

    Перечеркивает последовательность линейных сегментов.

    Объявление

    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 и позже.

Получение информации о путях
  • CGContextIsPathEmpty (_:) CGContextIsPathEmpty

    Указывает, содержит ли текущий путь какие-либо подпути.

    Объявление

    Swift

    func CGContextIsPathEmpty(_ c: CGContext!) -> Bool

    Objective C

    bool CGContextIsPathEmpty ( CGContextRef context );

    Параметры

    c

    Графический контекст, содержащий путь для исследования.

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

    Возвраты 1 если путь контекста не содержит подпутей, иначе возвраты 0.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGContextGetPathCurrentPoint (_:) CGContextGetPathCurrentPoint

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

    Объявление

    Swift

    func CGContextGetPathCurrentPoint(_ c: CGContext!) -> CGPoint

    Objective C

    CGPoint CGContextGetPathCurrentPoint ( CGContextRef context );

    Параметры

    c

    Графический контекст, содержащий путь для исследования.

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

    A CGPoint значение, указывающее расположение, в пространстве пользователя, текущей точки по пути контекста. Если нет никакого пути, функциональных возвратов CGPointZero.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGContextGetPathBoundingBox (_:) CGContextGetPathBoundingBox

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

    Объявление

    Swift

    func CGContextGetPathBoundingBox(_ c: CGContext!) -> CGRect

    Objective C

    CGRect CGContextGetPathBoundingBox ( CGContextRef context );

    Параметры

    c

    Графический контекст, содержа путь, для исследования.

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

    A CGRect значение, указывающее размерности и расположение, в пространстве пользователя, ограничительной рамки пути. Если нет никакого пути, функциональных возвратов CGRectNull.

    Обсуждение

    Ограничительная рамка является наименьшим прямоугольником, полностью включающим все точки в путь, включая контрольные точки для Bézier кубические и квадратичные кривые.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGContextPathContainsPoint (_: _: _:) CGContextPathContainsPoint

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

    Объявление

    Swift

    func CGContextPathContainsPoint(_ context: CGContext!, _ point: CGPoint, _ mode: CGPathDrawingMode) -> Bool

    Objective 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 и позже.

Изменение траекторий отсечения
  • CGContextClip (_:) CGContextClip

    Изменяет текущую траекторию отсечения, с помощью ненулевого вьющегося правила числа.

    Объявление

    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 и позже.

    См. также

    CGContextEOClip

  • CGContextEOClip (_:) CGContextEOClip

    Изменяет текущую траекторию отсечения, с помощью ровно-нечетного правила.

    Объявление

    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 и позже.

    См. также

    CGContextClip

  • CGContextClipToRect (_: _:) CGContextClipToRect

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

    Объявление

    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 и позже.

    См. также

    CGContextClipToRects

  • CGContextClipToRects (_: _: _:) CGContextClipToRects

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

    Объявление

    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 и позже.

    См. также

    CGContextClipToRect

  • CGContextGetClipBoundingBox (_:) CGContextGetClipBoundingBox

    Возвращает ограничительную рамку траектории отсечения.

    Объявление

    Swift

    func CGContextGetClipBoundingBox(_ c: CGContext!) -> CGRect

    Objective C

    CGRect CGContextGetClipBoundingBox ( CGContextRef c );

    Параметры

    c

    Графический контекст для изменения.

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

    Ограничительная рамка траектории отсечения, указанной в пространстве пользователя.

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGContextClipToMask (_: _: _:) CGContextClipToMask

    Отображает маску в указанный прямоугольник и пересекает его с текущей областью отсечения графического контекста.

    Объявление

    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 и позже.

Выбирая цвет, цветовое пространство и теневые значения
  • CGContextSetAlpha (_: _:) CGContextSetAlpha

    Устанавливает уровень непрозрачности для объектов, нарисованных в графическом контексте.

    Объявление

    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 и позже.

  • CGContextSetCMYKFillColor (_: _: _: _: _: _:) CGContextSetCMYKFillColor

    Устанавливает текущий цвет заливки в значение в цветовом пространстве DeviceCMYK.

    Объявление

    Swift

    func CGContextSetCMYKFillColor(_ c: CGContext!, _ cyan: CGFloat, _ magenta: CGFloat, _ yellow: CGFloat, _ black: CGFloat, _ alpha: CGFloat)

    Objective C

    void CGContextSetCMYKFillColor ( CGContextRef context, CGFloat cyan, CGFloat magenta, CGFloat yellow, CGFloat black, CGFloat alpha );

    Параметры

    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 и позже.

    См. также

    CGContextSetCMYKStrokeColor

  • CGContextSetFillColor (_: _:) CGContextSetFillColor

    Устанавливает текущий цвет заливки.

    Объявление

    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 и позже.

  • CGContextSetCMYKStrokeColor (_: _: _: _: _: _:) CGContextSetCMYKStrokeColor

    Выбирает текущий цвет обводки к значению в цветовом пространстве DeviceCMYK.

    Объявление

    Swift

    func CGContextSetCMYKStrokeColor(_ c: CGContext!, _ cyan: CGFloat, _ magenta: CGFloat, _ yellow: CGFloat, _ black: CGFloat, _ alpha: CGFloat)

    Objective C

    void CGContextSetCMYKStrokeColor ( CGContextRef context, CGFloat cyan, CGFloat magenta, CGFloat yellow, CGFloat black, CGFloat alpha );

    Параметры

    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 и позже.

    См. также

    CGContextSetCMYKFillColor

  • CGContextSetFillColorSpace (_: _:) CGContextSetFillColorSpace

    Устанавливает пространство цвета заливки в графическом контексте.

    Объявление

    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 и позже.

  • CGContextSetFillColorWithColor (_: _:) CGContextSetFillColorWithColor

    Устанавливает текущий цвет заливки в графическом контексте, с помощью Кварцевого цвета.

    Объявление

    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 и позже.

    См. также

    CGContextSetFillColor

  • CGContextSetGrayFillColor (_: _: _:) CGContextSetGrayFillColor

    Устанавливает текущий цвет заливки в значение в цветовом пространстве 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 и позже.

    См. также

    CGContextSetGrayStrokeColor

  • CGContextSetGrayStrokeColor (_: _: _:) CGContextSetGrayStrokeColor

    Выбирает текущий цвет обводки к значению в цветовом пространстве 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 и позже.

    См. также

    CGContextSetGrayFillColor

  • CGContextSetRGBFillColor (_: _: _: _: _:) CGContextSetRGBFillColor

    Устанавливает текущий цвет заливки в значение в цветовом пространстве 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 и позже.

    См. также

    CGContextSetRGBStrokeColor

  • CGContextSetRGBStrokeColor (_: _: _: _: _:) CGContextSetRGBStrokeColor

    Выбирает текущий цвет обводки к значению в цветовом пространстве 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 и позже.

    См. также

    CGContextSetRGBFillColor

  • CGContextSetShadow (_: _: _:) CGContextSetShadow

    Включает затенение в графическом контексте.

    Объявление

    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 и позже.

  • CGContextSetShadowWithColor (_: _: _: _:) CGContextSetShadowWithColor

    Включает затенение с цветом графический контекст.

    Объявление

    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 и позже.

    См. также

    CGContextSetShadow

  • CGContextSetStrokeColor (_: _:) CGContextSetStrokeColor

    Выбирает текущий цвет обводки.

    Объявление

    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 и позже.

  • CGContextSetStrokeColorSpace (_: _:) CGContextSetStrokeColorSpace

    Устанавливает пространство цвета обводки в графическом контексте.

    Объявление

    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 и позже.

  • CGContextSetStrokeColorWithColor (_: _:) CGContextSetStrokeColorWithColor

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

    Объявление

    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 и позже.

    См. также

    CGContextSetStrokeColor

Преобразование пространства пользователя

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

  • CGContextConcatCTM (_: _:) CGContextConcatCTM

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

    Объявление

    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 и позже.

  • CGContextGetCTM (_:) CGContextGetCTM

    Возвращает текущую матрицу преобразования.

    Объявление

    Swift

    func CGContextGetCTM(_ c: CGContext!) -> CGAffineTransform

    Objective C

    CGAffineTransform CGContextGetCTM ( CGContextRef c );

    Параметры

    c

    Графический контекст.

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

    Матрица преобразования для текущего состояния графики указанного контекста.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGContextRotateCTM (_: _:) CGContextRotateCTM

    Поворачивает пользовательскую систему координат в контексте.

    Объявление

    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 и позже.

  • CGContextScaleCTM (_: _: _:) CGContextScaleCTM

    Изменяет масштаб пользовательской системы координат в контексте.

    Объявление

    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 и позже.

  • CGContextTranslateCTM (_: _: _:) CGContextTranslateCTM

    Изменяет источник пользовательской системы координат в контексте.

    Объявление

    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 и позже.

Используя слои прозрачности
  • CGContextBeginTransparencyLayer (_: _:) CGContextBeginTransparencyLayer

    Начинает слой прозрачности.

    Объявление

    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 и позже.

  • CGContextBeginTransparencyLayerWithRect (_: _: _:) CGContextBeginTransparencyLayerWithRect

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

    Объявление

    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 и позже.

  • CGContextEndTransparencyLayer (_:) CGContextEndTransparencyLayer

    Заканчивает слой прозрачности.

    Объявление

    Swift

    func CGContextEndTransparencyLayer(_ context: CGContext!)

    Objective C

    void CGContextEndTransparencyLayer ( CGContextRef context );

    Параметры

    context

    Графический контекст.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

    См. также

    CGContextBeginTransparencyLayer

Рисование изображения к графическому контексту
  • CGContextDrawTiledImage (_: _: _:) CGContextDrawTiledImage

    Неоднократно рисует изображение, масштабируемое к предоставленному прямоугольнику, для заполнения текущей области клипа.

    Объявление

    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 и позже.

  • CGContextDrawImage (_: _: _:) CGContextDrawImage

    Вовлекает изображение в графический контекст.

    Объявление

    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 к графическому контексту
  • CGContextDrawPDFPage (_: _:) CGContextDrawPDFPage

    Рисует страницу в текущем пространстве пользователя контекста 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 и позже.

Рисование с градиентом
  • CGContextDrawLinearGradient (_: _: _: _: _:) CGContextDrawLinearGradient

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

    Объявление

    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 и позже.

  • CGContextDrawRadialGradient (_: _: _: _: _: _: _:) CGContextDrawRadialGradient

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

    Объявление

    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 и позже.

Рисование со штриховкой
  • CGContextDrawShading (_: _:) CGContextDrawShading

    Заполняет траекторию отсечения контекста с указанной штриховкой.

    Объявление

    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 и позже.

    См. также

    CGContextDrawLinearGradient
    CGContextDrawRadialGradient

Установка основанного на странице графического контекста
  • CGContextBeginPage (_: _:) CGContextBeginPage

    Запускает новую страницу в основанном на странице графическом контексте.

    Объявление

    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 и позже.

  • CGContextEndPage (_:) CGContextEndPage

    Заканчивает текущую страницу в основанном на странице графическом контексте.

    Объявление

    Swift

    func CGContextEndPage(_ c: CGContext!)

    Objective C

    void CGContextEndPage ( CGContextRef c );

    Параметры

    c

    Основанный на странице графический контекст.

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

    См. также

    CGContextBeginPage

Рисование глифов
  • 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
    CGContextShowText
    CGContextShowTextAtPoint
    CGContextShowGlyphsWithAdvances

  • 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.

    См. также

    CGContextShowGlyphs
    CGContextShowText
    CGContextShowTextAtPoint
    CGContextShowGlyphsWithAdvances

  • CGContextShowGlyphsWithAdvances CGContextShowGlyphsWithAdvances (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.

    См. также

    CGContextShowGlyphs
    CGContextShowText
    CGContextShowTextAtPoint
    CGContextShowGlyphsAtPoint

  • CGContextShowGlyphsAtPositions (_: _: _: _:) CGContextShowGlyphsAtPositions

    Рисует глифы в предоставленной позиции.

    Объявление

    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 и позже.

Рисование текста
  • CGContextGetTextMatrix (_:) CGContextGetTextMatrix

    Возвращает матрицу текущего текста.

    Объявление

    Swift

    func CGContextGetTextMatrix(_ c: CGContext!) -> CGAffineTransform

    Objective C

    CGAffineTransform CGContextGetTextMatrix ( CGContextRef c );

    Параметры

    c

    Графический контекст, для которого можно получить текстовую матрицу.

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

    Матрица текущего текста.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGContextGetTextPosition (_:) CGContextGetTextPosition

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

    Объявление

    Swift

    func CGContextGetTextPosition(_ c: CGContext!) -> CGPoint

    Objective 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.

    См. также

    CGContextShowText
    CGContextShowTextAtPoint

  • CGContextSetCharacterSpacing (_: _:) CGContextSetCharacterSpacing

    Устанавливает интервал текущего символа.

    Объявление

    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 и позже.

  • CGContextSetFont (_: _:) CGContextSetFont

    Устанавливает шрифт платформы в графическом контексте.

    Объявление

    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 и позже.

    См. также

    CGFontCreateWithPlatformFont

  • CGContextSetFontSize (_: _:) CGContextSetFontSize

    Устанавливает размер текущего шрифта.

    Объявление

    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 и позже.

  • CGContextSetTextDrawingMode (_: _:) CGContextSetTextDrawingMode

    Устанавливает режим получения текущего текста.

    Объявление

    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 и позже.

  • CGContextSetTextMatrix (_: _:) CGContextSetTextMatrix

    Устанавливает матрицу текущего текста.

    Объявление

    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 и позже.

  • CGContextSetTextPosition (_: _: _:) CGContextSetTextPosition

    Устанавливает расположение, в котором составлен текст.

    Объявление

    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
    CGContextShowGlyphs
    CGContextShowGlyphsAtPoint
    CGContextShowGlyphsWithAdvances

  • 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.

    См. также

    CGContextShowText
    CGContextShowGlyphs
    CGContextShowGlyphsAtPoint
    CGContextShowGlyphsWithAdvances

Преобразование между пространством устройства и пространством пользователя
  • CGContextGetUserSpaceToDeviceSpaceTransform (_:) CGContextGetUserSpaceToDeviceSpaceTransform

    Возвращает аффинное преобразование, отображающее координаты пространства пользователя на координаты пространства устройства.

    Объявление

    Swift

    func CGContextGetUserSpaceToDeviceSpaceTransform(_ c: CGContext!) -> CGAffineTransform

    Objective C

    CGAffineTransform CGContextGetUserSpaceToDeviceSpaceTransform ( CGContextRef context );

    Параметры

    c

    Графический контекст.

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

    Аффинные преобразования, который отображает пространство пользователя графического контекста к пространству устройства.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGContextConvertPointToDeviceSpace (_: _:) CGContextConvertPointToDeviceSpace

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

    Объявление

    Swift

    func CGContextConvertPointToDeviceSpace(_ c: CGContext!, _ point: CGPoint) -> CGPoint

    Objective C

    CGPoint CGContextConvertPointToDeviceSpace ( CGContextRef context, CGPoint point );

    Параметры

    c

    Графический контекст.

    point

    Точка, в координатах пространства пользователя, для преобразования.

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

    Координаты точки в координатах пространства устройства.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

    См. также

    CGContextConvertPointToUserSpace

  • CGContextConvertPointToUserSpace (_: _:) CGContextConvertPointToUserSpace

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

    Объявление

    Swift

    func CGContextConvertPointToUserSpace(_ c: CGContext!, _ point: CGPoint) -> CGPoint

    Objective C

    CGPoint CGContextConvertPointToUserSpace ( CGContextRef context, CGPoint point );

    Параметры

    c

    Графический контекст.

    point

    Точка, в координатах пространства устройства, для преобразования.

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

    Координаты точки в координатах пространства пользователя.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

    См. также

    CGContextConvertPointToDeviceSpace

  • CGContextConvertSizeToDeviceSpace (_: _:) CGContextConvertSizeToDeviceSpace

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

    Объявление

    Swift

    func CGContextConvertSizeToDeviceSpace(_ c: CGContext!, _ size: CGSize) -> CGSize

    Objective C

    CGSize CGContextConvertSizeToDeviceSpace ( CGContextRef context, CGSize size );

    Параметры

    c

    Графический контекст.

    size

    Размер, в координатах пространства пользователя, для преобразования.

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

    Размер в координатах пространства устройства.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

    См. также

    CGContextConvertSizeToUserSpace

  • CGContextConvertSizeToUserSpace (_: _:) CGContextConvertSizeToUserSpace

    Возвращает размер, преобразовывающийся от координат пространства устройства до координат пространства пользователя

    Объявление

    Swift

    func CGContextConvertSizeToUserSpace(_ c: CGContext!, _ size: CGSize) -> CGSize

    Objective C

    CGSize CGContextConvertSizeToUserSpace ( CGContextRef context, CGSize size );

    Параметры

    c

    Графический контекст.

    size

    Размер, в координатах пространства устройства, для преобразования.

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

    Размер в координатах пространства пользователя.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

    См. также

    CGContextConvertSizeToDeviceSpace

  • CGContextConvertRectToDeviceSpace (_: _:) CGContextConvertRectToDeviceSpace

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

    Объявление

    Swift

    func CGContextConvertRectToDeviceSpace(_ c: CGContext!, _ rect: CGRect) -> CGRect

    Objective C

    CGRect CGContextConvertRectToDeviceSpace ( CGContextRef context, CGRect rect );

    Параметры

    c

    Графический контекст.

    rect

    Прямоугольник, в координатах пространства пользователя, для преобразования.

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

    Прямоугольник в координатах пространства устройства.

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

    См. также

    CGContextConvertRectToUserSpace

  • CGContextConvertRectToUserSpace (_: _:) CGContextConvertRectToUserSpace

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

    Объявление

    Swift

    func CGContextConvertRectToUserSpace(_ c: CGContext!, _ rect: CGRect) -> CGRect

    Objective C

    CGRect CGContextConvertRectToUserSpace ( CGContextRef context, CGRect rect );

    Параметры

    c

    Графический контекст.

    rect

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

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

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

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

    См. также

    CGContextConvertRectToDeviceSpace

Типы данных

  • CGContextRef CGContextRef

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

    Объявление

    Swift

    typealias CGContextRef = CGContext

    Objective C

    typedef struct CGContext * CGContextRef;

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

Константы

  • CGBlendMode

    Составление композита операций для изображений.

    Объявление

    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 и позже.

  • CGInterpolationQuality

    Уровни качества интерполяции для рендеринга изображения.

    Объявление

    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 и позже.

  • CGTextDrawingMode

    Режимы для рендеринга текста.

    Объявление

    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 и позже.

  • CGTextEncoding

    Текстовые кодировки для шрифтов.

    Объявление

    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.