SPaintEngine.ts 7.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262
  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. } // Get state
  40. set state(value: SPaintState) {
  41. this._state = value;
  42. } // Set state
  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. } // Function save()
  54. /**
  55. * 恢复 painter 状态
  56. */
  57. restore(): void {
  58. if (this.stateStack.length > 0) {
  59. this.state = this.stateStack.pop() as SPaintState;
  60. }
  61. } // Function restore()
  62. // =================================================================================================================
  63. // 变换相关
  64. /**
  65. * 平移变换
  66. *
  67. * @param x X 轴方向平移
  68. * @param y Y 辆方向平移
  69. */
  70. translate(x: number, y: number): void {
  71. this.state.matrix.translate(x, y);
  72. } // Function translate()
  73. /**
  74. * 缩放
  75. *
  76. * @param x X 轴方向缩放
  77. * @param y Y 轴方向缩放
  78. */
  79. scale(x: number, y: number): void {
  80. this.state.matrix.scale(x, y);
  81. } // Function scale()
  82. /**
  83. * 旋转
  84. *
  85. * @param angle 旋转角度(单位弧度)
  86. */
  87. rotate(angle: number): void {
  88. this.state.matrix.rotate(0, 0, angle);
  89. } // Function rotate()
  90. /**
  91. * 将当前的变形矩阵乘上一个基于自身参数的矩阵
  92. *
  93. * @param m11 水平方向的缩放
  94. * @param m12 水平方向的倾斜偏移
  95. * @param m21 竖直方向的倾斜偏移
  96. * @param m22 竖直方向的缩放
  97. * @param dx 水平方向的移动
  98. * @param dy 竖直方向的移动
  99. */
  100. transform(
  101. m11: number,
  102. m12: number,
  103. m21: number,
  104. m22: number,
  105. dx: number,
  106. dy: number
  107. ): void {} // Function transform()
  108. /**
  109. * 将当前的变形矩阵重置为单位矩阵,再将当前的变形矩阵乘上一个基于自身参数的矩阵
  110. *
  111. * @param m11 水平方向的缩放
  112. * @param m12 水平方向的倾斜偏移
  113. * @param m21 竖直方向的倾斜偏移
  114. * @param m22 竖直方向的缩放
  115. * @param dx 水平方向的移动
  116. * @param dy 竖直方向的移动
  117. */
  118. setTransform(
  119. m11: number,
  120. m12: number,
  121. m21: number,
  122. m22: number,
  123. dx: number,
  124. dy: number
  125. ): void {} // Function transform()
  126. /**
  127. * 重置当前变形为单位矩阵。等价于调用 setTransform(1, 0, 0, 1, 0, 0)
  128. */
  129. resetTransform(): void {
  130. this.state.matrix = new SMatrix();
  131. } // Function resetTransform()
  132. // =================================================================================================================
  133. // 绘制图形
  134. /**
  135. * 清空矩形区域
  136. *
  137. * @param rect 矩形
  138. */
  139. abstract clearRect(rect: SRect): void;
  140. /**
  141. * 绘制空心矩形
  142. *
  143. * @param rect 矩形
  144. */
  145. abstract drawRect(rect: SRect): void;
  146. /**
  147. * 绘制圆形
  148. *
  149. * @param cx 圆心 X 坐标
  150. * @param cy 圆心 Y 坐标
  151. * @param r 圆半径
  152. */
  153. abstract drawCircle(cx: number, cy: number, r: number): void;
  154. /**
  155. * 绘制椭圆
  156. *
  157. * @param cx 圆点 X 坐标
  158. * @param cy 圆点 Y 坐标
  159. * @param rx 水平半径
  160. * @param ry 垂直半径
  161. */
  162. abstract drawEllipse(cx: number, cy: number, rx: number, ry: number): void;
  163. /**
  164. * 绘制线段
  165. *
  166. * @param line 线段
  167. */
  168. abstract drawLine(line: SLine): void;
  169. /**
  170. * 绘制折线
  171. *
  172. * @param points 折线折点
  173. */
  174. abstract drawPolyline(points: SPoint[]): void;
  175. /**
  176. * 绘制多边形
  177. *
  178. * @param points 多边形顶点
  179. */
  180. abstract drawPolygon(points: SPoint[]): void;
  181. /**
  182. * 绘制路径
  183. *
  184. * @param path 路径
  185. */
  186. abstract drawPath(path: SPath): void;
  187. /**
  188. * 绘制文本
  189. *
  190. * @param text 文本内容
  191. * @param x X 坐标
  192. * @param y Y 坐标
  193. * @param maxWidth 最大宽度
  194. */
  195. abstract drawText(
  196. text: string,
  197. x: number,
  198. y: number,
  199. maxWidth?: number
  200. ): void;
  201. /**
  202. * 绘制图片
  203. *
  204. * @param img 图片
  205. * @param x X 坐标
  206. * @param y Y 坐标
  207. * @param width 宽度
  208. * @param height 高度
  209. */
  210. abstract drawImage(
  211. img: CanvasImageSource,
  212. x: number,
  213. y: number,
  214. width?: number,
  215. height?: number
  216. ): void;
  217. /**
  218. * 预测量文本宽度
  219. *
  220. * @param text 预测的文本
  221. */
  222. abstract textWidth(text: string): number;
  223. /**
  224. * 修改字体
  225. *
  226. * @param font 字体
  227. */
  228. abstract changeFont(font: SFont): void;
  229. /**
  230. * 绘制带导角空心矩形
  231. *
  232. * @param rect 矩形
  233. * @param r 导角半径
  234. */
  235. abstract drawRoundRect(rect: SRect, r: number): void;
  236. } // class SPaintEngine