@vyr/three 0.0.33 → 0.0.35

package/build/descriptor/Particle.js

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

package/build/descriptor/Particle.js.map

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

package/build/descriptor/Pass.d.ts

@@ -0,0 +1,41 @@
+import { Descriptor, DeserializationObject } from "@vyr/engine";
+/**
+ * 效果通道接口
+ * 定义了渲染通道中的效果
+ */
+export interface EffectPass {
+}
+/**
+ * Pass类
+ * 渲染通道类，用于后期处理效果
+ *
+ * 作用：作为后期处理的基本单元，包含各种渲染效果
+ * 继承自Descriptor类，拥有描述器的所有属性和方法
+ *
+ * TODO 继续实现渲染通道
+ */
+export declare class Pass extends Descriptor {
+    /**类类型标识 */
+    static type: string;
+    /**
+     * 是否启用通道
+     * @default true
+     */
+    enabled: boolean;
+    /**
+     * 是否需要交换缓冲
+     * @default false
+     */
+    needsSwap: boolean;
+    /**
+     * 是否需要为此材质准备深度纹理
+     * @default false
+     */
+    needsDepthTexture: boolean;
+    /**
+     * 该通道的效果
+     * @default []
+     */
+    effects: EffectPass[];
+    constructor(descriptor?: Partial<DeserializationObject<Pass>>);
+}

package/build/descriptor/Pass.js

@@ -0,0 +1,43 @@
+import { Descriptor } from "@vyr/engine";
+/**
+ * Pass类
+ * 渲染通道类，用于后期处理效果
+ *
+ * 作用：作为后期处理的基本单元，包含各种渲染效果
+ * 继承自Descriptor类，拥有描述器的所有属性和方法
+ *
+ * TODO 继续实现渲染通道
+ */
+export class Pass extends Descriptor {
+    /**类类型标识 */
+    static type = 'Pass';
+    /**
+     * 是否启用通道
+     * @default true
+     */
+    enabled;
+    /**
+     * 是否需要交换缓冲
+     * @default false
+     */
+    needsSwap;
+    /**
+     * 是否需要为此材质准备深度纹理
+     * @default false
+     */
+    needsDepthTexture;
+    /**
+     * 该通道的效果
+     * @default []
+     */
+    effects;
+    constructor(descriptor = {}) {
+        super(descriptor);
+        this.enabled = descriptor.enabled ?? true;
+        this.needsSwap = descriptor.needsSwap ?? false;
+        this.needsDepthTexture = descriptor.needsDepthTexture ?? false;
+        this.effects = descriptor.effects ? Descriptor.deepClone(descriptor.effects) : [];
+    }
+}
+Descriptor.register(Pass);
+//# sourceMappingURL=Pass.js.map

package/build/descriptor/Pass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Pass.js","sourceRoot":"","sources":["../../src/descriptor/Pass.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAyB,MAAM,aAAa,CAAC;AAUhE;;;;;;;;GAQG;AACH,MAAM,OAAO,IAAK,SAAQ,UAAU;IAChC,WAAW;IACX,MAAM,CAAC,IAAI,GAAG,MAAM,CAAA;IAEpB;;;OAGG;IACH,OAAO,CAAS;IAChB;;;OAGG;IACH,SAAS,CAAS;IAClB;;;OAGG;IACH,iBAAiB,CAAS;IAC1B;;;OAGG;IACH,OAAO,CAAc;IAErB,YAAY,aAAmD,EAAE;QAC7D,KAAK,CAAC,UAAU,CAAC,CAAA;QACjB,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,IAAI,IAAI,CAAA;QACzC,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,IAAI,KAAK,CAAA;QAC9C,IAAI,CAAC,iBAAiB,GAAG,UAAU,CAAC,iBAAiB,IAAI,KAAK,CAAA;QAC9D,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IACrF,CAAC;;AAGL,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA"}

package/build/descriptor/PerspectiveCamera.d.ts

