@rings-webgpu/core 1.0.6 → 1.0.7

package/dist/types/util/AxisObject.d.ts

@@ -0,0 +1,11 @@
+import { Object3D } from "../core/entities/Object3D";
+/**
+ * 包含xyz坐标的OBJECT3D
+ * @group Util
+ */
+export declare class AxisObject extends Object3D {
+    length: number;
+    thickness: number;
+    constructor(length: number, thickness?: number);
+    init(): void;
+}

package/dist/types/util/BoundUtil.d.ts

@@ -0,0 +1,13 @@
+import { BoundingBox } from "../core/bound/BoundingBox";
+import { Object3D } from "../core/entities/Object3D";
+import { Matrix4 } from "../math/Matrix4";
+export declare class BoundUtil {
+    private static readonly maxVector;
+    private static readonly minVector;
+    private static readonly genMeshMaxVector;
+    private static readonly genMeshMinVector;
+    private static readonly genMeshVectorList8;
+    static genGSplatBounds(obj: Object3D, bound?: BoundingBox): BoundingBox;
+    static genMeshBounds(obj: Object3D, bound?: BoundingBox): BoundingBox;
+    static transformBound(matrix: Matrix4, source: BoundingBox, bound?: BoundingBox): BoundingBox;
+}

package/dist/types/util/BytesArray.d.ts

@@ -0,0 +1,49 @@
+import { Color, Matrix4, Quaternion, Vector2, Vector3, Vector4 } from "..";
+export declare class BytesArray extends DataView<ArrayBufferLike> {
+    get buffer(): ArrayBufferLike;
+    get byteOffset(): number;
+    get byteLength(): number;
+    getInt16(byteOffset: number, littleEndian?: boolean): number;
+    getInt32(byteOffset: number, littleEndian?: boolean): number;
+    getFloat32(byteOffset: number, littleEndian?: boolean): number;
+    getFloat64(byteOffset: number, littleEndian?: boolean): number;
+    getUint8(byteOffset: number): number;
+    getUint32(byteOffset: number, littleEndian?: boolean): number;
+    getInt8(byteOffset: number): number;
+    getUint16(byteOffset: number, littleEndian?: boolean): number;
+    position: number;
+    littleEndian?: boolean;
+    constructor(buffer: ArrayBufferLike, byteOffset?: number, byteLength?: number);
+    readUTF(): string;
+    readStringArray(): string[];
+    readByte(): number;
+    readBoolean(): boolean;
+    readBytes(byteLen: number): ArrayBufferLike;
+    readBytesArray(): BytesArray;
+    readUnit8(): number;
+    readUnit16(): number;
+    readUnit32(): number;
+    readInt8(): number;
+    readInt16(): number;
+    readInt32(): number;
+    readFloat32(): number;
+    readFloat64(): number;
+    readInt32Array(): Int32Array;
+    readInt32List(): number[];
+    readFloatArray(): number[];
+    readIntArray(): number[];
+    readVector2int(): Vector2;
+    readVector2(): Vector2;
+    readVector3(): Vector3;
+    readVector3Array(): any[];
+    readVector4(): Vector4;
+    readVector4Array(): any[];
+    readColor(): Color;
+    readColorArray(): any[];
+    readQuaternion(): Quaternion;
+    readQuaternionArray(): any[];
+    readMatrix44(): Matrix4;
+    readMatrix44Array(): Matrix4[];
+    readFloat32Array(len: number): Float32Array;
+    getFloat32Array(): Float32Array;
+}

package/dist/types/util/CameraUtil.d.ts

@@ -0,0 +1,10 @@
+import { Camera3D } from "../core/Camera3D";
+import { Object3D } from "../core/entities/Object3D";
+import { Vector3 } from "../math/Vector3";
+export declare class CameraUtil {
+    static createCamera3DObject(parent?: Object3D, name?: string): Camera3D;
+    static createCamera3D(object3D?: Object3D, parent?: Object3D, name?: string): Camera3D;
+    static UnProjection(sX: number, sY: number, sZ?: number, camera?: Camera3D): Vector3;
+    static Projection(point: Vector3, camera: Camera3D, target?: Vector3): Vector3;
+    static UnProjection2(sceneX: number, sceneY: number, z: number, camera: Camera3D, target: Vector3): Vector3;
+}

