Класс Rectangle

public class Rectangle
extends Rectangle2D
implements Shape, Serializable

Объект типа Rectangle определяет область в системе координат, ограниченную точкой верхнего левого угла объекта Rectangle (x,y) в пространстве координат, его шириной и высотой.

Поля width и height объекта Rectangle являются полями типа public. Конструкторы, создающие объект Rectangle, и методы, которые могут его изменить, не препятствуют установке отрицательного значения для ширины или высоты.

Объект Rectangle с шириной или высотой ровно ноль имеет координаты вдоль соответствующих осей с нулевыми размерами, но при этом считается пустым. Метод isEmpty() вернёт true для такого объекта Rectangle. Методы, проверяющие, содержит ли пустой объект Rectangle точку или прямоугольник, или пересекается ли с ними, всегда возвращают false, если хотя бы один из размеров равен нулю. Методы, объединяющие такой объект Rectangle с точкой или прямоугольником, включат координату объекта Rectangle вдоль этой оси в результат, как будто вызывался метод add(Point).

Объект Rectangle с отрицательной шириной или высотой не имеет координат или размеров вдоль осей с отрицательными размерами. Такой объект Rectangle считается несуществующим вдоль этих осей. Такой объект Rectangle также считается пустым при проверке на вмещение, и методы, проверяющие, содержит ли он или пересекается ли с точкой или прямоугольником, всегда возвращают false. Методы, объединяющие такой объект Rectangle с точкой или прямоугольником, полностью игнорируют объект Rectangle при формировании результата. Если два объекта Rectangle объединяются, и каждый из них имеет отрицательный размер, то результат будет иметь хотя бы один отрицательный размер.

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

Обратите внимание, что объект Rectangle, созданный с помощью конструктора по умолчанию без аргументов, будет иметь размеры 0x0 и, следовательно, будет пустым. Такой объект Rectangle по-прежнему будет иметь координаты (0,0) и будет вносить эти координаты в операции объединения и добавления. Поэтому код, пытающийся накапливать границы набора точек, должен первоначально создать объект Rectangle со специально заданными отрицательными шириной и высотой или использовать первую точку в наборе для создания объекта Rectangle. Например:

Rectangle bounds = new Rectangle(0, 0, -1, -1);
     for (int i = 0; i < points.length; i++) {
         bounds.add(points[i]);
     }

или если известно, что массив точек содержит по крайней мере одну точку:

Rectangle bounds = new Rectangle(points[0]);
     for (int i = 1; i < points.length; i++) {
         bounds.add(points[i]);
     }

Этот класс использует 32-битные целые числа для хранения своего положения и размеров. Часто операции могут давать результат, превышающий диапазон 32-битного целого числа. Методы вычисляют результаты таким образом, чтобы избежать переполнения 32-битных целых чисел для промежуточных результатов, а затем выбирают лучшее представление для хранения окончательных результатов обратно в 32-битные поля, хранящие положение и размеры. Координаты результата будут сохранены в поля x и y путём округления истинного результата до ближайшего 32-битного значения. Значения, хранящиеся в полях width и height, будут выбраны как 32-битные значения, охватывающие наибольшую часть истинного результата. Как правило, это означает, что размеры будут обрезаны независимо до диапазона 32-битных целых чисел, за исключением случая, когда положение пришлось сместить для его хранения в парах 32-битных полей, тогда размеры будут скорректированы относительно «лучшего представления» положения. Если истинный результат имел отрицательный размер и, следовательно, не существовал вдоль одной или обеих осей, хранимые размеры будут отрицательными числами вдоль этих осей. Если истинный результат имел координаты, которые можно было представить в диапазоне 32-битных целых чисел, но имел нулевой размер вдоль одной или обеих осей, то хранимые размеры будут нулевыми вдоль этих осей.