Polygon (Java Platform SE 8 )

java.lang.Object
- java.awt.Polygon

All Implemented Interfaces:

Shape， Serializable
```
public class Polygon
extends Object
implements Shape, Serializable
```
的 Polygon类封装了一个描述一个封闭区域内，二维坐标空间。这个区域是有界的任意数量的线段，其中每一个是一个边的多边形。在内部，一个多边形组成的一系列 (x,y)坐标对，每对顶点定义一个空的多边形，并连续两对一线，多边形的一条边的端点。 (x,y)点的第一和最后对通过线段闭合多边形加入。这是一个 Polygon奇偶缠绕规则定义。看到一个奇偶缠绕规则定义 WIND_EVEN_ODD。这类的命中测试方法，包括 contains， intersects和 inside方法，使用在 Shape类注释描述的nullinsideness定义。

从以下版本开始：

一

另请参见：

Shape， Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`protected Rectangle`	`bounds` 这 `Polygon`界限。
`int`	`npoints` 点的总数。
`int[]`	`xpoints` X坐标数组。
`int[]`	`ypoints` Y坐标数组。

构造方法摘要

构造方法
Constructor and Description
`Polygon()` 创建一个空的多边形。
`Polygon(int[] xpoints, int[] ypoints, int npoints)` 构造和初始化一个 `Polygon`从指定的参数。

方法摘要

所有方法接口方法具体的方法弃用的方法
Modifier and Type	Method and Description
`void`	`addPoint(int x, int y)` 将指定的坐标，这 `Polygon`。
`boolean`	`contains(double x, double y)` 如果指定的坐标的 `Shape`边界内，由 definition of insideness描述。
`boolean`	`contains(double x, double y, double w, double h)` 如果 `Shape`测试的内部完全包含指定的矩形区域。
`boolean`	`contains(int x, int y)` 确定指定的坐标，这里面 `Polygon`。
`boolean`	`contains(Point p)` 确定指定的 `Point`是这里面 `Polygon`。
`boolean`	`contains(Point2D p)` 如果指定的 `Point2D`的 `Shape`边界内，由 definition of insideness描述。
`boolean`	`contains(Rectangle2D r)` 如果 `Shape`测试的内部完全包含指定的 `Rectangle2D`。
`Rectangle`	`getBoundingBox()` 过时的。作为JDK 1.1版本，取而代之的`getBounds()`。
`Rectangle`	`getBounds()` 得到这 `Polygon`包围盒。
`Rectangle2D`	`getBounds2D()` 返回一个高的精度和更精确的包围盒的 `Shape`比 `getBounds`方法。
`PathIterator`	`getPathIterator(AffineTransform at)` 返回一个迭代器对象，就沿着这 `Polygon`边界提供了进入这个 `Polygon`轮廓的几何。
`PathIterator`	`getPathIterator(AffineTransform at, double flatness)` 返回一个迭代器对象，迭代的 `Shape`沿边界和提供的 `Shape`轮廓的几何。
`boolean`	`inside(int x, int y)` 过时的。作为JDK 1.1版本，取而代之的`contains(int, int)`。
`boolean`	`intersects(double x, double y, double w, double h)` 如果 `Shape`测试的内部与一个指定的矩形区域内。
`boolean`	`intersects(Rectangle2D r)` 如果 `Shape`测试的内部与指定的 `Rectangle2D`内部。
`void`	`invalidate()` 无效或刷新任何内部高速缓存的数据，取决于这 `Polygon`顶点坐标。
`void`	`reset()` 这 `Polygon`对象重置为空的多边形。
`void`	`translate(int deltaX, int deltaY)` 翻译的 `Polygon`顶点的 `deltaX`沿X轴和Y轴 `deltaY`沿。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - npoints
```
public int npoints
```
    点的总数。对 npoints价值体现在这 Polygon有效点的数量可能会低于在 xpoints或 ypoints元素个数。此值可以为空。
    
    从以下版本开始：
    
    一
    
    另请参见：
    
    addPoint(int, int)
  - xpoints
```
public int[] xpoints
```
    X坐标数组。元素的个数可能比这个 Polygon X坐标数。额外的元素，让新的点被添加到这个 Polygon没有重新创建这个数组。对 npoints值等于该 Polygon有效点数。
    
    从以下版本开始：
    
    一
    
    另请参见：
    
    addPoint(int, int)
  - ypoints