package/dist/types/util/Convert.d.ts

@@ -0,0 +1 @@
+export declare let toHalfFloat: (val: any) => number;

package/dist/types/util/GeometryUtil.d.ts

@@ -0,0 +1,12 @@
+import { Matrix4 } from "..";
+import { GeometryBase } from "../core/geometry/GeometryBase";
+/**
+ * @internal
+ */
+export declare class GeometryUtil {
+    static merge(geometries: GeometryBase[], matrixes: Matrix4[], target?: GeometryBase): void;
+    static mergeNumber(geometries: GeometryBase, num: number, target?: GeometryBase): GeometryBase;
+    static generateNormal(): void;
+    static generateTangent(): void;
+    static packUV(): void;
+}

package/dist/types/util/Global.d.ts

@@ -0,0 +1,15 @@
+import { ParserFormat } from "../loader/parser/ParserFormat";
+export declare let UUID: (len?: number, radix?: number) => string;
+export declare let GetCountInstanceID: () => number;
+export declare let ArrayHas: (array: any[], item: any) => boolean;
+export declare let ArrayItemIndex: (array: any[], item: any) => number;
+export declare let mergeFunctions: (...funcs: any[]) => (...args: any[]) => void;
+export type Ctor<T> = {
+    new (any?: any, any2?: any, any3?: any, any4?: any): T;
+    prototype: any;
+};
+export type Parser<T> = {
+    new (any?: any): T;
+    prototype: any;
+    format: ParserFormat;
+};

package/dist/types/util/GridObject.d.ts

@@ -0,0 +1,12 @@
+import { Object3D } from "../core/entities/Object3D";
+/**
+ * 一个包含网格的Object3D - 由二维线条组成
+ * @group Util
+ */
+export declare class GridObject extends Object3D {
+    size: number;
+    divisions: number;
+    constructor(size?: number, divisions?: number);
+    private buildGeometry;
+    private addAxis;
+}

package/dist/types/util/KelvinUtil.d.ts

@@ -0,0 +1,40 @@
+import { Color } from "../math/Color";
+/**
+ * 色温颜色转换器
+ * @group Util
+ */
+export declare class KelvinUtil {
+    /**
+     * 将色温值转换为颜色对象
+     * @param color_temperature_Kelvin 色温值(单位：开尔文)
+     * @returns 返回对应的Color对象
+     */
+    static color_temperature_to_rgb(color_temperature_Kelvin: number): Color;
+    /**
+     * 获取红色分量[0-255]
+     * @param temperature 温度值(百分之一开尔文)
+     * @returns 红色分量值
+     */
+    static get_red(temperature: number): number;
+    /**
+     * 获取绿色分量[0-255]
+     * @param temperature 温度值(百分之一开尔文)
+     * @returns 绿色分量值
+     */
+    static get_green(temperature: number): number;
+    /**
+     * 获取蓝色分量[0-255]
+     * @param temperature 温度值(百分之一开尔文)
+     * @returns 蓝色分量值
+     */
+    static get_blue(temperature: number): number;
+    /**
+     * @internal
+     * 限制颜色分量在指定范围内
+     * @param color_component 颜色分量值
+     * @param minimum 最小值(默认0)
+     * @param maximum 最大值(默认255)
+     * @returns 限制后的颜色分量值
+     */
+    static bound(color_component: number, minimum?: number, maximum?: number): number;
+}

package/dist/types/util/Object3DUtil.d.ts

