lythreeframe 1.1.10 → 1.1.12

package/dist/bundle.cjs.js

@@ -14,6 +14,7 @@ var MotionBlur_js = require('three/examples/jsm/tsl/display/MotionBlur.js');
 var FXAANode_js = require('three/examples/jsm/tsl/display/FXAANode.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 = require('three/examples/jsm/controls/PointerLockControls');
@@ -23,10 +24,10 @@ var TransformControls_js = require('three/examples/jsm/controls/TransformControl
  * virtual class of 3D Object, should not be use directly.
  */
 class BaseObject {
-    get IsTickable() {
+    get isTickEnabled() {
         return this.bCanTick;
     }
-    set IsTickable(bCanTick) {
+    set isTickEnabled(bCanTick) {
         this.bCanTick = bCanTick;
     }
     get uuid() {
@@ -34,6 +35,7 @@ class BaseObject {
     }
     constructor(uuid = webgpu.MathUtils.generateUUID()) {
         this.bCanTick = false;
+        this.tickEvents = [];
         this.bCanTick = false;
         this._uuid = uuid;
     }
@@ -41,6 +43,21 @@ class BaseObject {
         if (!this.bCanTick) {
             return;
         }
+        this.tickEvents.forEach((elem) => {
+            elem(deltaTime);
+        });
+    }
+    addTickEvent(event) {
+        this.tickEvents.push(event);
+    }
+    removeTickEvent(event) {
+        let index = this.tickEvents.indexOf(event);
+        if (index != -1) {
+            this.tickEvents.splice(index, 1);
+        }
+    }
+    clearTickEvents() {
+        this.tickEvents = [];
     }
     destroy() {
     }
@@ -106,7 +123,6 @@ class SceneComponent extends Component {
         this._parentActor = value;
     }
     get parentActor() {
-        // 通过 _parentActor 私有字段访问父级 Actor
         return this._parentActor;
     }
     get world() {
@@ -122,6 +138,12 @@ class SceneComponent extends Component {
     createDefaultThreeObject() {
         this.threeObject = new webgpu.Group();
     }
+    tick(deltaTime) {
+        super.tick(deltaTime);
+        this.childrenComponents.forEach((elem) => {
+            elem.tick(deltaTime);
+        });
+    }
     get isVisible() {
         if (!this.threeObject) {
             return false;
@@ -899,7 +921,7 @@ class MaterialAssetPointer extends TAssetPointer {
         try {
             this.textures.set(name, texturePtr);
             this.getValue()[name] = texture;
-            texture.addRef();
+            texturePtr.addRef();
             mat.needsUpdate = true;
         }
         catch (e) {
@@ -1226,25 +1248,9 @@ const DefaultPostProcessParam = {
     }
 };
 
-class ThreeObjectLibrary {
-    static disposeMeshMaterial(mesh) {
-        let mats = Array.isArray(mesh.material) ? mesh.material : [mesh.material];
-        mats.forEach((elem) => {
-            elem.dispose();
-        });
-    }
-    static disposeMeshGeometry(mesh) {
-        mesh.geometry.dispose();
-    }
-    static disposeMeshResource(mesh) {
-        ThreeObjectLibrary.disposeMeshMaterial(mesh);
-        ThreeObjectLibrary.disposeMeshGeometry(mesh);
-    }
-}
-
 class World {
     get scene() {
-        return this._scene;
+        return this.rootActor.scene;
     }
     get viewport() {
         return this.app.viewport;
@@ -1252,15 +1258,22 @@ class World {
     get controller() {
         return this.app.controller;
     }
-    constructor(app) {
+    constructor(app, worldParam) {
         this.actors = new Set();
+        this.tickableActors = new Set();
         this.app = app;
-        this._scene = new webgpu.Scene();
+        this.rootActor = new worldParam.levelActorClass(app);
     }
     init() {
     }
+    addTickableActor(actor) {
+        this.tickableActors.add(actor);
+    }
+    removeTickableActor(actor) {
+        this.tickableActors.delete(actor);
+    }
     tick(deltaTime) {
-        this.actors.forEach((elem) => {
+        this.tickableActors.forEach((elem) => {
             elem.tick(deltaTime);
         });
     }
@@ -1269,19 +1282,14 @@ class World {
             elem.destroy();
         });
         this.actors.clear();
-        this.scene.traverse((child) => {
-            if (child instanceof webgpu.Mesh) {
-                ThreeObjectLibrary.disposeMeshResource(child);
-            }
-        });
-        this.scene.clear();
+        this.rootActor.destroy();
     }
     addActor(actor) {
         if (!actor.rootComponent.threeObject) {
-            throw Error("actor.threeObject is null");
+            throw new Error("actor.threeObject is null");
         }
         actor.removeFromParent();
-        this.scene.add(actor.rootComponent.threeObject);
+        this.rootActor.addChildActor(actor);
         this.actors.add(actor);
         actor.onAddedToWorld(this);
         this.viewport.markRenderStateDirty();
@@ -2274,97 +2282,6 @@ const DefaultAppParam = {
     }
 };
 
-class ThreeJsApp {
-    get camera() {
-        return this._camera;
-    }
-    get clock() {
-        return this._clock;
-    }
-    get world() {
-        return this._world;
-    }
-    get viewport() {
-        return this._viewport;
-    }
-    get controller() {
-        return this._controller;
-    }
-    get assetManager() {
-        return this._assetManager;
-    }
-    get appParam() {
-        return this._appParam;
-    }
-    get onCameraChangedDelegate() {
-        return this._onCameraChangedDelegate;
-    }
-    constructor(appParam = DefaultAppParam) {
-        this._appParam = { viewportParam: DefaultViewportParam };
-        this._onCameraChangedDelegate = new Delegate();
-        this._appParam.cameraParam = appParam.cameraParam ? appParam.cameraParam : DefaultCameraParam;
-        this._appParam.renderParam = appParam.renderParam ? appParam.renderParam : DefaultRenderParam;
-        this._appParam.postProcessParam = appParam.postProcessParam ? appParam.postProcessParam : DefaultPostProcessParam;
-        this._appParam.viewportParam = appParam.viewportParam ? appParam.viewportParam : DefaultViewportParam;
-        this._appParam.classes = appParam.classes ? appParam.classes : {
-            assetManagerClass: AssetManager,
-            controllerClass: Controller,
-            worldClass: World,
-            viewportClass: Viewport,
-        };
-        this._clock = new webgpu.Clock();
-        this._camera = CameraFactory.createCamera(this._appParam.cameraParam);
-        this._world = new this._appParam.classes.worldClass(this);
-        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(() => {
-            this.tick();
-        });
-        this.init();
-    }
-    init() {
-        this.controller.init();
-        this.world.init();
-        this.viewport.init();
-    }
-    tick() {
-        const delta = this._clock.getDelta();
-        this._controller.tick(delta);
-        this.world.tick(delta);
-        this.viewport.render();
-    }
-    destroy() {
-        this.onCameraChangedDelegate.clear();
-        this.world.destroy();
-        this.controller.destroy();
-        this.viewport.destroy();
-        this._assetManager.clearAssets();
-    }
-    updateCamera(param) {
-        const previousCam = this.camera;
-        this._camera = CameraFactory.updataCamera(param, this.camera);
-        if (previousCam !== this.camera) {
-            this._onCameraChangedDelegate.broadcast();
-        }
-        this._camera.updateProjectionMatrix();
-        this.viewport.markRenderStateDirty();
-    }
-    onWindowResize(width, height) {
-        if (this.camera instanceof webgpu.PerspectiveCamera) {
-            this.camera.aspect = width / height;
-        }
-        // if(this.camera instanceof OrthographicCamera)
-        // {
-        //     // to do
-        // }
-        this.camera.updateProjectionMatrix();
-    }
-    async renderAsImage(width = 1024, height = 1024) {
-        return await this.viewport.renderAsImage(width, height);
-    }
-}
-
 class Actor extends BaseObject {
     get world() {
         return this._world;
@@ -2417,6 +2334,15 @@ class Actor extends BaseObject {
     get isVisible() {
         return this.rootComponent ? this.rootComponent.isVisible : false;
     }
+    set isTickEnabled(bCanTick) {
+        super.isTickEnabled = bCanTick;
+        if (this.isTickEnabled) {
+            this.app.world.addTickableActor(this);
+        }
+        else {
+            this.app.world.removeTickableActor(this);
+        }
+    }
     constructor(app, myThreeObject = null) {
         super();
         this._name = "Actor";
@@ -2497,6 +2423,9 @@ class Actor extends BaseObject {
         }
     }
     tick(deltaTime) {
+        if (!this.isTickEnabled) {
+            return;
+        }
         super.tick(deltaTime);
         this.rootComponent.tick(deltaTime);
     }
@@ -2742,6 +2671,146 @@ class Actor extends BaseObject {
     }
 }
 
+class ThreeObjectLibrary {
+    static disposeMeshMaterial(mesh) {
+        let mats = Array.isArray(mesh.material) ? mesh.material : [mesh.material];
+        mats.forEach((elem) => {
+            elem.dispose();
+        });
+    }
+    static disposeMeshGeometry(mesh) {
+        mesh.geometry.dispose();
+    }
+    static disposeMeshResource(mesh) {
+        ThreeObjectLibrary.disposeMeshMaterial(mesh);
+        ThreeObjectLibrary.disposeMeshGeometry(mesh);
+    }
+}
+
+class LevelActor extends Actor {
+    get scene() {
+        if (!this._scene) {
+            throw new Error("scene is null");
+        }
+        return this._scene;
+    }
+    constructor(app) {
+        let scene = new webgpu.Scene();
+        super(app, new webgpu.Scene());
+        this._scene = null;
+        this._scene = scene;
+        this.isTickEnabled = false;
+    }
+    tick(_deltaTime) {
+        return;
+    }
+    destroy() {
+        this.childActors.forEach((elem) => {
+            elem.destroy();
+        });
+        this.scene.traverse((child) => {
+            if (child instanceof three.Mesh) {
+                ThreeObjectLibrary.disposeMeshResource(child);
+            }
+        });
+    }
+}
+
+const DefaultWorldParam = {
+    levelActorClass: LevelActor,
+};
+
+class ThreeJsApp {
+    get camera() {
+        return this._camera;
+    }
+    get clock() {
+        return this._clock;
+    }
+    get world() {
+        return this._world;
+    }
+    get viewport() {
+        return this._viewport;
+    }
+    get controller() {
+        return this._controller;
+    }
+    get assetManager() {
+        return this._assetManager;
+    }
+    get appParam() {
+        return this._appParam;
+    }
+    get onCameraChangedDelegate() {
+        return this._onCameraChangedDelegate;
+    }
+    constructor(appParam = DefaultAppParam) {
+        this._appParam = { viewportParam: DefaultViewportParam };
+        this._onCameraChangedDelegate = new Delegate();
+        this._appParam.cameraParam = appParam.cameraParam ? appParam.cameraParam : DefaultCameraParam;
+        this._appParam.renderParam = appParam.renderParam ? appParam.renderParam : DefaultRenderParam;
+        this._appParam.postProcessParam = appParam.postProcessParam ? appParam.postProcessParam : DefaultPostProcessParam;
+        this._appParam.viewportParam = appParam.viewportParam ? appParam.viewportParam : DefaultViewportParam;
+        this._appParam.classes = appParam.classes ? appParam.classes : {
+            assetManagerClass: AssetManager,
+            controllerClass: Controller,
+            worldClass: World,
+            viewportClass: Viewport,
+        };
+        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._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(() => {
+            this.tick();
+        });
+        this.init();
+    }
+    init() {
+        this.controller.init();
+        this.world.init();
+        this.viewport.init();
+    }
+    tick() {
+        const delta = this._clock.getDelta();
+        this._controller.tick(delta);
+        this.world.tick(delta);
+        this.viewport.render();
+    }
+    destroy() {
+        this.onCameraChangedDelegate.clear();
+        this.world.destroy();
+        this.controller.destroy();
+        this.viewport.destroy();
+        this._assetManager.clearAssets();
+    }
+    updateCamera(param) {
+        const previousCam = this.camera;
+        this._camera = CameraFactory.updataCamera(param, this.camera);
+        if (previousCam !== this.camera) {
+            this._onCameraChangedDelegate.broadcast();
+        }
+        this._camera.updateProjectionMatrix();
+        this.viewport.markRenderStateDirty();
+    }
+    onWindowResize(width, height) {
+        if (this.camera instanceof webgpu.PerspectiveCamera) {
+            this.camera.aspect = width / height;
+        }
+        // if(this.camera instanceof OrthographicCamera)
+        // {
+        //     // to do
+        // }
+        this.camera.updateProjectionMatrix();
+    }
+    async renderAsImage(width = 1024, height = 1024) {
+        return await this.viewport.renderAsImage(width, height);
+    }
+}
+
 /*
  * virtual class of light, should not be use directly.
  */
@@ -3231,12 +3300,14 @@ exports.DefaultSSRParam = DefaultSSRParam;
 exports.DefaultSkyParam = DefaultSkyParam;
 exports.DefaultToneMappingParams = DefaultToneMappingParams;
 exports.DefaultViewportParam = DefaultViewportParam;
+exports.DefaultWorldParam = DefaultWorldParam;
 exports.Delegate = Delegate;
 exports.DirectionalLightActor = DirectionalLightActor;
 exports.DirectionalLightComponent = DirectionalLightComponent;
 exports.FirstPerson = FirstPerson;
 exports.GeometryAssetPointer = GeometryAssetPointer;
 exports.LabelComponent = LabelComponent;
+exports.LevelActor = LevelActor;
 exports.MaterialAssetPointer = MaterialAssetPointer;
 exports.MeshComponent = MeshComponent;
 exports.Orbital = Orbital;

package/dist/bundle.esm.js

@@ -1,4 +1,4 @@
-import { MathUtils, Group, Vector3, Box3, Quaternion, Euler, Matrix4, Mesh, LoadingManager, BufferGeometry, Texture, FileLoader, Material, Scene, NoToneMapping, LinearToneMapping, ReinhardToneMapping, CineonToneMapping, ACESFilmicToneMapping, AgXToneMapping, NeutralToneMapping, WebGPURenderer, PostProcessing, Color, Vector2, Raycaster, PerspectiveCamera, OrthographicCamera, Clock, DirectionalLight, MeshStandardMaterial, BoxGeometry, MeshBasicMaterial, PlaneGeometry, SphereGeometry, Object3D } from 'three/webgpu';
+import { MathUtils, Group, Vector3, Box3, Quaternion, Euler, Matrix4, Mesh, LoadingManager, BufferGeometry, Texture, FileLoader, Material, NoToneMapping, LinearToneMapping, ReinhardToneMapping, CineonToneMapping, ACESFilmicToneMapping, AgXToneMapping, NeutralToneMapping, WebGPURenderer, PostProcessing, Color, Vector2, Raycaster, PerspectiveCamera, OrthographicCamera, Scene, Clock, DirectionalLight, MeshStandardMaterial, BoxGeometry, MeshBasicMaterial, PlaneGeometry, SphereGeometry, Object3D } from 'three/webgpu';
 import { GLTFLoader, DRACOLoader, CSS2DRenderer, OrbitControls } from 'three/examples/jsm/Addons.js';
 import { pass, mrt, output, uniform, velocity, metalness, transformedNormalView, blendColor, time, oscSine } from 'three/tsl';
 import { bloom } from 'three/examples/jsm/tsl/display/BloomNode.js';
@@ -12,6 +12,7 @@ import { motionBlur } from 'three/examples/jsm/tsl/display/MotionBlur.js';
 import { fxaa } from 'three/examples/jsm/tsl/display/FXAANode.js';
 import { smaa } from 'three/examples/jsm/tsl/display/SMAANode.js';
 import { gsap } from 'gsap';
+import { Mesh as Mesh$1 } 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';
@@ -21,10 +22,10 @@ import { TransformControls } from 'three/examples/jsm/controls/TransformControls
  * virtual class of 3D Object, should not be use directly.
  */
 class BaseObject {
-    get IsTickable() {
+    get isTickEnabled() {
         return this.bCanTick;
     }
-    set IsTickable(bCanTick) {
+    set isTickEnabled(bCanTick) {
         this.bCanTick = bCanTick;
     }
     get uuid() {
@@ -32,6 +33,7 @@ class BaseObject {
     }
     constructor(uuid = MathUtils.generateUUID()) {
         this.bCanTick = false;
+        this.tickEvents = [];
         this.bCanTick = false;
         this._uuid = uuid;
     }
@@ -39,6 +41,21 @@ class BaseObject {
         if (!this.bCanTick) {
             return;
         }
+        this.tickEvents.forEach((elem) => {
+            elem(deltaTime);
+        });
+    }
+    addTickEvent(event) {
+        this.tickEvents.push(event);
+    }
+    removeTickEvent(event) {
+        let index = this.tickEvents.indexOf(event);
+        if (index != -1) {
+            this.tickEvents.splice(index, 1);
+        }
+    }
+    clearTickEvents() {
+        this.tickEvents = [];
     }
     destroy() {
     }
@@ -104,7 +121,6 @@ class SceneComponent extends Component {
         this._parentActor = value;
     }
     get parentActor() {
-        // 通过 _parentActor 私有字段访问父级 Actor
         return this._parentActor;
     }
     get world() {
@@ -120,6 +136,12 @@ class SceneComponent extends Component {
     createDefaultThreeObject() {
         this.threeObject = new Group();
     }
+    tick(deltaTime) {
+        super.tick(deltaTime);
+        this.childrenComponents.forEach((elem) => {
+            elem.tick(deltaTime);
+        });
+    }
     get isVisible() {
         if (!this.threeObject) {
             return false;
@@ -897,7 +919,7 @@ class MaterialAssetPointer extends TAssetPointer {
         try {
             this.textures.set(name, texturePtr);
             this.getValue()[name] = texture;
-            texture.addRef();
+            texturePtr.addRef();
             mat.needsUpdate = true;
         }
         catch (e) {
@@ -1224,25 +1246,9 @@ const DefaultPostProcessParam = {
     }
 };
 
-class ThreeObjectLibrary {
-    static disposeMeshMaterial(mesh) {
-        let mats = Array.isArray(mesh.material) ? mesh.material : [mesh.material];
-        mats.forEach((elem) => {
-            elem.dispose();
-        });
-    }
-    static disposeMeshGeometry(mesh) {
-        mesh.geometry.dispose();
-    }
-    static disposeMeshResource(mesh) {
-        ThreeObjectLibrary.disposeMeshMaterial(mesh);
-        ThreeObjectLibrary.disposeMeshGeometry(mesh);
-    }
-}
-
 class World {
     get scene() {
-        return this._scene;
+        return this.rootActor.scene;
     }
     get viewport() {
         return this.app.viewport;
@@ -1250,15 +1256,22 @@ class World {
     get controller() {
         return this.app.controller;
     }
-    constructor(app) {
+    constructor(app, worldParam) {
         this.actors = new Set();
+        this.tickableActors = new Set();
         this.app = app;
-        this._scene = new Scene();
+        this.rootActor = new worldParam.levelActorClass(app);
     }
     init() {
     }
+    addTickableActor(actor) {
+        this.tickableActors.add(actor);
+    }
+    removeTickableActor(actor) {
+        this.tickableActors.delete(actor);
+    }
     tick(deltaTime) {
-        this.actors.forEach((elem) => {
+        this.tickableActors.forEach((elem) => {
             elem.tick(deltaTime);
         });
     }
@@ -1267,19 +1280,14 @@ class World {
             elem.destroy();
         });
         this.actors.clear();
-        this.scene.traverse((child) => {
-            if (child instanceof Mesh) {
-                ThreeObjectLibrary.disposeMeshResource(child);
-            }
-        });
-        this.scene.clear();
+        this.rootActor.destroy();
     }
     addActor(actor) {
         if (!actor.rootComponent.threeObject) {
-            throw Error("actor.threeObject is null");
+            throw new Error("actor.threeObject is null");
         }
         actor.removeFromParent();
-        this.scene.add(actor.rootComponent.threeObject);
+        this.rootActor.addChildActor(actor);
         this.actors.add(actor);
         actor.onAddedToWorld(this);
         this.viewport.markRenderStateDirty();
@@ -2272,97 +2280,6 @@ const DefaultAppParam = {
     }
 };
 
-class ThreeJsApp {
-    get camera() {
-        return this._camera;
-    }
-    get clock() {
-        return this._clock;
-    }
-    get world() {
-        return this._world;
-    }
-    get viewport() {
-        return this._viewport;
-    }
-    get controller() {
-        return this._controller;
-    }
-    get assetManager() {
-        return this._assetManager;
-    }
-    get appParam() {
-        return this._appParam;
-    }
-    get onCameraChangedDelegate() {
-        return this._onCameraChangedDelegate;
-    }
-    constructor(appParam = DefaultAppParam) {
-        this._appParam = { viewportParam: DefaultViewportParam };
-        this._onCameraChangedDelegate = new Delegate();
-        this._appParam.cameraParam = appParam.cameraParam ? appParam.cameraParam : DefaultCameraParam;
-        this._appParam.renderParam = appParam.renderParam ? appParam.renderParam : DefaultRenderParam;
-        this._appParam.postProcessParam = appParam.postProcessParam ? appParam.postProcessParam : DefaultPostProcessParam;
-        this._appParam.viewportParam = appParam.viewportParam ? appParam.viewportParam : DefaultViewportParam;
-        this._appParam.classes = appParam.classes ? appParam.classes : {
-            assetManagerClass: AssetManager,
-            controllerClass: Controller,
-            worldClass: World,
-            viewportClass: Viewport,
-        };
-        this._clock = new Clock();
-        this._camera = CameraFactory.createCamera(this._appParam.cameraParam);
-        this._world = new this._appParam.classes.worldClass(this);
-        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(() => {
-            this.tick();
-        });
-        this.init();
-    }
-    init() {
-        this.controller.init();
-        this.world.init();
-        this.viewport.init();
-    }
-    tick() {
-        const delta = this._clock.getDelta();
-        this._controller.tick(delta);
-        this.world.tick(delta);
-        this.viewport.render();
-    }
-    destroy() {
-        this.onCameraChangedDelegate.clear();
-        this.world.destroy();
-        this.controller.destroy();
-        this.viewport.destroy();
-        this._assetManager.clearAssets();
-    }
-    updateCamera(param) {
-        const previousCam = this.camera;
-        this._camera = CameraFactory.updataCamera(param, this.camera);
-        if (previousCam !== this.camera) {
-            this._onCameraChangedDelegate.broadcast();
-        }
-        this._camera.updateProjectionMatrix();
-        this.viewport.markRenderStateDirty();
-    }
-    onWindowResize(width, height) {
-        if (this.camera instanceof PerspectiveCamera) {
-            this.camera.aspect = width / height;
-        }
-        // if(this.camera instanceof OrthographicCamera)
-        // {
-        //     // to do
-        // }
-        this.camera.updateProjectionMatrix();
-    }
-    async renderAsImage(width = 1024, height = 1024) {
-        return await this.viewport.renderAsImage(width, height);
-    }
-}
-
 class Actor extends BaseObject {
     get world() {
         return this._world;
@@ -2415,6 +2332,15 @@ class Actor extends BaseObject {
     get isVisible() {
         return this.rootComponent ? this.rootComponent.isVisible : false;
     }
+    set isTickEnabled(bCanTick) {
+        super.isTickEnabled = bCanTick;
+        if (this.isTickEnabled) {
+            this.app.world.addTickableActor(this);
+        }
+        else {
+            this.app.world.removeTickableActor(this);
+        }
+    }
     constructor(app, myThreeObject = null) {
         super();
         this._name = "Actor";
@@ -2495,6 +2421,9 @@ class Actor extends BaseObject {
         }
     }
     tick(deltaTime) {
+        if (!this.isTickEnabled) {
+            return;
+        }
         super.tick(deltaTime);
         this.rootComponent.tick(deltaTime);
     }
@@ -2740,6 +2669,146 @@ class Actor extends BaseObject {
     }
 }
 
+class ThreeObjectLibrary {
+    static disposeMeshMaterial(mesh) {
+        let mats = Array.isArray(mesh.material) ? mesh.material : [mesh.material];
+        mats.forEach((elem) => {
+            elem.dispose();
+        });
+    }
+    static disposeMeshGeometry(mesh) {
+        mesh.geometry.dispose();
+    }
+    static disposeMeshResource(mesh) {
+        ThreeObjectLibrary.disposeMeshMaterial(mesh);
+        ThreeObjectLibrary.disposeMeshGeometry(mesh);
+    }
+}
+
+class LevelActor extends Actor {
+    get scene() {
+        if (!this._scene) {
+            throw new Error("scene is null");
+        }
+        return this._scene;
+    }
+    constructor(app) {
+        let scene = new Scene();
+        super(app, new Scene());
+        this._scene = null;
+        this._scene = scene;
+        this.isTickEnabled = false;
+    }
+    tick(_deltaTime) {
+        return;
+    }
+    destroy() {
+        this.childActors.forEach((elem) => {
+            elem.destroy();
+        });
+        this.scene.traverse((child) => {
+            if (child instanceof Mesh$1) {
+                ThreeObjectLibrary.disposeMeshResource(child);
+            }
+        });
+    }
+}
+
+const DefaultWorldParam = {
+    levelActorClass: LevelActor,
+};
+
+class ThreeJsApp {
+    get camera() {
+        return this._camera;
+    }
+    get clock() {
+        return this._clock;
+    }
+    get world() {
+        return this._world;
+    }
+    get viewport() {
+        return this._viewport;
+    }
+    get controller() {
+        return this._controller;
+    }
+    get assetManager() {
+        return this._assetManager;
+    }
+    get appParam() {
+        return this._appParam;
+    }
+    get onCameraChangedDelegate() {
+        return this._onCameraChangedDelegate;
+    }
+    constructor(appParam = DefaultAppParam) {
+        this._appParam = { viewportParam: DefaultViewportParam };
+        this._onCameraChangedDelegate = new Delegate();
+        this._appParam.cameraParam = appParam.cameraParam ? appParam.cameraParam : DefaultCameraParam;
+        this._appParam.renderParam = appParam.renderParam ? appParam.renderParam : DefaultRenderParam;
+        this._appParam.postProcessParam = appParam.postProcessParam ? appParam.postProcessParam : DefaultPostProcessParam;
+        this._appParam.viewportParam = appParam.viewportParam ? appParam.viewportParam : DefaultViewportParam;
+        this._appParam.classes = appParam.classes ? appParam.classes : {
+            assetManagerClass: AssetManager,
+            controllerClass: Controller,
+            worldClass: World,
+            viewportClass: Viewport,
+        };
+        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._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(() => {
+            this.tick();
+        });
+        this.init();
+    }
+    init() {
+        this.controller.init();
+        this.world.init();
+        this.viewport.init();
+    }
+    tick() {
+        const delta = this._clock.getDelta();
+        this._controller.tick(delta);
+        this.world.tick(delta);
+        this.viewport.render();
+    }
+    destroy() {
+        this.onCameraChangedDelegate.clear();
+        this.world.destroy();
+        this.controller.destroy();
+        this.viewport.destroy();
+        this._assetManager.clearAssets();
+    }
+    updateCamera(param) {
+        const previousCam = this.camera;
+        this._camera = CameraFactory.updataCamera(param, this.camera);
+        if (previousCam !== this.camera) {
+            this._onCameraChangedDelegate.broadcast();
+        }
+        this._camera.updateProjectionMatrix();
+        this.viewport.markRenderStateDirty();
+    }
+    onWindowResize(width, height) {
+        if (this.camera instanceof PerspectiveCamera) {
+            this.camera.aspect = width / height;
+        }
+        // if(this.camera instanceof OrthographicCamera)
+        // {
+        //     // to do
+        // }
+        this.camera.updateProjectionMatrix();
+    }
+    async renderAsImage(width = 1024, height = 1024) {
+        return await this.viewport.renderAsImage(width, height);
+    }
+}
+
 /*
  * virtual class of light, should not be use directly.
  */
@@ -3211,4 +3280,4 @@ class TransformGizmo extends Pawn {
     }
 }
 
-export { Actor, AssetManager, AttachmentRules, BoxActor, BoxComponent, Controller, DefaultAppParam, DefaultBloomParam, DefaultCameraParam, DefaultDOFParam, DefaultDenoiseParam, DefaultGTAOParam, DefaultOutlineParams, DefaultPostProcessParam, DefaultRenderParam, DefaultSSRParam, DefaultSkyParam, DefaultToneMappingParams, DefaultViewportParam, Delegate, DirectionalLightActor, DirectionalLightComponent, FirstPerson, GeometryAssetPointer, LabelComponent, MaterialAssetPointer, MeshComponent, Orbital, PlaneActor, PlaneComponent, SceneComponent, SkyActor, SkyComponent, SphereComponent, TAssetPointer, TSmartPointer, TextureAssetPointer, ThreeJsApp, ThreeObjectLibrary, ToneMappingOptions, TransformGizmo, Viewport, WebGPUPostProcessFactory, World };
+export { Actor, AssetManager, AttachmentRules, BoxActor, BoxComponent, Controller, DefaultAppParam, DefaultBloomParam, DefaultCameraParam, DefaultDOFParam, DefaultDenoiseParam, DefaultGTAOParam, DefaultOutlineParams, DefaultPostProcessParam, DefaultRenderParam, DefaultSSRParam, DefaultSkyParam, DefaultToneMappingParams, DefaultViewportParam, DefaultWorldParam, Delegate, DirectionalLightActor, DirectionalLightComponent, FirstPerson, GeometryAssetPointer, LabelComponent, LevelActor, MaterialAssetPointer, MeshComponent, Orbital, PlaneActor, PlaneComponent, SceneComponent, SkyActor, SkyComponent, SphereComponent, TAssetPointer, TSmartPointer, TextureAssetPointer, ThreeJsApp, ThreeObjectLibrary, ToneMappingOptions, TransformGizmo, Viewport, WebGPUPostProcessFactory, World };

package/dist/index.d.ts

@@ -16,11 +16,14 @@ export type { AppParam, AppClass } from "./lythreeframe/Frame/Parameters/AppPara
 export { DefaultRenderParam, DefaultAppParam } from "./lythreeframe/Frame/Parameters/AppParameter";
 export type { ViewportParam } from './lythreeframe/Frame/Parameters/ViewportParameters';
 export { DefaultViewportParam } from './lythreeframe/Frame/Parameters/ViewportParameters';
+export type { WorldParam } from "./lythreeframe/Frame/Parameters/WorldParameter";
+export { DefaultWorldParam } from "./lythreeframe/Frame/Parameters/WorldParameter";
 export { Actor } from "./lythreeframe/Object/Actor";
 export { DirectionalLightActor } from "./lythreeframe/Object/Actors/Light/DirectionalLightActor";
 export { BoxActor } from "./lythreeframe/Object/Actors/Shape/BoxActor";
 export { SkyActor } from "./lythreeframe/Object/Actors/Sky/SkyActor";
 export { PlaneActor } from "./lythreeframe/Object/Actors/Shape/PlaneActor";
+export { LevelActor } from './lythreeframe/Object/Actors/Level/LevelActor';
 export { SceneComponent } from "./lythreeframe/Object/Components/SceneComponent";
 export { MeshComponent } from "./lythreeframe/Object/Components/Mesh/MeshComponent";
 export { BoxComponent } from "./lythreeframe/Object/Components/Mesh/Shape/BoxComponent";

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

@@ -1,2 +1,5 @@
+import { LevelActor } from "../../Object/Actors/Level/LevelActor";
 export interface WorldParam {
+    levelActorClass: typeof LevelActor;
 }
+export declare const DefaultWorldParam: WorldParam;

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

@@ -3,15 +3,20 @@ import { ThreeJsApp } from "../ThreeJsApp";
 import { Viewport } from "./Viewport";
 import { Controller } from "./Controller";
 import { Actor } from "../Object/Actor";
+import { LevelActor } from "../Object/Actors/Level/LevelActor";
+import { WorldParam } from "./Parameters/WorldParameter";
 export declare class World {
     get scene(): Scene;
     get viewport(): Viewport;
     get controller(): Controller;
-    protected _scene: Scene;
+    protected rootActor: LevelActor;
     protected app: ThreeJsApp;
     protected actors: Set<Actor>;
-    constructor(app: ThreeJsApp);
+    protected tickableActors: Set<Actor>;
+    constructor(app: ThreeJsApp, worldParam: WorldParam);
     init(): void;
+    addTickableActor(actor: Actor): void;
+    removeTickableActor(actor: Actor): void;
     tick(deltaTime: number): void;
     destroy(): void;
     addActor(actor: Actor): void;

package/dist/lythreeframe/Object/Actor.d.ts

@@ -14,6 +14,7 @@ export declare class Actor extends BaseObject {
     get childActors(): Actor[];
     get parentActor(): Actor | null;
     get isVisible(): boolean;
+    set isTickEnabled(bCanTick: boolean);
     protected _name: string;
     protected _rootComponent: SceneComponent | null;
     protected _world: World | null;

package/dist/lythreeframe/Object/Actors/Level/LevelActor.d.ts

@@ -0,0 +1,10 @@
+import { Scene } from "three/webgpu";
+import { ThreeJsApp } from "../../../ThreeJsApp";
+import { Actor } from "../../Actor";
+export declare class LevelActor extends Actor {
+    get scene(): Scene;
+    protected _scene: Scene | null;
+    constructor(app: ThreeJsApp);
+    tick(_deltaTime: number): void;
+    destroy(): void;
+}

package/dist/lythreeframe/Object/BaseObject.d.ts

@@ -1,10 +1,14 @@
 export declare abstract class BaseObject {
-    get IsTickable(): boolean;
-    set IsTickable(bCanTick: boolean);
+    get isTickEnabled(): boolean;
+    set isTickEnabled(bCanTick: boolean);
     get uuid(): string;
     protected bCanTick: boolean;
+    protected tickEvents: ((deltaTime: number) => void)[];
     protected _uuid: string;
     protected constructor(uuid?: string);
     tick(deltaTime: number): void;
+    addTickEvent(event: (deltaTime: number) => void): void;
+    removeTickEvent(event: (deltaTime: number) => void): void;
+    clearTickEvents(): void;
     destroy(): void;
 }

package/dist/lythreeframe/Object/Components/SceneComponent.d.ts

@@ -13,6 +13,7 @@ export declare class SceneComponent extends Component {
     protected app: ThreeJsApp;
     constructor(app: ThreeJsApp, newThreeObject: Object3D);
     createDefaultThreeObject(): void;
+    tick(deltaTime: number): void;
     get isVisible(): boolean;
     setVisible(bVisible: boolean): void;
     setLayers(layer: number): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lythreeframe",
-  "version": "1.1.10",
+  "version": "1.1.12",
   "description": "Three.js 封装",
   "main": "dist/bundle.cjs.js",
   "module": "dist/bundle.esm.js",