@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,107 @@
|
|
|
1
|
+
export type Object3DKind = 'object' | 'scene' | 'mesh' | 'camera' | 'light' | 'bone';
|
|
2
|
+
export declare const WORLD3D_LIMITS: Readonly<{
|
|
3
|
+
readonly maxDepth: 256;
|
|
4
|
+
readonly maxChildren: 65536;
|
|
5
|
+
readonly maxNameLength: 256;
|
|
6
|
+
}>;
|
|
7
|
+
export declare class Object3D {
|
|
8
|
+
#private;
|
|
9
|
+
readonly id: number;
|
|
10
|
+
readonly kind: Object3DKind;
|
|
11
|
+
name: string;
|
|
12
|
+
/** Local translation, unit rotation quaternion and scale. Call markTransformDirty() after writing directly. */
|
|
13
|
+
readonly position: Float32Array<ArrayBuffer>;
|
|
14
|
+
readonly quaternion: Float32Array<ArrayBuffer>;
|
|
15
|
+
readonly scale: Float32Array<ArrayBuffer>;
|
|
16
|
+
/** Local and world matrices; valid after updateWorldMatrix(). */
|
|
17
|
+
readonly matrix: Float32Array;
|
|
18
|
+
readonly matrixWorld: Float32Array;
|
|
19
|
+
visible: boolean;
|
|
20
|
+
/** Bit mask matched against the camera mask; an object renders when the masks intersect. */
|
|
21
|
+
layers: number;
|
|
22
|
+
/** Higher values draw later within the opaque or transparent pass. */
|
|
23
|
+
renderOrder: number;
|
|
24
|
+
castShadow: boolean;
|
|
25
|
+
receiveShadow: boolean;
|
|
26
|
+
frustumCulled: boolean;
|
|
27
|
+
/** Free-form application data; never read by the engine. */
|
|
28
|
+
userData: Record<string, unknown>;
|
|
29
|
+
constructor(kind?: Object3DKind);
|
|
30
|
+
get parent(): Object3D | undefined;
|
|
31
|
+
get children(): readonly Object3D[];
|
|
32
|
+
get numChildren(): number;
|
|
33
|
+
/** Increases every time matrixWorld is recomputed; dependants compare it to skip work. */
|
|
34
|
+
get worldVersion(): number;
|
|
35
|
+
addChild<T extends Object3D>(child: T): T;
|
|
36
|
+
addChildAt<T extends Object3D>(child: T, index: number): T;
|
|
37
|
+
removeChild<T extends Object3D>(child: T): T;
|
|
38
|
+
removeFromParent(): this;
|
|
39
|
+
removeChildren(): void;
|
|
40
|
+
getChildAt(index: number): Object3D | undefined;
|
|
41
|
+
/** Depth-first search including this node. */
|
|
42
|
+
getObjectByName(name: string): Object3D | undefined;
|
|
43
|
+
/** Pre-order traversal. Returning false from the callback skips that subtree. */
|
|
44
|
+
traverse(callback: (object: Object3D) => boolean | void): void;
|
|
45
|
+
setPosition(x: number, y: number, z: number): this;
|
|
46
|
+
setScale(x: number, y?: number, z?: number): this;
|
|
47
|
+
setQuaternion(x: number, y: number, z: number, w: number): this;
|
|
48
|
+
/** Intrinsic XYZ Euler angles in radians. */
|
|
49
|
+
setRotation(x: number, y: number, z: number): this;
|
|
50
|
+
/** Post-multiply a rotation about a local axis. */
|
|
51
|
+
rotateOnAxis(axis: ArrayLike<number>, radians: number): this;
|
|
52
|
+
/** Orient the negative Z axis (cameras, lights) toward a world-space point. */
|
|
53
|
+
lookAt(x: number, y: number, z: number, up?: ArrayLike<number>): this;
|
|
54
|
+
/** Replace the local transform from an affine matrix. */
|
|
55
|
+
setMatrix(matrix: ArrayLike<number>): this;
|
|
56
|
+
/** Required after writing position, quaternion or scale arrays directly. */
|
|
57
|
+
markTransformDirty(): void;
|
|
58
|
+
/**
|
|
59
|
+
* Refresh matrixWorld for this node, resolving dirty ancestors first.
|
|
60
|
+
* Returns true when the world matrix changed.
|
|
61
|
+
*/
|
|
62
|
+
updateWorldMatrix(): boolean;
|
|
63
|
+
/** Refresh this subtree top-down. Call once per frame on the scene root. */
|
|
64
|
+
updateWorldMatrices(parentChanged?: boolean): void;
|
|
65
|
+
private refresh;
|
|
66
|
+
/** Subclass hook, invoked after matrixWorld was recomputed. */
|
|
67
|
+
protected onWorldMatrixChanged(): void;
|
|
68
|
+
/** World-space position; refreshes ancestors as needed. */
|
|
69
|
+
getWorldPosition(out?: Float32Array | number[]): Float32Array | number[];
|
|
70
|
+
localToWorld(out: Float32Array | number[], point: ArrayLike<number>): Float32Array | number[];
|
|
71
|
+
worldToLocal(out: Float32Array | number[], point: ArrayLike<number>): Float32Array | number[];
|
|
72
|
+
/**
|
|
73
|
+
* Copy this node and its subtree. Geometries, materials and skeleton data
|
|
74
|
+
* are shared by reference; subclasses override copyFrom for their state.
|
|
75
|
+
*/
|
|
76
|
+
clone(recursive?: boolean): this;
|
|
77
|
+
protected copyFrom(source: this): void;
|
|
78
|
+
}
|
|
79
|
+
export type Fog3D = {
|
|
80
|
+
readonly kind: 'linear';
|
|
81
|
+
readonly color: readonly [number, number, number];
|
|
82
|
+
readonly near: number;
|
|
83
|
+
readonly far: number;
|
|
84
|
+
} | {
|
|
85
|
+
readonly kind: 'exponential';
|
|
86
|
+
readonly color: readonly [number, number, number];
|
|
87
|
+
readonly density: number;
|
|
88
|
+
};
|
|
89
|
+
/** Root of a renderable graph; owns environment-wide settings. Colors are linear RGB. */
|
|
90
|
+
export declare class Scene3D extends Object3D {
|
|
91
|
+
/** Clear color, or a cube texture drawn as a skybox. `undefined` keeps the canvas transparent. */
|
|
92
|
+
background: readonly [number, number, number] | import('./Texture3D.js').CubeTexture3D | undefined;
|
|
93
|
+
backgroundIntensity: number;
|
|
94
|
+
/** Cube texture used for image-based lighting on standard materials. */
|
|
95
|
+
environment: import('./Texture3D.js').CubeTexture3D | undefined;
|
|
96
|
+
environmentIntensity: number;
|
|
97
|
+
fog: Fog3D | undefined;
|
|
98
|
+
/** Draw every mesh with this material instead of its own, as for masks and depth-only views. */
|
|
99
|
+
overrideMaterial: import('./Material3D.js').Material3D | undefined;
|
|
100
|
+
/**
|
|
101
|
+
* Up to four world-space planes as [nx, ny, nz, d]. Fragments on the
|
|
102
|
+
* negative side (n . p + d < 0) are not drawn. Shadows are not clipped.
|
|
103
|
+
*/
|
|
104
|
+
clippingPlanes: readonly (readonly [number, number, number, number])[];
|
|
105
|
+
constructor();
|
|
106
|
+
}
|
|
107
|
+
//# sourceMappingURL=Object3D.d.ts.map
|
|
@@ -0,0 +1,305 @@
|
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
// Scene-graph node. Transform storage is mutable typed arrays; local and world
|
|
3
|
+
// matrices are recomputed lazily from dirty flags so static subtrees cost
|
|
4
|
+
// nothing per frame.
|
|
5
|
+
import { World3DError, allocateId3D } from './core3D.js';
|
|
6
|
+
import { mat4Compose, mat4Copy, mat4Decompose, mat4Identity, mat4Invert, mat4LookAt, mat4Multiply, quatFromAxisAngle, quatFromEuler, quatFromRotationMatrix, quatMultiply, quatNormalize, vec3TransformMat4 } from './math3D.js';
|
|
7
|
+
export const WORLD3D_LIMITS = Object.freeze({
|
|
8
|
+
maxDepth: 256,
|
|
9
|
+
maxChildren: 65536,
|
|
10
|
+
maxNameLength: 256
|
|
11
|
+
});
|
|
12
|
+
const UP = new Float32Array([0, 1, 0]);
|
|
13
|
+
const scratchMatrix = new Float32Array(16);
|
|
14
|
+
const scratchVector = new Float32Array(3);
|
|
15
|
+
const scratchQuat = new Float32Array(4);
|
|
16
|
+
export class Object3D {
|
|
17
|
+
id = allocateId3D();
|
|
18
|
+
kind;
|
|
19
|
+
name = '';
|
|
20
|
+
/** Local translation, unit rotation quaternion and scale. Call markTransformDirty() after writing directly. */
|
|
21
|
+
position = new Float32Array(3);
|
|
22
|
+
quaternion = new Float32Array([0, 0, 0, 1]);
|
|
23
|
+
scale = new Float32Array([1, 1, 1]);
|
|
24
|
+
/** Local and world matrices; valid after updateWorldMatrix(). */
|
|
25
|
+
matrix = mat4Identity(new Float32Array(16));
|
|
26
|
+
matrixWorld = mat4Identity(new Float32Array(16));
|
|
27
|
+
visible = true;
|
|
28
|
+
/** Bit mask matched against the camera mask; an object renders when the masks intersect. */
|
|
29
|
+
layers = 1;
|
|
30
|
+
/** Higher values draw later within the opaque or transparent pass. */
|
|
31
|
+
renderOrder = 0;
|
|
32
|
+
castShadow = false;
|
|
33
|
+
receiveShadow = true;
|
|
34
|
+
frustumCulled = true;
|
|
35
|
+
/** Free-form application data; never read by the engine. */
|
|
36
|
+
userData = {};
|
|
37
|
+
#parent;
|
|
38
|
+
#children = [];
|
|
39
|
+
#localDirty = true;
|
|
40
|
+
#worldDirty = true;
|
|
41
|
+
#worldVersion = 0;
|
|
42
|
+
/** World version of the parent that matrixWorld was last computed from. */
|
|
43
|
+
#parentVersion = -1;
|
|
44
|
+
constructor(kind = 'object') {
|
|
45
|
+
this.kind = kind;
|
|
46
|
+
}
|
|
47
|
+
get parent() {
|
|
48
|
+
return this.#parent;
|
|
49
|
+
}
|
|
50
|
+
get children() {
|
|
51
|
+
return this.#children;
|
|
52
|
+
}
|
|
53
|
+
get numChildren() {
|
|
54
|
+
return this.#children.length;
|
|
55
|
+
}
|
|
56
|
+
/** Increases every time matrixWorld is recomputed; dependants compare it to skip work. */
|
|
57
|
+
get worldVersion() {
|
|
58
|
+
return this.#worldVersion;
|
|
59
|
+
}
|
|
60
|
+
// ---- hierarchy ---------------------------------------------------------
|
|
61
|
+
addChild(child) {
|
|
62
|
+
return this.addChildAt(child, this.#children.length);
|
|
63
|
+
}
|
|
64
|
+
addChildAt(child, index) {
|
|
65
|
+
if (!(child instanceof Object3D) || child === this)
|
|
66
|
+
throw new World3DError('WORLD3D_HIERARCHY_INVALID', 'child');
|
|
67
|
+
if (child.kind === 'scene')
|
|
68
|
+
throw new World3DError('WORLD3D_HIERARCHY_INVALID', 'a scene cannot be a child');
|
|
69
|
+
if (!Number.isSafeInteger(index) || index < 0 || index > this.#children.length)
|
|
70
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'index');
|
|
71
|
+
let depth = 0;
|
|
72
|
+
for (let node = this; node; node = node.#parent) {
|
|
73
|
+
if (node === child)
|
|
74
|
+
throw new World3DError('WORLD3D_HIERARCHY_INVALID', 'cycle');
|
|
75
|
+
if (++depth > WORLD3D_LIMITS.maxDepth)
|
|
76
|
+
throw new World3DError('WORLD3D_BUDGET', 'depth');
|
|
77
|
+
}
|
|
78
|
+
if (this.#children.length >= WORLD3D_LIMITS.maxChildren && child.#parent !== this)
|
|
79
|
+
throw new World3DError('WORLD3D_BUDGET', 'children');
|
|
80
|
+
if (child.#parent) {
|
|
81
|
+
const siblings = child.#parent.#children, at = siblings.indexOf(child);
|
|
82
|
+
siblings.splice(at, 1);
|
|
83
|
+
if (child.#parent === this && at < index)
|
|
84
|
+
index--;
|
|
85
|
+
}
|
|
86
|
+
child.#parent = this;
|
|
87
|
+
this.#children.splice(index, 0, child);
|
|
88
|
+
child.#worldDirty = true;
|
|
89
|
+
return child;
|
|
90
|
+
}
|
|
91
|
+
removeChild(child) {
|
|
92
|
+
const index = this.#children.indexOf(child);
|
|
93
|
+
if (index < 0)
|
|
94
|
+
throw new World3DError('WORLD3D_HIERARCHY_INVALID', 'not a child');
|
|
95
|
+
this.#children.splice(index, 1);
|
|
96
|
+
child.#parent = undefined;
|
|
97
|
+
child.#worldDirty = true;
|
|
98
|
+
return child;
|
|
99
|
+
}
|
|
100
|
+
removeFromParent() {
|
|
101
|
+
this.#parent?.removeChild(this);
|
|
102
|
+
return this;
|
|
103
|
+
}
|
|
104
|
+
removeChildren() {
|
|
105
|
+
for (const child of this.#children) {
|
|
106
|
+
child.#parent = undefined;
|
|
107
|
+
child.#worldDirty = true;
|
|
108
|
+
}
|
|
109
|
+
this.#children.length = 0;
|
|
110
|
+
}
|
|
111
|
+
getChildAt(index) {
|
|
112
|
+
return this.#children[index];
|
|
113
|
+
}
|
|
114
|
+
/** Depth-first search including this node. */
|
|
115
|
+
getObjectByName(name) {
|
|
116
|
+
if (this.name === name)
|
|
117
|
+
return this;
|
|
118
|
+
for (const child of this.#children) {
|
|
119
|
+
const found = child.getObjectByName(name);
|
|
120
|
+
if (found)
|
|
121
|
+
return found;
|
|
122
|
+
}
|
|
123
|
+
return undefined;
|
|
124
|
+
}
|
|
125
|
+
/** Pre-order traversal. Returning false from the callback skips that subtree. */
|
|
126
|
+
traverse(callback) {
|
|
127
|
+
if (callback(this) === false)
|
|
128
|
+
return;
|
|
129
|
+
for (const child of this.#children)
|
|
130
|
+
child.traverse(callback);
|
|
131
|
+
}
|
|
132
|
+
// ---- transform ---------------------------------------------------------
|
|
133
|
+
setPosition(x, y, z) {
|
|
134
|
+
this.position[0] = x;
|
|
135
|
+
this.position[1] = y;
|
|
136
|
+
this.position[2] = z;
|
|
137
|
+
this.#localDirty = true;
|
|
138
|
+
return this;
|
|
139
|
+
}
|
|
140
|
+
setScale(x, y = x, z = x) {
|
|
141
|
+
this.scale[0] = x;
|
|
142
|
+
this.scale[1] = y;
|
|
143
|
+
this.scale[2] = z;
|
|
144
|
+
this.#localDirty = true;
|
|
145
|
+
return this;
|
|
146
|
+
}
|
|
147
|
+
setQuaternion(x, y, z, w) {
|
|
148
|
+
this.quaternion[0] = x;
|
|
149
|
+
this.quaternion[1] = y;
|
|
150
|
+
this.quaternion[2] = z;
|
|
151
|
+
this.quaternion[3] = w;
|
|
152
|
+
quatNormalize(this.quaternion, this.quaternion);
|
|
153
|
+
this.#localDirty = true;
|
|
154
|
+
return this;
|
|
155
|
+
}
|
|
156
|
+
/** Intrinsic XYZ Euler angles in radians. */
|
|
157
|
+
setRotation(x, y, z) {
|
|
158
|
+
quatFromEuler(this.quaternion, x, y, z);
|
|
159
|
+
this.#localDirty = true;
|
|
160
|
+
return this;
|
|
161
|
+
}
|
|
162
|
+
/** Post-multiply a rotation about a local axis. */
|
|
163
|
+
rotateOnAxis(axis, radians) {
|
|
164
|
+
quatFromAxisAngle(scratchQuat, axis, radians);
|
|
165
|
+
quatMultiply(this.quaternion, this.quaternion, scratchQuat);
|
|
166
|
+
this.#localDirty = true;
|
|
167
|
+
return this;
|
|
168
|
+
}
|
|
169
|
+
/** Orient the negative Z axis (cameras, lights) toward a world-space point. */
|
|
170
|
+
lookAt(x, y, z, up = UP) {
|
|
171
|
+
this.updateWorldMatrix();
|
|
172
|
+
const world = this.matrixWorld;
|
|
173
|
+
scratchVector[0] = x;
|
|
174
|
+
scratchVector[1] = y;
|
|
175
|
+
scratchVector[2] = z;
|
|
176
|
+
mat4LookAt(scratchMatrix, [world[12], world[13], world[14]], scratchVector, up);
|
|
177
|
+
quatFromRotationMatrix(this.quaternion, scratchMatrix);
|
|
178
|
+
const parent = this.#parent;
|
|
179
|
+
if (parent) {
|
|
180
|
+
// Convert the world orientation into the parent's frame.
|
|
181
|
+
mat4Decompose(parent.matrixWorld, scratchVector, scratchQuat, new Float32Array(3));
|
|
182
|
+
scratchQuat[0] = -scratchQuat[0];
|
|
183
|
+
scratchQuat[1] = -scratchQuat[1];
|
|
184
|
+
scratchQuat[2] = -scratchQuat[2];
|
|
185
|
+
quatMultiply(this.quaternion, scratchQuat, this.quaternion);
|
|
186
|
+
}
|
|
187
|
+
this.#localDirty = true;
|
|
188
|
+
return this;
|
|
189
|
+
}
|
|
190
|
+
/** Replace the local transform from an affine matrix. */
|
|
191
|
+
setMatrix(matrix) {
|
|
192
|
+
mat4Decompose(matrix, this.position, this.quaternion, this.scale);
|
|
193
|
+
this.#localDirty = true;
|
|
194
|
+
return this;
|
|
195
|
+
}
|
|
196
|
+
/** Required after writing position, quaternion or scale arrays directly. */
|
|
197
|
+
markTransformDirty() {
|
|
198
|
+
this.#localDirty = true;
|
|
199
|
+
}
|
|
200
|
+
/**
|
|
201
|
+
* Refresh matrixWorld for this node, resolving dirty ancestors first.
|
|
202
|
+
* Returns true when the world matrix changed.
|
|
203
|
+
*/
|
|
204
|
+
updateWorldMatrix() {
|
|
205
|
+
const parent = this.#parent;
|
|
206
|
+
const parentChanged = parent ? parent.updateWorldMatrix() : false;
|
|
207
|
+
return this.refresh(parentChanged);
|
|
208
|
+
}
|
|
209
|
+
/** Refresh this subtree top-down. Call once per frame on the scene root. */
|
|
210
|
+
updateWorldMatrices(parentChanged = false) {
|
|
211
|
+
const changed = this.refresh(parentChanged);
|
|
212
|
+
const children = this.#children;
|
|
213
|
+
for (let i = 0; i < children.length; i++)
|
|
214
|
+
children[i].updateWorldMatrices(changed);
|
|
215
|
+
}
|
|
216
|
+
refresh(parentChanged) {
|
|
217
|
+
if (this.#localDirty) {
|
|
218
|
+
mat4Compose(this.matrix, this.position, this.quaternion, this.scale);
|
|
219
|
+
this.#localDirty = false;
|
|
220
|
+
this.#worldDirty = true;
|
|
221
|
+
}
|
|
222
|
+
// The parent may have been refreshed on its own earlier, so its change no longer arrives
|
|
223
|
+
// through `parentChanged`; comparing versions catches that.
|
|
224
|
+
const parent = this.#parent;
|
|
225
|
+
if (!this.#worldDirty && !parentChanged && (!parent || this.#parentVersion === parent.#worldVersion))
|
|
226
|
+
return false;
|
|
227
|
+
if (parent) {
|
|
228
|
+
mat4Multiply(this.matrixWorld, parent.matrixWorld, this.matrix);
|
|
229
|
+
this.#parentVersion = parent.#worldVersion;
|
|
230
|
+
}
|
|
231
|
+
else
|
|
232
|
+
mat4Copy(this.matrixWorld, this.matrix);
|
|
233
|
+
this.#worldDirty = false;
|
|
234
|
+
this.#worldVersion++;
|
|
235
|
+
this.onWorldMatrixChanged();
|
|
236
|
+
return true;
|
|
237
|
+
}
|
|
238
|
+
/** Subclass hook, invoked after matrixWorld was recomputed. */
|
|
239
|
+
onWorldMatrixChanged() { }
|
|
240
|
+
/** World-space position; refreshes ancestors as needed. */
|
|
241
|
+
getWorldPosition(out = new Float32Array(3)) {
|
|
242
|
+
this.updateWorldMatrix();
|
|
243
|
+
out[0] = this.matrixWorld[12];
|
|
244
|
+
out[1] = this.matrixWorld[13];
|
|
245
|
+
out[2] = this.matrixWorld[14];
|
|
246
|
+
return out;
|
|
247
|
+
}
|
|
248
|
+
localToWorld(out, point) {
|
|
249
|
+
this.updateWorldMatrix();
|
|
250
|
+
return vec3TransformMat4(out, point, this.matrixWorld);
|
|
251
|
+
}
|
|
252
|
+
worldToLocal(out, point) {
|
|
253
|
+
this.updateWorldMatrix();
|
|
254
|
+
if (!mat4Invert(scratchMatrix, this.matrixWorld))
|
|
255
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'singular world matrix');
|
|
256
|
+
return vec3TransformMat4(out, point, scratchMatrix);
|
|
257
|
+
}
|
|
258
|
+
/**
|
|
259
|
+
* Copy this node and its subtree. Geometries, materials and skeleton data
|
|
260
|
+
* are shared by reference; subclasses override copyFrom for their state.
|
|
261
|
+
*/
|
|
262
|
+
clone(recursive = true) {
|
|
263
|
+
const copy = new this.constructor();
|
|
264
|
+
copy.copyFrom(this);
|
|
265
|
+
if (recursive)
|
|
266
|
+
for (const child of this.#children)
|
|
267
|
+
copy.addChild(child.clone(true));
|
|
268
|
+
return copy;
|
|
269
|
+
}
|
|
270
|
+
copyFrom(source) {
|
|
271
|
+
this.name = source.name;
|
|
272
|
+
this.position.set(source.position);
|
|
273
|
+
this.quaternion.set(source.quaternion);
|
|
274
|
+
this.scale.set(source.scale);
|
|
275
|
+
this.visible = source.visible;
|
|
276
|
+
this.layers = source.layers;
|
|
277
|
+
this.renderOrder = source.renderOrder;
|
|
278
|
+
this.castShadow = source.castShadow;
|
|
279
|
+
this.receiveShadow = source.receiveShadow;
|
|
280
|
+
this.frustumCulled = source.frustumCulled;
|
|
281
|
+
this.userData = { ...source.userData };
|
|
282
|
+
this.#localDirty = true;
|
|
283
|
+
}
|
|
284
|
+
}
|
|
285
|
+
/** Root of a renderable graph; owns environment-wide settings. Colors are linear RGB. */
|
|
286
|
+
export class Scene3D extends Object3D {
|
|
287
|
+
/** Clear color, or a cube texture drawn as a skybox. `undefined` keeps the canvas transparent. */
|
|
288
|
+
background;
|
|
289
|
+
backgroundIntensity = 1;
|
|
290
|
+
/** Cube texture used for image-based lighting on standard materials. */
|
|
291
|
+
environment;
|
|
292
|
+
environmentIntensity = 1;
|
|
293
|
+
fog;
|
|
294
|
+
/** Draw every mesh with this material instead of its own, as for masks and depth-only views. */
|
|
295
|
+
overrideMaterial;
|
|
296
|
+
/**
|
|
297
|
+
* Up to four world-space planes as [nx, ny, nz, d]. Fragments on the
|
|
298
|
+
* negative side (n . p + d < 0) are not drawn. Shadows are not clipped.
|
|
299
|
+
*/
|
|
300
|
+
clippingPlanes = [];
|
|
301
|
+
constructor() {
|
|
302
|
+
super('scene');
|
|
303
|
+
}
|
|
304
|
+
}
|
|
305
|
+
//# sourceMappingURL=Object3D.js.map
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
import type { Blending3D, ColorInput3D } from './Material3D.js';
|
|
2
|
+
import { InstancedMesh3D } from './Mesh3D.js';
|
|
3
|
+
import type { Texture3D } from './Texture3D.js';
|
|
4
|
+
export declare const PARTICLES3D_LIMITS: Readonly<{
|
|
5
|
+
readonly maxParticles: 262144;
|
|
6
|
+
readonly maxStepSeconds: 0.25;
|
|
7
|
+
}>;
|
|
8
|
+
export type ParticleShape3D = 'point' | 'sphere' | 'box';
|
|
9
|
+
export interface ParticleEmitterOptions3D {
|
|
10
|
+
/** Maximum number of live particles. */
|
|
11
|
+
readonly capacity?: number;
|
|
12
|
+
/** Particles emitted per second while the emitter is playing. */
|
|
13
|
+
readonly rate?: number;
|
|
14
|
+
/** Seconds each particle lives: a fixed value or a [min, max] range. */
|
|
15
|
+
readonly lifetime?: number | readonly [number, number];
|
|
16
|
+
/** Initial speed in units per second: a fixed value or a [min, max] range. */
|
|
17
|
+
readonly speed?: number | readonly [number, number];
|
|
18
|
+
/** Mean emission direction in emitter space. */
|
|
19
|
+
readonly direction?: readonly [number, number, number];
|
|
20
|
+
/** Half angle in radians of the cone around `direction`; PI emits in every direction. */
|
|
21
|
+
readonly spread?: number;
|
|
22
|
+
/** Constant acceleration, in the simulation space. */
|
|
23
|
+
readonly gravity?: readonly [number, number, number];
|
|
24
|
+
/** Fraction of velocity lost per second. */
|
|
25
|
+
readonly drag?: number;
|
|
26
|
+
readonly startSize?: number;
|
|
27
|
+
readonly endSize?: number;
|
|
28
|
+
readonly startColor?: ColorInput3D;
|
|
29
|
+
readonly endColor?: ColorInput3D;
|
|
30
|
+
readonly startOpacity?: number;
|
|
31
|
+
readonly endOpacity?: number;
|
|
32
|
+
/** Volume particles spawn in: a point, a sphere of `radius`, or a box of half `extents`. */
|
|
33
|
+
readonly shape?: ParticleShape3D;
|
|
34
|
+
readonly radius?: number;
|
|
35
|
+
readonly extents?: readonly [number, number, number];
|
|
36
|
+
/** 'world' leaves emitted particles behind when the emitter moves; 'local' carries them along. */
|
|
37
|
+
readonly space?: 'world' | 'local';
|
|
38
|
+
readonly map?: Texture3D;
|
|
39
|
+
readonly blending?: Blending3D;
|
|
40
|
+
/** Seed of the deterministic random sequence. */
|
|
41
|
+
readonly seed?: number;
|
|
42
|
+
/** Stop emitting after this many seconds; 0 emits forever. */
|
|
43
|
+
readonly duration?: number;
|
|
44
|
+
}
|
|
45
|
+
export declare class ParticleEmitter3D extends InstancedMesh3D {
|
|
46
|
+
#private;
|
|
47
|
+
rate: number;
|
|
48
|
+
readonly lifetime: [number, number];
|
|
49
|
+
readonly speed: [number, number];
|
|
50
|
+
readonly direction: Float32Array<ArrayBuffer>;
|
|
51
|
+
spread: number;
|
|
52
|
+
readonly gravity: Float32Array<ArrayBuffer>;
|
|
53
|
+
drag: number;
|
|
54
|
+
startSize: number;
|
|
55
|
+
endSize: number;
|
|
56
|
+
readonly startColor: Float32Array<ArrayBuffer>;
|
|
57
|
+
readonly endColor: Float32Array<ArrayBuffer>;
|
|
58
|
+
startOpacity: number;
|
|
59
|
+
endOpacity: number;
|
|
60
|
+
shape: ParticleShape3D;
|
|
61
|
+
radius: number;
|
|
62
|
+
readonly extents: Float32Array<ArrayBuffer>;
|
|
63
|
+
readonly space: 'world' | 'local';
|
|
64
|
+
duration: number;
|
|
65
|
+
/** Emission is suspended while false; live particles keep simulating. */
|
|
66
|
+
emitting: boolean;
|
|
67
|
+
constructor(options?: ParticleEmitterOptions3D);
|
|
68
|
+
/** Number of live particles. */
|
|
69
|
+
get aliveCount(): number;
|
|
70
|
+
/** Seconds simulated since construction or the last reset(). */
|
|
71
|
+
get elapsedSeconds(): number;
|
|
72
|
+
/** Uniform value in [0, 1) from a small deterministic generator (mulberry32). */
|
|
73
|
+
private next;
|
|
74
|
+
/** Emit `count` particles immediately, limited by the remaining capacity. */
|
|
75
|
+
burst(count: number): number;
|
|
76
|
+
private spawn;
|
|
77
|
+
/** Advance the simulation and refresh the instance buffers. */
|
|
78
|
+
update(deltaSeconds: number): void;
|
|
79
|
+
private writeInstances;
|
|
80
|
+
/** Remove every particle and restart the random sequence and the duration timer. */
|
|
81
|
+
reset(): void;
|
|
82
|
+
clone(): this;
|
|
83
|
+
}
|
|
84
|
+
export declare function createParticleEmitter3D(options?: ParticleEmitterOptions3D): ParticleEmitter3D;
|
|
85
|
+
//# sourceMappingURL=Particles3D.d.ts.map
|