Класс Rectangle2D.Double

java.awt.geom.Rectangle2D.Double

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

Внешний класс:: Rectangle2D

public static class Rectangle2D.Double extends Rectangle2D implements Serializable

Класс Double определяет прямоугольник, заданный координатами типа double.

Начиная с версии:

1.2

См. также:

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

Вложенные классы/интерфейсы, объявленные в классе Rectangle2D

Rectangle2D.Double, Rectangle2D.Float

Модификатор и тип	Класс	Описание
`static class`	`Rectangle2D.Double`	Класс `Double` определяет прямоугольник, заданный координатами типа double.
`static class`	`Rectangle2D.Float`	Класс `Float` определяет прямоугольник, заданный координатами типа float.

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

Модификатор и тип	Поле	Описание
`double`	`height`	Высота этого `Rectangle2D`.
`double`	`width`	Ширина этого `Rectangle2D`.
`double`	`x`	Координата X этого `Rectangle2D`.
`double`	`y`	Координата Y этого `Rectangle2D`.

Поля, объявленные в классе Rectangle2D

OUT_BOTTOM, OUT_LEFT, OUT_RIGHT, OUT_TOP

Модификатор и тип	Поле	Описание
`static final int`	`OUT_BOTTOM`	Битовая маска, указывающая, что точка находится ниже этого `Rectangle2D`.
`static final int`	`OUT_LEFT`	Битовая маска, указывающая, что точка находится левее этого `Rectangle2D`.
`static final int`	`OUT_RIGHT`	Битовая маска, указывающая, что точка находится правее этого `Rectangle2D`.
`static final int`	`OUT_TOP`	Битовая маска, указывающая, что точка находится выше этого `Rectangle2D`.

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

Конструктор	Описание
`Double()`	Создает новый `Rectangle2D`, инициализированный расположением (0, 0) и размером (0, 0).
`Double(double x, double y, double w, double h)`	Создает и инициализирует `Rectangle2D` на основе указанных координат `double`.

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

Модификатор и тип	Метод	Описание
`Rectangle2D`	`createIntersection(Rectangle2D r)`	Возвращает новый объект `Rectangle2D`, представляющий пересечение этого `Rectangle2D` с указанным `Rectangle2D`.
`Rectangle2D`	`createUnion(Rectangle2D r)`	Возвращает новый объект `Rectangle2D`, представляющий объединение этого `Rectangle2D` с указанным `Rectangle2D`.
`Rectangle2D`	`getBounds2D()`	Возвращает ограничивающую рамку с более высокой точностью и лучшей достоверностью для `Shape`, чем метод `getBounds`.
`double`	`getHeight()`	Возвращает высоту ограничивающего прямоугольника с точностью `double`.
`double`	`getWidth()`	Возвращает ширину ограничивающего прямоугольника с точностью `double`.
`double`	`getX()`	Возвращает координату X верхнего левого угла ограничивающего прямоугольника с точностью `double`.
`double`	`getY()`	Возвращает координату Y верхнего левого угла ограничивающего прямоугольника с точностью `double`.
`boolean`	`isEmpty()`	Определяет, является ли `RectangularShape` пустым.
`int`	`outcode(double x, double y)`	Определяет положение указанных координат относительно этого `Rectangle2D`.
`void`	`setRect(double x, double y, double w, double h)`	Задает расположение и размер этого `Rectangle2D` указанными значениями `double`.
`void`	`setRect(Rectangle2D r)`	Задает этому `Rectangle2D` значения, совпадающие с указанным `Rectangle2D`.
`String`	`toString()`	Возвращает `String` представление этого `Rectangle2D`.

Методы, объявленные в классе Rectangle2D

add, add, add, contains, contains, equals, getPathIterator, getPathIterator, hashCode, intersect, intersects, intersectsLine, intersectsLine, outcode, setFrame, union

