fabric/dist/src/util/misc/matrix.mjs.map

Object model for HTML5 canvas, and SVG-to-canvas parser. Backed by jsdom and node-canvas.

{"version":3,"file":"matrix.mjs","names":[],"sources":["../../../../src/util/misc/matrix.ts"],"sourcesContent":["import { iMatrix } from '../../constants';\nimport type { XY } from '../../Point';\nimport { Point } from '../../Point';\nimport type { TDegree, TRadian, TMat2D } from '../../typedefs';\nimport { cos } from './cos';\nimport { degreesToRadians, radiansToDegrees } from './radiansDegreesConversion';\nimport { sin } from './sin';\n\nexport type TRotateMatrixArgs = {\n  angle?: TDegree;\n};\n\nexport type TTranslateMatrixArgs = {\n  translateX?: number;\n  translateY?: number;\n};\n\nexport type TScaleMatrixArgs = {\n  scaleX?: number;\n  scaleY?: number;\n  flipX?: boolean;\n  flipY?: boolean;\n  skewX?: TDegree;\n  skewY?: TDegree;\n};\n\nexport type TComposeMatrixArgs = TTranslateMatrixArgs &\n  TRotateMatrixArgs &\n  TScaleMatrixArgs;\n\nexport type TQrDecomposeOut = Required<\n  Omit<TComposeMatrixArgs, 'flipX' | 'flipY'>\n>;\n\nexport const isIdentityMatrix = (mat: TMat2D) =>\n  mat.every((value, index) => value === iMatrix[index]);\n\n/**\n * Apply transform t to point p\n * @deprecated use {@link Point#transform}\n * @param  {Point | XY} p The point to transform\n * @param  {Array} t The transform\n * @param  {Boolean} [ignoreOffset] Indicates that the offset should not be applied\n * @return {Point} The transformed point\n */\nexport const transformPoint = (\n  p: XY,\n  t: TMat2D,\n  ignoreOffset?: boolean,\n): Point => new Point(p).transform(t, ignoreOffset);\n\n/**\n * Invert transformation t\n * @param {Array} t The transform\n * @return {Array} The inverted transform\n */\nexport const invertTransform = (t: TMat2D): TMat2D => {\n  const a = 1 / (t[0] * t[3] - t[1] * t[2]),\n    r = [a * t[3], -a * t[1], -a * t[2], a * t[0], 0, 0] as TMat2D,\n    { x, y } = new Point(t[4], t[5]).transform(r, true);\n  r[4] = -x;\n  r[5] = -y;\n  return r;\n};\n\n/**\n * Multiply matrix A by matrix B to nest transformations\n * @param  {TMat2D} a First transformMatrix\n * @param  {TMat2D} b Second transformMatrix\n * @param  {Boolean} is2x2 flag to multiply matrices as 2x2 matrices\n * @return {TMat2D} The product of the two transform matrices\n */\nexport const multiplyTransformMatrices = (\n  a: TMat2D,\n  b: TMat2D,\n  is2x2?: boolean,\n): TMat2D =>\n  [\n    a[0] * b[0] + a[2] * b[1],\n    a[1] * b[0] + a[3] * b[1],\n    a[0] * b[2] + a[2] * b[3],\n    a[1] * b[2] + a[3] * b[3],\n    is2x2 ? 0 : a[0] * b[4] + a[2] * b[5] + a[4],\n    is2x2 ? 0 : a[1] * b[4] + a[3] * b[5] + a[5],\n  ] as TMat2D;\n\n/**\n * Multiplies the matrices array such that a matrix defines the plane for the rest of the matrices **after** it\n *\n * `multiplyTransformMatrixArray([A, B, C, D])` is equivalent to `A(B(C(D)))`\n *\n * @param matrices an array of matrices\n * @param [is2x2] flag to multiply matrices as 2x2 matrices\n * @returns the multiplication product\n */\nexport const multiplyTransformMatrixArray = (\n  matrices: (TMat2D | undefined | null | false)[],\n  is2x2?: boolean,\n) =>\n  matrices.reduceRight(\n    (product: TMat2D, curr) =>\n      curr && product\n        ? multiplyTransformMatrices(curr, product, is2x2)\n        : curr || product,\n    undefined as unknown as TMat2D,\n  ) || iMatrix.concat();\n\nexport const calcPlaneRotation = ([a, b]: TMat2D) =>\n  Math.atan2(b, a) as TRadian;\n\n/**\n * Decomposes standard 2x3 matrix into transform components\n * @param  {TMat2D} a transformMatrix\n * @return {Object} Components of transform\n */\nexport const qrDecompose = (a: TMat2D): TQrDecomposeOut => {\n  const angle = calcPlaneRotation(a),\n    denom = Math.pow(a[0], 2) + Math.pow(a[1], 2),\n    scaleX = Math.sqrt(denom),\n    scaleY = (a[0] * a[3] - a[2] * a[1]) / scaleX,\n    skewX = Math.atan2(a[0] * a[2] + a[1] * a[3], denom);\n  return {\n    angle: radiansToDegrees(angle),\n    scaleX,\n    scaleY,\n    skewX: radiansToDegrees(skewX),\n    skewY: 0 as TDegree,\n    translateX: a[4] || 0,\n    translateY: a[5] || 0,\n  };\n};\n\n/**\n * Generate a translation matrix\n *\n * A translation matrix in the form of\n * [ 1 0 x ]\n * [ 0 1 y ]\n * [ 0 0 1 ]\n *\n * See {@link https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/transform#translate} for more details\n *\n * @param {number} x translation on X axis\n * @param {number} [y] translation on Y axis\n * @returns {TMat2D} matrix\n */\nexport const createTranslateMatrix = (x: number, y = 0): TMat2D => [\n  1,\n  0,\n  0,\n  1,\n  x,\n  y,\n];\n\n/**\n * Generate a rotation matrix around around a point (x,y), defaulting to (0,0)\n *\n * A matrix in the form of\n * [cos(a) -sin(a) -x*cos(a)+y*sin(a)+x]\n * [sin(a)  cos(a) -x*sin(a)-y*cos(a)+y]\n * [0       0      1                 ]\n *\n *\n * @param {TDegree} angle rotation in degrees\n * @param {XY} [pivotPoint] pivot point to rotate around\n * @returns {TMat2D} matrix\n */\nexport function createRotateMatrix(\n  { angle = 0 }: TRotateMatrixArgs = {},\n  { x = 0, y = 0 }: Partial<XY> = {},\n): TMat2D {\n  const angleRadiant = degreesToRadians(angle),\n    cosValue = cos(angleRadiant),\n    sinValue = sin(angleRadiant);\n  return [\n    cosValue,\n    sinValue,\n    -sinValue,\n    cosValue,\n    x ? x - (cosValue * x - sinValue * y) : 0,\n    y ? y - (sinValue * x + cosValue * y) : 0,\n  ];\n}\n\n/**\n * Generate a scale matrix around the point (0,0)\n *\n * A matrix in the form of\n * [x 0 0]\n * [0 y 0]\n * [0 0 1]\n *\n * {@link https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/transform#scale}\n *\n * @param {number} x scale on X axis\n * @param {number} [y] scale on Y axis\n * @returns {TMat2D} matrix\n */\nexport const createScaleMatrix = (x: number, y: number = x): TMat2D => [\n  x,\n  0,\n  0,\n  y,\n  0,\n  0,\n];\n\nexport const angleToSkew = (angle: TDegree) =>\n  Math.tan(degreesToRadians(angle));\n\nexport const skewToAngle = (value: TRadian) =>\n  radiansToDegrees(Math.atan(value));\n\n/**\n * Generate a skew matrix for the X axis\n *\n * A matrix in the form of\n * [1 x 0]\n * [0 1 0]\n * [0 0 1]\n *\n * {@link https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/transform#skewx}\n *\n * @param {TDegree} skewValue translation on X axis\n * @returns {TMat2D} matrix\n */\nexport const createSkewXMatrix = (skewValue: TDegree): TMat2D => [\n  1,\n  0,\n  angleToSkew(skewValue),\n  1,\n  0,\n  0,\n];\n\n/**\n * Generate a skew matrix for the Y axis\n *\n * A matrix in the form of\n * [1 0 0]\n * [y 1 0]\n * [0 0 1]\n *\n * {@link https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/transform#skewy}\n *\n * @param {TDegree} skewValue translation on Y axis\n * @returns {TMat2D} matrix\n */\nexport const createSkewYMatrix = (skewValue: TDegree): TMat2D => [\n  1,\n  angleToSkew(skewValue),\n  0,\n  1,\n  0,\n  0,\n];\n\n/**\n * Returns a transform matrix starting from an object of the same kind of\n * the one returned from qrDecompose, useful also if you want to calculate some\n * transformations from an object that is not enlived yet.\n * is called DimensionsTransformMatrix because those properties are the one that influence\n * the size of the resulting box of the object.\n * @param  {Object} options\n * @param  {Number} [options.scaleX]\n * @param  {Number} [options.scaleY]\n * @param  {Boolean} [options.flipX]\n * @param  {Boolean} [options.flipY]\n * @param  {Number} [options.skewX]\n * @param  {Number} [options.skewY]\n * @return {Number[]} transform matrix\n */\nexport const calcDimensionsMatrix = ({\n  scaleX = 1,\n  scaleY = 1,\n  flipX = false,\n  flipY = false,\n  skewX = 0 as TDegree,\n  skewY = 0 as TDegree,\n}: TScaleMatrixArgs) => {\n  let matrix = createScaleMatrix(\n    flipX ? -scaleX : scaleX,\n    flipY ? -scaleY : scaleY,\n  );\n  if (skewX) {\n    matrix = multiplyTransformMatrices(matrix, createSkewXMatrix(skewX), true);\n  }\n  if (skewY) {\n    matrix = multiplyTransformMatrices(matrix, createSkewYMatrix(skewY), true);\n  }\n  return matrix;\n};\n\n/**\n * Returns a transform matrix starting from an object of the same kind of\n * the one returned from qrDecompose, useful also if you want to calculate some\n * transformations from an object that is not enlived yet\n * Before changing this function look at: src/benchmarks/calcTransformMatrix.mjs\n * @param  {Object} options\n * @param  {Number} [options.angle]\n * @param  {Number} [options.scaleX]\n * @param  {Number} [options.scaleY]\n * @param  {Boolean} [options.flipX]\n * @param  {Boolean} [options.flipY]\n * @param  {Number} [options.skewX]\n * @param  {Number} [options.skewY]\n * @param  {Number} [options.translateX]\n * @param  {Number} [options.translateY]\n * @return {Number[]} transform matrix\n */\nexport const composeMatrix = (options: TComposeMatrixArgs): TMat2D => {\n  const { translateX = 0, translateY = 0, angle = 0 as TDegree } = options;\n  let matrix = createTranslateMatrix(translateX, translateY);\n  if (angle) {\n    matrix = multiplyTransformMatrices(matrix, createRotateMatrix({ angle }));\n  }\n  const scaleMatrix = calcDimensionsMatrix(options);\n  if (!isIdentityMatrix(scaleMatrix)) {\n    matrix = multiplyTransformMatrices(matrix, scaleMatrix);\n  }\n  return matrix;\n};\n"],"mappings":";;;;;;AAkCA,MAAa,oBAAoB,QAC/B,IAAI,OAAO,OAAO,UAAU,UAAU,QAAQ,OAAO;;;;;;;;;AAUvD,MAAa,kBACX,GACA,GACA,iBACU,IAAI,MAAM,EAAE,CAAC,UAAU,GAAG,aAAa;;;;;;AAOnD,MAAa,mBAAmB,MAAsB;CACpD,MAAM,IAAI,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KACpC,IAAI;EAAC,IAAI,EAAE;EAAI,CAAC,IAAI,EAAE;EAAI,CAAC,IAAI,EAAE;EAAI,IAAI,EAAE;EAAI;EAAG;EAAE,EACpD,EAAE,GAAG,MAAM,IAAI,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,UAAU,GAAG,KAAK;AACrD,GAAE,KAAK,CAAC;AACR,GAAE,KAAK,CAAC;AACR,QAAO;;;;;;;;;AAUT,MAAa,6BACX,GACA,GACA,UAEA;CACE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE;CACvB,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE;CACvB,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE;CACvB,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE;CACvB,QAAQ,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE;CAC1C,QAAQ,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE;CAC3C;;;;;;;;;;AAWH,MAAa,gCACX,UACA,UAEA,SAAS,aACN,SAAiB,SAChB,QAAQ,UACJ,0BAA0B,MAAM,SAAS,MAAM,GAC/C,QAAQ,SACd,KAAA,EACD,IAAI,QAAQ,QAAQ;AAEvB,MAAa,qBAAqB,CAAC,GAAG,OACpC,KAAK,MAAM,GAAG,EAAE;;;;;;AAOlB,MAAa,eAAe,MAA+B;CACzD,MAAM,QAAQ,kBAAkB,EAAE,EAChC,QAAQ,KAAK,IAAI,EAAE,IAAI,EAAE,GAAG,KAAK,IAAI,EAAE,IAAI,EAAE,EAC7C,SAAS,KAAK,KAAK,MAAM,EACzB,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,QACvC,QAAQ,KAAK,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,MAAM;AACtD,QAAO;EACL,OAAO,iBAAiB,MAAM;EAC9B;EACA;EACA,OAAO,iBAAiB,MAAM;EAC9B,OAAO;EACP,YAAY,EAAE,MAAM;EACpB,YAAY,EAAE,MAAM;EACrB;;;;;;;;;;;;;;;;AAiBH,MAAa,yBAAyB,GAAW,IAAI,MAAc;CACjE;CACA;CACA;CACA;CACA;CACA;CACD;;;;;;;;;;;;;;AAeD,SAAgB,mBACd,EAAE,QAAQ,MAAyB,EAAE,EACrC,EAAE,IAAI,GAAG,IAAI,MAAmB,EAAE,EAC1B;CACR,MAAM,eAAe,iBAAiB,MAAM,EAC1C,WAAW,IAAI,aAAa,EAC5B,WAAW,IAAI,aAAa;AAC9B,QAAO;EACL;EACA;EACA,CAAC;EACD;EACA,IAAI,KAAK,WAAW,IAAI,WAAW,KAAK;EACxC,IAAI,KAAK,WAAW,IAAI,WAAW,KAAK;EACzC;;;;;;;;;;;;;;;;AAiBH,MAAa,qBAAqB,GAAW,IAAY,MAAc;CACrE;CACA;CACA;CACA;CACA;CACA;CACD;AAED,MAAa,eAAe,UAC1B,KAAK,IAAI,iBAAiB,MAAM,CAAC;;;;;;;;;;;;;;AAkBnC,MAAa,qBAAqB,cAA+B;CAC/D;CACA;CACA,YAAY,UAAU;CACtB;CACA;CACA;CACD;;;;;;;;;;;;;;AAeD,MAAa,qBAAqB,cAA+B;CAC/D;CACA,YAAY,UAAU;CACtB;CACA;CACA;CACA;CACD;;;;;;;;;;;;;;;;AAiBD,MAAa,wBAAwB,EACnC,SAAS,GACT,SAAS,GACT,QAAQ,OACR,QAAQ,OACR,QAAQ,GACR,QAAQ,QACc;CACtB,IAAI,SAAS,kBACX,QAAQ,CAAC,SAAS,QAClB,QAAQ,CAAC,SAAS,OACnB;AACD,KAAI,MACF,UAAS,0BAA0B,QAAQ,kBAAkB,MAAM,EAAE,KAAK;AAE5E,KAAI,MACF,UAAS,0BAA0B,QAAQ,kBAAkB,MAAM,EAAE,KAAK;AAE5E,QAAO;;;;;;;;;;;;;;;;;;;AAoBT,MAAa,iBAAiB,YAAwC;CACpE,MAAM,EAAE,aAAa,GAAG,aAAa,GAAG,QAAQ,MAAiB;CACjE,IAAI,SAAS,sBAAsB,YAAY,WAAW;AAC1D,KAAI,MACF,UAAS,0BAA0B,QAAQ,mBAAmB,EAAE,OAAO,CAAC,CAAC;CAE3E,MAAM,cAAc,qBAAqB,QAAQ;AACjD,KAAI,CAAC,iBAAiB,YAAY,CAChC,UAAS,0BAA0B,QAAQ,YAAY;AAEzD,QAAO"}