lythreeframe 1.2.48 → 1.2.50

package/dist/bundle.cjs.js

@@ -3,6 +3,7 @@
 var webgpu = require('three/webgpu');
 var Addons_js = require('three/examples/jsm/Addons.js');
 var tsl = require('three/tsl');
+var three = require('three');
 var DepthOfFieldNode_js = require('three/addons/tsl/display/DepthOfFieldNode.js');
 var BloomNode_js = require('three/examples/jsm/tsl/display/BloomNode.js');
 var DenoiseNode_js = require('three/examples/jsm/tsl/display/DenoiseNode.js');
@@ -11,7 +12,6 @@ var GTAONode_js = require('three/examples/jsm/tsl/display/GTAONode.js');
 var OutlineNode_js = require('three/examples/jsm/tsl/display/OutlineNode.js');
 var SMAANode_js = require('three/examples/jsm/tsl/display/SMAANode.js');
 var gsap = require('gsap');
-var three = require('three');
 var SkyMesh_js = require('three/examples/jsm/objects/SkyMesh.js');
 var CSS2DRenderer_js = require('three/examples/jsm/renderers/CSS2DRenderer.js');
 var PointerLockControls_js = require('three/examples/jsm/controls/PointerLockControls.js');
@@ -1521,7 +1521,12 @@ class Viewport {
     }
     get renderer() {
         if (!this._renderer) {
-            throw Error("Renderer is not initialized");
+            if (this._webGLRenderer) {
+                return this._webGLRenderer;
+            }
+            else {
+                throw Error("Renderer is not initialized");
+            }
         }
         return this._renderer;
     }
