SPaintEngine.ts 7.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271
  1. /*
  2. * *********************************************************************************************************************
  3. *
  4. * !!
  5. * .F88X
  6. * X8888Y
  7. * .}888888N;
  8. * i888888N; .:! .I$WI:
  9. * R888888I .'N88~ i8}+8Y&8"l8i$8>8W~'>W8}8]KW+8IIN"8&
  10. * .R888888I .;N8888~ .X8' "8I.!,/8" !%NY8`"8I8~~8>,88I
  11. * +888888N; .8888888Y "&&8Y.}8,
  12. * ./888888N; .R888888Y .'}~ .>}'.`+> i}! "i' +/' .'i~ !11,.:">, .~]! .i}i
  13. * ~888888%: .I888888l .]88~`1/iY88Ii+1'.R$8$8]"888888888> Y8$ W8E X8E W8888'188Il}Y88$*
  14. * 18888888 E8888881 .]W%8$`R8X'&8%++N8i,8N%N8+l8%` .}8N:.R$RE%N88N%N$K$R 188,FE$8%~Y88I
  15. * .E888888I .i8888888' .:$8I;88+`E8R:/8N,.>881.`$8E/1/]N8X.Y8N`"KF&&FK!'88*."88K./$88%RN888+~
  16. * 8888888I .,N888888~ ~88i"8W,!N8*.I88.}888%F,i$88"F88" 888:E8X.>88!i88>`888*.}Fl1]*}1YKi'
  17. * i888888N' I888Y ]88;/EX*IFKFK88X K8R .l8W 88Y ~88}'88E&%8W.X8N``]88!.$8K .:W8I
  18. * .i888888N; I8Y .&8$ .X88! i881.:%888>I88 ;88] +88+.';;;;:.Y88X 18N.,88l .+88/
  19. * .:R888888I
  20. * .&888888I Copyright (c) 2009-2020. 博锐尚格科技股份有限公司
  21. * ~8888'
  22. * .!88~ All rights reserved.
  23. *
  24. * *********************************************************************************************************************
  25. */
  26. import { SFont, SLine, SPaintEngineType, SPath, SPoint, SRect } from "..";
  27. import { SPaintState } from "./SPaintState";
  28. import { SMatrix } from "@persagy-web/base";
  29. /**
  30. * 绘制引擎基类
  31. *
  32. * @author 庞利祥 <sybotan@126.com>
  33. */
  34. export abstract class SPaintEngine {
  35. /** 当关状态 */
  36. private _state = new SPaintState();
  37. get state(): SPaintState {
  38. return this._state;
  39. }
  40. set state(value: SPaintState) {
  41. this._state = value;
  42. }
  43. /** 状态栈 */
  44. private stateStack = new Array<SPaintState>();
  45. /** 绘制引擎类型 */
  46. abstract get type(): SPaintEngineType;
  47. /**
  48. * 保存 painter 状态
  49. */
  50. save(): void {
  51. let state = new SPaintState(this.state);
  52. this.stateStack.push(state);
  53. }
  54. /**
  55. * 恢复 painter 状态
  56. */
  57. restore(): void {
  58. // 绘制命令栈有内容
  59. if (this.stateStack.length > 0) {
  60. this.state = this.stateStack.pop() as SPaintState;
  61. }
  62. }
  63. // =================================================================================================================
  64. // 变换相关
  65. /**
  66. * 平移变换
  67. *
  68. * @param x X 轴方向平移
  69. * @param y Y 辆方向平移
  70. */
  71. translate(x: number, y: number): void {
  72. this.state.matrix.translate(x, y);
  73. }
  74. /**
  75. * 缩放
  76. *
  77. * @param x X 轴方向缩放
  78. * @param y Y 轴方向缩放
  79. */
  80. scale(x: number, y: number): void {
  81. this.state.matrix.scale(x, y);
  82. }
  83. /**
  84. * 旋转
  85. *
  86. * @param angle 旋转角度(单位弧度)
  87. */
  88. rotate(angle: number): void {
  89. this.state.matrix.rotate(0, 0, angle);
  90. }
  91. /**
  92. * 将当前的变形矩阵乘上一个基于自身参数的矩阵
  93. *
  94. * @param m11 水平方向的缩放
  95. * @param m12 水平方向的倾斜偏移
  96. * @param m21 竖直方向的倾斜偏移
  97. * @param m22 竖直方向的缩放
  98. * @param dx 水平方向的移动
  99. * @param dy 竖直方向的移动
  100. */
  101. transform(
  102. m11: number,
  103. m12: number,
  104. m21: number,
  105. m22: number,
  106. dx: number,
  107. dy: number
  108. ): void {}
  109. /**
  110. * 将当前的变形矩阵重置为单位矩阵,再将当前的变形矩阵乘上一个基于自身参数的矩阵
  111. *
  112. * @param m11 水平方向的缩放
  113. * @param m12 水平方向的倾斜偏移
  114. * @param m21 竖直方向的倾斜偏移
  115. * @param m22 竖直方向的缩放
  116. * @param dx 水平方向的移动
  117. * @param dy 竖直方向的移动
  118. */
  119. setTransform(
  120. m11: number,
  121. m12: number,
  122. m21: number,
  123. m22: number,
  124. dx: number,
  125. dy: number
  126. ): void {}
  127. /**
  128. * 重置当前变形为单位矩阵。等价于调用 setTransform(1, 0, 0, 1, 0, 0)
  129. */
  130. resetTransform(): void {
  131. this.state.matrix = new SMatrix();
  132. }
  133. // =================================================================================================================
  134. // 绘制图形
  135. /**
  136. * 清空矩形区域
  137. *
  138. * @param rect 矩形
  139. */
  140. abstract clearRect(rect: SRect): void;
  141. /**
  142. * 绘制空心矩形
  143. *
  144. * @param rect 矩形
  145. */
  146. abstract drawRect(rect: SRect): void;
  147. /**
  148. * 绘制圆形
  149. *
  150. * @param cx 圆心 X 坐标
  151. * @param cy 圆心 Y 坐标
  152. * @param r 圆半径
  153. */
  154. abstract drawCircle(cx: number, cy: number, r: number): void;
  155. /**
  156. * 绘制椭圆
  157. *
  158. * @param cx 圆点 X 坐标
  159. * @param cy 圆点 Y 坐标
  160. * @param rx 水平半径
  161. * @param ry 垂直半径
  162. */
  163. abstract drawEllipse(cx: number, cy: number, rx: number, ry: number): void;
  164. /**
  165. * 绘制线段
  166. *
  167. * @param line 线段
  168. */
  169. abstract drawLine(line: SLine): void;
  170. /**
  171. * 绘制折线
  172. *
  173. * @param points 折线折点
  174. */
  175. abstract drawPolyline(points: SPoint[]): void;
  176. /**
  177. * 绘制多边形
  178. *
  179. * @param points 多边形顶点
  180. */
  181. abstract drawPolygon(points: SPoint[]): void;
  182. /**
  183. * 绘制路径
  184. *
  185. * @param path 路径
  186. */
  187. abstract drawPath(path: SPath): void;
  188. /**
  189. * 绘制文本
  190. *
  191. * @param text 文本内容
  192. * @param x X 坐标
  193. * @param y Y 坐标
  194. * @param maxWidth 最大宽度
  195. */
  196. abstract drawText(
  197. text: string,
  198. x: number,
  199. y: number,
  200. maxWidth?: number
  201. ): void;
  202. /**
  203. * 绘制图片
  204. *
  205. * @param img 图片
  206. * @param x X 坐标
  207. * @param y Y 坐标
  208. * @param width 宽度
  209. * @param height 高度
  210. * @param sx 开始剪切的 x 坐标位置
  211. * @param sy 开始剪切的 y 坐标位置
  212. * @param swidth 被剪切图像的宽度
  213. * @param sheight 被剪切图像的高度
  214. */
  215. abstract drawImage(
  216. img: CanvasImageSource,
  217. x: number,
  218. y: number,
  219. width?: number,
  220. height?: number,
  221. sx?: number,
  222. sy?: number,
  223. swidth?: number,
  224. sheight?: number
  225. ): void;
  226. /**
  227. * 预测量文本宽度
  228. *
  229. * @param text 预测的文本
  230. */
  231. abstract textWidth(text: string): number;
  232. /**
  233. * 修改字体
  234. *
  235. * @param font 字体
  236. */
  237. abstract changeFont(font: SFont): void;
  238. /**
  239. * 绘制带导角空心矩形
  240. *
  241. * @param rect 矩形
  242. * @param r 导角半径
  243. */
  244. abstract drawRoundRect(rect: SRect, r: number): void;
  245. }