Класс Path2D

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

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

Path2D предоставляет именно те средства, которые необходимы для базового построения и управления геометрической траекторией и реализации вышеперечисленных интерфейсов с небольшим дополнительным интерпретацией. Если необходимо манипулировать внутренними областями замкнутых геометрических фигур, выходящими за рамки простой проверки попадания, класс Area предоставляет дополнительные возможности, специально ориентированные на замкнутые фигуры. Хотя оба класса номинально реализуют интерфейс Shape, они различаются по назначению, и вместе они обеспечивают два полезных представления геометрической фигуры, где Path2D в основном работает с траекторией, образованной сегментами пути, а Area больше занимается интерпретацией и манипулированием замкнутых областей 2D геометрического пространства.

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

Поля

WIND_EVEN_ODD

public static final int WIND_EVEN_ODD

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

С момента:

1.6

См. также:

PathIterator.WIND_EVEN_ODD, Значения постоянных полей

WIND_NON_ZERO

public static final int WIND_NON_ZERO

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

С момента:

1.6

См. также:

PathIterator.WIND_NON_ZERO, Значения постоянных полей

Методы

moveTo

public abstract void moveTo(double x,
                            double y)

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

Параметры:

x - указанная координата X

y - указанная координата Y

С момента:

1.6

lineTo

public abstract void lineTo(double x,
                            double y)

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

Параметры:

x - указанная координата X

y - указанная координата Y

С момента:

1.6

quadTo

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

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

Параметры:

x1 - координата X квадратичной контрольной точки

y1 - координата Y квадратичной контрольной точки

x2 - координата X конечной точки

y2 - координата Y конечной точки

С момента:

1.6

curveTo

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

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

Параметры:

x1 - координата X первой контрольной точки Безье

y1 - координата Y первой контрольной точки Безье

x2 - координата X второй контрольной точки Безье

y2 - координата Y второй контрольной точки Безье

x3 - координата X конечной точки

y3 - координата Y конечной точки

С момента:

1.6

closePath

public final void closePath()

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

С момента:

1.6

append

public final void append(Shape s,
                         boolean connect)

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

Параметры:

s - Shape, чья геометрия добавляется в этот путь

connect - логическое значение, контролирующее преобразование начального moveTo сегмента в lineTo сегмент для соединения новой геометрии с существующим путём

С момента:

1.6

append

public abstract void append(PathIterator pi,
                            boolean connect)

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

Параметры:

pi - PathIterator, чья геометрия добавляется в этот путь

connect - логическое значение, контролирующее преобразование начального moveTo сегмента в lineTo сегмент для соединения новой геометрии с существующим путём

С момента:

1.6

getWindingRule

public final int getWindingRule()

Возвращает правило обхода для заливки.

Возвращает:

целое число, представляющее текущее правило обхода.

С момента:

1.6

См. также:

WIND_EVEN_ODD, WIND_NON_ZERO, setWindingRule(int)

setWindingRule

public final void setWindingRule(int rule)

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

Параметры:

rule - целое число, представляющее указанное правило обхода

Исключения:

IllegalArgumentException - если rule не равно ни WIND_EVEN_ODD, ни WIND_NON_ZERO

С момента:

1.6

См. также:

getWindingRule()

getCurrentPoint

public final Point2D getCurrentPoint()

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

Возвращает:

объект Point2D содержащий конечные координаты пути или null, если в пути нет точек.

С момента:

1.6

reset

public final void reset()

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

С момента:

1.6

transform

public abstract void transform(AffineTransform at)

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

Параметры:

at - AffineTransform используемый для преобразования области

С момента:

1.6

createTransformedShape

public final Shape createTransformedShape(AffineTransform at)

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

Параметры:

at - AffineTransform используемый для преобразования нового Shape.

Возвращает:

новый Shape, преобразованный с помощью указанного AffineTransform.

С момента:

1.6

getBounds

public final Rectangle getBounds()

Задано в:

getBounds в интерфейсе Shape

Возвращает:

целочисленное значение Rectangle , которое полностью охватывает Shape.

С момента:

1.6

См. также:

Shape.getBounds2D()

contains

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

Параметры:

pi - указанный PathIterator

x - указанная координата X

y - указанная координата Y

Возвращает:

true если указанные координаты находятся внутри указанной PathIterator; false в противном случае

С момента:

1.6

contains

public static boolean contains(PathIterator pi,
                               Point2D p)

Параметры:

pi - указанный PathIterator

