@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,12 @@
|
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
/** Attach rejection observation before handing the promise to either host. */
|
|
3
|
+
export function deferred() {
|
|
4
|
+
let resolve, reject;
|
|
5
|
+
const promise = new Promise((a, b) => {
|
|
6
|
+
resolve = a;
|
|
7
|
+
reject = b;
|
|
8
|
+
});
|
|
9
|
+
promise.catch(() => undefined);
|
|
10
|
+
return { promise, resolve, reject };
|
|
11
|
+
}
|
|
12
|
+
//# sourceMappingURL=sharedHostDeferred.js.map
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
/** Backend validators supply complete compatibility keys; this ledger owns metadata only. */
|
|
2
|
+
export interface RetentionRequestBase {
|
|
3
|
+
readonly id: number;
|
|
4
|
+
readonly byteLength: number;
|
|
5
|
+
}
|
|
6
|
+
export interface KeyedRetentionRequest<R extends RetentionRequestBase> {
|
|
7
|
+
readonly request: R;
|
|
8
|
+
readonly key: string;
|
|
9
|
+
}
|
|
10
|
+
export type LedgerHandle<R extends RetentionRequestBase, T extends object> = R & {
|
|
11
|
+
readonly resource: T;
|
|
12
|
+
readonly identity: object;
|
|
13
|
+
readonly session: object;
|
|
14
|
+
};
|
|
15
|
+
export interface LedgerLease<R extends RetentionRequestBase, T extends object> {
|
|
16
|
+
readonly requestId: number;
|
|
17
|
+
readonly handle: LedgerHandle<R, T>;
|
|
18
|
+
readonly offset: 0;
|
|
19
|
+
readonly size: number;
|
|
20
|
+
}
|
|
21
|
+
export interface LedgerPlan<R extends RetentionRequestBase, T extends object> {
|
|
22
|
+
readonly session: object;
|
|
23
|
+
readonly revision: object;
|
|
24
|
+
readonly requests: readonly R[];
|
|
25
|
+
readonly matches: ReadonlyMap<number, LedgerHandle<R, T>>;
|
|
26
|
+
readonly leases: readonly LedgerLease<R, T>[];
|
|
27
|
+
readonly victims: readonly LedgerHandle<R, T>[];
|
|
28
|
+
}
|
|
29
|
+
export interface LedgerReturnPlan<R extends RetentionRequestBase, T extends object> {
|
|
30
|
+
readonly identity: object;
|
|
31
|
+
readonly retained: readonly LedgerHandle<R, T>[];
|
|
32
|
+
readonly transient: readonly LedgerHandle<R, T>[];
|
|
33
|
+
}
|
|
34
|
+
export interface RetentionLedgerStatus {
|
|
35
|
+
readonly idleBytes: number;
|
|
36
|
+
readonly idleEntries: number;
|
|
37
|
+
readonly reservedBytes: number;
|
|
38
|
+
readonly reservedEntries: number;
|
|
39
|
+
readonly unknownBytes: number;
|
|
40
|
+
readonly unknownEntries: number;
|
|
41
|
+
}
|
|
42
|
+
interface RetentionResourceGauges extends RetentionLedgerStatus {
|
|
43
|
+
readonly leasedBytes: number;
|
|
44
|
+
readonly leasedEntries: number;
|
|
45
|
+
readonly detachedBytes: number;
|
|
46
|
+
readonly detachedEntries: number;
|
|
47
|
+
}
|
|
48
|
+
/** Existing unknown obligations projected without native references. */
|
|
49
|
+
export interface NativeUnknownDiagnostics {
|
|
50
|
+
knownLogicalBytes: number;
|
|
51
|
+
objects: number;
|
|
52
|
+
highKnownLogicalBytes: number;
|
|
53
|
+
highObjects: number;
|
|
54
|
+
saturated: boolean;
|
|
55
|
+
}
|
|
56
|
+
/** Fixed-size Host observation shared by successive original generation ledgers. */
|
|
57
|
+
export interface RetentionLedgerDiagnostics {
|
|
58
|
+
current: {
|
|
59
|
+
-readonly [K in keyof RetentionResourceGauges]: number;
|
|
60
|
+
};
|
|
61
|
+
highWater: {
|
|
62
|
+
-readonly [K in keyof RetentionResourceGauges]: number;
|
|
63
|
+
};
|
|
64
|
+
saturated: boolean;
|
|
65
|
+
unknownNative?: NativeUnknownDiagnostics;
|
|
66
|
+
}
|
|
67
|
+
export type RetentionSettlement = 'destroyed' | 'unknown' | 'context-invalidated';
|
|
68
|
+
export interface RetentionLedger<R extends RetentionRequestBase, T extends object> {
|
|
69
|
+
assertActive(): void;
|
|
70
|
+
plan(requests: readonly KeyedRetentionRequest<R>[]): LedgerPlan<R, T>;
|
|
71
|
+
claim(plan: LedgerPlan<R, T>): readonly LedgerLease<R, T>[];
|
|
72
|
+
registerCreated(request: KeyedRetentionRequest<R>, resource: T): LedgerLease<R, T>;
|
|
73
|
+
reserveReturns(leases: readonly LedgerLease<R, T>[]): LedgerReturnPlan<R, T>;
|
|
74
|
+
publishReturns(plan: LedgerReturnPlan<R, T>): readonly LedgerHandle<R, T>[];
|
|
75
|
+
cancelReturns(plan: LedgerReturnPlan<R, T>): readonly LedgerHandle<R, T>[];
|
|
76
|
+
detach(handle: LedgerHandle<R, T>): void;
|
|
77
|
+
settled(handle: LedgerHandle<R, T>, outcome: RetentionSettlement): void;
|
|
78
|
+
invalidate(): void;
|
|
79
|
+
detachIdleForClose(): readonly LedgerHandle<R, T>[];
|
|
80
|
+
getStatus(): RetentionLedgerStatus;
|
|
81
|
+
}
|
|
82
|
+
/** Native proofs belong to the Host; confirmed outcomes alone change these charges. */
|
|
83
|
+
export declare function createRetentionLedger<Request extends RetentionRequestBase, Resource extends object>(session: object, diagnostics?: RetentionLedgerDiagnostics): RetentionLedger<Request, Resource>;
|
|
84
|
+
export {};
|
|
85
|
+
//# sourceMappingURL=sharedRetentionLedger.d.ts.map
|
|
@@ -0,0 +1,391 @@
|
|
|
1
|
+
// Capture callback-free collection operations before any Host native callback.
|
|
2
|
+
// Claim uses only these operations and preallocated nodes/leases after detaching.
|
|
3
|
+
const NativeMap = Map, NativeSet = Set, NativeWeakMap = WeakMap, NativeWeakSet = WeakSet;
|
|
4
|
+
const mapGet = Function.prototype.call.bind(Map.prototype.get);
|
|
5
|
+
const mapSet = Function.prototype.call.bind(Map.prototype.set);
|
|
6
|
+
const mapHas = Function.prototype.call.bind(Map.prototype.has);
|
|
7
|
+
const mapDelete = Function.prototype.call.bind(Map.prototype.delete);
|
|
8
|
+
const setAdd = Function.prototype.call.bind(Set.prototype.add);
|
|
9
|
+
const setHas = Function.prototype.call.bind(Set.prototype.has);
|
|
10
|
+
const weakGet = Function.prototype.call.bind(WeakMap.prototype.get);
|
|
11
|
+
const weakSet = Function.prototype.call.bind(WeakMap.prototype.set);
|
|
12
|
+
const weakHas = Function.prototype.call.bind(WeakSet.prototype.has);
|
|
13
|
+
const weakAdd = Function.prototype.call.bind(WeakSet.prototype.add);
|
|
14
|
+
const MAX_IDLE_BYTES = 33554432;
|
|
15
|
+
const MAX_IDLE_ENTRIES = 4096;
|
|
16
|
+
// A captured resource may acquire exactly one allocation identity, even when two
|
|
17
|
+
// Hosts borrow one device. Native object identity alone is not an allocation ID.
|
|
18
|
+
const registeredResources = new NativeWeakSet();
|
|
19
|
+
/** Native proofs belong to the Host; confirmed outcomes alone change these charges. */
|
|
20
|
+
export function createRetentionLedger(session, diagnostics) {
|
|
21
|
+
const indexes = new NativeMap();
|
|
22
|
+
const nodes = new NativeWeakMap();
|
|
23
|
+
const leaseNodes = new NativeWeakMap();
|
|
24
|
+
const claims = new NativeWeakMap();
|
|
25
|
+
const returns = new NativeWeakMap();
|
|
26
|
+
const idle = { bytes: 0, count: 0, bytesKey: 'idleBytes', countKey: 'idleEntries' }, leased = { bytes: 0, count: 0, bytesKey: 'leasedBytes', countKey: 'leasedEntries' };
|
|
27
|
+
const reserved = { bytes: 0, count: 0, bytesKey: 'reservedBytes', countKey: 'reservedEntries' }, detached = { bytes: 0, count: 0, bytesKey: 'detachedBytes', countKey: 'detachedEntries' };
|
|
28
|
+
const unknown = { bytes: 0, count: 0, bytesKey: 'unknownBytes', countKey: 'unknownEntries' };
|
|
29
|
+
let head, tail;
|
|
30
|
+
let revision = {}, active = true;
|
|
31
|
+
function requireActive() {
|
|
32
|
+
if (!active)
|
|
33
|
+
throw new TypeError('Inactive buffer pool');
|
|
34
|
+
}
|
|
35
|
+
function requireNode(handle) {
|
|
36
|
+
const node = weakGet(nodes, handle);
|
|
37
|
+
if (!node)
|
|
38
|
+
throw new TypeError('Foreign buffer handle');
|
|
39
|
+
return node;
|
|
40
|
+
}
|
|
41
|
+
function admit(input) {
|
|
42
|
+
// Backend wrappers own the fresh plain-data snapshot and its finite
|
|
43
|
+
// descriptor validation. Frozen is a misuse check, not an authority brand.
|
|
44
|
+
const request = input.request, key = input.key;
|
|
45
|
+
if (!Object.isFrozen(request))
|
|
46
|
+
throw new TypeError('Mutable retention request');
|
|
47
|
+
if (!Number.isSafeInteger(request.id) ||
|
|
48
|
+
request.id < 0 ||
|
|
49
|
+
!Number.isSafeInteger(request.byteLength) ||
|
|
50
|
+
request.byteLength <= 0 ||
|
|
51
|
+
request.byteLength % 4 !== 0 ||
|
|
52
|
+
typeof key !== 'string' ||
|
|
53
|
+
key.length === 0) {
|
|
54
|
+
throw new TypeError('Invalid retention request');
|
|
55
|
+
}
|
|
56
|
+
return { request, key };
|
|
57
|
+
}
|
|
58
|
+
function charge(total, node, direction) {
|
|
59
|
+
total.bytes += direction * node.handle.byteLength;
|
|
60
|
+
total.count += direction;
|
|
61
|
+
if (diagnostics) {
|
|
62
|
+
const bytes = diagnostics.current[total.bytesKey] + direction * node.handle.byteLength, count = diagnostics.current[total.countKey] + direction;
|
|
63
|
+
if (bytes > Number.MAX_SAFE_INTEGER || count > Number.MAX_SAFE_INTEGER)
|
|
64
|
+
diagnostics.saturated = true;
|
|
65
|
+
diagnostics.current[total.bytesKey] = Math.min(Number.MAX_SAFE_INTEGER, bytes);
|
|
66
|
+
diagnostics.current[total.countKey] = Math.min(Number.MAX_SAFE_INTEGER, count);
|
|
67
|
+
diagnostics.highWater[total.bytesKey] = Math.max(diagnostics.highWater[total.bytesKey], diagnostics.current[total.bytesKey]);
|
|
68
|
+
diagnostics.highWater[total.countKey] = Math.max(diagnostics.highWater[total.countKey], diagnostics.current[total.countKey]);
|
|
69
|
+
if (total === unknown && diagnostics.unknownNative) {
|
|
70
|
+
const native = diagnostics.unknownNative, bytes = native.knownLogicalBytes + direction * node.handle.byteLength, objects = native.objects + direction;
|
|
71
|
+
if (bytes > Number.MAX_SAFE_INTEGER || objects > Number.MAX_SAFE_INTEGER)
|
|
72
|
+
native.saturated = true;
|
|
73
|
+
native.knownLogicalBytes = Math.min(Number.MAX_SAFE_INTEGER, bytes);
|
|
74
|
+
native.objects = Math.min(Number.MAX_SAFE_INTEGER, objects);
|
|
75
|
+
native.highKnownLogicalBytes = Math.max(native.highKnownLogicalBytes, native.knownLogicalBytes);
|
|
76
|
+
native.highObjects = Math.max(native.highObjects, native.objects);
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
function leaseFor(request, node) {
|
|
81
|
+
const lease = Object.freeze({
|
|
82
|
+
requestId: request.id,
|
|
83
|
+
handle: node.handle,
|
|
84
|
+
offset: 0,
|
|
85
|
+
size: request.byteLength
|
|
86
|
+
});
|
|
87
|
+
weakSet(leaseNodes, lease, node);
|
|
88
|
+
return lease;
|
|
89
|
+
}
|
|
90
|
+
/** All links already exist before claim; unlinking publishes no new owner. */
|
|
91
|
+
function unlink(node) {
|
|
92
|
+
const bucket = node.bucket;
|
|
93
|
+
if (node.keyPrevious)
|
|
94
|
+
node.keyPrevious.keyNext = node.keyNext;
|
|
95
|
+
else
|
|
96
|
+
bucket.head = node.keyNext;
|
|
97
|
+
if (node.keyNext)
|
|
98
|
+
node.keyNext.keyPrevious = node.keyPrevious;
|
|
99
|
+
else
|
|
100
|
+
bucket.tail = node.keyPrevious;
|
|
101
|
+
if (node.previous)
|
|
102
|
+
node.previous.next = node.next;
|
|
103
|
+
else
|
|
104
|
+
head = node.next;
|
|
105
|
+
if (node.next)
|
|
106
|
+
node.next.previous = node.previous;
|
|
107
|
+
else
|
|
108
|
+
tail = node.previous;
|
|
109
|
+
if (!bucket.head)
|
|
110
|
+
mapDelete(bucket.sizes, bucket.key);
|
|
111
|
+
node.bucket = undefined;
|
|
112
|
+
node.keyPrevious = undefined;
|
|
113
|
+
node.keyNext = undefined;
|
|
114
|
+
node.previous = undefined;
|
|
115
|
+
node.next = undefined;
|
|
116
|
+
charge(idle, node, -1);
|
|
117
|
+
}
|
|
118
|
+
function append(node) {
|
|
119
|
+
const sizes = indexes, key = node.key;
|
|
120
|
+
let bucket = mapGet(sizes, key);
|
|
121
|
+
if (!bucket) {
|
|
122
|
+
bucket = { key, sizes, head: undefined, tail: undefined };
|
|
123
|
+
// A failing metadata allocation leaves this node reservation-owned.
|
|
124
|
+
mapSet(sizes, key, bucket);
|
|
125
|
+
}
|
|
126
|
+
node.bucket = bucket;
|
|
127
|
+
node.keyPrevious = bucket.tail;
|
|
128
|
+
node.keyNext = undefined;
|
|
129
|
+
if (bucket.tail)
|
|
130
|
+
bucket.tail.keyNext = node;
|
|
131
|
+
else
|
|
132
|
+
bucket.head = node;
|
|
133
|
+
bucket.tail = node;
|
|
134
|
+
node.previous = tail;
|
|
135
|
+
node.next = undefined;
|
|
136
|
+
if (tail)
|
|
137
|
+
tail.next = node;
|
|
138
|
+
else
|
|
139
|
+
head = node;
|
|
140
|
+
tail = node;
|
|
141
|
+
charge(reserved, node, -1);
|
|
142
|
+
charge(leased, node, -1);
|
|
143
|
+
charge(idle, node, 1);
|
|
144
|
+
node.state = 'idle';
|
|
145
|
+
node.lease = undefined;
|
|
146
|
+
}
|
|
147
|
+
function detachNode(node) {
|
|
148
|
+
if (node.state === 'idle')
|
|
149
|
+
unlink(node);
|
|
150
|
+
else if (node.state === 'reserved') {
|
|
151
|
+
charge(reserved, node, -1);
|
|
152
|
+
charge(leased, node, -1);
|
|
153
|
+
}
|
|
154
|
+
else if (node.state === 'leased')
|
|
155
|
+
charge(leased, node, -1);
|
|
156
|
+
else
|
|
157
|
+
return;
|
|
158
|
+
node.state = 'detached';
|
|
159
|
+
node.lease = undefined;
|
|
160
|
+
charge(detached, node, 1);
|
|
161
|
+
}
|
|
162
|
+
function returnState(plan) {
|
|
163
|
+
const state = weakGet(returns, plan);
|
|
164
|
+
if (!state || state.consumed)
|
|
165
|
+
throw new TypeError('Foreign or consumed buffer return plan');
|
|
166
|
+
return state;
|
|
167
|
+
}
|
|
168
|
+
return {
|
|
169
|
+
assertActive: requireActive,
|
|
170
|
+
plan(requests) {
|
|
171
|
+
requireActive();
|
|
172
|
+
const rows = [], matches = new NativeMap();
|
|
173
|
+
const selected = [], leases = [], victims = [];
|
|
174
|
+
const cursors = new NativeMap(), protectedNodes = new NativeSet();
|
|
175
|
+
let incomingBytes = 0, incomingCount = 0, matchedBytes = 0;
|
|
176
|
+
for (let i = 0; i < requests.length; i++) {
|
|
177
|
+
const { request, key } = admit(requests[i]);
|
|
178
|
+
if (request.id !== i)
|
|
179
|
+
throw new TypeError('Nonsequential buffer request');
|
|
180
|
+
rows.push(request);
|
|
181
|
+
if (request.byteLength <= MAX_IDLE_BYTES) {
|
|
182
|
+
// Saturating sums preserve pressure decisions for arbitrarily
|
|
183
|
+
// many admitted candidates without creating a new refusal.
|
|
184
|
+
incomingBytes = Math.min(MAX_IDLE_BYTES + 1, incomingBytes + request.byteLength);
|
|
185
|
+
incomingCount = Math.min(MAX_IDLE_ENTRIES + 1, incomingCount + 1);
|
|
186
|
+
}
|
|
187
|
+
const bucket = mapGet(indexes, key);
|
|
188
|
+
if (!bucket)
|
|
189
|
+
continue;
|
|
190
|
+
const node = mapHas(cursors, bucket) ? mapGet(cursors, bucket) : bucket.head;
|
|
191
|
+
if (!node)
|
|
192
|
+
continue;
|
|
193
|
+
mapSet(cursors, bucket, node.keyNext);
|
|
194
|
+
setAdd(protectedNodes, node);
|
|
195
|
+
selected.push(node);
|
|
196
|
+
mapSet(matches, request.id, node.handle);
|
|
197
|
+
leases.push(leaseFor(request, node));
|
|
198
|
+
matchedBytes += node.handle.byteLength;
|
|
199
|
+
}
|
|
200
|
+
let remainingBytes = idle.bytes - matchedBytes, remainingCount = idle.count - selected.length;
|
|
201
|
+
// Protect every exact hit before selecting one unmatched FIFO prefix.
|
|
202
|
+
for (let node = head; node &&
|
|
203
|
+
(remainingBytes + reserved.bytes + incomingBytes > MAX_IDLE_BYTES ||
|
|
204
|
+
remainingCount + reserved.count + incomingCount > MAX_IDLE_ENTRIES); node = node.next) {
|
|
205
|
+
if (setHas(protectedNodes, node))
|
|
206
|
+
continue;
|
|
207
|
+
victims.push(node);
|
|
208
|
+
remainingBytes -= node.handle.byteLength;
|
|
209
|
+
remainingCount--;
|
|
210
|
+
}
|
|
211
|
+
const publicLeases = Object.freeze(leases), publicVictims = Object.freeze(victims.map(node => node.handle));
|
|
212
|
+
const plan = Object.freeze({
|
|
213
|
+
session,
|
|
214
|
+
revision,
|
|
215
|
+
requests: Object.freeze(rows),
|
|
216
|
+
matches,
|
|
217
|
+
leases: publicLeases,
|
|
218
|
+
victims: publicVictims
|
|
219
|
+
});
|
|
220
|
+
weakSet(claims, plan, {
|
|
221
|
+
revision,
|
|
222
|
+
nextRevision: {},
|
|
223
|
+
matches: selected,
|
|
224
|
+
victims,
|
|
225
|
+
leases: publicLeases,
|
|
226
|
+
consumed: false
|
|
227
|
+
});
|
|
228
|
+
return plan;
|
|
229
|
+
},
|
|
230
|
+
claim(plan) {
|
|
231
|
+
requireActive();
|
|
232
|
+
const state = weakGet(claims, plan);
|
|
233
|
+
if (!state || state.consumed || state.revision !== revision)
|
|
234
|
+
throw new TypeError('Foreign, stale or consumed buffer plan');
|
|
235
|
+
// Host has already attached these exact leases and every victim to
|
|
236
|
+
// persistent cleanup owners. No allocation follows the first unlink.
|
|
237
|
+
state.consumed = true;
|
|
238
|
+
revision = state.nextRevision;
|
|
239
|
+
for (let i = 0; i < state.matches.length; i++) {
|
|
240
|
+
const node = state.matches[i];
|
|
241
|
+
unlink(node);
|
|
242
|
+
node.state = 'leased';
|
|
243
|
+
node.lease = state.leases[i];
|
|
244
|
+
charge(leased, node, 1);
|
|
245
|
+
}
|
|
246
|
+
for (let i = 0; i < state.victims.length; i++)
|
|
247
|
+
detachNode(state.victims[i]);
|
|
248
|
+
return state.leases;
|
|
249
|
+
},
|
|
250
|
+
registerCreated(input, resource) {
|
|
251
|
+
// Registration follows Host capture even if a native callback has
|
|
252
|
+
// just invalidated reuse; it still records an owned cold allocation.
|
|
253
|
+
const { request, key } = admit(input);
|
|
254
|
+
if (weakHas(registeredResources, resource))
|
|
255
|
+
throw new TypeError('Already registered buffer resource');
|
|
256
|
+
const handle = Object.freeze({ ...request, identity: Object.freeze({}), session, resource });
|
|
257
|
+
const node = {
|
|
258
|
+
handle,
|
|
259
|
+
key,
|
|
260
|
+
state: 'leased',
|
|
261
|
+
lease: undefined,
|
|
262
|
+
bucket: undefined,
|
|
263
|
+
keyPrevious: undefined,
|
|
264
|
+
keyNext: undefined,
|
|
265
|
+
previous: undefined,
|
|
266
|
+
next: undefined
|
|
267
|
+
};
|
|
268
|
+
const lease = leaseFor(request, node), nextRevision = {};
|
|
269
|
+
weakSet(nodes, handle, node);
|
|
270
|
+
weakAdd(registeredResources, resource);
|
|
271
|
+
node.lease = lease;
|
|
272
|
+
charge(leased, node, 1);
|
|
273
|
+
revision = nextRevision;
|
|
274
|
+
return lease;
|
|
275
|
+
},
|
|
276
|
+
reserveReturns(leases) {
|
|
277
|
+
const selected = [], retained = [], transient = [];
|
|
278
|
+
const seen = new NativeSet();
|
|
279
|
+
let bytes = idle.bytes + reserved.bytes, count = idle.count + reserved.count;
|
|
280
|
+
for (let i = 0; i < leases.length; i++) {
|
|
281
|
+
const lease = leases[i], node = weakGet(leaseNodes, lease);
|
|
282
|
+
if (!node || node.state !== 'leased' || node.lease !== lease || setHas(seen, node)) {
|
|
283
|
+
throw new TypeError('Foreign, duplicate or inactive buffer lease');
|
|
284
|
+
}
|
|
285
|
+
setAdd(seen, node);
|
|
286
|
+
if (active && bytes + node.handle.byteLength <= MAX_IDLE_BYTES && count < MAX_IDLE_ENTRIES) {
|
|
287
|
+
selected.push(node);
|
|
288
|
+
retained.push(node.handle);
|
|
289
|
+
bytes += node.handle.byteLength;
|
|
290
|
+
count++;
|
|
291
|
+
}
|
|
292
|
+
else
|
|
293
|
+
transient.push(node.handle);
|
|
294
|
+
}
|
|
295
|
+
const plan = Object.freeze({
|
|
296
|
+
identity: Object.freeze({}),
|
|
297
|
+
retained: Object.freeze(retained),
|
|
298
|
+
transient: Object.freeze(transient)
|
|
299
|
+
});
|
|
300
|
+
const nextRevision = {};
|
|
301
|
+
weakSet(returns, plan, { nodes: selected, consumed: false });
|
|
302
|
+
// Reservations bound retention only: the leased allocation charge
|
|
303
|
+
// remains until publication or detach, never counted twice as memory.
|
|
304
|
+
for (let i = 0; i < selected.length; i++) {
|
|
305
|
+
const node = selected[i];
|
|
306
|
+
node.state = 'reserved';
|
|
307
|
+
charge(reserved, node, 1);
|
|
308
|
+
}
|
|
309
|
+
revision = nextRevision;
|
|
310
|
+
return plan;
|
|
311
|
+
},
|
|
312
|
+
publishReturns(plan) {
|
|
313
|
+
requireActive();
|
|
314
|
+
const state = returnState(plan), nextRevision = {};
|
|
315
|
+
for (let i = 0; i < state.nodes.length; i++) {
|
|
316
|
+
if (state.nodes[i].state !== 'reserved')
|
|
317
|
+
throw new TypeError('Detached return reservation');
|
|
318
|
+
}
|
|
319
|
+
// Keep the plan cancellable until every append succeeds. If an
|
|
320
|
+
// allocation throws, cancellation also removes already-idle nodes.
|
|
321
|
+
revision = nextRevision;
|
|
322
|
+
for (let i = 0; i < state.nodes.length; i++)
|
|
323
|
+
append(state.nodes[i]);
|
|
324
|
+
state.consumed = true;
|
|
325
|
+
return plan.retained;
|
|
326
|
+
},
|
|
327
|
+
cancelReturns(plan) {
|
|
328
|
+
const state = returnState(plan), cleanup = [], nextRevision = {};
|
|
329
|
+
for (let i = 0; i < state.nodes.length; i++) {
|
|
330
|
+
const node = state.nodes[i];
|
|
331
|
+
if (node.state === 'reserved' || node.state === 'idle' || node.state === 'detached')
|
|
332
|
+
cleanup.push(node.handle);
|
|
333
|
+
}
|
|
334
|
+
const result = Object.freeze(cleanup);
|
|
335
|
+
state.consumed = true;
|
|
336
|
+
revision = nextRevision;
|
|
337
|
+
for (let i = 0; i < state.nodes.length; i++)
|
|
338
|
+
detachNode(state.nodes[i]);
|
|
339
|
+
return result;
|
|
340
|
+
},
|
|
341
|
+
detach(handle) {
|
|
342
|
+
const node = requireNode(handle), nextRevision = {};
|
|
343
|
+
detachNode(node);
|
|
344
|
+
revision = nextRevision;
|
|
345
|
+
},
|
|
346
|
+
settled(handle, outcome) {
|
|
347
|
+
const node = requireNode(handle);
|
|
348
|
+
if (outcome !== 'destroyed' && outcome !== 'unknown' && outcome !== 'context-invalidated')
|
|
349
|
+
throw new TypeError('Invalid retention settlement');
|
|
350
|
+
if (node.state === 'unknown' || node.state === 'destroyed' || node.state === 'context-invalidated')
|
|
351
|
+
throw new TypeError('Allocation settlement already reported');
|
|
352
|
+
if (outcome === 'context-invalidated' && active)
|
|
353
|
+
throw new TypeError('Active context allocation');
|
|
354
|
+
const nextRevision = {};
|
|
355
|
+
detachNode(node);
|
|
356
|
+
charge(detached, node, -1);
|
|
357
|
+
node.state = outcome;
|
|
358
|
+
if (outcome === 'unknown') {
|
|
359
|
+
charge(unknown, node, 1);
|
|
360
|
+
active = false;
|
|
361
|
+
}
|
|
362
|
+
// Confirmed loss can invalidate a known owner. It never refunds a
|
|
363
|
+
// prior unknown cleanup or turns invalidation into native deletion.
|
|
364
|
+
revision = nextRevision;
|
|
365
|
+
},
|
|
366
|
+
invalidate() {
|
|
367
|
+
active = false;
|
|
368
|
+
},
|
|
369
|
+
detachIdleForClose() {
|
|
370
|
+
const cleanup = [];
|
|
371
|
+
for (let node = head; node; node = node.next)
|
|
372
|
+
cleanup.push(node.handle);
|
|
373
|
+
const result = Object.freeze(cleanup), nextRevision = {};
|
|
374
|
+
while (head)
|
|
375
|
+
detachNode(head);
|
|
376
|
+
revision = nextRevision;
|
|
377
|
+
return result;
|
|
378
|
+
},
|
|
379
|
+
getStatus() {
|
|
380
|
+
return Object.freeze({
|
|
381
|
+
idleBytes: idle.bytes,
|
|
382
|
+
idleEntries: idle.count,
|
|
383
|
+
reservedBytes: reserved.bytes,
|
|
384
|
+
reservedEntries: reserved.count,
|
|
385
|
+
unknownBytes: unknown.bytes,
|
|
386
|
+
unknownEntries: unknown.count
|
|
387
|
+
});
|
|
388
|
+
}
|
|
389
|
+
};
|
|
390
|
+
}
|
|
391
|
+
//# sourceMappingURL=sharedRetentionLedger.js.map
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
import type { PreparedSharedFrame2D } from '../rendering/prepareSharedDraws2D.js';
|
|
2
|
+
import type { SharedPageCopyDiagnostics2D } from '../rendering/sharedColor2D.js';
|
|
3
|
+
import type { ProjectionPlan2D } from './imageProjections2D.js';
|
|
4
|
+
/** Private logical limits; native capabilities remain in each concrete wrapper. */
|
|
5
|
+
export interface SharedStorageLimits2D {
|
|
6
|
+
readonly maxUploadBytes: number;
|
|
7
|
+
readonly maxPendingUploadBytes: number;
|
|
8
|
+
readonly maxPendingFrames: number;
|
|
9
|
+
readonly maxReadbackBytes: number;
|
|
10
|
+
readonly maxPendingGeometryBytes: number;
|
|
11
|
+
/** Absent in a caller that predates the option: the profile's own 64 MiB. */
|
|
12
|
+
readonly maxFramePageBytes?: number;
|
|
13
|
+
}
|
|
14
|
+
export declare class SharedStorageError2D extends Error {
|
|
15
|
+
readonly reason: 'budget' | 'device' | 'backpressure' | 'serial';
|
|
16
|
+
constructor(reason: 'budget' | 'device' | 'backpressure' | 'serial');
|
|
17
|
+
}
|
|
18
|
+
export interface SharedOwnerSnapshot2D {
|
|
19
|
+
readonly pendingFrames: number;
|
|
20
|
+
readonly pendingUploadBytes: number;
|
|
21
|
+
readonly pendingReadbackBytes: number;
|
|
22
|
+
readonly pendingTextureBytes: number;
|
|
23
|
+
readonly pendingGeometryBytes: number;
|
|
24
|
+
readonly pendingColorBytes: number;
|
|
25
|
+
readonly pendingCanonicalBytes: number;
|
|
26
|
+
readonly serial: number;
|
|
27
|
+
}
|
|
28
|
+
export interface SharedStorageFees2D {
|
|
29
|
+
readonly prepared: PreparedSharedFrame2D;
|
|
30
|
+
readonly options: SharedStorageLimits2D;
|
|
31
|
+
readonly upload: number;
|
|
32
|
+
readonly colorBytes: number;
|
|
33
|
+
readonly effectBytes: number;
|
|
34
|
+
}
|
|
35
|
+
/** Concrete amounts authored by the backend after the shared logical fee check. */
|
|
36
|
+
export interface SharedReadbackLayout2D {
|
|
37
|
+
readonly rowPitch: number;
|
|
38
|
+
readonly staging: number;
|
|
39
|
+
readonly output: number;
|
|
40
|
+
}
|
|
41
|
+
export interface SharedStoragePlan2D extends SharedStorageFees2D, SharedReadbackLayout2D {
|
|
42
|
+
}
|
|
43
|
+
export interface SharedSubmissionStorage2D extends SharedStoragePlan2D {
|
|
44
|
+
readonly projectionPlan: ProjectionPlan2D;
|
|
45
|
+
}
|
|
46
|
+
/** Joint logical fees precede readback layout, native limits, pending checks and payloads. */
|
|
47
|
+
export declare function planSharedStorageFees2D(prepared: PreparedSharedFrame2D, options: SharedStorageLimits2D): SharedStorageFees2D;
|
|
48
|
+
/** No allocator or callback is accepted; the caller supplies its already computed layout. */
|
|
49
|
+
export declare function withSharedReadbackLayout2D(fees: SharedStorageFees2D, layout: SharedReadbackLayout2D): SharedStoragePlan2D;
|
|
50
|
+
export declare function checkSharedCapacity2D(storage: SharedStoragePlan2D, owner: SharedOwnerSnapshot2D, canonicalBytes?: number, sourceCopy?: number): void;
|
|
51
|
+
/** Only current READY identities authorize omitted whole-page copies. */
|
|
52
|
+
export declare function materializeSharedPages2D(storage: SharedSubmissionStorage2D, cold: ReadonlySet<number>, owner: SharedOwnerSnapshot2D, diagnostics?: SharedPageCopyDiagnostics2D): {
|
|
53
|
+
projections: (Uint8Array<ArrayBuffer> | undefined)[];
|
|
54
|
+
canonicalBytes: number;
|
|
55
|
+
};
|
|
56
|
+
//# sourceMappingURL=sharedSubmissionStorage2D.d.ts.map
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
import { copySharedPagePixels } from '../rendering/sharedColor2D.js';
|
|
2
|
+
import { noteOwnedPreparationFailure } from '../rendering/ownedPreparationFailure2D.js';
|
|
3
|
+
// Page texture bytes awaiting completion, and conversion memory held at once, are each bounded by
|
|
4
|
+
// two frames' worth of pages, as the number of accepted frames is bounded by two.
|
|
5
|
+
const pendingPageBytes = (framePageBytes) => 2 * Math.min(67108864, framePageBytes ?? 67108864);
|
|
6
|
+
export class SharedStorageError2D extends Error {
|
|
7
|
+
reason;
|
|
8
|
+
constructor(reason) {
|
|
9
|
+
super('Shared storage ' + reason);
|
|
10
|
+
this.reason = reason;
|
|
11
|
+
}
|
|
12
|
+
}
|
|
13
|
+
function fail(reason) {
|
|
14
|
+
throw noteOwnedPreparationFailure(new SharedStorageError2D(reason));
|
|
15
|
+
}
|
|
16
|
+
/** Joint logical fees precede readback layout, native limits, pending checks and payloads. */
|
|
17
|
+
export function planSharedStorageFees2D(prepared, options) {
|
|
18
|
+
const { width, height } = prepared, colorBytes = 4 * width * height, effectBytes = colorBytes * prepared.effects.targetCount, upload = prepared.upload;
|
|
19
|
+
if (!Number.isSafeInteger(colorBytes) ||
|
|
20
|
+
colorBytes + effectBytes > 67108864 ||
|
|
21
|
+
!Number.isSafeInteger(upload) ||
|
|
22
|
+
upload > options.maxUploadBytes)
|
|
23
|
+
fail('budget');
|
|
24
|
+
return { prepared, options, upload, colorBytes, effectBytes };
|
|
25
|
+
}
|
|
26
|
+
/** No allocator or callback is accepted; the caller supplies its already computed layout. */
|
|
27
|
+
export function withSharedReadbackLayout2D(fees, layout) {
|
|
28
|
+
const { rowPitch, staging, output } = layout;
|
|
29
|
+
if (!Number.isSafeInteger(staging) || staging + output > fees.options.maxReadbackBytes)
|
|
30
|
+
fail('budget');
|
|
31
|
+
return { ...fees, rowPitch, staging, output };
|
|
32
|
+
}
|
|
33
|
+
export function checkSharedCapacity2D(storage, owner, canonicalBytes = 0, sourceCopy = 0) {
|
|
34
|
+
const { options, prepared } = storage;
|
|
35
|
+
const check = (used, amount, limit) => {
|
|
36
|
+
if (!Number.isSafeInteger(used) || used < 0 || !Number.isSafeInteger(amount) || amount < 0 || amount > limit - used)
|
|
37
|
+
fail('backpressure');
|
|
38
|
+
};
|
|
39
|
+
check(owner.pendingFrames, 1, options.maxPendingFrames);
|
|
40
|
+
check(owner.pendingUploadBytes, storage.upload, options.maxPendingUploadBytes);
|
|
41
|
+
check(owner.pendingReadbackBytes, storage.staging + storage.output, options.maxReadbackBytes);
|
|
42
|
+
const pagesAtOnce = pendingPageBytes(options.maxFramePageBytes);
|
|
43
|
+
check(owner.pendingTextureBytes, prepared.pageBytes, pagesAtOnce);
|
|
44
|
+
check(owner.pendingGeometryBytes, prepared.geometryBytes, options.maxPendingGeometryBytes);
|
|
45
|
+
check(owner.pendingColorBytes, storage.colorBytes + storage.effectBytes, 134217728);
|
|
46
|
+
if (canonicalBytes + sourceCopy > pagesAtOnce)
|
|
47
|
+
fail('budget');
|
|
48
|
+
check(owner.pendingCanonicalBytes, canonicalBytes + sourceCopy, pagesAtOnce);
|
|
49
|
+
if (!Number.isSafeInteger(owner.serial) || owner.serial < 0 || owner.serial >= Number.MAX_SAFE_INTEGER)
|
|
50
|
+
fail('serial');
|
|
51
|
+
}
|
|
52
|
+
/** Only current READY identities authorize omitted whole-page copies. */
|
|
53
|
+
export function materializeSharedPages2D(storage, cold, owner, diagnostics) {
|
|
54
|
+
let canonicalBytes = 0, sourceCopy = 0;
|
|
55
|
+
for (const index of cold) {
|
|
56
|
+
const bytes = storage.projectionPlan.views[index].byteLength;
|
|
57
|
+
canonicalBytes += bytes;
|
|
58
|
+
sourceCopy = Math.max(sourceCopy, bytes);
|
|
59
|
+
}
|
|
60
|
+
checkSharedCapacity2D(storage, owner, canonicalBytes, sourceCopy);
|
|
61
|
+
const before = diagnostics?.canonicalBytes;
|
|
62
|
+
try {
|
|
63
|
+
const projections = storage.projectionPlan.views.map((view, index) => cold.has(index) ? copySharedPagePixels(view.image, diagnostics) : undefined);
|
|
64
|
+
return { projections, canonicalBytes };
|
|
65
|
+
}
|
|
66
|
+
catch (cause) {
|
|
67
|
+
// No returned projection array owns the earlier completed copies on this exit.
|
|
68
|
+
if (diagnostics)
|
|
69
|
+
diagnostics.canonicalBytes = before;
|
|
70
|
+
throw cause;
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
//# sourceMappingURL=sharedSubmissionStorage2D.js.map
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import type { PackedSharedDraw2D } from '../rendering/packSharedDraws2D.js';
|
|
2
|
+
export interface SharedWebGL2ArenaStrides {
|
|
3
|
+
readonly sharedStride: number;
|
|
4
|
+
}
|
|
5
|
+
interface SharedRange {
|
|
6
|
+
readonly draw: PackedSharedDraw2D;
|
|
7
|
+
readonly vertexOffset: number;
|
|
8
|
+
readonly firstVertex: number;
|
|
9
|
+
readonly uniformOffset: number;
|
|
10
|
+
readonly uniformSize: 128;
|
|
11
|
+
}
|
|
12
|
+
/** The region table of one record: its own uniform buffer, one window after another, each at an aligned offset. */
|
|
13
|
+
export interface SharedWebGL2RegionTable {
|
|
14
|
+
readonly bytes: number;
|
|
15
|
+
readonly stride: number;
|
|
16
|
+
/** The rows of each window, to be written at `offset`. */
|
|
17
|
+
readonly windows: readonly {
|
|
18
|
+
readonly offset: number;
|
|
19
|
+
readonly data: Uint32Array<ArrayBuffer>;
|
|
20
|
+
}[];
|
|
21
|
+
}
|
|
22
|
+
export interface SharedWebGL2ArenaPlan {
|
|
23
|
+
readonly vertexBytes: number;
|
|
24
|
+
readonly uniformBytes: number;
|
|
25
|
+
readonly sharedRanges: readonly SharedRange[];
|
|
26
|
+
/** Present when a draw of the record has a region. Not part of `uniformBytes`. */
|
|
27
|
+
readonly regionTable: SharedWebGL2RegionTable | undefined;
|
|
28
|
+
}
|
|
29
|
+
export interface SharedWebGL2ArenaOwner {
|
|
30
|
+
readonly pendingVertexArenaBytes: number;
|
|
31
|
+
readonly pendingUniformArenaBytes: number;
|
|
32
|
+
}
|
|
33
|
+
/** Actual GL alignment is finite but need not be a power of two. */
|
|
34
|
+
export declare function qualifySharedWebGL2Alignment(alignment: number): SharedWebGL2ArenaStrides;
|
|
35
|
+
/** Plan only native addresses; existing private payload arrays remain their original owners. */
|
|
36
|
+
export declare function planSharedWebGL2Arenas(draws: readonly PackedSharedDraw2D[], alignment: number, regions?: Uint32Array<ArrayBuffer>): SharedWebGL2ArenaPlan;
|
|
37
|
+
/** Pure check: Host repeats it with current counters immediately before owner/serial commit. */
|
|
38
|
+
export declare function checkSharedWebGL2ArenaCapacity(plan: SharedWebGL2ArenaPlan, owner: SharedWebGL2ArenaOwner): void;
|
|
39
|
+
export {};
|
|
40
|
+
//# sourceMappingURL=sharedWebGL2Arena.d.ts.map
|