Класс Arc2D

java.lang.Object

java.awt.geom.RectangularShape

java.awt.geom.Arc2D

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

Прямые известные подклассы:: Arc2D.Double, Arc2D.Float

public abstract class Arc2D extends RectangularShape

Arc2D является абстрактным суперклассом для всех объектов, хранящих дугу 2D, определённую прямоугольной рамкой, начальным углом, угловым протяжением (длиной дуги) и типом замкнутости (OPEN, CHORD, или PIE).

Дуга представляет собой частичный сегмент полной эллипса, вписанной в прямоугольную рамку родительского элемента RectangularShape. Углы задаются относительно прямоугольной рамки, не являющейся квадратом, таким образом, что 45 градусов всегда находятся на линии от центра эллипса до правого верхнего угла прямоугольной рамки. В результате, если прямоугольная рамка заметно длиннее по одной оси, чем по другой, углы начала и конца сегмента дуги будут смещены дальше вдоль большей оси рамки.

Фактическое представление координат оставляется подклассу.

С:: 1.2

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

Модификатор и тип	Класс	Описание
`static class`	`Arc2D.Double`	Этот класс определяет дугу, заданную с точностью `double`.
`static class`	`Arc2D.Float`	Этот класс определяет дугу, заданную с точностью `float`.

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

Модификатор и тип	Поле	Описание
`static final int`	`CHORD`	Тип замкнутости для дуги, замкнутой путём рисования отрезка прямой от начала дуги до её конца.
`static final int`	`OPEN`	Тип замкнутости для открытой дуги без соединяющих отрезков между двумя концами дуги.
`static final int`	`PIE`	Тип замкнутости для дуги, замкнутой путём рисования отрезков прямой от начала дуги до центра полного эллипса, и от этой точки до конца дуги.

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

Arc2D()

Arc2D(int type)

Модификатор	Конструктор	Описание
`protected`	Это абстрактный класс, который нельзя создать напрямую.
`protected`	Это абстрактный класс, который нельзя создать напрямую.

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

Модификатор и тип	Метод	Описание
`boolean`	`contains(double x, double y)`	Определяет, находится ли указанная точка внутри границы дуги.
`boolean`	`contains(double x, double y, double w, double h)`	Определяет, полностью ли внутренняя часть дуги содержит указанный прямоугольник.
`boolean`	`contains(Rectangle2D r)`	Определяет, полностью ли внутренняя часть дуги содержит указанный прямоугольник.
`boolean`	`containsAngle(double angle)`	Определяет, находится ли указанный угол в пределах угловых границ дуги.
`boolean`	`equals(Object obj)`	Определяет, равен ли указанный `Object` этому `Arc2D`.
`abstract double`	`getAngleExtent()`	Возвращает угловое протяжение дуги.
`abstract double`	`getAngleStart()`	Возвращает начальный угол дуги.
`int`	`getArcType()`	Возвращает тип замкнутости дуги: `OPEN`, `CHORD` или `PIE`.
`Rectangle2D`	`getBounds2D()`	Возвращает прямоугольник высокой точности рамки дуги.
`Point2D`	`getEndPoint()`	Возвращает конечную точку дуги.
`PathIterator`	`getPathIterator(AffineTransform at)`	Возвращает объект итерации, определяющий границу дуги.
`Point2D`	`getStartPoint()`	Возвращает начальную точку дуги.
`int`	`hashCode()`	Возвращает хэш-код для этой `Arc2D`.
`boolean`	`intersects(double x, double y, double w, double h)`	Определяет, пересекается ли внутренняя часть дуги с внутренней частью указанного прямоугольника.
`protected abstract Rectangle2D`	`makeBounds(double x, double y, double w, double h)`	Создаёт `Rectangle2D` соответствующей точности, чтобы содержать параметры, вычисленные как прямоугольную рамку этой дуги.
`abstract void`	`setAngleExtent(double angExt)`	Устанавливает угловое протяжение этой дуги в указанное значение типа double.
`void`	`setAngles(double x1, double y1, double x2, double y2)`	Устанавливает начальный угол и угловое протяжение этой дуги, используя два набора координат.
`void`	`setAngles(Point2D p1, Point2D p2)`	Устанавливает начальный угол и угловое протяжение этой дуги, используя две точки.
`abstract void`	`setAngleStart(double angSt)`	Устанавливает начальный угол этой дуги в указанное значение типа double.
`void`	`setAngleStart(Point2D p)`	Устанавливает начальный угол этой дуги в угол, который определяет указанная точка относительно центра этой дуги.
`abstract void`	`setArc(double x, double y, double w, double h, double angSt, double angExt, int closure)`	Устанавливает расположение, размеры, угловые протяжения и тип замкнутости этой дуги в указанные значения типа double.
`void`	`setArc(Arc2D a)`	Устанавливает эту дугу такой же, как указанная дуга.
`void`	`setArc(Point2D loc, Dimension2D size, double angSt, double angExt, int closure)`	Устанавливает расположение, размеры, угловые протяжения и тип замкнутости этой дуги в указанные значения.
`void`	`setArc(Rectangle2D rect, double angSt, double angExt, int closure)`	Устанавливает расположение, размеры, угловые протяжения и тип замкнутости этой дуги в указанные значения.
`void`	`setArcByCenter(double x, double y, double radius, double angSt, double angExt, int closure)`	Устанавливает положение, границы, угловые протяжения и тип замкнутости этой дуги в указанные значения.
`void`	`setArcByTangent(Point2D p1, Point2D p2, Point2D p3, double radius)`	Устанавливает положение, границы и угловые протяжения этой дуги в указанное значение.
`void`	`setArcType(int type)`	Устанавливает тип замкнутости этой дуги в указанное значение: `OPEN`, `CHORD`, или `PIE`.
`void`	`setFrame(double x, double y, double w, double h)`	Устанавливает расположение и размеры прямоугольной рамки этой `Shape` в указанные прямоугольные значения.

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