```
public int[] ypoints
```
    Y坐标数组。元素的个数可能比这个数 Polygon Y坐标。额外的元素，让新的点被添加到这个 Polygon没有重新创建这个数组。对 npoints值等于该 Polygon有效点数。
    
    从以下版本开始：
    
    一
    
    另请参见：
    
    addPoint(int, int)
  - bounds
```
protected Rectangle bounds
```
    这 Polygon界限。此值可以为空。
    
    从以下版本开始：
    
    一
    
    另请参见：
    
    getBoundingBox()， getBounds()
- Constructor Detail
  - Polygon
```
public Polygon()
```
    创建一个空的多边形。
    
    从以下版本开始：
    
    一
  - 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。
    
    从以下版本开始：
    
    一
- 方法详细信息
  - reset
```
public void reset()
```
    这 Polygon对象重置为空的多边形。坐标阵列和它们中的数据是左不变的，但点的数量被重置为零，以标记旧的顶点数据为无效，并开始积累新的顶点数据在开始。所有与旧的顶点有关的内部缓存数据都被丢弃。请注意，由于坐标数组从复位前可重复使用，创建一个新的空 Polygon可能比重置当前如果在新的多边形数据顶点个数比数据顶点个数明显偏小，从之前的复位更高效的内存。
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    invalidate()
  - invalidate
```
public void invalidate()
```
    无效或刷新任何内部高速缓存的数据依赖于顶点的坐标这 Polygon。这种方法被称为后的坐标任何直接操作在 xpoints或避免不一致的结果 ypoints阵列等方法 getBounds或 contains可能缓存数据从先前的计算涉及的顶点坐标。
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    getBounds()
  - translate
```
public void translate(int deltaX,
                      int deltaY)
```
    翻译的 Polygon顶点的 deltaX沿X轴和Y轴 deltaY沿。
    
    参数
    
    deltaX -沿X轴的数量
    
    deltaY -沿Y轴的数量
    
    从以下版本开始：
    
    一点一
  - addPoint
```
public void addPoint(int x,
                     int y)
```
    将指定的坐标，这 Polygon。
    如果一个操作，计算这个Polygon包围盒已经进行，如getBounds或contains，那么这个方法更新包围盒。
    
    参数
    
    x -指定的X坐标
    
    y -指定的y坐标
    
    从以下版本开始：
    
    一
    
    另请参见：
    
    getBounds()， contains(java.awt.Point)
  - getBounds
```
public Rectangle getBounds()
```
    得到这 Polygon包围盒，包围盒的两侧平行于x和y轴的坐标空间的最小 Rectangle，完全可以包含 Polygon。
    
    Specified by:
    
    getBounds 接口 Shape
    
    结果
    
    一个 Rectangle定义此 Polygon界限。
    
    从以下版本开始：
    
    一点一
    
    另请参见：
    
    Shape.getBounds2D()
  - getBoundingBox
```
@Deprecated
public Rectangle getBoundingBox()
```
    过时的。作为JDK 1.1版本，取而代之的getBounds()。
    
    返回该 Polygon界限。
    
    结果
    
    这 Polygon界限。
    
    从以下版本开始：
    
    一
  - contains
```
public boolean contains(Point p)
```
    确定指定的 Point是这里面 Polygon。
    
    参数
    
    p -指定 Point进行测试
    
    结果
    
    true如果 Polygon包含 Point； false否则。
    
    从以下版本开始：
    
    一
    
    另请参见：
    
    contains(double, double)
  - contains
```
public boolean contains(int x,
                        int y)
```
    确定指定的坐标，这里面 Polygon。
    
    参数
    
    x -指定的x坐标进行测试
    
    y -指定的y坐标进行测试
    
    结果
    
    如果这 Polygon true包含指定的坐标 (x,y)； false否则。
    
    从以下版本开始：
    
    一点一
    
    另请参见：
    
    contains(double, double)
  - inside
