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