@esengine/ecs-framework-math 1.0.5 → 2.9.0

package/bin/Matrix3.d.ts

@@ -0,0 +1,288 @@
+import { Vector2 } from './Vector2';
+/**
+ * 3x3变换矩阵类
+ * 3x3 Transform Matrix Class
+ *
+ * 用于2D变换（平移、旋转、缩放）的3x3矩阵
+ * 使用左手坐标系（顺时针正旋转）
+ *
+ * 矩阵布局（顺时针旋转）：
+ * [m00, m01, m02]   [scaleX * cos,  scaleY * sin, translateX]
+ * [m10, m11, m12] = [-scaleX * sin, scaleY * cos, translateY]
+ * [m20, m21, m22]   [0,             0,            1]
+ */
+export declare class Matrix3 {
+    /** 矩阵元素，按行优先存储 */
+    elements: Float32Array;
+    /**
+   * 创建3x3矩阵
+   * @param elements 矩阵元素数组（可选），默认为单位矩阵
+   */
+    constructor(elements?: ArrayLike<number>);
+    /** 单位矩阵 */
+    static readonly IDENTITY: Matrix3;
+    /** 零矩阵 */
+    static readonly ZERO: Matrix3;
+    /** 获取矩阵元素 */
+    get(row: number, col: number): number;
+    /** 设置矩阵元素 */
+    set(row: number, col: number, value: number): this;
+    get m00(): number;
+    set m00(value: number);
+    get m01(): number;
+    set m01(value: number);
+    get m02(): number;
+    set m02(value: number);
+    get m10(): number;
+    set m10(value: number);
+    get m11(): number;
+    set m11(value: number);
+    get m12(): number;
+    set m12(value: number);
+    get m20(): number;
+    set m20(value: number);
+    get m21(): number;
+    set m21(value: number);
+    get m22(): number;
+    set m22(value: number);
+    /**
+   * 设置矩阵为单位矩阵
+   * @returns 当前矩阵实例（链式调用）
+   */
+    identity(): this;
+    /**
+   * 设置矩阵为零矩阵
+   * @returns 当前矩阵实例（链式调用）
+   */
+    zero(): this;
+    /**
+   * 复制另一个矩阵的值
+   * @param other 源矩阵
+   * @returns 当前矩阵实例（链式调用）
+   */
+    copy(other: Matrix3): this;
+    /**
+   * 克隆当前矩阵
+   * @returns 新的矩阵实例
+   */
+    clone(): Matrix3;
+    /**
+   * 从数组设置矩阵元素
+   * @param elements 矩阵元素数组
+   * @returns 当前矩阵实例（链式调用）
+   */
+    fromArray(elements: ArrayLike<number>): this;
+    /**
+   * 矩阵加法
+   * @param other 另一个矩阵
+   * @returns 当前矩阵实例（链式调用）
+   */
+    add(other: Matrix3): this;
+    /**
+   * 矩阵减法
+   * @param other 另一个矩阵
+   * @returns 当前矩阵实例（链式调用）
+   */
+    subtract(other: Matrix3): this;
+    /**
+   * 矩阵标量乘法
+   * @param scalar 标量
+   * @returns 当前矩阵实例（链式调用）
+   */
+    multiplyScalar(scalar: number): this;
+    /**
+   * 矩阵乘法
+   * @param other 另一个矩阵
+   * @returns 当前矩阵实例（链式调用）
+   */
+    multiply(other: Matrix3): this;
+    /**
+   * 左乘另一个矩阵（other * this）
+   * @param other 左乘矩阵
+   * @returns 当前矩阵实例（链式调用）
+   */
+    premultiply(other: Matrix3): this;
+    /**
+   * 设置为平移矩阵
+   * @param x X方向平移
+   * @param y Y方向平移
+   * @returns 当前矩阵实例（链式调用）
+   */
+    makeTranslation(x: number, y: number): this;
+    /**
+     * 设置为旋转矩阵（顺时针为正）
+     * Set as rotation matrix (clockwise positive)
+     *
+     * 使用左手坐标系约定：正角度 = 顺时针旋转
+     * Uses left-hand coordinate system: positive angle = clockwise
+     *
+     * @param angle 旋转角度（弧度）
+     * @returns 当前矩阵实例（链式调用）
+     */
+    makeRotation(angle: number): this;
+    /**
+   * 设置为缩放矩阵
+   * @param scaleX X方向缩放
+   * @param scaleY Y方向缩放
+   * @returns 当前矩阵实例（链式调用）
+   */
+    makeScale(scaleX: number, scaleY: number): this;
+    /**
+   * 复合平移
+   * @param x X方向平移
+   * @param y Y方向平移
+   * @returns 当前矩阵实例（链式调用）
+   */
+    translate(x: number, y: number): this;
+    /**
+     * 复合旋转（顺时针为正）
+     * Composite rotation (clockwise positive)
+     *
+     * 使用左手坐标系约定：正角度 = 顺时针旋转
+     * Uses left-hand coordinate system: positive angle = clockwise
+     *
+     * @param angle 旋转角度（弧度）
+     * @returns 当前矩阵实例（链式调用）
+     */
+    rotate(angle: number): this;
+    /**
+   * 复合缩放
+   * @param scaleX X方向缩放
+   * @param scaleY Y方向缩放
+   * @returns 当前矩阵实例（链式调用）
+   */
+    scale(scaleX: number, scaleY: number): this;
+    /**
+   * 矩阵转置
+   * @returns 当前矩阵实例（链式调用）
+   */
+    transpose(): this;
+    /**
+   * 计算矩阵行列式
+   * @returns 行列式值
+   */
+    determinant(): number;
+    /**
+   * 矩阵求逆
+   * @returns 当前矩阵实例（链式调用），如果矩阵不可逆则保持不变
+   */
+    invert(): this;
+    /**
+   * 变换向量（应用完整的3x3变换）
+   * @param vector 向量
+   * @returns 新的变换后的向量
+   */
+    transformVector(vector: Vector2): Vector2;
+    /**
+   * 变换向量（仅应用旋转和缩放，忽略平移）
+   * @param vector 向量
+   * @returns 新的变换后的向量
+   */
+    transformDirection(vector: Vector2): Vector2;
+    /**
+   * 批量变换向量数组
+   * @param vectors 向量数组
+   * @returns 变换后的向量数组
+   */
+    transformVectors(vectors: Vector2[]): Vector2[];
+    /**
+   * 获取平移分量
+   * @returns 平移向量
+   */
+    getTranslation(): Vector2;
+    /**
+     * 获取旋转角度（顺时针为正）
+     * Get rotation angle (clockwise positive)
+     * @returns 旋转角度（弧度）
+     */
+    getRotation(): number;
+    /**
+   * 获取缩放分量
+   * @returns 缩放向量
+   */
+    getScale(): Vector2;
+    /**
+   * 分解变换矩阵为平移、旋转、缩放分量
+   * @returns {translation, rotation, scale}
+   */
+    decompose(): {
+        translation: Vector2;
+        rotation: number;
+        scale: Vector2;
+    };
+    /**
+   * 检查两个矩阵是否相等
+   * @param other 另一个矩阵
+   * @param epsilon 容差，默认为Number.EPSILON
+   * @returns 是否相等
+   */
+    equals(other: Matrix3, epsilon?: number): boolean;
+    /**
+   * 检查两个矩阵是否完全相等
+   * @param other 另一个矩阵
+   * @returns 是否完全相等
+   */
+    exactEquals(other: Matrix3): boolean;
+    /**
+   * 检查是否为单位矩阵
+   * @param epsilon 容差，默认为Number.EPSILON
+   * @returns 是否为单位矩阵
+   */
+    isIdentity(epsilon?: number): boolean;
+    /**
+   * 矩阵乘法（静态方法）
+   * @param a 矩阵a
+   * @param b 矩阵b
+   * @returns 新的结果矩阵
+   */
+    static multiply(a: Matrix3, b: Matrix3): Matrix3;
+    /**
+   * 创建平移矩阵（静态方法）
+   * @param x X方向平移
+   * @param y Y方向平移
+   * @returns 新的平移矩阵
+   */
+    static translation(x: number, y: number): Matrix3;
+    /**
+   * 创建旋转矩阵（静态方法）
+   * @param angle 旋转角度（弧度）
+   * @returns 新的旋转矩阵
+   */
+    static rotation(angle: number): Matrix3;
+    /**
+   * 创建缩放矩阵（静态方法）
+   * @param scaleX X方向缩放
+   * @param scaleY Y方向缩放
+   * @returns 新的缩放矩阵
+   */
+    static scale(scaleX: number, scaleY: number): Matrix3;
+    /**
+     * 创建TRS（平移-旋转-缩放）变换矩阵（顺时针为正）
+     * Create TRS (Translate-Rotate-Scale) matrix (clockwise positive)
+     *
+     * 使用左手坐标系约定：正角度 = 顺时针旋转
+     * Uses left-hand coordinate system: positive angle = clockwise
+     *
+     * @param translation 平移向量
+     * @param rotation 旋转角度（弧度）
+     * @param scale 缩放向量
+     * @returns 新的TRS矩阵
+     */
+    static TRS(translation: Vector2, rotation: number, scale: Vector2): Matrix3;
+    /**
+   * 转换为字符串
+   * @returns 字符串表示
+   */
+    toString(): string;
+    /**
+   * 转换为数组
+   * @returns 矩阵元素数组
+   */
+    toArray(): number[];
+    /**
+   * 转换为CSS transform字符串
+   * @returns CSS transform字符串
+   */
+    toCSSTransform(): string;
+}
+//# sourceMappingURL=Matrix3.d.ts.map

package/bin/Matrix3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Matrix3.d.ts","sourceRoot":"","sources":["../src/Matrix3.ts"],"names":[],"mappings":"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"}