Модификатор и тип	Метод	Описание
`void`	`add(double newx, double newy)`	Добавляет точку, заданную аргументами двойной точности `newx` и `newy`, к этому `Rectangle2D`.
`void`	`add(Point2D pt)`	Добавляет объект `Point2D` `pt` к этому `Rectangle2D`.
`void`	`add(Rectangle2D r)`	Добавляет объект `Rectangle2D` к этому `Rectangle2D`.
`boolean`	`contains(double x, double y)`	Проверяет, находятся ли указанные координаты внутри границ `Shape`, согласно определению принадлежности внутренней области.
`boolean`	`contains(double x, double y, double w, double h)`	Проверяет, полностью ли внутренняя область `Shape` содержит указанную прямоугольную область.
`boolean`	`equals(Object obj)`	Определяет, равен ли указанный `Object` этому `Rectangle2D`.
`PathIterator`	`getPathIterator(AffineTransform at)`	Возвращает объект-итератор, определяющий границу этого `Rectangle2D`.
`PathIterator`	`getPathIterator(AffineTransform at, double flatness)`	Возвращает объект-итератор, определяющий границу упрощенного `Rectangle2D`.
`int`	`hashCode()`	Возвращает хеш-код этого `Rectangle2D`.
`static void`	`intersect(Rectangle2D src1, Rectangle2D src2, Rectangle2D dest)`	Пересекает указанную пару исходных объектов `Rectangle2D` и помещает результат в указанный целевой объект `Rectangle2D`.
`boolean`	`intersects(double x, double y, double w, double h)`	Проверяет, пересекается ли внутренняя область `Shape` с внутренней областью указанного прямоугольника.
`boolean`	`intersectsLine(double x1, double y1, double x2, double y2)`	Проверяет, пересекает ли указанный отрезок прямой внутреннюю область этого `Rectangle2D`.
`boolean`	`intersectsLine(Line2D l)`	Проверяет, пересекает ли указанный отрезок прямой внутреннюю область этого `Rectangle2D`.
`int`	`outcode(Point2D p)`	Определяет положение указанной `Point2D` относительно этого `Rectangle2D`.
`void`	`setFrame(double x, double y, double w, double h)`	Задает расположение и размер внешних границ этого `Rectangle2D` указанными значениями прямоугольника.
`static void`	`union(Rectangle2D src1, Rectangle2D src2, Rectangle2D dest)`	Объединяет пару исходных объектов `Rectangle2D` и помещает результат в указанный целевой объект `Rectangle2D`.

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

clone, contains, contains, getBounds, getCenterX, getCenterY, getFrame, getMaxX, getMaxY, getMinX, getMinY, intersects, setFrame, setFrame, setFrameFromCenter, setFrameFromCenter, setFrameFromDiagonal, setFrameFromDiagonal

Модификатор и тип	Метод	Описание
`Object`	`clone()`	Создает новый объект того же класса с таким же содержимым, как у этого объекта.
`boolean`	`contains(Point2D p)`	Проверяет, находится ли указанная `Point2D` внутри границы `Shape`, согласно определению принадлежности внутренней области.
`boolean`	`contains(Rectangle2D r)`	Проверяет, полностью ли внутренняя область `Shape` содержит указанный `Rectangle2D`.
`Rectangle`	`getBounds()`	Возвращает целочисленный `Rectangle`, полностью охватывающий `Shape`.
`double`	`getCenterX()`	Возвращает координату X центра ограничивающего прямоугольника `Shape` с точностью `double`.
`double`	`getCenterY()`	Возвращает координату Y центра ограничивающего прямоугольника `Shape` с точностью `double`.
`Rectangle2D`	`getFrame()`	Возвращает ограничивающий `Rectangle2D`, определяющий общую форму этого объекта.
`double`	`getMaxX()`	Возвращает наибольшую координату X ограничивающего прямоугольника `Shape` с точностью `double`.
`double`	`getMaxY()`	Возвращает наибольшую координату Y ограничивающего прямоугольника `Shape` с точностью `double`.
`double`	`getMinX()`	Возвращает наименьшую координату X ограничивающего прямоугольника `Shape` с точностью `double`.
`double`	`getMinY()`	Возвращает наименьшую координату Y ограничивающего прямоугольника `Shape` с точностью `double`.
`boolean`	`intersects(Rectangle2D r)`	Проверяет, пересекается ли внутренняя область `Shape` с внутренней областью указанного `Rectangle2D`.
`void`	`setFrame(Point2D loc, Dimension2D size)`	Задает расположение и размер ограничивающего прямоугольника этого `Shape`, используя соответственно указанные `Point2D` и `Dimension2D`.
`void`	`setFrame(Rectangle2D r)`	Задает ограничивающий прямоугольник этого `Shape` равным указанному `Rectangle2D`.
`void`	`setFrameFromCenter(double centerX, double centerY, double cornerX, double cornerY)`	Задает ограничивающий прямоугольник этого `Shape` на основе указанных координат центральной точки и угловой точки.
`void`	`setFrameFromCenter(Point2D center, Point2D corner)`	Задает ограничивающий прямоугольник этого `Shape` на основе указанного центра `Point2D` и угла `Point2D`.
`void`	`setFrameFromDiagonal(double x1, double y1, double x2, double y2)`	Задает диагональ ограничивающего прямоугольника этого `Shape` на основе двух указанных координат.
`void`	`setFrameFromDiagonal(Point2D p1, Point2D p2)`	Задает диагональ ограничивающего прямоугольника этого `Shape` на основе двух указанных объектов `Point2D`.

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

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

