lythreeframe 1.2.48 → 1.2.50

package/dist/bundle.esm.js

@@ -1,6 +1,7 @@
-import { MathUtils, Object3D, Vector3, Box3, Quaternion, Euler, Matrix4, Mesh, LoadingManager, BufferGeometry, Texture, FileLoader, Material, NearestFilter, WebGPURenderer, PostProcessing, Color, Vector2, Raycaster, OrthographicCamera, PerspectiveCamera, Clock, DirectionalLight, AmbientLight, MeshStandardMaterial, BoxGeometry, MeshBasicMaterial, PlaneGeometry, SphereGeometry } from 'three/webgpu';
+import { MathUtils, Object3D, Vector3, Box3, Quaternion, Euler, Matrix4, Mesh, LoadingManager, BufferGeometry, Texture, FileLoader, Material, NearestFilter, WebGPURenderer, Vector2, Raycaster, OrthographicCamera, PerspectiveCamera, Clock, DirectionalLight, MeshStandardMaterial, BoxGeometry, MeshBasicMaterial, PlaneGeometry, SphereGeometry } from 'three/webgpu';
 import { GLTFLoader, DRACOLoader, CSS2DRenderer, OrbitControls } from 'three/examples/jsm/Addons.js';
-import { pass, mrt, output, uniform, metalness, transformedNormalView, time, oscSine } from 'three/tsl';
+import { pass, mrt, output, uniform, metalness, transformedNormalView } from 'three/tsl';
+import { WebGLRenderer, PCFSoftShadowMap, Scene, AmbientLight, CatmullRomCurve3, Color, LineBasicMaterial, BufferGeometry as BufferGeometry$1, Line, Float32BufferAttribute } from 'three';
 import { dof } from 'three/addons/tsl/display/DepthOfFieldNode.js';
 import { bloom } from 'three/examples/jsm/tsl/display/BloomNode.js';
 import { denoise } from 'three/examples/jsm/tsl/display/DenoiseNode.js';
@@ -9,7 +10,6 @@ import { ao } from 'three/examples/jsm/tsl/display/GTAONode.js';
 import { outline } from 'three/examples/jsm/tsl/display/OutlineNode.js';
 import { smaa } from 'three/examples/jsm/tsl/display/SMAANode.js';
 import { gsap } from 'gsap';
-import { Scene } from 'three';
 import { SkyMesh } from 'three/examples/jsm/objects/SkyMesh.js';
 import { CSS2DObject } from 'three/examples/jsm/renderers/CSS2DRenderer.js';
 import { PointerLockControls } from 'three/examples/jsm/controls/PointerLockControls.js';
@@ -1519,7 +1519,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;
     }
@@ -1532,6 +1537,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;
@@ -1545,6 +1551,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();
@@ -1566,7 +1573,7 @@ class Viewport {
             this.setupPostProcess();
         });
     }
