fabric 5.3.0 → 6.0.0-beta10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (634) hide show
  1. package/.babelrc +11 -0
  2. package/.babelrcAlt +19 -0
  3. package/.browserslistrc +5 -0
  4. package/.eslintignore +3 -0
  5. package/.eslintrc.js +51 -0
  6. package/.eslintrc.json +38 -46
  7. package/.eslintrc_tests +12 -0
  8. package/.gitattributes +2 -0
  9. package/.gitpod.yml +17 -1
  10. package/.prettierignore +19 -0
  11. package/.prettierrc +4 -0
  12. package/CHANGELOG.md +615 -189
  13. package/CONTRIBUTING.md +233 -59
  14. package/README.md +200 -235
  15. package/babel-jest.config.js +6 -0
  16. package/bower.json +1 -3
  17. package/dist/fabric.d.ts +54 -0
  18. package/dist/index.d.ts +2 -0
  19. package/dist/index.js +28452 -0
  20. package/dist/index.js.map +1 -0
  21. package/dist/index.min.js +1 -0
  22. package/dist/index.mjs +28385 -0
  23. package/dist/index.mjs.map +1 -0
  24. package/dist/index.node.cjs +28538 -0
  25. package/dist/index.node.cjs.map +1 -0
  26. package/dist/index.node.d.ts +20 -0
  27. package/dist/index.node.mjs +28477 -0
  28. package/dist/index.node.mjs.map +1 -0
  29. package/dist/src/ClassRegistry.d.ts +13 -0
  30. package/dist/src/Collection.d.ts +136 -0
  31. package/dist/src/CommonMethods.d.ts +32 -0
  32. package/dist/src/EventTypeDefs.d.ts +227 -0
  33. package/dist/src/Intersection.d.ts +112 -0
  34. package/dist/src/Observable.d.ts +60 -0
  35. package/dist/src/Pattern/Pattern.d.ts +99 -0
  36. package/dist/src/Pattern/index.d.ts +3 -0
  37. package/dist/src/Pattern/types.d.ts +9 -0
  38. package/dist/src/Point.d.ts +232 -0
  39. package/dist/src/Shadow.d.ts +96 -0
  40. package/dist/src/brushes/BaseBrush.d.ts +101 -0
  41. package/dist/src/brushes/CircleBrush.d.ts +44 -0
  42. package/dist/src/brushes/CircleBrush.test.d.ts +2 -0
  43. package/dist/src/brushes/PatternBrush.d.ts +23 -0
  44. package/dist/src/brushes/PencilBrush.d.ts +92 -0
  45. package/dist/src/brushes/SprayBrush.d.ts +74 -0
  46. package/dist/src/brushes/typedefs.d.ts +18 -0
  47. package/dist/src/cache.d.ts +47 -0
  48. package/dist/src/canvas/Canvas.d.ts +364 -0
  49. package/dist/src/canvas/DOMManagers/CanvasDOMManager.d.ts +29 -0
  50. package/dist/src/canvas/DOMManagers/StaticCanvasDOMManager.d.ts +29 -0
  51. package/dist/src/canvas/DOMManagers/util.d.ts +24 -0
  52. package/dist/src/canvas/DOMManagers/util.spec.d.ts +2 -0
  53. package/dist/src/canvas/SelectableCanvas.d.ts +723 -0
  54. package/dist/src/canvas/StaticCanvas.d.ts +747 -0
  55. package/dist/src/canvas/TextEditingManager.d.ts +21 -0
  56. package/dist/src/canvas/canvas_gestures.mixin.d.ts +2 -0
  57. package/dist/src/color/Color.d.ts +152 -0
  58. package/dist/src/color/color_map.d.ts +155 -0
  59. package/dist/src/color/constants.d.ts +104 -0
  60. package/dist/src/color/typedefs.d.ts +16 -0
  61. package/dist/src/color/util.d.ts +27 -0
  62. package/dist/src/config.d.ts +115 -0
  63. package/dist/src/constants.d.ts +21 -0
  64. package/dist/src/controls/Control.d.ts +229 -0
  65. package/dist/src/controls/changeWidth.d.ts +13 -0
  66. package/dist/src/controls/commonControls.d.ts +28 -0
  67. package/dist/src/controls/controlRendering.d.ts +29 -0
  68. package/dist/src/controls/drag.d.ts +12 -0
  69. package/dist/src/controls/fireEvent.d.ts +3 -0
  70. package/dist/src/controls/index.d.ts +13 -0
  71. package/dist/src/controls/polyControl.d.ts +5 -0
  72. package/dist/src/controls/rotate.d.ts +12 -0
  73. package/dist/src/controls/scale.d.ts +47 -0
  74. package/dist/src/controls/scaleSkew.d.ts +39 -0
  75. package/dist/src/controls/skew.d.ts +33 -0
  76. package/dist/src/controls/util.d.ts +41 -0
  77. package/dist/src/controls/wrapWithFireEvent.d.ts +8 -0
  78. package/dist/src/controls/wrapWithFixedAnchor.d.ts +9 -0
  79. package/dist/src/env/browser.d.ts +3 -0
  80. package/dist/src/env/index.d.ts +28 -0
  81. package/dist/src/env/node.d.ts +6 -0
  82. package/dist/src/env/types.d.ts +15 -0
  83. package/dist/src/filters/BaseFilter.d.ts +160 -0
  84. package/dist/src/filters/BlendColor.d.ts +81 -0
  85. package/dist/src/filters/BlendImage.d.ts +93 -0
  86. package/dist/src/filters/Blur.d.ts +52 -0
  87. package/dist/src/filters/Boilerplate.d.ts +48 -0
  88. package/dist/src/filters/Brightness.d.ts +48 -0
  89. package/dist/src/filters/Canvas2dFilterBackend.d.ts +27 -0
  90. package/dist/src/filters/ColorMatrix.d.ts +64 -0
  91. package/dist/src/filters/ColorMatrixFilters.d.ts +537 -0
  92. package/dist/src/filters/Composed.d.ts +46 -0
  93. package/dist/src/filters/Contrast.d.ts +46 -0
  94. package/dist/src/filters/Convolute.d.ts +83 -0
  95. package/dist/src/filters/FilterBackend.d.ts +15 -0
  96. package/dist/src/filters/GLProbes/GLProbe.d.ts +7 -0
  97. package/dist/src/filters/GLProbes/NodeGLProbe.d.ts +11 -0
  98. package/dist/src/filters/GLProbes/WebGLProbe.d.ts +20 -0
  99. package/dist/src/filters/Gamma.d.ts +55 -0
  100. package/dist/src/filters/Grayscale.d.ts +47 -0
  101. package/dist/src/filters/HueRotation.d.ts +25 -0
  102. package/dist/src/filters/Invert.d.ts +56 -0
  103. package/dist/src/filters/Noise.d.ts +55 -0
  104. package/dist/src/filters/Pixelate.d.ts +45 -0
  105. package/dist/src/filters/RemoveColor.d.ts +64 -0
  106. package/dist/src/filters/Resize.d.ts +137 -0
  107. package/dist/src/filters/Saturation.d.ts +49 -0
  108. package/dist/src/filters/Vibrance.d.ts +49 -0
  109. package/dist/src/filters/WebGLFilterBackend.d.ts +128 -0
  110. package/dist/src/filters/filters.d.ts +21 -0
  111. package/dist/src/filters/index.d.ts +7 -0
  112. package/dist/src/filters/shaders/baseFilter.d.ts +4 -0
  113. package/dist/src/filters/shaders/blendColor.d.ts +13 -0
  114. package/dist/src/filters/shaders/blendImage.d.ts +3 -0
  115. package/dist/src/filters/shaders/blur.d.ts +2 -0
  116. package/dist/src/filters/shaders/brightness.d.ts +2 -0
  117. package/dist/src/filters/shaders/colorMatrix.d.ts +2 -0
  118. package/dist/src/filters/shaders/constrast.d.ts +2 -0
  119. package/dist/src/filters/shaders/convolute.d.ts +11 -0
  120. package/dist/src/filters/shaders/gamma.d.ts +2 -0
  121. package/dist/src/filters/shaders/grayscale.d.ts +3 -0
  122. package/dist/src/filters/shaders/invert.d.ts +2 -0
  123. package/dist/src/filters/shaders/noise.d.ts +2 -0
  124. package/dist/src/filters/shaders/pixelate.d.ts +2 -0
  125. package/dist/src/filters/shaders/removeColor.d.ts +2 -0
  126. package/dist/src/filters/shaders/saturation.d.ts +2 -0
  127. package/dist/src/filters/shaders/vibrance.d.ts +2 -0
  128. package/dist/src/filters/typedefs.d.ts +48 -0
  129. package/dist/src/filters/utils.d.ts +3 -0
  130. package/dist/src/gradient/Gradient.d.ts +150 -0
  131. package/dist/src/gradient/constants.d.ts +15 -0
  132. package/dist/src/gradient/index.d.ts +3 -0
  133. package/dist/src/gradient/parser/index.d.ts +4 -0
  134. package/dist/src/gradient/parser/misc.d.ts +4 -0
  135. package/dist/src/gradient/parser/parseColorStops.d.ts +3 -0
  136. package/dist/src/gradient/parser/parseCoords.d.ts +17 -0
  137. package/dist/src/gradient/typedefs.d.ts +93 -0
  138. package/dist/src/mixins/eraser_brush.mixin.d.ts +2 -0
  139. package/dist/src/parkinglot/canvas_animation.mixin.d.ts +2 -0
  140. package/dist/src/parkinglot/straighten.d.ts +2 -0
  141. package/dist/src/parser/applyViewboxTransform.d.ts +5 -0
  142. package/dist/src/parser/attributes.d.ts +6 -0
  143. package/dist/src/parser/constants.d.ts +53 -0
  144. package/dist/src/parser/doesSomeParentMatch.d.ts +2 -0
  145. package/dist/src/parser/elementById.d.ts +6 -0
  146. package/dist/src/parser/elementMatchesRule.d.ts +5 -0
  147. package/dist/src/parser/elements_parser.d.ts +3 -0
  148. package/dist/src/parser/getCSSRules.d.ts +7 -0
  149. package/dist/src/parser/getGlobalStylesForElement.d.ts +5 -0
  150. package/dist/src/parser/getGradientDefs.d.ts +7 -0
  151. package/dist/src/parser/getMultipleNodes.d.ts +2 -0
  152. package/dist/src/parser/getSvgRegex.d.ts +2 -0
  153. package/dist/src/parser/hasAncestorWithNodeName.d.ts +2 -0
  154. package/dist/src/parser/index.d.ts +9 -0
  155. package/dist/src/parser/loadSVGFromString.d.ts +18 -0
  156. package/dist/src/parser/loadSVGFromURL.d.ts +19 -0
  157. package/dist/src/parser/normalizeAttr.d.ts +2 -0
  158. package/dist/src/parser/normalizeValue.d.ts +2 -0
  159. package/dist/src/parser/parseAttributes.d.ts +9 -0
  160. package/dist/src/parser/parseFontDeclaration.d.ts +10 -0
  161. package/dist/src/parser/parsePointsAttribute.d.ts +12 -0
  162. package/dist/src/parser/parseSVGDocument.d.ts +23 -0
  163. package/dist/src/parser/parseStyleAttribute.d.ts +9 -0
  164. package/dist/src/parser/parseStyleObject.d.ts +2 -0
  165. package/dist/src/parser/parseStyleString.d.ts +2 -0
  166. package/dist/src/parser/parseTransformAttribute.d.ts +11 -0
  167. package/dist/src/parser/parseUseDirectives.d.ts +2 -0
  168. package/dist/src/parser/percent.d.ts +9 -0
  169. package/dist/src/parser/recursivelyParseGradientsXlink.d.ts +2 -0
  170. package/dist/src/parser/selectorMatches.d.ts +2 -0
  171. package/dist/src/parser/setStrokeFillOpacity.d.ts +6 -0
  172. package/dist/src/parser/typedefs.d.ts +9 -0
  173. package/dist/src/shapes/ActiveSelection.d.ts +83 -0
  174. package/dist/src/shapes/Circle.d.ts +99 -0
  175. package/dist/src/shapes/Ellipse.d.ts +84 -0
  176. package/dist/src/shapes/Group.d.ts +407 -0
  177. package/dist/src/shapes/IText/DraggableTextDelegate.d.ts +78 -0
  178. package/dist/src/shapes/IText/IText.d.ts +336 -0
  179. package/dist/src/shapes/IText/ITextBehavior.d.ts +287 -0
  180. package/dist/src/shapes/IText/ITextClickBehavior.d.ts +73 -0
  181. package/dist/src/shapes/IText/ITextKeyBehavior.d.ts +195 -0
  182. package/dist/src/shapes/IText/constants.d.ts +13 -0
  183. package/dist/src/shapes/Image.d.ts +309 -0
  184. package/dist/src/shapes/Line.d.ts +121 -0
  185. package/dist/src/shapes/Object/AnimatableObject.d.ts +33 -0
  186. package/dist/src/shapes/Object/FabricObject.d.ts +11 -0
  187. package/dist/src/shapes/Object/FabricObjectSVGExportMixin.d.ts +74 -0
  188. package/dist/src/shapes/Object/InteractiveObject.d.ts +296 -0
  189. package/dist/src/shapes/Object/Object.d.ts +599 -0
  190. package/dist/src/shapes/Object/ObjectGeometry.d.ts +327 -0
  191. package/dist/src/shapes/Object/ObjectOrigin.d.ts +109 -0
  192. package/dist/src/shapes/Object/StackedObject.d.ts +72 -0
  193. package/dist/src/shapes/Object/defaultValues.d.ts +76 -0
  194. package/dist/src/shapes/Object/types/BaseProps.d.ts +84 -0
  195. package/dist/src/shapes/Object/types/BorderProps.d.ts +37 -0
  196. package/dist/src/shapes/Object/types/ControlProps.d.ts +62 -0
  197. package/dist/src/shapes/Object/types/FabricObjectProps.d.ts +96 -0
  198. package/dist/src/shapes/Object/types/FillStrokeProps.d.ts +80 -0
  199. package/dist/src/shapes/Object/types/LockInteractionProps.d.ts +51 -0
  200. package/dist/src/shapes/Object/types/ObjectProps.d.ts +42 -0
  201. package/dist/src/shapes/Object/types/SerializedObjectProps.d.ts +66 -0
  202. package/dist/src/shapes/Object/types/index.d.ts +6 -0
  203. package/dist/src/shapes/Path.d.ts +214 -0
  204. package/dist/src/shapes/Polygon.d.ts +10 -0
  205. package/dist/src/shapes/Polyline.d.ts +147 -0
  206. package/dist/src/shapes/Rect.d.ts +82 -0
  207. package/dist/src/shapes/Text/StyledText.d.ts +123 -0
  208. package/dist/src/shapes/Text/Text.d.ts +688 -0
  209. package/dist/src/shapes/Text/TextSVGExportMixin.d.ts +32 -0
  210. package/dist/src/shapes/Text/constants.d.ts +13 -0
  211. package/dist/src/shapes/Textbox.d.ts +204 -0
  212. package/dist/src/shapes/Triangle.d.ts +26 -0
  213. package/dist/src/typedefs.d.ts +96 -0
  214. package/dist/src/util/animation/AnimationBase.d.ts +54 -0
  215. package/dist/src/util/animation/AnimationFrameProvider.d.ts +3 -0
  216. package/dist/src/util/animation/AnimationRegistry.d.ts +29 -0
  217. package/dist/src/util/animation/ArrayAnimation.d.ts +10 -0
  218. package/dist/src/util/animation/ColorAnimation.d.ts +11 -0
  219. package/dist/src/util/animation/ValueAnimation.d.ts +10 -0
  220. package/dist/src/util/animation/animate.d.ts +37 -0
  221. package/dist/src/util/animation/easing.d.ts +130 -0
  222. package/dist/src/util/animation/index.d.ts +3 -0
  223. package/dist/src/util/animation/types.d.ts +87 -0
  224. package/dist/src/util/applyMixins.d.ts +8 -0
  225. package/dist/src/util/dom_event.d.ts +5 -0
  226. package/dist/src/util/dom_misc.d.ts +12 -0
  227. package/dist/src/util/dom_request.d.ts +14 -0
  228. package/dist/src/util/dom_style.d.ts +7 -0
  229. package/dist/src/util/index.d.ts +36 -0
  230. package/dist/src/util/internals/cleanupSvgAttribute.d.ts +2 -0
  231. package/dist/src/util/internals/cleanupSvgAttribute.test.d.ts +2 -0
  232. package/dist/src/util/internals/cloneDeep.d.ts +2 -0
  233. package/dist/src/util/internals/cloneDeep.test.d.ts +2 -0
  234. package/dist/src/util/internals/getRandomInt.d.ts +8 -0
  235. package/dist/src/util/internals/getRandomInt.test.d.ts +2 -0
  236. package/dist/src/util/internals/ifNaN.d.ts +8 -0
  237. package/dist/src/util/internals/index.d.ts +4 -0
  238. package/dist/src/util/internals/removeFromArray.d.ts +9 -0
  239. package/dist/src/util/internals/uid.d.ts +2 -0
  240. package/dist/src/util/lang_string.d.ts +22 -0
  241. package/dist/src/util/misc/boundingBoxFromPoints.d.ts +9 -0
  242. package/dist/src/util/misc/capValue.d.ts +2 -0
  243. package/dist/src/util/misc/cos.d.ts +10 -0
  244. package/dist/src/util/misc/dom.d.ts +28 -0
  245. package/dist/src/util/misc/findScaleTo.d.ts +20 -0
  246. package/dist/src/util/misc/groupSVGElements.d.ts +9 -0
  247. package/dist/src/util/misc/isTransparent.d.ts +11 -0
  248. package/dist/src/util/misc/matrix.d.ts +168 -0
  249. package/dist/src/util/misc/mergeClipPaths.d.ts +23 -0
  250. package/dist/src/util/misc/objectEnlive.d.ts +41 -0
  251. package/dist/src/util/misc/objectTransforms.d.ts +68 -0
  252. package/dist/src/util/misc/pick.d.ts +9 -0
  253. package/dist/src/util/misc/planeChange.d.ts +81 -0
  254. package/dist/src/util/misc/projectStroke/StrokeLineCapProjections.d.ts +52 -0
  255. package/dist/src/util/misc/projectStroke/StrokeLineJoinProjections.d.ts +82 -0
  256. package/dist/src/util/misc/projectStroke/StrokeProjectionsBase.d.ts +26 -0
  257. package/dist/src/util/misc/projectStroke/index.d.ts +12 -0
  258. package/dist/src/util/misc/projectStroke/types.d.ts +23 -0
  259. package/dist/src/util/misc/radiansDegreesConversion.d.ts +14 -0
  260. package/dist/src/util/misc/resolveOrigin.d.ts +9 -0
  261. package/dist/src/util/misc/rotatePoint.d.ts +12 -0
  262. package/dist/src/util/misc/sin.d.ts +10 -0
  263. package/dist/src/util/misc/svgParsing.d.ts +45 -0
  264. package/dist/src/util/misc/textStyles.d.ts +32 -0
  265. package/dist/src/util/misc/toFixed.d.ts +8 -0
  266. package/dist/src/util/misc/vectors.d.ts +58 -0
  267. package/dist/src/util/path/index.d.ts +96 -0
  268. package/dist/src/util/path/regex.d.ts +2 -0
  269. package/dist/src/util/path/typechecks.d.ts +24 -0
  270. package/dist/src/util/path/typedefs.d.ts +220 -0
  271. package/dist/src/util/transform_matrix_removal.d.ts +14 -0
  272. package/dist/src/util/typeAssertions.d.ts +19 -0
  273. package/e2e/site/index.html +25 -0
  274. package/e2e/utils/objects.ts +36 -0
  275. package/fabric.ts +72 -0
  276. package/index.node.ts +43 -0
  277. package/index.ts +1 -0
  278. package/jest.config.js +194 -0
  279. package/lib/aligning_guidelines.js +2 -2
  280. package/package.json +110 -40
  281. package/playwright.config.ts +64 -0
  282. package/publish.js +0 -26
  283. package/rollup.config.mjs +99 -0
  284. package/rollup.test.config.js +24 -0
  285. package/scripts/build.mjs +50 -0
  286. package/scripts/buildLock.mjs +115 -0
  287. package/scripts/buildReporter.mjs +15 -0
  288. package/scripts/buildStats.mjs +139 -0
  289. package/scripts/dirname.mjs +14 -0
  290. package/scripts/git.mjs +36 -0
  291. package/scripts/index.mjs +564 -0
  292. package/scripts/sandbox.mjs +149 -0
  293. package/src/ClassRegistry.ts +56 -0
  294. package/src/Collection.ts +346 -0
  295. package/src/CommonMethods.ts +63 -0
  296. package/src/EventTypeDefs.ts +298 -0
  297. package/src/Intersection.ts +302 -0
  298. package/src/Observable.ts +181 -0
  299. package/src/Pattern/Pattern.ts +207 -0
  300. package/src/Pattern/index.ts +2 -0
  301. package/src/Pattern/types.ts +17 -0
  302. package/src/Point.ts +388 -0
  303. package/src/Shadow.ts +214 -0
  304. package/src/brushes/{base_brush.class.js → BaseBrush.ts} +63 -42
  305. package/src/brushes/CircleBrush.test.ts +11 -0
  306. package/src/brushes/CircleBrush.ts +140 -0
  307. package/src/brushes/PatternBrush.ts +70 -0
  308. package/src/brushes/PencilBrush.ts +300 -0
  309. package/src/brushes/SprayBrush.ts +214 -0
  310. package/src/brushes/typedefs.ts +18 -0
  311. package/src/cache.ts +90 -0
  312. package/src/canvas/Canvas.ts +1598 -0
  313. package/src/canvas/DOMManagers/CanvasDOMManager.ts +124 -0
  314. package/src/canvas/DOMManagers/StaticCanvasDOMManager.ts +80 -0
  315. package/src/canvas/DOMManagers/util.spec.ts +26 -0
  316. package/src/canvas/DOMManagers/util.ts +98 -0
  317. package/src/canvas/SelectableCanvas.ts +1506 -0
  318. package/src/canvas/StaticCanvas.ts +1634 -0
  319. package/src/canvas/TextEditingManager.ts +70 -0
  320. package/src/canvas/canvas_gestures.mixin.ts +207 -0
  321. package/src/color/Color.ts +320 -0
  322. package/src/color/color_map.ts +154 -0
  323. package/src/color/constants.ts +107 -0
  324. package/src/color/typedefs.ts +18 -0
  325. package/src/color/util.ts +93 -0
  326. package/src/config.ts +159 -0
  327. package/src/constants.ts +29 -0
  328. package/src/controls/Control.ts +385 -0
  329. package/src/controls/changeWidth.ts +53 -0
  330. package/src/controls/commonControls.ts +105 -0
  331. package/src/controls/controlRendering.ts +138 -0
  332. package/src/controls/drag.ts +32 -0
  333. package/src/controls/fireEvent.ts +18 -0
  334. package/src/controls/index.ts +22 -0
  335. package/src/controls/polyControl.ts +135 -0
  336. package/src/controls/rotate.ts +87 -0
  337. package/src/controls/scale.ts +277 -0
  338. package/src/controls/scaleSkew.ts +92 -0
  339. package/src/controls/skew.ts +243 -0
  340. package/src/controls/util.ts +155 -0
  341. package/src/controls/wrapWithFireEvent.ts +25 -0
  342. package/src/controls/wrapWithFixedAnchor.ts +20 -0
  343. package/src/env/browser.ts +32 -0
  344. package/src/env/index.ts +38 -0
  345. package/src/env/node.ts +58 -0
  346. package/src/env/types.ts +15 -0
  347. package/src/filters/{base_filter.class.js → BaseFilter.ts} +203 -151
  348. package/src/filters/BlendColor.ts +219 -0
  349. package/src/filters/BlendImage.ts +230 -0
  350. package/src/filters/Blur.ts +181 -0
  351. package/src/filters/Boilerplate.ts +94 -0
  352. package/src/filters/Brightness.ts +85 -0
  353. package/src/filters/Canvas2dFilterBackend.ts +65 -0
  354. package/src/filters/ColorMatrix.ts +147 -0
  355. package/src/filters/ColorMatrixFilters.ts +79 -0
  356. package/src/filters/Composed.ts +78 -0
  357. package/src/filters/Contrast.ts +84 -0
  358. package/src/filters/Convolute.ts +186 -0
  359. package/src/filters/FilterBackend.ts +38 -0
  360. package/src/filters/GLProbes/GLProbe.ts +7 -0
  361. package/src/filters/GLProbes/NodeGLProbe.ts +15 -0
  362. package/src/filters/GLProbes/WebGLProbe.ts +47 -0
  363. package/src/filters/Gamma.ts +112 -0
  364. package/src/filters/Grayscale.ts +104 -0
  365. package/src/filters/HueRotation.ts +64 -0
  366. package/src/filters/Invert.ts +101 -0
  367. package/src/filters/Noise.ts +96 -0
  368. package/src/filters/Pixelate.ts +98 -0
  369. package/src/filters/RemoveColor.ts +137 -0
  370. package/src/filters/Resize.ts +540 -0
  371. package/src/filters/Saturation.ts +89 -0
  372. package/src/filters/Vibrance.ts +90 -0
  373. package/src/filters/WebGLFilterBackend.ts +456 -0
  374. package/src/filters/filters.ts +28 -0
  375. package/src/filters/index.ts +12 -0
  376. package/src/filters/shaders/baseFilter.ts +17 -0
  377. package/src/filters/shaders/blendColor.ts +33 -0
  378. package/src/filters/shaders/blendImage.ts +32 -0
  379. package/src/filters/shaders/blur.ts +24 -0
  380. package/src/filters/shaders/brightness.ts +11 -0
  381. package/src/filters/shaders/colorMatrix.ts +12 -0
  382. package/src/filters/shaders/constrast.ts +11 -0
  383. package/src/filters/shaders/convolute.ts +154 -0
  384. package/src/filters/shaders/gamma.ts +15 -0
  385. package/src/filters/shaders/grayscale.ts +36 -0
  386. package/src/filters/shaders/invert.ts +19 -0
  387. package/src/filters/shaders/noise.ts +16 -0
  388. package/src/filters/shaders/pixelate.ts +19 -0
  389. package/src/filters/shaders/removeColor.ts +13 -0
  390. package/src/filters/shaders/saturation.ts +15 -0
  391. package/src/filters/shaders/vibrance.ts +16 -0
  392. package/src/filters/typedefs.ts +59 -0
  393. package/src/filters/utils.ts +7 -0
  394. package/src/gradient/Gradient.ts +409 -0
  395. package/src/gradient/constants.ts +12 -0
  396. package/src/gradient/index.ts +2 -0
  397. package/src/gradient/parser/index.ts +3 -0
  398. package/src/gradient/parser/misc.ts +13 -0
  399. package/src/gradient/parser/parseColorStops.ts +56 -0
  400. package/src/gradient/parser/parseCoords.ts +73 -0
  401. package/src/gradient/typedefs.ts +104 -0
  402. package/src/mixins/{eraser_brush.mixin.js → eraser_brush.mixin.ts} +350 -239
  403. package/src/parkinglot/canvas_animation.mixin.ts +121 -0
  404. package/src/parkinglot/straighten.ts +58 -0
  405. package/src/parser/applyViewboxTransform.ts +158 -0
  406. package/src/parser/attributes.ts +25 -0
  407. package/src/parser/constants.ts +116 -0
  408. package/src/parser/doesSomeParentMatch.ts +18 -0
  409. package/src/parser/elementById.ts +21 -0
  410. package/src/parser/elementMatchesRule.ts +16 -0
  411. package/src/parser/elements_parser.ts +158 -0
  412. package/src/parser/getCSSRules.ts +61 -0
  413. package/src/parser/getGlobalStylesForElement.ts +19 -0
  414. package/src/parser/getGradientDefs.ts +31 -0
  415. package/src/parser/getMultipleNodes.ts +15 -0
  416. package/src/parser/getSvgRegex.ts +3 -0
  417. package/src/parser/hasAncestorWithNodeName.ts +14 -0
  418. package/src/parser/index.ts +8 -0
  419. package/src/parser/loadSVGFromString.ts +29 -0
  420. package/src/parser/loadSVGFromURL.ts +47 -0
  421. package/src/parser/normalizeAttr.ts +10 -0
  422. package/src/parser/normalizeValue.ts +64 -0
  423. package/src/parser/parseAttributes.ts +90 -0
  424. package/src/parser/parseFontDeclaration.ts +44 -0
  425. package/src/parser/parsePointsAttribute.ts +34 -0
  426. package/src/parser/parseSVGDocument.ts +118 -0
  427. package/src/parser/parseStyleAttribute.ts +27 -0
  428. package/src/parser/parseStyleObject.ts +15 -0
  429. package/src/parser/parseStyleString.ts +16 -0
  430. package/src/parser/parseTransformAttribute.ts +94 -0
  431. package/src/parser/parseUseDirectives.ts +78 -0
  432. package/src/parser/percent.ts +27 -0
  433. package/src/parser/recursivelyParseGradientsXlink.ts +42 -0
  434. package/src/parser/selectorMatches.ts +25 -0
  435. package/src/parser/setStrokeFillOpacity.ts +40 -0
  436. package/src/parser/typedefs.ts +13 -0
  437. package/src/shapes/ActiveSelection.ts +192 -0
  438. package/src/shapes/Circle.ts +236 -0
  439. package/src/shapes/Ellipse.ts +177 -0
  440. package/src/shapes/Group.ts +1103 -0
  441. package/src/shapes/IText/DraggableTextDelegate.ts +385 -0
  442. package/src/shapes/IText/IText.ts +696 -0
  443. package/src/shapes/IText/ITextBehavior.ts +1073 -0
  444. package/src/shapes/IText/ITextClickBehavior.ts +292 -0
  445. package/src/shapes/IText/ITextKeyBehavior.ts +675 -0
  446. package/src/shapes/IText/constants.ts +53 -0
  447. package/src/shapes/Image.ts +848 -0
  448. package/src/shapes/Line.ts +285 -0
  449. package/src/shapes/Object/AnimatableObject.ts +103 -0
  450. package/src/shapes/Object/FabricObject.ts +29 -0
  451. package/src/shapes/Object/FabricObjectSVGExportMixin.ts +278 -0
  452. package/src/shapes/Object/InteractiveObject.ts +669 -0
  453. package/src/shapes/Object/Object.ts +1589 -0
  454. package/src/shapes/Object/ObjectGeometry.ts +814 -0
  455. package/src/shapes/Object/ObjectOrigin.ts +277 -0
  456. package/src/shapes/Object/StackedObject.ts +206 -0
  457. package/src/shapes/Object/defaultValues.ts +110 -0
  458. package/src/shapes/Object/types/BaseProps.ts +96 -0
  459. package/src/shapes/Object/types/BorderProps.ts +40 -0
  460. package/src/shapes/Object/types/ControlProps.ts +69 -0
  461. package/src/shapes/Object/types/FabricObjectProps.ts +111 -0
  462. package/src/shapes/Object/types/FillStrokeProps.ts +90 -0
  463. package/src/shapes/Object/types/LockInteractionProps.ts +57 -0
  464. package/src/shapes/Object/types/ObjectProps.ts +49 -0
  465. package/src/shapes/Object/types/SerializedObjectProps.ts +73 -0
  466. package/src/shapes/Object/types/index.ts +8 -0
  467. package/src/shapes/Path.ts +434 -0
  468. package/src/shapes/Polygon.ts +22 -0
  469. package/src/shapes/Polyline.ts +364 -0
  470. package/src/shapes/Rect.ts +230 -0
  471. package/src/shapes/Text/StyledText.ts +323 -0
  472. package/src/shapes/Text/Text.ts +1891 -0
  473. package/src/shapes/Text/TextSVGExportMixin.ts +289 -0
  474. package/src/shapes/Text/constants.ts +111 -0
  475. package/src/shapes/Textbox.ts +526 -0
  476. package/src/shapes/Triangle.ts +62 -0
  477. package/src/typedefs.ts +121 -0
  478. package/src/util/animation/AnimationBase.ts +166 -0
  479. package/src/util/animation/AnimationFrameProvider.ts +9 -0
  480. package/src/util/animation/AnimationRegistry.ts +58 -0
  481. package/src/util/animation/ArrayAnimation.ts +27 -0
  482. package/src/util/animation/ColorAnimation.ts +74 -0
  483. package/src/util/animation/ValueAnimation.ts +29 -0
  484. package/src/util/animation/animate.ts +74 -0
  485. package/src/util/animation/easing.ts +327 -0
  486. package/src/util/animation/index.ts +2 -0
  487. package/src/util/animation/types.ts +136 -0
  488. package/src/util/applyMixins.ts +22 -0
  489. package/src/util/dom_event.ts +28 -0
  490. package/src/util/dom_misc.ts +44 -0
  491. package/src/util/dom_request.ts +64 -0
  492. package/src/util/dom_style.ts +20 -0
  493. package/src/util/index.ts +106 -0
  494. package/src/util/internals/cleanupSvgAttribute.test.ts +16 -0
  495. package/src/util/internals/cleanupSvgAttribute.ts +8 -0
  496. package/src/util/internals/cloneDeep.test.ts +16 -0
  497. package/src/util/internals/cloneDeep.ts +2 -0
  498. package/src/util/internals/getRandomInt.test.ts +33 -0
  499. package/src/util/internals/getRandomInt.ts +8 -0
  500. package/src/util/internals/ifNaN.ts +9 -0
  501. package/src/util/internals/index.ts +3 -0
  502. package/src/util/internals/removeFromArray.ts +14 -0
  503. package/src/util/internals/uid.ts +3 -0
  504. package/src/util/lang_string.ts +79 -0
  505. package/src/util/misc/boundingBoxFromPoints.ts +38 -0
  506. package/src/util/misc/capValue.ts +2 -0
  507. package/src/util/misc/cos.ts +24 -0
  508. package/src/util/misc/dom.ts +55 -0
  509. package/src/util/misc/findScaleTo.ts +29 -0
  510. package/src/util/misc/groupSVGElements.ts +15 -0
  511. package/src/util/misc/isTransparent.ts +28 -0
  512. package/src/util/misc/matrix.ts +313 -0
  513. package/src/util/misc/mergeClipPaths.ts +40 -0
  514. package/src/util/misc/objectEnlive.ts +174 -0
  515. package/src/util/misc/objectTransforms.ts +130 -0
  516. package/src/util/misc/pick.ts +29 -0
  517. package/src/util/misc/planeChange.ts +127 -0
  518. package/src/util/misc/projectStroke/StrokeLineCapProjections.ts +113 -0
  519. package/src/util/misc/projectStroke/StrokeLineJoinProjections.ts +227 -0
  520. package/src/util/misc/projectStroke/StrokeProjectionsBase.ts +76 -0
  521. package/src/util/misc/projectStroke/index.ts +55 -0
  522. package/src/util/misc/projectStroke/types.ts +24 -0
  523. package/src/util/misc/radiansDegreesConversion.ts +18 -0
  524. package/src/util/misc/resolveOrigin.ts +22 -0
  525. package/src/util/misc/rotatePoint.ts +15 -0
  526. package/src/util/misc/sin.ts +26 -0
  527. package/src/util/misc/svgParsing.ts +171 -0
  528. package/src/util/misc/textStyles.ts +132 -0
  529. package/src/util/misc/toFixed.ts +8 -0
  530. package/src/util/misc/vectors.ts +83 -0
  531. package/src/util/path/index.ts +1039 -0
  532. package/src/util/path/regex.ts +39 -0
  533. package/src/util/path/typechecks.ts +145 -0
  534. package/src/util/path/typedefs.ts +305 -0
  535. package/src/util/transform_matrix_removal.ts +61 -0
  536. package/src/util/typeAssertions.ts +78 -0
  537. package/tsconfig.json +106 -0
  538. package/HEADER.js +0 -203
  539. package/build.js +0 -287
  540. package/dist/fabric.js +0 -31187
  541. package/dist/fabric.min.js +0 -1
  542. package/old-travis-reference.yml +0 -97
  543. package/src/brushes/circle_brush.class.js +0 -144
  544. package/src/brushes/pattern_brush.class.js +0 -61
  545. package/src/brushes/pencil_brush.class.js +0 -310
  546. package/src/brushes/spray_brush.class.js +0 -219
  547. package/src/canvas.class.js +0 -1312
  548. package/src/color.class.js +0 -636
  549. package/src/control.class.js +0 -339
  550. package/src/controls.actions.js +0 -740
  551. package/src/controls.render.js +0 -99
  552. package/src/elements_parser.js +0 -152
  553. package/src/filters/2d_backend.class.js +0 -65
  554. package/src/filters/blendcolor_filter.class.js +0 -251
  555. package/src/filters/blendimage_filter.class.js +0 -247
  556. package/src/filters/blur_filter.class.js +0 -217
  557. package/src/filters/brightness_filter.class.js +0 -113
  558. package/src/filters/colormatrix_filter.class.js +0 -159
  559. package/src/filters/composed_filter.class.js +0 -72
  560. package/src/filters/contrast_filter.class.js +0 -113
  561. package/src/filters/convolute_filter.class.js +0 -352
  562. package/src/filters/filter_boilerplate.js +0 -111
  563. package/src/filters/filter_generator.js +0 -85
  564. package/src/filters/gamma_filter.class.js +0 -136
  565. package/src/filters/grayscale_filter.class.js +0 -154
  566. package/src/filters/hue_rotation.class.js +0 -107
  567. package/src/filters/invert_filter.class.js +0 -111
  568. package/src/filters/noise_filter.class.js +0 -134
  569. package/src/filters/pixelate_filter.class.js +0 -137
  570. package/src/filters/removecolor_filter.class.js +0 -173
  571. package/src/filters/resize_filter.class.js +0 -490
  572. package/src/filters/saturate_filter.class.js +0 -119
  573. package/src/filters/vibrance_filter.class.js +0 -122
  574. package/src/filters/webgl_backend.class.js +0 -396
  575. package/src/globalFabric.js +0 -4
  576. package/src/gradient.class.js +0 -490
  577. package/src/intersection.class.js +0 -172
  578. package/src/log.js +0 -11
  579. package/src/mixins/animation.mixin.js +0 -231
  580. package/src/mixins/canvas_dataurl_exporter.mixin.js +0 -97
  581. package/src/mixins/canvas_events.mixin.js +0 -974
  582. package/src/mixins/canvas_gestures.mixin.js +0 -149
  583. package/src/mixins/canvas_grouping.mixin.js +0 -177
  584. package/src/mixins/canvas_serialization.mixin.js +0 -228
  585. package/src/mixins/collection.mixin.js +0 -170
  586. package/src/mixins/default_controls.js +0 -114
  587. package/src/mixins/itext.svg_export.js +0 -241
  588. package/src/mixins/itext_behavior.mixin.js +0 -940
  589. package/src/mixins/itext_click_behavior.mixin.js +0 -278
  590. package/src/mixins/itext_key_behavior.mixin.js +0 -694
  591. package/src/mixins/object.svg_export.js +0 -258
  592. package/src/mixins/object_geometry.mixin.js +0 -683
  593. package/src/mixins/object_interactivity.mixin.js +0 -314
  594. package/src/mixins/object_origin.mixin.js +0 -255
  595. package/src/mixins/object_stacking.mixin.js +0 -80
  596. package/src/mixins/object_straightening.mixin.js +0 -80
  597. package/src/mixins/observable.mixin.js +0 -141
  598. package/src/mixins/shared_methods.mixin.js +0 -94
  599. package/src/mixins/stateful.mixin.js +0 -107
  600. package/src/mixins/text_style.mixin.js +0 -324
  601. package/src/parser.js +0 -1090
  602. package/src/pattern.class.js +0 -189
  603. package/src/point.class.js +0 -337
  604. package/src/shadow.class.js +0 -195
  605. package/src/shapes/active_selection.class.js +0 -155
  606. package/src/shapes/circle.class.js +0 -210
  607. package/src/shapes/ellipse.class.js +0 -181
  608. package/src/shapes/group.class.js +0 -593
  609. package/src/shapes/image.class.js +0 -764
  610. package/src/shapes/itext.class.js +0 -526
  611. package/src/shapes/line.class.js +0 -324
  612. package/src/shapes/object.class.js +0 -2008
  613. package/src/shapes/path.class.js +0 -384
  614. package/src/shapes/polygon.class.js +0 -81
  615. package/src/shapes/polyline.class.js +0 -268
  616. package/src/shapes/rect.class.js +0 -187
  617. package/src/shapes/text.class.js +0 -1696
  618. package/src/shapes/textbox.class.js +0 -461
  619. package/src/shapes/triangle.class.js +0 -93
  620. package/src/static_canvas.class.js +0 -1881
  621. package/src/util/anim_ease.js +0 -398
  622. package/src/util/animate.js +0 -254
  623. package/src/util/animate_color.js +0 -74
  624. package/src/util/dom_event.js +0 -50
  625. package/src/util/dom_misc.js +0 -300
  626. package/src/util/dom_request.js +0 -54
  627. package/src/util/dom_style.js +0 -70
  628. package/src/util/lang_array.js +0 -94
  629. package/src/util/lang_class.js +0 -115
  630. package/src/util/lang_object.js +0 -75
  631. package/src/util/lang_string.js +0 -110
  632. package/src/util/misc.js +0 -1330
  633. package/src/util/named_accessors.mixin.js +0 -428
  634. package/src/util/path.js +0 -829
