Класс Polygon

public class Polygon
extends Object
implements Shape, Serializable

Поля

npoints

public int npoints

Общее количество точек. Значение npoints представляет количество действительных точек в этом Polygon и может быть меньше, чем количество элементов в xpoints или ypoints. Это значение может быть NULL.

Since:

1.0

См. также:

addPoint(int, int)

xpoints

public int[] xpoints

Массив координат X. Количество элементов в этом массиве может быть больше, чем количество координат X в этом Polygon. Дополнительные элементы позволяют добавлять новые точки в этот Polygon без повторного создания этого массива. Значение npoints равно количеству действительных точек в этом Polygon.

Since:

1.0

См. также:

addPoint(int, int)

ypoints

public int[] ypoints

Массив координат Y. Количество элементов в этом массиве может быть больше, чем количество координат Y в этом Polygon. Дополнительные элементы позволяют добавлять новые точки в этот Polygon без повторного создания этого массива. Значение npoints равно количеству действительных точек в этом Polygon.

Since:

1.0

См. также:

addPoint(int, int)

bounds

protected Rectangle bounds

Границы этого Polygon. Это значение может быть null.

Since:

1.0

См. также:

getBoundingBox(), getBounds()

Конструкторы

Polygon

public Polygon()

Создаёт пустой многоугольник.

Since:

1.0

Polygon

public Polygon(int[] xpoints,
               int[] ypoints,
               int npoints)

Создаёт и инициализирует Polygon из указанных параметров.

Параметры:

xpoints - массив координат X

ypoints - массив координат Y

npoints - общее количество точек в Polygon

Исключения:

NegativeArraySizeException - если значение npoints отрицательное.

IndexOutOfBoundsException - если npoints больше длины xpoints или длины ypoints.

NullPointerException - если xpoints или ypoints null.

Since:

1.0

Методы

reset

public void reset()

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

Since:

1.4

См. также:

invalidate()

invalidate

public void invalidate()

Делает недействительными или очищает любые внутренние кэшированные данные, зависящие от координат вершин этого Polygon. Этот метод следует вызывать после любых прямых манипуляций с координатами в массивах xpoints или ypoints для предотвращения несогласованных результатов от методов, таких как getBounds или contains, которые могут кешировать данные из предыдущих вычислений, связанных с координатами вершин.

Since:

1.4

См. также:

getBounds()

translate

public void translate(int deltaX,
                      int deltaY)

Перемещает вершины Polygon на deltaX по оси X и на deltaY по оси Y.

Параметры:

deltaX - величина смещения по оси X

deltaY - величина смещения по оси Y

Since:

1.1

addPoint

public void addPoint(int x,
                     int y)

Параметры:

x - указанная координата X

y - указанная координата Y

Since:

1.0

См. также:

getBounds(), contains(java.awt.Point)

getBounds

public Rectangle getBounds()

Получает рамки этого Polygon. Рамки — это наименьший Rectangle, стороны которого параллельны осям X и Y координатного пространства, и который может полностью содержать Polygon.

Определено в:

getBounds в интерфейсе Shape

Возвращает:

a Rectangle описывающий рамки этого Polygon.

Since:

1.1

См. также:

Shape.getBounds2D()

getBoundingBox

@Deprecated
public Rectangle getBoundingBox()

Устарело. Начиная с версии JDK 1.1, заменено на getBounds().

Возвращает рамки этого Polygon.

Возвращает:

рамки этого Polygon.

Since:

1.0

contains

public boolean contains(Point p)

Определяет, находится ли указанная Point внутри этого Polygon.

Параметры:

p - указанная Point для проверки

Возвращает:

true если Polygon содержит Point; false в противном случае.

Since:

1.0

См. также:

contains(double, double)

contains

public boolean contains(int x,
                        int y)

Параметры:

x - указанная координата X для проверки

y - указанная координата Y для проверки

Возвращает:

true если этот Polygon содержит указанные координаты (x,y); false в противном случае.

Since:

1.1

См. также:

contains(double, double)

inside

@Deprecated
public boolean inside(int x,
                                  int y)

