@rings-webgpu/core 1.0.6 → 1.0.7

package/dist/types/math/HaltonSeq.d.ts

@@ -0,0 +1,13 @@
+/**
+ * https://en.wikipedia.org/wiki/Halton_sequence
+ * https://baike.baidu.com/item/Halton%20sequence/16697800
+ * Class for generating the Halton low-discrepancy series for Quasi Monte Carlo integration.
+ */
+export declare class HaltonSeq {
+    private value;
+    private inv_base;
+    static get(index: number, radix: number): number;
+    getBase(index: number, base: number): void;
+    next(): void;
+    get(): number;
+}

package/dist/types/math/Line.d.ts

@@ -0,0 +1,39 @@
+import { Color } from "./Color";
+import { Matrix4 } from "./Matrix4";
+import { Ray } from "./Ray";
+import { Vector3 } from "./Vector3";
+export declare enum LineClassification {
+    COLLINEAR = 0,
+    LINES_INTERSECT = 1,
+    SEGMENTS_INTERSECT = 2,
+    A_BISECTS_B = 3,
+    B_BISECTS_A = 4,
+    PARALELL = 5
+}
+export declare enum PointClassification {
+    ON_LINE = 0,
+    LEFT_SIDE = 1,
+    RIGHT_SIDE = 2
+}
+export declare class Line {
+    static cacluteLine0: Line;
+    static cacluteLine1: Line;
+    start: Vector3;
+    end: Vector3;
+    color: Color;
+    private _normal;
+    private _normalCalculated;
+    constructor(start?: Vector3, end?: Vector3);
+    set(start: Vector3, end: Vector3): void;
+    getCenter(): Vector3;
+    inverse(): void;
+    equals(l: Line): boolean;
+    toArray(): number[];
+    static getLines(ps: Vector3[]): Line[];
+    intersection(other: Line, pIntersectPoint?: Vector3): LineClassification;
+    getDirection(): Vector3;
+    copyFrom(line: Line): void;
+    static IsEqual(d1: any, d2: any): boolean;
+    static squreDistanceSegmentToSegment(lineA: Line, lineB: Line, mat?: Matrix4): number;
+    isNear(ray: Ray, maxDistance?: number, mat?: Matrix4): boolean;
+}

package/dist/types/math/MathUtil.d.ts

