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,127 @@
1
+ import { iMatrix } from '../../constants';
2
+ import type { Point } from '../../Point';
3
+ import type { FabricObject } from '../../shapes/Object/Object';
4
+ import type { TMat2D } from '../../typedefs';
5
+ import type { StaticCanvas } from '../../canvas/StaticCanvas';
6
+ import { invertTransform, multiplyTransformMatrices } from './matrix';
7
+ import { applyTransformToObject } from './objectTransforms';
8
+
9
+ export type ObjectRelation = 'sibling' | 'child';
10
+
11
+ /**
12
+ * We are actually looking for the transformation from the destination plane to the source plane (change of basis matrix)\
13
+ * The object will exist on the destination plane and we want it to seem unchanged by it so we invert the destination matrix (`to`) and then apply the source matrix (`from`)
14
+ * @param [from]
15
+ * @param [to]
16
+ * @returns
17
+ */
18
+ export const calcPlaneChangeMatrix = (
19
+ from: TMat2D = iMatrix,
20
+ to: TMat2D = iMatrix
21
+ ) => multiplyTransformMatrices(invertTransform(to), from);
22
+
23
+ /**
24
+ * Sends a point from the source coordinate plane to the destination coordinate plane.\
25
+ * From the canvas/viewer's perspective the point remains unchanged.
26
+ *
27
+ * @example <caption>Send point from canvas plane to group plane</caption>
28
+ * var obj = new Rect({ left: 20, top: 20, width: 60, height: 60, strokeWidth: 0 });
29
+ * var group = new Group([obj], { strokeWidth: 0 });
30
+ * var sentPoint1 = sendPointToPlane(new Point(50, 50), undefined, group.calcTransformMatrix());
31
+ * var sentPoint2 = sendPointToPlane(new Point(50, 50), iMatrix, group.calcTransformMatrix());
32
+ * console.log(sentPoint1, sentPoint2) // both points print (0,0) which is the center of group
33
+ *
34
+ * @see {transformPointRelativeToCanvas} for transforming relative to canvas
35
+ * @param {Point} point
36
+ * @param {TMat2D} [from] plane matrix containing object. Passing `undefined` is equivalent to passing the identity matrix, which means `point` exists in the canvas coordinate plane.
37
+ * @param {TMat2D} [to] destination plane matrix to contain object. Passing `undefined` means `point` should be sent to the canvas coordinate plane.
38
+ * @returns {Point} transformed point
39
+ */
40
+ export const sendPointToPlane = (
41
+ point: Point,
42
+ from: TMat2D = iMatrix,
43
+ to: TMat2D = iMatrix
44
+ ): Point =>
45
+ // we are actually looking for the transformation from the destination plane to the source plane (which is a linear mapping)
46
+ // the object will exist on the destination plane and we want it to seem unchanged by it so we reverse the destination matrix (to) and then apply the source matrix (from)
47
+ point.transform(calcPlaneChangeMatrix(from, to));
48
+
49
+ /**
50
+ * Transform point relative to canvas.
51
+ * From the viewport/viewer's perspective the point remains unchanged.
52
+ *
53
+ * `child` relation means `point` exists in the coordinate plane created by `canvas`.
54
+ * In other words point is measured according to canvas' top left corner
55
+ * meaning that if `point` is equal to (0,0) it is positioned at canvas' top left corner.
56
+ *
57
+ * `sibling` relation means `point` exists in the same coordinate plane as canvas.
58
+ * In other words they both relate to the same (0,0) and agree on every point, which is how an event relates to canvas.
59
+ *
60
+ * @param {Point} point
61
+ * @param {StaticCanvas} canvas
62
+ * @param {'sibling'|'child'} relationBefore current relation of point to canvas
63
+ * @param {'sibling'|'child'} relationAfter desired relation of point to canvas
64
+ * @returns {Point} transformed point
65
+ */
66
+ export const transformPointRelativeToCanvas = (
67
+ point: Point,
68
+ canvas: StaticCanvas,
69
+ relationBefore: ObjectRelation,
70
+ relationAfter: ObjectRelation
71
+ ): Point => {
72
+ // is this still needed with TS?
73
+ if (relationBefore !== 'child' && relationBefore !== 'sibling') {
74
+ throw new Error(`fabric.js: received bad argument ${relationBefore}`);
75
+ }
76
+ if (relationAfter !== 'child' && relationAfter !== 'sibling') {
77
+ throw new Error(`fabric.js: received bad argument ${relationAfter}`);
78
+ }
79
+ if (relationBefore === relationAfter) {
80
+ return point;
81
+ }
82
+ const t = canvas.viewportTransform;
83
+ return point.transform(relationAfter === 'child' ? invertTransform(t) : t);
84
+ };
85
+
86
+ /**
87
+ *
88
+ * A util that abstracts applying transform to objects.\
89
+ * Sends `object` to the destination coordinate plane by applying the relevant transformations.\
90
+ * Changes the space/plane where `object` is drawn.\
91
+ * From the canvas/viewer's perspective `object` remains unchanged.
92
+ *
93
+ * @example <caption>Move clip path from one object to another while preserving it's appearance as viewed by canvas/viewer</caption>
94
+ * let obj, obj2;
95
+ * let clipPath = new Circle({ radius: 50 });
96
+ * obj.clipPath = clipPath;
97
+ * // render
98
+ * sendObjectToPlane(clipPath, obj.calcTransformMatrix(), obj2.calcTransformMatrix());
99
+ * obj.clipPath = undefined;
100
+ * obj2.clipPath = clipPath;
101
+ * // render, clipPath now clips obj2 but seems unchanged from the eyes of the viewer
102
+ *
103
+ * @example <caption>Clip an object's clip path with an existing object</caption>
104
+ * let obj, existingObj;
105
+ * let clipPath = new Circle({ radius: 50 });
106
+ * obj.clipPath = clipPath;
107
+ * let transformTo = multiplyTransformMatrices(obj.calcTransformMatrix(), clipPath.calcTransformMatrix());
108
+ * sendObjectToPlane(existingObj, existingObj.group?.calcTransformMatrix(), transformTo);
109
+ * clipPath.clipPath = existingObj;
110
+ *
111
+ * @param {FabricObject} object
112
+ * @param {Matrix} [from] plane matrix containing object. Passing `undefined` is equivalent to passing the identity matrix, which means `object` is a direct child of canvas.
113
+ * @param {Matrix} [to] destination plane matrix to contain object. Passing `undefined` means `object` should be sent to the canvas coordinate plane.
114
+ * @returns {Matrix} the transform matrix that was applied to `object`
115
+ */
116
+ export const sendObjectToPlane = (
117
+ object: FabricObject,
118
+ from?: TMat2D,
119
+ to?: TMat2D
120
+ ): TMat2D => {
121
+ const t = calcPlaneChangeMatrix(from, to);
122
+ applyTransformToObject(
123
+ object,
124
+ multiplyTransformMatrices(t, object.calcOwnMatrix())
125
+ );
126
+ return t;
127
+ };
@@ -0,0 +1,113 @@
1
+ import type { XY } from '../../../Point';
2
+ import { Point } from '../../../Point';
3
+ import { createVector, getOrthonormalVector, getUnitVector } from '../vectors';
4
+ import { StrokeLineJoinProjections } from './StrokeLineJoinProjections';
5
+ import { StrokeProjectionsBase } from './StrokeProjectionsBase';
6
+ import type { TProjection, TProjectStrokeOnPointsOptions } from './types';
7
+
8
+ /**
9
+ * class in charge of finding projections for each type of line cap for start/end of an open path
10
+ * @see {@link [Open path projections at #8344](https://github.com/fabricjs/fabric.js/pull/8344#1-open-path)}
11
+ *
12
+ * Reference:
13
+ * - MDN:
14
+ * - https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/lineCap
15
+ * - https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/stroke-linecap
16
+ * - Spec: https://html.spec.whatwg.org/multipage/canvas.html#dom-context-2d-linecap-dev
17
+ * - Playground to understand how the line joins works: https://hypertolosana.github.io/efficient-webgl-stroking/index.html
18
+ * - View the calculated projections for each of the control points: https://codesandbox.io/s/project-stroke-points-with-context-to-trace-b8jc4j?file=/src/index.js
19
+ */
20
+ export class StrokeLineCapProjections extends StrokeProjectionsBase {
21
+ /**
22
+ * edge point
23
+ */
24
+ declare A: Point;
25
+ /**
26
+ * point next to edge point
27
+ */
28
+ declare T: Point;
29
+
30
+ constructor(A: XY, T: XY, options: TProjectStrokeOnPointsOptions) {
31
+ super(options);
32
+ this.A = new Point(A);
33
+ this.T = new Point(T);
34
+ }
35
+
36
+ calcOrthogonalProjection(
37
+ from: Point,
38
+ to: Point,
39
+ magnitude: number = this.strokeProjectionMagnitude
40
+ ) {
41
+ const vector = this.createSideVector(from, to);
42
+ return this.scaleUnitVector(getOrthonormalVector(vector), magnitude);
43
+ }
44
+
45
+ /**
46
+ * OPEN PATH START/END - Line cap: Butt
47
+ * Calculation: to find the projections, just find the points orthogonal to the stroke
48
+ *
49
+ * @see https://github.com/fabricjs/fabric.js/pull/8344#1-1-butt
50
+ */
51
+ projectButt() {
52
+ return [
53
+ this.projectOrthogonally(this.A, this.T, this.strokeProjectionMagnitude),
54
+ this.projectOrthogonally(this.A, this.T, -this.strokeProjectionMagnitude),
55
+ ];
56
+ }
57
+
58
+ /**
59
+ * OPEN PATH START/END - Line cap: Round
60
+ * Calculation: same as stroke line join `round`
61
+ *
62
+ * @see https://github.com/fabricjs/fabric.js/pull/8344#1-2-round
63
+ */
64
+ projectRound() {
65
+ return new StrokeLineJoinProjections(
66
+ this.A,
67
+ this.T,
68
+ this.T,
69
+ this.options
70
+ ).projectRound();
71
+ }
72
+
73
+ /**
74
+ * OPEN PATH START/END - Line cap: Square
75
+ * Calculation: project a rectangle of points on the stroke in the opposite direction of the vector `AT`
76
+ *
77
+ * @see https://github.com/fabricjs/fabric.js/pull/8344#1-3-square
78
+ */
79
+ projectSquare() {
80
+ const orthogonalProjection = this.calcOrthogonalProjection(
81
+ this.A,
82
+ this.T,
83
+ this.strokeProjectionMagnitude
84
+ );
85
+ const strokePointingOut = this.scaleUnitVector(
86
+ getUnitVector(createVector(this.A, this.T)),
87
+ -this.strokeProjectionMagnitude
88
+ );
89
+ const projectedA = this.A.add(strokePointingOut);
90
+ return [
91
+ projectedA.add(orthogonalProjection),
92
+ projectedA.subtract(orthogonalProjection),
93
+ ].map((p) => this.applySkew(p));
94
+ }
95
+
96
+ protected projectPoints() {
97
+ switch (this.options.strokeLineCap) {
98
+ case 'round':
99
+ return this.projectRound();
100
+ case 'square':
101
+ return this.projectSquare();
102
+ default:
103
+ return this.projectButt();
104
+ }
105
+ }
106
+
107
+ public project(): TProjection[] {
108
+ return this.projectPoints().map((point) => ({
109
+ originPoint: this.A,
110
+ projectedPoint: point,
111
+ }));
112
+ }
113
+ }
@@ -0,0 +1,227 @@
1
+ import type { XY } from '../../../Point';
2
+ import { Point } from '../../../Point';
3
+ import { degreesToRadians } from '../radiansDegreesConversion';
4
+ import { getBisector, getOrthonormalVector, magnitude } from '../vectors';
5
+ import { StrokeProjectionsBase } from './StrokeProjectionsBase';
6
+ import type { TProjection, TProjectStrokeOnPointsOptions } from './types';
7
+
8
+ /**
9
+ * class in charge of finding projections for each type of line join
10
+ * @see {@link [Closed path projections at #8344](https://github.com/fabricjs/fabric.js/pull/8344#2-closed-path)}
11
+ *
12
+ * - MDN:
13
+ * - https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/lineJoin
14
+ * - https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/stroke-linejoin
15
+ * - Spec: https://svgwg.org/svg2-draft/painting.html#StrokeLinejoinProperty
16
+ * - Playground to understand how the line joins works: https://hypertolosana.github.io/efficient-webgl-stroking/index.html
17
+ * - View the calculated projections for each of the control points: https://codesandbox.io/s/project-stroke-points-with-context-to-trace-b8jc4j?file=/src/index.js
18
+ *
19
+ */
20
+ export class StrokeLineJoinProjections extends StrokeProjectionsBase {
21
+ /**
22
+ * The point being projected (the angle ∠BAC)
23
+ */
24
+ declare A: Point;
25
+ /**
26
+ * The point before A
27
+ */
28
+ declare B: Point;
29
+ /**
30
+ * The point after A
31
+ */
32
+ declare C: Point;
33
+ /**
34
+ * The bisector of A (∠BAC)
35
+ */
36
+ declare bisector: ReturnType<typeof getBisector>;
37
+
38
+ constructor(A: XY, B: XY, C: XY, options: TProjectStrokeOnPointsOptions) {
39
+ super(options);
40
+ this.A = new Point(A);
41
+ this.B = new Point(B);
42
+ this.C = new Point(C);
43
+ // First we calculate the bisector between the points. Used in `round` and `miter` cases
44
+ // When the stroke is uniform, scaling changes the arrangement of the points, so we have to take it into account
45
+ this.bisector = this.options.strokeUniform
46
+ ? getBisector(
47
+ this.A.multiply(this.scale),
48
+ this.B.multiply(this.scale),
49
+ this.C.multiply(this.scale)
50
+ )
51
+ : getBisector(this.A, this.B, this.C);
52
+ }
53
+
54
+ get bisectorVector() {
55
+ return this.bisector.vector;
56
+ }
57
+
58
+ get bisectorAngle() {
59
+ return this.bisector.angle;
60
+ }
61
+
62
+ calcOrthogonalProjection(
63
+ from: Point,
64
+ to: Point,
65
+ magnitude: number = this.strokeProjectionMagnitude
66
+ ) {
67
+ const vector = this.createSideVector(from, to);
68
+ const orthogonalProjection = getOrthonormalVector(vector);
69
+ const correctSide = StrokeProjectionsBase.getAcuteAngleFactor(
70
+ orthogonalProjection,
71
+ this.bisectorVector
72
+ );
73
+ return this.scaleUnitVector(orthogonalProjection, magnitude * correctSide);
74
+ }
75
+
76
+ /**
77
+ * BEVEL
78
+ * Calculation: the projection points are formed by the vector orthogonal to the vertex.
79
+ *
80
+ * @see https://github.com/fabricjs/fabric.js/pull/8344#2-2-bevel
81
+ */
82
+ projectBevel() {
83
+ return [this.B, this.C].map((to) => this.projectOrthogonally(this.A, to));
84
+ }
85
+
86
+ /**
87
+ * MITER
88
+ * Calculation: the corner is formed by extending the outer edges of the stroke
89
+ * at the tangents of the path segments until they intersect.
90
+ *
91
+ * @see https://github.com/fabricjs/fabric.js/pull/8344#2-1-miter
92
+ */
93
+ projectMiter() {
94
+ const alpha = Math.abs(this.bisectorAngle),
95
+ hypotUnitScalar = 1 / Math.sin(alpha / 2),
96
+ miterVector = this.scaleUnitVector(
97
+ this.bisectorVector,
98
+ -this.strokeProjectionMagnitude * hypotUnitScalar
99
+ );
100
+
101
+ // When two line segments meet at a sharp angle, it is possible for the join to extend,
102
+ // far beyond the thickness of the line stroking the path. The stroke-miterlimit imposes
103
+ // a limit on the extent of the line join.
104
+ // MDN: https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/stroke-miterlimit
105
+ // When the stroke is uniform, scaling changes the arrangement of points, this changes the miter-limit
106
+ const strokeMiterLimit = this.options.strokeUniform
107
+ ? hypotUnitScalar
108
+ : this.options.strokeMiterLimit;
109
+
110
+ if (
111
+ magnitude(miterVector) / this.strokeProjectionMagnitude <=
112
+ strokeMiterLimit
113
+ ) {
114
+ return [this.applySkew(this.A.add(miterVector))];
115
+ } else {
116
+ // when the miter-limit is reached, the stroke line join becomes of type bevel
117
+ return this.projectBevel();
118
+ }
119
+ }
120
+
121
+ /**
122
+ * ROUND (without skew)
123
+ * Calculation: the projections are the two vectors parallel to X and Y axes
124
+ *
125
+ * @see https://github.com/fabricjs/fabric.js/pull/8344#2-3-1-round-without-skew
126
+ */
127
+ private projectRoundNoSkew() {
128
+ // correctSide is used to only consider projecting for the outer side
129
+ const correctSide = new Point(
130
+ StrokeProjectionsBase.getAcuteAngleFactor(this.bisectorVector),
131
+ StrokeProjectionsBase.getAcuteAngleFactor(
132
+ new Point(this.bisectorVector.y, this.bisectorVector.x)
133
+ )
134
+ ),
135
+ radiusOnAxisX = new Point(1, 0)
136
+ .scalarMultiply(this.strokeProjectionMagnitude)
137
+ .multiply(this.strokeUniformScalar)
138
+ .multiply(correctSide),
139
+ radiusOnAxisY = new Point(0, 1)
140
+ .scalarMultiply(this.strokeProjectionMagnitude)
141
+ .multiply(this.strokeUniformScalar)
142
+ .multiply(correctSide);
143
+
144
+ return [this.A.add(radiusOnAxisX), this.A.add(radiusOnAxisY)];
145
+ }
146
+
147
+ /**
148
+ * ROUND (with skew)
149
+ * Calculation: the projections are the points furthest from the vertex in
150
+ * the direction of the X and Y axes after distortion.
151
+ *
152
+ * @todo TODO:
153
+ * - Consider only projections that are inside the beginning and end of the circle segment
154
+ *
155
+ * @see https://github.com/fabricjs/fabric.js/pull/8344#2-3-2-round-skew
156
+ */
157
+ private projectRoundWithSkew() {
158
+ const projections: Point[] = [];
159
+
160
+ // The start and end points of the circle segment
161
+ [this.B, this.C].forEach((to) =>
162
+ projections.push(this.projectOrthogonally(this.A, to))
163
+ );
164
+
165
+ const { skewX, skewY } = this.options;
166
+ // The points furthest from the vertex in the direction of the X and Y axes after distortion
167
+ const circleRadius = new Point()
168
+ .scalarAdd(this.strokeProjectionMagnitude)
169
+ .multiply(this.strokeUniformScalar),
170
+ newY =
171
+ circleRadius.y / Math.sqrt(1 + Math.tan(degreesToRadians(skewY)) ** 2),
172
+ furthestY = new Point(
173
+ Math.sqrt(
174
+ circleRadius.x ** 2 - ((newY * circleRadius.x) / circleRadius.y) ** 2
175
+ ),
176
+ newY
177
+ ),
178
+ newX =
179
+ circleRadius.x / Math.sqrt(1 + Math.tan(degreesToRadians(skewX)) ** 2),
180
+ furthestX = new Point(
181
+ newX,
182
+ Math.sqrt(newY ** 2 - ((newX * newY) / circleRadius.x) ** 2)
183
+ );
184
+
185
+ [furthestX, furthestY].forEach((vector) => {
186
+ projections.push(
187
+ this.applySkew(this.A.add(vector)),
188
+ this.applySkew(this.A.subtract(vector))
189
+ );
190
+ });
191
+
192
+ return projections;
193
+ }
194
+
195
+ projectRound() {
196
+ if (!this.isSkewed()) {
197
+ return this.projectRoundNoSkew();
198
+ } else {
199
+ return this.projectRoundWithSkew();
200
+ }
201
+ }
202
+
203
+ /**
204
+ * Project stroke width on points returning projections for each point as follows:
205
+ * - `miter`: 1 point corresponding to the outer boundary. If the miter limit is exceeded, it will be 2 points (becomes bevel)
206
+ * - `bevel`: 2 points corresponding to the bevel possible boundaries, orthogonal to the stroke.
207
+ * - `round`: same as `bevel` when it has no skew, with skew are 4 points.
208
+ */
209
+ protected projectPoints() {
210
+ switch (this.options.strokeLineJoin) {
211
+ case 'miter':
212
+ return this.projectMiter();
213
+ case 'round':
214
+ return this.projectRound();
215
+ default:
216
+ return this.projectBevel();
217
+ }
218
+ }
219
+
220
+ public project(): TProjection[] {
221
+ return this.projectPoints().map((point) => ({
222
+ originPoint: this.A,
223
+ projectedPoint: point,
224
+ bisector: this.bisector,
225
+ }));
226
+ }
227
+ }
@@ -0,0 +1,76 @@
1
+ import { halfPI } from '../../../constants';
2
+ import type { XY } from '../../../Point';
3
+ import { Point } from '../../../Point';
4
+ import { degreesToRadians } from '../radiansDegreesConversion';
5
+ import {
6
+ calcAngleBetweenVectors,
7
+ calcVectorRotation,
8
+ createVector,
9
+ } from '../vectors';
10
+ import type { TProjectStrokeOnPointsOptions, TProjection } from './types';
11
+
12
+ /**
13
+ * @see https://github.com/fabricjs/fabric.js/pull/8344
14
+ */
15
+ export abstract class StrokeProjectionsBase {
16
+ declare options: TProjectStrokeOnPointsOptions;
17
+ declare scale: Point;
18
+ declare strokeUniformScalar: Point;
19
+ declare strokeProjectionMagnitude: number;
20
+
21
+ static getAcuteAngleFactor(vector1: Point, vector2?: Point) {
22
+ const angle = vector2
23
+ ? calcAngleBetweenVectors(vector1, vector2)
24
+ : calcVectorRotation(vector1);
25
+ return Math.abs(angle) < halfPI ? -1 : 1;
26
+ }
27
+
28
+ constructor(options: TProjectStrokeOnPointsOptions) {
29
+ this.options = options;
30
+ this.strokeProjectionMagnitude = this.options.strokeWidth / 2;
31
+ this.scale = new Point(this.options.scaleX, this.options.scaleY);
32
+ this.strokeUniformScalar = this.options.strokeUniform
33
+ ? new Point(1 / this.options.scaleX, 1 / this.options.scaleY)
34
+ : new Point(1, 1);
35
+ }
36
+
37
+ /**
38
+ * When the stroke is uniform, scaling affects the arrangement of points. So we must take it into account.
39
+ */
40
+ protected createSideVector(from: XY, to: XY) {
41
+ const v = createVector(from, to);
42
+ return this.options.strokeUniform ? v.multiply(this.scale) : v;
43
+ }
44
+
45
+ protected abstract calcOrthogonalProjection(
46
+ from: Point,
47
+ to: Point,
48
+ magnitude?: number
49
+ ): Point;
50
+
51
+ protected projectOrthogonally(from: Point, to: Point, magnitude?: number) {
52
+ return this.applySkew(
53
+ from.add(this.calcOrthogonalProjection(from, to, magnitude))
54
+ );
55
+ }
56
+
57
+ protected isSkewed() {
58
+ return this.options.skewX !== 0 || this.options.skewY !== 0;
59
+ }
60
+
61
+ protected applySkew(point: Point) {
62
+ const p = new Point(point);
63
+ // skewY must be applied before skewX as this distortion affects skewX calculation
64
+ p.y += p.x * Math.tan(degreesToRadians(this.options.skewY));
65
+ p.x += p.y * Math.tan(degreesToRadians(this.options.skewX));
66
+ return p;
67
+ }
68
+
69
+ protected scaleUnitVector(unitVector: Point, scalar: number) {
70
+ return unitVector.multiply(this.strokeUniformScalar).scalarMultiply(scalar);
71
+ }
72
+
73
+ protected abstract projectPoints(): Point[];
74
+
75
+ public abstract project(): TProjection[];
76
+ }
@@ -0,0 +1,55 @@
1
+ import type { XY } from '../../../Point';
2
+ import { StrokeLineCapProjections } from './StrokeLineCapProjections';
3
+ import { StrokeLineJoinProjections } from './StrokeLineJoinProjections';
4
+ import type { TProjection, TProjectStrokeOnPointsOptions } from './types';
5
+
6
+ export * from './types';
7
+
8
+ /**
9
+ *
10
+ * Used to calculate object's bounding box
11
+ *
12
+ * @see https://github.com/fabricjs/fabric.js/pull/8344
13
+ *
14
+ */
15
+ export const projectStrokeOnPoints = (
16
+ points: XY[],
17
+ options: TProjectStrokeOnPointsOptions,
18
+ openPath = false
19
+ ): TProjection[] => {
20
+ const projections: TProjection[] = [];
21
+
22
+ if (points.length <= 1) {
23
+ return projections;
24
+ }
25
+
26
+ points.forEach((A, index) => {
27
+ let B: XY, C: XY;
28
+ if (index === 0) {
29
+ C = points[1];
30
+ B = openPath ? A : points[points.length - 1];
31
+ } else if (index === points.length - 1) {
32
+ B = points[index - 1];
33
+ C = openPath ? A : points[0];
34
+ } else {
35
+ B = points[index - 1];
36
+ C = points[index + 1];
37
+ }
38
+
39
+ if (openPath && (index === 0 || index === points.length - 1)) {
40
+ projections.push(
41
+ ...new StrokeLineCapProjections(
42
+ A,
43
+ index === 0 ? C : B,
44
+ options
45
+ ).project()
46
+ );
47
+ } else {
48
+ projections.push(
49
+ ...new StrokeLineJoinProjections(A, B, C, options).project()
50
+ );
51
+ }
52
+ });
53
+
54
+ return projections;
55
+ };
@@ -0,0 +1,24 @@
1
+ import type { Point } from '../../../Point';
2
+ import type { TDegree } from '../../../typedefs';
3
+ import type { getBisector } from '../vectors';
4
+
5
+ export type TProjectStrokeOnPointsOptions = {
6
+ strokeWidth: number;
7
+ strokeLineCap: CanvasLineCap;
8
+ strokeLineJoin: CanvasLineJoin;
9
+ /**
10
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/stroke-miterlimit
11
+ */
12
+ strokeMiterLimit: number;
13
+ strokeUniform: boolean;
14
+ scaleX: number;
15
+ scaleY: number;
16
+ skewX: TDegree;
17
+ skewY: TDegree;
18
+ };
19
+
20
+ export type TProjection = {
21
+ projectedPoint: Point;
22
+ originPoint: Point;
23
+ bisector?: ReturnType<typeof getBisector>;
24
+ };
@@ -0,0 +1,18 @@
1
+ import type { TRadian, TDegree } from '../../typedefs';
2
+ import { PiBy180 } from '../../constants';
3
+
4
+ /**
5
+ * Transforms degrees to radians.
6
+ * @param {TDegree} degrees value in degrees
7
+ * @return {TRadian} value in radians
8
+ */
9
+ export const degreesToRadians = (degrees: TDegree): TRadian =>
10
+ (degrees * PiBy180) as TRadian;
11
+
12
+ /**
13
+ * Transforms radians to degrees.
14
+ * @param {TRadian} radians value in radians
15
+ * @return {TDegree} value in degrees
16
+ */
17
+ export const radiansToDegrees = (radians: TRadian): TDegree =>
18
+ (radians / PiBy180) as TDegree;
@@ -0,0 +1,22 @@
1
+ import type { TOriginX, TOriginY } from '../../typedefs';
2
+
3
+ const originOffset = {
4
+ left: -0.5,
5
+ top: -0.5,
6
+ center: 0,
7
+ bottom: 0.5,
8
+ right: 0.5,
9
+ };
10
+ /**
11
+ * Resolves origin value relative to center
12
+ * @private
13
+ * @param {TOriginX | TOriginY} originValue originX / originY
14
+ * @returns number
15
+ */
16
+
17
+ export const resolveOrigin = (
18
+ originValue: TOriginX | TOriginY | number
19
+ ): number =>
20
+ typeof originValue === 'string'
21
+ ? originOffset[originValue]
22
+ : originValue - 0.5;
@@ -0,0 +1,15 @@
1
+ import type { Point } from '../../Point';
2
+ import type { TRadian } from '../../typedefs';
3
+ /**
4
+ * Rotates `point` around `origin` with `radians`
5
+ * @deprecated use the Point.rotate
6
+ * @param {Point} origin The origin of the rotation
7
+ * @param {Point} origin The origin of the rotation
8
+ * @param {TRadian} radians The radians of the angle for the rotation
9
+ * @return {Point} The new rotated point
10
+ */
11
+ export const rotatePoint = (
12
+ point: Point,
13
+ origin: Point,
14
+ radians: TRadian
15
+ ): Point => point.rotate(radians, origin);