所有已知实现类:: Arc2D, Arc2D.Double, Arc2D.Float, Area, BasicTextUI.BasicCaret, CubicCurve2D, CubicCurve2D.Double, CubicCurve2D.Float, DefaultCaret, Ellipse2D, Ellipse2D.Double, Ellipse2D.Float, GeneralPath, Line2D, Line2D.Double, Line2D.Float, Path2D, Path2D.Double, Path2D.Float, Polygon, QuadCurve2D, QuadCurve2D.Double, QuadCurve2D.Float, Rectangle, Rectangle2D, Rectangle2D.Double, Rectangle2D.Float, RectangularShape, RoundRectangle2D, RoundRectangle2D.Double, RoundRectangle2D.Float

public interface Shape

Shape接口提供了表示某种几何形状的对象的定义。 Shape由一个PathIterator对象描述，该对象可以表达Shape的轮廓以及确定轮廓如何将2D平面分割为内部和外部点的规则。每个Shape对象提供了回调以获取几何图形的边界框，确定点或矩形是否部分或完全位于Shape的内部，并检索描述Shape轮廓的轨迹路径的PathIterator对象。

内部定义: 仅当点完全位于Shape边界内部时，才认为点位于Shape内部:

它完全位于Shape边界内部或
它恰好位于Shape边界上且在增加的X方向上紧邻点的空间完全位于边界内部或
它恰好位于水平边界段上且在增加的Y方向上紧邻点的空间位于边界内部。

contains和intersects方法将Shape的内部视为其所包围的区域，就好像它被填充一样。这意味着这些方法认为未封闭的形状在确定形状是否包含或相交矩形或形状是否包含点时隐式封闭。

自:

1.2

参见:

Method Summary

Modifier and Type

Method

Description

boolean

contains(double x, double y)

测试指定坐标是否位于Shape的边界内部，如内部定义所述。

boolean

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

测试Shape的内部是否完全包含指定的矩形区域。

boolean

contains(Point2D p)

测试指定的Point2D是否位于Shape的边界内部，如内部定义所述。

boolean

contains(Rectangle2D r)

测试Shape的内部是否完全包含指定的Rectangle2D。

Rectangle

getBounds()

返回完全包围Shape的整数Rectangle。

Rectangle2D

getBounds2D()

返回Shape的高精度和更准确的边界框，比getBounds方法更紧凑。

PathIterator

getPathIterator(AffineTransform at)

返回一个迭代器对象，沿着Shape的边界迭代，并提供对Shape轮廓几何的访问。

PathIterator

getPathIterator(AffineTransform at, double flatness)

返回一个迭代器对象，沿着Shape的边界迭代，并提供对Shape轮廓几何的扁平视图的访问。

boolean

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

测试Shape的内部是否与指定矩形区域的内部相交。

boolean

intersects(Rectangle2D r)

测试Shape的内部是否与指定的Rectangle2D的内部相交。

Method Details
- getBounds
  
  Rectangle getBounds()
  
  返回完全包围Shape的整数Rectangle。请注意，返回的Rectangle未必是最小的包围Shape的边界框，只是Shape完全位于指定Rectangle内部。如果Shape溢出整数数据类型的有限范围，则返回的Rectangle也可能无法完全包围Shape。由于其在表示上更加灵活，getBounds2D方法通常返回更紧凑的边界框。
  请注意，内部定义可能导致这样的情况：定义形状的轮廓上的点可能不被认为包含在返回的bounds对象中，但只有在这些点也不被认为包含在原始shape中的情况下才是如此。
  
  如果一个point根据contains(point)方法在shape内部，那么根据bounds的contains(point)方法，它必须在返回的Rectangle边界对象内部。具体来说:
  
  shape.contains(x,y)要求bounds.contains(x,y)
  
  如果一个point不在shape内部，则它可能仍然包含在bounds对象中:
  
  bounds.contains(x,y)不意味着shape.contains(x,y)
  返回:
  
  完全包围Shape的整数Rectangle。
  
  自:
  
  1.2
  
  参见:
  
  getBounds2D()