@@ -0,0 +1,25 @@
+import { Object3D } from "../core/entities/Object3D";
+import { BoxGeometry } from "../shape/BoxGeometry";
+import { SphereGeometry } from "../shape/SphereGeometry";
+import { PointLight } from "../components/lights/PointLight";
+import { Texture } from "../gfx/graphics/webGpu/core/texture/Texture";
+import { Vector3 } from "../math/Vector3";
+import { Material } from "../materials/Material";
+export declare class Object3DUtil {
+    private static boxGeo;
+    private static planeGeo;
+    private static sphere;
+    private static material;
+    private static materialMap;
+    private static initHeap;
+    static get CubeMesh(): BoxGeometry;
+    static get SphereMesh(): SphereGeometry;
+    static GetCube(): Object3D;
+    static GetMaterial(tex: Texture): Material;
+    static GetPlane(tex: Texture): Object3D;
+    static GetSingleCube(sizeX: number, sizeY: number, sizeZ: number, r: number, g: number, b: number): Object3D;
+    static GetSingleSphere(radius: number, r: number, g: number, b: number): Object3D;
+    static get Sphere(): Object3D;
+    static GetSingleCube2(mat: Material, size?: number): Object3D;
+    static GetPointLight(pos: Vector3, rotation: Vector3, radius: number, r: number, g: number, b: number, intensity?: number, castShadow?: boolean): PointLight;
+}

package/dist/types/util/ProfilerUtil.d.ts

@@ -0,0 +1,49 @@
+import { View3D } from "../core/View3D";
+export type ProfilerLabel2 = {
+    lable: string;
+    start: number;
+    end: number;
+    total: number;
+    count: number;
+};
+export type ProfilerLabel = {
+    lable: string;
+    start: number;
+    end: number;
+    total: number;
+    count: number;
+    child: Map<string, ProfilerLabel2>;
+};
+export type ProfilerDraw = {
+    [key: string]: {
+        vertexCount: number;
+        indicesCount: number;
+        triCount: number;
+        instanceCount: number;
+        drawCount: number;
+        pipelineCount: number;
+    };
+};
+export declare class ProfilerUtil {
+    private static profilerLabelMap;
+    static viewMap: Map<View3D, ProfilerDraw>;
+    static testObj: {
+        testValue1: number;
+        testValue2: number;
+        testValue3: number;
+        testValue4: number;
+    };
+    static startView(view: View3D): void;
+    static viewCount(view: View3D): ProfilerDraw;
+    static viewCount_vertex(view: View3D, pass: string, v: number): void;
+    static viewCount_indices(view: View3D, pass: string, v: number): void;
+    static viewCount_tri(view: View3D, pass: string, v: number): void;
+    static viewCount_instance(view: View3D, pass: string, v: number): void;
+    static viewCount_draw(view: View3D, pass: string): void;
+    static viewCount_pipeline(view: View3D, pass: string): void;
+    static start(id: string): void;
+    static end(id: string): void;
+    static countStart(id: string, id2?: string): void;
+    static countEnd(id: string, id2: string): void;
+    static print(id: string): void;
+}

package/dist/types/util/Reference.d.ts

@@ -0,0 +1,37 @@
+/**
+ * instance reference statistics module
+ * apply any instance , used full destroy
+ */
+export declare class Reference {
+    protected reference: Map<any, Map<any, any>>;
+    private static _ins;
+    static getInstance(): Reference;
+    /**
+     * current instance attached from parent instance
+     * @param ref reference current
+     * @param target reference parent
+     */
+    attached(ref: any, target: any): void;
+    /**
+     * current instance detached from parent instance
+     * @param ref reference current
+     * @param target reference parent
+     */
+    detached(ref: any, target: any): void;
+    /**
+     * current instance has reference
+     */
+    hasReference(ref: any): boolean;
+    /**
+     * get current instance reference count
+     * @param ref
+     * @returns
+     */
+    getReferenceCount(ref: any): number;
+    /**
+    * get current instance reference from where
+    * @param ref
+    * @returns
+    */
+    getReference(ref: any): Map<any, any>;
+}

package/dist/types/util/SerializeDecoration.d.ts

@@ -0,0 +1,9 @@
+export type SerializeTag = null | 'self' | 'non';
+export declare function NonSerialize(cls: any, key: any): any;
+export declare function IsNonSerialize<T extends object>(instance: T, key: string): boolean;
+export declare function EditorInspector(cls: any, key: any, p1?: any, p2?: any, p3?: any): any;
+export declare function IsEditorInspector<T extends object>(instance: T): Map<string, any>;
+export declare function RegisterComponent(cls: any, key: any, p1?: any, p2?: any, p3?: any): any;
+export declare function GetComponentClass(name: string): any;
+export declare function RegisterShader(cls: any, key?: any, p1?: any, p2?: any, p3?: any): any;
+export declare function GetShader(name: string): any;

