Android 自定义view Path 类学习

概述

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 类提供的方法可以组合使用，创建复杂的路径图形。
• 枚举类型的使用可以让路径操作更加直观和灵活。