```
@Deprecated
public boolean inside(int x,
                                  int y)
```
    过时的。作为JDK 1.1版本，取而代之的contains(int, int)。
    
    确定指定的坐标都包含在这 Polygon。
    
    参数
    
    x -指定的x坐标进行测试
    
    y -指定的y坐标进行测试
    
    结果
    
    如果这 Polygon true包含指定的坐标 (x,y)； false否则。
    
    从以下版本开始：
    
    一
    
    另请参见：
    
    contains(double, double)
  - getBounds2D
```
public Rectangle2D getBounds2D()
```
    返回一个高的精度和更精确的包围盒的 Shape比 getBounds方法。需要注意的是不能保证返回的 Rectangle2D是最小包围盒包围 Shape，只有 Shape完全在于在显示 Rectangle2D。包围盒返回此方法通常是更严格的比 getBounds返回的方法，永远不会失败由于溢出的问题由于返回值可以是使用双精度值存储维度的 Rectangle2D实例。
    请注意， definition of insideness可导致的情况下，点上的shape定义轮廓可能不被视为包含在返回的bounds对象，但只有在这些点的情况下，也不被认为是包含在原始的shape。
    
    如果一个point在shape根据contains(point)方法，那么它必须在返回的Rectangle2D界根据的bounds contains(point)方法的具体对象：
    
    shape.contains(p)需要bounds.contains(p)
    
    如果一个point是不是在shape，那么它可能仍然包含在bounds对象：
    
    bounds.contains(p)并不意味着shape.contains(p)
    
    Specified by:
    
    getBounds2D 接口 Shape
    
    结果
    
    这是一个高精度的 Rectangle2D包围盒的 Shape实例。
    
    从以下版本开始：
    
    一点二
    
    另请参见：
    
    Shape.getBounds()
  - contains
```
public boolean contains(double x,
                        double y)
```
    如果指定的坐标的 Shape边界内，由 definition of insideness描述。
    
    Specified by:
    
    contains 接口 Shape
    
    参数
    
    x -指定的x坐标进行测试
    
    y -指定的y坐标进行测试
    
    结果
    
    true如果指定坐标的 Shape边界内； false否则。
    
    从以下版本开始：
    
    一点二
  - contains
```
public boolean contains(Point2D p)
```
    如果指定的 Point2D的 Shape边界内，由 definition of insideness描述。
    
    Specified by:
    
    contains 接口 Shape
    
    参数
    
    p -指定 Point2D进行测试
    
    结果
    
    true如果指定 Point2D的 Shape边界内； false否则。
    
    从以下版本开始：
    
    一点二
  - intersects
```
public boolean intersects(double x,
                          double y,
                          double w,
                          double h)
```
    如果 Shape测试的内部与一个指定的矩形区域内。矩形区域是相交的 Shape如果任何点是否包含在内部的 Shape和指定的矩形区域。
    的Shape.intersects()方法允许Shape实施保守的回报true时：
    - 有一个高概率的矩形面积和Shape相交，但
    - 准确地确定这个路口计算是昂贵的。
    这意味着对一些 Shapes这个方法可能返回 true即使矩形区域不相交的 Shape， Area类执行更精确的计算几何相交比大多数 Shape对象，因此可以更准确的答案是需要用。
    Specified by:
    
    intersects 接口 Shape
    
    参数
    
    x -指定的矩形区域左上角的x坐标
    
    y -指定的矩形区域的左上角的Y坐标
    
    w -指定的矩形区域的宽度
    
    h -指定矩形区域的高度
    
    结果
    
    true如果的 Shape内部与矩形区域内相交，或是相交，相交计算高度可能会执行 false否则太贵。
    
    从以下版本开始：
    
    一点二
    
    另请参见：
    
    Area
  - intersects
```
public boolean intersects(Rectangle2D r)
```
    如果 Shape测试的内部与指定的 Rectangle2D内部。的 Shape.intersects()方法允许 Shape实施保守的回报 true时：
    - 有一个高概率的Rectangle2D和Shape相交，但
    - 准确地确定这个路口计算是昂贵的。
    这意味着对一些 Shapes这个方法可能返回 true即使 Rectangle2D不相交的 Shape。的 Area类执行更精确的计算几何相交比大多数 Shape对象，因此可以更准确的答案是需要用。
    Specified by:
    
    intersects 接口 Shape
    
    参数
    
    r -指定 Rectangle2D
    
    结果
    
    true如果的 Shape内部和指定的 Rectangle2D内部相交，或是相交，相交计算高度可能会执行 false否则太贵。
    
    从以下版本开始：
    
    一点二
    
    另请参见：
    
    Shape.intersects(double, double, double, double)
  - contains