- getBounds2D
  
  Rectangle2D getBounds2D()
  
  返回Shape的高精度和更准确的边界框，比getBounds方法更紧凑。请注意，返回的Rectangle2D未必是最小的包围Shape的边界框，只是Shape完全位于指定Rectangle2D内部。此方法返回的边界框通常比getBounds方法返回的边界框更紧凑，并且不会因为溢出问题而失败，因为返回值可以是使用双精度值存储尺寸的Rectangle2D的实例。
  请注意，内部定义可能导致这样的情况：定义形状的轮廓上的点可能不被认为包含在返回的bounds对象中，但只有在这些点也不被认为包含在原始shape中的情况下才是如此。
  
  如果一个point根据contains(point)方法在shape内部，那么根据bounds的contains(point)方法，它必须在返回的Rectangle2D边界对象内部。具体来说:
  
  shape.contains(p)要求bounds.contains(p)
  
  如果一个point不在shape内部，则它可能仍然包含在bounds对象中:
  
  bounds.contains(p)不意味着shape.contains(p)
  返回:
  
  一个高精度的Rectangle2D实例，是Shape的边界框。
  
  自:
  
  1.2
  
  参见:
  
  getBounds()
- contains
  
  boolean contains(double x, double y)
  
  测试指定坐标是否位于Shape的边界内部，如内部定义所述。
  
  参数:
  
  x - 要测试的指定X坐标
  
  y - 要测试的指定Y坐标
  
  返回值:
  
  如果指定的坐标在Shape边界内，则返回true; 否则返回false。
  
  自版本:
  
  1.2
- contains
  
  boolean contains(Point2D p)
  
  测试指定的Point2D是否在Shape的边界内，如内部定义所述。
  
  参数:
  
  p - 要测试的指定Point2D
  
  返回值:
  
  如果指定的Point2D在Shape的边界内，则返回true; 否则返回false。
  
  自版本:
  
  1.2
- intersects
  
  boolean intersects(double x, double y, double w, double h)
  测试Shape的内部是否与指定的矩形区域的内部相交。如果任何点同时包含在Shape的内部和指定的矩形区域内，则认为矩形区域与Shape相交。
  Shape.intersects()方法允许Shape实现在以下情况下保守地返回true：
  
  矩形区域和Shape有很高的概率相交，但
  
  准确确定此交集的计算代价过高。
  
  这意味着对于某些Shapes，即使矩形区域与Shape不相交，此方法可能返回true。与大多数Shape对象相比，Area类执行更准确的几何相交计算，因此如果需要更精确的答案，则可以使用该类。
  参数:
  
  x - 指定矩形区域左上角的X坐标
  
  y - 指定矩形区域左上角的Y坐标
  
  w - 指定矩形区域的宽度
  
  h - 指定矩形区域的高度
  
  返回值:
  
  如果Shape的内部和矩形区域的内部相交，或者两者高度可能相交且交集计算代价过高，则返回true; 否则返回false。
  
  自版本:
  
  1.2
  
  参见:
  
  Area
- intersects
  
  boolean intersects(Rectangle2D r)
  测试Shape的内部是否与指定的Rectangle2D相交。Shape.intersects()方法允许Shape实现在以下情况下保守地返回true：
  
  矩形区域和Shape有很高的概率相交，但
  
  准确确定此交集的计算代价过高。
  
  这意味着对于某些Shapes，即使矩形区域与Shape不相交，此方法可能返回true。与大多数Shape对象相比，Area类执行更准确的几何相交计算，因此如果需要更精确的答案，则可以使用该类。
  参数:
  
  r - 指定的Rectangle2D
  
  返回值:
  
  如果Shape的内部和指定的Rectangle2D的内部相交，或者两者高度可能相交且交集计算代价过高，则返回true; 否则返回false。
  
  自版本:
  
  1.2
  
  参见:
  
  intersects(double, double, double, double)