@@ -0,0 +1,20 @@
+import { Camera, DeserializationObject, Node } from "@vyr/engine";
+/**
+ * PerspectiveCamera类
+ * 透视相机类，用于创建透视投影的相机
+ *
+ * 作用：创建具有透视效果的相机，适用于大多数3D场景
+ * 继承自Node类，拥有节点的所有空间变换属性
+ * 实现了Camera接口，可作为场景的相机使用
+ */
+export declare class PerspectiveCamera extends Node implements Camera {
+    /**类类型标识 */
+    static type: string;
+    /**
+     * 视场角
+     * 相机的垂直视场角，以度为单位
+     * @default 45
+     */
+    fov: number;
+    constructor(descriptor?: Partial<DeserializationObject<PerspectiveCamera>>);
+}

package/build/descriptor/PerspectiveCamera.js

@@ -0,0 +1,25 @@
+import { Node } from "@vyr/engine";
+/**
+ * PerspectiveCamera类
+ * 透视相机类，用于创建透视投影的相机
+ *
+ * 作用：创建具有透视效果的相机，适用于大多数3D场景
+ * 继承自Node类，拥有节点的所有空间变换属性
+ * 实现了Camera接口，可作为场景的相机使用
+ */
+export class PerspectiveCamera extends Node {
+    /**类类型标识 */
+    static type = 'PerspectiveCamera';
+    /**
+     * 视场角
+     * 相机的垂直视场角，以度为单位
+     * @default 45
+     */
+    fov;
+    constructor(descriptor = {}) {
+        super(descriptor);
+        this.fov = descriptor.fov ?? 45;
+    }
+}
+Node.register(PerspectiveCamera);
+//# sourceMappingURL=PerspectiveCamera.js.map

package/build/descriptor/PerspectiveCamera.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerspectiveCamera.js","sourceRoot":"","sources":["../../src/descriptor/PerspectiveCamera.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,IAAI,EAAE,MAAM,aAAa,CAAA;AAEjE;;;;;;;GAOG;AACH,MAAM,OAAO,iBAAkB,SAAQ,IAAI;IACvC,WAAW;IACX,MAAM,CAAC,IAAI,GAAG,mBAAmB,CAAA;IAEjC;;;;OAIG;IACH,GAAG,CAAQ;IAEX,YAAY,aAAgE,EAAE;QAC1E,KAAK,CAAC,UAAU,CAAC,CAAA;QACjB,IAAI,CAAC,GAAG,GAAG,UAAU,CAAC,GAAG,IAAI,EAAE,CAAA;IACnC,CAAC;;AAEL,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAA"}

package/build/descriptor/Points.d.ts

@@ -0,0 +1,25 @@
+import { DeserializationObject, Node } from "@vyr/engine";
+/**
+ * Points类
+ * 点云类，用于创建和显示点云对象
+ *
+ * 作用：通过几何体和材质创建点云效果，可用于表示粒子系统、点数据集等
+ * 继承自Node类，拥有节点的所有空间变换属性
+ */
+export declare class Points extends Node {
+    /**类类型标识 */
+    static type: string;
+    /**
+     * 材质
+     * 点云的材质，使用`Material`资源的URL作为有效值
+     * @default ""
+     */
+    material: string;
+    /**
+     * 几何体
+     * 点云的几何体，使用`Geometry`资源的URL作为有效值
+     * @default ""
+     */
+    geometry: string;
+    constructor(descriptor?: Partial<DeserializationObject<Points>>);
+}

package/build/descriptor/Points.js

@@ -0,0 +1,31 @@
+import { Node } from "@vyr/engine";
+/**
+ * Points类
+ * 点云类，用于创建和显示点云对象
+ *
+ * 作用：通过几何体和材质创建点云效果，可用于表示粒子系统、点数据集等
+ * 继承自Node类，拥有节点的所有空间变换属性
+ */
+export class Points extends Node {
+    /**类类型标识 */
+    static type = 'Points';
+    /**
+     * 材质
+     * 点云的材质，使用`Material`资源的URL作为有效值
+     * @default ""
+     */
+    material;
+    /**
+     * 几何体
+     * 点云的几何体，使用`Geometry`资源的URL作为有效值
+     * @default ""
+     */
+    geometry;
+    constructor(descriptor = {}) {
+        super(descriptor);
+        this.material = descriptor.material ?? '';
+        this.geometry = descriptor.geometry ?? '';
+    }
+}
+Node.register(Points);
+//# sourceMappingURL=Points.js.map

