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