- contains
  
  boolean contains(double x, double y, double w, double h)
  测试Shape的内部是否完全包含指定的矩形区域。所有位于矩形区域内部的坐标必须完全位于Shape内部，才能认为整个矩形区域被包含在Shape内部。
  Shape.contains()方法允许Shape实现在以下情况下保守地返回false：
  
  intersect方法返回true且
  
  确定Shape是否完全包含矩形区域的计算代价过高。
  
  这意味着对于某些Shapes，即使Shape包含矩形区域，此方法可能返回false。与大多数Shape对象相比，Area类执行更准确的几何计算，因此如果需要更精确的答案，则可以使用该类。
  参数:
  
  x - 指定矩形区域左上角的X坐标
  
  y - 指定矩形区域左上角的Y坐标
  
  w - 指定矩形区域的宽度
  
  h - 指定矩形区域的高度
  
  返回值:
  
  如果Shape的内部完全包含指定的矩形区域，则返回true; 否则返回false，或者如果Shape包含矩形区域且intersects方法返回true且包含计算代价过高，则返回false。
  
  自版本:
  
  1.2
  
  参见:
  
  Area
  
  intersects(double, double, double, double)
- contains
  
  boolean contains(Rectangle2D r)
  测试Shape的内部是否完全包含指定的Rectangle2D。Shape.contains()方法允许Shape实现在以下情况下保守地返回false：
  
  intersect方法返回true且
  
  确定Shape是否完全包含Rectangle2D的计算代价过高。
  
  这意味着对于某些Shapes，即使Shape包含Rectangle2D，此方法可能返回false。与大多数Shape对象相比，Area类执行更准确的几何计算，因此如果需要更精确的答案，则可以使用该类。
  参数:
  
  r - 指定的Rectangle2D
  
  返回值:
  
  如果Shape的内部完全包含Rectangle2D，则返回true; 否则返回false，或者如果Shape包含Rectangle2D且intersects方法返回true且包含计算代价过高，则返回false。
  
  自版本:
  
  1.2
  
  参见:
  
  contains(double, double, double, double)
- getPathIterator
  
  PathIterator getPathIterator(AffineTransform at)
  
  返回一个迭代器对象，沿着Shape边界进行迭代，并提供对Shape轮廓几何的访问。如果指定了可选的AffineTransform，则迭代中返回的坐标将相应地进行转换。
  每次调用此方法都会返回一个独立于同时使用的其他PathIterator对象的新的PathIterator对象，用于遍历Shape对象的几何。
  
  建议但不保证实现Shape接口的对象会将正在进行的迭代与在此类迭代期间可能发生的对原始对象几何的任何更改隔离开来。
  
  参数:
  
  at - 要应用于迭代中返回的坐标的可选AffineTransform，如果需要未转换的坐标，则为null
  
  返回值:
  
  一个新的PathIterator对象，独立遍历Shape的几何。
  
  自版本:
  
  1.2
- getPathIterator
  
  PathIterator getPathIterator(AffineTransform at, double flatness)
  
  返回一个迭代器对象，沿着Shape边界进行迭代，并提供Shape轮廓几何的扁平视图访问。
  迭代器仅返回SEG_MOVETO、SEG_LINETO和SEG_CLOSE点类型。
  
  如果指定了可选的AffineTransform，则迭代中返回的坐标将相应地进行转换。
  
  曲线段的细分量由flatness参数控制，该参数指定未扁平化的转换曲线上的任何点与返回的扁平化路径段之间的最大距离。请注意，可能会悄悄地对扁平化路径的准确性施加限制，导致非常小的扁平化参数被视为较大的值。如果存在限制，则其定义由所使用的特定实现定义。
  
  每次调用此方法都会返回一个独立于同时使用的其他PathIterator对象的新的PathIterator对象，用于独立遍历Shape对象的几何。
  
  建议但不保证实现Shape接口的对象会将正在进行的迭代与在此类迭代期间可能发生的对原始对象几何的任何更改隔离开来。
  
  参数:
  
  at - 要应用于迭代中返回的坐标的可选AffineTransform，如果需要未转换的坐标，则为null
  
  flatness - 用于近似曲线段的线段允许偏离原始曲线上任意点的最大距离
  
  返回值:
  
  一个新的PathIterator，独立遍历Shape几何的扁平视图。
  
  自版本:
  
  1.2

Interface Shape

Method Summary

Method Details

getBounds

getBounds2D

contains

contains

intersects

intersects

contains

contains

getPathIterator

getPathIterator