@vyr/three 0.0.33 → 0.0.35

package/build/descriptor/Mesh.js

@@ -0,0 +1,31 @@
+import { Node } from "@vyr/engine";
+/**
+ * Mesh类
+ * 网格类，用于表示三维场景中的几何体对象
+ *
+ * 作用：作为场景中基本的可渲染对象，由几何体和材质组成
+ * 继承自Node类，拥有节点的所有空间变换属性
+ */
+export class Mesh extends Node {
+    /**类类型标识 */
+    static type = 'Mesh';
+    /**
+     * 材质
+     * 网格的材质，使用`Material`资源的URL作为有效值
+     * @default ""
+     */
+    material;
+    /**
+     * 几何体
+     * 网格的几何体，使用`Geometry`资源的URL作为有效值
+     * @default ""
+     */
+    geometry;
+    constructor(descriptor = {}) {
+        super(descriptor);
+        this.material = Array.isArray(descriptor.material) ? Node.deepClone(descriptor.material) : descriptor.material ?? '';
+        this.geometry = descriptor.geometry ?? '';
+    }
+}
+Node.register(Mesh);
+//# sourceMappingURL=Mesh.js.map

package/build/descriptor/Mesh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Mesh.js","sourceRoot":"","sources":["../../src/descriptor/Mesh.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkD,IAAI,EAAE,MAAM,aAAa,CAAA;AAElF;;;;;;GAMG;AACH,MAAM,OAAO,IAAK,SAAQ,IAAI;IAC1B,WAAW;IACX,MAAM,CAAC,IAAI,GAAG,MAAM,CAAA;IACpB;;;;OAIG;IACH,QAAQ,CAAkC;IAC1C;;;;OAIG;IACH,QAAQ,CAAQ;IAEhB,YAAY,aAAmD,EAAE;QAC7D,KAAK,CAAC,UAAU,CAAC,CAAA;QACjB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,IAAI,EAAE,CAAA;QACpH,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,IAAI,EAAE,CAAA;IAC7C,CAAC;;AAEL,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA"}

package/build/descriptor/Model.d.ts

@@ -0,0 +1,19 @@
+import { DeserializationObject, Node } from "@vyr/engine";
+/**
+ * Model类
+ * 模型类，用于加载和显示外部三维模型文件
+ *
+ * 作用：通过URL加载外部模型文件（如GLTF、GLB等格式）并在场景中显示
+ * 继承自Node类，拥有节点的所有空间变换属性
+ */
+export declare class Model extends Node {
+    /**类类型标识 */
+    static type: string;
+    /**
+     * 模型文件URL
+     * 指向外部模型文件的路径
+     * @default ""
+     */
+    url: string;
+    constructor(descriptor?: Partial<DeserializationObject<Model>>);
+}

package/build/descriptor/Model.js

@@ -0,0 +1,24 @@
+import { Node } from "@vyr/engine";
+/**
+ * Model类
+ * 模型类，用于加载和显示外部三维模型文件
+ *
+ * 作用：通过URL加载外部模型文件（如GLTF、GLB等格式）并在场景中显示
+ * 继承自Node类，拥有节点的所有空间变换属性
+ */
+export class Model extends Node {
+    /**类类型标识 */
+    static type = 'Model';
+    /**
+     * 模型文件URL
+     * 指向外部模型文件的路径
+     * @default ""
+     */
+    url = '';
+    constructor(descriptor = {}) {
+        super(descriptor);
+        this.url = descriptor.url ?? '';
+    }
+}
+Node.register(Model);
+//# sourceMappingURL=Model.js.map

package/build/descriptor/Model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Model.js","sourceRoot":"","sources":["../../src/descriptor/Model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,IAAI,EAAE,MAAM,aAAa,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,OAAO,KAAM,SAAQ,IAAI;IAC3B,WAAW;IACX,MAAM,CAAC,IAAI,GAAG,OAAO,CAAA;IAErB;;;;OAIG;IACH,GAAG,GAAG,EAAE,CAAA;IAER,YAAY,aAAoD,EAAE;QAC9D,KAAK,CAAC,UAAU,CAAC,CAAA;QACjB,IAAI,CAAC,GAAG,GAAG,UAAU,CAAC,GAAG,IAAI,EAAE,CAAA;IACnC,CAAC;;AAEL,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA"}