clone, contains, getBounds, getCenterX, getCenterY, getFrame, getHeight, getMaxX, getMaxY, getMinX, getMinY, getPathIterator, getWidth, getX, getY, intersects, isEmpty, setFrame, setFrame, setFrameFromCenter, setFrameFromCenter, setFrameFromDiagonal, setFrameFromDiagonal

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

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Подробное описание полей

OPEN

public static final int OPEN

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

Since:

1.2

См. также:

Значения постоянных полей

CHORD

public static final int CHORD

Тип закрытия для дуги, закрытой путём рисования прямого отрезка от начала сегмента дуги до конца сегмента дуги.

Since:

1.2

См. также:

Значения постоянных полей

PIE

public static final int PIE

Тип закрытия для дуги, закрытой путём рисования прямых отрезков от начала сегмента дуги к центру полного эллипса и от этой точки до конца сегмента дуги.

Since:

1.2

См. также:

Значения постоянных полей

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

Arc2D

protected Arc2D()

Это абстрактный класс, который нельзя создать напрямую. Подклассы, специфичные для типа, доступны для создания экземпляров и предоставляют множество форматов для хранения информации, необходимой для удовлетворения различных методов доступа ниже.

Этот конструктор создаёт объект с типом закрытия по умолчанию OPEN. Он предоставляется только для обеспечения сериализации подклассов.

См. также:

Arc2D

protected Arc2D(int type)

Параметры:

type - Тип закрытия этой дуги: OPEN, CHORD или PIE.

Since:

1.2

См. также:

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

getAngleStart

public abstract double getAngleStart()

Возвращает начальный угол дуги.

Возвращает:

Значение типа double, представляющее начальный угол дуги в градусах.

Since:

1.2

См. также:

setAngleStart(double)

getAngleExtent

public abstract double getAngleExtent()

Возвращает угловое протяжение дуги.

Возвращает:

Значение типа double, представляющее угловое протяжение дуги в градусах.

Since:

1.2

См. также:

setAngleExtent(double)

getArcType

public int getArcType()

Возвращает тип закрытия дуги: OPEN, CHORD или PIE.

Возвращает:

Одно из целочисленных постоянных значений типа закрытия, определенных в этом классе.

Since:

1.2

См. также:

setArcType(int)

getStartPoint

public Point2D getStartPoint()

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

Возвращает:: Объект типа Point2D представляющий координаты x,y начальной точки дуги.
Since:: 1.2

getEndPoint

public Point2D getEndPoint()

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

Возвращает:: Объект типа Point2D представляющий координаты x,y конечной точки дуги.
Since:: 1.2

setArc

public abstract void setArc(double x, double y, double w, double h, double angSt, double angExt, int closure)

Устанавливает расположение, размер, угловые протяжения и тип закрытия этой дуги на указанные значения типа double.