Модификатор и тип	Метод	Описание
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удален в будущей версии. Финализация устарела и будет удалена в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Переводит текущий поток в ожидание до пробуждения, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Переводит текущий поток в ожидание до пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного интервала реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Переводит текущий поток в ожидание до пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного интервала реального времени.

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

x

public double x

Координата X этого Rectangle2D.

Начиная с версии:: 1.2

y

public double y

Координата Y этого Rectangle2D.

Начиная с версии:: 1.2

width

public double width

Ширина этого Rectangle2D.

Начиная с версии:: 1.2

height

public double height

Высота этого Rectangle2D.

Начиная с версии:: 1.2

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

Double

public Double()

Создает новый Rectangle2D, инициализированный расположением (0, 0) и размером (0, 0).

Начиная с версии:: 1.2

Double

public Double(double x, double y, double w, double h)

Создает и инициализирует Rectangle2D на основе указанных координат double.

Параметры:: x — координата X верхнего левого угла вновь созданного Rectangle2D; y — координата Y верхнего левого угла вновь созданного Rectangle2D; w — ширина вновь созданного Rectangle2D; h — высота вновь созданного Rectangle2D
Начиная с версии:: 1.2

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

getX

public double getX()

Возвращает координату X верхнего левого угла ограничивающего прямоугольника с точностью double.

Определено в:: getX в классе RectangularShape
Возвращает:: координату X верхнего левого угла ограничивающего прямоугольника.
Начиная с версии:: 1.2

getY

public double getY()

Возвращает координату Y верхнего левого угла ограничивающего прямоугольника с точностью double.

Определено в:: getY в классе RectangularShape
Возвращает:: координату Y верхнего левого угла ограничивающего прямоугольника.
Начиная с версии:: 1.2

getWidth

public double getWidth()

Возвращает ширину ограничивающего прямоугольника с точностью double.

Определено в:: getWidth в классе RectangularShape
Возвращает:: ширину ограничивающего прямоугольника.
Начиная с версии:: 1.2

getHeight

public double getHeight()

Возвращает высоту ограничивающего прямоугольника с точностью double.

Определено в:: getHeight в классе RectangularShape
Возвращает:: высоту ограничивающего прямоугольника.
Начиная с версии:: 1.2

isEmpty

public boolean isEmpty()

Определяет, является ли RectangularShape пустым. Если RectangularShape пуст, он не охватывает никакой области.

Определено в:: isEmpty в классе RectangularShape
Возвращает:: true, если RectangularShape пуст; в противном случае — false.
Начиная с версии:: 1.2

setRect

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

Задает расположение и размер этого Rectangle2D указанными значениями double.

Определено в:: setRect в классе Rectangle2D
Параметры:: x — координата X верхнего левого угла этого Rectangle2D; y — координата Y верхнего левого угла этого Rectangle2D; w — ширина этого Rectangle2D; h — высота этого Rectangle2D
Начиная с версии:: 1.2

setRect

public void setRect(Rectangle2D r)

Задает этому Rectangle2D значения, совпадающие с указанным Rectangle2D.

Переопределяет:: setRect в классе Rectangle2D
Параметры:: r — указанный Rectangle2D
Начиная с версии:: 1.2

outcode

public int outcode(double x, double y)

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

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

outcode в классе Rectangle2D

Параметры:

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

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

Возвращает:

логическое ИЛИ всех подходящих кодов out.

Начиная с версии:

1.2

См. также:

getBounds2D

public 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

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

getBounds2D в классе Rectangle2D

Возвращает:

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

Начиная с версии:

1.2

См. также:

createIntersection

public Rectangle2D createIntersection(Rectangle2D r)

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

Определено в:: createIntersection в классе Rectangle2D
Параметры:: r — Rectangle2D, с которым нужно пересечь этот Rectangle2D
Возвращает:: наибольший Rectangle2D, содержащийся как в указанном Rectangle2D, так и в этом Rectangle2D.
Начиная с версии:: 1.2

createUnion

public Rectangle2D createUnion(Rectangle2D r)

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

Определено в:: createUnion в классе Rectangle2D
Параметры:: r — Rectangle2D, который нужно объединить с этим Rectangle2D
Возвращает:: наименьший Rectangle2D, содержащий указанный Rectangle2D и этот Rectangle2D.
Начиная с версии:: 1.2

toString

public String toString()

Возвращает String представление этого Rectangle2D.

Переопределяет:: toString в классе Object
Возвращает:: String, представляющую этот Rectangle2D.
Начиная с версии:: 1.2

© 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.