Android 绘图(三) Path

男娘i 2022-09-25 02:26 235阅读 0赞

前面两篇文章[Android 绘图(一) Paint][Android _ Paint]  和 [Android 绘图(二) Canvas][Android _ Canvas]  ，分别介绍了有关画笔和画布， 今天来看看另外一个和绘图有关的类-Path(路径)。

先看看官方文档对Path(路径)的描述：

The Path class encapsulates compound (multiple contour) geometric paths consisting of straight line segments, quadratic curves, and cubic curves. It can be 
    drawn with canvas.drawPath(path, paint), either filled or stroked (based on the paint's Style), or it can be used for clipping or to draw text on a path.

简单翻译：Path(路径)封装了复合（多轮廓）几何图形路径由直线段、二次曲线、三次曲线组成。它能绘制通过调用canvas.drawPath(path, paint)方法，填充或者描边（基于画笔的样式），或者被用于裁剪，或者绘制文本。

Path(路径)主要用于绘制复杂的图形轮廓，比如折线，圆弧以及各种复杂图案。

一、 下面列举Path(路径)常用的Api方法。

1.public void addArc (RectF oval, float startAngle, float sweepAngle)
    参数
      oval          生成椭圆的矩形
      startAngle 	弧开始的起始角度（度）
      sweepAngle 	顺时针测量的扫描角（度）
    添加指定的弧路径作为一种新的轮廓

2.public void addArc (float left, float top, float right, float bottom, float startAngle, float sweepAngle)
    参数
     left，top（左上角坐标）right，bottom （右下角坐标）
     startAngle 	弧开始的起始角度（度）
     sweepAngle 	顺时针测量的扫描角（度）
    添加指定的弧路径作为一种新的轮廓

3.public void addCircle (float x, float y, float radius, Path.Direction dir)
    参数
     x 	添加到路径的圆的圆心X坐标
     y 	添加到路径的圆的圆心Y坐标
     radius 	添加到路径的圆的半径
     dir 	圆的生成方式
    向路径添加一个封闭的圆轮廓

**PS:   Path.Direction有两个值：  
Path.Direction.CCW：是counter-clockwise缩写，指创建逆时针方向的矩形路径；  
Path.Direction.CW：是clockwise的缩写，指创建顺时针方向的矩形路径；**

4.public void addOval (float left, float top, float right, float bottom, Path.Direction dir)
    参数
     dir 	椭圆的生成方式 
    向路径添加一个封闭的椭圆轮廓

5.public void addOval (RectF oval, Path.Direction dir)
    参数
     oval 	生成椭圆的矩形
     dir 	圆的生成方式
    向路径添加一个封闭的椭圆轮廓

6.public void addPath (Path src, float dx, float dy)
    参数
     src  添加作为一个新的轮廓的路径
     dx 	 在x轴增加的路径平移量
    将src平移dx,dy后添加到path当中

7.public void addPath (Path src, Matrix matrix)
    参数
     src 添加作为一个新的轮廓的路径
    将src通过matrix平移后添加到path当中

8.public void addRect (float left, float top, float right, float bottom, Path.Direction dir)
    参数
     left 	矩形的左边
     top 	矩形的上边
     right 	矩形的右边
     bottom 矩形的下边
     dir    矩形的生成方式 
    添加一个封闭的矩形到路径

9. public void addRoundRect (float left, float top, float right, float bottom, float rx, float ry, Path.Direction dir)
    参数
     rx 	圆角矩形的x轴半径
     ry 	圆角矩形的y轴半径
     dir 	圆角矩形的生成方式 
    添加一个封闭的圆角矩形到路径

10. public void addRoundRect (float left, float top, float right, float bottom, float[] radii, Path.Direction dir)
    参数
     radii  数组有8个值，4对[x,y]半径。
     dir    圆角矩形的生成方式 
    添加一个封闭的圆角矩形到路径。每一个圆角接受两个半径[x,y].圆角的顺序左上角，右上角，右下角，左下角。

11. public void arcTo (float left, float top, float right, float bottom, float startAngle, float sweepAngle, boolean forceMoveTo)
    参数
     startAngle 	弧开始的起始角度（度）
      sweepAngle 	顺时针方向的扫描角（度），360求模
    forceMoveTo 	如果是真的，总是用圆弧开始一个新的轮廓
    添加指定的弧路径。如果path的最后一个点和圆弧的第一个点不相同，那么就会自动先调用lineTo()将这两个点连接起来，然后再连接圆弧。当然，如果path是空的，那就会调用moveTo()把path的第一个点移到圆弧的第一个点上来。

12. public void arcTo (RectF oval, float startAngle, float sweepAngle)
    参数
     oval 	为椭圆的矩形
     startAngle 	为开始角度
     sweepAngle 	为结束角度
    同上(用于绘制弧线，实际是截取圆或椭圆的一部分)

13. public void arcTo (RectF oval, float startAngle, float sweepAngle, boolean forceMoveTo)
    参数
     oval 	     为椭圆的矩形
     startAngle  为开始角度
     sweepAngle  为结束角度，360求模
     forceMoveTo 如果是真的，总是用圆弧开始一个新的轮廓
    同上

14. public void close ()
    关闭当前轮廓。如果当前点不等于轮廓的第一点，则自动添加一个线段。

15. public void lineTo (float x, float y)
    参数
     x 	线段终点的x坐标
     y 	线段终点的y坐标
    从最后一个点添加一条线到指定的点（x，y）.如果这条轮廓没有调用 moveTo()，第一个点会自动设置为(0,0).

16. public void moveTo (float x, float y)
    参数
     x 	新轮廓起始点的x坐标
     y 	新轮廓起始点的y坐标
    设置下一个轮廓的起始点（x，y）

17. public void offset (float dx, float dy, Path dst)
    参数
     dx 	x方向的偏移量
     dy 	y方向的偏移量
     dst 	将结果写到dst中，如果dst为null，那么改变后的结果直接写在当前path中
    将path偏移dx,dy之后，将结果写到dst中，如果dst为null，那么改变后的结果直接写在当前path中

18.public boolean op (Path path1, Path path2, Path.Op op)
    参数
     path1 	第一个操作数（差，被减数）
     path2 	第二个操作数（差、减数）
    返回值 
       如果操作成功，返回True，否则返回false ,path未修改
    对两个Path对象做相应的运算组合(combine),具体的说是根据不同的op参数及path2参数来影响path1对象。

PS: Path.Op参数说明：

(1). Path.Op.DIFFERENCE 减去path1中path1与path2都存在的部分;

path1 = (path1 - path1 ∩ path2)  
(2). Path.Op.INTERSECT 保留path1与path2共同的部分;  
path1 = path1 ∩ path2  
(3). Path.Op.UNION 取path1与path2的并集;  
path1 = path1 ∪ path2  
(4). Path.Op.REVERSE\_DIFFERENCE 与DIFFERENCE刚好相反;  
path1 = path2 - (path1 ∩ path2)  
(5). Path.Op.XOR 与INTERSECT刚好相反;  
path1 = (path1 ∪ path2) - (path1 ∩ path2)

19. public void quadTo (float x1, float y1, float x2, float y2)
    参数
     x1 	控制点上的二次曲线的横坐标
     y1 	控制点上的二次曲线的纵坐标
     x2 	结束点的二次曲线的横坐标
     y2 	结束点的二次曲线的纵坐标
    添加二次贝塞尔曲线从最后一点，接近控制点（x1，y1），终点（x2，y2）。如果没有调用moveto()，第一点是自动设置为（0,0）。

20. public void transform (Matrix matrix, Path dst)
    参数
     matrix 	改变矩阵
     dst 	将结果写到dst中，如果dst为null，那么改变后的结果直接写在当前path中。
    通过matrix矩阵改变path上的点，将结果写到dst中，如果dst为null，那么改变后的结果直接写在当前path中。

21. public void setLastPoint (float dx, float dy)
    参数
     dx 	最后一个点的x坐标
     dy 	最后一个点的y坐标
    设置path的最后一个点

22. public void setFillType (Path.FillType ft)
    参数
     ft 	此路径的新填充类型
    设置路径的填充类型。这定义了如何计算“内部”。

23.public void set (Path src)
    使用src替换

24.public void rewind ()
    清空当前path，清除掉所有直线，曲线，但是保留它内部的数据结构，以便更好的重新使用

25.public void reset ()
    从路径上清除任何线条和曲线，使其为空。这不会改变填充类型设置。

ps:上面的lineTo,MoveTo,QuadTo,CubicTo方法都有与之对应的rXXX方法：  
rLineTo(float dx, float dy)  
rMoveTo(float dx, float dy)  
rQuadTo(float dx1, float dy1, float dx2, float dy2)  
rCubicTo(float x1, float y1, float x2, float y2, float x3, float y3)  
这些方法与之对应的原方法相比，惟一的区别在于：r方法是基于当前绘制开始点的offest,比如当前paint位于 (100,100)处，  
则使用rLineTo(100,100)方法绘制出来的直线是从(100,100)到(200,200)的一条直接，由此可见rXXX方法方便用来基于之前的绘制作连续绘制。

27. public boolean isRect (RectF rect)
    参数
    rect 	如果不为空，则返回路径的界限，如果它指定一个矩形
    返回值
           如果路径指定一个矩形，则是真的 
    如果path指定了一个矩形，那么返回true，并且rect将会存储path的边界值，如果没有指定一个矩形，返回false，并且忽略掉rect。

28.public boolean isEmpty ()
    如果路径是空的（不包含行或曲线），则返回真。

29.public Path.FillType getFillType ()
    回路径的填充类型。这定义了如何计算“内部”。默认值为‘WINDING’。

30. public void computeBounds (RectF bounds, boolean exact)
    参数
     bounds 	返回路径控制点的计算界限。
     exact 	此参数已不再使用。
    计算路径的控制点的边界，并将答案写入界限。如果路径中包含0或1点，边界设置为（0,0,0,0）。

以上就是Path(路径)常用的一些方法，说了这么多，可能还是有些抽象，下面，我们通过实际的例子来演示方法。

二. 具体代码如下，

@Override
    	protected void onDraw(Canvas canvas) {
    		// TODO Auto-generated method stub
    
    		mWidth = getMeasuredWidth();// 获取宽度
    		mHalfWidth = mWidth / 2;//
    		mPaint.setColor(Color.WHITE);// 设置画笔颜色为白色
    		mPaint.setAntiAlias(true);// 坑锯齿
    		mPaint.setStyle(Style.STROKE);// 样式是描边
    		mPaint.setStrokeWidth(mStrokeWidth);// 设置画笔的宽度
    		rect = new RectF(0, 0, 400, 400);//初始化矩形
    		//先创建两个大小一样的路径  
    		//第一个逆向生成  
    		Path CCWRectpath = new Path();  
    		RectF rect1 =  new RectF(40, 40, 200, 200);  
    		CCWRectpath.addRect(rect1, Direction.CCW);  
    		//第二个顺向生成  
    		Path CWRectpath = new Path();  
    		RectF rect2 =  new RectF(240, 40, 400, 200);  
    		CWRectpath.addRect(rect2, Direction.CW);  
    		//先画出这两个路径   
    		canvas.drawPath(CCWRectpath, mPaint);  
    		canvas.drawPath(CWRectpath, mPaint);  
    		//依据路径写出文字  
    		String text="Android 绘图(三) Path";  
    		mPaint.setColor(Color.GREEN);  
    		mPaint.setTextSize(20);  
    		canvas.drawTextOnPath(text, CCWRectpath, 0, 18, mPaint);//逆时针生成  
    		canvas.drawTextOnPath(text, CWRectpath, 0, 18, mPaint);//顺时针生成  
    		//设置的下一个路径的开始点（x，y）。
    		path.moveTo(0, 300);
    		//添加了最后一点线指定点（x，y）。如果没有moveto()调用了这个轮廓，第一点是自动设定为（0,0）
    		path.lineTo(50, 260);
    		path.lineTo(100, 300);
    		canvas.drawPath(path, mPaint);
    		//绘制弧度
    		path.addArc(rect, 0f, 60f);
    		canvas.drawPath(path, mPaint);
    		//绘制圆
    		path.addCircle(100, 400, 50, Direction.CW);
    		canvas.drawPath(path, mPaint);
    		//一个椭圆
    		RectF oval=new RectF(500, 0, 600, 200);
    		path.addOval(oval, Direction.CW);
    		canvas.drawPath(path, mPaint);
    		//圆角矩形
    		RectF rect3=new RectF(400, 300, 600, 500);
    		path.addRoundRect(rect3, 40, 40, Direction.CW);
    		canvas.drawPath(path, mPaint);
    		//绘制弧线
    		RectF oval1=new RectF(0, 500, 300, 800);
    		path.arcTo(oval1, 0f, 70f, true);
    		canvas.drawPath(path, mPaint);
    		//对两个Path对象做相应的运算组合
    		Path path1=new Path();
    		RectF rect5 =  new RectF(50, 400, 300, 700);  
    		path1.addOval(rect5, Direction.CW);
    		Path path2=new Path();
    		RectF rect6 =  new RectF(70, 440, 400, 840);  
    		path2.addOval(rect6, Direction.CW);
    		path.op(path1, path2,Path.Op.UNION );
    		canvas.drawPath(path, mPaint);
    		//添加二次贝塞尔曲线
    		path.quadTo(400, 700, 500, 800);
    		canvas.drawPath(path, mPaint);
    	}

运行截图，

![Center][]  
三. 总结。  
     本篇只是简单的列举了Path(路径)类的常用方法以及简单使用，仅供参考！

[Android _ Paint]: http://blog.csdn.net/zxw136511485/article/details/51914916
[Android _ Canvas]: http://blog.csdn.net/zxw136511485/article/details/51914935
[Center]: /images/20220719/a996e180a9e94efa88923885c91c428f.png