@@ -0,0 +1,86 @@
+import { Color } from "./Color";
+import { Matrix4 } from "./Matrix4";
+import { Quaternion } from "./Quaternion";
+import { Rand } from "./Rand";
+import { Vector2 } from "./Vector2";
+import { Vector3 } from "./Vector3";
+export declare let RADIANS_TO_DEGREES: number;
+export declare let DEGREES_TO_RADIANS: number;
+export declare let MAX_VALUE: number;
+export declare let MIN_VALUE: number;
+export declare function clamp(value: any, min: any, max: any): number;
+export declare class MathUtil {
+    private static gaussFunction;
+    private static computeGaussian;
+    private static gaussCoef;
+    static clampf(value: number, min_inclusive: number, max_inclusive: number): number;
+    static normalizeAngle(a: number): number;
+    static fract(v: number): number;
+    static getRandDirXZ(r: number): {
+        x: number;
+        z: number;
+    };
+    static getRandDirXYZ(r: number): Vector3;
+    static getCycleXYZ(r: number): Vector3;
+    static angle(p1: Vector3, p2: Vector3): number;
+    static angle_360(from: Vector3, to: Vector3): number;
+    getRotationY(v: Vector3): number;
+    static fromToRotation(fromDirection: Vector3, toDirection: Vector3, target?: Quaternion): Quaternion;
+    static getEularDir_yUp(v: number): Vector3;
+    static transformVector(matrix: Matrix4, vector: Vector3, result?: Vector3): Vector3;
+}
+export declare let lerp: (v0: number, v1: number, t: number) => number;
+export declare function lerpVector3(v0: Vector3, v1: Vector3, t: number): Vector3;
+export declare function lerpColor(c0: Color, c1: Color, t: any): Color;
+export declare function lerpByte(u0: any, u1: any, scale: any): number;
+export declare let PingPong: (t: number, start: number, end: number) => number;
+export declare let RepeatSE: (t: number, start: number, end: number) => number;
+export declare let GetRepeat: (datas: any[], element: any) => number;
+export declare class RandomSeed {
+    x: number;
+    y: number;
+    z: number;
+    w: number;
+    randSeedList: number[];
+    constructor();
+    reset(): void;
+}
+export declare function dot(lhs: Vector2 | Quaternion | Vector3, rhs: Vector2 | Quaternion | Vector3): number;
+export declare function scale(lhs: Vector3, rhs: Vector3): Vector3;
+export declare function sqrtImpl(f: number): number;
+export declare function magnitude(inV: Vector2 | Vector3 | Quaternion): number;
+export declare function normalizeSafe(inV: Vector2 | Vector3 | Quaternion, defaultV?: Vector2 | Vector3 | Quaternion): Vector2 | Vector3 | Quaternion;
+export declare function getFloatFromInt(value: any): number;
+export declare function random01(value: any): any;
+export declare function rangedRandomFloat(r: Rand, min: number, max: number): number;
+export declare function rangedRandomInt(r: Rand, min: number, max: number): number;
+export declare function randomUnitVector(rand: Rand): Vector3;
+export declare function randomUnitVector2(rand: Rand): Vector2;
+export declare function randomQuaternion(rand: Rand): number | Quaternion;
+export declare function randomQuaternionUniformDistribution(rand: Rand): number | Quaternion;
+export declare function randomPointInsideCube(r: Rand, extents: Vector3): Vector3;
+export declare function randomPointInsideUnitSphere(r: Rand): Vector3;
+export declare function randomPointInsideEllipsoid(r: Rand, extents: Vector3): Vector3;
+export declare function randomPointBetweenSphere(r: Rand, minRadius: number, maxRadius: number): Vector3;
+export declare function randomPointInsideUnitCircle(r: Rand): Vector2;
+export declare function randomPointBetweenEllipsoid(r: Rand, maxExtents: Vector3, minRange: number): Vector3;
+export declare function randomBarycentricCoord(rand: Rand): Vector3;
+export declare function deg2Rad(deg: any): number;
+export declare function rad2Deg(deg: any): number;
+export declare function sin(v: number): number;
+export declare function cos(v: number): number;
+export declare let randomSeed: number;
+export declare function getGlobalRandomSeed(): number;
+export declare function swap(values: any[], i1: number, i2: number): void;
+export declare function floorfToIntPos(f: any): number;
+export declare function roundfToIntPos(f: any): number;
+export declare function normalizedToWord(f: any): number;
+export declare function normalizedToByte(f: any): number;
+export declare function fastInvSqrt(f: any): any;
+export declare function normalizeFast(inV: Vector3): Vector3;
+export declare function crossProduct(lhs: Vector3, rhs: Vector3): Vector3;
+export declare function sqrMagnitude(inV: Vector3): number;
+export declare function generateRandom(randomIn: any): any;
+export declare function generateRandom3(randomOut: Vector3, randomIn: number): void;
+export declare function clampRepeat(t: any, t0: any, t1: any): any;
+export declare function repeat(t: any, length: any): number;

package/dist/types/math/Matrix3.d.ts

