Интерфейс 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, координаты, возвращаемые в процессе итерации, преобразуются соответствующим образом.

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

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

PathIterator getPathIterator(AffineTransform at, double flatness)

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

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

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

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

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

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