package/dist/types/util/StringUtil.d.ts

@@ -0,0 +1,23 @@
+export declare class StringUtil {
+    private static _filterChar;
+    static hasString(fields: Array<string>, str: string): number;
+    static getEllipsis(str: any, len?: number): string;
+    static getURLName(url: string): string;
+    static getFileFormat(url: string): string;
+    static readLineProperty(line: string, data: any): void;
+    static getPath(url: string): string;
+    static normalizePath(url: string): string;
+    static getStringList(str: string, char?: string): string[];
+    static formatTime(time: number): string[];
+    static trim(str: any): any;
+    static isEmpty(value: any): boolean;
+    static strCut(str: any, len: any): string;
+    static toQueryPair(key: any, value: any, isEncodeURI?: boolean): string;
+    static stringFormat(str: string, ...params: any[]): string;
+    static parseJson2String(json: any, options?: any): string;
+    static compareVersion(v1: any, v2: any): 1 | 0 | -1;
+    static buildRandomCode(): string;
+    static UUID(): string;
+    static stringToHash(str: any): number;
+    static parseUrl(base: string, url: string): string;
+}

package/dist/types/util/Time.d.ts

@@ -0,0 +1,9 @@
+export declare class Time {
+    static time: number;
+    static frame: number;
+    static delta: number;
+    private static _startTime;
+    private static _timeLabel;
+    static start(label: string): void;
+    static end(): void;
+}

package/dist/types/util/Vector3Ex.d.ts

@@ -0,0 +1,16 @@
+import { Vector3 } from "../math/Vector3";
+export declare class Vector3Ex {
+    static add(v1: Vector3, v2: Vector3, target?: Vector3): Vector3;
+    static sub(v1: Vector3, v2: Vector3, target?: Vector3): Vector3;
+    static mul(v1: Vector3, v2: Vector3, target?: Vector3): Vector3;
+    static mulScale(v1: Vector3, v: number, target?: Vector3): Vector3;
+    static div(v1: Vector3, v2: Vector3, target?: Vector3): Vector3;
+    static normalize(v1: Vector3): Vector3;
+    static dot(v1: Vector3, v2: Vector3): number;
+    static calculateVectorAngle_xz(v1: Vector3, v2: Vector3): number;
+    static distance(v1: Vector3, v2: Vector3): number;
+    static getRandomXYZ(min?: number, max?: number): Vector3;
+    static getRandomV3(min: number, max: number, yMin: number, yMax: number): Vector3;
+    static sphere(radius: number): Vector3;
+    static sphereXYZ(radiusMin: number, radiusMax: number, x?: number, y?: number, z?: number): Vector3;
+}

package/dist/types/util/ZSorterUtil.d.ts

@@ -0,0 +1,13 @@
+import { Camera3D } from "../core/Camera3D";
+import { Object3D } from "../core/entities/Object3D";
+export declare class ZSorterUtil {
+    private _pool;
+    private _worldPosition;
+    private _viewPosition;
+    private _zSortList;
+    private pop;
+    private recycle;
+    sort(camera3D: Camera3D, userDataList: any[], getObject3D: (userData: any) => Object3D, result?: any[]): any[];
+    worldToCameraDepth(obj3d: Object3D, camera?: Camera3D): number;
+}
+export declare let zSorterUtil: ZSorterUtil;

package/dist/types/util/struct/Struct.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @internal
+ * @auth sirxu
+ * Basic data structure class
+ * Reasonable arrangement of data structure can accelerate computing performance
+ * @group Util
+ */
+import { Ctor } from "../Global";
+export declare class Struct {
+    private __refection;
+    private __size;
+    /**
+     * get reflection name
+     * @returns
+     */
+    getValueType(): {
+        name: string;
+        type: string;
+    }[];
+    /**
+     * get any type value memory size
+     * @param value any type value
+     * @returns
+     */
+    static getValueSize(value: any): any;
+    private static __cacheStruct;
+    static Ref<T extends Struct>(c: Ctor<T>): {
+        name: string;
+        type: string;
+    }[];
+    static Get<T extends Struct>(c: Ctor<T>): Struct;
+    /**
+     * get any struct memory size
+     * @returns
+     */
+    static GetSize<T extends Struct>(c: Ctor<T>): number;
+}

