Класс Path2D.Double

java.lang.Object

java.awt.geom.Path2D

java.awt.geom.Path2D.Double

Все реализованные интерфейсы:: Shape, Serializable, Cloneable

Вложенный класс:: Path2D

public static non-sealed class Path2D.Double extends Path2D implements Serializable

Класс Double определяет геометрическую траекторию с координатами, хранящимися в числах с плавающей точкой двойной точности.

С:

1.6

См. также:

Краткое описание вложенных классов

Вложенные классы/интерфейсы, объявленные в классе java.awt.geom.Path2D

Path2D.Double, Path2D.Float

Краткое описание полей

Поля, объявленные в классе java.awt.geom.Path2D

WIND_EVEN_ODD, WIND_NON_ZERO

Краткое описание конструкторов

Конструктор	Описание
`Double()`	Создаёт новый пустой объект `Path2D` двойной точности с правилом обхода по умолчанию `Path2D.WIND_NON_ZERO`.
`Double(int rule)`	Создаёт новый пустой объект `Path2D` двойной точности с заданным правилом обхода для управления операциями, требующими определения внутренней части траектории.
`Double(int rule, int initialCapacity)`	Создаёт новый пустой объект `Path2D` двойной точности с заданным правилом обхода и заданной начальной ёмкостью для хранения сегментов траектории.
`Double(Shape s)`	Создаёт новый объект `Path2D` двойной точности из произвольного объекта `Shape`.
`Double(Shape s, AffineTransform at)`	Создаёт новый объект `Path2D` двойной точности из произвольного объекта `Shape`, преобразованного с помощью объекта `AffineTransform`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`final void`	`append(PathIterator pi, boolean connect)`	Добавляет геометрию указанного объекта `PathIterator` к траектории, возможно соединяя новую геометрию с существующими сегментами траектории отрезком прямой.
`final Object`	`clone()`	Создаёт новый объект того же класса, что и этот объект.
`final void`	`curveTo(double x1, double y1, double x2, double y2, double x3, double y3)`	Добавляет криволинейный сегмент, определяемый тремя новыми точками, к траектории, рисуя кривую Безье, пересекающую как текущие координаты, так и указанные координаты `(x3,y3)`, используя указанные точки `(x1,y1)` и `(x2,y2)` в качестве контрольных точек Безье.
`final Rectangle2D`	`getBounds2D()`	Возвращает прямоугольник ограничительной рамки `Shape` с высокой точностью и большей точностью, чем метод `getBounds`.
`final PathIterator`	`getPathIterator(AffineTransform at)`	Возвращает объект-итератор, который итерирует по границе `Shape` и предоставляет доступ к геометрии контура `Shape`.
`final void`	`lineTo(double x, double y)`	Добавляет точку к траектории, рисуя прямую линию от текущих координат до новых указанных координат, указанных в формате двойной точности.
`final void`	`moveTo(double x, double y)`	Добавляет точку к траектории, переходя в указанные координаты, указанные в формате двойной точности.
`final void`	`quadTo(double x1, double y1, double x2, double y2)`	Добавляет криволинейный сегмент, определяемый двумя новыми точками, к траектории, рисуя квадратичную кривую, которая пересекает как текущие координаты, так и указанные координаты `(x2,y2)`, используя указанную точку `(x1,y1)` в качестве квадратичной параметрической контрольной точки.
`final void`	`transform(AffineTransform at)`	Преобразует геометрию этой траектории с помощью указанного объекта `AffineTransform`.
`final void`	`trimToSize()`	Урезает ёмкость экземпляра Path2D до его текущего размера.

Методы, объявленные в классе java.awt.geom.Path2D

append, closePath, contains, contains, contains, contains, contains, contains, contains, contains, createTransformedShape, getBounds, getCurrentPoint, getPathIterator, getWindingRule, intersects, intersects, intersects, intersects, reset, setWindingRule

Методы, объявленные в классе java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание конструкторов

Double

public Double()

Создаёт новый пустой объект двойной точности Path2D с правилом обхода по умолчанию Path2D.WIND_NON_ZERO.

С момента:: 1.6

Double

public Double(int rule)

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

Параметры:

rule - правило обхода

Исключение:

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

С момента:

1.6

См. также:

Double

public Double(int rule, int initialCapacity)

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

Параметры:

rule - правило обхода

initialCapacity - оценка количества сегментов пути

Исключение:

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

NegativeArraySizeException - если initialCapacity отрицательное

С момента:

1.6

См. также:

Double

public Double(Shape s)

Создаёт новый объект двойной точности Path2D из произвольного объекта Shape. Все начальные геометрические данные и правило обхода для этого пути берутся из указанного объекта Shape.

