diff --git a/AudioVideo/README.md b/AudioVideo/README.md new file mode 100644 index 00000000..de09b5cb --- /dev/null +++ b/AudioVideo/README.md @@ -0,0 +1,4 @@ +# Audio/Video 杂记 + +- [通用视频解码播放流程](通用视频解码播放流程.md) + diff --git a/AudioVideo/SDL.md b/AudioVideo/SDL.md new file mode 100644 index 00000000..02b79fb9 --- /dev/null +++ b/AudioVideo/SDL.md @@ -0,0 +1,73 @@ +--- +typora-copy-images-to: ./image +--- + +## SDL + +### 简介 + +SDL（Simple DirectMedia Layer）库的作用就是封装了复杂的音视频底层交互工作，简化了音视频处理的难度。 + +**特点：** 开源、跨平台。 + +### 结构 + +![SDL结构](image/SDL结构.png) + +它是对底层进行了封装，最终还是调用的平台底层接口与硬件进行交互。 + +### SDL 流程 + +![SDL流程](image/SDL流程.jpg) + +### SDL 主要函数 + +| 函数 | 简介 | +| -------------------- | -------------------------- | +| SDL_Init() | 初始化 SDL 系统。 | +| SDL_CreateWindow() | 创建窗口 SDL_Window。 | +| SDL_CreateRenderer() | 创建渲染器 SDL_Renderer。 | +| SDL_CreateTexture() | 创建纹理 SDL_Texture。 | +| SDL_UpdateTexture() | 设置纹理数据。 | +| SDL_RenderCopy() | 将纹理的数据拷贝给渲染器。 | +| SDL_RenderPresent() | 显示。 | +| SDL_Delay() | 工具函数，用于延时。 | +| SDL_Quit() | 退出 SDL 系统。 | + +### SDL 数据结构 + +![SDL数据结构](image/SDL数据结构.jpg) + +**数据结构简介：** + +| 结构 | 简介 | +| ------------ | -------------------- | +| SDL_Window | 代表一个“窗口”。 | +| SDL_Renderer | 代表一个“渲染器”。 | +| SDL_Texture | 代表一个“纹理”。 | +| SDL_Rect | 一个简单的矩形结构。 | + +### SDL 事件和多线程 + +#### **SDL 多线程** + +| 函数 | 简介 | +| ------------------ | -------------- | +| SDL_CreateThread() | 创建一个线程。 | +| SDL_Thread() | 线程的句柄。 | + +#### **SDL 事件** + +**函数：** + +| 函数 | 简介 | +| --------------- | -------------- | +| SDL_WaitEvent() | 等待一个事件。 | +| SDL_PushEvent() | 发送一个事件。 | + +**数据结构：** + +| 结构 | 简介 | +| ----------- | -------------- | +| SDL_Event() | 代表一个事件。 | + diff --git "a/AudioVideo/image/SDL\346\225\260\346\215\256\347\273\223\346\236\204.jpg" "b/AudioVideo/image/SDL\346\225\260\346\215\256\347\273\223\346\236\204.jpg" new file mode 100755 index 00000000..0fa937b7 Binary files /dev/null and "b/AudioVideo/image/SDL\346\225\260\346\215\256\347\273\223\346\236\204.jpg" differ diff --git "a/AudioVideo/image/SDL\346\265\201\347\250\213.jpg" "b/AudioVideo/image/SDL\346\265\201\347\250\213.jpg" new file mode 100755 index 00000000..18105033 Binary files /dev/null and "b/AudioVideo/image/SDL\346\265\201\347\250\213.jpg" differ diff --git "a/AudioVideo/image/SDL\347\273\223\346\236\204.png" "b/AudioVideo/image/SDL\347\273\223\346\236\204.png" new file mode 100644 index 00000000..9d150d37 Binary files /dev/null and "b/AudioVideo/image/SDL\347\273\223\346\236\204.png" differ diff --git "a/AudioVideo/image/\350\247\206\351\242\221\350\247\243\347\240\201\346\222\255\346\224\276\346\265\201\347\250\213.gliffy" "b/AudioVideo/image/\350\247\206\351\242\221\350\247\243\347\240\201\346\222\255\346\224\276\346\265\201\347\250\213.gliffy" new file mode 100644 index 00000000..f4a83d31 --- /dev/null +++ "b/AudioVideo/image/\350\247\206\351\242\221\350\247\243\347\240\201\346\222\255\346\224\276\346\265\201\347\250\213.gliffy" @@ -0,0 +1 @@ +{"contentType":"application/gliffy+json","version":"1.1","metadata":{"title":"untitled","revision":0,"exportBorder":false},"embeddedResources":{"index":0,"resources":[]},"stage":{"objects":[{"x":20,"y":580,"rotation":0,"id":3,"uid":"com.gliffy.shape.network.network_v3.home.speakers","width":74,"height":100,"lockAspectRatio":true,"lockShape":false,"order":36,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.speakers_3d.network_v3","strokeWidth":2,"strokeColor":"#000000","fillColor":"#003366","gradient":false,"dropShadow":false,"state":0,"shadowX":0,"shadowY":0,"opacity":1}},"children":[{"x":2,"y":0,"rotation":0,"id":69,"uid":null,"width":75,"height":14,"lockAspectRatio":false,"lockShape":false,"order":"auto","graphic":{"type":"Text","Text":{"tid":null,"valign":"middle","overflow":"both","vposition":"below","hposition":"none","html":"

音频驱动/设备

","paddingLeft":2,"paddingRight":2,"paddingBottom":2,"paddingTop":2}},"children":null}],"linkMap":[]},{"x":264,"y":580,"rotation":0,"id":9,"uid":"com.gliffy.shape.network.network_v3.home.tv_flatscreen","width":76,"height":100,"lockAspectRatio":true,"lockShape":false,"order":35,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.tv_flatscreen_3d.network_v3","strokeWidth":2,"strokeColor":"#000000","fillColor":"#003366","gradient":false,"dropShadow":false,"state":0,"shadowX":0,"shadowY":0,"opacity":1}},"children":[{"x":2,"y":0,"rotation":0,"id":70,"uid":null,"width":75,"height":14,"lockAspectRatio":false,"lockShape":false,"order":"auto","graphic":{"type":"Text","Text":{"tid":null,"valign":"middle","overflow":"both","vposition":"below","hposition":"none","html":"

视频驱动/设备

","paddingLeft":2,"paddingRight":2,"paddingBottom":2,"paddingTop":2}},"children":null}],"linkMap":[]},{"x":245,"y":580,"rotation":0,"id":60,"uid":"com.gliffy.shape.basic.basic_v1.default.line","width":100,"height":100,"lockAspectRatio":false,"lockShape":false,"order":34,"graphic":{"type":"Line","Line":{"strokeWidth":2,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":2,"startArrowRotation":"auto","endArrowRotation":"auto","ortho":true,"interpolationType":"linear","cornerRadius":null,"controlPath":[[-65,0],[-65,50],[57,50]],"lockSegments":{}}},"children":null,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":45,"px":0.5,"py":1}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":9,"px":0.5,"py":0.5}}},"linkMap":[]},{"x":114,"y":584,"rotation":0,"id":59,"uid":"com.gliffy.shape.basic.basic_v1.default.line","width":100,"height":100,"lockAspectRatio":false,"lockShape":false,"order":33,"graphic":{"type":"Line","Line":{"strokeWidth":2,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":2,"startArrowRotation":"auto","endArrowRotation":"auto","ortho":true,"interpolationType":"linear","cornerRadius":null,"controlPath":[[66,-4],[66,46],[-57,46]],"lockSegments":{}}},"children":null,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":45,"px":0.5,"py":1}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":3,"px":0.5,"py":0.5}}},"linkMap":[]},{"x":270,"y":502,"rotation":0,"id":58,"uid":"com.gliffy.shape.basic.basic_v1.default.line","width":100,"height":100,"lockAspectRatio":false,"lockShape":false,"order":32,"graphic":{"type":"Line","Line":{"strokeWidth":2,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":2,"startArrowRotation":"auto","endArrowRotation":"auto","ortho":true,"interpolationType":"linear","cornerRadius":null,"controlPath":[[10,-2],[10,18],[-90,18],[-90,38]],"lockSegments":{}}},"children":null,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":40,"px":0.5,"py":1}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":45,"px":0.5,"py":0}}},"linkMap":[]},{"x":92,"y":497,"rotation":0,"id":56,"uid":"com.gliffy.shape.basic.basic_v1.default.line","width":100,"height":100,"lockAspectRatio":false,"lockShape":false,"order":31,"graphic":{"type":"Line","Line":{"strokeWidth":2,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":2,"startArrowRotation":"auto","endArrowRotation":"auto","ortho":true,"interpolationType":"linear","cornerRadius":null,"controlPath":[[-12,3],[-12,23],[88,23],[88,43]],"lockSegments":{}}},"children":null,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":38,"px":0.5,"py":1}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":45,"px":0.5,"py":0}}},"linkMap":[]},{"x":267,"y":433,"rotation":0,"id":54,"uid":"com.gliffy.shape.basic.basic_v1.default.line","width":100,"height":100,"lockAspectRatio":false,"lockShape":false,"order":30,"graphic":{"type":"Line","Line":{"strokeWidth":2,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":2,"startArrowRotation":"auto","endArrowRotation":"auto","ortho":true,"interpolationType":"linear","cornerRadius":10,"controlPath":[[13,-3],[13,7],[13,17],[13,27]],"lockSegments":{}}},"children":null,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":36,"px":0.5,"py":1}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":40,"px":0.5,"py":0}}},"linkMap":[]},{"x":87,"y":431,"rotation":0,"id":53,"uid":"com.gliffy.shape.basic.basic_v1.default.line","width":100,"height":100,"lockAspectRatio":false,"lockShape":false,"order":29,"graphic":{"type":"Line","Line":{"strokeWidth":2,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":2,"startArrowRotation":"auto","endArrowRotation":"auto","ortho":true,"interpolationType":"linear","cornerRadius":10,"controlPath":[[-7,-1],[-7,9],[-7,19],[-7,29]],"lockSegments":{}}},"children":null,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":34,"px":0.5,"py":1}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":38,"px":0.5,"py":0}}},"linkMap":[]},{"x":271,"y":362,"rotation":0,"id":52,"uid":"com.gliffy.shape.basic.basic_v1.default.line","width":100,"height":100,"lockAspectRatio":false,"lockShape":false,"order":28,"graphic":{"type":"Line","Line":{"strokeWidth":2,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":2,"startArrowRotation":"auto","endArrowRotation":"auto","ortho":true,"interpolationType":"linear","cornerRadius":10,"controlPath":[[9,-2],[9,8],[9,18],[9,28]],"lockSegments":{}}},"children":null,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":32,"px":0.5,"py":1}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":36,"px":0.5,"py":0}}},"linkMap":[]},{"x":92,"y":356,"rotation":0,"id":51,"uid":"com.gliffy.shape.basic.basic_v1.default.line","width":100,"height":100,"lockAspectRatio":false,"lockShape":false,"order":27,"graphic":{"type":"Line","Line":{"strokeWidth":2,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":2,"startArrowRotation":"auto","endArrowRotation":"auto","ortho":true,"interpolationType":"linear","cornerRadius":10,"controlPath":[[-12,4],[-12,14],[-12,24],[-12,34]],"lockSegments":{}}},"children":null,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":29,"px":0.5,"py":1}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":34,"px":0.5,"py":0}}},"linkMap":[]},{"x":243,"y":271,"rotation":0,"id":50,"uid":"com.gliffy.shape.basic.basic_v1.default.line","width":100,"height":100,"lockAspectRatio":false,"lockShape":false,"order":26,"graphic":{"type":"Line","Line":{"strokeWidth":2,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":2,"startArrowRotation":"auto","endArrowRotation":"auto","ortho":true,"interpolationType":"linear","cornerRadius":null,"controlPath":[[-63,-1],[-63,24],[37,24],[37,49]],"lockSegments":{}}},"children":null,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":27,"px":0.5,"py":1}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":32,"px":0.5,"py":0}}},"linkMap":[]},{"x":106,"y":268,"rotation":0,"id":49,"uid":"com.gliffy.shape.basic.basic_v1.default.line","width":100,"height":100,"lockAspectRatio":false,"lockShape":false,"order":25,"graphic":{"type":"Line","Line":{"strokeWidth":2,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":2,"startArrowRotation":"auto","endArrowRotation":"auto","ortho":true,"interpolationType":"linear","cornerRadius":null,"controlPath":[[74,2],[74,27],[-26,27],[-26,52]],"lockSegments":{}}},"children":null,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":27,"px":0.5,"py":1}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":29,"px":0.5,"py":0}}},"linkMap":[]},{"x":181,"y":201,"rotation":0,"id":48,"uid":"com.gliffy.shape.basic.basic_v1.default.line","width":100,"height":100,"lockAspectRatio":false,"lockShape":false,"order":24,"graphic":{"type":"Line","Line":{"strokeWidth":2,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":2,"startArrowRotation":"auto","endArrowRotation":"auto","ortho":true,"interpolationType":"linear","cornerRadius":10,"controlPath":[[-1,-1],[-1,9],[-1,19],[-1,29]],"lockSegments":{}}},"children":null,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":25,"px":0.5,"py":1}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":27,"px":0.5,"py":0}}},"linkMap":[]},{"x":179,"y":134,"rotation":0,"id":47,"uid":"com.gliffy.shape.basic.basic_v1.default.line","width":100,"height":100,"lockAspectRatio":false,"lockShape":false,"order":23,"graphic":{"type":"Line","Line":{"strokeWidth":2,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":2,"startArrowRotation":"auto","endArrowRotation":"auto","ortho":true,"interpolationType":"linear","cornerRadius":10,"controlPath":[[1,-4],[1,6],[1,16],[1,26]],"lockSegments":{}}},"children":null,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":23,"px":0.5,"py":1}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":25,"px":0.5,"py":0}}},"linkMap":[]},{"x":120,"y":540,"rotation":0,"id":45,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.process","width":120,"height":40,"lockAspectRatio":false,"lockShape":false,"order":21,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dropShadow":false,"state":0,"shadowX":0,"shadowY":0,"opacity":1}},"children":[{"x":2.4000000000000004,"y":0,"rotation":0,"id":46,"uid":null,"width":115.2,"height":14,"lockAspectRatio":false,"lockShape":false,"order":"auto","graphic":{"type":"Text","Text":{"tid":null,"valign":"middle","overflow":"none","vposition":"none","hposition":"none","html":"

音视频同步

","paddingLeft":2,"paddingRight":2,"paddingBottom":2,"paddingTop":2}},"children":null}],"linkMap":[]},{"x":182,"y":62,"rotation":0,"id":42,"uid":"com.gliffy.shape.basic.basic_v1.default.line","width":100,"height":100,"lockAspectRatio":false,"lockShape":false,"order":20,"graphic":{"type":"Line","Line":{"strokeWidth":2,"strokeColor":"#000000","fillColor":"none","dashStyle":null,"startArrow":0,"endArrow":2,"startArrowRotation":"auto","endArrowRotation":"auto","ortho":true,"interpolationType":"linear","cornerRadius":10,"controlPath":[[-2,-2],[-2,8],[-2,18],[-2,28]],"lockSegments":{}}},"children":null,"constraints":{"constraints":[],"startConstraint":{"type":"StartPositionConstraint","StartPositionConstraint":{"nodeId":19,"px":0.5,"py":1}},"endConstraint":{"type":"EndPositionConstraint","EndPositionConstraint":{"nodeId":23,"px":0.5,"py":0}}},"linkMap":[]},{"x":220,"y":460,"rotation":0,"id":40,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.process","width":120,"height":40,"lockAspectRatio":false,"lockShape":false,"order":18,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2,"strokeColor":"#333333","fillColor":"#d0e0e3","gradient":false,"dropShadow":false,"state":0,"shadowX":0,"shadowY":0,"opacity":1}},"children":[{"x":2.4,"y":0,"rotation":0,"id":41,"uid":null,"width":115.2,"height":14,"lockAspectRatio":false,"lockShape":false,"order":"auto","graphic":{"type":"Text","Text":{"tid":null,"valign":"middle","overflow":"none","vposition":"none","hposition":"none","html":"

视频原始数据

","paddingLeft":2,"paddingRight":2,"paddingBottom":2,"paddingTop":2}},"children":null}],"linkMap":[]},{"x":20,"y":460,"rotation":0,"id":38,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.process","width":120,"height":40,"lockAspectRatio":false,"lockShape":false,"order":16,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2,"strokeColor":"#333333","fillColor":"#d0e0e3","gradient":false,"dropShadow":false,"state":0,"shadowX":0,"shadowY":0,"opacity":1}},"children":[{"x":2.4,"y":0,"rotation":0,"id":39,"uid":null,"width":115.2,"height":14,"lockAspectRatio":false,"lockShape":false,"order":"auto","graphic":{"type":"Text","Text":{"tid":null,"valign":"middle","overflow":"none","vposition":"none","hposition":"none","html":"

音频原始数据

","paddingLeft":2,"paddingRight":2,"paddingBottom":2,"paddingTop":2}},"children":null}],"linkMap":[]},{"x":220,"y":390,"rotation":0,"id":36,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.process","width":120,"height":40,"lockAspectRatio":false,"lockShape":false,"order":14,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2,"strokeColor":"#333333","fillColor":"#f9cb9c","gradient":false,"dropShadow":false,"state":0,"shadowX":0,"shadowY":0,"opacity":1}},"children":[{"x":2.4,"y":0,"rotation":0,"id":37,"uid":null,"width":115.2,"height":14,"lockAspectRatio":false,"lockShape":false,"order":"auto","graphic":{"type":"Text","Text":{"tid":null,"valign":"middle","overflow":"none","vposition":"none","hposition":"none","html":"

视频解码

","paddingLeft":2,"paddingRight":2,"paddingBottom":2,"paddingTop":2}},"children":null}],"linkMap":[]},{"x":20,"y":390,"rotation":0,"id":34,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.process","width":120,"height":40,"lockAspectRatio":false,"lockShape":false,"order":12,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2,"strokeColor":"#333333","fillColor":"#f9cb9c","gradient":false,"dropShadow":false,"state":0,"shadowX":0,"shadowY":0,"opacity":1}},"children":[{"x":2.4,"y":0,"rotation":0,"id":35,"uid":null,"width":115.2,"height":14,"lockAspectRatio":false,"lockShape":false,"order":"auto","graphic":{"type":"Text","Text":{"tid":null,"valign":"middle","overflow":"none","vposition":"none","hposition":"none","html":"

音频解码

","paddingLeft":2,"paddingRight":2,"paddingBottom":2,"paddingTop":2}},"children":null}],"linkMap":[]},{"x":220,"y":320,"rotation":0,"id":32,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.process","width":120,"height":40,"lockAspectRatio":false,"lockShape":false,"order":10,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2,"strokeColor":"#333333","fillColor":"#a2c4c9","gradient":false,"dropShadow":false,"state":0,"shadowX":0,"shadowY":0,"opacity":1}},"children":[{"x":2.4,"y":0,"rotation":0,"id":33,"uid":null,"width":115.2,"height":14,"lockAspectRatio":false,"lockShape":false,"order":"auto","graphic":{"type":"Text","Text":{"tid":null,"valign":"middle","overflow":"none","vposition":"none","hposition":"none","html":"

视频压缩数据

","paddingLeft":2,"paddingRight":2,"paddingBottom":2,"paddingTop":2}},"children":null}],"linkMap":[]},{"x":20,"y":320,"rotation":0,"id":29,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.process","width":120,"height":40,"lockAspectRatio":false,"lockShape":false,"order":8,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2,"strokeColor":"#333333","fillColor":"#a2c4c9","gradient":false,"dropShadow":false,"state":0,"shadowX":0,"shadowY":0,"opacity":1}},"children":[{"x":2.4,"y":0,"rotation":0,"id":30,"uid":null,"width":115.2,"height":14,"lockAspectRatio":false,"lockShape":false,"order":"auto","graphic":{"type":"Text","Text":{"tid":null,"valign":"middle","overflow":"none","vposition":"none","hposition":"none","html":"

音频压缩数据

","paddingLeft":2,"paddingRight":2,"paddingBottom":2,"paddingTop":2}},"children":null}],"linkMap":[]},{"x":120,"y":230,"rotation":0,"id":27,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.process","width":120,"height":40,"lockAspectRatio":false,"lockShape":false,"order":6,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dropShadow":false,"state":0,"shadowX":0,"shadowY":0,"opacity":1}},"children":[{"x":2.3999999999999995,"y":0,"rotation":0,"id":28,"uid":null,"width":115.19999999999999,"height":14,"lockAspectRatio":false,"lockShape":false,"order":"auto","graphic":{"type":"Text","Text":{"tid":null,"valign":"middle","overflow":"none","vposition":"none","hposition":"none","html":"

解封装

","paddingLeft":2,"paddingRight":2,"paddingBottom":2,"paddingTop":2}},"children":null}],"linkMap":[]},{"x":120,"y":160,"rotation":0,"id":25,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.process","width":120,"height":40,"lockAspectRatio":false,"lockShape":false,"order":4,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2,"strokeColor":"#333333","fillColor":"#76a5af","gradient":false,"dropShadow":false,"state":0,"shadowX":0,"shadowY":0,"opacity":1}},"children":[{"x":2.3999999999999995,"y":0,"rotation":0,"id":26,"uid":null,"width":115.19999999999999,"height":14,"lockAspectRatio":false,"lockShape":false,"order":"auto","graphic":{"type":"Text","Text":{"tid":null,"valign":"middle","overflow":"none","vposition":"none","hposition":"none","html":"

封装格式数据

","paddingLeft":2,"paddingRight":2,"paddingBottom":2,"paddingTop":2}},"children":null}],"linkMap":[]},{"x":120,"y":90,"rotation":0,"id":23,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.process","width":120,"height":40,"lockAspectRatio":false,"lockShape":false,"order":2,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2,"strokeColor":"#333333","fillColor":"#FFFFFF","gradient":false,"dropShadow":false,"state":0,"shadowX":0,"shadowY":0,"opacity":1}},"children":[{"x":2.4000000000000004,"y":0,"rotation":0,"id":24,"uid":null,"width":115.19999999999999,"height":14,"lockAspectRatio":false,"lockShape":false,"order":"auto","graphic":{"type":"Text","Text":{"tid":null,"valign":"middle","overflow":"none","vposition":"none","hposition":"none","html":"

解协议

","paddingLeft":2,"paddingRight":2,"paddingBottom":2,"paddingTop":2}},"children":null}],"linkMap":[]},{"x":120,"y":20,"rotation":0,"id":19,"uid":"com.gliffy.shape.flowchart.flowchart_v1.default.process","width":120,"height":40,"lockAspectRatio":false,"lockShape":false,"order":0,"graphic":{"type":"Shape","Shape":{"tid":"com.gliffy.stencil.rectangle.basic_v1","strokeWidth":2,"strokeColor":"#333333","fillColor":"#45818e","gradient":false,"dropShadow":false,"state":0,"shadowX":0,"shadowY":0,"opacity":1}},"children":[{"x":2.3999999999999995,"y":0,"rotation":0,"id":21,"uid":null,"width":115.19999999999993,"height":14,"lockAspectRatio":false,"lockShape":false,"order":"auto","graphic":{"type":"Text","Text":{"tid":null,"valign":"middle","overflow":"none","vposition":"none","hposition":"none","html":"

网络数据

","paddingLeft":2,"paddingRight":2,"paddingBottom":2,"paddingTop":2}},"children":null}],"linkMap":[]}],"background":"#FFFFFF","width":340.5,"height":698,"maxWidth":5000,"maxHeight":5000,"nodeIndex":72,"autoFit":true,"exportBorder":false,"gridOn":true,"snapToGrid":true,"drawingGuidesOn":true,"pageBreaksOn":false,"printGridOn":false,"printPaper":"LETTER","printShrinkToFit":false,"printPortrait":true,"shapeStyles":{"com.gliffy.shape.network.network_v3.home":{"fill":"#003366"},"com.gliffy.shape.flowchart.flowchart_v1.default":{"fill":"#f9cb9c","stroke":"#333333","strokeWidth":2}},"lineStyles":{"global":{"endArrow":2,"orthoMode":0}},"textStyles":{},"themeData":null}} \ No newline at end of file diff --git "a/AudioVideo/image/\350\247\206\351\242\221\350\247\243\347\240\201\346\222\255\346\224\276\346\265\201\347\250\213.jpg" "b/AudioVideo/image/\350\247\206\351\242\221\350\247\243\347\240\201\346\222\255\346\224\276\346\265\201\347\250\213.jpg" new file mode 100644 index 00000000..25f9b820 Binary files /dev/null and "b/AudioVideo/image/\350\247\206\351\242\221\350\247\243\347\240\201\346\222\255\346\224\276\346\265\201\347\250\213.jpg" differ diff --git "a/AudioVideo/\345\270\270\350\247\201\345\260\201\350\243\205\346\240\274\345\274\217.md" "b/AudioVideo/\345\270\270\350\247\201\345\260\201\350\243\205\346\240\274\345\274\217.md" new file mode 100644 index 00000000..5dcf80b8 --- /dev/null +++ "b/AudioVideo/\345\270\270\350\247\201\345\260\201\350\243\205\346\240\274\345\274\217.md" @@ -0,0 +1,28 @@ +## 常见封装格式 + +封装格式的主要作用是把视频码流和音频码流按照一定的格式存储在一个文件中。现如今流行的封装格式如下表所示： + +主要封装格式一览 + +| 名称 | 推出机构 | 流媒体 | 支持的视频编码 | 支持的音频编码 | 目前使用领域 | +| ---- | ------------------ | ---- | ----------------------------- | ------------------------------------ | --------- | +| AVI | Microsoft Inc. | 不支持 | 几乎所有格式 | 几乎所有格式 | BT下载影视 | +| MP4 | MPEG | 支持 | MPEG-2, MPEG-4, H.264, H.263等 | AAC, MPEG-1 Layers I, II, III, AC-3等 | 互联网视频网站 | +| TS | MPEG | 支持 | MPEG-1, MPEG-2, MPEG-4, H.264 | MPEG-1 Layers I, II, III, AAC, | IPTV，数字电视 | +| FLV | Adobe Inc. | 支持 | Sorenson, VP6, H.264 | MP3, ADPCM, Linear PCM, AAC等 | 互联网视频网站 | +| MKV | CoreCodec Inc. | 支持 | 几乎所有格式 | 几乎所有格式 | 互联网视频网站 | +| RMVB | Real Networks Inc. | 支持 | RealVideo 8, 9, 10 | AAC, Cook Codec, RealAudio Lossless | BT下载影视 | + +由表可见，除了AVI之外，其他封装格式都支持流媒体，即可以“边下边播”。有些格式更“万能”一些，支持的视音频编码标准多一些，比如MKV。而有些格式则支持的相对比较少，比如说RMVB。 + +这些封装格式都有相关的文档，在这里就不一一例举了。 + +我自己也做过辅助学习的小项目： + +[TS封装格式分析器](http://blog.csdn.net/leixiaohua1020/article/details/17973587) + +[FLV封装格式分析器](http://blog.csdn.net/leixiaohua1020/article/details/17934487) + +### 参考资料： + +[视音频编解码技术零基础学习方法](http://blog.csdn.net/leixiaohua1020/article/details/18893769) \ No newline at end of file diff --git "a/AudioVideo/\345\270\270\350\247\201\345\260\201\350\243\205\346\240\274\345\274\217\346\246\202\350\247\210.md" "b/AudioVideo/\345\270\270\350\247\201\345\260\201\350\243\205\346\240\274\345\274\217\346\246\202\350\247\210.md" new file mode 100644 index 00000000..98f1e818 --- /dev/null +++ "b/AudioVideo/\345\270\270\350\247\201\345\260\201\350\243\205\346\240\274\345\274\217\346\246\202\350\247\210.md" @@ -0,0 +1,14 @@ +## 常见封装格式概览 + +| 名称 | 推出机构 | 流媒体 | 支持的视频编码 | 支持的音频编码 | 目前使用领域 | +| ---- | ------------------ | ---- | ----------------------------- | ------------------------------------ | --------- | +| AVI | Microsoft Inc. | 不支持 | 几乎所有格式 | 几乎所有格式 | BT下载影视 | +| MP4 | MPEG | 支持 | MPEG-2, MPEG-4, H.264, H.263等 | AAC, MPEG-1 Layers I, II, III, AC-3等 | 互联网视频网站 | +| TS | MPEG | 支持 | MPEG-1, MPEG-2, MPEG-4, H.264 | MPEG-1 Layers I, II, III, AAC, | IPTV，数字电视 | +| FLV | Adobe Inc. | 支持 | Sorenson, VP6, H.264 | MP3, ADPCM, Linear PCM, AAC等 | 互联网视频网站 | +| MKV | CoreCodec Inc. | 支持 | 几乎所有格式 | 几乎所有格式 | 互联网视频网站 | +| RMVB | Real Networks Inc. | 支持 | RealVideo 8, 9, 10 | AAC, Cook Codec, RealAudio Lossless | BT下载影视 | + +### 参考资料： + +[视音频编解码技术零基础学习方法](http://blog.csdn.net/leixiaohua1020/article/details/18893769) \ No newline at end of file diff --git "a/AudioVideo/\345\270\270\350\247\201\346\265\201\345\252\222\344\275\223\345\215\217\350\256\256.md" "b/AudioVideo/\345\270\270\350\247\201\346\265\201\345\252\222\344\275\223\345\215\217\350\256\256.md" new file mode 100644 index 00000000..7cb5b7a2 --- /dev/null +++ "b/AudioVideo/\345\270\270\350\247\201\346\265\201\345\252\222\344\275\223\345\215\217\350\256\256.md" @@ -0,0 +1,33 @@ +## 常见流媒体协议 + +流媒体协议是服务器与客户端之间通信遵循的规定。当前网络上主要的流媒体协议如表所示。 + +| 名称 | 推出机构 | 传输层协议 | 客户端 | 目前使用领域 | +| -------- | -------------- | ------- | -------- | -------- | +| RTSP+RTP | IETF | TCP+UDP | VLC, WMP | IPTV | +| RTMP | Adobe Inc. | TCP | Flash | 互联网直播 | +| RTMFP | Adobe Inc. | UDP | Flash | 互联网直播 | +| MMS | Microsoft Inc. | TCP/UDP | WMP | 互联网直播+点播 | +| HTTP | WWW+IETF | TCP | Flash | 互联网点播 | + +RTSP+RTP经常用于IPTV领域。因为其采用UDP传输视音频，支持组播，效率较高。但其缺点是网络不好的情况下可能会丢包，影响视频观看质量。因而围绕IPTV的视频质量的研究还是挺多的。 + +RTSP规范可参考：[RTSP协议学习笔记](http://blog.csdn.net/leixiaohua1020/article/details/11955341) + +RTSP+RTP系统中衡量服务质量可参考：[网络视频传输的服务质量（QoS）](http://blog.csdn.net/leixiaohua1020/article/details/11883393) + +上海IPTV码流分析结果可参考：[IPTV视频码流分析](http://blog.csdn.net/leixiaohua1020/article/details/11846761) + +因为互联网网络环境的不稳定性，RTSP+RTP较少用于互联网视音频传输。互联网视频服务通常采用TCP作为其流媒体的传输层协议，因而像RTMP，MMS，HTTP这类的协议广泛用于互联网视音频服务之中。这类协议不会发生丢包，因而保证了视频的质量，但是传输的效率会相对低一些。 + +此外RTMFP是一种比较新的流媒体协议，特点是支持P2P。 + +RTMP我做的研究相对多一些：比如[RTMP规范简单分析](http://blog.csdn.net/leixiaohua1020/article/details/11694129)，或者[RTMP流媒体播放过程](http://blog.csdn.net/leixiaohua1020/article/details/11704355) + +相关工具的源代码分析：[RTMPdump源代码分析 1： main()函数[系列文章\]](http://blog.csdn.net/leixiaohua1020/article/details/12952977) + +RTMP协议学习：[RTMP流媒体技术零基础学习方法](http://blog.csdn.net/leixiaohua1020/article/details/15814587) + +### 参考资料： + +[视音频编解码技术零基础学习方法](http://blog.csdn.net/leixiaohua1020/article/details/18893769) \ No newline at end of file diff --git "a/AudioVideo/\345\270\270\350\247\201\351\237\263\350\247\206\351\242\221\347\274\226\347\240\201.md" "b/AudioVideo/\345\270\270\350\247\201\351\237\263\350\247\206\351\242\221\347\274\226\347\240\201.md" new file mode 100644 index 00000000..524415e3 --- /dev/null +++ "b/AudioVideo/\345\270\270\350\247\201\351\237\263\350\247\206\351\242\221\347\274\226\347\240\201.md" @@ -0,0 +1,110 @@ +## 常见音视频编码 + +### 1. 视频编码 + +视频编码的主要作用是将视频像素数据（RGB，YUV等）压缩成为视频码流，从而降低视频的数据量。如果视频不经过压缩编码的话，体积通常是非常大的，一部电影可能就要上百G的空间。视频编码是视音频技术中最重要的技术之一。视频码流的数据量占了视音频总数据量的绝大部分。高效率的视频编码在同等的码率下，可以获得更高的视频质量。 + +视频编码的简单原理可以参考：[视频压缩编码和音频压缩编码的基本原理](http://blog.csdn.net/leixiaohua1020/article/details/28114081) + +注：视频编码技术在整个视音频技术中应该是最复杂的技术。如果没有基础的话，可以先买一些书看一下原理，比如说《现代电视原理》《数字电视广播原理与应用》（本科的课本）中的部分章节。 + +主要视频编码一览 + +| 名称 | 推出机构 | 推出时间 | 目前使用领域 | +| ----------- | -------------- | ---- | ------ | +| HEVC(H.265) | MPEG/ITU-T | 2013 | 研发中 | +| H.264 | MPEG/ITU-T | 2003 | 各个领域 | +| MPEG4 | MPEG | 2001 | 不温不火 | +| MPEG2 | MPEG | 1994 | 数字电视 | +| VP9 | Google | 2013 | 研发中 | +| VP8 | Google | 2008 | 不普及 | +| VC-1 | Microsoft Inc. | 2006 | 微软平台 | + +由表可见，有两种视频编码方案是最新推出的：VP9和HEVC。目前这两种方案都处于研发阶段，还没有到达实用的程度。当前使用最多的视频编码方案就是H.264。 + +#### **1.1 主流编码标准** + +H.264仅仅是一个编码标准，而不是一个具体的编码器，H.264只是给编码器的实现提供参照用的。 + +基于H.264标准的编码器还是很多的，究竟孰优孰劣？可参考：[MSU出品的 H.264编码器比较（2011.5）](http://blog.csdn.net/leixiaohua1020/article/details/12373947) + +在学习视频编码的时候，可能会用到各种编码器（实际上就是一个exe文件），他们常用的编码命令可以参考：[各种视频编码器的命令行格式](http://blog.csdn.net/leixiaohua1020/article/details/11705495) + +学习H.264最标准的源代码，就是其官方标准JM了。但是要注意，JM速度非常的慢，是无法用于实际的：[H.264参考软件JM12.2RC代码详细流程](http://blog.csdn.net/leixiaohua1020/article/details/11980219) + +实际中使用最多的就是x264了，性能强悍（超过了很多商业编码器），而且开源。其基本教程网上极多，不再赘述。编码时候可参考：[x264编码指南——码率控制](http://blog.csdn.net/leixiaohua1020/article/details/12720135)。编码后统计值的含义：[X264输出的统计值的含义（X264 Stats Output）](http://blog.csdn.net/leixiaohua1020/article/details/11884559) + +Google推出的VP8属于和H.264同一时代的标准。总体而言，VP8比H.264要稍微差一点。有一篇写的很好的VP8的介绍文章：[深入了解 VP8](http://blog.csdn.net/leixiaohua1020/article/details/12760173)。除了在技术领域，VP8和H.264在专利等方面也是打的不可开交，可参考文章：[WebM(VP8) vs H.264](http://blog.csdn.net/leixiaohua1020/article/details/12720237) + +此外，我国还推出了自己的国产标准AVS，性能也不错，但目前比H.264还是要稍微逊色一点。不过感觉我国在视频编解码领域还算比较先进的，可参考：[视频编码国家标准AVS与H.264的比较（节选）](http://blog.csdn.net/leixiaohua1020/article/details/12851745) + +近期又推出了AVS新一代的版本AVS+，具体的性能测试还没看过。不过据说AVS+得到了国家政策上非常强力的支持。 + +#### **1.2 下一代编码标准** + +下一代的编解码标准就要数HEVC和VP9了。VP9是Google继VP8之后推出的新一代标准。VP9和HEVC相比，要稍微逊色一些。它们的对比可参考：（1）[HEVC与VP9编码效率对比](http://blog.csdn.net/leixiaohua1020/article/details/11713041) （2）[HEVC，VP9，x264性能对比](http://blog.csdn.net/leixiaohua1020/article/details/19014955) + +HEVC在未来拥有很多大的优势，可参考：[HEVC将会取代H.264的原因](http://blog.csdn.net/leixiaohua1020/article/details/11844949) + +学习HEVC最标准的源代码，就是其官方标准HM了。其速度比H.264的官方标准代码又慢了一大截，使用可参考：[HEVC学习—— HM的使用](http://blog.csdn.net/leixiaohua1020/article/details/12759297) + +未来实际使用的HEVC开源编码器很有可能是x265，目前该项目还处于发展阶段，可参考：[x265(HEVC编码器，基于x264)](http://blog.csdn.net/leixiaohua1020/article/details/13991351)[介绍](http://blog.csdn.net/leixiaohua1020/article/details/13991351)。x265的使用可以参考：[HEVC（H.265）标准的编码器（x265，DivX265）试用](http://blog.csdn.net/leixiaohua1020/article/details/18861635) + +主流以及下一代编码标准之间的比较可以参考文章：[视频编码方案之间的比较（HEVC，H.264，MPEG2等）](http://blog.csdn.net/leixiaohua1020/article/details/12237177) + +此外，在码率一定的情况下，几种编码标准的比较可参考：[限制码率的视频编码标准比较（包括MPEG-2，H.263，MPEG-4，以及 H.264）](http://blog.csdn.net/leixiaohua1020/article/details/12851975) + +结果大致是这样的： + +HEVC > VP9 > H.264> VP8 > MPEG4 > H.263 > MPEG2。 + +截了一些图，可以比较直观的了解各种编码标准： + +HEVC码流简析：[HEVC码流简单分析](http://blog.csdn.net/leixiaohua1020/article/details/11845069) + +H.264码流简析：[H.264简单码流分析](http://blog.csdn.net/leixiaohua1020/article/details/11845625) + +MPEG2码流简析：[MPEG2简单码流分析](http://blog.csdn.net/leixiaohua1020/article/details/11846185) + +以上简析使用的工具：[视频码流分析工具](http://blog.csdn.net/leixiaohua1020/article/details/11845435) + +我自己做的小工具： [H.264码流分析器](http://blog.csdn.net/leixiaohua1020/article/details/17933821) + +### 2. 音频编码 + +音频编码的主要作用是将音频采样数据（PCM等）压缩成为音频码流，从而降低音频的数据量。音频编码也是互联网视音频技术中一个重要的技术。但是一般情况下音频的数据量要远小于视频的数据量，因而即使使用稍微落后的音频编码标准，而导致音频数据量有所增加，也不会对视音频的总数据量产生太大的影响。高效率的音频编码在同等的码率下，可以获得更高的音质。 + +音频编码的简单原理可以参考：[视频压缩编码和音频压缩编码的基本原理](http://blog.csdn.net/leixiaohua1020/article/details/28114081) + +主要音频编码一览 + +| 名称 | 推出机构 | 推出时间 | 目前使用领域 | +| ---- | -------------- | ---- | ------- | +| AAC | MPEG | 1997 | 各个领域（新） | +| AC-3 | Dolby Inc. | 1992 | 电影 | +| MP3 | MPEG | 1993 | 各个领域（旧） | +| WMA | Microsoft Inc. | 1999 | 微软平台 | + +由表可见，近年来并未推出全新的音频编码方案，可见音频编码技术已经基本可以满足人们的需要。音频编码技术近期绝大部分的改动都是在MP3的继任者——AAC的基础上完成的。 + +这些编码标准之间的比较可以参考文章：[音频编码方案之间音质比较（AAC，MP3，WMA等）](http://blog.csdn.net/leixiaohua1020/article/details/11730661) + +结果大致是这样的： + +AAC+ > MP3PRO > AAC> RealAudio > WMA > MP3 + +AAC格式的介绍：[AAC格式简介](http://blog.csdn.net/leixiaohua1020/article/details/11822537) + +AAC几种不同版本之间的对比：[AAC规格（LC，HE，HEv2）及性能对比](http://blog.csdn.net/leixiaohua1020/article/details/11971419) + +AAC专利方面的介绍：[AAC专利介绍](http://blog.csdn.net/leixiaohua1020/article/details/11854587) + +此外杜比数字的编码标准也比较流行，但是貌似比最新的AAC稍为逊色：[AC-3技术综述](http://blog.csdn.net/leixiaohua1020/article/details/11822737) + +我自己做的小工具：[ AAC格式分析器](http://blog.csdn.net/leixiaohua1020/article/details/18155549) + + + +### 参考资料： + +[视音频编解码技术零基础学习方法](http://blog.csdn.net/leixiaohua1020/article/details/18893769) \ No newline at end of file diff --git "a/AudioVideo/\351\200\232\347\224\250\350\247\206\351\242\221\350\247\243\347\240\201\346\222\255\346\224\276\346\265\201\347\250\213.md" "b/AudioVideo/\351\200\232\347\224\250\350\247\206\351\242\221\350\247\243\347\240\201\346\222\255\346\224\276\346\265\201\347\250\213.md" new file mode 100644 index 00000000..6f35f5d3 --- /dev/null +++ "b/AudioVideo/\351\200\232\347\224\250\350\247\206\351\242\221\350\247\243\347\240\201\346\222\255\346\224\276\346\265\201\347\250\213.md" @@ -0,0 +1,18 @@ +--- +typora-copy-images-to: ./image +--- + +## 通用视频解码播放流程 + +**通用的网络视频播放流程:** + +1. 从网络数据流中获得视频数据流。 +2. 将视频数据流解析成压缩音频数据和压缩视频数据。 +3. 分别对音频和视频解码获取原始(采样)数据。 +4. 经过同步策略后，有序的将原始(采样)数据输出到指定设备播放。 + +![视频解码播放流程](image/视频解码播放流程.jpg) + +### 参考资料： + +[视音频编解码技术零基础学习方法](http://blog.csdn.net/leixiaohua1020/article/details/18893769) \ No newline at end of file diff --git a/Course/Markdown/README.md b/Course/Markdown/README.md new file mode 100644 index 00000000..a35826e3 --- /dev/null +++ b/Course/Markdown/README.md @@ -0,0 +1,6 @@ +# Markdown 实用技巧 + +* [Markdown 快速入门](https://github.com/GcsSloop/AndroidNote/blob/master/Course/Markdown/markdown-start.md) +* [Markdown 基础语法](https://github.com/GcsSloop/AndroidNote/blob/master/Course/Markdown/markdown-grammar.md) +* [Markdown 链接图片](https://github.com/GcsSloop/AndroidNote/blob/master/Course/Markdown/markdown-link.md) +* [Markdown 编辑器](https://github.com/GcsSloop/AndroidNote/blob/master/Course/Markdown/markdown-editor.md) diff --git a/Course/Markdown/markdown-editor.md b/Course/Markdown/markdown-editor.md new file mode 100644 index 00000000..85eb6aae --- /dev/null +++ b/Course/Markdown/markdown-editor.md @@ -0,0 +1,120 @@ +# Markdown实用技巧－编辑器(Typora) + +本次的安利对象是一个 Markdown 编辑器，是会长见过的最简单，最优雅的编辑器，先来看一下它的界面吧： + +![QQ20161207-0](http://ww3.sinaimg.cn/large/006y8lVajw1fahmo8d9udj30ph0brgo0.jpg) + + + +它的界面非常简单，有多种主题可选，更重要的是**它的预览界面和编辑界面是一体的，而不像其他编辑器那样是左右分开的。** + +![](http://ww2.sinaimg.cn/large/005Xtdi2jw1fahnsrelggg30fp0dwakd.gif) + +从上面的示例中可以看出，其输入模式支持多种，不论是手动输入语法还是使用快捷键，都非常的流畅，实时看到效果变化，除此之外 Typora 还有很多优点。 + +## Typora 的优点 + +* 预览和编辑界面一体。 +* 强大的快捷键。 +* 兼容常见扩展语法。 +* 兼容 HTML (新版进行了完善)。 +* 支持 YAML 格式。 +* 支持公式编辑(LaTeX公式)。 +* 表格和代码块编辑起来非常方便。 +* 支持本地图片相对链接。 +* 支持将本地图片拖进编辑页面。 +* 支持多种导出格式(PDF，HTML，Word，LaTeX 等)。 +* 有多种主题可选。 + +虽然上面的内容在其他编辑器上也可以见到，但做到这么完善的并不多，想要尝试的小伙伴赶紧来试试吧，相信你也会爱上它的。 + +#### [点击这里进入 Typora 官网](http://www.typora.io/) + +既然 Typora 这么好，为什么不在一开始就推荐呢，这是因为在 Markdown 系列文章第一篇发布的时候，Typora 还有一些小瑕疵(HTML语法兼容部分)让会长不满意，所以只是放在了推荐首位，在最近更新了新版本之后，这一部分已经修复完善了，基本算是完美了，所以会长我才特地写一篇文章来推荐。 + +**Typora 支持在 WIndows，Linux，和 Mac 上使用，如果你正在使用的是 Mac 的话，那么恭喜你，除了上述的优点，你可以用到一些 Mac 系统才有的福利。** + +## 版本回溯功能 + +这是 Mac 系统提供的一个小功能，使用 Mac 的时候你可能会注意到一个小细节，**使用系统文本编辑器进行编辑文本的时候，从来不会提示你保存文本，即便编辑后不点保存立即退出里面的内容也不会丢失。**你可能会觉得这不就是一个自动保存功能么，有啥稀奇的？ + +那么你是否遇到过这一种情况，编辑了半天的内容觉得不太好想放弃保存，继续使用之前的内容，这在Windows上很容易实现，只要编辑的时候没有手动保存，直接点击关闭不保存，再打开的时候就是编辑之前的内容。 + +然而在 Mac 上自动保存了，如果关闭后再打开，点 `Command + Z` 也没用了，这不就尴尬了，难道说遇到这种情况只能关闭前狂点 `Command + Z` 回退？ + +作为一个有情怀的操作系统，自然不会意识不到这个问题，它提供了更强大的方法，那就是版本回溯，相当于一个自动的 Git 系统，这就厉害了。 + +Trpora 也用到了这一特性，点击 `File > Revert To > Browse All Versions` 就能看到了。以我之前发布的一篇文章为例： + +![](http://ww2.sinaimg.cn/large/006y8lVajw1facti4okblj31400p0gs8.jpg) + + **上图中左边为当前版本，右边为选中版本，最右侧是时间线，使用这一功能可以将文章回溯到任意时间点，妈妈再也不怕我的文章内容丢失啦，也成功避免了以下这种情况 ▼** + +![](http://ww3.sinaimg.cn/large/005Xtdi2jw1factpcyrfqj30rs0ja40l.jpg) + +由于这一功能是 Mac 系统提供的，所以不仅对纯文本有效，对 iWork 也是有效的，iWork 上面也有版本回溯功能，像 key，numbers，pages 都支持版本回溯，中文版点 `文件 > 复原 > 浏览所有版本` 即可看到过去保存的数据。 + +当然了，这只是福利之一。 + +## 更便捷的图片插入和上传方式 + +众所周知，Markdown 插入图片是一个大问题，尤其是在本地编辑的时候，但是这些在遇到 Typora 后就变的越来越简单了。 + +**对于本地图片，我们可以直接拖进来，再也不用记复杂的语法和查图片地址了，没错，只要拖进来就行，Typora 会自动识别图片并进行插入。** + +不过还有一个问题，我们的很多文章都是要发布的，直接拖进来这种方式在本地看起来没问题，但上传到网站上是读取不到本地图片的，通常解决方案就是先上传到图床上，之后再将链接插入到 Markdown 中，这样发布就没问题了。 + +但是，当一篇文章需要插入很多图片的时候，一次次的上传，一次次的复制链接，一次次的粘贴，也是很麻烦的，虽然有一些脚本可以通过快捷键进行上传，但终归还是多了一些步骤，很不方便，而且对新手很不友好，更何况很多新手根本不知道图床所谓何物。 + +这时候就要祭出 Mac 上另一个神器了: iPic [(点击此处进行下载)](https://itunes.apple.com/cn/app/ipic-tu-chuang-shen-qi-zhong/id1101244278?mt=12)，它是一个专业图床管理工具，貌似出来还没多久，目前免费版只能上传到微博图床，专业版支持大部分图床，专业版一年 30RMB，如果经常使用的话，倒也不算贵。 + +**话说不还是要用图床么？** + +**但 Typora 的方便之处就在于可以和 iPic 无缝结合，纯傻瓜式一键操作，能一次性的将文章中所有本地图片上传到图床上。** + +**首先安装 iPic，运行 iPic，之后点击 `Edit > Image Tools > Upload Local Images via iPic` 就像下面这样就行了。** + +![![QQ20161207-0](../Downloads/QQ20161207-0.png)QQ20161202-8](http://ww1.sinaimg.cn/large/006y8lVajw1facuf1yjjkj30fo0dmq4v.jpg) + +**如果你觉得这样还是很麻烦的话，还有另外的选项，可以选择插入本地图片的时候自动上传到服务器，当然了，为了保护个人隐私，这一个选项默认是关闭的，首先你要找到首选项，点击 `Typora > Preferences` 或者快捷键 `Command + ,` 都行，之后打开以下两个选项，其中一个选项是后面用到的。** + +![QQ20161202-9](http://ww3.sinaimg.cn/large/006y8lVajw1fahlaeo8pej30by0ddgn8.jpg) + +**打开之后继续选择 `Edit > Image Tools > When Insert Local Images > Upload Image via iPic` 它的意思是当插入本地图片时自动通过 iPic 上传到服务器上。** + +![QQ20161203-0](http://ww2.sinaimg.cn/large/006y8lVajw1fahlajkq1gj30qe0hwtas.jpg) + +这种方案虽然方便，但是会长并不推荐大家这么做，主要还是不安全，误操作的话可能会将一些包含个人隐私的照片上传上去。 + +会长推荐另一种方案，就是 `Copy Image File to Folder`，操作步骤和上面类似，它的意思是插入本地图片时自动归档到某一个文件夹，在文章编辑完成后在点击上传按钮统一上传，这样有以下几点好处： + +* 安全，不会因为误操作将涉及隐私照片传到服务器上。 +* 相当于自动建立了一个本地图片档案，方便备份保存。 +* 如果图床上的图片丢失，可以从快速从本地备份中找到并恢复。 + + +关于 Typora 的推荐内容暂时就到这里结束啦，更多关于 Typora 的多详情请参阅 [Support](http://support.typora.io/)。关于 Markdown 的更多内容请参见之前的文章: + +[Markdown实用技巧－快速入门](https://www.gcssloop.com/markdown/markdown-start) +[Markdown实用技巧－基础语法](https://www.gcssloop.com/markdown/markdown-grammar) +[Markdown实用技巧－链接和图片](https://www.gcssloop.com/markdown/markdown-links) + +## 结语 + +最后稍微夹带一点个人建议，个人觉得 Typora 除了界面简洁之外，最大的优点就是快捷键方便了，然而，快捷键那么多，要不要专一去记呢？ + +个人的建议是不要专一去记忆这些快捷键，用到的时候打开菜单看一眼快捷键是什么，之后用快捷键按出来，这样用过几次之后自然就会记住常用的快捷键，而且会记得很牢固，不然每个应用都有快捷键，一个一个的记多麻烦。 + +本文中涉及到的两个软件下载地址： + +[**Typora**](http://www.typora.io/) +[**iPic**](https://itunes.apple.com/cn/app/id1101244278?ls=1&mt=12) + +**最后留一个课后作业，关注会长的 [新浪微博](http://weibo.com/GcsSloop) 。** + +## About Me + +### 作者微博: @GcsSloop + + + diff --git a/Course/Markdown/markdown-grammar.md b/Course/Markdown/markdown-grammar.md new file mode 100644 index 00000000..a84c9f40 --- /dev/null +++ b/Course/Markdown/markdown-grammar.md @@ -0,0 +1,331 @@ +# Markdown 基础语法 + +为保证语法兼容性，本文只介绍基础语法，扩展语法等其它内容，会在后续的文章中单独介绍。 +**注意：所有的标记符号均使用英文，中文无效。** + +**** + +## 标题 + +Markdown 支持多种标题格式。 + +利用 `=` (等号)和 `-`(减号)可以定义一级标题和二级标题，(任何数量的 `=` 和 `-` 都有效果) ： + + + + + + + + + + + + + + +
Markdown预览
一级标题
====

一级标题

二级标题
----

二级标题

+ +通过在行首插入 1 到 6 个 # ，来定义对应的 1 到 6 阶 标题，个人推荐使用这种，例如： + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Markdown预览
# 一级标题

一级标题

## 二级标题

二级标题

### 三级标题

三级标题

#### 四级标题

四级标题

##### 五级标题
五级标题
###### 六级标题
六级标题
+ +**** + +## 段落和换行 + +在 Markdown 中段落由一行或者多行文本组成，相邻的两行文字会被视为同一段落，如果存在空行则被视为不同段落( Markdown 对空行的定义是看起来是空行就是空行，即使空行中存在 `空格` `TAB` `回车` 等不可见字符，同样会被视为空行)。 + +Markdown支持段内换行，如果你想进行段落内换行可以在上一行结尾插入两个以上的空格后再回车。 + + + + + + + + + + + + + + + + + + +
Markdown预览
+ 第一行
+ 相邻被视为同一段落。 + 		+

+ 第一行 相邻被视为同一段落。 +

+
+ 第一行[空格][空格]
+ 上一行结尾存在两个空格，段内换行 + 		+

+ 第一行
+ 上一行结尾存在两个空格，段内换行。 +

+
+ 第一行
+
+ 两行之间存在空行，视为不同段落。 + 		+

+ 第一行 +

+

+ 两行之间存在空行，视为不同段落。 +

+
+ +****** + +## 强调 + +删除线的 `~` 符号一般位于键盘左上角位置。 + + + + + + + + + + + + + + + + + + + + + + +
Markdown预览
*倾斜* + 倾斜 +
**粗体**粗体
~~删除线~~删除线
+ > 引用 + +
引用
+
+ +****** + +## 链接和图片 + +为了规避某些平台的防盗链机制，图片推荐使用图床，否则在不同平台上发布需要重新上传很麻烦的，图床最好选大平台的图床，一时半会不会倒闭的那种，个人目前主要用的是微博图床 [Chrome插件－微博图床](https://chrome.google.com/webstore/detail/%E6%96%B0%E6%B5%AA%E5%BE%AE%E5%8D%9A%E5%9B%BE%E5%BA%8A/fdfdnfpdplfbbnemmmoklbfjbhecpnhf?hl=zh-CN) 以及 [Alfred脚本－微博图床](https://imciel.com/2016/07/17/weibo-picture-upload-alfred-workflow/) + + + + + + + + + + + + + + +
Markdown预览
[GcsSloop](http://www.gcssloop.com)GcsSloop
![GcsSloop Blog](http://www.gcssloop.com/assets/siteinfo/friends/gcssloop.jpg)GcsSloop Blog
+ +****** + +## 列表 + +无序列表前面可以用 `*` `+` `-` 等，结果是相同的。 +有序列表的数字即便不按照顺序排列，结果仍是有序的。 + + + + + + + + + + + + + + + + + +
Markdown预览
+ * 项目
+ * 项目
+ * 项目
+   * 子项目
+   * 子项目
+ * 项目 + 		+
    +
  • 项目
    • +
  • 项目
    • +
  • 项目 +
      +
    • 子项目
      • +
    • 子项目
      • +
    +
    • +
  • 项目
    • +
+
+ 1. 项目
+ 2. 项目
+ 3. 项目
+   1. 子项目
+   2. 子项目
+ 4. 项目 + 		+
    +
  1. 项目
    2. +
  2. 项目
    3. +
  3. 项目 +
      +
    1. 子项目
      2. +
    2. 子项目
      3. +
    +
    4. +
  4. 项目
    5. +
+
+ +**** + +## 下划线和特殊符号 + +由于 Markdown 使用一些特殊符号进行标记，当我们想要在文档中使用这些特殊符号并防止被 Markdown 转换的时候，可以使用 `\` (转义符) 将这些特殊符号进行转义。 + + + + + + + + + + + + + + +
Markdown预览
+ 在一行中用三个以上的星号、减号、下划线来建立一个分隔线
+ --- + 		+
+
可以利用反斜杠(转义字符)来插入一些在语法中有特殊意义的符号
+ \*Hi\* + 		*Hi*
+ +**** + +## 代码 + +### 1.行内代码 + +行内代码可以使用反引号来标记(反引号一般位于键盘左上角，要用英文): + +``` +一句话 `行内代码` 一句话。 +``` + +**预览:** + +一句话 `行内代码` 一句话。 + +### 2.多行代码 + +多行代码使用 3 个反引号来标记(反引号一般位于键盘左上角，要用英文) ，在第一个 `｀｀｀` 后面可以跟语言类型，没有语言类型可以省略不写: + +``` +​``` java +// 我是注释 +int a = 5; +​``` +``` + +**预览:** + +``` java +// 我是注释 +int a = 5; +``` + + + +**** + +## 表格 + +**扩展的 Markdown 支持手写表格**，格式也非常简单，第二行分割线部分可以使用 `:` 来控制内容状态。 +**注意，Markdown 标准(原生)语法中没有表格支持，但现在多数平台已经支持了该语法，如 GitHub，CSDN，简书 等均支持，所以写在这里:** + +**Markdown：** + +``` +| 默认 | 靠右 | 居中 | 靠左 | +| ---- | ---: | :--: | :--- | +| 内容 | 内容 | 内容 | 内容 | +| 内容 | 内容 | 条目 | 内容 | +``` + +**预览：** + +| 默认 | 靠右 | 居中 | 靠左 | +| ---- | ---: | :--: | :--- | +| 内容 | 内容 | 内容 | 内容 | +| 内容 | 内容 | 条目 | 内容 | + + +## 参考资料 + +[Markdown－语法说明](http://www.markdown.cn/) + + +## About Me + +### 作者微博: @GcsSloop + + diff --git a/Course/Markdown/markdown-html.md b/Course/Markdown/markdown-html.md new file mode 100644 index 00000000..ec82fc0f --- /dev/null +++ b/Course/Markdown/markdown-html.md @@ -0,0 +1,3 @@ +# Markdown 网页格式兼容 + +Markdown 作为一种标记型语言，在大多数情况下都是需要转换为 HTML 格式的，所以 Markdown 理论上是兼容 HTML 语法的，在 Markdown 所提供的标记无法满足我们需要的时候，可以尝试使用 HTML 相关语法来实现。 \ No newline at end of file diff --git a/Course/Markdown/markdown-link.md b/Course/Markdown/markdown-link.md new file mode 100644 index 00000000..5c3d40cc --- /dev/null +++ b/Course/Markdown/markdown-link.md @@ -0,0 +1,194 @@ +# Markdown实用技巧－链接和图片 + +博客地址： http://www.gcssloop.com/markdown/markdown-links + +Sloop 喝过半杯咖啡，涨红的脸色渐渐复了原，旁人便又问道，“ Sloop，你当真会写文章么？” Sloop 看着问他的人，显出不屑置辩的神气。他们便接着说道，“你怎的连半个赞也捞不到呢？” Sloop 立刻显出颓唐不安模样，脸上笼上了一层灰色，嘴里说些话；这回可是全是技术名词之类，一些不懂了。在这时候，众人也都哄笑起来：办公室内外充满了快活的空气。 + +在这些时候，我可以附和着笑，老板是决不责备的。而且老板见了 Sloop，也每每这样问他，引人发笑。Sloop 自己知道不能和他们谈天，便只好向实习生说话。有一回对我说道，“你会用 Markdown 么？” 我略略点一点头。他说，“会用 Markdown，……我便考你一考。Markdown 的链接，你是怎样写的？” 我想，码农一样的人，也配考我么？便回过脸去，不再理会。Sloop 等了许久，很恳切的说道，“不能写罢？……我教给你，记着！这些写法应该记着。将来做程序员的时候，写文档要用。”我暗想我和程序员的等级还很远呢，而且我们这里的程序员也从不写文档；又好笑，又不耐烦，懒懒的答他道，“谁要你教，不是一对方括号后面跟一对圆括号么？” Sloop 显出极高兴的样子，将两个指头的长指甲敲着电脑，点头说，“对呀对呀！……链接有4样基本写法，你知道么？” 我愈不耐烦了，努着嘴走远。Sloop 刚想打开编辑器，给我演示，见我毫不热心，便又叹一口气，显出极惋惜的样子。 + +***** + +## 前言 + +**本文是适用于对 Markdown 有一定了解的魔法师，以帮助他们挖掘更多关于 Markdown 的可能性，例如：链接的不同类型以及使用方式，如何在新标签页打开链接，如何控制图片大小等，对 Markdown 还不了解的魔法师请参考 [Markdown快速入门][markdown-start] 和 [Markdown基础语法][markdown-grammar] 。** + +**注意：以下的部分语法不属于标准语法，存在不兼容的问题，不能保证所有平台都能够使用。对于非标准语法(拓展语法)我会进行标注说明。** + +***** + +## 行内式链接: + +```markdown +博客地址: [GcsSloop](http://www.gcssloop.com) +博客地址: [GcsSloop](http://www.gcssloop.com "GcsSloop的博客") +``` + +博客地址: [GcsSloop](http://www.gcssloop.com) +博客地址: [GcsSloop](http://www.gcssloop.com "GcsSloop的博客") + +***** + +## 参考式链接: + +```markdown +[GcsSloop的博客][gcssloop] + +[gcssloop]: http://www.gcssloop.com +// 或者 +[gcssloop]: http://www.gcssloop.com "点击访问GcsSloop的博客" +``` + +[GcsSloop的博客][gcssloop] + +**为什么要使用参考式呢？** +在写文章的时候很可能会在文章不同的地方引用同一篇文章，使用参考式可以少写一点字符。 +更重要的是，参考文章的链接可能会改变，如果将参考链接统一写在文末的话，改起来会更容易。 + +***** + +## 自动链接: + +```markdown + +``` + + + +***** + +## 相对链接: + +**如果你的内容是发布在 GitHub 或者自己的个人网站上，那么相对链接是一个很好用的东西**，例如引用本站的一张图片可以这样写: + +```markdown +![头像](/assets/siteinfo/avatar.jpg) +``` + +![头像](/assets/siteinfo/avatar.jpg) + +**相对链接优点:** + +* 线下预览和线上效果相同，不受网络影响。 +* 避免了分别上传图片导致的麻烦。 +* GitHub复制仓库更方便，改仓库名字不会导致资源链接失效。 + +**相对链接缺点:** + +* 不适用于需要在多平台发布的文章。 +* 某些本地编辑器不支持读取相对链接。 + +***** + +## 图片链接: + +图片链接其实就是把图片和链接嵌套在一起: + +> 顺便为 DiyCode 打一个小广告，欢迎更多小伙伴的加入。 + +```markdown +[![](http://ww1.sinaimg.cn/large/005Xtdi2jw1f9e6ii0bsgj30xc04gaau.jpg)](http://www.diycode.cc/wiki/encouragement) +``` + +[![](http://ww1.sinaimg.cn/large/005Xtdi2jw1f9e6ii0bsgj30xc04gaau.jpg)](http://www.diycode.cc/wiki/encouragement){:target="_blank"} + +***** + +IIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIII + +**注意：从这里开始往下的部分，属于拓展语法，可能存在某些平台(编辑器)无法识别的问题，请亲自测试后再使用。** + +IIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIII + +## 在新标签页打开: + +Markdown 的默认链接方式都是在当前标签页打开的，这就会导致打开链接之后原始页面被覆盖掉，如果想要让链接在新标签页打开可以在后面添加上 `{:target="_blank"}` 或者使用 HTML 语法。 + +``` +[GcsSloop](http://www.gcssloop.com){:target="_blank"} + +[GcsSloop的博客][gcssloop]{:target="_blank"} + +{:target="_blank"} + +关于GcsSloop +``` + +[GcsSloop](http://www.gcssloop.com){:target="_blank"}
+[GcsSloop的博客][gcssloop]{:target="_blank"}
+{:target="_blank"}
+关于GcsSloop + +注意: 部分平台可能不识别 `{:target="_blank"}` 标签，例如你正在看的这个 GitHub 就不识别。。 + +***** + +## 注释(脚注): + +注释一般用于解释一些专业名词或者难以理解的内容，由于注释的解释部分一般放在文末，所以又称为脚注: + +``` +GcsSloop[^1]是一个超级魔法师[^2] 。 + +[^1]: GcsSloop：非著名程序员。 +[^2]: 魔法师：会魔法的人类 +``` + +GcsSloop[^1]是一个超级魔法师[^2] 。 + +注意：脚注不论在何处定义，最终都是显示在文末。部分平台不识别该语法，GitHub 依旧不识别。 + +***** + +## 控制图片大小 + +使用 `{:width="300" height="100"}` 或者 HTML 格式可以控制图片显示大小，图片有宽度(width)和高度(height)两个属性，如果只指定了一个，另一个会按照比例缩放。 + +``` +![](http://ww1.sinaimg.cn/large/005Xtdi2jw1f9k7b8a6vmj312w0rg143.jpg){:width="300"} + + +``` + +![](http://ww1.sinaimg.cn/large/005Xtdi2jw1f9k7b8a6vmj312w0rg143.jpg){:width="300"} + +右键，新标签页打开图片，你会发现原图其实挺大的。 +注意: 部分平台可能不识别 `{:width="300" height="100"}` 标签，你正在看的这个 GitHub 依旧不识别。 + +***** + +## 总结: + +Markdown 存在很多的变种，对其语法进行了不同程度的拓展，使其更加的强大，但是使用拓展语法之前请三思。个人建议如下： + +* 如果文章(文档)只在单一平台发布，使用任何该平台支持的拓展语法都没问题。 +* 如果文章(文档)需要在多个平台发布，尽量使用标准语法，使用拓展语法之前请注意测试平台兼容性。 +* 图片尽量使用图床管理，而且要进行本地备份。 + + +***** + +## About Me + +### 作者微博: @GcsSloop + + + +## 参考链接： + +[Markdown－基础语法](http://www.markdown.cn/) +[Markdown语法:在新窗口新标签页中打开](http://yinping4256.github.io/cn/Markdown%E8%AF%AD%E6%B3%95%E5%9C%A8%E6%96%B0%E7%AA%97%E5%8F%A3%E6%96%B0%E6%A0%87%E7%AD%BE%E9%A1%B5%E4%B8%AD%E6%89%93%E5%BC%80/) + + +### 注释: + +[^1]: GcsSloop：非著名程序员。 +[^2]: 魔法师：会魔法的人类 + + + + +[markdown-start]: http://www.gcssloop.com/markdown/markdown-star "Markdown实用技巧－快速入门" + +[markdown-grammar]: http://www.gcssloop.com/markdown/markdown-grammar "Markdown实用技巧－基础语法" + +[gcssloop]: http://www.gcssloop.com "点击访问GcsSloop的博客" diff --git a/Course/Markdown/markdown-start.md b/Course/Markdown/markdown-start.md new file mode 100644 index 00000000..ffca84e8 --- /dev/null +++ b/Course/Markdown/markdown-start.md @@ -0,0 +1,176 @@ +# Markdown 快速入门 + +自从接触了 Markdown 之后，就一直用 Markdown 作为自己的主要书写工具，不论是平时做一些简单的纪录，还是用来写博客，写文档都是非常方便。你现在看到的这篇文章就是用 Markdown 进行书写的。 + +> 我最早因为 GitHub 而了解到 Markdown，当是支持 Markdown 的平台并不多，现在发现很多平台都已经开始支持 Markdown了，不论是老牌的 CSDN 还是比较新的 简书、掘金、DiyCode 等都支持使用Markdown进行写作，借此趋势，赶紧向还不了解 Markdown 的魔法师强势安利一波。 +> +> **如果你已经开始使用 Markdown了，那么本文作用对你可以能并不大，请看后续文章。** + + + +**** + +## 什么是 Markdown ? + +**Markdown 是一种轻量级标记语言，创始人为約翰·格魯伯（John Gruber）。 它允许人们“使用易读易写的纯文本格式编写文档，然后转换成有效的XHTML(或者HTML)文档”。** + +相比于 HTML (~~How To Make Love~~ 大雾)， **Markdown 更加精简，更加注重内容，其主要宗旨是「易读易写」** 一般 Markdown 最终都是要转换为 HTML 的，可用于书写博客或者网页，但借助某些工具，可以讲 Markdown 转换为 pdf，word，Latex 等其他常见的文件格式。 + + + +**** + +## 为什么选择 Markdown ? + +**选择 Markdown 但理由只有一个：方便，节省时间!** + +至于为什么这样说，请看下面内容： + +* **语法简洁**，没有任何编程基础的人十几分钟语言即可入门。 +* **注重内容**，专注于内容编写，不再因为格式拍版而苦恼 (word格式刷工具哭晕在厕所)。 +* **易阅读性**，即便是没有经过转换的 Markdown 文件，大部分文字内容仍可阅读。 +* **易编辑性**，任何文本编辑器都能编辑 Markdown 文件。 +* **跨平台性**，任何平台均能打开 Markdown 文件，由于是纯文本文件，不存在格式兼容的问题。 +* **导出方便**，支持导出为 HTML，PDF，Word(.docx)，LaTex 等常见格式(需要工具支持)。 + +在 Windows 上编写的文档，非常方便的就能在 Mac 上继续编辑，方便数据迁移，降低沟通成本。 + + + +**** + +## Markdown 存在的问题 + +前面吹嘘了 Markdown 的那么多优点，下面就说一下其中的不足： + +* **图片问题**，很多人都觉得 Markdown 文件插入图片麻烦，还要自己上传找链接。 +* **语法兼容**，基础语法是兼容的，但不同工具(平台)的扩展语法不兼容(由于没有统一标准)。 +* **细节控制**，Markdown只提供最基础的格式，其显示样式主要由CSS控制，很难针对性的控制部分内容。 + +以上应该是 Markdown 最常见的一些麻烦，不过不必担心，**后续文章会教大家来如何解决这些问题，取其精华，去其糟粕，让 Markdown 运用得心应手**。 + +**** + +## Markdown 编辑器推荐 + +俗话说，工欲善其事，必先利其器，虽然 Markdown 用任何文本编辑器都能打开编辑，但仍需要专业工具进行转化，常见 Markdown 编辑器我基本上都尝试用过，在此简单推荐几种，大家找适合自己的就行。 + +**仅推荐本地编辑器，在线编辑器根据需要自己选择，很多平台都已经支持直接用 Markdown 进行编辑了。** + +| 编辑器 | 支持平台 | 支持导出格式 | +| ---------------------------------------- | --------------------------- | ---------------------------------------- | +| [**Typora**](http://www.typora.io/)
正在开发， 界面简洁， 对 HTML 语法支持较弱， 支持导出文件类型较多。 | Mac、
Windows、
Linux | HTML、
Word(.docx)、
PDF、
LaTex 等 | +| [**EME**](https://eme.moe/)
正在开发， 界面简洁，对 HTML 语法支持友好，支持导出文件类型较少。 | Mac、
Windows、
Linux | 仅 PDF | +| [**Mou**](http://25.io/mou/)
停止开发， 界面简洁， 对 HTML 语法支持友好， 但支持导出文件类型较少。 | Mac | HTML、
PDF | +| [**Sublime Text**](http://www.sublimetext.com/3)
神兵利器，需要安装插件才能使用， 相对比较麻烦， 适合高级魔法师。 | Mac、
Windows、
Linux | 多种格式(插件) | +| [**Atom**](https://atom.io/)
神兵利器， 支持多种常见的编程语言， 如果仅仅是为了写 Markdown 不推荐安装。 | Mac、
Windows、
Linux | HTML、
PDF(插件) | + +**** + +## 快速入门 + +本文是为了帮助还不了解 Markdown 的魔法师有一个简单的认知，所以快速入门只说最基本的一些内容。 + + + +### 标题 + +通过在行首插入 1 到 6 个 `#` ，来定义对应的 1 到 6 阶 标题： + + + + + + + + + + + + + + + + + + +
Markdown预览
# 一级标题

一级标题

## 二级标题

二级标题

### 三级标题

三级标题

+ + + +### 分段 + +在 Markdown 中段落由一行或者多行文本组成，相邻的两行文字会被视为同一段落，如果存在空行则被视为不同段落( Markdown 对空行的定义是看起来是空行就是空行，即使空行中存在 `空格` `TAB` `回车` 等不可见字符，同样会被视为空行)。 + + + + + + + + + + + + + + +
Markdown预览
+ 第一行
+ 相邻被视为同一段落。 + 		+

+ 第一行 相邻被视为同一段落。 +

+
+ 第一行
+
+ 两行之间存在空行，视为不同段落。 + 		+

+ 第一行 +

+

+ 两行之间存在空行，视为不同段落。 +

+
+ + + +### 链接和图片 + + + + + + + + + + + + + + +
Markdown预览
[GcsSloop](http://www.gcssloop.com)GcsSloop
![GcsSloop Blog](http://www.gcssloop.com/assets/siteinfo/friends/gcssloop.jpg)GcsSloop Blog
+ + + +知道了上面这些内容就已经算是入门了，可以用 Markdown 进行快乐的写作，如果想了解更多语法相关内容，请看下一篇 [Markdown实用技巧－基础语法][markdown-grammar] + + +## 参考资料 + +[Markdown－基础语法](http://www.markdown.cn/) + + +## About Me + +### 作者微博: @GcsSloop + + + +[markdown-grammar]: /markdown/markdown-grammar "Markdown实用技巧－语法" + + + diff --git a/Course/README.md b/Course/README.md index b9fd97f3..d2e3d8c9 100644 --- a/Course/README.md +++ b/Course/README.md @@ -2,7 +2,7 @@

- - - + + +

diff --git a/CustomView/Advance/Code/CheckView.md b/CustomView/Advance/Code/CheckView.md index 1c7044b9..1a17bb65 100644 --- a/CustomView/Advance/Code/CheckView.md +++ b/CustomView/Advance/Code/CheckView.md @@ -1,5 +1,7 @@ ## CheckView源代码 +[下载代码 ( 右键 -> 另存为 )](https://raw.githubusercontent.com/GcsSloop/AndroidNote/master/CustomView/Advance/Code/CheckView.java) + ``` java package com.sloop.canvas; diff --git a/CustomView/Advance/Code/SearchView.java b/CustomView/Advance/Code/SearchView.java index 8f3a3a23..c6ee6262 100644 --- a/CustomView/Advance/Code/SearchView.java +++ b/CustomView/Advance/Code/SearchView.java @@ -16,6 +16,33 @@ public class SearchView extends View { private int mViewWidth; private int mViewHeight; + public SearchView(Context context) { + this(context,null); + } + + public SearchView(Context context, AttributeSet attrs) { + super(context, attrs); + initAll(); + } + + public void initAll() { + + initPaint(); + + initPath(); + + initListener(); + + initHandler(); + + initAnimator(); + + // 进入开始动画 + mCurrentState = State.STARTING; + mStartingAnimator.start(); + + } + // 这个视图拥有的状态 public static enum State { NONE, @@ -57,24 +84,7 @@ public static enum State { private int count = 0; - public SearchView(Context context) { - super(context); - - initPaint(); - - initPath(); - - initListener(); - initHandler(); - - initAnimator(); - - // 进入开始动画 - mCurrentState = State.STARTING; - mStartingAnimator.start(); - - } private void initPaint() { mPaint = new Paint(); diff --git a/CustomView/Advance/Code/SearchView.md b/CustomView/Advance/Code/SearchView.md index 13af1f7c..311df8e3 100644 --- a/CustomView/Advance/Code/SearchView.md +++ b/CustomView/Advance/Code/SearchView.md @@ -1,5 +1,7 @@ ## SearchView 源代码 +[下载代码 (右键 -> 另存为)](https://raw.githubusercontent.com/GcsSloop/AndroidNote/master/CustomView/Advance/Code/SearchView.java) + ``` java /** * Author: GcsSloop @@ -19,6 +21,33 @@ public class SearchView extends View { private int mViewWidth; private int mViewHeight; + public SearchView(Context context) { + this(context,null); + } + + public SearchView(Context context, AttributeSet attrs) { + super(context, attrs); + initAll(); + } + + public void initAll() { + + initPaint(); + + initPath(); + + initListener(); + + initHandler(); + + initAnimator(); + + // 进入开始动画 + mCurrentState = State.STARTING; + mStartingAnimator.start(); + + } + // 这个视图拥有的状态 public static enum State { NONE, @@ -60,24 +89,7 @@ public class SearchView extends View { private int count = 0; - public SearchView(Context context) { - super(context); - - initPaint(); - - initPath(); - - initListener(); - initHandler(); - - initAnimator(); - - // 进入开始动画 - mCurrentState = State.STARTING; - mStartingAnimator.start(); - - } private void initPaint() { mPaint = new Paint(); diff --git a/CustomView/Advance/Code/SetPolyToPoly.md b/CustomView/Advance/Code/SetPolyToPoly.md index 3988fac2..9d77d6f3 100644 --- a/CustomView/Advance/Code/SetPolyToPoly.md +++ b/CustomView/Advance/Code/SetPolyToPoly.md @@ -2,6 +2,8 @@ ## SetPolyToPoly.java +[下载代码 (右键 -> 另存为)](https://raw.githubusercontent.com/GcsSloop/AndroidNote/master/CustomView/Advance/Code/SetPolyToPoly.java) + ```java public class SetPolyToPoly extends View{ private static final String TAG = "SetPolyToPoly"; diff --git a/CustomView/Advance/[01]CustomViewProcess.md b/CustomView/Advance/[01]CustomViewProcess.md index f6687bb5..70e4a5be 100644 --- a/CustomView/Advance/[01]CustomViewProcess.md +++ b/CustomView/Advance/[01]CustomViewProcess.md @@ -16,20 +16,20 @@ ## 一.自定义View分类 **我将自定义View分为了两类(sloop个人分类法，非官方)：** - + ### 1.自定义ViewGroup - + **自定义ViewGroup一般是利用现有的组件根据特定的布局方式来组成新的组件，大多继承自ViewGroup或各种Layout，包含有子View。** - + > 例如：应用底部导航条中的条目，一般都是上面图标(ImageView)，下面文字(TextView)，那么这两个就可以用自定义ViewGroup组合成为一个Veiw，提供两个属性分别用来设置文字和图片，使用起来会更加方便。 - + ### 2.自定义View - + **在没有现成的View，需要自己实现的时候，就使用自定义View，一般继承自View，SurfaceView或其他的View，不包含子View。** - + > 例如：制作一个支持自动加载网络图片的ImageView，制作图表等。 -**PS： 自定义View在大多数情况下都有替代方案，利用图片或者组合动画来实现，但是使用后者可能会面临内存耗费过大，制作麻烦更诸多问题。** +**PS： 自定义View在大多数情况下都有替代方案，利用图片或者组合动画来实现，但是使用后者可能会面临内存耗费过大，制作麻烦等诸多问题。** ******* @@ -47,9 +47,9 @@ View的构造函数有四种重载分别如下: public void SloopView(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes) {} ``` 可以看出，关于View构造函数的参数有多有少，先排除几个不常用的，留下常用的再研究。 - + **有四个参数的构造函数在API21的时候才添加上，暂不考虑。** - + 有三个参数的构造函数中第三个参数是默认的Style，这里的默认的Style是指它在当前Application或Activity所用的Theme中的默认Style，且只有在明确调用的时候才会生效，以系统中的ImageButton为例说明： ``` java public ImageButton(Context context, AttributeSet attrs) { @@ -111,21 +111,21 @@ View的构造函数有四种重载分别如下: **测量模式一共有三种， 被定义在 Android 中的 View 类的一个内部类View.MeasureSpec中：** -模式 | 二进制数值 | 描述 ------------ |:----------:| --- -UNSPECIFIED | 00 | 默认值，父控件没有给子view任何限制，子View可以设置为任意大小。 -EXACTLY | 01 | 表示父控件已经确切的指定了子View的大小。 -AT_MOST | 10 | 表示子View具体大小没有尺寸限制，但是存在上限，上限一般为父View大小。 +| 模式 | 二进制数值 | 描述 | +| ----------- | :---: | -------------------------------------- | +| UNSPECIFIED | 00 | 默认值，父控件没有给子view任何限制，子View可以设置为任意大小。 | +| EXACTLY | 01 | 表示父控件已经确切的指定了子View的大小。 | +| AT_MOST | 10 | 表示子View具体大小没有尺寸限制，但是存在上限，上限一般为父View大小。 | **在int类型的32位二进制位中，31-30这两位表示测量模式,29~0这三十位表示宽和高的实际值，实际上如下：** 以数值1080(二进制为: 1111011000)为例(其中模式和实际数值是连在一起的，为了展示我将他们分开了)： -模式名称 | 模式数值 | 实际数值 -------------| --------:| --- -UNSPECIFIED | 00 | 000000000000000000001111011000 -EXACTLY | 01 | 000000000000000000001111011000 -AT_MOST | 10 | 000000000000000000001111011000 +| 模式名称 | 模式数值 | 实际数值 | +| ----------- | ---: | ------------------------------ | +| UNSPECIFIED | 00 | 000000000000000000001111011000 | +| EXACTLY | 01 | 000000000000000000001111011000 | +| AT_MOST | 10 | 000000000000000000001111011000 | **PS: 实际上关于上面的东西了解即可，在实际运用之中只需要记住有三种模式，用 MeasureSpec 的 getSize是获取数值， getMode是获取模式即可。** @@ -136,7 +136,7 @@ AT_MOST | 10 | 000000000000000000001111011000 ### 3.确定View大小(onSizeChanged) 这个函数在视图大小发生改变时调用。 - + **Q: 在测量完View并使用setMeasuredDimension函数之后View的大小基本上已经确定了，那么为什么还要再次确定View的大小呢？** **A: 这是因为View的大小不仅由View本身控制，而且受父控件的影响，所以我们在确定View大小的时候最好使用系统提供的onSizeChanged回调函数。** @@ -157,32 +157,32 @@ onSizeChanged如下： ### 4.确定子View布局位置(onLayout) **确定布局的函数是onLayout，它用于确定子View的位置，在自定义ViewGroup中会用到，他调用的是子View的layout函数。** - + 在自定义ViewGroup中，onLayout一般是循环取出子View，然后经过计算得出各个子View位置的坐标值，然后用以下函数设置子View位置。 - + ``` java child.layout(l, t, r, b); ``` 四个参数分别为： -名称 | 说明 | 对应的函数 ----- | -------------------------- | --- -l | View左侧距父View左侧的距离 | getLeft(); -t | View顶部距父View顶部的距离 | getTop(); -r | View右侧距父View左侧的距离 | getRight(); -b | View底部距父View顶部的距离 | getBottom(); +| 名称 | 说明 | 对应的函数 | +| ---- | ----------------- | ------------ | +| l | View左侧距父View左侧的距离 | getLeft(); | +| t | View顶部距父View顶部的距离 | getTop(); | +| r | View右侧距父View左侧的距离 | getRight(); | +| b | View底部距父View顶部的距离 | getBottom(); | -具体可以参考 [坐标系](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Base/%5B1%5DCoordinateSystem.md) 这篇文章。 +具体可以参考 [坐标系](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Base/%5B01%5DCoordinateSystem.md) 这篇文章。 ![](http://ww2.sinaimg.cn/large/005Xtdi2gw1f1qzqwvkkbj308c0dwgm9.jpg) PS：关于onLayout这个函数在讲解自定义ViewGroup的时候会详细讲解。 - - + + ======== ### 5.绘制内容(onDraw) - + onDraw是实际绘制的部分，也就是我们真正关心的部分，使用的是Canvas绘图。 ``` java @Override @@ -196,7 +196,7 @@ b | View底部距父View顶部的距离 | getBottom(); ### 6.对外提供操作方法和监听回调 自定义完View之后，一般会对外暴露一些接口，用于控制View的状态等，或者监听View的变化. - + 本内容会在后续文章中以实例的方式进讲解。 ************ @@ -207,20 +207,20 @@ b | View底部距父View顶部的距离 | getBottom(); > PS ：实际上ViewGroup是View的一个子类。 -类别 | 继承自 | 特点 ---------- | --------------------- | ------------ -View | View SurfaceView 等 | 不含子View -ViewGroup | ViewGroup xxLayout等 | 包含子View +| 类别 | 继承自 | 特点 | +| --------- | ------------------- | ------- | +| View | View SurfaceView 等 | 不含子View | +| ViewGroup | ViewGroup xxLayout等 | 包含子View | ### 自定义View流程： -步骤 | 关键字 | 作用 ----- | ------------- | ------------- - 1 | 构造函数 | View初始化 - 2 | onMeasure | 测量View大小 - 3 | onSizeChanged | 确定View大小 - 4 | onLayout | 确定子View布局(自定义View包含子View时有用) - 5 | onDraw | 实际绘制内容 - 6 | 提供接口 | 控制View或监听View某些状态。 +| 步骤 | 关键字 | 作用 | +| ---- | ------------- | ---------------------------- | +| 1 | 构造函数 | View初始化 | +| 2 | onMeasure | 测量View大小 | +| 3 | onSizeChanged | 确定View大小 | +| 4 | onLayout | 确定子View布局(自定义View包含子View时有用) | +| 5 | onDraw | 实际绘制内容 | +| 6 | 提供接口 | 控制View或监听View某些状态。 | diff --git a/CustomView/Advance/[02]Canvas_BasicGraphics.md b/CustomView/Advance/[02]Canvas_BasicGraphics.md index bd60cebc..60143dc4 100644 --- a/CustomView/Advance/[02]Canvas_BasicGraphics.md +++ b/CustomView/Advance/[02]Canvas_BasicGraphics.md @@ -3,7 +3,7 @@ ### 作者微博: [@GcsSloop](http://weibo.com/GcsSloop) ### [【本系列相关文章】](https://github.com/GcsSloop/AndroidNote/tree/master/CustomView/README.md) -在上一篇[自定义View分类与流程](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B1%5DCustomViewProcess.md)中我们了解自定义View相关的基本知识，不过，这些东西依旧还是理论，并不能**拿来(zhuang)用(B)**, 这一次我们就了解一些**能(zhaung)用(B)**的东西。 +在上一篇[自定义View分类与流程](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B01%5DCustomViewProcess.md)中我们了解自定义View相关的基本知识，不过，这些东西依旧还是理论，并不能**拿来(zhuang)用(B)**, 这一次我们就了解一些**能(zhaung)用(B)**的东西。 在本篇文章中，我们先了解Canvas的基本用法，最后用一个小示例来结束本次教程。 @@ -50,7 +50,7 @@ Canvas我们可以称之为画布，能够在上面绘制各种东西，是安 -> 关于颜色的更多资料请参考[基础篇_颜色](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView%2FBase%2F%5B3%5DColor.md) +> 关于颜色的更多资料请参考[基础篇_颜色](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView%2FBase%2F%5B03%5DColor.md) ****** @@ -90,7 +90,7 @@ Canvas我们可以称之为画布，能够在上面绘制各种东西，是安 ``` 关于坐标原点默认在左上角，水平向右为x轴增大方向，竖直向下为y轴增大方向。 -> 更多参考这里 [基础篇_坐标系](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView%2FBase%2F%5B1%5DCoordinateSystem.md) +> 更多参考这里 [基础篇_坐标系](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView%2FBase%2F%5B01%5DCoordinateSystem.md) @@ -111,22 +111,22 @@ Canvas我们可以称之为画布，能够在上面绘制各种东西，是安 ****** ### 绘制矩形： -确定确定一个矩形最少需要四个数据，就是**对角线的两个点**的坐标值，这里一般采用**左上角和右下角**的两个点的坐标。 +我们都知道，确定一个矩形最少需要四个数据，就是**对角线的两个点**的坐标值，这里一般采用**左上角和右下角**的两个点的坐标。 关于绘制矩形，Canvas提供了三种重载方法，第一种就是提供**四个数值(矩形左上角和右下角两个点的坐标)来确定一个矩形**进行绘制。 其余两种是先将矩形封装为**Rect或RectF**(实际上仍然是用两个坐标点来确定的矩形)，然后传递给Canvas绘制，如下： ``` java - // 第一种 - canvas.drawRect(100,100,800,400,mPaint); +// 第一种 +canvas.drawRect(100,100,800,400,mPaint); - // 第二种 - Rect rect = new Rect(100,100,800,400); - canvas.drawRect(rect,mPaint); +// 第二种 +Rect rect = new Rect(100,100,800,400); +canvas.drawRect(rect,mPaint); - // 第三种 - RectF rectF = new RectF(100,100,800,400); - canvas.drawRect(rectF,mPaint); +// 第三种 +RectF rectF = new RectF(100,100,800,400); +canvas.drawRect(rectF,mPaint); ``` 以上三种方法所绘制出来的结果是完全一样的。 @@ -192,7 +192,7 @@ Canvas我们可以称之为画布，能够在上面绘制各种东西，是安 ****** ### 绘制椭圆： -相对于绘制圆角矩形，绘制椭圆就简单的多了，因为他只需要一个矩形矩形作为参数: +相对于绘制圆角矩形，绘制椭圆就简单的多了，因为他只需要一个矩形作为参数: ``` java // 第一种 @@ -274,12 +274,12 @@ useCenter // 是否使用中心 -可以发现使用了中心点之后绘制出来类似于一个扇形，而不使用中心点则是圆弧起始点和结束点之间的连线加上圆弧围成的图形。这样中心点这个参数的作用就很明显了，不必多说想必大家试一下就明白了。 另外可以关于角度可以参考一下这篇文章： [角度与弧度](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView%2FBase%2F%5B2%5DAngleAndRadian.md) +可以发现使用了中心点之后绘制出来类似于一个扇形，而不使用中心点则是圆弧起始点和结束点之间的连线加上圆弧围成的图形。这样中心点这个参数的作用就很明显了，不必多说想必大家试一下就明白了。 另外可以关于角度可以参考一下这篇文章： [角度与弧度](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView%2FBase%2F%5B02%5DAngleAndRadian.md) 相比于使用椭圆，我们还是使用正圆比较多的，使用正圆展示一下效果： ``` - RectF rectF = new RectF(100,100,800,400); + RectF rectF = new RectF(100,100,600,600); // 绘制背景矩形 mPaint.setColor(Color.GRAY); canvas.drawRect(rectF,mPaint); @@ -290,7 +290,7 @@ useCenter // 是否使用中心 //------------------------------------- - RectF rectF2 = new RectF(100,600,800,900); + RectF rectF2 = new RectF(100,700,600,1200); // 绘制背景矩形 mPaint.setColor(Color.GRAY); canvas.drawRect(rectF2,mPaint); @@ -476,12 +476,12 @@ public class PieView extends View { // 设置数据 public void setData(ArrayList mData) { this.mData = mData; - initDate(mData); + initData(mData); invalidate(); // 刷新 } // 初始化数据 - private void initDate(ArrayList mData) { + private void initData(ArrayList mData) { if (null == mData || mData.size() == 0) // 数据有问题 直接返回 return; diff --git a/CustomView/Advance/[03]Canvas_Convert.md b/CustomView/Advance/[03]Canvas_Convert.md index b462e3e2..4ad9f63f 100644 --- a/CustomView/Advance/[03]Canvas_Convert.md +++ b/CustomView/Advance/[03]Canvas_Convert.md @@ -3,24 +3,24 @@ ### 作者微博: [@GcsSloop](http://weibo.com/GcsSloop) ### [【本系列相关文章】](https://github.com/GcsSloop/AndroidNote/tree/master/CustomView/README.md) -上一篇[Canvas之绘制基本形状](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B2%5DCanvas_BasicGraphics.md)中我们了解了如何使用Canvas绘制基本图形，本次了解一些基本的画布操作。 +上一篇[Canvas之绘制基本形状](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B02%5DCanvas_BasicGraphics.md)中我们了解了如何使用Canvas绘制基本图形，本次了解一些基本的画布操作。 本来想把画布操作放到后面部分的，但是发现很多图形绘制都离不开画布操作，于是先讲解一下画布的基本操作方法。 ## 一.Canvas的常用操作速查表 -操作类型 | 相关API | 备注 ---- | --- | --- -绘制颜色 | drawColor, drawRGB, drawARGB | 使用单一颜色填充整个画布 -绘制基本形状 | drawPoint, drawPoints, drawLine, drawLines, drawRect, drawRoundRect, drawOval, drawCircle, drawArc | 依次为 点、线、矩形、圆角矩形、椭圆、圆、圆弧 -绘制图片 | drawBitmap, drawPicture | 绘制位图和图片 -绘制文本 | drawText, drawPosText, drawTextOnPath | 依次为 绘制文字、绘制文字时指定每个文字位置、根据路径绘制文字 -绘制路径 | drawPath | 绘制路径，绘制贝塞尔曲线时也需要用到该函数 -顶点操作 | drawVertices, drawBitmapMesh | 通过对顶点操作可以使图像形变，drawVertices直接对画布作用、 drawBitmapMesh只对绘制的Bitmap作用 -画布剪裁 | clipPath, clipRect | 设置画布的显示区域 -画布快照 | save, restore, saveLayerXxx, restoreToCount, getSaveCount | 依次为 保存当前状态、 回滚到上一次保存的状态、 保存图层状态、 回滚到指定状态、 获取保存次数 -画布变换 | translate, scale, rotate, skew | 依次为 位移、缩放、 旋转、错切 -Matrix(矩阵) | getMatrix, setMatrix, concat | 实际上画布的位移，缩放等操作的都是图像矩阵Matrix， 只不过Matrix比较难以理解和使用，故封装了一些常用的方法。 +| 操作类型 | 相关API | 备注 | +| ---------- | ---------------------------------------- | ---------------------------------------- | +| 绘制颜色 | drawColor, drawRGB, drawARGB | 使用单一颜色填充整个画布 | +| 绘制基本形状 | drawPoint, drawPoints, drawLine, drawLines, drawRect, drawRoundRect, drawOval, drawCircle, drawArc | 依次为 点、线、矩形、圆角矩形、椭圆、圆、圆弧 | +| 绘制图片 | drawBitmap, drawPicture | 绘制位图和图片 | +| 绘制文本 | drawText, drawPosText, drawTextOnPath | 依次为 绘制文字、绘制文字时指定每个文字位置、根据路径绘制文字 | +| 绘制路径 | drawPath | 绘制路径，绘制贝塞尔曲线时也需要用到该函数 | +| 顶点操作 | drawVertices, drawBitmapMesh | 通过对顶点操作可以使图像形变，drawVertices直接对画布作用、 drawBitmapMesh只对绘制的Bitmap作用 | +| 画布剪裁 | clipPath, clipRect | 设置画布的显示区域 | +| 画布快照 | save, restore, saveLayerXxx, restoreToCount, getSaveCount | 依次为 保存当前状态、 回滚到上一次保存的状态、 保存图层状态、 回滚到指定状态、 获取保存次数 | +| 画布变换 | translate, scale, rotate, skew | 依次为 位移、缩放、 旋转、错切 | +| Matrix(矩阵) | getMatrix, setMatrix, concat | 实际上画布的位移，缩放等操作的都是图像矩阵Matrix， 只不过Matrix比较难以理解和使用，故封装了一些常用的方法。 | ****** ## 二.Canvas基本操作 @@ -61,7 +61,7 @@ Matrix(矩阵) | getMatrix, setMatrix, concat | 实际上画布的位移，缩 canvas.drawCircle(0,0,100,mPaint); ``` - + 我们首先将坐标系移动一段距离绘制一个圆形，之后再移动一段距离绘制一个圆形，两次移动是可叠加的。 @@ -77,15 +77,15 @@ Matrix(矩阵) | getMatrix, setMatrix, concat | 实际上画布的位移，缩 缩放比例(sx,sy)取值范围详解： -取值范围(n)| 说明 ---------- | ------ -[-∞, -1) | 先根据缩放中心放大n倍，再根据中心轴进行翻转 --1 | 根据缩放中心轴进行翻转 -(-1, 0) | 先根据缩放中心缩小到n，再根据中心轴进行翻转 -0 | 不会显示，若sx为0，则宽度为0，不会显示，sy同理 -(0, 1) | 根据缩放中心缩小到n -1 | 没有变化 -(1, +∞) | 根据缩放中心放大n倍 +| 取值范围(n) | 说明 | +| ----------- | ---------------------------------------------- | +| (-∞, -1) | 先根据缩放中心放大n倍，再根据中心轴进行翻转 | +| -1 | 根据缩放中心轴进行翻转 | +| (-1, 0) | 先根据缩放中心缩小到n，再根据中心轴进行翻转 | +| 0 | 不会显示，若sx为0，则宽度为0，不会显示，sy同理 | +| (0, 1) | 根据缩放中心缩小到n | +| 1 | 没有变化 | +| (1, +∞) | 根据缩放中心放大n倍 | 如果在缩放时稍微注意一下就会发现缩放的中心默认为坐标原点,而缩放中心轴就是坐标轴，如下： @@ -105,7 +105,7 @@ Matrix(矩阵) | getMatrix, setMatrix, concat | 实际上画布的位移，缩 ``` (为了更加直观，我添加了一个坐标系，可以比较明显的看出，缩放中心就是坐标原点) - + 接下来我们使用第二种方法让缩放中心位置稍微改变一下，如下： ``` java @@ -124,7 +124,7 @@ Matrix(矩阵) | getMatrix, setMatrix, concat | 实际上画布的位移，缩 ``` (图中用箭头指示的就是缩放中心。) - + 前面两个示例缩放的数值都是正数，按照表格中的说明，**当缩放比例为负数的时候会根据缩放中心轴进行翻转**，下面我们就来实验一下： @@ -181,6 +181,9 @@ Matrix(矩阵) | getMatrix, setMatrix, concat | 实际上画布的位移，缩 调用两次缩放则 x轴实际缩放为0.5x0.5=0.25 y轴实际缩放为0.5x0.1=0.05 下面我们利用这一特性制作一个有趣的图形。 + +> 注意设置画笔模式为描边(STROKE) + ``` java // 将坐标系原点移动到画布正中心 canvas.translate(mWidth / 2, mHeight / 2); @@ -194,7 +197,7 @@ Matrix(矩阵) | getMatrix, setMatrix, concat | 实际上画布的位移，缩 } ``` - + ***** #### ⑶旋转(rotate) @@ -222,7 +225,7 @@ Matrix(矩阵) | getMatrix, setMatrix, concat | 实际上画布的位移，缩 canvas.drawRect(rect,mPaint); ``` - + 改变旋转中心位置： ``` java @@ -240,7 +243,7 @@ Matrix(矩阵) | getMatrix, setMatrix, concat | 实际上画布的位移，缩 canvas.drawRect(rect,mPaint); ``` - + 好吧，旋转也是可叠加的 ``` java @@ -262,7 +265,7 @@ Matrix(矩阵) | getMatrix, setMatrix, concat | 实际上画布的位移，缩 canvas.rotate(10); } ``` - + ***** #### ⑷错切(skew) @@ -299,7 +302,7 @@ Y = sy * x + y mPaint.setColor(Color.BLUE); // 绘制蓝色矩形 canvas.drawRect(rect,mPaint); ``` - + 如你所想，错切也是可叠加的，不过请注意，调用次序不同绘制结果也会不同 ``` java @@ -318,25 +321,25 @@ Y = sy * x + y canvas.drawRect(rect,mPaint); ``` - + ***** #### ⑸快照(save)和回滚(restore) -Q: 为什存在快照与回滚
+Q: 为什么存在快照与回滚
A：画布的操作是不可逆的，而且很多画布操作会影响后续的步骤，例如第一个例子，两个圆形都是在坐标原点绘制的，而因为坐标系的移动绘制出来的实际位置不同。所以会对画布的一些状态进行保存和回滚。 与之相关的API: -相关API | 简介 ---- | --- -save | 把当前的画布的状态进行保存，然后放入特定的栈中 -saveLayerXxx | 新建一个图层，并放入特定的栈中 -restore | 把栈中最顶层的画布状态取出来，并按照这个状态恢复当前的画布 -restoreToCount| 弹出指定位置及其以上所有的状态，并按照指定位置的状态进行恢复 -getSaveCount | 获取栈中内容的数量(即保存次数) +| 相关API | 简介 | +| -------------- | ------------------------------ | +| save | 把当前的画布的状态进行保存，然后放入特定的栈中 | +| saveLayerXxx | 新建一个图层，并放入特定的栈中 | +| restore | 把栈中最顶层的画布状态取出来，并按照这个状态恢复当前的画布 | +| restoreToCount | 弹出指定位置及其以上所有的状态，并按照指定位置的状态进行恢复 | +| getSaveCount | 获取栈中内容的数量(即保存次数) | 下面对其中的一些概念和方法进行分析： @@ -359,14 +362,14 @@ A：实际上我们看到的画布是由多个图层构成的，如下图(图片 ##### SaveFlags -数据类型 | 名称 | 简介 ---- | --- | --- -int | ALL_SAVE_FLAG | 默认，保存全部状态 -int | CLIP_SAVE_FLAG | 保存剪辑区 -int | CLIP_TO_LAYER_SAVE_FLAG | 剪裁区作为图层保存 -int | FULL_COLOR_LAYER_SAVE_FLAG | 保存图层的全部色彩通道 -int | HAS_ALPHA_LAYER_SAVE_FLAG | 保存图层的alpha(不透明度)通道 -int | MATRIX_SAVE_FLAG | 保存Matrix信息(translate, rotate, scale, skew) +| 数据类型 | 名称 | 简介 | +| ---- | -------------------------- | ---------------------------------------- | +| int | ALL_SAVE_FLAG | 默认，保存全部状态 | +| int | CLIP_SAVE_FLAG | 保存剪辑区 | +| int | CLIP_TO_LAYER_SAVE_FLAG | 剪裁区作为图层保存 | +| int | FULL_COLOR_LAYER_SAVE_FLAG | 保存图层的全部色彩通道 | +| int | HAS_ALPHA_LAYER_SAVE_FLAG | 保存图层的alpha(不透明度)通道 | +| int | MATRIX_SAVE_FLAG | 保存Matrix信息(translate, rotate, scale, skew) | ##### save save 有两种方法： @@ -440,7 +443,7 @@ public int saveLayerAlpha (float left, float top, float right, float bottom, int ## About Me ### 作者微博: @GcsSloop - + ****** ## 四.参考资料 diff --git a/CustomView/Advance/[04]Canvas_PictureText.md b/CustomView/Advance/[04]Canvas_PictureText.md index 8dc25299..06bffcd5 100644 --- a/CustomView/Advance/[04]Canvas_PictureText.md +++ b/CustomView/Advance/[04]Canvas_PictureText.md @@ -3,22 +3,22 @@ ### 作者微博: [@GcsSloop](http://weibo.com/GcsSloop) ### [【本系列相关文章】](https://github.com/GcsSloop/AndroidNote/tree/master/CustomView/README.md) -在上一篇文章[Canvas之画布操作](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B3%5DCanvas_Convert.md)中我们了解了画布的一些基本操作方法，本次了解一些绘制图片文字相关的内容。如果你对前几篇文章讲述的内容熟练掌握的话，那么恭喜你，本篇结束之后，大部分的自定义View已经难不倒你了，当然了，这并不是终点，接下来还会有更加炫酷的技能。 +在上一篇文章[Canvas之画布操作](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B03%5DCanvas_Convert.md)中我们了解了画布的一些基本操作方法，本次了解一些绘制图片文字相关的内容。如果你对前几篇文章讲述的内容熟练掌握的话，那么恭喜你，本篇结束之后，大部分的自定义View已经难不倒你了，当然了，这并不是终点，接下来还会有更加炫酷的技能。 ## 一.Canvas的常用操作速查表 -操作类型 | 相关API | 备注 ----------|---------|----------- -绘制颜色 | drawColor, drawRGB, drawARGB | 使用单一颜色填充整个画布 -绘制基本形状 | drawPoint, drawPoints, drawLine, drawLines, drawRect, drawRoundRect, drawOval, drawCircle, drawArc | 依次为 点、线、矩形、圆角矩形、椭圆、圆、圆弧 -绘制图片 | drawBitmap, drawPicture | 绘制位图和图片 -绘制文本 | drawText, drawPosText, drawTextOnPath | 依次为 绘制文字、绘制文字时指定每个文字位置、根据路径绘制文字 -绘制路径 | drawPath | 绘制路径，绘制贝塞尔曲线时也需要用到该函数 -顶点操作 | drawVertices, drawBitmapMesh | 通过对顶点操作可以使图像形变，drawVertices直接对画布作用、 drawBitmapMesh只对绘制的Bitmap作用 -画布剪裁 | clipPath, clipRect | 设置画布的显示区域 -画布快照 | save, restore, saveLayerXxx, restoreToCount, getSaveCount | 依次为 保存当前状态、 回滚到上一次保存的状态、 保存图层状态、 回滚到指定状态、 获取保存次数 -画布变换 | translate, scale, rotate, skew | 依次为 位移、缩放、 旋转、错切 -Matrix(矩阵) | getMatrix, setMatrix, concat | 实际上画布的位移，缩放等操作的都是图像矩阵Matrix， 只不过Matrix比较难以理解和使用，故封装了一些常用的方法。 +| 操作类型 | 相关API | 备注 | +| ---------- | ---------------------------------------- | ---------------------------------------- | +| 绘制颜色 | drawColor, drawRGB, drawARGB | 使用单一颜色填充整个画布 | +| 绘制基本形状 | drawPoint, drawPoints, drawLine, drawLines, drawRect, drawRoundRect, drawOval, drawCircle, drawArc | 依次为 点、线、矩形、圆角矩形、椭圆、圆、圆弧 | +| 绘制图片 | drawBitmap, drawPicture | 绘制位图和图片 | +| 绘制文本 | drawText, drawPosText, drawTextOnPath | 依次为 绘制文字、绘制文字时指定每个文字位置、根据路径绘制文字 | +| 绘制路径 | drawPath | 绘制路径，绘制贝塞尔曲线时也需要用到该函数 | +| 顶点操作 | drawVertices, drawBitmapMesh | 通过对顶点操作可以使图像形变，drawVertices直接对画布作用、 drawBitmapMesh只对绘制的Bitmap作用 | +| 画布剪裁 | clipPath, clipRect | 设置画布的显示区域 | +| 画布快照 | save, restore, saveLayerXxx, restoreToCount, getSaveCount | 依次为 保存当前状态、 回滚到上一次保存的状态、 保存图层状态、 回滚到指定状态、 获取保存次数 | +| 画布变换 | translate, scale, rotate, skew | 依次为 位移、缩放、 旋转、错切 | +| Matrix(矩阵) | getMatrix, setMatrix, concat | 实际上画布的位移，缩放等操作的都是图像矩阵Matrix， 只不过Matrix比较难以理解和使用，故封装了一些常用的方法。 | ****** # 二.Canvas基本操作详解 @@ -68,15 +68,15 @@ A Picture records drawing calls (via the canvas returned by beginRecording) and 了解了Picture的概念之后，我们再了解一下Picture的相关方法。 -相关方法 | 简介 -------------------------------------------------------------|-------------------- -public int getWidth () | 获取宽度 -public int getHeight () | 获取高度 -public Canvas beginRecording (int width, int height) | 开始录制 (返回一个Canvas，在Canvas中所有的绘制都会存储在Picture中) -public void endRecording () | 结束录制 -public void draw (Canvas canvas) | 将Picture中内容绘制到Canvas中 -public static Picture createFromStream (InputStream stream) | (已废弃)通过输入流创建一个Picture -public void writeToStream (OutputStream stream) | (已废弃)将Picture中内容写出到输出流中 +| 相关方法 | 简介 | +| ---------------------------------------- | ---------------------------------------- | +| public int getWidth () | 获取宽度 | +| public int getHeight () | 获取高度 | +| public Canvas beginRecording (int width, int height) | 开始录制 (返回一个Canvas，在Canvas中所有的绘制都会存储在Picture中) | +| public void endRecording () | 结束录制 | +| public void draw (Canvas canvas) | 将Picture中内容绘制到Canvas中 | +| public static Picture createFromStream (InputStream stream) | (已废弃)通过输入流创建一个Picture | +| public void writeToStream (OutputStream stream) | (已废弃)将Picture中内容写出到输出流中 | 上面表格中基本上已经列出了Picture的所有方法，其中getWidth和getHeight没什么好说的，最后两个已经废弃也自然就不用关注了，排除了这些方法之后，只剩三个方法了，接下来我们就比较详细的了解一下： @@ -127,19 +127,19 @@ public void writeToStream (OutputStream stream) | (已废弃)将Pict Picture虽然方法就那么几个，但是具体使用起来还是分很多情况的，由于录制的内容不会直接显示，就像存储的视频不点击播放不会自动播放一样，同样，想要将Picture中的内容显示出来就需要手动调用播放(绘制)，将Picture中的内容绘制出来可以有以下几种方法： -序号 | 简介 ------|----------- - 1 | 使用Picture提供的draw方法绘制。 - 2 | 使用Canvas提供的drawPicture方法绘制。 - 3 | 将Picture包装成为PictureDrawable，使用PictureDrawable的draw方法绘制。 +| 序号 | 简介 | +| ---- | ---------------------------------------- | +| 1 | 使用Picture提供的draw方法绘制。 | +| 2 | 使用Canvas提供的drawPicture方法绘制。 | +| 3 | 将Picture包装成为PictureDrawable，使用PictureDrawable的draw方法绘制。 | 以上几种方法主要区别： -主要区别 | 分类 | 简介 --------------------|-----------------------------------|------------------ -是否对Canvas有影响 | 1有影响
2,3不影响 | 此处指绘制完成后是否会影响Canvas的状态(Matrix clip等) -可操作性强弱 | 1可操作性较弱
2,3可操作性较强 | 此处的可操作性可以简单理解为对绘制结果可控程度。 +| 主要区别 | 分类 | 简介 | +| ------------ | --------------------- | ------------------------------------ | +| 是否对Canvas有影响 | 1有影响
2,3不影响 | 此处指绘制完成后是否会影响Canvas的状态(Matrix clip等) | +| 可操作性强弱 | 1可操作性较弱
2,3可操作性较强 | 此处的可操作性可以简单理解为对绘制结果可控程度。 | 几种方法简介和主要区别基本就这么多了，接下来对于各种使用方法一一详细介绍： @@ -170,9 +170,9 @@ public void drawPicture (Picture picture, RectF dst) ``` java canvas.drawPicture(mPicture,new RectF(0,0,mPicture.getWidth(),200)); ``` - + - + **PS:对照上一张图片，可以比较明显的看出，绘制的内容根据选区进行了缩放。 ** **3.将Picture包装成为PictureDrawable，使用PictureDrawable的draw方法绘制。** @@ -197,15 +197,15 @@ public void drawPicture (Picture picture, RectF dst) > 其实一开始知道要讲Bitmap我是拒绝的，为什么呢？因为Bitmap就是很多问题的根源啊有木有，Bitmap可能导致内存不足，内存泄露，ListView中的复用混乱等诸多问题。想完美的掌控Bitmap还真不是一件容易的事情。限于篇幅**本文对于Bitmap不会过多的展开，只讲解一些常用的功能**，关于Bitmap详细内容，以后开专题讲解QAQ。 既然要绘制Bitmap，就要先获取一个Bitmap，那么如何获取呢？ - + **获取Bitmap方式:** - - 序号 | 获取方式 | 备注 - -----|---------------------------|----------------------------------------- - 1 | 通过Bitmap创建 | 复制一个已有的Bitmap(_新Bitmap状态和原有的一致_) 或者 创建一个空白的Bitmap(_内容可改变_) - 2 | 通过BitmapDrawable获取 | 从资源文件 内存卡 网络等地方获取一张图片并转换为内容不可变的Bitmap - 3 | 通过BitmapFactory获取 | 从资源文件 内存卡 网络等地方获取一张图片并转换为内容不可变的Bitmap - + +| 序号 | 获取方式 | 备注 | +| ---- | ------------------ | ---------------------------------------- | +| 1 | 通过Bitmap创建 | 复制一个已有的Bitmap(_新Bitmap状态和原有的一致_) 或者 创建一个空白的Bitmap(_内容可改变_) | +| 2 | 通过BitmapDrawable获取 | 从资源文件 内存卡 网络等地方获取一张图片并转换为内容不可变的Bitmap | +| 3 | 通过BitmapFactory获取 | 从资源文件 内存卡 网络等地方获取一张图片并转换为内容不可变的Bitmap | + **通常来说，我们绘制Bitmap都是读取已有的图片转换为Bitmap绘制到Canvas上。**
很明显，第1种方式不能满足我们的要求，暂时排除。
第2种方式虽然也可满足我们的要求，但是我不推荐使用这种方式，至于为什么在后续详细讲解Drawable的时候会说明,暂时排除。
@@ -282,10 +282,10 @@ PS:图片左上角位置默认为坐标原点。 第三种方法比较有意思，上面多了两个矩形区域(src,dst),这两个矩形选区是干什么用的？ -名称 | 作用 ---------------------------|--------------------- -Rect src | 指定绘制图片的区域 -Rect dst 或RectF dst | 指定图片在屏幕上显示(绘制)的区域 +| 名称 | 作用 | +| ------------------- | ----------------- | +| Rect src | 指定绘制图片的区域 | +| Rect dst 或RectF dst | 指定图片在屏幕上显示(绘制)的区域 | 示例： ``` java @@ -362,7 +362,7 @@ Rect dst 或RectF dst | 指定图片在屏幕上显示(绘制)的区域 绘制文字部分大致可以分为三类： -第一类只能指定文本基线位置位置(基线x默认在字符串左侧，基线y默认在字符串下方)。
+第一类只能指定文本基线位置(基线x默认在字符串左侧，基线y默认在字符串下方)。
第二类可以分别指定每个文字的位置。
第三类是指定一个路径，根据路径绘制文字。
@@ -372,14 +372,14 @@ Rect dst 或RectF dst | 指定图片在屏幕上显示(绘制)的区域 **Paint文本相关常用方法表** -标题 | 相关方法 | 备注 ------|---------------------------|---------------------- -色彩 | setColor setARGB setAlpha | 设置颜色，透明度 -大小 | setTextSize | 设置文本字体大小 -字体 | setTypeface | 设置或清除字体样式 -样式 | setStyle | 填充(FILL),描边(STROKE),填充加描边(FILL_AND_STROKE) -对齐 | setTextAlign | 左对齐(LEFT),居中对齐(CENTER),右对齐(RIGHT) -测量 | measureText | 测量文本大小(注意，请在设置完文本各项参数后调用) +| 标题 | 相关方法 | 备注 | +| ---- | ------------------------- | ---------------------------------------- | +| 色彩 | setColor setARGB setAlpha | 设置颜色，透明度 | +| 大小 | setTextSize | 设置文本字体大小 | +| 字体 | setTypeface | 设置或清除字体样式 | +| 样式 | setStyle | 填充(FILL),描边(STROKE),填充加描边(FILL_AND_STROKE) | +| 对齐 | setTextAlign | 左对齐(LEFT),居中对齐(CENTER),右对齐(RIGHT) | +| 测量 | measureText | 测量文本大小(注意，请在设置完文本各项参数后调用) | 为了绘制文本，我们先创建一个文本画笔： ``` java @@ -411,13 +411,13 @@ Rect dst 或RectF dst | 指定图片在屏幕上显示(绘制)的区域 以上一个例子使用的字符串为例，它的下标是这样的(wait，我为啥要说这个，算了，不管了，就这样吧(๑•́ ₃ •̀๑)): -字符 | A | B | C | D | E | F | G | H | I | J | K - ---|---|---|---|---|---|---|---|---|---|---|--- -下标 | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 +| 字符 | A | B | C | D | E | F | G | H | I | J | K | +| ---- | ---- | ---- | ---- | ---- | ---- | ---- | ---- | ---- | ---- | ---- | ---- | +| 下标 | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | -假设我我们指定star为1，end为3，那么最终截取的字符串就是"BC"。 +假设我们指定start为1，end为3，那么最终截取的字符串就是"BC"。 -一般来说，**使用start和end指定的区间是前闭后开的，即包含start指定的下标，而不包含end指定的下标**，故[1,3)最后获取到的下标只有 下标1 和 下标2 的字符，就是"BC". +一般来说，**使用start和end指定的区间是前闭后开的，即包含start指定的下标，而不包含end指定的下标**，故[1,3)最后获取到的下标只有 下标1 和 下标2 的字符，就是"BC"。 示例： ``` java @@ -430,7 +430,7 @@ Rect dst 或RectF dst | 指定图片在屏幕上显示(绘制)的区域 另外，对于字符数组char[]我们截取字符串使用起始位置(index)和长度(count)来确定。 -同样，我们指定index为1，count为3，那么最终截取到的字符串是"BCD". +同样，我们指定index为1，count为3，那么最终截取到的字符串是"BCD"。 其实就是从下标位置为1处向后数3位就是截取到的字符串，示例： ``` java @@ -465,11 +465,11 @@ Rect dst 或RectF dst | 指定图片在屏幕上显示(绘制)的区域 不过嘛，虽然虽然这个方法也比较容易理解，但是关于这个方法我个人是不推荐使用的，因为坑比较多，主要有一下几点： -序号 | 反对理由 ------|---------------------- - 1 | 必须指定所有字符位置，否则直接crash掉，反人类设计 - 2 | 性能不佳，在大量使用的时候可能导致卡顿 - 3 | 不支持emoji等特殊字符，不支持字形组合与分解 +| 序号 | 反对理由 | +| ---- | --------------------------- | +| 1 | 必须指定所有字符位置，否则直接crash掉，反人类设计 | +| 2 | 性能不佳，在大量使用的时候可能导致卡顿 | +| 3 | 不支持emoji等特殊字符，不支持字形组合与分解 | 关于第二类的第二种方法： diff --git a/CustomView/Advance/[05]Path_Basic.md b/CustomView/Advance/[05]Path_Basic.md index d3641a42..58e9c2d2 100644 --- a/CustomView/Advance/[05]Path_Basic.md +++ b/CustomView/Advance/[05]Path_Basic.md @@ -4,39 +4,39 @@ ### [【本系列相关文章】](https://github.com/GcsSloop/AndroidNote/tree/master/CustomView/README.md) -在上一篇[Canvas之图片文字](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B4%5DCanvas_PictureText.md)中我们了解了如何使用Canvas中绘制图片文字，结合前几篇文章，Canvas的基本操作已经差不多完结了，然而Canvas不仅仅具有这些基本的操作，还可以更加炫酷，本次会了解到path(路径)这个Canvas中的神器，有了这个神器，就能创造出更多**炫(zhuang)酷(B)**的东东了。 +在上一篇[Canvas之图片文字](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B04%5DCanvas_PictureText.md)中我们了解了如何使用Canvas中绘制图片文字，结合前几篇文章，Canvas的基本操作已经差不多完结了，然而Canvas不仅仅具有这些基本的操作，还可以更加炫酷，本次会了解到path(路径)这个Canvas中的神器，有了这个神器，就能创造出更多**炫(zhuang)酷(B)**的东东了。 ****** # 一.Path常用方法表 > 为了兼容性(_偷懒_) 本表格中去除了部分API21(即安卓版本5.0)以上才添加的方法。 -作用 | 相关方法 | 备注 -----------------|-----------------|------------------------------------------ -移动起点 | moveTo | 移动下一次操作的起点位置 -设置终点 | setLastPoint | 重置当前path中最后一个点位置，如果在绘制之前调用，效果和moveTo相同 -连接直线 | lineTo | 添加上一个点到当前点之间的直线到Path -闭合路径 | close | 连接第一个点连接到最后一个点，形成一个闭合区域 -添加内容 | addRect, addRoundRect, addOval, addCircle, addPath, addArc, arcTo | 添加(矩形， 圆角矩形， 椭圆， 圆， 路径， 圆弧) 到当前Path (注意addArc和arcTo的区别) -是否为空 | isEmpty | 判断Path是否为空 -是否为矩形 | isRect | 判断path是否是一个矩形 -替换路径 | set | 用新的路径替换到当前路径所有内容 -偏移路径 | offset | 对当前路径之前的操作进行偏移(不会影响之后的操作) -贝塞尔曲线 | quadTo, cubicTo | 分别为二次和三次贝塞尔曲线的方法 -rXxx方法 | rMoveTo, rLineTo, rQuadTo, rCubicTo | **不带r的方法是基于原点的坐标系(偏移量)， rXxx方法是基于当前点坐标系(偏移量)** -填充模式 | setFillType, getFillType, isInverseFillType, toggleInverseFillType | 设置,获取,判断和切换填充模式 -提示方法 | incReserve | 提示Path还有多少个点等待加入**(这个方法貌似会让Path优化存储结构)** -布尔操作(API19) | op | 对两个Path进行布尔运算(即取交集、并集等操作) -计算边界 | computeBounds | 计算Path的边界 -重置路径 | reset, rewind | 清除Path中的内容
**reset不保留内部数据结构，但会保留FillType.**
**rewind会保留内部的数据结构，但不保留FillType** -矩阵操作 | transform | 矩阵变换 +| 作用 | 相关方法 | 备注 | +| ----------- | ---------------------------------------- | ---------------------------------------- | +| 移动起点 | moveTo | 移动下一次操作的起点位置 | +| 设置终点 | setLastPoint | 重置当前path中最后一个点位置，如果在绘制之前调用，效果和moveTo相同 | +| 连接直线 | lineTo | 添加上一个点到当前点之间的直线到Path | +| 闭合路径 | close | 连接第一个点连接到最后一个点，形成一个闭合区域 | +| 添加内容 | addRect, addRoundRect, addOval, addCircle, addPath, addArc, arcTo | 添加(矩形， 圆角矩形， 椭圆， 圆， 路径， 圆弧) 到当前Path (注意addArc和arcTo的区别) | +| 是否为空 | isEmpty | 判断Path是否为空 | +| 是否为矩形 | isRect | 判断path是否是一个矩形 | +| 替换路径 | set | 用新的路径替换到当前路径所有内容 | +| 偏移路径 | offset | 对当前路径之前的操作进行偏移(不会影响之后的操作) | +| 贝塞尔曲线 | quadTo, cubicTo | 分别为二次和三次贝塞尔曲线的方法 | +| rXxx方法 | rMoveTo, rLineTo, rQuadTo, rCubicTo | **不带r的方法是基于原点的坐标系(偏移量)， rXxx方法是基于当前点坐标系(偏移量)** | +| 填充模式 | setFillType, getFillType, isInverseFillType, toggleInverseFillType | 设置,获取,判断和切换填充模式 | +| 提示方法 | incReserve | 提示Path还有多少个点等待加入**(这个方法貌似会让Path优化存储结构)** | +| 布尔操作(API19) | op | 对两个Path进行布尔运算(即取交集、并集等操作) | +| 计算边界 | computeBounds | 计算Path的边界 | +| 重置路径 | reset, rewind | 清除Path中的内容
**reset不保留内部数据结构，但会保留FillType.**
**rewind会保留内部的数据结构，但不保留FillType** | +| 矩阵操作 | transform | 矩阵变换 | # 二.Path详解 **请关闭硬件加速，以免引起不必要的问题！
请关闭硬件加速，以免引起不必要的问题！
请关闭硬件加速，以免引起不必要的问题！** -**在AndroidMenifest文件中application节点下添上 android:hardwareAccelerated="false"以关闭整个应用的硬件加速。
更多请参考这里：[Android的硬件加速及可能导致的问题](https://github.com/GcsSloop/AndroidNote/issues/7)** +**在AndroidMainfest文件中application节点下添上 android:hardwareAccelerated="false"以关闭整个应用的硬件加速。
更多请参考这里：[Android的硬件加速及可能导致的问题](https://github.com/GcsSloop/AndroidNote/issues/7)** ## Path作用 本次特地开了一篇详细讲解Path，为什么要单独摘出来呢，这是因为Path在2D绘图中是一个很重要的东西。 @@ -55,16 +55,16 @@ _The Path class encapsulates compound (multiple contour) geometric paths consist **通俗解释(sloop个人版)：** -**Path是封装了由直线和曲线(二次，三次贝塞尔曲线)构成的几何路径。你能用Canvas中的drawPath来把这条路径画出来(同样支持Paint的不同绘制模式)，也可以用于剪裁画布和根据路径绘制文字。我们有时会用Path来描述一个图像的轮廓，所以也会称为轮廓线(轮廓线仅是Path的一种使用方法，两者并不等价)** +**Path封装了由直线和曲线(二次，三次贝塞尔曲线)构成的几何路径。你能用Canvas中的drawPath来把这条路径画出来(同样支持Paint的不同绘制模式)，也可以用于剪裁画布和根据路径绘制文字。我们有时会用Path来描述一个图像的轮廓，所以也会称为轮廓线(轮廓线仅是Path的一种使用方法，两者并不等价)** 另外路径有开放和封闭的区别。 - -图像 | 名称 | 备注 - --- | --- | --- - ![](http://ww4.sinaimg.cn/thumbnail/005Xtdi2jw1f0zx9g9gggj30f00aiwek.jpg) | 封闭路径 | 首尾相接形成了一个封闭区域 - ![](http://ww1.sinaimg.cn/thumbnail/005Xtdi2jw1f0zxg8ilpxj30f00aimx8.jpg) | 开放路径 | 没有首位相接形成封闭区域 - + +| 图像 | 名称 | 备注 | +| ------------------------------------------------------------ | -------- | -------------------------- | +| ![](http://ww4.sinaimg.cn/thumbnail/005Xtdi2jw1f0zx9g9gggj30f00aiwek.jpg) | 封闭路径 | 首尾相接形成了一个封闭区域 | +| ![](http://ww1.sinaimg.cn/thumbnail/005Xtdi2jw1f0zxg8ilpxj30f00aimx8.jpg) | 开放路径 | 没有首尾相接形成封闭区域 | + > 这个是我随便画的，仅为展示一下区别，请无视我灵魂画师一般的绘图水准。 **与Path相关的还有一些比较神奇的概念，不过暂且不说，等接下来需要用到的时候再详细说明。** @@ -76,18 +76,18 @@ _The Path class encapsulates compound (multiple contour) geometric paths consist ![](http://ww3.sinaimg.cn/large/005Xtdi2jw1f19mncfcirj305i02j744.jpg) ### 第1组: moveTo、 setLastPoint、 lineTo 和 close - + 由于Path的有些知识点无法单独来讲，所以本次采取了一次讲一组方法。 - + 按照惯例，先创建画笔： - + ``` java Paint mPaint = new Paint(); // 创建画笔 mPaint.setColor(Color.BLACK); // 画笔颜色 - 黑色 mPaint.setStyle(Paint.Style.STROKE); // 填充模式 - 描边 mPaint.setStrokeWidth(10); // 边框宽度 - 10 ``` - + #### lineTo： 方法预览： ``` @@ -95,9 +95,9 @@ public void lineTo (float x, float y) ``` 首先讲解的的LineTo，为啥先讲解这个呢？ - + 是因为moveTo、 setLastPoint、 close都无法直接看到效果，借助有具现化效果的lineTo才能让这些方法现出原形。 - + lineTo很简单，只有一个方法，作用也很容易理解，line嘛，顾名思义就是一条线。 @@ -143,10 +143,10 @@ lineTo很简单，只有一个方法，作用也很容易理解，line嘛，顾 这两个方法虽然在作用上有相似之处，但实际上却是完全不同的两个东东，具体参照下表： -方法名 | 简介 | 是否影响之前的操作 | 是否影响之后操作 ---- | --- | --- | --- -moveTo | 移动下一次操作的起点位置 | 否 | 是 -setLastPoint | 设置之前操作的最后一个点位置 | 是 | 是 +| 方法名 | 简介 | 是否影响之前的操作 | 是否影响之后操作 | +| ------------ | -------------- | --------- | -------- | +| moveTo | 移动下一次操作的起点位置 | 否 | 是 | +| setLastPoint | 设置之前操作的最后一个点位置 | 是 | 是 | 废话不多说，直接上代码： ``` java @@ -213,9 +213,9 @@ close方法用于连接当前最后一个点和最初的一个点(如果两个 ``` -很明显，两个lineTo分别代表第1和第2条线，而close在此处的作用就算连接了B(200,0)点和圆的O之间的第3条线，使之形成一个封闭的图形。 +很明显，两个lineTo分别代表第1和第2条线，而close在此处的作用就算连接了B(200,0)点和原点O之间的第3条线，使之形成一个封闭的图形。 -**注意：close的作用是封闭路径，与当前最后一个点和第一个点并不等价。如果连接了最后一个点和第一个点仍然无法形成封闭图形，则close什么 也不做。** +**注意：close的作用是封闭路径，与连接当前最后一个点和第一个点并不等价。如果连接了最后一个点和第一个点仍然无法形成封闭图形，则close什么 也不做。** ### 第2组: addXxx与arcTo @@ -239,23 +239,23 @@ close方法用于连接当前最后一个点和最初的一个点(如果两个 **这一类就是在path中添加一个基本形状，基本形状部分和前面所讲的绘制基本形状并无太大差别，详情参考[Canvas(1)颜色与基本形状](https://github.com/GcsSloop/AndroidNote/blob/master/%E9%97%AE%E9%A2%98/Canvas/Canvas(1).md), 本次只将其中不同的部分摘出来详细讲解一下。** -**仔细观察一下第一类是方法，无一例外，在最后都有一个_Path.Direction_，这是一个什么神奇的东东？** +**仔细观察一下第一类的方法，无一例外，在最后都有一个_Path.Direction_，这是一个什么神奇的东东？** Direction的意思是 方向，趋势。 点进去看一下会发现Direction是一个枚举(Enum)类型，里面只有两个枚举常量，如下： -类型 | 解释 | 翻译 ------|-------------------|------- -CW | clockwise | 顺时针 -CCW | counter-clockwise | 逆时针 +| 类型 | 解释 | 翻译 | +| ---- | ----------------- | ---- | +| CW | clockwise | 顺时针 | +| CCW | counter-clockwise | 逆时针 | > **瞬间懵逼，我只是想添加一个基本的形状啊，搞什么顺时针和逆时针, (╯‵□′)╯︵┻━┻** **稍安勿躁，┬─┬ ノ( ' - 'ノ) {摆好摆好） 既然存在肯定是有用的，先偷偷剧透一下这个顺时针和逆时针的作用。** -序号 | 作用 ------|--------------------------------------------------- - 1 | 在添加图形时确定闭合顺序(各个点的记录顺序) - 2 | 对图形的渲染结果有影响(是判断图形渲染的重要条件) +| 序号 | 作用 | +| ---- | ------------------------- | +| 1 | 在添加图形时确定闭合顺序(各个点的记录顺序) | +| 2 | 对图形的渲染结果有影响(是判断图形渲染的重要条件) | 这个先剧透这么多，至于对闭合顺序有啥影响，自相交图形的渲染等问题等请慢慢看下去 @@ -275,7 +275,7 @@ CCW | counter-clockwise | 逆时针 **将上面代码的CW改为CCW再运行一次。接下来就是见证奇迹的时刻，两次运行结果一模一样，有木有很神奇！** > **(╯°Д°)╯︵ ┻━┻(再TM掀一次) -坑人也不带这样的啊，一毛一样要它干嘛。** +> 坑人也不带这样的啊，一毛一样要它干嘛。** **其实啊，这个东东是自带隐身技能的，想要让它现出原形，就要用到咱们刚刚学到的setLastPoint(重置当前最后一个点的位置)。** @@ -369,7 +369,7 @@ CCW | counter-clockwise | 逆时针 -首先我们新建地方两个Path(矩形和圆形)中心都是坐标原点，我们在将包含圆形的path添加到包含矩形的path之前将其进行移动了一段距离，最终绘制出来的效果就如上面所示。 +首先我们新建的两个Path(矩形和圆形)中心都是坐标原点，我们在将包含圆形的path添加到包含矩形的path之前将其进行移动了一段距离，最终绘制出来的效果就如上面所示。 #### 第三类(addArc与arcTo) 方法预览： @@ -384,10 +384,10 @@ CCW | counter-clockwise | 逆时针 从名字就可以看出，这两个方法都是与圆弧相关的，作用都是添加一个圆弧到path中，但既然存在两个方法，两者之间肯定是有区别的： -名称 | 作用 | 区别 - --- | --- | --- - addArc | 添加一个圆弧到path | 直接添加一个圆弧到path中 - arcTo | 添加一个圆弧到path | 添加一个圆弧到path，如果圆弧的起点和上次最后一个坐标点不相同，就连接两个点 +| 名称 | 作用 | 区别 | +| ------ | ----------- | --------------------------------------- | +| addArc | 添加一个圆弧到path | 直接添加一个圆弧到path中 | +| arcTo | 添加一个圆弧到path | 添加一个圆弧到path，如果圆弧的起点和上次最后一个坐标点不相同，就连接两个点 | 可以看到addArc有1个方法(_实际上是两个的，但另一个重载方法是API21添加的_), 而arcTo有2个方法，其中一个最后多了一个布尔类型的变量forceMoveTo。 @@ -395,10 +395,10 @@ CCW | counter-clockwise | 逆时针 这个变量意思为“是否强制使用moveTo”，也就是说，是否使用moveTo将变量移动到圆弧的起点位移，也就意味着： -forceMoveTo | 含义 | 等价方法 - --- | --- | --- - true | 将最后一个点移动到圆弧起点，即不连接最后一个点与圆弧起点 | public void addArc (RectF oval, float startAngle, float sweepAngle) - false | 不移动，而是连接最后一个点与圆弧起点 | public void arcTo (RectF oval, float startAngle, float sweepAngle) +| forceMoveTo | 含义 | 等价方法 | +| ----------- | ---------------------------- | ---------------------------------------- | +| true | 将最后一个点移动到圆弧起点，即不连接最后一个点与圆弧起点 | public void addArc (RectF oval, float startAngle, float sweepAngle) | +| false | 不移动，而是连接最后一个点与圆弧起点 | public void arcTo (RectF oval, float startAngle, float sweepAngle) | **示例(addArc)：** ``` java @@ -524,12 +524,12 @@ log 输出结果: **但是第二个方法最后怎么会有一个path作为参数？** -其实第二个方法中最后的参数das是存储平移后的path的。 +其实第二个方法中最后的参数dst是存储平移后的path的。 -dst状态 | 效果 - --------------|--------------------------------- - dst不为空 | 将当前path平移后的状态存入dst中，不会影响当前path - dat为空(null) | 平移将作用于当前path，相当于第一种方法 +| dst状态 | 效果 | +| ----------- | ------------------------------ | +| dst不为空 | 将当前path平移后的状态存入dst中，不会影响当前path | +| dst为空(null) | 平移将作用于当前path，相当于第一种方法 | 示例： ``` java diff --git a/CustomView/Advance/[06]Path_Bezier.md b/CustomView/Advance/[06]Path_Bezier.md index 26f38ea8..e98db733 100644 --- a/CustomView/Advance/[06]Path_Bezier.md +++ b/CustomView/Advance/[06]Path_Bezier.md @@ -3,33 +3,32 @@ ### 作者微博: [@GcsSloop](http://weibo.com/GcsSloop) ### [【本系列相关文章】](https://github.com/GcsSloop/AndroidNote/tree/master/CustomView/README.md) -在上一篇文章[Path之基本图形](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B5%5DPath_BasicGraphics.md)中我们了解了Path的基本使用方法，本次了解Path中非常非常非常重要的内容-贝塞尔曲线。 - +在上一篇文章[Path之基本图形](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B05%5DPath_Basic.md)中我们了解了Path的基本使用方法，本次了解Path中非常非常非常重要的内容-贝塞尔曲线。 ****** ## 一.Path常用方法表 > 为了兼容性(_偷懒_) 本表格中去除了在API21(即安卓版本5.0)以上才添加的方法。忍不住吐槽一下，为啥看起来有些顺手就能写的重载方法要等到API21才添加上啊。宝宝此刻内心也是崩溃的。 -作用 | 相关方法 | 备注 -----------------|-----------------|------------------------------------------ -移动起点 | moveTo | 移动下一次操作的起点位置 -设置终点 | setLastPoint | 重置当前path中最后一个点位置，如果在绘制之前调用，效果和moveTo相同 -连接直线 | lineTo | 添加上一个点到当前点之间的直线到Path -闭合路径 | close | 连接第一个点连接到最后一个点，形成一个闭合区域 -添加内容 | addRect, addRoundRect, addOval, addCircle, addPath, addArc, arcTo | 添加(矩形， 圆角矩形， 椭圆， 圆， 路径， 圆弧) 到当前Path (注意addArc和arcTo的区别) -是否为空 | isEmpty | 判断Path是否为空 -是否为矩形 | isRect | 判断path是否是一个矩形 -替换路径 | set | 用新的路径替换到当前路径所有内容 -偏移路径 | offset | 对当前路径之前的操作进行偏移(不会影响之后的操作) -贝塞尔曲线 | quadTo, cubicTo | 分别为二次和三次贝塞尔曲线的方法 -rXxx方法 | rMoveTo, rLineTo, rQuadTo, rCubicTo | **不带r的方法是基于原点的坐标系(偏移量)， rXxx方法是基于当前点坐标系(偏移量)** -填充模式 | setFillType, getFillType, isInverseFillType, toggleInverseFillType | 设置,获取,判断和切换填充模式 -提示方法 | incReserve | 提示Path还有多少个点等待加入**(这个方法貌似会让Path优化存储结构)** -布尔操作(API19) | op | 对两个Path进行布尔运算(即取交集、并集等操作) -计算边界 | computeBounds | 计算Path的边界 -重置路径 | reset, rewind | 清除Path中的内容
**reset不保留内部数据结构，但会保留FillType.**
**rewind会保留内部的数据结构，但不保留FillType** -矩阵操作 | transform | 矩阵变换 +| 作用 | 相关方法 | 备注 | +| ----------- | ---------------------------------------- | ---------------------------------------- | +| 移动起点 | moveTo | 移动下一次操作的起点位置 | +| 设置终点 | setLastPoint | 重置当前path中最后一个点位置，如果在绘制之前调用，效果和moveTo相同 | +| 连接直线 | lineTo | 添加上一个点到当前点之间的直线到Path | +| 闭合路径 | close | 连接第一个点连接到最后一个点，形成一个闭合区域 | +| 添加内容 | addRect, addRoundRect, addOval, addCircle, addPath, addArc, arcTo | 添加(矩形， 圆角矩形， 椭圆， 圆， 路径， 圆弧) 到当前Path (注意addArc和arcTo的区别) | +| 是否为空 | isEmpty | 判断Path是否为空 | +| 是否为矩形 | isRect | 判断path是否是一个矩形 | +| 替换路径 | set | 用新的路径替换到当前路径所有内容 | +| 偏移路径 | offset | 对当前路径之前的操作进行偏移(不会影响之后的操作) | +| 贝塞尔曲线 | quadTo, cubicTo | 分别为二次和三次贝塞尔曲线的方法 | +| rXxx方法 | rMoveTo, rLineTo, rQuadTo, rCubicTo | **不带r的方法是基于原点的坐标系(偏移量)， rXxx方法是基于当前点坐标系(偏移量)** | +| 填充模式 | setFillType, getFillType, isInverseFillType, toggleInverseFillType | 设置,获取,判断和切换填充模式 | +| 提示方法 | incReserve | 提示Path还有多少个点等待加入**(这个方法貌似会让Path优化存储结构)** | +| 布尔操作(API19) | op | 对两个Path进行布尔运算(即取交集、并集等操作) | +| 计算边界 | computeBounds | 计算Path的边界 | +| 重置路径 | reset, rewind | 清除Path中的内容
**reset不保留内部数据结构，但会保留FillType.**
**rewind会保留内部的数据结构，但不保留FillType** | +| 矩阵操作 | transform | 矩阵变换 | ## 二.Path详解 @@ -64,14 +63,14 @@ rXxx方法 | rMoveTo, rLineTo, rQuadTo, rCubicTo | **不带r的方法是 以上几种类型中比较有用的就是基础型和实战型，但两者各有不足，本文会综合两者内容，从零开始学习贝塞尔曲线。 ### 第一步.理解贝塞尔曲线的原理 - + 此处理解贝塞尔曲线并非是学会公式的推导过程(不是推倒(ﾉ*･ω･)ﾉ)，而是要了解贝塞尔曲线是如何生成的。 贝塞尔曲线是用一系列点来控制曲线状态的，我将这些点简单分为两类： - 类型 | 作用 --------|------ -数据点 | 确定曲线的起始和结束位置 -控制点 | 确定曲线的弯曲程度 +| 类型 | 作用 | +| ---- | ------------ | +| 数据点 | 确定曲线的起始和结束位置 | +| 控制点 | 确定曲线的弯曲程度 | > 此处暂时仅作了解概念，接下来就会讲解其中详细的含义。 @@ -101,7 +100,7 @@ rXxx方法 | rMoveTo, rLineTo, rQuadTo, rCubicTo | **不带r的方法是 ![](http://ww2.sinaimg.cn/large/005Xtdi2jw1f361oje6h1j308c0dwdg0.jpg) - + 连接DE，取点F，使得: @@ -123,7 +122,7 @@ rXxx方法 | rMoveTo, rLineTo, rQuadTo, rCubicTo | **不带r的方法是 > **PS: 三阶曲线对应的方法是cubicTo** -#### [贝塞尔曲线速查表](https://github.com/GcsSloop/AndroidNote/blob/master/QuickChart/Bessel.md) +#### [贝塞尔曲线速查表](https://github.com/GcsSloop/AndroidNote/blob/master/QuickChart/Bezier.md) #### 强烈推荐[点击这里](http://bezier.method.ac/)练习贝塞尔曲线，可以加深对贝塞尔曲线的理解程度。 @@ -131,7 +130,7 @@ rXxx方法 | rMoveTo, rLineTo, rQuadTo, rCubicTo | **不带r的方法是 #### 一阶曲线： -一阶曲线是一条线段，非常简单，可以参见上一篇文章[Path之基本操作](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B5%5DPath_Basic.md)，此处就不详细讲解了。 +一阶曲线是一条线段，非常简单，可以参见上一篇文章[Path之基本操作](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/5%5DPath_Basic.md)，此处就不详细讲解了。 #### 二阶曲线： @@ -331,10 +330,10 @@ public class Bezier2 extends View { #### 降阶与升阶 -类型 | 释义 | 变化 ------|---|--- -降阶 | 在保持曲线形状与方向不变的情况下，减少控制点数量，即降低曲线阶数 | 方法变得简单，数据点变多，控制点可能减少，灵活性变弱 -升阶 | 在保持曲线形状与方向不变的情况下，增加控制点数量，即升高曲线阶数 | 方法更加复杂，数据点不变，控制点增加，灵活性变强 +| 类型 | 释义 | 变化 | +| ---- | -------------------------------- | -------------------------- | +| 降阶 | 在保持曲线形状与方向不变的情况下，减少控制点数量，即降低曲线阶数 | 方法变得简单，数据点变多，控制点可能减少，灵活性变弱 | +| 升阶 | 在保持曲线形状与方向不变的情况下，增加控制点数量，即升高曲线阶数 | 方法更加复杂，数据点不变，控制点增加，灵活性变强 | ### 第三步.贝塞尔曲线使用实例 @@ -342,12 +341,12 @@ public class Bezier2 extends View { > 需要绘制不规则图形时？ 当然不是！目前来说，我觉得使用贝塞尔曲线主要有以下几个方面(仅个人拙见，可能存在错误，欢迎指正) -序号 | 内容 | 用例 ------|-----------------------------------------------|--------- - 1 | 事先不知道曲线状态，需要实时计算时 | 天气预报气温变化的平滑折线图 - 2 | 显示状态会根据用户操作改变时 | QQ小红点，仿真翻书效果 - 3 | 一些比较复杂的运动状态(配合PathMeasure使用) | 复杂运动状态的动画效果 - +| 序号 | 内容 | 用例 | +| ---- | ---------------------------- | -------------- | +| 1 | 事先不知道曲线状态，需要实时计算时 | 天气预报气温变化的平滑折线图 | +| 2 | 显示状态会根据用户操作改变时 | QQ小红点，仿真翻书效果 | +| 3 | 一些比较复杂的运动状态(配合PathMeasure使用) | 复杂运动状态的动画效果 | + 至于只需要一个静态的曲线图形的情况，用图片岂不是更好，大量的计算会很不划算。 如果是显示SVG矢量图的话，已经有相关的解析工具了(内部依旧运用的有贝塞尔曲线)，不需要手动计算。 @@ -375,15 +374,15 @@ public class Bezier2 extends View { #### 核心难点： ##### 1.如何得到数据点和控制点的位置？ - + 关于使用绘制圆形的数据点与控制点早就已经有人详细的计算好了，可以参考stackoverflow的一个回答[How to create circle with Bézier curves?](http://stackoverflow.com/questions/1734745/how-to-create-circle-with-b%C3%A9zier-curves)其中的数据只需要拿来用即可。 - + 而对于心形的数据点和控制点，可以由圆形的部分数据点和控制点平移后得到，具体参数可以自己慢慢调整到一个满意的效果。 - + ##### 2.如何达到渐变效果？ - + 渐变其实就是每次对数据点和控制点稍微移动一点，然后重绘界面，在短时间多次的调整数据点与控制点，使其逐渐接近目标值，通过不断的重绘界面达到一种渐变的效果。过程可以参照下图动态效果： - + ![](http://ww2.sinaimg.cn/large/005Xtdi2jw1f3ch74ewiig308c0e8wic.gif) #### 代码： diff --git a/CustomView/Advance/[07]Path_Over.md b/CustomView/Advance/[07]Path_Over.md index be9818bc..dad580ce 100644 --- a/CustomView/Advance/[07]Path_Over.md +++ b/CustomView/Advance/[07]Path_Over.md @@ -3,32 +3,32 @@ ### 作者微博: [@GcsSloop](http://weibo.com/GcsSloop) ### [【本系列相关文章】](https://github.com/GcsSloop/AndroidNote/tree/master/CustomView/README.md) -经历过前两篇 [Path之基本操作](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B5%5DPath_Basic.md) 和 [Path之贝塞尔曲线](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B6%5DPath_Bezier.md) 的讲解，本篇终于进入Path的收尾篇，本篇结束后Path的大部分相关方法都已经讲解完了，但Path还有一些更有意思的玩法，应该会在后续的文章中出现吧，嗯，应该会的ˊ_>ˋ +经历过前两篇 [Path之基本操作](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B05%5DPath_Basic.md) 和 [Path之贝塞尔曲线](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B06%5DPath_Bezier.md) 的讲解，本篇终于进入Path的收尾篇，本篇结束后Path的大部分相关方法都已经讲解完了，但Path还有一些更有意思的玩法，应该会在后续的文章中出现吧，嗯，应该会的ˊ_>ˋ ****** ## 一.Path常用方法表 > 为了兼容性(_偷懒_) 本表格中去除了在API21(即安卓版本5.0)以上才添加的方法。忍不住吐槽一下，为啥看起来有些顺手就能写的重载方法要等到API21才添加上啊。宝宝此刻内心也是崩溃的。 -作用 | 相关方法 | 备注 -----------------|-----------------|------------------------------------------ -移动起点 | moveTo | 移动下一次操作的起点位置 -设置终点 | setLastPoint | 重置当前path中最后一个点位置，如果在绘制之前调用，效果和moveTo相同 -连接直线 | lineTo | 添加上一个点到当前点之间的直线到Path -闭合路径 | close | 连接第一个点连接到最后一个点，形成一个闭合区域 -添加内容 | addRect, addRoundRect, addOval, addCircle, addPath, addArc, arcTo | 添加(矩形， 圆角矩形， 椭圆， 圆， 路径， 圆弧) 到当前Path (注意addArc和arcTo的区别) -是否为空 | isEmpty | 判断Path是否为空 -是否为矩形 | isRect | 判断path是否是一个矩形 -替换路径 | set | 用新的路径替换到当前路径所有内容 -偏移路径 | offset | 对当前路径之前的操作进行偏移(不会影响之后的操作) -贝塞尔曲线 | quadTo, cubicTo | 分别为二次和三次贝塞尔曲线的方法 -rXxx方法 | rMoveTo, rLineTo, rQuadTo, rCubicTo | **不带r的方法是基于原点的坐标系(偏移量)， rXxx方法是基于当前点坐标系(偏移量)** -填充模式 | setFillType, getFillType, isInverseFillType, toggleInverseFillType | 设置,获取,判断和切换填充模式 -提示方法 | incReserve | 提示Path还有多少个点等待加入**(这个方法貌似会让Path优化存储结构)** -布尔操作(API19) | op | 对两个Path进行布尔运算(即取交集、并集等操作) -计算边界 | computeBounds | 计算Path的边界 -重置路径 | reset, rewind | 清除Path中的内容
**reset不保留内部数据结构，但会保留FillType.**
**rewind会保留内部的数据结构，但不保留FillType** -矩阵操作 | transform | 矩阵变换 +| 作用 | 相关方法 | 备注 | +| ----------- | ---------------------------------------- | ---------------------------------------- | +| 移动起点 | moveTo | 移动下一次操作的起点位置 | +| 设置终点 | setLastPoint | 重置当前path中最后一个点位置，如果在绘制之前调用，效果和moveTo相同 | +| 连接直线 | lineTo | 添加上一个点到当前点之间的直线到Path | +| 闭合路径 | close | 连接第一个点连接到最后一个点，形成一个闭合区域 | +| 添加内容 | addRect, addRoundRect, addOval, addCircle, addPath, addArc, arcTo | 添加(矩形， 圆角矩形， 椭圆， 圆， 路径， 圆弧) 到当前Path (注意addArc和arcTo的区别) | +| 是否为空 | isEmpty | 判断Path是否为空 | +| 是否为矩形 | isRect | 判断path是否是一个矩形 | +| 替换路径 | set | 用新的路径替换到当前路径所有内容 | +| 偏移路径 | offset | 对当前路径之前的操作进行偏移(不会影响之后的操作) | +| 贝塞尔曲线 | quadTo, cubicTo | 分别为二次和三次贝塞尔曲线的方法 | +| rXxx方法 | rMoveTo, rLineTo, rQuadTo, rCubicTo | **不带r的方法是基于原点的坐标系(偏移量)， rXxx方法是基于当前点坐标系(偏移量)** | +| 填充模式 | setFillType, getFillType, isInverseFillType, toggleInverseFillType | 设置,获取,判断和切换填充模式 | +| 提示方法 | incReserve | 提示Path还有多少个点等待加入**(这个方法貌似会让Path优化存储结构)** | +| 布尔操作(API19) | op | 对两个Path进行布尔运算(即取交集、并集等操作) | +| 计算边界 | computeBounds | 计算Path的边界 | +| 重置路径 | reset, rewind | 清除Path中的内容
**reset不保留内部数据结构，但会保留FillType.**
**rewind会保留内部的数据结构，但不保留FillType** | +| 矩阵操作 | transform | 矩阵变换 | ## 二、Path方法详解 @@ -79,10 +79,10 @@ rXxx方法 | rMoveTo, rLineTo, rQuadTo, rCubicTo | **不带r的方法是 > PS：此处所有的图形均为封闭图形，不包括图形不封闭这种情况。 -方法 | 判定条件 | 解释 ----------------|-----------------------------------------------|---------------- -奇偶规则 | 奇数表示在图形内，偶数表示在图形外 | 从任意位置p作一条射线， 若与该射线相交的图形边的数目为奇数，则p是图形内部点，否则是外部点。 -非零环绕数规则 | 若环绕数为0表示在图形外，非零表示在图形内 | 首先使图形的边变为矢量。将环绕数初始化为零。再从任意位置p作一条射线。当从p点沿射线方向移动时，对在每个方向上穿过射线的边计数，每当图形的边从右到左穿过射线时，环绕数加1，从左到右时，环绕数减1。处理完图形的所有相关边之后，若环绕数为非零，则p为内部点，否则，p是外部点。 +| 方法 | 判定条件 | 解释 | +| ------- | --------------------- | ---------------------------------------- | +| 奇偶规则 | 奇数表示在图形内，偶数表示在图形外 | 从任意位置p作一条射线， 若与该射线相交的图形边的数目为奇数，则p是图形内部点，否则是外部点。 | +| 非零环绕数规则 | 若环绕数为0表示在图形外，非零表示在图形内 | 首先使图形的边变为矢量。将环绕数初始化为零。再从任意位置p作一条射线。当从p点沿射线方向移动时，对在每个方向上穿过射线的边计数，每当图形的边从右到左穿过射线时，环绕数加1，从左到右时，环绕数减1。处理完图形的所有相关边之后，若环绕数为非零，则p为内部点，否则，p是外部点。 | 接下来我们先了解一下两种判断方法是如何工作的。 @@ -95,16 +95,16 @@ rXxx方法 | rMoveTo, rLineTo, rQuadTo, rCubicTo | **不带r的方法是 在上图中有一个四边形，我们选取了三个点来判断这些点是否在图形内部。 > -P1: 从P1发出一条射线，发现图形与该射线相交边数为0，偶数，故P1点在图形外部。
-P2: 从P2发出一条射线，发现图形与该射线相交边数为1，奇数，故P2点在图形内部。
-P3: 从P3发出一条射线，发现图形与该射线相交边数为2，偶数，故P3点在图形外部。
+>P1: 从P1发出一条射线，发现图形与该射线相交边数为0，偶数，故P1点在图形外部。
+>P2: 从P2发出一条射线，发现图形与该射线相交边数为1，奇数，故P2点在图形内部。
+>P3: 从P3发出一条射线，发现图形与该射线相交边数为2，偶数，故P3点在图形外部。
#### 非零环绕数规则(Non-Zero Winding Number Rule) 非零环绕数规则相对来说比较难以理解一点。 -我们在之前的文章 [Path之基本操作](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B5%5DPath_Basic.md) 中我们了解到，在给Path中添加图形时需要指定图形的添加方式，是用顺时针还是逆时针，另外我们不论是使用lineTo，quadTo，cubicTo还是其他连接线的方法，都是从一个点连接到另一个点，换言之，**Path中任何线段都是有方向性的**，这也是使用非零环绕数规则的基础。 +我们在之前的文章 [Path之基本操作](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B05%5DPath_Basic.md) 中我们了解到，在给Path中添加图形时需要指定图形的添加方式，是用顺时针还是逆时针，另外我们不论是使用lineTo，quadTo，cubicTo还是其他连接线的方法，都是从一个点连接到另一个点，换言之，**Path中任何线段都是有方向性的**，这也是使用非零环绕数规则的基础。 我们依旧用一个简单的例子来说明非零环绕数规则的用法: @@ -113,9 +113,9 @@ P3: 从P3发出一条射线，发现图形与该射线相交边数为2，偶数 ![](http://ww2.sinaimg.cn/large/005Xtdi2jw1f42368af2jj308c0dwt8z.jpg) > -P1: 从P1点发出一条射线，沿射线防线移动，并没有与边相交点部分，环绕数为0，故P1在图形外边。
-P2: 从P2点发出一条射线，沿射线方向移动，与图形点左侧边相交，该边从左到右穿过穿过射线，环绕数－1，最终环绕数为－1，故P2在图形内部。
-P3: 从P3点发出一条射线，沿射线方向移动，在第一个交点处，底边从右到左穿过射线，环绕数＋1，在第二个交点处，右侧边从左到右穿过射线，环绕数－1，最终环绕数为0，故P3在图形外部。
+>P1: 从P1点发出一条射线，沿射线方向移动，并没有与边相交点部分，环绕数为0，故P1在图形外边。
+>P2: 从P2点发出一条射线，沿射线方向移动，与图形点左侧边相交，该边从左到右穿过射线，环绕数－1，最终环绕数为－1，故P2在图形内部。
+>P3: 从P3点发出一条射线，沿射线方向移动，在第一个交点处，底边从右到左穿过射线，环绕数＋1，在第二个交点处，右侧边从左到右穿过射线，环绕数－1，最终环绕数为0，故P3在图形外部。
通常，这两种方法的判断结果是相同的，但也存在两种方法判断结果不同的情况，如下面这种情况： @@ -135,27 +135,27 @@ P3: 从P3点发出一条射线，沿射线方向移动，在第一个交点处 Android中的填充模式有四种，是封装在Path中的一个枚举。 -模式 | 简介 ------------------|----------------------- -EVEN_ODD | 奇偶规则 -INVERSE_EVEN_ODD | 反奇偶规则 -WINDING | 非零环绕数规则 -INVERSE_WINDING | 反非零环绕数规则 +| 模式 | 简介 | +| ---------------- | -------- | +| EVEN_ODD | 奇偶规则 | +| INVERSE_EVEN_ODD | 反奇偶规则 | +| WINDING | 非零环绕数规则 | +| INVERSE_WINDING | 反非零环绕数规则 | 我们可以看到上面有四种模式，分成两对，例如 "奇偶规则" 与 "反奇偶规则" 是一对，它们之间有什么关系呢？ -Inverse 和含义是“相反，对立”，说明反奇偶规则刚好与奇偶规则相反，例如对于一个矩形而言，使用奇偶规则会填充矩形内部，而使用反奇偶规则会填充矩形外部，这个会在后面示例中代码展示两者对区别。 +Inverse 的含义是“相反，对立”，说明反奇偶规则刚好与奇偶规则相反，例如对于一个矩形而言，使用奇偶规则会填充矩形内部，而使用反奇偶规则会填充矩形外部，这个会在后面示例中代码展示两者的区别。 #### Android与填充模式相关的方法 > 这些都是Path中的方法。 -方法 | 作用 -------------------------|---------------------------- -setFillType | 设置填充规则 -getFillType | 获取当前填充规则 -isInverseFillType | 判断是否是反向(INVERSE)规则 -toggleInverseFillType | 切换填充规则(即原有规则与反向规则之间相互切换) +| 方法 | 作用 | +| --------------------- | ------------------------ | +| setFillType | 设置填充规则 | +| getFillType | 获取当前填充规则 | +| isInverseFillType | 判断是否是反向(INVERSE)规则 | +| toggleInverseFillType | 切换填充规则(即原有规则与反向规则之间相互切换) | #### 示例演示： @@ -176,7 +176,7 @@ toggleInverseFillType | 切换填充规则(即原有规则与反向规则之 path.addRect(-200,-200,200,200, Path.Direction.CW); // 给Path中添加一个矩形 ``` -下面两张图片分别是在奇偶规则于反奇偶规则的情况下绘制的结果，可以看出其填充的区域刚好相反： +下面两张图片分别是在奇偶规则与反奇偶规则的情况下绘制的结果，可以看出其填充的区域刚好相反： > PS: 白色为背景色，黑色为填充色。 @@ -214,7 +214,7 @@ toggleInverseFillType | 切换填充规则(即原有规则与反向规则之 ### 布尔操作(API19) -布尔操作与我们中学所学的集合操作非常像，只要知道集合操作中等交集，并集，差集等操作，那么理解布尔操作也是很容易的。 +布尔操作与我们中学所学的集合操作非常像，只要知道集合操作中的交集，并集，差集等操作，那么理解布尔操作也是很容易的。 **布尔操作是两个Path之间的运算，主要作用是用一些简单的图形通过一些规则合成一些相对比较复杂，或难以直接得到的图形**。 @@ -247,17 +247,17 @@ toggleInverseFillType | 切换填充规则(即原有规则与反向规则之 Path的布尔运算有五种逻辑，如下: -逻辑名称 | 类比 | 说明 | 示意图 --------------------|------|----------------------------------------|------------------------- -DIFFERENCE | 差集 | Path1中减去Path2后剩下的部分 | ![](http://ww2.sinaimg.cn/large/005Xtdi2gw1f43j85gcaqj305k03c0sn.jpg) -REVERSE_DIFFERENCE | 差集 | Path2中减去Path1后剩下的部分 | ![](http://ww2.sinaimg.cn/large/005Xtdi2gw1f43jbaaw80j305k03c0sn.jpg) -INTERSECT | 交集 | Path1与Path2相交的部分 | ![](http://ww3.sinaimg.cn/large/005Xtdi2gw1f43jbj4iddj305k03c746.jpg) -UNION | 并集 | 包含全部Path1和Path2 | ![](http://ww2.sinaimg.cn/large/005Xtdi2gw1f43jbqk8rbj305k03cmx4.jpg) -XOR | 异或 | 包含Path1与Path2但不包括两者相交的部分 | ![](http://ww3.sinaimg.cn/large/005Xtdi2gw1f43jby8c60j305k03c0sp.jpg) +| 逻辑名称 | 类比 | 说明 | 示意图 | +| ------------------ | ---- | ------------------------ | ---------------------------------------- | +| DIFFERENCE | 差集 | Path1中减去Path2后剩下的部分 | ![](http://ww2.sinaimg.cn/large/005Xtdi2gw1f43j85gcaqj305k03c0sn.jpg) | +| REVERSE_DIFFERENCE | 差集 | Path2中减去Path1后剩下的部分 | ![](http://ww2.sinaimg.cn/large/005Xtdi2gw1f43jbaaw80j305k03c0sn.jpg) | +| INTERSECT | 交集 | Path1与Path2相交的部分 | ![](http://ww3.sinaimg.cn/large/005Xtdi2gw1f43jbj4iddj305k03c746.jpg) | +| UNION | 并集 | 包含全部Path1和Path2 | ![](http://ww2.sinaimg.cn/large/005Xtdi2gw1f43jbqk8rbj305k03cmx4.jpg) | +| XOR | 异或 | 包含Path1与Path2但不包括两者相交的部分 | ![](http://ww3.sinaimg.cn/large/005Xtdi2gw1f43jby8c60j305k03c0sp.jpg) | #### 布尔运算方法 -通过前面到理论知识铺垫，相信大家对布尔运算已经有了基本的认识和理解，下面我们用代码演示一下布尔运算: +通过前面的理论知识铺垫，相信大家对布尔运算已经有了基本的认识和理解，下面我们用代码演示一下布尔运算: 在Path中的布尔运算有两个方法 @@ -268,7 +268,7 @@ XOR | 异或 | 包含Path1与Path2但不包括两者相交的部 两个方法中的返回值用于判断布尔运算是否成功，它们使用方法如下: -``` `java +``` java // 对 path1 和 path2 执行布尔运算，运算方式由第二个参数指定，运算结果存入到path1中。 path1.op(path2, Path.Op.DIFFERENCE); @@ -331,10 +331,10 @@ XOR | 异或 | 包含Path1与Path2但不包括两者相交的部 它有两个参数： -参数 | 作用 --------|-------- -bounds | 测量结果会放入这个矩形 -exact | 是否精确测量，目前这一个参数作用已经废弃，一般写true即可。 +| 参数 | 作用 | +| ------ | ------------------------------- | +| bounds | 测量结果会放入这个矩形 | +| exact | 是否精确测量，目前这一个参数作用已经废弃，一般写true即可 | 关于exact如有疑问可参见Google官方的提交记录[Path.computeBounds()](https://code.google.com/p/android/issues/detail?id=4070) @@ -369,12 +369,12 @@ exact | 是否精确测量，目前这一个参数作用已经废弃，一般 ### 重置路径 -重置Path有两个方法，分别是reset和rewind，两者区别主要有一下两点： +重置Path有两个方法，分别是reset和rewind，两者区别主要有以下两点： -方法 | 是否保留FillType设置 | 是否保留原有数据结构 --------|:--------------------:|:--------------------: -reset | 是 | 否 -rewind | 否 | 是 +| 方法 | 是否保留FillType设置 | 是否保留原有数据结构 | +| ------ | :------------: | :--------: | +| reset | 是 | 否 | +| rewind | 否 | 是 | **这个两个方法应该何时选择呢？** @@ -384,8 +384,8 @@ _因为“FillType”影响的是显示效果，而“数据结构”影响的 ## 总结 - -Path中常用的方法到此已经结束，希望能够帮助大家加深对Path对理解运用，让大家能够用Path愉快的玩耍。(￣▽￣) + +Path中常用的方法到此已经结束，希望能够帮助大家加深对Path的理解运用，让大家能够用Path愉快的玩耍。(￣▽￣) (,,• ₃ •,,) #### PS: 由于本人水平有限，某些地方可能存在误解或不准确，如果你对此有疑问可以提交Issues进行反馈。 diff --git a/CustomView/Advance/[08]Path_Play.md b/CustomView/Advance/[08]Path_Play.md index 181158c6..35387d5f 100644 --- a/CustomView/Advance/[08]Path_Play.md +++ b/CustomView/Advance/[08]Path_Play.md @@ -1,13 +1,9 @@ # Path之玩出花样(PathMeasure) -### 作者微博: [@GcsSloop](http://weibo.com/GcsSloop) -### [【本系列相关文章】](https://github.com/GcsSloop/AndroidNote/tree/master/CustomView/README.md) - - 可以看到，在经过 -[Path之基本操作](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B5%5DPath_Basic.md) -[Path之贝塞尔曲线](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B6%5DPath_Bezier.md) 和 -[Path之完结篇(伪)](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B7%5DPath_Over.md) 后， Path中各类方法基本上都讲完了，表格中还没有讲解到到方法就是矩阵变换了，难道本篇终于要讲矩阵了？ +[Path之基本操作](http://www.gcssloop.com/customview/Path_Basic/) +[Path之贝塞尔曲线](http://www.gcssloop.com/customview/Path_Bezier/) 和 +[Path之完结篇](http://www.gcssloop.com/customview/Path_Over/) 后， Path中各类方法基本上都讲完了，表格中还没有讲解到到方法就是矩阵变换了，难道本篇终于要讲矩阵了？ 非也，矩阵这一部分仍在后面单独讲解，本篇主要讲解 PathMeasure 这个类与 Path 的一些使用技巧。 > PS：不要问我为什么不讲 PathEffect，因为这个方法在后面的Paint系列中。 @@ -16,35 +12,34 @@ ![](http://ww3.sinaimg.cn/large/005Xtdi2jw1f4fp2myqo4g308c05k75k.gif) -****** +------ -## Path & PathMeasure +## Path & PathMeasure 顾名思义，PathMeasure是一个用来测量Path的类，主要有以下方法: ### 构造方法 -方法名 | 释义 ----|--- -PathMeasure() | 创建一个空的PathMeasure -PathMeasure(Path path, boolean forceClosed) | 创建 PathMeasure 并关联一个指定的Path(Path需要已经创建完成)。 +| 方法名 | 释义 | +| ---------------------------------------- | ---------------------------------------- | +| PathMeasure() | 创建一个空的PathMeasure | +| PathMeasure(Path path, boolean forceClosed) | 创建 PathMeasure 并关联一个指定的Path(Path需要已经创建完成)。 | ### 公共方法 -返回值 | 方法名 | 释义 ---------|--------------------------------------------------------------------------|------------------- -void | setPath(Path path, boolean forceClosed) | 关联一个Path -boolean | isClosed() | 是否闭合 -float | getLength() | 获取Path的长度 -boolean | nextContour() | 跳转到下一个轮廓 -boolean | getSegment(float startD, float stopD, Path dst, boolean startWithMoveTo) | 截取片段 -boolean | getPosTan(float distance, float[] pos, float[] tan) | 获取指定长度的位置坐标及该点切线值 -boolean | getMatrix(float distance, Matrix matrix, int flags) | 获取指定长度的位置坐标及该点Matrix +| 返回值 | 方法名 | 释义 | +| ------- | ---------------------------------------- | -------------------- | +| void | setPath(Path path, boolean forceClosed) | 关联一个Path | +| boolean | isClosed() | 是否闭合 | +| float | getLength() | 获取Path的长度 | +| boolean | nextContour() | 跳转到下一个轮廓 | +| boolean | getSegment(float startD, float stopD, Path dst, boolean startWithMoveTo) | 截取片段 | +| boolean | getPosTan(float distance, float[] pos, float[] tan) | 获取指定长度的位置坐标及该点切线值 | +| boolean | getMatrix(float distance, Matrix matrix, int flags) | 获取指定长度的位置坐标及该点Matrix | PathMeasure的方法也不多，接下来我们就逐一的讲解一下。 -****** - +------ ### 1.构造函数 @@ -52,7 +47,7 @@ PathMeasure的方法也不多，接下来我们就逐一的讲解一下。 **无参构造函数：** -``` java +```java PathMeasure () ``` @@ -60,7 +55,7 @@ PathMeasure的方法也不多，接下来我们就逐一的讲解一下。 **有参构造函数：** -``` java +```java PathMeasure (Path path, boolean forceClosed) ``` @@ -71,33 +66,35 @@ PathMeasure的方法也不多，接下来我们就逐一的讲解一下。 **在这里有两点需要明确:** > -* 1. 不论 forceClosed 设置为何种状态(true 或者 false)， 都不会影响原有Path的状态，**即 Path 与 PathMeasure 关联之后，之前的的 Path 不会有任何改变。** -* 2. forceClosed 的设置状态可能会影响测量结果，**如果 Path 未闭合但在与 PathMeasure 关联的时候设置 forceClosed 为 true 时，测量结果可能会比 Path 实际长度稍长一点，获取到到是该 Path 闭合时的状态。** + +- 1. 不论 forceClosed 设置为何种状态(true 或者 false)， 都不会影响原有Path的状态，**即 Path 与 PathMeasure 关联之后，之前的的 Path 不会有任何改变。** +- 1. forceClosed 的设置状态可能会影响测量结果，**如果 Path 未闭合但在与 PathMeasure 关联的时候设置 forceClosed 为 true 时，测量结果可能会比 Path 实际长度稍长一点，获取到到是该 Path 闭合时的状态。** 下面我们用一个例子来验证一下： -``` - canvas.translate(mViewWidth/2,mViewHeight/2); +```java +canvas.translate(mViewWidth/2,mViewHeight/2); - Path path = new Path(); +Path path = new Path(); - path.lineTo(0,200); - path.lineTo(200,200); - path.lineTo(200,0); +path.lineTo(0,200); +path.lineTo(200,200); +path.lineTo(200,0); - PathMeasure measure1 = new PathMeasure(path,false); - PathMeasure measure2 = new PathMeasure(path,true); +PathMeasure measure1 = new PathMeasure(path,false); +PathMeasure measure2 = new PathMeasure(path,true); - Log.e("TAG", "forceClosed=false---->"+measure1.getLength()); - Log.e("TAG", "forceClosed=true----->"+measure2.getLength()); +Log.e("TAG", "forceClosed=false---->"+measure1.getLength()); +Log.e("TAG", "forceClosed=true----->"+measure2.getLength()); - canvas.drawPath(path,mDeafultPaint); +canvas.drawPath(path,mDeafultPaint); ``` log如下: -``` - 25521-25521/com.gcssloop.canvas E/TAG: forceClosed=false---->600.0 - 25521-25521/com.gcssloop.canvas E/TAG: forceClosed=true----->800.0 + +```shell +com.gcssloop.canvas E/TAG: forceClosed=false---->600.0 +com.gcssloop.canvas E/TAG: forceClosed=true----->800.0 ``` 绘制在界面上的效果如下: @@ -107,10 +104,9 @@ log如下: 我们所创建的 Path 实际上是一个边长为 200 的正方形的三条边，通过上面的示例就能验证以上两个问题。 > -* 1.我们将 Path 与两个的 PathMeasure 进行关联，并给 forceClosed 设置了不同的状态，之后绘制再绘制出来的 Path 没有任何变化，所以与 Path 与 PathMeasure进行关联并不会影响 Path 状态。 -* 2.我们可以看到，设置 forceClosed 为 true 的方法比设置为 false 的方法测量出来的长度要长一点，这是由于 Path 没有闭合的缘故，多出来的距离正是 Path 最后一个点与最开始一个点之间点距离。**forceClosed 为 false 测量的是当前 Path 状态的长度， forceClosed 为 true，则不论Path是否闭合测量的都是 Path 的闭合长度。** - +- 1.我们将 Path 与两个的 PathMeasure 进行关联，并给 forceClosed 设置了不同的状态，之后绘制再绘制出来的 Path 没有任何变化，所以与 Path 与 PathMeasure进行关联并不会影响 Path 状态。 +- 2.我们可以看到，设置 forceClosed 为 true 的方法比设置为 false 的方法测量出来的长度要长一点，这是由于 Path 没有闭合的缘故，多出来的距离正是 Path 最后一个点与最开始一个点之间点距离。**forceClosed 为 false 测量的是当前 Path 状态的长度， forceClosed 为 true，则不论Path是否闭合测量的都是 Path 的闭合长度。** @@ -126,29 +122,28 @@ getLength 用于获取 Path 的总长度，在之前的测试中已经用过了 - - ### 3.getSegment getSegment 用于获取Path的一个片段，方法如下： -``` java - boolean getSegment (float startD, float stopD, Path dst, boolean startWithMoveTo) +```java +boolean getSegment (float startD, float stopD, Path dst, boolean startWithMoveTo) ``` 方法各个参数释义： -参数 | 作用 | 备注 -----------------|----------------------------------|-------------------------------------------- -返回值(boolean) | 判断截取是否成功 | true 表示截取成功，结果存入dst中，false 截取失败，不会改变dst中内容 -startD | 开始截取位置距离 Path 起点的长度 | 取值范围: 0 <= startD < stopD <= Path总长度 -stopD | 结束截取位置距离 Path 起点的长度 | 取值范围: 0 <= startD < stopD <= Path总长度 -dst | 截取的 Path 将会添加到 dst 中 | 注意: 是添加，而不是替换 -startWithMoveTo | 起始点是否使用 moveTo | 用于保证截取的 Path 第一个点位置不变 +| 参数 | 作用 | 备注 | +| --------------- | -------------------- | ---------------------------------------- | +| 返回值(boolean) | 判断截取是否成功 | true 表示截取成功，结果存入dst中，false 截取失败，不会改变dst中内容 | +| startD | 开始截取位置距离 Path 起点的长度 | 取值范围: 0 <= startD < stopD <= Path总长度 | +| stopD | 结束截取位置距离 Path 起点的长度 | 取值范围: 0 <= startD < stopD <= Path总长度 | +| dst | 截取的 Path 将会添加到 dst 中 | 注意: 是添加，而不是替换 | +| startWithMoveTo | 起始点是否使用 moveTo | 用于保证截取的 Path 第一个点位置不变 | > -* 如果 startD、stopD 的数值不在取值范围 [0, getLength] 内，或者 startD == stopD 则返回值为 false，不会改变 dst 内容。 -* 如果在安卓4.4或者之前的版本，在默认开启硬件加速的情况下，更改 dst 的内容后可能绘制会出现问题，请关闭硬件加速或者给 dst 添加一个单个操作，例如: dst.rLineTo(0, 0) + +- 如果 startD、stopD 的数值不在取值范围 [0, getLength] 内，或者 startD == stopD 则返回值为 false，不会改变 dst 内容。 +- 如果在安卓4.4或者之前的版本，在默认开启硬件加速的情况下，更改 dst 的内容后可能绘制会出现问题，请关闭硬件加速或者给 dst 添加一个单个操作，例如: dst.rLineTo(0, 0) 我们先看看这个方法如何使用： @@ -160,20 +155,20 @@ startWithMoveTo | 起始点是否使用 moveTo | 用于保证截取 代码: -``` java - canvas.translate(mViewWidth / 2, mViewHeight / 2); // 平移坐标系 +```java +canvas.translate(mViewWidth / 2, mViewHeight / 2); // 平移坐标系 - Path path = new Path(); // 创建Path并添加了一个矩形 - path.addRect(-200, -200, 200, 200, Path.Direction.CW); +Path path = new Path(); // 创建Path并添加了一个矩形 +path.addRect(-200, -200, 200, 200, Path.Direction.CW); - Path dst = new Path(); // 创建用于存储截取后内容的 Path +Path dst = new Path(); // 创建用于存储截取后内容的 Path - PathMeasure measure = new PathMeasure(path, false); // 将 Path 与 PathMeasure 关联 +PathMeasure measure = new PathMeasure(path, false); // 将 Path 与 PathMeasure 关联 - // 截取一部分存入dst中，并使用 moveTo 保持截取得到的 Path 第一个点的位置不变 - measure.getSegment(200, 600, dst, true); +// 截取一部分存入dst中，并使用 moveTo 保持截取得到的 Path 第一个点的位置不变 +measure.getSegment(200, 600, dst, true); - canvas.drawPath(dst, mDeafultPaint); // 绘制 dst +canvas.drawPath(dst, mDeafultPaint); // 绘制 dst ``` 结果如下： @@ -182,20 +177,20 @@ startWithMoveTo | 起始点是否使用 moveTo | 用于保证截取 从上图可以看到我们成功到将需要到片段截取了出来，然而当 dst 中有内容时会怎样呢？ -``` java - canvas.translate(mViewWidth / 2, mViewHeight / 2); // 平移坐标系 +```java +canvas.translate(mViewWidth / 2, mViewHeight / 2); // 平移坐标系 - Path path = new Path(); // 创建Path并添加了一个矩形 - path.addRect(-200, -200, 200, 200, Path.Direction.CW); +Path path = new Path(); // 创建Path并添加了一个矩形 +path.addRect(-200, -200, 200, 200, Path.Direction.CW); - Path dst = new Path(); // 创建用于存储截取后内容的 Path - dst.lineTo(-300, -300); // <--- 在 dst 中添加一条线段 +Path dst = new Path(); // 创建用于存储截取后内容的 Path +dst.lineTo(-300, -300); // <--- 在 dst 中添加一条线段 - PathMeasure measure = new PathMeasure(path, false); // 将 Path 与 PathMeasure 关联 +PathMeasure measure = new PathMeasure(path, false); // 将 Path 与 PathMeasure 关联 - measure.getSegment(200, 600, dst, true); // 截取一部分 并使用 moveTo 保持截取得到的 Path 第一个点的位置不变 +measure.getSegment(200, 600, dst, true); // 截取一部分 并使用 moveTo 保持截取得到的 Path 第一个点的位置不变 - canvas.drawPath(dst, mDeafultPaint); // 绘制 Path +canvas.drawPath(dst, mDeafultPaint); // 绘制 Path ``` 结果如下: @@ -206,20 +201,20 @@ startWithMoveTo | 起始点是否使用 moveTo | 用于保证截取 前面两个例子中 startWithMoveTo 均为 true， 如果设置为false会怎样呢? -``` java - canvas.translate(mViewWidth / 2, mViewHeight / 2); // 平移坐标系 +```java +canvas.translate(mViewWidth / 2, mViewHeight / 2); // 平移坐标系 - Path path = new Path(); // 创建Path并添加了一个矩形 - path.addRect(-200, -200, 200, 200, Path.Direction.CW); +Path path = new Path(); // 创建Path并添加了一个矩形 +path.addRect(-200, -200, 200, 200, Path.Direction.CW); - Path dst = new Path(); // 创建用于存储截取后内容的 Path - dst.lineTo(-300, -300); // 在 dst 中添加一条线段 +Path dst = new Path(); // 创建用于存储截取后内容的 Path +dst.lineTo(-300, -300); // 在 dst 中添加一条线段 - PathMeasure measure = new PathMeasure(path, false); // 将 Path 与 PathMeasure 关联 +PathMeasure measure = new PathMeasure(path, false); // 将 Path 与 PathMeasure 关联 - measure.getSegment(200, 600, dst, false); // <--- 截取一部分 不使用 startMoveTo, 保持 dst 的连续性 +measure.getSegment(200, 600, dst, false); // <--- 截取一部分 不使用 startMoveTo, 保持 dst 的连续性 - canvas.drawPath(dst, mDeafultPaint); // 绘制 Path +canvas.drawPath(dst, mDeafultPaint); // 绘制 Path ``` 结果如下： @@ -230,18 +225,16 @@ startWithMoveTo | 起始点是否使用 moveTo | 用于保证截取 从而我们可以用以下规则来判断 startWithMoveTo 的取值： -取值 | 主要功用 -------|------------------ -true | 保证截取得到的 Path 片段不会发生形变 -false | 保证存储截取片段的 Path(dst) 的连续性 - - +| 取值 | 主要功用 | +| ----- | ------------------------ | +| true | 保证截取得到的 Path 片段不会发生形变 | +| false | 保证存储截取片段的 Path(dst) 的连续性 | ### 4.nextContour -我们知道 Path 可以由多条曲线构成，但不论是 getLength , getgetSegment 或者是其它方法，都只会在其中第一条线段上运行，而这个 `nextContour` 就是用于跳转到下一条曲线到方法，_如果跳转成功，则返回 true， 如果跳转失败，则返回 false。_ +我们知道 Path 可以由多条曲线构成，但不论是 getLength , getSegment 或者是其它方法，都只会在其中第一条线段上运行，而这个 `nextContour` 就是用于跳转到下一条曲线到方法，_如果跳转成功，则返回 true， 如果跳转失败，则返回 false。_ 如下，我们创建了一个 Path 并使其中包含了两个闭合的曲线，内部的边长是200，外面的边长是400，现在我们使用 PathMeasure 分别测量两条曲线的总长度。 @@ -249,156 +242,207 @@ false | 保证存储截取片段的 Path(dst) 的连续性 代码： -``` java - canvas.translate(mViewWidth / 2, mViewHeight / 2); // 平移坐标系 +```java +canvas.translate(mViewWidth / 2, mViewHeight / 2); // 平移坐标系 + +Path path = new Path(); - Path path = new Path(); +path.addRect(-100, -100, 100, 100, Path.Direction.CW); // 添加小矩形 +path.addRect(-200, -200, 200, 200, Path.Direction.CW); // 添加大矩形 - path.addRect(-100, -100, 100, 100, Path.Direction.CW); // 添加小矩形 - path.addRect(-200, -200, 200, 200, Path.Direction.CW); // 添加大矩形 +canvas.drawPath(path,mDeafultPaint); // 绘制 Path - canvas.drawPath(path,mDeafultPaint); // 绘制 Path - - PathMeasure measure = new PathMeasure(path, false); // 将Path与PathMeasure关联 +PathMeasure measure = new PathMeasure(path, false); // 将Path与PathMeasure关联 - float len1 = measure.getLength(); // 获得第一条路径的长度 +float len1 = measure.getLength(); // 获得第一条路径的长度 - measure.nextContour(); // 跳转到下一条路径 +measure.nextContour(); // 跳转到下一条路径 - float len2 = measure.getLength(); // 获得第二条路径的长度 +float len2 = measure.getLength(); // 获得第二条路径的长度 - Log.i("LEN","len1="+len1); // 输出两条路径的长度 - Log.i("LEN","len2="+len2); +Log.i("LEN","len1="+len1); // 输出两条路径的长度 +Log.i("LEN","len2="+len2); ``` log输出结果: -``` -05-30 02:00:33.899 19879-19879/com.gcssloop.canvas I/LEN: len1=800.0 -05-30 02:00:33.899 19879-19879/com.gcssloop.canvas I/LEN: len2=1600.0 + +```shell +com.gcssloop.canvas I/LEN: len1=800.0 +com.gcssloop.canvas I/LEN: len2=1600.0 ``` 通过测试，我们可以得到以下内容： -* 1.曲线的顺序与 Path 中添加的顺序有关。 -* 2.getLength 获取到到是当前一条曲线分长度，而不是整个 Path 的长度。 -* 3.getLength 等方法是针对当前的曲线(其它方法请自行验证)。 - - - - +- 1.曲线的顺序与 Path 中添加的顺序有关。 +- 2.getLength 获取到到是当前一条曲线分长度，而不是整个 Path 的长度。 +- 3.getLength 等方法是针对当前的曲线(其它方法请自行验证)。 #### 5.getPosTan 这个方法是用于得到路径上某一长度的位置以及该位置的正切值： -``` java - boolean getPosTan (float distance, float[] pos, float[] tan) + +```java +boolean getPosTan (float distance, float[] pos, float[] tan) ``` 方法各个参数释义： -参数 | 作用 | 备注 -----------------|----------------------------------|-------------------------------------------- -返回值(boolean) | 判断获取是否成功 | true表示成功，数据会存入 pos 和 tan 中，
false 表示失败，pos 和 tan 不会改变 -distance | 距离 Path 起点的长度 | 取值范围: 0 <= distance <= getLength -pos | 该点的坐标值 | 坐标值: (x==[0], y==[1]) -tan | 该点的正切值 | 正切值: (x==[0], y==[1]) +| 参数 | 作用 | 备注 | +| ------------ | ------------- | ---------------------------------------- | +| 返回值(boolean) | 判断获取是否成功 | true表示成功，数据会存入 pos 和 tan 中，
false 表示失败，pos 和 tan 不会改变 | +| distance | 距离 Path 起点的长度 | 取值范围: 0 <= distance <= getLength | +| pos | 该点的坐标值 | 当前点在画布上的位置，有两个数值，分别为x，y坐标。 | +| tan | 该点的正切值 | 当前点在曲线上的方向，使用 Math.atan2(tan[1], tan[0]) 获取到正切角的弧度值。 | 这个方法也不难理解，除了其中 `tan` 这个东东，这个东西是干什么的呢？ -`tan` 是用来判断 Path 的趋势的，即在这个位置上曲线的走向，请看下图示例，注意箭头的方向: +`tan` 是用来判断 Path 上趋势的，即在这个位置上曲线的走向，请看下图示例，注意箭头的方向: ![](http://ww4.sinaimg.cn/large/005Xtdi2jw1f4dtufydm4g308c0etmyl.gif) **[点击这里下载箭头图片](http://ww1.sinaimg.cn/large/005Xtdi2jw1f4gam21ktoj3069069jre.jpg)** -可以看到 上图中箭头在沿着 Path 运动时，方向始终与 Path 走向保持一致，下面我们来看看代码是如何实现的: +可以看到 上图中箭头在沿着 Path 运动时，方向始终与 Path 走向保持一致，保持方向主要就是依靠 `tan` 。 -首先我们需要定义几个必要的变量: +下面我们来看看代码是如何实现的，首先我们需要定义几个必要的变量: -``` java - private float currentValue = 0; // 用于纪录当前的位置,取值范围[0,1]映射Path的整个长度 +```java +private float currentValue = 0; // 用于纪录当前的位置,取值范围[0,1]映射Path的整个长度 - private float[] pos; // 当前点的实际位置 - private float[] tan; // 当前点的tangent值,用于计算图片所需旋转的角度 - private Bitmap mBitmap; // 箭头图片 - private Matrix mMatrix; // 矩阵,用于对图片进行一些操作 +private float[] pos; // 当前点的实际位置 +private float[] tan; // 当前点的tangent值,用于计算图片所需旋转的角度 +private Bitmap mBitmap; // 箭头图片 +private Matrix mMatrix; // 矩阵,用于对图片进行一些操作 ``` 初始化这些变量(在构造函数中调用这个方法): -``` java - private void init(Context context) { - pos = new float[2]; - tan = new float[2]; - BitmapFactory.Options options = new BitmapFactory.Options(); - options.inSampleSize = 2; // 缩放图片 - mBitmap = BitmapFactory.decodeResource(context.getResources(), R.drawable.arrow, options); - mMatrix = new Matrix(); - } +```java +private void init(Context context) { + pos = new float[2]; + tan = new float[2]; + BitmapFactory.Options options = new BitmapFactory.Options(); + options.inSampleSize = 2; // 缩放图片 + mBitmap = BitmapFactory.decodeResource(context.getResources(), R.drawable.arrow, options); + mMatrix = new Matrix(); +} ``` 具体绘制: -``` java - - canvas.translate(mViewWidth / 2, mViewHeight / 2); // 平移坐标系 +```java +canvas.translate(mViewWidth / 2, mViewHeight / 2); // 平移坐标系 - Path path = new Path(); // 创建 Path +Path path = new Path(); // 创建 Path - path.addCircle(0, 0, 200, Path.Direction.CW); // 添加一个圆形 +path.addCircle(0, 0, 200, Path.Direction.CW); // 添加一个圆形 - PathMeasure measure = new PathMeasure(path, false); // 创建 PathMeasure +PathMeasure measure = new PathMeasure(path, false); // 创建 PathMeasure - currentValue += 0.005; // 计算当前的位置在总长度上的比例[0,1] - if (currentValue >= 1) { - currentValue = 0; - } +currentValue += 0.005; // 计算当前的位置在总长度上的比例[0,1] +if (currentValue >= 1) { + currentValue = 0; +} - measure.getPosTan(measure.getLength() * currentValue, pos, tan); // 获取当前位置的坐标以及趋势 +measure.getPosTan(measure.getLength() * currentValue, pos, tan); // 获取当前位置的坐标以及趋势 - mMatrix.reset(); // 重置Matrix - float degrees = (float) (Math.atan2(tan[1], tan[0]) * 180.0 / Math.PI); // 计算图片旋转角度 +mMatrix.reset(); // 重置Matrix +float degrees = (float) (Math.atan2(tan[1], tan[0]) * 180.0 / Math.PI); // 计算图片旋转角度 - mMatrix.postRotate(degrees, mBitmap.getWidth() / 2, mBitmap.getHeight() / 2); // 旋转图片 - mMatrix.postTranslate(pos[0] - mBitmap.getWidth() / 2, pos[1] - mBitmap.getHeight() / 2); // 将图片绘制中心调整到与当前点重合 +mMatrix.postRotate(degrees, mBitmap.getWidth() / 2, mBitmap.getHeight() / 2); // 旋转图片 +mMatrix.postTranslate(pos[0] - mBitmap.getWidth() / 2, pos[1] - mBitmap.getHeight() / 2); // 将图片绘制中心调整到与当前点重合 - canvas.drawPath(path, mDeafultPaint); // 绘制 Path - canvas.drawBitmap(mBitmap, mMatrix, mDeafultPaint); // 绘制箭头 +canvas.drawPath(path, mDeafultPaint); // 绘制 Path +canvas.drawBitmap(mBitmap, mMatrix, mDeafultPaint); // 绘制箭头 - invalidate(); // 重绘页面 +invalidate(); // 重绘页面 ``` **核心要点:** > -* 1.**通过 `tan` 得值计算出图片旋转的角度**，tan 是 tangent 的缩写，即中学中常见的正切， 其中tan[0](x)是邻边边长，tan[1](y)是对边边长，而Math中 `atan2` 方法是根据正切是数值计算出该角度的大小,得到的单位是弧度，所以上面又将弧度转为了角度。 -* 2.**通过 `Matrix` 来设置图片对旋转角度和位移**，这里使用的方法与前面讲解过对 canvas操作 有些类似，对于 `Matrix` 会在后面专一进行讲解，敬请期待。 -* 3.**页面刷新**，页面刷新此处是在 onDraw 里面调用了 invalidate 方法来保持界面不断刷新，但并不提倡这么做，正确对做法应该是使用 线程 或者 ValueAnimator 来控制界面的刷新，关于控制页面刷新这一部分会在后续的 动画部分 详细讲解，同样敬请期待。 + +- 1.**通过 `tan` 得值计算出图片旋转的角度**，tan 是 tangent 的缩写，即中学中常见的正切， 其中tan[0]是邻边边长，tan[1]是对边边长，而Math中 `atan2` 方法是根据正切是数值计算出该角度的大小,得到的单位是弧度(取值范围是 -pi 到 pi)，所以上面又将弧度转为了角度。 +- 2.**通过 `Matrix` 来设置图片对旋转角度和位移**，这里使用的方法与前面讲解过对 canvas操作 有些类似，对于 `Matrix` 会在后面专一进行讲解，敬请期待。 +- 3.**页面刷新**，页面刷新此处是在 onDraw 里面调用了 invalidate 方法来保持界面不断刷新，但并不提倡这么做，正确对做法应该是使用 线程 或者 ValueAnimator 来控制界面的刷新，关于控制页面刷新这一部分会在后续的 动画部分 详细讲解，同样敬请期待。 + +关于`tan`这个参数有很多魔法师不理解，特此拉出来详述一下，`tan` 在数学中被称为正切，在直角三角形中，一个锐角的**正切**定义为它的对边(Opposite side)与邻边(Adjacent side)的比值(来自维基百科)： + +![](http://ww3.sinaimg.cn/large/005Xtdi2jw1f8wyvmjf9gj307y01kdfr.jpg) + +我们此处用 `tan` 来描述 Path 上某一点的切线方向，**主要用了两个数值 tan[0] 和 tan[1] 来描述这个切线的方向(切线方向与x轴夹角)** ，看上面公式可知 `tan` 既可以用 `对边／邻边` 来表述，也可以用 `sin／cos` 来表述，此处用两种理解方式均可以(**注意下面等价关系**): + +> **tan[0] = cos = 邻边(单位圆x坐标)** +> **tan[1] = sin = 对边(单位圆y坐标)** + + + +**以 `sin／cos`理解:** + +![](http://ww1.sinaimg.cn/large/005Xtdi2jw1f8wzrmz33tj308c0etq3c.jpg) +在圆上最右侧点的切线方向向下(动图中小飞机朝向和切线朝向一致)，切线角度为90度. +sin90 = 1，cos90 = 0 +tan[0] = cos = 0 +tan[1] = sin = 1 + + + +**以 `对边／邻边` 理解(单位圆上坐标):** + +按照这种理解方式需要借助一个单位圆，单位圆上任意一点到圆心到距离均为 1，以下图30度为例： + + + +tan30 = 对边／邻边 = AB／OA = B点y坐标／B点x坐标 + +> **另外根据单位圆性质同样可以证得:** +> sin30 = 对边／斜边 = AB／OB = AB = B点y坐标 (单位圆边上任意一点距离圆心距离均为1，故OB = 1) +> cos30 = 邻边／斜边 = OA／OB = OA = B点x坐标 +> +> **化为通用公式即为:** +> sin = 该角度在单位圆上对应点的y坐标 +> cos = 该角度在单位圆上对应点的x坐标 +> +> 即 tan = sin／cos = y／x +> tan[0] = x +> tan[1] = y +> +> 另外注意，这个单位圆与小飞机路径没有半毛钱关系，例如上一个例子中的90度切线，不要在单位圆上找对应位置，**要找对应角度的位置，90度对应的位置是(0，1)**，所以: +> tan[0] = x = 0 +> tan[1] = y = 1 +> +> 其实绕来绕去全是等价的 (╯°Д°)╯︵ ┻━┻ + +**PS: 使用 Math.atan2(tan[1], tan[0]) 将 `tan` 转化为角(单位为弧度)的时候要注意参数顺序。** + + ### 6.getMatrix 这个方法是用于得到路径上某一长度的位置以及该位置的正切值的矩阵： -``` java + +```java boolean getMatrix (float distance, Matrix matrix, int flags) ``` 方法各个参数释义： -参数 | 作用 | 备注 -----------------|----------------------------------|-------------------------------------------- -返回值(boolean) | 判断获取是否成功 | true表示成功，数据会存入matrix中，false 失败，matrix内容不会改变 -distance | 距离 Path 起点的长度 | 取值范围: 0 <= distance <= getLength -matrix | 根据 falgs 封装好的matrix | 会根据 flags 的设置而存入不同的内容 -flags | 规定哪些内容会存入到matrix中 | 可选择
POSITION_MATRIX_FLAG(位置)
ANGENT_MATRIX_FLAG(正切) +| 参数 | 作用 | 备注 | +| ------------ | ------------------- | ---------------------------------------- | +| 返回值(boolean) | 判断获取是否成功 | true表示成功，数据会存入matrix中，false 失败，matrix内容不会改变 | +| distance | 距离 Path 起点的长度 | 取值范围: 0 <= distance <= getLength | +| matrix | 根据 falgs 封装好的matrix | 会根据 flags 的设置而存入不同的内容 | +| flags | 规定哪些内容会存入到matrix中 | 可选择
POSITION_MATRIX_FLAG(位置)
ANGENT_MATRIX_FLAG(正切) | 其实这个方法就相当于我们在前一个例子中封装 `matrix` 的过程由 `getMatrix` 替我们做了，我们可以直接得到一个封装好到 `matrix`，岂不快哉。 但是我们看到最后到 `flags` 选项可以选择 `位置` 或者 `正切` ,如果我们两个选项都想选择怎么办？ 如果两个选项都想选择，可以将两个选项之间用 `|` 连接起来，如下： + ``` measure.getMatrix(distance, matrix, PathMeasure.TANGENT_MATRIX_FLAG | PathMeasure.POSITION_MATRIX_FLAG); ``` @@ -407,68 +451,66 @@ measure.getMatrix(distance, matrix, PathMeasure.TANGENT_MATRIX_FLAG | PathMeasur 具体绘制: -``` java - Path path = new Path(); // 创建 Path +```java +Path path = new Path(); // 创建 Path + +path.addCircle(0, 0, 200, Path.Direction.CW); // 添加一个圆形 - path.addCircle(0, 0, 200, Path.Direction.CW); // 添加一个圆形 +PathMeasure measure = new PathMeasure(path, false); // 创建 PathMeasure - PathMeasure measure = new PathMeasure(path, false); // 创建 PathMeasure +currentValue += 0.005; // 计算当前的位置在总长度上的比例[0,1] +if (currentValue >= 1) { + currentValue = 0; +} - currentValue += 0.005; // 计算当前的位置在总长度上的比例[0,1] - if (currentValue >= 1) { - currentValue = 0; - } +// 获取当前位置的坐标以及趋势的矩阵 +measure.getMatrix(measure.getLength() * currentValue, mMatrix, PathMeasure.TANGENT_MATRIX_FLAG | PathMeasure.POSITION_MATRIX_FLAG); - // 获取当前位置的坐标以及趋势的矩阵 - measure.getMatrix(measure.getLength() * currentValue, mMatrix, PathMeasure.TANGENT_MATRIX_FLAG | PathMeasure.POSITION_MATRIX_FLAG); - - mMatrix.preTranslate(-mBitmap.getWidth() / 2, -mBitmap.getHeight() / 2); // <-- 将图片绘制中心调整到与当前点重合(注意:此处是前乘pre) +mMatrix.preTranslate(-mBitmap.getWidth() / 2, -mBitmap.getHeight() / 2); // <-- 将图片绘制中心调整到与当前点重合(注意:此处是前乘pre) - canvas.drawPath(path, mDeafultPaint); // 绘制 Path - canvas.drawBitmap(mBitmap, mMatrix, mDeafultPaint); // 绘制箭头 +canvas.drawPath(path, mDeafultPaint); // 绘制 Path +canvas.drawBitmap(mBitmap, mMatrix, mDeafultPaint); // 绘制箭头 - invalidate(); // 重绘页面 +invalidate(); // 重绘页面 ``` > 由于此处代码运行结果与上面一样，便不再贴图片了，请参照上面一个示例的效果图。 可以看到使用 getMatrix 方法的确可以节省一些代码，不过这里依旧需要注意一些内容: -> -* 1.对 `matrix` 的操作必须要在 `getMatrix` 之后进行，否则会被 `getMatrix` 重置而导致无效。 -* 2.矩阵对旋转角度默认为图片的左上角，我们此处需要使用 `preTranslate` 调整为图片中心。 -* 3.pre(矩阵前乘) 与 post(矩阵后乘) 的区别，此处请等待后续的文章或者自行搜索。 +> -***** +- 1.对 `matrix` 的操作必须要在 `getMatrix` 之后进行，否则会被 `getMatrix` 重置而导致无效。 +- 2.矩阵对旋转角度默认为图片的左上角，我们此处需要使用 `preTranslate` 调整为图片中心。 +- 3.pre(矩阵前乘) 与 post(矩阵后乘) 的区别，此处请等待后续的文章或者自行搜索。 +------ ## Path & SVG 我们知道，用Path可以创建出各种个样的图形，但如果图形过于复杂时，用代码写就不现实了，不仅麻烦，而且容易出错，所以在绘制复杂的图形时我们一般是将 SVG 图像转换为 Path。 **你说什么是 SVG?** - + SVG 是一种矢量图，内部用的是 xml 格式化存储方式存储这操作和数据，你完全可以将 SVG 看作是 Path 的各项操作简化书写后的存储格式。 - + Path 和 SVG 结合通常能诞生出一些奇妙的东西，如下: ![](http://ww3.sinaimg.cn/large/005Xtdi2jw1f4g87vfjbeg30690b4go8.gif) ![](http://ww3.sinaimg.cn/large/005Xtdi2jw1f4g89vqhqwg30690b4mzu.gif) -> -**该图片来自这个开源库 ->[PathView](https://github.com/geftimov/android-pathview)**
-**SVG 转 Path 的解析可以用这个库 -> [AndroidSVG](https://bigbadaboom.github.io/androidsvg/)** +> **该图片来自这个开源库 ->[PathView](https://github.com/geftimov/android-pathview)**
+> **SVG 转 Path 的解析可以用这个库 -> [AndroidSVG](https://bigbadaboom.github.io/androidsvg/)** 限于篇幅以及本人精力，这一部分就暂不详解了，感兴趣的可以直接看源码，或者搜索一些相关的解析文章。 -***** +------ ## Path使用技巧 **话说本篇文章的名字不是叫 玩出花样么？怎么只见前面啰啰嗦嗦的扯了一大堆不明所以的东西，花样在哪里？** -> -**前面的内容虽然啰嗦繁杂，但却是重中之重的基础，如果在修仙界，这叫根基，而下面讲述的内容的是招式，有了根基才能演化出千变万化的招式，而没有根基只学招式则是徒有其表，只能学一样会一样，很难适应千变万化的需求。** +> **前面的内容虽然啰嗦繁杂，但却是重中之重的基础，如果在修仙界，这叫根基，而下面讲述的内容的是招式，有了根基才能演化出千变万化的招式，而没有根基只学招式则是徒有其表，只能学一样会一样，很难适应千变万化的需求。** 先放一个效果图，然后分析一下实现过程: @@ -476,12 +518,12 @@ Path 和 SVG 结合通常能诞生出一些奇妙的东西，如下: 这是一个搜索的动效图，通过分析可以得到它应该有四种状态，分别如下: -状态 |概述 ----------|-------------------------------------------------- -初始状态 | 初始状态，没有任何动效，只显示一个搜索标志 :mag: -准备搜索 | 放大镜图标逐渐变化为一个点 -正在搜索 | 围绕这一个圆环运动，并且线段长度会周期性变化 -准备结束 | 从一个点逐渐变化成为放大镜图标 +| 状态 | 概述 | +| ---- | ------------------------ | +| 初始状态 | 初始状态，没有任何动效，只显示一个搜索标志 🔍 | +| 准备搜索 | 放大镜图标逐渐变化为一个点 | +| 正在搜索 | 围绕这一个圆环运动，并且线段长度会周期性变化 | +| 准备结束 | 从一个点逐渐变化成为放大镜图标 | 这些状态是有序转换的，转换流程以及转换条件如下： @@ -525,28 +567,22 @@ Path 和 SVG 结合通常能诞生出一些奇妙的东西，如下: > PS: 本代码仅作为示例使用，还有诸多不足，如 自定义属性，视图大小， 点击事件， 监听回调 等，并不适合直接使用，有需要的可以自行补足相关内容。 - ## 总结 **本文中虽然后面的内容看起来比较高大上一点，但前面"啰嗦"的废话才是真正的干货，把前面的东西学会了，后面的各种效果都能信手拈来，如果只研究后面的东西，则是取其形，而难以会其意。** #### PS: 由于本人水平有限，某些地方可能存在误解或不准确，如果你对此有疑问可以提交Issues进行反馈。 -## About Me +## About -### 作者微博: [@GcsSloop](http://weibo.com/GcsSloop) +[本系列相关文章](http://www.gcssloop.com/customview/CustomViewIndex/) - +作者微博: [GcsSloop](http://weibo.com/GcsSloop) ## 参考资料 + [PathMeasure](https://developer.android.com/reference/android/graphics/PathMeasure.html)
[AndroidSVG](https://bigbadaboom.github.io/androidsvg/)
[android-pathview](https://github.com/geftimov/android-pathview)
[android Path 和 PathMeasure 进阶](http://blog.csdn.net/cquwentao/article/details/51436852)
-[]()
- - - - - diff --git a/CustomView/Advance/[09]Matrix_Basic.md b/CustomView/Advance/[09]Matrix_Basic.md index 044cbaf4..e3985de3 100644 --- a/CustomView/Advance/[09]Matrix_Basic.md +++ b/CustomView/Advance/[09]Matrix_Basic.md @@ -1,52 +1,18 @@ -# Matrix原理 - -### 作者微博: [@GcsSloop](http://weibo.com/GcsSloop) -### [【本系列相关文章】](https://github.com/GcsSloop/AndroidNote/tree/master/CustomView/README.md) - - -## 目录 - -- [前言](#qianyan) -- [Matrix简介](#jianjie) -- [Matrix基本原理](#jiben) -- [Matrix复合原理](#fuhe) -- [Matrix方法表](#fangfa) -- [总结](#zongjie) -- [关于作者](#about) -- [参考资料](#ziliao) - -

-## 前言 - -本文内容偏向理论，和 [画布操作](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B3%5DCanvas_Convert.md) 有重叠的部分，本文会让你更加深入的了解其中的原理。 +本文内容偏向理论，和 [画布操作](http://www.gcssloop.com/customview/Canvas_Convert/) 有重叠的部分，本文会让你更加深入的了解其中的原理。 本篇的主角Matrix，是一个一直在后台默默工作的劳动模范，虽然我们所有看到View背后都有着Matrix的功劳，但我们却很少见到它，本篇我们就看看它是何方神圣吧。 +> 由于Google已经对这一部分已经做了很好的封装，所以跳过本部分对实际开发影响并不会太大，不想深究的粗略浏览即可，下一篇中将会详细讲解Matrix的具体用法和技巧。 > -由于Google已经对这一部分已经做了很好的封装，所以跳过本部分对实际开发影响并不会太大，不想深究的粗略浏览即可，下一篇中将会详细讲解Matrix的具体用法和技巧。 +> ## ⚠️ 警告：测试本文章示例之前请关闭硬件加速。 -****** - -

## Matrix简介 -

**Matrix是一个矩阵，主要功能是坐标映射，数值转换。** 它看起来大概是下面这样: -![](http://latex.codecogs.com/png.latex? -$$ -\\left [ -\\begin{matrix} -MSCALE\\_X & MSKEW\\_X & MTRANS\\_X \\\\ -\\\\ -MSKEW\\_Y & MSCALE\\_Y & MTRANS\\_Y \\\\ -\\\\ -MPERSP\\_0 & MPERSP\\_1 & MPERSP\\_2 -\\end{1} -\\right ] -$$) +![](http://ww1.sinaimg.cn/large/006tKfTcly1fdz72rjfnjj30ak01yglo.jpg) **Matrix作用就是坐标映射，那么为什么需要Matrix呢? 举一个简单的例子:** @@ -54,8 +20,7 @@ $$) 以下图为例，我们的内容区和屏幕坐标系还相差一个通知栏加一个标题栏的距离，所以两者是不重合的，我们在内容区的坐标系中的内容最终绘制的时候肯定要转换为实际的物理坐标系来绘制，Matrix在此处的作用就是转换这些数值。 -> -假设通知栏高度为20像素，导航栏高度为40像素,那么我们在内容区的(0，0)位置绘制一个点，最终就要转化为在实际坐标系中的(0，60)位置绘制一个点。 +> 假设通知栏高度为20像素，导航栏高度为40像素,那么我们在内容区的(0，0)位置绘制一个点，最终就要转化为在实际坐标系中的(0，60)位置绘制一个点。 ![](http://ww4.sinaimg.cn/large/005Xtdi2jw1f624vi3eb6j30rs0goab5.jpg) @@ -65,13 +30,11 @@ $$) ### Matrix特点 -* 作用范围更广，Matrix在View，图片，动画效果等各个方面均有运用，相比与之前讲解等画布操作应用范围更广。 -* 更加灵活，画布操作是对Matrix的封装，Matrix作为更接近底层的东西，必然要比画布操作更加灵活。 -* 封装很好，Matrix本身对各个方法就做了很好的封装，让开发者可以很方便的操作Matrix。 -* -* 难以深入理解，很难理解中各个数值的意义，以及操作规律，如果不了解矩阵，也很难理解前乘，后乘。 +- 作用范围更广，Matrix在View，图片，动画效果等各个方面均有运用，相比与之前讲解等画布操作应用范围更广。 +- 更加灵活，画布操作是对Matrix的封装，Matrix作为更接近底层的东西，必然要比画布操作更加灵活。 +- 封装很好，Matrix本身对各个方法就做了很好的封装，让开发者可以很方便的操作Matrix。 +- 难以深入理解，很难理解中各个数值的意义，以及操作规律，如果不了解矩阵，也很难理解前乘，后乘。 -

### 常见误解 **1.认为Matrix最下面的一行的三个参数(MPERSP_0、MPERSP_1、MPERSP_2)没有什么太大的作用，在这里只是为了凑数。** @@ -82,9 +45,6 @@ $$) 的确，更改MPERSP_2的值能够达到类似缩放的效果，但这是因为齐次坐标的缘故，并非这个参数的实际功能。 -****** - -

## Matrix基本原理 Matrix 是一个矩阵，最根本的作用就是坐标转换，下面我们就看看几种常见变换的原理: @@ -105,46 +65,18 @@ Matrix 是一个矩阵，最根本的作用就是坐标转换，下面我们就 ### 1.缩放(Scale) -![](http://latex.codecogs.com/png.latex?$$ x = k_1 x_0 $$) - -![](http://latex.codecogs.com/png.latex?$$ y = k_2 y_0 $$) - +![](http://ww2.sinaimg.cn/large/006tKfTcly1fdz7baj17gj302h01rdfr.jpg) 用矩阵表示: -![](http://latex.codecogs.com/png.latex? -$$ -\\left [ -\\begin{matrix} -x\\\\ -y\\\\ -1 -\\end{1} -\\right ] - = -\\left [ -\\begin{matrix} -k_1 & 0 & 0 \\\\ - 0 & k_2 & 0 \\\\ - 0 & 0 & 1 -\\end{1} -\\right ] -\\left [ -\\begin{matrix} -x_0 \\\\ -y_0 \\\\ -1 -\\end{1} -\\right ] -$$) - -> -你可能注意到了，我们坐标多了一个1，这是使用了齐次坐标系的缘故，在数学中我们的点和向量都是这样表示的(x, y)，两者看起来一样，计算机无法区分，为此让计算机也可以区分它们，增加了一个标志位，增加之后看起来是这样:
+![](http://ww3.sinaimg.cn/large/006tKfTcly1fdz7busaiej3062020mx4.jpg) + +> 你可能注意到了，我们坐标多了一个1，这是使用了齐次坐标系的缘故，在数学中我们的点和向量都是这样表示的(x, y)，两者看起来一样，计算机无法区分，为此让计算机也可以区分它们，增加了一个标志位，增加之后看起来是这样:
> -(x, y, 1) - 点
-(x, y, 0) - 向量
+> (x, y, 1) - 点
+> (x, y, 0) - 向量
> -另外，齐次坐标具有等比的性质，(2,3,1)、(4,6,2)...(2N,3N,N)表示的均是(2,3)这一个点。(**将MPERSP_2解释为scale这一误解就源于此**)。 +> 另外，齐次坐标具有等比的性质，(2,3,1)、(4,6,2)...(2N,3N,N)表示的均是(2,3)这一个点。(**将MPERSP_2解释为scale这一误解就源于此**)。 图例： @@ -156,37 +88,11 @@ $$) #### 水平错切 -![](http://latex.codecogs.com/png.latex?$$ x = x_0 + ky_0 $$) - -![](http://latex.codecogs.com/png.latex?$$ y = y_0 $$) +![](http://ww3.sinaimg.cn/large/006tKfTcly1fdz7d0niaqj303601mglj.jpg) 用矩阵表示: -![](http://latex.codecogs.com/png.latex? -$$ -\\left [ -\\begin{matrix} -x\\\\ -y\\\\ -1 -\\end{1} -\\right ] - = -\\left [ -\\begin{matrix} - 1 & k & 0 \\\\ - 0 & 1 & 0 \\\\ - 0 & 0 & 1 -\\end{1} -\\right ] -\\left [ -\\begin{matrix} -x_0\\\\ -y_0\\\\ -1 -\\end{1} -\\right ] -$$) +![](http://ww4.sinaimg.cn/large/006tKfTcly1fdz7dryrfcj305m020glk.jpg) 图例: @@ -194,37 +100,11 @@ $$) #### 垂直错切 -![](http://latex.codecogs.com/png.latex?$$ x = x_0 $$) - -![](http://latex.codecogs.com/png.latex?$$ y = kx_0 + y_0 $$) +![](http://ww3.sinaimg.cn/large/006tKfTcly1fdz7esq5j4j303701pdfr.jpg) 用矩阵表示: -![](http://latex.codecogs.com/png.latex? -$$ -\\left [ -\\begin{matrix} -x\\\\ -y\\\\ -1 -\\end{1} -\\right ] - = -\\left [ -\\begin{matrix} - 1 & 0 & 0 \\\\ - k & 1 & 0 \\\\ - 0 & 0 & 1 -\\end{1} -\\right ] -\\left [ -\\begin{matrix} -x_0\\\\ -y_0\\\\ -1 -\\end{1} -\\right ] -$$) +![](http://ww4.sinaimg.cn/large/006tKfTcly1fdz7ffdxauj305n024glk.jpg) 图例: @@ -234,37 +114,11 @@ $$) > 水平错切和垂直错切的复合。 -![](http://latex.codecogs.com/png.latex?$$ x = x_0 + k_1 y_0 $$) - -![](http://latex.codecogs.com/png.latex?$$ y = k_2 x_0 + y_0 $$) +![](http://ww4.sinaimg.cn/large/006tKfTcly1fdz7g0lmcaj303801mq2v.jpg) 用矩阵表示: -![](http://latex.codecogs.com/png.latex? -$$ -\\left [ -\\begin{matrix} -x\\\\ -y\\\\ -1 -\\end{1} -\\right ] - = -\\left [ -\\begin{matrix} - 1 & k_1 & 0 \\\\ - k_2 & 1 & 0 \\\\ - 0 & 0 & 1 -\\end{1} -\\right ] -\\left [ -\\begin{matrix} -x_0\\\\ -y_0\\\\ -1 -\\end{1} -\\right ] -$$) +![](http://ww2.sinaimg.cn/large/006tKfTcly1fdz7gkg5dej3062021mx4.jpg) 图例: @@ -274,102 +128,30 @@ $$) 假定一个点 A(x0, y0) ,距离原点距离为 r, 与水平轴夹角为 α 度, 绕原点旋转 θ 度, 旋转后为点 B(x, y) 如下: -![](http://latex.codecogs.com/png.latex? $$ x_0 = r \\cdot cos \\alpha $$) - -![](http://latex.codecogs.com/png.latex? $$ y_0 = r \\cdot sin \\alpha $$) - -![](http://latex.codecogs.com/png.latex? -$$ -x = r \\cdot cos( \\alpha + \\theta) -= r \\cdot cos \\alpha \\cdot cos \\theta - r \\cdot sin \\alpha \\cdot sin \\theta -= x_0 \\cdot cos \\theta - y_0 \\cdot sin \\theta -$$) - -![](http://latex.codecogs.com/png.latex? -$$ -y = r \\cdot sin( \\alpha + \\theta) -= r \\cdot sin \\alpha \\cdot cos \\theta + r \\cdot cos \\alpha \\cdot sin \\theta -= y_0 \\cdot cos \\theta + x_0 \\cdot sin \\theta -$$) +![](http://ww3.sinaimg.cn/large/006tKfTcly1fdz7h61ddsj30gm03twel.jpg) 用矩阵表示: -![](http://latex.codecogs.com/png.latex? -$$ -\\left [ -\\begin{matrix} -x\\\\ -y\\\\ -1 -\\end{1} -\\right ] - = -\\left [ -\\begin{matrix} -cos(\\theta) & -sin(\\theta) & 0 \\\\ -sin(\\theta) & cos(\\theta) & 0 \\\\ - 0 & 0 & 1 -\\end{1} -\\right ] - . -\\left [ -\\begin{matrix} -x_0\\\\ -y_0\\\\ -1 -\\end{1} -\\right ] -$$) +![](http://ww2.sinaimg.cn/large/006tKfTcly1fdz7hn7pbdj308i0240sq.jpg) 图例: ![](http://ww4.sinaimg.cn/large/005Xtdi2jw1f6cpp174twj308c0dwt8s.jpg) - ### 4.平移(Translate) -> -此处也是使用齐次坐标的优点体现之一，实际上前面的三个操作使用 2x2 的矩阵也能满足需求，但是使用 2x2 的矩阵，无法将平移操作加入其中，而将坐标扩展为齐次坐标后，将矩阵扩展为 3x3 就可以将算法统一，四种算法均可以使用矩阵乘法完成。 - -![](http://latex.codecogs.com/png.latex?$$ x = x_0 + \\Delta x $$) +> 此处也是使用齐次坐标的优点体现之一，实际上前面的三个操作使用 2x2 的矩阵也能满足需求，但是使用 2x2 的矩阵，无法将平移操作加入其中，而将坐标扩展为齐次坐标后，将矩阵扩展为 3x3 就可以将算法统一，四种算法均可以使用矩阵乘法完成。 -![](http://latex.codecogs.com/png.latex?$$ y = y_0 + \\Delta y $$) +![](http://ww4.sinaimg.cn/large/006tKfTcly1fdz7igi28cj302w01kdfr.jpg) 用矩阵表示: -![](http://latex.codecogs.com/png.latex? -$$ -\\left [ -\\begin{matrix} -x\\\\ -y\\\\ -1 -\\end{1} -\\right ] - = -\\left [ -\\begin{matrix} -1 & 0 & \\Delta x \\\\ -0 & 1 & \\Delta y \\\\ -0 & 0 & 1 -\\end{1} -\\right ] - . -\\left [ -\\begin{matrix} -x_0\\\\ -y_0\\\\ -1 -\\end{1} -\\right ] -$$) +![](http://ww2.sinaimg.cn/large/006tKfTcly1fdz7izsq8hj306b022mx4.jpg) 图例: ![](http://ww3.sinaimg.cn/large/005Xtdi2jw1f6dqiw20xoj308c0dw0su.jpg) - -

## Matrix复合原理 其实Matrix的多种复合操作都是使用矩阵乘法实现的，从原理上理解很简单，但是，使用矩阵乘法也有其弱点，后面的操作可能会影响到前面到操作，所以在构造Matrix时顺序很重要。 @@ -379,14 +161,16 @@ $$) ### 前乘(pre) 前乘相当于矩阵的右乘： -![](http://latex.codecogs.com/png.latex?$$ M' = M \\cdot S $$) + +![](https://ww1.sinaimg.cn/large/006tKfTcgy1fhe1ul01s9j302m00gq2u.jpg) > 这表示一个矩阵与一个特殊矩阵前乘后构造出结果矩阵。 ### 后乘(post) -前乘相当于矩阵的左乘： -![](http://latex.codecogs.com/png.latex?$$ M' = S \\cdot M $$) +后乘相当于矩阵的左乘： + +![](https://ww3.sinaimg.cn/large/006tKfTcgy1fhe1vta7ooj302s00pq2u.jpg) > 这表示一个矩阵与一个特殊矩阵后乘后构造出结果矩阵。 @@ -396,163 +180,261 @@ $$) ## 组合 -我们使用Matrix最终目的就是让视图显示为我们想要的状态，为此我们可能需要多种操作结合使用。 +**关于 Matrix 的文章终有一个问题，就是 pre 和 post 这一部分的理论非常别扭，国内大多数文章都是这样的，看起来貌似是对的但很难理解，部分内容违背直觉。** -我发现很多讲解Matrix的文章喜欢用绕某一个点缩放(旋转)的示例来讲解，如下: +**我由于也受到了这些文章的影响，自然而然的继承了这一理论，直到在评论区有一位小伙伴提出了一个问题，才让我重新审视了这一部分的内容，并进行了一定反思。** +经过良久的思考之后，我决定抛弃国内大部分文章的那套理论和结论，只用严谨的数学逻辑和程序逻辑来阐述这一部分的理论，也许仍有疏漏，如有发现请指正。 +**首先澄清两个错误结论，记住，是错误结论，错误结论，错误结论。** + +### ~~错误结论一：pre 是顺序执行，post 是逆序执行。~~ + +这个结论很具有迷惑性，因为这个结论并非是完全错误的，你很容易就能证明这个结论，例如下面这样： + +```java +// 第一段 pre 顺序执行，先平移(T)后旋转(R) +Matrix matrix = new Matrix(); +matrix.preTranslate(pivotX,pivotY); +matrix.preRotate(angle); +Log.e("Matrix", matrix.toShortString()); + +// 第二段 post 逆序执行，先平移(T)后旋转(R) +Matrix matrix = new Matrix(); +matrix.postRotate(angle); +matrix.postTranslate(pivotX,pivotY) +Log.e("Matrix", matrix.toShortString()); +``` + +**这两段代码最终结果是等价的，于是轻松证得这个结论的正确性，但事实真是这样么？** + +首先，从数学角度分析，pre 和 post 就是右乘或者左乘的区别，其次，它们不可能实际影响运算顺序(程序执行顺序)。以上这两段代码等价也仅仅是因为最终化简公式一样而已。 + +> 设原始矩阵为 M，平移为 T ，旋转为 R ，单位矩阵为 I ，最终结果为 M' > - 那么我们如果想让它基于图片中心缩放，应该该怎么办？要用到组合变换， - 1）先将图片由中心平移到原点，这是应用变换 T - 2）对图应用缩放变换 S - 3）再将图片平移回到中心，应用变换 -T - -> - 对应代码: - matrix.postScale(0.5f, 0.5f); - matrix.preTranslate(-pivotX, -pivotY); - matrix.postTranslate(pivotX, pivotY); -> - PS: 此段文字引用自其它文章。 +> - 矩阵乘法不满足交换律，即 A\\*B ≠ B\\*A +> - 矩阵乘法满足结合律，即 (A\\*B)\\*C = A\\*(B\\*C) +> - 矩阵与单位矩阵相乘结果不变，即 A * I = A + +``` +由于上面例子中原始矩阵(M)是一个单位矩阵(I)，所以可得： + +// 第一段 pre +M' = (M*T)*R = I*T*R = T*R + +// 第二段 post +M' = T*(R*M) = T*R*I = T*R +``` + +由于两者最终的化简公式是相同的，所以两者是等价的，但是，这结论不具备普适性。 + +**即原始矩阵不为单位矩阵的时候，两者无法化简为相同的公式，结果自然也会不同。另外，执行顺序就是程序书写顺序，不存在所谓的正序逆序。** + +### ~~错误结论二：pre 是先执行，而 post 是后执行。~~ + +这一条结论比上一条更离谱。 + +之所以产生这个错误完全是因为写文章的人懂英语。 + +``` +pre ：先，和 before 相似。 +post ：后，和 after 相似。 +``` -首先，**这个思路是没有任何问题的，也是实现绕某一点操作的核心原理**，但这可能会对一部分小白造成误解，认为只能这样实现，然而查看一下Matrix的方法表就能知道四大操作都可以指定中心点，所以，上面的三行代码用一行就能完成: +所以就得出了 pre 先执行，而 post 后执行这一说法，但从严谨的数学和程序角度来分析，完全是不可能的，还是上面所说的，**pre 和 post 不能影响程序执行顺序，而程序每执行一条语句都会得出一个确定的结果，所以，它根本不能控制先后执行，属于完全扯淡型。** + +**如果非要用这套理论强行解释的话，反而看起来像是 post 先执行，例如：** ```java -matrix.postScale(0.5f, 0.5f, pivotX, pivotY); +matrix.preRotate(angle); +matrix.postTranslate(pivotX,pivotY); ``` -**组合操作构造Matrix时，个人建议尽量全部使用后乘或者全部使用前乘，这样操作顺序容易确定，出现问题也比较容易排查。
当然，由于矩阵乘法不满足交换律，前乘和后乘的结果是不同的，使用时应结合具体情景分析使用。** +同样化简公式： -### Pre与Post的区别 +``` +// 矩阵乘法满足结合律 +M‘ = T*(M*R) = T*M*R = (T*M)*R +``` -主要区别其实就是矩阵的乘法顺序不同，pre相当于矩阵的右乘，而post相当于矩阵的左乘。 +**从实际上来说，由于矩阵乘法满足结合律，所以不论你说是靠右先执行还是靠左先执行，从结果上来说都没有错。** -以下观点存在歧义，故做删除标注: +**之前基于这条错误的结论我进行了一次错误的证明：** - -在图像处理中，越靠近右边的矩阵越先执行，所以pre操作会先执行，而post操作会后执行。 - +> **(这段内容注定要成为我写作历程中不可抹灭的耻辱，既然是公开文章，就应该对读者负责，虽然我在发表每一篇文章之前都竭力的求证其中的问题，各种细节，避免出现这种错误，但终究还是留下了这样一段内容，在此我诚挚的向我所有的读者道歉。)** +> +> 关注我的读者请尽量看我在 [个人博客](http://www.gcssloop.com/#blog) 和 [GitHub](https://github.com/GcsSloop/AndroidNote/blob/master/README.md) 发布的版本，这两个平台都在博文修复计划之内，有任何错误或者纰漏，都会首先修复这两个平台的文章。另外，所有进行修复过的文章都会在我的微博 [@GcsSloop](http://weibo.com/GcsSloop) 重新发布说明，关注我的微博可以第一时间得到博文更新或者修复的消息。 +> +> ------ +> +> ## 以下是错误证明： +> +> ~~在实际操作中，我们每一步操作都会得出准确的计算结果，但是为什么还会用存在先后的说法? 难道真的能够用pre和post影响计算顺序? 实则不然，下面我们用一个例子说明:~~ +> +> ```java +> Matrix matrix = new Matrix(); +> matrix.postScale(0.5f, 0.8f); +> matrix.preTranslate(1000, 1000); +> Log.e(TAG, "MatrixTest" + matrix.toShortString()); +> ``` +> +> ~~在上面的操作中，如果按照正常的思路，先缩放，后平移，缩放操作执行在前，不会影响到后续的平移操作，但是执行结果却发现平移距离变成了(500， 800)。~~ +> +> ~~在上面例子中，计算顺序是没有问题的，先计算的缩放，然后计算的平移，而缩放影响到平移则是因为前一步缩放后的结果矩阵右乘了平移矩阵，这是符合矩阵乘法的运算规律的，也就是说缩放操作虽然在前却影响到了平移操作，**相当于先执行了平移操作，然后执行的缩放操作，因此才有pre操作会先执行，而post操作会后执行这一说法**。~~ +> +> ------ -在实际操作中，我们每一步操作都会得出准确的计算结果，但是为什么还会用存在先后的说法? 难道真的能够用pre和post影响计算顺序? 实则不然，下面我们用一个例子说明: +上面的论证是完全错误的，因为可以轻松举出反例： -> ```java Matrix matrix = new Matrix(); -matrix.postScale(0.5f, 0.8f); +matrix.preScale(0.5f, 0.8f); matrix.preTranslate(1000, 1000); -Log.e(TAG, "MatrixTest:3" + matrix.toShortString()); +Log.e(TAG, "MatrixTest" + matrix.toShortString()); ``` -> -在上面的操作中，如果按照正常的思路，先缩放，后平移，缩放操作执行在前，不会影响到后续的平移操作，但是执行结果却发现平移距离变成了(500， 800)。 -> 在上面例子中，计算顺序是没有问题的，先计算的缩放，然后计算的平移，而缩放影响到平移则是因为前一步缩放后的结果矩阵右乘了平移矩阵，这是符合矩阵乘法的运算规律的，也就是说缩放操作虽然在前却影响到了平移操作，**相当于先执行了平移操作，然后执行的缩放操作，因此才有pre操作会先执行，而post操作会后执行这一说法**。 +反例中，虽然将 `postScale` 改为了 `preScale` ，但两者结果是完全相同的，所以先后论根本就是错误的。 + +他们结果相同是因为最终化简公式是相同的，都是 S*T + +之所以平移距离是 MTRANS\_X = 500，MTRANS\_Y = 800，那是因为执行 Translate 之前 Matrix 已经具有了一个缩放比例。在右乘的时候影响到了具体的数值计算，可以用矩阵乘法计算一下。 + +![](http://ww3.sinaimg.cn/large/006tKfTcly1fdz7lhb20fj30lz01zgm8.jpg) +最终结果为： -### 下面我们用不同对方式来构造一个矩阵: +![](http://ww2.sinaimg.cn/large/006tKfTcly1fdz7m2pgyuj303o022wef.jpg) -**假设我们需要先缩放再平移。** +当 T*S 的时候，缩放比例则不会影响到 MTRANS\\_X 和 MTRANS\\_Y ，具体可以使用矩阵乘法自己计算一遍。 + +## 如何理解和使用 pre 和 post ？ + +不要去管什么先后论，顺序论，就按照最基本的矩阵乘法理解。 + +``` +pre : 右乘， M‘ = M*A +post : 左乘， M’ = A*M +``` + +**那么如何使用？** + +正确使用方式就是先构造正常的 Matrix 乘法顺序，之后根据情况使用 pre 和 post 来把这个顺序实现。 + +还是用一个最简单的例子理解，假设需要围绕某一点旋转。 + +可以用这个方法 `xxxRotate(angle, pivotX, pivotY)` ,由于我们这里需要组合构造一个 Matrix，所以不直接使用这个方法。 + +首先，有两条基本定理： + +- 所有的操作(旋转、平移、缩放、错切)默认都是以坐标原点为基准点的。 +- 之前操作的坐标系状态会保留，并且影响到后续状态。 + +基于这两条基本定理，我们可以推算出要基于某一个点进行旋转需要如下步骤： + +``` +1. 先将坐标系原点移动到指定位置，使用平移 T +2. 对坐标系进行旋转，使用旋转 S (围绕原点旋转) +3. 再将坐标系平移回原来位置，使用平移 -T +``` + +具体公式如下： + +> M 为原始矩阵，是一个单位矩阵， M‘ 为结果矩阵， T 为平移， R为旋转 + +``` +M' = M*T*R*-T = T*R*-T +``` + +按照公式写出来的伪代码如下： + +```java +Matrix matrix = new Matrix(); +matrix.preTranslate(pivotX,pivotY); +matrix.preRotate(angle); +matrix.preTranslate(-pivotX, -pivotY); +``` + + + + + +围绕某一点操作可以拓展为通用情况，即： + +```java +Matrix matrix = new Matrix(); +matrix.preTranslate(pivotX,pivotY); +// 各种操作，旋转，缩放，错切等，可以执行多次。 +matrix.preTranslate(-pivotX, -pivotY); +``` + +公式为： + +``` +M' = M*T* ... *-T = T* ... *-T +``` + +但是这种方式，两个调整中心的平移函数就拉的太开了，所以通常采用这种写法： + +```java +Matrix matrix = new Matrix(); +// 各种操作，旋转，缩放，错切等，可以执行多次。 +matrix.postTranslate(pivotX,pivotY); +matrix.preTranslate(-pivotX, -pivotY); +``` + +这样公式为： + +``` +M' = T*M* ... *-T = T* ... *-T +``` + +可以看到最终化简结果是相同的。 + +所以说，pre 和 post 就是用来调整乘法顺序的，正常情况下应当正向进行构建出乘法顺序公式，之后根据实际情况调整书写即可。 + +**在构造 Matrix 时，个人建议尽量使用一种乘法，前乘或者后乘，这样操作顺序容易确定，出现问题也比较容易排查。当然，由于矩阵乘法不满足交换律，前乘和后乘的结果是不同的，使用时应结合具体情景分析使用。** + + + +### 下面我们用不同对方式来构造一个相同的矩阵: 注意: -* 1.由于矩阵乘法不满足交换律，请保证使用初始矩阵(Initial Matrix)，否则可能导致运算结果不同。 -* 2.注意构造顺序，顺序是会影响结果的。 -* 3.Initial Matrix是指new出来的新矩阵，或者reset后的矩阵，是一个单位矩阵。 +- 1.由于矩阵乘法不满足交换律，请保证使用初始矩阵(Initial Matrix)，否则可能导致运算结果不同。 +- 2.注意构造顺序，顺序是会影响结果的。 +- 3.Initial Matrix是指new出来的新矩阵，或者reset后的矩阵，是一个单位矩阵。 #### 1.仅用pre： -``` java +```java +// 使用pre， M' = M*T*S = T*S Matrix m ＝ new Matrix(); m.reset(); -m.preTranslate(tx, ty); //使用pre，越靠后越先执行。 +m.preTranslate(tx, ty); m.preScale(sx, sy); ``` 用矩阵表示: - -![](http://latex.codecogs.com/png.latex? -$$ -\\left [ -\\begin{matrix} - & &\\\\ - & Result Matrix &\\\\ - & & -\\end{1} -\\right ] - = - \\left [ -\\begin{matrix} - & &\\\\ - & Initial Matrix &\\\\ - & & -\\end{1} -\\right ] -\\cdot -\\left [ -\\begin{matrix} -1 & 0 & \\Delta x \\\\ -0 & 1 & \\Delta y \\\\ -0 & 0 & 1 -\\end{1} -\\right ] -\\cdot -\\left [ -\\begin{matrix} -sx & 0 & 0\\\\ -0 & sy & 0\\\\ -0 & 0 & 1 -\\end{1} -\\right ] -$$) +![](http://ww4.sinaimg.cn/large/006tKfTcly1fdz7mv29jhj30gg02374b.jpg) #### 2.仅用post: -``` java +```java +// 使用post， M‘ = T*S*M = T*S Matrix m ＝ new Matrix(); m.reset(); -m.postScale(sx, sy); //使用post，越靠前越先执行。 +m.postScale(sx, sy); //，越靠前越先执行。 m.postTranslate(tx, ty); ``` 用矩阵表示: -![](http://latex.codecogs.com/png.latex? -$$ -\\left [ -\\begin{matrix} - & &\\\\ - & Result Matrix &\\\\ - & & -\\end{1} -\\right ] - = -\\left [ -\\begin{matrix} -1 & 0 & \\Delta x \\\\ -0 & 1 & \\Delta y \\\\ -0 & 0 & 1 -\\end{1} -\\right ] -\\cdot -\\left [ -\\begin{matrix} -sx & 0 & 0\\\\ -0 & sy & 0\\\\ -0 & 0 & 1 -\\end{1} -\\right ] -\\cdot - \\left [ -\\begin{matrix} - & &\\\\ - & Initial Matrix &\\\\ - & & -\\end{1} -\\right ] -$$) +![](http://ww1.sinaimg.cn/large/006tKfTcly1fdz7nde6gcj30gh020dfv.jpg) #### 3.混合: -``` java +```java +// 混合 M‘ = T*M*S = T*S Matrix m ＝ new Matrix(); m.reset(); m.preScale(sx, sy); @@ -561,7 +443,8 @@ m.postTranslate(tx, ty); 或: -``` java +```java +// 混合 M‘ = T*M*S = T*S Matrix m ＝ new Matrix(); m.reset(); m.postTranslate(tx, ty); @@ -572,77 +455,42 @@ m.preScale(sx, sy); 用矩阵表示: -![](http://latex.codecogs.com/png.latex? -$$ -\\left [ -\\begin{matrix} - & &\\\\ - & Result Matrix &\\\\ - & & -\\end{1} -\\right ] - = -\\left [ -\\begin{matrix} -1 & 0 & \\Delta x \\\\ -0 & 1 & \\Delta y \\\\ -0 & 0 & 1 -\\end{1} -\\right ] -\\cdot - \\left [ -\\begin{matrix} - & &\\\\ - & Initial Matrix &\\\\ - & & -\\end{1} -\\right ] -\\cdot -\\left [ -\\begin{matrix} -sx & 0 & 0\\\\ -0 & sy & 0\\\\ -0 & 0 & 1 -\\end{1} -\\right ] -$$) - - -**注意: 由于矩阵乘法不满足交换律，请保证初始矩阵为空，如果初始矩阵不为空，则导致运算结果不同。** - - -

+![](http://ww4.sinaimg.cn/large/006tKfTcly1fdz7o3i9kfj30gh021aa3.jpg) + +**注意: 由于矩阵乘法不满足交换律，请保证初始矩阵为单位矩阵，如果初始矩阵不为单位矩阵，则导致运算结果不同。** + +上面虽然用了很多不同的写法，但最终的化简公式是一样的，这些不同的写法，都是根据同一个公式反向推算出来的。 + ## Matrix方法表 这个方法表，暂时放到这里让大家看看，方法的使用讲解放在下一篇文章中。 -方法类别 | 相关API | 摘要 ------------|---------------------------------------------------------|------------------------ -基本方法 | equals hashCode toString toShortString | 比较、 获取哈希值、 转换为字符串 -数值操作 | set reset setValues getValues | 设置、 重置、 设置数值、 获取数值 -数值计算 | mapPoints mapRadius mapRect mapVectors | 计算变换后的数值 -设置(set) | setConcat setRotate setScale setSkew setTranslate | 设置变换 -前乘(pre) | preConcat preRotate preScale preSkew preTranslate | 前乘变换 -后乘(post) | postConcat postRotate postScale postSkew postTranslate | 后乘变换 -特殊方法 | setPolyToPoly setRectToRect rectStaysRect setSinCos | 一些特殊操作 -矩阵相关 | invert isAffine isIdentity | 求逆矩阵、 是否为仿射矩阵、 是否为单位矩阵 ... - -

+| 方法类别 | 相关API | 摘要 | +| -------- | ---------------------------------------- | -------------------------- | +| 基本方法 | equals hashCode toString toShortString | 比较、 获取哈希值、 转换为字符串 | +| 数值操作 | set reset setValues getValues | 设置、 重置、 设置数值、 获取数值 | +| 数值计算 | mapPoints mapRadius mapRect mapVectors | 计算变换后的数值 | +| 设置(set) | setConcat setRotate setScale setSkew setTranslate | 设置变换 | +| 前乘(pre) | preConcat preRotate preScale preSkew preTranslate | 前乘变换 | +| 后乘(post) | postConcat postRotate postScale postSkew postTranslate | 后乘变换 | +| 特殊方法 | setPolyToPoly setRectToRect rectStaysRect setSinCos | 一些特殊操作 | +| 矩阵相关 | invert isAffine isIdentity | 求逆矩阵、 是否为仿射矩阵、 是否为单位矩阵 ... | + ## 总结 对于Matrix重在理解，理解了其中的原理之后用起来将会更加得心应手。 -**学完了本篇之后，推荐配合鸿洋大大的视频课程 [ -打造个性的图片预览与多点触控](http://www.imooc.com/learn/239) 食用，定然能够让你对Matrix对理解更上一层楼。** +学完了本篇之后，推荐配合鸿洋大大的视频课程 [ +打造个性的图片预览与多点触控](http://www.imooc.com/learn/239) 食用，定然能够让你对Matrix对理解更上一层楼。 + +由于个人水平有限，文章中可能会出现错误，如果你觉得哪一部分有错误，或者发现了错别字等内容，欢迎在评论区告诉我，另外，据说关注 [作者微博](http://weibo.com/GcsSloop) 不仅能第一时间收到新文章消息，还能变帅哦。 -

-## About Me +## About -### 作者微博: [@GcsSloop](http://weibo.com/GcsSloop) +[本系列相关文章](http://www.gcssloop.com/customview/CustomViewIndex/) - +作者微博: [GcsSloop](http://weibo.com/GcsSloop) -

## 参考资料 [Matrix](https://developer.android.com/reference/android/graphics/Matrix.html)
@@ -653,4 +501,3 @@ $$) [维基百科-线性映射](https://zh.wikipedia.org/wiki/%E7%BA%BF%E6%80%A7%E6%98%A0%E5%B0%84)
[齐次坐标系入门级思考](https://oncemore2020.github.io/blog/homogeneous/)
[仿射变换与齐次坐标](https://guangchun.wordpress.com/2011/10/12/affineandhomogeneous/)
-[]()
diff --git a/CustomView/Advance/[10]Matrix_Method.md b/CustomView/Advance/[10]Matrix_Method.md index 6d7b0a0c..3254f4bb 100644 --- a/CustomView/Advance/[10]Matrix_Method.md +++ b/CustomView/Advance/[10]Matrix_Method.md @@ -40,16 +40,7 @@ Matrix matrix = new Matrix(); 通过这种方式创建出来的并不是一个数值全部为空的矩阵，而是一个单位矩阵,如下: -![](http://latex.codecogs.com/png.latex?$$ -\\left [ -\\begin{matrix} -1 & 0 & 0 \\\\ -0 & 1 & 0 \\\\ -0 & 0 & 1 -\\end{1} -\\right ] -$$) - +![](https://ww2.sinaimg.cn/large/006tKfTcgy1fhe1potuf8j302301z3yf.jpg) #### 有参构造 diff --git a/CustomView/Advance/[11]Matrix_3D_Camera.md b/CustomView/Advance/[11]Matrix_3D_Camera.md index 0e4c83b6..e59848c0 100644 --- a/CustomView/Advance/[11]Matrix_3D_Camera.md +++ b/CustomView/Advance/[11]Matrix_3D_Camera.md @@ -16,7 +16,7 @@ | 基本方法 | save、restore | 保存、 回滚 | | 常用方法 | getMatrix、applyToCanvas | 获取Matrix、应用到画布 | | 平移 | translate | 位移 | -| 旋转 | rotat (API 12)、rotateX、rotateY、rotateZ | 各种旋转 | +| 旋转 | rotate (API 12)、rotateX、rotateY、rotateZ | 各种旋转 | | 相机位置 | setLocation (API 12)、getLocationX (API 16)、getLocationY (API 16)、getLocationZ (API 16) | 设置与获取相机位置 | > Camera的方法并不是特别多，很多内容与之前的讲解的Canvas和Matrix类似，不过又稍有不同，之前的画布操作和Matrix主要是作用于2D空间，而Camera则主要作用于3D空间。 @@ -71,7 +71,9 @@ ![](http://ww4.sinaimg.cn/large/005Xtdi2jw1f7q71yek4wg308c058go5.gif) -> 摄像机的位置默认是 (0, 0, -576)。其中 -576＝ -8 x 72，虽然官方文档说距离屏幕的距离是 -8, 但经过测试实际距离是 -576 像素，当距离为 -10 的时候，实际距离为 -720 像素。不过这个数值72我也不明白是什么东西，我使用了3款手机测试，屏幕大小和像素密度均不同，但结果都是一样的，知道的小伙伴可以告诉我一声。 +> 摄像机的位置默认是 (0, 0, -576)。其中 -576＝ -8 x 72，虽然官方文档说距离屏幕的距离是 -8, 但经过测试实际距离是 -576 像素，当距离为 -10 的时候，实际距离为 -720 像素。我使用了3款手机测试，屏幕大小和像素密度均不同，但结果都是一样的。 +> +> 这个魔数可以在 Android 底层的图像引擎 Skia 中找到。在 Skia 中，Camera 的位置单位是英寸，英寸和像素的换算单位在 Skia 中被固定为 72 像素，而 Android 中把这个换算单位照搬了过来。 diff --git a/CustomView/Advance/[12]Dispatch-TouchEvent-Theory.md b/CustomView/Advance/[12]Dispatch-TouchEvent-Theory.md new file mode 100644 index 00000000..47b33077 --- /dev/null +++ b/CustomView/Advance/[12]Dispatch-TouchEvent-Theory.md @@ -0,0 +1,314 @@ +# 事件分发机制原理 + + +之前讲解了很多与View绘图相关的知识，你可以在 [安卓自定义View教程目录](http://www.gcssloop.com/customview/CustomViewIndex) 中查看到这些文章，如果你理解了这些文章，那么至少2D绘图部分不是难题了，大部分的需求都能满足，但是关于View还有很多知识点，例如: `让绘图更加炫酷的Paint`，`让View动起来的动画`，`与用户交互的触控事件` 等一系列内容。**本次就带大家简单的了解一下与交互息息相关的东西－事件分发原理**。 + +> 本次魔法小火车的终点站是事件分发，请各位魔法师带好装备，准备登车启程。 + +**注意：本文中所有源码分析部分均基于 API23(Android 6.0) 版本，由于安卓系统源码改变很多，可能与之前版本有所不同，但基本流程都是一致的。** + + + +## 为什么要有事件分发机制？ + +**安卓上面的View是树形结构的，View可能会重叠在一起，当我们点击的地方有多个View都可以响应的时候，这个点击事件应该给谁呢？为了解决这一个问题，就有了事件分发机制。** + +如下图，View是一层一层嵌套的，当手指点击 `View1` 的时候，下面的`ViewGroupA`、 `RootView` 等也是能够响应的，为了确定到底应该是哪个View处理这次点击事件，就需要事件分发机制来帮忙。 + +![](http://ww1.sinaimg.cn/large/005Xtdi2jw1f87nsnluf5j308c0eamxg.jpg) + + + +## View的结构: + +我们的View是树形结构的，在上一个问题中实例View的结构大致如下: + +**layout文件:** + +```XML + + + + + + + + + + + +``` + + + +**View结构:** + +![](http://ww4.sinaimg.cn/large/005Xtdi2jw1f87juodlepj308q09ut8v.jpg) + +**可以看到在上面的View结构中莫名多出来的两个东西，`PhoneWindow` 和 `DecorView` ，这两个我们并没有在Layout文件中定义过，但是为什么会存在呢？** + +> 仔细观察上面的 layout 文件，你会发现一个问题，我在 layout 文件中的最顶层 View(Group) 的大小并不是填满父窗体的，留下了大量的空白区域，由于我们的手机屏幕不能透明，所以这些空白区域肯定要显示一些东西，那么应该显示什么呢？ +> +> 有过安卓开发经验的都知道，屏幕上没有View遮挡的部分会显示主题的颜色。不仅如此，最上面的一个标题栏也没有在 layout 文件中，这个标题栏又是显示在哪里的呢？ +> +> **你没有猜错，这个主题颜色和标题栏等内容就是显示在`DecorView`中的。** + + + +**现在知道 `DecorView` 是干什么的了，那么`PhoneWindow` 又有什么作用？** + +> 要了解 PhoneWindow 是干啥的，首先要了解啥是 Window ，看官方说明： +> +> Abstract base class for a top-level window look and behavior policy. An instance of this class should be used as the top-level view added to the window manager. It provides standard UI policies such as a background, title area, default key processing, etc. +> +> +> 简单来说，Window是一个抽象类，是所有视图的最顶层容器，视图的外观和行为都归他管，不论是背景显示，标题栏还是事件处理都是他管理的范畴，它其实就像是View界的太上皇(虽然能管的事情看似很多，但是没实权，因为抽象类不能直接使用)。 +> +> 而 PhoneWindow 作为 Window 的唯一亲儿子(唯一实现类)，自然就是 View 界的皇帝了，PhoneWindow 的权利可是非常大大，不过对于我们来说用处并不大，因为皇帝平时都是躲在深宫里面的，虽然偶尔用特殊方法能见上一面，但想要完全指挥 PhoneWindow 为你工作是很困难的。 +> +> 而上面说的 DecorView 是 PhoneWindow 的一个内部类，其职位相当于小太监，就是跟在 PhoneWindow 身边专业为 PhoneWindow 服务的，除了自己要干活之外，也负责消息的传递，PhoneWindow 的指示通过 DecorView 传递给下面的 View，而下面 View 的信息也通过 DecorView 回传给 PhoneWindow。 + + +## 事件分发、拦截与消费 + +下表省略了 PhoneWidow 和 DecorView。 + +> `√` 表示有该方法。 +> +> `X` 表示没有该方法。 + +| 类型 | 相关方法 | Activity | ViewGroup | View | +| :--: | :-------------------: | :------: | :-------: | :--: | +| 事件分发 | dispatchTouchEvent | √ | √ | √ | +| 事件拦截 | onInterceptTouchEvent | X | √ | X | +| 事件消费 | onTouchEvent | √ | √ | √ | + + +这个三个方法均有一个 boolean(布尔) 类型的返回值，通过返回 true 和 false 来控制事件传递的流程。 + +PS: 从上表可以看到 Activity 和 View 都是没有事件拦截的，这是因为： + +> Activity 作为原始的事件分发者，如果 Activity 拦截了事件会导致整个屏幕都无法响应事件，这肯定不是我们想要的效果。 +> +> View最为事件传递的最末端，要么消费掉事件，要么不处理进行回传，根本没必要进行事件拦截。 + + + +## 事件分发流程 + +前面我们了解到了我们的View是树形结构的，基于这样的结构，我们的事件可以进行有序的分发。 + +事件收集之后最先传递给 Activity， 然后依次向下传递，大致如下： + +``` +Activity －> PhoneWindow －> DecorView －> ViewGroup －> ... －> View +``` + +这样的事件分发机制逻辑非常清晰，可是，你是否注意到一个问题？如果最后分发到View，如果这个View也没有处理事件怎么办，就这样让事件浪费掉？ + +当然不会啦，如果没有任何View消费掉事件，那么这个事件会按照反方向回传，最终传回给Activity，如果最后 Activity 也没有处理，本次事件才会被抛弃: + +``` +Activity <－ PhoneWindow <－ DecorView <－ ViewGroup <－ ... <－ View +``` + +**看到这里，我不禁微微一皱眉，这个东西咋看起来那么熟悉呢？再仔细一看，这不就是一个非常经典的[责任链模式](https://zh.wikipedia.org/wiki/%E8%B4%A3%E4%BB%BB%E9%93%BE%E6%A8%A1%E5%BC%8F)吗，** 如果我能处理就拦截下来自己干，如果自己不能处理或者不确定就交给责任链中下一个对象。 + +**这种设计是非常精巧的，上层View既可以直接拦截该事件，自己处理，也可以先询问(分发给)子View，如果子View需要就交给子View处理，如果子View不需要还能继续交给上层View处理。既保证了事件的有序性，又非常的灵活。在我第一次将这个逻辑弄清楚的时候，看着这样精妙的设计，简直想欢呼庆贺一下。** + +其实关于事件传递机制，吴小龙的 [Android事件传递机制分析](http://wuxiaolong.me/2015/12/19/MotionEvent/) 一文中的比喻非常有趣，本文也会借鉴一些其中的内容。 + +先确定几个角色： + +> Activity － 公司大老板 +> +> RootView － 项目经理 +> +> ViewGroupA － 技术小组长 +> +> View1 － 码农小王(公司里唯一的码农) +> +> View2 － 跑龙套的路人甲，无视即可 + +**PS：由于 PhoneWindow 和 DecorView 我们无法直接操作，以下所有示例均省略了 PhoneWindow 和 DecorView。** + + + +### 1.点击 View1 区域但没有任何 View 消费事件 + +![](http://ww1.sinaimg.cn/large/005Xtdi2jw1f87nsnluf5j308c0eamxg.jpg) + +当手指在 `View1` 区域点击了一下之后，如果所有View都不消耗事件，你就能看到一个完整的事件分发流程，大致如下： + +> 红色箭头方向表示事件分发方向。 +> +> 绿色箭头方向表示事件回传方向。 + +![](http://ww2.sinaimg.cn/large/005Xtdi2jw1f88i0q8uozj30nm0kqwhm.jpg) + + +> **注意: 上图显示分发流程仅仅是一个示意流程，并不代表实际情况，如果按照实际情况绘制，会导致流程图非常复杂和混乱，在纠结了好久之后做了一个艰难的决定，采用这样一个简化后的流程。** +> +> 上面的流程中存在部分不合理内容，请大家选择性接受。 +> +> 1. 事件返回时 `dispatchTouchEvent` 直接指向了父View的 `onTouchEvent` 这一部分是不合理的，实际上它仅仅是给了父View的 `dispatchTouchEvent` 一个 false 返回值，父View根据返回值来调用自身的 `onTouchEvent`。 +> 2. ViewGroup 是根据 `onInterceptTouchEvent` 的返回值来确定是调用子View的 `dispatchTouchEvent` 还是自身的 `onTouchEvent`， 并没有将调用交给 `onInterceptTouchEvent`。 +> 3. ViewGroup 的事件分发机制伪代码如下，可以看出调用的顺序。 +> +> ```java +> public boolean dispatchTouchEvent(MotionEvent ev) { +> boolean result = false; // 默认状态为没有消费过 +> +> if (!onInterceptTouchEvent(ev)) { // 如果没有拦截交给子View +> result = child.dispatchTouchEvent(ev); +> } +> +> if (!result) { // 如果事件没有被消费,询问自身onTouchEvent +> result = onTouchEvent(ev); +> } +> +> return result; +> } +> ``` + +**测试:** + +> **情景：老板: 我看公司最近业务不咋地，准备发展一下电商业务，下周之前做个淘宝出来试试怎么样。** +> +> **事件顺序，老板(MainActivity)要做淘宝，这个事件通过各个部门(ViewGroup)一层一层的往下传，传到最底层的时候，码农小王(View1)发现做不了，于是消息又一层一层的回传到老板那里。** +> +> 可以看到整个事件传递路线非常有序。从Activity开始，最后回传给Activity结束(由于我们无法操作Phone Window和DecorView，所以没有它们的信息)。 + +``` +MainActivity [老板]: dispatchTouchEvent 经理,我准备发展一下电商业务,下周之前做一个淘宝出来. +RootView     [经理]: dispatchTouchEvent 呼叫技术部,老板要做淘宝,下周上线. +RootView     [经理]: onInterceptTouchEvent (老板可能疯了,但又不是我做.) +ViewGroupA   [组长]: dispatchTouchEvent 老板要做淘宝,下周上线? +ViewGroupA   [组长]: onInterceptTouchEvent (看着不太靠谱,先问问小王怎么看) +View1        [码农]: dispatchTouchEvent 做淘宝??? +View1        [码农]: onTouchEvent 这个真心做不了啊. +ViewGroupA   [组长]: onTouchEvent 小王说做不了. +RootView     [经理]: onTouchEvent 报告老板, 技术部说做不了. +MainActivity [老板]: onTouchEvent 这么简单都做不了,你们都是干啥的(愤怒). +``` + + + +### 2.点击 View1 区域且事件被 View1 消费 + +如果事件被View1消费掉了则事件会回传告诉上层View这个事件已经被我解决了，上层View就无需再响应了。 + +![](http://ww2.sinaimg.cn/large/005Xtdi2jw1f88ll27wv9j30nm0kqtbo.jpg) + +> 注意：这张图中的事件回传路径才是正确的路径。 + +**测试:** + +> **情景：老板: 我觉得咱们这个app按钮不好看，做的有光泽一点，要让人有一种想点的欲望。** +> +> **事件顺序，老板(MainActivity)要做改界面，这个事件通过各个部门(ViewGroup)一层一层的往下传，传到最底层的时候，码农小王(View1)就在按钮上添加了一道光(为啥是小王呢？因为公司没有设计师)。** +> +> 可以看出，事件一旦被消费就意味着消息传递的结束，上层View知道了事件已经被消费掉，就不再处理了。 + +``` +MainActivity [老板]: dispatchTouchEvent 把按钮做的好看一点,要有光泽,给人一种点击的欲望. +RootView     [经理]: dispatchTouchEvent 技术部,老板说按钮不好看,要加一道光. +RootView     [经理]: onInterceptTouchEvent +ViewGroupA   [组长]: dispatchTouchEvent 给按钮加上一道光. +ViewGroupA   [组长]: onInterceptTouchEvent +View1        [码农]: dispatchTouchEvent 加一道光. +View1        [码农]: onTouchEvent 做好了. +``` + +> 加一道光： +> +> ![](http://ww4.sinaimg.cn/large/005Xtdi2jw1f88oqj0o4jj304j03paa4.jpg) + + + +### 3.点击 View1 区域但事件被 ViewGroupA 拦截 + +> 上层的View有权拦截事件，不传递给下层View，例如 ListView 滑动的时候，就不会将事件传递给下层的子 View。 + +![](http://ww4.sinaimg.cn/large/005Xtdi2jw1f88p3r45vfj30nm0kqn00.jpg) + +> 注意：可以看到，如果上层拦截了事件，下层View将接收不到事件信息。 + +**测试：** + +> **情景：老板: 报告一下项目进度。** +> +> **事件顺序，老板(MainActivity)要知道项目进度，这个事件通过各个部门(ViewGroup)一层一层的往下传，传到技术组组长(ViewGroupA)的时候，组长(ViewGroupA)上报任务即可。无需告知码农小王(View1)。** + +``` +MainActivity [老板]: dispatchTouchEvent 现在项目做到什么程度了? +RootView     [经理]: dispatchTouchEvent 技术部,你们的app快做完了么? +RootView     [经理]: onInterceptTouchEvent +ViewGroupA   [组长]: dispatchTouchEvent 项目进度? +ViewGroupA   [组长]: onInterceptTouchEvent +ViewGroupA   [组长]: onTouchEvent 正在测试,明天就测试完了 +``` + +### 其他情况 + +事件分发机制设计到到情形非常多，这里就不一一列举了，记住以下几条原则就行了。 + +* 1.如果事件被消费，就意味着事件信息传递终止。 +* 2.如果事件一直没有被消费，最后会传给Activity，如果Activity也不需要就被抛弃。 +* 3.判断事件是否被消费是根据返回值，而不是根据你是否使用了事件。 + + +#### [文中测试用的源码下载](https://raw.githubusercontent.com/GcsSloop/AndroidNote/master/CustomView/Demo/dispatchTouchEventDemo.zip) + +## 总结 + +View的事件分发机制实际上就是一个非常经典的责任链模式，如果你了解责任链模式，那么事件分发对你来说并不是什么难题，如果你不了解责任链模式，刚好借此机会学习一下啦。 + +> **责任链模式：** +> +> 当有多个对象均可以处理同一请求的时候，将这些对象串联成一条链，并沿着这条链传递改请求，直到有对象处理它为止。 + +Android 中事件分发机制原理虽然非常简单，但由于实际场景非常复杂，一旦具体到某个场景中变得很麻烦，而本文仅仅是带你简单的了解一下事件分发机制，更详细的内容和具体的一些特殊情形处理会在后续文章中进行讲解。 + +由于个人水平有限，文章中可能会出现错误，如果你觉得哪一部分有错误，或者发现了错别字等内容，欢迎在评论区告诉我，另外，据说关注[作者微博](http://weibo.com/GcsSloop)不仅能第一时间收到新文章消息，还能变帅哦。 + + + +## 参考资料 + +[Activity](https://android.googlesource.com/platform/frameworks/base/+/master/core/java/android/app/Activity.java)
+[PhoneWindow](https://android.googlesource.com/platform/frameworks/base/+/696cba573e651b0e4f18a4718627c8ccecb3bda0/policy/src/com/android/internal/policy/impl/PhoneWindow.java)
+[ViewGroup](https://android.googlesource.com/platform/frameworks/base/+/master/core/java/android/view/ViewGroup.java)
+[View](https://android.googlesource.com/platform/frameworks/base/+/master/core/java/android/view/View.java)
+[Android事件传递机制分析](http://wuxiaolong.me/2015/12/19/MotionEvent/)
+[Android ViewGroup/View 事件分发机制详解](http://anany.me/2015/11/08/touchevent/)
+[ Android事件分发机制完全解析，带你从源码的角度彻底理解(上)](http://blog.csdn.net/guolin_blog/article/details/9097463)
+[ Android事件分发机制完全解析，带你从源码的角度彻底理解(下)](http://blog.csdn.net/sinyu890807/article/details/9153747)
+[更简单的学习Android事件分发](http://www.idtkm.com/customview/customview11/)
+《安卓开发艺术探索》 + + + +## About Me + +### 作者微博: @GcsSloop + + + diff --git a/CustomView/Advance/[12]TouchEvent.md b/CustomView/Advance/[12]TouchEvent.md deleted file mode 100644 index fd411729..00000000 --- a/CustomView/Advance/[12]TouchEvent.md +++ /dev/null @@ -1,2 +0,0 @@ -# 事件分发 - diff --git a/CustomView/Advance/[15]Dispatch-TouchEvent-Source.md b/CustomView/Advance/[15]Dispatch-TouchEvent-Source.md new file mode 100644 index 00000000..b31bb10b --- /dev/null +++ b/CustomView/Advance/[15]Dispatch-TouchEvent-Source.md @@ -0,0 +1,548 @@ +# 事件分发机制详解 + +在上一篇文章 [事件分发机制原理][dispatch-touchevent-theory] 中简要分析了一下事件分发机制的原理，原理是十分简单的，一句话就能总结：**责任链模式，事件层层传递，直到被消费。** 虽然原理简单，但是随着 Android 不断的发展，实际运用场景也越来越复杂，所以想要彻底玩转事件分发机制还需要一定技巧，本篇事件分发机制详解将带大家了解 ... + +> **你以为我接下来要讲源码？** +> 我就不按套路，所有的源码都是为了适应具体的应用场景而写的，只要能够理解运用场景，理解源码也就十分简单了。所以本篇的核心问题是：**正确理解在实际场景中事件分发机制的作用。** 会涉及到源码，但不是主角。 + +**注意：本文中所有源码分析部分均基于 API23(Android 6.0) 版本，由于安卓系统源码改变很多，可能与之前版本有所不同，但基本流程都是一致的。** + + + +## 常见事件 + +既然是事件分发，总要有事件才能分发吧，所以我们先了解一下常见的几种事件。 + +根据面向对象思想，事件被封装成 MotionEvent 对象，由于本篇重点不在于此，所以只会涉及到几个与手指触摸相关的常见事件: + +| 事件 | 简介 | +| ------------- | ------------------------- | +| ACTION_DOWN | 手指 **初次接触到屏幕** 时触发。 | +| ACTION_MOVE | 手指 **在屏幕上滑动** 时触发，会会多次触发。 | +| ACTION_UP | 手指 **离开屏幕** 时触发。 | +| ACTION_CANCEL | 事件 **被上层拦截** 时触发。 | + +对于单指触控来说，一次简单的交互流程是这样的: + +**手指落下(ACTION_DOWN) －> 移动(ACTION_MOVE) －> 离开(ACTION_UP)** + +> * 本次事例中 ACTION_MOVE 有多次触发。 +> * 如果仅仅是单击(手指按下再抬起)，不会触发 ACTION_MOVE。 + +![](http://ww4.sinaimg.cn/large/005Xtdi2jw1f8oz1704ylg30bo0jqgmx.gif) + +## 事件分发、拦截与消费 + +关于这一部分内容，上一篇文章 [事件分发机制原理][dispatch-touchevent-theory] 已经将流程整理的比较清楚了，本文会深入细节来研究这些内容。之所以分开讲，是为了防止大家被细节所迷惑而忽略了整体逻辑。 + +> `√` 表示有该方法。 +> +> `X` 表示没有该方法。 + +| 类型 | 相关方法 | ViewGroup | View | +| :--: | :-------------------: | :-------: | :--: | +| 事件分发 | dispatchTouchEvent | √ | √ | +| 事件拦截 | onInterceptTouchEvent | √ | X | +| 事件消费 | onTouchEvent | √ | √ | + + + +### View 相关 + +`dispatchTouchEvent` 是事件分发机制中的核心，所有的事件调度都归它管。不过我细看表格， ViewGroup 有 dispatchTouchEvent 也就算了，毕竟人家有一堆 ChildView 需要管理，但为啥 View 也有？这就引出了我们的第一个疑问。 + +#### Q: 为什么 View 会有 dispatchTouchEvent ? + +A: 我们知道 View 可以注册很多事件监听器，例如：单击事件(onClick)、长按事件(onLongClick)、触摸事件(onTouch)，并且View自身也有 onTouchEvent 方法，那么问题来了，这么多与事件相关的方法应该由谁管理？毋庸置疑就是 `dispatchTouchEvent`，所以 View 也会有事件分发。 + +相信看到这里很多小伙伴会产生第二个疑问，View 有这么多事件监听器，到底哪个先执行？ + +#### Q: 与 View 事件相关的各个方法调用顺序是怎样的？ + +A: **如果不去看源码，想一下让自己设计会怎样？** + +* 单击事件(onClickListener) 需要两个两个事件(ACTION_DOWN 和 ACTION_UP )才能触发，如果先分配给onClick判断，等它判断完，用户手指已经离开屏幕，黄花菜都凉了，定然造成 View 无法响应其他事件，应该最后调用。(最后) +* 长按事件(onLongClickListener) 同理，也是需要长时间等待才能出结果，肯定不能排到前面，但因为不需要ACTION_UP，应该排在 onClick 前面。(onLongClickListener > onClickListener) +* 触摸事件(onTouchListener) 如果用户注册了触摸事件，说明用户要自己处理触摸事件了，这个应该排在最前面。(最前) +* View自身处理(onTouchEvent) 提供了一种默认的处理方式，如果用户已经处理好了，也就不需要了，所以应该排在 onTouchListener 后面。(onTouchListener > onTouchEvent) + +**所以事件的调度顺序应该是 `onTouchListener > onTouchEvent > onLongClickListener > onClickListener`**。 + +![](http://ww2.sinaimg.cn/large/005Xtdi2jw1f8r8jg9mw5j308y07mglw.jpg) + +下面我们来看一下实际测试结果: + +> 手指按下，不移动，稍等片刻再抬起。 + +```shell +[Listener ]: onTouchListener ACTION_DOWN +[GcsView  ]: onTouchEvent ACTION_DOWN +[Listener ]: onLongClickListener +[Listener ]: onTouchListener ACTION_UP +[GcsView  ]: onTouchEvent ACTION_UP +[Listener ]: onClickListener +``` + +可以看到，测试结果也支持我们猜测的结论，因为长按 onLongClickListener 不需要 ACTION_UP 所以会在 ACTION_DOWN 之后就触发。 + +接下来就看一下源码是怎么设计的(省略了大量无关代码)： + +```java +public boolean dispatchTouchEvent(MotionEvent event) { + ... + boolean result = false; // result 为返回值，主要作用是告诉调用者事件是否已经被消费。 + if (onFilterTouchEventForSecurity(event)) { + ListenerInfo li = mListenerInfo; + /** + * 如果设置了OnTouchListener，并且当前 View 可点击，就调用监听器的 onTouch 方法， + * 如果 onTouch 方法返回值为 true，就设置 result 为 true。 + */ + if (li != null && li.mOnTouchListener != null + && (mViewFlags & ENABLED_MASK) == ENABLED + && li.mOnTouchListener.onTouch(this, event)) { + result = true; + } + + /** + * 如果 result 为 false，则调用自身的 onTouchEvent。 + * 如果 onTouchEvent 返回值为 true，则设置 result 为 true。 + */ + if (!result && onTouchEvent(event)) { + result = true; + } + } + ... + return result; +} +``` + +> **如果觉得源码还是太长，那么用伪代码实现应当是这样的(省略若干安全判断)，简单粗暴:** +> +> ```java +> public boolean dispatchTouchEvent(MotionEvent event) { +> if (mOnTouchListener.onTouch(this, event)) { +> return true; +> } else if (onTouchEvent(event)) { +> return true; +> } +> return false; +> } +> ``` + +正当你沉迷在源码的"精妙"逻辑的时候，你可能没发现有两个东西失踪了，等回过神来，定睛一看，哎呦妈呀，**OnClick 和 OnLongClick 去哪里了？** + +不要担心，OnClick 和 OnLongClick 的具体调用位置在 **onTouchEvent** 中，看源码(同样省略大量无关代码): + +```java +public boolean onTouchEvent(MotionEvent event) { + ... + final int action = event.getAction(); + // 检查各种 clickable + if (((viewFlags & CLICKABLE) == CLICKABLE || + (viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE) || + (viewFlags & CONTEXT_CLICKABLE) == CONTEXT_CLICKABLE) { + switch (action) { + case MotionEvent.ACTION_UP: + ... + removeLongPressCallback(); // 移除长按 + ... + performClick(); // 检查单击 + ... + break; + case MotionEvent.ACTION_DOWN: + ... + checkForLongClick(0); // 检测长按 + ... + break; + ... + } + return true; // ◀︎表示事件被消费 + } + return false; +} +``` + +> **注意了，第一个重点要出现了(敲黑板)!** +> +> ![](http://ww3.sinaimg.cn/large/005Xtdi2jw1f8p431ehi3j304w04wmx1.jpg) +> +> **注意上面代码中存在一个 `return true;` 并且是只要 View 可点击就返回 true，就表示事件被消费了。** +> +> 举个栗子: I have a **RelativeLayout**，I have a **View**，Ugh，**RelativeLayout - View** +> +> ```xml +> android:background="#CCC" +> android:id="@+id/layout" +> android:onClick="myClick" +> android:layout_width="200dp" +> android:layout_height="200dp"> +> android:clickable="true" +> android:layout_width="200dp" +> android:layout_height="200dp" /> +> +> ``` +> +> 现在你有了一个 **RelativeLayout - View** 你开开心心的为 RelativeLayout 设置了一个点击事件`myClick`，然而你会发现不论怎么点都不会接收到信息，仔细一看，发现内部的 View 有一个属性 `android:clickable="true"` 正是这个看似不起眼的属性把事件给消费掉了，由此我们可以得出如下结论: +> **1. 不论 View 自身是否注册点击事件，只要 View 是可点击的就会消费事件。** +> **2. 事件是否被消费由返回值决定，true 表示消费，false 表示不消费，与是否使用了事件无关。** + +关于 View 的事件分发先说这么多，下面我们来看一下 ViewGroup 的事件分发。 + + + +### ViewGroup 相关 + +**ViewGroup(通常是各种Layout) 的事件分发相对来说就要麻烦一些，因为 ViewGroup 不仅要考虑自身，还要考虑各种 ChildView，一旦处理不好就容易引起各种事件冲突，正所谓养儿方知父母难啊。** + +#### VIewGroup 的事件分发流程又是如何的呢？ + + 上一篇文章 [事件分发机制原理][dispatch-touchevent-theory] 中我们了解到事件是通过ViewGroup一层一层传递的，最终传递给 View，ViewGroup 要比它的 ChildView 先拿到事件，并且有权决定是否告诉要告诉 ChildView。在默认的情况下 ViewGroup 事件分发流程是这样的。 + +* 1.判断自身是否需要(询问 onInterceptTouchEvent 是否拦截)，如果需要，调用自己的 onTouchEvent。 +* 2.自身不需要或者不确定，则询问 ChildView ，一般来说是调用手指触摸位置的 ChildView。 +* 3.如果子 ChildView 不需要则调用自身的 onTouchEvent。 + + +用伪代码应该是这样的: + +```java +public boolean dispatchTouchEvent(MotionEvent ev) { + boolean result = false; // 默认状态为没有消费过 + + if (!onInterceptTouchEvent(ev)) { // 如果没有拦截交给子View + result = child.dispatchTouchEvent(ev); + } + + if (!result) { // 如果事件没有被消费,询问自身onTouchEvent + result = onTouchEvent(ev); + } + + return result; +} +``` + +**有人看到这里可能会有疑问，我看过源码，ViewGroup 的 `dispatchTouchEvent` 可有二百多行呢，你弄这几行就想忽悠我，别以为我读书少。** + +当然了，上述源码是不完善的，还有很多问题是没有解决的，例如: + +##### 1. ViewGroup 中可能有多个 ChildView，如何判断应该分配给哪一个？ + +这个很容易，就是把所有的 ChildView 遍历一遍，如果手指触摸的点在 ChildView 区域内就分发给这个View。 + +##### 2. 当该点的 ChildView 有重叠时应该如何分配？ + +当 ChildView 重叠时，**一般会分配给显示在最上面的 ChildView**。 +如何判断哪个是显示在最上面的呢？后面加载的一般会覆盖掉之前的，所以**显示在最上面的是最后加载的**。 + +如下: + +```xml + + + + +``` + +![](http://ww2.sinaimg.cn/large/005Xtdi2jw1f8r0i301sgj308w0fmwez.jpg) + +当手指点击有重叠区域时，分如下几种情况: + +1. 只有 View1 可点击时，事件将会分配给 View1，即使被 View2 遮挡，这一部分仍是 View1 的可点击区域。 +2. 只有 View2 可点击时，事件将会分配给 View2。 +3. View1 和 View2 均可点击时，事件会分配给后加载的 View2，View2 将事件消费掉，View1接收不到事件。 + +**注意:** + +* 上面说的是可点击，可点击包括很多种情况，只要你给View注册了 `onClickListener、onLongClickListener、OnContextClickListener` 其中的任何一个监听器或者设置了 `android:clickable="true"` 就代表这个 View 是可点击的。 + 另外，某些 View 默认就是可点击的，例如，Button，CheckBox 等。 +* 给 View 注册 `OnTouchListener` 不会影响 View 的可点击状态。即使给 View 注册 `OnTouchListener` ，**只要不返回 `true` 就不会消费事件**。 + + +##### 3. ViewGroup 和 ChildView 同时注册了事件监听器(onClick等)，哪个会执行? + +事件优先给 ChildView，会被 ChildView消费掉，ViewGroup 不会响应。 + +##### 4. 所有事件都应该被同一 View 消费 + +在上面的例子中我们分析后可以了解到，同一次点击事件只能被一个 View 消费，这是为什呢？主要是为了防止事件响应混乱，如果再一次完整的事件中分别将不同的事件分配给了不同的 View 容易造成事件响应混乱。 + +> ( View 中 onClick 事件需要同时接收到 ACTION_DOWN 和 ACTION_UP 才能触发，如果分配给了不同的 View，那么 onClick 将无法被正确触发)。 + +**安卓为了保证所有的事件都是被一个 View 消费的，对第一次的事件( ACTION_DOWN )进行了特殊判断，View 只有消费了 ACTION_DOWN 事件，才能接收到后续的事件(可点击控件会默认消费所有事件)，并且会将后续所有事件传递过来，不会再传递给其他 View，除非上层 View 进行了拦截。** +**如果上层 View 拦截了当前正在处理的事件，会收到一个 ACTION_CANCEL，表示当前事件已经结束，后续事件不会再传递过来。** + + + +**源码:** + +> 其实如果能够理解上面的内容，不看源码也能非常顺利的使用事件分发，但源码中能挖掘出更多的内容。 + +```java +public boolean dispatchTouchEvent(MotionEvent ev) { + // 调试用 + if (mInputEventConsistencyVerifier != null) { + mInputEventConsistencyVerifier.onTouchEvent(ev, 1); + } + + // 判断事件是否是针对可访问的焦点视图(很晚才添加的内容，个人猜测和屏幕辅助相关，方便盲人等使用设备) + if (ev.isTargetAccessibilityFocus() && isAccessibilityFocusedViewOrHost()) { + ev.setTargetAccessibilityFocus(false); + } + + boolean handled = false; + if (onFilterTouchEventForSecurity(ev)) { + final int action = ev.getAction(); + final int actionMasked = action & MotionEvent.ACTION_MASK; + + // 处理第一次ACTION_DOWN. + if (actionMasked == MotionEvent.ACTION_DOWN) { + // 清除之前所有的状态 + cancelAndClearTouchTargets(ev); + resetTouchState(); + } + + // 检查是否需要拦截. + final boolean intercepted; + if (actionMasked == MotionEvent.ACTION_DOWN || mFirstTouchTarget != null) { + final boolean disallowIntercept = (mGroupFlags & FLAG_DISALLOW_INTERCEPT) != 0; + if (!disallowIntercept) { + intercepted = onInterceptTouchEvent(ev); // 询问是否拦截 + ev.setAction(action); // 恢复操作，防止被更改 + } else { + intercepted = false; + } + } else { + // 没有目标来处理该事件，而且也不是一个新的事件事件(ACTION_DOWN), 进行拦截。 + intercepted = true; + } + + // 判断事件是否是针对可访问的焦点视图 + if (intercepted || mFirstTouchTarget != null) { + ev.setTargetAccessibilityFocus(false); + } + + // 检查事件是否被取消(ACTION_CANCEL). + final boolean canceled = resetCancelNextUpFlag(this) + || actionMasked == MotionEvent.ACTION_CANCEL; + + final boolean split = (mGroupFlags & FLAG_SPLIT_MOTION_EVENTS) != 0; + TouchTarget newTouchTarget = null; + boolean alreadyDispatchedToNewTouchTarget = false; + + // 如果没有取消也没有被拦截 (进入事件分发) + if (!canceled && !intercepted) { + + // 如果事件是针对可访问性焦点视图，我们将其提供给具有可访问性焦点的视图。 + // 如果它不处理它，我们清除该标志并像往常一样将事件分派给所有的 ChildView。 + // 我们检测并避免保持这种状态，因为这些事非常罕见。 + View childWithAccessibilityFocus = ev.isTargetAccessibilityFocus() + ? findChildWithAccessibilityFocus() : null; + + if (actionMasked == MotionEvent.ACTION_DOWN + || (split && actionMasked == MotionEvent.ACTION_POINTER_DOWN) + || actionMasked == MotionEvent.ACTION_HOVER_MOVE) { + final int actionIndex = ev.getActionIndex(); + final int idBitsToAssign = split ? 1 << ev.getPointerId(actionIndex) + : TouchTarget.ALL_POINTER_IDS; + + // 清除此指针ID的早期触摸目标，防止不同步。 + removePointersFromTouchTargets(idBitsToAssign); + + final int childrenCount = mChildrenCount; + if (newTouchTarget == null && childrenCount != 0) { + final float x = ev.getX(actionIndex); // 获取触摸位置坐标 + final float y = ev.getY(actionIndex); + // 查找可以接受事件的 ChildView + final ArrayList preorderedList = buildOrderedChildList(); + final boolean customOrder = preorderedList == null + && isChildrenDrawingOrderEnabled(); + final View[] children = mChildren; + // ▼注意，从最后向前扫描 + for (int i = childrenCount - 1; i >= 0; i--) { + final int childIndex = customOrder + ? getChildDrawingOrder(childrenCount, i) : i; + final View child = (preorderedList == null) + ? children[childIndex] : preorderedList.get(childIndex); + + // 如果有一个视图具有可访问性焦点，我们希望它首先获取事件， + // 如果不处理，我们将执行正常的分派。 + // 尽管这可能会分发两次，但它能保证在给定的时间内更安全的执行。 + if (childWithAccessibilityFocus != null) { + if (childWithAccessibilityFocus != child) { + continue; + } + childWithAccessibilityFocus = null; + i = childrenCount - 1; + } + + // 检查View是否允许接受事件(即处于显示状态(VISIBLE)或者正在播放动画) + // 检查触摸位置是否在View区域内 + if (!canViewReceivePointerEvents(child) + || !isTransformedTouchPointInView(x, y, child, null)) { + ev.setTargetAccessibilityFocus(false); + continue; + } + + // getTouchTarget 中判断了 child 是否包含在 mFirstTouchTarget 中 + // 如果有返回 target，如果没有返回 null + newTouchTarget = getTouchTarget(child); + if (newTouchTarget != null) { + // ChildView 已经准备好接受在其区域内的事件。 + newTouchTarget.pointerIdBits |= idBitsToAssign; + break; // ◀︎已经找到目标View，跳出循环 + } + + resetCancelNextUpFlag(child); + if (dispatchTransformedTouchEvent(ev, false, child, idBitsToAssign)) { + mLastTouchDownTime = ev.getDownTime(); + if (preorderedList != null) { + for (int j = 0; j < childrenCount; j++) { + if (children[childIndex] == mChildren[j]) { + mLastTouchDownIndex = j; + break; + } + } + } else { + mLastTouchDownIndex = childIndex; + } + mLastTouchDownX = ev.getX(); + mLastTouchDownY = ev.getY(); + newTouchTarget = addTouchTarget(child, idBitsToAssign); + alreadyDispatchedToNewTouchTarget = true; + break; + } + + ev.setTargetAccessibilityFocus(false); + } + if (preorderedList != null) preorderedList.clear(); + } + + if (newTouchTarget == null && mFirstTouchTarget != null) { + // 没有找到 ChildView 接收事件 + newTouchTarget = mFirstTouchTarget; + while (newTouchTarget.next != null) { + newTouchTarget = newTouchTarget.next; + } + newTouchTarget.pointerIdBits |= idBitsToAssign; + } + } + } + + // 分发 TouchTarget + if (mFirstTouchTarget == null) { + // 没有 TouchTarget，将当前 ViewGroup 当作普通的 View 处理。 + handled = dispatchTransformedTouchEvent(ev, canceled, null, + TouchTarget.ALL_POINTER_IDS); + } else { + // 分发TouchTarget，如果我们已经分发过，则避免分配给新的目标。 + // 如有必要，取消分发。 + TouchTarget predecessor = null; + TouchTarget target = mFirstTouchTarget; + while (target != null) { + final TouchTarget next = target.next; + if (alreadyDispatchedToNewTouchTarget && target == newTouchTarget) { + handled = true; + } else { + final boolean cancelChild = resetCancelNextUpFlag(target.child) + || intercepted; + if (dispatchTransformedTouchEvent(ev, cancelChild, + target.child, target.pointerIdBits)) { + handled = true; + } + if (cancelChild) { + if (predecessor == null) { + mFirstTouchTarget = next; + } else { + predecessor.next = next; + } + target.recycle(); + target = next; + continue; + } + } + predecessor = target; + target = next; + } + } + + // 如果需要，更新指针的触摸目标列表或取消。 + if (canceled + || actionMasked == MotionEvent.ACTION_UP + || actionMasked == MotionEvent.ACTION_HOVER_MOVE) { + resetTouchState(); + } else if (split && actionMasked == MotionEvent.ACTION_POINTER_UP) { + final int actionIndex = ev.getActionIndex(); + final int idBitsToRemove = 1 << ev.getPointerId(actionIndex); + removePointersFromTouchTargets(idBitsToRemove); + } + } + + if (!handled && mInputEventConsistencyVerifier != null) { + mInputEventConsistencyVerifier.onUnhandledEvent(ev, 1); + } + return handled; +} +``` + + + +## 核心要点 + +1. **事件分发原理: 责任链模式，事件层层传递，直到被消费。** +2. **View 的 `dispatchTouchEvent` 主要用于调度自身的监听器和 onTouchEvent。** +3. **View的事件的调度顺序是 onTouchListener > onTouchEvent > onLongClickListener > onClickListener 。** +4. **不论 View 自身是否注册点击事件，只要 View 是可点击的就会消费事件。** +5. **事件是否被消费由返回值决定，true 表示消费，false 表示不消费，与是否使用了事件无关。** +6. **ViewGroup 中可能有多个 ChildView 时，将事件分配给包含点击位置的 ChildView。** +7. **ViewGroup 和 ChildView 同时注册了事件监听器(onClick等)，由 ChildView 消费。** +8. **一次触摸流程中产生事件应被同一 View 消费，全部接收或者全部拒绝。** +9. **只要接受 ACTION_DOWN 就意味着接受所有的事件，拒绝 ACTION_DOWN 则不会收到后续内容。** +10. **如果当前正在处理的事件被上层 View 拦截，会收到一个 ACTION_CANCEL，后续事件不会再传递过来**。 + + + +## 总结 + +本文啰嗦了这么多内容，但真正需要注意的就是核心要点中的几个概念，只要能正确理解这些概念，相信理解事件分发机制将再也不是难题。 + +> 最后，个人推荐阅读源码的方法，先尝试用自己的角度去分析，建立概念，然后看源码进行验证、对比，如果发现自己建立的概念有问题，就尝试修正自己的概念，这样比较容易理解原作者的意图，也不容易被众多的代码所迷惑。 +> +> 就像 ViewGroup 中的 dispatchTouchEvent 内容非常多，主要是为了应对实际的场景，里面有很多 安全判断，处理多指触控 等内容，这些如果不先建立概念就去看源码很容易被这些细节问题所迷惑。 + + + +## 参考资料 + +[View ](https://android.googlesource.com/platform/frameworks/base/+/master/core/java/android/view/View.java) +[ViewGroup.java](https://android.googlesource.com/platform/frameworks/base/+/master/core/java/android/view/ViewGroup.java) +[Android Touch事件分发详解](https://github.com/CharonChui/AndroidNote/blob/master/Android%E5%8A%A0%E5%BC%BA/Android%20Touch%E4%BA%8B%E4%BB%B6%E5%88%86%E5%8F%91%E8%AF%A6%E8%A7%A3.md) +[基于源码来了解Android的事件分发机制](http://minjie.tech/2016/09/03/%E5%9F%BA%E4%BA%8E%E6%BA%90%E7%A0%81%E6%9D%A5%E4%BA%86%E8%A7%A3Android%E7%9A%84%E4%BA%8B%E4%BB%B6%E5%88%86%E5%8F%91%E6%9C%BA%E5%88%B6/) + + + +## About Me + +### 作者微博: @GcsSloop + + + + + +[dispatch-touchevent-theory]: http://www.gcssloop.com/customview/dispatch-touchevent-theory "事件分发机制原理－GcsSloop" + diff --git a/CustomView/Advance/[16]MotionEvent.md b/CustomView/Advance/[16]MotionEvent.md new file mode 100644 index 00000000..94c9c8f1 --- /dev/null +++ b/CustomView/Advance/[16]MotionEvent.md @@ -0,0 +1,368 @@ +# MotionEvent 详解 + +Android MotionEvent 详解，之前用了两篇文章 [事件分发机制原理][customview/dispatch-touchevent-theory] 和 [事件分发机制详解][customview/dispatch-touchevent-source] 来讲解事件分发，而作为事件分发主角之一的 MotionEvent 并没有过多的说明，本文就带大家了解 MotionEvent 的相关内容，简要介绍触摸事件，主要包括 单点触控、多点触控、鼠标事件 以及 getAction() 和 getActionMasked() 的区别。 + +Android 将所有的输入事件都放在了 MotionEvent 中，随着安卓的不断发展壮大，MotionEvent 也开始变得越来越复杂，下面是我自己整理的 MotionEvent 大事记: + +| 版本号 | 更新内容 | +| :-------------------: | --------------------------- | +| Android 1.0 (API 1 ) | 支持单点触控和轨迹球的事件。 | +| Android 1.6 (API 4 ) | 支持手势。 | +| Android 2.2 (API 8 ) | 支持多点触控。 | +| Android 3.1 (API 12) | 支持触控笔，鼠标，键盘，操纵杆，游戏控制器等输入工具。 | + +以上仅仅是简要的说明几次比较大的变动，细小的修复和更新不计其数，此处就不一一列出了，反正也没人关心这些东西。 +MotionEvent 负责集中处理所有类型设备的输入事件，但是由于某些设备使用的几率较小本文会忽略讲解，或者简要讲解，例如： +1、轨迹球只出现在最早的设备上，现代的设备上已经见不到了，本文不再叙述。 +2、触控笔和手指处理流程基本相同，不再多说。 +3、鼠标在手机上使用概率也比较小，会在文末简要介绍。 + + + +## 单点触控 + +单点触控就非常简单啦，入门的工程师都会用，上一篇文章也简要介绍过，主要涉及以下几个事件: + +| 事件 | 简介 | +| -------------- | ------------------------ | +| ACTION_DOWN | 手指 **初次接触到屏幕** 时触发。 | +| ACTION_MOVE | 手指 **在屏幕上滑动** 时触发，会多次触发。 | +| ACTION_UP | 手指 **离开屏幕** 时触发。 | +| ACTION_CANCEL | 事件 **被上层拦截** 时触发。 | +| ACTION_OUTSIDE | 手指 **不在控件区域** 时触发。 | + +和以下的几个方法: + +| 方法 | 简介 | +| :---------- | ---------------------- | +| getAction() | 获取事件类型。 | +| getX() | 获得触摸点在当前 View 的 X 轴坐标。 | +| getY() | 获得触摸点在当前 View 的 Y 轴坐标。 | +| getRawX() | 获得触摸点在整个屏幕的 X 轴坐标。 | +| getRawY() | 获得触摸点在整个屏幕的 Y 轴坐标。 | + +> 关于 `get` 和 `getRaw` 的区别可以参考这一篇文章 [安卓自定义View基础-坐标系][customview/CoordinateSystem] + +单点触控一次简单的交互流程是这样的: + +**手指落下(ACTION_DOWN) －> 多次移动(ACTION_MOVE) －> 离开(ACTION_UP)** + +> * 本次事例中 ACTION_MOVE 有多次触发。 +> * 如果仅仅是单击(手指按下再抬起)，不会触发 ACTION_MOVE。 + +![单点触摸事件流程](http://ww4.sinaimg.cn/large/005Xtdi2jw1f8oz1704ylg30bo0jqgmx.gif) + +针对单点触控的事件处理一般是这样写的: + +```java +@Override +public boolean onTouchEvent(MotionEvent event) { + // ▼ 注意这里使用的是 getAction()，先埋一个小尾巴。 + switch (event.getAction()){ + case MotionEvent.ACTION_DOWN: + // 手指按下 + break; + case MotionEvent.ACTION_MOVE: + // 手指移动 + break; + case MotionEvent.ACTION_UP: + // 手指抬起 + break; + case MotionEvent.ACTION_CANCEL: + // 事件被拦截 + break; + case MotionEvent.ACTION_OUTSIDE: + // 超出区域 + break; + } + return super.onTouchEvent(event); +} +``` + +相信小伙伴对此已经非常熟悉了，经常使用的东西，我也不啰嗦了。 + +但其中有两个比较特殊的事件: `ACTION_CANCEL` 和 `ACTION_OUTSIDE` 。 +为什么说特殊呢，因为它们是由程序触发而产生的，而且触发条件也非常特殊，通常情况下即便不处理这两个事件也没有什么问题。接下来我们就扒一扒它们的真面目: + + + +### ACTION_CANCEL + +**`ACTION_CANCEL` 的触发条件是事件被上层拦截**，然而我们在 [事件分发机制原理][customview/dispatch-touchevent-theory] 一文中了解到当事件被上层 View 拦截的时候，ChildView 是收不到任何事件的，ChildView 收不到任何事件，自然也不会收到 `ACTION_CANCEL` 了，所以说这个 `ACTION_CANCEL` 的正确触发条件并不是这样，那么是什么呢？ + +**事实上，只有上层 View 回收事件处理权的时候，ChildView 才会收到一个 `ACTION_CANCEL` 事件。** + +这样说可能不太容易理解，咱举个例子? + +![](http://ww1.sinaimg.cn/large/005Xtdi2jw1f9auctayt4j302s03o744.jpg) + +> 例如：上层 View 是一个 RecyclerView，它收到了一个 `ACTION_DOWN` 事件，由于这个可能是点击事件，所以它先传递给对应 ItemView，询问 ItemView 是否需要这个事件，然而接下来又传递过来了一个 `ACTION_MOVE` 事件，且移动的方向和 RecyclerView 的可滑动方向一致，所以 RecyclerView 判断这个事件是滚动事件，于是要收回事件处理权，这时候对应的 ItemView 会收到一个 `ACTION_CANCEL` ，并且不会再收到后续事件。 +> +> **通俗一点？** +> +> RecyclerView：儿砸，这里有一个 `ACTION_DOWN` 你看你要不要。 +> ItemView ：好嘞，我看看。 +> RecyclerView：噫？居然是移动事件`ACTION_MOVE`，我要滚起来了，儿砸，我可能要把你送去你姑父家(缓存区)了，在这之前给你一个 `ACTION_CANCEL`，你要收好啊。 +> ItemView ：…... +> +> 这是实际开发中最有可能见到 `ACTION_CANCEL` 的场景了。 + + + +### ACTION_OUTSIDE + +`ACTION_OUTSIDE`的触发条件更加奇葩，从字面上看，outside 意思不就是超出区域么？然而不论你如何滑动超出控件区域都不会触发 `ACTION_OUTSIDE` 这个事件。相信很多魔法师都对此很是疑惑，说好的超出区域呢？ + +实际上这个事件根本就不是在这里用的，看官方解释(装一下逼)： + +>  A movement has happened outside of the normal bounds of the UI element. This does not provide a full gesture, but only the initial location of the movement/touch. +> +> 一个触摸事件已经发生了UI元素的正常范围之外。因此不再提供完整的手势，只提供 运动/触摸 的初始位置。 + +我们知道，正常情况下，如果初始点击位置在该视图区域之外，该视图根本不可能会收到事件，然而，万事万物都不是绝对的，肯定还有一些特殊情况，你可曾还记得点击 Dialog 区域外关闭吗？Dialog 就是一个特殊的视图(没有占满屏幕大小的窗口)，能够接收到视图区域外的事件(虽然在通常情况下你根本用不到这个事件)，除了 Dialog 之外，你最可能看到这个事件的场景是悬浮窗，当然啦，想要接收到视图之外的事件需要一些特殊的设置。 + +> 设置视图的 WindowManager 布局参数的 flags为[`FLAG_WATCH_OUTSIDE_TOUCH`](http://developer.android.com/reference/android/view/WindowManager.LayoutParams.html#FLAG_WATCH_OUTSIDE_TOUCH)，这样点击事件发生在这个视图之外时，该视图就可以接收到一个 `ACTION_OUTSIDE` 事件。 +> +> 参见StackOverflow：[How to dismiss the dialog with click on outside of the dialog?](http://stackoverflow.com/questions/8384067/how-to-dismiss-the-dialog-with-click-on-outside-of-the-dialog) + +由于这个事件用到的几率比较小，此处就不展开叙述了，以后用到的时候再详细讲解。 + + + +## 多点触控 + +Android 在 2.2 版本的时候开始支持多点触控，一旦出现了多点触控，很多东西就突然之间变得麻烦起来了，首先要解决的问题就是 **多个手指同时按在屏幕上，会产生很多的事件，这些事件该如何区分呢？** + +为了区分这些事件，工程师们用了一个很简单的办法－－**编号，当手指第一次按下时产生一个唯一的号码，手指抬起或者事件被拦截就回收编号，就这么简单。** + +**第一次按下的手指特殊处理作为主指针，之后按下的手指作为辅助指针**，然后随之衍生出来了以下事件(注意增加的事件和事件简介的变化)： + +| 事件 | 简介 | +| --------------------------- | ------------------------------ | +| ACTION_DOWN | **第一个** 手指 **初次接触到屏幕** 时触发。 | +| ACTION_MOVE | 手指 **在屏幕上滑动** 时触发，会多次触发。 | +| ACTION_UP | **最后一个** 手指 **离开屏幕** 时触发。 | +| **ACTION_POINTER_DOWN** | 有非主要的手指按下(**即按下之前已经有手指在屏幕上**)。 | +| **ACTION_POINTER_UP** | 有非主要的手指抬起(**即抬起之后仍然有手指在屏幕上**)。 | +| 以下事件类型不推荐使用 | －－－－－－－－－－－－－－－－－－ | +| ~~ACTION_POINTER\_1\_DOWN~~ | 第 2 个手指按下，已废弃，不推荐使用。 | +| ~~ACTION_POINTER\_2\_DOWN~~ | 第 3 个手指按下，已废弃，不推荐使用。 | +| ~~ACTION_POINTER\_3\_DOWN~~ | 第 4 个手指按下，已废弃，不推荐使用。 | +| ~~ACTION_POINTER\_1\_UP~~ | 第 2 个手指抬起，已废弃，不推荐使用。 | +| ~~ACTION_POINTER\_2\_UP~~ | 第 3 个手指抬起，已废弃，不推荐使用。 | +| ~~ACTION_POINTER\_3\_UP~~ | 第 4 个手指抬起，已废弃，不推荐使用。 | + +和以下方法： + +| 方法 | 简介 | +| ------------------------------- | ---------------------------------------- | +| getActionMasked() | 与 `getAction()` 类似，**多点触控必须使用这个方法获取事件类型**。 | +| getActionIndex() | 获取该事件是哪个指针(手指)产生的。 | +| getPointerCount() | 获取在屏幕上手指的个数。 | +| getPointerId(int pointerIndex) | 获取一个指针(手指)的唯一标识符ID，在手指按下和抬起之间ID始终不变。 | +| findPointerIndex(int pointerId) | 通过PointerId获取到当前状态下PointIndex，之后通过PointIndex获取其他内容。 | +| getX(int pointerIndex) | 获取某一个指针(手指)的X坐标 | +| getY(int pointerIndex) | 获取某一个指针(手指)的Y坐标 | + +由于多点触控部分涉及内容比较多，也很复杂，我准备单独用一篇文章进行详细叙述，所以这里只叙述一些基础的内容作为铺垫： + +### getAction() 与 getActionMasked() + +当多个手指在屏幕上按下的时候，会产生大量的事件，如何在获取事件类型的同时区分这些事件就是一个大问题了。 + +一般来说我们可以通过为事件添加一个int类型的index属性来区分，但是我们知道谷歌工程师是有洁癖的(在 [自定义View分类与流程][customview/CustomViewProcess] 的onMeasure中已经见识过了)，为了添加一个通常数值不会超过10的index属性就浪费一个int大小的空间简直是不能忍受的，于是工程师们将这个index属性和事件类型直接合并了。 + +int类型共32位(0x00000000)，他们用最低8位(0x000000**ff**)表示事件类型，再往前的8位(0x0000**ff**00)表示事件编号，以手指按下为例讲解数值是如何合成的: + +> ACTION_DOWN 的默认数值为 (0x00000000) +> ACTION_POINTER_DOWN 的默认数值为 (0x00000005) + +| 手指按下 | 触发事件(数值) | +| :-----: | :--------------------------------------- | +| 第1个手指按下 | ACTION_DOWN (0x0000**00**00) | +| 第2个手指按下 | ACTION_POINTER_DOWN (0x0000**01**05) | +| 第3个手指按下 | ACTION_POINTER_DOWN (0x0000**02**05) | +| 第4个手指按下 | ACTION_POINTER_DOWN (0x0000**03**05) | + +**注意：** +上面表格中用粗体标示出的数值，可以看到随着按下手指数量的增加，这个数值也是一直变化的，进而导致我们使用 `getAction()` 获取到的数值无法与标准的事件类型进行对比，为了解决这个问题，他们创建了一个 `getActionMasked()` 方法，这个方法可以清除index数值，让其变成一个标准的事件类型。 +**1、多点触控时必须使用 `getActionMasked()` 来获取事件类型。** +**2、单点触控时由于事件数值不变，使用 `getAction()` 和 `getActionMasked()` 两个方法都可以。** +**3、使用 getActionIndex() 可以获取到这个index数值。不过请注意，getActionIndex() 只在 down 和 up 时有效，move 时是无效的。** + +目前来说获取事件类型使用 `getActionMasked()` 就行了，但是如果一定要编译时兼容古董版本的话，可以考虑使用这样的写法: + +```java +final int action = (Build.VERSION.SDK_INT >= Build.VERSION_CODES.FROYO) + ? event.getActionMasked() + : event.getAction(); +switch (action){ + case MotionEvent.ACTION_DOWN: + // TODO + break; +} +``` + + + +### PointId + +虽然前面刚刚说了一个 actionIndex，可以使用 getActionIndex() 获得，但通过 actionIndex 字面意思知道，这个只表示事件的序号，而且根据其说明文档解释，这个 ActionIndex 只有在手指按下(down)和抬起(up)时是有用的，在移动(move)时是没有用的，事件追踪非常重要的一环就是移动(move)，然而它却没卵用，这也太不实在了 (￣Д￣)ﾉ + +**郑重声明：追踪事件流，请认准 PointId，这是唯一官方指定标准，不要相信 ActionIndex 那个小婊砸。** + +PointId 在手指按下时产生，手指抬起或者事件被取消后消失，是一个事件流程中唯一不变的标识，可以在手指按下时 通过 `getPointerId(int pointerIndex)` 获得。 (参数中的 pointerIndex 就是 actionIndex) + +关于事件流的追踪等问题在讲解多点触控时再详细讲解。 + + + +## 历史数据(批处理) + +由于我们的设备非常灵敏，手指稍微移动一下就会产生一个移动事件，所以移动事件会产生的特别频繁，为了提高效率，系统会将近期的多个移动事件(move)按照事件发生的顺序进行排序打包放在同一个 MotionEvent 中，与之对应的产生了以下方法： + +| 事件 | 简介 | +| --------------------------------- | ---------------------------------------- | +| getHistorySize() | 获取历史事件集合大小 | +| getHistoricalX(int pos) | 获取第pos个历史事件x坐标
(pos < getHistorySize()) | +| getHistoricalY(int pos) | 获取第pos个历史事件y坐标
(pos < getHistorySize()) | +| getHistoricalX (int pin, int pos) | 获取第pin个手指的第pos个历史事件x坐标
(pin < getPointerCount(), pos < getHistorySize() ) | +| getHistoricalY (int pin, int pos) | 获取第pin个手指的第pos个历史事件y坐标
(pin < getPointerCount(), pos < getHistorySize() ) | + +**注意：** + +1. pin 全称是 pointerIndex，表示第几个手指，此处为了节省空间使用了缩写。 +2. 历史数据只有 ACTION_MOVE 事件。 +3. 历史数据单点触控和多点触控均可以用。 + +下面是官方文档给出的一个简单使用示例： + +```java +void printSamples(MotionEvent ev) { + final int historySize = ev.getHistorySize(); + final int pointerCount = ev.getPointerCount(); + for (int h = 0; h < historySize; h++) { + System.out.printf("At time %d:", ev.getHistoricalEventTime(h)); + for (int p = 0; p < pointerCount; p++) { + System.out.printf(" pointer %d: (%f,%f)", + ev.getPointerId(p), ev.getHistoricalX(p, h), ev.getHistoricalY(p, h)); + } + } + System.out.printf("At time %d:", ev.getEventTime()); + for (int p = 0; p < pointerCount; p++) { + System.out.printf(" pointer %d: (%f,%f)", + ev.getPointerId(p), ev.getX(p), ev.getY(p)); + } +} +``` + + + +## 获取事件发生的时间 + +获取事件发生的时间。 + +| 方法 | 简介 | +| ------------------------------- | ------------ | +| getDownTime() | 获取手指按下时的时间。 | +| getEventTime() | 获取当前事件发生的时间。 | +| getHistoricalEventTime(int pos) | 获取历史事件发生的时间。 | + +> 1. pos 表示历史数据中的第几个数据。( pos < getHistorySize() ) +> 2. 返回值类型为 long，单位是毫秒。 + +## 获取压力(接触面积大小) + +MotionEvent支持获取某些输入设备(手指或触控笔)的与屏幕的接触面积和压力大小，主要有以下方法： + +> 描述中使用了手指，触控笔也是一样的。 + +| 方法 | 简介 | +| ---------------------------------------- | ---------------------------- | +| getSize () | 获取第1个手指与屏幕接触面积的大小 | +| getSize (int pin) | 获取第pin个手指与屏幕接触面积的大小 | +| getHistoricalSize (int pos) | 获取历史数据中第1个手指在第pos次事件中的接触面积 | +| getHistoricalSize (int pin, int pos) | 获取历史数据中第pin个手指在第pos次事件中的接触面积 | +| getPressure () | 获取第一个手指的压力大小 | +| getPressure (int pin) | 获取第pin个手指的压力大小 | +| getHistoricalPressure (int pos) | 获取历史数据中第1个手指在第pos次事件中的压力大小 | +| getHistoricalPressure (int pin, int pos) | 获取历史数据中第pin个手指在第pos次事件中的压力大小 | + +> 1. pin 全称是 pointerIndex，表示第几个手指。(pin < getPointerCount() ) +> 2. pos 表示历史数据中的第几个数据。( pos < getHistorySize() ) + +**注意：** + +**1、获取接触面积大小和获取压力大小是需要硬件支持的。** +**2、非常不幸的是大部分设备所使用的电容屏不支持压力检测，但能够大致检测出接触面积。** +**3、大部分设备的 `getPressure()` 是使用接触面积来模拟的。** +**4、由于某些未知的原因(可能系统版本和硬件问题)，某些设备不支持该方法。** + +我用不同的设备对这两个方法进行了测试，然而不同设备测试出来的结果不相同，之后经过我多方查证，发现是系统问题，有的设备上只有 `getSize()` 能用，有的设备上只有 `getPressure()` 能用，而有的则两个都不能用。 + +**由于获取接触面积和获取压力大小受系统和硬件影响，使用的时候一定要进行数据检测，以防因为设备问题而导致程序出错。** + + + +## 鼠标事件 + +由于触控笔事件和手指事件处理流程大致相同，所以就不讲解了，这里讲解一下与鼠标相关的几个事件： + +| 事件 | 简介 | +| ------------------ | ---------------------------------------- | +| ACTION_HOVER_ENTER | 指针移入到窗口或者View区域，但没有按下。 | +| ACTION_HOVER_MOVE | 指针在窗口或者View区域移动，但没有按下。 | +| ACTION_HOVER_EXIT | 指针移出到窗口或者View区域，但没有按下。 | +| ACTION_SCROLL | 滚轮滚动，可以触发水平滚动(AXIS_HSCROLL)或者垂直滚动(AXIS_VSCROLL) | + +注意： + +1、这些事件类型是 安卓4.0 (API 14) 才添加的。 +2、使用 ` getActionMasked()` 获得这些事件类型。 +3、这些事件不会传递到 [onTouchEvent(MotionEvent)](https://developer.android.com/reference/android/view/View.html#onTouchEvent(android.view.MotionEvent)) 而是传递到 [onGenericMotionEvent(MotionEvent)](https://developer.android.com/reference/android/view/View.html#onGenericMotionEvent(android.view.MotionEvent)) 。 + + + +## 输入设备类型判断 + +输入设备类型判断也是安卓4.0 (API 14) 才添加的，主要包括以下几种设备： + +| 设备类型 | 简介 | +| ----------------- | ---- | +| TOOL_TYPE_ERASER | 橡皮擦 | +| TOOL_TYPE_FINGER | 手指 | +| TOOL_TYPE_MOUSE | 鼠标 | +| TOOL_TYPE_STYLUS | 手写笔 | +| TOOL_TYPE_UNKNOWN | 未知类型 | + +**使用 `getToolType(int pointerIndex)` 来获取对应的输入设备类型，pointIndex可以为0，但必须小于 `getPointerCount()`。** + + + +## 总结 + +虽然本文标题是 MotionEvent 详解，但由于 MotionEvent 实在太庞大了，本文只能涉及一些比较常用的内容，某些不太常用的内容就在以后用到的时候再详细介绍吧，像游戏手柄等输入设备由于我暂时不做游戏开发，也没有过多了解，所以就不介绍给大家啦。 + +由于个人水平有限，文章中可能会出现错误，如果你觉得哪一部分有错误，或者发现了错别字等内容，欢迎在评论区告诉我，另外，据说关注 [作者微博](http://weibo.com/GcsSloop) 不仅能第一时间收到新文章消息，还能变帅哦。 + + + +## 参考资料 + +[MotionEvent ](https://developer.android.com/reference/android/view/MotionEvent.html) +[Android MotionEvent详解](http://www.jianshu.com/p/0c863bbde8eb) + + + +## About Me + +### 作者微博: @GcsSloop + + + + + +[customview/CoordinateSystem]: http://www.gcssloop.com/customview/CoordinateSystem "安卓自定义View基础-坐标系" +[customview/CustomViewProcess]: http://www.gcssloop.com/customview/CustomViewProcess "安卓自定义View进阶-分类与流程" +[customview/dispatch-touchevent-theory]: http://www.gcssloop.com/customview/dispatch-touchevent-theory "安卓自定义View进阶-事件分发机制原理" +[customview/dispatch-touchevent-source]: http://www.gcssloop.com/customview/dispatch-touchevent-source "安卓自定义View进阶-事件分发机制详解" diff --git a/CustomView/Advance/[17]touch-matrix-region.md b/CustomView/Advance/[17]touch-matrix-region.md new file mode 100644 index 00000000..cf23d6cb --- /dev/null +++ b/CustomView/Advance/[17]touch-matrix-region.md @@ -0,0 +1,579 @@ +# 特殊控件的事件处理方案 + +本文带大家了解 Android 特殊形状控件的事件处理方式，主要是利用了 Region 和 Matrix 的一些方法，超级实用的事件处理方案，相信看完本篇之后，任何奇葩控件的事件处理都会变得十分简单。 + +不得不说，Android 对事件体系封装的非常棒，即便对事件体系不太了解的人，只要简单的调用方法就能使用，而且具有防呆设计，能够保证事件流的完整性和统一性，最大可能性的避免了事件处理的混乱，着实令人佩服。 +**然而世界上并没有绝对完美的东西，当"事件处理"遇上"自定义View"，一场好戏就开演了。** + +## 特殊形状控件 + +在通常的情况下，自定义 View 直接使用系统的事件体系处理就行，我们也不需要特殊处理，然而当一些特殊的控件出现的时候，麻烦就来了，举个栗子： + +![](http://ww2.sinaimg.cn/large/005Xtdi2jw1f9t9u0tignj308c08cq3f.jpg) + +这是一个在遥控器上非常常见的按键布局，注意中间上下左右选择的部分，看起来十分简单，然而当你真正准备在手机上实现的时候麻烦就出现了。因为所有的 View 默认都是矩形的，所以事件接收区域也是矩形的，如果直接使用系统提供的 View 来组合出一摸一样的布局也很简单，但点击区域该如何处理？显然有部分点击区域是在控件外面的，并且会产生重叠区域： + +> 红色方框表示 View 的可点击区域。 + +![](http://ww3.sinaimg.cn/large/005Xtdi2jw1f9ta3eymeej308c08cwf1.jpg) + +当我们面对这样比较奇特的控件的时候，有很多处理办法，比较投机的一种就是背景贴一个静态图，按钮做成透明的，设置小一点，放在对应的位置，这样可以保证不会误触，当然了如果想要点击效果可以在按钮按下的时候更新一下背景图，这样虽然也可以，但是这样会导致可点击区域变小，体验效果变差，设计方案变得复杂，而且逻辑也不容易处理，是一种非常糟糕的设计。 + +当然了，看了我这么多文章的小伙伴应该也猜到接下来要说什么了，没错，就是自定义 View。当我们面对一些奇葩控件的时候，自定义 View 就变成了一种非常好用的处理方案。 + +相信小伙伴们看过 [前面的文章][CustomViewIndex] 之后，对各种图形的绘制已经不成问题了，所以我们直接处理重点问题。 + +> #### 注意： +> +> 本文中所有的 自定义View 均继承自 CustomView ，这是一个自定义的超类，目的是简化 自定义View 部分常用操作，你可以在 [ViewSupport](https://github.com/GcsSloop/ViewSupport/wiki/CustomView) 中找到它以及关于它的简介。 +> **⚠️ 警告：测试本文章示例之前请关闭硬件加速。** + +## 特殊形状控的点击区域判断 + +要进行特殊形状的点击判断，要用到一个之前没有使用过的类：Region。 + +Region 直接翻译的意思是 地域，区域。**在此处应该是区域的意思**。它和 Path 有些类似，但 Path 可以是不封闭图形，而 Region 总是封闭的。可以通过 `setPath` 方法将 Path 转换为 Region。 + + **本文中我们重点要使用到的是 Region 中的 `contains` 方法，这个方法可以判断一个点是否包含在该区域内。** + +接下来是一个简单的示例，**判断手指是否是在圆形区域内按下**: + +![](http://ww1.sinaimg.cn/large/005Xtdi2jw1f9xtlae5wzj308c0ea3yn.jpg) + +代码： + +```java +public class RegionClickView extends CustomView { + Region circleRegion; + Path circlePath; + + public RegionClickView(Context context) { + super(context); + mDeafultPaint.setColor(0xFF4E5268); + circlePath = new Path(); + circleRegion = new Region(); + } + + @Override + protected void onSizeChanged(int w, int h, int oldw, int oldh) { + super.onSizeChanged(w, h, oldw, oldh); + // ▼在屏幕中间添加一个圆 + circlePath.addCircle(w/2, h/2, 300, Path.Direction.CW); + // ▼将剪裁边界设置为视图大小 + Region globalRegion = new Region(-w, -h, w, h); + // ▼将 Path 添加到 Region 中 + circleRegion.setPath(circlePath, globalRegion); + } + + @Override + public boolean onTouchEvent(MotionEvent event) { + switch (event.getAction()){ + case MotionEvent.ACTION_DOWN: + int x = (int) event.getX(); + int y = (int) event.getY(); + + // ▼点击区域判断 + if (circleRegion.contains(x,y)){ + Toast.makeText(this.getContext(),"圆被点击",Toast.LENGTH_SHORT).show(); + } + break; + } + return true; + } + + @Override + protected void onDraw(Canvas canvas) { + // ▼注意此处将全局变量转化为局部变量，方便 GC 回收 canvas + Path circle = circlePath; + // 绘制圆 + canvas.drawPath(circle,mDeafultPaint); + } +} +``` + +> 代码中比较重要的内容都用 ▼ 符号标记出来了。 + +上述代码非常简单，就是创建了个 Path 并在其中添加圆形，之后将 Path 设置到 Region 中，当手指在屏幕上按下的时候判断手指位置是否在 Region 区域内。 + + + +## 画布变换后坐标转换问题 + +还是本文一开始的例子，绘制一个上下左右选择按键，这个控件是上下左右对称的，熟悉我代码风格的小伙伴都知道，如果遇上这种问题，我肯定是要将坐标系平移到这个控件中心的，这样数据比较好计算，然而进行画布变换操作会产生一个新问题：**手指触摸的坐标系和画布坐标系不统一，就可能引起手指触摸位置和绘制位置不统一。** + +举个栗子： + +> 画布移动后在手指按下位置绘制一个圆，可以看到，直接拿手指触摸位置的坐标来绘制会导致绘制位置不正确，**两者坐标是相同的，但是由于坐标系不同，导致实际显示位置不同。** + +![](http://ww4.sinaimg.cn/large/005Xtdi2jw1f9tdc3p84uj308c0d4mx9.jpg) + +代码： + +```java +public class CanvasVonvertTouchTest extends CustomView{ + float down_x = -1; + float down_y = -1; + + public CanvasVonvertTouchTest(Context context) { + this(context, null); + } + + public CanvasVonvertTouchTest(Context context, AttributeSet attrs) { + super(context, attrs); + } + + @Override + public boolean onTouchEvent(MotionEvent event) { + switch (event.getActionMasked()){ + case MotionEvent.ACTION_DOWN: + case MotionEvent.ACTION_MOVE: + down_x = event.getX(); + down_y = event.getY(); + invalidate(); + break; + + case MotionEvent.ACTION_CANCEL: + case MotionEvent.ACTION_UP: + down_x = down_y = -1; + invalidate(); + break; + } + + return true; + } + + @Override + protected void onDraw(Canvas canvas) { + float x = down_x; + float y = down_y; + + drawTouchCoordinateSpace(canvas); // 绘制触摸坐标系 灰色 + + // ▼注意画布平移 + canvas.translate(mViewWidth/2, mViewHeight/2); + + drawTranslateCoordinateSpace(canvas); // 绘制平移后的坐标系，红色 + + if (x == -1 && y == -1) return; // 如果没有就返回 + + canvas.drawCircle(x,y,20,mDeafultPaint); // 在触摸位置绘制一个小圆 + } + + /** + * 绘制触摸坐标系，灰色，为了能够显示出坐标系，将坐标系位置稍微偏移了一点 + */ + private void drawTouchCoordinateSpace(Canvas canvas) { + canvas.save(); + canvas.translate(10,10); + CanvasAidUtils.set2DAxisLength(1000, 0, 1400, 0); + CanvasAidUtils.setLineColor(Color.GRAY); + CanvasAidUtils.draw2DCoordinateSpace(canvas); + canvas.restore(); + } + + /** + * 绘制平移后的坐标系，红色 + */ + private void drawTranslateCoordinateSpace(Canvas canvas) { + CanvasAidUtils.set2DAxisLength(500, 500, 700, 700); + CanvasAidUtils.setLineColor(Color.RED); + CanvasAidUtils.draw2DCoordinateSpace(canvas); + CanvasAidUtils.draw2DCoordinateSpace(canvas); + } +} +``` + +**那么问题来了，我们在之前的文章中讲过，映射不同坐标系的坐标用 什么来着？** +**是 Matrix。** + +如果看过我之前的文章但没有想起来的说明你们根本没有认真看，全部拖出去糟蹋 5 分钟！ +没看过的点 [Matrix原理][Matrix_Basic] 和 [Matrix详解][Matrix_Method] 。 + +> **Matrix 是一个矩阵，主要功能是坐标映射，数值转换。** + +那么接下来我们就对上面的示例进行简单的改造一下，让触摸位置和实际绘制绘制重合。小白点和黑色的圆没有完全重合是因为系统显示触摸位置的绘制逻辑和我使用的绘制逻辑不太相同导致的。 + +![](http://ww3.sinaimg.cn/large/005Xtdi2jw1f9te2mzxcvj308c0d40st.jpg) + +代码： + +**注意：比较重要的修改位置用▼标记出来了。** + +```java +public class CanvasVonvertTouchTest extends CustomView{ + float down_x = -1; + float down_y = -1; + + public CanvasVonvertTouchTest(Context context) { + this(context, null); + } + + public CanvasVonvertTouchTest(Context context, AttributeSet attrs) { + super(context, attrs); + } + + @Override + public boolean onTouchEvent(MotionEvent event) { + switch (event.getActionMasked()){ + case MotionEvent.ACTION_DOWN: + case MotionEvent.ACTION_MOVE: + // ▼ 注意此处使用 getRawX，而不是 getX + down_x = event.getRawX(); + down_y = event.getRawY(); + invalidate(); + break; + + case MotionEvent.ACTION_CANCEL: + case MotionEvent.ACTION_UP: + down_x = down_y = -1; + invalidate(); + break; + } + + return true; + } + + @Override + protected void onDraw(Canvas canvas) { + float[] pts = {down_x, down_y}; + + drawTouchCoordinateSpace(canvas); // 绘制触摸坐标系，灰色 + // ▼注意画布平移 + canvas.translate(mViewWidth/2, mViewHeight/2); + + drawTranslateCoordinateSpace(canvas); // 绘制平移后的坐标系，红色 + + if (pts[0] == -1 && pts[1] == -1) return; // 如果没有就返回 + + // ▼ 获得当前矩阵的逆矩阵 + Matrix invertMatrix = new Matrix(); + canvas.getMatrix().invert(invertMatrix); + + // ▼ 使用 mapPoints 将触摸位置转换为画布坐标 + invertMatrix.mapPoints(pts); + + // 在触摸位置绘制一个小圆 + canvas.drawCircle(pts[0],pts[1],20,mDeafultPaint); + } + + /** + * 绘制触摸坐标系，颜色为灰色，为了能够显示出坐标系，将坐标系位置稍微偏移了一点 + */ + private void drawTouchCoordinateSpace(Canvas canvas) { + canvas.save(); + canvas.translate(10,10); + CanvasAidUtils.set2DAxisLength(1000, 0, 1400, 0); + CanvasAidUtils.setLineColor(Color.GRAY); + CanvasAidUtils.draw2DCoordinateSpace(canvas); + canvas.restore(); + } + + /** + * 绘制平移后的坐标系，颜色为红色 + */ + private void drawTranslateCoordinateSpace(Canvas canvas) { + CanvasAidUtils.set2DAxisLength(500, 500, 700, 700); + CanvasAidUtils.setLineColor(Color.RED); + CanvasAidUtils.draw2DCoordinateSpace(canvas); + CanvasAidUtils.draw2DCoordinateSpace(canvas); + } +} +``` + +其实核心部分就这两点： + +```java +// ▼ 注意此处使用 getRawX，而不是 getX +down_x = event.getRawX(); +down_y = event.getRawY(); + +// ------------------------------------- + +// ▼ 获得当前矩阵的逆矩阵 +Matrix invertMatrix = new Matrix(); +canvas.getMatrix().invert(invertMatrix); + +// ▼ 使用 mapPoints 将触摸位置转换为画布坐标 +invertMatrix.mapPoints(pts); +``` + +1. 使用全局坐标系 +2. 使用逆矩阵的 mapPoints + +**原理嘛，其实非常简单，我们在画布上正常的绘制，需要将画布坐标系转换为全局坐标系后才能真正的绘制内容。所以我们反着来，将获得到的全局坐标系坐标使用当前画布的逆矩阵转化一下，就转化为当前画布的坐标系坐标了，如果对 [Matrix原理][Matrix_Basic] 和 [Matrix详解][Matrix_Method] 理解了，即便我不说你们也肯定会想到这个方案的。** + +## 仿遥控器按钮代码示例 + +在解决了上述两大难题之后，相信不论形状如何奇葩的自定义控件，基本上都难不倒大家了，最后用一个简单的示例作为结尾，还是文章开头所举的例子，核心内容就是上面讲的两个东西。 + +![](http://ww1.sinaimg.cn/large/005Xtdi2jw1f9tinrk6ilj308c0eat92.jpg) + +代码： + +```java +public class RemoteControlMenu extends CustomView { + Path up_p, down_p, left_p, right_p, center_p; + Region up, down, left, right, center; + + Matrix mMapMatrix = null; + + int CENTER = 0; + int UP = 1; + int RIGHT = 2; + int DOWN = 3; + int LEFT = 4; + int touchFlag = -1; + int currentFlag = -1; + + MenuListener mListener = null; + + int mDefauColor = 0xFF4E5268; + int mTouchedColor = 0xFFDF9C81; + + + public RemoteControlMenu(Context context) { + this(context, null); + } + + public RemoteControlMenu(Context context, AttributeSet attrs) { + super(context, attrs); + + up_p = new Path(); + down_p = new Path(); + left_p = new Path(); + right_p = new Path(); + center_p = new Path(); + + up = new Region(); + down = new Region(); + left = new Region(); + right = new Region(); + center = new Region(); + + mDeafultPaint.setColor(mDefauColor); + mDeafultPaint.setAntiAlias(true); + + mMapMatrix = new Matrix(); + + } + + @Override + protected void onSizeChanged(int w, int h, int oldw, int oldh) { + super.onSizeChanged(w, h, oldw, oldh); + mMapMatrix.reset(); + + // 注意这个区域的大小 + Region globalRegion = new Region(-w, -h, w, h); + int minWidth = w > h ? h : w; + minWidth *= 0.8; + + int br = minWidth / 2; + RectF bigCircle = new RectF(-br, -br, br, br); + + int sr = minWidth / 4; + RectF smallCircle = new RectF(-sr, -sr, sr, sr); + + float bigSweepAngle = 84; + float smallSweepAngle = -80; + + // 根据视图大小，初始化 Path 和 Region + center_p.addCircle(0, 0, 0.2f * minWidth, Path.Direction.CW); + center.setPath(center_p, globalRegion); + + right_p.addArc(bigCircle, -40, bigSweepAngle); + right_p.arcTo(smallCircle, 40, smallSweepAngle); + right_p.close(); + right.setPath(right_p, globalRegion); + + down_p.addArc(bigCircle, 50, bigSweepAngle); + down_p.arcTo(smallCircle, 130, smallSweepAngle); + down_p.close(); + down.setPath(down_p, globalRegion); + + left_p.addArc(bigCircle, 140, bigSweepAngle); + left_p.arcTo(smallCircle, 220, smallSweepAngle); + left_p.close(); + left.setPath(left_p, globalRegion); + + up_p.addArc(bigCircle, 230, bigSweepAngle); + up_p.arcTo(smallCircle, 310, smallSweepAngle); + up_p.close(); + up.setPath(up_p, globalRegion); + + } + + @Override + public boolean onTouchEvent(MotionEvent event) { + float[] pts = new float[2]; + pts[0] = event.getRawX(); + pts[1] = event.getRawY(); + mMapMatrix.mapPoints(pts); + + int x = (int) pts[0]; + int y = (int) pts[1]; + + switch (event.getActionMasked()) { + case MotionEvent.ACTION_DOWN: + touchFlag = getTouchedPath(x, y); + currentFlag = touchFlag; + break; + case MotionEvent.ACTION_MOVE: + currentFlag = getTouchedPath(x, y); + break; + case MotionEvent.ACTION_UP: + currentFlag = getTouchedPath(x, y); + // 如果手指按下区域和抬起区域相同且不为空，则判断点击事件 + if (currentFlag == touchFlag && currentFlag != -1 && mListener != null) { + if (currentFlag == CENTER) { + mListener.onCenterCliched(); + } else if (currentFlag == UP) { + mListener.onUpCliched(); + } else if (currentFlag == RIGHT) { + mListener.onRightCliched(); + } else if (currentFlag == DOWN) { + mListener.onDownCliched(); + } else if (currentFlag == LEFT) { + mListener.onLeftCliched(); + } + } + touchFlag = currentFlag = -1; + break; + case MotionEvent.ACTION_CANCEL: + touchFlag = currentFlag = -1; + break; + } + + invalidate(); + return true; + } + + // 获取当前触摸点在哪个区域 + int getTouchedPath(int x, int y) { + if (center.contains(x, y)) { + return 0; + } else if (up.contains(x, y)) { + return 1; + } else if (right.contains(x, y)) { + return 2; + } else if (down.contains(x, y)) { + return 3; + } else if (left.contains(x, y)) { + return 4; + } + return -1; + } + + @Override + protected void onDraw(Canvas canvas) { + super.onDraw(canvas); + canvas.translate(mViewWidth / 2, mViewHeight / 2); + + // 获取测量矩阵(逆矩阵) + if (mMapMatrix.isIdentity()) { + canvas.getMatrix().invert(mMapMatrix); + } + + // 绘制默认颜色 + canvas.drawPath(center_p, mDeafultPaint); + canvas.drawPath(up_p, mDeafultPaint); + canvas.drawPath(right_p, mDeafultPaint); + canvas.drawPath(down_p, mDeafultPaint); + canvas.drawPath(left_p, mDeafultPaint); + + // 绘制触摸区域颜色 + mDeafultPaint.setColor(mTouchedColor); + if (currentFlag == CENTER) { + canvas.drawPath(center_p, mDeafultPaint); + } else if (currentFlag == UP) { + canvas.drawPath(up_p, mDeafultPaint); + } else if (currentFlag == RIGHT) { + canvas.drawPath(right_p, mDeafultPaint); + } else if (currentFlag == DOWN) { + canvas.drawPath(down_p, mDeafultPaint); + } else if (currentFlag == LEFT) { + canvas.drawPath(left_p, mDeafultPaint); + } + mDeafultPaint.setColor(mDefauColor); + } + + public void setListener(MenuListener listener) { + mListener = listener; + } + + // 点击事件监听器 + public interface MenuListener { + void onCenterCliched(); + + void onUpCliched(); + + void onRightCliched(); + + void onDownCliched(); + + void onLeftCliched(); + } +} +``` + +**运行效果:** + +当手指在某一区域活动时，该区域会高亮显示，如果注册了监听器，点击某一区域会触发监听器回调。 + + + +## 关于硬件加速的问题 + +**硬件加速是个好东西，但是处理不好会引起诸多问题，博主为了怕麻烦我一直关闭硬件加速。** + +然而硬件加速在 Android 4.0 以上是默认开启的，这就导致了有好几位魔法师反馈测试结果和我的测试结果不同，我来简单说明一下硬件加速干了什么事情，以及这些文章中的锅是如何产生的，应该由谁来背。 + +我在 [Matrix 原理][Matrix_Basic] 中说过 Matrix 的作用： **Matrix作用就是坐标映射。** +其核心功能就是将单个 View 的坐标系转化为屏幕(物理)坐标系，虽然转换一次费不了多少时间，但是当执行动画效果等需要大量快速重绘的情况下，耗费的时间就需要考量一下了，于是乎，硬件加速干了一件非常**精明**的事情，**把所有画布坐标系都设置为屏幕(物理)坐标系**，之后在 View 绘制区域设置一个遮罩，保证绘制内容不会超过 View 自身的大小，**这样就直接跳过坐标转换过程，可以节省坐标系之间数值转换耗费的时间**。因此导致了以下问题： + +1. 开启硬件加速情况下 event.getX() 和 不开启情况下 event.getRawX() 等价，获取到的是屏幕(物理)坐标 (本文的锅)。 +2. 开启硬件加速情况下 event.getRawX() 数值是一个错误数值，因为本身就是全局的坐标又叠加了一次 View 的偏移量，所以肯定是不正确的 (本文的锅)。 +3. 从 Canvas 获取到的 Matrix 是全局的，默认情况下 x,y 偏移量始终为0，因此你不能从这里拿到当前 View 的偏移量 ( Matrix系列文章中的锅 )。 +4. 由于其使用的是遮罩来控制绘制区域，所以如果重绘 path 时，如果 path 区域变大，但没有执行单步操作会导致 path 绘制不完整或者看起来比较奇怪 (Path系列文章中的锅)。 + +很显然，这个硬件加速有点6，制造了各种锅想让我来背，然而智慧的我早已看穿一切，默默的把硬件加速关闭了，因为我不知道它还有多少锅没亮出来。 + +**这里顺便挖个坑，等我搞明白硬件加速扔锅的逻辑之后，专门写一篇硬件加速的文章，把硬件加速的锅全埋进去，再也不背这口大黑锅了**。 +**(╯°Д°）╯︵ ┻━┻** + + + +**个人建议：** + +1. APP全局关闭硬件加速。 +2. 针对动画较多的 Activity 或者 View 单独开启硬件加速。 +3. 如果应用要兼容到 3.0 以下，不要使用硬件加速的特性，或者进行兼容处理。 +4. 如果 自定义View 出现与绘图相关的异常，请务必检查一下硬件加速。 +5. 如果想关掉硬件加速看这里： [Android如何关闭硬件加速](https://github.com/GcsSloop/AndroidNote/issues/7) 。 + + + +## 总结 + +本文虽然代码比较多，但核心概念非常简单，主要涉及以下两点： + +1. Region 的区域检测。 +2. Matrix 的坐标映射。 + +**这两个知识点都不是很难，然而灵活运用起来却是非常强大的，如果有对 Matrix 不了解的小伙伴，推荐去看我 [之前的文章][CustomViewIndex]，里面有关于Matrix的详细介绍，** + + + +## About Me + +### 作者微博: @GcsSloop + + + + + +[CustomViewIndex]: http://www.gcssloop.com/customview/CustomViewIndex +[Matrix_Basic]: http://www.gcssloop.com/customview/Matrix_Basic +[Matrix_Method]: http://www.gcssloop.com/customview/Matrix_Method + + + diff --git a/CustomView/Advance/[18]multi-touch.md b/CustomView/Advance/[18]multi-touch.md new file mode 100644 index 00000000..98efa326 --- /dev/null +++ b/CustomView/Advance/[18]multi-touch.md @@ -0,0 +1,613 @@ +# Android 多点触控详解 + +Android 多点触控详解，在前面的几篇文章中我们大致了解了 Android 中的事件处理流程和一些简单的处理方案，本次带大家了解 Android 多点触控相关的一些知识。 + +**多点触控** ( **Multitouch**，也称 **Multi-touch** )，即同时接受屏幕上多个点的人机交互操作，多点触控是从 Android 2.0 开始引入的功能，在 Android 2.2 时对这一部分进行了重新设计。 + +在本文开始之前，先回顾一下 [MotionEvent详解][motionevent] 中提到过的内容： + +- Android 将所有的事件都封装进了 `Motionvent` 中。 +- 我们可以通过复写 `onTouchEvent` 或者设置 `OnTouchListener` 来获取 View 的事件。 +- 多点触控获取事件类型请使用 `getActionMasked()` 。 +- 追踪事件流请使用 `PointId`。 + +**多点触控相关的事件：** + +| 事件 | 简介 | +| --------------------------- | ------------------------------ | +| ACTION_DOWN | **第一个** 手指 **初次接触到屏幕** 时触发。 | +| ACTION_MOVE | 手指 **在屏幕上滑动** 时触发，会多次触发。 | +| ACTION_UP | **最后一个** 手指 **离开屏幕** 时触发。 | +| **ACTION_POINTER_DOWN** | 有非主要的手指按下(**即按下之前已经有手指在屏幕上**)。 | +| **ACTION_POINTER_UP** | 有非主要的手指抬起(**即抬起之后仍然有手指在屏幕上**)。 | +| 以下事件类型不推荐使用 | －－－以下事件在 2.2 版本以上被标记为废弃－－－ | +| ~~ACTION_POINTER\_1\_DOWN~~ | 第 2 个手指按下，已废弃，不推荐使用。 | +| ~~ACTION_POINTER\_2\_DOWN~~ | 第 3 个手指按下，已废弃，不推荐使用。 | +| ~~ACTION_POINTER\_3\_DOWN~~ | 第 4 个手指按下，已废弃，不推荐使用。 | +| ~~ACTION_POINTER\_1\_UP~~ | 第 2 个手指抬起，已废弃，不推荐使用。 | +| ~~ACTION_POINTER\_2\_UP~~ | 第 3 个手指抬起，已废弃，不推荐使用。 | +| ~~ACTION_POINTER\_3\_UP~~ | 第 4 个手指抬起，已废弃，不推荐使用。 | + +**多点触控相关的方法：** + +| 方法 | 简介 | +| ------------------------------- | ---------------------------------------- | +| getActionMasked() | 与 `getAction()` 类似，**多点触控需要使用这个方法获取事件类型**。 | +| getActionIndex() | 获取该事件是哪个指针(手指)产生的。 | +| getPointerCount() | 获取在屏幕上手指的个数。 | +| getPointerId(int pointerIndex) | 获取一个指针(手指)的唯一标识符ID，在手指按下和抬起之间ID始终不变。 | +| findPointerIndex(int pointerId) | 通过PointerId获取到当前状态下PointIndex，之后通过PointIndex获取其他内容。 | +| getX(int pointerIndex) | 获取某一个指针(手指)的X坐标 | +| getY(int pointerIndex) | 获取某一个指针(手指)的Y坐标 | + +回顾完毕，开始正文。 + + + +## 一、多点触控相关问题 + +在引入多点触控之前，事件的类型很少，基本事件类型只有按下(down)、移动(move) 和 抬起(up)，即便加上那些特殊的事件类型也只有几种而已，所以我们可以用几个常量来标记这些事件，在使用的时候使用 `getAction()` 方法来获取具体的事件，之后和这些常量进行对比就行了。 + +在 Android 2.0 版本的时候，开始引入多点触控技术，由于技术上并不成熟，硬件和驱动也跟不上，多数设备只能支持追踪两三个点而已，因此在设计 API 上采取了一种简单粗暴的方案，添加了几个常量用于多点触控的事件类型的判断。 + +| 事件 | 简介 | +| ----------------------- | -------------------- | +| ACTION_POINTER\_1\_DOWN | 第 2 个手指按下，已废弃，不推荐使用。 | +| ACTION_POINTER\_2\_DOWN | 第 3 个手指按下，已废弃，不推荐使用。 | +| ACTION_POINTER\_3\_DOWN | 第 4 个手指按下，已废弃，不推荐使用。 | +| ACTION_POINTER\_1\_UP | 第 2 个手指抬起，已废弃，不推荐使用。 | +| ACTION_POINTER\_2\_UP | 第 3 个手指抬起，已废弃，不推荐使用。 | +| ACTION_POINTER\_3\_UP | 第 4 个手指抬起，已废弃，不推荐使用。 | + +这些事件类型是用来判断非主要手指(第一个按下的称为主要手指)的按下和抬起，使用起来大概是这样子： + +```java +switch (event.getAction()) { + case MotionEvent.ACTION_DOWN: break; + case MotionEvent.ACTION_UP: break; + case MotionEvent.ACTION_MOVE: break; + case MotionEvent.ACTION_POINTER_1_DOWN: break; + case MotionEvent.ACTION_POINTER_2_DOWN: break; + case MotionEvent.ACTION_POINTER_3_DOWN: break; + case MotionEvent.ACTION_POINTER_1_UP: break; + case MotionEvent.ACTION_POINTER_2_UP: break; + case MotionEvent.ACTION_POINTER_3_UP: break; +} +``` + +看到这里可能会产生以下的一些疑问？ + +### 1.为什么没有 ACTION_POINTER_X_MOVE ? + +在多指触控中所有的移动事件都是使用 `ACTION_MOVE`， 并没有追踪某一个手指的 move 事件类型，个人猜测主要是因为：**很难无歧义的实现单独追踪每一个手指。** + +要理解这个，首先要明白设备是如何识别多点触控的，设备没有眼睛，不能像我们人一样看到有几个手指(或者触控笔)在屏幕上。 +目前大多数 Android 设备都是电容屏，它们感知触摸是利用手指(触控笔)与屏幕接触产生的微小电流变化，之后通过计算这些电流变化来得出具体的触摸位置，在多点触控中，当两个触摸点足够靠近时，设备实际上是无法分清这两个点的。因此当两个触摸点靠近(重合)后再分开，设备很可能就无法正确的追踪两个点了，所以也很难实现无歧义的追踪每一个点。 + +并且从软件上来说，事件的编号产生和复用也是一个大问题，例如下面的场景： + +| 事件 | 手指数量 | 编号变化 | +| ------------ | :--: | ------------------------- | +| 一个手指按下(命名为A) | 1 | A手指的编号为0，id为0 | +| 一个手指按下(命名为B) | 2 | B手指的编号为1，id为1 | +| A手指抬起 | 1 | B手指编号变更为0，id不变为1 | +| 一个手指按下(命名为C) | 2 | C手指编号为0，id为0，B手指编号为1，id为1 | + +注意观察上面编号和id的变化，有两个问题，**1、B手指的编号变化了。2、A手指和C手指id是相同的(A手指抬起后，C手指按下替代了A手指)。**所以这就引出了一个问题：如果存在 ACTION_POINTER_X_MOVE，那么X应该用什么标志呢？编号会变化，id虽然不会变化，但id会被复用，例如A手指抬起后C手指按下，C手指复用了A手指的id。所以不论使用哪一个都不能保证唯一性。 + +当然了，解决问题最好的方式就是把问题抛出去，既然从硬件和软件上都不能保证唯一性和不变性，就不做区分了，因此所有的 move 事件都是 `ACTION_MOVE`, 具体是哪个手指产生的 move 用户可以结合其他事件(按下和抬起)来综合判断。 + +### 2.超过4个手指怎么办？ + +**2.0 兼容版**，在2.2 之前的设计中，其提供的常量最多能判断四个手指的抬起和落下，当超过四个手指时怎么办呢？ + +由于在 2.2 版本之前，由于没有 `getActionMasked` 方法，我们可以自己自己手动进行计算，例如下面这样 ： + +```java +String TAG = "Gcs"; + +int action = event.getAction() & MotionEvent.ACTION_MASK; +int index = (event.getAction() & MotionEvent.ACTION_POINTER_INDEX_MASK) + >> MotionEvent.ACTION_POINTER_INDEX_SHIFT; + +switch (action) { + case MotionEvent.ACTION_DOWN: + Log.e(TAG,"第1个手指按下"); + break; + case MotionEvent.ACTION_UP: + Log.e(TAG,"最后1个手指抬起"); + break; + case MotionEvent.ACTION_POINTER_1_DOWN: // 此时相当于 ACTION_POINTER_DOWN + Log.e(TAG,"第"+(index+1)+"个手指按下"); + break; + case MotionEvent.ACTION_POINTER_1_UP: // 此时相当于 ACTION_POINTER_UP + Log.e(TAG,"第"+(index+1)+"个手指抬起"); + break; +} +``` + +在上面的例子中有几点比较关键： + +#### 2.1、action 与 Index 的获得 + +我们在 [MotionEvent详解][motionevent] 中了解过，Android中的事件一般用最后8位来表示事件类型，再往前8位来表示Index。 + +例如多指触控的按下事件，其事件类型是 0x000000**05**， 其Index标志位是 0x0000**00**05，随着更多的手指按下，其中变化的部分是 Index 标志位，最后两位是始终不变的，所以我们只要能将这两个分离开就行了。 + +**取得事件类型(action)** + +```java +// 获取事件类型 +int action = event.getAction() & MotionEvent.ACTION_MASK; +``` + +这个非常简单，ACTION_MASK=0x000000ff， 与 getAction() 进行按位与操作后保留最后8位内容(十六进制每一个字符转化为二进制是4位)。 + +例如： +0x000001**05** & 0x000000ff = 0x000000**05** + +**取得事件索引(index)** + +```java +// 获取index编号 +int index = (event.getAction() & MotionEvent.ACTION_POINTER_INDEX_MASK) + >> MotionEvent.ACTION_POINTER_INDEX_SHIFT; +``` + +ACTION_POINTER_INDEX_MASK = 0x0000ff00 +ACTION_POINTER_INDEX_SHIFT = 8 +首先让 getAction() 与 ACTION_POINTER_INDEX_MASK 按位与之后，只保留 Index 那8位，之后再右移8位，最终就拿到了 Index 的真实数值。 + +例如： +0x0000**01**05 & 0x0000ff00 = 0x0000**01**00 +0x0000**01**00 >> 8 = 0x000000**01** + +#### 2.2、用 ACTION\_POINTER\_1\_DOWN 代替 ACTION\_POINTER\_DOWN + +这是因为在 2.0 版本的时候还没有 ACTION\_POINTER\_DOWN 的这个常量，但是它们两个点数值是相同的，都是 0x00000005，这个你可以查看官方文档或者源码，甚至你直接写 `case 0x00000005` 也行，抬起也是同理。 + +#### 2.3、只考虑兼容 2.2 以上的版本 + +当然了，如果你不需要兼容 2.0 版本，只需要兼容到 2.2 以上的话就很简单了，像下面这样： + +```java +String TAG = "Gcs"; + +int index = event.getActionIndex(); + +switch (event.getActionMasked()) { + case MotionEvent.ACTION_DOWN: + Log.e(TAG,"第1个手指按下"); + break; + case MotionEvent.ACTION_UP: + Log.e(TAG,"最后1个手指抬起"); + break; + case MotionEvent.ACTION_POINTER_DOWN: + Log.e(TAG,"第"+(index+1)+"个手指按下"); + break; + case MotionEvent.ACTION_POINTER_UP: + Log.e(TAG,"第"+(index+1)+"个手指抬起"); + break; +} +``` + +### 3. index 和 pointId 的变化规则 + +在 2.2 版本以上，我们可以通过 getActionIndex() 轻松获取到事件的索引(Index)，但是这个事件索引的变化还是有点意思的，Index 变化有以下几个特点： + +1、从 0 开始，自动增长。 +2、如果之前落下的手指抬起，后面手指的 Index 会随之减小。 +3、Index 变化趋向于第一次落下的数值(落下手指时，前面有空缺会优先填补空缺)。 +4、对 move 事件无效。 + +下面我们逐条解释一下具体含义。 + +#### 3.1、从 0 开始，自动增长。 + +这一条非常简单，也很容易理解，而且在 [MotionEvent详解][motionevent] 中讲解 getAction() 与 getActionMasked() 也简单说过。 + +| 手指按下 | 触发事件(数值) | +| :-----: | :--------------------------------------- | +| 第1个手指按下 | ACTION_DOWN (0x0000**00**00) | +| 第2个手指按下 | ACTION_POINTER_DOWN (0x0000**01**05) | +| 第3个手指按下 | ACTION_POINTER_DOWN (0x0000**02**05) | +| 第4个手指按下 | ACTION_POINTER_DOWN (0x0000**03**05) | + +注意加粗的位置，数值随着手指按下而不断变大。 + +#### 3.2、如果之前落下的手指抬起，后面手指的 Index 会随之减小。 + +这个也比较容易理解，像下面这样： + +| 手指按下 | 触发事件(数值) | +| :-----: | :--------------------------------------- | +| 第1个手指按下 | ACTION_DOWN (0x0000**00**00) | +| 第2个手指按下 | ACTION_POINTER_DOWN (0x0000**01**05) | +| 第3个手指按下 | ACTION_POINTER_DOWN (0x0000**02**05) | +| 第2个手指抬起 | ACTION_POINTER_UP (0x0000**01**06) | +| 第3个手指抬起 | ACTION_POINTER_UP (0x0000**01**06) | + +注意最后两次触发的事件，它的 Index 都是 1，这样也比较容易解释，当原本的第 2 个手指抬起后，屏幕上就只剩下两个手指了，之前的第 3 个手指就变成了第 2 个，于是抬起时触发事件的 Index 为 1，即之前落下的手指抬起，后面手指的 Index 会随之减小。 + +#### 3.3、Index 变化趋向于第一次落下的数值(落下手指时，前面有空缺会优先填补空缺)。 + +这个就有点神奇了，通过上一条规则，我们知道，某一个手指的 Index 可能会随着其他手指的抬起而变小，这次我们用 4 个手指测试一下 Index 的变化趋势。 + +| 手指按下 | 触发事件(数值) | +| :---------: | :--------------------------------------- | +| 第1个手指按下 | ACTION_DOWN (0x0000**00**00) | +| 第2个手指按下 | ACTION_POINTER_DOWN (0x0000**01**05) | +| **第3个手指按下** | ACTION_POINTER_DOWN (0x0000**02**05) | +| 第2个手指抬起 | ACTION_POINTER_UP (0x0000**01**06) | +| ~~第3个手指抬起~~ | ~~ACTION_POINTER_UP~~ ~~(0x0000**01**06)~~ | +| 第4个手指按下 | ACTION_POINTER_DOWN (0x0000**01**05) | +| **第3个手指抬起** | ACTION_POINTER_UP (0x0000**02**06) | + +这个要和上一个对比这看，**重点观察第 3 个手指所触发事件区别**，在上一个示例中，随着第 2 个手指的抬起，第 3 个手指变化为第 2(01) 个，所以抬起时触发的是第 2 根手指的抬起事件(删除线部分)。 + +但是，如果第 2 个手指抬起后，落在屏幕上另外一个手指会怎样？经过测试，发现另外**落下的手指会替代之前第 2 个手指的位置，系统判定为 2(01)，而不是顺延下去变成 3(02)，并且原本第3个手指的index变为原来数值(02)**，但是如果继续落下其他的手指，数值则会顺延。 + +**即手指抬起时的 Index 会趋向于和按下时相同，虽然在手指数量不足时，Index 会变小，但是当手指变多时，Index 会趋向于保持和按下时一样。** + +> PS：由于程序是从0开始计数的，所以 0 就是 1， 1 就是 2 ... + +#### 3.4、对 move 事件无效。 + +这个也比较容易理解，我们所取得的 Index 属性实际上是从事件上分离下来的，但是 move 事件始终为 0x0000**00**02，也就是说，在 move 时不论你移动哪个手指，使用 `getActionIndex()` 获取到的始终是数值 0。 + +既然 move 事件无法用事件索引(Index)区别，那么该如何区分 move 是那个手指发出的呢？这就要用到 pointId 了，**pointId 和 index 最大的区别就是 pointId 是不变的，始终为第一次落下时生成的数值，不会受到其他手指抬起和落下的影响。** + +#### 3.5、pointId 与 index 的异同。 + +相同点： + +- 从 0 开始，自动增长。 +- 落下手指时优先填补空缺(填补之前抬起手指的编号)。 + +不同点： + +- Index 会变化，pointId 始终不变。 + +### 4. Move 相关事件 + +#### 4.1 actionIndex 与 pointerIndex + +在 move 中无法取得 actionIndex 的，我们需要使用 pointerIndex 来获取更多的信息，例如某个手指的坐标： + +```java +getX(int pointerIndex) +getY(int pointerIndex) +``` + +**但是这个 pointerIndex 又是什么呢？和 actionIndex 有区别么？** + +实际上这个 pointerIndex 和 actionIndex 区别并不大，两者的数值是相同的，你可以认为 pointerIndex 是特地为 move 事件准备的 actionIndex。 + +#### 4.2 pointerIndex 与 pointerId + +| 类型 | 简介 | +| ------------ | ----------------------------- | +| pointerIndex | 用于获取具体事件，可能会随着其他手指的抬起和落下而变化 | +| pointerId | 用于识别手指，手指按下时产生，手指抬起时回收，期间始终不变 | + +这两个数值使用以下两个方法相互转换。 + +| 方法 | 简介 | +| ------------------------------- | ---------------------------------------- | +| getPointerId(int pointerIndex) | 获取一个指针(手指)的唯一标识符ID，在手指按下和抬起之间ID始终不变。 | +| findPointerIndex(int pointerId) | 通过 pointerId 获取到当前状态下 pointIndex，之后通过 pointIndex 获取其他内容。 | + +> 通常情况下，pointerIndex 和 pointerId 是相同的，但也可能会因为某些手指的抬起而变得不同。 + +#### 4.3 遍历多点触控 + +先来一个简单的，遍历出多个手指的 move 事件： + +```java +String TAG = "Gcs"; +switch (event.getActionMasked()) { + case MotionEvent.ACTION_MOVE: + for (int i = 0; i < event.getPointerCount(); i++) { + Log.i("TAG", "pointerIndex="+i+", pointerId="+event.getPointerId(i)); + // TODO + } +} +``` + +通过遍历 pointerCount 获取到所有的 pointerIndex，同时通过 pointerIndex 来获取 pointerId，可以通过不同手指抬起和按下后移动来观察 pointerIndex 和 pointerId 的变化。 + +#### 4.4 在多点触控中追踪单个手指 + +要实现追踪单个手指还是有些麻烦的，需要同时使用上 actionIndex， pointerId 和 pointerIndex，例如，我们只追踪第2个手指，并画出其位置： + +```java +/** + * 绘制出第二个手指第位置 + */ +public class MultiTouchTest extends CustomView { + String TAG = "Gcs"; + + // 用于判断第2个手指是否存在 + boolean haveSecondPoint = false; + + // 记录第2个手指第位置 + PointF point = new PointF(0, 0); + + public MultiTouchTest(Context context) { + this(context, null); + } + + public MultiTouchTest(Context context, AttributeSet attrs) { + super(context, attrs); + + mDeafultPaint.setAntiAlias(true); + mDeafultPaint.setTextAlign(Paint.Align.CENTER); + mDeafultPaint.setTextSize(30); + } + + @Override + public boolean onTouchEvent(MotionEvent event) { + int index = event.getActionIndex(); + + switch (event.getActionMasked()) { + case MotionEvent.ACTION_POINTER_DOWN: + // 判断是否是第2个手指按下 + if (event.getPointerId(index) == 1){ + haveSecondPoint = true; + point.set(event.getY(), event.getX()); + } + break; + case MotionEvent.ACTION_POINTER_UP: + // 判断抬起的手指是否是第2个 + if (event.getPointerId(index) == 1){ + haveSecondPoint = false; + point.set(0, 0); + } + break; + case MotionEvent.ACTION_MOVE: + if (haveSecondPoint) { + // 通过 pointerId 来获取 pointerIndex + int pointerIndex = event.findPointerIndex(1); + // 通过 pointerIndex 来取出对应的坐标 + point.set(event.getX(pointerIndex), event.getY(pointerIndex)); + } + break; + } + + invalidate(); // 刷新 + + return true; + } + + @Override + protected void onDraw(Canvas canvas) { + canvas.save(); + canvas.translate(mViewWidth/2, mViewHeight/2); + canvas.drawText("追踪第2个按下手指的位置", 0, 0, mDeafultPaint); + canvas.restore(); + + // 如果屏幕上有第2个手指则绘制出来其位置 + if (haveSecondPoint) { + canvas.drawCircle(point.x, point.y, 50, mDeafultPaint); + } + } +} +``` + +这段代码也非常短，其核心就是通过判断数值为 1 的 pointerId 是否存在，如果存在就在 move 的时候取出其坐标，并绘制出来。 + +![SecondPoint](http://ww3.sinaimg.cn/large/006y8lVagw1fbs1vkt1mwj30bo0jq3z3.jpg) + +> 虽然逻辑简单，但个人感觉写起来还是有些麻烦，如果有更简单的方案欢迎告诉我。 + + + +## 二、如何使用多点触控 + +多点触控应用还是比较广泛的，至少目前大部分的图片查看都需要用到多点触控技术(用于拖动和缩放图片)。 + +但是在某些看似不需要多触控的地方也需要对多点触控进行判断，只要是多点触控可能引起错误的地方都应该加上多点触控的判断。例如使用到 move 事件的时候，由于 move 事件可能由多个手指同时触发，所以可能会出现同时被多个手指控制的情况，如果不适当的处理，这个 move 就可能由任何一个手指触发。 + +举一个简单的例子： + +如果我们需要一个**可以用单指拖动的图片**。假如我们不进行多指触控的判断，像下面这样： + +**没有针对多指触控处理版本：** + +```java +/** + * 一个可以拖图片动的 View + */ +public class DragView1 extends CustomView { + String TAG = "Gcs"; + + Bitmap mBitmap; // 图片 + RectF mBitmapRectF; // 图片所在区域 + Matrix mBitmapMatrix; // 控制图片的 matrix + + boolean canDrag = false; + PointF lastPoint = new PointF(0, 0); + + public DragView1(Context context) { + this(context, null); + } + + public DragView1(Context context, AttributeSet attrs) { + super(context, attrs); + + // 调整图片大小 + BitmapFactory.Options options = new BitmapFactory.Options(); + options.outWidth = 960/2; + options.outHeight = 800/2; + + mBitmap = BitmapFactory.decodeResource(this.getResources(), R.drawable.drag_test, options); + mBitmapRectF = new RectF(0,0,mBitmap.getWidth(), mBitmap.getHeight()); + mBitmapMatrix = new Matrix(); + } + + @Override + public boolean onTouchEvent(MotionEvent event) { + switch (event.getActionMasked()) { + case MotionEvent.ACTION_DOWN: + // 判断按下位置是否包含在图片区域内 + if (mBitmapRectF.contains((int)event.getX(), (int)event.getY())){ + canDrag = true; + lastPoint.set(event.getX(), event.getY()); + } + break; + case MotionEvent.ACTION_UP: + canDrag = false; + case MotionEvent.ACTION_MOVE: + if (canDrag) { + // 移动图片 + mBitmapMatrix.postTranslate(event.getX() - lastPoint.x, event.getY() - lastPoint.y); + // 更新上一次点位置 + lastPoint.set(event.getX(), event.getY()); + + // 更新图片区域 + mBitmapRectF = new RectF(0, 0, mBitmap.getWidth(), mBitmap.getHeight()); + mBitmapMatrix.mapRect(mBitmapRectF); + + invalidate(); + } + break; + } + + return true; + } + + @Override + protected void onDraw(Canvas canvas) { + canvas.drawBitmap(mBitmap, mBitmapMatrix, mDeafultPaint); + } +} +``` + +这个版本非常简单，当然了，如果正常使用(只使用一个手指)的话也不会出问题，但是当使用多个手指，且有抬起和按下的时候就可能出问题，下面用一个典型的场景演示一下： + +![dragview1](http://ww2.sinaimg.cn/large/006y8lVagw1fbs1vm2rppg308c0d4kfm.gif) + +注意在第二个手指按下，第一个手指抬起时，此时原本的第二个手指会被识别为第一个，所以图片会直接跳动到第二个手指位置。 + +为了不出现这种情况，我们可以判断一下 pointId 并且只获取第一个手指的数据，这样就能避免这种情况发生了，如下。 + +**针对多指触控处理后版本：** + +```java +/** + * 一个可以拖图片动的 View + */ +public class DragView extends CustomView { + String TAG = "Gcs"; + + Bitmap mBitmap; // 图片 + RectF mBitmapRectF; // 图片所在区域 + Matrix mBitmapMatrix; // 控制图片的 matrix + + boolean canDrag = false; + PointF lastPoint = new PointF(0, 0); + + public DragView(Context context) { + this(context, null); + } + + public DragView(Context context, AttributeSet attrs) { + super(context, attrs); + + BitmapFactory.Options options = new BitmapFactory.Options(); + options.outWidth = 960/2; + options.outHeight = 800/2; + + mBitmap = BitmapFactory.decodeResource(this.getResources(), R.drawable.drag_test, options); + mBitmapRectF = new RectF(0,0,mBitmap.getWidth(), mBitmap.getHeight()); + mBitmapMatrix = new Matrix(); + } + + @Override + public boolean onTouchEvent(MotionEvent event) { + switch (event.getActionMasked()) { + case MotionEvent.ACTION_DOWN: + case MotionEvent.ACTION_POINTER_DOWN: + // ▼ 判断是否是第一个手指 && 是否包含在图片区域内 + if (event.getPointerId(event.getActionIndex()) == 0 && mBitmapRectF.contains((int)event.getX(), (int)event.getY())){ + canDrag = true; + lastPoint.set(event.getX(), event.getY()); + } + break; + case MotionEvent.ACTION_UP: + case MotionEvent.ACTION_POINTER_UP: + // ▼ 判断是否是第一个手指 + if (event.getPointerId(event.getActionIndex()) == 0){ + canDrag = false; + } + break; + case MotionEvent.ACTION_MOVE: + // 如果存在第一个手指，且这个手指的落点在图片区域内 + if (canDrag) { + // ▼ 注意 getX 和 getY + int index = event.findPointerIndex(0); + // Log.i(TAG, "index="+index); + mBitmapMatrix.postTranslate(event.getX(index)-lastPoint.x, event.getY(index)-lastPoint.y); + lastPoint.set(event.getX(index), event.getY(index)); + + mBitmapRectF = new RectF(0,0,mBitmap.getWidth(), mBitmap.getHeight()); + mBitmapMatrix.mapRect(mBitmapRectF); + + invalidate(); + } + break; + } + + return true; + } + + @Override + protected void onDraw(Canvas canvas) { + canvas.drawBitmap(mBitmap, mBitmapMatrix, mDeafultPaint); + } +} +``` + +可以看到，比起上一个版本，只添加了少量代码，就变得更加“智能”了，可以准确识别某一个手指，不会因为手指抬起而认错手指。 + +![dragview2](http://ww2.sinaimg.cn/large/006y8lVagw1fbs1vmwpu4g308c0d4nf9.gif) + +**重点注意最后，第一个手指抬起之后，图片并没有跳跃到第二个手指的位置。** + +上面的两个对比示例都精简到了极致，其核心依旧是正确的追踪某一个手指，建议大家自己写一遍体会一下。 + +------ + +我感觉很多人看到这里依旧是不明所以的，一些简单的东西还好弄，但是复杂一些，如同时处理多个手指的数值就有些困难了，**假如说你之前没有接触过多点触控的处理，此时让你实现用两个手指来缩放图片还是有些困难的。** + +因为这不仅要追踪两个手指的位置，还要根据位置变化来计算缩放比例和缩放中心，单单这两个非常简单的数学问题就能难倒一大批人。 + +![-510a02a1a3f8d16d](http://ww2.sinaimg.cn/large/006y8lVagw1fbs1vnfni1g307b07ct8m.gif) + +当然了，很多麻烦问题都有简单的解决方案，假如说我们真的要实现一个可以用两个或者多个手指缩放的控件，何必要自己算呢，可以尝试一下 Android 自带的解决方案：**手势检测(GestureDetector)**，不仅能自动帮你计算好缩放比例和缩放中心，而且还可以检测出 单击、长按、滑屏 等不同的手势，不过这就不是本篇的事情了，以后有时间会写一下有关手势检测的用法(继续挖坑)。 + +## 三、总结 + +前段时间因为各种事情比较忙，这篇文章也没时间去写，所以就一直拖到了现在，期间收到不少读者催更，实在是抱歉了。今后在会尽量保证稳定更新的，争取尽快把自定义View系列这一个大坑填完。 ˊ_>ˋ + +关于多点触控，个人认为还算一个比较重要的知识点。尤其是随着 Android 的发展，很多炫酷的交互操作可能会需要用户进行拖拽操作。在进行这类操作的时候进行一下手指的判断还是相当重要的。 + +本文中需要注意的几个知识点： + +- 如何兼容 2.0 版本的多点触控(目前大部分都不需要兼容 2.0 了吧)。 +- actionIndex、pointIndex 与 pointId 的区别和用法。 +- 如何在多点触控中正确的追踪一个手指。 + +## About Me + +### 作者微博: @GcsSloop + + + +## 参考资料 + +[MotionEvent ](https://developer.android.com/reference/android/view/MotionEvent.html) + + + +[motionevent]: http://www.gcssloop.com/customview/motionevent \ No newline at end of file diff --git a/CustomView/Advance/[19]gesture-detector.md b/CustomView/Advance/[19]gesture-detector.md new file mode 100644 index 00000000..94e60e18 --- /dev/null +++ b/CustomView/Advance/[19]gesture-detector.md @@ -0,0 +1,386 @@ +# Android 手势检测(GestureDetector) + +Android 手势检测，主要是 GestureDetector 相关内容的用法和注意事项，本文依旧属于事件处理这一体系，部分内容会涉及到之前文章提及过的知识点，如果你没看过之前的文章，可以到 [自定义 View 系列](http://www.gcssloop.com/customview/CustomViewIndex) 来查看这些内容。 + +在开发 Android 手机应用过程中，可能需要对一些手势作出响应，如：单击、双击、长按、滑动、缩放等。这些都是很常用的手势。就拿最简单的双击来说吧，假如我们需要判断一个控件是否被双击(即在较短的时间内快速的点击两次)，似乎是一个很容易的任务，但仔细考虑起来，要处理的细节问题也有不少，例如： + +1. **记录点击次数**，为了判断是否被点击超过 1 次，所以必须记录点击次数。 +2. **记录点击时间**，由于双击事件是较快速的点击两次，像点击一次后，过来几分钟再点击一次肯定不能算是双击事件，所以在记录点击次数的同时也要记录上一次的点击时间，我们可以设置本次点击距离上一次时间超过一定时间(例如：超过100ms)就不识别为双击事件。 +3. **点击状态重置**，在响应双击事件，或者判断不是双击事件的时候要重置计数器和上一次点击时间。重置既可以在点击的时候判断并进行重新设置，也可以使用定时器等超过一定时间后重置状态。 + +这样看起来，判断一个双击事件就有这么多麻烦事情，更别其他的手势了，虽然这些看起来都很简单，但设计起来需要考虑的细节情况实在是太多了。 + +那么有没有一种更好的方法来方便的检测手势呢？当然有啦，因为这些手势很常用，系统早就封装了一些方法给我们用，接下来我们就看看它们是如何使用的。 + +## GestureDetector + +> GestureDetector 可以使用 MotionEvents 检测各种手势和事件。GestureDetector.OnGestureListener 是一个回调方法，在发生特定的事件时会调用 Listener 中对应的方法回调。这个类只能用于检测触摸事件的 MotionEvent，不能用于轨迹球事件。 +> (话说轨迹球已经消失多长时间了，估计很多人都没见过轨迹球这种东西)。 +> +> 如何使用： +> +> - 创建一个 GestureDetector 实例。 +> - 在onTouchEvent（MotionEvent）方法中，确保调用 GestureDetector 实例的 onTouchEvent（MotionEvent）。回调中定义的方法将在事件发生时执行。 +> - 如果侦听 onContextClick（MotionEvent），则必须在 View 的 onGenericMotionEvent（MotionEvent）中调用 GestureDetector OnGenericMotionEvent（MotionEvent）。 + + GestureDetector 本身的方法比较少，使用起来也非常简单，下面让我们先看一下它的简单使用示例，分解开来大概需要三个步骤。 + +```java +// 1.创建一个监听回调 +SimpleOnGestureListener listener = new SimpleOnGestureListener() { + @Override public boolean onDoubleTap(MotionEvent e) { + Toast.makeText(MainActivity.this, "双击666", Toast.LENGTH_SHORT).show(); + return super.onDoubleTap(e); + } +}; + +// 2.创建一个检测器 +final GestureDetector detector = new GestureDetector(this, listener); + +// 3.给监听器设置数据源 +view.setOnTouchListener(new View.OnTouchListener() { + @Override public boolean onTouch(View v, MotionEvent event) { + return detector.onTouchEvent(event); + } +}); +``` + +接下来我们先了解一下 GestureDetector 里面都有哪些内容。 + +### 1. 构造函数 + +GestureDetector 一共有 5 种构造函数，但有 2 种被废弃了，1 种是重复的，所以我们只需要关注其中的 2 种构造函数即可，如下： + +| 构造函数 | +| ---------------------------------------- | +| GestureDetector(Context context, GestureDetector.OnGestureListener listener) | +| GestureDetector(Context context, GestureDetector.OnGestureListener listener, Handler handler) | + +第 1 种构造函数里面需要传递两个参数，上下文(Context) 和 手势监听器(OnGestureListener)，这个很容易理解，就不再过多叙述，上面的例子中使用的就是这一种。 + +第 2 种构造函数则需要多传递一个 Handler 作为参数，这个有什么作用呢？其实作用也非常简单，这个 Handler 主要是为了给 GestureDetector 提供一个 Looper。 + +在通常情况下是不需这个 Handler 的，因为它会在内部自动创建一个 Handler 用于处理数据，如果你在主线程中创建 GestureDetector，那么它内部创建的 Handler 会自动获得主线程的 Looper，然而如果你在一个没有创建 Looper 的子线程中创建 GestureDetector 则需要传递一个带有 Looper 的 Handler 给它，否则就会因为无法获取到 Looper 导致创建失败。 + +第 2 种构造函数使用方式如下(下面是两种在子线程中创建 GestureDetector 的方法)： + +```java +// 方式一、在主线程创建 Handler +final Handler handler = new Handler(); +new Thread(new Runnable() { + @Override public void run() { + final GestureDetector detector = new GestureDetector(MainActivity.this, new + GestureDetector.SimpleOnGestureListener() , handler); + // ... 省略其它代码 ... + } +}).start(); + +// 方式二、在子线程创建 Handler，并且指定 Looper +new Thread(new Runnable() { + @Override public void run() { + final Handler handler = new Handler(Looper.getMainLooper()); + final GestureDetector detector = new GestureDetector(MainActivity.this, new + GestureDetector.SimpleOnGestureListener() , handler); + // ... 省略其它代码 ... + } +}).start(); +``` + +当然了，使用其它创建 Handler 的方式也是可以的，重点传递的 Handler 一定要有 Looper，敲黑板，重点是 Handler 中的 Looper。假如子线程准备了 Looper 那么可以直接使用第 1 种构造函数进行创建，如下： + +```java +new Thread(new Runnable() { + @Override public void run() { + Looper.prepare(); // <- 重点在这里 + final GestureDetector detector = new GestureDetector(MainActivity.this, new + GestureDetector.SimpleOnGestureListener()); + // ... 省略其它代码 ... + } +}).start(); +``` + +### 2.手势监听器 + +既然是手势检测，自然要在对应的手势出现的时候通知调用者，最合适的自然是事件监听器模式。目前 GestureDetecotr 有四种监听器。 + +| 监听器 | 简介 | +| ---------------------------------------- | ---------------------------------------- | +| [OnContextClickListener](https://developer.android.com/reference/android/view/GestureDetector.OnContextClickListener.html) | 这个很容易让人联想到ContextMenu，然而它和ContextMenu并没有什么关系，它是在Android6.0(API 23)才添加的一个选项，是用于检测外部设备上的按钮是否按下的，例如蓝牙触控笔上的按钮，一般情况下，忽略即可。 | +| [OnDoubleTapListener](https://developer.android.com/reference/android/view/GestureDetector.OnDoubleTapListener.html) | 双击事件，有三个回调类型：双击(DoubleTap)、单击确认(SingleTapConfirmed) 和 双击事件回调(DoubleTapEvent) | +| [OnGestureListener](https://developer.android.com/reference/android/view/GestureDetector.OnGestureListener.html) | 手势检测，主要有以下类型事件：按下(Down)、 一扔(Fling)、长按(LongPress)、滚动(Scroll)、触摸反馈(ShowPress) 和 单击抬起(SingleTapUp) | +| [SimpleOnGestureListener](https://developer.android.com/reference/android/view/GestureDetector.SimpleOnGestureListener.html) | 这个是上述三个接口的空实现，一般情况下使用这个比较多，也比较方便。 | + +#### 2.1 OnContextClickListener + +由于 OnContextClickListener 主要是用于检测外部设备按钮的，关于它需要注意一点，如果侦听 onContextClick(MotionEvent)，则必须在 View 的 onGenericMotionEvent(MotionEvent)中调用 GestureDetector 的 OnGenericMotionEvent(MotionEvent)。 + +由于目前我们用到这个监听器的场景并不多，所以也就不展开介绍了，重点关注后面几个监听器。 + +#### 2.2 OnDoubleTapListener + +这个很明显就是用于检测双击事件的，它有三个回调接口，分别是 onDoubleTap、onDoubleTapEvent 和 onSingleTapConfirmed。 + +##### **2.2.1 onDoubleTap 与 onSingleTapConfirmed** + +**如果你只想监听双击事件，那么只用关注 onDoubleTap 就行了，如果你同时要监听单击事件则需要关注 onSingleTapConfirmed 这个回调函数**。 + +有人可能会有疑问，监听单击事件为什么要使用 onSingleTapConfirmed，使用 OnClickListener 不行吗？从理论上是可行的，但是我并不推荐这样使用，主要有两个原因： +1.它们两个是存在一定冲突的，如果你看过 [事件分发机制详解](http://www.gcssloop.com/customview/dispatch-touchevent-source) 就会知道，如果想要两者同时被触发，则 setOnTouchListener 不能消费事件，如果 onTouchListener 消费了事件，就可能导致 OnClick 无法正常触发。 +2.需要同时监听单击和双击，则说明单击和双击后响应逻辑不同，然而使用 OnClickListener 会在双击事件发生时触发两次，这显然不是我们想要的结果。而使用 onSingleTapConfirmed 就不用考虑那么多了，你完全可以把它当成单击事件来看待，而且在双击事件发生时，onSingleTapConfirmed 不会被调用，这样就不会引发冲突。 + +如果你需要同时监听两种点击事件可以这样写： + +```java +GestureDetector detector = new GestureDetector(this, new GestureDetector + .SimpleOnGestureListener() { + @Override public boolean onSingleTapConfirmed(MotionEvent e) { + Toast.makeText(MainActivity.this, "单击", Toast.LENGTH_SHORT).show(); + return false; + } + @Override public boolean onDoubleTap(MotionEvent e) { + Toast.makeText(MainActivity.this, "双击", Toast.LENGTH_SHORT).show(); + return false; + } +}); +``` + +关于 onSingleTapConfirmed 原理也非常简单，这一个回调函数在单击事件发生后300ms后触发(注意，不是立即触发的)，只有在确定不会有后续的事件后，既当前事件肯定是单击事件才触发 onSingleTapConfirmed，所以在进行点击操作时，onDoubleTap 和 onSingleTapConfirmed 只会有一个被触发，也就不存在冲突了。 + +当然，如果你对事件分发机制非常了解的话，随便怎么用都行，条条大路通罗马，我这里只是推荐一种最简单而且不容易出错的实现方案。 + +##### **2.2.2 onDoubleTapEvent** + +**有些细心的小伙伴可能注意到还有一个 onDoubleTapEvent 回调函数，它是干什么的呢？它在双击事件确定发生时会对第二次按下产生的 MotionEvent 信息进行回调。** + +至于为什么要存在这样的回调，就要涉及到另一个比较细致的问题了，那就是 onDoubleTap 的触发时间，如果你在这些函数被调用时打印一条日志，那么你会看到这样的信息： + +``` +GCS-LOG: onDoubleTap +GCS-LOG: onDoubleTapEvent - down +GCS-LOG: onDoubleTapEvent - move +GCS-LOG: onDoubleTapEvent - move +GCS-LOG: onDoubleTapEvent - up +``` + +通过观察这些信息你会发现它们的调用顺序非常有趣，首先是 onDoubleTap 被触发，之后依次触发 onDoubleTapEvent 的 down、move、up 等信息，为什么说它们有趣呢？是因为这样的调用顺序会引发两种猜想，第一种猜想是 onDoubleTap 是在第二次手指抬起(up)后触发的，而 onDoubleTapEvent 是一种延时回调。第二种猜想则是 onDoubleTap 在第二次手指按下(dowm)时触发，onDoubleTapEvent 是一种实时回调。 + +通过测试和观察源码发现第二种猜想是正确的，因为第二次按下手指时，即便不抬起也会触发 onDoubleTap 和 onDoubleTapEvent 的 down，而且源码中逻辑也表明 onDoubleTapEvent 是一种实时回调。 + +这就引发了另一个问题，双击的触发时间，虽然这是一个细微到很难让人注意到的问题，假如说我们想要在第二次按下抬起后才判定这是一个双击操作，触发后续的内容，则不能使用 onDoubleTap 了，需要使用 onDoubleTapEvent 来进行更细微的控制，如下： + +```java +final GestureDetector detector = new GestureDetector(MainActivity.this, new GestureDetector.SimpleOnGestureListener() { + @Override public boolean onDoubleTap(MotionEvent e) { + Logger.e("第二次按下时触发"); + return super.onDoubleTap(e); + } + + @Override public boolean onDoubleTapEvent(MotionEvent e) { + switch (e.getActionMasked()) { + case MotionEvent.ACTION_UP: + Logger.e("第二次抬起时触发"); + break; + } + return super.onDoubleTapEvent(e); + } +}); +``` + +如果你不需要控制这么细微的话，忽略即可(Logger 是我自己封装的日志库，忽略即可)。 + +#### 2.3 OnGestureListener + +这个是手势检测中较为核心的一个部分了，主要检测以下类型事件：按下(Down)、 一扔(Fling)、长按(LongPress)、滚动(Scroll)、触摸反馈(ShowPress) 和 单击抬起(SingleTapUp)。 + +##### 2.3.1 onDown + +```java +@Override public boolean onDown(MotionEvent e) { + return true; +} +``` + +看过前面的文章应该知道，down 在事件分发体系中是一个较为特殊的事件，为了保证事件被唯一的 View 消费，哪个 View 消费了 down 事件，后续的内容就会传递给该 View。如果我们想让一个 View 能够接收到事件，有两种做法： + +1、让该 View 可以点击，因为可点击状态会默认消费 down 事件。 + +2、手动消费掉 down 事件。 + +由于图片、文本等一些控件默认是不可点击的，所以我们要么声明它们的 clickable 为 true，要么在发生 down 事件是返回 true。所以 onDown 在这里的作用就很明显了，就是为了保证让该控件能拥有消费事件的能力，以接受后续的事件。 + +##### 2.3.2 onFling + +Failing 中文直接翻译过来就是一扔、抛、甩，最常见的场景就是在 ListView 或者 RecyclerView 上快速滑动时手指抬起后它还会滚动一段时间才会停止。onFling 就是检测这种手势的。 + +```java +@Override +public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float + velocityY) { + return super.onFling(e1, e2, velocityX, velocityY); +} +``` + +在 onFling 的回调中共有四个参数，分别是： + +| 参数 | 简介 | +| --------- | ------------------ | +| e1 | 手指按下时的 Event。 | +| e2 | 手指抬起时的 Event。 | +| velocityX | 在 X 轴上的运动速度(像素／秒)。 | +| velocityY | 在 Y 轴上的运动速度(像素／秒)。 | + +我们可以通过 e1 和 e2 获取到手指按下和抬起时的坐标、时间等相关信息，通过 velocityX 和 velocityY 获取到在这段时间内的运动速度，单位是像素／秒(即 1 秒内滑动的像素距离)。 + +这个我们自己用到的地方比较少，但是也可以帮助我们简单的做出一些有趣的效果，例如下面的这种弹球效果，会根据滑动的力度和方向产生不同的弹跳效果。 + +![](https://ww2.sinaimg.cn/large/006tKfTcgy1fhe10uwa4fg308c0e6wn5.gif) + +其实这种原理非常简单，简化之后如下： + +1. 记录 velocityX 和 velocityY 作为初始速度，之后不断让速度衰减，直至为零。 +2. 根据速度和当前小球的位置计算一段时间后的位置，并在该位置重新绘制小球。 +3. 判断小球边缘是否碰触控件边界，如果碰触了边界则让速度反向。 + +根据这三条基本的逻辑就可以做出比较像的弹球效果，[具体的Demo可以看这里](https://raw.githubusercontent.com/GcsSloop/AndroidNote/master/CustomView/Demo/FailingBall.zip)。 + +##### 2.3.3 onLongPress + +这个是检测长按事件的，即手指按下后不抬起，在一段时间后会触发该事件。 + +```java +@Override +public void onLongPress(MotionEvent e) { +} +``` + +##### 2.3.4 onScroll + +onScroll 就是监听滚动事件的，它看起来和 onFaling 比较像，不同的是，onSrcoll 后两个参数不是速度，而是滚动的距离。 + +```java +@Override +public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float + distanceY) { + return super.onScroll(e1, e2, distanceX, distanceY); +} +``` + +| 参数 | | +| --------- | ----------- | +| e1 | 手指按下时的Event | +| e2 | 手指抬起时的Event | +| distanceX | 在 X 轴上划过的距离 | +| distanceY | 在 Y 轴上划过的距离 | + +##### 2.3.5 onShowPress + +它是用户按下时的一种回调，主要作用是给用户提供一种视觉反馈，可以在监听到这种事件时可以让控件换一种颜色，或者产生一些变化，告诉用户他的动作已经被识别。 + +不过这个消息和 onSingleTapConfirmed 类似，也是一种延时回调，延迟时间是 180 ms，假如用户手指按下后立即抬起或者事件立即被拦截，时间没有超过 180 ms的话，这条消息会被 remove 掉，也就不会触发这个回调。 + +```java +@Override +public void onShowPress(MotionEvent e) { +} +``` + +##### 2.3.6 onSingleTapUp + +```java +@Override +public boolean onSingleTapUp(MotionEvent e) { + return super.onSingleTapUp(e); +} +``` + +这个也很容易理解，就是用户单击抬起时的回调，但是它和上面的 `onSingleTapConfirmed` 之间有何不同呢？和 `onClick` 又有何不同呢？ + +单击事件触发： + +```java +GCS: onSingleTapUp +GCS: onClick +GCS: onSingleTapConfirmed +``` + +| 类型 | 触发次数 | 摘要 | +| -------------------- | ---- | ---- | +| onSingleTapUp | 1 | 单击抬起 | +| onSingleTapConfirmed | 1 | 单击确认 | +| onClick | 1 | 单击事件 | + +双击事件触发： + +```java +GCS: onSingleTapUp +GCS: onClick +GCS: onDoubleTap // <- 双击 +GCS: onClick +``` + +| 类型 | 触发次数 | 摘要 | +| -------------------- | ---- | ------------ | +| onSingleTapUp | 1 | 在双击的第一次抬起时触发 | +| onSingleTapConfirmed | 0 | 双击发生时不会触发。 | +| onClick | 2 | 在双击事件时触发两次。 | + +可以看出来这三个事件还是有所不同的，根据自己实际需要进行使用即可 + +#### 2.4 SimpleOnGestureListener + +这个里面并没有什么内容，只是对上面三种 Listener 的空实现，在上面的例子中使用的基本都是这监听器。因为它用起来更方便一点。 + +这主要是 GestureDetector 构造函数的设计问题，以只监听 OnDoubleTapListener 为例，如果想要使用 OnDoubleTapListener 接口则需要这样进行设置： + +```java +GestureDetector detector = new GestureDetector(this, new GestureDetector + .SimpleOnGestureListener()); +detector.setOnDoubleTapListener(new GestureDetector.OnDoubleTapListener() { + @Override public boolean onSingleTapConfirmed(MotionEvent e) { + Toast.makeText(MainActivity.this, "单击确认", Toast.LENGTH_SHORT).show(); + return false; + } + + @Override public boolean onDoubleTap(MotionEvent e) { + Toast.makeText(MainActivity.this, "双击", Toast.LENGTH_SHORT).show(); + return false; + } + + @Override public boolean onDoubleTapEvent(MotionEvent e) { + // Toast.makeText(MainActivity.this,"",Toast.LENGTH_SHORT).show(); + return false; + } +}); +``` + +既然都已经创建 SimpleOnGestureListener 了，再创建一个 OnDoubleTapListener 显然十分浪费，如果构造函数不使用 SimpleOnGestureListener，而是使用 OnGestureListener 的话，会多出几个无用的空实现，显然很浪费，所以在一般情况下，老老实实的使用 SimpleOnGestureListener 就好了。 + +### 3. 相关方法 + +除了各类监听器之外，与 GestureDetector 相关的方法其实并不多，只有几个，下面来简单介绍一下。 + +| 方法 | 摘要 | +| ----------------------- | ---------------------------------------- | +| setIsLongpressEnabled | 通过布尔值设置是否允许触发长按事件，true 表示允许，false 表示不允许。 | +| isLongpressEnabled | 判断当前是否允许触发长按事件，true 表示允许，false 表示不允许。 | +| onTouchEvent | 这个是其中一个重要的方法，在最开始已经演示过使用方式了。 | +| onGenericMotionEvent | 这个是在 API 23 之后才添加的内容，主要是为 OnContextClickListener 服务的，暂时不用关注。 | +| setContextClickListener | 设置 ContextClickListener 。 | +| setOnDoubleTapListener | 设置 OnDoubleTapListener 。 | + +### 结语 + +关于手势检测部分的 GestureDetector 相关内容基本就这么多了，其实手势检测还有一个 ScaleGestureDetector 也是为手势检测服务的，限于篇幅，本次就讲这么多吧。 + +其实手势检测辅助类 GestureDetector 本身并不是很复杂，带上注释等内容才不到1000行，感兴趣的可以自己研究一下实现方式。 + +## About Me + +### 作者微博: @GcsSloop + + + +## 参考资料 + +[文档 · GestureDetector ](https://developer.android.com/reference/android/view/GestureDetector.html) +[源码 · GestureDetector](https://android.googlesource.com/platform/frameworks/base/+/refs/heads/master/core/java/android/view/GestureDetector.java) \ No newline at end of file diff --git a/CustomView/Base/[02]AngleAndRadian.md b/CustomView/Base/[02]AngleAndRadian.md index dab77f5a..07235471 100644 --- a/CustomView/Base/[02]AngleAndRadian.md +++ b/CustomView/Base/[02]AngleAndRadian.md @@ -20,17 +20,17 @@ 由于两者进制是不同的(**角度是60进制，弧度是10进制**),在合适的地方使用合适的单位来描述会更加方便。 > **例如：** -角度是60进位制，遇到30°6′这样的角，应该转化为10进制的30.1°。但弧度就不需要，因为弧度本身就是十进制的实数。 +> 角度是60进位制，遇到30°6′这样的角，应该转化为10进制的30.1°。但弧度就不需要，因为弧度本身就是十进制的实数。 ## 二.角度与弧度的定义 角度和弧度一样都是描述角的一种度量单位，下面是它们的定义： -名称 | 定义 -:---:| --- -角度 | 两条射线从圆心向圆周射出，形成一个夹角和夹角正对的一段弧。**当这段弧长正好等于圆周长的360分之一时，两条射线的夹角的大小为1度.** -弧度 | 两条射线从圆心向圆周射出，形成一个夹角和夹角正对的一段弧。**当这段弧长正好等于圆的半径时，两条射线的夹角大小为1弧度.** +| 名称 | 定义 | +| :--: | ---------------------------------------- | +| 角度 | 两条射线从圆心向圆周射出，形成一个夹角和夹角正对的一段弧。**当这段弧长正好等于圆周长的360分之一时，两条射线的夹角的大小为1度.** | +| 弧度 | 两条射线从圆心向圆周射出，形成一个夹角和夹角正对的一段弧。**当这段弧长正好等于圆的半径时，两条射线的夹角大小为1弧度.** | **如图:** @@ -39,22 +39,18 @@ ## 三.角度和弧度的换算关系 -根据角度和弧度的的定义和圆的相关知识非常容易就能得出两者的换算公式： +**圆一周对应的角度为360度(角度)，对应的弧度为2π弧度。** -先设圆的周长为C. 半径为r +**故得等价关系:360(角度) = 2π(弧度) ==> 180(角度) = π(弧度)** -C = 2πr; +由等价关系可得如下换算公式: -一周对应的角度为360度(角度)，对应的弧度为2π弧度。 +> rad 是弧度， deg 是角度 -故: **180度 = π弧度.** - -可得: - -公式 | 例子 -----------------------|--------------------- -**弧度 = 角度xπ/180** | 2π ＝ 360 x π / 180 -**角度 = 弧度x180/π** | 360 ＝ 2π x 180 / π +| 公式 | 例子 | +| ----------------------- | ------------------ | +| **rad = deg x π / 180** | 2π ＝ 360 x π / 180 | +| **deg = rad x 180 / π** | 360 ＝ 2π x 180 / π | 维基百科的公式： diff --git a/CustomView/Base/[03]Color.md b/CustomView/Base/[03]Color.md index 77694a0c..300b9cc5 100644 --- a/CustomView/Base/[03]Color.md +++ b/CustomView/Base/[03]Color.md @@ -32,7 +32,7 @@ B(Blue) | 蓝色 | 无色 | 蓝色 *其中 A R G B 的取值范围均为0~255(即16进制的0x00~0xff)* -A 从ox00到oxff表示从透明到不透明。 +A 从0x00到0xff表示从透明到不透明。 RGB 从0x00到0xff表示颜色从浅到深。 @@ -82,6 +82,8 @@ RGB 从0x00到0xff表示颜色从浅到深。 ``` java int color = getResources().getColor(R.color.mycolor); + + int color = getColor(R.color.myColor); //API 23 及以上支持该方法 ``` ### 4.在xml文件(layout或style)中引用或者创建颜色 @@ -129,7 +131,7 @@ PicPick具备了截取全屏、活动窗口、指定区域、固定区域、手 **注意：** -1.这里我们一般把每个通道的取值从0(ox00)到255(0xff)映射到0到1的浮点数表示。 +1.这里我们一般把每个通道的取值从0(0x00)到255(0xff)映射到0到1的浮点数表示。 2.这里等式右边的“绘制的颜色"、“Canvas上的原有颜色”都是经过预乘了自己的Alpha通道的值。如绘制颜色：0x88ffffff，那么参与运算时的每个颜色通道的值不是1.0，而是(1.0 * 0.5333 = 0.5333)。 (其中0.5333 = 0x88/0xff) diff --git a/CustomView/CustomViewRule.md b/CustomView/CustomViewRule.md new file mode 100644 index 00000000..766fcaa0 --- /dev/null +++ b/CustomView/CustomViewRule.md @@ -0,0 +1,48 @@ +# 自定义View基本法 + +我们使用手机，是想要获取某些信息，而 View 是这些信息的直接展示界面，因为信息种类繁多，为了更好的展示这些信息， View 也必须有多种多样，Android 系统本身就给我们提供了不少类型的 View，但有时仍不能满足我们的需要，所以有时可能需要自定义 View 来完成任务。 + +自定义 View 有许多需要注意的地方，关于这些需要注意的内容，我都会整理在这里，其名为《自定义 View 基本法》。 + +#### 第一条：尽量避免自定义 View。 + +由于 View 直接承载了与用户交互的重任，所以必须要考虑到各种情况，例如： + +* 当没有设置宽高属性时，View 默认应该多大。 +* 横竖屏转换时 View 可能重新设定大小，此时应如何处理。 +* View 因为特殊情况被销毁后重建，应如何保存和恢复数据。 + +由于某些情况很特殊，触发条件也特殊，我们简单的实现了一个自定义了一个 View，可能在 99% 的情况下都是正常的，但在某些特殊情况下就会出问题。 + +而系统提供给我们的组件都是经过千锤百炼的，基本上考虑到了各种特殊情况的处理，所以通常情况下，系统提供给我们的组件稳定性要好一些。所以我的建议是，能使用系统提供的组件的尽量使用系统的。 + +除此之外，使用系统提供的组件也方便于其他人快速读懂项目，便于交流。 + +#### 第二条：尽量避免从头开始。 + +如果一定要使用自定义 View，那么尽量去继承系统已有的组件，并重写其中的部分方法，不要自己从头开始写。例如：图像相关的 View 可以考虑继承 ImageView，容器类 View 可以考虑继承 LinerLayout，RelativeLayout 等，原因同上。 + +#### 第三条：处理特殊情况。 + +针对能想到的一些特殊情况进行处理并且测试，尽量保证自定义 View 能适应各种特殊场景。 + +#### 第四条：留下文档。 + +**程序员有两大痛苦，1、别人写的项目居然没有文档。2、自己写的项目居然要写文档。** + +虽然有时候文档写起来确实挺麻烦，但是个人建议要留下一份文档，至少要为自己写的程序添加**有效的注释**，这不仅是方便他人，更重要的是方便自己以后修改项目。 + +* 于自定义View而言，首先要标明这个自定义View是解决什么问题，有怎样的效果，使用的场景如何。 +* 其次要在关键部位标注实现原理。(例如：显示圆形的ImageView，要标明圆形是如何实现的，使用的是遮罩还是剪裁。) +* 避免无效注释 (例如：在onDraw上面标注绘图)，大家都知道这个是绘图，但绘制逻辑才是重点，要去标注绘制逻辑。 + +#### 第五条：面向结果编程。 + +我们既然使用自定义View，自然是想要实现一些系统组件无法实现的效果，所以要时刻谨记自己所需要的内容，让其中的所有逻辑都为这个结果服务，我自己实现自定义 View 一般有如下步骤： + +1. 原型，用我能想到的逻辑实现原型(demo)，不管其代码复杂度，首先要得到结果，通常情况下，第一份代码可得性和整洁性都比较差。 +2. 优化，在原型的基础上对代码进行优化，剔除不必要的内容，例如尝试优化逻辑，对与一些重复性的内容抽取函数进行封装，想办法消灭一些中间变量。同时添加上必要注释，让其逻辑更加清晰易懂。 +3. 测试，对其进行场景测试，尽量保证其正常运行。 + + + diff --git a/CustomView/Demo/FailingBall.zip b/CustomView/Demo/FailingBall.zip new file mode 100644 index 00000000..92f0b8f5 Binary files /dev/null and b/CustomView/Demo/FailingBall.zip differ diff --git a/CustomView/Demo/PieView.zip b/CustomView/Demo/PieView.zip new file mode 100644 index 00000000..f88db430 Binary files /dev/null and b/CustomView/Demo/PieView.zip differ diff --git a/CustomView/Demo/dispatchTouchEventDemo.zip b/CustomView/Demo/dispatchTouchEventDemo.zip new file mode 100644 index 00000000..665b5d4c Binary files /dev/null and b/CustomView/Demo/dispatchTouchEventDemo.zip differ diff --git a/CustomView/README.md b/CustomView/README.md index 084727ed..cf5a50ac 100644 --- a/CustomView/README.md +++ b/CustomView/README.md @@ -5,43 +5,52 @@ ## 基础篇

- - - + + +

******* ## 进阶篇

- - - + + +

*******

- - - + + +

*******

- - - + + +

*******

- - + + + +

+ +******* + +

+ + +

### 作者微博: [@GcsSloop](http://weibo.com/GcsSloop) - + diff --git a/Lecture/README.md b/Lecture/README.md new file mode 100644 index 00000000..959ec327 --- /dev/null +++ b/Lecture/README.md @@ -0,0 +1,4 @@ +# 演讲稿 + +* [程序员练级指北(郑州GDG-2016DevFest)](https://github.com/GcsSloop/AndroidNote/blob/master/Lecture/gdg-developer-growth-guide.md) + diff --git a/Lecture/gdg-developer-growth-guide.md b/Lecture/gdg-developer-growth-guide.md new file mode 100755 index 00000000..0a383423 --- /dev/null +++ b/Lecture/gdg-developer-growth-guide.md @@ -0,0 +1,165 @@ +# 程序员练级指北 + +![](http://ww4.sinaimg.cn/large/005Xtdi2jw1fa7c95aispj30rs07qmyp.jpg) + +之前非常有幸收到 [脉脉不得语](https://github.com/inferjay) 的邀请参加 郑州GDG[^1] 举办的 DevFest[^2] 活动，并上台分享了一下自己的拙见，回来之后我将自己演讲的内容整理了一下，并分享给大家，希望对一些人有帮助，关于 郑州GDG 更多的活动内容，大家可以到 [GDGZhengzou](https://github.com/GDGZhengzhou/Events) 查看。另外，欢迎关注我的 [GitHub](https://github.com/GcsSloop) 和 [微博](http://weibo.com/GcsSloop) 。 + +**我在本次活动中的演讲主题是《程序员练级指北》，主要内容如何从零开始，并逐渐成长为一名合格的程序员，里面的内容是基于自身的经历和见解所书写的，并不一定适合所有人，建议选择性采纳。** + +**为了演讲不那么枯燥乏味，我用了很多口语化的描述，并将程序员分了等级，从零装备的新手到钻石级别套装的大佬，其实各个等级之间并没有严格的分界点，只是大致的划分，大家理解便好。另外本文和现场演讲可能稍有差别，下面开始正文。** + +Hello，大家好，我是 GcsSloop，今天是我第一次在这么多陌生人面前装逼，啊不，演讲，心里很是忐忑，现在我还能感受到自己的心扑通扑通的跳。 + +我呢，主要学习 Android，爱好装逼，喜欢钱，目前正在向段子手的方向上越走越远。 + +非常高兴今天能站在这里向大家分享我自己的观点，因为在坐的的技术牛人太多了，作为一个没什么技术实力的新人，不敢在这里班门弄斧讲技术，要不然正讲着哪位大牛突然站起来说我讲的不对，这不就尴尬了么。 + +由于本人爱好装逼，自然也研究了一些心得，所以我今天分享一下程序员如何在不同阶段正确的装逼。 + +## 第一阶段 - 新手村 + +![](http://ww2.sinaimg.cn/large/005Xtdi2jw1fa7a60w9nqj30m80c0gma.jpg) + +作为编程的新手，自然是不能在大佬面前装逼的，否则分分钟被吊打。这一阶段我们要先给自己定一个小目标，什么是小目标呢？例如挣他个一百万？这对于我们来说当然是不现实的，作为编程菜鸟，小目标当然是稍微努力一下就能完成的，例如：看完几个新手教程，时间不要太长，两三天能完成的任务量就够了。当然了，光看还不行的，要发在朋友圈，让大家觉得你是一个非常有上进心的人。 + +**为什么要发在朋友圈呢？装逼是一方面，除此之外，过了两天你就会发现，这两天光顾着打游戏了，新手教程居然忘记看了，这时候去看看朋友圈，再看看上面的赞，心里想如果这要是不弄完以后还如何在朋友面前装逼，自己装的逼跪着也要学完。** + +这一阶段注意两点： + +1. **任务周期要短，任务量要小**，如果周期太长，例如一个月，到月底发现弄不完了，就会想反正也弄不完了，就这样吧，容易破罐子破摔。 +2. **要形成周围的监督机制**，如果没人看着，反正也没人知道，那就随便学喽，过不了几天自己就放弃了。 + +如果按照计划执行了第一阶段的任务，那么经过大约一两个月的时间，新手教程基本上就看完了，相当于集齐了一套新手装备，顺利进入下一阶段。 + +## 第二阶段 - 初级套装 + +![](http://ww3.sinaimg.cn/large/005Xtdi2jw1fa7abwlqq8j30m80c0dgm.jpg) + +初级套装虽然攻击和防御力都很弱，但至少能单挑一些野怪了，有了一定的装逼资本，这时候就要在新手村附近刷一些野怪练级。 + +既然是刷怪升级，自然要选一个怪物比较集中的地方，最好还要有不同等级的怪物，这样方便刷经验，这个地方是哪里呢？个人觉得最适合的地方就是学校OJ题库，不一定要是自己学校的，大部分学校的OJ题库都是开放的，这里面的题目比较多，难度也分了很多等级，是非常适合新手练习的场所。不熟悉OJ系统的建议搜索了解一下。 + +**这一阶段非常容易卡关，经常发现自己有两点不会，就是这也不会，那也不会。** + +然而作为编程界的新手，我们遇到的大部分问题肯定已经有大神踩过坑了，在99%的情况下，用百度或者Google搜索题目描述就能得到攻略方式，但不要偷懒直接复制，要自己亲自写一遍代码，这样有助于自己了解不同类型题目的模式。 + +如果你发现了一道题的答案搜索不到，但是自己解决了，那么恭喜你捡到宝了，说明你遇到了一个稀有的或者新增的怪物，赶紧整理一下攻略过程发博客吧，又能装逼了。 + +这样过了一段时间你就会发现，这些野怪大部分都很弱，只会几种常见的套路而已，除了最基础的题型外，归纳起来就是：堆、栈、树、表、图。 + +每一类野怪都有特定的攻略方法，常用的有：枚举，遍历，分治，贪婪，动态，线性，暴力打表 以及 抖机灵。 + +我在大一的时候加入了学校的打野攻略组，就是传说中的ACM，在里面待了大约有一年的时间，虽然没拿过大奖项，但好在通过刷题把自己的基础巩固了。 + +这一阶段反映自己进步的最好标准就是 做题量 和 排行榜，我最高在校内排到前5，两年没有更新的情况下目前依旧在前50之内，不要问我哪个学校的，是我学校的，看一下OJ排行榜自然能认出我，我在排行榜上也叫GcsSloop。 + +装逼完毕，进入下一阶段。 + +## 第三阶段 - 青铜套装 + +![](http://ww4.sinaimg.cn/large/005Xtdi2jw1fa7afft4xgj30m80c00tc.jpg) + +刷野怪时间长了就会发现其实也挺没意思的，不过好在能够练装备，把数据结构知识和一些常见的算法弄明白，熟悉敌人的攻击套路，这样经过一段时间后，装备基本也升级到青铜了，这时候就应该尝试去挑战一下区域小boss了。 + +什么是挑战区域小boss呢，就是尝试制作一个完整的项目并发布出去，有人使用即可。 + +挑战小boss可以组团或者单挑，个人虽然喜欢组团，但无奈我们学校这个服务器太弱了，基本找不到合适的队友，尝试了几次组队最终都以失败而告终，无奈只能去单挑。 + +单挑boss要量力而行，不能找太强的boss，根据我自己的经验，单挑太强的boss会死的很难看，自己曾经有无数个项目胎死腹中或者半路夭折。 + +选择一个比较弱的boss，例如：发布一个简单的 app 到应用市场，获取到一定的下载量，或者写一个开源库，获得一点 star。 + +**这一阶段锻炼的是项目构建能力，能够完整的构建一个项目并发布出去，有人使用就算成功了。** + +这样既能带来成就感，又能装逼，发完之后记得告诉身边的人自己有内容发布了，再次装一波。 + +## 第四阶段 - 白银套装 + +![](http://ww4.sinaimg.cn/large/005Xtdi2jw1fa7ajkrs5aj30m80c0751.jpg) + +单挑完一些区域小boss后，将套装升级为白银，有了一定的装逼资本，此时发现总在朋友圈装逼成就感太差了，这时候可以去论坛、贴吧、社区、微博等地方好好的装一把，让那些装备还没有升级起来的小白看看这套锃亮的白银套装是多么耀眼，不过仍要注意不能太过火，在出来帮助新手解决问题的时候顺便展示一下白银套装的威力就行了，装的太狠容易被大佬发现抓起来吊打，这不就尴尬了么。 + +顺便说一下，如果从培训机构出来的，正常应该是白银初级，自身有基础加上比较努力可能会达到白银中级，能拿到白银套装说明已经达到了职业程序员最基本的标准。 + +**很多人打到白银就开始迷茫了，去挑战小boss吧太没成就感，那些看起来就很肥美的中级和高级boss基本已经被大公司瓜分了，自己根本无从插手。所以这时候就要考虑加入公司的问题了。** + +那些比较好的公司，例如：网易、阿里、腾讯 等肯定有一堆人挤破头都想进，作为一个刚刚拿到白银套装的人想挤进去不能说没有机会，但肯定很难。但作为拥有白银套装的人，想加入一些小公司倒还算比较容易。 + +个人建议初期有条件优先选择比较大的公司，因为这些公司资源多，有成熟的体系，可以帮助我们快速的在某一方向上获得长足的发展。 + +后期则优先选择发展型的小公司，如果是从大公司跳向一个小公司，一般都会担任不错的职位，这可以帮助我们锻炼技术之外的能力，另外一个原因是随着公司成长可以分得一些红利。 + +加入公司自然要考虑自身和公司的关系。 + +个人觉得最核心的一点就是不要依附于公司，也不要抱有敌意，最好的办法就是和公司成为**利益共同体**，在自己为公司创造价值的同时利用公司强大的资源提升自己的能力。 + +如果太过于依附公司，认为自己努力工作一定能得到相应回报的，根据经济学的假设，人都是自私而理性的，老板亦是如此，所以这类人大部分情况下都不会得到预期的结果。 + +对公司抱有敌意，认为自己就是打工赚钱的，想偷懒干最少的活，拿最多的钱，因为在偷懒的同时错失了很多发展机会，所以这类人大部分会随着技术的升级而被淘汰掉。 + +**如何与公司成为利益共同体呢？首先要明确自己的目标，自己加入公司是为了提升自己的能力，而不仅仅是来打工赚钱的，想要实现这一目标则是想办法干更多的活，这样老板肯定乐意，而我们通过干更多的活来接触更多的信息，并且把接触到的信息沉淀成为自己的经验积累，对自身发展也是有益的。** + +当然了，我们也不是傻子，当我们自身产生的价值远远超过公司给我们的薪资并且公司资源已经无法支撑我们继续提升的时候，就该抛弃这家公司跳槽了，这一次跳槽势必能进入一个更好的公司深造，可以利用更庞大的资源来辅助我们发展，接触到更多的信息。在信息时代，信息就是金钱，将信息沉淀成为个人经验并不能第一时间转化为金钱，但是总能在未来的某一时刻爆发出惊人的力量。 + +## 第五阶段 - 黄金套装 + +![](http://ww4.sinaimg.cn/large/005Xtdi2jw1fa7ar2u1gjj30m80c03zb.jpg) + +在白银阶段，就具备了职业程序员的基本素养，但是离出任CTO，迎娶白富美，走上人生巅峰还差的很远呢，想要实现这些目标，首先要拿到黄金套装。 + +一般来说技术发现有两个方向可走：**深度 和 广度。** + +我自己使用的是树形型结构，大树的树，**一到两门追求深度，做树木主干，其余的最求广度，做树木枝叶**。 + +> 有些人也称为T型知识结构，不过我觉得树形更佳贴切，因为我的所有周边技能都是围绕主干展开的，并且是可生长(拓展)的。 + +我的主方向 Android，自学了 C、Java、Python、Web、Photoshop 等相关知识，除了主方向Android之外，其他方向作为辅助方向，仅仅了解了最基础的内容，也就是能够靠着搜索引擎写一些简单小程序的程度。 + +树型知识架构有很多好处： + +1. **不被单一语言束缚，在实际场景中可以选择最合适的语言**。 +2. **可以跨领域突破，我在研究 Android 2D 绘图逻辑的时候就借鉴了很多 PS 的知识**。 +3. **预留发展空间大，假设某一天，Android市场饱和了或者前景变差了，我可以快速的从树枝中选择一支比较擅长的发展成为主干，而不用每次都从零开始**。 + +其实我们大部分人都是俗人，是不是黄金套装都无所谓，能赚钱才行，很多人来做技术也是为了赚钱，所以接下来我说的是如何想办法用最小的代价产生最大的价值。想要赚钱首先要明白最基本的商业逻辑，如果我们通过正常的方式从别人那里赚到钱了，说明我们为别人提供了价值，这样别人才愿意付费给我们。 + +所以我们要想办法用最小的代价为别人提供最大的价值，我写代码之前会多思考，没错，就是学生时代老师经常说的多思考。不过那时候没有人告诉我们该思考什么，因此我自己摸索出来了一套东西。 + +1. **思考核心目标**，我们是为了某一件事情而写程序，并不是因为写程序了所以要完成这件事情。**核心目标是完成这件事情，而不是写程序。** +2. **思考是否可以偷懒**，我是否可以用更简单的方式完成目标，例如**不写代码，少写代码**。 +3. **如果写代码了，是否可以产生附加价值**，例如我写这一段代码是否可以抽取成为一个开源库，是否可以将其中的设计思想整理成文共享出去。 +4. **如何产生更大的价值**，我的开源库或者文章如何才能服务更多人，让更多人了解到我的东西。因为只有服务更多人，才能产生更大的价值，我们也才可能从中拿走一部分利润。 + +经历过这几步的思考，基本上就已经能将所写的每一段代码的价值潜力都发掘出来，进而用最小的力气服务最多的人。当然了，为了别人服务，只是产生了价值，在通常情况下，这部分价值是无法直接提现的，也就是说仅仅产生了价值但自身并没有收益。 + +不过非常值得庆幸的是，今年很有可能成为内容付费元年，今年已经出来了很多内容变现工具，我知道的就有，微博长文打赏，简书打赏，知乎live，diycode原创打赏 和 掘金原创打赏。 + +另外，最重要的是，**随着社会的快速发展，很多人有钱了，开始愿意为自己喜欢的事物打赏，这是一切的基础。** + + +## 第六阶段 - 钻石套装 + +![](http://ww4.sinaimg.cn/large/005Xtdi2jw1fa7aswevd3j30m80c0gm8.jpg) + +能拿到钻石套装的人在全球范围内都是屈指可数的，这一类人通常是某一领域的开拓者，就是我们所说的 XXX之父。这些开拓者已经将自己的影响力渗透进了社会的各行各业，说他们推动了社会的进步也是可以的，我有生之年不说集齐套装，仅仅能拿一件钻石武器便足以令我心满意足了。 + +## 结语 + +前面啰嗦了这么多，最后告诉大家一个小秘密，如果你想要研究一个人发展的根本，不要直接去问他，因为别人很少会告诉你自己赖以生存的核心技能，他们只会告诉你看起来很光鲜的皮毛，就是所谓的心灵鸡汤，这些听起来很励志，但落实在自己身上通常没什么用，大多数情况下只会给你带来两三天的激情而已。 + +正确的方法是观察他在做什么事情，以及分析他做这些事情的背后逻辑。如果你能把这些逻辑想清楚了，就把别人真正的核心技能偷过来了。之后根据自身情况一步一步的学着做就行了。 + +**所以说，你们如果你们想了解我在做什么，为什么不考虑关注一下我的 [新浪微博](http://weibo.com/GcsSloop) 呢？关注一下又不会吃亏！** + +### 作者微博: [@GcsSloop](http://weibo.com/GcsSloop) + + + +[^1]: GDG 全称 Google Developer Group，中文意思是 **谷歌开发者社区** 。 + +[^2]: DevFest 开发者节，今年(2016)的举办时间是 9月1日 到 11月30日 之间，全球大部分谷歌开发者社区都会举办该活动，一年一次。 + + + + + diff --git a/OpenGL/README.md b/OpenGL/README.md new file mode 100644 index 00000000..3f834828 --- /dev/null +++ b/OpenGL/README.md @@ -0,0 +1,3 @@ +# OpenGL + +OpenGL 全称 Open Graphics Library,是用于渲染2D、3D矢量图形的跨语言、跨平台的应用程序编程接口(API)。OpenGL 常用于CAD、虚拟实境、科学可视化程序和电子游戏开发。 diff --git a/QuickChart/Canvas.md b/QuickChart/Canvas.md index edc90448..5b5f269c 100644 --- a/QuickChart/Canvas.md +++ b/QuickChart/Canvas.md @@ -1,14 +1,28 @@ # Canvas常用操作速查表 -操作分类 | 相关API | 备注 ----------|---------|-------------- -绘制颜色 | drawColor, drawRGB, drawARGB | 使用单一颜色填充整个画布
**相关链接:**
[【基础－颜色】](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Base/%5B3%5DColor.md)
[【Canvas－颜色与基本形状】](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B2%5DCanvas_BasicGraphics.md) -绘制基本形状 | drawPoint, drawPoints, drawLine, drawLines, drawRect, drawRoundRect, drawOval, drawCircle, drawArc | 依次为 点、线、矩形、圆角矩形、椭圆、圆、圆弧
**相关链接 :**
[【Canvas－颜色与基本形状】](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B2%5DCanvas_BasicGraphics.md) -绘制图片 | drawBitmap, drawPicture | 绘制位图和图片
**相关链接:**
[【Canvas－图片文字】](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B4%5DCanvas_PictureText.md) -绘制文本 | drawText, drawPosText, drawTextOnPath | 依次为 绘制文字、绘制文字时指定每个文字位置、根据路径绘制文字
**相关链接:**
[【Canvas－图片文字】](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B4%5DCanvas_PictureText.md) -绘制路径 | drawPath | 绘制路径，绘制贝塞尔曲线时也需要用到该函数
**相关链接:**
[【Path－基本操作】](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B5%5DPath_Basic.md)
[【Path－贝塞尔曲线】](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B6%5DPath_Bezier.md)
[【Path－完结篇(伪)】](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B7%5DPath_Over.md)
[【Path－Path玩出花样(PathMeasure)】](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B08%5DPath_Play.md) -顶点操作 | drawVertices, drawBitmapMesh | 通过对顶点操作可以使图像形变，drawVertices直接对画布作用、 drawBitmapMesh只对绘制的Bitmap作用 -画布剪裁 | clipPath, clipRect | 设置画布的显示区域 -画布快照 | save, restore, saveLayerXxx, restoreToCount, getSaveCount | 依次为 保存当前状态、 回滚到上一次保存的状态、 保存图层状态、 会滚到指定状态、 获取保存次数
**相关链接:**
[【Canvas－画布操作】](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B3%5DCanvas_Convert.md) -画布变换 | translate, scale, rotate, skew | 依次为 位移、缩放、 旋转、错切
**相关链接:**
[【基础－坐标系】](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Base/%5B1%5DCoordinateSystem.md)
[【基础－角度弧度】](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Base/%5B2%5DAngleAndRadian.md)
[【Canvas－画布操作】](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B3%5DCanvas_Convert.md) -Matrix(矩阵) | getMatrix, setMatrix, concat | 实际画布的位移，缩放等操作的都是图像矩阵Matrix，只不过Matrix比较难以理解和使用，故封装了一些常用的方法。
[【Matrix－原理】](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B09%5DMatrix_Basic.md) +| 操作分类 | 相关API | 备注 | +| ---------- | ---------------------------------------- | ---------------------------------------- | +| 绘制颜色 | drawColor, drawRGB, drawARGB | 使用单一颜色填充整个画布
**相关链接:**
[【基础－颜色】](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Base/%5B3%5DColor.md)
[【Canvas－颜色与基本形状】](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B2%5DCanvas_BasicGraphics.md) | +| 绘制基本形状 | drawPoint, drawPoints, drawLine, drawLines, drawRect, drawRoundRect, drawOval, drawCircle, drawArc | 依次为 点、线、矩形、圆角矩形、椭圆、圆、圆弧
**相关链接 :**
[【Canvas－颜色与基本形状】](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B2%5DCanvas_BasicGraphics.md) | +| 绘制图片 | drawBitmap, drawPicture | 绘制位图和图片
**相关链接:**
[【Canvas－图片文字】](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B4%5DCanvas_PictureText.md) | +| 绘制文本 | drawText, drawPosText, drawTextOnPath | 依次为 绘制文字、绘制文字时指定每个文字位置、根据路径绘制文字
**相关链接:**
[【Canvas－图片文字】](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B4%5DCanvas_PictureText.md) | +| 绘制路径 | drawPath | 绘制路径，绘制贝塞尔曲线时也需要用到该函数
**相关链接:**
[【Path－基本操作】](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B5%5DPath_Basic.md)
[【Path－贝塞尔曲线】](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B6%5DPath_Bezier.md)
[【Path－完结篇(伪)】](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B7%5DPath_Over.md)
[【Path－Path玩出花样(PathMeasure)】](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B08%5DPath_Play.md) | +| 顶点操作 | drawVertices, drawBitmapMesh | 通过对顶点操作可以使图像形变，drawVertices直接对画布作用、 drawBitmapMesh只对绘制的Bitmap作用 | +| 画布剪裁 | clipPath, clipRect | 设置画布的显示区域 | +| 画布快照 | save, restore, saveLayerXxx, restoreToCount, getSaveCount | 依次为 保存当前状态、 回滚到上一次保存的状态、 保存图层状态、 会滚到指定状态、 获取保存次数
**相关链接:**
[【Canvas－画布操作】](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B3%5DCanvas_Convert.md) | +| 画布变换 | translate, scale, rotate, skew | 依次为 位移、缩放、 旋转、错切
**相关链接:**
[【基础－坐标系】](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Base/%5B1%5DCoordinateSystem.md)
[【基础－角度弧度】](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Base/%5B2%5DAngleAndRadian.md)
[【Canvas－画布操作】](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B3%5DCanvas_Convert.md) | +| Matrix(矩阵) | getMatrix, setMatrix, concat | 实际画布的位移，缩放等操作的都是图像矩阵Matrix，只不过Matrix比较难以理解和使用，故封装了一些常用的方法。
[【Matrix－原理】](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B09%5DMatrix_Basic.md) | + +| 操作类型 | 相关API | 备注 | +| ---------- | ---------------------------------------- | ---------------------------------------- | +| 基础方法 | getDensity, getWidth, getHeight，getDrawFilter，isHardwareAccelerated(API 11)，getMaximumBitmapWidth，getMaximumBitmapHeight，getDensity，quickReject，isOpaque，setBitmap，setDrawFilter | 使用单一颜色填充画布 | +| 绘制颜色 | drawColor, drawRGB, drawARGB，drawPaint | 使用单一颜色填充画布 | +| 绘制基本形状 | drawPoint, drawPoints, drawLine, drawLines, drawRect, drawRoundRect, drawOval, drawCircle, drawArc | 依次为 点、线、矩形、圆角矩形、椭圆、圆、圆弧 | +| 绘制图片 | drawBitmap, drawPicture | 绘制位图和图片 | +| 绘制文本 | drawText, drawPosText, drawTextOnPath | 依次为 绘制文字、绘制文字时指定每个文字位置、根据路径绘制文字 | +| 绘制路径 | drawPath | 绘制路径，绘制贝塞尔曲线时也需要用到该函数 | +| 顶点操作 | drawVertices, drawBitmapMesh | 通过对顶点操作可以使图像形变，drawVertices直接对画布作用、 drawBitmapMesh只对绘制的Bitmap作用 | +| 画布剪裁 | clipPath, clipRect， clipRegion，getClipBounds | 画布剪裁相关方法 | +| 画布快照 | save, restore, saveLayer, saveLayerXxx, restoreToCount, getSaveCount | 依次为 保存当前状态、 回滚到上一次保存的状态、 保存图层状态、 回滚到指定状态、 获取保存次数 | +| 画布变换 | translate, scale, rotate, skew | 依次为 位移、缩放、 旋转、错切 | +| Matrix(矩阵) | getMatrix, setMatrix, concat | 实际画布的位移，缩放等操作的都是图像矩阵Matrix，只不过Matrix比较难以理解和使用，故封装了一些常用的方法。 | diff --git a/QuickChart/Matrix.md b/QuickChart/Matrix.md index 5aecb593..6aaead2c 100644 --- a/QuickChart/Matrix.md +++ b/QuickChart/Matrix.md @@ -13,5 +13,7 @@ ## 相关文章 -* [Matrix原理](http://www.gcssloop.com/2015/02/Matrix_Basic/) -* [Matrix详解](http://www.gcssloop.com/2015/02/Matrix_Method/) +* [安卓自定义View进阶 - Matrix原理](http://www.gcssloop.com/customview/Matrix_Basic/) +* [安卓自定义View进阶 - Matrix详解](http://www.gcssloop.com/customview/Matrix_Method/) +* [安卓自定义View进阶 - Matrix Camera](http://www.gcssloop.com/customview/matrix-3d-camera) + diff --git a/README.md b/README.md index 78a306c2..1e8b8821 100644 --- a/README.md +++ b/README.md @@ -2,21 +2,22 @@ ### 作者微博: [@GcsSloop](http://weibo.com/GcsSloop) -我的安卓学习笔记，记录学习过程中遇到的问题,以及我的一些经验总结。如果出现链接失效等情况可以提交Issues提醒我修改相关内容。 +我的安卓学习笔记，记录学习过程中遇到的问题,以及我的一些经验总结。如果出现链接失效等情况可以提交 Issues 提醒我修改相关内容。 > #### PS:点击分类标题可以查看该分类的详细信息。 -## [博客](http://www.gcssloop.com/#blog) +## [博客](http://www.gcssloop.com/#blog "GcsSloop的博客") -新开的博客，在博客中可以获得更好的阅读体验，同时在博客的评论区可以更及时的向我反馈文章中的问题。 +我的个人博客，在博客中可以获得更好的阅读体验，同时在博客的评论区可以更及时的向我反馈文章中的问题。 - + ******

+ ## [自定义View](https://github.com/GcsSloop/AndroidNote/tree/master/CustomView/README.md) - + * 基础篇 * [安卓自定义View基础 - 坐标系](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Base/%5B01%5DCoordinateSystem.md) * [安卓自定义View基础 - 角度弧度](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Base/%5B02%5DAngleAndRadian.md) @@ -33,7 +34,33 @@ * [安卓自定义View进阶 - Matrix原理](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B09%5DMatrix_Basic.md) * [安卓自定义View进阶 - Matrix详解](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B10%5DMatrix_Method.md) * [安卓自定义View进阶 - Matrix Camera](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B11%5DMatrix_3D_Camera.md) - + * [安卓自定义View进阶 - 事件分发机制原理](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B12%5DDispatch-TouchEvent-Theory.md) + * [安卓自定义View进阶 - 事件分发机制详解](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B15%5DDispatch-TouchEvent-Source.md) + * [安卓自定义View进阶 - MotionEvent详解](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B16%5DMotionEvent.md) + * [安卓自定义View进阶 - 特殊形状控件事件处理方案](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B17%5Dtouch-matrix-region.md) + * [安卓自定义View进阶 - 多点触控详解](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B18%5Dmulti-touch.md) + * [安卓自定义View进阶 - 手势检测(GestureDetector)](https://github.com/GcsSloop/AndroidNote/blob/master/CustomView/Advance/%5B19%5Dgesture-detector.md) + * [安卓自定义View进阶 - 缩放手势检测(ScaleGestureDetector)](http://www.gcssloop.com/customview/scalegesturedetector) + * [安卓自定义View进阶 - 画笔基础(Paint)](http://www.gcssloop.com/customview/paint-base) + + +* [ViewSupport - 自定义View工具包](https://github.com/GcsSloop/ViewSupport) + +****** + +## 雕虫晓技 + +* [雕虫晓技(一) 组件化](http://www.gcssloop.com/gebug/componentr) +* [雕虫晓技(二) 编码](http://www.gcssloop.com/gebug/coding) +* [雕虫晓技(三) 通用圆角布局全解析](http://www.gcssloop.com/gebug/rclayout) +* [雕虫晓技(四) 搭建私有Maven仓库(带容灾备份)](http://www.gcssloop.com/gebug/maven-private) +* [雕虫晓技(五) 网格分页布局源码解析(上) (付费)](https://xiaozhuanlan.com/topic/5841730926) +* [雕虫晓技(六) 网格分页布局源码解析(下) (付费)](https://xiaozhuanlan.com/topic/1456397082) +* [雕虫晓技(七) 用旧Android手机做远程摄像头](http://www.gcssloop.com/gebug/internet-ip-webcam) +* [雕虫晓技(八) Android与数据流的斗争](http://www.gcssloop.com/gebug/android-stream) +* [雕虫晓技(九) Netty与私有协议框架](http://www.gcssloop.com/gebug/netty-private-protocol) +* [雕虫晓技(十) Android超简单气泡效果](http://www.gcssloop.com/gebug/bubble-sample) + ****** ## [教程类](https://github.com/GcsSloop/AndroidNote/tree/master/Course/README.md) @@ -44,7 +71,23 @@ * [用JitPack发布时附加文档和源码](https://github.com/GcsSloop/AndroidNote/blob/master/Course/jitpack-javadoc.md) ****** - + +## [Markdown](https://github.com/GcsSloop/AndroidNote/tree/master/Course/Markdown) + +* [Markdown 快速入门](https://github.com/GcsSloop/AndroidNote/blob/master/Course/Markdown/markdown-start.md) +* [Markdown 基础语法](https://github.com/GcsSloop/AndroidNote/blob/master/Course/Markdown/markdown-grammar.md) +* [Markdown 链接图片](https://github.com/GcsSloop/AndroidNote/blob/master/Course/Markdown/markdown-link.md) +* [Markdown 编辑器](https://github.com/GcsSloop/AndroidNote/blob/master/Course/Markdown/markdown-editor.md) + +****** + +## Tips + +* [ArrayList与LinkedList遍历性能比较](https://github.com/GcsSloop/AndroidNote/blob/magic-world/ChaosCrystal/List%E9%81%8D%E5%8E%86%E6%80%A7%E8%83%BD.md) +* [程序员不可不知的版权协议](https://github.com/GcsSloop/AndroidNote/blob/magic-world/ChaosCrystal/%E5%BC%80%E6%BA%90%E5%85%B1%E4%BA%AB%E5%8D%8F%E8%AE%AE.md) + +****** + ## [速查表](https://github.com/GcsSloop/AndroidNote/tree/master/QuickChart/README.md) * [Canvas常用操作速查表](https://github.com/GcsSloop/AndroidNote/blob/master/QuickChart/Canvas.md) @@ -68,18 +111,36 @@ ## 开源库 +* [arc-seekbar - 弧形SeekBar](https://github.com/GcsSloop/arc-seekbar) +* [encrypt - 加密工具包](https://github.com/GcsSloop/encrypt) +* [rclayout - 通用圆角布局](https://github.com/GcsSloop/rclayout) * [FontsManager - 快速替换字体](https://github.com/GcsSloop/FontsManager) -* [ViewSupport - 自定义View工具包](https://github.com/GcsSloop/ViewSupport) * [Rocker － 自定义摇杆](https://github.com/GcsSloop/Rocker) * [LeafLoading － 进度条](https://github.com/GcsSloop/LeafLoading) * [Rotate3dAnimation - 3D旋转动画(修正版)](https://github.com/GcsSloop/Rotate3dAnimation) +------ + +## 源码解析 + +- [AtomicFile 源码解析](https://github.com/GcsSloop/AndroidNote/blob/master/SourceAnalysis/AtomicFile.md) + ## 传送门 通往异世界的传送门，请谨慎使用。 时空折跃准备完毕，[点击开始传送](https://github.com/GcsSloop/AndroidNote/tree/magic-world)。 +***** + +## 博文修复计划 + +由于自己的知识水平有限，书写的文章难免会出现一些问题。 + +随着知识增长和知识面的扩大，发现了一些之前未曾注意到的问题，故有此博文修复计划，本次修复不仅会修复之前文章中的瑕疵和纰漏，甚至会对文章的知识结构稍作调整，所有修复的文章和调整后的内容都会在微博重新发布声明，点击下面关注我的微博可以第一时间了解到相关信息，另外据说关注我的微博会变帅哦。 + +**本次博文修复计划主要针对 [个人博客](http://www.gcssloop.com/#blog) 和 [GitHub](https://github.com/GcsSloop)，由于博主精力有限以及某些平台自身限制，对于其他平台仅能修复部分内容。** + ****** ## 版权声明 @@ -97,12 +158,24 @@ * 保持文章原文，不作修改。 * 明确署名，即至少注明 `作者：GcsSloop` 字样以及文章的原始链接，且不得使用 `rel="nofollow"` 标记。 * 商业用途请点击最下面图片联系本人。 +* 微信公众号转载一律不授权 `原创` 标志。 + +## 捐赠 + +#### 如果你觉得我的文章有帮助的话，捐赠一些晶石，鼓励我继续研究! 🐾 + +| | | +| ---------------------------------------- | ---------------------------------------- | +| ![](http://www.gcssloop.com/assets/images/wechat.png) | ![](http://www.gcssloop.com/assets/images/alipay.png) | +## 交流群 -## About Me +QQ群：612310796 +微信群：加我个人微信 GcsSloop，备注加群。 +![](https://ww3.sinaimg.cn/large/006tNc79gy1fl8bemmtmxj30p005k406.jpg) ### 作者微博: [@GcsSloop](http://weibo.com/GcsSloop) - + [▲ 回到顶部](#top) diff --git a/SourceAnalysis/AtomicFile.md b/SourceAnalysis/AtomicFile.md new file mode 100644 index 00000000..78e669c2 --- /dev/null +++ b/SourceAnalysis/AtomicFile.md @@ -0,0 +1,276 @@ +# AtomicFile 源码解析 + +![](http://ww4.sinaimg.cn/large/005Xtdi2jw1faa9dj0nf7j30rs05kaaf.jpg) + +## 什么是 AtomicFile ? + +AtomicFile 在 `android.support.v4.util` 包下，**是一个与文件相关的工具类，其作用是保证文件读写的原子性。** 即文件读写的时候全部成功才会更新文件，如果失败则不会影响文件内容。 + +看官方对其说明： + +> Static library support version of the framework's `AtomicFile`, a helper class for performing atomic operations on a file by creating a backup file until a write has successfully completed. +> +> 静态支持库版本的AtomicFile，一个帮助类，用于通过创建备份文件对文件执行原子操作，直到写入成功完成。 +> +> Atomic file guarantees file integrity by ensuring that a file has been completely written and sync'd to disk before removing its backup. As long as the backup file exists, the original file is considered to be invalid (left over from a previous attempt to write the file). +> +> 原子文件通过确保文件在删除其备份之前已经完全写入并同步到磁盘，从而保证文件的完整性。只要备份文件存在，原始文件将被视为无效（会尝试写入备份文件中）。 +> +> Atomic file does not confer any file locking semantics. Do not use this class when the file may be accessed or modified concurrently by multiple threads or processes. The caller is responsible for ensuring appropriate mutual exclusion invariants whenever it accesses the file. +> +> 原子文件不提供任何文件锁定语义。当文件可能被多个线程或进程并发访问或修改时，不要使用此类。每当访问文件时，调用者都负责确保适当的互斥变量。 + +## 主要方法 + +| 返回值 | 方法名称和简介 | +| :------------------: | ---------------------------------------- | +| | **AtomicFile(File baseName)**
构造方法，通过File创建AtomicFile | +| **FileOutputStream** | **startWrite()**
准备写文件，获得一个向文件写入的字节流(FileOutputStream)。 | +| **void** | **finishWrite(FileOutputStream str)**
写入完毕时调用。 | +| **void** | **failWrite(FileOutputStream str)**
写入失败时调用。 | +| **FileInputStream** | **openRead()**
准备读取文件，获得一个从文件读取的字节流(FileInputStream)。 | +| **byte[]** | **readFully()**
将文件中所有内容读取出来用 byte 数组返回，相当于更方便的 openRead 方法。 | +| **File** | **getBaseFile()**
获得原文件地址。 | +| **void** | **delete()**
删除 AtomicFile，包括原文件和备份文件。 | + +## AtomicFile 原理 + +AtomicFile 原理其实非常简单，下面用一张图简单展示一下其原理： + +![](http://ww3.sinaimg.cn/large/005Xtdi2jw1faaeg4kqo5j30lu0tegp5.jpg) + +## AtomicFile 源码解析 + +源码解析非常简单，根据上面表格中的内容按顺序一个一个看吧。 + + + +#### 构造函数： + +根据传进来的文件创建 AtomicFile 类，同时创建辅助备份文件(空文件)。 + +```java +private final File mBaseName; +private final File mBackupName; + +public AtomicFile(File baseName) { + mBaseName = baseName; // 记录原始文件 + mBackupName = new File(baseName.getPath() + ".bak"); // 创建备份文件 +} +``` + + + +#### 开始写入(startWrite) + +在获取向文件写入的输出流之前，它会对原文件进行备份，同时清除原文件内容。 + +同时根据其原理可知，它并不是线程安全的，如果需要多线程操作等，最好自己加锁，如果一个线程未写完，直接开启了另一个线程进行写入可能会导致文件内容丢失。 + +**另外使用这种方法获得到的 FileOutputStream 不要直接关闭，写入完成的时候需要调用 `finishWrite` 或者`failWrite` 进行关闭，否则下次读取的时候会因为备份文件存在而使本次写入失效。** + +```java +public FileOutputStream startWrite() throws IOException { + // 当原文件存在，备份文件不存在的时候，原文件更名为备份文件 + if (mBaseName.exists()) { + if (!mBackupName.exists()) { + // 如果原文件存在且备份文件不存在，直接将原文件重命名为备份文件 + if (!mBaseName.renameTo(mBackupName)) { + Log.w("AtomicFile", "Couldn't rename file " + mBaseName + + " to backup file " + mBackupName); + } + } else { + mBaseName.delete(); // 删除原文件 + } + } + // 保证原文件存在，并根据原文件创建一个输出流。 + FileOutputStream str = null; + try { + str = new FileOutputStream(mBaseName); + } catch (FileNotFoundException e) { + File parent = mBaseName.getParentFile(); + if (!parent.mkdirs()) { + throw new IOException("Couldn't create directory " + mBaseName); + } + FileUtils.setPermissions( + parent.getPath(), + FileUtils.S_IRWXU|FileUtils.S_IRWXG|FileUtils.S_IXOTH, + -1, -1); + try { + str = new FileOutputStream(mBaseName); + } catch (FileNotFoundException e2) { + throw new IOException("Couldn't create " + mBaseName); + } + } + return str; // 返回输出流。 +} +``` + + + +#### 写入完成(finishWrite) + +写入完成的时候需要用户调用该方法，该方法会关闭 FileOutputStream ，并且会删除备份文件以保证文件的唯一性。 + +```java +public void finishWrite(FileOutputStream str) { + if (str != null) { + FileUtils.sync(str); + try { + str.close(); + mBackupName.delete(); + } catch (IOException e) { + Log.w("AtomicFile", "finishWrite: Got exception:", e); + } + } +} +``` + + + +#### 写入失败(failWrite) + +写入失败时会调用该方法，该方法会关闭 FileOutputStream，并且从备份文件恢复文件内容。 + +```java +public void failWrite(FileOutputStream str) { + if (str != null) { + FileUtils.sync(str); + try { + str.close(); + mBaseName.delete(); + mBackupName.renameTo(mBaseName); + } catch (IOException e) { + Log.w("AtomicFile", "failWrite: Got exception:", e); + } + } +} +``` + + + +#### 准备读取(openRead) + +该方法会获取到一个读取文件的输入流(FileInputStream)，并且在备份文件存在时，会简单粗暴的删除原文件，并从备份文件恢复内容。 + +```java +public FileInputStream openRead() throws FileNotFoundException { + if (mBackupName.exists()) { + mBaseName.delete(); + mBackupName.renameTo(mBaseName); + } + return new FileInputStream(mBaseName); +} +``` + + + +#### 读取全部(readFully) + +该方法会将文件中的所有内容转化为一个 byte 数组并且返回，所以不建议使用该方法读取大文件。 + +```java +public byte[] readFully() throws IOException { + FileInputStream stream = openRead(); + try { + int pos = 0; + int avail = stream.available(); + byte[] data = new byte[avail]; + // 通过循环读取的方式将文件所有内容都装入 byte 数组中。 + while (true) { + int amt = stream.read(data, pos, data.length-pos); + //Log.i("foo", "Read " + amt + " bytes at " + pos + // + " of avail " + data.length); + if (amt <= 0) { + //Log.i("foo", "**** FINISHED READING: pos=" + pos + // + " len=" + data.length); + return data; + } + pos += amt; + avail = stream.available(); + if (avail > data.length-pos) { + byte[] newData = new byte[pos+avail]; + System.arraycopy(data, 0, newData, 0, pos); + data = newData; + } + } + } finally { + stream.close(); + } +} +``` + + + +#### 获取原文件(getBaseFile) + +该方法用于获取原文件路径，但通常情况下并不推荐使用，因为获取到的原文件可能是损坏的或者无效的。 + +```java +public File getBaseFile() { + return mBaseName; +} +``` + + + +#### 删除(delete) + +该方法会直接删除原文件和备份文件。 + +```java +public void delete() { + mBaseName.delete(); + mBackupName.delete(); +} +``` + + + +## 简单示例 + + + +## FAQ + +**Q：AtmoicFile 适用于哪些文件？** + +> A：**AtomicFile 适用一次性写入的文件**。根据 AtomicFile 原理可知，每一次获取写入文件的输出流的时候都会清空原文件的内容，所以是无法给文件追加内容的。 + +**Q：AtmoicFile 是否是线程安全的？** + +> A：根据其原理就可知它没有带线程锁，所以**AtomicFile并不能保证线程安全**。 + +**Q：文件写入完毕后可以直接关闭输出字节流(FileOutputStream)么？** + +> A：AtomicFile写入完毕后是不允许直接关闭字节流的，因为直接关闭字节流会导致备份文件没有删除，因而下次读取的时候会导致读取到的是原文件，而不是更新后的文件。 +> **写入完毕后应调用 finishWrite(正常写入完成) 或者 failWrite(写入失败)。** + +**Q：文件读取完毕后可以直接关闭输入字节流(FileInputStream)么？** + +> A：可以。 + + + +## 结语 + +AtomicFile 作为一个工具类，有其方便之处，同时也有一些需要注意的地方，例如不能追加内容，另外，AtomicFile 除了上述方法之外，还有另外几个方法没有在本文中说明，这几个方法由于不安全，已经被标注删除和隐藏，故本文就不在赘述了。 + +事实上 AtomicFile 逻辑非常简单，应用场景也有限，如果需要的话自己徒手写一个也是可以的，个人觉得它的作用并不太大，如果以后大家在源码或者其他地方见到了这个类，知道它是干什么的就行了。 + +**最后，任何工具都是双刃剑，用好了伤人，用不好伤己，希望大家用之前好好了解一下其利弊，权衡之后再做决定。** + + + +## 参考资料 + +[Guide - AtomicFile](https://developer.android.com/reference/android/support/v4/util/AtomicFile.html) +[源码 - AtomicFile](https://android.googlesource.com/platform/frameworks/base/+/master/core/java/android/util/AtomicFile.java) + + + +## About Me + +### 作者微博: @GcsSloop + + \ No newline at end of file diff --git a/SourceAnalysis/CircularArray.md b/SourceAnalysis/CircularArray.md new file mode 100644 index 00000000..e69de29b diff --git a/SourceAnalysis/README.md b/SourceAnalysis/README.md new file mode 100644 index 00000000..6924a8e2 --- /dev/null +++ b/SourceAnalysis/README.md @@ -0,0 +1,3 @@ +# 源码解析 + +* [AtomicFile 源码解析](https://github.com/GcsSloop/AndroidNote/blob/master/SourceAnalysis/AtomicFile.md) diff --git a/Tools/MarkdownEditor.md b/Tools/MarkdownEditor.md deleted file mode 100644 index c124a1b5..00000000 --- a/Tools/MarkdownEditor.md +++ /dev/null @@ -1,2 +0,0 @@ -# Markdown编辑器推荐 -