UIBezierPath класс позволяет Вам определить путь, состоящий из прямых и изогнутых сегментов линии и рендеринга, соединяющих каналом в Ваших пользовательских представлениях. Вы используете этот класс первоначально для указания просто геометрии для пути. Пути могут определить простые формы, такие как прямоугольники, овалы и дуги, или они могут определить сложные многоугольники, включающие смесь прямых и изогнутых сегментов линии. После определения формы можно использовать дополнительные методы этого класса представить путь в текущем контексте получения.
A UIBezierPath возразите комбинирует геометрию пути с атрибутами, описывающими путь во время рендеринга. Вы устанавливаете геометрию и атрибуты отдельно и можете изменить их независимый от друг друга. Как только у Вас есть объект, сконфигурировал способ, которым Вы хотите его, можно сказать ему рисовать себя в текущем контексте. Поскольку создание, конфигурация, и представляющий процесс являются всеми отличными шагами, объекты контуров Безье могут быть снова использованы легко в Вашем коде. Можно даже использовать тот же объект представить ту же форму многократно, возможно изменяя опции рендеринга между последовательными вызовами получения.
Вы устанавливаете геометрию пути путем управления текущей точкой пути. При создании нового пустого объекта контуров текущая точка не определена и должна быть установлена явно. Для перемещения текущей точки, не таща сегмент Вы используете moveToPoint: метод. Все другие методы приводят к добавлению или линейные сегменты или сегменты кривой к пути. Методы для добавления новых сегментов всегда предполагают, что Вы запускаете в текущей точке и заканчиваетесь в некоторой новой точке, которую Вы указываете. После добавления сегмента конечная точка нового сегмента автоматически становится текущей точкой.
Единственный объект контуров Безье может содержать любое число открытых или закрытых подпутей, где каждый подпуть представляет связанную серию сегментов контура. Вызов closePath метод закрывает подпуть путем добавления сегмента прямой линии от текущей точки до первой точки по подпути. Вызов moveToPoint: метод заканчивает текущий подпуть (не закрывая его) и устанавливает начальную точку следующего подпути. Подпути объекта контуров Безье совместно используют те же атрибуты получения и должны управляться как группа. Для рисования подпутей с различными атрибутами необходимо вставить каждый подпуть его собственное UIBezierPath объект.
После конфигурирования геометрии и атрибутов пути Безье, Вы рисуете путь в текущем графическом контексте с помощью stroke и fill методы. stroke метод прослеживает схему пути с помощью текущего цвета обводки и атрибутов объекта контуров Безье. Точно так же fill метод заполняет область, включенную путем с помощью текущего цвета заливки. (Вы выбираете цвет обводки и цвет заливки с помощью UIColor класс.)
В дополнение к использованию объекта контуров Безье для рисования форм можно также использовать его для определения новой области отсечения. addClip метод пересекает форму, представленную объектом контуров с текущей областью отсечения графического контекста. Во время последующего получения только содержание, находящееся в новой перекрестной области, фактически представляется к графическому контексту.
Этот метод создает закрытый подпуть путем запуска в источнике rect и добавление линейных сегментов в направлении по часовой стрелке (относительно системы координат по умолчанию).
Этот метод создает закрытый подпуть, приближающий овальное использование последовательности кривых Bézier. Путь создается в направлении по часовой стрелке (относительно системы координат по умолчанию). Если rect параметр указывает квадрат, нанесенный путь является кругом.
Радиус каждого овального угла. Значение 0 результаты в прямоугольнике без скругленных углов. Значения, больше, чем половина ширины или высоты прямоугольника, фиксируются соответственно к половине ширины или высоты.
Возвращаемое значение
Новый объект контуров с округленным прямоугольным контуром.
Обсуждение
Этот метод создает закрытый подпуть, продолжающийся в направлении по часовой стрелке (относительно системы координат по умолчанию), как это создает необходимую строку и сегменты кривой.
Значение битовой маски, идентифицирующее углы, которые Вы хотите округленный. Можно использовать этот параметр для раунда только подмножество углов прямоугольника.
cornerRadii
Радиус каждого овального угла. Значения, больше, чем половина ширины или высоты прямоугольника, фиксируются соответственно к половине ширины или высоты.
Возвращаемое значение
Новый объект контуров с округленным прямоугольным контуром.
Обсуждение
Этот метод создает закрытый подпуть, продолжающийся в направлении по часовой стрелке (относительно системы координат по умолчанию), как это создает необходимую строку и сегменты кривой.
Указывает, что центральная точка круга (в текущей системе координат) раньше определяла дугу.
radius
Указывает, что радиус круга раньше определял дугу.
startAngle
Указывает стартовый угол дуги (измеренный в радианах).
endAngle
Указывает угол конца дуги (измеренный в радианах).
clockwise
Направление, в котором можно нарисовать дугу.
Возвращаемое значение
Новый объект контуров с указанной дугой.
Обсуждение
Этот метод создает открытый подпуть. Создаваемая дуга находится на периметре указанного круга. Когда нарисовано в системе координат по умолчанию, запуск и углы конца основываются на круге модуля, показанном на рисунке 1. Например, указание угла запуска 0 радианы, угол конца π радианы и установка clockwise параметр к YEStrue рисует нижнюю половину круга. Однако указание то же запускает и заканчивает углы, но установку clockwise набор параметра к NOfalse рисует верхнюю часть круга.
Рисунок 1Angles в системе координат по умолчанию
После вызова этого метода текущая точка установлена в точку на дуге под углом конца круга.
Новый объект контуров с той же формой контура, но для которого путь был создан в обратном направлении.
Обсуждение
Инвертирование пути не обязательно изменяет появление пути, когда представлено. Вместо этого это изменяет направление, в котором нарисованы сегменты контура. Например, инвертирование пути прямоугольника (чьи линейные сегменты обычно рисуются, запускаясь в источнике и продолжаясь в направлении против часовой стрелки) заставляет свои линейные сегменты быть нарисованными в направлении по часовой стрелке вместо этого. Рисование обратного пути могло влиять на появление заполненного образца, в зависимости от образца и правила заливки в использовании.
Этот метод инвертирует каждый полный или частичный подпуть в объекте контуров индивидуально.
Этот метод неявно заканчивает текущий подпуть (если таковые имеются) и устанавливает текущую точку в значение в point параметр. При окончании предыдущего подпути этот метод фактически не закрывает подпуть. Поэтому первые и последние точки предыдущего подпути не подключены друг к другу.
Для многих операций пути необходимо вызвать этот метод прежде, чем дать любые команды, заставляющие линейный сегмент или сегмент кривой быть нарисованным.
Пункт назначения линейного сегмента, указанного в текущей системе координат.
Обсуждение
Этот метод создает сегмент прямой линии, запускающийся в текущей точке и заканчивающийся в точке, указанной point параметр. После добавления линейного сегмента этот метод обновляет текущую точку к значению в point.
Необходимо установить текущую точку пути (использующий moveToPoint: метод или посредством предыдущего создания линейного сегмента или сегмента кривой) перед вызовом этого метода. Если путь пуст, этот метод ничего не делает.
Указывает, что центральная точка круга (в текущей системе координат) раньше определяла дугу.
radius
Указывает, что радиус круга раньше определял дугу.
startAngle
Указывает стартовый угол дуги (измеренный в радианах).
endAngle
Указывает угол конца дуги (измеренный в радианах).
clockwise
Направление, в котором можно нарисовать дугу.
Обсуждение
Этот метод добавляет указанную дугу, начинающуюся в текущей точке. Создаваемая дуга находится на периметре указанного круга. Когда нарисовано в системе координат по умолчанию, запуск и углы конца основываются на круге модуля, показанном на рисунке 1. Например, указание угла запуска 0 радианы, угол конца π радианы и установка clockwise параметр к YEStrue рисует нижнюю половину круга. Однако указание то же запускает и заканчивает углы, но установку clockwise набор параметра к NOfalse рисует верхнюю часть круга.
После вызова этого метода текущая точка установлена в точку на дуге под углом конца круга.
Первая контрольная точка, которая будет использовать при вычислениях кривой.
controlPoint2
Вторая контрольная точка для использования при вычислениях кривой.
Обсуждение
Этот метод добавляет кубическую кривую Bézier от текущей точки, до конца указывают указанный endPoint параметр. Эти две контрольных точки определяют искривление сегмента. Рисунок 2 показывает, что приближение кубического Bézier изгибает данный ряд начальных точек. Точное искривление сегмента включает сложное математическое отношение между всеми точками и хорошо документируется онлайн.
Рисунок 2A кубическая кривая Bézier
Необходимо установить текущую точку пути (использующий moveToPoint: метод или посредством предыдущего создания линейного сегмента или сегмента кривой) перед вызовом этого метода. Если путь пуст, этот метод ничего не делает. После добавления сегмента кривой этот метод обновляет текущую точку к значению в point.
Этот метод добавляет квадратичную кривую Bézier от текущей точки, до конца указывают указанный endPoint параметр. Отношения между текущей точкой, контрольной точкой и конечной точкой - то, что определяет фактическую кривую. Рисунок 3 показывает некоторые примеры квадратичных кривых и приблизительной формы кривой на основе некоторых демонстрационных точек. Точное искривление сегмента включает сложное математическое отношение между точками и хорошо документируется онлайн.
Примеры кривой рисунка 3Quadratic
Необходимо установить текущую точку пути (использующий moveToPoint: метод или посредством предыдущего создания линейного сегмента или сегмента кривой) перед вызовом этого метода. Если путь пуст, этот метод ничего не делает. После добавления сегмента кривой этот метод обновляет текущую точку к значению в point.
Этот метод закрывает текущий подпуть путем создания линейного сегмента между первыми и последними точками по подпути. Этот метод впоследствии обновляет текущую точку до конца недавно создаваемого линейного сегмента, который является также первой точкой по теперь закрытому подпути.
Этот метод добавляет, что команды раньше создавали путь в bezierPath до конца пути получателя. Этот метод явно не пытается соединить подпути в двух объектах, несмотря на то, что операции в bezierPath мог бы все еще вызвать тот эффект.
Это свойство содержит снимок пути в любом данном моменте времени. Получение этого свойства возвращает неизменный объект контуров, который можно передать Базовым Графическим функциям. Сам объект контуров принадлежит UIBezierPath возразите и допустимо только, пока Вы не делаете дальнейшие модификации к пути.
Можно установить значение этого свойства к пути, Вы создали использование функций Базовой Графической платформы. При установке нового пути этот метод делает копию пути, который Вы обеспечиваете.
Значение в этом свойстве представляет начальную точку для новой строки и сегментов кривой. Если путь в настоящее время пуст, это свойство содержит значение CGPointZero.
Ширина строки определяет толщину перечеркиваемого пути получателя. Ширина 0 интерпретируется как самая тонкая строка, которая может быть представлена на определенном устройстве. Фактическая представленная ширина строки может варьироваться от указанной ширины целых 2 пикселями устройства, в зависимости от позиции строки относительно пиксельной сетки и текущих настроек сглаживания. Ширина строки может также быть затронута масштабными коэффициентами, указанными в текущей матрице преобразования активного графического контекста.
Стиль окончания линии применяется к запуску и конечным точкам любых открытых подпутей. Это свойство не влияет на закрытые подпути. Стиль окончания линии по умолчанию kCGLineCapButt.
Предельный угол стыка помогает Вам избежать скачков по путям, использующим kCGLineJoinMiter стиль соединения. Если отношение длины среза — т.е. диагональная длина соединения среза — к толщине строки превышает предельный угол стыка, соединение преобразовывается в косоугольное соединение. Предельный угол стыка по умолчанию равняется 10, который приводит к преобразованию срезов, угол которых в соединении составляет меньше чем 11 градусов.
Значение плоскости измеряет самое большое допустимое расстояние (измеренный в пикселях) между точкой на истинной кривой и точкой на представленной кривой. Меньшие значения приводят к более гладким кривым, но требуют большего количества времени вычисления. Большие значения приводят к более зубчатым кривым, но представляются намного быстрее. Значение плоскости по умолчанию 0.6.
В большинстве случаев Вы не должны изменять значение плоскости. Однако Вы могли бы увеличить стоимость плоскости временно для минимизации количества времени, которое она занимает для рисования формы временно (такой как во время прокрутки).
Булевская переменная, указывающая, используется ли ровно-нечетное вьющееся правило для рисования путей.
Объявление
Swift
var usesEvenOddFillRule: Bool
Objective C
@property(nonatomic)BOOLusesEvenOddFillRule
Обсуждение
Если YEStrue, путь заполняется с помощью ровно-нечетного правила. Если NOfalse, это заполняется с помощью ненулевого правила. Оба правила являются алгоритмами для определения который области пути заполниться текущим цветом заливки. Луч нарисован из точки в данной области к точке где угодно вне границ пути. Общее количество пересеченных строк пути (включая неявные строки пути) и направление каждой строки пути тогда интерпретируется следующим образом:
Для ровно-нечетного правила, если общее количество пересечений пути нечетно, точка считается в пути, и соответствующая область заполнена. Если число пересечений даже, точка считается вне пути, и область не заполнена.
Для ненулевого правила пересечение слева направо соединяет количества каналом как +1 и пересечение справа налево количества пути как-1. Если сумма пересечений является ненулевой, точка считается в пути, и соответствующая область заполнена. Если сумма 0, точка вне пути, и область не заполнена.
Значение по умолчанию этого свойства NOfalse. Для получения дополнительной информации о проветривании правил и как они применяются к подпутям, посмотрите Кварц 2D Руководство по программированию.
Массив C-стиля значений с плавающей точкой, содержащий длины (измеренный в точках) линейных сегментов и разрывов в образце. Значения в альтернативе массива, начиная с первой продолжительности линейного сегмента, сопровождаемой первой длиной разрыва, сопровождаемой второй продолжительностью линейного сегмента, и т.д.
count
Число значений в pattern.
phase
Смещение, при котором можно начать рисовать образец, измерилось в точках вдоль образца пунктирной линии. Например, значение фазы 6 для образца 5-2-3-2 заставил бы получение начинаться посреди первого разрыва.
На вводе, массиве C-стиля значений с плавающей точкой, или nil если Вы не хотите значения образца. На выводе этот массив содержит длины (измеренный в точках) линейных сегментов и разрывов в образце. Значения в альтернативе массива, начиная с первой продолжительности линейного сегмента, сопровождаемой первой длиной разрыва, сопровождаемой второй продолжительностью линейного сегмента, и т.д.
count
На вводе, указателе на целое число или nil если Вы не хотите число записей образца. На выводе, числе записей, записанных в pattern.
phase
На вводе, указателе на значение с плавающей точкой или nil если Вы не хотите фазу. На выводе это значение содержит смещение, при котором можно начать рисовать образец, измеренный в точках вдоль образца пунктирной линии. Например, фаза 6 в образце 5-2-3-2 заставила бы получение начинаться посреди первого разрыва.
Обсуждение
Массив в pattern параметр должен быть достаточно большим для содержания всех возвращенных значений в образце. Если Вы не уверены сколько значений, там мог бы быть, можно вызвать этот метод дважды. В первый раз Вы вызываете его, не передавайте значение для pattern но используйте возвращенное значение в count параметр для выделения массива чисел с плавающей точкой, которые можно тогда передать во втором разе.
Красит область включенной путем получателя с помощью текущих свойств получения.
Объявление
Swift
funcfill()
Objective C
- (void)fill
Обсуждение
Этот метод заполняет путь с помощью текущего цвета заливки и таща свойства. Если путь содержит какие-либо открытые подпути, этот метод неявно закрывает их прежде, чем нарисовать область заливки.
Нарисованная область включает пиксели прямо до, но не включая, сама строка пути. Для путей с большими ширинами строки это может привести к перекрытию между областью заливки и перечеркиваемым путем (который самостоятельно центрируется на строке пути).
Этот метод автоматически сохраняет текущее состояние графики до рисования и восстановлений, утверждающих, когда это сделано, таким образом, Вы не должны сохранять состояние графики сами.
Режим смешивания определяет, как заполненный путь составляется с любым существующим представленным содержанием.
alpha
Сумма прозрачности для применения к заполненному пути. Значения могут расположиться между 0.0 (прозрачный) и 1.0 (непрозрачный). Значения вне этого диапазона фиксируются к 0.0 или 1.0.
Обсуждение
Этот метод заполняет путь с помощью текущего цвета заливки и таща свойства (плюс указанный режим смешивания и значение прозрачности). Если путь содержит какие-либо открытые подпути, этот метод неявно закрывает их прежде, чем нарисовать область заливки.
Нарисованная область включает пиксели прямо до, но не включая, сама строка пути. Для путей с большими ширинами строки это может привести к перекрытию между областью заливки и перечеркиваемым путем (который самостоятельно центрируется на строке пути).
Этот метод автоматически сохраняет текущее состояние графики до рисования и восстановлений, утверждающих, когда это сделано, таким образом, Вы не должны сохранять состояние графики сами.
Чертит линию вдоль пути получателя с помощью текущих свойств получения.
Объявление
Swift
funcstroke()
Objective C
- (void)stroke
Обсуждение
Проведенная линия центрируется на пути с его сторонами, параллельными сегменту контура. Этот метод применяет текущие свойства получения к представленному пути.
Этот метод автоматически сохраняет текущее состояние графики до рисования и восстановлений, утверждающих, когда это сделано, таким образом, Вы не должны сохранять состояние графики сами.
Режим смешивания определяет, как перечеркиваемый путь составляется с любым существующим представленным содержанием.
alpha
Сумма прозрачности для применения к перечеркиваемому пути. Значения могут расположиться между 0.0 (прозрачный) и 1.0 (непрозрачный). Значения вне этого диапазона фиксируются к 0.0 или 1.0.
Обсуждение
Проведенная линия центрируется на пути с его сторонами, параллельными сегменту контура. Этот метод применяет текущий цвет обводки и свойства получения (плюс указанный режим смешивания и значение прозрачности) к представленному пути.
Этот метод автоматически сохраняет текущее состояние графики до рисования и восстановлений, утверждающих, когда это сделано, таким образом, Вы не должны сохранять состояние графики сами.
Пересекает область, включенную путем получателя с траекторией отсечения текущего графического контекста, и делает получающуюся форму текущей траекторией отсечения.
Объявление
Swift
funcaddClip()
Objective C
- (void)addClip
Обсуждение
Этот метод изменяет видимую область получения текущего графического контекста. После вызова его последующие операции рисования приводят к представленному содержанию, только если они происходят в закрашенной области указанного пути.
usesEvenOddFillRule свойство используется, чтобы определить, используется ли ровно-нечетное или ненулевое правило для определения области, включенной путем.
Точка для тестирования против пути, указанного в системе координат объекта контуров.
Возвращаемое значение
YEStrue если точка считается во вложенной области пути или NOfalse если это не.
Обсуждение
Получатель содержит указанную точку, если бы та точка находится в части закрытого подпути, который обычно красился бы во время операции заполнения. Этот метод использует значение usesEvenOddFillRule свойство для определения, какие части подпути были бы заполнены.
Точка не считается включенной путем, если бы это в открытом подпути, независимо от того, была ли та область бы нарисована во время операции заполнения. Поэтому для определения мыши совершает нападки на открытых контурах, необходимо создать копию объекта контуров и явно закрыть любые подпути (использующий closePath метод) прежде, чем вызвать этот метод.
Булево значение, указывающее, имеет ли путь какие-либо допустимые элементы. (только для чтения)
Объявление
Swift
var empty: Bool { get }
Objective C
@property(readonly,getter=isEmpty)BOOLempty
Обсуждение
Допустимые элементы пути включают команды, чтобы переместиться в указанную точку, чертить линию или сегмент кривой или закрыть путь. Таким образом путь не считают пустым, даже если все, что Вы делаете, вызвать moveToPoint: метод.
Значение в этом свойстве представляет наименьший прямоугольник, полностью включающий все точки в путь, включая любые контрольные точки для Bézier и квадратичных кривых.
Этот метод применяет указанное преобразование к точкам пути сразу. Модификации, сделанные к объекту контуров, являются постоянными. Если Вы не хотите постоянно изменять объект контуров, необходимо рассмотреть применение преобразования к копии.
Указанные константы отражают углы прямоугольника, не измененного аффинным преобразованием и нарисованного в системе координат по умолчанию (где источник находится в верхнем левом углу, и положительные значения расширяются вниз и вправо).