package/build/descriptor/OrbitController.d.ts

@@ -0,0 +1,156 @@
+import { Controller, Descriptor, DeserializationObject, ScriptableArgs } from "@vyr/engine";
+/**
+ * OrbitController变更事件参数接口
+ * 定义了轨道控制器事件的参数结构
+ */
+export interface OrbitControllerChangeArgs extends ScriptableArgs {
+    /**事件信息 */
+    event: {
+        /**事件类型 */
+        type: string;
+        /**目标UUID */
+        target: string;
+    };
+}
+/**
+ * OrbitController类
+ * 轨道控制器类，用于控制相机的轨道运动
+ *
+ * 作用：提供相机的旋转、缩放、平移等交互控制功能
+ * 实现了Controller接口，可作为场景中的控制器使用
+ */
+export declare class OrbitController extends Descriptor implements Controller {
+    /**类类型标识 */
+    static type: string;
+    /**
+     * 控制器是否启用
+     * @default false
+     */
+    enabled: boolean;
+    /**
+     * 最小距离
+     * 你能够将相机向内移动多少
+     * @default 0
+     */
+    minDistance: number;
+    /**
+     * 最大距离
+     * 你能够将相机向外移动多少
+     * @default Infinity
+     */
+    maxDistance: number;
+    /**
+     * 最小缩放
+     * 你能够将相机放大多少
+     * @default 0.01
+     */
+    minZoom: number;
+    /**
+     * 最大缩放
+     * 你能够将相机缩小多少
+     * @default Infinity
+     */
+    maxZoom: number;
+    /**
+     * 最小极角
+     * 你能够垂直旋转的角度的下限
+     * @default 0
+     */
+    minPolarAngle: number;
+    /**
+     * 最大极角
+     * 你能够垂直旋转的角度的上限
+     * @default Math.PI * 2
+     */
+    maxPolarAngle: number;
+    /**
+     * 最小方位角
+     * 你能够水平旋转的角度下限
+     * @default -Infinity
+     */
+    minAzimuthAngle: number;
+    /**
+     * 最大方位角
+     * 你能够水平旋转的角度上限
+     * @default Infinity
+     */
+    maxAzimuthAngle: number;
+    /**
+     * 边界摩擦系数
+     * @default 0
+     */
+    boundaryFriction: number;
+    /**
+     * 边界是否包围相机
+     * 相机位置是否应包含在边界内
+     * @default false
+     */
+    boundaryEnclosesCamera: boolean;
+    /**
+     * 平滑时间
+     * 到达目标的近似时间（秒），值越小到达目标越快
+     * @default 0.25
+     */
+    smoothTime: number;
+    /**
+     * 拖动平滑时间
+     * 拖动时的平滑时间
+     * @default 0.125
+     */
+    draggingSmoothTime: number;
+    /**
+     * 方位角旋转速度
+     * 水平旋转速度
+     * @default 1
+     */
+    azimuthRotateSpeed: number;
+    /**
+     * 极角旋转速度
+     * 垂直旋转速度
+     * @default 1
+     */
+    polarRotateSpeed: number;
+    /**
+     * 缩放速度
+     * 鼠标滚轮移动速度
+     * @default 1
+     */
+    dollySpeed: number;
+    /**
+     * 平移速度
+     * 平移和升降的拖动速度
+     * @default 2
+     */
+    truckSpeed: number;
+    /**
+     * 向光标缩放
+     * 是否启用向鼠标光标坐标移动
+     * @default false
+     */
+    dollyToCursor: boolean;
+    /**
+     * 反转缩放方向
+     * 是否反转拖动时的移动或缩放方向
+     * @default false
+     */
+    dollyDragInverted: boolean;
+    /**
+     * 无限缩放
+     * 是否启用滚轮和缩放的无限移动，与 minDistance 和 maxDistance 一起使用
+     * @default false
+     */
+    infinityDolly: boolean;
+    /**
+     * 静止阈值
+     * 控制相机减速时 rest 事件触发的时机
+     * @default 0.0025
+     */
+    restThreshold: number;
+    /**
+     * 事件脚本
+     * 控制器触发事件时执行的脚本依赖
+     * @default ""
+     */
+    event: string;
+    constructor(descriptor?: Partial<DeserializationObject<OrbitController>>);
+}