Параметры:: x - Координата X верхнего левого угла дуги.; y - Координата Y верхнего левого угла дуги.; w - Общая ширина полного эллипса, частью которого является эта дуга.; h - Общая высота полного эллипса, частью которого является эта дуга.; angSt - Начальный угол дуги в градусах.; angExt - Угловое протяжение дуги в градусах.; closure - Тип закрытия дуги: OPEN, CHORD или PIE.
Since:: 1.2

setArc

public void setArc(Point2D loc, Dimension2D size, double angSt, double angExt, int closure)

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

Параметры:: loc - Point2D представляющий координаты верхнего левого угла дуги.; size - Dimension2D представляющий ширину и высоту полного эллипса, частью которого является эта дуга.; angSt - Начальный угол дуги в градусах.; angExt - Угловое протяжение дуги в градусах.; closure - Тип закрытия дуги: OPEN, CHORD или PIE.
Since:: 1.2

setArc

public void setArc(Rectangle2D rect, double angSt, double angExt, int closure)

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

Параметры:: rect - Прямоугольник, определяющий внешнюю границу полного эллипса, частью которого является эта дуга.; angSt - Начальный угол дуги в градусах.; angExt - Угловое протяжение дуги в градусах.; closure - Тип закрытия дуги: OPEN, CHORD или PIE.
Since:: 1.2

setArc

public void setArc(Arc2D a)

Устанавливает эту дугу такой же, как и указанная дуга.

Параметры:: a - Arc2D для установки значений дуги.
Since:: 1.2

setArcByCenter

public void setArcByCenter(double x, double y, double radius, double angSt, double angExt, int closure)

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

Параметры:: x - Координата X центра дуги.; y - Координата Y центра дуги.; radius - Радиус дуги.; angSt - Начальный угол дуги в градусах.; angExt - Угловое протяжение дуги в градусах.; closure - Тип закрытия дуги: OPEN, CHORD или PIE.
Since:: 1.2

setArcByTangent

public void setArcByTangent(Point2D p1, Point2D p2, Point2D p3, double radius)

Устанавливает положение, границы и угловые протяжения этой дуги на указанное значение. Начальный угол дуги касается прямой, заданной точками (p1, p2), конечный угол касается прямой, заданной точками (p2, p3), и дуга имеет указанный радиус.

Параметры:: p1 - Первая точка, определяющая дугу. Начальный угол дуги касается прямой, заданной точками (p1, p2).; p2 - Вторая точка, определяющая дугу. Начальный угол дуги касается прямой, заданной точками (p1, p2). Конечный угол дуги касается прямой, заданной точками (p2, p3).; p3 - Третья точка, определяющая дугу. Конечный угол дуги касается прямой, заданной точками (p2, p3).; radius - Радиус дуги.
Since:: 1.2

setAngleStart

public abstract void setAngleStart(double angSt)

Устанавливает начальный угол этой дуги на указанное значение типа double.

Параметры:

angSt - Начальный угол дуги в градусах.

Since:

1.2

См. также:

getAngleStart()

setAngleExtent

public abstract void setAngleExtent(double angExt)

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

Parameters:

angExt - Угловой охват дуги в градусах.

Since:

1.2

See Also:

getAngleExtent()

setAngleStart

public void setAngleStart(Point2D p)

Устанавливает начальный угол этой дуги в угол, задаваемый указанной точкой относительно центра этой дуги. Угловой охват дуги останется неизменным.

Parameters:

p - Точка, определяющая начальный угол.

Since:

1.2

See Also:

getAngleStart()

setAngles

public void setAngles(double x1, double y1, double x2, double y2)

Устанавливает начальный угол и угловой охват этой дуги, используя два набора координат. Первый набор координат используется для определения угла начальной точки относительно центра дуги. Второй набор координат используется для определения угла конечной точки относительно центра дуги. Дуга всегда будет непустой и расширяться против часовой стрелки от первой точки до второй.

Parameters:: x1 - Координата X начальной точки дуги.; y1 - Координата Y начальной точки дуги.; x2 - Координата X конечной точки дуги.; y2 - Координата Y конечной точки дуги.
Since:: 1.2

setAngles

public void setAngles(Point2D p1, Point2D p2)

Устанавливает начальный угол и угловой охват этой дуги, используя две точки. Первая точка используется для определения угла начальной точки относительно центра дуги. Вторая точка используется для определения угла конечной точки относительно центра дуги. Дуга всегда будет непустой и расширяться против часовой стрелки от первой точки до второй.

