Класс 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, для реализации поддержки метода Shape.contains(double, double).

public static boolean contains(PathIterator pi, Point2D p)

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

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

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, для реализации поддержки метода Shape.contains(double, double, double, double).

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

public static boolean contains(PathIterator pi, Rectangle2D r)

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

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

Этот метод может консервативно возвращать 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 для реализации поддержки метода Shape.intersects(double, double, double, double).

Этот метод может консервативно возвращать 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 до его текущего размера. Приложение может использовать эту операцию, чтобы минимизировать хранение пути.