Path常用方法
| 方法 | 作用 | 备注 |
|---|---|---|
| moveTo | 移动起点 | 移动下一次操作的起点位置 |
| lineTo | 连接直线 | 连接上一个点到当前点之间的直线 |
| setLastPoint | 设置终点 | 重置最后一个点的位置 |
| close | 闭合路劲 | 从最后一个点连接最初的一个点，形成一个闭合区域 |
| addRect | 添加矩形 | 添加矩形到当前Path |
| addRoundRect | 添加圆角矩形 | 添加圆角矩形到当前Path |
| addOval | 添加椭圆 | 添加椭圆到当前Path |
| addCircle | 添加圆 | 添加圆到当前Path |
| addPah | 添加路劲 | 添加路劲到当前Path |
| addArc | 添加圆弧 | 添加圆弧到当前Path |
| arcTo | 圆弧 | 绘制圆弧，注意和addArc的区别 |
| isEmpty | 是否为空 | 判定Path是否为空 |
| isRect | 是否为矩形 | 判定Path是否是一个矩形 |
| set | 替换路劲 | 用新的路劲替换当前路劲的所有内容 |
| offset | 偏移路劲 | 对当前的路劲进行偏移 |
| quadTo | 贝塞尔曲线 | 二次贝塞尔曲线的方法 |
| cubicTo | 贝塞尔曲线 | 三次贝塞尔曲线的方法 |
| rMoveTo,rlineTo,rQuadTo,rCubicTo | rXxx方法 | 不带r的方法是基于原点坐标系（偏移量），带r的基于当前点坐标系（偏移量） |
| op | 布尔操作 | 对两个Path进行布尔运算（交集，并集）等操作 |
| setFillType | 填充模式 | 设置Path的填充模式 |
| getFillType | 填充模式 | 获取Path的填充 |
| isInverseFillType | 是否逆填充 | 判断是否是逆填充模式 |
| toggleInverseFillType | 相反模式 | 切换相反的填充模式 |
| getFillType | 填充模式 | 获取Path的填充 |
| incReserve | 提示方法 | 提示Path还有多少个点等待加入 |
| computeBounds | 计算边界 | 计算Path的路劲 |
| reset，rewind | 重置路劲 | 清除Path中的内容（reset相当于new Path , rewind 会保留Path的数据结构） |
| transform | 矩阵操作 | 矩阵变换 |
Path方法使用详解
使用Path不仅可以绘制简单的图形（如圆形，矩形，直线等），也可以绘制复杂一些的图形（如正多边形，五角星等），还有绘制裁剪和绘制文本都会用到Path。由于方法比较多，我这里分组来讲下。
moveTo , lineTo , setLastPoint , close
先创建画笔：
paint = new Paint();
paint.setAntiAlias(true);
paint.setStyle(Paint.Style.STROKE);
paint.setStrokeWidth(10);
paint.setColor(Color.parseColor("#FF0000"));- 1
- 2
- 3
- 4
- 5
注意paint.setStyle(Paint.Style.FILL);，设置画笔为实心。一些线条将在画布上看不见。
1、lineTo
首先我们来看看lineTo,如果你直接moveTo 将看不出效果。
Path path = new Path();
path.lineTo(200,200);
path.lineTo(400,0);
canvas.drawPath(path,paint);- 1
- 2
- 3
- 4
- 5
- 6
为了方便大家好观察坐标的变化，我在屏幕上画出了网格，每块网格的宽高都是100。由于第一次之前没有过操作，所以默认点就是原点（屏幕左上角），第一次lineTo就是坐标原点到(200,200)之间的直线。第二次lineTo就是上一次结束点位置(200,200)到(400,0)点之间的直线。
2、moveTo 和setLastPoint
方法预览：
moveTo(float x, float y)
setLastPoint(float dx, float dy)- 1
- 2
- 3
这两个方法在作用上有相似之处，却是两个不同的东西，具体参考下表：
| 方法名 | 作用 | 是否影响之前的操作 | 是否影响之后的操作 |
|---|---|---|---|
| moveTo | 移动下一次操作的起点位置 | 否 | 是 |
| setLastPoint | 改变上一次操作点的位置 | 是 | 是 |
来看看下面的例子：
Path path = new Path();
path.lineTo(200, 200);
path.moveTo(300,300);
path.lineTo(400, 0);
canvas.drawPath(path, paint);- 1
- 2
- 3
- 4
- 5
- 6
- 7
效果图：
Path path = new Path();
path.lineTo(200, 200);
path.setLastPoint(300,100);
path.lineTo(400, 0);
canvas.drawPath(path, paint);- 1
- 2
- 3
- 4
- 5
- 6
- 7
效果图：
当我们绘制线条之前，调用moveTo 和 setLastPoint效果是一样的，都是对坐标原点(0,0)进行操作。setLastPoint是重置上一次操作的最后一点，在执行完第一次lineTo的时候，最后一个点就是(200,200),setLastPoint更改(200,200)为(300,100)，所以在执行的时候就是(300,100)到(400, 0)之间的连线了。
3、close
方法预览
public void close()- 1
close方法连接最后一个点和最初一个点（如果两个点不重合）形成一个闭合的图形。
path.moveTo(100,100);
path.lineTo(500,100);
path.lineTo(300,400);
path.close();
canvas.drawPath(path, paint);- 1
- 2
- 3
- 4
- 5
效果图：
上图中可以看到lineTo(500,100)直线和lineTo(300,400)直线，而close方法就是连接(300,400)，(100,100)两点，形成一个闭合的区域。
注意：close的作用的封闭路径，如果连接最后一个点和最初一个点任然无法形成闭合的区域，那么close什么也不做。
quadTo,cubicTo
二次贝塞尔曲线以及三次贝塞尔曲线。
1、quadTo
方法预览
public void quadTo(float x1, float y1, float x2, float y2)- 1
quadTo方法其中 (x1,y1) 为控制点，(x2,y2)为结束点。
path.moveTo(100,400);
path.quadTo(300, 100, 400, 400);
canvas.drawPath(path, paint);- 1
- 2
- 3
- 4
效果图：
2、cubicTo
方法预览：
public void cubicTo(float x1, float y1, float x2, float y2, float x3, float y3)- 1
cubicTo方法比quadTo方法多了一个点坐标，那么其中(x1,y1) 为控制点，(x2,y2)为控制点，(x3,y3) 为结束点。
path.moveTo(100, 400);
path.cubicTo(100, 400, 300, 100, 400, 400);
canvas.drawPath(path, paint);- 1
- 2
- 3
- 4
绘制的图形和上面的quadTo绘制的图形是一样的。我们去掉moveTo来看看运行的效果图：
如果你想了解贝塞尔曲线公式，请链接这里
addXxx和arcTo
主要是向Path中添加基本图形以及区分addArc和arcTo
1、添加基本图形
方法预览：
//圆形
addCircle(float x, float y, float radius, Path.Direction dir)
//椭圆
addOval(RectF oval, Path.Direction dir)
addOval(float left, float top, float right, float bottom, Path.Direction dir)
//矩形
addRect(RectF rect, Path.Direction dir)
addRect(float left, float top, float right, float bottom, Path.Direction dir)
//圆角矩形
addRoundRect(RectF rect, float rx, float ry, Path.Direction dir)
addRoundRect(float left, float top, float right, float bottom, float rx, float ry, Path.Direction dir)
addRoundRect(RectF rect, float[] radii, Path.Direction dir)
addRoundRect(float left, float top, float right, float bottom, float[] radii, Path.Direction dir)- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
我们仔细观察上面的方法，在最后都有一个Path.Direction，这是个什么东东呢？Direction的意思是方向，指导，趋势。点进去跟一下你会发现Direction是一个枚举类型（Enum）分别有CW（顺时针），CCW（逆时针）两个常量。那么它的作用主要有以下两点：
| 序号 | 作用 |
|---|---|
| 1 | 在添加图形时确定闭合顺序(各个点的记录顺序) |
| 2 | 对自相交图形的渲染结果有影响 |
我们先来看看闭合顺序的问题，添加一个矩形看看：
path.addRect(100, 200, 500, 400, Path.Direction.CW);
canvas.drawPath(path, paint);- 1
- 2
- 3
我将上面的代码CW改成CCW再运行一次，结果一模一样，尼玛区别在哪里啊。稍安勿躁，想看到区别就要用到setLastPoint（重置最后一个点的坐标）。我们来这样变变代码：
path.addRect(100, 200, 500, 400, Path.Direction.CW);
path.setLastPoint(200,400);
canvas.drawPath(path, paint);- 1
- 2
- 3
- 4
效果立马现行：
为什么图形会发生奇怪的变化呢。我们先来分析一下，绘制一个矩形至少需要对角线的两个点，根据这两个点计算出四条边然后把四条边按照顺序连接起来。上图的起始坐标是（100,200）按着顺时针的方向连接（500,200），（500,400），（100,400）最后连接（100,200）形成一个矩形。setLastPoint是重置上一个操作点坐标及改变（100,400）为（200,400），所以出现了上图的效果。
接下来我们看看逆时针的情况：
path.addRect(100, 200, 500, 400, Path.Direction.CCW);
path.setLastPoint(400,300);
canvas.drawPath(path, paint);- 1
- 2
- 3
- 4
效果图：
我们理清楚了闭合的问题，相交问题与设置填充模式有关。
我以addCircle方法来讲解添加图形，并不会逐一讲解。
path.addCircle(300,300,200, Path.Direction.CW);
canvas.drawPath(path, paint);- 1
- 2
- 3
绘制圆形，（300,300）点表示圆心坐标，200 表示半径长度。
2、addPath
方法预览：
public void addPath(Path src)
public void addPath(Path src, float dx, float dy)
public void addPath(Path src, Matrix matrix)- 1
- 2
- 3
addPath方法就是将两个路径合并到一起。第二个方法的dx,dy指的是偏移量，第三个方法是添加到当前path之前先使用Matrix进行变换。来看看下面例子：
Path path = new Path();
path.addRect(100,100,400,300, Path.Direction.CW);
Path src=new Path();
src.addCircle(300,300,100, Path.Direction.CW);
path.addPath(src,0,100);
canvas.drawPath(path, paint);- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
效果图：
3、addArc与arcTo
方法预览：
addArc(RectF oval, float startAngle, float sweepAngle)
addArc(float left, float top, float right, float bottom, float startAngle, float sweepAngle)
arcTo(RectF oval, float startAngle, float sweepAngle)
arcTo(RectF oval, float startAngle, float sweepAngle, boolean forceMoveTo)
arcTo(float left, float top, float right, float bottom, float startAngle, float sweepAngle, boolean forceMoveTo)- 1
- 2
- 3
- 4
- 5
- 6
从方法名字上面看，这两个方法都是与圆弧有关，那么他们之间肯定是有区别的：
| 名称 | 作用 | 区别 |
|---|---|---|
| addArc | 添加一个圆弧到Path | 直接添加一个圆弧到path中，和上一次操作点无关 |
| arcTo | 添加一个圆弧到Path | 添加一个圆弧到path中，如果圆弧的起点和上次操作点坐标不同就连接两个点 |
startAngle表示开始圆弧度数（0度与X轴方向对齐，顺时针移动，弧度增大）。
注意：sweepAngle表示运动了多少弧度，并不是结束弧度。
forceMoveTo表示“是否强制使用moveTo”，也就是说是否使用moveTo将上一次操作点移动到圆弧的起点坐标。默认是false。
| forceMoveTo | 含义 |
|---|---|
| true | 将最后一个点移动到圆弧起点，即不连接最后一个点与圆弧起点 |
| false | 不移动，而是连接最后一个点与圆弧起点(注意之前没有操作的话，不会连接原点) |
示例：
path.lineTo(200, 200);
RectF rectF = new RectF(100, 100, 400, 400);
path.arcTo(rectF, 0, 270, true);
// path.addArc(rectF,0,270);和上面一句等价
canvas.drawPath(path, paint);- 1
- 2
- 3
- 4
- 5
- 6
效果图：
我们把 path.arcTo(rectF, 0, 270, true);改成 path.arcTo(rectF, 0, 270, false);，来看看效果图：
从上面两张图可以看出明显的变化。
isEmpty、 isRect、 set 和 offset
isEmpty
判断path中是否包含内容。
Path path = new Path();
Log.e("-----","----"+path.isEmpty());//-----: ----true
path.lineTo(100,100);
Log.e("-----","----"+path.isEmpty());//-----: ----false
canvas.drawPath(path, paint);- 1
- 2
- 3
- 4
- 5
- 6
isRect
方法预览：
isRect(RectF rect)- 1
判断path是否是一个矩形，如果是一个矩形的话，会将矩形的信息存放进参数rect中。
Path path = new Path();
RectF rectF = new RectF();
rectF.left = 100;
rectF.top = 100;
rectF.right = 400;
rectF.bottom = 300;
path.addRect(rectF, Path.Direction.CW);
boolean isRect = path.isRect(rectF);
Log.e("-----","------"+isRect);//-----: ------true- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
set
方法预览：
public void set(Path src)- 1
将新的path赋值到现有path。相当于运算符中的“=”，如a=b,把b赋值给a
还是一起来看个例子：
Path path = new Path();
path.addRect(100,100,400,300, Path.Direction.CW);
Path src=new Path();
src.addCircle(300,200,100, Path.Direction.CW);
path.set(src);
canvas.drawPath(path, paint);- 1
- 2
- 3
- 4
- 5
- 6
效果图：
offset
方法预览：
public void offset(float dx, float dy)
public void offset(float dx, float dy, Path dst)- 1
- 2
这个方法就是对Path进行一段平移，正方向和X轴，Y轴方向一致（如果dx为正数则向右平移，反之向左平移；如果dy为正则向下平移，反之向上平移）。我们看到第二个方法多了一个dst，这个又是一个什么玩意呢，其实参数das是存储平移后的path的。
用例子来说明一下：
Path path = new Path();
path.addCircle(300, 200, 100, Path.Direction.CW);
Path dst = new Path();
dst.addCircle(500, 200, 200, Path.Direction.CW);
path.offset(-100, 100, dst);
canvas.drawPath(path, paint);- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
效果图：
从运行效果图可以看出，虽然我们在dst中添加了一个圆形，但是并没有表现出来，所以，当dst中存在内容时，dst中原有的内容会被清空，而存放平移后的path。
FillType
方法预览：
public void setFillType(Path.FillType ft)
public Path.FillType getFillType()- 1
- 2
setFillType方法中的参数Path.FillType为枚举类型：
| FillType值 | 含义 |
|---|---|
| FillType.WINDING | 取path所有所在区域 默认值 |
| FillType.EVEN_ODD | 取path所在并不相交区域 |
| FillType.INVERSE_WINDING | 取path所有未占区域 |
| FillType.INVERSE_EVEN_ODD | 取path未占或相交区域 |
path所在区域
path所在区域
path所在区域
setFillType
WINDING
Path path = new Path();
path.addCircle(300,200,100, Path.Direction.CW);
path.addCircle(200,200,100, Path.Direction.CW);
path.setFillType(Path.FillType.WINDING);
canvas.drawPath(path, paint);- 1
- 2
- 3
- 4
- 5
效果图：
EVEN_ODD
代码我就不贴了，直接上图（上mis）：
INVERSE_WINDING
INVERSE_EVEN_ODD
isInverseFillType
是否是逆填充模式：WINDING 和 EVEN_ODD 返回false；
INVERSE_WINDING 和 INVERSE_EVEN_ODD 返回true；
toggleInverseFillType
切换相反的填充模式，如果填充模式为WINDING则填充模式为INVERSE_WINDING，反之为WINDING模式；如果填充模式为EVEN_ODD则填充模式为INVERSE_EVEN_ODD，反之为EVEN_ODD模式。
举个例子：
Path path = new Path();
path.addCircle(300,200,100, Path.Direction.CW);
path.addCircle(200,200,100, Path.Direction.CW);
path.setFillType(Path.FillType.INVERSE_EVEN_ODD);
path.toggleInverseFillType();
canvas.drawPath(path, paint);- 1
- 2
- 3
- 4
- 5
- 6
效果图和上面EVEN_ODD模式一模一样。
就写到这里，文中有什么写错，写偏的请给我留言。
package comg.xtc.mytestapplication;
/**
* Created by liaozeyu on 2018/5/16.
*/
import android.content.Context;
import android.graphics.Canvas;
import android.graphics.Color;
import android.graphics.LinearGradient;
import android.graphics.Paint;
import android.graphics.Path;
import android.graphics.Rect;
import android.graphics.RectF;
import android.graphics.Shader;
import android.util.AttributeSet;
import android.view.View;
public class MyView extends View{
private Paint paint;
public MyView(Context context, AttributeSet attrs) {
super(context, attrs);
}
@Override
protected void onDraw(Canvas canvas) {
super.onDraw(canvas);
//把整张画布绘制成白色
canvas.drawColor(Color.WHITE);
Paint paint = new Paint();
//去锯齿
paint.setAntiAlias(true);
paint.setColor(Color.BLUE);
paint.setStyle(Paint.Style.STROKE);
paint.setStrokeWidth(6);
//edit by lzy demo 1
Path paint1 = new Path();
paint1.moveTo(200, 200);
paint1.quadTo(200,100,300,100);
paint1.lineTo(600,100);
paint1.moveTo(700,100);
paint1.lineTo(900,100);
paint1.quadTo(1000,100,1000,200);
paint1.lineTo(1000,500);
paint1.quadTo(1000,600,900,600);
paint1.lineTo(700,600);
paint1.moveTo(600,600);
paint1.lineTo(300,600);
paint1.quadTo(200,600,200,500);
paint1.lineTo(200,400);
paint1.moveTo(200,300);
paint1.lineTo(200,200);
//paint1.close();
canvas.drawPath(paint1, paint);
/*
//绘制圆形
canvas.drawCircle(40, 40, 30, paint);
//绘制正方形
canvas.drawRect(10, 80, 70, 140, paint);
//绘制矩形
canvas.drawRect(10, 150, 70, 190, paint);
RectF rel = new RectF(10,240,70,270);
//绘制椭圆
canvas.drawOval(rel, paint);
//定义一个Path对象，封闭一个三角形
Path path1 = new Path();
path1.moveTo(10, 340);
path1.lineTo(70, 340);
path1.lineTo(40, 290);
path1.close();
//根据Path进行绘制，绘制三角形
canvas.drawPath(path1, paint);
//定义一个Path对象，封闭一个五角星
Path path2 = new Path();
path2.moveTo(27, 360);
path2.lineTo(54, 360);
path2.lineTo(70, 392);
path2.lineTo(40, 420);
path2.lineTo(10, 392);
path2.close();
//根据Path进行绘制，绘制五角星
canvas.drawPath(path2, paint);
//设置填丛风格后进行绘制
paint.setStyle(Paint.Style.FILL);
paint.setColor(Color.RED);
canvas.drawCircle(120, 40, 30, paint);
//绘制正方形
canvas.drawRect(90, 80, 150, 140, paint);
//绘制矩形
canvas.drawRect(90, 150, 150, 190, paint);
//绘制圆角矩形
RectF re2 = new RectF(90,200,150,230);
canvas.drawRoundRect(re2, 15, 15, paint);
//绘制椭圆
RectF re21 = new RectF(90, 240, 150, 270);
canvas.drawOval(re21, paint);
Path path3 = new Path();
path3.moveTo(90, 340);
path3.lineTo(150, 340);
path3.lineTo(120, 290);
path3.close();
//绘制三角形
canvas.drawPath(path3,paint);
//绘制五角形
Path path4 = new Path();
path4.moveTo(106, 360);
path4.lineTo(134, 360);
path4.lineTo(150, 392);
path4.lineTo(120, 420);
path4.lineTo(90, 392);
path4.close();
canvas.drawPath(path4, paint);
//设置渐变器后绘制
//为Paint设置渐变器
Shader mShasder = new LinearGradient(0, 0, 40, 60, new int[]{Color.RED,Color.GREEN,Color.BLUE,Color.YELLOW}, null, Shader.TileMode.REPEAT);
paint.setShader(mShasder);
//设置阴影
paint.setShadowLayer(45, 10, 10, Color.GRAY);
//绘制圆形
canvas.drawCircle(200, 40, 30, paint);
//绘制正方形
canvas.drawRect(170, 80, 230, 140, paint);
//绘制矩形
canvas.drawRect(170, 150, 230, 190, paint);
//绘制圆角的矩形
RectF re31 = new RectF();
canvas.drawRoundRect(re31, 15, 15, paint);
//绘制椭圆
RectF re32 =new RectF();
canvas.drawOval(re32, paint);
//根据Path,绘制三角形
Path path5 = new Path();
path5.moveTo(170, 340);
path5.lineTo(230, 340);
path5.lineTo(200, 290);
path5.close();
canvas.drawPath(path5, paint);
//根据PAth,进行绘制五角形
Path path6 = new Path();
path6.moveTo(186, 360);
path6.lineTo(214, 360);
path6.lineTo(230, 392);
path6.lineTo(200, 420);
path6.lineTo(170, 392);
path6.close();
canvas.drawPath(path6, paint);*/
}
}