-    createRenderer(rendererParam) {
+    async createRenderer(rendererParam) {
         if (this._outerContainer) {
             this._canvasContainer = document.createElement("div");
             this._canvasContainer.style.left = "0px";
@@ -1593,15 +1600,31 @@ class Viewport {
         renderP.logarithmicDepthBuffer = rendererParam.logarithmicDepthBuffer;
         renderP.samples = rendererParam.samples;
         renderP.colorBufferType = rendererParam.colorBufferType;
-        this._renderer = new 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 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 : PCFSoftShadowMap;
+            this._webGLRenderer.toneMapping = rendererParam.toneMapping;
+            this._webGLRenderer.toneMappingExposure = rendererParam.toneMappingExposure;
+            if (element) {
+                element.appendChild(this._webGLRenderer.domElement);
+            }
+        }
+        else {
+            this._renderer = new 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() {
@@ -1648,97 +1671,7 @@ class Viewport {
         this.setupPostProcess();
     }
     setupPostProcess() {
-        if (this.postProcessParam.steps.length === 0) {
-            this.destroyPostProcess();
-            this.markRenderStateDirty();
-            return;
-        }
-        if (!this.postProcessing) {
-            this.postProcessing = new 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 PostProcessStepType.Bloom:
-                    {
-                        const bloomPass = WebGPUPostProcessFactory.constructBloomPass(scenePass, step);
-                        //console.log("[PostProcess] BloomPass 构建完成");
-                        finalNode = finalNode.add(bloomPass);
-                        break;
-                    }
-                case PostProcessStepType.DepthOfField:
-                    {
-                        const dofPass = WebGPUPostProcessFactory.constructDOFPass(scenePass, step);
-                        //console.log("[PostProcess] DOFPass 构建完成");
-                        finalNode = finalNode.add(dofPass);
-                        break;
-                    }
-                case PostProcessStepType.ScreenSpaceReflection:
-                    {
-                        console.warn("[PostProcess] SSR 目前存在技术问题，暂不支持。");
-                        // const ssrPass = WebGPUPostProcessFactory.constructSSRPass(scenePass, step as SSRParam);
-                        // console.log("[PostProcess] SSRPass 构建完成");
-                        //finalNode = blendColor(finalNode, ssrPass);
-                        break;
-                    }
-                case 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 PostProcessStepType.Outline:
-                    {
-                        const outlineParam = step;
-                        const outlinePass = WebGPUPostProcessFactory.constructOutlinePass(this.app.world.scene, scenePass.camera, this.outlineObjects, outlineParam);
-                        const { visibleEdge, hiddenEdge } = outlinePass;
-                        const pulsePeriod = uniform(outlineParam.pulsePeriod);
-                        const period = time.div(pulsePeriod).mul(2);
-                        const osc = oscSine(period).mul(.5).add(.5);
-                        const outlineColor = visibleEdge.mul(uniform(new Color(outlineParam.visibleEdgeColor))).add(hiddenEdge.mul(uniform(new 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 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;
@@ -1823,7 +1756,7 @@ class Viewport {
             return;
         }
         if (this.postProcessing) {
-            this.postProcessing.render();
+            this.postProcessing.renderAsync();
         }
         else {
             this.renderer.render(this.app.world.scene, this.app.camera);
@@ -1840,7 +1773,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;
@@ -2149,13 +2088,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);
@@ -2165,13 +2098,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;
@@ -2293,6 +2220,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 {
@@ -2318,7 +2253,7 @@ class CameraFactory {
         catch (error) {
             console.warn("[CameraFactory]Error occurred while creating camera: ", error);
             console.warn("[CameraFactory]Create default perspective camera instead");
-            return new PerspectiveCamera(50, 1, 0.1, 1000);
+            return new PerspectiveCamera(50, 1, 0.1, 100000);
         }
     }
     static updataCamera(param, camera) {
@@ -2332,6 +2267,7 @@ class CameraFactory {
                             camera.far = data.far;
                             camera.fov = data.fov;
                             camera.aspect = data.aspect;
+                            camera.updateProjectionMatrix();
                             return camera;
                         }
                         return new PerspectiveCamera(data.fov, data.aspect, data.near, data.far);
@@ -2346,6 +2282,7 @@ class CameraFactory {
                             camera.right = data.right;
                             camera.top = data.top;
                             camera.bottom = data.bottom;
+                            camera.updateProjectionMatrix();
                             return camera;
                         }
                         return new OrthographicCamera(data.left, data.right, data.top, data.bottom, data.near, data.far);
@@ -2366,7 +2303,7 @@ class CameraFactory {
 
 const DefaultPerspectiveCameraParam = {
     near: 0.1,
-    far: 1000,
+    far: 10000,
     type: "Perspective",
     fov: 50,
     aspect: 1,
@@ -2898,7 +2835,14 @@ const DefaultWorldParam = {
     levelActorClass: LevelActor,
 };
 
+/** 动画循环启动延迟时间（毫秒） */
+const ANIMATION_START_DELAY = 100;
+/**
+ * Three.js应用程序主类
+ * 负责管理场景、视口、控制器和资源
+ */
 class ThreeJsApp {
+    // ========== 公共访问器 ==========
     get camera() {
         return this._camera;
     }
@@ -2923,67 +2867,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 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);
@@ -2994,16 +3003,31 @@ class ThreeJsApp {
         this._camera.updateProjectionMatrix();
         this.viewport.markRenderStateDirty();
     }
+    /**
+     * 窗口大小改变时的处理
+     * @param width 新的宽度
+     * @param height 新的高度
+     */
     onWindowResize(width, height) {
         if (this.camera instanceof 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);
     }
@@ -3179,7 +3203,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 MeshStandardMaterial(), uuid) {
+    constructor(app, width = 1, height = 1, depth = 1, widthSegments = 1, heightSegments = 1, depthSegments = 1, material = new MeshStandardMaterial({ color: 0x00ff00 }), uuid) {
         super(app, new BoxGeometry(width, height, depth, widthSegments, heightSegments, depthSegments), material, uuid);
     }
 }
@@ -3326,6 +3350,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 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 Color(setup.color);
+        this.bCreateLine = bCreateLine;
+        this.name = "CurveComponent";
+        if (this.bCreateLine) {
+            this.createLine();
+        }
+    }
+    isValid() {
+        return this.threeObject != null;
+    }
+    createDefaultObject() {
+        // 创建默认材质
+        const material = new LineBasicMaterial({
+            color: 0xffffff,
+            transparent: true,
+            opacity: 1
+        });
+        // 创建空的几何体和线对象
+        const geometry = new BufferGeometry$1();
+        const line = new Line(geometry, material);
+        return line;
+    }
+    resetPoints(points) {
+        this.sourcePoints = points;
+        this.curve = new 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 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: PostProcessStepType.Bloom,
     threshold: 0,
@@ -3600,4 +3738,4 @@ class TransformGizmo extends Pawn {
     }
 }
 
-export { Actor, AmbientLightActor, AmbientLightComponent, AssetManager, AttachmentRules, BoxActor, BoxComponent, Controller, DefaultAAParams, DefaultAppParam, DefaultBloomParam, DefaultCameraParam, DefaultDOFParam, DefaultDenoiseParam, DefaultGTAOParam, DefaultOrthographicCameraParam, DefaultOutlineParams, DefaultPerspectiveCameraParam, DefaultPostProcessParam, DefaultRendererParameters, DefaultSSRParam, DefaultSkyParam, DefaultViewportParam, DefaultWorldParam, Delegate, DirectionalLightActor, DirectionalLightComponent, FirstPerson, GeometryAssetPointer, LabelComponent, LevelActor, LevelComponent, MaterialAssetPointer, MeshComponent, Orbital, PlaneActor, PlaneComponent, PostProcessStepType, SceneComponent, SkyActor, SkyComponent, SphereComponent, TAssetPointer, TSmartPointer, TextureAssetPointer, ThreeJsApp, ThreeObjectLibrary, TransformGizmo, Viewport, WebGPUPostProcessFactory, World };
+export { Actor, AmbientLightActor, AmbientLightComponent, AssetManager, AttachmentRules, BoxActor, BoxComponent, Controller, CurveComponent, DefaultAAParams, DefaultAppParam, DefaultBloomParam, DefaultCameraParam, DefaultDOFParam, DefaultDenoiseParam, DefaultGTAOParam, DefaultOrthographicCameraParam, DefaultOutlineParams, DefaultPerspectiveCameraParam, DefaultPostProcessParam, DefaultRendererParameters, DefaultSSRParam, DefaultSkyParam, DefaultViewportParam, DefaultWorldParam, Delegate, DirectionalLightActor, DirectionalLightComponent, FirstPerson, GeometryAssetPointer, LabelComponent, LevelActor, LevelComponent, MaterialAssetPointer, MeshComponent, Orbital, Pawn, PlaneActor, PlaneComponent, PostProcessStepType, SceneComponent, SkyActor, SkyComponent, SphereComponent, TAssetPointer, TSmartPointer, TextureAssetPointer, ThreeJsApp, ThreeObjectLibrary, TransformGizmo, Viewport, WebGPUPostProcessFactory, World };

package/dist/index.d.ts

@@ -37,6 +37,8 @@ export { DirectionalLightComponent } from "./lythreeframe/Object/Components/Ligh
 export { AmbientLightComponent } from './lythreeframe/Object/Components/Light/AmbientLight/AmbientLightComponent';
 export { LabelComponent } from "./lythreeframe/Object/Components/2D/2DComponent";
 export { SkyComponent } from "./lythreeframe/Object/Components/Sky/SkyComponent";
+export { CurveComponent } from './lythreeframe/Object/Components/Curve/CurveComponent';
+export type { CurveComponetSetup } from './lythreeframe/Object/Components/Curve/CurveComponent';
 export type { SkyComponentParam } from "./lythreeframe/Object/Components/Sky/SkyComponent";
 export { DefaultSkyParam } from "./lythreeframe/Object/Components/Sky/SkyComponent";
 export { WebGPUPostProcessFactory } from "./lythreeframe/PostProcess/WebGPUPostProcessFactory";
@@ -58,6 +60,7 @@ export { DefaultSSRParam } from "./lythreeframe/PostProcess/Param/SSR";
 export type { SSRParam } from "./lythreeframe/PostProcess/Param/SSR";
 export { DefaultAAParams } from "./lythreeframe/PostProcess/Param/AAParam";
 export type { AAParams } from "./lythreeframe/PostProcess/Param/AAParam";
+export { Pawn } from "./lythreeframe/Object/PawnV2/Pawn";
 export { Orbital } from "./lythreeframe/Object/PawnV2/Oribital";
 export { FirstPerson } from "./lythreeframe/Object/PawnV2/FirstPerson";
 export type { ITransforming } from "./lythreeframe/Object/PawnV2/TransformControl";

package/dist/lythreeframe/Frame/Controller.d.ts

@@ -40,4 +40,5 @@ export declare class Controller {
     getHitResultUnderCursor(): Intersection | null;
     getHitResultFromScreenPoint(x: number, y: number): Intersection | null;
     focusTo(targetPos: Vector3, targetQuat: Quaternion | Euler, distance: number, time: number, onGoing?: (() => void) | null, onFinished?: (() => void) | null): void;
+    setPawn(pawn: Pawn): void;
 }

package/dist/lythreeframe/Frame/Parameters/AppParameter.d.ts

@@ -7,6 +7,7 @@ import { ViewportParam } from "./ViewportParameters";
 import { AssetManager } from "../../AssetManagement/AssetManager";
 import { PostProcessParam } from "../../PostProcess/PostProcessParam";
 import { RendererParameters } from "./RendererParameters";
+import { ControllerParameters } from "./ControllerParameters";
 export interface AppClass {
     assetManagerClass: typeof AssetManager;
     controllerClass: typeof Controller;
@@ -19,6 +20,7 @@ export interface AppParam {
     postProcessParam?: PostProcessParam;
     worldParam?: WorldParam;
     viewportParam: ViewportParam;
+    controllerParam?: ControllerParameters;
     classes?: AppClass;
     isRenderEveryFrame?: boolean;
 }

package/dist/lythreeframe/Frame/Parameters/ControllerParameters.d.ts

@@ -0,0 +1,2 @@
+export interface ControllerParameters {
+}