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
@@ -0,0 +1,186 @@
1
+ import type { TClassProperties } from '../typedefs';
2
+ import { BaseFilter } from './BaseFilter';
3
+ import type { T2DPipelineState, TWebGLUniformLocationMap } from './typedefs';
4
+ import { classRegistry } from '../ClassRegistry';
5
+ import { fragmentSource } from './shaders/convolute';
6
+
7
+ export const convoluteDefaultValues: Partial<TClassProperties<Convolute>> = {
8
+ opaque: false,
9
+ matrix: [0, 0, 0, 0, 1, 0, 0, 0, 0],
10
+ };
11
+
12
+ /**
13
+ * Adapted from <a href="http://www.html5rocks.com/en/tutorials/canvas/imagefilters/">html5rocks article</a>
14
+ * @example <caption>Sharpen filter</caption>
15
+ * const filter = new Convolute({
16
+ * matrix: [ 0, -1, 0,
17
+ * -1, 5, -1,
18
+ * 0, -1, 0 ]
19
+ * });
20
+ * object.filters.push(filter);
21
+ * object.applyFilters();
22
+ * canvas.renderAll();
23
+ * @example <caption>Blur filter</caption>
24
+ * const filter = new Convolute({
25
+ * matrix: [ 1/9, 1/9, 1/9,
26
+ * 1/9, 1/9, 1/9,
27
+ * 1/9, 1/9, 1/9 ]
28
+ * });
29
+ * object.filters.push(filter);
30
+ * object.applyFilters();
31
+ * canvas.renderAll();
32
+ * @example <caption>Emboss filter</caption>
33
+ * const filter = new Convolute({
34
+ * matrix: [ 1, 1, 1,
35
+ * 1, 0.7, -1,
36
+ * -1, -1, -1 ]
37
+ * });
38
+ * object.filters.push(filter);
39
+ * object.applyFilters();
40
+ * canvas.renderAll();
41
+ * @example <caption>Emboss filter with opaqueness</caption>
42
+ * const filter = new Convolute({
43
+ * opaque: true,
44
+ * matrix: [ 1, 1, 1,
45
+ * 1, 0.7, -1,
46
+ * -1, -1, -1 ]
47
+ * });
48
+ * object.filters.push(filter);
49
+ * object.applyFilters();
50
+ * canvas.renderAll();
51
+ */
52
+ export class Convolute extends BaseFilter {
53
+ /*
54
+ * Opaque value (true/false)
55
+ */
56
+ declare opaque: boolean;
57
+
58
+ /*
59
+ * matrix for the filter, max 9x9
60
+ */
61
+ declare matrix: number[];
62
+
63
+ static type = 'Convolute';
64
+
65
+ static defaults = convoluteDefaultValues;
66
+
67
+ getCacheKey() {
68
+ return `${this.type}_${Math.sqrt(this.matrix.length)}_${
69
+ this.opaque ? 1 : 0
70
+ }` as keyof typeof fragmentSource;
71
+ }
72
+
73
+ getFragmentSource() {
74
+ return fragmentSource[this.getCacheKey()];
75
+ }
76
+
77
+ /**
78
+ * Apply the Brightness operation to a Uint8ClampedArray representing the pixels of an image.
79
+ *
80
+ * @param {Object} options
81
+ * @param {ImageData} options.imageData The Uint8ClampedArray to be filtered.
82
+ */
83
+ applyTo2d(options: T2DPipelineState) {
84
+ const imageData = options.imageData,
85
+ data = imageData.data,
86
+ weights = this.matrix,
87
+ side = Math.round(Math.sqrt(weights.length)),
88
+ halfSide = Math.floor(side / 2),
89
+ sw = imageData.width,
90
+ sh = imageData.height,
91
+ output = options.ctx.createImageData(sw, sh),
92
+ dst = output.data,
93
+ // go through the destination image pixels
94
+ alphaFac = this.opaque ? 1 : 0;
95
+ let r, g, b, a, dstOff, scx, scy, srcOff, wt, x, y, cx, cy;
96
+
97
+ for (y = 0; y < sh; y++) {
98
+ for (x = 0; x < sw; x++) {
99
+ dstOff = (y * sw + x) * 4;
100
+ // calculate the weighed sum of the source image pixels that
101
+ // fall under the convolution matrix
102
+ r = 0;
103
+ g = 0;
104
+ b = 0;
105
+ a = 0;
106
+
107
+ for (cy = 0; cy < side; cy++) {
108
+ for (cx = 0; cx < side; cx++) {
109
+ scy = y + cy - halfSide;
110
+ scx = x + cx - halfSide;
111
+
112
+ // eslint-disable-next-line max-depth
113
+ if (scy < 0 || scy >= sh || scx < 0 || scx >= sw) {
114
+ continue;
115
+ }
116
+
117
+ srcOff = (scy * sw + scx) * 4;
118
+ wt = weights[cy * side + cx];
119
+
120
+ r += data[srcOff] * wt;
121
+ g += data[srcOff + 1] * wt;
122
+ b += data[srcOff + 2] * wt;
123
+ // eslint-disable-next-line max-depth
124
+ if (!alphaFac) {
125
+ a += data[srcOff + 3] * wt;
126
+ }
127
+ }
128
+ }
129
+ dst[dstOff] = r;
130
+ dst[dstOff + 1] = g;
131
+ dst[dstOff + 2] = b;
132
+ if (!alphaFac) {
133
+ dst[dstOff + 3] = a;
134
+ } else {
135
+ dst[dstOff + 3] = data[dstOff + 3];
136
+ }
137
+ }
138
+ }
139
+ options.imageData = output;
140
+ }
141
+
142
+ /**
143
+ * Return WebGL uniform locations for this filter's shader.
144
+ *
145
+ * @param {WebGLRenderingContext} gl The GL canvas context used to compile this filter's shader.
146
+ * @param {WebGLShaderProgram} program This filter's compiled shader program.
147
+ */
148
+ getUniformLocations(
149
+ gl: WebGLRenderingContext,
150
+ program: WebGLProgram
151
+ ): TWebGLUniformLocationMap {
152
+ return {
153
+ uMatrix: gl.getUniformLocation(program, 'uMatrix'),
154
+ uOpaque: gl.getUniformLocation(program, 'uOpaque'),
155
+ uHalfSize: gl.getUniformLocation(program, 'uHalfSize'),
156
+ uSize: gl.getUniformLocation(program, 'uSize'),
157
+ };
158
+ }
159
+
160
+ /**
161
+ * Send data from this filter to its shader program's uniforms.
162
+ *
163
+ * @param {WebGLRenderingContext} gl The GL canvas context used to compile this filter's shader.
164
+ * @param {Object} uniformLocations A map of string uniform names to WebGLUniformLocation objects
165
+ */
166
+ sendUniformData(
167
+ gl: WebGLRenderingContext,
168
+ uniformLocations: TWebGLUniformLocationMap
169
+ ) {
170
+ gl.uniform1fv(uniformLocations.uMatrix, this.matrix);
171
+ }
172
+
173
+ /**
174
+ * Returns object representation of an instance
175
+ * @return {Object} Object representation of an instance
176
+ */
177
+ toObject() {
178
+ return {
179
+ ...super.toObject(),
180
+ opaque: this.opaque,
181
+ matrix: [...this.matrix],
182
+ };
183
+ }
184
+ }
185
+
186
+ classRegistry.setClass(Convolute);
@@ -0,0 +1,38 @@
1
+ import { config } from '../config';
2
+ import { getEnv } from '../env';
3
+ import { createCanvasElement } from '../util/misc/dom';
4
+ import { Canvas2dFilterBackend } from './Canvas2dFilterBackend';
5
+ import { WebGLFilterBackend } from './WebGLFilterBackend';
6
+
7
+ export type FilterBackend = WebGLFilterBackend | Canvas2dFilterBackend;
8
+
9
+ let filterBackend: FilterBackend;
10
+
11
+ /**
12
+ * Verifies if it is possible to initialize webgl or fallback on a canvas2d filtering backend
13
+ */
14
+ export function initFilterBackend(): FilterBackend {
15
+ const { WebGLProbe } = getEnv();
16
+ WebGLProbe.queryWebGL(createCanvasElement());
17
+ if (config.enableGLFiltering && WebGLProbe.isSupported(config.textureSize)) {
18
+ return new WebGLFilterBackend({ tileSize: config.textureSize });
19
+ } else {
20
+ return new Canvas2dFilterBackend();
21
+ }
22
+ }
23
+
24
+ /**
25
+ * Get the current fabricJS filter backend or initialize one if not available yet
26
+ * @param [strict] pass `true` to create the backend if it wasn't created yet (default behavior),
27
+ * pass `false` to get the backend ref without mutating it
28
+ */
29
+ export function getFilterBackend(strict = true): FilterBackend {
30
+ if (!filterBackend && strict) {
31
+ filterBackend = initFilterBackend();
32
+ }
33
+ return filterBackend;
34
+ }
35
+
36
+ export function setFilterBackend(backend: FilterBackend) {
37
+ filterBackend = backend;
38
+ }
@@ -0,0 +1,7 @@
1
+ export type GLPrecision = 'lowp' | 'mediump' | 'highp';
2
+
3
+ export abstract class GLProbe {
4
+ declare GLPrecision: GLPrecision | undefined;
5
+ abstract queryWebGL(canvas: HTMLCanvasElement): void;
6
+ abstract isSupported(textureSize: number): boolean;
7
+ }
@@ -0,0 +1,15 @@
1
+ import { GLProbe } from './GLProbe';
2
+
3
+ /**
4
+ * @todo GL rendering in node is possible:
5
+ * - https://github.com/stackgl/headless-gl
6
+ * - https://github.com/akira-cn/node-canvas-webgl
7
+ */
8
+ export class NodeGLProbe extends GLProbe {
9
+ queryWebGL() {
10
+ // noop
11
+ }
12
+ isSupported() {
13
+ return false;
14
+ }
15
+ }
@@ -0,0 +1,47 @@
1
+ import { GLProbe } from './GLProbe';
2
+ import type { GLPrecision } from './GLProbe';
3
+
4
+ /**
5
+ * Lazy initialize WebGL constants
6
+ */
7
+ export class WebGLProbe extends GLProbe {
8
+ declare maxTextureSize?: number;
9
+
10
+ /**
11
+ * Tests if webgl supports certain precision
12
+ * @param {WebGL} Canvas WebGL context to test on
13
+ * @param {GLPrecision} Precision to test can be any of following
14
+ * @returns {Boolean} Whether the user's browser WebGL supports given precision.
15
+ */
16
+ private testPrecision(
17
+ gl: WebGLRenderingContext,
18
+ precision: GLPrecision
19
+ ): boolean {
20
+ const fragmentSource = `precision ${precision} float;\nvoid main(){}`;
21
+ const fragmentShader = gl.createShader(gl.FRAGMENT_SHADER);
22
+ if (!fragmentShader) {
23
+ return false;
24
+ }
25
+ gl.shaderSource(fragmentShader, fragmentSource);
26
+ gl.compileShader(fragmentShader);
27
+ return !!gl.getShaderParameter(fragmentShader, gl.COMPILE_STATUS);
28
+ }
29
+
30
+ /**
31
+ * query browser for WebGL
32
+ */
33
+ queryWebGL(canvas: HTMLCanvasElement) {
34
+ const gl = canvas.getContext('webgl');
35
+ if (gl) {
36
+ this.maxTextureSize = gl.getParameter(gl.MAX_TEXTURE_SIZE);
37
+ this.GLPrecision = (['highp', 'mediump', 'lowp'] as const).find(
38
+ (precision) => this.testPrecision(gl, precision)
39
+ );
40
+ console.log(`fabric: max texture size ${this.maxTextureSize}`);
41
+ }
42
+ }
43
+
44
+ isSupported(textureSize: number) {
45
+ return !!this.maxTextureSize && this.maxTextureSize >= textureSize;
46
+ }
47
+ }
@@ -0,0 +1,112 @@
1
+ import type { TClassProperties } from '../typedefs';
2
+ import { BaseFilter } from './BaseFilter';
3
+ import type { T2DPipelineState, TWebGLUniformLocationMap } from './typedefs';
4
+ import { classRegistry } from '../ClassRegistry';
5
+ import { fragmentSource } from './shaders/gamma';
6
+ export type GammaInput = [number, number, number];
7
+
8
+ export const gammaDefaultValues: Partial<TClassProperties<Gamma>> = {
9
+ mainParameter: 'gamma',
10
+ gamma: [1, 1, 1],
11
+ };
12
+
13
+ /**
14
+ * Gamma filter class
15
+ * @example
16
+ * const filter = new Gamma({
17
+ * gamma: [1, 0.5, 2.1]
18
+ * });
19
+ * object.filters.push(filter);
20
+ * object.applyFilters();
21
+ */
22
+ export class Gamma extends BaseFilter {
23
+ /**
24
+ * Gamma array value, from 0.01 to 2.2.
25
+ * @param {Array} gamma
26
+ * @default
27
+ */
28
+ declare gamma: GammaInput;
29
+ declare rgbValues?: {
30
+ r: Uint8Array;
31
+ g: Uint8Array;
32
+ b: Uint8Array;
33
+ };
34
+
35
+ static type = 'Gamma';
36
+
37
+ static defaults = gammaDefaultValues;
38
+
39
+ getFragmentSource() {
40
+ return fragmentSource;
41
+ }
42
+
43
+ constructor({ gamma = [1, 1, 1], ...options }: { gamma?: GammaInput } = {}) {
44
+ super(options);
45
+ this.gamma = gamma;
46
+ }
47
+
48
+ /**
49
+ * Apply the Gamma operation to a Uint8Array representing the pixels of an image.
50
+ *
51
+ * @param {Object} options
52
+ * @param {ImageData} options.imageData The Uint8Array to be filtered.
53
+ */
54
+ applyTo2d({ imageData: { data } }: T2DPipelineState) {
55
+ const gamma = this.gamma,
56
+ rInv = 1 / gamma[0],
57
+ gInv = 1 / gamma[1],
58
+ bInv = 1 / gamma[2];
59
+
60
+ if (!this.rgbValues) {
61
+ this.rgbValues = {
62
+ r: new Uint8Array(256),
63
+ g: new Uint8Array(256),
64
+ b: new Uint8Array(256),
65
+ };
66
+ }
67
+
68
+ // This is an optimization - pre-compute a look-up table for each color channel
69
+ // instead of performing these pow calls for each pixel in the image.
70
+ const rgb = this.rgbValues;
71
+ for (let i = 0; i < 256; i++) {
72
+ rgb.r[i] = Math.pow(i / 255, rInv) * 255;
73
+ rgb.g[i] = Math.pow(i / 255, gInv) * 255;
74
+ rgb.b[i] = Math.pow(i / 255, bInv) * 255;
75
+ }
76
+ for (let i = 0; i < data.length; i += 4) {
77
+ data[i] = rgb.r[data[i]];
78
+ data[i + 1] = rgb.g[data[i + 1]];
79
+ data[i + 2] = rgb.b[data[i + 2]];
80
+ }
81
+ }
82
+
83
+ /**
84
+ * Return WebGL uniform locations for this filter's shader.
85
+ *
86
+ * @param {WebGLRenderingContext} gl The GL canvas context used to compile this filter's shader.
87
+ * @param {WebGLShaderProgram} program This filter's compiled shader program.
88
+ */
89
+ getUniformLocations(
90
+ gl: WebGLRenderingContext,
91
+ program: WebGLProgram
92
+ ): TWebGLUniformLocationMap {
93
+ return {
94
+ uGamma: gl.getUniformLocation(program, 'uGamma'),
95
+ };
96
+ }
97
+
98
+ /**
99
+ * Send data from this filter to its shader program's uniforms.
100
+ *
101
+ * @param {WebGLRenderingContext} gl The GL canvas context used to compile this filter's shader.
102
+ * @param {Object} uniformLocations A map of string uniform names to WebGLUniformLocation objects
103
+ */
104
+ sendUniformData(
105
+ gl: WebGLRenderingContext,
106
+ uniformLocations: TWebGLUniformLocationMap
107
+ ) {
108
+ gl.uniform3fv(uniformLocations.uGamma, this.gamma);
109
+ }
110
+ }
111
+
112
+ classRegistry.setClass(Gamma);
@@ -0,0 +1,104 @@
1
+ import type { TClassProperties } from '../typedefs';
2
+ import { BaseFilter } from './BaseFilter';
3
+ import type { T2DPipelineState, TWebGLUniformLocationMap } from './typedefs';
4
+ import { classRegistry } from '../ClassRegistry';
5
+ import { fragmentSource } from './shaders/grayscale';
6
+
7
+ export type TGrayscaleMode = 'average' | 'lightness' | 'luminosity';
8
+
9
+ export const grayscaleDefaultValues: Partial<TClassProperties<Grayscale>> = {
10
+ mode: 'average',
11
+ mainParameter: 'mode',
12
+ };
13
+
14
+ /**
15
+ * Grayscale image filter class
16
+ * @example
17
+ * const filter = new Grayscale();
18
+ * object.filters.push(filter);
19
+ * object.applyFilters();
20
+ */
21
+ export class Grayscale extends BaseFilter {
22
+ declare mode: TGrayscaleMode;
23
+
24
+ static type = 'Grayscale';
25
+
26
+ static defaults = grayscaleDefaultValues;
27
+
28
+ /**
29
+ * Apply the Grayscale operation to a Uint8Array representing the pixels of an image.
30
+ *
31
+ * @param {Object} options
32
+ * @param {ImageData} options.imageData The Uint8Array to be filtered.
33
+ */
34
+ applyTo2d({ imageData: { data } }: T2DPipelineState) {
35
+ for (let i = 0, value: number; i < data.length; i += 4) {
36
+ switch (this.mode) {
37
+ case 'average':
38
+ value = (data[i] + data[i + 1] + data[i + 2]) / 3;
39
+ break;
40
+ case 'lightness':
41
+ value =
42
+ (Math.min(data[i], data[i + 1], data[i + 2]) +
43
+ Math.max(data[i], data[i + 1], data[i + 2])) /
44
+ 2;
45
+ break;
46
+ case 'luminosity':
47
+ value = 0.21 * data[i] + 0.72 * data[i + 1] + 0.07 * data[i + 2];
48
+ break;
49
+ }
50
+
51
+ data[i] = value;
52
+ data[i + 1] = value;
53
+ data[i + 2] = value;
54
+ }
55
+ }
56
+
57
+ getCacheKey() {
58
+ return `${this.type}_${this.mode}`;
59
+ }
60
+
61
+ getFragmentSource() {
62
+ return fragmentSource[this.mode];
63
+ }
64
+
65
+ /**
66
+ * Return WebGL uniform locations for this filter's shader.
67
+ *
68
+ * @param {WebGLRenderingContext} gl The GL canvas context used to compile this filter's shader.
69
+ * @param {WebGLShaderProgram} program This filter's compiled shader program.
70
+ */
71
+ getUniformLocations(
72
+ gl: WebGLRenderingContext,
73
+ program: WebGLProgram
74
+ ): TWebGLUniformLocationMap {
75
+ return {
76
+ uMode: gl.getUniformLocation(program, 'uMode'),
77
+ };
78
+ }
79
+
80
+ /**
81
+ * Send data from this filter to its shader program's uniforms.
82
+ *
83
+ * @param {WebGLRenderingContext} gl The GL canvas context used to compile this filter's shader.
84
+ * @param {Object} uniformLocations A map of string uniform names to WebGLUniformLocation objects
85
+ */
86
+ sendUniformData(
87
+ gl: WebGLRenderingContext,
88
+ uniformLocations: TWebGLUniformLocationMap
89
+ ) {
90
+ const mode = 1;
91
+ gl.uniform1i(uniformLocations.uMode, mode);
92
+ }
93
+
94
+ /**
95
+ * Grayscale filter isNeutralState implementation
96
+ * The filter is never neutral
97
+ * on the image
98
+ **/
99
+ isNeutralState() {
100
+ return false;
101
+ }
102
+ }
103
+
104
+ classRegistry.setClass(Grayscale);
@@ -0,0 +1,64 @@
1
+ import type { TClassProperties } from '../typedefs';
2
+ import { cos } from '../util/misc/cos';
3
+ import { sin } from '../util/misc/sin';
4
+ import { ColorMatrix } from './ColorMatrix';
5
+ import type { TWebGLPipelineState, T2DPipelineState } from './typedefs';
6
+ import { classRegistry } from '../ClassRegistry';
7
+
8
+ export const hueRotationDefaultValues: Partial<TClassProperties<HueRotation>> =
9
+ {
10
+ rotation: 0,
11
+ mainParameter: 'rotation',
12
+ };
13
+
14
+ /**
15
+ * HueRotation filter class
16
+ * @example
17
+ * const filter = new HueRotation({
18
+ * rotation: -0.5
19
+ * });
20
+ * object.filters.push(filter);
21
+ * object.applyFilters();
22
+ */
23
+ // @ts-expect-error some babbling about mainParameter
24
+ export class HueRotation extends ColorMatrix {
25
+ /**
26
+ * HueRotation value, from -1 to 1.
27
+ */
28
+ declare rotation: number;
29
+
30
+ static type = 'HueRotation';
31
+
32
+ static defaults = hueRotationDefaultValues;
33
+
34
+ calculateMatrix() {
35
+ const rad = this.rotation * Math.PI,
36
+ cosine = cos(rad),
37
+ sine = sin(rad),
38
+ aThird = 1 / 3,
39
+ aThirdSqtSin = Math.sqrt(aThird) * sine,
40
+ OneMinusCos = 1 - cosine;
41
+ this.matrix = [1, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 1, 0];
42
+ this.matrix[0] = cosine + OneMinusCos / 3;
43
+ this.matrix[1] = aThird * OneMinusCos - aThirdSqtSin;
44
+ this.matrix[2] = aThird * OneMinusCos + aThirdSqtSin;
45
+ this.matrix[5] = aThird * OneMinusCos + aThirdSqtSin;
46
+ this.matrix[6] = cosine + aThird * OneMinusCos;
47
+ this.matrix[7] = aThird * OneMinusCos - aThirdSqtSin;
48
+ this.matrix[10] = aThird * OneMinusCos - aThirdSqtSin;
49
+ this.matrix[11] = aThird * OneMinusCos + aThirdSqtSin;
50
+ this.matrix[12] = cosine + aThird * OneMinusCos;
51
+ }
52
+
53
+ isNeutralState() {
54
+ this.calculateMatrix();
55
+ return super.isNeutralState();
56
+ }
57
+
58
+ applyTo(options: TWebGLPipelineState | T2DPipelineState) {
59
+ this.calculateMatrix();
60
+ super.applyTo(options);
61
+ }
62
+ }
63
+
64
+ classRegistry.setClass(HueRotation);
@@ -0,0 +1,101 @@
1
+ import type { TClassProperties } from '../typedefs';
2
+ import { BaseFilter } from './BaseFilter';
3
+ import type { T2DPipelineState, TWebGLUniformLocationMap } from './typedefs';
4
+ import { classRegistry } from '../ClassRegistry';
5
+ import { fragmentSource } from './shaders/invert';
6
+
7
+ export const invertDefaultValues: Partial<TClassProperties<Invert>> = {
8
+ alpha: false,
9
+ invert: true,
10
+ mainParameter: 'invert',
11
+ };
12
+
13
+ /**
14
+ * @example
15
+ * const filter = new Invert();
16
+ * object.filters.push(filter);
17
+ * object.applyFilters(canvas.renderAll.bind(canvas));
18
+ */
19
+ export class Invert extends BaseFilter {
20
+ /**
21
+ * Invert also alpha.
22
+ * @param {Boolean} alpha
23
+ * @default
24
+ **/
25
+ declare alpha: boolean;
26
+
27
+ /**
28
+ * Filter invert. if false, does nothing
29
+ * @param {Boolean} invert
30
+ * @default
31
+ */
32
+ declare invert: boolean;
33
+
34
+ static type = 'Invert';
35
+
36
+ static defaults = invertDefaultValues;
37
+
38
+ /**
39
+ * Apply the Invert operation to a Uint8Array representing the pixels of an image.
40
+ *
41
+ * @param {Object} options
42
+ * @param {ImageData} options.imageData The Uint8Array to be filtered.
43
+ */
44
+ applyTo2d({ imageData: { data } }: T2DPipelineState) {
45
+ for (let i = 0; i < data.length; i += 4) {
46
+ data[i] = 255 - data[i];
47
+ data[i + 1] = 255 - data[i + 1];
48
+ data[i + 2] = 255 - data[i + 2];
49
+
50
+ if (this.alpha) {
51
+ data[i + 3] = 255 - data[i + 3];
52
+ }
53
+ }
54
+ }
55
+
56
+ protected getFragmentSource(): string {
57
+ return fragmentSource;
58
+ }
59
+
60
+ /**
61
+ * Invert filter isNeutralState implementation
62
+ * Used only in image applyFilters to discard filters that will not have an effect
63
+ * on the image
64
+ * @param {Object} options
65
+ **/
66
+ isNeutralState() {
67
+ return !this.invert;
68
+ }
69
+
70
+ /**
71
+ * Return WebGL uniform locations for this filter's shader.
72
+ *
73
+ * @param {WebGLRenderingContext} gl The GL canvas context used to compile this filter's shader.
74
+ * @param {WebGLShaderProgram} program This filter's compiled shader program.
75
+ */
76
+ getUniformLocations(
77
+ gl: WebGLRenderingContext,
78
+ program: WebGLProgram
79
+ ): TWebGLUniformLocationMap {
80
+ return {
81
+ uInvert: gl.getUniformLocation(program, 'uInvert'),
82
+ uAlpha: gl.getUniformLocation(program, 'uAlpha'),
83
+ };
84
+ }
85
+
86
+ /**
87
+ * Send data from this filter to its shader program's uniforms.
88
+ *
89
+ * @param {WebGLRenderingContext} gl The GL canvas context used to compile this filter's shader.
90
+ * @param {Object} uniformLocations A map of string uniform names to WebGLUniformLocation objects
91
+ */
92
+ sendUniformData(
93
+ gl: WebGLRenderingContext,
94
+ uniformLocations: TWebGLUniformLocationMap
95
+ ) {
96
+ gl.uniform1i(uniformLocations.uInvert, Number(this.invert));
97
+ gl.uniform1i(uniformLocations.uAlpha, Number(this.alpha));
98
+ }
99
+ }
100
+
101
+ classRegistry.setClass(Invert);