@faicad/faijs 0.31.1 → 0.32.2

package/dist/math3d/Mat4.d.ts

@@ -0,0 +1,196 @@
+/**
+   * math3d/Mat4 — three.js r162 `Matrix4` 的算法子集移植。
+ *
+   * Ported from three.js r162 `src/math/Matrix4.js` (MIT License, © 2010-2024
+   * three.js authors). **列主序** `elements`（长度 16）与 three 一致，公式逐行照抄
+   * 以保证逐位一致。未移植相机/投影相关方法（makePerspective / makeOrthographic /
+   * lookAt / decompose / determinant 等，core 不用）。
+ */
+import { Vec3 } from './Vec3.js';
+import { Quat } from './Quat.js';
+/**
+   * Structural 4x4 matrix: three's column-major `elements` layout.
+ *
+   * Used for public-API parameters that previously accepted `THREE.Matrix4`
+   * (three's class and this module's `Mat4` both satisfy it → no breaking change).
+ */
+export interface MatrixLike {
+    elements: number[];
+}
+/** 4x4 matrix (column-major elements), three.js `Matrix4` subset. */
+export declare class Mat4 {
+    /** three 内部标记。 */
+    readonly isMatrix4 = true;
+    /** Column-major 16-element storage. */
+    elements: number[];
+    /**
+     * @param n11 - initial value, or omitted for identity.
+     * @param n12 - initial value.
+     * @param n13 - initial value.
+     * @param n14 - initial value.
+     * @param n21 - initial value.
+     * @param n22 - initial value.
+     * @param n23 - initial value.
+     * @param n24 - initial value.
+     * @param n31 - initial value.
+     * @param n32 - initial value.
+     * @param n33 - initial value.
+     * @param n34 - initial value.
+     * @param n41 - initial value.
+     * @param n42 - initial value.
+     * @param n43 - initial value.
+     * @param n44 - initial value.
+     */
+    constructor(n11?: number, n12?: number, n13?: number, n14?: number, n21?: number, n22?: number, n23?: number, n24?: number, n31?: number, n32?: number, n33?: number, n34?: number, n41?: number, n42?: number, n43?: number, n44?: number);
+    /**
+     * Set all 16 elements in column-major order.
+     * @param n11 - element (row 1, col 1).
+     * @param n12 - element (row 1, col 2).
+     * @param n13 - element (row 1, col 3).
+     * @param n14 - element (row 1, col 4).
+     * @param n21 - element (row 2, col 1).
+     * @param n22 - element (row 2, col 2).
+     * @param n23 - element (row 2, col 3).
+     * @param n24 - element (row 2, col 4).
+     * @param n31 - element (row 3, col 1).
+     * @param n32 - element (row 3, col 2).
+     * @param n33 - element (row 3, col 3).
+     * @param n34 - element (row 3, col 4).
+     * @param n41 - element (row 4, col 1).
+     * @param n42 - element (row 4, col 2).
+     * @param n43 - element (row 4, col 3).
+     * @param n44 - element (row 4, col 4).
+     * @returns this
+     */
+    set(n11: number, n12: number, n13: number, n14: number, n21: number, n22: number, n23: number, n24: number, n31: number, n32: number, n33: number, n34: number, n41: number, n42: number, n43: number, n44: number): this;
+    /**
+     * Set to the identity matrix.
+     * @returns this (identity)
+     */
+    identity(): this;
+    /**
+     * Return a new matrix with the same elements.
+     * @returns a new matrix with the same elements.
+     */
+    clone(): Mat4;
+    /**
+     * Copy the elements from another matrix.
+     * @param m - source matrix.
+     * @returns this
+     */
+    copy(m: Mat4): this;
+    /**
+     * Set the basis vectors (columns) of the matrix.
+     * @param xAxis - basis X vector.
+     * @param yAxis - basis Y vector.
+     * @param zAxis - basis Z vector.
+     * @returns this
+     */
+    makeBasis(xAxis: Vec3, yAxis: Vec3, zAxis: Vec3): this;
+    /**
+     * Set the rotation part from Euler angles (radians).
+     * @param euler - Euler angles (radians) with an order tag.
+     * @returns this
+     */
+    makeRotationFromEuler(euler: {
+        x: number;
+        y: number;
+        z: number;
+        order: string;
+    }): this;
+    /**
+     * Set the rotation part from a quaternion.
+     * @param q - rotation quaternion.
+     * @returns this
+     */
+    makeRotationFromQuaternion(q: Quat): this;
+    /**
+     * Multiply by another matrix (this = this * m).
+     * @param m - right operand.
+     * @returns this
+     */
+    multiply(m: Mat4): this;
+    /**
+     * Pre-multiply by another matrix (this = m * this).
+     * @param m - left operand.
+     * @returns this
+     */
+    premultiply(m: Mat4): this;
+    /**
+     * Set this to a * b.
+     * @param a - left operand.
+     * @param b - right operand.
+     * @returns this
+     */
+    multiplyMatrices(a: Mat4, b: Mat4): this;
+    /**
+     * Set the translation part (last column).
+     * @param x - X translation, or a Vec3.
+     * @param y - Y translation.
+     * @param z - Z translation.
+     * @returns this
+     */
+    setPosition(x: number | Vec3, y?: number, z?: number): this;
+    /**
+     * Invert the matrix in place.
+     * @returns this (inverse; zero matrix when singular, matching three)
+     */
+    invert(): this;
+    /**
+     * Set to a translation matrix.
+     * @param x - X translation, or a Vec3.
+     * @param y - Y translation.
+     * @param z - Z translation.
+     * @returns this
+     */
+    makeTranslation(x: number | Vec3, y?: number, z?: number): this;
+    /**
+     * Set to a rotation matrix around the X axis.
+     * @param theta - rotation angle in radians.
+     * @returns this
+     */
+    makeRotationX(theta: number): this;
+    /**
+     * Set to a rotation matrix around the Y axis.
+     * @param theta - rotation angle in radians.
+     * @returns this
+     */
+    makeRotationY(theta: number): this;
+    /**
+     * Set to a rotation matrix around the Z axis.
+     * @param theta - rotation angle in radians.
+     * @returns this
+     */
+    makeRotationZ(theta: number): this;
+    /**
+     * Set to a scale matrix.
+     * @param x - X scale.
+     * @param y - Y scale.
+     * @param z - Z scale.
+     * @returns this
+     */
+    makeScale(x: number, y: number, z: number): this;
+    /**
+     * Set from position, quaternion and scale.
+     * @param position - translation.
+     * @param quaternion - rotation.
+     * @param scale - scale.
+     * @returns this
+     */
+    compose(position: Vec3, quaternion: Quat, scale: Vec3): this;
+    /**
+     * Load the elements from an array-like.
+     * @param array - source array.
+     * @param offset - start offset.
+     * @returns this
+     */
+    fromArray(array: ArrayLike<number>, offset?: number): this;
+    /**
+     * Write the elements into an array.
+     * @param array - target array (created when omitted).
+     * @param offset - start offset.
+     * @returns the target array.
+     */
+    toArray(array?: number[], offset?: number): number[];
+}
+//# sourceMappingURL=Mat4.d.ts.map

package/dist/math3d/Mat4.d.ts.map

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