Parameters:: p1 - Точка, определяющая начальную точку дуги.; Point2D - Точка, определяющая конечную точку дуги.
Since:: 1.2

setArcType

public void setArcType(int type)

Устанавливает тип закрытия этой дуги в указанное значение: OPEN, CHORD, или PIE.

Parameters:

type - Целочисленная константа, представляющая тип закрытия этой дуги: OPEN, CHORD, или PIE.

Throws:

IllegalArgumentException - если значение type не равно 0, 1 или 2.

Since:

1.2

See Also:

getArcType()

setFrame

public void setFrame(double x, double y, double w, double h)

Устанавливает положение и размеры прямоугольника обрамления этой дуги в заданные прямоугольные значения. Обратите внимание, что дуга частично вписана в прямоугольник обрамления этой дуги.

Specified by:

setFrame в классе RectangularShape

Parameters:

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

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

w - ширина указанной прямоугольной фигуры

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

Since:

1.2

See Also:

RectangularShape.getFrame()

getBounds2D

public Rectangle2D getBounds2D()

Возвращает прямоугольник обрамления дуги с высокой точностью. Прямоугольник обрамления содержит только часть этой дуги, которая находится между начальным и конечным углами и содержит сегмент, если у этой дуги тип закрытия PIE.

Этот метод отличается от getBounds тем, что метод getBounds возвращает только границы охватывающей эллипса этой дуги, не учитывая начальный и конечный углы этой дуги.

Returns:

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

Since:

1.2

See Also:

Shape.getBounds()

makeBounds

protected abstract Rectangle2D makeBounds(double x, double y, double w, double h)

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

Parameters:: x - Координата X верхнего левого угла прямоугольника обрамления.; y - Координата Y верхнего левого угла прямоугольника обрамления.; w - Ширина прямоугольника обрамления.; h - Высота прямоугольника обрамления.
Returns:: прямоугольник, являющийся прямоугольником обрамления этой дуги.
Since:: 1.2

containsAngle

public boolean containsAngle(double angle)

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

Parameters:: angle - Угол для проверки.
Returns:: true если дуга содержит угол, false если дуга не содержит угол.
Since:: 1.2

contains

public boolean contains(double x, double y)

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

Parameters:: x - Координата X точки для проверки.; y - Координата Y точки для проверки.
Returns:: true если точка находится внутри границы дуги, false если точка находится за пределами границ дуги.
Since:: 1.2

intersects

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

Определяет, пересекается ли внутренняя часть дуги с внутренней частью указанного прямоугольника.

Parameters:

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

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

w - Ширина прямоугольника.

h - Высота прямоугольника.

Returns:

true если дуга пересекает прямоугольник, false если дуга не пересекает прямоугольник.

Since:

1.2

See Also:

Area

contains

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

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

Parameters:

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

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

w - Ширина прямоугольника.

h - Высота прямоугольника.

Returns:

true если дуга содержит прямоугольник, false если дуга не содержит прямоугольник.

Since:

1.2

See Also:

contains

public boolean contains(Rectangle2D r)

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

Specified by:

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

Overrides:

contains в классе RectangularShape

Parameters:

r - Прямоугольник для проверки.

Returns:

true если дуга содержит прямоугольник, false если дуга не содержит прямоугольник.

Since:

1.2

See Also:

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

getPathIterator

public PathIterator getPathIterator(AffineTransform at)

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

Parameters:: at - необязательное преобразование, которое должно быть применено к координатам по мере их возврата в итерации, или null, если желаемы не преобразованные координаты.
Returns:: Объект итерации, определяющий границу дуги.
Since:: 1.2

hashCode

public int hashCode()

Возвращает хэш-код для этой дуги.

Overrides:

hashCode в классе Object

Returns:

хэш-код для этой дуги.

Since:

1.6

See Also:

equals

public boolean equals(Object obj)

Определяет, равняется ли указанный Object этому Arc2D. Указанный Object равен этому Arc2D, если он является экземпляром Arc2D и если его расположение, размер, пределы дуги и тип совпадают с этим Arc2D.

Overrides:

equals в классе Object

Параметры:

obj - Object для сравнения с этим Arc2D.

Возвращает:

true, если obj является экземпляром Arc2D и имеет те же значения; false в противном случае.

Since:

1.6

См. также:

© 1993, 2021, 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://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/java/awt/geom/Arc2D.html