matrix.js
2.33 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
// matrix.js —— 2D 仿射矩阵原语（纯函数，零依赖，最易测）。
// 移植自原型 evaluator.js 的 matFromTRS / matMul / decompose。
//
// 约定：point' = M·point，M = [[a,c,tx],[b,d,ty],[0,0,1]]。
// 部件均为均匀缩放、无切变（skew），所以 decompose 可忽略 skew 安全还原。
const DEG = Math.PI / 180
/** @type {import('./types.js').BoneOffset} 默认增量：无旋转 / 无位移 / 缩放 1。 */
export const PROP_DEFAULT = { drot: 0, dx: 0, dy: 0, dscale: 1 }
/**
* 度 → 弧度。
* @param {number} deg
* @returns {number}
*/
export function degToRad(deg) {
return deg * DEG
}
/**
* 线性插值。
* @param {number} a
* @param {number} b
* @param {number} t
* @returns {number}
*/
export function lerp(a, b, t) {
return a + (b - a) * t
}
/**
* 由平移 / 旋转（弧度）/ 均匀缩放构造仿射矩阵。
* @param {number} x
* @param {number} y
* @param {number} rotRad 旋转（弧度，顺时针为正，与屏幕坐标系一致）
* @param {number} scale 均匀缩放
* @returns {import('./types.js').Mat2D}
*/
export function fromTRS(x, y, rotRad, scale) {
const cos = Math.cos(rotRad)
const sin = Math.sin(rotRad)
return {
a: cos * scale,
b: sin * scale,
c: -sin * scale,
d: cos * scale,
tx: x,
ty: y,
}
}
/**
* 矩阵相乘（父 × 子 = 子的世界变换；满足结合律）。
* @param {import('./types.js').Mat2D} A
* @param {import('./types.js').Mat2D} B
* @returns {import('./types.js').Mat2D}
*/
export function mul(A, B) {
return {
a: A.a * B.a + A.c * B.b,
b: A.b * B.a + A.d * B.b,
c: A.a * B.c + A.c * B.d,
d: A.b * B.c + A.d * B.d,
tx: A.a * B.tx + A.c * B.ty + A.tx,
ty: A.b * B.tx + A.d * B.ty + A.ty,
}
}
/**
* 把矩阵分解回 {x,y,rotation,scaleX,scaleY}（忽略 skew）。
* 满足 decompose(fromTRS(x,y,r,s)) 还原（浮点容差内）。
* @param {import('./types.js').Mat2D} M
* @returns {{x:number,y:number,rotation:number,scaleX:number,scaleY:number}}
*/
export function decompose(M) {
const scaleX = Math.hypot(M.a, M.b)
const scaleY = Math.hypot(M.c, M.d)
const rotation = Math.atan2(M.b, M.a)
return { x: M.tx, y: M.ty, rotation, scaleX, scaleY }
}
/** §3 要求的 matrix 命名空间（也单独导出各函数）。 */
export const matrix = { fromTRS, mul, decompose }