Класс 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 не изменяется.