@@ -0,0 +1,183 @@
+import { Vector3 } from "./Vector3";
+export declare class Matrix3 {
+    a: number;
+    b: number;
+    c: number;
+    d: number;
+    tx: number;
+    ty: number;
+    /**
+     * Create a Matrix3
+     * @param a The width of x
+     * @param b The slope of y
+     * @param c The slope of x
+     * @param d The height of y
+     * @param tx The position of the x coordinate
+     * @param ty The position of the y coordinate
+     */
+    constructor(a?: number, b?: number, c?: number, d?: number, tx?: number, ty?: number);
+    /**
+     * 克隆当前矩阵 - 返回一个新矩阵对象
+     * @returns New Matrix3 object
+     */
+    clone(): Matrix3;
+    /**
+     * 合并矩阵 - 将当前矩阵与目标矩阵相乘(后乘)
+     * @param matrix target matrix
+     */
+    concat(matrix: Matrix3): void;
+    /**
+     * 复制矩阵值 - 从另一个矩阵复制值到当前矩阵
+     * @param other  target matrix value
+     * @returns current matrix
+     */
+    copyFrom(other: Matrix3): Matrix3;
+    /**
+     * 重置为单位矩阵 - 将矩阵重置为无变换状态
+     */
+    identity(): this;
+    /**
+     * 矩阵求逆 - 将当前矩阵变为它的逆矩阵
+     */
+    invert(): void;
+    /**
+     * 旋转矩阵 - 按指定角度旋转(角度制)
+     * @param angle rotation angle
+     */
+    rotate(angle: number): void;
+    /**
+     * 缩放矩阵 - 按指定比例缩放
+     * @param sx x axis scaling
+     * @param sy y axis scaling
+     */
+    scale(sx: number, sy: number): void;
+    /**
+     * 设置矩阵值 - 直接设置矩阵各元素值
+     * @param a Matrix element a
+     * @param b Matrix element b
+     * @param c Matrix element c
+     * @param d Matrix element d
+     * @param tx Matrix element tx
+     * @param ty Matrix element ty
+     * @returns The modified matrix
+     */
+    setTo(a: number, b: number, c: number, d: number, tx: number, ty: number): Matrix3;
+    /**
+     * 坐标变换 - 将点坐标应用当前矩阵变换
+     * @param pointX x coordinate
+     * @param pointY y coordinate
+     * @param resultPoint Vector of results
+     * @returns Vector of results
+     */
+    transformPoint(pointX: number, pointY: number, resultPoint?: Vector3): Vector3;
+    /**
+     * 设置平移量 - 直接设置tx/ty值
+     * @param x x coordinate
+     * @param y y coordinate
+     */
+    setTranslate(x: number, y: number): void;
+    /**
+     * 平移矩阵 - 增加平移偏移量
+     * @param dx The x-coordinate offset
+     * @param dy The y-coordinate offset
+     */
+    translate(dx: number, dy: number): void;
+    /**
+     * 矩阵乘法 - 当前矩阵乘以目标矩阵(后乘)
+     * @param t target matrix
+     */
+    mul(t: Matrix3): void;
+    /**
+     * 矩阵相等判断 - 判断与另一矩阵是否相等
+     * @param other matrix
+     * @returns
+     */
+    equals(other: Matrix3): boolean;
+    /**
+     * 前乘矩阵 - 用指定参数创建一个矩阵并前乘当前矩阵
+     * @param a Multiply by a
+     * @param b Multiply by b
+     * @param c Multiply by c
+     * @param d Multiply by d
+     * @param tx Multiply by tx
+     * @param ty Multiply by ty
+     * @returns prematrix
+     */
+    prepend(a: number, b: number, c: number, d: number, tx: number, ty: number): Matrix3;
+    /**
+     * 后乘矩阵 - 用目标矩阵后乘当前矩阵
+     * @param mat Matrix
+     * @returns result
+     */
+    append(mat: Matrix3): Matrix3;
+    /**
+     * 忽略平移的坐标变换 - 只应用缩放/旋转变换
+     * @param point A given point
+     * @returns
+     */
+    deltaTransformPoint(point: Vector3): Vector3;
+    /**
+     * 转换为字符串 - 返回矩阵的字符串表示
+     * @returns
+     */
+    toString(): string;
+    /**
+     * 创建变换矩阵 - 设置缩放、旋转和平移参数
+     * @param scaleX x axis scaling
+     * @param scaleY y axis scaling
+     * @param rotation rotation
+     * @param tx x-coordinate
+     * @param ty y-coordinate
+     */
+    createBox(scaleX: number, scaleY: number, rotation?: number, tx?: number, ty?: number): void;
+    /**
+     * 创建渐变框矩阵 - 特殊用途的矩阵创建方法
+     * @param width width
+     * @param height height
+     * @param rotation rotation
+     * @param tx x-coordinate
+     * @param ty y-coordinate
+     */
+    createGradientBox(width: number, height: number, rotation?: number, tx?: number, ty?: number): void;
+    /**
+     * 内部方法 - 将矩阵求逆结果存入目标矩阵
+     * @param target matrix
+     * @returns
+     */
+    private _invertInto;
+    /**
+     * @private
+     */
+    getScaleX(): number;
+    /**
+     * @private
+     */
+    getScaleY(): number;
+    /**
+     * @private
+     */
+    getSkewX(): number;
+    /**
+     * @private
+     */
+    getSkewY(): number;
+    /**
+     * @private
+     */
+    updateScaleAndRotation(scaleX: number, scaleY: number, skewX: number, skewY: number): void;
+    /**
+     * 前乘到目标矩阵 - 计算 other * this 存入target
+     * @private
+     * target = other * this
+     */
+    preMultiplyInto(other: Matrix3, target: Matrix3): void;
+    /**
+     * 变换矩形边界 - 对矩形应用矩阵变换
+     * @private
+     */
+    private $transformBounds;
+    /**
+     * @private
+     */
+    private getDeterminant;
+}