Класс Path2D

public static final int WIND_EVEN_ODD

Правило чётности для определения внутренней области пути.

public static final int WIND_NON_ZERO

Правило ненулевого числа обходов для определения внутренней области пути.

public abstract void moveTo(double x, double y)

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

public abstract void lineTo(double x, double y)

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

public abstract void quadTo(double x1, double y1, double x2, double y2)

Добавляет к пути криволинейный сегмент, заданный двумя новыми точками, строя квадратичную кривую, проходящую через текущие координаты и заданные координаты (x2,y2), используя заданную точку (x1,y1) в качестве управляющей точки квадратичной параметрической кривой. Все координаты представлены числами двойной точности.

public abstract void curveTo(double x1, double y1, double x2, double y2, double x3, double y3)

Добавляет к пути криволинейный сегмент, заданный тремя новыми точками, строя кривую Безье, проходящую через текущие координаты и заданные координаты (x3,y3), используя заданные точки (x1,y1) и (x2,y2) в качестве управляющих точек кривой Безье. Все координаты представлены числами двойной точности.

public final void closePath()

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

public final void append(Shape s, boolean connect)

Добавляет геометрию указанного объекта Shape к пути, при необходимости соединяя новую геометрию с существующими сегментами пути отрезком. Если параметр connect равен true и путь не пуст, любой начальный moveTo в геометрии добавляемого Shape преобразуется в сегмент lineTo. Если конечные координаты такого соединительного сегмента lineTo совпадают с конечными координатами открытого в данный момент подпути, сегмент пропускается как избыточный. Правило обхода указанного Shape игнорируется, а добавленная геометрия подчиняется правилу обхода, заданному для этого пути.

public abstract void append(PathIterator pi, boolean connect)

Добавляет геометрию указанного объекта PathIterator к пути, при необходимости соединяя новую геометрию с существующими сегментами пути отрезком. Если параметр connect равен true и путь не пуст, любой начальный moveTo в геометрии добавляемого Shape преобразуется в сегмент lineTo. Если конечные координаты такого соединительного сегмента lineTo совпадают с конечными координатами открытого в данный момент подпути, сегмент пропускается как избыточный. Правило обхода указанного Shape игнорируется, а добавленная геометрия подчиняется правилу обхода, заданному для этого пути.

public final int getWindingRule()

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

public final void setWindingRule(int rule)

Устанавливает для этого пути указанное правило обхода.

public final Point2D getCurrentPoint()

Возвращает координаты, последними добавленные в конец пути, в виде объекта Point2D.

public final void reset()

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

public abstract void transform(AffineTransform at)

Преобразует геометрию этого пути с помощью указанного объекта AffineTransform. Геометрия преобразуется на месте, что навсегда изменяет границу, определяемую этим объектом.

public final Shape createTransformedShape(AffineTransform at)

Возвращает новый Shape, представляющий преобразованную версию этого Path2D. Обратите внимание, что точный тип и точность координат возвращаемого значения для этого метода не определены. Метод вернет Shape, точность которого для преобразованной геометрии будет не ниже точности, поддерживаемой этим Path2D, однако она может и не быть выше. Если важно соотношение точности и объема хранимых данных результата, для явного выбора следует использовать удобные конструкторы подклассов Path2D.Float и Path2D.Double.

public final Rectangle getBounds()

Возвращает целочисленный объект Rectangle, полностью охватывающий Shape. Обратите внимание, что нет гарантии, что возвращенный Rectangle является наименьшим ограничивающим прямоугольником, охватывающим Shape; гарантируется только, что Shape целиком находится внутри указанного Rectangle. Возвращенный Rectangle также может не охватывать Shape полностью, если Shape выходит за ограниченный диапазон целочисленного типа данных. Метод getBounds2D обычно возвращает более точный ограничивающий прямоугольник благодаря большей гибкости представления.

Обратите внимание, что определение принадлежности внутренней области может приводить к ситуациям, когда точки на определяющем контуре shape не считаются принадлежащими возвращенному объекту bounds, но только в тех случаях, когда эти точки также не считаются принадлежащими исходному shape.

Если point находится внутри shape согласно методу contains(point), то она должна находиться внутри возвращенного объекта границ Rectangle согласно методу contains(point) объекта bounds. В частности:

shape.contains(x,y) требует bounds.contains(x,y)

Если point не находится внутри shape, она всё же может находиться внутри объекта bounds:

bounds.contains(x,y) не подразумевает shape.contains(x,y)

public static boolean contains(PathIterator pi, double x, double y)

Проверяет, находятся ли указанные координаты внутри замкнутой границы указанного PathIterator.

Этот метод предоставляет базовые средства для реализации поддержки метода Shape.contains(double, double) классами, реализующими интерфейс Shape.