package/build/descriptor/Points.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Points.js","sourceRoot":"","sources":["../../src/descriptor/Points.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,IAAI,EAAE,MAAM,aAAa,CAAA;AAEzD;;;;;;GAMG;AACH,MAAM,OAAO,MAAO,SAAQ,IAAI;IAC5B,WAAW;IACX,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAA;IACtB;;;;OAIG;IACH,QAAQ,CAAQ;IAChB;;;;OAIG;IACH,QAAQ,CAAQ;IAEhB,YAAY,aAAqD,EAAE;QAC/D,KAAK,CAAC,UAAU,CAAC,CAAA;QACjB,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,IAAI,EAAE,CAAA;QACzC,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,IAAI,EAAE,CAAA;IAC7C,CAAC;;AAEL,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA"}

package/build/descriptor/Scene3DService.d.ts

@@ -0,0 +1,62 @@
+import { Descriptor, DeserializationObject, HtmlAttributes, Service } from "@vyr/engine";
+/**
+ * 场景阴影类型枚举
+ * 定义了不同质量的阴影贴图类型
+ */
+export declare enum SceneShadow {
+    /**基础阴影贴图，性能最佳但质量较低 */
+    BasicShadowMap = 0,
+    /**PCF阴影贴图，平衡性能与质量 */
+    PCFShadowMap = 1,
+    /**PCF软阴影贴图，质量较高但性能消耗较大 */
+    PCFSoftShadowMap = 2,
+    /**VSM阴影贴图，支持透明物体阴影 */
+    VSMShadowMap = 3
+}
+/**
+ * SceneService类
+ * 三维场景渲染服务
+ *
+ * 作用：负责管理三维节点（如Node、Mesh、Model等）的渲染。必须作为Scene的直接子节点挂载，
+ * 否则所有三维节点将无法正常渲染。
+ *
+ * 使用要求：
+ * 1. 必须添加为Scene的子节点
+ * 2. 在场景中仅需一个实例
+ * 3. 应在其他三维节点之前初始化
+ *
+ * @example
+ * // 场景结构示例
+ * Scene
+ * └── Scene3DService  // 必须在此位置
+ *     └── Mesh          // 依赖此服务才能渲染
+ */
+export declare class Scene3DService extends Descriptor implements Service {
+    /**类类型标识 */
+    static type: string;
+    readonly isHTML = true;
+    visible: boolean;
+    htmlAttributes: HtmlAttributes;
+    /**
+     * 是否开启阴影贴图
+     * @default true
+     */
+    shadowMap: boolean;
+    /**
+     * 阴影贴图类型
+     * @default SceneShadow.BasicShadowMap
+     */
+    shadowMapType: SceneShadow;
+    /**
+     * 是否自动更新阴影贴图
+     * @default false
+     */
+    autoUpdateShadowMap: boolean;
+    /**
+     * 背景贴图
+     * 使用`Texture`资源的URL作为有效值
+     * @default ""
+     */
+    backgroundMap: string;
+    constructor(descriptor?: Partial<DeserializationObject<Scene3DService>>);
+}

package/build/descriptor/Scene3DService.js