package/build/descriptor/OrbitController.js

@@ -0,0 +1,169 @@
+import { Descriptor } from "@vyr/engine";
+/**
+ * OrbitController类
+ * 轨道控制器类，用于控制相机的轨道运动
+ *
+ * 作用：提供相机的旋转、缩放、平移等交互控制功能
+ * 实现了Controller接口，可作为场景中的控制器使用
+ */
+export class OrbitController extends Descriptor {
+    /**类类型标识 */
+    static type = 'OrbitController';
+    /**
+     * 控制器是否启用
+     * @default false
+     */
+    enabled;
+    /**
+     * 最小距离
+     * 你能够将相机向内移动多少
+     * @default 0
+     */
+    minDistance;
+    /**
+     * 最大距离
+     * 你能够将相机向外移动多少
+     * @default Infinity
+     */
+    maxDistance;
+    /**
+     * 最小缩放
+     * 你能够将相机放大多少
+     * @default 0.01
+     */
+    minZoom;
+    /**
+     * 最大缩放
+     * 你能够将相机缩小多少
+     * @default Infinity
+     */
+    maxZoom;
+    /**
+     * 最小极角
+     * 你能够垂直旋转的角度的下限
+     * @default 0
+     */
+    minPolarAngle;
+    /**
+     * 最大极角
+     * 你能够垂直旋转的角度的上限
+     * @default Math.PI * 2
+     */
+    maxPolarAngle;
+    /**
+     * 最小方位角
+     * 你能够水平旋转的角度下限
+     * @default -Infinity
+     */
+    minAzimuthAngle;
+    /**
+     * 最大方位角
+     * 你能够水平旋转的角度上限
+     * @default Infinity
+     */
+    maxAzimuthAngle;
+    /**
+     * 边界摩擦系数
+     * @default 0
+     */
+    boundaryFriction;
+    /**
+     * 边界是否包围相机
+     * 相机位置是否应包含在边界内
+     * @default false
+     */
+    boundaryEnclosesCamera;
+    /**
+     * 平滑时间
+     * 到达目标的近似时间（秒），值越小到达目标越快
+     * @default 0.25
+     */
+    smoothTime;
+    /**
+     * 拖动平滑时间
+     * 拖动时的平滑时间
+     * @default 0.125
+     */
+    draggingSmoothTime;
+    /**
+     * 方位角旋转速度
+     * 水平旋转速度
+     * @default 1
+     */
+    azimuthRotateSpeed;
+    /**
+     * 极角旋转速度
+     * 垂直旋转速度
+     * @default 1
+     */
+    polarRotateSpeed;
+    /**
+     * 缩放速度
+     * 鼠标滚轮移动速度
+     * @default 1
+     */
+    dollySpeed;
+    /**
+     * 平移速度
+     * 平移和升降的拖动速度
+     * @default 2
+     */
+    truckSpeed;
+    /**
+     * 向光标缩放
+     * 是否启用向鼠标光标坐标移动
+     * @default false
+     */
+    dollyToCursor;
+    /**
+     * 反转缩放方向
+     * 是否反转拖动时的移动或缩放方向
+     * @default false
+     */
+    dollyDragInverted;
+    /**
+     * 无限缩放
+     * 是否启用滚轮和缩放的无限移动，与 minDistance 和 maxDistance 一起使用
+     * @default false
+     */
+    infinityDolly;
+    /**
+     * 静止阈值
+     * 控制相机减速时 rest 事件触发的时机
+     * @default 0.0025
+     */
+    restThreshold;
+    /**
+     * 事件脚本
+     * 控制器触发事件时执行的脚本依赖
+     * @default ""
+     */
+    event;
+    constructor(descriptor = {}) {
+        super(descriptor);
+        this.enabled = descriptor.enabled ?? false;
+        this.minDistance = descriptor.minDistance ?? 0;
+        this.maxDistance = descriptor.maxDistance ?? Infinity;
+        this.minPolarAngle = descriptor.minPolarAngle ?? 0;
+        this.maxPolarAngle = descriptor.maxPolarAngle ?? Math.PI * 2;
+        this.minAzimuthAngle = descriptor.minAzimuthAngle ?? -Infinity;
+        this.maxAzimuthAngle = descriptor.maxAzimuthAngle ?? Infinity;
+        this.minZoom = descriptor.minZoom ?? 0.01;
+        this.maxZoom = descriptor.maxZoom ?? Infinity;
+        this.boundaryFriction = descriptor.boundaryFriction ?? 0;
+        this.boundaryEnclosesCamera = descriptor.boundaryEnclosesCamera ?? false;
+        this.smoothTime = descriptor.smoothTime ?? 0.25;
+        this.draggingSmoothTime = descriptor.draggingSmoothTime ?? 0.125;
+        this.azimuthRotateSpeed = descriptor.azimuthRotateSpeed ?? 1;
+        this.polarRotateSpeed = descriptor.polarRotateSpeed ?? 1;
+        this.dollySpeed = descriptor.dollySpeed ?? 1;
+        this.truckSpeed = descriptor.truckSpeed ?? 2;
+        this.dollyToCursor = descriptor.dollyToCursor ?? false;
+        this.dollyDragInverted = descriptor.dollyDragInverted ?? false;
+        this.infinityDolly = descriptor.infinityDolly ?? false;
+        this.restThreshold = descriptor.restThreshold ?? 0.0025;
+        this.event = descriptor.event ?? '';
+    }
+}
+Descriptor.register(OrbitController);
+//# sourceMappingURL=OrbitController.js.map

