Класс Rectangle2D

Класс Rectangle2D описывает прямоугольник, определяемый положением (x,y) и размерами (w x h).

Этот класс является только абстрактным суперклассом для всех объектов, хранящих прямоугольник 2D. Фактическое представление координат оставляется подклассу.

Поля

OUT_LEFT

public static final int OUT_LEFT

Маска битов, указывающая, что точка лежит слева от этой Rectangle2D.

Since:

1.2

См. также:

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

OUT_TOP

public static final int OUT_TOP

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

Since:

1.2

См. также:

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

OUT_RIGHT

public static final int OUT_RIGHT

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

Since:

1.2

См. также:

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

OUT_BOTTOM

public static final int OUT_BOTTOM

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

Since:

1.2

См. также:

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

Конструкторы

Rectangle2D

protected Rectangle2D()

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

Since:

1.2

См. также:

Rectangle2D.Float, Rectangle2D.Double, Rectangle

Методы

setRect

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

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

Параметры:

x - координата X верхнего левого угла этой Rectangle2D

y - координата Y верхнего левого угла этой Rectangle2D

w - ширина этой Rectangle2D

h - высота этой Rectangle2D

Since:

1.2

setRect

public void setRect(Rectangle2D r)

Устанавливает эту Rectangle2D равной указанной Rectangle2D.

Параметры:

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

Since:

1.2

intersectsLine

public boolean intersectsLine(double x1,
                              double y1,
                              double x2,
                              double y2)

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

Параметры:

x1 - координата X начальной точки указанного отрезка прямой

y1 - координата Y начальной точки указанного отрезка прямой

x2 - координата X конечной точки указанного отрезка прямой

y2 - координата Y конечной точки указанного отрезка прямой

Возвращает:

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

Since:

1.2

intersectsLine

public boolean intersectsLine(Line2D l)

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

Параметры:

l - указанный Line2D для проверки пересечения с внутренней частью этой Rectangle2D

Возвращает:

true если указанный Line2D пересекает внутреннюю часть этой Rectangle2D; false в противном случае.

Since:

1.2

outcode

public abstract int outcode(double x,
                            double y)

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

Параметры:

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

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

Возвращает:

логическое ИЛИ всех соответствующих кодов.

Since:

1.2

См. также:

OUT_LEFT, OUT_TOP, OUT_RIGHT, OUT_BOTTOM

outcode

public int outcode(Point2D p)

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

Параметры:

p - указанная Point2D

Возвращает:

логическое ИЛИ всех соответствующих кодов.

Since:

1.2

См. также:

OUT_LEFT, OUT_TOP, OUT_RIGHT, OUT_BOTTOM

setFrame

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

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

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

setFrame в классе RectangularShape

Параметры:

x - координата X верхнего левого угла этой Rectangle2D

y - координата Y верхнего левого угла этой Rectangle2D

w - ширина этой Rectangle2D

h - высота этой Rectangle2D

Since:

1.2

См. также:

RectangularShape.getFrame()

getBounds2D

public Rectangle2D getBounds2D()

Возвращает:

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

Since:

1.2

См. также:

Shape.getBounds()

contains

public boolean contains(double x,
                        double y)

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

Параметры:

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

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

Возвращает:

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

Since:

1.2

intersects

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

Параметры:

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

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

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

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

Возвращает:

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

С:

1.2

См. также:

Area

contains

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

Параметры:

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

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

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

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

Возвращает:

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

С:

1.2

См. также:

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

createIntersection

public abstract Rectangle2D createIntersection(Rectangle2D r)

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

Параметры:

r - Rectangle2D для пересечения с этим Rectangle2D

Возвращает:

наибольший Rectangle2D содержащийся как в указанной Rectangle2D, так и в этом Rectangle2D.

С:

1.2

intersect

public static void intersect(Rectangle2D src1,
                             Rectangle2D src2,
                             Rectangle2D dest)

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

Параметры:

src1 - первый из пары Rectangle2D объектов, которые нужно пересечь друг с другом

src2 - второй из пары Rectangle2D объектов, которые нужно пересечь друг с другом

dest - Rectangle2D содержащий результат пересечения src1 и src2

С:

1.2

createUnion

public abstract Rectangle2D createUnion(Rectangle2D r)

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

Параметры:

r - Rectangle2D для объединения с этим Rectangle2D

Возвращает:

наименьший Rectangle2D содержащий как указанный Rectangle2D, так и этот Rectangle2D.

С:

1.2

union

public static void union(Rectangle2D src1,
                         Rectangle2D src2,
                         Rectangle2D dest)

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

Параметры:

src1 - первый из пары Rectangle2D объектов для объединения друг с другом

src2 - второй из пары Rectangle2D объектов для объединения друг с другом

dest - Rectangle2D содержащий результат объединения src1 и src2

С:

1.2

add

public void add(double newx,
                double newy)

Параметры:

newx - координата X новой точки

newy - координата Y новой точки

С:

1.2

add

public void add(Point2D pt)

Параметры:

pt - новая Point2D для добавления к этому Rectangle2D.

С:

1.2

add

public void add(Rectangle2D r)

Добавляет объект Rectangle2D к этому Rectangle2D. Результирующий Rectangle2D - это объединение двух Rectangle2D объектов.

Параметры:

r - Rectangle2D для добавления к этому Rectangle2D.

С:

1.2

getPathIterator

public PathIterator getPathIterator(AffineTransform at)

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

Параметры:

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

Возвращает:

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

С:

1.2

getPathIterator

public PathIterator getPathIterator(AffineTransform at,
                                    double flatness)

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

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

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

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

getPathIterator в классе RectangularShape

Параметры:

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

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

Возвращает:

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

С:

1.2

hashCode

public int hashCode()

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

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

hashCode в классе Object

Возвращает:

хэш-код для этого Rectangle2D.

С:

1.2

См. также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

equals

public boolean equals(Object obj)

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

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

equals в классе Object

Параметры:

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

Возвращает:

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

С:

1.2

См. также:

Object.hashCode(), HashMap