package/dist/types/util/transformUtil/Object3DTransformTools.d.ts

@@ -0,0 +1,37 @@
+import { TransformControllerBaseComponent } from "./TransformControllerBaseComponent";
+import { TransformMode } from "./TransformMode";
+import { TransformSpaceMode } from "./TransformSpaceMode";
+import { Object3D } from "../../core/entities/Object3D";
+import { Scene3D } from "../../core/Scene3D";
+import { KeyEvent } from "../../event/eventConst/KeyEvent";
+import { PointerEvent3D } from "../../event/eventConst/PointerEvent3D";
+/**
+ * Object3D 转换控制器
+ * @group Controller
+ */
+export declare class Object3DTransformTools extends Object3D {
+    private static _instance;
+    static get instance(): Object3DTransformTools;
+    protected mTarget: Object3D;
+    protected mTransformMode: TransformMode;
+    protected mTransformSpaceType: TransformSpaceMode;
+    protected mControllers: TransformControllerBaseComponent[];
+    mXObj: Object3D;
+    mYObj: Object3D;
+    mZObj: Object3D;
+    constructor();
+    get transformMode(): TransformMode;
+    get transformSpaceMode(): TransformSpaceMode;
+    active(scene: Scene3D): void;
+    unActive(scene: Scene3D): void;
+    get target(): Object3D;
+    selectObject(obj: Object3D, transformMode?: TransformMode, spaceMode?: TransformSpaceMode): void;
+    selectTransformMode(transformMode: TransformMode): void;
+    selectTransformSpaceMode(spaceMode: TransformSpaceMode): void;
+    protected activate(): void;
+    protected unactivate(): void;
+    protected onKeyDown(e: KeyEvent): void;
+    protected onMouseDown(e: PointerEvent3D): void;
+    protected onMouseMove(e: PointerEvent3D): void;
+    protected onMouseUp(e: PointerEvent3D): void;
+}

package/dist/types/util/transformUtil/RotationControlComponents.d.ts

@@ -0,0 +1,21 @@
+import { Object3D } from "../../core/entities/Object3D";
+import { PointerEvent3D } from "../../event/eventConst/PointerEvent3D";
+import { Vector3 } from "../../math/Vector3";
+import { TransformAxisEnum } from "./TransformAxisEnum";
+import { TransformControllerBaseComponent } from "./TransformControllerBaseComponent";
+export declare class RotationControlComponents extends TransformControllerBaseComponent {
+    protected applyLocalTransform(currentAxis: TransformAxisEnum, offset: Vector3, distance: number): void;
+    protected getAngle(): number;
+    protected mLastAngle: number;
+    protected applyGlobalTransform(currentAxis: TransformAxisEnum, offset: Vector3, distance: number): void;
+    onMouseDown(e: PointerEvent3D): void;
+    onMouseUp(e: PointerEvent3D): void;
+    protected createCustomAxis(axis: TransformAxisEnum): Object3D;
+    protected createAxis(axis: TransformAxisEnum): Object3D;
+    protected pickAxis(): {
+        intersectPoint?: Vector3;
+        distance: number;
+        obj: Object3D;
+        axis: TransformAxisEnum;
+    };
+}

package/dist/types/util/transformUtil/ScaleControlComponents.d.ts

@@ -0,0 +1,11 @@
+import { Object3D } from "../../core/entities/Object3D";
+import { Vector3 } from "../../math/Vector3";
+import { TransformAxisEnum } from "./TransformAxisEnum";
+import { TransformControllerBaseComponent } from "./TransformControllerBaseComponent";
+export declare class ScaleControlComponents extends TransformControllerBaseComponent {
+    init(param?: any): void;
+    protected applyLocalTransform(currentAxis: TransformAxisEnum, offset: Vector3, distance: number): void;
+    protected applyGlobalTransform(currentAxis: TransformAxisEnum, offset: Vector3, distance: number): void;
+    protected createCustomAxis(axis: TransformAxisEnum): Object3D;
+    protected createBox(axis: TransformAxisEnum): Object3D;
+}

package/dist/types/util/transformUtil/TransformAxisEnum.d.ts