Устарело. Начиная с версии JDK 1.1, заменено на contains(int, int).

Определяет, содержатся ли указанные координаты в этом Polygon.

Параметры:

x - указанная координата X для проверки

y - указанная координата Y для проверки

Возвращает:

true если этот Polygon содержит указанные координаты (x,y); false в противном случае.

Since:

1.0

См. также:

contains(double, double)

getBounds2D

public Rectangle2D getBounds2D()

Определено в:

getBounds2D в интерфейсе Shape

Возвращает:

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

Since:

1.2

См. также:

Shape.getBounds()

contains

public boolean contains(double x,
                        double y)

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

Указано в:

contains в интерфейсе Shape

Параметры:

x - заданная координата X для проверки

y - заданная координата Y для проверки

Возвращает:

true , если указанные координаты находятся внутри границ Shape; false в противном случае.

С момента:

1.2

contains

public boolean contains(Point2D p)

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

Указано в:

contains в интерфейсе Shape

Параметры:

p - указанный Point2D для проверки

Возвращает:

true , если указанный Point2D находится внутри границ Shape; false в противном случае.

С момента:

1.2

intersects

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

Указано в:

intersects в интерфейсе Shape

Параметры:

x - координата X левого верхнего угла заданной прямоугольной области

y - координата Y левого верхнего угла заданной прямоугольной области

w - ширина заданной прямоугольной области

h - высота заданной прямоугольной области

Возвращает:

true , если внутренние области Shape и прямоугольной области пересекаются или обе, скорее всего, пересекаются, но вычисление пересечения слишком дорого; false в противном случае.

С момента:

1.2

См. также:

Area

intersects

public boolean intersects(Rectangle2D r)

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

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

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

Указано в:

intersects в интерфейсе Shape

Параметры:

r - указанный Rectangle2D

Возвращает:

true , если внутренние области Shape и заданного Rectangle2D пересекаются или обе, скорее всего, пересекаются, но вычисление пересечения слишком дорого; false в противном случае.

С момента:

1.2

См. также:

Shape.intersects(double, double, double, double)

contains

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

Указано в:

contains в интерфейсе Shape

Параметры:

x - координата X левого верхнего угла заданной прямоугольной области

y - координата Y левого верхнего угла заданной прямоугольной области

w - ширина заданной прямоугольной области

h - высота заданной прямоугольной области

Возвращает:

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

С момента:

1.2

См. также:

Area, Shape.intersects(double, double, double, double)

contains

public boolean contains(Rectangle2D r)

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

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

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

Указано в:

contains в интерфейсе Shape

Параметры:

r - указанный Rectangle2D

Возвращает:

true , если внутренняя область Shape полностью содержит Rectangle2D; false в противном случае или, если Shape содержит Rectangle2D , и метод intersects возвращает true , и вычисление включения слишком дорогостоящее.

С момента:

1.2

См. также:

Shape.contains(double, double, double, double)

getPathIterator

public PathIterator getPathIterator(AffineTransform at)

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

Указано в:

getPathIterator в интерфейсе Shape

Параметры:

at - необязательное AffineTransform для применения к координатам при их возвращении в ходе итерации, или null , если желаемы непрообразованные координаты

Возвращает:

объект PathIterator , предоставляющий доступ к геометрии этого Polygon.

С момента:

1.2

getPathIterator

public PathIterator getPathIterator(AffineTransform at,
                                    double flatness)

Возвращает объект-итератор, который перемещается по границе Shape и предоставляет доступ к геометрии контура Shape. Итератор возвращает только типы точек SEG_MOVETO, SEG_LINETO и SEG_CLOSE. Так как многоугольники уже плоские, параметр flatness игнорируется. Можно указать необязательное AffineTransform, в этом случае координаты, возвращаемые в процессе итерации, будут преобразовываться соответствующим образом.

Указано в:

getPathIterator в интерфейсе Shape

Параметры:

at - необязательное AffineTransform для применения к координатам при их возвращении в ходе итерации, или null , если желаемы непрообразованные координаты

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

Возвращает:

объект PathIterator , предоставляющий доступ к геометрии объекта Shape.

С момента:

1.2