@vyr/three 0.0.33 → 0.0.36

package/src/actor/TextureActor.ts

@@ -1,13 +1,11 @@
 import { Actor } from "@vyr/engine"
 import { Texture } from "three"
 
-class TextureActor<T extends Texture = Texture> extends Actor {
+export class TextureActor<T extends Texture = Texture> extends Actor {
     readonly object: T
 
     constructor(object: T) {
         super()
         this.object = object
     }
-}
-
-export { TextureActor }
+}

package/src/actor/TransformControllerActor.ts

@@ -1,11 +1,11 @@
 import { Actor, Graphics } from "@vyr/engine"
-import { TransformControllerDescriptor } from "../descriptor"
+import { TransformController } from "../descriptor"
 import { TransformControls } from "../controls"
 
-class TransformControllerActor extends Actor {
+export class TransformControllerActor extends Actor {
   readonly object = new TransformControls()
 
-  update(descriptor: TransformControllerDescriptor, graphics: Graphics) {
+  update(descriptor: TransformController, graphics: Graphics) {
     this.object.unlisten(graphics)
     if (descriptor.enabled === false) return
     this.object.listen(descriptor, graphics)
@@ -19,5 +19,3 @@ class TransformControllerActor extends Actor {
     this.object.dispose(graphics)
   }
 }
-
-export { TransformControllerActor }

package/src/actor/index.ts

@@ -1,4 +1,4 @@
-export * from './SceneServiceActor'
+export * from './Scene3DServiceActor'
 export * from './OrbitControllerActor'
 export * from './TransformControllerActor'
 export * from './MaterialActor'

package/src/asset/index.ts

@@ -2,7 +2,7 @@ import { Group } from "three"
 import { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader.js'
 import { FontLoader, Font } from 'three/examples/jsm/loaders/FontLoader.js'
 import { Asset, AssetGraph, Category, Port } from "@vyr/engine"
-import { ExtrudeGeometryDescriptor, TextDescriptor, GeoMapDescriptor, InstancedMeshDescriptor, MeshBasicMaterialDescriptor, MeshDescriptor, MeshPhongMaterialDescriptor, MeshStandardMaterialDescriptor, ModelDescriptor, OrbitControllerDescriptor, ParticleDescriptor, PointsDescriptor, PointsMaterialDescriptor, ShaderMaterialDescriptor, SpriteDescriptor, SpriteMaterialDescriptor, TextureDescriptor, TransformControllerDescriptor, TubeGeometryDescriptor } from "../descriptor"
+import { ExtrudeGeometry, Text3D, GeoMap, InstancedMesh, MeshBasicMaterial, Mesh, MeshPhongMaterial, MeshStandardMaterial, Model, Particle, Points, PointsMaterial, ShaderMaterial, Sprite, SpriteMaterial, Texture, TransformController, TubeGeometry } from "../descriptor"
 import { material } from '../utils'
 
 const factoryImage = (url: string) => {
@@ -62,54 +62,45 @@ const factoryFont = (url: string) => {
 }
 Asset.register(Category.font, factoryFont)
 
-const ModelDescriptorProvider = (descriptor: ModelDescriptor, port: Port) => {
+const ModelProvider = (descriptor: Model, port: Port) => {
     if (descriptor.url) port.edges.push({ key: 'url', category: Category.model, asset: `${descriptor.url}?${descriptor.uuid}` })
 }
 
-const MeshDescriptorProvider = (descriptor: MeshDescriptor, port: Port) => {
+const MeshProvider = (descriptor: Mesh, port: Port) => {
     material.pickMaterial(descriptor.material, port)
 
     if (descriptor.geometry) port.edges.push({ key: 'geometry', category: Category.geometry, asset: descriptor.geometry })
 }
-const InstancedMeshDescriptorProvider = (descriptor: InstancedMeshDescriptor, port: Port) => {
-    MeshDescriptorProvider(descriptor, port)
-    if (descriptor.setting) port.edges.push({ key: 'setting', category: Category.dataset, asset: descriptor.setting })
+const InstancedMeshProvider = (descriptor: InstancedMesh, port: Port) => {
+    MeshProvider(descriptor, port)
+    if (descriptor.data) port.edges.push({ key: 'data', category: Category.store, asset: descriptor.data })
 }
-const TextDescriptorProvider = (descriptor: TextDescriptor, port: Port) => {
+const TextProvider = (descriptor: Text3D, port: Port) => {
     if (descriptor.material) port.edges.push({ key: 'material', category: Category.material, asset: descriptor.material })
     if (descriptor.font) port.edges.push({ key: 'font', category: Category.font, asset: descriptor.font })
 }
-const PointsDescriptorProvider = (descriptor: PointsDescriptor, port: Port) => {
+const PointsProvider = (descriptor: Points, port: Port) => {
     if (descriptor.material) port.edges.push({ key: 'material', category: Category.material, asset: descriptor.material })
     if (descriptor.geometry) port.edges.push({ key: 'geometry', category: Category.geometry, asset: descriptor.geometry })
 }
-const ParticleDescriptorProvider = (descriptor: ParticleDescriptor, port: Port) => {
+const ParticleProvider = (descriptor: Particle, port: Port) => {
     if (descriptor.map) port.edges.push({ key: 'map', category: Category.texture, asset: descriptor.map })
     if (descriptor.alphaMap) port.edges.push({ key: 'alphaMap', category: Category.texture, asset: descriptor.alphaMap })
-    if (descriptor.track) port.edges.push({ key: 'track', category: Category.dataset, asset: descriptor.track })
+    if (descriptor.track) port.edges.push({ key: 'track', category: Category.store, asset: descriptor.track })
 }
 
-const SpriteDescriptorProvider = (descriptor: SpriteDescriptor, port: Port) => {
+const SpriteProvider = (descriptor: Sprite, port: Port) => {
     if (descriptor.material) port.edges.push({ key: 'material', category: Category.material, asset: descriptor.material })
 }
 
-const GeoMapDescriptorProvider = (descriptor: GeoMapDescriptor, port: Port) => {
+const GeoMapProvider = (descriptor: GeoMap, port: Port) => {
     material.pickMaterial(descriptor.material, port)
     if (descriptor.borderMaterial) port.edges.push({ key: 'borderMaterial', category: Category.material, asset: descriptor.borderMaterial })
     if (descriptor.shadowMaterial) port.edges.push({ key: 'shadowMaterial', category: Category.material, asset: descriptor.shadowMaterial })
-    if (descriptor.label) port.edges.push({ key: 'label', category: Category.prefab, asset: descriptor.label })
     if (descriptor.geojsonRegion) port.edges.push({ key: 'geojsonRegion', category: Category.json, asset: descriptor.geojsonRegion })
     if (descriptor.geojsonBorder) port.edges.push({ key: 'geojsonBorder', category: Category.json, asset: descriptor.geojsonBorder })
 }
-
-const TransformControllerDescriptorProvider = (descriptor: TransformControllerDescriptor, port: Port) => {
-    if (descriptor.event) port.edges.push({ key: 'event', category: Category.ts, asset: descriptor.event })
-}
-const orbitControllerDescriptorProvider = (descriptor: OrbitControllerDescriptor, port: Port) => {
-    if (descriptor.event) port.edges.push({ key: 'event', category: Category.ts, asset: descriptor.event })
-}
-
-const MeshBasicMaterialDescriptorProvider = (descriptor: MeshBasicMaterialDescriptor, port: Port) => {
+const MeshBasicMaterialProvider = (descriptor: MeshBasicMaterial, port: Port) => {
     if (descriptor.map) port.edges.push({ key: 'map', category: Category.texture, asset: descriptor.map })
     if (descriptor.alphaMap) port.edges.push({ key: 'alphaMap', category: Category.texture, asset: descriptor.alphaMap })
     if (descriptor.envMap) port.edges.push({ key: 'envMap', category: Category.texture, asset: descriptor.envMap })
@@ -117,7 +108,7 @@ const MeshBasicMaterialDescriptorProvider = (descriptor: MeshBasicMaterialDescri
     if (descriptor.specularMap) port.edges.push({ key: 'specularMap', category: Category.texture, asset: descriptor.specularMap })
 }
 
-const MeshPhongMaterialDescriptorProvider = (descriptor: MeshPhongMaterialDescriptor, port: Port) => {
+const MeshPhongMaterialProvider = (descriptor: MeshPhongMaterial, port: Port) => {
     if (descriptor.map) port.edges.push({ key: 'map', category: Category.texture, asset: descriptor.map })
     if (descriptor.alphaMap) port.edges.push({ key: 'alphaMap', category: Category.texture, asset: descriptor.alphaMap })
     if (descriptor.envMap) port.edges.push({ key: 'envMap', category: Category.texture, asset: descriptor.envMap })
@@ -129,7 +120,7 @@ const MeshPhongMaterialDescriptorProvider = (descriptor: MeshPhongMaterialDescri
     if (descriptor.normalMap) port.edges.push({ key: 'normalMap', category: Category.texture, asset: descriptor.normalMap })
 }
 
-const MeshStandardMaterialDescriptorProvider = (descriptor: MeshStandardMaterialDescriptor, port: Port) => {
+const MeshStandardMaterialProvider = (descriptor: MeshStandardMaterial, port: Port) => {
     if (descriptor.map) port.edges.push({ key: 'map', category: Category.texture, asset: descriptor.map })
     if (descriptor.alphaMap) port.edges.push({ key: 'alphaMap', category: Category.texture, asset: descriptor.alphaMap })
     if (descriptor.envMap) port.edges.push({ key: 'envMap', category: Category.texture, asset: descriptor.envMap })
@@ -142,46 +133,40 @@ const MeshStandardMaterialDescriptorProvider = (descriptor: MeshStandardMaterial
     if (descriptor.roughnessMap) port.edges.push({ key: 'roughnessMap', category: Category.texture, asset: descriptor.roughnessMap })
 }
 
-const PointsMaterialDescriptorProvider = (descriptor: PointsMaterialDescriptor, port: Port) => {
+const PointsMaterialProvider = (descriptor: PointsMaterial, port: Port) => {
     if (descriptor.map) port.edges.push({ key: 'map', category: Category.texture, asset: descriptor.map })
     if (descriptor.alphaMap) port.edges.push({ key: 'alphaMap', category: Category.texture, asset: descriptor.alphaMap })
 }
 
-const SpriteMaterialDescriptorProvider = (descriptor: SpriteMaterialDescriptor, port: Port) => {
+const SpriteMaterialProvider = (descriptor: SpriteMaterial, port: Port) => {
     if (descriptor.map) port.edges.push({ key: 'map', category: Category.texture, asset: descriptor.map })
     if (descriptor.alphaMap) port.edges.push({ key: 'alphaMap', category: Category.texture, asset: descriptor.alphaMap })
 }
 
-const ShaderMaterialDescriptorProvider = (descriptor: ShaderMaterialDescriptor, port: Port) => {
-    if (descriptor.shader) port.edges.push({ key: 'shader', category: Category.ts, asset: descriptor.shader })
-}
-const ExtrudeGeometryDescriptorProvider = (descriptor: ExtrudeGeometryDescriptor, port: Port) => {
-    if (descriptor.shapes) port.edges.push({ key: 'shapes', category: Category.dataset, asset: descriptor.shapes })
+const ExtrudeGeometryProvider = (descriptor: ExtrudeGeometry, port: Port) => {
+    if (descriptor.shapes) port.edges.push({ key: 'shapes', category: Category.store, asset: descriptor.shapes })
 }
-const TubeGeometryDescriptorProvider = (descriptor: TubeGeometryDescriptor, port: Port) => {
-    if (descriptor.track) port.edges.push({ key: 'track', category: Category.dataset, asset: descriptor.track })
+const TubeGeometryProvider = (descriptor: TubeGeometry, port: Port) => {
+    if (descriptor.track) port.edges.push({ key: 'track', category: Category.store, asset: descriptor.track })
 }
 
-const TextureDescriptorProvider = (descriptor: TextureDescriptor, port: Port) => {
+const TextureProvider = (descriptor: Texture, port: Port) => {
     if (descriptor.url) port.edges.push({ key: 'url', category: Category.image, asset: descriptor.url })
 }
 
-AssetGraph.register(ModelDescriptor.type, ModelDescriptorProvider)
-AssetGraph.register(MeshDescriptor.type, MeshDescriptorProvider)
-AssetGraph.register(InstancedMeshDescriptor.type, InstancedMeshDescriptorProvider)
-AssetGraph.register(TextDescriptor.type, TextDescriptorProvider)
-AssetGraph.register(PointsDescriptor.type, PointsDescriptorProvider)
-AssetGraph.register(ParticleDescriptor.type, ParticleDescriptorProvider)
-AssetGraph.register(SpriteDescriptor.type, SpriteDescriptorProvider)
-AssetGraph.register(GeoMapDescriptor.type, GeoMapDescriptorProvider)
-AssetGraph.register(OrbitControllerDescriptor.type, orbitControllerDescriptorProvider)
-AssetGraph.register(TransformControllerDescriptor.type, TransformControllerDescriptorProvider)
-AssetGraph.register(MeshBasicMaterialDescriptor.type, MeshBasicMaterialDescriptorProvider)
-AssetGraph.register(MeshPhongMaterialDescriptor.type, MeshPhongMaterialDescriptorProvider)
-AssetGraph.register(MeshStandardMaterialDescriptor.type, MeshStandardMaterialDescriptorProvider)
-AssetGraph.register(PointsMaterialDescriptor.type, PointsMaterialDescriptorProvider)
-AssetGraph.register(SpriteMaterialDescriptor.type, SpriteMaterialDescriptorProvider)
-AssetGraph.register(ShaderMaterialDescriptor.type, ShaderMaterialDescriptorProvider)
-AssetGraph.register(ExtrudeGeometryDescriptor.type, ExtrudeGeometryDescriptorProvider)
-AssetGraph.register(TubeGeometryDescriptor.type, TubeGeometryDescriptorProvider)
-AssetGraph.register(TextureDescriptor.type, TextureDescriptorProvider)
+AssetGraph.register(Model.type, ModelProvider)
+AssetGraph.register(Mesh.type, MeshProvider)
+AssetGraph.register(InstancedMesh.type, InstancedMeshProvider)
+AssetGraph.register(Text3D.type, TextProvider)
+AssetGraph.register(Points.type, PointsProvider)
+AssetGraph.register(Particle.type, ParticleProvider)
+AssetGraph.register(Sprite.type, SpriteProvider)
+AssetGraph.register(GeoMap.type, GeoMapProvider)
+AssetGraph.register(MeshBasicMaterial.type, MeshBasicMaterialProvider)
+AssetGraph.register(MeshPhongMaterial.type, MeshPhongMaterialProvider)
+AssetGraph.register(MeshStandardMaterial.type, MeshStandardMaterialProvider)
+AssetGraph.register(PointsMaterial.type, PointsMaterialProvider)
+AssetGraph.register(SpriteMaterial.type, SpriteMaterialProvider)
+AssetGraph.register(ExtrudeGeometry.type, ExtrudeGeometryProvider)
+AssetGraph.register(TubeGeometry.type, TubeGeometryProvider)
+AssetGraph.register(Texture.type, TextureProvider)

package/src/controls/CameraControls.ts

@@ -216,7 +216,7 @@ interface Pointer {
     mouseButton: number | null
 }
 
-class CameraControls extends EventDispatcher<any> {
+export class CameraControls extends EventDispatcher<any> {
     static get ACTION() {
         return ACTION;
     }
@@ -2356,5 +2356,3 @@ class CameraControls extends EventDispatcher<any> {
         return boundingSphere;
     }
 }
-
-export { CameraControls };

package/src/controls/TransformControls.ts

@@ -21,9 +21,9 @@ import {
     TorusGeometry,
     Vector3,
 } from 'three'
-import { Asset, NodeDescriptor, ServiceDescriptor, Graphics, Scriptable, Descriptor } from '@vyr/engine'
-import { TransformControllerChangeArgs, TransformControllerDescriptor, SceneServiceDescriptor, OrbitControllerDescriptor } from '../descriptor'
-import { NodeActor, SceneServiceActor } from '../actor'
+import { Node, Service, Graphics, Scriptable, Descriptor } from '@vyr/engine'
+import { TransformControllerChangeArgs, TransformController, Scene3DService, OrbitController } from '../descriptor'
+import { NodeActor, Scene3DServiceActor } from '../actor'
 
 const _raycaster = new Raycaster()
 const _tempVector = new Vector3()
@@ -1135,14 +1135,14 @@ class TransformControlsPlane extends Mesh {
     }
 }
 
-class TransformControls extends Object3D {
+export class TransformControls extends Object3D {
     readonly events: number[] = []
     camera!: Camera
     scriptable!: Scriptable
-    sourceTarget!: NodeDescriptor
+    sourceTarget!: Node
     object!: Object3D
     args!: UpdateArgs
-    descriptor!: TransformControllerDescriptor
+    descriptor!: TransformController
     graphics!: Graphics
     domElement!: HTMLElement
     isTransformControls: boolean
@@ -1255,20 +1255,19 @@ class TransformControls extends Object3D {
         this.sourceTarget.rotation.y = this.object.rotation.y
         this.sourceTarget.rotation.z = this.object.rotation.z
 
-        const _args: TransformControllerChangeArgs = { event: { type, target: this.descriptor.target }, trigger: this.sourceTarget }
-        this.scriptable.execute(this.graphics, _args)
+        this.scriptable.execute(this.graphics, this.sourceTarget.uuid, { type, target: this.descriptor.target })
     }
 
-    listen(descriptor: TransformControllerDescriptor, graphics: Graphics) {
+    listen(descriptor: TransformController, graphics: Graphics) {
         this.unlisten(graphics)
 
-        const sourceTarget = graphics.variableProxy.get<NodeDescriptor>(descriptor.target, graphics)
+        const sourceTarget = graphics.variableProxy.get<Node>(descriptor.target, graphics)
         if (sourceTarget === null) return
         const sourceTargetActor = graphics.getActor(sourceTarget)
         if (sourceTargetActor instanceof NodeActor) {
-            const camera = graphics.variableProxy.get<NodeDescriptor>(graphics.scheduler.camera, graphics)
+            const camera = graphics.variableProxy.get<Node>(graphics.scene.camera, graphics)
             const actor = graphics.getActor(camera) as NodeActor
-            const scriptable = Asset.get(descriptor.event)
+            const scriptable = Scriptable.use(descriptor.event)
 
             this.setCustomProperty('camera', actor.object)
             this.setCustomProperty('graphics', graphics)
@@ -1281,9 +1280,8 @@ class TransformControls extends Object3D {
 
             this.attach(sourceTargetActor.object)
 
-            this.domElement = this.getWrapper(descriptor, graphics)
+            this.domElement = this.getDOM(descriptor, graphics)
 
-            this.events.push(graphics.engine.inputSystem.listen('pointerdown', this._onPointerDown, { target: this.domElement }))
             this.events.push(graphics.engine.inputSystem.listen('pointerdown', this._onPointerDown, { target: this.domElement }))
             this.events.push(graphics.engine.inputSystem.listen('pointerup', this._onPointerUp, { target: this.domElement }))
         }
@@ -1316,15 +1314,15 @@ class TransformControls extends Object3D {
         })
     }
 
-    private getWrapper(descriptor: TransformControllerDescriptor, graphics: Graphics) {
-        let wrapper
+    private getDOM(descriptor: TransformController, graphics: Graphics) {
+        let DOM
         const service = graphics.traceService(descriptor)
-        if (service instanceof SceneServiceDescriptor) {
+        if (service instanceof Scene3DService) {
             const interpreter = graphics.getInterpreter(service)
-            const actor = interpreter.getActor<SceneServiceActor>(service)
-            wrapper = actor.getWrapper()
+            const actor = interpreter.getActor<Scene3DServiceActor>(service)
+            DOM = actor.getDOM()
         }
-        return wrapper as HTMLElement
+        return DOM as HTMLElement
     }
 
     private setCustomProperty(propName: string, defaultValue: any) {
@@ -1736,8 +1734,4 @@ class TransformControls extends Object3D {
     setSpace(space) {
         this.space = space
     }
-}
-
-export {
-    TransformControls
 }

package/src/descriptor/ComposerService.ts

@@ -0,0 +1,72 @@
+import { DeserializationObject } from "@vyr/engine"
+import { Scene3DService } from "./Scene3DService"
+
+/**
+ * 帧缓冲类型枚举
+ * 定义了不同精度的帧缓冲类型，用于控制渲染质量和性能
+ */
+export enum frameBufferType {
+    /**默认选择，性能最佳，适合标准动态范围(SDR)渲染 */
+    UnsignedByteType = 1009,
+    /**HDR渲染推荐，平衡性能与质量，支持Bloom、色调映射等效果 */
+    HalfFloatType = 1016,
+    /**超高精度需求，科学计算、物理模拟等特殊场景 */
+    FloatType = 1015,
+    /**有符号数据，特殊图像处理 */
+    ByteType = 1010,
+    /**16位整数数据，医学影像等 */
+    ShortType = 1011,
+    /**16位无符号数据，深度缓冲区等 */
+    UnsignedShortType = 1012,
+    /**32位整数数据，特殊计算需求 */
+    IntType = 1013,
+    /**32位无符号数据，ID缓冲区、模板缓冲区等 */
+    UnsignedIntType = 1014,
+}
+
+/**
+ * ComposerService类
+ * 合成器服务类，用于高级渲染效果的处理
+ * 
+ * 作用：提供后期处理功能，支持各种渲染通道和效果的合成
+ * 继承自SceneService，拥有场景服务的所有功能
+ */
+export class ComposerService extends Scene3DService {
+    /**类类型标识 */
+    static type = 'ComposerService'
+
+    /**
+     * 采样率
+     * 控制抗锯齿的采样数量
+     * @default 2
+     */
+    multisampling: number
+    /**
+     * 缓冲帧类型
+     * 控制渲染缓冲区的精度
+     * @default frameBufferType.UnsignedByteType
+     */
+    frameBufferType: frameBufferType
+    /**
+     * 深度缓冲区
+     * 是否启用深度缓冲区
+     * @default true
+     */
+    depthBuffer: boolean
+    /**
+     * 模板缓冲区
+     * 是否启用模板缓冲区
+     * @default false
+     */
+    stencilBuffer: boolean
+
+    constructor(descriptor: Partial<DeserializationObject<ComposerService>> = {}) {
+        super(descriptor)
+        this.multisampling = descriptor.multisampling ?? 2
+        this.frameBufferType = descriptor.frameBufferType ?? frameBufferType.UnsignedByteType
+        this.depthBuffer = descriptor.depthBuffer ?? true
+        this.stencilBuffer = descriptor.stencilBuffer ?? false
+    }
+}
+
+Scene3DService.register(ComposerService)

package/src/descriptor/GeoMap.ts

@@ -0,0 +1,60 @@
+import { AssetPropertyCollection, DeserializationObject, Node } from "@vyr/engine"
+
+/**
+ * GeoMap类
+ * 地理地图类，用于显示地理信息数据
+ * 
+ * 作用：根据GeoJSON数据显示地理区域和边界
+ * 支持材质设置、边界显示和标签功能
+ */
+export class GeoMap extends Node {
+    /**类类型标识 */
+    static type = 'GeoMap'
+    /**
+     * 材质
+     * 地理区域的材质，可以是材质对象或材质UUID
+     * @default ""
+     */
+    material: AssetPropertyCollection | string
+    /**
+     * 边界材质
+     * 地理边界的材质，使用`Material`资源的URL作为有效值
+     * @default ""
+     */
+    borderMaterial: string
+    /**
+     * 阴影材质
+     * 地理区域的阴影材质，使用`Material`资源的URL作为有效值
+     * @default ""
+     */
+    shadowMaterial: string
+    /**
+     * 地理区域GeoJSON
+     * 定义地理区域边界的GeoJSON数据，使用json资源的URL作为有效值
+     * @default ""
+     */
+    geojsonRegion: string
+    /**
+     * 地理边界GeoJSON
+     * 定义地理边界的GeoJSON数据，使用json资源的URL作为有效值
+     * @default ""
+     */
+    geojsonBorder: string
+    /**
+     * 标签
+     * 地理地图的标签，使用`HTML`节点的uuid作为有效值
+     * @default ""
+     */
+    label: string
+
+    constructor(descriptor: Partial<DeserializationObject<GeoMap>> = {}) {
+        super(descriptor)
+        this.material = Array.isArray(descriptor.material) ? Node.deepClone(descriptor.material) : descriptor.material ?? ''
+        this.borderMaterial = descriptor.borderMaterial ?? ''
+        this.shadowMaterial = descriptor.shadowMaterial ?? ''
+        this.geojsonRegion = descriptor.geojsonRegion ?? ''
+        this.geojsonBorder = descriptor.geojsonBorder ?? ''
+        this.label = descriptor.label ?? ''
+    }
+}
+Node.register(GeoMap)

package/src/descriptor/HTMLConvert.ts

@@ -0,0 +1,18 @@
+import { DeserializationObject, Node } from "@vyr/engine";
+
+/**
+ * HTMLConvert类
+ * HTML转换类，用于将HTML元素转换为3D场景中的对象
+ * 
+ * 作用：提供HTML元素到3D对象的转换功能
+ * 继承自Node，拥有节点的所有空间变换属性
+ */
+export class HTMLConvert extends Node {
+    /**类类型标识 */
+    static type = 'HTMLConvert'
+
+    constructor(descriptor: Partial<DeserializationObject<HTMLConvert>> = {}) {
+        super(descriptor)
+    }
+}
+Node.register(HTMLConvert)

package/src/descriptor/InstancedMesh.ts

@@ -0,0 +1,38 @@
+import { DeserializationObject } from "@vyr/engine"
+import { Mesh } from "./Mesh"
+
+/**
+ * 实例化设置接口
+ * 定义了实例化网格中单个实例的设置
+ */
+export interface InstancedData {
+    /**颜色 */
+    color: string
+    /**变换矩阵 */
+    matrix: number[]
+}
+
+/**
+ * InstancedMesh类
+ * 实例化网格类，用于高效渲染大量相同几何体的实例
+ * 
+ * 作用：通过实例化技术，使用单个几何体和材质渲染多个对象，提高性能
+ * 继承自Mesh类，拥有网格的所有属性和方法
+ */
+export class InstancedMesh extends Mesh {
+    /**类类型标识 */
+    static type = 'InstancedMesh'
+
+    /**
+     * 实例化数据引用
+     * 使用`Store`的URL作为有效值
+     * @default ""
+     */
+    data: string
+
+    constructor(descriptor: Partial<DeserializationObject<InstancedMesh>> = {}) {
+        super(descriptor)
+        this.data = descriptor.data ?? ''
+    }
+}
+Mesh.register(InstancedMesh)

package/src/descriptor/Mesh.ts

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

package/src/descriptor/Model.ts

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