```
public boolean contains(double x,
                        double y,
                        double w,
                        double h)
```
    如果 Shape测试的内部完全包含指定的矩形区域。所有的坐标，在矩形区域必须位于 Shape整个矩形区域被认为是包含在 Shape。
    的Shape.contains()方法允许Shape实施保守的回报false时：
    - 该方法返回true和intersect
    - 要确定是否Shape完全包含矩形区域是昂贵的计算。
    这意味着对一些 Shapes这个方法可能返回 false即使 Shape包含矩形区域。的 Area类执行更精确的几何计算比大多数 Shape对象，因此可以更准确的答案是需要用。
    Specified by:
    
    contains 接口 Shape
    
    参数
    
    x -指定的矩形区域左上角的x坐标
    
    y -指定的矩形区域的左上角的Y坐标
    
    w -指定的矩形区域的宽度
    
    h -指定矩形区域的高度
    
    结果
    
    true如果的 Shape内部完全包含指定矩形区域； false否则，如果 Shape包含矩形面积和 intersects方法返回 true和遏制的计算是执行太贵。
    
    从以下版本开始：
    
    一点二
    
    另请参见：
    
    Area， Shape.intersects(double, double, double, double)
  - contains
```
public boolean contains(Rectangle2D r)
```
    如果 Shape测试的内部完全包含指定的 Rectangle2D。的 Shape.contains()方法允许 Shape实施保守的回报 false时：
    - 该方法返回true和intersect
    - 要确定是否Shape完全包含Rectangle2D是昂贵的计算。
    这意味着对一些 Shapes这个方法可能返回 false即使 Shape包含 Rectangle2D， Area类执行更精确的几何计算比大多数 Shape对象，因此可以更准确的答案是需要用。
    Specified by:
    
    contains 接口 Shape
    
    参数
    
    r -指定 Rectangle2D
    
    结果
    
    true如果的 Shape内部完全包含 false Rectangle2D；否则，如果 Shape包含 Rectangle2D和 intersects方法返回 true和遏制的计算是执行太贵。
    
    从以下版本开始：
    
    一点二
    
    另请参见：
    
    Shape.contains(double, double, double, double)
  - getPathIterator
```
public PathIterator getPathIterator(AffineTransform at)
```
    返回一个迭代器对象，就沿着这 Polygon边界提供了进入这个 Polygon轮廓的几何。一个可选的 AffineTransform可以指定使迭代返回相应的坐标变换。
    
    Specified by:
    
    getPathIterator 接口 Shape
    
    参数
    
    at可选 AffineTransform被应用到坐标作为他们在迭代返回，或 null如果需要转化的坐标
    
    结果
    
    一个 PathIterator对象提供了访问该 Polygon几何。
    
    从以下版本开始：
    
    一点二
  - getPathIterator
```
public PathIterator getPathIterator(AffineTransform at,
                                    double flatness)
```
    返回一个迭代器对象，迭代的 Shape沿边界和提供的 Shape轮廓的几何。只有seg_moveto，seg_lineto，和seg_close点类型通过返回的迭代器。由于多边形已经持平，这 flatness参数被忽略。一个可选的 AffineTransform可规定在这种情况下，返回的坐标在迭代进行相应的转换。
    
    Specified by:
    
    getPathIterator 接口 Shape
    
    参数
    
    at可选 AffineTransform被应用到坐标作为他们在迭代返回，或 null如果需要转化的坐标
    
    flatness，给定曲线的控制点可以从之前的细分曲线是通过共线直线连接端点取代量最大。由于多边形已经平 flatness参数被忽略。
    
    结果
    
    一个 PathIterator对象提供了访问的 Shape物体的几何形状。
    
    从以下版本开始：
    
    一点二

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class Polygon

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Field Detail

npoints

xpoints

ypoints

bounds

Constructor Detail

Polygon

Polygon

方法详细信息

reset

invalidate

translate

addPoint

getBounds

getBoundingBox

contains

contains

inside

getBounds2D

contains

contains

intersects

intersects

contains

contains

getPathIterator

getPathIterator