package/build/descriptor/OrbitController.js.map

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

package/build/descriptor/OrthographicCamera.d.ts

@@ -0,0 +1,14 @@
+import { Camera, DeserializationObject, Node } from "@vyr/engine";
+/**
+ * OrthographicCamera类
+ * 正交相机类，用于创建正交投影的相机
+ *
+ * 作用：创建正交投影的相机，适用于2D场景或需要保持物体大小不变的3D场景
+ * 继承自Node类，拥有节点的所有空间变换属性
+ * 实现了Camera接口，可作为场景的相机使用
+ */
+export declare class OrthographicCamera extends Node implements Camera {
+    /**类类型标识 */
+    static type: string;
+    constructor(descriptor?: Partial<DeserializationObject<OrthographicCamera>>);
+}

package/build/descriptor/OrthographicCamera.js

@@ -0,0 +1,18 @@
+import { Node } from "@vyr/engine";
+/**
+ * OrthographicCamera类
+ * 正交相机类，用于创建正交投影的相机
+ *
+ * 作用：创建正交投影的相机，适用于2D场景或需要保持物体大小不变的3D场景
+ * 继承自Node类，拥有节点的所有空间变换属性
+ * 实现了Camera接口，可作为场景的相机使用
+ */
+export class OrthographicCamera extends Node {
+    /**类类型标识 */
+    static type = 'OrthographicCamera';
+    constructor(descriptor = {}) {
+        super(descriptor);
+    }
+}
+Node.register(OrthographicCamera);
+//# sourceMappingURL=OrthographicCamera.js.map

package/build/descriptor/OrthographicCamera.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrthographicCamera.js","sourceRoot":"","sources":["../../src/descriptor/OrthographicCamera.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,IAAI,EAAE,MAAM,aAAa,CAAA;AAEjE;;;;;;;GAOG;AACH,MAAM,OAAO,kBAAmB,SAAQ,IAAI;IACxC,WAAW;IACX,MAAM,CAAC,IAAI,GAAG,oBAAoB,CAAA;IAElC,YAAY,aAAiE,EAAE;QAC3E,KAAK,CAAC,UAAU,CAAC,CAAA;IACrB,CAAC;;AAEL,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAA"}

