Интерфейс Shape

Rectangle getBounds()

Возвращает целочисленный объект Rectangle, полностью охватывающий Shape. Обратите внимание, что нет гарантии, что возвращённый Rectangle является наименьшим ограничивающим прямоугольником, охватывающим Shape; гарантируется лишь то, что Shape полностью находится внутри указанного Rectangle. Возвращённый Rectangle также может не охватывать Shape полностью, если Shape выходит за пределы ограниченного диапазона целочисленного типа данных. Метод getBounds2D обычно возвращает более точно подогнанный ограничивающий прямоугольник благодаря большей гибкости представления.

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

Если point находится внутри shape согласно методу contains(point), то оно должно находиться внутри возвращённого объекта ограничивающих границ Rectangle согласно методу contains(point) объекта bounds. В частности:

shape.contains(x,y) влечёт bounds.contains(x,y)

Если point не находится внутри shape, оно всё же может содержаться в объекте bounds:

bounds.contains(x,y) не влечёт shape.contains(x,y)

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)

boolean contains(double x, double y)

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

boolean contains(Point2D p)

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

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

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

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

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

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

boolean intersects(Rectangle2D r)

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

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

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

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, поэтому его можно использовать, если требуется более точный результат.

boolean contains(Rectangle2D r)

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

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

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

PathIterator getPathIterator(AffineTransform at)

Возвращает объект-итератор, проходящий вдоль границы Shape и предоставляющий доступ к геометрии контура Shape. Если указан необязательный объект AffineTransform, координаты, возвращаемые при итерации, соответствующим образом преобразуются.

Каждый вызов этого метода возвращает новый объект PathIterator, который независимо от любых других одновременно используемых объектов PathIterator обходит геометрию объекта Shape.

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

PathIterator getPathIterator(AffineTransform at, double flatness)

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

Итератор возвращает только типы точек SEG_MOVETO, SEG_LINETO и SEG_CLOSE.

Если указан необязательный объект AffineTransform, координаты, возвращаемые при итерации, соответствующим образом преобразуются.

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

Каждый вызов этого метода возвращает новый объект PathIterator, который независимо от любых других одновременно используемых объектов PathIterator обходит геометрию объекта Shape.

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