p - указанный Point2D

Возвращает:

true если указанные координаты находятся внутри указанной PathIterator; false в противном случае

С момента:

1.6

contains

public final boolean contains(double x,
                              double y)

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

Определено в:

contains в интерфейсе Shape

Параметры:

x - указанная координата X для проверки

y - указанная координата Y для проверки

Возвращает:

true если указанные координаты находятся внутри границы Shape; false в противном случае.

С момента:

1.6

contains

public final boolean contains(Point2D p)

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

Определено в:

contains в интерфейсе Shape

Параметры:

p - указанный Point2D для проверки

Возвращает:

true если указанный Point2D находится внутри границы Shape; false в противном случае.

С момента:

1.6

contains

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

Параметры:

pi - указанный PathIterator

x - указанная координата X

y - указанная координата Y

w - ширина указанного прямоугольного участка

h - высота указанного прямоугольного участка

Возвращает:

true если указанный PathIterator содержит указанный прямоугольный участок; false в противном случае.

С момента:

1.6

contains

public static boolean contains(PathIterator pi,
                               Rectangle2D r)

Параметры:

pi - указанный PathIterator

r - указанный Rectangle2D

Возвращает:

true если указанный PathIterator содержит указанный Rectangle2D; false в противном случае.

С момента:

1.6

contains

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

Определено в:

contains в интерфейсе Shape

Параметры:

x - координата X верхнего левого угла указанного прямоугольного участка

y - координата Y верхнего левого угла указанного прямоугольного участка

w - ширина указанного прямоугольного участка

h - высота указанного прямоугольного участка

Возвращает:

true если внутренняя область Shape полностью содержит указанный прямоугольный участок; false в противном случае или, если Shape содержит прямоугольный участок и метод intersects возвращает true и вычисления включения были бы слишком дорогими.

С момента:

1.6

См. также:

Area, Shape.intersects(double, double, double, double)

contains

public final boolean contains(Rectangle2D r)

Определено в:

contains в интерфейсе Shape

Параметры:

r - Указанная Rectangle2D

Возвращает:

true если внутренняя область Shape полностью содержит Rectangle2D; false в противном случае или если Shape содержит Rectangle2D и метод intersects возвращает true и вычисления включения были бы слишком дорогостоящими.

С:

1.6

См. также:

Shape.contains(double, double, double, double)

intersects

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

Параметры:

pi - указанный PathIterator

x - указанная координата X

y - указанная координата Y

w - ширина указанного набора прямоугольных координат

h - высота указанного набора прямоугольных координат

Возвращает:

true если указанный PathIterator и внутренняя область указанного набора прямоугольных координат пересекаются друг с другом; false в противном случае.

С:

1.6

intersects

public static boolean intersects(PathIterator pi,
                                 Rectangle2D r)

Параметры:

pi - указанный PathIterator

r - указанный Rectangle2D

Возвращает:

true если указанный PathIterator и внутренняя область указанного Rectangle2D пересекаются друг с другом; false в противном случае.

С:

1.6

intersects

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

Определено в:

intersects в интерфейсе Shape

Параметры:

x - координата X левого верхнего угла заданной прямоугольной области

y - координата Y левого верхнего угла заданной прямоугольной области

w - ширина заданной прямоугольной области

h - высота заданной прямоугольной области

Возвращает:

true если внутренняя область Shape и внутренняя область прямоугольной области пересекаются или, если они, скорее всего, пересекаются, а вычисления пересечения являются слишком дорогостоящими; false в противном случае.

С:

1.6

См. также:

Area

intersects

public final boolean intersects(Rectangle2D r)

Определено в:

intersects в интерфейсе Shape

Параметры:

r - указанный Rectangle2D

Возвращает:

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

С:

1.6

См. также:

Shape.intersects(double, double, double, double)

getPathIterator

public final PathIterator getPathIterator(AffineTransform at,
                                          double flatness)

Определено в:

getPathIterator в интерфейсе Shape

Параметры:

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

flatness - максимальное расстояние, на которое отрезки прямых, используемые для приближения криволинейных отрезков, разрешается отклоняться от любой точки исходной кривой

Возвращает:

новый PathIterator, который независимо проходит по сплющенному представлению геометрии Shape.

С:

1.6

clone

public abstract Object clone()

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

Переопределяет:

clone в классе Object

Возвращает:

клонированный экземпляр.

Исключения:

OutOfMemoryError - если памяти недостаточно.

С:

1.6

См. также:

Cloneable