2312skia,17路径和api概述

SkPath概述

路径包含可描边或填充的线条和曲线.轮廓由一系列相连的直线和曲线组成.路径可包含零个,多个等值线.每条直线和曲线都由动词,点和可选Path_Conic_Weight描述.

每对连接的直线和曲线共享公共点;如,包含两条连接线的路径按Path_Verb序列描述:SkPath::kMove_Verb,SkPath::kLine_Verb,SkPath::kLine_Verb;
带三个项的Point序列,按第一行的结束和第二行的开始共享中间项.
路径组件"弧","矩形","圆角矩","圆"和"椭圆"由带精确描述期望的多个动词和点的直线和曲线组成.添加到Path后,这些组件可能会失去其标识;
但可检查Path以确定它是否描述了单个Rect,Oval,Round_Rect等.
例:
路径包含三个轮廓:直线,圆形和四边形.描边但未填充线条.描边和填充圆圈;描边圆形成一个圈.描边和填充Quad,但因为它没有闭合,因此Quad不会描边圈.
“路径”(Path)包含一个来确定重叠轮廓是形成填充还是孔洞的Path_Fill_Type,还可确定是填充"直线和曲线"内部还是外部的区域.

例
先绘画填充路径,然后描边,然后描边和填充.
从不共享路径内容.按值复制路径可有效创建一个独立于原始路径的新路径.内部,在编辑之前不会复制副本内容,以减少内存使用并提高性能.

轮廓包含多个动词,及满足Path_Verb_Array期望的多个点.路径中的第一个Path_Verb总是是SkPath::kMove_Verb;,接着的每个SkPath::kMove_Verb都会启动新的轮廓.

例
每个SkPath::moveTo都会启动一个新的轮廓,SkPath::close()之后的内容也会启动一个新的轮廓.因为SkPath::conicTo前面没有SkPath::moveTo,因此第三个轮廓的第一个点从第二个轮廓的最后点开始.

如果轮廓中的最终Path_Verb是SkPath::kClose_Verb,则Line连接轮廓中的Path_Last_Point与第一个点起来.
在Path_Last_Point点和第一个点画Paint_Stroke_Join描边闭合轮廓.如果没有SkPath::kClose_Verb作为最终动词,则不会连接Path_Last_Point和第一个点.
轮廓保持打开.在Path_Last_Point点和第一个点画Paint_Stroke_Cap来描边开放轮廓.

例
用开和闭轮廓描边绘画的路径.
等值线长度是从第一个点到Path_Last_Point点的行进距离,如果闭合等值线,则为从Path_Last_Point点到第一个点的距离.

即使等值线长度为零,如果描边线条可见,也会绘画Paint_Stroke_Cap描边线条.

接口索引

一些关键类是:
1,SkAutoCanvasRestore,Canvas保存栈管理器
2,SkBitmap:二维光栅像素数组
3,SkBlendMode:像素颜色算术
4,SkCanvas:绘图环境
5,SkColor:用整数编码的颜色
6,SkFont:文本风格和字体
7,SkImage:要绘画的二维像素数组
8,SkImageInfo:像素尺寸和特征
9,SkIPoint:两个整数坐标
10,SkIRect:整数矩形
11,SkMatrix:3x3变换矩阵
12,SkPaint:颜色,描边,字体,效果
13,SkPath:连接直线和曲线的序列
14,SkPicture:绘图命令序列
15,SkPixmap:像素映射,图像信息和像素地址
16,SkPoint:两个浮点坐标
17,SkRRect:浮点圆角矩形
18,SkRect:浮点矩形
19,SkRegion:压缩剪切掩码
20,SkSurface:绘图目的地
21,SkTextBlob:运行符号
22,SkTextBlobBuilder:字形块的构造器

概述

Skia围绕SkCanvas对象组织.它是调用"draw"的主机:drawRect,drawPath,drawText等.其中每个都有两个组件:正在绘画的原语(SkRect,SkPath等)和颜色/风格属性(SkPaint).

canvas:>drawRect(rect, paint);

画笔保留了(本例中)描述如何绘画矩形的大部分状态:颜色,填充或描边,如何与以前绘画内容混合.
画布保存的状态相对较少.它指向正在绘画的实际像素,并维护一堆矩阵和剪切.
因此,上面调用中,画布的当前矩阵可转换矩形的坐标(平移,旋转,倾斜,透视),画布的当前剪切可能会限制矩形在画布上的绘画位置,但绘图的所有其他风格属性都由画布控制.