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,219 @@
1
+ import { Color } from '../color/Color';
2
+ import type { TClassProperties } from '../typedefs';
3
+ import { BaseFilter } from './BaseFilter';
4
+ import type { T2DPipelineState, TWebGLUniformLocationMap } from './typedefs';
5
+ import { classRegistry } from '../ClassRegistry';
6
+ import { blendColorFragmentSource } from './shaders/blendColor';
7
+
8
+ type TBlendMode =
9
+ | 'multiply'
10
+ | 'add'
11
+ | 'difference'
12
+ | 'screen'
13
+ | 'subtract'
14
+ | 'darken'
15
+ | 'lighten'
16
+ | 'overlay'
17
+ | 'exclusion'
18
+ | 'tint';
19
+
20
+ export const blendColorDefaultValues: Partial<TClassProperties<BlendColor>> = {
21
+ color: '#F95C63',
22
+ mode: 'multiply',
23
+ alpha: 1,
24
+ };
25
+
26
+ /**
27
+ * Color Blend filter class
28
+ * @example
29
+ * const filter = new BlendColor({
30
+ * color: '#000',
31
+ * mode: 'multiply'
32
+ * });
33
+ *
34
+ * const filter = new BlendImage({
35
+ * image: fabricImageObject,
36
+ * mode: 'multiply',
37
+ * alpha: 0.5
38
+ * });
39
+ * object.filters.push(filter);
40
+ * object.applyFilters();
41
+ * canvas.renderAll();
42
+ */
43
+ export class BlendColor extends BaseFilter {
44
+ /**
45
+ * Color to make the blend operation with. default to a reddish color since black or white
46
+ * gives always strong result.
47
+ * @type String
48
+ * @default
49
+ **/
50
+ declare color: string;
51
+
52
+ /**
53
+ * Blend mode for the filter: one of multiply, add, difference, screen, subtract,
54
+ * darken, lighten, overlay, exclusion, tint.
55
+ * @type String
56
+ * @default
57
+ **/
58
+ declare mode: TBlendMode;
59
+
60
+ /**
61
+ * alpha value. represent the strength of the blend color operation.
62
+ * @type Number
63
+ * @default
64
+ **/
65
+ declare alpha: number;
66
+
67
+ static defaults = blendColorDefaultValues;
68
+
69
+ static type = 'BlendColor';
70
+
71
+ getCacheKey() {
72
+ return `${this.type}_${this.mode}`;
73
+ }
74
+
75
+ protected getFragmentSource(): string {
76
+ return `
77
+ precision highp float;
78
+ uniform sampler2D uTexture;
79
+ uniform vec4 uColor;
80
+ varying vec2 vTexCoord;
81
+ void main() {
82
+ vec4 color = texture2D(uTexture, vTexCoord);
83
+ gl_FragColor = color;
84
+ if (color.a > 0.0) {
85
+ ${blendColorFragmentSource[this.mode]}
86
+ }
87
+ }
88
+ `;
89
+ }
90
+
91
+ /**
92
+ * Apply the Blend operation to a Uint8ClampedArray representing the pixels of an image.
93
+ *
94
+ * @param {Object} options
95
+ * @param {ImageData} options.imageData The Uint8ClampedArray to be filtered.
96
+ */
97
+ applyTo2d({ imageData: { data } }: T2DPipelineState) {
98
+ const source = new Color(this.color).getSource();
99
+ const tr = source[0] * this.alpha;
100
+ const tg = source[1] * this.alpha;
101
+ const tb = source[2] * this.alpha;
102
+ const alpha1 = 1 - this.alpha;
103
+
104
+ for (let i = 0; i < data.length; i += 4) {
105
+ const r = data[i];
106
+ const g = data[i + 1];
107
+ const b = data[i + 2];
108
+
109
+ switch (this.mode) {
110
+ case 'multiply':
111
+ data[i] = (r * tr) / 255;
112
+ data[i + 1] = (g * tg) / 255;
113
+ data[i + 2] = (b * tb) / 255;
114
+ break;
115
+ case 'screen':
116
+ data[i] = 255 - ((255 - r) * (255 - tr)) / 255;
117
+ data[i + 1] = 255 - ((255 - g) * (255 - tg)) / 255;
118
+ data[i + 2] = 255 - ((255 - b) * (255 - tb)) / 255;
119
+ break;
120
+ case 'add':
121
+ data[i] = r + tr;
122
+ data[i + 1] = g + tg;
123
+ data[i + 2] = b + tb;
124
+ break;
125
+ case 'difference':
126
+ data[i] = Math.abs(r - tr);
127
+ data[i + 1] = Math.abs(g - tg);
128
+ data[i + 2] = Math.abs(b - tb);
129
+ break;
130
+ case 'subtract':
131
+ data[i] = r - tr;
132
+ data[i + 1] = g - tg;
133
+ data[i + 2] = b - tb;
134
+ break;
135
+ case 'darken':
136
+ data[i] = Math.min(r, tr);
137
+ data[i + 1] = Math.min(g, tg);
138
+ data[i + 2] = Math.min(b, tb);
139
+ break;
140
+ case 'lighten':
141
+ data[i] = Math.max(r, tr);
142
+ data[i + 1] = Math.max(g, tg);
143
+ data[i + 2] = Math.max(b, tb);
144
+ break;
145
+ case 'overlay':
146
+ data[i] =
147
+ tr < 128
148
+ ? (2 * r * tr) / 255
149
+ : 255 - (2 * (255 - r) * (255 - tr)) / 255;
150
+ data[i + 1] =
151
+ tg < 128
152
+ ? (2 * g * tg) / 255
153
+ : 255 - (2 * (255 - g) * (255 - tg)) / 255;
154
+ data[i + 2] =
155
+ tb < 128
156
+ ? (2 * b * tb) / 255
157
+ : 255 - (2 * (255 - b) * (255 - tb)) / 255;
158
+ break;
159
+ case 'exclusion':
160
+ data[i] = tr + r - (2 * tr * r) / 255;
161
+ data[i + 1] = tg + g - (2 * tg * g) / 255;
162
+ data[i + 2] = tb + b - (2 * tb * b) / 255;
163
+ break;
164
+ case 'tint':
165
+ data[i] = tr + r * alpha1;
166
+ data[i + 1] = tg + g * alpha1;
167
+ data[i + 2] = tb + b * alpha1;
168
+ }
169
+ }
170
+ }
171
+
172
+ /**
173
+ * Return WebGL uniform locations for this filter's shader.
174
+ *
175
+ * @param {WebGLRenderingContext} gl The GL canvas context used to compile this filter's shader.
176
+ * @param {WebGLShaderProgram} program This filter's compiled shader program.
177
+ */
178
+ getUniformLocations(
179
+ gl: WebGLRenderingContext,
180
+ program: WebGLProgram
181
+ ): TWebGLUniformLocationMap {
182
+ return {
183
+ uColor: gl.getUniformLocation(program, 'uColor'),
184
+ };
185
+ }
186
+
187
+ /**
188
+ * Send data from this filter to its shader program's uniforms.
189
+ *
190
+ * @param {WebGLRenderingContext} gl The GL canvas context used to compile this filter's shader.
191
+ * @param {Object} uniformLocations A map of string uniform names to WebGLUniformLocation objects
192
+ */
193
+ sendUniformData(
194
+ gl: WebGLRenderingContext,
195
+ uniformLocations: TWebGLUniformLocationMap
196
+ ) {
197
+ const source = new Color(this.color).getSource();
198
+ source[0] = (this.alpha * source[0]) / 255;
199
+ source[1] = (this.alpha * source[1]) / 255;
200
+ source[2] = (this.alpha * source[2]) / 255;
201
+ source[3] = this.alpha;
202
+ gl.uniform4fv(uniformLocations.uColor, source);
203
+ }
204
+
205
+ /**
206
+ * Returns object representation of an instance
207
+ * @return {Object} Object representation of an instance
208
+ */
209
+ toObject() {
210
+ return {
211
+ type: this.type,
212
+ color: this.color,
213
+ mode: this.mode,
214
+ alpha: this.alpha,
215
+ };
216
+ }
217
+ }
218
+
219
+ classRegistry.setClass(BlendColor);
@@ -0,0 +1,230 @@
1
+ import { Image } from '../shapes/Image';
2
+ import type { TClassProperties } from '../typedefs';
3
+ import { createCanvasElement } from '../util/misc/dom';
4
+ import { BaseFilter } from './BaseFilter';
5
+ import type {
6
+ T2DPipelineState,
7
+ TWebGLPipelineState,
8
+ TWebGLUniformLocationMap,
9
+ } from './typedefs';
10
+ import type { WebGLFilterBackend } from './WebGLFilterBackend';
11
+ import { classRegistry } from '../ClassRegistry';
12
+ import { fragmentSource } from './shaders/blendImage';
13
+
14
+ export type TBlendImageMode = 'multiply' | 'mask';
15
+
16
+ export const blendImageDefaultValues: Partial<TClassProperties<BlendImage>> = {
17
+ mode: 'multiply',
18
+ alpha: 1,
19
+ vertexSource: `
20
+ attribute vec2 aPosition;
21
+ varying vec2 vTexCoord;
22
+ varying vec2 vTexCoord2;
23
+ uniform mat3 uTransformMatrix;
24
+ void main() {
25
+ vTexCoord = aPosition;
26
+ vTexCoord2 = (uTransformMatrix * vec3(aPosition, 1.0)).xy;
27
+ gl_Position = vec4(aPosition * 2.0 - 1.0, 0.0, 1.0);
28
+ }
29
+ `,
30
+ };
31
+
32
+ /**
33
+ * Image Blend filter class
34
+ * @example
35
+ * const filter = new filters.BlendColor({
36
+ * color: '#000',
37
+ * mode: 'multiply'
38
+ * });
39
+ *
40
+ * const filter = new BlendImage({
41
+ * image: fabricImageObject,
42
+ * mode: 'multiply',
43
+ * alpha: 0.5
44
+ * });
45
+ * object.filters.push(filter);
46
+ * object.applyFilters();
47
+ * canvas.renderAll();
48
+ */
49
+ export class BlendImage extends BaseFilter {
50
+ /**
51
+ * Color to make the blend operation with. default to a reddish color since black or white
52
+ * gives always strong result.
53
+ **/
54
+ declare image: Image;
55
+
56
+ declare mode: TBlendImageMode;
57
+
58
+ /**
59
+ * alpha value. represent the strength of the blend image operation.
60
+ * not implemented.
61
+ **/
62
+ declare alpha: number;
63
+
64
+ static type = 'BlendImage';
65
+
66
+ static defaults = blendImageDefaultValues;
67
+
68
+ getCacheKey() {
69
+ return `${this.type}_${this.mode}`;
70
+ }
71
+
72
+ getFragmentSource(): string {
73
+ return fragmentSource[this.mode];
74
+ }
75
+
76
+ applyToWebGL(options: TWebGLPipelineState) {
77
+ const gl = options.context,
78
+ texture = this.createTexture(options.filterBackend, this.image);
79
+ this.bindAdditionalTexture(gl, texture!, gl.TEXTURE1);
80
+ super.applyToWebGL(options);
81
+ this.unbindAdditionalTexture(gl, gl.TEXTURE1);
82
+ }
83
+
84
+ createTexture(backend: WebGLFilterBackend, image: Image) {
85
+ return backend.getCachedTexture(image.cacheKey, image.getElement());
86
+ }
87
+
88
+ /**
89
+ * Calculate a transformMatrix to adapt the image to blend over
90
+ * @param {Object} options
91
+ * @param {WebGLRenderingContext} options.context The GL context used for rendering.
92
+ * @param {Object} options.programCache A map of compiled shader programs, keyed by filter type.
93
+ */
94
+ calculateMatrix() {
95
+ const image = this.image,
96
+ { width, height } = image.getElement();
97
+ return [
98
+ 1 / image.scaleX,
99
+ 0,
100
+ 0,
101
+ 0,
102
+ 1 / image.scaleY,
103
+ 0,
104
+ -image.left / width,
105
+ -image.top / height,
106
+ 1,
107
+ ];
108
+ }
109
+
110
+ /**
111
+ * Apply the Blend operation to a Uint8ClampedArray representing the pixels of an image.
112
+ *
113
+ * @param {Object} options
114
+ * @param {ImageData} options.imageData The Uint8ClampedArray to be filtered.
115
+ */
116
+ applyTo2d({
117
+ imageData: { data, width, height },
118
+ filterBackend: { resources },
119
+ }: T2DPipelineState) {
120
+ const image = this.image;
121
+ if (!resources.blendImage) {
122
+ resources.blendImage = createCanvasElement();
123
+ }
124
+ const canvas1 = resources.blendImage;
125
+ const context = canvas1.getContext('2d')!;
126
+ if (canvas1.width !== width || canvas1.height !== height) {
127
+ canvas1.width = width;
128
+ canvas1.height = height;
129
+ } else {
130
+ context.clearRect(0, 0, width, height);
131
+ }
132
+ context.setTransform(
133
+ image.scaleX,
134
+ 0,
135
+ 0,
136
+ image.scaleY,
137
+ image.left,
138
+ image.top
139
+ );
140
+ context.drawImage(image.getElement(), 0, 0, width, height);
141
+ const blendData = context.getImageData(0, 0, width, height).data;
142
+ for (let i = 0; i < data.length; i += 4) {
143
+ const r = data[i];
144
+ const g = data[i + 1];
145
+ const b = data[i + 2];
146
+ const a = data[i + 3];
147
+
148
+ const tr = blendData[i];
149
+ const tg = blendData[i + 1];
150
+ const tb = blendData[i + 2];
151
+ const ta = blendData[i + 3];
152
+
153
+ switch (this.mode) {
154
+ case 'multiply':
155
+ data[i] = (r * tr) / 255;
156
+ data[i + 1] = (g * tg) / 255;
157
+ data[i + 2] = (b * tb) / 255;
158
+ data[i + 3] = (a * ta) / 255;
159
+ break;
160
+ case 'mask':
161
+ data[i + 3] = ta;
162
+ break;
163
+ }
164
+ }
165
+ }
166
+
167
+ /**
168
+ * Return WebGL uniform locations for this filter's shader.
169
+ *
170
+ * @param {WebGLRenderingContext} gl The GL canvas context used to compile this filter's shader.
171
+ * @param {WebGLShaderProgram} program This filter's compiled shader program.
172
+ */
173
+ getUniformLocations(
174
+ gl: WebGLRenderingContext,
175
+ program: WebGLProgram
176
+ ): TWebGLUniformLocationMap {
177
+ return {
178
+ uTransformMatrix: gl.getUniformLocation(program, 'uTransformMatrix'),
179
+ uImage: gl.getUniformLocation(program, 'uImage'),
180
+ };
181
+ }
182
+
183
+ /**
184
+ * Send data from this filter to its shader program's uniforms.
185
+ *
186
+ * @param {WebGLRenderingContext} gl The GL canvas context used to compile this filter's shader.
187
+ * @param {Object} uniformLocations A map of string uniform names to WebGLUniformLocation objects
188
+ */
189
+ sendUniformData(
190
+ gl: WebGLRenderingContext,
191
+ uniformLocations: TWebGLUniformLocationMap
192
+ ) {
193
+ const matrix = this.calculateMatrix();
194
+ gl.uniform1i(uniformLocations.uImage, 1); // texture unit 1.
195
+ gl.uniformMatrix3fv(uniformLocations.uTransformMatrix, false, matrix);
196
+ }
197
+
198
+ /**
199
+ * Returns object representation of an instance
200
+ * @return {Object} Object representation of an instance
201
+ */
202
+ toObject() {
203
+ return {
204
+ type: this.type,
205
+ image: this.image && this.image.toObject(),
206
+ mode: this.mode,
207
+ alpha: this.alpha,
208
+ };
209
+ }
210
+
211
+ /**
212
+ * Create filter instance from an object representation
213
+ * @static
214
+ * @param {object} object Object to create an instance from
215
+ * @param {object} [options]
216
+ * @param {AbortSignal} [options.signal] handle aborting image loading, see https://developer.mozilla.org/en-US/docs/Web/API/AbortController/signal
217
+ * @returns {Promise<BlendImage>}
218
+ */
219
+ static fromObject(
220
+ { type, image, ...filterOptions }: Record<string, any>,
221
+ options: { signal: AbortSignal }
222
+ ) {
223
+ return Image.fromObject(image, options).then(
224
+ (enlivedImage) =>
225
+ new this({ ...filterOptions, image: enlivedImage }) as BaseFilter
226
+ );
227
+ }
228
+ }
229
+
230
+ classRegistry.setClass(BlendImage);
@@ -0,0 +1,181 @@
1
+ import type { TClassProperties } from '../typedefs';
2
+ import { createCanvasElement } from '../util/misc/dom';
3
+ import { BaseFilter } from './BaseFilter';
4
+ import type {
5
+ TWebGLPipelineState,
6
+ T2DPipelineState,
7
+ TWebGLUniformLocationMap,
8
+ } from './typedefs';
9
+ import { isWebGLPipelineState } from './utils';
10
+ import { classRegistry } from '../ClassRegistry';
11
+ import { fragmentSource } from './shaders/blur';
12
+
13
+ export const blurDefaultValues: Partial<TClassProperties<Blur>> = {
14
+ blur: 0,
15
+ mainParameter: 'blur',
16
+ };
17
+
18
+ /**
19
+ * Blur filter class
20
+ * @example
21
+ * const filter = new Blur({
22
+ * blur: 0.5
23
+ * });
24
+ * object.filters.push(filter);
25
+ * object.applyFilters();
26
+ * canvas.renderAll();
27
+ */
28
+ export class Blur extends BaseFilter {
29
+ /**
30
+ * blur value, in percentage of image dimensions.
31
+ * specific to keep the image blur constant at different resolutions
32
+ * range between 0 and 1.
33
+ * @type Number
34
+ * @default
35
+ */
36
+ declare blur: number;
37
+
38
+ declare horizontal: boolean;
39
+ declare aspectRatio: number;
40
+
41
+ static type = 'Blur';
42
+
43
+ static defaults = blurDefaultValues;
44
+
45
+ getFragmentSource(): string {
46
+ return fragmentSource;
47
+ }
48
+
49
+ applyTo(options: TWebGLPipelineState | T2DPipelineState) {
50
+ if (isWebGLPipelineState(options)) {
51
+ // this aspectRatio is used to give the same blur to vertical and horizontal
52
+ this.aspectRatio = options.sourceWidth / options.sourceHeight;
53
+ options.passes++;
54
+ this._setupFrameBuffer(options);
55
+ this.horizontal = true;
56
+ this.applyToWebGL(options);
57
+ this._swapTextures(options);
58
+ this._setupFrameBuffer(options);
59
+ this.horizontal = false;
60
+ this.applyToWebGL(options);
61
+ this._swapTextures(options);
62
+ } else {
63
+ this.applyTo2d(options);
64
+ }
65
+ }
66
+
67
+ applyTo2d(options: T2DPipelineState) {
68
+ options.imageData = this.simpleBlur(options);
69
+ }
70
+
71
+ simpleBlur({
72
+ ctx,
73
+ imageData,
74
+ filterBackend: { resources },
75
+ }: T2DPipelineState) {
76
+ const { width, height } = imageData;
77
+ if (!resources.blurLayer1) {
78
+ resources.blurLayer1 = createCanvasElement();
79
+ resources.blurLayer2 = createCanvasElement();
80
+ }
81
+ const canvas1 = resources.blurLayer1!;
82
+ const canvas2 = resources.blurLayer2!;
83
+ if (canvas1.width !== width || canvas1.height !== height) {
84
+ canvas2.width = canvas1.width = width;
85
+ canvas2.height = canvas1.height = height;
86
+ }
87
+ const ctx1 = canvas1.getContext('2d')!,
88
+ ctx2 = canvas2.getContext('2d')!,
89
+ nSamples = 15,
90
+ blur = this.blur * 0.06 * 0.5;
91
+ let random, percent, j, i;
92
+
93
+ // load first canvas
94
+ ctx1.putImageData(imageData, 0, 0);
95
+ ctx2.clearRect(0, 0, width, height);
96
+
97
+ for (i = -nSamples; i <= nSamples; i++) {
98
+ random = (Math.random() - 0.5) / 4;
99
+ percent = i / nSamples;
100
+ j = blur * percent * width + random;
101
+ ctx2.globalAlpha = 1 - Math.abs(percent);
102
+ ctx2.drawImage(canvas1, j, random);
103
+ ctx1.drawImage(canvas2, 0, 0);
104
+ ctx2.globalAlpha = 1;
105
+ ctx2.clearRect(0, 0, canvas2.width, canvas2.height);
106
+ }
107
+ for (i = -nSamples; i <= nSamples; i++) {
108
+ random = (Math.random() - 0.5) / 4;
109
+ percent = i / nSamples;
110
+ j = blur * percent * height + random;
111
+ ctx2.globalAlpha = 1 - Math.abs(percent);
112
+ ctx2.drawImage(canvas1, random, j);
113
+ ctx1.drawImage(canvas2, 0, 0);
114
+ ctx2.globalAlpha = 1;
115
+ ctx2.clearRect(0, 0, canvas2.width, canvas2.height);
116
+ }
117
+ ctx.drawImage(canvas1, 0, 0);
118
+ const newImageData = ctx.getImageData(0, 0, canvas1.width, canvas1.height);
119
+ ctx1.globalAlpha = 1;
120
+ ctx1.clearRect(0, 0, canvas1.width, canvas1.height);
121
+ return newImageData;
122
+ }
123
+
124
+ /**
125
+ * Return WebGL uniform locations for this filter's shader.
126
+ *
127
+ * @param {WebGLRenderingContext} gl The GL canvas context used to compile this filter's shader.
128
+ * @param {WebGLShaderProgram} program This filter's compiled shader program.
129
+ */
130
+ getUniformLocations(
131
+ gl: WebGLRenderingContext,
132
+ program: WebGLProgram
133
+ ): TWebGLUniformLocationMap {
134
+ return {
135
+ delta: gl.getUniformLocation(program, 'uDelta'),
136
+ };
137
+ }
138
+
139
+ /**
140
+ * Send data from this filter to its shader program's uniforms.
141
+ *
142
+ * @param {WebGLRenderingContext} gl The GL canvas context used to compile this filter's shader.
143
+ * @param {Object} uniformLocations A map of string uniform names to WebGLUniformLocation objects
144
+ */
145
+ sendUniformData(
146
+ gl: WebGLRenderingContext,
147
+ uniformLocations: TWebGLUniformLocationMap
148
+ ) {
149
+ const delta = this.chooseRightDelta();
150
+ gl.uniform2fv(uniformLocations.delta, delta);
151
+ }
152
+
153
+ /**
154
+ * choose right value of image percentage to blur with
155
+ * @returns {Array} a numeric array with delta values
156
+ */
157
+ chooseRightDelta() {
158
+ let blurScale = 1;
159
+ const delta = [0, 0];
160
+ if (this.horizontal) {
161
+ if (this.aspectRatio > 1) {
162
+ // image is wide, i want to shrink radius horizontal
163
+ blurScale = 1 / this.aspectRatio;
164
+ }
165
+ } else {
166
+ if (this.aspectRatio < 1) {
167
+ // image is tall, i want to shrink radius vertical
168
+ blurScale = this.aspectRatio;
169
+ }
170
+ }
171
+ const blur = blurScale * this.blur * 0.12;
172
+ if (this.horizontal) {
173
+ delta[0] = blur;
174
+ } else {
175
+ delta[1] = blur;
176
+ }
177
+ return delta;
178
+ }
179
+ }
180
+
181
+ classRegistry.setClass(Blur);