@egret/engine 0.0.0-stage → 7.0.1-rc.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +201 -0
- package/NOTICE +21 -0
- package/README.md +101 -2
- package/README.zh-CN.md +102 -0
- package/dist/Engine.d.ts +77 -0
- package/dist/Engine.js +464 -0
- package/dist/animation/index.d.ts +6 -0
- package/dist/animation/index.js +5 -0
- package/dist/animation/sequenceController.d.ts +22 -0
- package/dist/animation/sequenceController.js +618 -0
- package/dist/animation/sequenceCoordinator.d.ts +26 -0
- package/dist/animation/sequenceCoordinator.js +161 -0
- package/dist/animation/sequenceInput.d.ts +25 -0
- package/dist/animation/sequenceInput.js +108 -0
- package/dist/animation/sequenceMath.d.ts +35 -0
- package/dist/animation/sequenceMath.js +164 -0
- package/dist/animation/sequenceResetSlot.d.ts +7 -0
- package/dist/animation/sequenceResetSlot.js +367 -0
- package/dist/animation/sequenceResetTypes.d.ts +42 -0
- package/dist/animation/sequenceResetTypes.js +2 -0
- package/dist/animation/types.d.ts +69 -0
- package/dist/animation/types.js +2 -0
- package/dist/assetBundle.d.ts +52 -0
- package/dist/assetBundle.js +173 -0
- package/dist/assetGroup.d.ts +17 -0
- package/dist/assetGroup.js +332 -0
- package/dist/assetGroupTypes.d.ts +15 -0
- package/dist/assetGroupTypes.js +2 -0
- package/dist/audio.d.ts +4 -0
- package/dist/audio.js +4 -0
- package/dist/audioCues.d.ts +43 -0
- package/dist/audioCues.js +127 -0
- package/dist/audioMixer.d.ts +7 -0
- package/dist/audioMixer.js +785 -0
- package/dist/audioTypes.d.ts +233 -0
- package/dist/audioTypes.js +3 -0
- package/dist/bitmapBindingTicket.d.ts +24 -0
- package/dist/bitmapBindingTicket.js +215 -0
- package/dist/bitmapButton.d.ts +4 -0
- package/dist/bitmapButton.js +407 -0
- package/dist/bitmapButtonTypes.d.ts +29 -0
- package/dist/bitmapButtonTypes.js +2 -0
- package/dist/bitmapFontParse.d.ts +10 -0
- package/dist/bitmapFontParse.js +246 -0
- package/dist/bitmapFontTypes.d.ts +109 -0
- package/dist/bitmapFontTypes.js +2 -0
- package/dist/bitmapResourceSlot.d.ts +25 -0
- package/dist/bitmapResourceSlot.js +340 -0
- package/dist/bitmapText.d.ts +6 -0
- package/dist/bitmapText.js +320 -0
- package/dist/bitmapfont.d.ts +5 -0
- package/dist/bitmapfont.js +5 -0
- package/dist/camera.d.ts +4 -0
- package/dist/camera.js +4 -0
- package/dist/camera2d.d.ts +7 -0
- package/dist/camera2d.js +411 -0
- package/dist/cameraTypes.d.ts +114 -0
- package/dist/cameraTypes.js +2 -0
- package/dist/closeHost.d.ts +4 -0
- package/dist/closeHost.js +66 -0
- package/dist/contentArtifacts.d.ts +12 -0
- package/dist/contentArtifacts.js +153 -0
- package/dist/contentAtlasPages.d.ts +13 -0
- package/dist/contentAtlasPages.js +117 -0
- package/dist/contentLoader.d.ts +6 -0
- package/dist/contentLoader.js +327 -0
- package/dist/contentTypes.d.ts +33 -0
- package/dist/contentTypes.js +2 -0
- package/dist/createEngine.d.ts +7 -0
- package/dist/createEngine.js +25 -0
- package/dist/createEngineForProfile.d.ts +5 -0
- package/dist/createEngineForProfile.js +42 -0
- package/dist/displaySubtreeTicket.d.ts +25 -0
- package/dist/displaySubtreeTicket.js +76 -0
- package/dist/fontContentLoader.d.ts +6 -0
- package/dist/fontContentLoader.js +298 -0
- package/dist/fontContentTypes.d.ts +34 -0
- package/dist/fontContentTypes.js +2 -0
- package/dist/gameClock.d.ts +24 -0
- package/dist/gameClock.js +246 -0
- package/dist/gameClockTypes.d.ts +31 -0
- package/dist/gameClockTypes.js +2 -0
- package/dist/gameRun.d.ts +50 -0
- package/dist/gameRun.js +97 -0
- package/dist/gamepad.d.ts +5 -0
- package/dist/gamepad.js +5 -0
- package/dist/gamepadInput.d.ts +4 -0
- package/dist/gamepadInput.js +281 -0
- package/dist/gamepadKeys.d.ts +4 -0
- package/dist/gamepadKeys.js +205 -0
- package/dist/gamepadTypes.d.ts +134 -0
- package/dist/gamepadTypes.js +3 -0
- package/dist/hover.d.ts +4 -0
- package/dist/hover.js +4 -0
- package/dist/hoverInput.d.ts +8 -0
- package/dist/hoverInput.js +503 -0
- package/dist/hoverInputTypes.d.ts +119 -0
- package/dist/hoverInputTypes.js +2 -0
- package/dist/index.d.ts +49 -0
- package/dist/index.js +20 -0
- package/dist/input.d.ts +6 -0
- package/dist/input.js +5 -0
- package/dist/inputActions.d.ts +81 -0
- package/dist/inputActions.js +330 -0
- package/dist/internal/contentFactoryState.d.ts +19 -0
- package/dist/internal/contentFactoryState.js +42 -0
- package/dist/internal/mouseInputFactoryState.d.ts +57 -0
- package/dist/internal/mouseInputFactoryState.js +125 -0
- package/dist/internal/sequenceControllerFactoryState.d.ts +42 -0
- package/dist/internal/sequenceControllerFactoryState.js +98 -0
- package/dist/internal/textFieldFactoryState.d.ts +11 -0
- package/dist/internal/textFieldFactoryState.js +32 -0
- package/dist/internal/texturedFrameState.d.ts +4 -0
- package/dist/internal/texturedFrameState.js +12 -0
- package/dist/internal/uiFactoryState.d.ts +64 -0
- package/dist/internal/uiFactoryState.js +157 -0
- package/dist/internal/uiRootState.d.ts +67 -0
- package/dist/internal/uiRootState.js +103 -0
- package/dist/keyboardInput.d.ts +12 -0
- package/dist/keyboardInput.js +578 -0
- package/dist/keyboardInputTypes.d.ts +81 -0
- package/dist/keyboardInputTypes.js +2 -0
- package/dist/kit.d.ts +14 -0
- package/dist/kit.js +9 -0
- package/dist/layout.d.ts +5 -0
- package/dist/layout.js +132 -0
- package/dist/layoutTypes.d.ts +28 -0
- package/dist/layoutTypes.js +2 -0
- package/dist/manifestAssetGroup.d.ts +10 -0
- package/dist/manifestAssetGroup.js +477 -0
- package/dist/manifestResourceState.d.ts +16 -0
- package/dist/manifestResourceState.js +57 -0
- package/dist/manifestResourceTypes.d.ts +25 -0
- package/dist/manifestResourceTypes.js +2 -0
- package/dist/motion.d.ts +33 -0
- package/dist/motion.js +206 -0
- package/dist/mouseInput.d.ts +102 -0
- package/dist/mouseInput.js +562 -0
- package/dist/mouseInputTypes.d.ts +37 -0
- package/dist/mouseInputTypes.js +2 -0
- package/dist/paragraph.d.ts +8 -0
- package/dist/paragraph.js +7 -0
- package/dist/particleEmitter.d.ts +4 -0
- package/dist/particleEmitter.js +292 -0
- package/dist/particleTypes.d.ts +107 -0
- package/dist/particleTypes.js +2 -0
- package/dist/particles.d.ts +4 -0
- package/dist/particles.js +4 -0
- package/dist/physics2d.d.ts +4 -0
- package/dist/physics2d.js +4 -0
- package/dist/physics2dGeometry.d.ts +39 -0
- package/dist/physics2dGeometry.js +230 -0
- package/dist/physics2dTypes.d.ts +167 -0
- package/dist/physics2dTypes.js +2 -0
- package/dist/physics2dWorld.d.ts +4 -0
- package/dist/physics2dWorld.js +623 -0
- package/dist/pointerInput.d.ts +11 -0
- package/dist/pointerInput.js +299 -0
- package/dist/pointerInputTypes.d.ts +38 -0
- package/dist/pointerInputTypes.js +2 -0
- package/dist/random.d.ts +29 -0
- package/dist/random.js +131 -0
- package/dist/rendering/ownedPreparationFailure2D.d.ts +5 -0
- package/dist/rendering/ownedPreparationFailure2D.js +33 -0
- package/dist/rendering/packSharedDraws2D.d.ts +50 -0
- package/dist/rendering/packSharedDraws2D.js +331 -0
- package/dist/rendering/packedOrientation.d.ts +4 -0
- package/dist/rendering/packedOrientation.js +7 -0
- package/dist/rendering/prepareRectangles2D.d.ts +92 -0
- package/dist/rendering/prepareRectangles2D.js +481 -0
- package/dist/rendering/prepareSharedDraws2D.d.ts +88 -0
- package/dist/rendering/prepareSharedDraws2D.js +652 -0
- package/dist/rendering/preparedBatches2D.d.ts +17 -0
- package/dist/rendering/preparedBatches2D.js +30 -0
- package/dist/rendering/preparedSharedBatches2D.d.ts +44 -0
- package/dist/rendering/preparedSharedBatches2D.js +247 -0
- package/dist/rendering/sharedColor2D.d.ts +18 -0
- package/dist/rendering/sharedColor2D.js +68 -0
- package/dist/rendering/sharedEffects2D.d.ts +23 -0
- package/dist/rendering/sharedEffects2D.js +118 -0
- package/dist/rendering/sharedPreparationRetention2D.d.ts +120 -0
- package/dist/rendering/sharedPreparationRetention2D.js +357 -0
- package/dist/rendering/srgbBytes.d.ts +3 -0
- package/dist/rendering/srgbBytes.js +64 -0
- package/dist/rendering/texturedPreparationBudget2D.d.ts +31 -0
- package/dist/rendering/texturedPreparationBudget2D.js +81 -0
- package/dist/rendering/world3d/Animation3D.d.ts +95 -0
- package/dist/rendering/world3d/Animation3D.js +380 -0
- package/dist/rendering/world3d/AnimationTexture3D.d.ts +157 -0
- package/dist/rendering/world3d/AnimationTexture3D.js +601 -0
- package/dist/rendering/world3d/Batch3D.d.ts +71 -0
- package/dist/rendering/world3d/Batch3D.js +329 -0
- package/dist/rendering/world3d/Camera3D.d.ts +57 -0
- package/dist/rendering/world3d/Camera3D.js +129 -0
- package/dist/rendering/world3d/Character3D.d.ts +123 -0
- package/dist/rendering/world3d/Character3D.js +303 -0
- package/dist/rendering/world3d/Cloth3D.d.ts +115 -0
- package/dist/rendering/world3d/Cloth3D.js +498 -0
- package/dist/rendering/world3d/Compression3D.d.ts +21 -0
- package/dist/rendering/world3d/Compression3D.js +702 -0
- package/dist/rendering/world3d/Curves3D.d.ts +111 -0
- package/dist/rendering/world3d/Curves3D.js +455 -0
- package/dist/rendering/world3d/Decal3D.d.ts +41 -0
- package/dist/rendering/world3d/Decal3D.js +241 -0
- package/dist/rendering/world3d/Geometry3D.d.ts +85 -0
- package/dist/rendering/world3d/Geometry3D.js +326 -0
- package/dist/rendering/world3d/GeometryBuilder3D.d.ts +51 -0
- package/dist/rendering/world3d/GeometryBuilder3D.js +196 -0
- package/dist/rendering/world3d/Gizmo3D.d.ts +75 -0
- package/dist/rendering/world3d/Gizmo3D.js +512 -0
- package/dist/rendering/world3d/Gltf3D.d.ts +67 -0
- package/dist/rendering/world3d/Gltf3D.js +976 -0
- package/dist/rendering/world3d/GpuParticles3D.d.ts +107 -0
- package/dist/rendering/world3d/GpuParticles3D.js +400 -0
- package/dist/rendering/world3d/Hdr3D.d.ts +33 -0
- package/dist/rendering/world3d/Hdr3D.js +190 -0
- package/dist/rendering/world3d/Jelly3D.d.ts +75 -0
- package/dist/rendering/world3d/Jelly3D.js +266 -0
- package/dist/rendering/world3d/Ktx23D.d.ts +27 -0
- package/dist/rendering/world3d/Ktx23D.js +112 -0
- package/dist/rendering/world3d/Light3D.d.ts +75 -0
- package/dist/rendering/world3d/Light3D.js +93 -0
- package/dist/rendering/world3d/Material3D.d.ts +243 -0
- package/dist/rendering/world3d/Material3D.js +267 -0
- package/dist/rendering/world3d/Mesh3D.d.ts +108 -0
- package/dist/rendering/world3d/Mesh3D.js +323 -0
- package/dist/rendering/world3d/Meshopt3D.d.ts +12 -0
- package/dist/rendering/world3d/Meshopt3D.js +275 -0
- package/dist/rendering/world3d/Navigation3D.d.ts +173 -0
- package/dist/rendering/world3d/Navigation3D.js +971 -0
- package/dist/rendering/world3d/Object3D.d.ts +107 -0
- package/dist/rendering/world3d/Object3D.js +305 -0
- package/dist/rendering/world3d/Particles3D.d.ts +85 -0
- package/dist/rendering/world3d/Particles3D.js +274 -0
- package/dist/rendering/world3d/Physics3D.d.ts +416 -0
- package/dist/rendering/world3d/Physics3D.js +2835 -0
- package/dist/rendering/world3d/PhysicsHull3D.d.ts +35 -0
- package/dist/rendering/world3d/PhysicsHull3D.js +227 -0
- package/dist/rendering/world3d/PhysicsMesh3D.d.ts +39 -0
- package/dist/rendering/world3d/PhysicsMesh3D.js +338 -0
- package/dist/rendering/world3d/PhysicsQueries3D.d.ts +24 -0
- package/dist/rendering/world3d/PhysicsQueries3D.js +323 -0
- package/dist/rendering/world3d/PhysicsRemote3D.d.ts +174 -0
- package/dist/rendering/world3d/PhysicsRemote3D.js +534 -0
- package/dist/rendering/world3d/Ragdoll3D.d.ts +69 -0
- package/dist/rendering/world3d/Ragdoll3D.js +200 -0
- package/dist/rendering/world3d/Raycast3D.d.ts +37 -0
- package/dist/rendering/world3d/Raycast3D.js +246 -0
- package/dist/rendering/world3d/RenderList3D.d.ts +88 -0
- package/dist/rendering/world3d/RenderList3D.js +490 -0
- package/dist/rendering/world3d/Retarget3D.d.ts +20 -0
- package/dist/rendering/world3d/Retarget3D.js +185 -0
- package/dist/rendering/world3d/Serialize3D.d.ts +49 -0
- package/dist/rendering/world3d/Serialize3D.js +607 -0
- package/dist/rendering/world3d/StateMachine3D.d.ts +78 -0
- package/dist/rendering/world3d/StateMachine3D.js +277 -0
- package/dist/rendering/world3d/Terrain3D.d.ts +227 -0
- package/dist/rendering/world3d/Terrain3D.js +803 -0
- package/dist/rendering/world3d/Text3D.d.ts +90 -0
- package/dist/rendering/world3d/Text3D.js +558 -0
- package/dist/rendering/world3d/Texture3D.d.ts +133 -0
- package/dist/rendering/world3d/Texture3D.js +252 -0
- package/dist/rendering/world3d/Trail3D.d.ts +59 -0
- package/dist/rendering/world3d/Trail3D.js +193 -0
- package/dist/rendering/world3d/Vehicle3D.d.ts +97 -0
- package/dist/rendering/world3d/Vehicle3D.js +226 -0
- package/dist/rendering/world3d/VolumetricFog3D.d.ts +55 -0
- package/dist/rendering/world3d/VolumetricFog3D.js +229 -0
- package/dist/rendering/world3d/Water3D.d.ts +163 -0
- package/dist/rendering/world3d/Water3D.js +606 -0
- package/dist/rendering/world3d/core3D.d.ts +34 -0
- package/dist/rendering/world3d/core3D.js +99 -0
- package/dist/rendering/world3d/debug3D.d.ts +64 -0
- package/dist/rendering/world3d/debug3D.js +257 -0
- package/dist/rendering/world3d/decoders3D.d.ts +42 -0
- package/dist/rendering/world3d/decoders3D.js +133 -0
- package/dist/rendering/world3d/geometries3D.d.ts +99 -0
- package/dist/rendering/world3d/geometries3D.js +605 -0
- package/dist/rendering/world3d/helpers3D.d.ts +65 -0
- package/dist/rendering/world3d/helpers3D.js +177 -0
- package/dist/rendering/world3d/index.d.ts +91 -0
- package/dist/rendering/world3d/index.js +56 -0
- package/dist/rendering/world3d/math3D.d.ts +78 -0
- package/dist/rendering/world3d/math3D.js +640 -0
- package/dist/rendering/world3d/primitives3D.d.ts +60 -0
- package/dist/rendering/world3d/primitives3D.js +196 -0
- package/dist/resources.d.ts +8 -0
- package/dist/resources.js +6 -0
- package/dist/saveStore.d.ts +56 -0
- package/dist/saveStore.js +163 -0
- package/dist/semanticList.d.ts +122 -0
- package/dist/semanticList.js +174 -0
- package/dist/semanticTree.d.ts +10 -0
- package/dist/semanticTree.js +532 -0
- package/dist/semanticTypes.d.ts +167 -0
- package/dist/semanticTypes.js +2 -0
- package/dist/semantics.d.ts +6 -0
- package/dist/semantics.js +5 -0
- package/dist/sequencePlayback.d.ts +19 -0
- package/dist/sequencePlayback.js +391 -0
- package/dist/sequencePlaybackTypes.d.ts +21 -0
- package/dist/sequencePlaybackTypes.js +2 -0
- package/dist/sequenceTargetClaims.d.ts +10 -0
- package/dist/sequenceTargetClaims.js +31 -0
- package/dist/srgbBytes.d.ts +3 -0
- package/dist/srgbBytes.js +64 -0
- package/dist/startEngine.d.ts +5 -0
- package/dist/startEngine.js +31 -0
- package/dist/surfaceOwnership.d.ts +3 -0
- package/dist/surfaceOwnership.js +15 -0
- package/dist/text.d.ts +23 -0
- package/dist/text.js +4 -0
- package/dist/textField.d.ts +6 -0
- package/dist/textField.js +6 -0
- package/dist/tileMapDraw.d.ts +7 -0
- package/dist/tileMapDraw.js +310 -0
- package/dist/tiledImport.d.ts +9 -0
- package/dist/tiledImport.js +357 -0
- package/dist/tilemap.d.ts +5 -0
- package/dist/tilemap.js +5 -0
- package/dist/tilemapTypes.d.ts +169 -0
- package/dist/tilemapTypes.js +2 -0
- package/dist/tween.d.ts +15 -0
- package/dist/tween.js +329 -0
- package/dist/tweenTypes.d.ts +27 -0
- package/dist/tweenTypes.js +2 -0
- package/dist/ui/controlKeys.d.ts +109 -0
- package/dist/ui/controlKeys.js +249 -0
- package/dist/ui/controls.d.ts +52 -0
- package/dist/ui/controls.js +288 -0
- package/dist/ui/editing.d.ts +3 -0
- package/dist/ui/editing.js +3 -0
- package/dist/ui/index.d.ts +19 -0
- package/dist/ui/index.js +11 -0
- package/dist/ui/keyboardFocus.d.ts +32 -0
- package/dist/ui/keyboardFocus.js +146 -0
- package/dist/ui/layerTypes.d.ts +91 -0
- package/dist/ui/layerTypes.js +2 -0
- package/dist/ui/layers.d.ts +4 -0
- package/dist/ui/layers.js +586 -0
- package/dist/ui/leafContent.d.ts +21 -0
- package/dist/ui/leafContent.js +136 -0
- package/dist/ui/rangeControl.d.ts +50 -0
- package/dist/ui/rangeControl.js +167 -0
- package/dist/ui/scrollControl.d.ts +72 -0
- package/dist/ui/scrollControl.js +218 -0
- package/dist/ui/stateControls.d.ts +82 -0
- package/dist/ui/stateControls.js +328 -0
- package/dist/ui/textEditor.d.ts +53 -0
- package/dist/ui/textEditor.js +370 -0
- package/dist/ui/textEditorTypes.d.ts +78 -0
- package/dist/ui/textEditorTypes.js +2 -0
- package/dist/ui/textFieldControl.d.ts +96 -0
- package/dist/ui/textFieldControl.js +259 -0
- package/dist/ui/theme.d.ts +59 -0
- package/dist/ui/theme.js +165 -0
- package/dist/ui/types.d.ts +265 -0
- package/dist/ui/types.js +2 -0
- package/dist/ui/uiRoot.d.ts +4 -0
- package/dist/ui/uiRoot.js +1497 -0
- package/dist/ui/uiRootDisplay.d.ts +46 -0
- package/dist/ui/uiRootDisplay.js +148 -0
- package/dist/ui/uiRootModel.d.ts +112 -0
- package/dist/ui/uiRootModel.js +60 -0
- package/dist/ui/virtualList.d.ts +20 -0
- package/dist/ui/virtualList.js +105 -0
- package/dist/video.d.ts +4 -0
- package/dist/video.js +4 -0
- package/dist/videoPlayer.d.ts +4 -0
- package/dist/videoPlayer.js +215 -0
- package/dist/videoTypes.d.ts +74 -0
- package/dist/videoTypes.js +2 -0
- package/dist/web/BrowserAssetBundle.d.ts +39 -0
- package/dist/web/BrowserAssetBundle.js +136 -0
- package/dist/web/BrowserAudio.d.ts +41 -0
- package/dist/web/BrowserAudio.js +473 -0
- package/dist/web/BrowserFrameLoop.d.ts +65 -0
- package/dist/web/BrowserFrameLoop.js +125 -0
- package/dist/web/BrowserGame.d.ts +112 -0
- package/dist/web/BrowserGame.js +352 -0
- package/dist/web/BrowserGamepadInput.d.ts +35 -0
- package/dist/web/BrowserGamepadInput.js +134 -0
- package/dist/web/BrowserHoverInput.d.ts +24 -0
- package/dist/web/BrowserHoverInput.js +266 -0
- package/dist/web/BrowserImageTextures.d.ts +66 -0
- package/dist/web/BrowserImageTextures.js +169 -0
- package/dist/web/BrowserInputActions.d.ts +53 -0
- package/dist/web/BrowserInputActions.js +342 -0
- package/dist/web/BrowserKeyboardInput.d.ts +4 -0
- package/dist/web/BrowserKeyboardInput.js +223 -0
- package/dist/web/BrowserPlay.d.ts +289 -0
- package/dist/web/BrowserPlay.js +1301 -0
- package/dist/web/BrowserPointerInput.d.ts +4 -0
- package/dist/web/BrowserPointerInput.js +511 -0
- package/dist/web/BrowserSemantics.d.ts +34 -0
- package/dist/web/BrowserSemantics.js +418 -0
- package/dist/web/BrowserStatsPanel.d.ts +46 -0
- package/dist/web/BrowserStatsPanel.js +137 -0
- package/dist/web/BrowserStorage.d.ts +33 -0
- package/dist/web/BrowserStorage.js +132 -0
- package/dist/web/BrowserTextEditor.d.ts +49 -0
- package/dist/web/BrowserTextEditor.js +839 -0
- package/dist/web/BrowserTextInput.d.ts +83 -0
- package/dist/web/BrowserTextInput.js +524 -0
- package/dist/web/BrowserTextureProvider.d.ts +52 -0
- package/dist/web/BrowserTextureProvider.js +935 -0
- package/dist/web/BrowserVideo.d.ts +28 -0
- package/dist/web/BrowserVideo.js +211 -0
- package/dist/web/CanvasKitFontSetProvider.d.ts +29 -0
- package/dist/web/CanvasKitFontSetProvider.js +215 -0
- package/dist/web/CanvasKitParagraphProvider.d.ts +169 -0
- package/dist/web/CanvasKitParagraphProvider.js +691 -0
- package/dist/web/CanvasTextRasterProvider.d.ts +4 -0
- package/dist/web/CanvasTextRasterProvider.js +312 -0
- package/dist/web/ManifestByteSource.d.ts +147 -0
- package/dist/web/ManifestByteSource.js +974 -0
- package/dist/web/ManifestFontContentLoader.d.ts +12 -0
- package/dist/web/ManifestFontContentLoader.js +30 -0
- package/dist/web/MouseInput.d.ts +4 -0
- package/dist/web/MouseInput.js +218 -0
- package/dist/web/WebGL2Host.d.ts +5 -0
- package/dist/web/WebGL2Host.js +2672 -0
- package/dist/web/WebGPUHost.d.ts +87 -0
- package/dist/web/WebGPUHost.js +3349 -0
- package/dist/web/audio.d.ts +3 -0
- package/dist/web/audio.js +4 -0
- package/dist/web/canvasKitParagraphGeometry.d.ts +27 -0
- package/dist/web/canvasKitParagraphGeometry.js +83 -0
- package/dist/web/editing.d.ts +5 -0
- package/dist/web/editing.js +4 -0
- package/dist/web/editorFonts.d.ts +50 -0
- package/dist/web/editorFonts.js +297 -0
- package/dist/web/game.d.ts +5 -0
- package/dist/web/game.js +6 -0
- package/dist/web/gamepad.d.ts +3 -0
- package/dist/web/gamepad.js +4 -0
- package/dist/web/hover.d.ts +3 -0
- package/dist/web/hover.js +4 -0
- package/dist/web/image.d.ts +4 -0
- package/dist/web/image.js +4 -0
- package/dist/web/imageProjections2D.d.ts +14 -0
- package/dist/web/imageProjections2D.js +2 -0
- package/dist/web/input.d.ts +6 -0
- package/dist/web/input.js +4 -0
- package/dist/web/keyboard.d.ts +3 -0
- package/dist/web/keyboard.js +3 -0
- package/dist/web/kit.d.ts +10 -0
- package/dist/web/kit.js +7 -0
- package/dist/web/loop.d.ts +3 -0
- package/dist/web/loop.js +4 -0
- package/dist/web/paragraph.d.ts +6 -0
- package/dist/web/paragraph.js +4 -0
- package/dist/web/play.d.ts +5 -0
- package/dist/web/play.js +6 -0
- package/dist/web/playSfx.d.ts +36 -0
- package/dist/web/playSfx.js +112 -0
- package/dist/web/pointer.d.ts +3 -0
- package/dist/web/pointer.js +3 -0
- package/dist/web/prepareSharedSubmission2D.d.ts +27 -0
- package/dist/web/prepareSharedSubmission2D.js +57 -0
- package/dist/web/resources.d.ts +27 -0
- package/dist/web/resources.js +96 -0
- package/dist/web/semantics.d.ts +3 -0
- package/dist/web/semantics.js +4 -0
- package/dist/web/sharedDeviceSession.d.ts +64 -0
- package/dist/web/sharedDeviceSession.js +2 -0
- package/dist/web/sharedEffectShaders.d.ts +9 -0
- package/dist/web/sharedEffectShaders.js +165 -0
- package/dist/web/sharedFrameUpload.d.ts +25 -0
- package/dist/web/sharedFrameUpload.js +2 -0
- package/dist/web/sharedHostDeferred.d.ts +7 -0
- package/dist/web/sharedHostDeferred.js +12 -0
- package/dist/web/sharedRetentionLedger.d.ts +85 -0
- package/dist/web/sharedRetentionLedger.js +391 -0
- package/dist/web/sharedSubmissionStorage2D.d.ts +56 -0
- package/dist/web/sharedSubmissionStorage2D.js +73 -0
- package/dist/web/sharedWebGL2Arena.d.ts +40 -0
- package/dist/web/sharedWebGL2Arena.js +77 -0
- package/dist/web/sharedWebGL2Options.d.ts +30 -0
- package/dist/web/sharedWebGL2Options.js +96 -0
- package/dist/web/sharedWebGL2Shaders.d.ts +20 -0
- package/dist/web/sharedWebGL2Shaders.js +314 -0
- package/dist/web/sharedWebGPUOptions.d.ts +37 -0
- package/dist/web/sharedWebGPUOptions.js +126 -0
- package/dist/web/text.d.ts +3 -0
- package/dist/web/text.js +3 -0
- package/dist/web/textInput.d.ts +3 -0
- package/dist/web/textInput.js +3 -0
- package/dist/web/video.d.ts +3 -0
- package/dist/web/video.js +4 -0
- package/dist/web/webgl2.d.ts +7 -0
- package/dist/web/webgl2.js +4 -0
- package/dist/web/webgl2LayerState.d.ts +50 -0
- package/dist/web/webgl2LayerState.js +102 -0
- package/dist/web/webgl2Native.d.ts +70 -0
- package/dist/web/webgl2Native.js +568 -0
- package/dist/web/webgl2Types.d.ts +132 -0
- package/dist/web/webgl2Types.js +2 -0
- package/dist/web/webgpu.d.ts +6 -0
- package/dist/web/webgpu.js +2 -0
- package/dist/web/webgpuBindingCache.d.ts +26 -0
- package/dist/web/webgpuBindingCache.js +223 -0
- package/dist/web/webgpuBufferPool.d.ts +51 -0
- package/dist/web/webgpuBufferPool.js +58 -0
- package/dist/web/webgpuImageResidency.d.ts +53 -0
- package/dist/web/webgpuImageResidency.js +61 -0
- package/dist/web/webgpuLifetime.d.ts +45 -0
- package/dist/web/webgpuLifetime.js +64 -0
- package/dist/web/webgpuRetentionPool.d.ts +66 -0
- package/dist/web/webgpuRetentionPool.js +84 -0
- package/dist/web/webgpuSharedPass.d.ts +7 -0
- package/dist/web/webgpuSharedPass.js +211 -0
- package/dist/web/webgpuSharedResolvePass.d.ts +3 -0
- package/dist/web/webgpuSharedResolvePass.js +29 -0
- package/dist/web/world3d/Audio3D.d.ts +68 -0
- package/dist/web/world3d/Audio3D.js +212 -0
- package/dist/web/world3d/BrowserPlay3D.d.ts +182 -0
- package/dist/web/world3d/BrowserPlay3D.js +851 -0
- package/dist/web/world3d/FlyControls3D.d.ts +55 -0
- package/dist/web/world3d/FlyControls3D.js +160 -0
- package/dist/web/world3d/FollowControls3D.d.ts +28 -0
- package/dist/web/world3d/FollowControls3D.js +117 -0
- package/dist/web/world3d/OrbitControls3D.d.ts +55 -0
- package/dist/web/world3d/OrbitControls3D.js +187 -0
- package/dist/web/world3d/TransformControls3D.d.ts +34 -0
- package/dist/web/world3d/TransformControls3D.js +125 -0
- package/dist/web/world3d/WebGL2Renderer3D.d.ts +133 -0
- package/dist/web/world3d/WebGL2Renderer3D.js +1173 -0
- package/dist/web/world3d/WebGPURenderer3D.d.ts +110 -0
- package/dist/web/world3d/WebGPURenderer3D.js +1915 -0
- package/dist/web/world3d/World3DView.d.ts +51 -0
- package/dist/web/world3d/World3DView.js +77 -0
- package/dist/web/world3d/app3D.d.ts +136 -0
- package/dist/web/world3d/app3D.js +304 -0
- package/dist/web/world3d/assets3D.d.ts +38 -0
- package/dist/web/world3d/assets3D.js +112 -0
- package/dist/web/world3d/atmosphere3D.d.ts +47 -0
- package/dist/web/world3d/atmosphere3D.js +178 -0
- package/dist/web/world3d/frame3D.d.ts +142 -0
- package/dist/web/world3d/frame3D.js +388 -0
- package/dist/web/world3d/gpuResources3D.d.ts +98 -0
- package/dist/web/world3d/gpuResources3D.js +901 -0
- package/dist/web/world3d/host3D.d.ts +23 -0
- package/dist/web/world3d/host3D.js +61 -0
- package/dist/web/world3d/index.d.ts +38 -0
- package/dist/web/world3d/index.js +23 -0
- package/dist/web/world3d/loaders3D.d.ts +26 -0
- package/dist/web/world3d/loaders3D.js +138 -0
- package/dist/web/world3d/markers3D.d.ts +49 -0
- package/dist/web/world3d/markers3D.js +130 -0
- package/dist/web/world3d/materialWebGL23D.d.ts +34 -0
- package/dist/web/world3d/materialWebGL23D.js +218 -0
- package/dist/web/world3d/overlay3D.d.ts +28 -0
- package/dist/web/world3d/overlay3D.js +170 -0
- package/dist/web/world3d/post3D.d.ts +112 -0
- package/dist/web/world3d/post3D.js +459 -0
- package/dist/web/world3d/postWebGL23D.d.ts +24 -0
- package/dist/web/world3d/postWebGL23D.js +237 -0
- package/dist/web/world3d/postWebGPU3D.d.ts +23 -0
- package/dist/web/world3d/postWebGPU3D.js +255 -0
- package/dist/web/world3d/probe3D.d.ts +14 -0
- package/dist/web/world3d/probe3D.js +66 -0
- package/dist/web/world3d/shaders3D.d.ts +43 -0
- package/dist/web/world3d/shaders3D.js +851 -0
- package/dist/web/world3d/stats3D.d.ts +31 -0
- package/dist/web/world3d/stats3D.js +80 -0
- package/dist/web/world3d/webGL2FrameMetrics3D.d.ts +66 -0
- package/dist/web/world3d/webGL2FrameMetrics3D.js +185 -0
- package/dist/web/world3d/webgpu.d.ts +35 -0
- package/dist/web/world3d/webgpu.js +22 -0
- package/dist/web/world3d/webgpuPacking3D.d.ts +13 -0
- package/dist/web/world3d/webgpuPacking3D.js +85 -0
- package/dist/web/world3d/wgsl3D.d.ts +68 -0
- package/dist/web/world3d/wgsl3D.js +781 -0
- package/package.json +220 -4
|
@@ -0,0 +1,277 @@
|
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
// Parameter-driven animation state machine on top of AnimationMixer3D.
|
|
3
|
+
// States play one clip or a 1D blend of several; transitions fire on
|
|
4
|
+
// parameter conditions and an optional exit time, and cross-fade by weight.
|
|
5
|
+
// An interrupted fade keeps the weights it had reached, so poses never pop.
|
|
6
|
+
import { AnimationMixer3D } from './Animation3D.js';
|
|
7
|
+
import { World3DError, requireFinite3D } from './core3D.js';
|
|
8
|
+
export const STATE_MACHINE3D_LIMITS = Object.freeze({
|
|
9
|
+
maxStates: 256,
|
|
10
|
+
maxTransitions: 2048,
|
|
11
|
+
maxTransitionsPerUpdate: 8
|
|
12
|
+
});
|
|
13
|
+
export class AnimationStateMachine3D {
|
|
14
|
+
mixer;
|
|
15
|
+
/** Called after every state change, including forced ones. */
|
|
16
|
+
onStateChange;
|
|
17
|
+
#states = new Map();
|
|
18
|
+
#transitions = [];
|
|
19
|
+
#parameters = new Map();
|
|
20
|
+
#triggers = new Set();
|
|
21
|
+
#current;
|
|
22
|
+
#fadeDuration = 0;
|
|
23
|
+
#fadeElapsed = 0;
|
|
24
|
+
#fading = false;
|
|
25
|
+
constructor(mixer) {
|
|
26
|
+
if (!(mixer instanceof AnimationMixer3D))
|
|
27
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'mixer');
|
|
28
|
+
this.mixer = mixer;
|
|
29
|
+
}
|
|
30
|
+
/** Name of the active state; during a fade this is the state being faded in. */
|
|
31
|
+
get current() {
|
|
32
|
+
return this.#current?.name;
|
|
33
|
+
}
|
|
34
|
+
get isTransitioning() {
|
|
35
|
+
return this.#fading;
|
|
36
|
+
}
|
|
37
|
+
/** Play time of the active state in passes of its duration. */
|
|
38
|
+
get normalizedTime() {
|
|
39
|
+
return this.#current?.normalizedTime ?? 0;
|
|
40
|
+
}
|
|
41
|
+
addState(name, options) {
|
|
42
|
+
if (typeof name !== 'string' || name.length === 0 || name === '*' || this.#states.has(name))
|
|
43
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'state name');
|
|
44
|
+
if (this.#states.size >= STATE_MACHINE3D_LIMITS.maxStates)
|
|
45
|
+
throw new World3DError('WORLD3D_BUDGET', 'states');
|
|
46
|
+
const entries = options.blend
|
|
47
|
+
? [...options.blend.clips].sort((a, b) => a.threshold - b.threshold)
|
|
48
|
+
: options.clip
|
|
49
|
+
? [{ clip: options.clip, threshold: 0 }]
|
|
50
|
+
: [];
|
|
51
|
+
if (entries.length === 0 || (options.blend && options.clip))
|
|
52
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'state needs a clip or a blend');
|
|
53
|
+
for (const entry of entries)
|
|
54
|
+
requireFinite3D(entry.threshold, 'blend threshold');
|
|
55
|
+
const loop = options.loop ?? true, speed = requireFinite3D(options.speed ?? 1, 'state speed');
|
|
56
|
+
const actions = entries.map(entry => {
|
|
57
|
+
const action = this.mixer.clipAction(entry.clip);
|
|
58
|
+
action.loop = loop ? 'repeat' : 'once';
|
|
59
|
+
action.clampWhenFinished = !loop;
|
|
60
|
+
return action;
|
|
61
|
+
});
|
|
62
|
+
this.#states.set(name, {
|
|
63
|
+
name,
|
|
64
|
+
actions,
|
|
65
|
+
thresholds: entries.map(entry => entry.threshold),
|
|
66
|
+
blendParameter: options.blend?.parameter,
|
|
67
|
+
loop,
|
|
68
|
+
speed,
|
|
69
|
+
onEnter: options.onEnter,
|
|
70
|
+
onExit: options.onExit,
|
|
71
|
+
events: [],
|
|
72
|
+
blendWeights: entries.map(() => 0),
|
|
73
|
+
weight: 0,
|
|
74
|
+
fadeFrom: 0,
|
|
75
|
+
normalizedTime: 0
|
|
76
|
+
});
|
|
77
|
+
return this;
|
|
78
|
+
}
|
|
79
|
+
addTransition(options) {
|
|
80
|
+
if (options.from !== '*' && !this.#states.has(options.from))
|
|
81
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'transition from: ' + options.from);
|
|
82
|
+
if (!this.#states.has(options.to))
|
|
83
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'transition to: ' + options.to);
|
|
84
|
+
if (this.#transitions.length >= STATE_MACHINE3D_LIMITS.maxTransitions)
|
|
85
|
+
throw new World3DError('WORLD3D_BUDGET', 'transitions');
|
|
86
|
+
const conditions = [...(options.conditions ?? [])];
|
|
87
|
+
if (conditions.length === 0 && options.exitTime === undefined)
|
|
88
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'transition needs a condition or an exit time');
|
|
89
|
+
for (const condition of conditions)
|
|
90
|
+
if (typeof condition.parameter !== 'string' || condition.parameter.length === 0)
|
|
91
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'condition parameter');
|
|
92
|
+
const duration = Math.max(0, requireFinite3D(options.duration ?? 0.2, 'transition duration'));
|
|
93
|
+
this.#transitions.push({
|
|
94
|
+
from: options.from,
|
|
95
|
+
to: options.to,
|
|
96
|
+
duration,
|
|
97
|
+
conditions,
|
|
98
|
+
exitTime: options.exitTime === undefined ? undefined : requireFinite3D(options.exitTime, 'exitTime'),
|
|
99
|
+
canInterrupt: options.canInterrupt ?? true
|
|
100
|
+
});
|
|
101
|
+
return this;
|
|
102
|
+
}
|
|
103
|
+
/** Run `callback` each time `state` passes `normalizedTime` (0 to 1 within one pass). */
|
|
104
|
+
addEvent(state, normalizedTime, callback) {
|
|
105
|
+
const target = this.#states.get(state);
|
|
106
|
+
if (!target || typeof callback !== 'function')
|
|
107
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'event');
|
|
108
|
+
target.events.push({ time: Math.min(Math.max(requireFinite3D(normalizedTime, 'event time'), 0), 1), callback });
|
|
109
|
+
return this;
|
|
110
|
+
}
|
|
111
|
+
set(parameter, value) {
|
|
112
|
+
if (typeof value !== 'boolean')
|
|
113
|
+
requireFinite3D(value, 'parameter ' + parameter);
|
|
114
|
+
this.#parameters.set(parameter, value);
|
|
115
|
+
return this;
|
|
116
|
+
}
|
|
117
|
+
get(parameter) {
|
|
118
|
+
return this.#parameters.get(parameter);
|
|
119
|
+
}
|
|
120
|
+
/** Raise a one-shot flag; the first transition that tests it consumes it. */
|
|
121
|
+
trigger(parameter) {
|
|
122
|
+
this.#triggers.add(parameter);
|
|
123
|
+
return this;
|
|
124
|
+
}
|
|
125
|
+
resetTrigger(parameter) {
|
|
126
|
+
this.#triggers.delete(parameter);
|
|
127
|
+
return this;
|
|
128
|
+
}
|
|
129
|
+
/** Switch to `state` now, cross-fading over `duration` seconds. */
|
|
130
|
+
play(state, duration = 0) {
|
|
131
|
+
const next = this.#states.get(state);
|
|
132
|
+
if (!next)
|
|
133
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'state: ' + state);
|
|
134
|
+
this.enter(next, Math.max(0, requireFinite3D(duration, 'duration')));
|
|
135
|
+
return this;
|
|
136
|
+
}
|
|
137
|
+
enter(next, duration) {
|
|
138
|
+
const previous = this.#current;
|
|
139
|
+
if (previous === next && !this.#fading)
|
|
140
|
+
return;
|
|
141
|
+
previous?.onExit?.();
|
|
142
|
+
// Every state fades from the weight it holds right now, so interrupting a fade is seamless.
|
|
143
|
+
for (const state of this.#states.values())
|
|
144
|
+
state.fadeFrom = state.weight;
|
|
145
|
+
if (next.weight === 0) {
|
|
146
|
+
next.normalizedTime = 0;
|
|
147
|
+
for (const action of next.actions)
|
|
148
|
+
action.reset().play();
|
|
149
|
+
}
|
|
150
|
+
this.#current = next;
|
|
151
|
+
this.#fadeDuration = duration;
|
|
152
|
+
this.#fadeElapsed = 0;
|
|
153
|
+
this.#fading = duration > 0;
|
|
154
|
+
if (!this.#fading)
|
|
155
|
+
for (const state of this.#states.values())
|
|
156
|
+
state.weight = state === next ? 1 : 0;
|
|
157
|
+
next.onEnter?.();
|
|
158
|
+
this.onStateChange?.(previous?.name, next.name);
|
|
159
|
+
}
|
|
160
|
+
holds(condition) {
|
|
161
|
+
if (this.#triggers.has(condition.parameter))
|
|
162
|
+
return condition.op === undefined;
|
|
163
|
+
const value = this.#parameters.get(condition.parameter);
|
|
164
|
+
if (condition.op === undefined)
|
|
165
|
+
return value === true;
|
|
166
|
+
if (value === undefined || condition.value === undefined)
|
|
167
|
+
return false;
|
|
168
|
+
switch (condition.op) {
|
|
169
|
+
case '>':
|
|
170
|
+
return value > condition.value;
|
|
171
|
+
case '>=':
|
|
172
|
+
return value >= condition.value;
|
|
173
|
+
case '<':
|
|
174
|
+
return value < condition.value;
|
|
175
|
+
case '<=':
|
|
176
|
+
return value <= condition.value;
|
|
177
|
+
case '==':
|
|
178
|
+
return value === condition.value;
|
|
179
|
+
default:
|
|
180
|
+
return value !== condition.value;
|
|
181
|
+
}
|
|
182
|
+
}
|
|
183
|
+
evaluate() {
|
|
184
|
+
const current = this.#current;
|
|
185
|
+
if (!current)
|
|
186
|
+
return false;
|
|
187
|
+
for (const transition of this.#transitions) {
|
|
188
|
+
if (transition.from !== '*' && transition.from !== current.name)
|
|
189
|
+
continue;
|
|
190
|
+
if (transition.to === current.name)
|
|
191
|
+
continue;
|
|
192
|
+
if (this.#fading && !transition.canInterrupt)
|
|
193
|
+
continue;
|
|
194
|
+
if (transition.exitTime !== undefined && current.normalizedTime < transition.exitTime)
|
|
195
|
+
continue;
|
|
196
|
+
if (!transition.conditions.every(condition => this.holds(condition)))
|
|
197
|
+
continue;
|
|
198
|
+
for (const condition of transition.conditions)
|
|
199
|
+
this.#triggers.delete(condition.parameter);
|
|
200
|
+
this.enter(this.#states.get(transition.to), transition.duration);
|
|
201
|
+
return true;
|
|
202
|
+
}
|
|
203
|
+
return false;
|
|
204
|
+
}
|
|
205
|
+
applyState(state, delta) {
|
|
206
|
+
const { actions, thresholds, blendWeights } = state, count = actions.length;
|
|
207
|
+
let duration = actions[0].clip.duration;
|
|
208
|
+
if (count > 1) {
|
|
209
|
+
const raw = state.blendParameter === undefined ? undefined : this.#parameters.get(state.blendParameter);
|
|
210
|
+
const value = Math.min(Math.max(typeof raw === 'number' ? raw : thresholds[0], thresholds[0]), thresholds[count - 1]);
|
|
211
|
+
let upper = 1;
|
|
212
|
+
while (upper < count - 1 && thresholds[upper] < value)
|
|
213
|
+
upper++;
|
|
214
|
+
const lower = upper - 1, span = thresholds[upper] - thresholds[lower], t = span > 0 ? (value - thresholds[lower]) / span : 0;
|
|
215
|
+
blendWeights.fill(0);
|
|
216
|
+
blendWeights[lower] = 1 - t;
|
|
217
|
+
blendWeights[upper] = t;
|
|
218
|
+
// Blend the cycle length too, and scale each clip to it so their phases stay locked.
|
|
219
|
+
duration = actions[lower].clip.duration * (1 - t) + actions[upper].clip.duration * t;
|
|
220
|
+
}
|
|
221
|
+
else
|
|
222
|
+
blendWeights[0] = 1;
|
|
223
|
+
for (let i = 0; i < count; i++) {
|
|
224
|
+
const action = actions[i];
|
|
225
|
+
action.weight = state.weight * blendWeights[i];
|
|
226
|
+
action.timeScale = duration > 0 ? (state.speed * action.clip.duration) / duration : state.speed;
|
|
227
|
+
if (state.weight > 0 && !action.isRunning)
|
|
228
|
+
action.play();
|
|
229
|
+
}
|
|
230
|
+
if (state.weight <= 0)
|
|
231
|
+
return;
|
|
232
|
+
const before = state.normalizedTime, step = duration > 0 ? (delta * state.speed) / duration : 0;
|
|
233
|
+
let after = before + step;
|
|
234
|
+
if (!state.loop)
|
|
235
|
+
after = Math.min(after, 1);
|
|
236
|
+
state.normalizedTime = after;
|
|
237
|
+
if (state.events.length > 0 && after > before) {
|
|
238
|
+
for (const event of state.events) {
|
|
239
|
+
// Count how many times the event time was crossed, wrapping per pass.
|
|
240
|
+
const crossings = Math.floor(after - event.time) - Math.floor(before - event.time);
|
|
241
|
+
if (crossings > 0 || (before === 0 && event.time === 0 && step > 0))
|
|
242
|
+
event.callback();
|
|
243
|
+
}
|
|
244
|
+
}
|
|
245
|
+
}
|
|
246
|
+
/** Evaluate transitions, advance fades and drive the mixer by `deltaSeconds`. */
|
|
247
|
+
update(deltaSeconds) {
|
|
248
|
+
const delta = requireFinite3D(deltaSeconds, 'deltaSeconds') * this.mixer.timeScale;
|
|
249
|
+
// Chained transitions with zero-length states are bounded so a cycle cannot hang the frame.
|
|
250
|
+
for (let i = 0; i < STATE_MACHINE3D_LIMITS.maxTransitionsPerUpdate && this.evaluate(); i++)
|
|
251
|
+
;
|
|
252
|
+
if (this.#fading) {
|
|
253
|
+
this.#fadeElapsed += Math.abs(delta);
|
|
254
|
+
const k = Math.min(this.#fadeElapsed / this.#fadeDuration, 1);
|
|
255
|
+
for (const state of this.#states.values())
|
|
256
|
+
state.weight = state.fadeFrom * (1 - k) + (state === this.#current ? k : 0);
|
|
257
|
+
if (k >= 1)
|
|
258
|
+
this.#fading = false;
|
|
259
|
+
}
|
|
260
|
+
for (const state of this.#states.values()) {
|
|
261
|
+
if (state.weight <= 0 && state !== this.#current) {
|
|
262
|
+
for (const action of state.actions)
|
|
263
|
+
if (action.isRunning)
|
|
264
|
+
action.stop();
|
|
265
|
+
continue;
|
|
266
|
+
}
|
|
267
|
+
this.applyState(state, delta);
|
|
268
|
+
}
|
|
269
|
+
this.mixer.update(deltaSeconds);
|
|
270
|
+
// Triggers last one update when nothing consumed them.
|
|
271
|
+
this.#triggers.clear();
|
|
272
|
+
}
|
|
273
|
+
}
|
|
274
|
+
export function createAnimationStateMachine3D(mixer) {
|
|
275
|
+
return new AnimationStateMachine3D(mixer);
|
|
276
|
+
}
|
|
277
|
+
//# sourceMappingURL=StateMachine3D.js.map
|
|
@@ -0,0 +1,227 @@
|
|
|
1
|
+
import { type Material3D, type StandardMaterialOptions3D } from './Material3D.js';
|
|
2
|
+
import { type DecalOptions3D } from './Decal3D.js';
|
|
3
|
+
import type { Texture3D } from './Texture3D.js';
|
|
4
|
+
import { Mesh3D } from './Mesh3D.js';
|
|
5
|
+
import { Object3D } from './Object3D.js';
|
|
6
|
+
import { TriangleMeshShape3D } from './PhysicsMesh3D.js';
|
|
7
|
+
import type { Camera3D } from './Camera3D.js';
|
|
8
|
+
export declare const TERRAIN3D_LIMITS: Readonly<{
|
|
9
|
+
readonly maxSamplesPerSide: 4097;
|
|
10
|
+
readonly maxChunkCells: 254;
|
|
11
|
+
readonly maxLevels: 8;
|
|
12
|
+
readonly maxChunks: 4096;
|
|
13
|
+
readonly maxCachedGeometryBytes: number;
|
|
14
|
+
readonly maxStreamTiles: 256;
|
|
15
|
+
readonly maxStreamPending: 32;
|
|
16
|
+
}>;
|
|
17
|
+
export interface HeightFieldOptions3D {
|
|
18
|
+
/** Samples along X and along Z; a field of n samples has n - 1 cells. */
|
|
19
|
+
readonly columns: number;
|
|
20
|
+
readonly rows: number;
|
|
21
|
+
/** World size along X and Z. The field is centered on its origin. */
|
|
22
|
+
readonly width: number;
|
|
23
|
+
readonly depth: number;
|
|
24
|
+
/** Row-major heights, `rows * columns` values starting at the -X, -Z corner. */
|
|
25
|
+
readonly heights?: ArrayLike<number>;
|
|
26
|
+
/** Called for each sample with its local x and z when `heights` is absent. */
|
|
27
|
+
readonly sample?: (x: number, z: number) => number;
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* Heights on a regular grid in the XZ plane. Every cell is split into two
|
|
31
|
+
* triangles along the same diagonal, and `heightAt` follows those triangles
|
|
32
|
+
* exactly, so an object placed with it sits on the full-detail mesh and on the
|
|
33
|
+
* collision shape alike.
|
|
34
|
+
*/
|
|
35
|
+
export declare class HeightField3D {
|
|
36
|
+
#private;
|
|
37
|
+
readonly columns: number;
|
|
38
|
+
readonly rows: number;
|
|
39
|
+
readonly width: number;
|
|
40
|
+
readonly depth: number;
|
|
41
|
+
readonly heights: Float32Array;
|
|
42
|
+
/** Increases on refresh(); terrains rebuild their meshes when it changes. */
|
|
43
|
+
version: number;
|
|
44
|
+
constructor(options: HeightFieldOptions3D);
|
|
45
|
+
get minHeight(): number;
|
|
46
|
+
get maxHeight(): number;
|
|
47
|
+
get cellWidth(): number;
|
|
48
|
+
get cellDepth(): number;
|
|
49
|
+
/** Local x of a sample column and local z of a sample row. */
|
|
50
|
+
columnX(column: number): number;
|
|
51
|
+
rowZ(row: number): number;
|
|
52
|
+
/** Height stored at a sample; indices are clamped to the grid. */
|
|
53
|
+
sampleAt(column: number, row: number): number;
|
|
54
|
+
/** Call after writing to `heights`: recomputes the range and bumps the version. */
|
|
55
|
+
refresh(): void;
|
|
56
|
+
/** True when the local point lies over the grid. */
|
|
57
|
+
contains(x: number, z: number): boolean;
|
|
58
|
+
/** Surface height under a local point; points outside the grid use the nearest edge. */
|
|
59
|
+
heightAt(x: number, z: number): number;
|
|
60
|
+
/** Smoothed unit surface normal at a local point, from the neighbouring samples. */
|
|
61
|
+
normalAt(x: number, z: number, out?: number[] | Float32Array): number[] | Float32Array;
|
|
62
|
+
/**
|
|
63
|
+
* Distance along a unit local ray to where it first drops below the
|
|
64
|
+
* surface, or -1 within `limit`. The ray is walked in half-cell steps and
|
|
65
|
+
* the crossing refined, so features thinner than a cell can be skipped.
|
|
66
|
+
*/
|
|
67
|
+
raycast(origin: ArrayLike<number>, direction: ArrayLike<number>, limit?: number): number;
|
|
68
|
+
/**
|
|
69
|
+
* Collision shape for a static physics body placed at the terrain's
|
|
70
|
+
* origin: the full-detail triangles, indexed by a bounding-volume
|
|
71
|
+
* hierarchy so bodies only test the ground near them.
|
|
72
|
+
*/
|
|
73
|
+
createShape(): {
|
|
74
|
+
readonly type: 'mesh';
|
|
75
|
+
readonly mesh: TriangleMeshShape3D;
|
|
76
|
+
};
|
|
77
|
+
}
|
|
78
|
+
export declare function createHeightField3D(options: HeightFieldOptions3D): HeightField3D;
|
|
79
|
+
export interface HeightImageOptions3D {
|
|
80
|
+
readonly width: number;
|
|
81
|
+
readonly depth: number;
|
|
82
|
+
/** Heights the darkest and the brightest pixel map to. Defaults: 0 and 1. */
|
|
83
|
+
readonly minHeight?: number;
|
|
84
|
+
readonly maxHeight?: number;
|
|
85
|
+
/** `red` reads 8 bits from the red channel; `rg16` reads 16 bits with red as the high byte. */
|
|
86
|
+
readonly encoding?: 'red' | 'rg16';
|
|
87
|
+
}
|
|
88
|
+
/** Height field with one sample per pixel of a decoded RGBA image; the image's top row is the -Z edge. */
|
|
89
|
+
export declare function createHeightFieldFromPixels3D(pixels: {
|
|
90
|
+
readonly width: number;
|
|
91
|
+
readonly height: number;
|
|
92
|
+
readonly data: ArrayLike<number>;
|
|
93
|
+
}, options: HeightImageOptions3D): HeightField3D;
|
|
94
|
+
export interface TerrainOptions3D {
|
|
95
|
+
/** Cells along each side of a chunk. Default 32. */
|
|
96
|
+
readonly chunkCells?: number;
|
|
97
|
+
/** Number of detail levels; each halves the one before. Default 4. */
|
|
98
|
+
readonly levels?: number;
|
|
99
|
+
/** Distance from the camera to a chunk at which the first coarser level takes over; each further level doubles it. Default: two chunk widths. */
|
|
100
|
+
readonly lodDistance?: number;
|
|
101
|
+
/** How far the border strips that hide gaps between levels hang down. Default: 2% of the larger side. */
|
|
102
|
+
readonly skirtDepth?: number;
|
|
103
|
+
/** Texture repeats across the whole terrain. Default 1. */
|
|
104
|
+
readonly uvScale?: number;
|
|
105
|
+
/**
|
|
106
|
+
* Writes a linear RGB vertex color for a sample; enable `vertexColors` on
|
|
107
|
+
* the material to see it. `slope` is 0 on flat ground and 1 on a vertical face.
|
|
108
|
+
*/
|
|
109
|
+
readonly colorAt?: (height: number, slope: number, x: number, z: number, out: number[]) => void;
|
|
110
|
+
}
|
|
111
|
+
/**
|
|
112
|
+
* A height field drawn as a grid of chunk meshes. Before each frame every
|
|
113
|
+
* chunk picks a detail level from its distance to the camera; neighbouring
|
|
114
|
+
* chunks at different levels are sealed by skirts hanging from their borders.
|
|
115
|
+
* Normals always come from the full-detail field, so lighting does not shift
|
|
116
|
+
* when a chunk changes level.
|
|
117
|
+
*/
|
|
118
|
+
export declare class Terrain3D extends Object3D {
|
|
119
|
+
#private;
|
|
120
|
+
readonly field: HeightField3D;
|
|
121
|
+
readonly chunkCells: number;
|
|
122
|
+
readonly levels: number;
|
|
123
|
+
lodDistance: number;
|
|
124
|
+
/** Added to every chunk's level: raise it to lower the detail of the whole terrain. */
|
|
125
|
+
lodBias: number;
|
|
126
|
+
constructor(field: HeightField3D, material: Material3D, options?: TerrainOptions3D);
|
|
127
|
+
get material(): Material3D;
|
|
128
|
+
set material(value: Material3D);
|
|
129
|
+
get chunkCount(): number;
|
|
130
|
+
/** Detail level each chunk is currently drawn at, in row-major chunk order. */
|
|
131
|
+
get chunkLevels(): number[];
|
|
132
|
+
/** Triangles in the levels the chunks currently use. */
|
|
133
|
+
get triangleCount(): number;
|
|
134
|
+
/** Set shadow casting and receiving on every chunk. */
|
|
135
|
+
setShadows(cast: boolean, receive: boolean): this;
|
|
136
|
+
/**
|
|
137
|
+
* Choose every chunk's level for a camera now. Rendering does this by
|
|
138
|
+
* itself; call it when you read `chunkLevels` or `triangleCount` first.
|
|
139
|
+
*/
|
|
140
|
+
update(camera: Camera3D): void;
|
|
141
|
+
/** Rebuild the meshes after the field's heights changed and `field.refresh()` ran. Rendering checks this by itself. */
|
|
142
|
+
rebuild(): void;
|
|
143
|
+
/**
|
|
144
|
+
* Lay a decal on the terrain. It is cut from the full-detail heights, not
|
|
145
|
+
* from whichever level a chunk happens to show, so it stays put when the
|
|
146
|
+
* levels change; far away, where chunks are coarse, it can sink slightly
|
|
147
|
+
* into them. Attached decal geometry is released with the terrain; a
|
|
148
|
+
* reparented decal belongs to the caller. Returns undefined when the box misses the ground.
|
|
149
|
+
*/
|
|
150
|
+
createDecal(material: Material3D, options: DecalOptions3D): Mesh3D | undefined;
|
|
151
|
+
/** Release chunk geometry and attached factory decals. Materials and the field stay with the caller. */
|
|
152
|
+
dispose(): void;
|
|
153
|
+
private checkGeometryBudget;
|
|
154
|
+
private select;
|
|
155
|
+
private use;
|
|
156
|
+
private build;
|
|
157
|
+
}
|
|
158
|
+
export declare function createTerrain3D(field: HeightField3D, material: Material3D, options?: TerrainOptions3D): Terrain3D;
|
|
159
|
+
export interface TerrainMaterialOptions3D extends StandardMaterialOptions3D {
|
|
160
|
+
/** One to four tiling ground textures. */
|
|
161
|
+
readonly layers: readonly Texture3D[];
|
|
162
|
+
/** Where each layer shows: its R, G, B and A channels weigh layers 0 to 3 across the whole terrain. */
|
|
163
|
+
readonly weights: Texture3D;
|
|
164
|
+
/** How often each layer repeats across the terrain. Default 32 each. */
|
|
165
|
+
readonly repeat?: number | readonly number[];
|
|
166
|
+
}
|
|
167
|
+
/**
|
|
168
|
+
* A standard material whose color is a blend of ground textures, such as
|
|
169
|
+
* sand, grass, rock and snow, painted by a weight map. Use it on a terrain
|
|
170
|
+
* with `uvScale` 1 so the weight map covers the terrain once.
|
|
171
|
+
*/
|
|
172
|
+
export declare function createTerrainMaterial3D(options: TerrainMaterialOptions3D): Material3D;
|
|
173
|
+
export interface TerrainTile3D {
|
|
174
|
+
readonly x: number;
|
|
175
|
+
readonly z: number;
|
|
176
|
+
readonly field: HeightField3D;
|
|
177
|
+
readonly terrain: Terrain3D;
|
|
178
|
+
}
|
|
179
|
+
export interface TerrainStreamOptions3D {
|
|
180
|
+
/** World size of one square tile. Tile (x, z) covers x * size to (x + 1) * size on each axis. */
|
|
181
|
+
readonly tileSize: number;
|
|
182
|
+
/** Tiles whose nearest point is within this distance of the viewer are kept loaded. */
|
|
183
|
+
readonly viewDistance: number;
|
|
184
|
+
/**
|
|
185
|
+
* Supplies the heights of a tile, now or later, as a field `tileSize`
|
|
186
|
+
* wide and deep; undefined leaves the tile empty. Neighbouring tiles
|
|
187
|
+
* should share the samples along their common edge.
|
|
188
|
+
*/
|
|
189
|
+
readonly load: (x: number, z: number) => HeightField3D | undefined | Promise<HeightField3D | undefined>;
|
|
190
|
+
readonly material: Material3D | ((x: number, z: number, field: HeightField3D) => Material3D);
|
|
191
|
+
readonly terrain?: TerrainOptions3D;
|
|
192
|
+
/** Tiles requested per update, nearest first. Default 2. */
|
|
193
|
+
readonly loadsPerUpdate?: number;
|
|
194
|
+
/** Called when a tile has been added to or removed from the scene, as for creating and removing its collision body. */
|
|
195
|
+
readonly onLoad?: (tile: TerrainTile3D) => void;
|
|
196
|
+
readonly onUnload?: (tile: TerrainTile3D) => void;
|
|
197
|
+
}
|
|
198
|
+
type TerrainStreamFailure3D = Readonly<{
|
|
199
|
+
x: number;
|
|
200
|
+
z: number;
|
|
201
|
+
phase: 'load' | 'prepare' | 'onLoad' | 'dispose' | 'onUnload';
|
|
202
|
+
cause: unknown;
|
|
203
|
+
}>;
|
|
204
|
+
export declare class TerrainStream3D extends Object3D {
|
|
205
|
+
#private;
|
|
206
|
+
readonly tileSize: number;
|
|
207
|
+
viewDistance: number;
|
|
208
|
+
constructor(options: TerrainStreamOptions3D);
|
|
209
|
+
get tiles(): readonly TerrainTile3D[];
|
|
210
|
+
/** Outstanding loader calls, including retired requests that have yet to settle. */
|
|
211
|
+
get pendingCount(): number;
|
|
212
|
+
/** Most recent failure in a loader, tile preparation, or lifecycle callback. */
|
|
213
|
+
get lastFailure(): TerrainStreamFailure3D | undefined;
|
|
214
|
+
tileAt(x: number, z: number): TerrainTile3D | undefined;
|
|
215
|
+
/** Ground height at a world point of this node's space, or undefined where no tile is loaded. */
|
|
216
|
+
heightAt(x: number, z: number): number | undefined;
|
|
217
|
+
/** Request the tiles near a position and release those that fell out of range. */
|
|
218
|
+
update(x: number, z: number): void;
|
|
219
|
+
/** Retire the stream and release all tile geometry. Outstanding loads cannot publish. */
|
|
220
|
+
dispose(): void;
|
|
221
|
+
private request;
|
|
222
|
+
private release;
|
|
223
|
+
private recordFailure;
|
|
224
|
+
}
|
|
225
|
+
export declare function createTerrainStream3D(options: TerrainStreamOptions3D): TerrainStream3D;
|
|
226
|
+
export {};
|
|
227
|
+
//# sourceMappingURL=Terrain3D.d.ts.map
|