Параметры:: s - указанный объект Shape
Исключение:: NullPointerException - если s равен null
С момента:: 1.6

Double

public Double(Shape s, AffineTransform at)

Создаёт новый объект двойной точности Path2D из произвольного объекта Shape, преобразованного с помощью объекта AffineTransform. Все начальные геометрические данные и правило обхода для этого пути берутся из указанного объекта Shape и преобразуются с помощью указанного объекта AffineTransform.

Параметры:: s - указанный объект Shape; at - указанный объект AffineTransform
Исключение:: NullPointerException - если s равен null
С момента:: 1.6

Подробное описание методов

trimToSize

public final void trimToSize()

Описание, скопированное из класса: Path2D

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

Определено в:: trimToSize в классе Path2D
С момента:: 10

moveTo

public final void moveTo(double x, double y)

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

Определено в:: moveTo в классе Path2D
Параметры:: x - указанная координата X; y - указанная координата Y
С момента:: 1.6

lineTo

public final void lineTo(double x, double y)

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

Определено в:: lineTo в классе Path2D
Параметры:: x - указанная координата X; y - указанная координата Y
С момента:: 1.6

quadTo

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

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

Определено в:: quadTo в классе Path2D
Параметры:: x1 - координата X квадратичной контрольной точки; y1 - координата Y квадратичной контрольной точки; x2 - координата X конечной точки; y2 - координата Y конечной точки
С момента:: 1.6

curveTo

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

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

Определено в:: curveTo в классе Path2D
Параметры:: x1 - координата X первой контрольной точки Безье; y1 - координата Y первой контрольной точки Безье; x2 - координата X второй контрольной точки Безье; y2 - координата Y второй контрольной точки Безье; x3 - координата X конечной точки; y3 - координата Y конечной точки
С момента:: 1.6

append

public final void append(PathIterator pi, boolean connect)

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

Определено в:: append в классе Path2D
Параметры:: pi - PathIterator, геометрия которого добавляется к этому пути; connect - логическое значение, определяющее, преобразовывать ли начальный moveTo сегмент в сегмент lineTo для подключения новой геометрии к существующему пути
С момента:: 1.6

transform

public final void transform(AffineTransform at)

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

Определено в:: transform в классе Path2D
Параметры:: at - AffineTransform, используемое для преобразования области
С момента:: 1.6

getBounds2D

public final Rectangle2D getBounds2D()

Возвращает прямоугольник с высокой точностью и большей точностью, охватывающий Shape, чем метод getBounds. Обратите внимание, что нет гарантии, что возвращаемый Rectangle2D является наименьшим прямоугольником, охватывающим Shape, только то, что Shape полностью находится внутри указанного Rectangle2D. Обычно прямоугольник, возвращаемый этим методом, более точный, чем возвращаемый методом getBounds, и никогда не терпит неудачу из-за проблем переполнения, поскольку возвращаемое значение может быть экземпляром Rectangle2D, который использует значения двойной точности для хранения размеров.

Обратите внимание, что определение принадлежности может привести к ситуациям, когда точки на определяющей границе shape могут не считаться содержащимися в возвращаемом bounds объекте, но только в тех случаях, когда эти точки также не считаются содержащимися в исходном shape.

Если point находится внутри shape в соответствии с методом contains(point), то он должен находиться внутри границ возвращаемого Rectangle2D объекта в соответствии с методом contains(point) bounds. В частности:

shape.contains(p) требует bounds.contains(p)

Если point не находится внутри shape, то он все равно может быть содержащимся в bounds объекте:

bounds.contains(p) не подразумевает shape.contains(p)

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

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

Возвращает:

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

С:

1.6

См. также:

getPathIterator

public final PathIterator getPathIterator(AffineTransform at)

Возвращает объект-итератор, который перемещается по границе Shape и предоставляет доступ к геометрии контура Shape. Если задан необязательный AffineTransform, координаты, возвращаемые в процессе итерации, преобразуются соответствующим образом.

Каждый вызов этого метода возвращает новый объект-итератор PathIterator, который проходит по геометрии объекта Shape независимо от других объектов-итераторов PathIterator, используемых одновременно.

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

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

Определено в:: getPathIterator в интерфейсе Shape
Параметры:: at - AffineTransform
Возвращает:: новый PathIterator, который перемещается по границе этого Shape и предоставляет доступ к геометрии контура этого Shape
С:: 1.6

clone

public final Object clone()

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

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

clone в классе Path2D

Возвращает:

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

Исключения:

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

С:

1.6

См. также:

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/geom/Path2D.Double.html