@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,266 @@
|
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
import { EgretError } from '@egret/runtime';
|
|
3
|
+
import { createHoverInput } from '@egret/engine/input/hover';
|
|
4
|
+
const ownedSurfaces = new WeakSet();
|
|
5
|
+
const units = ['pixel', 'line', 'page'];
|
|
6
|
+
const finite = (value) => typeof value === 'number' && Number.isFinite(value);
|
|
7
|
+
const same = (a, b) => a.left === b.left && a.top === b.top && a.width === b.width && a.height === b.height;
|
|
8
|
+
/**
|
|
9
|
+
* Hover and wheel of the page for the canvas of a started Engine, in the same connected,
|
|
10
|
+
* untransformed profile as the pointer adapter. It captures no pointer and sets no style, so it
|
|
11
|
+
* shares the canvas with that adapter.
|
|
12
|
+
*/
|
|
13
|
+
export function createBrowserHoverInput(options) {
|
|
14
|
+
if (options === null || typeof options !== 'object' || Array.isArray(options))
|
|
15
|
+
throw new EgretError('HOVER_INPUT_OPTIONS_INVALID');
|
|
16
|
+
const { canvas: surface, wheelPage = 'unconsumed', onError, ...configuration } = options;
|
|
17
|
+
if ((wheelPage !== 'unconsumed' && wheelPage !== 'never' && wheelPage !== 'always') ||
|
|
18
|
+
(onError !== undefined && typeof onError !== 'function') ||
|
|
19
|
+
surface === null ||
|
|
20
|
+
typeof surface !== 'object')
|
|
21
|
+
throw new EgretError('HOVER_INPUT_OPTIONS_INVALID');
|
|
22
|
+
const input = createHoverInput(configuration);
|
|
23
|
+
const pairs = [];
|
|
24
|
+
let closed = false, owned;
|
|
25
|
+
/** A failure has nowhere to return to from a listener of the page. */
|
|
26
|
+
function report(cause) {
|
|
27
|
+
if (onError !== undefined)
|
|
28
|
+
onError(cause);
|
|
29
|
+
else if (typeof globalThis.reportError === 'function')
|
|
30
|
+
globalThis.reportError(cause);
|
|
31
|
+
}
|
|
32
|
+
function cleanup() {
|
|
33
|
+
if (closed)
|
|
34
|
+
return;
|
|
35
|
+
closed = true;
|
|
36
|
+
const failures = [];
|
|
37
|
+
for (const pair of pairs.splice(0).reverse())
|
|
38
|
+
try {
|
|
39
|
+
pair.target.removeEventListener(pair.type, pair.listener, pair.options);
|
|
40
|
+
}
|
|
41
|
+
catch (cause) {
|
|
42
|
+
failures.push(cause);
|
|
43
|
+
}
|
|
44
|
+
if (owned !== undefined) {
|
|
45
|
+
ownedSurfaces.delete(owned);
|
|
46
|
+
owned = undefined;
|
|
47
|
+
}
|
|
48
|
+
for (const cause of failures)
|
|
49
|
+
report(cause);
|
|
50
|
+
}
|
|
51
|
+
try {
|
|
52
|
+
input.onClose(cleanup);
|
|
53
|
+
const win = globalThis.window, page = globalThis.document;
|
|
54
|
+
if (win === undefined || page === undefined || typeof win.getComputedStyle !== 'function')
|
|
55
|
+
throw new EgretError('HOVER_INPUT_SURFACE_INVALID');
|
|
56
|
+
const { width, height } = input;
|
|
57
|
+
/** The rectangle of the canvas on the page, refused unless one scale and one offset map it. */
|
|
58
|
+
function profile() {
|
|
59
|
+
if (typeof surface?.getBoundingClientRect !== 'function' ||
|
|
60
|
+
surface.ownerDocument !== page ||
|
|
61
|
+
surface.isConnected !== true)
|
|
62
|
+
throw new EgretError('HOVER_INPUT_SURFACE_INVALID');
|
|
63
|
+
let current = surface, depth = 0;
|
|
64
|
+
// Ordinary ancestors only: a turn, a skew, a mirror or a zoom would need a mapping this adapter does not have.
|
|
65
|
+
while (current !== page) {
|
|
66
|
+
if (current === null || current.nodeType !== 1 || ++depth > 64)
|
|
67
|
+
throw new EgretError('HOVER_INPUT_SURFACE_INVALID');
|
|
68
|
+
const style = win.getComputedStyle(current), read = (name) => style.getPropertyValue(name).trim();
|
|
69
|
+
// Moving and positive scaling keep the canvas an upright rectangle, which the bounding rectangle maps as it is.
|
|
70
|
+
const matrix = /^matrix\(([^)]*)\)$/.exec(read('transform'))?.[1]?.split(',').map(Number), scale = read('scale');
|
|
71
|
+
if ((read('transform') !== 'none' &&
|
|
72
|
+
!(matrix !== undefined &&
|
|
73
|
+
matrix.length === 6 &&
|
|
74
|
+
matrix.every(Number.isFinite) &&
|
|
75
|
+
matrix[0] > 0 &&
|
|
76
|
+
matrix[3] > 0 &&
|
|
77
|
+
matrix[1] === 0 &&
|
|
78
|
+
matrix[2] === 0)) ||
|
|
79
|
+
read('rotate') !== 'none' ||
|
|
80
|
+
read('perspective') !== 'none' ||
|
|
81
|
+
(scale !== 'none' && !scale.split(/\s+/).every(part => Number(part) > 0)))
|
|
82
|
+
throw new EgretError('HOVER_INPUT_SURFACE_INVALID', {
|
|
83
|
+
cause: new Error('the canvas or an element around it is rotated, skewed, mirrored or in perspective')
|
|
84
|
+
});
|
|
85
|
+
const zoom = read('zoom');
|
|
86
|
+
if (zoom !== 'normal' && zoom !== '1')
|
|
87
|
+
throw new EgretError('HOVER_INPUT_SURFACE_INVALID');
|
|
88
|
+
if (current === surface) {
|
|
89
|
+
const edges = [
|
|
90
|
+
'padding-top',
|
|
91
|
+
'padding-right',
|
|
92
|
+
'padding-bottom',
|
|
93
|
+
'padding-left',
|
|
94
|
+
'border-top-width',
|
|
95
|
+
'border-right-width',
|
|
96
|
+
'border-bottom-width',
|
|
97
|
+
'border-left-width'
|
|
98
|
+
];
|
|
99
|
+
if (read('object-fit') !== 'fill' ||
|
|
100
|
+
edges.some(name => {
|
|
101
|
+
const value = read(name);
|
|
102
|
+
return value !== '0px' && value !== '0';
|
|
103
|
+
}))
|
|
104
|
+
throw new EgretError('HOVER_INPUT_SURFACE_INVALID');
|
|
105
|
+
}
|
|
106
|
+
current = current.parentNode;
|
|
107
|
+
}
|
|
108
|
+
return measure();
|
|
109
|
+
}
|
|
110
|
+
function measure() {
|
|
111
|
+
const { left, top, width: wide, height: high } = surface.getBoundingClientRect();
|
|
112
|
+
if (!finite(left) || !finite(top) || !finite(wide) || !finite(high) || wide <= 0 || high <= 0)
|
|
113
|
+
throw new EgretError('HOVER_INPUT_SURFACE_INVALID');
|
|
114
|
+
return { left, top, width: wide, height: high };
|
|
115
|
+
}
|
|
116
|
+
let bounds = profile();
|
|
117
|
+
if (ownedSurfaces.has(surface))
|
|
118
|
+
throw new EgretError('HOVER_INPUT_SURFACE_BUSY');
|
|
119
|
+
ownedSurfaces.add(surface);
|
|
120
|
+
owned = surface;
|
|
121
|
+
function fail(cause) {
|
|
122
|
+
cleanup();
|
|
123
|
+
const failures = [cause];
|
|
124
|
+
try {
|
|
125
|
+
input.dispose();
|
|
126
|
+
}
|
|
127
|
+
catch (secondary) {
|
|
128
|
+
failures.push(secondary);
|
|
129
|
+
}
|
|
130
|
+
for (const failure of failures)
|
|
131
|
+
report(failure);
|
|
132
|
+
}
|
|
133
|
+
function guard(action) {
|
|
134
|
+
if (closed)
|
|
135
|
+
return;
|
|
136
|
+
try {
|
|
137
|
+
action();
|
|
138
|
+
}
|
|
139
|
+
catch (cause) {
|
|
140
|
+
// One pointer too many is told and the others go on hovering.
|
|
141
|
+
if (cause instanceof EgretError && cause.code === 'HOVER_INPUT_CAPACITY')
|
|
142
|
+
report(cause);
|
|
143
|
+
else
|
|
144
|
+
fail(cause);
|
|
145
|
+
}
|
|
146
|
+
}
|
|
147
|
+
/** What is hovered is told under the old mapping; the next movement uses the new one. */
|
|
148
|
+
function remap() {
|
|
149
|
+
const next = profile();
|
|
150
|
+
if (input.state !== 'closed')
|
|
151
|
+
input.setViewportRevision(input.viewportRevision + 1);
|
|
152
|
+
bounds = next;
|
|
153
|
+
}
|
|
154
|
+
function current() {
|
|
155
|
+
// A layout change without a resize or a scroll shows as a rectangle that moved.
|
|
156
|
+
if (!same(bounds, measure()))
|
|
157
|
+
remap();
|
|
158
|
+
return bounds;
|
|
159
|
+
}
|
|
160
|
+
let observed = 0;
|
|
161
|
+
// The platform orders its events; a clock that steps back is not passed on as a refused sample.
|
|
162
|
+
const time = (event) => (observed = Math.max(observed, finite(event.timeStamp) && event.timeStamp > 0 ? event.timeStamp : 0));
|
|
163
|
+
function place(event) {
|
|
164
|
+
const rect = current();
|
|
165
|
+
if (!finite(event.clientX) || !finite(event.clientY))
|
|
166
|
+
throw new EgretError('HOVER_INPUT_EVENT_INVALID');
|
|
167
|
+
const globalX = ((event.clientX - rect.left) * width) / rect.width, globalY = ((event.clientY - rect.top) * height) / rect.height;
|
|
168
|
+
return globalX >= 0 && globalY >= 0 && globalX < width && globalY < height ? { globalX, globalY } : undefined;
|
|
169
|
+
}
|
|
170
|
+
function identify(event) {
|
|
171
|
+
const { pointerId, pointerType } = event;
|
|
172
|
+
return Number.isSafeInteger(pointerId) && pointerId >= 0 && (pointerType === 'mouse' || pointerType === 'pen')
|
|
173
|
+
? { pointerId, pointerType }
|
|
174
|
+
: undefined;
|
|
175
|
+
}
|
|
176
|
+
function hover(event) {
|
|
177
|
+
const identity = identify(event);
|
|
178
|
+
if (identity === undefined || input.state !== 'active')
|
|
179
|
+
return;
|
|
180
|
+
// A pressed pointer belongs to the contact that began with the press.
|
|
181
|
+
if (event.buttons !== 0) {
|
|
182
|
+
input.leave(identity.pointerId, 'contact');
|
|
183
|
+
return;
|
|
184
|
+
}
|
|
185
|
+
const point = page.visibilityState === 'visible' ? place(event) : undefined;
|
|
186
|
+
// A captured pointer is still reported after it has left the canvas.
|
|
187
|
+
if (point === undefined) {
|
|
188
|
+
input.leave(identity.pointerId, 'outside');
|
|
189
|
+
return;
|
|
190
|
+
}
|
|
191
|
+
input.sample({ ...identity, ...point, timestamp: time(event) });
|
|
192
|
+
}
|
|
193
|
+
function leave(event, reason) {
|
|
194
|
+
const identity = identify(event);
|
|
195
|
+
if (identity !== undefined && input.state !== 'closed')
|
|
196
|
+
input.leave(identity.pointerId, reason);
|
|
197
|
+
}
|
|
198
|
+
function wheel(event) {
|
|
199
|
+
const point = input.state === 'active' ? place(event) : undefined;
|
|
200
|
+
let consumed = false;
|
|
201
|
+
if (point !== undefined) {
|
|
202
|
+
const unit = units[event.deltaMode];
|
|
203
|
+
if (unit === undefined || !finite(event.deltaX) || !finite(event.deltaY) || !finite(event.deltaZ))
|
|
204
|
+
throw new EgretError('HOVER_INPUT_EVENT_INVALID');
|
|
205
|
+
consumed = input.wheel({
|
|
206
|
+
...point,
|
|
207
|
+
deltaX: event.deltaX,
|
|
208
|
+
deltaY: event.deltaY,
|
|
209
|
+
deltaZ: event.deltaZ,
|
|
210
|
+
unit,
|
|
211
|
+
timestamp: time(event),
|
|
212
|
+
zoom: event.ctrlKey === true
|
|
213
|
+
});
|
|
214
|
+
}
|
|
215
|
+
if ((wheelPage === 'never' || (wheelPage === 'unconsumed' && consumed)) && event.cancelable)
|
|
216
|
+
event.preventDefault();
|
|
217
|
+
}
|
|
218
|
+
function listen(target, type, action, settings = {}) {
|
|
219
|
+
const listener = event => guard(() => {
|
|
220
|
+
if (event.type === type)
|
|
221
|
+
action(event);
|
|
222
|
+
});
|
|
223
|
+
const pair = { target, type, listener, options: settings };
|
|
224
|
+
pairs.push(pair);
|
|
225
|
+
target.addEventListener(type, listener, settings);
|
|
226
|
+
}
|
|
227
|
+
listen(surface, 'pointermove', event => hover(event));
|
|
228
|
+
listen(surface, 'pointerup', event => hover(event));
|
|
229
|
+
listen(surface, 'pointerdown', event => leave(event, 'contact'));
|
|
230
|
+
listen(surface, 'pointerleave', event => leave(event, 'outside'));
|
|
231
|
+
listen(surface, 'pointercancel', event => leave(event, 'pointercancel'));
|
|
232
|
+
// A passive listener lets the page scroll without waiting for this one. It cannot hold the page.
|
|
233
|
+
listen(surface, 'wheel', event => wheel(event), { passive: wheelPage === 'always' });
|
|
234
|
+
listen(win, 'blur', () => input.leaveAll('blur'));
|
|
235
|
+
listen(win, 'pagehide', () => input.leaveAll('pagehide'));
|
|
236
|
+
listen(page, 'visibilitychange', () => {
|
|
237
|
+
if (page.visibilityState !== 'visible')
|
|
238
|
+
input.leaveAll('hidden');
|
|
239
|
+
});
|
|
240
|
+
listen(win, 'resize', remap);
|
|
241
|
+
listen(win, 'orientationchange', remap);
|
|
242
|
+
listen(win, 'scroll', remap, { capture: true });
|
|
243
|
+
const viewport = win.visualViewport;
|
|
244
|
+
if (viewport !== null && viewport !== undefined) {
|
|
245
|
+
listen(viewport, 'resize', remap);
|
|
246
|
+
listen(viewport, 'scroll', remap);
|
|
247
|
+
}
|
|
248
|
+
// Resuming is the application's to do, once its rendering host is ready again.
|
|
249
|
+
listen(surface, 'webglcontextlost', () => input.setInteractive(false));
|
|
250
|
+
return input;
|
|
251
|
+
}
|
|
252
|
+
catch (cause) {
|
|
253
|
+
cleanup();
|
|
254
|
+
const cleanupErrors = [];
|
|
255
|
+
try {
|
|
256
|
+
input.dispose();
|
|
257
|
+
}
|
|
258
|
+
catch (secondary) {
|
|
259
|
+
cleanupErrors.push(secondary);
|
|
260
|
+
}
|
|
261
|
+
if (cause instanceof EgretError && cause.code === 'HOVER_INPUT_SURFACE_BUSY' && cleanupErrors.length === 0)
|
|
262
|
+
throw cause;
|
|
263
|
+
throw new EgretError('HOVER_INPUT_SURFACE_INVALID', { cause, cleanupErrors });
|
|
264
|
+
}
|
|
265
|
+
}
|
|
266
|
+
//# sourceMappingURL=BrowserHoverInput.js.map
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
import type { AssetLoadContext, AssetProvider, AssetRef, Texture } from '@egret/runtime';
|
|
2
|
+
/** What `textureFromCanvas` and `decodeBrowserImage` can read pixels from. */
|
|
3
|
+
export type BrowserImageSource = HTMLCanvasElement | OffscreenCanvas | HTMLImageElement | ImageBitmap | {
|
|
4
|
+
readonly width: number;
|
|
5
|
+
readonly height: number;
|
|
6
|
+
};
|
|
7
|
+
/** The picture formats the browser route recognises by their first bytes. */
|
|
8
|
+
export type BrowserImageFormat = 'png' | 'jpeg' | 'webp' | 'gif' | 'avif';
|
|
9
|
+
export interface BrowserImagePorts {
|
|
10
|
+
/** A fresh canvas of the given size with a 2D context that can be read back. */
|
|
11
|
+
readonly createCanvas: (width: number, height: number) => BrowserImageCanvas;
|
|
12
|
+
/** Decodes encoded bytes into something a 2D context can draw. */
|
|
13
|
+
readonly decode: (bytes: Uint8Array<ArrayBuffer>, type: string) => Promise<BrowserDecodedImage>;
|
|
14
|
+
}
|
|
15
|
+
export interface BrowserImageCanvas {
|
|
16
|
+
width: number;
|
|
17
|
+
height: number;
|
|
18
|
+
getContext(kind: '2d', options?: {
|
|
19
|
+
willReadFrequently?: boolean;
|
|
20
|
+
}): BrowserImageContext | null;
|
|
21
|
+
}
|
|
22
|
+
export interface BrowserImageContext {
|
|
23
|
+
drawImage(source: unknown, x: number, y: number, width: number, height: number): void;
|
|
24
|
+
getImageData(x: number, y: number, width: number, height: number): {
|
|
25
|
+
readonly data: Uint8ClampedArray;
|
|
26
|
+
};
|
|
27
|
+
}
|
|
28
|
+
export interface BrowserDecodedImage {
|
|
29
|
+
readonly source: unknown;
|
|
30
|
+
readonly width: number;
|
|
31
|
+
readonly height: number;
|
|
32
|
+
/** Frees what decoding held; called once the pixels are read. */
|
|
33
|
+
readonly release?: () => void;
|
|
34
|
+
}
|
|
35
|
+
export interface BrowserImageOptions {
|
|
36
|
+
/** Largest area kept, in pixels; larger pictures are scaled down. At most the 2D image limit. */
|
|
37
|
+
readonly maxPixels?: number;
|
|
38
|
+
/** Longest edge kept, in pixels. At most the 2D image limit. */
|
|
39
|
+
readonly maxEdge?: number;
|
|
40
|
+
/** Replaces the browser operations, for tests or other hosts. */
|
|
41
|
+
readonly ports?: BrowserImagePorts;
|
|
42
|
+
}
|
|
43
|
+
export interface BrowserImageTextureProviderOptions extends BrowserImageOptions {
|
|
44
|
+
/** Reads the encoded bytes a reference names. */
|
|
45
|
+
readonly readBytes: (ref: AssetRef<Texture>, context: AssetLoadContext) => Promise<Uint8Array<ArrayBuffer>>;
|
|
46
|
+
}
|
|
47
|
+
/** The picture format the bytes start with, or undefined when they start like none of them. */
|
|
48
|
+
export declare function sniffBrowserImageFormat(bytes: Uint8Array): BrowserImageFormat | undefined;
|
|
49
|
+
/** The size a picture is read at: its own, or scaled down evenly to fit both limits. */
|
|
50
|
+
export declare function fitBrowserImageSize(width: number, height: number, options?: Pick<BrowserImageOptions, 'maxPixels' | 'maxEdge'>): {
|
|
51
|
+
width: number;
|
|
52
|
+
height: number;
|
|
53
|
+
};
|
|
54
|
+
/**
|
|
55
|
+
* Reads a canvas, image or bitmap as a texture of straight RGBA bytes, scaled down when it is larger than
|
|
56
|
+
* the limits. The source is not changed.
|
|
57
|
+
*/
|
|
58
|
+
export declare function textureFromCanvas(source: BrowserImageSource, options?: BrowserImageOptions): Texture;
|
|
59
|
+
/** Decodes PNG, JPEG, WebP, GIF or AVIF bytes with the browser and returns a texture of them. */
|
|
60
|
+
export declare function decodeBrowserImage(bytes: Uint8Array<ArrayBuffer>, options?: BrowserImageOptions): Promise<Texture>;
|
|
61
|
+
/**
|
|
62
|
+
* An asset provider that reads bytes with `readBytes` and decodes them with the browser. Register it for a
|
|
63
|
+
* texture asset type; disposing a texture releases it.
|
|
64
|
+
*/
|
|
65
|
+
export declare function createBrowserImageTextureProvider(options: BrowserImageTextureProviderOptions): AssetProvider<Texture>;
|
|
66
|
+
//# sourceMappingURL=BrowserImageTextures.d.ts.map
|
|
@@ -0,0 +1,169 @@
|
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
// Textures from pictures the way every browser can make them: PNG, JPEG, WebP,
|
|
3
|
+
// GIF or AVIF bytes are decoded by the browser itself, drawn onto a canvas and
|
|
4
|
+
// read back as straight RGBA bytes. A canvas the game painted becomes a texture
|
|
5
|
+
// the same way. This is the forgiving route: it accepts what the browser can
|
|
6
|
+
// show, and it scales a picture down to the 2D image limits instead of refusing
|
|
7
|
+
// it. `createBrowserTextureProvider` remains the strict PNG route for manifests
|
|
8
|
+
// that pin exact bytes.
|
|
9
|
+
import { createImageData2D, IMAGE_LIMITS_2D } from '@egret/contracts';
|
|
10
|
+
import { createTexture, EgretError } from '@egret/runtime';
|
|
11
|
+
const MIME = {
|
|
12
|
+
png: 'image/png',
|
|
13
|
+
jpeg: 'image/jpeg',
|
|
14
|
+
webp: 'image/webp',
|
|
15
|
+
gif: 'image/gif',
|
|
16
|
+
avif: 'image/avif'
|
|
17
|
+
};
|
|
18
|
+
/** The picture format the bytes start with, or undefined when they start like none of them. */
|
|
19
|
+
export function sniffBrowserImageFormat(bytes) {
|
|
20
|
+
const at = (i) => bytes[i] ?? -1;
|
|
21
|
+
const ascii = (i, text) => [...text].every((c, k) => at(i + k) === c.charCodeAt(0));
|
|
22
|
+
if (at(0) === 0x89 && ascii(1, 'PNG'))
|
|
23
|
+
return 'png';
|
|
24
|
+
if (at(0) === 0xff && at(1) === 0xd8 && at(2) === 0xff)
|
|
25
|
+
return 'jpeg';
|
|
26
|
+
if (ascii(0, 'RIFF') && ascii(8, 'WEBP'))
|
|
27
|
+
return 'webp';
|
|
28
|
+
if (ascii(0, 'GIF8'))
|
|
29
|
+
return 'gif';
|
|
30
|
+
if (ascii(4, 'ftyp') && (ascii(8, 'avif') || ascii(8, 'avis')))
|
|
31
|
+
return 'avif';
|
|
32
|
+
return undefined;
|
|
33
|
+
}
|
|
34
|
+
function fail(code, cause) {
|
|
35
|
+
throw new EgretError(code, { cause });
|
|
36
|
+
}
|
|
37
|
+
/** The size a picture is read at: its own, or scaled down evenly to fit both limits. */
|
|
38
|
+
export function fitBrowserImageSize(width, height, options = {}) {
|
|
39
|
+
if (!(width >= 1 && height >= 1) || !Number.isFinite(width) || !Number.isFinite(height))
|
|
40
|
+
fail('BROWSER_IMAGE_SIZE_INVALID', new RangeError(`${width} x ${height}`));
|
|
41
|
+
const maxPixels = Math.min(options.maxPixels ?? Infinity, IMAGE_LIMITS_2D.maxSourcePixels);
|
|
42
|
+
const maxEdge = Math.min(options.maxEdge ?? Infinity, IMAGE_LIMITS_2D.maxSourceEdge);
|
|
43
|
+
if (!(maxPixels >= 1) || !(maxEdge >= 1))
|
|
44
|
+
fail('BROWSER_IMAGE_SIZE_INVALID', new RangeError('limits'));
|
|
45
|
+
const scale = Math.min(1, Math.sqrt(maxPixels / (width * height)), maxEdge / Math.max(width, height));
|
|
46
|
+
let w = Math.max(1, Math.floor(width * scale)), h = Math.max(1, Math.floor(height * scale));
|
|
47
|
+
// Rounding can leave the area a pixel row over; take it off the longer side.
|
|
48
|
+
while (w * h > maxPixels)
|
|
49
|
+
w >= h ? w-- : h--;
|
|
50
|
+
return { width: Math.min(w, maxEdge), height: Math.min(h, maxEdge) };
|
|
51
|
+
}
|
|
52
|
+
function browserPorts() {
|
|
53
|
+
const doc = globalThis.document;
|
|
54
|
+
const createCanvas = (width, height) => {
|
|
55
|
+
let canvas;
|
|
56
|
+
if (typeof OffscreenCanvas === 'function')
|
|
57
|
+
canvas = new OffscreenCanvas(width, height);
|
|
58
|
+
else if (doc)
|
|
59
|
+
canvas = doc.createElement('canvas');
|
|
60
|
+
else
|
|
61
|
+
fail('BROWSER_IMAGE_UNAVAILABLE', new TypeError('No canvas'));
|
|
62
|
+
canvas.width = width;
|
|
63
|
+
canvas.height = height;
|
|
64
|
+
return canvas;
|
|
65
|
+
};
|
|
66
|
+
const decode = async (bytes, type) => {
|
|
67
|
+
const blob = new Blob([bytes], { type });
|
|
68
|
+
// createImageBitmap with no options is the call every current browser gives; where it is missing or
|
|
69
|
+
// refuses the picture, an image element decodes it.
|
|
70
|
+
if (typeof createImageBitmap === 'function') {
|
|
71
|
+
try {
|
|
72
|
+
const bitmap = await createImageBitmap(blob);
|
|
73
|
+
return { source: bitmap, width: bitmap.width, height: bitmap.height, release: () => bitmap.close() };
|
|
74
|
+
}
|
|
75
|
+
catch {
|
|
76
|
+
/* fall through to the image element */
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
if (!doc || typeof URL?.createObjectURL !== 'function')
|
|
80
|
+
fail('BROWSER_IMAGE_UNAVAILABLE', new TypeError('No image decoder'));
|
|
81
|
+
const address = URL.createObjectURL(blob);
|
|
82
|
+
try {
|
|
83
|
+
const image = doc.createElement('img');
|
|
84
|
+
image.src = address;
|
|
85
|
+
await image.decode();
|
|
86
|
+
return { source: image, width: image.naturalWidth, height: image.naturalHeight };
|
|
87
|
+
}
|
|
88
|
+
finally {
|
|
89
|
+
URL.revokeObjectURL(address);
|
|
90
|
+
}
|
|
91
|
+
};
|
|
92
|
+
return { createCanvas, decode };
|
|
93
|
+
}
|
|
94
|
+
function sizeOf(source) {
|
|
95
|
+
const s = source;
|
|
96
|
+
return { width: s.naturalWidth || s.width, height: s.naturalHeight || s.height };
|
|
97
|
+
}
|
|
98
|
+
// Draws `drawable` at the fitted size and reads the pixels back.
|
|
99
|
+
function readPixels(drawable, sourceWidth, sourceHeight, options, ports) {
|
|
100
|
+
const { width, height } = fitBrowserImageSize(sourceWidth, sourceHeight, options);
|
|
101
|
+
const canvas = ports.createCanvas(width, height);
|
|
102
|
+
try {
|
|
103
|
+
const pen = canvas.getContext('2d', { willReadFrequently: true });
|
|
104
|
+
if (!pen)
|
|
105
|
+
fail('BROWSER_IMAGE_UNAVAILABLE', new TypeError('No 2D context'));
|
|
106
|
+
pen.drawImage(drawable, 0, 0, width, height);
|
|
107
|
+
const data = pen.getImageData(0, 0, width, height).data;
|
|
108
|
+
const pixels = new Uint8Array(data.byteLength);
|
|
109
|
+
pixels.set(data);
|
|
110
|
+
return createTexture(createImageData2D({ width, height, pixels }));
|
|
111
|
+
}
|
|
112
|
+
finally {
|
|
113
|
+
// An empty canvas gives its memory back at once.
|
|
114
|
+
canvas.width = canvas.height = 0;
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
/**
|
|
118
|
+
* Reads a canvas, image or bitmap as a texture of straight RGBA bytes, scaled down when it is larger than
|
|
119
|
+
* the limits. The source is not changed.
|
|
120
|
+
*/
|
|
121
|
+
export function textureFromCanvas(source, options = {}) {
|
|
122
|
+
const size = sizeOf(source);
|
|
123
|
+
return readPixels(source, size.width, size.height, options, options.ports ?? browserPorts());
|
|
124
|
+
}
|
|
125
|
+
/** Decodes PNG, JPEG, WebP, GIF or AVIF bytes with the browser and returns a texture of them. */
|
|
126
|
+
export async function decodeBrowserImage(bytes, options = {}) {
|
|
127
|
+
if (!(bytes instanceof Uint8Array) || bytes.byteLength === 0)
|
|
128
|
+
fail('BROWSER_IMAGE_BYTES_INVALID', new TypeError('bytes'));
|
|
129
|
+
const format = sniffBrowserImageFormat(bytes);
|
|
130
|
+
if (!format)
|
|
131
|
+
fail('BROWSER_IMAGE_FORMAT_UNKNOWN', new TypeError('Not PNG, JPEG, WebP, GIF or AVIF'));
|
|
132
|
+
const ports = options.ports ?? browserPorts();
|
|
133
|
+
let decoded;
|
|
134
|
+
try {
|
|
135
|
+
decoded = await ports.decode(bytes, MIME[format]);
|
|
136
|
+
}
|
|
137
|
+
catch (cause) {
|
|
138
|
+
if (cause instanceof EgretError)
|
|
139
|
+
throw cause;
|
|
140
|
+
fail('BROWSER_IMAGE_DECODE_FAILED', cause);
|
|
141
|
+
}
|
|
142
|
+
try {
|
|
143
|
+
return readPixels(decoded.source, decoded.width, decoded.height, options, ports);
|
|
144
|
+
}
|
|
145
|
+
finally {
|
|
146
|
+
decoded.release?.();
|
|
147
|
+
}
|
|
148
|
+
}
|
|
149
|
+
/**
|
|
150
|
+
* An asset provider that reads bytes with `readBytes` and decodes them with the browser. Register it for a
|
|
151
|
+
* texture asset type; disposing a texture releases it.
|
|
152
|
+
*/
|
|
153
|
+
export function createBrowserImageTextureProvider(options) {
|
|
154
|
+
if (typeof options?.readBytes !== 'function')
|
|
155
|
+
fail('BROWSER_IMAGE_PROVIDER_INVALID', new TypeError('readBytes'));
|
|
156
|
+
const { readBytes, ...rest } = options;
|
|
157
|
+
return {
|
|
158
|
+
async load(ref, context) {
|
|
159
|
+
const bytes = await readBytes(ref, context);
|
|
160
|
+
if (context.signal?.aborted)
|
|
161
|
+
throw context.signal.reason;
|
|
162
|
+
return decodeBrowserImage(bytes, rest);
|
|
163
|
+
},
|
|
164
|
+
dispose(texture) {
|
|
165
|
+
texture.dispose();
|
|
166
|
+
}
|
|
167
|
+
};
|
|
168
|
+
}
|
|
169
|
+
//# sourceMappingURL=BrowserImageTextures.js.map
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
import type { InputActions } from '@egret/engine/kit';
|
|
2
|
+
export interface BrowserInputActionsOptions {
|
|
3
|
+
/** Where keys are listened for; the window by default. */
|
|
4
|
+
readonly keyTarget?: EventTarget;
|
|
5
|
+
/** Where mouse buttons are listened for, such as the canvas; none by default. */
|
|
6
|
+
readonly pointerTarget?: EventTarget;
|
|
7
|
+
/** Read connected gamepads on each `poll()`. On by default. */
|
|
8
|
+
readonly gamepads?: boolean;
|
|
9
|
+
/** Keep the page from acting on bound keys (scrolling on Space and the arrows). On by default. */
|
|
10
|
+
readonly preventDefault?: boolean;
|
|
11
|
+
/** Keys that are passed on even when bound, such as F5 or F12. */
|
|
12
|
+
readonly passKeys?: readonly string[];
|
|
13
|
+
}
|
|
14
|
+
export interface BrowserInputActions {
|
|
15
|
+
/** Reads the gamepads; call once a frame before the game reads its actions. */
|
|
16
|
+
poll(): void;
|
|
17
|
+
dispose(): void;
|
|
18
|
+
}
|
|
19
|
+
/** Listens to the page for the controls of `actions`. */
|
|
20
|
+
export declare function bindBrowserInputActions(actions: InputActions, options?: BrowserInputActionsOptions): BrowserInputActions;
|
|
21
|
+
export interface TouchStickOptions {
|
|
22
|
+
/** The binding the stick drives; `Touch:stick` by default. Put it in a vector action's `sticks`. */
|
|
23
|
+
readonly binding?: string;
|
|
24
|
+
/** Pixels from the centre to full tilt. Defaults to 56. */
|
|
25
|
+
readonly radius?: number;
|
|
26
|
+
/** Where a touch may start the stick: the left half of the element by default, or the whole of it. */
|
|
27
|
+
readonly zone?: 'left' | 'right' | 'all';
|
|
28
|
+
/** Class names of the base and the knob, which the stick creates inside the element. */
|
|
29
|
+
readonly className?: string;
|
|
30
|
+
}
|
|
31
|
+
export interface TouchControl {
|
|
32
|
+
/** The elements the control made, to style. */
|
|
33
|
+
readonly elements: readonly HTMLElement[];
|
|
34
|
+
dispose(): void;
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* A stick that appears where a finger lands in its zone of `element` and follows it. The element should cover
|
|
38
|
+
* the screen area the stick works in, with `touch-action: none`.
|
|
39
|
+
*/
|
|
40
|
+
export declare function createTouchStick(element: HTMLElement, actions: InputActions, options?: TouchStickOptions): TouchControl;
|
|
41
|
+
/** Makes `element` an on-screen button that holds `binding` (such as `Touch:jump`) while a finger is on it. */
|
|
42
|
+
export declare function createTouchButton(element: HTMLElement, actions: InputActions, binding: string): TouchControl;
|
|
43
|
+
/**
|
|
44
|
+
* The page's local storage as a save storage, or a memory stand-in where the page has none (a private window, a
|
|
45
|
+
* blocked site): every call is guarded, so a save never throws for want of storage.
|
|
46
|
+
*/
|
|
47
|
+
export declare function browserSaveStorage(): {
|
|
48
|
+
getItem(key: string): string | null;
|
|
49
|
+
setItem(key: string, value: string): void;
|
|
50
|
+
removeItem(key: string): void;
|
|
51
|
+
readonly persistent: boolean;
|
|
52
|
+
};
|
|
53
|
+
//# sourceMappingURL=BrowserInputActions.d.ts.map
|