Класс Area

public Area()

Конструктор по умолчанию, создающий пустую область.

public Area(Shape s)

Класс Area создаёт геометрию области на основе указанного объекта Shape. Геометрия явно закрывается, если она не была закрыта изначально. Правило заполнения (чёт-нечёт или обход контура), заданное геометрией объекта Shape, используется для определения итоговой закрытой области.

public void add(Area rhs)

Добавляет форму указанной Area к форме этого объекта Area. Результирующая форма этого объекта Area будет включать объединение обеих форм, или все области, содержащиеся либо в этом, либо в указанном объекте Area.

     // Example:
     Area a1 = new Area([triangle 0,0 => 8,0 => 0,8]);
     Area a2 = new Area([triangle 0,0 => 8,0 => 8,8]);
     a1.add(a2);

        a1(before)     +         a2         =     a1(after)

     ################     ################     ################
     ##############         ##############     ################
     ############             ############     ################
     ##########                 ##########     ################
     ########                     ########     ################
     ######                         ######     ######    ######
     ####                             ####     ####        ####
     ##                                 ##     ##            ##
 

public void subtract(Area rhs)

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

     // Example:
     Area a1 = new Area([triangle 0,0 => 8,0 => 0,8]);
     Area a2 = new Area([triangle 0,0 => 8,0 => 8,8]);
     a1.subtract(a2);

        a1(before)     -         a2         =     a1(after)

     ################     ################
     ##############         ##############     ##
     ############             ############     ####
     ##########                 ##########     ######
     ########                     ########     ########
     ######                         ######     ######
     ####                             ####     ####
     ##                                 ##     ##
 

public void intersect(Area rhs)

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

     // Example:
     Area a1 = new Area([triangle 0,0 => 8,0 => 0,8]);
     Area a2 = new Area([triangle 0,0 => 8,0 => 8,8]);
     a1.intersect(a2);

      a1(before)   intersect     a2         =     a1(after)

     ################     ################     ################
     ##############         ##############       ############
     ############             ############         ########
     ##########                 ##########           ####
     ########                     ########
     ######                         ######
     ####                             ####
     ##                                 ##
 

public void exclusiveOr(Area rhs)

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

     // Example:
     Area a1 = new Area([triangle 0,0 => 8,0 => 0,8]);
     Area a2 = new Area([triangle 0,0 => 8,0 => 8,8]);
     a1.exclusiveOr(a2);

        a1(before)    xor        a2         =     a1(after)

     ################     ################
     ##############         ##############     ##            ##
     ############             ############     ####        ####
     ##########                 ##########     ######    ######
     ########                     ########     ################
     ######                         ######     ######    ######
     ####                             ####     ####        ####
     ##                                 ##     ##            ##
 

public void reset()

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

public boolean isEmpty()

Проверяет, содержит ли этот объект Area какую-либо область.

public boolean isPolygonal()

Проверяет, состоит ли этот объект Area полностью из геометрии прямолинейных многоугольников.

public boolean isRectangular()

Проверяет, является ли этот объект Area прямоугольным.

public boolean isSingular()

Проверяет, состоит ли этот объект Area из одной замкнутой подтраектории. Этот метод возвращает true если траектория содержит 0 или 1 подтраекторию, или false если траектория содержит более 1 подтраектории. Подтраектории подсчитываются по количеству сегментов SEG_MOVETO в траектории.

public Rectangle2D getBounds2D()

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

Класс Area попытается вернуть максимально возможную ограничивающую прямоугольную область для формы. Ограничивающая прямоугольная область не будет расширена для включения контрольных точек кривых на контуре формы, но должна плотно прилегать к фактической геометрии контура.

public Rectangle getBounds()

Возвращает ограничивающую Rectangle, которая полностью охватывает этот объект Area.

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

public Object clone()

Возвращает точную копию объекта Area.

public boolean equals(Area other)

Проверяет, равны ли геометрии двух объектов Area. Этот метод вернёт false, если аргумент равен null.

public void transform(AffineTransform t)

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

public Area createTransformedArea(AffineTransform t)

Создаёт новый объект Area , содержащий ту же геометрию, что и этот объект Area , преобразованный с помощью указанного AffineTransform. Этот объект Area не изменяется.

public boolean contains(double x, double y)

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

public boolean contains(Point2D p)

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

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

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

Метод Shape.contains() позволяет реализации Shape консервативно возвращать false в случае:

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

Это означает, что для некоторых Shapes этот метод может вернуть false даже если Shape содержит прямоугольную область. Класс Area выполняет более точные геометрические вычисления, чем большинство объектов Shape и поэтому может быть использован, если требуется более точный ответ.

public boolean contains(Rectangle2D r)

Проверяет, полностью ли внутренняя область Shape содержит указанный Rectangle2D. Метод Shape.contains() позволяет реализации Shape консервативно возвращать false в случае:

• метод intersect возвращает true и
• вычисления для определения того, содержит ли Shape полностью Rectangle2D, являются чрезмерно затратными.

Это означает, что для некоторых Shapes этот метод может вернуть false даже если Shape содержит Rectangle2D. Класс Area выполняет более точные геометрические вычисления, чем большинство объектов Shape и поэтому может быть использован, если требуется более точный ответ.

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

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

Метод Shape.intersects() позволяет реализации Shape консервативно возвращать true в случае:

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

Это означает, что для некоторых Shapes этот метод может вернуть true даже если прямоугольная область не пересекает Shape. Класс Area выполняет более точные вычисления геометрического пересечения, чем большинство объектов Shape и поэтому может быть использован, если требуется более точный ответ.

public boolean intersects(Rectangle2D r)

Проверяет, пересекается ли внутренняя область Shape с внутренней областью указанного Rectangle2D. Метод Shape.intersects() позволяет реализации Shape консервативно возвращать true в случае:

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

Это означает, что для некоторых Shapes этот метод может вернуть true даже если Rectangle2D не пересекает Shape. Класс Area выполняет более точные вычисления геометрического пересечения, чем большинство объектов Shape и поэтому может быть использован, если требуется более точный ответ.

public PathIterator getPathIterator(AffineTransform at)

Создает PathIterator для контура этого объекта Area. Объект Area остается неизменным.

public PathIterator getPathIterator(AffineTransform at, double flatness)

Создает итератор для сглаженного контура этого объекта Area. Итератор возвращает только неизогнутые сегменты пути, представленные типами точек SEG_MOVETO, SEG_LINETO и SEG_CLOSE. Сам объект Area не изменяется.