@@ -1,64 +1,70 @@
1
- /**
2
- * @namespace fabric.Image.filters
3
- * @memberOf fabric.Image
4
- * @tutorial {@link http://fabricjs.com/fabric-intro-part-2#image_filters}
5
- * @see {@link http://fabricjs.com/image-filters|ImageFilters demo}
6
- */
7
- fabric.Image = fabric.Image || { };
8
- fabric.Image.filters = fabric.Image.filters || { };
9
-
10
- /**
11
- * Root filter class from which all filter classes inherit from
12
- * @class fabric.Image.filters.BaseFilter
13
- * @memberOf fabric.Image.filters
14
- */
15
- fabric.Image.filters.BaseFilter = fabric.util.createClass(/** @lends fabric.Image.filters.BaseFilter.prototype */ {
1
+ import { getEnv } from '../env';
2
+ import { createCanvasElement } from '../util/misc/dom';
3
+ import type {
4
+ T2DPipelineState,
5
+ TWebGLAttributeLocationMap,
6
+ TWebGLPipelineState,
7
+ TWebGLProgramCacheItem,
8
+ TWebGLUniformLocationMap,
9
+ } from './typedefs';
10
+ import { isWebGLPipelineState } from './utils';
11
+ import {
12
+ highPsourceCode,
13
+ identityFragmentShader,
14
+ vertexSource,
15
+ } from './shaders/baseFilter';
16
+ import type { Abortable } from '../typedefs';
16
17
 
18
+ export class BaseFilter {
17
19
  /**
18
20
  * Filter type
19
21
  * @param {String} type
20
22
  * @default
21
23
  */
22
- type: 'BaseFilter',
24
+ get type(): string {
25
+ return (this.constructor as typeof BaseFilter).type;
26
+ }
23
27
 
24
28
  /**
25
- * Array of attributes to send with buffers. do not modify
26
- * @private
29
+ * The class type. Used to identify which class this is.
30
+ * This is used for serialization purposes and internally it can be used
31
+ * to identify classes. As a developer you could use `instance of Class`
32
+ * but to avoid importing all the code and blocking tree shaking we try
33
+ * to avoid doing that.
27
34
  */
35
+ static type = 'BaseFilter';
28
36
 
29
- vertexSource: 'attribute vec2 aPosition;\n' +
30
- 'varying vec2 vTexCoord;\n' +
31
- 'void main() {\n' +
32
- 'vTexCoord = aPosition;\n' +
33
- 'gl_Position = vec4(aPosition * 2.0 - 1.0, 0.0, 1.0);\n' +
34
- '}',
37
+ declare static defaults: Record<string, any>;
35
38
 
36
- fragmentSource: 'precision highp float;\n' +
37
- 'varying vec2 vTexCoord;\n' +
38
- 'uniform sampler2D uTexture;\n' +
39
- 'void main() {\n' +
40
- 'gl_FragColor = texture2D(uTexture, vTexCoord);\n' +
41
- '}',
39
+ /**
40
+ * Array of attributes to send with buffers. do not modify
41
+ * @private
42
+ */
43
+ vertexSource = vertexSource;
42
44
 
43
45
  /**
44
- * Constructor
45
- * @param {Object} [options] Options object
46
+ * Name of the parameter that can be changed in the filter.
47
+ * Some filters have more than one parameter and there is no
48
+ * mainParameter
49
+ * @private
46
50
  */
47
- initialize: function(options) {
48
- if (options) {
49
- this.setOptions(options);
50
- }
51
- },
51
+ declare mainParameter?: keyof this | undefined;
52
52
 
53
53
  /**
54
- * Sets filter's properties from options
54
+ * Constructor
55
55
  * @param {Object} [options] Options object
56
56
  */
57
- setOptions: function(options) {
58
- for (var prop in options) {
59
- this[prop] = options[prop];
60
- }
61
- },
57
+ constructor({ ...options }: Record<string, any> = {}) {
58
+ Object.assign(
59
+ this,
60
+ (this.constructor as typeof BaseFilter).defaults,
61
+ options
62
+ );
63
+ }
64
+
65
+ protected getFragmentSource(): string {
66
+ return identityFragmentShader;
67
+ }
62
68
 
63
69
  /**
64
70
  * Compile this filter's shader program.
@@ -67,59 +73,66 @@ fabric.Image.filters.BaseFilter = fabric.util.createClass(/** @lends fabric.Imag
67
73
  * @param {String} fragmentSource fragmentShader source for compilation
68
74
  * @param {String} vertexSource vertexShader source for compilation
69
75
  */
70
- createProgram: function(gl, fragmentSource, vertexSource) {
71
- fragmentSource = fragmentSource || this.fragmentSource;
72
- vertexSource = vertexSource || this.vertexSource;
73
- if (fabric.webGlPrecision !== 'highp'){
76
+ createProgram(
77
+ gl: WebGLRenderingContext,
78
+ fragmentSource: string = this.getFragmentSource(),
79
+ vertexSource: string = this.vertexSource
80
+ ) {
81
+ const {
82
+ WebGLProbe: { GLPrecision = 'highp' },
83
+ } = getEnv();
84
+ if (GLPrecision !== 'highp') {
74
85
  fragmentSource = fragmentSource.replace(
75
- /precision highp float/g,
76
- 'precision ' + fabric.webGlPrecision + ' float'
86
+ new RegExp(highPsourceCode, 'g'),
87
+ highPsourceCode.replace('highp', GLPrecision)
77
88
  );
78
89
  }
79
- var vertexShader = gl.createShader(gl.VERTEX_SHADER);
90
+ const vertexShader = gl.createShader(gl.VERTEX_SHADER);
91
+ const fragmentShader = gl.createShader(gl.FRAGMENT_SHADER);
92
+ const program = gl.createProgram();
93
+
94
+ if (!vertexShader || !fragmentShader || !program) {
95
+ throw new Error('Vertex, fragment shader or program creation error');
96
+ }
80
97
  gl.shaderSource(vertexShader, vertexSource);
81
98
  gl.compileShader(vertexShader);
82
99
  if (!gl.getShaderParameter(vertexShader, gl.COMPILE_STATUS)) {
83
100
  throw new Error(
84
- // eslint-disable-next-line prefer-template
85
- 'Vertex shader compile error for ' + this.type + ': ' +
86
- gl.getShaderInfoLog(vertexShader)
101
+ `Vertex shader compile error for ${this.type}: ${gl.getShaderInfoLog(
102
+ vertexShader
103
+ )}`
87
104
  );
88
105
  }
89
106
 
90
- var fragmentShader = gl.createShader(gl.FRAGMENT_SHADER);
91
107
  gl.shaderSource(fragmentShader, fragmentSource);
92
108
  gl.compileShader(fragmentShader);
93
109
  if (!gl.getShaderParameter(fragmentShader, gl.COMPILE_STATUS)) {
94
110
  throw new Error(
95
- // eslint-disable-next-line prefer-template
96
- 'Fragment shader compile error for ' + this.type + ': ' +
97
- gl.getShaderInfoLog(fragmentShader)
111
+ `Fragment shader compile error for ${this.type}: ${gl.getShaderInfoLog(
112
+ fragmentShader
113
+ )}`
98
114
  );
99
115
  }
100
116
 
101
- var program = gl.createProgram();
102
117
  gl.attachShader(program, vertexShader);
103
118
  gl.attachShader(program, fragmentShader);
104
119
  gl.linkProgram(program);
105
120
  if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {
106
121
  throw new Error(
107
122
  // eslint-disable-next-line prefer-template
108
- 'Shader link error for "${this.type}" ' +
109
- gl.getProgramInfoLog(program)
123
+ 'Shader link error for "${this.type}" ' + gl.getProgramInfoLog(program)
110
124
  );
111
125
  }
112
126
 
113
- var attributeLocations = this.getAttributeLocations(gl, program);
114
- var uniformLocations = this.getUniformLocations(gl, program) || { };
127
+ const uniformLocations = this.getUniformLocations(gl, program) || {};
115
128
  uniformLocations.uStepW = gl.getUniformLocation(program, 'uStepW');
116
129
  uniformLocations.uStepH = gl.getUniformLocation(program, 'uStepH');
117
130
  return {
118
- program: program,
119
- attributeLocations: attributeLocations,
120
- uniformLocations: uniformLocations
131
+ program,
132
+ attributeLocations: this.getAttributeLocations(gl, program),
133
+ uniformLocations,
121
134
  };
122
- },
135
+ }
123
136
 
124
137
  /**
125
138
  * Return a map of attribute names to WebGLAttributeLocation objects.
@@ -128,11 +141,14 @@ fabric.Image.filters.BaseFilter = fabric.util.createClass(/** @lends fabric.Imag
128
141
  * @param {WebGLShaderProgram} program The shader program from which to take attribute locations.
129
142
  * @returns {Object} A map of attribute names to attribute locations.
130
143
  */
131
- getAttributeLocations: function(gl, program) {
144
+ getAttributeLocations(
145
+ gl: WebGLRenderingContext,
146
+ program: WebGLProgram
147
+ ): TWebGLAttributeLocationMap {
132
148
  return {
133
149
  aPosition: gl.getAttribLocation(program, 'aPosition'),
134
150
  };
135
- },
151
+ }
136
152
 
137
153
  /**
138
154
  * Return a map of uniform names to WebGLUniformLocation objects.
@@ -143,10 +159,12 @@ fabric.Image.filters.BaseFilter = fabric.util.createClass(/** @lends fabric.Imag
143
159
  * @param {WebGLShaderProgram} program The shader program from which to take uniform locations.
144
160
  * @returns {Object} A map of uniform names to uniform locations.
145
161
  */
146
- getUniformLocations: function (/* gl, program */) {
147
- // in case i do not need any special uniform i need to return an empty object
148
- return { };
149
- },
162
+ getUniformLocations(
163
+ gl: WebGLRenderingContext,
164
+ program: WebGLProgram
165
+ ): TWebGLUniformLocationMap {
166
+ return {};
167
+ }
150
168
 
151
169
  /**
152
170
  * Send attribute data from this filter to its shader program on the GPU.
@@ -154,41 +172,53 @@ fabric.Image.filters.BaseFilter = fabric.util.createClass(/** @lends fabric.Imag
154
172
  * @param {WebGLRenderingContext} gl The canvas context used to compile the shader program.
155
173
  * @param {Object} attributeLocations A map of shader attribute names to their locations.
156
174
  */
157
- sendAttributeData: function(gl, attributeLocations, aPositionData) {
158
- var attributeLocation = attributeLocations.aPosition;
159
- var buffer = gl.createBuffer();
175
+ sendAttributeData(
176
+ gl: WebGLRenderingContext,
177
+ attributeLocations: Record<string, number>,
178
+ aPositionData: Float32Array
179
+ ) {
180
+ const attributeLocation = attributeLocations.aPosition;
181
+ const buffer = gl.createBuffer();
160
182
  gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
161
183
  gl.enableVertexAttribArray(attributeLocation);
162
184
  gl.vertexAttribPointer(attributeLocation, 2, gl.FLOAT, false, 0, 0);
163
185
  gl.bufferData(gl.ARRAY_BUFFER, aPositionData, gl.STATIC_DRAW);
164
- },
186
+ }
165
187
 
166
- _setupFrameBuffer: function(options) {
167
- var gl = options.context, width, height;
188
+ _setupFrameBuffer(options: TWebGLPipelineState) {
189
+ const gl = options.context;
168
190
  if (options.passes > 1) {
169
- width = options.destinationWidth;
170
- height = options.destinationHeight;
191
+ const width = options.destinationWidth;
192
+ const height = options.destinationHeight;
171
193
  if (options.sourceWidth !== width || options.sourceHeight !== height) {
172
194
  gl.deleteTexture(options.targetTexture);
173
- options.targetTexture = options.filterBackend.createTexture(gl, width, height);
195
+ options.targetTexture = options.filterBackend.createTexture(
196
+ gl,
197
+ width,
198
+ height
199
+ );
174
200
  }
175
- gl.framebufferTexture2D(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0, gl.TEXTURE_2D,
176
- options.targetTexture, 0);
177
- }
178
- else {
201
+ gl.framebufferTexture2D(
202
+ gl.FRAMEBUFFER,
203
+ gl.COLOR_ATTACHMENT0,
204
+ gl.TEXTURE_2D,
205
+ options.targetTexture,
206
+ 0
207
+ );
208
+ } else {
179
209
  // draw last filter on canvas and not to framebuffer.
180
210
  gl.bindFramebuffer(gl.FRAMEBUFFER, null);
181
211
  gl.finish();
182
212
  }
183
- },
213
+ }
184
214
 
185
- _swapTextures: function(options) {
215
+ _swapTextures(options: TWebGLPipelineState) {
186
216
  options.passes--;
187
217
  options.pass++;
188
- var temp = options.targetTexture;
218
+ const temp = options.targetTexture;
189
219
  options.targetTexture = options.sourceTexture;
190
220
  options.sourceTexture = temp;
191
- },
221
+ }
192
222
 
193
223
  /**
194
224
  * Generic isNeutral implementation for one parameter based filters.
@@ -197,26 +227,25 @@ fabric.Image.filters.BaseFilter = fabric.util.createClass(/** @lends fabric.Imag
197
227
  * Other filters may need their own version ( ColorMatrix, HueRotation, gamma, ComposedFilter )
198
228
  * @param {Object} options
199
229
  **/
200
- isNeutralState: function(/* options */) {
201
- var main = this.mainParameter,
202
- _class = fabric.Image.filters[this.type].prototype;
230
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars
231
+ isNeutralState(options?: any): boolean {
232
+ const main = this.mainParameter,
233
+ defaultValue = (this.constructor as typeof BaseFilter).defaults[
234
+ main as string
235
+ ];
203
236
  if (main) {
204
- if (Array.isArray(_class[main])) {
205
- for (var i = _class[main].length; i--;) {
206
- if (this[main][i] !== _class[main][i]) {
207
- return false;
208
- }
209
- }
210
- return true;
211
- }
212
- else {
213
- return _class[main] === this[main];
237
+ const thisValue = this[main];
238
+ if (Array.isArray(defaultValue) && Array.isArray(thisValue)) {
239
+ return defaultValue.every(
240
+ (value: any, i: number) => value === thisValue[i]
241
+ );
242
+ } else {
243
+ return defaultValue === thisValue;
214
244
  }
215
- }
216
- else {
245
+ } else {
217
246
  return false;
218
247
  }
219
- },
248
+ }
220
249
 
221
250
  /**
222
251
  * Apply this filter to the input image data provided.
@@ -231,29 +260,43 @@ fabric.Image.filters.BaseFilter = fabric.util.createClass(/** @lends fabric.Imag
231
260
  * @param {WebGLRenderingContext} options.context The GL context used for rendering.
232
261
  * @param {Object} options.programCache A map of compiled shader programs, keyed by filter type.
233
262
  */
234
- applyTo: function(options) {
235
- if (options.webgl) {
263
+ applyTo(options: TWebGLPipelineState | T2DPipelineState) {
264
+ if (isWebGLPipelineState(options)) {
236
265
  this._setupFrameBuffer(options);
237
266
  this.applyToWebGL(options);
238
267
  this._swapTextures(options);
239
- }
240
- else {
268
+ } else {
241
269
  this.applyTo2d(options);
242
270
  }
243
- },
271
+ }
272
+
273
+ applyTo2d(options: T2DPipelineState): void {
274
+ // override by subclass
275
+ }
276
+
277
+ /**
278
+ * Returns a string that represent the current selected shader code for the filter.
279
+ * Used to force recompilation when parameters change or to retrieve the shader from cache
280
+ * @type string
281
+ **/
282
+ getCacheKey() {
283
+ return this.type;
284
+ }
244
285
 
245
286
  /**
246
287
  * Retrieves the cached shader.
247
288
  * @param {Object} options
248
289
  * @param {WebGLRenderingContext} options.context The GL context used for rendering.
249
290
  * @param {Object} options.programCache A map of compiled shader programs, keyed by filter type.
291
+ * @return {WebGLProgram} the compiled program shader
250
292
  */
251
- retrieveShader: function(options) {
252
- if (!options.programCache.hasOwnProperty(this.type)) {
253
- options.programCache[this.type] = this.createProgram(options.context);
293
+ retrieveShader(options: TWebGLPipelineState): TWebGLProgramCacheItem {
294
+ const key = this.getCacheKey();
295
+ if (!options.programCache[key]) {
296
+ options.programCache[key] = this.createProgram(options.context);
254
297
  }
255
- return options.programCache[this.type];
256
- },
298
+ return options.programCache[key];
299
+ }
257
300
 
258
301
  /**
259
302
  * Apply this filter using webgl.
@@ -267,13 +310,12 @@ fabric.Image.filters.BaseFilter = fabric.util.createClass(/** @lends fabric.Imag
267
310
  * @param {WebGLRenderingContext} options.context The GL context used for rendering.
268
311
  * @param {Object} options.programCache A map of compiled shader programs, keyed by filter type.
269
312
  */
270
- applyToWebGL: function(options) {
271
- var gl = options.context;
272
- var shader = this.retrieveShader(options);
313
+ applyToWebGL(options: TWebGLPipelineState) {
314
+ const gl = options.context;
315
+ const shader = this.retrieveShader(options);
273
316
  if (options.pass === 0 && options.originalTexture) {
274
317
  gl.bindTexture(gl.TEXTURE_2D, options.originalTexture);
275
- }
276
- else {
318
+ } else {
277
319
  gl.bindTexture(gl.TEXTURE_2D, options.sourceTexture);
278
320
  }
279
321
  gl.useProgram(shader.program);
@@ -285,28 +327,34 @@ fabric.Image.filters.BaseFilter = fabric.util.createClass(/** @lends fabric.Imag
285
327
  this.sendUniformData(gl, shader.uniformLocations);
286
328
  gl.viewport(0, 0, options.destinationWidth, options.destinationHeight);
287
329
  gl.drawArrays(gl.TRIANGLE_STRIP, 0, 4);
288
- },
330
+ }
289
331
 
290
- bindAdditionalTexture: function(gl, texture, textureUnit) {
332
+ bindAdditionalTexture(
333
+ gl: WebGLRenderingContext,
334
+ texture: WebGLTexture,
335
+ textureUnit: number
336
+ ) {
291
337
  gl.activeTexture(textureUnit);
292
338
  gl.bindTexture(gl.TEXTURE_2D, texture);
293
339
  // reset active texture to 0 as usual
294
340
  gl.activeTexture(gl.TEXTURE0);
295
- },
341
+ }
296
342
 
297
- unbindAdditionalTexture: function(gl, textureUnit) {
343
+ unbindAdditionalTexture(gl: WebGLRenderingContext, textureUnit: number) {
298
344
  gl.activeTexture(textureUnit);
299
345
  gl.bindTexture(gl.TEXTURE_2D, null);
300
346
  gl.activeTexture(gl.TEXTURE0);
301
- },
347
+ }
302
348
 
303
- getMainParameter: function() {
304
- return this[this.mainParameter];
305
- },
349
+ getMainParameter() {
350
+ return this.mainParameter ? this[this.mainParameter] : undefined;
351
+ }
306
352
 
307
- setMainParameter: function(value) {
308
- this[this.mainParameter] = value;
309
- },
353
+ setMainParameter(value: any) {
354
+ if (this.mainParameter) {
355
+ this[this.mainParameter] = value;
356
+ }
357
+ }
310
358
 
311
359
  /**
312
360
  * Send uniform data from this filter to its shader program on the GPU.
@@ -316,47 +364,51 @@ fabric.Image.filters.BaseFilter = fabric.util.createClass(/** @lends fabric.Imag
316
364
  * @param {WebGLRenderingContext} gl The canvas context used to compile the shader program.
317
365
  * @param {Object} uniformLocations A map of shader uniform names to their locations.
318
366
  */
319
- sendUniformData: function(/* gl, uniformLocations */) {
320
- // Intentionally left blank. Override me in subclasses.
321
- },
367
+ sendUniformData(
368
+ gl: WebGLRenderingContext,
369
+ uniformLocations: TWebGLUniformLocationMap
370
+ ): void {
371
+ // override by subclass
372
+ }
322
373
 
323
374
  /**
324
375
  * If needed by a 2d filter, this functions can create an helper canvas to be used
325
376
  * remember that options.targetCanvas is available for use till end of chain.
326
377
  */
327
- createHelpLayer: function(options) {
378
+ createHelpLayer(options: T2DPipelineState) {
328
379
  if (!options.helpLayer) {
329
- var helpLayer = document.createElement('canvas');
380
+ const helpLayer = createCanvasElement();
330
381
  helpLayer.width = options.sourceWidth;
331
382
  helpLayer.height = options.sourceHeight;
332
383
  options.helpLayer = helpLayer;
333
384
  }
334
- },
385
+ }
335
386
 
336
387
  /**
337
388
  * Returns object representation of an instance
338
389
  * @return {Object} Object representation of an instance
339
390
  */
340
- toObject: function() {
341
- var object = { type: this.type }, mainP = this.mainParameter;
342
- if (mainP) {
343
- object[mainP] = this[mainP];
344
- }
345
- return object;
346
- },
391
+ toObject() {
392
+ const mainP = this.mainParameter;
393
+ return {
394
+ type: this.type,
395
+ ...(mainP ? { [mainP]: this[mainP] } : {}),
396
+ };
397
+ }
347
398
 
348
399
  /**
349
400
  * Returns a JSON representation of an instance
350
401
  * @return {Object} JSON
351
402
  */
352
- toJSON: function() {
403
+ toJSON() {
353
404
  // delegate, not alias
354
405
  return this.toObject();
355
406
  }
356
- });
357
407
 
358
- fabric.Image.filters.BaseFilter.fromObject = function(object, callback) {
359
- var filter = new fabric.Image.filters[object.type](object);
360
- callback && callback(filter);
361
- return filter;
362
- };
408
+ static async fromObject(
409
+ { type, ...filterOptions }: Record<string, any>,
410
+ options: Abortable
411
+ ) {
412
+ return new this(filterOptions);
413
+ }
414
+ }