public static boolean contains(PathIterator pi, Point2D p)

Проверяет, находится ли указанная точка Point2D внутри замкнутой границы указанного PathIterator.

Этот метод предоставляет базовые средства для реализации поддержки метода Shape.contains(Point2D) классами, реализующими интерфейс Shape.

public final boolean contains(double x, double y)

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

public final boolean contains(Point2D p)

Проверяет, находится ли указанная точка Point2D внутри границы Shape, как описано в определении принадлежности внутренней области.

public static boolean contains(PathIterator pi, double x, double y, double w, double h)

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

Этот метод предоставляет базовые средства для реализации поддержки метода Shape.contains(double, double, double, double) классами, реализующими интерфейс Shape.

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

public static boolean contains(PathIterator pi, Rectangle2D r)

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

Этот метод предоставляет базовые средства для реализации поддержки метода Shape.contains(Rectangle2D) классами, реализующими интерфейс Shape.

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

public final boolean contains(double x, double y, double w, double h)

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

Метод Shape.contains() позволяет реализации Shape консервативно возвращать false в следующих случаях:

• метод intersect возвращает true; и
• вычисления, необходимые для определения того, полностью ли Shape содержит прямоугольную область, требуют чрезмерных затрат.

Это означает, что для некоторых Shapes этот метод может вернуть false, даже если Shape содержит прямоугольную область. Класс Area выполняет более точные геометрические вычисления, чем большинство объектов Shape, поэтому его можно использовать, если требуется более точный результат.

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

public final boolean contains(Rectangle2D r)

Проверяет, полностью ли внутренняя область Shape содержит указанный Rectangle2D. Метод Shape.contains() позволяет реализации Shape консервативно возвращать false в следующих случаях:

• метод intersect возвращает true; и
• вычисления, необходимые для определения того, полностью ли Shape содержит Rectangle2D, требуют чрезмерных затрат.

Это означает, что для некоторых Shapes этот метод может вернуть false, даже если Shape содержит Rectangle2D. Класс Area выполняет более точные геометрические вычисления, чем большинство объектов Shape, поэтому его можно использовать, если требуется более точный результат.

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

public static boolean intersects(PathIterator pi, double x, double y, double w, double h)

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

Этот метод предоставляет базовые средства для реализации поддержки метода Shape.intersects(double, double, double, double) классами, реализующими интерфейс Shape.

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

public static boolean intersects(PathIterator pi, Rectangle2D r)

Проверяет, пересекается ли внутренняя область указанного PathIterator с внутренней областью указанного Rectangle2D.

Этот метод предоставляет базовые средства для реализации интерфейса Shape и поддержки метода Shape.intersects(Rectangle2D).

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

public final boolean intersects(double x, double y, double w, double h)

Проверяет, пересекается ли внутренняя область Shape с внутренней областью указанной прямоугольной области. Считается, что прямоугольная область пересекается с Shape, если какая-либо точка принадлежит одновременно внутренней области Shape и указанной прямоугольной области.

Метод Shape.intersects() позволяет реализации Shape консервативно возвращать true в следующих случаях:

• высока вероятность пересечения прямоугольной области и Shape, но
• точное определение этого пересечения требует чрезмерно больших вычислительных затрат.

Это означает, что для некоторых Shapes этот метод может вернуть true, даже если прямоугольная область не пересекается с Shape. Класс Area выполняет более точные вычисления геометрического пересечения, чем большинство объектов Shape, поэтому его можно использовать, если требуется более точный результат.

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

public final boolean intersects(Rectangle2D r)

Проверяет, пересекается ли внутренняя область Shape с внутренней областью указанного Rectangle2D. Метод Shape.intersects() позволяет реализации Shape консервативно возвращать true в следующих случаях:

• высока вероятность пересечения Rectangle2D и Shape, но
• точное определение этого пересечения требует чрезмерно больших вычислительных затрат.

Это означает, что для некоторых Shapes этот метод может вернуть true, даже если Rectangle2D не пересекается с Shape. Класс Area выполняет более точные вычисления геометрического пересечения, чем большинство объектов Shape, поэтому его можно использовать, если требуется более точный результат.

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

public final PathIterator getPathIterator(AffineTransform at, double flatness)

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

Итератор возвращает только типы точек SEG_MOVETO, SEG_LINETO и SEG_CLOSE.

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

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

Каждый вызов этого метода возвращает новый объект PathIterator, который независимо обходит геометрию объекта Shape, не завися от других одновременно используемых объектов PathIterator.

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

Итератор этого класса не является потокобезопасным. Это означает, что класс Path2D не гарантирует, что изменения геометрии объекта Path2D не повлияют на уже выполняющиеся итерации этой геометрии.

public abstract Object clone()

Создает новый объект того же класса, что и этот объект.

public abstract void trimToSize()

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