@@ -1534,6 +1539,7 @@ class Viewport {
     constructor(app, viewportParam, rendererParam, postProcessParam) {
         this._uiDom = null;
         this._renderer = null;
+        this._webGLRenderer = null;
         this.labelRenderer = null;
         this._app = null;
         this.resizeObserver = null;
@@ -1547,6 +1553,7 @@ class Viewport {
         if (viewportParam.elementId) {
             this._outerContainer = document.getElementById(viewportParam.elementId);
         }
+        this.viewportParam = Object.assign({}, viewportParam);
         this.createRenderer(rendererParam);
         if (viewportParam.isLabelRendererNeeded) {
             this.createLabelRenderer();
@@ -1568,7 +1575,7 @@ class Viewport {
             this.setupPostProcess();
         });
     }
-    createRenderer(rendererParam) {
+    async createRenderer(rendererParam) {
         if (this._outerContainer) {
             this._canvasContainer = document.createElement("div");
             this._canvasContainer.style.left = "0px";
@@ -1595,15 +1602,31 @@ class Viewport {
         renderP.logarithmicDepthBuffer = rendererParam.logarithmicDepthBuffer;
         renderP.samples = rendererParam.samples;
         renderP.colorBufferType = rendererParam.colorBufferType;
-        this._renderer = new webgpu.WebGPURenderer(renderP);
-        this._renderer.setPixelRatio(window.devicePixelRatio);
-        this._renderer.setSize(width, height);
-        this._renderer.shadowMap.enabled = rendererParam.shadowMapEnabled;
-        this._renderer.shadowMap.type = rendererParam.shadowMapType;
-        this._renderer.toneMapping = rendererParam.toneMapping;
-        this._renderer.toneMappingExposure = rendererParam.toneMappingExposure;
-        if (element) {
-            element.appendChild(this._renderer.domElement);
+        if (this.viewportParam.usingWebGLRenderer) {
+            this._webGLRenderer = new three.WebGLRenderer();
+            this._webGLRenderer.setPixelRatio(window.devicePixelRatio);
+            this._webGLRenderer.setSize(width, height);
+            this._webGLRenderer.shadowMap.enabled = rendererParam.shadowMapEnabled;
+            this._webGLRenderer.shadowMap.type = rendererParam.shadowMapType ? rendererParam.shadowMapType : three.PCFSoftShadowMap;
+            this._webGLRenderer.toneMapping = rendererParam.toneMapping;
+            this._webGLRenderer.toneMappingExposure = rendererParam.toneMappingExposure;
+            if (element) {
+                element.appendChild(this._webGLRenderer.domElement);
+            }
+        }
+        else {
+            this._renderer = new webgpu.WebGPURenderer(renderP);
+            // WebGPU 需要异步初始化
+            await this._renderer.init();
+            this._renderer.setPixelRatio(window.devicePixelRatio);
+            this._renderer.setSize(width, height);
+            this._renderer.shadowMap.enabled = rendererParam.shadowMapEnabled;
+            this._renderer.shadowMap.type = rendererParam.shadowMapType;
+            this._renderer.toneMapping = rendererParam.toneMapping;
+            this._renderer.toneMappingExposure = rendererParam.toneMappingExposure;
+            if (element) {
+                element.appendChild(this._renderer.domElement);
+            }
         }
     }
     createLabelRenderer() {
@@ -1650,97 +1673,7 @@ class Viewport {
         this.setupPostProcess();
     }
     setupPostProcess() {
-        if (this.postProcessParam.steps.length === 0) {
-            this.destroyPostProcess();
-            this.markRenderStateDirty();
-            return;
-        }
-        if (!this.postProcessing) {
-            this.postProcessing = new webgpu.PostProcessing(this.renderer);
-        }
-        const scenePass = WebGPUPostProcessFactory.constructScenePass(this.app.world.scene, this.app.camera);
-        let finalNode = scenePass.getTextureNode('output');
-        this.postProcessParam.steps.forEach((step) => {
-            switch (step.type) {
-                case exports.PostProcessStepType.Bloom:
-                    {
-                        const bloomPass = WebGPUPostProcessFactory.constructBloomPass(scenePass, step);
-                        //console.log("[PostProcess] BloomPass 构建完成");
-                        finalNode = finalNode.add(bloomPass);
-                        break;
-                    }
-                case exports.PostProcessStepType.DepthOfField:
-                    {
-                        const dofPass = WebGPUPostProcessFactory.constructDOFPass(scenePass, step);
-                        //console.log("[PostProcess] DOFPass 构建完成");
-                        finalNode = finalNode.add(dofPass);
-                        break;
-                    }
-                case exports.PostProcessStepType.ScreenSpaceReflection:
-                    {
-                        console.warn("[PostProcess] SSR 目前存在技术问题，暂不支持。");
-                        // const ssrPass = WebGPUPostProcessFactory.constructSSRPass(scenePass, step as SSRParam);
-                        // console.log("[PostProcess] SSRPass 构建完成");
-                        //finalNode = blendColor(finalNode, ssrPass);
-                        break;
-                    }
-                case exports.PostProcessStepType.GroundTruthAmbientOcclusion:
-                    {
-                        console.warn("[PostProcess] AO 目前存在技术问题，暂不支持。");
-                        // const stepParam = step as GTAOParam
-                        // const GTAOPass = WebGPUPostProcessFactory.constructGTAOPass(scenePass, stepParam);
-                        // console.log("[PostProcess] GTAOPass 构建完成");
-                        // if (stepParam.denoised)
-                        // {
-                        //     const denoiseGTAOPass = WebGPUPostProcessFactory.constructGTAODenoisePass(scenePass, GTAOPass, stepParam);
-                        //     console.log("[PostProcess] GTAODenoisePass 构建完成");
-                        //     finalNode = denoiseGTAOPass.mul(finalNode);
-                        // }
-                        // else
-                        // {
-                        //     finalNode = GTAOPass.getTextureNode().mul(finalNode);
-                        // }
-                        break;
-                    }
-                case exports.PostProcessStepType.Outline:
-                    {
-                        const outlineParam = step;
-                        const outlinePass = WebGPUPostProcessFactory.constructOutlinePass(this.app.world.scene, scenePass.camera, this.outlineObjects, outlineParam);
-                        const { visibleEdge, hiddenEdge } = outlinePass;
-                        const pulsePeriod = tsl.uniform(outlineParam.pulsePeriod);
-                        const period = tsl.time.div(pulsePeriod).mul(2);
-                        const osc = tsl.oscSine(period).mul(.5).add(.5);
-                        const outlineColor = visibleEdge.mul(tsl.uniform(new webgpu.Color(outlineParam.visibleEdgeColor))).add(hiddenEdge.mul(tsl.uniform(new webgpu.Color(outlineParam.hiddenEdgeColor)))).mul(outlineParam.edgeStrength);
-                        const outlinePulse = pulsePeriod.greaterThan(0).select(outlineColor.mul(osc), outlineColor);
-                        // if(!this.denoiseOutlinePass)
-                        // {
-                        //     this.denoiseOutlinePass = WebGPUPostProcessFactory.constructDenoisePass(this.scenePass, outlinePulse, DefaultDenoiseParam);
-                        // }
-                        // outlinePulse = this.denoiseOutlinePass.mul(outlinePulse)
-                        // finalNode = this.denoiseOutlinePass.mul(outlinePulse).add(finalNode);
-                        finalNode = outlinePulse.add(finalNode);
-                        //console.log("[PostProcess] OutlinePass 构建完成");
-                        break;
-                    }
-                case exports.PostProcessStepType.Antialiasing:
-                    {
-                        const aaParam = step;
-                        if (aaParam.method === "fxaa") {
-                            finalNode = WebGPUPostProcessFactory.constructFXAAPass(finalNode);
-                            //console.log("[PostProcess] FXAAPass 构建完成");
-                        }
-                        if (aaParam.method === "smaa") {
-                            finalNode = WebGPUPostProcessFactory.constructSMAAPass(finalNode);
-                            //console.log("[PostProcess] SMAAPass 构建完成");
-                        }
-                        break;
-                    }
-            }
-        });
-        this.postProcessing.outputNode = finalNode;
-        this.postProcessing.needsUpdate = true;
-        //console.log("[PostProcess] setup complete",  this.postProcessParam.steps);
-        this.markRenderStateDirty();
+        return;
     }
     updatePostProcess(steps) {
         this.postProcessParam.steps = steps;
@@ -1825,7 +1758,7 @@ class Viewport {
             return;
         }
         if (this.postProcessing) {
-            this.postProcessing.render();
+            this.postProcessing.renderAsync();
         }
         else {
             this.renderer.render(this.app.world.scene, this.app.camera);
@@ -1842,7 +1775,13 @@ class Viewport {
                     await this.postProcessing.renderAsync();
                 }
                 else {
-                    await this.renderer.renderAsync(this.app.world.scene, this.app.camera);
+                    if (this._renderer) {
+                        await this._renderer.renderAsync(this.app.world.scene, this.app.camera);
+                    }
+                    else if (this._webGLRenderer) {
+                        console.log("render with gl");
+                        this._webGLRenderer.render(this.app.world.scene, this.app.camera);
+                    }
                 }
                 // 检查 renderer.domElement 的尺寸
                 const sourceWidth = this.renderer.domElement.width;
@@ -2151,13 +2090,7 @@ class Controller {
         this.pawn.enabled = isPawnEnabled;
     }
     init() {
-        if (this.viewPort.canvas) {
-            this.viewPort.canvas.addEventListener("pointermove", this.onPointerMove);
-            this.viewPort.canvas.addEventListener("pointerenter", this.onPointerEnter);
-            this.viewPort.canvas.addEventListener("pointerleave", this.onPointerLeave);
-            this.viewPort.canvas.addEventListener("pointerup", this.onPointerUp);
-            this.viewPort.canvas.addEventListener("pointerdown", this.onPointerDown);
-        }
+        if (this.viewPort.canvas) ;
     }
     tick(deltaTime) {
         this.pawn.tick(deltaTime);
@@ -2167,13 +2100,7 @@ class Controller {
             clearTimeout(this.leftClickTimer);
             this.leftClickTimer = null;
         }
-        if (this.viewPort.canvas) {
-            this.viewPort.canvas.removeEventListener("pointermove", this.onPointerMove);
-            this.viewPort.canvas.removeEventListener("pointerenter", this.onPointerEnter);
-            this.viewPort.canvas.removeEventListener("pointerleave", this.onPointerLeave);
-            this.viewPort.canvas.removeEventListener("pointerup", this.onPointerUp);
-            this.viewPort.canvas.removeEventListener("pointerdown", this.onPointerDown);
-        }
+        if (this.viewPort.canvas) ;
         this.pawn.unpossess();
         this.pawn.destroy();
         this._pawn = null;
@@ -2295,6 +2222,14 @@ class Controller {
     focusTo(targetPos, targetQuat, distance, time, onGoing = null, onFinished = null) {
         this.pawn.focusTo(targetPos, targetQuat, distance, time, onGoing, onFinished);
     }
+    setPawn(pawn) {
+        if (this._pawn) {
+            this._pawn.unpossess();
+            this._pawn.destroy();
+        }
+        this._pawn = pawn;
+        this._pawn.possess();
+    }
 }
 
 class CameraFactory {
@@ -2320,7 +2255,7 @@ class CameraFactory {
         catch (error) {
             console.warn("[CameraFactory]Error occurred while creating camera: ", error);
             console.warn("[CameraFactory]Create default perspective camera instead");
-            return new webgpu.PerspectiveCamera(50, 1, 0.1, 1000);
+            return new webgpu.PerspectiveCamera(50, 1, 0.1, 100000);
         }
     }
     static updataCamera(param, camera) {
@@ -2334,6 +2269,7 @@ class CameraFactory {
                             camera.far = data.far;
                             camera.fov = data.fov;
                             camera.aspect = data.aspect;
+                            camera.updateProjectionMatrix();
                             return camera;
                         }
                         return new webgpu.PerspectiveCamera(data.fov, data.aspect, data.near, data.far);
@@ -2348,6 +2284,7 @@ class CameraFactory {
                             camera.right = data.right;
                             camera.top = data.top;
                             camera.bottom = data.bottom;
+                            camera.updateProjectionMatrix();
                             return camera;
                         }
                         return new webgpu.OrthographicCamera(data.left, data.right, data.top, data.bottom, data.near, data.far);
@@ -2368,7 +2305,7 @@ class CameraFactory {
 
 const DefaultPerspectiveCameraParam = {
     near: 0.1,
-    far: 1000,
+    far: 10000,
     type: "Perspective",
     fov: 50,
     aspect: 1,
@@ -2900,7 +2837,14 @@ const DefaultWorldParam = {
     levelActorClass: LevelActor,
 };
 
+/** 动画循环启动延迟时间（毫秒） */
+const ANIMATION_START_DELAY = 100;
+/**
+ * Three.js应用程序主类
+ * 负责管理场景、视口、控制器和资源
+ */
 class ThreeJsApp {
+    // ========== 公共访问器 ==========
     get camera() {
         return this._camera;
     }
@@ -2925,67 +2869,132 @@ class ThreeJsApp {
     get onCameraChangedDelegate() {
         return this._onCameraChangedDelegate;
     }
+    /**
+     * 构造ThreeJs应用程序实例
+     * @param appParam 应用程序参数配置
+     */
     constructor(appParam = DefaultAppParam) {
+        var _a, _b, _c, _d, _e, _f;
+        // ========== 私有字段 ==========
+        this.animationFrameHandle = 0;
         this._tickingFunctions = [];
         this._appParam = { viewportParam: DefaultViewportParam };
         this._onCameraChangedDelegate = new Delegate();
-        this._appParam.cameraParam = appParam.cameraParam ? appParam.cameraParam : DefaultCameraParam;
-        this._appParam.renderParam = appParam.renderParam ? appParam.renderParam : DefaultRendererParameters;
-        this._appParam.postProcessParam = appParam.postProcessParam ? appParam.postProcessParam : DefaultPostProcessParam;
-        this._appParam.viewportParam = appParam.viewportParam ? appParam.viewportParam : DefaultViewportParam;
-        this._appParam.classes = appParam.classes ? appParam.classes : {
+        // 初始化应用参数（使用空值合并运算符简化默认值处理）
+        this._appParam.cameraParam = (_a = appParam.cameraParam) !== null && _a !== void 0 ? _a : DefaultCameraParam;
+        this._appParam.renderParam = (_b = appParam.renderParam) !== null && _b !== void 0 ? _b : DefaultRendererParameters;
+        this._appParam.postProcessParam = (_c = appParam.postProcessParam) !== null && _c !== void 0 ? _c : DefaultPostProcessParam;
+        this._appParam.viewportParam = (_d = appParam.viewportParam) !== null && _d !== void 0 ? _d : DefaultViewportParam;
+        this._appParam.worldParam = (_e = appParam.worldParam) !== null && _e !== void 0 ? _e : DefaultWorldParam;
+        this._appParam.isRenderEveryFrame = appParam.isRenderEveryFrame;
+        this._appParam.classes = (_f = appParam.classes) !== null && _f !== void 0 ? _f : {
             assetManagerClass: AssetManager,
             controllerClass: Controller,
             worldClass: World,
             viewportClass: Viewport,
         };
-        this._appParam.isRenderEveryFrame = appParam.isRenderEveryFrame;
+        // 初始化核心组件
         this._clock = new webgpu.Clock();
         this._camera = CameraFactory.createCamera(this._appParam.cameraParam);
-        this._world = new this._appParam.classes.worldClass(this, this._appParam.worldParam ? this._appParam.worldParam : DefaultWorldParam);
+        this._world = new this._appParam.classes.worldClass(this, this._appParam.worldParam);
         this._viewport = new this._appParam.classes.viewportClass(this, this._appParam.viewportParam, this._appParam.renderParam, this._appParam.postProcessParam);
         this._controller = new this._appParam.classes.controllerClass(this);
         this._assetManager = new this._appParam.classes.assetManagerClass(this);
-        this.viewport.renderer.setAnimationLoop(() => {
-            const delta = this._clock.getDelta();
-            this.tick(delta);
-        });
         this.postConstruct();
+        this.startAnimationLoop();
     }
+    /**
+     * 构造后初始化钩子
+     * 按顺序初始化控制器、世界和视口
+     */
     postConstruct() {
         this.controller.init();
         this.world.init();
         this.viewport.init();
     }
+    /**
+     * 公共初始化方法
+     * 可由子类重写以添加自定义初始化逻辑
+     */
     init() {
-    }
+        // 预留给子类实现
+    }
+    /**
+     * 启动动画循环
+     * 使用延迟启动以确保所有组件完全初始化
+     */
+    startAnimationLoop() {
+        const tick = () => {
+            this.animationFrameHandle = requestAnimationFrame(tick);
+            try {
+                const delta = this._clock.getDelta();
+                this.tick(delta);
+            }
+            catch (error) {
+                console.error('动画循环错误:', error);
+            }
+        };
+        setTimeout(() => {
+            tick();
+        }, ANIMATION_START_DELAY);
+    }
+    /**
+     * 每帧更新方法
+     * @param deltaTime 距离上一帧的时间增量（秒）
+     */
     tick(deltaTime) {
         this._controller.tick(deltaTime);
         this.world.tick(deltaTime);
+        // 执行所有注册的tick函数
         this._tickingFunctions.forEach(func => {
             func(deltaTime);
         });
+        // 根据配置决定是否每帧都渲染
         if (this._appParam.isRenderEveryFrame) {
             this.viewport.markRenderStateDirty();
         }
         this.viewport.render();
     }
+    /**
+     * 添加每帧执行的函数
+     * @param func 接收deltaTime参数的回调函数
+     */
     addTickingFunction(func) {
         this._tickingFunctions.push(func);
     }
+    /**
+     * 移除已注册的tick函数
+     * @param func 要移除的函数引用
+     */
     removeTickingFunction(func) {
         const index = this._tickingFunctions.indexOf(func);
         if (index >= 0) {
             this._tickingFunctions.splice(index, 1);
         }
     }
+    /**
+     * 销毁应用程序并清理所有资源
+     */
     destroy() {
+        // 停止动画循环
+        if (this.animationFrameHandle) {
+            cancelAnimationFrame(this.animationFrameHandle);
+            this.animationFrameHandle = 0;
+        }
+        // 清理委托
         this.onCameraChangedDelegate.clear();
+        // 销毁各个组件
         this.controller.destroy();
         this.world.destroy();
         this.viewport.destroy();
         this._assetManager.clearAssets();
+        // 清空tick函数列表
+        this._tickingFunctions = [];
     }
+    /**
+     * 更新相机参数
+     * @param param 新的相机参数
+     */
     updateCamera(param) {
         const previousCam = this.camera;
         this._camera = CameraFactory.updataCamera(param, this.camera);
@@ -2996,16 +3005,31 @@ class ThreeJsApp {
         this._camera.updateProjectionMatrix();
         this.viewport.markRenderStateDirty();
     }
+    /**
+     * 窗口大小改变时的处理
+     * @param width 新的宽度
+     * @param height 新的高度
+     */
     onWindowResize(width, height) {
         if (this.camera instanceof webgpu.PerspectiveCamera) {
             this.camera.aspect = width / height;
         }
-        // if(this.camera instanceof OrthographicCamera)
-        // {
-        //     // to do
+        // TODO: 实现正交相机的窗口缩放处理
+        // if (this.camera instanceof OrthographicCamera) {
+        //     const aspect = width / height;
+        //     this.camera.left = -width / 2;
+        //     this.camera.right = width / 2;
+        //     this.camera.top = height / 2;
+        //     this.camera.bottom = -height / 2;
         // }
         this.camera.updateProjectionMatrix();
     }
+    /**
+     * 将当前场景渲染为图片
+     * @param width 图片宽度，默认1024
+     * @param height 图片高度，默认1024
+     * @returns 图片的DataURL
+     */
     async renderAsImage(width = 1024, height = 1024) {
         return await this.viewport.renderAsImage(width, height);
     }
@@ -3137,7 +3161,7 @@ class AmbientLightComponent extends LightComponent {
         this.threeObject.intensity = intensity;
     }
     createDefaultObject() {
-        return new webgpu.AmbientLight(0xffffff, 10);
+        return new three.AmbientLight(0xffffff, 10);
     }
     setPosition(...args) {
         if (args.length === 1) {
@@ -3181,7 +3205,7 @@ class AmbientLightActor extends Actor {
 }
 
 class BoxComponent extends MeshComponent {
-    constructor(app, width = 1, height = 1, depth = 1, widthSegments = 1, heightSegments = 1, depthSegments = 1, material = new webgpu.MeshStandardMaterial(), uuid) {
+    constructor(app, width = 1, height = 1, depth = 1, widthSegments = 1, heightSegments = 1, depthSegments = 1, material = new webgpu.MeshStandardMaterial({ color: 0x00ff00 }), uuid) {
         super(app, new webgpu.BoxGeometry(width, height, depth, widthSegments, heightSegments, depthSegments), material, uuid);
     }
 }
@@ -3328,6 +3352,120 @@ class LabelComponent extends SceneComponent {
 // labelStyle.style.fontSize        = "10px";
 // labelStyle.style.pointerEvents   = 'auto';
 
+class CurveComponent extends SceneComponent {
+    get threeObject() {
+        if (!this.obj) {
+            throw new Error("threeObject is null");
+        }
+        return this.obj;
+    }
+    set threeObject(newThreeObject) {
+        this.obj = newThreeObject;
+        if (this.obj) {
+            this.obj.userData["LYObject"] = this;
+        }
+    }
+    get material() {
+        return this.threeObject.material;
+    }
+    constructor(app, points, setup = { color: 0xffffff }, bCreateLine = true, uuid) {
+        var _a, _b, _c;
+        super(app, uuid);
+        this.closed = (_a = setup.closed) !== null && _a !== void 0 ? _a : false;
+        this.curveType = (_b = setup.type) !== null && _b !== void 0 ? _b : 'centripetal';
+        this.tension = (_c = setup.tension) !== null && _c !== void 0 ? _c : 0;
+        this.sourcePoints = points;
+        this.curve = new three.CatmullRomCurve3(points, this.closed, this.curveType, this.tension);
+        this.points = this.curve.getPoints(points.length * (this.tension === 0 ? 1 : 10) - 1);
+        this.material.color = new three.Color(setup.color);
+        this.bCreateLine = bCreateLine;
+        this.name = "CurveComponent";
+        if (this.bCreateLine) {
+            this.createLine();
+        }
+    }
+    isValid() {
+        return this.threeObject != null;
+    }
+    createDefaultObject() {
+        // 创建默认材质
+        const material = new three.LineBasicMaterial({
+            color: 0xffffff,
+            transparent: true,
+            opacity: 1
+        });
+        // 创建空的几何体和线对象
+        const geometry = new three.BufferGeometry();
+        const line = new three.Line(geometry, material);
+        return line;
+    }
+    resetPoints(points) {
+        this.sourcePoints = points;
+        this.curve = new three.CatmullRomCurve3(points, this.closed, this.curveType, this.tension);
+        this.points = this.curve.getPoints(points.length * (this.tension === 0 ? 1 : 10) - 1);
+        if (this.bCreateLine) {
+            this.createLine();
+        }
+    }
+    createLine() {
+        const positions = [];
+        for (let i = 0; i < this.points.length; ++i) {
+            positions.push(this.points[i].x);
+            positions.push(this.points[i].y);
+            positions.push(this.points[i].z);
+        }
+        const geometry = this.threeObject.geometry;
+        geometry.setAttribute('position', new three.Float32BufferAttribute(positions, 3));
+    }
+    destroy() {
+        if (this.isValid() && this.threeObject) {
+            if (this.threeObject.geometry) {
+                this.threeObject.geometry.dispose();
+            }
+            if (this.material) {
+                this.material.dispose();
+            }
+        }
+        super.destroy();
+    }
+    get SourcePoints() {
+        return this.sourcePoints;
+    }
+    get Curve() {
+        return this.curve;
+    }
+    get Points() {
+        return this.points;
+    }
+    getPointAt(u) {
+        return this.curve.getPointAt(u);
+    }
+    getTangentAt(u) {
+        return this.curve.getTangentAt(u);
+    }
+    // 返回曲线在参数 u 处的世界坐标点
+    getWorldPointAt(u) {
+        const p = this.curve.getPointAt(u).clone();
+        if (this.obj) {
+            this.obj.updateMatrixWorld(true);
+            return this.localToWorld(p);
+        }
+        return p;
+    }
+    // 返回曲线在参数 u 处的世界坐标系下的单位切线方向
+    getWorldTangentAt(u) {
+        const t = this.curve.getTangentAt(u).clone();
+        if (this.obj) {
+            this.obj.updateMatrixWorld(true);
+            t.transformDirection(this.obj.matrixWorld);
+        }
+        return t;
+    }
+    getLength() {
+        return this.curve.getLength();
+    }
+}
+
 const DefaultBloomParam = {
     type: exports.PostProcessStepType.Bloom,
     threshold: 0,
@@ -3609,6 +3747,7 @@ exports.AssetManager = AssetManager;
 exports.BoxActor = BoxActor;
 exports.BoxComponent = BoxComponent;
 exports.Controller = Controller;
+exports.CurveComponent = CurveComponent;
 exports.DefaultAAParams = DefaultAAParams;
 exports.DefaultAppParam = DefaultAppParam;
 exports.DefaultBloomParam = DefaultBloomParam;
@@ -3636,6 +3775,7 @@ exports.LevelComponent = LevelComponent;
 exports.MaterialAssetPointer = MaterialAssetPointer;
 exports.MeshComponent = MeshComponent;
 exports.Orbital = Orbital;
+exports.Pawn = Pawn;
 exports.PlaneActor = PlaneActor;
 exports.PlaneComponent = PlaneComponent;
 exports.SceneComponent = SceneComponent;