- 直接已知的子类:
-
Path2D.Double
,Path2D.Float
Path2D
类提供了一个简单但灵活的形状,表示任意几何路径。它可以完全表示任何可以通过PathIterator
接口迭代的路径,包括所有的段类型和绕组规则,并实现了Shape
接口的所有基本命中测试方法。
在处理可以用浮点精度表示和使用的数据时,请使用Path2D.Float
。对于需要双精度精度或范围的数据,请使用Path2D.Double
。
Path2D
提供了构建和管理几何路径以及实现上述接口所需的设施,几乎没有额外的解释。如果需要操作封闭几何形状的内部超出简单命中测试,则Area
类提供了专门针对封闭图形的附加功能。虽然这两个类名义上都实现了Shape
接口,但它们在目的上有所不同,它们一起提供了几何形状的两个有用视图,其中Path2D
主要处理由路径段形成的轨迹,而Area
更多地处理2D几何空间中封闭区域的解释和操作。
PathIterator
接口有关路径组成的类型和控制如何确定哪些区域在路径内部或外部的绕组规则的更详细描述。
-
Nested Class Summary
Modifier and TypeClassDescriptionstatic class
Double
类定义了一个使用双精度浮点数存储坐标的几何路径。static class
Float
类定义了一个使用单精度浮点数存储坐标的几何路径。 -
Field Summary
Modifier and TypeFieldDescriptionstatic final int
用于确定路径内部的奇偶绕组规则。static final int
用于确定路径内部的非零绕组规则。 -
Method Summary
Modifier and TypeMethodDescriptionabstract void
append
(PathIterator pi, boolean connect) 将指定的PathIterator
对象的几何形状附加到路径,可能使用线段将新几何形状连接到现有路径段。final void
将指定的Shape
对象的几何形状附加到路径,可能使用线段将新几何形状连接到现有路径段。abstract Object
clone()
创建与此对象相同类的新对象。final void
通过绘制一条直线返回到最后一个moveTo
的坐标,关闭当前子路径。final boolean
contains
(double x, double y) 测试指定坐标是否在Shape
的边界内,如内部定义
的定义描述。final boolean
contains
(double x, double y, double w, double h) 测试Shape
的内部是否完全包含指定的矩形区域。static boolean
contains
(PathIterator pi, double x, double y) 测试指定坐标是否在指定PathIterator
的封闭边界内。static boolean
contains
(PathIterator pi, double x, double y, double w, double h) 测试指定矩形区域是否完全在指定PathIterator
的封闭边界内。static boolean
contains
(PathIterator pi, Point2D p) 测试指定的Point2D
是否在指定PathIterator
的封闭边界内。static boolean
contains
(PathIterator pi, Rectangle2D r) 测试指定的Rectangle2D
是否完全在指定PathIterator
的封闭边界内。final boolean
final boolean
测试Shape
的内部是否完全包含指定的Rectangle2D
。final Shape
返回表示此Path2D
的变换版本的新Shape
。abstract void
curveTo
(double x1, double y1, double x2, double y2, double x3, double y3) 添加一个曲线段,由三个新点定义,通过绘制一条贝塞尔曲线将当前坐标和指定坐标(x3,y3)
相交,使用指定点(x1,y1)
和(x2,y2)
作为贝塞尔控制点。final Rectangle
返回完全包围Shape
的整数Rectangle
。final Point2D
返回最近添加到路径末尾的坐标作为Point2D
对象。final PathIterator
getPathIterator
(AffineTransform at, double flatness) 返回一个迭代器对象,沿着Shape
的边界迭代,并提供Shape
轮廓几何的平坦视图。final int
返回填充样式绕组规则。final boolean
intersects
(double x, double y, double w, double h) 测试Shape
的内部是否与指定矩形区域的内部相交。static boolean
intersects
(PathIterator pi, double x, double y, double w, double h) 测试指定的PathIterator
的内部是否与指定的一组矩形坐标的内部相交。static boolean
intersects
(PathIterator pi, Rectangle2D r) 测试指定的PathIterator
的内部是否与指定的Rectangle2D
的内部相交。final boolean
测试Shape
的内部是否与指定的Rectangle2D
的内部相交。abstract void
lineTo
(double x, double y) 通过从当前坐标到双精度指定坐标绘制一条直线,向路径添加一个点。abstract void
moveTo
(double x, double y) 通过移动到双精度指定的坐标,向路径添加一个点。abstract void
quadTo
(double x1, double y1, double x2, double y2) 通过绘制一个二次曲线段,由两个新点定义,将当前坐标和指定坐标(x2,y2)
相交,使用指定点(x1,y1)
作为二次曲线控制点,向路径添加一个曲线段。final void
reset()
将路径重置为空。final void
setWindingRule
(int rule) 将此路径的绕组规则设置为指定值。abstract void
使用指定的AffineTransform
转换此路径的几何形状。abstract void
将此Path2D实例的容量修剪到其当前大小。Methods declared in class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods declared in interface java.awt.Shape
getBounds2D, getPathIterator
-
Field Details
-
WIND_EVEN_ODD
public static final int WIND_EVEN_ODD用于确定路径内部的奇偶绕组规则。- 自版本:
- 1.6
- 参见:
-
WIND_NON_ZERO
public static final int WIND_NON_ZERO用于确定路径内部的非零绕组规则。- 自版本:
- 1.6
- 参见:
-
-
Method Details
-
moveTo
public abstract void moveTo(double x, double y) 通过移动到双精度指定的坐标,向路径添加一个点。- 参数:
-
x
- 指定的X坐标 -
y
- 指定的Y坐标 - 自版本:
- 1.6
-
lineTo
public abstract void lineTo(double x, double y) 通过从当前坐标到双精度指定坐标绘制一条直线,向路径添加一个点。- 参数:
-
x
- 指定的X坐标 -
y
- 指定的Y坐标 - 自版本:
- 1.6
-
quadTo
public abstract void quadTo(double x1, double y1, double x2, double y2) 通过绘制一个二次曲线段,由两个新点定义,将当前坐标和指定坐标(x2,y2)
相交,使用指定点(x1,y1)
作为二次曲线控制点,向路径添加一个曲线段。所有坐标均以双精度指定。- 参数:
-
x1
- 二次控制点的X坐标 -
y1
- 二次控制点的Y坐标 -
x2
- 最终端点的X坐标 -
y2
- 最终端点的Y坐标 - 自版本:
- 1.6
-
curveTo
public abstract void curveTo(double x1, double y1, double x2, double y2, double x3, double y3) 通过绘制一个贝塞尔曲线段,由三个新点定义,将当前坐标和指定坐标(x3,y3)
相交,使用指定点(x1,y1)
和(x2,y2)
作为贝塞尔控制点,向路径添加一个曲线段。所有坐标均以双精度指定。- 参数:
-
x1
- 第一个贝塞尔控制点的X坐标 -
y1
- 第一个贝塞尔控制点的Y坐标 -
x2
- 第二个贝塞尔控制点的X坐标 -
y2
- 第二个贝塞尔控制点的Y坐标 -
x3
- 最终端点的X坐标 -
y3
- 最终端点的Y坐标 - 自版本:
- 1.6
-
closePath
public final void closePath()通过绘制一条直线返回到最后一个moveTo
的坐标来关闭当前子路径。如果路径已经关闭,则此方法不起作用。- 自版本:
- 1.6
-
append
将指定的Shape
对象的几何形状附加到路径中,可能使用线段将新几何形状连接到现有路径段。如果connect
参数为true
且路径不为空,则附加的Shape
的几何形状中的任何初始moveTo
都会转换为lineTo
段。如果这样一个连接的lineTo
段的目标坐标与当前打开子路径的结束坐标匹配,则该段将被省略为多余的。指定的Shape
的绕组规则将被忽略,附加的几何形状将由为此路径指定的绕组规则控制。- 参数:
-
s
- 要附加到此路径的Shape
-
connect
- 一个布尔值,用于控制是否将初始moveTo
段转换为lineTo
段以连接新几何形状到现有路径 - 自版本:
- 1.6
-
append
将指定的PathIterator
对象的几何形状附加到路径中,可能使用线段将新几何形状连接到现有路径段。如果connect
参数为true
且路径不为空,则附加的Shape
的几何形状中的任何初始moveTo
都会转换为lineTo
段。如果这样一个连接的lineTo
段的目标坐标与当前打开子路径的结束坐标匹配,则该段将被省略为多余的。指定的Shape
的绕组规则将被忽略,附加的几何形状将由为此路径指定的绕组规则控制。- 参数:
-
pi
- 要附加到此路径的PathIterator
-
connect
- 一个布尔值,用于控制是否将初始moveTo
段转换为lineTo
段以连接新几何形状到现有路径 - 自版本:
- 1.6
-
getWindingRule
public final int getWindingRule()返回填充样式的绕组规则。- 返回:
- 代表当前绕组规则的整数。
- 自版本:
- 1.6
- 参见:
-
setWindingRule
public final void setWindingRule(int rule) 将此路径的绕组规则设置为指定值。- 参数:
-
rule
- 表示指定绕组规则的整数 - 抛出:
-
IllegalArgumentException
- 如果rule
既不是WIND_EVEN_ODD
也不是WIND_NON_ZERO
- 自版本:
- 1.6
- 参见:
-
getCurrentPoint
返回最近添加到路径末端的坐标作为Point2D
对象。- 返回:
-
包含路径结束坐标的
Point2D
对象,如果路径中没有点则返回null
。 - 自版本:
- 1.6
-
reset
public final void reset()将路径重置为空。将附加位置设置回路径的开头,并且所有坐标和点类型都被忘记。- 自版本:
- 1.6
-
transform
使用指定的AffineTransform
转换此路径的几何形状。几何形状在原地转换,永久更改了由此对象定义的边界。- 参数:
-
at
- 用于转换区域的AffineTransform
- 自版本:
- 1.6
-
createTransformedShape
返回表示此Path2D
的转换版本的新Shape
。请注意,此方法未指定返回值的确切类型和坐标精度。该方法将返回一个包含转换几何形状的Shape
,其精度不低于此Path2D
当前维护的精度,但也可能不包含更多精度。如果结果中精度与存储大小之间的权衡重要,则应使用Path2D.Float
和Path2D.Double
子类中的便利构造函数来明确选择。- 参数:
-
at
- 用于转换新Shape
的AffineTransform
- 返回:
-
一个新的
Shape
,使用指定的AffineTransform
进行转换。 - 自版本:
- 1.6
-
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)
-
contains
测试指定坐标是否在闭合的指定PathIterator
的边界内。此方法为实现
Shape
接口的实现者提供了基本功能,以实现对Shape.contains(double, double)
方法的支持。- 参数:
-
pi
- 指定的PathIterator
-
x
- 指定的X坐标 -
y
- 指定的Y坐标 - 返回:
-
如果指定坐标在指定的
PathIterator
内部,则返回true
;否则返回false
- 自版本:
- 1.6
-
contains
- 参数:
-
pi
- 指定的PathIterator
-
p
- 指定的Point2D
- 返回:
-
如果指定坐标在指定的
PathIterator
内部,则返回true
;否则返回false
- 自版本:
- 1.6
-
contains
public final boolean contains(double x, double y) 测试指定坐标是否在Shape
的边界内,如内部定义所述。 -
contains
-
contains
测试指定的矩形区域是否完全在指定的PathIterator
的封闭边界内。此方法为实现
Shape
接口的实现者提供了一种基本功能,以实现对Shape.contains(double, double, double, double)
方法的支持。在某些情况下,此方法对象可能会保守地返回false,即指定的矩形区域与路径的某一段相交,但该段并不代表路径内部和外部之间的边界。如果这些段完全位于路径内部,那么它们可能是路径的一部分,具有
WIND_NON_ZERO
绕组规则,或者如果这些段以相反方向重迹,使得两组段互相抵消,而它们之间没有任何外部区域落在它们之间。要确定这些段是否代表路径内部的真实边界,需要进行涉及路径的所有段和绕组规则的广泛计算,因此超出了此实现的范围。- 参数:
-
pi
- 指定的PathIterator
-
x
- 指定的X坐标 -
y
- 指定的Y坐标 -
w
- 指定矩形区域的宽度 -
h
- 指定矩形区域的高度 - 返回:
-
如果指定的
PathIterator
包含指定的矩形区域,则返回true
;否则返回false
。 - 自:
- 1.6
-
contains
测试指定的Rectangle2D
是否完全在指定的PathIterator
的封闭边界内。此方法为实现
Shape
接口的实现者提供了一种基本功能,以实现对Shape.contains(Rectangle2D)
方法的支持。在某些情况下,此方法对象可能会保守地返回false,即指定的矩形区域与路径的某一段相交,但该段并不代表路径内部和外部之间的边界。如果这些段完全位于路径内部,那么它们可能是路径的一部分,具有
WIND_NON_ZERO
绕组规则,或者如果这些段以相反方向重迹,使得两组段互相抵消,而它们之间没有任何外部区域落在它们之间。要确定这些段是否代表路径内部的真实边界,需要进行涉及路径的所有段和绕组规则的广泛计算,因此超出了此实现的范围。- 参数:
-
pi
- 指定的PathIterator
-
r
- 指定的Rectangle2D
- 返回:
-
如果指定的
PathIterator
包含指定的Rectangle2D
,则返回true
;否则返回false
。 - 自:
- 1.6
-
contains
public final 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
类执行更精确的几何计算,因此如果需要更精确的答案,则可以使用该类。在某些情况下,此方法对象可能会保守地返回false,即指定的矩形区域与路径的某一段相交,但该段并不代表路径内部和外部之间的边界。如果这些段完全位于路径内部,那么它们可能是路径的一部分,具有
WIND_NON_ZERO
绕组规则,或者如果这些段以相反方向重迹,使得两组段互相抵消,而它们之间没有任何外部区域落在它们之间。要确定这些段是否代表路径内部的真实边界,需要进行涉及路径的所有段和绕组规则的广泛计算,因此超出了此实现的范围。 -
contains
测试Shape
的内部是否完全包含指定的Rectangle2D
。当intersect
方法返回true
且用于确定Shape
是否完全包含Rectangle2D
的计算代价过高时,Shape.contains()
方法允许Shape
实现保守地返回false
。- 这意味着对于某些
Shapes
,即使Shape
包含Rectangle2D
,此方法可能会返回false
。与大多数Shape
对象相比,Area
类执行更精确的几何计算,因此如果需要更精确的答案,则可以使用该类。
在某些情况下,此方法对象可能会保守地返回false,即指定的矩形区域与路径的某一段相交,但该段并不代表路径内部和外部之间的边界。如果这些段完全位于路径内部,那么它们可能是路径的一部分,具有
WIND_NON_ZERO
绕组规则,或者如果这些段以相反方向重迹,使得两组段互相抵消,而它们之间没有任何外部区域落在它们之间。要确定这些段是否代表路径内部的真实边界,需要进行涉及路径的所有段和绕组规则的广泛计算,因此超出了此实现的范围。 - 这意味着对于某些
-
intersects
测试指定的PathIterator
的内部是否与指定的一组矩形坐标的内部相交。此方法为实现
Shape
接口的实现者提供了一种基本功能,以实现对Shape.intersects(double, double, double, double)
方法的支持。在某些情况下,此方法对象可能会保守地返回true,即指定的矩形区域与路径的某一段相交,但该段并不代表路径内部和外部之间的边界。如果某些路径段以相反方向重迹,使得两组段互相抵消,而它们之间没有任何内部区域,那么就会出现这种情况。要确定这些段是否代表路径内部的真实边界,需要进行涉及路径的所有段和绕组规则的广泛计算,因此超出了此实现的范围。
- 参数:
-
pi
- 指定的PathIterator
-
x
- 指定的 X 坐标 -
y
- 指定的 Y 坐标 -
w
- 指定矩形坐标的宽度 -
h
- 指定矩形坐标的高度 - 返回值:
-
如果指定的
PathIterator
和指定的矩形坐标集的内部相交,则返回true
;否则返回false
。 - 自版本:
- 1.6
-
intersects
测试指定的PathIterator
的内部是否与指定的Rectangle2D
的内部相交。此方法为实现
Shape
接口的实现者提供了一个基本功能,以实现对Shape.intersects(Rectangle2D)
方法的支持。在某些情况下,此方法可能保守地返回 true,即指定的矩形区域与路径的某一段相交,但该段不代表路径的内部和外部之间的边界。这种情况可能发生在路径的某些段以相反方向重迹,使得两组段互相抵消而它们之间没有任何内部区域。要确定段是否代表路径内部的真实边界,需要进行涉及路径的所有段和绕组规则的广泛计算,因此超出了此实现的范围。
- 参数:
-
pi
- 指定的PathIterator
-
r
- 指定的Rectangle2D
- 返回值:
-
如果指定的
PathIterator
和指定的Rectangle2D
的内部相交,则返回true
;否则返回false
。 - 自版本:
- 1.6
-
intersects
public final boolean intersects(double x, double y, double w, double h) 测试Shape
的内部是否与指定的矩形区域的内部相交。如果任何点同时包含在Shape
的内部和指定的矩形区域内,则认为矩形区域与Shape
相交。Shape.intersects()
方法允许Shape
实现在以下情况下保守地返回true
:- 矩形区域和
Shape
有很高的可能相交,但 - 准确确定此交集的计算代价过高。
Shapes
,即使矩形区域与Shape
不相交,此方法可能返回true
。Area
类执行比大多数Shape
对象更准确的几何相交计算,因此如果需要更精确的答案,则可以使用该类。在某些情况下,此方法可能保守地返回 true,即指定的矩形区域与路径的某一段相交,但该段不代表路径的内部和外部之间的边界。这种情况可能发生在路径的某些段以相反方向重迹,使得两组段互相抵消而它们之间没有任何内部区域。要确定段是否代表路径内部的真实边界,需要进行涉及路径的所有段和绕组规则的广泛计算,因此超出了此实现的范围。
- 指定者:
-
intersects
在接口Shape
- 参数:
-
x
- 指定矩形区域左上角的 X 坐标 -
y
- 指定矩形区域左上角的 Y 坐标 -
w
- 指定矩形区域的宽度 -
h
- 指定矩形区域的高度 - 返回值:
-
如果
Shape
的内部与矩形区域的内部相交,或者两者高度可能相交且计算交集的代价过高,则返回true
;否则返回false
。 - 自版本:
- 1.6
- 参见:
- 矩形区域和
-
intersects
测试Shape
的内部是否与指定的Rectangle2D
的内部相交。Shape.intersects()
方法允许Shape
实现在以下情况下保守地返回true
:- 矩形区域和
Shape
有很高的可能相交,但 - 准确确定此交集的计算代价过高。
Shapes
,即使矩形区域与Shape
不相交,此方法可能返回true
。Area
类执行比大多数Shape
对象更准确的几何相交计算,因此如果需要更精确的答案,则可以使用该类。在某些情况下,此方法可能保守地返回 true,即指定的矩形区域与路径的某一段相交,但该段不代表路径的内部和外部之间的边界。这种情况可能发生在路径的某些段以相反方向重迹,使得两组段互相抵消而它们之间没有任何内部区域。要确定段是否代表路径内部的真实边界,需要进行涉及路径的所有段和绕组规则的广泛计算,因此超出了此实现的范围。
- 指定者:
-
intersects
在接口Shape
- 参数:
-
r
- 指定的Rectangle2D
- 返回值:
-
如果
Shape
的内部与指定的Rectangle2D
的内部相交,或者两者高度可能相交且计算交集的代价过高,则返回true
;否则返回false
。 - 自版本:
- 1.6
- 参见:
- 矩形区域和
-
getPathIterator
返回一个迭代器对象,沿着Shape
边界进行迭代,并提供Shape
轮廓几何的扁平视图。迭代器仅返回 SEG_MOVETO、SEG_LINETO 和 SEG_CLOSE 点类型。
如果指定了可选的
AffineTransform
,则迭代中返回的坐标将相应地进行变换。曲线段的细分量由
flatness
参数控制,该参数指定未扁平化的变换曲线上的任何点与返回的扁平化路径段之间的最大距离。请注意,可能会悄悄地对扁平化路径的准确性施加限制,导致非常小的扁平化参数被视为较大的值。如果存在限制,则由使用的特定实现定义。此方法的每次调用都会返回一个独立于同时使用的其他任何
PathIterator
对象遍历Shape
对象几何的新的PathIterator
对象。建议但不保证实现
Shape
接口的对象会将正在进行的迭代与在此类迭代期间可能发生的原始对象几何变化隔离开来。此类的迭代器不是多线程安全的,这意味着此
Path2D
类不保证修改此Path2D
对象的几何不会影响已经在进行的几何的任何迭代。- 指定者:
-
getPathIterator
在接口Shape
- 参数:
-
at
- 可选的AffineTransform
,在迭代返回的坐标中应用,如果希望使用未变换的坐标,则为null
-
flatness
- 用于近似曲线段的线段允许偏离原始曲线上任何点的最大距离 - 返回值:
-
一个新的
PathIterator
,独立地遍历Shape
几何的扁平视图。 - 自版本:
- 1.6
-
clone
创建与此对象相同类的新对象。- 覆盖:
-
clone
在类Object
- 返回值:
- 此实例的克隆。
- 抛出:
-
OutOfMemoryError
- 如果内存不足 - 自版本:
- 1.6
- 参见:
-
trimToSize
public abstract void trimToSize()将此 Path2D 实例的容量修剪到其当前大小。应用程序可以使用此操作来最小化路径的存储。- 自版本:
- 10
-