上篇文章我们罗列了一个些Paint的API，本章我们来看一个下Canvas相关的API
canvas画布的意思，所有的绘制都是他提供的方法。这些方法可以分为图形的绘制、画布状态的操作。接下来我们就这两个类型的API分析一下
一、 图形的绘制
1. drawRect 绘制矩形
//Rect中的参数是float类型的，封装了left、top、right、bottom
void drawRect(@NonNull RectF rect, @NonNull Paint paint)
//Rect中的参数是int类型的，封装了left、top、right、bottom
void drawRect(@NonNull Rect r, @NonNull Paint paint)
//直接指定四个边到X、Y轴的距离
void drawRect(float left, float top, float right, float bottom, @NonNull Paint paint)
2. drawArc 绘制一个圆弧
//RectF定义一个矩形范围，长宽的一半是长轴短轴的大小，中心点是圆弧的中心
//startAngle 开始角度，x轴为0，顺时针度数增加
//sweepAngle 扫过的角度，顺时针
//userCenter true使用圆弧的圆心，false不使用
void drawArc(@NonNull RectF oval, float startAngle, float sweepAngle, boolean useCenter,
@NonNull Paint paint)
//前四个参数指定了矩形
void drawArc(float left, float top, float right, float bottom, float startAngle,
float sweepAngle, boolean useCenter, @NonNull Paint paint)
userCenter 为true时
canvas.drawArc(new RectF(100f,100f,1000f,1000f),90f,90f,true,paint);
image.png
userCenter 为false时
canvas.drawArc(new RectF(100f,100f,1000f,1000f),90f,90f,false,paint);
image.png
3.drawCircle 绘制圆形
//cx，cy指定了圆心
//radius 指定半径
void drawCircle(float cx, float cy, float radius, @NonNull Paint paint)
4.drawOval 绘制椭圆（使用圆弧也能绘制一个椭圆）
//绘制一个矩形范围内的椭圆
void drawOval(@NonNull RectF oval, @NonNull Paint paint)
//前四个参数定义了一个椭圆
void drawOval(float left, float top, float right, float bottom, @NonNull Paint paint)
5.drawRoundRect 绘制一个圆角矩形
//rx,ry为圆角的圆心
void drawRoundRect(@NonNull RectF rect, float rx, float ry, @NonNull Paint paint)
void drawRoundRect(float left, float top, float right, float bottom, float rx, float ry,
@NonNull Paint paint)
6.drawBitmap 绘制位图
//在指定位置绘制位图
void drawBitmap(@NonNull Bitmap bitmap, float left, float top, @Nullable Paint paint)
//src 表示要截取位图的部分
//dst 要绘制目标的大小，自动缩放
void drawBitmap(@NonNull Bitmap bitmap, @Nullable Rect src, @NonNull Rect dst,@Nullable Paint paint)
void drawBitmap(@NonNull Bitmap bitmap, @Nullable Rect src, @NonNull RectF dst,@Nullable Paint paint)
//通过位图的矩阵来绘制
void drawBitmap(@NonNull Bitmap bitmap, @NonNull Matrix matrix, @Nullable Paint paint)
7.drawPoint 绘制点
void drawPoint(float x, float y, @NonNull Paint paint)
8.drawPoints绘制一组点
//pts 点x、y的坐标数组
void drawPoints(@Size(multiple = 2) @NonNull float[] pts, @NonNull Paint paint)
//pts 点的x、y的坐标数组
//offset 开始时先跳过offset个数据
//count 取offset后的多少个数据，因为点的坐标是x、y所以count > 1
void drawPoints(@Size(multiple = 2) float[] pts, int offset, int count,@NonNull Paint paint)
9.drawLine 绘制一条直线
//设置开始和结束点
void drawLine(float startX, float startY, float stopX, float stopY, @NonNull Paint paint)
10.drawLines 绘制一系列的线
//pts 定义一系列的开始、结束点，因为每四个点指定一条直线所以pts的个数是4的倍数
void drawLines(@Size(multiple = 4) @NonNull float[] pts, @NonNull Paint paint)
//offset 绘制钱跳过的个数
//count offset后要取的数据，count>4
void drawLines(@Size(multiple = 4) @NonNull float[] pts, int offset, int count,
@NonNull Paint paint)
11.drawText 绘制文本
//以text的左下角为开始点，绘制在x、y开始的位置
void drawText(@NonNull String text, float x, float y, @NonNull Paint paint)
//对text进行截取绘制
void drawText(@NonNull String text, int start, int end, float x, float y,
@NonNull Paint paint)
//对字符数据截取绘制
void drawText(@NonNull char[] text, int index, int count, float x, float y,
@NonNull Paint paint)
//对text截取绘制
void drawText(@NonNull CharSequence text, int start, int end, float x, float y,
@NonNull Paint paint)
12.drawTextOnPath 沿指定的路径绘制文本
//text 要绘制的文本信息
//path 路径
//hOffset 横向的偏移量 ，以当前位置的path为坐标系。x的方向的偏移量，负值的话会隐藏前面的文本
//vOffset 纵向的偏移量，负值向上移动，正直向下移动
void drawTextOnPath(@NonNull String text, @NonNull Path path, float hOffset,
float vOffset, @NonNull Paint paint)
void drawTextOnPath(@NonNull char[] text, int index, int count, @NonNull Path path,
float hOffset, float vOffset, @NonNull Paint paint)
13.drawPath 绘制一条路径
void drawPath(@NonNull Path path, @NonNull Paint paint)
二、画布状态的操作（以下API都是针对canvas的操作，这些操作会影响后面的绘制）
1.translate 平移
void translate(float dx, float dy)
image.png
canvas.drawRect(100,100,500,500,paint);
canvas.translate(100,100);
paint.setColor(Color.RED);
canvas.drawRect(100,100,500,500,paint);
通过上面的代码我们先绘制了一个灰色的矩形在平移操作后又绘制了一个红色的矩形，通过上面的图片可以发现平移操作是针对画布的操作，对之前的绘制没有影响只会影响到后续的绘制
2.scale 缩放
//sx sy xy的缩放比例
void scale(float sx, float sy)
//sx sy xy的缩放比例
//px py xy的偏移量，该偏移量受缩放的影响。先缩放后平移
void scale(float sx, float sy, float px, float py)
image.png
canvas.drawRect(100,100,500,500,paint);
canvas.scale(0.5f,0.5f);
paint.setColor(Color.RED);
//整个画布x y方向均缩小了0.5,所以下面的绘制的图形和缩放前绘制的位置和大小都是之前的0.5倍
canvas.drawRect(100,100,500,500,paint);
image.png
先缩放后平移，平移量受缩放量的影响
canvas.drawRect(100,100,500,500,paint);
canvas.scale(0.5f,0.5f,100,100);
paint.setColor(Color.RED);
canvas.drawRect(100,100,500,500,paint);
3.rotate 旋转
//以圆心为圆点进行旋转
void rotate(float degrees)
//以px，py为圆心旋转
void rotate(float degrees, float px, float py)
4.skew 倾斜
//sx sy为倾斜角度的tan值
skew(float sx, float sy)
5.clipXxx 裁剪成指定的样式的画布
boolean clipRect(@NonNull RectF rect)
boolean clipPath(@NonNull Path path)
6.clipOutXxx 裁剪出指定样式的画布，裁剪以外的部分生效。
boolean clipOutRect(@NonNull RectF rect)
boolean clipOutPath(@NonNull Path path)
7.setMatrix 使用矩阵进行平移、缩放、旋转、倾斜等操作。
void setMatrix(@Nullable Matrix matrix)
8.save 保存当前图层
int save()
9.saveLayer 裁剪指定的图层
int saveLayer(@Nullable RectF bounds, @Nullable Paint paint)
10.restore 恢复至上一图层的状态
void restore()
11.restoreToCount 恢复至指定的图层
void restoreToCount(int saveCount)
图层是以栈的形式保存的，每保存一个图层就会将该图层压入栈中，恢复一次就出栈一次。