package/build/descriptor/Particle.d.ts

@@ -0,0 +1,144 @@
+import { DeserializationObject, Euler, Node, Vector3 } from "@vyr/engine";
+/**
+ * Particle类
+ * 粒子类，用于创建和控制粒子系统
+ *
+ * 作用：通过配置参数创建各种粒子效果，如烟雾、火焰、雨滴等
+ * 继承自Node类，拥有节点的所有空间变换属性
+ */
+export declare class Particle extends Node {
+    /**类类型标识 */
+    static type: string;
+    /**
+     * 粒子数量
+     * @default 0
+     */
+    count: number;
+    /**
+     * 轨迹数据引用，使用`Store`的URL作为有效值
+     * @default ""
+     */
+    track: string;
+    /**
+     * 粒子运行时间
+     * @default 0
+     */
+    duration: number;
+    /**
+     * 最小粒子尺寸
+     * @default 1
+     */
+    minSize: number;
+    /**
+     * 最大粒子尺寸
+     * @default 1
+     */
+    maxSize: number;
+    /**
+     * 最小轨迹偏移
+     * @default {x:0,y:0,z:0}
+     */
+    minTrackOffset: Vector3;
+    /**
+     * 最大轨迹偏移
+     * @default {x:0,y:0,z:0}
+     */
+    maxTrackOffset: Vector3;
+    /**
+     * 最小轨迹缩放
+     * @default {x:1,y:1,z:1}
+     */
+    minTrackScale: Vector3;
+    /**
+     * 最大轨迹缩放
+     * @default {x:1,y:1,z:1}
+     */
+    maxTrackScale: Vector3;
+    /**
+     * 最小轨迹旋转
+     * @default {x:0,y:0,z:0,order:'XYZ'}
+     */
+    minTrackRotation: Euler;
+    /**
+     * 最大轨迹旋转
+     * @default {x:0,y:0,z:0,order:'XYZ'}
+     */
+    maxTrackRotation: Euler;
+    /**
+     * 透明度测试
+     * @default 0
+     */
+    alphaTest: number;
+    /**
+     * 材质是否透明
+     * @default false
+     */
+    transparent: boolean;
+    /**
+     * 材质类型
+     * @default MaterialSide.FrontSide
+     */
+    side: number;
+    /**
+     * 是否渲染材质的颜色
+     * @default true
+     */
+    colorWrite: boolean;
+    /**
+     * 是否启用深度测试
+     * @default true
+     */
+    depthTest: boolean;
+    /**
+     * 是否写入深度
+     * @default true
+     */
+    depthWrite: boolean;
+    /**
+     * 深度函数
+     * @default MaterialDepthFunc.LessEqualDepth
+     */
+    depthFunc: number;
+    /**
+     * 混合函数
+     * 混合效果见 https://threejs.org/examples/#webgl_materials_blending
+     * @default MaterialDlending.NormalBlending
+     */
+    blending: number;
+    /**
+     * 是否使用顶点着色
+     * @default false
+     */
+    vertexColors: boolean;
+    /**
+     * 漫反射颜色
+     * @default '#ffffff'
+     */
+    color: string;
+    /**
+     * 透明度
+     * @default 1
+     */
+    opacity: number;
+    /**
+     * 漫反射贴图
+     * @default ""
+     */
+    map: string;
+    /**
+     * 透明度贴图
+     * @default ""
+     */
+    alphaMap: string;
+    /**
+     * 点的大小是否会被相机深度衰减
+     * @default true
+     */
+    sizeAttenuation: boolean;
+    /**
+     * 材质是否受雾影响
+     * @default true
+     */
+    fog: boolean;
+    constructor(descriptor?: Partial<DeserializationObject<Particle>>);
+}