【Android UI】Path 测量 PathMeasure ② ( PathMeasure API 简介 | nextContour 函数 | getPosTan 函数 ★ | 曲线切线处理 )

一、PathMeasure API 简介

---

PathMeasure 官方文档 : https://developer.android.google.cn/reference/kotlin/android/graphics/PathMeasure

PathMeasure 是 Path 的一个 工具类 , 字面意思就是 Path 的测量工具类 ,

为该 PathMeasure 设置一个 Path 对象 , 则可以对 Path 的 路径 , 轨迹 进行测量 , 可以精确的计算出 Path 的运动轨迹 ,

PathMeasure 提供了 $7$ 个函数用于实现相关功能 ;

1、nextContour 函数

nextContour 函数 作用是 跳转到下一个轮廓 ;

Path 是可以进行组合的 , 调用 Path 的 op 函数 , 可以将两个 Path 轮廓组合在一起 , 设置了组合以后 , 假如对其中的一个 Path 进行测量 , 调用 nextContour 函数 , 即可对另外一个 Path 轮廓进行测量 ;

两个 Path 没有先后顺序 ;

nextContour 函数原型 :

open fun nextContour(): Boolean

Move to the next contour in the path. 
Return true if one exists, or false if we're done with the path.

移动到路径中的下一个轮廓。
如果存在，则返回true；如果路径已完成，则返回false。

2、getPosTan 函数 ★

getPosTan 函数 作用是 获取指定长度位置的坐标点 以及该点对应切线的值 ;

getPosTan 函数原型 :

open fun getPosTan(
    distance: Float, 
    pos: FloatArray!, 
    tan: FloatArray!
): Boolean

Pins distance to 0 <= distance <= getLength(), 
and then computes the corresponding position and tangent. 

Returns false if there is no path, or a zero-length path was specified, 
in which case position and tangent are unchanged.

将距离固定到0<=距离<=getLength（），
然后计算相应的位置和切线。

如果没有路径或指定了零长度路径，则返回false，
在这种情况下，位置和切线不变。

• distance: Float 参数 : 沿当前轮廓进行采样的距离 ;

The distance along the current contour to sample

• pos: FloatArray! 参数 : 如果不为null，则返回采样位置（x==[0]，y==[1]） ;

If not null, returns the sampled position (x==[0], y==[1])

• tan: FloatArray! 参数 : 如果不为null，则返回采样的切线（x==[0]，y==[1]）;

If not null, returns the sampled tangent (x==[0], y==[1])

• Boolean 返回值 : 如果没有与此度量值对象关联的路径，则为false ;

false if there was no path associated with this measure object

pos: FloatArray! 和 tan: FloatArray! 这两个数组 , 适用于接收返回值的 , 并不是用于参数传递 ;

只有曲线找切线才有意义 , 直线的切线直接就是 ( 0, 0 ) 坐标 ;

下图中 , 蓝色是 圆形 的曲线 , 红色点 是 曲线上的点 , 则 绿色点就是获取的 tan: FloatArray 参数值 , 该点是曲线的圆心 , 与曲线上的点连接 , 垂直与切线 ;