@@ -0,0 +1,74 @@
+import { Descriptor, HtmlAttributesSchema, registerService } from "@vyr/engine";
+/**
+ * 场景阴影类型枚举
+ * 定义了不同质量的阴影贴图类型
+ */
+export var SceneShadow;
+(function (SceneShadow) {
+    /**基础阴影贴图，性能最佳但质量较低 */
+    SceneShadow[SceneShadow["BasicShadowMap"] = 0] = "BasicShadowMap";
+    /**PCF阴影贴图，平衡性能与质量 */
+    SceneShadow[SceneShadow["PCFShadowMap"] = 1] = "PCFShadowMap";
+    /**PCF软阴影贴图，质量较高但性能消耗较大 */
+    SceneShadow[SceneShadow["PCFSoftShadowMap"] = 2] = "PCFSoftShadowMap";
+    /**VSM阴影贴图，支持透明物体阴影 */
+    SceneShadow[SceneShadow["VSMShadowMap"] = 3] = "VSMShadowMap";
+})(SceneShadow || (SceneShadow = {}));
+/**
+ * SceneService类
+ * 三维场景渲染服务
+ *
+ * 作用：负责管理三维节点（如Node、Mesh、Model等）的渲染。必须作为Scene的直接子节点挂载，
+ * 否则所有三维节点将无法正常渲染。
+ *
+ * 使用要求：
+ * 1. 必须添加为Scene的子节点
+ * 2. 在场景中仅需一个实例
+ * 3. 应在其他三维节点之前初始化
+ *
+ * @example
+ * // 场景结构示例
+ * Scene
+ * └── Scene3DService  // 必须在此位置
+ *     └── Mesh          // 依赖此服务才能渲染
+ */
+export class Scene3DService extends Descriptor {
+    /**类类型标识 */
+    static type = 'Scene3DService';
+    isHTML = true;
+    visible;
+    htmlAttributes;
+    /**
+     * 是否开启阴影贴图
+     * @default true
+     */
+    shadowMap;
+    /**
+     * 阴影贴图类型
+     * @default SceneShadow.BasicShadowMap
+     */
+    shadowMapType;
+    /**
+     * 是否自动更新阴影贴图
+     * @default false
+     */
+    autoUpdateShadowMap;
+    /**
+     * 背景贴图
+     * 使用`Texture`资源的URL作为有效值
+     * @default ""
+     */
+    backgroundMap;
+    constructor(descriptor = {}) {
+        super(descriptor);
+        this.visible = descriptor.visible ?? true;
+        this.htmlAttributes = HtmlAttributesSchema.parse(descriptor.htmlAttributes);
+        this.shadowMap = descriptor.shadowMap ?? true;
+        this.shadowMapType = descriptor.shadowMapType ?? SceneShadow.BasicShadowMap;
+        this.autoUpdateShadowMap = descriptor.autoUpdateShadowMap ?? false;
+        this.backgroundMap = descriptor.backgroundMap ?? '';
+    }
+}
+Descriptor.register(Scene3DService);
+registerService(Scene3DService.type);
+//# sourceMappingURL=Scene3DService.js.map

package/build/descriptor/Scene3DService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Scene3DService.js","sourceRoot":"","sources":["../../src/descriptor/Scene3DService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAyC,oBAAoB,EAAE,eAAe,EAAW,MAAM,aAAa,CAAA;AAE/H;;;GAGG;AACH,MAAM,CAAN,IAAY,WASX;AATD,WAAY,WAAW;IACnB,sBAAsB;IACtB,iEAAkB,CAAA;IAClB,qBAAqB;IACrB,6DAAgB,CAAA;IAChB,0BAA0B;IAC1B,qEAAoB,CAAA;IACpB,sBAAsB;IACtB,6DAAgB,CAAA;AACpB,CAAC,EATW,WAAW,KAAX,WAAW,QAStB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,cAAe,SAAQ,UAAU;IAC1C,WAAW;IACX,MAAM,CAAC,IAAI,GAAG,gBAAgB,CAAA;IAErB,MAAM,GAAG,IAAI,CAAA;IAEtB,OAAO,CAAS;IAEhB,cAAc,CAAgB;IAE9B;;;OAGG;IACH,SAAS,CAAS;IAClB;;;OAGG;IACH,aAAa,CAAa;IAC1B;;;OAGG;IACH,mBAAmB,CAAS;IAC5B;;;;OAIG;IACH,aAAa,CAAQ;IAErB,YAAY,aAA6D,EAAE;QACvE,KAAK,CAAC,UAAU,CAAC,CAAA;QACjB,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,IAAI,IAAI,CAAA;QACzC,IAAI,CAAC,cAAc,GAAG,oBAAoB,CAAC,KAAK,CAAC,UAAU,CAAC,cAAc,CAAC,CAAA;QAC3E,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,IAAI,IAAI,CAAA;QAC7C,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC,aAAa,IAAI,WAAW,CAAC,cAAc,CAAA;QAC3E,IAAI,CAAC,mBAAmB,GAAG,UAAU,CAAC,mBAAmB,IAAI,KAAK,CAAA;QAClE,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC,aAAa,IAAI,EAAE,CAAA;IACvD,CAAC;;AAGL,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAA;AACnC,eAAe,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA"}

