Класс 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, который независимо от любых других одновременно используемых объектов PathIterator проходит по геометрии объекта Shape.

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

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

public abstract Object clone()

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

public abstract void trimToSize()

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