@@ -0,0 +1,11 @@
+export declare enum TransformAxisEnum {
+    X = 0,
+    Y = 1,
+    Z = 2,
+    XY = 3,
+    XZ = 4,
+    YZ = 5,
+    XYZ = 6,
+    MAX = 7,
+    NONE = 8
+}

package/dist/types/util/transformUtil/TransformControllerBaseComponent.d.ts

@@ -0,0 +1,48 @@
+import { ColliderComponent } from "../../components/ColliderComponent";
+import { ComponentBase } from "../../components/ComponentBase";
+import { View3D } from "../../core/View3D";
+import { Object3D } from "../../core/entities/Object3D";
+import { PointerEvent3D } from "../../event/eventConst/PointerEvent3D";
+import { UnLitMaterial } from "../../materials/UnLitMaterial";
+import { Color } from "../../math/Color";
+import { Vector3 } from "../../math/Vector3";
+import { TransformAxisEnum } from "./TransformAxisEnum";
+import { TransformSpaceMode } from "./TransformSpaceMode";
+export declare class TransformControllerBaseComponent extends ComponentBase {
+    protected mAxis: Object3D[];
+    protected mAxisColor: Color[];
+    protected mContainer: Object3D;
+    protected mAxisMaterial: UnLitMaterial[];
+    protected mAxisCollider: ColliderComponent[];
+    constructor();
+    get target(): Object3D;
+    get mX(): Object3D;
+    get mY(): Object3D;
+    get mZ(): Object3D;
+    get transformSpaceMode(): TransformSpaceMode;
+    init(param?: any): void;
+    start(): void;
+    onEnable(view?: View3D): void;
+    onDisable(view?: View3D): void;
+    reset(): void;
+    protected pickAxis(): {
+        intersectPoint?: Vector3;
+        distance: number;
+        obj: Object3D;
+        axis: TransformAxisEnum;
+    };
+    protected currentAxis: TransformAxisEnum;
+    protected beginPoint: Vector3;
+    protected beginMousePos: Vector3;
+    protected currentPoint: Vector3;
+    onMouseDown(e: PointerEvent3D): void;
+    protected lastMoveObj: Object3D;
+    protected lastMoveAxis: TransformAxisEnum;
+    onMouseMove(e: PointerEvent3D): void;
+    onMouseUp(e: PointerEvent3D): void;
+    onUpdate(view?: View3D): void;
+    protected applyLocalTransform(currentAxis: TransformAxisEnum, offset: Vector3, distance: number): void;
+    protected applyGlobalTransform(currentAxis: TransformAxisEnum, offset: Vector3, distance: number): void;
+    protected createCustomAxis(axis: TransformAxisEnum): Object3D;
+    protected createAxis(axis: TransformAxisEnum): Object3D;
+}

package/dist/types/util/transformUtil/TransformMode.d.ts

@@ -0,0 +1,6 @@
+export declare enum TransformMode {
+    Scale = 0,
+    Rotation = 1,
+    Translation = 2,
+    NONE = 3
+}

package/dist/types/util/transformUtil/TransformSpaceMode.d.ts

@@ -0,0 +1,4 @@
+export declare enum TransformSpaceMode {
+    Local = 0,
+    Global = 1
+}

package/dist/types/util/transformUtil/TranslationControlComponents.d.ts

@@ -0,0 +1,12 @@
+import { Object3D } from "../../core/entities/Object3D";
+import { Vector3 } from "../../math/Vector3";
+import { TransformAxisEnum } from "./TransformAxisEnum";
+import { TransformControllerBaseComponent } from "./TransformControllerBaseComponent";
+export declare class TranslationControlComponents extends TransformControllerBaseComponent {
+    init(param?: any): void;
+    protected applyLocalTransform(currentAxis: TransformAxisEnum, offset: Vector3, distance: number): void;
+    protected applyGlobalTransform(currentAxis: TransformAxisEnum, offset: Vector3, distance: number): void;
+    protected createCustomAxis(axis: TransformAxisEnum): Object3D;
+    protected createArrows(axis: TransformAxisEnum): Object3D;
+    protected createPlane(axis: TransformAxisEnum): Object3D;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rings-webgpu/core",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "Rings webgpu Engine",
   "main": "index.js",
   "exports": {