package/build/descriptor/Sprite.d.ts

@@ -0,0 +1,20 @@
+import { DeserializationObject, Node, Vector2 } from "@vyr/engine";
+/**
+ * Sprite类
+ * 精灵对象，用于2D图像渲染
+ *
+ * 作用：创建和管理精灵实例，支持设置材质和中心点
+ */
+export declare class Sprite extends Node {
+    /**类类型标识 */
+    static type: string;
+    /**精灵的材质，使用`Material`资源的URL作为有效值
+     *  @default ""
+     */
+    material: string;
+    /**精灵中心点坐标，范围0-1
+     *  @default {x:0.5, y:0.5}
+     */
+    center: Vector2;
+    constructor(descriptor?: Partial<DeserializationObject<Sprite>>);
+}

package/build/descriptor/Sprite.js

@@ -0,0 +1,26 @@
+import { Node, Vector2 } from "@vyr/engine";
+/**
+ * Sprite类
+ * 精灵对象，用于2D图像渲染
+ *
+ * 作用：创建和管理精灵实例，支持设置材质和中心点
+ */
+export class Sprite extends Node {
+    /**类类型标识 */
+    static type = 'Sprite';
+    /**精灵的材质，使用`Material`资源的URL作为有效值
+     *  @default ""
+     */
+    material;
+    /**精灵中心点坐标，范围0-1
+     *  @default {x:0.5, y:0.5}
+     */
+    center;
+    constructor(descriptor = {}) {
+        super(descriptor);
+        this.material = descriptor.material ?? '';
+        this.center = descriptor.center ? Vector2.create(descriptor.center) : Vector2.create(0.5, 0.5);
+    }
+}
+Node.register(Sprite);
+//# sourceMappingURL=Sprite.js.map

package/build/descriptor/Sprite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sprite.js","sourceRoot":"","sources":["../../src/descriptor/Sprite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,IAAI,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAElE;;;;;GAKG;AACH,MAAM,OAAO,MAAO,SAAQ,IAAI;IAC5B,WAAW;IACX,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAA;IACtB;;OAEG;IACH,QAAQ,CAAQ;IAChB;;OAEG;IACH,MAAM,CAAS;IAEf,YAAY,aAAqD,EAAE;QAC/D,KAAK,CAAC,UAAU,CAAC,CAAA;QACjB,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,IAAI,EAAE,CAAA;QACzC,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;IAClG,CAAC;;AAEL,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA"}

package/build/descriptor/Text3D.d.ts

@@ -0,0 +1,34 @@
+import { DeserializationObject, Node } from '@vyr/engine';
+/**
+ * Text类
+ * 文本节点，用于渲染3D文本
+ *
+ * 作用：创建和管理3D文本实例，支持设置字体、大小、行高等属性
+ */
+export declare class Text3D extends Node {
+    /**类类型标识 */
+    static type: string;
+    /**字体资源，指向字体文件的URL @default "" */
+    font: string;
+    /**文本大小 @default 1 */
+    size: number;
+    /**文本最大宽度，超过会自动换行 @default Infinity */
+    maxWidth: number;
+    /**行高倍数 @default 1.5 */
+    lineHeight: number;
+    /**字符间距 @default 0 */
+    letterSpacing: number;
+    /**文本内容 @default "" */
+    text: string;
+    /**是否将UV展平到平面 @default false */
+    flattenUVsToPlane: boolean;
+    /**曲线分段数，影响文本平滑度 @default 12 */
+    curveSegments: number;
+    /**文本厚度方向的步数 @default 1 */
+    steps: number;
+    /**文本厚度 @default 1 */
+    depth: number;
+    /**材质引用，指向材质资源的唯一标识 @default "" */
+    material: string;
+    constructor(descriptor?: Partial<DeserializationObject<Text3D>>);
+}

