@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,481 @@
|
|
|
1
|
+
import { noteOwnedPreparationFailure } from './ownedPreparationFailure2D.js';
|
|
2
|
+
import { orient2d } from 'robust-predicates';
|
|
3
|
+
function tryReplayPreparedStage2D(budget, cost) {
|
|
4
|
+
if (!Number.isSafeInteger(cost.preparedVertices) ||
|
|
5
|
+
cost.preparedVertices < 0 ||
|
|
6
|
+
!Number.isSafeInteger(cost.predicates) ||
|
|
7
|
+
cost.predicates < 0 ||
|
|
8
|
+
!Number.isSafeInteger(cost.tupleComparisons) ||
|
|
9
|
+
cost.tupleComparisons < 0)
|
|
10
|
+
return false;
|
|
11
|
+
return budget === undefined || budget.tryReplayStageCost?.(cost) === true;
|
|
12
|
+
}
|
|
13
|
+
const clearClipEntries = Map.prototype.clear;
|
|
14
|
+
/** Drop all clip references before packing, including on an original preparation failure. */
|
|
15
|
+
export function clearClipRectangleContext2D(context) {
|
|
16
|
+
if (context === undefined)
|
|
17
|
+
return;
|
|
18
|
+
context.active = false;
|
|
19
|
+
const entries = context.entries;
|
|
20
|
+
context.entries = undefined;
|
|
21
|
+
if (entries !== undefined)
|
|
22
|
+
clearClipEntries.call(entries);
|
|
23
|
+
}
|
|
24
|
+
/** Adapter-owned mapping keeps these numeric errors private to preparation. */
|
|
25
|
+
export class GeometryPreparationError extends Error {
|
|
26
|
+
reason;
|
|
27
|
+
constructor(reason, cause = undefined) {
|
|
28
|
+
super(`Geometry preparation ${reason}`, { cause });
|
|
29
|
+
this.reason = reason;
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
const MINIMUM = 2 ** -100, MAXIMUM = 2 ** 20;
|
|
33
|
+
export const POLYGON_LIMIT = 1024;
|
|
34
|
+
function fail(reason) {
|
|
35
|
+
throw noteOwnedPreparationFailure(new GeometryPreparationError(reason));
|
|
36
|
+
}
|
|
37
|
+
export function coordinate(value) {
|
|
38
|
+
if (!Number.isFinite(value) || Math.abs(value) > MAXIMUM)
|
|
39
|
+
fail('range');
|
|
40
|
+
// A magnitude below 2^-100 pixels is nothing at any scale a frame is drawn at. It comes from a transform that
|
|
41
|
+
// is all but the identity, such as a shake that has died away or a turn of a millionth of a degree. It is
|
|
42
|
+
// taken as zero rather than refused, so the exact predicates never meet a number that small.
|
|
43
|
+
return Math.abs(value) < MINIMUM ? 0 : value;
|
|
44
|
+
}
|
|
45
|
+
export function same(a, b) {
|
|
46
|
+
return a.x === b.x && a.y === b.y;
|
|
47
|
+
}
|
|
48
|
+
export function before(a, b) {
|
|
49
|
+
return a.x < b.x || (a.x === b.x && a.y < b.y);
|
|
50
|
+
}
|
|
51
|
+
function between(a, b, c) {
|
|
52
|
+
return (b.x >= Math.min(a.x, c.x) && b.x <= Math.max(a.x, c.x) && b.y >= Math.min(a.y, c.y) && b.y <= Math.max(a.y, c.y));
|
|
53
|
+
}
|
|
54
|
+
/** Preserve the checked affine operation order without temporary corner-pair arrays. */
|
|
55
|
+
function appendCorner(points, m, x, y, ratio) {
|
|
56
|
+
const px = coordinate(coordinate(coordinate(m.a * x) + coordinate(m.c * y)) + m.tx);
|
|
57
|
+
const py = coordinate(coordinate(coordinate(m.b * x) + coordinate(m.d * y)) + m.ty);
|
|
58
|
+
points.push({ x: coordinate(px * ratio), y: coordinate(py * ratio) });
|
|
59
|
+
}
|
|
60
|
+
export class Preparation {
|
|
61
|
+
options;
|
|
62
|
+
budget;
|
|
63
|
+
containedClipping;
|
|
64
|
+
edgeTests = 0;
|
|
65
|
+
reuseContainedSubjects;
|
|
66
|
+
constructor(options, budget, containedClipping = false, clipContext) {
|
|
67
|
+
this.options = options;
|
|
68
|
+
this.budget = budget;
|
|
69
|
+
this.containedClipping = containedClipping;
|
|
70
|
+
// Dispatcher subjects are independently owned before clipping, so no
|
|
71
|
+
// unchanged step needs to replace the array or its point objects.
|
|
72
|
+
this.reuseContainedSubjects =
|
|
73
|
+
containedClipping && budget !== undefined && clipContext?.options === options && clipContext.budget === budget;
|
|
74
|
+
}
|
|
75
|
+
determinant(a, b, c) {
|
|
76
|
+
if (this.edgeTests >= this.options.maxClipEdgeTests)
|
|
77
|
+
fail('budget');
|
|
78
|
+
this.budget?.admitPredicate();
|
|
79
|
+
this.edgeTests++;
|
|
80
|
+
const value = orient2d(a.x, a.y, b.x, b.y, c.x, c.y);
|
|
81
|
+
if (!Number.isFinite(value))
|
|
82
|
+
fail('precision');
|
|
83
|
+
return value;
|
|
84
|
+
}
|
|
85
|
+
/** Intersect only already qualified canonical clip bounds, with the viewport last. */
|
|
86
|
+
containedClipStackBounds(clips, viewport) {
|
|
87
|
+
if (!this.reuseContainedSubjects || clips.length < 2)
|
|
88
|
+
return undefined;
|
|
89
|
+
let left = -Infinity, top = -Infinity, right = Infinity, bottom = Infinity;
|
|
90
|
+
for (let index = 0; index <= clips.length; index++) {
|
|
91
|
+
const clip = index === clips.length ? viewport : clips[index];
|
|
92
|
+
if (clip.length !== 4)
|
|
93
|
+
return undefined;
|
|
94
|
+
const first = clip[0], second = clip[1], third = clip[2], fourth = clip[3];
|
|
95
|
+
const x = first.x, y = first.y, endX = second.x, endY = third.y;
|
|
96
|
+
if (!Number.isFinite(x) ||
|
|
97
|
+
!Number.isFinite(y) ||
|
|
98
|
+
!Number.isFinite(endX) ||
|
|
99
|
+
!Number.isFinite(endY) ||
|
|
100
|
+
!(x < endX) ||
|
|
101
|
+
!(y < endY) ||
|
|
102
|
+
second.y !== y ||
|
|
103
|
+
third.x !== endX ||
|
|
104
|
+
fourth.x !== x ||
|
|
105
|
+
fourth.y !== endY)
|
|
106
|
+
return undefined;
|
|
107
|
+
left = Math.max(left, x);
|
|
108
|
+
top = Math.max(top, y);
|
|
109
|
+
right = Math.min(right, endX);
|
|
110
|
+
bottom = Math.min(bottom, endY);
|
|
111
|
+
}
|
|
112
|
+
return { left, top, right, bottom, count: clips.length + 1 };
|
|
113
|
+
}
|
|
114
|
+
/** Charge a wholly contained stack at once without merging any actual cuts. */
|
|
115
|
+
tryContainedClipStack(subject, bounds, normalization) {
|
|
116
|
+
if (!this.reuseContainedSubjects || bounds === undefined)
|
|
117
|
+
return false;
|
|
118
|
+
const count = subject.length;
|
|
119
|
+
if (count < 3 || count > (normalization === 'mesh' ? 64 : POLYGON_LIMIT))
|
|
120
|
+
return false;
|
|
121
|
+
for (const point of subject) {
|
|
122
|
+
if (!(point.x >= bounds.left && point.x <= bounds.right && point.y >= bounds.top && point.y <= bounds.bottom))
|
|
123
|
+
return false;
|
|
124
|
+
}
|
|
125
|
+
const predicates = (normalization === 'rectangle' ? 12 : 8) * count * bounds.count;
|
|
126
|
+
const tuples = normalization === 'mesh' ? 2 * count * (count + 1) * bounds.count : 0;
|
|
127
|
+
// An atomic refusal leaves the ordered per-clip traversal to report and
|
|
128
|
+
// charge the same first failure. A successful replay cannot cut a point.
|
|
129
|
+
if (predicates > this.options.maxClipEdgeTests - this.edgeTests ||
|
|
130
|
+
!tryReplayPreparedStage2D(this.budget, { preparedVertices: 0, predicates, tupleComparisons: tuples }))
|
|
131
|
+
return false;
|
|
132
|
+
this.edgeTests += predicates;
|
|
133
|
+
return true;
|
|
134
|
+
}
|
|
135
|
+
/** Only the ordinary TEXTURED Host enables this for its own normalized polygons and ledger. */
|
|
136
|
+
tryContainedClip(subject, clip, normalization) {
|
|
137
|
+
// Default/direct helpers and missing atomic ledgers retain every original
|
|
138
|
+
// predicate callback. An omitted budget is not authority to replay work.
|
|
139
|
+
if (!this.containedClipping || this.budget === undefined || typeof this.budget.tryReplayStageCost !== 'function')
|
|
140
|
+
return undefined;
|
|
141
|
+
const count = subject.length;
|
|
142
|
+
if (count < 3 || count > (normalization === 'mesh' ? 64 : POLYGON_LIMIT) || clip.length !== 4)
|
|
143
|
+
return undefined;
|
|
144
|
+
const first = clip[0], second = clip[1], third = clip[2], fourth = clip[3];
|
|
145
|
+
const left = first.x, top = first.y, right = second.x, bottom = third.y;
|
|
146
|
+
// Keep the narrow canonical positive-winding rectangle; no bounding-box
|
|
147
|
+
// substitution, epsilon or changed crossing arithmetic is permitted.
|
|
148
|
+
if (!Number.isFinite(left) ||
|
|
149
|
+
!Number.isFinite(top) ||
|
|
150
|
+
!Number.isFinite(right) ||
|
|
151
|
+
!Number.isFinite(bottom) ||
|
|
152
|
+
!(left < right) ||
|
|
153
|
+
!(top < bottom) ||
|
|
154
|
+
second.y !== top ||
|
|
155
|
+
third.x !== right ||
|
|
156
|
+
fourth.x !== left ||
|
|
157
|
+
fourth.y !== bottom)
|
|
158
|
+
return undefined;
|
|
159
|
+
for (const point of subject)
|
|
160
|
+
if (!(point.x >= left && point.x <= right && point.y >= top && point.y <= bottom))
|
|
161
|
+
return undefined;
|
|
162
|
+
// A successful first-party normalization is stable. Every contained edge
|
|
163
|
+
// originally classifies n points, then normalizes the identical sequence.
|
|
164
|
+
// Rectangles retain both the collinear scan and winding cost; image/Mesh
|
|
165
|
+
// retain attributed collinear corners. Mesh additionally charges all XY pairs.
|
|
166
|
+
const predicates = (normalization === 'rectangle' ? 12 : 8) * count;
|
|
167
|
+
const tuples = normalization === 'mesh' ? 2 * count * (count + 1) : 0;
|
|
168
|
+
if (predicates > this.options.maxClipEdgeTests - this.edgeTests)
|
|
169
|
+
return undefined;
|
|
170
|
+
if (!tryReplayPreparedStage2D(this.budget, { preparedVertices: 0, predicates, tupleComparisons: tuples }))
|
|
171
|
+
return undefined;
|
|
172
|
+
// Admission is all-or-nothing. A miss leaves local/global counts untouched
|
|
173
|
+
// so the original interleaved traversal still decides its first failure.
|
|
174
|
+
this.edgeTests += predicates;
|
|
175
|
+
if (this.reuseContainedSubjects)
|
|
176
|
+
return subject;
|
|
177
|
+
// Direct helpers still give callers an independently owned container.
|
|
178
|
+
return normalization === 'mesh' ? subject.map(point => ({ ...point })) : subject.slice();
|
|
179
|
+
}
|
|
180
|
+
/** Known first-party normalization may skip one unchanged canonical half-plane. */
|
|
181
|
+
tryContainedEdge(subject, clip, edge, normalization) {
|
|
182
|
+
// A normalization kind alone grants no callback-skipping authority.
|
|
183
|
+
if (!this.containedClipping || this.budget === undefined || typeof this.budget.tryReplayStageCost !== 'function')
|
|
184
|
+
return undefined;
|
|
185
|
+
const count = subject.length;
|
|
186
|
+
if (count < 3 ||
|
|
187
|
+
count > (normalization === 'mesh' ? 64 : POLYGON_LIMIT) ||
|
|
188
|
+
clip.length !== 4 ||
|
|
189
|
+
!Number.isInteger(edge) ||
|
|
190
|
+
edge < 0 ||
|
|
191
|
+
edge > 3)
|
|
192
|
+
return undefined;
|
|
193
|
+
const first = clip[0], second = clip[1], third = clip[2], fourth = clip[3];
|
|
194
|
+
const left = first.x, top = first.y, right = second.x, bottom = third.y;
|
|
195
|
+
if (!Number.isFinite(left) ||
|
|
196
|
+
!Number.isFinite(top) ||
|
|
197
|
+
!Number.isFinite(right) ||
|
|
198
|
+
!Number.isFinite(bottom) ||
|
|
199
|
+
!(left < right) ||
|
|
200
|
+
!(top < bottom) ||
|
|
201
|
+
second.y !== top ||
|
|
202
|
+
third.x !== right ||
|
|
203
|
+
fourth.x !== left ||
|
|
204
|
+
fourth.y !== bottom)
|
|
205
|
+
return undefined;
|
|
206
|
+
for (const point of subject) {
|
|
207
|
+
const inside = edge === 0 ? point.y >= top : edge === 1 ? point.x <= right : edge === 2 ? point.y <= bottom : point.x >= left;
|
|
208
|
+
if (!inside)
|
|
209
|
+
return undefined;
|
|
210
|
+
}
|
|
211
|
+
// Use the current edge's n: a preceding real cut may have changed it.
|
|
212
|
+
// No crossing occurs; the already stable normalization keeps this sequence.
|
|
213
|
+
const predicates = (normalization === 'rectangle' ? 3 : 2) * count;
|
|
214
|
+
const tuples = normalization === 'mesh' ? (count * (count + 1)) / 2 : 0;
|
|
215
|
+
if (predicates > this.options.maxClipEdgeTests - this.edgeTests)
|
|
216
|
+
return undefined;
|
|
217
|
+
if (!tryReplayPreparedStage2D(this.budget, { preparedVertices: 0, predicates, tupleComparisons: tuples }))
|
|
218
|
+
return undefined;
|
|
219
|
+
// An atomic miss leaves the original edge's interleaved first refusal intact.
|
|
220
|
+
this.edgeTests += predicates;
|
|
221
|
+
if (this.reuseContainedSubjects)
|
|
222
|
+
return subject;
|
|
223
|
+
return normalization === 'mesh' ? subject.map(point => ({ ...point })) : subject.slice();
|
|
224
|
+
}
|
|
225
|
+
/** Use exact comparisons for the classification stage of an owned axis edge. */
|
|
226
|
+
classifyOwnedAxisEdge(subject, a, b) {
|
|
227
|
+
if (!this.reuseContainedSubjects)
|
|
228
|
+
return undefined;
|
|
229
|
+
const vertical = a.x === b.x, horizontal = a.y === b.y;
|
|
230
|
+
if (vertical === horizontal)
|
|
231
|
+
return undefined;
|
|
232
|
+
const predicates = subject.length;
|
|
233
|
+
// A refusal keeps the original point-by-point debit and first error.
|
|
234
|
+
if (predicates > this.options.maxClipEdgeTests - this.edgeTests ||
|
|
235
|
+
!tryReplayPreparedStage2D(this.budget, { preparedVertices: 0, predicates, tupleComparisons: 0 }))
|
|
236
|
+
return undefined;
|
|
237
|
+
this.edgeTests += predicates;
|
|
238
|
+
const boundary = vertical ? a.x : a.y;
|
|
239
|
+
const higherSign = (vertical ? b.y < a.y : b.x > a.x) ? 1 : -1;
|
|
240
|
+
const signs = new Array(predicates);
|
|
241
|
+
let retained = false;
|
|
242
|
+
for (let index = 0; index < predicates; index++) {
|
|
243
|
+
// Prepared coordinates are finite and bounded by 2**20; viewport
|
|
244
|
+
// dimensions can reach uint32. For a nonzero axis extent, the
|
|
245
|
+
// perpendicular comparison is exact, including either zero.
|
|
246
|
+
const point = subject[index], position = vertical ? point.x : point.y;
|
|
247
|
+
const sign = position < boundary ? -higherSign : position > boundary ? higherSign : 0;
|
|
248
|
+
signs[index] = sign;
|
|
249
|
+
if (sign >= 0)
|
|
250
|
+
retained = true;
|
|
251
|
+
}
|
|
252
|
+
// All-strictly-outside has no crossing or normalization work to charge.
|
|
253
|
+
if (!retained)
|
|
254
|
+
signs.length = 0;
|
|
255
|
+
return signs;
|
|
256
|
+
}
|
|
257
|
+
sign(a, b, c) {
|
|
258
|
+
// The dependency uses the opposite sign to the conventional algebraic cross product.
|
|
259
|
+
return -Math.sign(this.determinant(a, b, c));
|
|
260
|
+
}
|
|
261
|
+
normalize(input) {
|
|
262
|
+
if (input.length > POLYGON_LIMIT)
|
|
263
|
+
fail('budget');
|
|
264
|
+
const points = [];
|
|
265
|
+
for (const point of input)
|
|
266
|
+
if (!points.length || !same(points[points.length - 1], point))
|
|
267
|
+
points.push(point);
|
|
268
|
+
if (points.length > 1 && same(points[0], points[points.length - 1]))
|
|
269
|
+
points.pop();
|
|
270
|
+
for (let i = 0; i < points.length; i++)
|
|
271
|
+
for (let j = i + 1; j < points.length; j++)
|
|
272
|
+
if (same(points[i], points[j]))
|
|
273
|
+
fail('precision');
|
|
274
|
+
if (points.length < 3)
|
|
275
|
+
return [];
|
|
276
|
+
// Remove only exact collinear middle points, never merely thin or nearly parallel turns.
|
|
277
|
+
let changed = true;
|
|
278
|
+
while (changed && points.length >= 3) {
|
|
279
|
+
changed = false;
|
|
280
|
+
for (let i = 0; i < points.length; i++) {
|
|
281
|
+
const a = points[(i + points.length - 1) % points.length], b = points[i], c = points[(i + 1) % points.length];
|
|
282
|
+
if (this.sign(a, b, c) === 0 && between(a, b, c)) {
|
|
283
|
+
points.splice(i, 1);
|
|
284
|
+
changed = true;
|
|
285
|
+
break;
|
|
286
|
+
}
|
|
287
|
+
}
|
|
288
|
+
}
|
|
289
|
+
if (points.length < 3)
|
|
290
|
+
return [];
|
|
291
|
+
return finishPolygonWinding2D(this, points);
|
|
292
|
+
}
|
|
293
|
+
corners(input) {
|
|
294
|
+
const { matrix: m, rect: r } = input, ratio = coordinate(this.options.pixelRatio);
|
|
295
|
+
// Capture the original array-literal reads before any value validation.
|
|
296
|
+
const a = m.a, b = m.b, c = m.c, d = m.d, tx = m.tx, ty = m.ty, x = r.x, y = r.y, width = r.width, height = r.height;
|
|
297
|
+
coordinate(a);
|
|
298
|
+
coordinate(b);
|
|
299
|
+
coordinate(c);
|
|
300
|
+
coordinate(d);
|
|
301
|
+
coordinate(tx);
|
|
302
|
+
coordinate(ty);
|
|
303
|
+
coordinate(x);
|
|
304
|
+
coordinate(y);
|
|
305
|
+
coordinate(width);
|
|
306
|
+
coordinate(height);
|
|
307
|
+
const right = coordinate(r.x + r.width), bottom = coordinate(r.y + r.height);
|
|
308
|
+
const points = [];
|
|
309
|
+
// All pair-literal getters originally ran before the first point arithmetic.
|
|
310
|
+
const firstX = r.x, firstY = r.y, secondY = r.y, fourthX = r.x;
|
|
311
|
+
appendCorner(points, m, firstX, firstY, ratio);
|
|
312
|
+
appendCorner(points, m, right, secondY, ratio);
|
|
313
|
+
appendCorner(points, m, right, bottom, ratio);
|
|
314
|
+
appendCorner(points, m, fourthX, bottom, ratio);
|
|
315
|
+
// Singular matrices must not acquire fabricated area from rounded corner arithmetic.
|
|
316
|
+
const determinant = this.sign({ x: 0, y: 0 }, { x: m.a, y: m.b }, { x: m.c, y: m.d });
|
|
317
|
+
if (r.width === 0 || r.height === 0 || determinant === 0)
|
|
318
|
+
return [];
|
|
319
|
+
return points;
|
|
320
|
+
}
|
|
321
|
+
rectangle(input) {
|
|
322
|
+
const points = this.corners(input);
|
|
323
|
+
return points.length ? this.normalize(points) : [];
|
|
324
|
+
}
|
|
325
|
+
/** Reuse only successful first-party clip rectangles, never the subject or viewport. */
|
|
326
|
+
clipRectangle(input, context) {
|
|
327
|
+
if (!this.containedClipping ||
|
|
328
|
+
context === undefined ||
|
|
329
|
+
!context.active ||
|
|
330
|
+
context.options !== this.options ||
|
|
331
|
+
this.budget === undefined ||
|
|
332
|
+
context.budget !== this.budget ||
|
|
333
|
+
context.entries === undefined)
|
|
334
|
+
return this.rectangle(input);
|
|
335
|
+
const entries = context.entries, cached = entries.get(input);
|
|
336
|
+
if (cached !== undefined) {
|
|
337
|
+
// A failed aggregate admission changes neither ledger. The original
|
|
338
|
+
// ordered rectangle operation must decide the first refusal and debit.
|
|
339
|
+
if (cached.predicates <= this.options.maxClipEdgeTests - this.edgeTests &&
|
|
340
|
+
tryReplayPreparedStage2D(this.budget, {
|
|
341
|
+
preparedVertices: 0,
|
|
342
|
+
predicates: cached.predicates,
|
|
343
|
+
tupleComparisons: 0
|
|
344
|
+
})) {
|
|
345
|
+
this.edgeTests += cached.predicates;
|
|
346
|
+
return cached.polygon;
|
|
347
|
+
}
|
|
348
|
+
return this.rectangle(input);
|
|
349
|
+
}
|
|
350
|
+
const previousPredicates = this.edgeTests;
|
|
351
|
+
// Required geometry work stays outside every optional-allocation catch.
|
|
352
|
+
const polygon = this.rectangle(input);
|
|
353
|
+
if (entries.size < 64 && polygon.length <= 4) {
|
|
354
|
+
try {
|
|
355
|
+
// Own a separate read-only copy; the original miss result may
|
|
356
|
+
// escape a private helper without changing later cached values.
|
|
357
|
+
const copy = Object.freeze(polygon.map(point => Object.freeze({ x: point.x, y: point.y })));
|
|
358
|
+
entries.set(input, { polygon: copy, predicates: this.edgeTests - previousPredicates });
|
|
359
|
+
}
|
|
360
|
+
catch {
|
|
361
|
+
// Map insertion and copying are optional. Never swallow a
|
|
362
|
+
// rectangle/predicate failure or retain a partially inserted row.
|
|
363
|
+
clearClipRectangleContext2D(context);
|
|
364
|
+
}
|
|
365
|
+
}
|
|
366
|
+
return polygon;
|
|
367
|
+
}
|
|
368
|
+
crossing(a, b, first, second, attach, policy) {
|
|
369
|
+
const p = (policy === undefined ? before(first, second) : policy.before(first, second)) ? first : second, q = p === first ? second : first;
|
|
370
|
+
const u = Math.abs(this.determinant(a, b, p)), v = Math.abs(this.determinant(a, b, q));
|
|
371
|
+
const sum = u + v, t = u / sum;
|
|
372
|
+
if (!(u > 0) || !(v > 0) || !Number.isFinite(sum) || !Number.isFinite(t))
|
|
373
|
+
fail('precision');
|
|
374
|
+
let x, y, weight = t, complementary = false;
|
|
375
|
+
if (t > 0 && t < 1) {
|
|
376
|
+
// Preserve the operation order and bits of strict-interior crossings.
|
|
377
|
+
x = coordinate(p.x + t * (q.x - p.x));
|
|
378
|
+
y = coordinate(p.y + t * (q.y - p.y));
|
|
379
|
+
}
|
|
380
|
+
else if (t === 1) {
|
|
381
|
+
// Compute the small complementary weight directly; 1-t loses it.
|
|
382
|
+
const s = v / sum;
|
|
383
|
+
if (!Number.isFinite(s) || !(s > 0 && s <= 0.5))
|
|
384
|
+
fail('precision');
|
|
385
|
+
x = coordinate(q.x + s * (p.x - q.x));
|
|
386
|
+
y = coordinate(q.y + s * (p.y - q.y));
|
|
387
|
+
weight = s;
|
|
388
|
+
complementary = true;
|
|
389
|
+
}
|
|
390
|
+
else
|
|
391
|
+
fail('precision');
|
|
392
|
+
if (x < Math.min(p.x, q.x) || x > Math.max(p.x, q.x) || y < Math.min(p.y, q.y) || y > Math.max(p.y, q.y))
|
|
393
|
+
fail('precision');
|
|
394
|
+
return attach(p, q, weight, complementary, x, y);
|
|
395
|
+
}
|
|
396
|
+
intersect(subject, clip, normalized = false) {
|
|
397
|
+
// Generic callers may supply unnormalized points; only the real producer opts in.
|
|
398
|
+
return clipPolygon2D(this, subject, clip, normalizeRectangle, attachRectangle, undefined, normalized ? 'rectangle' : undefined);
|
|
399
|
+
}
|
|
400
|
+
}
|
|
401
|
+
/** Policy wrappers keep their collinear/duplicate rules; this finish preserves sign order and full points. */
|
|
402
|
+
export function finishPolygonWinding2D(preparation, points) {
|
|
403
|
+
let winding = 0;
|
|
404
|
+
for (let i = 0; i < points.length; i++) {
|
|
405
|
+
const sign = preparation.sign(points[i], points[(i + 1) % points.length], points[(i + 2) % points.length]);
|
|
406
|
+
if (sign !== 0) {
|
|
407
|
+
if (winding !== 0 && winding !== sign)
|
|
408
|
+
fail('precision');
|
|
409
|
+
winding = sign;
|
|
410
|
+
}
|
|
411
|
+
}
|
|
412
|
+
if (winding === 0)
|
|
413
|
+
return [];
|
|
414
|
+
if (winding < 0)
|
|
415
|
+
points.reverse();
|
|
416
|
+
return points;
|
|
417
|
+
}
|
|
418
|
+
const normalizeRectangle = (preparation, input) => preparation.normalize(input);
|
|
419
|
+
// Plain rectangle corners retain exactly their original two-field shape.
|
|
420
|
+
const attachRectangle = (_p, _q, _weight, _complementary, x, y) => ({ x, y });
|
|
421
|
+
/** Shared traversal preserves determinant order; callers own attribute normalization. */
|
|
422
|
+
export function clipPolygon2D(preparation, subject, clip, normalize, attach, policy, normalization) {
|
|
423
|
+
if (!clip.length)
|
|
424
|
+
return [];
|
|
425
|
+
for (let edge = 0; edge < clip.length && subject.length; edge++) {
|
|
426
|
+
// Only known first-party call sites mark their successful normalization.
|
|
427
|
+
// Preparation independently requires the existing trusted clipping selection.
|
|
428
|
+
if (normalization !== undefined) {
|
|
429
|
+
const contained = preparation.tryContainedEdge(subject, clip, edge, normalization);
|
|
430
|
+
if (contained !== undefined) {
|
|
431
|
+
subject = contained;
|
|
432
|
+
continue;
|
|
433
|
+
}
|
|
434
|
+
}
|
|
435
|
+
const a = clip[edge], b = clip[(edge + 1) % clip.length];
|
|
436
|
+
const classified = normalization === undefined ? undefined : preparation.classifyOwnedAxisEdge(subject, a, b);
|
|
437
|
+
if (classified?.length === 0)
|
|
438
|
+
return [];
|
|
439
|
+
const signs = classified ?? subject.map(point => preparation.sign(a, b, point));
|
|
440
|
+
const output = [];
|
|
441
|
+
const cache = [];
|
|
442
|
+
const append = (point) => {
|
|
443
|
+
if (policy === undefined) {
|
|
444
|
+
if (output.length >= POLYGON_LIMIT)
|
|
445
|
+
fail('budget');
|
|
446
|
+
}
|
|
447
|
+
else
|
|
448
|
+
policy.assertAppend(output.length);
|
|
449
|
+
output.push(point);
|
|
450
|
+
};
|
|
451
|
+
for (let i = 0; i < subject.length; i++) {
|
|
452
|
+
const p = subject[i], j = (i + 1) % subject.length, q = subject[j];
|
|
453
|
+
const ps = signs[i], qs = signs[j];
|
|
454
|
+
if (ps >= 0)
|
|
455
|
+
append(p);
|
|
456
|
+
if ((ps < 0 && qs > 0) || (ps > 0 && qs < 0)) {
|
|
457
|
+
const left = (policy === undefined ? before(p, q) : policy.before(p, q)) ? p : q, right = left === p ? q : p;
|
|
458
|
+
let hit;
|
|
459
|
+
if (policy === undefined)
|
|
460
|
+
hit = cache.find(item => same(item.p, left) && same(item.q, right));
|
|
461
|
+
else {
|
|
462
|
+
// Each attempted endpoint pair is admitted before any tuple read.
|
|
463
|
+
for (const item of cache) {
|
|
464
|
+
if (policy.sameTuple(item.p, left) && policy.sameTuple(item.q, right)) {
|
|
465
|
+
hit = item;
|
|
466
|
+
break;
|
|
467
|
+
}
|
|
468
|
+
}
|
|
469
|
+
}
|
|
470
|
+
if (!hit) {
|
|
471
|
+
hit = { p: left, q: right, point: preparation.crossing(a, b, left, right, attach, policy) };
|
|
472
|
+
cache.push(hit);
|
|
473
|
+
}
|
|
474
|
+
append(hit.point);
|
|
475
|
+
}
|
|
476
|
+
}
|
|
477
|
+
subject = normalize(preparation, output);
|
|
478
|
+
}
|
|
479
|
+
return subject;
|
|
480
|
+
}
|
|
481
|
+
//# sourceMappingURL=prepareRectangles2D.js.map
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
import type { PreparedEffects2D } from './sharedEffects2D.js';
|
|
2
|
+
import type { SharedRenderFrame2D, SharedRenderCommand2D, SharedMaterial2D, SharedRegion2D } from '@egret/contracts';
|
|
3
|
+
import { TexturedPreparationBudget2D } from './texturedPreparationBudget2D.js';
|
|
4
|
+
import type { TexturedPreparationLimits2D } from './texturedPreparationBudget2D.js';
|
|
5
|
+
import type { RetainedSharedDraw2D, SharedPreparationRetention2D } from './sharedPreparationRetention2D.js';
|
|
6
|
+
export declare class SharedPreparationError extends Error {
|
|
7
|
+
readonly reason: 'frame' | 'profile' | 'precision' | 'budget';
|
|
8
|
+
constructor(reason: 'frame' | 'profile' | 'precision' | 'budget');
|
|
9
|
+
}
|
|
10
|
+
export declare function sharedFailure(reason: SharedPreparationError['reason']): never;
|
|
11
|
+
export interface SharedPoint2D {
|
|
12
|
+
readonly x: number;
|
|
13
|
+
readonly y: number;
|
|
14
|
+
readonly u: number;
|
|
15
|
+
readonly v: number;
|
|
16
|
+
readonly r: number;
|
|
17
|
+
readonly g: number;
|
|
18
|
+
readonly b: number;
|
|
19
|
+
readonly a: number;
|
|
20
|
+
readonly dr: number;
|
|
21
|
+
readonly dg: number;
|
|
22
|
+
readonly db: number;
|
|
23
|
+
}
|
|
24
|
+
export type SharedDrawCommand2D = Exclude<SharedRenderCommand2D, {
|
|
25
|
+
kind: 'barrier';
|
|
26
|
+
}>;
|
|
27
|
+
export interface PreparedSharedDraw2D {
|
|
28
|
+
readonly kind: 'draw';
|
|
29
|
+
readonly command: SharedDrawCommand2D;
|
|
30
|
+
readonly material: SharedMaterial2D;
|
|
31
|
+
readonly region: SharedRegion2D | undefined;
|
|
32
|
+
readonly pageIndex: number | undefined;
|
|
33
|
+
readonly polygons: readonly (readonly SharedPoint2D[])[];
|
|
34
|
+
readonly vertexReservation: number;
|
|
35
|
+
}
|
|
36
|
+
export interface PreparedSharedBarrier2D {
|
|
37
|
+
readonly kind: 'barrier';
|
|
38
|
+
readonly ordinal: number;
|
|
39
|
+
readonly occurrenceId: number;
|
|
40
|
+
}
|
|
41
|
+
export type PreparedSharedEntry2D = PreparedSharedDraw2D | PreparedSharedBarrier2D;
|
|
42
|
+
/** What one shared frame may hold at most, whatever a Host is configured to admit. */
|
|
43
|
+
export declare const SHARED_FRAME_REGIONS_2D = 4096, SHARED_FRAME_PAGE_BYTES_2D = 67108864;
|
|
44
|
+
/** A Host option may lower the two frame ceilings; an absent one leaves the profile's own. */
|
|
45
|
+
export interface SharedPreparationOptions2D extends TexturedPreparationLimits2D {
|
|
46
|
+
readonly enableEffects?: boolean;
|
|
47
|
+
readonly pixelRatio: number;
|
|
48
|
+
readonly maxCommands: number;
|
|
49
|
+
readonly maxClipRectangles: number;
|
|
50
|
+
readonly maxFrameGeometryBytes: number;
|
|
51
|
+
readonly maxFrameRegions?: number;
|
|
52
|
+
readonly maxFramePageBytes?: number;
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* `retention` is the Host's kept draws, when the frame was prepared with them, and `retained` names for each
|
|
56
|
+
* entry the kept draw that packing may take its rows from or give them to.
|
|
57
|
+
*/
|
|
58
|
+
export interface PreparedSharedFrame2D {
|
|
59
|
+
readonly effects: PreparedEffects2D;
|
|
60
|
+
readonly frame: SharedRenderFrame2D;
|
|
61
|
+
readonly width: number;
|
|
62
|
+
readonly height: number;
|
|
63
|
+
readonly entries: readonly PreparedSharedEntry2D[];
|
|
64
|
+
readonly budget: TexturedPreparationBudget2D;
|
|
65
|
+
readonly geometryBytes: number;
|
|
66
|
+
readonly pageBytes: number;
|
|
67
|
+
readonly upload: number;
|
|
68
|
+
readonly retention?: SharedPreparationRetention2D;
|
|
69
|
+
readonly retained?: readonly (RetainedSharedDraw2D | undefined)[];
|
|
70
|
+
}
|
|
71
|
+
/** What address qualification reads of a draw: the same for each of its corners, so it is found once a draw. */
|
|
72
|
+
export interface SharedUVDomain2D {
|
|
73
|
+
readonly width: number;
|
|
74
|
+
readonly height: number;
|
|
75
|
+
readonly limit: number;
|
|
76
|
+
}
|
|
77
|
+
/** Undefined for a draw without a page, whose corners are not qualified. */
|
|
78
|
+
export declare function sharedUVDomain(draw: Pick<PreparedSharedDraw2D, 'region' | 'material' | 'pageIndex'>, frame: SharedRenderFrame2D): SharedUVDomain2D | undefined;
|
|
79
|
+
/** Check one corner using the resolved draw domain and f32 preparation without clamping or wrapping authored UVs. */
|
|
80
|
+
export declare function qualifySharedUVIn(pointU: number, pointV: number, domain: SharedUVDomain2D): void;
|
|
81
|
+
/**
|
|
82
|
+
* Authentic completion is checked by Host; this helper still defends all table references. With `retention`,
|
|
83
|
+
* a draw whose every input is the same as in the last frame takes the geometry kept for it, once the charges
|
|
84
|
+
* recorded with that geometry fit what is left of the budget; any other draw is prepared here and kept.
|
|
85
|
+
* The frame's tables, every command's own numbers and every frame-wide charge are checked for every frame.
|
|
86
|
+
*/
|
|
87
|
+
export declare function prepareSharedDraws2D(frame: SharedRenderFrame2D, width: number, height: number, options: SharedPreparationOptions2D, retention?: SharedPreparationRetention2D): PreparedSharedFrame2D;
|
|
88
|
+
//# sourceMappingURL=prepareSharedDraws2D.d.ts.map
|