Интерфейс 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, который обходит геометрию объекта Shape независимо от других объектов-итераторов PathIterator.

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

PathIterator getPathIterator(AffineTransform at, double flatness)

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

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

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

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

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

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