@egret/engine 0.0.0-stage → 7.0.2
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 +469 -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 +48 -0
- package/dist/animation/sequenceResetTypes.js +2 -0
- package/dist/animation/types.d.ts +75 -0
- package/dist/animation/types.js +2 -0
- package/dist/assetBundle.d.ts +54 -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 +17 -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 +47 -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 +246 -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 +31 -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 +112 -0
- package/dist/bitmapFontTypes.js +2 -0
- package/dist/bitmapResourceSlot.d.ts +26 -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 +419 -0
- package/dist/cameraTypes.d.ts +126 -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 +35 -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 +45 -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 +39 -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 +37 -0
- package/dist/gameClockTypes.js +2 -0
- package/dist/gameRun.d.ts +53 -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 +142 -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 +129 -0
- package/dist/hoverInputTypes.js +2 -0
- package/dist/index.d.ts +52 -0
- package/dist/index.js +21 -0
- package/dist/input.d.ts +6 -0
- package/dist/input.js +5 -0
- package/dist/inputActions.d.ts +86 -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 +68 -0
- package/dist/internal/uiFactoryState.js +173 -0
- package/dist/internal/uiRootState.d.ts +67 -0
- package/dist/internal/uiRootState.js +103 -0
- package/dist/keyboardInput.d.ts +13 -0
- package/dist/keyboardInput.js +579 -0
- package/dist/keyboardInputTypes.d.ts +93 -0
- package/dist/keyboardInputTypes.js +2 -0
- package/dist/kit.d.ts +16 -0
- package/dist/kit.js +10 -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 +17 -0
- package/dist/manifestResourceState.js +58 -0
- package/dist/manifestResourceTypes.d.ts +26 -0
- package/dist/manifestResourceTypes.js +2 -0
- package/dist/motion.d.ts +35 -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 +41 -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 +300 -0
- package/dist/particleTypes.d.ts +115 -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 +221 -0
- package/dist/physics2dTypes.js +2 -0
- package/dist/physics2dWorld.d.ts +4 -0
- package/dist/physics2dWorld.js +823 -0
- package/dist/pointerInput.d.ts +12 -0
- package/dist/pointerInput.js +300 -0
- package/dist/pointerInputTypes.d.ts +41 -0
- package/dist/pointerInputTypes.js +2 -0
- package/dist/random.d.ts +30 -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 +379 -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 +90 -0
- package/dist/rendering/prepareSharedDraws2D.js +663 -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 +52 -0
- package/dist/rendering/sharedColor2D.js +191 -0
- package/dist/rendering/sharedEffects2D.d.ts +23 -0
- package/dist/rendering/sharedEffects2D.js +126 -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 +104 -0
- package/dist/rendering/world3d/Animation3D.js +384 -0
- package/dist/rendering/world3d/AnimationTexture3D.d.ts +163 -0
- package/dist/rendering/world3d/AnimationTexture3D.js +603 -0
- package/dist/rendering/world3d/Batch3D.d.ts +75 -0
- package/dist/rendering/world3d/Batch3D.js +332 -0
- package/dist/rendering/world3d/Camera3D.d.ts +62 -0
- package/dist/rendering/world3d/Camera3D.js +132 -0
- package/dist/rendering/world3d/Character3D.d.ts +127 -0
- package/dist/rendering/world3d/Character3D.js +305 -0
- package/dist/rendering/world3d/Cloth3D.d.ts +130 -0
- package/dist/rendering/world3d/Cloth3D.js +503 -0
- package/dist/rendering/world3d/Compression3D.d.ts +22 -0
- package/dist/rendering/world3d/Compression3D.js +703 -0
- package/dist/rendering/world3d/Curves3D.d.ts +119 -0
- package/dist/rendering/world3d/Curves3D.js +460 -0
- package/dist/rendering/world3d/Decal3D.d.ts +43 -0
- package/dist/rendering/world3d/Decal3D.js +242 -0
- package/dist/rendering/world3d/Export3D.d.ts +13 -0
- package/dist/rendering/world3d/Export3D.js +263 -0
- package/dist/rendering/world3d/Geometry3D.d.ts +95 -0
- package/dist/rendering/world3d/Geometry3D.js +335 -0
- package/dist/rendering/world3d/GeometryBuilder3D.d.ts +53 -0
- package/dist/rendering/world3d/GeometryBuilder3D.js +196 -0
- package/dist/rendering/world3d/Gizmo3D.d.ts +80 -0
- package/dist/rendering/world3d/Gizmo3D.js +514 -0
- package/dist/rendering/world3d/Gltf3D.d.ts +73 -0
- package/dist/rendering/world3d/Gltf3D.js +996 -0
- package/dist/rendering/world3d/GpuParticles3D.d.ts +109 -0
- package/dist/rendering/world3d/GpuParticles3D.js +401 -0
- package/dist/rendering/world3d/Hdr3D.d.ts +35 -0
- package/dist/rendering/world3d/Hdr3D.js +191 -0
- package/dist/rendering/world3d/Jelly3D.d.ts +77 -0
- package/dist/rendering/world3d/Jelly3D.js +267 -0
- package/dist/rendering/world3d/Ktx23D.d.ts +30 -0
- package/dist/rendering/world3d/Ktx23D.js +112 -0
- package/dist/rendering/world3d/Light3D.d.ts +84 -0
- package/dist/rendering/world3d/Light3D.js +97 -0
- package/dist/rendering/world3d/Material3D.d.ts +253 -0
- package/dist/rendering/world3d/Material3D.js +269 -0
- package/dist/rendering/world3d/Mesh3D.d.ts +112 -0
- package/dist/rendering/world3d/Mesh3D.js +337 -0
- package/dist/rendering/world3d/Meshopt3D.d.ts +15 -0
- package/dist/rendering/world3d/Meshopt3D.js +276 -0
- package/dist/rendering/world3d/Navigation3D.d.ts +213 -0
- package/dist/rendering/world3d/Navigation3D.js +1043 -0
- package/dist/rendering/world3d/Object3D.d.ts +118 -0
- package/dist/rendering/world3d/Object3D.js +315 -0
- package/dist/rendering/world3d/Particles3D.d.ts +90 -0
- package/dist/rendering/world3d/Particles3D.js +277 -0
- package/dist/rendering/world3d/Physics3D.d.ts +430 -0
- package/dist/rendering/world3d/Physics3D.js +2840 -0
- package/dist/rendering/world3d/PhysicsHull3D.d.ts +37 -0
- package/dist/rendering/world3d/PhysicsHull3D.js +229 -0
- package/dist/rendering/world3d/PhysicsMesh3D.d.ts +41 -0
- package/dist/rendering/world3d/PhysicsMesh3D.js +340 -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 +179 -0
- package/dist/rendering/world3d/PhysicsRemote3D.js +536 -0
- package/dist/rendering/world3d/Ragdoll3D.d.ts +74 -0
- package/dist/rendering/world3d/Ragdoll3D.js +202 -0
- package/dist/rendering/world3d/Raycast3D.d.ts +40 -0
- package/dist/rendering/world3d/Raycast3D.js +247 -0
- package/dist/rendering/world3d/RenderList3D.d.ts +91 -0
- package/dist/rendering/world3d/RenderList3D.js +502 -0
- package/dist/rendering/world3d/Retarget3D.d.ts +21 -0
- package/dist/rendering/world3d/Retarget3D.js +185 -0
- package/dist/rendering/world3d/Rig3D.d.ts +57 -0
- package/dist/rendering/world3d/Rig3D.js +219 -0
- package/dist/rendering/world3d/Sdf3D.d.ts +181 -0
- package/dist/rendering/world3d/Sdf3D.js +1136 -0
- package/dist/rendering/world3d/SdfLod3D.d.ts +17 -0
- package/dist/rendering/world3d/SdfLod3D.js +56 -0
- package/dist/rendering/world3d/Serialize3D.d.ts +66 -0
- package/dist/rendering/world3d/Serialize3D.js +629 -0
- package/dist/rendering/world3d/Simplify3D.d.ts +29 -0
- package/dist/rendering/world3d/Simplify3D.js +426 -0
- package/dist/rendering/world3d/StateMachine3D.d.ts +87 -0
- package/dist/rendering/world3d/StateMachine3D.js +280 -0
- package/dist/rendering/world3d/SurfaceMaterial3D.d.ts +26 -0
- package/dist/rendering/world3d/SurfaceMaterial3D.js +138 -0
- package/dist/rendering/world3d/Terrain3D.d.ts +248 -0
- package/dist/rendering/world3d/Terrain3D.js +827 -0
- package/dist/rendering/world3d/Text3D.d.ts +95 -0
- package/dist/rendering/world3d/Text3D.js +560 -0
- package/dist/rendering/world3d/Texture3D.d.ts +148 -0
- package/dist/rendering/world3d/Texture3D.js +270 -0
- package/dist/rendering/world3d/Trail3D.d.ts +62 -0
- package/dist/rendering/world3d/Trail3D.js +195 -0
- package/dist/rendering/world3d/Vehicle3D.d.ts +102 -0
- package/dist/rendering/world3d/Vehicle3D.js +228 -0
- package/dist/rendering/world3d/VolumetricFog3D.d.ts +57 -0
- package/dist/rendering/world3d/VolumetricFog3D.js +230 -0
- package/dist/rendering/world3d/Water3D.d.ts +165 -0
- package/dist/rendering/world3d/Water3D.js +607 -0
- package/dist/rendering/world3d/core3D.d.ts +36 -0
- package/dist/rendering/world3d/core3D.js +99 -0
- package/dist/rendering/world3d/debug3D.d.ts +69 -0
- package/dist/rendering/world3d/debug3D.js +262 -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 +111 -0
- package/dist/rendering/world3d/geometries3D.js +610 -0
- package/dist/rendering/world3d/helpers3D.d.ts +67 -0
- package/dist/rendering/world3d/helpers3D.js +178 -0
- package/dist/rendering/world3d/index.d.ts +103 -0
- package/dist/rendering/world3d/index.js +62 -0
- package/dist/rendering/world3d/math3D.d.ts +114 -0
- package/dist/rendering/world3d/math3D.js +675 -0
- package/dist/rendering/world3d/primitives3D.d.ts +67 -0
- package/dist/rendering/world3d/primitives3D.js +197 -0
- package/dist/resources.d.ts +8 -0
- package/dist/resources.js +6 -0
- package/dist/saveStore.d.ts +71 -0
- package/dist/saveStore.js +182 -0
- package/dist/semanticList.d.ts +126 -0
- package/dist/semanticList.js +175 -0
- package/dist/semanticTree.d.ts +10 -0
- package/dist/semanticTree.js +539 -0
- package/dist/semanticTypes.d.ts +175 -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 +24 -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 +24 -0
- package/dist/text.js +4 -0
- package/dist/textField.d.ts +6 -0
- package/dist/textField.js +6 -0
- package/dist/textTable.d.ts +41 -0
- package/dist/textTable.js +114 -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 +182 -0
- package/dist/tilemapTypes.js +2 -0
- package/dist/timer.d.ts +34 -0
- package/dist/timer.js +119 -0
- package/dist/tween.d.ts +15 -0
- package/dist/tween.js +329 -0
- package/dist/tweenTypes.d.ts +31 -0
- package/dist/tweenTypes.js +2 -0
- package/dist/ui/controlKeys.d.ts +113 -0
- package/dist/ui/controlKeys.js +250 -0
- package/dist/ui/controls.d.ts +58 -0
- package/dist/ui/controls.js +290 -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 +98 -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 +53 -0
- package/dist/ui/rangeControl.js +168 -0
- package/dist/ui/scrollControl.d.ts +84 -0
- package/dist/ui/scrollControl.js +222 -0
- package/dist/ui/stateControls.d.ts +90 -0
- package/dist/ui/stateControls.js +331 -0
- package/dist/ui/textEditor.d.ts +54 -0
- package/dist/ui/textEditor.js +371 -0
- package/dist/ui/textEditorTypes.d.ts +85 -0
- package/dist/ui/textEditorTypes.js +2 -0
- package/dist/ui/textFieldControl.d.ts +100 -0
- package/dist/ui/textFieldControl.js +260 -0
- package/dist/ui/theme.d.ts +64 -0
- package/dist/ui/theme.js +166 -0
- package/dist/ui/types.d.ts +285 -0
- package/dist/ui/types.js +2 -0
- package/dist/ui/uiRoot.d.ts +4 -0
- package/dist/ui/uiRoot.js +1526 -0
- package/dist/ui/uiRootDisplay.d.ts +46 -0
- package/dist/ui/uiRootDisplay.js +148 -0
- package/dist/ui/uiRootModel.d.ts +114 -0
- package/dist/ui/uiRootModel.js +66 -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 +77 -0
- package/dist/videoTypes.js +2 -0
- package/dist/web/BrowserAssetBundle.d.ts +41 -0
- package/dist/web/BrowserAssetBundle.js +136 -0
- package/dist/web/BrowserAudio.d.ts +74 -0
- package/dist/web/BrowserAudio.js +503 -0
- package/dist/web/BrowserFrameLoop.d.ts +69 -0
- package/dist/web/BrowserFrameLoop.js +125 -0
- package/dist/web/BrowserGame.d.ts +174 -0
- package/dist/web/BrowserGame.js +473 -0
- package/dist/web/BrowserGamepadInput.d.ts +38 -0
- package/dist/web/BrowserGamepadInput.js +134 -0
- package/dist/web/BrowserHoverInput.d.ts +25 -0
- package/dist/web/BrowserHoverInput.js +266 -0
- package/dist/web/BrowserImageTextures.d.ts +72 -0
- package/dist/web/BrowserImageTextures.js +169 -0
- package/dist/web/BrowserInputActions.d.ts +63 -0
- package/dist/web/BrowserInputActions.js +345 -0
- package/dist/web/BrowserKeyboardInput.d.ts +4 -0
- package/dist/web/BrowserKeyboardInput.js +223 -0
- package/dist/web/BrowserPlay.d.ts +417 -0
- package/dist/web/BrowserPlay.js +1648 -0
- package/dist/web/BrowserPointerInput.d.ts +4 -0
- package/dist/web/BrowserPointerInput.js +511 -0
- package/dist/web/BrowserPreferences.d.ts +10 -0
- package/dist/web/BrowserPreferences.js +39 -0
- package/dist/web/BrowserSemantics.d.ts +36 -0
- package/dist/web/BrowserSemantics.js +418 -0
- package/dist/web/BrowserStatsPanel.d.ts +56 -0
- package/dist/web/BrowserStatsPanel.js +143 -0
- package/dist/web/BrowserStorage.d.ts +35 -0
- package/dist/web/BrowserStorage.js +132 -0
- package/dist/web/BrowserTextEditor.d.ts +52 -0
- package/dist/web/BrowserTextEditor.js +839 -0
- package/dist/web/BrowserTextInput.d.ts +89 -0
- package/dist/web/BrowserTextInput.js +524 -0
- package/dist/web/BrowserTextureProvider.d.ts +58 -0
- package/dist/web/BrowserTextureProvider.js +935 -0
- package/dist/web/BrowserVideo.d.ts +40 -0
- package/dist/web/BrowserVideo.js +237 -0
- package/dist/web/CanvasKitFontSetProvider.d.ts +32 -0
- package/dist/web/CanvasKitFontSetProvider.js +215 -0
- package/dist/web/CanvasKitParagraphProvider.d.ts +173 -0
- package/dist/web/CanvasKitParagraphProvider.js +692 -0
- package/dist/web/CanvasTextRasterProvider.d.ts +4 -0
- package/dist/web/CanvasTextRasterProvider.js +312 -0
- package/dist/web/ManifestByteSource.d.ts +151 -0
- package/dist/web/ManifestByteSource.js +975 -0
- package/dist/web/ManifestFontContentLoader.d.ts +13 -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 +2711 -0
- package/dist/web/WebGPUHost.d.ts +100 -0
- package/dist/web/WebGPUHost.js +3430 -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 +54 -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 +16 -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 +11 -0
- package/dist/web/kit.js +8 -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 +10 -0
- package/dist/web/play.js +9 -0
- package/dist/web/playMusic.d.ts +33 -0
- package/dist/web/playMusic.js +194 -0
- package/dist/web/playSfx.d.ts +36 -0
- package/dist/web/playSfx.js +112 -0
- package/dist/web/playTouch.d.ts +45 -0
- package/dist/web/playTouch.js +141 -0
- package/dist/web/playWidgets.d.ts +71 -0
- package/dist/web/playWidgets.js +431 -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 +63 -0
- package/dist/web/resources.d.ts +29 -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 +13 -0
- package/dist/web/sharedEffectShaders.js +181 -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 +33 -0
- package/dist/web/sharedWebGL2Options.js +102 -0
- package/dist/web/sharedWebGL2Shaders.d.ts +33 -0
- package/dist/web/sharedWebGL2Shaders.js +408 -0
- package/dist/web/sharedWebGPUOptions.d.ts +41 -0
- package/dist/web/sharedWebGPUOptions.js +130 -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 +72 -0
- package/dist/web/webgl2Native.js +572 -0
- package/dist/web/webgl2Types.d.ts +150 -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 +56 -0
- package/dist/web/webgpuImageResidency.js +65 -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 +85 -0
- package/dist/web/webgpuSharedPass.d.ts +7 -0
- package/dist/web/webgpuSharedPass.js +293 -0
- package/dist/web/webgpuSharedResolvePass.d.ts +3 -0
- package/dist/web/webgpuSharedResolvePass.js +34 -0
- package/dist/web/world3d/Audio3D.d.ts +85 -0
- package/dist/web/world3d/Audio3D.js +271 -0
- package/dist/web/world3d/BrowserPlay3D.d.ts +295 -0
- package/dist/web/world3d/BrowserPlay3D.js +1256 -0
- package/dist/web/world3d/FlyControls3D.d.ts +59 -0
- package/dist/web/world3d/FlyControls3D.js +162 -0
- package/dist/web/world3d/FollowControls3D.d.ts +31 -0
- package/dist/web/world3d/FollowControls3D.js +119 -0
- package/dist/web/world3d/OrbitControls3D.d.ts +58 -0
- package/dist/web/world3d/OrbitControls3D.js +189 -0
- package/dist/web/world3d/TransformControls3D.d.ts +37 -0
- package/dist/web/world3d/TransformControls3D.js +128 -0
- package/dist/web/world3d/WebGL2Renderer3D.d.ts +136 -0
- package/dist/web/world3d/WebGL2Renderer3D.js +1175 -0
- package/dist/web/world3d/WebGPURenderer3D.d.ts +112 -0
- package/dist/web/world3d/WebGPURenderer3D.js +1916 -0
- package/dist/web/world3d/World3DView.d.ts +54 -0
- package/dist/web/world3d/World3DView.js +79 -0
- package/dist/web/world3d/app3D.d.ts +143 -0
- package/dist/web/world3d/app3D.js +305 -0
- package/dist/web/world3d/assets3D.d.ts +39 -0
- package/dist/web/world3d/assets3D.js +112 -0
- package/dist/web/world3d/atmosphere3D.d.ts +56 -0
- package/dist/web/world3d/atmosphere3D.js +193 -0
- package/dist/web/world3d/canvasFont3D.d.ts +21 -0
- package/dist/web/world3d/canvasFont3D.js +165 -0
- package/dist/web/world3d/frame3D.d.ts +144 -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 +24 -0
- package/dist/web/world3d/host3D.js +61 -0
- package/dist/web/world3d/index.d.ts +40 -0
- package/dist/web/world3d/index.js +24 -0
- package/dist/web/world3d/loaders3D.d.ts +27 -0
- package/dist/web/world3d/loaders3D.js +138 -0
- package/dist/web/world3d/markers3D.d.ts +53 -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 +47 -0
- package/dist/web/world3d/overlay3D.js +187 -0
- package/dist/web/world3d/post3D.d.ts +116 -0
- package/dist/web/world3d/post3D.js +462 -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 +15 -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 +34 -0
- package/dist/web/world3d/stats3D.js +81 -0
- package/dist/web/world3d/webGL2FrameMetrics3D.d.ts +71 -0
- package/dist/web/world3d/webGL2FrameMetrics3D.js +185 -0
- package/dist/web/world3d/webgpu.d.ts +37 -0
- package/dist/web/world3d/webgpu.js +23 -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,31 @@
|
|
|
1
|
+
import type { PreparedStageCost2D } from './prepareRectangles2D.js';
|
|
2
|
+
import type { PreparationBudget2D } from './prepareRectangles2D.js';
|
|
3
|
+
export interface TexturedPreparationLimits2D {
|
|
4
|
+
readonly maxSourceTriangles: number;
|
|
5
|
+
readonly maxPreparedVertices: number;
|
|
6
|
+
readonly maxClipEdgeTests: number;
|
|
7
|
+
readonly maxTupleComparisons: number;
|
|
8
|
+
}
|
|
9
|
+
export interface TexturedPreparationSnapshot2D {
|
|
10
|
+
readonly sourceTrianglesCharged: number;
|
|
11
|
+
readonly preparedVerticesCharged: number;
|
|
12
|
+
readonly predicatesCharged: number;
|
|
13
|
+
readonly tupleComparisonsCharged: number;
|
|
14
|
+
}
|
|
15
|
+
/** One private frame ledger is shared by preparation and represented packing. */
|
|
16
|
+
export declare class TexturedPreparationBudget2D implements PreparationBudget2D {
|
|
17
|
+
#private;
|
|
18
|
+
constructor(limits: TexturedPreparationLimits2D);
|
|
19
|
+
admitSourceTriangles(count: number): void;
|
|
20
|
+
admitPreparedVertices(count: number): void;
|
|
21
|
+
admitPredicate(): void;
|
|
22
|
+
admitTupleComparison(): void;
|
|
23
|
+
/** The three charges a stage replays, as they stand; a stage's cost is their difference across it. */
|
|
24
|
+
get preparedVerticesCharged(): number;
|
|
25
|
+
get predicatesCharged(): number;
|
|
26
|
+
get tupleComparisonsCharged(): number;
|
|
27
|
+
/** A rejected replay changes no dimension; the original stage then decides its first error. */
|
|
28
|
+
tryReplayStageCost(cost: PreparedStageCost2D): boolean;
|
|
29
|
+
snapshot(): Readonly<TexturedPreparationSnapshot2D>;
|
|
30
|
+
}
|
|
31
|
+
//# sourceMappingURL=texturedPreparationBudget2D.d.ts.map
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
import { noteOwnedPreparationFailure } from './ownedPreparationFailure2D.js';
|
|
2
|
+
import { GeometryPreparationError } from './prepareRectangles2D.js';
|
|
3
|
+
function fail(reason) {
|
|
4
|
+
throw noteOwnedPreparationFailure(new GeometryPreparationError(reason));
|
|
5
|
+
}
|
|
6
|
+
function limit(value, maximum) {
|
|
7
|
+
if (!Number.isSafeInteger(value) || value < 1 || value > maximum)
|
|
8
|
+
fail('budget');
|
|
9
|
+
return value;
|
|
10
|
+
}
|
|
11
|
+
/** Whole admission is atomic; accepted earlier work is never refunded. */
|
|
12
|
+
function admit(count, charged, maximum) {
|
|
13
|
+
if (!Number.isSafeInteger(count) || count < 0 || count > maximum - charged)
|
|
14
|
+
fail('budget');
|
|
15
|
+
return charged + count;
|
|
16
|
+
}
|
|
17
|
+
/** One private frame ledger is shared by preparation and represented packing. */
|
|
18
|
+
export class TexturedPreparationBudget2D {
|
|
19
|
+
#limits;
|
|
20
|
+
#sourceTrianglesCharged = 0;
|
|
21
|
+
#preparedVerticesCharged = 0;
|
|
22
|
+
#predicatesCharged = 0;
|
|
23
|
+
#tupleComparisonsCharged = 0;
|
|
24
|
+
constructor(limits) {
|
|
25
|
+
this.#limits = Object.freeze({
|
|
26
|
+
maxSourceTriangles: limit(limits.maxSourceTriangles, 65_536),
|
|
27
|
+
maxPreparedVertices: limit(limits.maxPreparedVertices, 1_048_576),
|
|
28
|
+
maxClipEdgeTests: limit(limits.maxClipEdgeTests, 4_194_304),
|
|
29
|
+
maxTupleComparisons: limit(limits.maxTupleComparisons, 1_048_576)
|
|
30
|
+
});
|
|
31
|
+
}
|
|
32
|
+
admitSourceTriangles(count) {
|
|
33
|
+
this.#sourceTrianglesCharged = admit(count, this.#sourceTrianglesCharged, this.#limits.maxSourceTriangles);
|
|
34
|
+
}
|
|
35
|
+
admitPreparedVertices(count) {
|
|
36
|
+
this.#preparedVerticesCharged = admit(count, this.#preparedVerticesCharged, this.#limits.maxPreparedVertices);
|
|
37
|
+
}
|
|
38
|
+
admitPredicate() {
|
|
39
|
+
this.#predicatesCharged = admit(1, this.#predicatesCharged, this.#limits.maxClipEdgeTests);
|
|
40
|
+
}
|
|
41
|
+
admitTupleComparison() {
|
|
42
|
+
this.#tupleComparisonsCharged = admit(1, this.#tupleComparisonsCharged, this.#limits.maxTupleComparisons);
|
|
43
|
+
}
|
|
44
|
+
/** The three charges a stage replays, as they stand; a stage's cost is their difference across it. */
|
|
45
|
+
get preparedVerticesCharged() {
|
|
46
|
+
return this.#preparedVerticesCharged;
|
|
47
|
+
}
|
|
48
|
+
get predicatesCharged() {
|
|
49
|
+
return this.#predicatesCharged;
|
|
50
|
+
}
|
|
51
|
+
get tupleComparisonsCharged() {
|
|
52
|
+
return this.#tupleComparisonsCharged;
|
|
53
|
+
}
|
|
54
|
+
/** A rejected replay changes no dimension; the original stage then decides its first error. */
|
|
55
|
+
tryReplayStageCost(cost) {
|
|
56
|
+
const vertices = cost.preparedVertices, predicates = cost.predicates, tuples = cost.tupleComparisons;
|
|
57
|
+
if (!Number.isSafeInteger(vertices) ||
|
|
58
|
+
vertices < 0 ||
|
|
59
|
+
vertices > this.#limits.maxPreparedVertices - this.#preparedVerticesCharged ||
|
|
60
|
+
!Number.isSafeInteger(predicates) ||
|
|
61
|
+
predicates < 0 ||
|
|
62
|
+
predicates > this.#limits.maxClipEdgeTests - this.#predicatesCharged ||
|
|
63
|
+
!Number.isSafeInteger(tuples) ||
|
|
64
|
+
tuples < 0 ||
|
|
65
|
+
tuples > this.#limits.maxTupleComparisons - this.#tupleComparisonsCharged)
|
|
66
|
+
return false;
|
|
67
|
+
this.#preparedVerticesCharged += vertices;
|
|
68
|
+
this.#predicatesCharged += predicates;
|
|
69
|
+
this.#tupleComparisonsCharged += tuples;
|
|
70
|
+
return true;
|
|
71
|
+
}
|
|
72
|
+
snapshot() {
|
|
73
|
+
return Object.freeze({
|
|
74
|
+
sourceTrianglesCharged: this.#sourceTrianglesCharged,
|
|
75
|
+
preparedVerticesCharged: this.#preparedVerticesCharged,
|
|
76
|
+
predicatesCharged: this.#predicatesCharged,
|
|
77
|
+
tupleComparisonsCharged: this.#tupleComparisonsCharged
|
|
78
|
+
});
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
//# sourceMappingURL=texturedPreparationBudget2D.js.map
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
import type { Object3D } from './Object3D.js';
|
|
2
|
+
/** What an animation track moves: a node's position, rotation, scale, or morph weights. */
|
|
3
|
+
export type AnimationPath3D = 'position' | 'quaternion' | 'scale' | 'weights';
|
|
4
|
+
/** How a track goes between its keys: it steps, moves in a line, or follows a cubic spline. */
|
|
5
|
+
export type AnimationInterpolation3D = 'step' | 'linear' | 'cubic';
|
|
6
|
+
/** How an action plays its clip: over and over, once, or back and forth. */
|
|
7
|
+
export type AnimationLoop3D = 'repeat' | 'once' | 'pingpong';
|
|
8
|
+
/** The most tracks, keys and actions animations hold. */
|
|
9
|
+
export declare const ANIMATION3D_LIMITS: Readonly<{
|
|
10
|
+
readonly maxTracks: 4096;
|
|
11
|
+
readonly maxKeys: 1048576;
|
|
12
|
+
readonly maxActions: 256;
|
|
13
|
+
}>;
|
|
14
|
+
/** A track to make: the node it moves by name, what it moves, its key times and values, and its interpolation. */
|
|
15
|
+
export interface AnimationTrackInput3D {
|
|
16
|
+
/** Name of the animated node, resolved under the mixer root. */
|
|
17
|
+
readonly targetName: string;
|
|
18
|
+
readonly path: AnimationPath3D;
|
|
19
|
+
/** Strictly increasing key times in seconds. */
|
|
20
|
+
readonly times: ArrayLike<number>;
|
|
21
|
+
/**
|
|
22
|
+
* Key values, `size` numbers per key. Cubic tracks store in-tangent,
|
|
23
|
+
* value and out-tangent for every key (3 * size numbers), as in glTF.
|
|
24
|
+
*/
|
|
25
|
+
readonly values: ArrayLike<number>;
|
|
26
|
+
readonly interpolation?: AnimationInterpolation3D;
|
|
27
|
+
}
|
|
28
|
+
/** One track of a clip: the node it moves, what it moves, its keys and its interpolation. */
|
|
29
|
+
export interface AnimationTrack3D {
|
|
30
|
+
readonly targetName: string;
|
|
31
|
+
readonly path: AnimationPath3D;
|
|
32
|
+
readonly times: Float32Array;
|
|
33
|
+
readonly values: Float32Array;
|
|
34
|
+
readonly interpolation: AnimationInterpolation3D;
|
|
35
|
+
/** Components per key: 3, 4, or the morph target count. */
|
|
36
|
+
readonly size: number;
|
|
37
|
+
}
|
|
38
|
+
/** A named animation: its tracks and its length in seconds. */
|
|
39
|
+
export declare class AnimationClip3D {
|
|
40
|
+
readonly name: string;
|
|
41
|
+
readonly tracks: readonly AnimationTrack3D[];
|
|
42
|
+
readonly duration: number;
|
|
43
|
+
constructor(name: string, tracks: readonly AnimationTrackInput3D[], duration?: number);
|
|
44
|
+
}
|
|
45
|
+
/** Makes a clip from its name and tracks; malformed tracks are refused. */
|
|
46
|
+
export declare function createAnimationClip3D(input: {
|
|
47
|
+
readonly name?: string;
|
|
48
|
+
readonly tracks: readonly AnimationTrackInput3D[];
|
|
49
|
+
readonly duration?: number;
|
|
50
|
+
}): AnimationClip3D;
|
|
51
|
+
/** Evaluate one track at `time` into `out`; `hint` caches the last key index. */
|
|
52
|
+
export declare function sampleAnimationTrack3D(track: AnimationTrack3D, time: number, out: Float32Array, hint: {
|
|
53
|
+
index: number;
|
|
54
|
+
}): void;
|
|
55
|
+
/** One clip playing on a mixer: play, stop and reset it, fade it in or out, or cross-fade to another. */
|
|
56
|
+
export declare class AnimationAction3D {
|
|
57
|
+
#private;
|
|
58
|
+
readonly clip: AnimationClip3D;
|
|
59
|
+
/** Blend weight before fading is applied. */
|
|
60
|
+
weight: number;
|
|
61
|
+
timeScale: number;
|
|
62
|
+
loop: AnimationLoop3D;
|
|
63
|
+
/** Hold the last frame after a 'once' action ends instead of releasing the pose. */
|
|
64
|
+
clampWhenFinished: boolean;
|
|
65
|
+
paused: boolean;
|
|
66
|
+
/** Invoked once when a non-repeating action reaches its end. */
|
|
67
|
+
onFinished: ((action: AnimationAction3D) => void) | undefined;
|
|
68
|
+
/** @internal Created by AnimationMixer3D.clipAction(). */
|
|
69
|
+
constructor(clip: AnimationClip3D, bound: readonly unknown[]);
|
|
70
|
+
get time(): number;
|
|
71
|
+
set time(value: number);
|
|
72
|
+
get isRunning(): boolean;
|
|
73
|
+
/** Weight actually applied this frame, including any fade in progress. */
|
|
74
|
+
get effectiveWeight(): number;
|
|
75
|
+
play(): this;
|
|
76
|
+
/** Stop contributing and rewind. */
|
|
77
|
+
stop(): this;
|
|
78
|
+
reset(): this;
|
|
79
|
+
fadeIn(seconds: number): this;
|
|
80
|
+
fadeOut(seconds: number): this;
|
|
81
|
+
/** Fade this action out while fading `next` in over the same interval. */
|
|
82
|
+
crossFadeTo(next: AnimationAction3D, seconds: number): this;
|
|
83
|
+
private currentFade;
|
|
84
|
+
private fade;
|
|
85
|
+
/** @internal Advance time and add this action's samples to the property mixes. */
|
|
86
|
+
advance(delta: number, scratch: Float32Array): void;
|
|
87
|
+
}
|
|
88
|
+
/** Plays clips on the subtree under `root`, blending concurrent actions by weight. */
|
|
89
|
+
export declare class AnimationMixer3D {
|
|
90
|
+
#private;
|
|
91
|
+
readonly root: Object3D;
|
|
92
|
+
timeScale: number;
|
|
93
|
+
constructor(root: Object3D);
|
|
94
|
+
/** Create (or return the existing) action for a clip. Tracks whose target is missing are skipped. */
|
|
95
|
+
clipAction(clip: AnimationClip3D): AnimationAction3D;
|
|
96
|
+
/** Advance every running action by `deltaSeconds` and write the blended pose. */
|
|
97
|
+
update(deltaSeconds: number): void;
|
|
98
|
+
stopAll(): void;
|
|
99
|
+
/** Stop every action and restore the pose captured when each property was first bound. */
|
|
100
|
+
restorePose(): void;
|
|
101
|
+
/** Forget an action so its clip can be collected. */
|
|
102
|
+
uncache(clip: AnimationClip3D): void;
|
|
103
|
+
}
|
|
104
|
+
//# sourceMappingURL=Animation3D.d.ts.map
|
|
@@ -0,0 +1,384 @@
|
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
// Keyframe animation: tracks, clips and a mixer that blends any number of
|
|
3
|
+
// weighted actions onto a node hierarchy. Time is explicit; the mixer never
|
|
4
|
+
// reads a clock, so callers drive it from the Engine game clock.
|
|
5
|
+
import { World3DError, requireCount3D, requireFinite3D } from './core3D.js';
|
|
6
|
+
import { quatNormalize, quatSlerp } from './math3D.js';
|
|
7
|
+
import { Mesh3D } from './Mesh3D.js';
|
|
8
|
+
/** The most tracks, keys and actions animations hold. */
|
|
9
|
+
export const ANIMATION3D_LIMITS = Object.freeze({ maxTracks: 4096, maxKeys: 1048576, maxActions: 256 });
|
|
10
|
+
/** A named animation: its tracks and its length in seconds. */
|
|
11
|
+
export class AnimationClip3D {
|
|
12
|
+
name;
|
|
13
|
+
tracks;
|
|
14
|
+
duration;
|
|
15
|
+
constructor(name, tracks, duration) {
|
|
16
|
+
if (typeof name !== 'string')
|
|
17
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'clip name');
|
|
18
|
+
requireCount3D(tracks.length, 'tracks', ANIMATION3D_LIMITS.maxTracks);
|
|
19
|
+
let end = 0;
|
|
20
|
+
this.tracks = Object.freeze(tracks.map(input => {
|
|
21
|
+
const times = Float32Array.from(input.times), values = Float32Array.from(input.values);
|
|
22
|
+
const interpolation = input.interpolation ?? 'linear';
|
|
23
|
+
requireCount3D(times.length, 'keys', ANIMATION3D_LIMITS.maxKeys);
|
|
24
|
+
if (times.length === 0 || typeof input.targetName !== 'string')
|
|
25
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'track');
|
|
26
|
+
for (let i = 0; i < times.length; i++) {
|
|
27
|
+
if (!Number.isFinite(times[i]) || times[i] < 0 || (i > 0 && times[i] <= times[i - 1]))
|
|
28
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'track times');
|
|
29
|
+
}
|
|
30
|
+
const perKey = values.length / times.length / (interpolation === 'cubic' ? 3 : 1);
|
|
31
|
+
const fixed = input.path === 'quaternion' ? 4 : input.path === 'weights' ? perKey : 3;
|
|
32
|
+
if (!Number.isSafeInteger(perKey) || perKey < 1 || perKey !== fixed)
|
|
33
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'track values');
|
|
34
|
+
end = Math.max(end, times[times.length - 1]);
|
|
35
|
+
return Object.freeze({
|
|
36
|
+
targetName: input.targetName,
|
|
37
|
+
path: input.path,
|
|
38
|
+
times,
|
|
39
|
+
values,
|
|
40
|
+
interpolation,
|
|
41
|
+
size: perKey
|
|
42
|
+
});
|
|
43
|
+
}));
|
|
44
|
+
this.name = name;
|
|
45
|
+
this.duration = duration === undefined ? end : requireFinite3D(duration, 'clip duration');
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
/** Makes a clip from its name and tracks; malformed tracks are refused. */
|
|
49
|
+
export function createAnimationClip3D(input) {
|
|
50
|
+
return new AnimationClip3D(input.name ?? '', input.tracks, input.duration);
|
|
51
|
+
}
|
|
52
|
+
/** Evaluate one track at `time` into `out`; `hint` caches the last key index. */
|
|
53
|
+
export function sampleAnimationTrack3D(track, time, out, hint) {
|
|
54
|
+
const times = track.times, values = track.values, size = track.size, last = times.length - 1;
|
|
55
|
+
const cubic = track.interpolation === 'cubic', stride = cubic ? size * 3 : size, valueOffset = cubic ? size : 0;
|
|
56
|
+
if (time <= times[0] || last === 0) {
|
|
57
|
+
for (let i = 0; i < size; i++)
|
|
58
|
+
out[i] = values[valueOffset + i];
|
|
59
|
+
return;
|
|
60
|
+
}
|
|
61
|
+
if (time >= times[last]) {
|
|
62
|
+
for (let i = 0; i < size; i++)
|
|
63
|
+
out[i] = values[last * stride + valueOffset + i];
|
|
64
|
+
return;
|
|
65
|
+
}
|
|
66
|
+
// Playback usually advances monotonically: try the cached interval, then
|
|
67
|
+
// its successor, before falling back to binary search.
|
|
68
|
+
let index = hint.index;
|
|
69
|
+
if (!(index >= 0 && index < last && times[index] <= time && time < times[index + 1])) {
|
|
70
|
+
if (index + 1 < last && times[index + 1] <= time && time < times[index + 2])
|
|
71
|
+
index++;
|
|
72
|
+
else {
|
|
73
|
+
let low = 0, high = last;
|
|
74
|
+
while (high - low > 1) {
|
|
75
|
+
const middle = (low + high) >> 1;
|
|
76
|
+
if (times[middle] <= time)
|
|
77
|
+
low = middle;
|
|
78
|
+
else
|
|
79
|
+
high = middle;
|
|
80
|
+
}
|
|
81
|
+
index = low;
|
|
82
|
+
}
|
|
83
|
+
hint.index = index;
|
|
84
|
+
}
|
|
85
|
+
const t0 = times[index], span = times[index + 1] - t0, t = (time - t0) / span;
|
|
86
|
+
const a = index * stride + valueOffset, b = a + stride;
|
|
87
|
+
if (track.interpolation === 'step') {
|
|
88
|
+
for (let i = 0; i < size; i++)
|
|
89
|
+
out[i] = values[a + i];
|
|
90
|
+
}
|
|
91
|
+
else if (cubic) {
|
|
92
|
+
// Hermite spline with glTF tangents scaled by the key interval.
|
|
93
|
+
const t2 = t * t, t3 = t2 * t, h00 = 2 * t3 - 3 * t2 + 1, h10 = (t3 - 2 * t2 + t) * span, h01 = -2 * t3 + 3 * t2, h11 = (t3 - t2) * span;
|
|
94
|
+
for (let i = 0; i < size; i++) {
|
|
95
|
+
out[i] = h00 * values[a + i] + h10 * values[a + size + i] + h01 * values[b + i] + h11 * values[b - size + i];
|
|
96
|
+
}
|
|
97
|
+
if (track.path === 'quaternion')
|
|
98
|
+
quatNormalize(out, out);
|
|
99
|
+
}
|
|
100
|
+
else if (track.path === 'quaternion') {
|
|
101
|
+
quatSlerp(out, values.subarray(a, a + 4), values.subarray(b, b + 4), t);
|
|
102
|
+
}
|
|
103
|
+
else {
|
|
104
|
+
for (let i = 0; i < size; i++)
|
|
105
|
+
out[i] = values[a + i] + (values[b + i] - values[a + i]) * t;
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
/** Accumulates weighted samples for one animated property of one node. */
|
|
109
|
+
class PropertyMix {
|
|
110
|
+
target;
|
|
111
|
+
path;
|
|
112
|
+
size;
|
|
113
|
+
accumulated;
|
|
114
|
+
rest;
|
|
115
|
+
weight = 0;
|
|
116
|
+
constructor(target, path, size) {
|
|
117
|
+
this.target = target;
|
|
118
|
+
this.path = path;
|
|
119
|
+
this.size = size;
|
|
120
|
+
this.accumulated = new Float32Array(size);
|
|
121
|
+
this.rest = Float32Array.from(this.storage());
|
|
122
|
+
}
|
|
123
|
+
storage() {
|
|
124
|
+
const target = this.target;
|
|
125
|
+
if (this.path === 'position')
|
|
126
|
+
return target.position;
|
|
127
|
+
if (this.path === 'quaternion')
|
|
128
|
+
return target.quaternion;
|
|
129
|
+
if (this.path === 'scale')
|
|
130
|
+
return target.scale;
|
|
131
|
+
return target.morphWeights;
|
|
132
|
+
}
|
|
133
|
+
add(sample, weight) {
|
|
134
|
+
const accumulated = this.accumulated, size = this.size;
|
|
135
|
+
if (this.weight === 0) {
|
|
136
|
+
for (let i = 0; i < size; i++)
|
|
137
|
+
accumulated[i] = sample[i] * weight;
|
|
138
|
+
}
|
|
139
|
+
else if (this.path === 'quaternion') {
|
|
140
|
+
// Keep both rotations in the same hemisphere before the weighted sum.
|
|
141
|
+
const sign = accumulated[0] * sample[0] +
|
|
142
|
+
accumulated[1] * sample[1] +
|
|
143
|
+
accumulated[2] * sample[2] +
|
|
144
|
+
accumulated[3] * sample[3] <
|
|
145
|
+
0
|
|
146
|
+
? -weight
|
|
147
|
+
: weight;
|
|
148
|
+
for (let i = 0; i < 4; i++)
|
|
149
|
+
accumulated[i] += sample[i] * sign;
|
|
150
|
+
}
|
|
151
|
+
else {
|
|
152
|
+
for (let i = 0; i < size; i++)
|
|
153
|
+
accumulated[i] += sample[i] * weight;
|
|
154
|
+
}
|
|
155
|
+
this.weight += weight;
|
|
156
|
+
}
|
|
157
|
+
/** Write the blended value; missing weight is filled from the rest pose. */
|
|
158
|
+
apply() {
|
|
159
|
+
const weight = this.weight;
|
|
160
|
+
if (weight === 0)
|
|
161
|
+
return;
|
|
162
|
+
const accumulated = this.accumulated, storage = this.storage(), size = Math.min(this.size, storage.length);
|
|
163
|
+
if (weight < 1)
|
|
164
|
+
this.add(this.rest, 1 - weight);
|
|
165
|
+
const total = this.weight;
|
|
166
|
+
if (this.path === 'quaternion')
|
|
167
|
+
quatNormalize(storage, accumulated);
|
|
168
|
+
else
|
|
169
|
+
for (let i = 0; i < size; i++)
|
|
170
|
+
storage[i] = accumulated[i] / total;
|
|
171
|
+
if (this.path !== 'weights')
|
|
172
|
+
this.target.markTransformDirty();
|
|
173
|
+
this.weight = 0;
|
|
174
|
+
}
|
|
175
|
+
restore() {
|
|
176
|
+
this.storage().set(this.rest.subarray(0, this.storage().length));
|
|
177
|
+
if (this.path !== 'weights')
|
|
178
|
+
this.target.markTransformDirty();
|
|
179
|
+
}
|
|
180
|
+
}
|
|
181
|
+
/** One clip playing on a mixer: play, stop and reset it, fade it in or out, or cross-fade to another. */
|
|
182
|
+
export class AnimationAction3D {
|
|
183
|
+
clip;
|
|
184
|
+
/** Blend weight before fading is applied. */
|
|
185
|
+
weight = 1;
|
|
186
|
+
timeScale = 1;
|
|
187
|
+
loop = 'repeat';
|
|
188
|
+
/** Hold the last frame after a 'once' action ends instead of releasing the pose. */
|
|
189
|
+
clampWhenFinished = false;
|
|
190
|
+
paused = false;
|
|
191
|
+
/** Invoked once when a non-repeating action reaches its end. */
|
|
192
|
+
onFinished;
|
|
193
|
+
#time = 0;
|
|
194
|
+
#running = false;
|
|
195
|
+
#direction = 1;
|
|
196
|
+
#fadeFrom = 1;
|
|
197
|
+
#fadeTo = 1;
|
|
198
|
+
#fadeDuration = 0;
|
|
199
|
+
#fadeElapsed = 0;
|
|
200
|
+
#bound;
|
|
201
|
+
/** @internal Created by AnimationMixer3D.clipAction(). */
|
|
202
|
+
constructor(clip, bound) {
|
|
203
|
+
this.clip = clip;
|
|
204
|
+
this.#bound = bound;
|
|
205
|
+
}
|
|
206
|
+
get time() {
|
|
207
|
+
return this.#time;
|
|
208
|
+
}
|
|
209
|
+
set time(value) {
|
|
210
|
+
this.#time = Math.max(0, Math.min(this.clip.duration, requireFinite3D(value, 'time')));
|
|
211
|
+
}
|
|
212
|
+
get isRunning() {
|
|
213
|
+
return this.#running;
|
|
214
|
+
}
|
|
215
|
+
/** Weight actually applied this frame, including any fade in progress. */
|
|
216
|
+
get effectiveWeight() {
|
|
217
|
+
if (!this.#running)
|
|
218
|
+
return 0;
|
|
219
|
+
const fade = this.#fadeDuration > 0
|
|
220
|
+
? this.#fadeFrom + (this.#fadeTo - this.#fadeFrom) * Math.min(1, this.#fadeElapsed / this.#fadeDuration)
|
|
221
|
+
: this.#fadeTo;
|
|
222
|
+
return this.weight * fade;
|
|
223
|
+
}
|
|
224
|
+
play() {
|
|
225
|
+
this.#running = true;
|
|
226
|
+
return this;
|
|
227
|
+
}
|
|
228
|
+
/** Stop contributing and rewind. */
|
|
229
|
+
stop() {
|
|
230
|
+
this.#running = false;
|
|
231
|
+
return this.reset();
|
|
232
|
+
}
|
|
233
|
+
reset() {
|
|
234
|
+
this.#time = 0;
|
|
235
|
+
this.#direction = 1;
|
|
236
|
+
this.paused = false;
|
|
237
|
+
this.#fadeFrom = this.#fadeTo = 1;
|
|
238
|
+
this.#fadeDuration = this.#fadeElapsed = 0;
|
|
239
|
+
return this;
|
|
240
|
+
}
|
|
241
|
+
fadeIn(seconds) {
|
|
242
|
+
return this.fade(0, 1, seconds);
|
|
243
|
+
}
|
|
244
|
+
fadeOut(seconds) {
|
|
245
|
+
return this.fade(this.currentFade(), 0, seconds);
|
|
246
|
+
}
|
|
247
|
+
/** Fade this action out while fading `next` in over the same interval. */
|
|
248
|
+
crossFadeTo(next, seconds) {
|
|
249
|
+
this.fadeOut(seconds);
|
|
250
|
+
next.reset().play().fadeIn(seconds);
|
|
251
|
+
return this;
|
|
252
|
+
}
|
|
253
|
+
currentFade() {
|
|
254
|
+
return this.#fadeDuration > 0
|
|
255
|
+
? this.#fadeFrom + (this.#fadeTo - this.#fadeFrom) * Math.min(1, this.#fadeElapsed / this.#fadeDuration)
|
|
256
|
+
: this.#fadeTo;
|
|
257
|
+
}
|
|
258
|
+
fade(from, to, seconds) {
|
|
259
|
+
this.#fadeFrom = from;
|
|
260
|
+
this.#fadeTo = to;
|
|
261
|
+
this.#fadeDuration = Math.max(0, requireFinite3D(seconds, 'fade seconds'));
|
|
262
|
+
this.#fadeElapsed = 0;
|
|
263
|
+
if (this.#fadeDuration === 0)
|
|
264
|
+
this.#fadeFrom = to;
|
|
265
|
+
return this;
|
|
266
|
+
}
|
|
267
|
+
/** @internal Advance time and add this action's samples to the property mixes. */
|
|
268
|
+
advance(delta, scratch) {
|
|
269
|
+
if (!this.#running)
|
|
270
|
+
return;
|
|
271
|
+
const duration = this.clip.duration;
|
|
272
|
+
let finished = false;
|
|
273
|
+
if (!this.paused) {
|
|
274
|
+
if (this.#fadeDuration > 0) {
|
|
275
|
+
this.#fadeElapsed += Math.abs(delta);
|
|
276
|
+
// A completed fade-out retires the action.
|
|
277
|
+
if (this.#fadeElapsed >= this.#fadeDuration && this.#fadeTo === 0) {
|
|
278
|
+
this.#running = false;
|
|
279
|
+
return;
|
|
280
|
+
}
|
|
281
|
+
}
|
|
282
|
+
let time = this.#time + delta * this.timeScale * this.#direction;
|
|
283
|
+
if (duration <= 0)
|
|
284
|
+
time = 0;
|
|
285
|
+
else if (this.loop === 'repeat')
|
|
286
|
+
time = ((time % duration) + duration) % duration;
|
|
287
|
+
else if (this.loop === 'pingpong') {
|
|
288
|
+
while (time > duration || time < 0) {
|
|
289
|
+
time = time > duration ? 2 * duration - time : -time;
|
|
290
|
+
this.#direction = -this.#direction;
|
|
291
|
+
}
|
|
292
|
+
}
|
|
293
|
+
else if (time >= duration || time < 0) {
|
|
294
|
+
time = time < 0 ? 0 : duration;
|
|
295
|
+
finished = true;
|
|
296
|
+
}
|
|
297
|
+
this.#time = time;
|
|
298
|
+
}
|
|
299
|
+
const weight = this.effectiveWeight;
|
|
300
|
+
if (weight > 0) {
|
|
301
|
+
for (const bound of this.#bound) {
|
|
302
|
+
const sample = scratch.subarray(0, bound.track.size);
|
|
303
|
+
sampleAnimationTrack3D(bound.track, this.#time, sample, bound.hint);
|
|
304
|
+
bound.mix.add(sample, weight);
|
|
305
|
+
}
|
|
306
|
+
}
|
|
307
|
+
if (finished) {
|
|
308
|
+
if (this.clampWhenFinished)
|
|
309
|
+
this.paused = true;
|
|
310
|
+
else
|
|
311
|
+
this.#running = false;
|
|
312
|
+
this.onFinished?.(this);
|
|
313
|
+
}
|
|
314
|
+
}
|
|
315
|
+
}
|
|
316
|
+
/** Plays clips on the subtree under `root`, blending concurrent actions by weight. */
|
|
317
|
+
export class AnimationMixer3D {
|
|
318
|
+
root;
|
|
319
|
+
timeScale = 1;
|
|
320
|
+
#mixes = new Map();
|
|
321
|
+
#actions = new Map();
|
|
322
|
+
#scratch = new Float32Array(16);
|
|
323
|
+
constructor(root) {
|
|
324
|
+
this.root = root;
|
|
325
|
+
}
|
|
326
|
+
/** Create (or return the existing) action for a clip. Tracks whose target is missing are skipped. */
|
|
327
|
+
clipAction(clip) {
|
|
328
|
+
const existing = this.#actions.get(clip);
|
|
329
|
+
if (existing)
|
|
330
|
+
return existing;
|
|
331
|
+
requireCount3D(this.#actions.size + 1, 'actions', ANIMATION3D_LIMITS.maxActions);
|
|
332
|
+
const names = new Map();
|
|
333
|
+
this.root.traverse(object => {
|
|
334
|
+
if (object.name && !names.has(object.name))
|
|
335
|
+
names.set(object.name, object);
|
|
336
|
+
});
|
|
337
|
+
const bound = [];
|
|
338
|
+
for (const track of clip.tracks) {
|
|
339
|
+
const target = names.get(track.targetName);
|
|
340
|
+
if (!target)
|
|
341
|
+
continue;
|
|
342
|
+
if (track.path === 'weights') {
|
|
343
|
+
if (!(target instanceof Mesh3D))
|
|
344
|
+
continue;
|
|
345
|
+
target.syncMorphWeights();
|
|
346
|
+
if (target.morphWeights.length < track.size)
|
|
347
|
+
continue;
|
|
348
|
+
}
|
|
349
|
+
const key = target.id + ':' + track.path;
|
|
350
|
+
let mix = this.#mixes.get(key);
|
|
351
|
+
if (!mix)
|
|
352
|
+
this.#mixes.set(key, (mix = new PropertyMix(target, track.path, track.size)));
|
|
353
|
+
if (track.size > this.#scratch.length)
|
|
354
|
+
this.#scratch = new Float32Array(track.size);
|
|
355
|
+
bound.push({ track, mix, hint: { index: 0 } });
|
|
356
|
+
}
|
|
357
|
+
const action = new AnimationAction3D(clip, bound);
|
|
358
|
+
this.#actions.set(clip, action);
|
|
359
|
+
return action;
|
|
360
|
+
}
|
|
361
|
+
/** Advance every running action by `deltaSeconds` and write the blended pose. */
|
|
362
|
+
update(deltaSeconds) {
|
|
363
|
+
const delta = requireFinite3D(deltaSeconds, 'deltaSeconds') * this.timeScale;
|
|
364
|
+
for (const action of this.#actions.values())
|
|
365
|
+
action.advance(delta, this.#scratch);
|
|
366
|
+
for (const mix of this.#mixes.values())
|
|
367
|
+
mix.apply();
|
|
368
|
+
}
|
|
369
|
+
stopAll() {
|
|
370
|
+
for (const action of this.#actions.values())
|
|
371
|
+
action.stop();
|
|
372
|
+
}
|
|
373
|
+
/** Stop every action and restore the pose captured when each property was first bound. */
|
|
374
|
+
restorePose() {
|
|
375
|
+
this.stopAll();
|
|
376
|
+
for (const mix of this.#mixes.values())
|
|
377
|
+
mix.restore();
|
|
378
|
+
}
|
|
379
|
+
/** Forget an action so its clip can be collected. */
|
|
380
|
+
uncache(clip) {
|
|
381
|
+
this.#actions.delete(clip);
|
|
382
|
+
}
|
|
383
|
+
}
|
|
384
|
+
//# sourceMappingURL=Animation3D.js.map
|