概述
Android 的 Path 类是用于创建和操作二维矢量路径的工具。它支持直线、二次曲线、三次曲线等基本图形元素，并且可以进行各种逻辑操作，如合并、相交、相减等。以下是 Path 类的一些核心概念和操作方法。
构造方法
-
Path(): 创建一个新的空路径。 -
Path(Path src): 基于已有的Path对象创建一个新的路径。
枚举类型
Op
-
DIFFERENCE: 差集操作。 -
INTERSECT: 交集操作。 -
UNION: 并集操作。 -
XOR: 异或操作。 -
REVERSE_DIFFERENCE: 反向差集操作。
FillType
填充类型，决定路径的“内部”如何计算。
-
WINDING: 非零环绕数规则。 -
EVEN_ODD: 奇偶环绕数规则。 -
INVERSE_WINDING: 反向非零环绕数规则。 -
INVERSE_EVEN_ODD: 反向奇偶环绕数规则。
Direction
定义路径的走向方向。
-
CW: 顺时针方向。 -
CCW: 逆时针方向。
基础操作
-
reset(): 清除路径上的所有线条和曲线，但保留填充类型。 -
rewind(): 清除路径上的所有线条和曲线，但不保留任何状态信息。
路径操作
-
op(Path path, Op op): 对当前路径和另一个路径执行逻辑操作。 -
op(Path path1, Path path2, Op op): 对两个路径执行逻辑操作。
路径状态检查
-
isEmpty(): 检查路径是否为空。 -
isRect(RectF rect): 检查路径是否为矩形，并返回矩形的边界。
路径点操作
不带r的方法是基于原点的坐标系（moveTo）
带r的方法是基于当前点的坐标系（rMoveTo）
-
incReserve(int extraPtCount): 提示路径为添加更多点做准备，以更高效地分配存储空间。 -
moveTo(float x, float y): 设置下一个轮廓的起点。 -
setLastPoint (float dx, float dy):是重置上一次操作的最后一个点 -
rMoveTo(float dx, float dy): 相对于上一个轮廓的终点设置下一个轮廓的起点。 -
lineTo(float x, float y): 添加一条从最后一个点到指定点的直线。 -
rLineTo(float dx, float dy): 相对于上一个点添加一条直线。 -
quadTo(float x1, float y1, float x2, float y2): 添加一个二次贝塞尔曲线。 -
rQuadTo(float dx1, float dy1, float dx2, float dy2): 相对于上一个点添加一个二次贝塞尔曲线。 -
cubicTo(float x1, float y1, float x2, float y2, float x3, float y3): 添加一个三次贝塞尔曲线。 -
rCubicTo(float x1, float y1, float x2, float y2, float x3, float y3): 相对于上一个点添加一个三次贝塞尔曲线。 -
close ():连接当前最后一个点和最初的一个点(如果两个点不重合的话)，最终形成一个封闭的图形。
弧和圆
这里RectF 中的起点是三点钟方向
-
arcTo(RectF oval, float startAngle, float sweepAngle, boolean forceMoveTo): 添加一个弧线。（如果圆弧的七点和上次最后一个坐标不同就连接两点） -
addArc (RectF oval, float startAngle, float sweepAngle)：添加一个圆弧（直接添加圆弧） -
addOval(RectF oval, Direction dir): 添加一个椭圆形状。 -
addCircle(float x, float y, float radius, Direction dir): 添加一个圆形。
矩阵
-
addRect (float left, float top, float right, float bottom, Path.Direction dir)：添加矩阵 -
addRect (RectF rect, Path.Direction dir)：添加矩阵
路径转换
-
offset(float dx, float dy): 将路径偏移指定的距离。 -
transform(Matrix matrix): 应用矩阵变换到路径上。
其他方法
-
addPath(Path src): 将另一个路径添加到当前路径。 -
computeBounds(RectF bounds, boolean exact): 计算路径的边界。
注意事项
- 使用
Path类时，需要注意路径的走向方向，尤其是在创建封闭形状时。 -
Path类提供的方法可以组合使用，创建复杂的路径图形。 - 枚举类型的使用可以让路径操作更加直观和灵活。