package/build/descriptor/Text3D.js

@@ -0,0 +1,49 @@
+import { Node } from '@vyr/engine';
+/**
+ * Text类
+ * 文本节点，用于渲染3D文本
+ *
+ * 作用：创建和管理3D文本实例，支持设置字体、大小、行高等属性
+ */
+export class Text3D extends Node {
+    /**类类型标识 */
+    static type = 'Text3D';
+    /**字体资源，指向字体文件的URL @default "" */
+    font;
+    /**文本大小 @default 1 */
+    size;
+    /**文本最大宽度，超过会自动换行 @default Infinity */
+    maxWidth;
+    /**行高倍数 @default 1.5 */
+    lineHeight;
+    /**字符间距 @default 0 */
+    letterSpacing;
+    /**文本内容 @default "" */
+    text;
+    /**是否将UV展平到平面 @default false */
+    flattenUVsToPlane;
+    /**曲线分段数，影响文本平滑度 @default 12 */
+    curveSegments;
+    /**文本厚度方向的步数 @default 1 */
+    steps;
+    /**文本厚度 @default 1 */
+    depth;
+    /**材质引用，指向材质资源的唯一标识 @default "" */
+    material;
+    constructor(descriptor = {}) {
+        super(descriptor);
+        this.font = descriptor.font ?? '';
+        this.size = descriptor.size ?? 1;
+        this.maxWidth = descriptor.maxWidth ?? Infinity;
+        this.lineHeight = descriptor.lineHeight ?? 1.5;
+        this.letterSpacing = descriptor.letterSpacing ?? 0;
+        this.text = descriptor.text ?? '';
+        this.flattenUVsToPlane = descriptor.flattenUVsToPlane ?? false;
+        this.curveSegments = descriptor.curveSegments ?? 12;
+        this.steps = descriptor.steps ?? 1;
+        this.depth = descriptor.depth ?? 1;
+        this.material = descriptor.material ?? '';
+    }
+}
+Node.register(Text3D);
+//# sourceMappingURL=Text3D.js.map

package/build/descriptor/Text3D.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Text3D.js","sourceRoot":"","sources":["../../src/descriptor/Text3D.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,IAAI,EAAE,MAAM,aAAa,CAAA;AAEzD;;;;;GAKG;AACH,MAAM,OAAO,MAAO,SAAQ,IAAI;IAC5B,WAAW;IACX,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAA;IAEtB,iCAAiC;IACjC,IAAI,CAAQ;IACZ,qBAAqB;IACrB,IAAI,CAAQ;IACZ,sCAAsC;IACtC,QAAQ,CAAQ;IAChB,uBAAuB;IACvB,UAAU,CAAQ;IAClB,qBAAqB;IACrB,aAAa,CAAQ;IACrB,sBAAsB;IACtB,IAAI,CAAQ;IACZ,+BAA+B;IAC/B,iBAAiB,CAAS;IAC1B,+BAA+B;IAC/B,aAAa,CAAQ;IACrB,0BAA0B;IAC1B,KAAK,CAAQ;IACb,qBAAqB;IACrB,KAAK,CAAQ;IACb,kCAAkC;IAClC,QAAQ,CAAQ;IAEhB,YAAY,aAAqD,EAAE;QAC/D,KAAK,CAAC,UAAU,CAAC,CAAA;QACjB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,IAAI,EAAE,CAAA;QACjC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,IAAI,CAAC,CAAA;QAChC,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,IAAI,QAAQ,CAAA;QAC/C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,IAAI,GAAG,CAAA;QAC9C,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC,aAAa,IAAI,CAAC,CAAA;QAClD,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,IAAI,EAAE,CAAA;QACjC,IAAI,CAAC,iBAAiB,GAAG,UAAU,CAAC,iBAAiB,IAAI,KAAK,CAAA;QAC9D,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC,aAAa,IAAI,EAAE,CAAA;QACnD,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,CAAC,CAAA;QAClC,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,CAAC,CAAA;QAClC,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,IAAI,EAAE,CAAA;IAC7C,CAAC;;AAEL,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA"}