@egret/engine 0.0.0-stage → 7.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +201 -0
- package/NOTICE +21 -0
- package/README.md +101 -2
- package/README.zh-CN.md +102 -0
- package/dist/Engine.d.ts +77 -0
- package/dist/Engine.js +469 -0
- package/dist/animation/index.d.ts +6 -0
- package/dist/animation/index.js +5 -0
- package/dist/animation/sequenceController.d.ts +22 -0
- package/dist/animation/sequenceController.js +618 -0
- package/dist/animation/sequenceCoordinator.d.ts +26 -0
- package/dist/animation/sequenceCoordinator.js +161 -0
- package/dist/animation/sequenceInput.d.ts +25 -0
- package/dist/animation/sequenceInput.js +108 -0
- package/dist/animation/sequenceMath.d.ts +35 -0
- package/dist/animation/sequenceMath.js +164 -0
- package/dist/animation/sequenceResetSlot.d.ts +7 -0
- package/dist/animation/sequenceResetSlot.js +367 -0
- package/dist/animation/sequenceResetTypes.d.ts +48 -0
- package/dist/animation/sequenceResetTypes.js +2 -0
- package/dist/animation/types.d.ts +75 -0
- package/dist/animation/types.js +2 -0
- package/dist/assetBundle.d.ts +54 -0
- package/dist/assetBundle.js +173 -0
- package/dist/assetGroup.d.ts +17 -0
- package/dist/assetGroup.js +332 -0
- package/dist/assetGroupTypes.d.ts +17 -0
- package/dist/assetGroupTypes.js +2 -0
- package/dist/audio.d.ts +4 -0
- package/dist/audio.js +4 -0
- package/dist/audioCues.d.ts +47 -0
- package/dist/audioCues.js +127 -0
- package/dist/audioMixer.d.ts +7 -0
- package/dist/audioMixer.js +785 -0
- package/dist/audioTypes.d.ts +246 -0
- package/dist/audioTypes.js +3 -0
- package/dist/bitmapBindingTicket.d.ts +24 -0
- package/dist/bitmapBindingTicket.js +215 -0
- package/dist/bitmapButton.d.ts +4 -0
- package/dist/bitmapButton.js +407 -0
- package/dist/bitmapButtonTypes.d.ts +31 -0
- package/dist/bitmapButtonTypes.js +2 -0
- package/dist/bitmapFontParse.d.ts +10 -0
- package/dist/bitmapFontParse.js +246 -0
- package/dist/bitmapFontTypes.d.ts +112 -0
- package/dist/bitmapFontTypes.js +2 -0
- package/dist/bitmapResourceSlot.d.ts +26 -0
- package/dist/bitmapResourceSlot.js +340 -0
- package/dist/bitmapText.d.ts +6 -0
- package/dist/bitmapText.js +320 -0
- package/dist/bitmapfont.d.ts +5 -0
- package/dist/bitmapfont.js +5 -0
- package/dist/camera.d.ts +4 -0
- package/dist/camera.js +4 -0
- package/dist/camera2d.d.ts +7 -0
- package/dist/camera2d.js +419 -0
- package/dist/cameraTypes.d.ts +126 -0
- package/dist/cameraTypes.js +2 -0
- package/dist/closeHost.d.ts +4 -0
- package/dist/closeHost.js +66 -0
- package/dist/contentArtifacts.d.ts +12 -0
- package/dist/contentArtifacts.js +153 -0
- package/dist/contentAtlasPages.d.ts +13 -0
- package/dist/contentAtlasPages.js +117 -0
- package/dist/contentLoader.d.ts +6 -0
- package/dist/contentLoader.js +327 -0
- package/dist/contentTypes.d.ts +35 -0
- package/dist/contentTypes.js +2 -0
- package/dist/createEngine.d.ts +7 -0
- package/dist/createEngine.js +25 -0
- package/dist/createEngineForProfile.d.ts +5 -0
- package/dist/createEngineForProfile.js +45 -0
- package/dist/displaySubtreeTicket.d.ts +25 -0
- package/dist/displaySubtreeTicket.js +76 -0
- package/dist/fontContentLoader.d.ts +6 -0
- package/dist/fontContentLoader.js +298 -0
- package/dist/fontContentTypes.d.ts +39 -0
- package/dist/fontContentTypes.js +2 -0
- package/dist/gameClock.d.ts +24 -0
- package/dist/gameClock.js +246 -0
- package/dist/gameClockTypes.d.ts +37 -0
- package/dist/gameClockTypes.js +2 -0
- package/dist/gameRun.d.ts +53 -0
- package/dist/gameRun.js +97 -0
- package/dist/gamepad.d.ts +5 -0
- package/dist/gamepad.js +5 -0
- package/dist/gamepadInput.d.ts +4 -0
- package/dist/gamepadInput.js +281 -0
- package/dist/gamepadKeys.d.ts +4 -0
- package/dist/gamepadKeys.js +205 -0
- package/dist/gamepadTypes.d.ts +142 -0
- package/dist/gamepadTypes.js +3 -0
- package/dist/hover.d.ts +4 -0
- package/dist/hover.js +4 -0
- package/dist/hoverInput.d.ts +8 -0
- package/dist/hoverInput.js +503 -0
- package/dist/hoverInputTypes.d.ts +129 -0
- package/dist/hoverInputTypes.js +2 -0
- package/dist/index.d.ts +52 -0
- package/dist/index.js +21 -0
- package/dist/input.d.ts +6 -0
- package/dist/input.js +5 -0
- package/dist/inputActions.d.ts +86 -0
- package/dist/inputActions.js +330 -0
- package/dist/internal/contentFactoryState.d.ts +19 -0
- package/dist/internal/contentFactoryState.js +42 -0
- package/dist/internal/mouseInputFactoryState.d.ts +57 -0
- package/dist/internal/mouseInputFactoryState.js +125 -0
- package/dist/internal/sequenceControllerFactoryState.d.ts +42 -0
- package/dist/internal/sequenceControllerFactoryState.js +98 -0
- package/dist/internal/textFieldFactoryState.d.ts +11 -0
- package/dist/internal/textFieldFactoryState.js +32 -0
- package/dist/internal/texturedFrameState.d.ts +4 -0
- package/dist/internal/texturedFrameState.js +12 -0
- package/dist/internal/uiFactoryState.d.ts +68 -0
- package/dist/internal/uiFactoryState.js +173 -0
- package/dist/internal/uiRootState.d.ts +67 -0
- package/dist/internal/uiRootState.js +103 -0
- package/dist/keyboardInput.d.ts +13 -0
- package/dist/keyboardInput.js +579 -0
- package/dist/keyboardInputTypes.d.ts +93 -0
- package/dist/keyboardInputTypes.js +2 -0
- package/dist/kit.d.ts +16 -0
- package/dist/kit.js +10 -0
- package/dist/layout.d.ts +5 -0
- package/dist/layout.js +132 -0
- package/dist/layoutTypes.d.ts +28 -0
- package/dist/layoutTypes.js +2 -0
- package/dist/manifestAssetGroup.d.ts +10 -0
- package/dist/manifestAssetGroup.js +477 -0
- package/dist/manifestResourceState.d.ts +17 -0
- package/dist/manifestResourceState.js +58 -0
- package/dist/manifestResourceTypes.d.ts +26 -0
- package/dist/manifestResourceTypes.js +2 -0
- package/dist/motion.d.ts +35 -0
- package/dist/motion.js +206 -0
- package/dist/mouseInput.d.ts +102 -0
- package/dist/mouseInput.js +562 -0
- package/dist/mouseInputTypes.d.ts +41 -0
- package/dist/mouseInputTypes.js +2 -0
- package/dist/paragraph.d.ts +8 -0
- package/dist/paragraph.js +7 -0
- package/dist/particleEmitter.d.ts +4 -0
- package/dist/particleEmitter.js +300 -0
- package/dist/particleTypes.d.ts +115 -0
- package/dist/particleTypes.js +2 -0
- package/dist/particles.d.ts +4 -0
- package/dist/particles.js +4 -0
- package/dist/physics2d.d.ts +4 -0
- package/dist/physics2d.js +4 -0
- package/dist/physics2dGeometry.d.ts +39 -0
- package/dist/physics2dGeometry.js +230 -0
- package/dist/physics2dTypes.d.ts +221 -0
- package/dist/physics2dTypes.js +2 -0
- package/dist/physics2dWorld.d.ts +4 -0
- package/dist/physics2dWorld.js +823 -0
- package/dist/pointerInput.d.ts +12 -0
- package/dist/pointerInput.js +300 -0
- package/dist/pointerInputTypes.d.ts +41 -0
- package/dist/pointerInputTypes.js +2 -0
- package/dist/random.d.ts +30 -0
- package/dist/random.js +131 -0
- package/dist/rendering/ownedPreparationFailure2D.d.ts +5 -0
- package/dist/rendering/ownedPreparationFailure2D.js +33 -0
- package/dist/rendering/packSharedDraws2D.d.ts +50 -0
- package/dist/rendering/packSharedDraws2D.js +379 -0
- package/dist/rendering/packedOrientation.d.ts +4 -0
- package/dist/rendering/packedOrientation.js +7 -0
- package/dist/rendering/prepareRectangles2D.d.ts +92 -0
- package/dist/rendering/prepareRectangles2D.js +481 -0
- package/dist/rendering/prepareSharedDraws2D.d.ts +90 -0
- package/dist/rendering/prepareSharedDraws2D.js +663 -0
- package/dist/rendering/preparedBatches2D.d.ts +17 -0
- package/dist/rendering/preparedBatches2D.js +30 -0
- package/dist/rendering/preparedSharedBatches2D.d.ts +44 -0
- package/dist/rendering/preparedSharedBatches2D.js +247 -0
- package/dist/rendering/sharedColor2D.d.ts +52 -0
- package/dist/rendering/sharedColor2D.js +191 -0
- package/dist/rendering/sharedEffects2D.d.ts +23 -0
- package/dist/rendering/sharedEffects2D.js +126 -0
- package/dist/rendering/sharedPreparationRetention2D.d.ts +120 -0
- package/dist/rendering/sharedPreparationRetention2D.js +357 -0
- package/dist/rendering/srgbBytes.d.ts +3 -0
- package/dist/rendering/srgbBytes.js +64 -0
- package/dist/rendering/texturedPreparationBudget2D.d.ts +31 -0
- package/dist/rendering/texturedPreparationBudget2D.js +81 -0
- package/dist/rendering/world3d/Animation3D.d.ts +104 -0
- package/dist/rendering/world3d/Animation3D.js +384 -0
- package/dist/rendering/world3d/AnimationTexture3D.d.ts +163 -0
- package/dist/rendering/world3d/AnimationTexture3D.js +603 -0
- package/dist/rendering/world3d/Batch3D.d.ts +75 -0
- package/dist/rendering/world3d/Batch3D.js +332 -0
- package/dist/rendering/world3d/Camera3D.d.ts +62 -0
- package/dist/rendering/world3d/Camera3D.js +132 -0
- package/dist/rendering/world3d/Character3D.d.ts +127 -0
- package/dist/rendering/world3d/Character3D.js +305 -0
- package/dist/rendering/world3d/Cloth3D.d.ts +130 -0
- package/dist/rendering/world3d/Cloth3D.js +503 -0
- package/dist/rendering/world3d/Compression3D.d.ts +22 -0
- package/dist/rendering/world3d/Compression3D.js +703 -0
- package/dist/rendering/world3d/Curves3D.d.ts +119 -0
- package/dist/rendering/world3d/Curves3D.js +460 -0
- package/dist/rendering/world3d/Decal3D.d.ts +43 -0
- package/dist/rendering/world3d/Decal3D.js +242 -0
- package/dist/rendering/world3d/Export3D.d.ts +13 -0
- package/dist/rendering/world3d/Export3D.js +263 -0
- package/dist/rendering/world3d/Geometry3D.d.ts +95 -0
- package/dist/rendering/world3d/Geometry3D.js +335 -0
- package/dist/rendering/world3d/GeometryBuilder3D.d.ts +53 -0
- package/dist/rendering/world3d/GeometryBuilder3D.js +196 -0
- package/dist/rendering/world3d/Gizmo3D.d.ts +80 -0
- package/dist/rendering/world3d/Gizmo3D.js +514 -0
- package/dist/rendering/world3d/Gltf3D.d.ts +73 -0
- package/dist/rendering/world3d/Gltf3D.js +996 -0
- package/dist/rendering/world3d/GpuParticles3D.d.ts +109 -0
- package/dist/rendering/world3d/GpuParticles3D.js +401 -0
- package/dist/rendering/world3d/Hdr3D.d.ts +35 -0
- package/dist/rendering/world3d/Hdr3D.js +191 -0
- package/dist/rendering/world3d/Jelly3D.d.ts +77 -0
- package/dist/rendering/world3d/Jelly3D.js +267 -0
- package/dist/rendering/world3d/Ktx23D.d.ts +30 -0
- package/dist/rendering/world3d/Ktx23D.js +112 -0
- package/dist/rendering/world3d/Light3D.d.ts +84 -0
- package/dist/rendering/world3d/Light3D.js +97 -0
- package/dist/rendering/world3d/Material3D.d.ts +253 -0
- package/dist/rendering/world3d/Material3D.js +269 -0
- package/dist/rendering/world3d/Mesh3D.d.ts +112 -0
- package/dist/rendering/world3d/Mesh3D.js +337 -0
- package/dist/rendering/world3d/Meshopt3D.d.ts +15 -0
- package/dist/rendering/world3d/Meshopt3D.js +276 -0
- package/dist/rendering/world3d/Navigation3D.d.ts +213 -0
- package/dist/rendering/world3d/Navigation3D.js +1043 -0
- package/dist/rendering/world3d/Object3D.d.ts +118 -0
- package/dist/rendering/world3d/Object3D.js +315 -0
- package/dist/rendering/world3d/Particles3D.d.ts +90 -0
- package/dist/rendering/world3d/Particles3D.js +277 -0
- package/dist/rendering/world3d/Physics3D.d.ts +430 -0
- package/dist/rendering/world3d/Physics3D.js +2840 -0
- package/dist/rendering/world3d/PhysicsHull3D.d.ts +37 -0
- package/dist/rendering/world3d/PhysicsHull3D.js +229 -0
- package/dist/rendering/world3d/PhysicsMesh3D.d.ts +41 -0
- package/dist/rendering/world3d/PhysicsMesh3D.js +340 -0
- package/dist/rendering/world3d/PhysicsQueries3D.d.ts +24 -0
- package/dist/rendering/world3d/PhysicsQueries3D.js +323 -0
- package/dist/rendering/world3d/PhysicsRemote3D.d.ts +179 -0
- package/dist/rendering/world3d/PhysicsRemote3D.js +536 -0
- package/dist/rendering/world3d/Ragdoll3D.d.ts +74 -0
- package/dist/rendering/world3d/Ragdoll3D.js +202 -0
- package/dist/rendering/world3d/Raycast3D.d.ts +40 -0
- package/dist/rendering/world3d/Raycast3D.js +247 -0
- package/dist/rendering/world3d/RenderList3D.d.ts +91 -0
- package/dist/rendering/world3d/RenderList3D.js +502 -0
- package/dist/rendering/world3d/Retarget3D.d.ts +21 -0
- package/dist/rendering/world3d/Retarget3D.js +185 -0
- package/dist/rendering/world3d/Rig3D.d.ts +57 -0
- package/dist/rendering/world3d/Rig3D.js +219 -0
- package/dist/rendering/world3d/Sdf3D.d.ts +181 -0
- package/dist/rendering/world3d/Sdf3D.js +1136 -0
- package/dist/rendering/world3d/SdfLod3D.d.ts +17 -0
- package/dist/rendering/world3d/SdfLod3D.js +56 -0
- package/dist/rendering/world3d/Serialize3D.d.ts +66 -0
- package/dist/rendering/world3d/Serialize3D.js +629 -0
- package/dist/rendering/world3d/Simplify3D.d.ts +29 -0
- package/dist/rendering/world3d/Simplify3D.js +426 -0
- package/dist/rendering/world3d/StateMachine3D.d.ts +87 -0
- package/dist/rendering/world3d/StateMachine3D.js +280 -0
- package/dist/rendering/world3d/SurfaceMaterial3D.d.ts +26 -0
- package/dist/rendering/world3d/SurfaceMaterial3D.js +138 -0
- package/dist/rendering/world3d/Terrain3D.d.ts +248 -0
- package/dist/rendering/world3d/Terrain3D.js +827 -0
- package/dist/rendering/world3d/Text3D.d.ts +95 -0
- package/dist/rendering/world3d/Text3D.js +560 -0
- package/dist/rendering/world3d/Texture3D.d.ts +148 -0
- package/dist/rendering/world3d/Texture3D.js +270 -0
- package/dist/rendering/world3d/Trail3D.d.ts +62 -0
- package/dist/rendering/world3d/Trail3D.js +195 -0
- package/dist/rendering/world3d/Vehicle3D.d.ts +102 -0
- package/dist/rendering/world3d/Vehicle3D.js +228 -0
- package/dist/rendering/world3d/VolumetricFog3D.d.ts +57 -0
- package/dist/rendering/world3d/VolumetricFog3D.js +230 -0
- package/dist/rendering/world3d/Water3D.d.ts +165 -0
- package/dist/rendering/world3d/Water3D.js +607 -0
- package/dist/rendering/world3d/core3D.d.ts +36 -0
- package/dist/rendering/world3d/core3D.js +99 -0
- package/dist/rendering/world3d/debug3D.d.ts +69 -0
- package/dist/rendering/world3d/debug3D.js +262 -0
- package/dist/rendering/world3d/decoders3D.d.ts +42 -0
- package/dist/rendering/world3d/decoders3D.js +133 -0
- package/dist/rendering/world3d/geometries3D.d.ts +111 -0
- package/dist/rendering/world3d/geometries3D.js +610 -0
- package/dist/rendering/world3d/helpers3D.d.ts +67 -0
- package/dist/rendering/world3d/helpers3D.js +178 -0
- package/dist/rendering/world3d/index.d.ts +103 -0
- package/dist/rendering/world3d/index.js +62 -0
- package/dist/rendering/world3d/math3D.d.ts +114 -0
- package/dist/rendering/world3d/math3D.js +675 -0
- package/dist/rendering/world3d/primitives3D.d.ts +67 -0
- package/dist/rendering/world3d/primitives3D.js +197 -0
- package/dist/resources.d.ts +8 -0
- package/dist/resources.js +6 -0
- package/dist/saveStore.d.ts +71 -0
- package/dist/saveStore.js +182 -0
- package/dist/semanticList.d.ts +126 -0
- package/dist/semanticList.js +175 -0
- package/dist/semanticTree.d.ts +10 -0
- package/dist/semanticTree.js +539 -0
- package/dist/semanticTypes.d.ts +175 -0
- package/dist/semanticTypes.js +2 -0
- package/dist/semantics.d.ts +6 -0
- package/dist/semantics.js +5 -0
- package/dist/sequencePlayback.d.ts +19 -0
- package/dist/sequencePlayback.js +391 -0
- package/dist/sequencePlaybackTypes.d.ts +24 -0
- package/dist/sequencePlaybackTypes.js +2 -0
- package/dist/sequenceTargetClaims.d.ts +10 -0
- package/dist/sequenceTargetClaims.js +31 -0
- package/dist/srgbBytes.d.ts +3 -0
- package/dist/srgbBytes.js +64 -0
- package/dist/startEngine.d.ts +5 -0
- package/dist/startEngine.js +31 -0
- package/dist/surfaceOwnership.d.ts +3 -0
- package/dist/surfaceOwnership.js +15 -0
- package/dist/text.d.ts +24 -0
- package/dist/text.js +4 -0
- package/dist/textField.d.ts +6 -0
- package/dist/textField.js +6 -0
- package/dist/textTable.d.ts +41 -0
- package/dist/textTable.js +114 -0
- package/dist/tileMapDraw.d.ts +7 -0
- package/dist/tileMapDraw.js +310 -0
- package/dist/tiledImport.d.ts +9 -0
- package/dist/tiledImport.js +357 -0
- package/dist/tilemap.d.ts +5 -0
- package/dist/tilemap.js +5 -0
- package/dist/tilemapTypes.d.ts +182 -0
- package/dist/tilemapTypes.js +2 -0
- package/dist/timer.d.ts +34 -0
- package/dist/timer.js +119 -0
- package/dist/tween.d.ts +15 -0
- package/dist/tween.js +329 -0
- package/dist/tweenTypes.d.ts +31 -0
- package/dist/tweenTypes.js +2 -0
- package/dist/ui/controlKeys.d.ts +113 -0
- package/dist/ui/controlKeys.js +250 -0
- package/dist/ui/controls.d.ts +58 -0
- package/dist/ui/controls.js +290 -0
- package/dist/ui/editing.d.ts +3 -0
- package/dist/ui/editing.js +3 -0
- package/dist/ui/index.d.ts +19 -0
- package/dist/ui/index.js +11 -0
- package/dist/ui/keyboardFocus.d.ts +32 -0
- package/dist/ui/keyboardFocus.js +146 -0
- package/dist/ui/layerTypes.d.ts +98 -0
- package/dist/ui/layerTypes.js +2 -0
- package/dist/ui/layers.d.ts +4 -0
- package/dist/ui/layers.js +586 -0
- package/dist/ui/leafContent.d.ts +21 -0
- package/dist/ui/leafContent.js +136 -0
- package/dist/ui/rangeControl.d.ts +53 -0
- package/dist/ui/rangeControl.js +168 -0
- package/dist/ui/scrollControl.d.ts +84 -0
- package/dist/ui/scrollControl.js +222 -0
- package/dist/ui/stateControls.d.ts +90 -0
- package/dist/ui/stateControls.js +331 -0
- package/dist/ui/textEditor.d.ts +54 -0
- package/dist/ui/textEditor.js +371 -0
- package/dist/ui/textEditorTypes.d.ts +85 -0
- package/dist/ui/textEditorTypes.js +2 -0
- package/dist/ui/textFieldControl.d.ts +100 -0
- package/dist/ui/textFieldControl.js +260 -0
- package/dist/ui/theme.d.ts +64 -0
- package/dist/ui/theme.js +166 -0
- package/dist/ui/types.d.ts +285 -0
- package/dist/ui/types.js +2 -0
- package/dist/ui/uiRoot.d.ts +4 -0
- package/dist/ui/uiRoot.js +1526 -0
- package/dist/ui/uiRootDisplay.d.ts +46 -0
- package/dist/ui/uiRootDisplay.js +148 -0
- package/dist/ui/uiRootModel.d.ts +114 -0
- package/dist/ui/uiRootModel.js +66 -0
- package/dist/ui/virtualList.d.ts +20 -0
- package/dist/ui/virtualList.js +105 -0
- package/dist/video.d.ts +4 -0
- package/dist/video.js +4 -0
- package/dist/videoPlayer.d.ts +4 -0
- package/dist/videoPlayer.js +215 -0
- package/dist/videoTypes.d.ts +77 -0
- package/dist/videoTypes.js +2 -0
- package/dist/web/BrowserAssetBundle.d.ts +41 -0
- package/dist/web/BrowserAssetBundle.js +136 -0
- package/dist/web/BrowserAudio.d.ts +74 -0
- package/dist/web/BrowserAudio.js +503 -0
- package/dist/web/BrowserFrameLoop.d.ts +69 -0
- package/dist/web/BrowserFrameLoop.js +125 -0
- package/dist/web/BrowserGame.d.ts +174 -0
- package/dist/web/BrowserGame.js +473 -0
- package/dist/web/BrowserGamepadInput.d.ts +38 -0
- package/dist/web/BrowserGamepadInput.js +134 -0
- package/dist/web/BrowserHoverInput.d.ts +25 -0
- package/dist/web/BrowserHoverInput.js +266 -0
- package/dist/web/BrowserImageTextures.d.ts +72 -0
- package/dist/web/BrowserImageTextures.js +169 -0
- package/dist/web/BrowserInputActions.d.ts +63 -0
- package/dist/web/BrowserInputActions.js +345 -0
- package/dist/web/BrowserKeyboardInput.d.ts +4 -0
- package/dist/web/BrowserKeyboardInput.js +223 -0
- package/dist/web/BrowserPlay.d.ts +417 -0
- package/dist/web/BrowserPlay.js +1648 -0
- package/dist/web/BrowserPointerInput.d.ts +4 -0
- package/dist/web/BrowserPointerInput.js +511 -0
- package/dist/web/BrowserPreferences.d.ts +10 -0
- package/dist/web/BrowserPreferences.js +39 -0
- package/dist/web/BrowserSemantics.d.ts +36 -0
- package/dist/web/BrowserSemantics.js +418 -0
- package/dist/web/BrowserStatsPanel.d.ts +56 -0
- package/dist/web/BrowserStatsPanel.js +143 -0
- package/dist/web/BrowserStorage.d.ts +35 -0
- package/dist/web/BrowserStorage.js +132 -0
- package/dist/web/BrowserTextEditor.d.ts +52 -0
- package/dist/web/BrowserTextEditor.js +839 -0
- package/dist/web/BrowserTextInput.d.ts +89 -0
- package/dist/web/BrowserTextInput.js +524 -0
- package/dist/web/BrowserTextureProvider.d.ts +58 -0
- package/dist/web/BrowserTextureProvider.js +935 -0
- package/dist/web/BrowserVideo.d.ts +40 -0
- package/dist/web/BrowserVideo.js +237 -0
- package/dist/web/CanvasKitFontSetProvider.d.ts +32 -0
- package/dist/web/CanvasKitFontSetProvider.js +215 -0
- package/dist/web/CanvasKitParagraphProvider.d.ts +173 -0
- package/dist/web/CanvasKitParagraphProvider.js +692 -0
- package/dist/web/CanvasTextRasterProvider.d.ts +4 -0
- package/dist/web/CanvasTextRasterProvider.js +312 -0
- package/dist/web/ManifestByteSource.d.ts +151 -0
- package/dist/web/ManifestByteSource.js +975 -0
- package/dist/web/ManifestFontContentLoader.d.ts +13 -0
- package/dist/web/ManifestFontContentLoader.js +30 -0
- package/dist/web/MouseInput.d.ts +4 -0
- package/dist/web/MouseInput.js +218 -0
- package/dist/web/WebGL2Host.d.ts +5 -0
- package/dist/web/WebGL2Host.js +2711 -0
- package/dist/web/WebGPUHost.d.ts +100 -0
- package/dist/web/WebGPUHost.js +3430 -0
- package/dist/web/audio.d.ts +3 -0
- package/dist/web/audio.js +4 -0
- package/dist/web/canvasKitParagraphGeometry.d.ts +27 -0
- package/dist/web/canvasKitParagraphGeometry.js +83 -0
- package/dist/web/editing.d.ts +5 -0
- package/dist/web/editing.js +4 -0
- package/dist/web/editorFonts.d.ts +54 -0
- package/dist/web/editorFonts.js +297 -0
- package/dist/web/game.d.ts +5 -0
- package/dist/web/game.js +6 -0
- package/dist/web/gamepad.d.ts +3 -0
- package/dist/web/gamepad.js +4 -0
- package/dist/web/hover.d.ts +3 -0
- package/dist/web/hover.js +4 -0
- package/dist/web/image.d.ts +4 -0
- package/dist/web/image.js +4 -0
- package/dist/web/imageProjections2D.d.ts +16 -0
- package/dist/web/imageProjections2D.js +2 -0
- package/dist/web/input.d.ts +6 -0
- package/dist/web/input.js +4 -0
- package/dist/web/keyboard.d.ts +3 -0
- package/dist/web/keyboard.js +3 -0
- package/dist/web/kit.d.ts +11 -0
- package/dist/web/kit.js +8 -0
- package/dist/web/loop.d.ts +3 -0
- package/dist/web/loop.js +4 -0
- package/dist/web/paragraph.d.ts +6 -0
- package/dist/web/paragraph.js +4 -0
- package/dist/web/play.d.ts +10 -0
- package/dist/web/play.js +9 -0
- package/dist/web/playMusic.d.ts +33 -0
- package/dist/web/playMusic.js +194 -0
- package/dist/web/playSfx.d.ts +36 -0
- package/dist/web/playSfx.js +112 -0
- package/dist/web/playTouch.d.ts +45 -0
- package/dist/web/playTouch.js +141 -0
- package/dist/web/playWidgets.d.ts +71 -0
- package/dist/web/playWidgets.js +431 -0
- package/dist/web/pointer.d.ts +3 -0
- package/dist/web/pointer.js +3 -0
- package/dist/web/prepareSharedSubmission2D.d.ts +27 -0
- package/dist/web/prepareSharedSubmission2D.js +63 -0
- package/dist/web/resources.d.ts +29 -0
- package/dist/web/resources.js +96 -0
- package/dist/web/semantics.d.ts +3 -0
- package/dist/web/semantics.js +4 -0
- package/dist/web/sharedDeviceSession.d.ts +64 -0
- package/dist/web/sharedDeviceSession.js +2 -0
- package/dist/web/sharedEffectShaders.d.ts +13 -0
- package/dist/web/sharedEffectShaders.js +181 -0
- package/dist/web/sharedFrameUpload.d.ts +25 -0
- package/dist/web/sharedFrameUpload.js +2 -0
- package/dist/web/sharedHostDeferred.d.ts +7 -0
- package/dist/web/sharedHostDeferred.js +12 -0
- package/dist/web/sharedRetentionLedger.d.ts +85 -0
- package/dist/web/sharedRetentionLedger.js +391 -0
- package/dist/web/sharedSubmissionStorage2D.d.ts +56 -0
- package/dist/web/sharedSubmissionStorage2D.js +73 -0
- package/dist/web/sharedWebGL2Arena.d.ts +40 -0
- package/dist/web/sharedWebGL2Arena.js +77 -0
- package/dist/web/sharedWebGL2Options.d.ts +33 -0
- package/dist/web/sharedWebGL2Options.js +102 -0
- package/dist/web/sharedWebGL2Shaders.d.ts +33 -0
- package/dist/web/sharedWebGL2Shaders.js +408 -0
- package/dist/web/sharedWebGPUOptions.d.ts +41 -0
- package/dist/web/sharedWebGPUOptions.js +130 -0
- package/dist/web/text.d.ts +3 -0
- package/dist/web/text.js +3 -0
- package/dist/web/textInput.d.ts +3 -0
- package/dist/web/textInput.js +3 -0
- package/dist/web/video.d.ts +3 -0
- package/dist/web/video.js +4 -0
- package/dist/web/webgl2.d.ts +7 -0
- package/dist/web/webgl2.js +4 -0
- package/dist/web/webgl2LayerState.d.ts +50 -0
- package/dist/web/webgl2LayerState.js +102 -0
- package/dist/web/webgl2Native.d.ts +72 -0
- package/dist/web/webgl2Native.js +572 -0
- package/dist/web/webgl2Types.d.ts +150 -0
- package/dist/web/webgl2Types.js +2 -0
- package/dist/web/webgpu.d.ts +6 -0
- package/dist/web/webgpu.js +2 -0
- package/dist/web/webgpuBindingCache.d.ts +26 -0
- package/dist/web/webgpuBindingCache.js +223 -0
- package/dist/web/webgpuBufferPool.d.ts +51 -0
- package/dist/web/webgpuBufferPool.js +58 -0
- package/dist/web/webgpuImageResidency.d.ts +56 -0
- package/dist/web/webgpuImageResidency.js +65 -0
- package/dist/web/webgpuLifetime.d.ts +45 -0
- package/dist/web/webgpuLifetime.js +64 -0
- package/dist/web/webgpuRetentionPool.d.ts +66 -0
- package/dist/web/webgpuRetentionPool.js +85 -0
- package/dist/web/webgpuSharedPass.d.ts +7 -0
- package/dist/web/webgpuSharedPass.js +293 -0
- package/dist/web/webgpuSharedResolvePass.d.ts +3 -0
- package/dist/web/webgpuSharedResolvePass.js +34 -0
- package/dist/web/world3d/Audio3D.d.ts +85 -0
- package/dist/web/world3d/Audio3D.js +271 -0
- package/dist/web/world3d/BrowserPlay3D.d.ts +295 -0
- package/dist/web/world3d/BrowserPlay3D.js +1256 -0
- package/dist/web/world3d/FlyControls3D.d.ts +59 -0
- package/dist/web/world3d/FlyControls3D.js +162 -0
- package/dist/web/world3d/FollowControls3D.d.ts +31 -0
- package/dist/web/world3d/FollowControls3D.js +119 -0
- package/dist/web/world3d/OrbitControls3D.d.ts +58 -0
- package/dist/web/world3d/OrbitControls3D.js +189 -0
- package/dist/web/world3d/TransformControls3D.d.ts +37 -0
- package/dist/web/world3d/TransformControls3D.js +128 -0
- package/dist/web/world3d/WebGL2Renderer3D.d.ts +136 -0
- package/dist/web/world3d/WebGL2Renderer3D.js +1175 -0
- package/dist/web/world3d/WebGPURenderer3D.d.ts +112 -0
- package/dist/web/world3d/WebGPURenderer3D.js +1916 -0
- package/dist/web/world3d/World3DView.d.ts +54 -0
- package/dist/web/world3d/World3DView.js +79 -0
- package/dist/web/world3d/app3D.d.ts +143 -0
- package/dist/web/world3d/app3D.js +305 -0
- package/dist/web/world3d/assets3D.d.ts +39 -0
- package/dist/web/world3d/assets3D.js +112 -0
- package/dist/web/world3d/atmosphere3D.d.ts +56 -0
- package/dist/web/world3d/atmosphere3D.js +193 -0
- package/dist/web/world3d/canvasFont3D.d.ts +21 -0
- package/dist/web/world3d/canvasFont3D.js +165 -0
- package/dist/web/world3d/frame3D.d.ts +144 -0
- package/dist/web/world3d/frame3D.js +388 -0
- package/dist/web/world3d/gpuResources3D.d.ts +98 -0
- package/dist/web/world3d/gpuResources3D.js +901 -0
- package/dist/web/world3d/host3D.d.ts +24 -0
- package/dist/web/world3d/host3D.js +61 -0
- package/dist/web/world3d/index.d.ts +40 -0
- package/dist/web/world3d/index.js +24 -0
- package/dist/web/world3d/loaders3D.d.ts +27 -0
- package/dist/web/world3d/loaders3D.js +138 -0
- package/dist/web/world3d/markers3D.d.ts +53 -0
- package/dist/web/world3d/markers3D.js +130 -0
- package/dist/web/world3d/materialWebGL23D.d.ts +34 -0
- package/dist/web/world3d/materialWebGL23D.js +218 -0
- package/dist/web/world3d/overlay3D.d.ts +47 -0
- package/dist/web/world3d/overlay3D.js +187 -0
- package/dist/web/world3d/post3D.d.ts +116 -0
- package/dist/web/world3d/post3D.js +462 -0
- package/dist/web/world3d/postWebGL23D.d.ts +24 -0
- package/dist/web/world3d/postWebGL23D.js +237 -0
- package/dist/web/world3d/postWebGPU3D.d.ts +23 -0
- package/dist/web/world3d/postWebGPU3D.js +255 -0
- package/dist/web/world3d/probe3D.d.ts +15 -0
- package/dist/web/world3d/probe3D.js +66 -0
- package/dist/web/world3d/shaders3D.d.ts +43 -0
- package/dist/web/world3d/shaders3D.js +851 -0
- package/dist/web/world3d/stats3D.d.ts +34 -0
- package/dist/web/world3d/stats3D.js +81 -0
- package/dist/web/world3d/webGL2FrameMetrics3D.d.ts +71 -0
- package/dist/web/world3d/webGL2FrameMetrics3D.js +185 -0
- package/dist/web/world3d/webgpu.d.ts +37 -0
- package/dist/web/world3d/webgpu.js +23 -0
- package/dist/web/world3d/webgpuPacking3D.d.ts +13 -0
- package/dist/web/world3d/webgpuPacking3D.js +85 -0
- package/dist/web/world3d/wgsl3D.d.ts +68 -0
- package/dist/web/world3d/wgsl3D.js +781 -0
- package/package.json +220 -4
|
@@ -0,0 +1,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,63 @@
|
|
|
1
|
+
import type { InputActions } from '@egret/engine/kit';
|
|
2
|
+
/** Where input actions read the browser: which element takes keys and pointers, whether gamepads count, and which keys pass through. */
|
|
3
|
+
export interface BrowserInputActionsOptions {
|
|
4
|
+
/** Where keys are listened for; the window by default. */
|
|
5
|
+
readonly keyTarget?: EventTarget;
|
|
6
|
+
/** Where mouse buttons are listened for, such as the canvas; none by default. */
|
|
7
|
+
readonly pointerTarget?: EventTarget;
|
|
8
|
+
/** Read connected gamepads on each `poll()`. On by default. */
|
|
9
|
+
readonly gamepads?: boolean;
|
|
10
|
+
/** Keep the page from acting on bound keys (scrolling on Space and the arrows). On by default. */
|
|
11
|
+
readonly preventDefault?: boolean;
|
|
12
|
+
/** Keys that are passed on even when bound, such as F5 or F12. */
|
|
13
|
+
readonly passKeys?: readonly string[];
|
|
14
|
+
/**
|
|
15
|
+
* Leave alone a key something before has already acted on, which says so by `preventDefault`. The game's keyboard input
|
|
16
|
+
* does this for a key a focused control took — Space on a focused button, the arrows on a focused slider — so with
|
|
17
|
+
* `true` that key does not also press an action. Off by default.
|
|
18
|
+
*/
|
|
19
|
+
readonly skipPrevented?: boolean;
|
|
20
|
+
}
|
|
21
|
+
/** Input actions driven by the browser's keys, pointers and gamepads: poll them each frame. */
|
|
22
|
+
export interface BrowserInputActions {
|
|
23
|
+
/** Reads the gamepads; call once a frame before the game reads its actions. */
|
|
24
|
+
poll(): void;
|
|
25
|
+
dispose(): void;
|
|
26
|
+
}
|
|
27
|
+
/** Listens to the page for the controls of `actions`. */
|
|
28
|
+
export declare function bindBrowserInputActions(actions: InputActions, options?: BrowserInputActionsOptions): BrowserInputActions;
|
|
29
|
+
/** A touch stick to put on the page: its binding, radius, the zone it appears in and its class. */
|
|
30
|
+
export interface TouchStickOptions {
|
|
31
|
+
/** The binding the stick drives; `Touch:stick` by default. Put it in a vector action's `sticks`. */
|
|
32
|
+
readonly binding?: string;
|
|
33
|
+
/** Pixels from the centre to full tilt. Defaults to 56. */
|
|
34
|
+
readonly radius?: number;
|
|
35
|
+
/** Where a touch may start the stick: the left half of the element by default, or the whole of it. */
|
|
36
|
+
readonly zone?: 'left' | 'right' | 'all';
|
|
37
|
+
/** Class names of the base and the knob, which the stick creates inside the element. */
|
|
38
|
+
readonly className?: string;
|
|
39
|
+
}
|
|
40
|
+
/** Touch controls on the page: their elements; dispose of them to take them off. */
|
|
41
|
+
export interface TouchControl {
|
|
42
|
+
/** The elements the control made, to style. */
|
|
43
|
+
readonly elements: readonly HTMLElement[];
|
|
44
|
+
dispose(): void;
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* A stick that appears where a finger lands in its zone of `element` and follows it. The element should cover
|
|
48
|
+
* the screen area the stick works in, with `touch-action: none`.
|
|
49
|
+
*/
|
|
50
|
+
export declare function createTouchStick(element: HTMLElement, actions: InputActions, options?: TouchStickOptions): TouchControl;
|
|
51
|
+
/** Makes `element` an on-screen button that holds `binding` (such as `Touch:jump`) while a finger is on it. */
|
|
52
|
+
export declare function createTouchButton(element: HTMLElement, actions: InputActions, binding: string): TouchControl;
|
|
53
|
+
/**
|
|
54
|
+
* The page's local storage as a save storage, or a memory stand-in where the page has none (a private window, a
|
|
55
|
+
* blocked site): every call is guarded, so a save never throws for want of storage.
|
|
56
|
+
*/
|
|
57
|
+
export declare function browserSaveStorage(): {
|
|
58
|
+
getItem(key: string): string | null;
|
|
59
|
+
setItem(key: string, value: string): void;
|
|
60
|
+
removeItem(key: string): void;
|
|
61
|
+
readonly persistent: boolean;
|
|
62
|
+
};
|
|
63
|
+
//# sourceMappingURL=BrowserInputActions.d.ts.map
|
|
@@ -0,0 +1,345 @@
|
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
// Feeds named input actions from the page: keys, mouse buttons and gamepads,
|
|
3
|
+
// and on-screen sticks and buttons for touch screens. Every listener is taken
|
|
4
|
+
// off by `dispose`. A lost focus or a hidden page lets every control go, so a
|
|
5
|
+
// key held while the player switched windows does not stay down.
|
|
6
|
+
import { EgretError } from '@egret/runtime';
|
|
7
|
+
// The standard gamepad layout, by button number.
|
|
8
|
+
const PAD_BUTTONS = [
|
|
9
|
+
'a',
|
|
10
|
+
'b',
|
|
11
|
+
'x',
|
|
12
|
+
'y',
|
|
13
|
+
'leftShoulder',
|
|
14
|
+
'rightShoulder',
|
|
15
|
+
'leftTrigger',
|
|
16
|
+
'rightTrigger',
|
|
17
|
+
'select',
|
|
18
|
+
'start',
|
|
19
|
+
'leftStickButton',
|
|
20
|
+
'rightStickButton',
|
|
21
|
+
'up',
|
|
22
|
+
'down',
|
|
23
|
+
'left',
|
|
24
|
+
'right',
|
|
25
|
+
'home'
|
|
26
|
+
];
|
|
27
|
+
const PAD_DEAD_ZONE = 0.12;
|
|
28
|
+
// PointerEvent.button order: primary, middle, secondary, back, forward, pen eraser.
|
|
29
|
+
const POINTER_BUTTON_MASKS = [1, 4, 2, 8, 16, 32];
|
|
30
|
+
function bound(actions, binding) {
|
|
31
|
+
for (const name of actions.names)
|
|
32
|
+
for (const slot of ['bindings', 'negative', 'positive', 'up', 'down', 'left', 'right', 'sticks']) {
|
|
33
|
+
let list;
|
|
34
|
+
try {
|
|
35
|
+
list = actions.bindingsOf(name, slot);
|
|
36
|
+
}
|
|
37
|
+
catch {
|
|
38
|
+
continue;
|
|
39
|
+
}
|
|
40
|
+
if (list.includes(binding))
|
|
41
|
+
return true;
|
|
42
|
+
}
|
|
43
|
+
return false;
|
|
44
|
+
}
|
|
45
|
+
/** Listens to the page for the controls of `actions`. */
|
|
46
|
+
export function bindBrowserInputActions(actions, options = {}) {
|
|
47
|
+
if (!actions || typeof actions.press !== 'function')
|
|
48
|
+
throw new EgretError('INPUT_ACTIONS_INVALID');
|
|
49
|
+
const win = globalThis;
|
|
50
|
+
const keyTarget = options.keyTarget ?? win;
|
|
51
|
+
if (!keyTarget || typeof keyTarget.addEventListener !== 'function')
|
|
52
|
+
throw new EgretError('INPUT_ACTIONS_INVALID');
|
|
53
|
+
const prevent = options.preventDefault ?? true;
|
|
54
|
+
const pass = new Set(options.passKeys ?? ['F5', 'F11', 'F12']);
|
|
55
|
+
const skipPrevented = options.skipPrevented ?? false;
|
|
56
|
+
if (typeof skipPrevented !== 'boolean')
|
|
57
|
+
throw new EgretError('INPUT_ACTIONS_INVALID');
|
|
58
|
+
const removers = [];
|
|
59
|
+
const listen = (target, type, handler, opts) => {
|
|
60
|
+
target.addEventListener(type, handler, opts);
|
|
61
|
+
removers.push(() => target.removeEventListener(type, handler, opts));
|
|
62
|
+
};
|
|
63
|
+
const typing = (event) => {
|
|
64
|
+
const element = event.target;
|
|
65
|
+
return (!!element &&
|
|
66
|
+
(element.isContentEditable === true || ['INPUT', 'TEXTAREA', 'SELECT'].includes(element.tagName ?? '')));
|
|
67
|
+
};
|
|
68
|
+
listen(keyTarget, 'keydown', event => {
|
|
69
|
+
const e = event;
|
|
70
|
+
if (typing(e) || !e.code || (skipPrevented && e.defaultPrevented))
|
|
71
|
+
return;
|
|
72
|
+
const binding = 'Key:' + e.code;
|
|
73
|
+
if (prevent && !pass.has(e.code) && bound(actions, binding))
|
|
74
|
+
e.preventDefault();
|
|
75
|
+
if (!e.repeat)
|
|
76
|
+
actions.press(binding);
|
|
77
|
+
});
|
|
78
|
+
listen(keyTarget, 'keyup', event => {
|
|
79
|
+
const e = event;
|
|
80
|
+
if (e.code)
|
|
81
|
+
actions.release('Key:' + e.code);
|
|
82
|
+
});
|
|
83
|
+
const letGo = () => actions.releaseAll();
|
|
84
|
+
if (typeof win.addEventListener === 'function') {
|
|
85
|
+
listen(win, 'blur', letGo);
|
|
86
|
+
listen(win, 'pagehide', letGo);
|
|
87
|
+
}
|
|
88
|
+
const doc = globalThis.document;
|
|
89
|
+
if (doc && typeof doc.addEventListener === 'function')
|
|
90
|
+
listen(doc, 'visibilitychange', () => {
|
|
91
|
+
if (doc.visibilityState === 'hidden')
|
|
92
|
+
letGo();
|
|
93
|
+
});
|
|
94
|
+
if (options.pointerTarget) {
|
|
95
|
+
const target = options.pointerTarget;
|
|
96
|
+
const mouseButton = (event, pressed) => {
|
|
97
|
+
const e = event;
|
|
98
|
+
if (e.pointerType === 'touch')
|
|
99
|
+
return;
|
|
100
|
+
if (e.type === 'pointermove') {
|
|
101
|
+
// A chord changes one button on pointermove. Ordinary motion reports button -1.
|
|
102
|
+
const mask = POINTER_BUTTON_MASKS[e.button];
|
|
103
|
+
if (mask === undefined || Boolean(e.buttons & mask) !== pressed)
|
|
104
|
+
return;
|
|
105
|
+
}
|
|
106
|
+
const binding = 'Mouse:' + e.button;
|
|
107
|
+
if (pressed)
|
|
108
|
+
actions.press(binding);
|
|
109
|
+
else
|
|
110
|
+
actions.release(binding);
|
|
111
|
+
};
|
|
112
|
+
const pressMouse = (event) => mouseButton(event, true);
|
|
113
|
+
const releaseMouse = (event) => mouseButton(event, false);
|
|
114
|
+
listen(target, 'pointerdown', pressMouse);
|
|
115
|
+
listen(target, 'pointermove', pressMouse);
|
|
116
|
+
listen(win, 'pointermove', releaseMouse);
|
|
117
|
+
listen(win, 'pointerup', releaseMouse);
|
|
118
|
+
listen(target, 'contextmenu', event => {
|
|
119
|
+
if (bound(actions, 'Mouse:2'))
|
|
120
|
+
event.preventDefault();
|
|
121
|
+
});
|
|
122
|
+
}
|
|
123
|
+
const padsHeld = new Set();
|
|
124
|
+
const padSticks = new Set();
|
|
125
|
+
const readPads = options.gamepads ?? true;
|
|
126
|
+
return {
|
|
127
|
+
poll() {
|
|
128
|
+
if (!readPads)
|
|
129
|
+
return;
|
|
130
|
+
const nav = globalThis.navigator;
|
|
131
|
+
const pads = typeof nav?.getGamepads === 'function' ? nav.getGamepads() : [];
|
|
132
|
+
const now = new Set();
|
|
133
|
+
// Pads are merged: any pad presses a button, and the strongest stick wins.
|
|
134
|
+
const sticks = new Map();
|
|
135
|
+
for (const pad of pads) {
|
|
136
|
+
if (!pad?.connected)
|
|
137
|
+
continue;
|
|
138
|
+
pad.buttons.forEach((button, index) => {
|
|
139
|
+
const value = button.value ?? (button.pressed ? 1 : 0);
|
|
140
|
+
if (!(button.pressed || value > 0.05))
|
|
141
|
+
return;
|
|
142
|
+
for (const name of [String(index), pad.mapping === 'standard' ? PAD_BUTTONS[index] : undefined]) {
|
|
143
|
+
if (!name)
|
|
144
|
+
continue;
|
|
145
|
+
const binding = 'Pad:' + name;
|
|
146
|
+
now.add(binding);
|
|
147
|
+
actions.press(binding, Math.min(1, Math.max(value, button.pressed ? 1 : 0)));
|
|
148
|
+
}
|
|
149
|
+
});
|
|
150
|
+
const pairs = [
|
|
151
|
+
['leftStick', pad.axes[0] ?? 0, pad.axes[1] ?? 0],
|
|
152
|
+
['rightStick', pad.axes[2] ?? 0, pad.axes[3] ?? 0]
|
|
153
|
+
];
|
|
154
|
+
for (const [name, x, y] of pairs) {
|
|
155
|
+
const length = Math.hypot(x, y);
|
|
156
|
+
if (length < PAD_DEAD_ZONE)
|
|
157
|
+
continue;
|
|
158
|
+
const held = sticks.get(name);
|
|
159
|
+
if (!held || length > Math.hypot(held[0], held[1]))
|
|
160
|
+
sticks.set(name, [x, y]);
|
|
161
|
+
}
|
|
162
|
+
}
|
|
163
|
+
for (const binding of padsHeld)
|
|
164
|
+
if (!now.has(binding))
|
|
165
|
+
actions.release(binding);
|
|
166
|
+
padsHeld.clear();
|
|
167
|
+
for (const binding of now)
|
|
168
|
+
padsHeld.add(binding);
|
|
169
|
+
for (const name of ['leftStick', 'rightStick']) {
|
|
170
|
+
const value = sticks.get(name);
|
|
171
|
+
const binding = 'Pad:' + name;
|
|
172
|
+
if (value) {
|
|
173
|
+
actions.setStick(binding, value[0], value[1]);
|
|
174
|
+
padSticks.add(binding);
|
|
175
|
+
}
|
|
176
|
+
else if (padSticks.delete(binding))
|
|
177
|
+
actions.setStick(binding, 0, 0);
|
|
178
|
+
}
|
|
179
|
+
},
|
|
180
|
+
dispose() {
|
|
181
|
+
for (const remove of removers.splice(0))
|
|
182
|
+
remove();
|
|
183
|
+
actions.releaseAll();
|
|
184
|
+
}
|
|
185
|
+
};
|
|
186
|
+
}
|
|
187
|
+
/**
|
|
188
|
+
* A stick that appears where a finger lands in its zone of `element` and follows it. The element should cover
|
|
189
|
+
* the screen area the stick works in, with `touch-action: none`.
|
|
190
|
+
*/
|
|
191
|
+
export function createTouchStick(element, actions, options = {}) {
|
|
192
|
+
if (!element || typeof element.addEventListener !== 'function' || !actions)
|
|
193
|
+
throw new EgretError('INPUT_ACTIONS_INVALID');
|
|
194
|
+
const binding = options.binding ?? 'Touch:stick', radius = options.radius ?? 56, zone = options.zone ?? 'left', name = options.className ?? 'egret-touch-stick';
|
|
195
|
+
if (!(radius > 0))
|
|
196
|
+
throw new EgretError('INPUT_ACTIONS_INVALID');
|
|
197
|
+
const doc = element.ownerDocument;
|
|
198
|
+
const base = doc.createElement('div'), knob = doc.createElement('div');
|
|
199
|
+
base.className = name;
|
|
200
|
+
knob.className = name + '-knob';
|
|
201
|
+
base.style.cssText =
|
|
202
|
+
`position:absolute;left:0;top:0;width:${radius * 2}px;height:${radius * 2}px;margin:${-radius}px 0 0 ${-radius}px;` +
|
|
203
|
+
'border-radius:50%;background:rgba(255,255,255,0.12);border:2px solid rgba(255,255,255,0.35);pointer-events:none';
|
|
204
|
+
knob.style.cssText =
|
|
205
|
+
`position:absolute;left:${radius - 22}px;top:${radius - 22}px;width:44px;height:44px;border-radius:50%;` +
|
|
206
|
+
'background:rgba(255,255,255,0.45)';
|
|
207
|
+
base.hidden = true;
|
|
208
|
+
base.appendChild(knob);
|
|
209
|
+
element.appendChild(base);
|
|
210
|
+
let finger, cx = 0, cy = 0;
|
|
211
|
+
const local = (event) => {
|
|
212
|
+
const box = element.getBoundingClientRect();
|
|
213
|
+
return [event.clientX - box.left, event.clientY - box.top];
|
|
214
|
+
};
|
|
215
|
+
const move = (event) => {
|
|
216
|
+
const [x, y] = local(event);
|
|
217
|
+
let dx = (x - cx) / radius, dy = (y - cy) / radius;
|
|
218
|
+
const length = Math.hypot(dx, dy);
|
|
219
|
+
if (length > 1) {
|
|
220
|
+
dx /= length;
|
|
221
|
+
dy /= length;
|
|
222
|
+
}
|
|
223
|
+
knob.style.transform = `translate(${(dx * radius).toFixed(1)}px, ${(dy * radius).toFixed(1)}px)`;
|
|
224
|
+
actions.setStick(binding, dx, dy);
|
|
225
|
+
};
|
|
226
|
+
const down = (event) => {
|
|
227
|
+
const e = event;
|
|
228
|
+
if (finger !== undefined || e.pointerType === 'mouse')
|
|
229
|
+
return;
|
|
230
|
+
const [x, y] = local(e);
|
|
231
|
+
const width = element.getBoundingClientRect().width;
|
|
232
|
+
if ((zone === 'left' && x > width / 2) || (zone === 'right' && x < width / 2))
|
|
233
|
+
return;
|
|
234
|
+
finger = e.pointerId;
|
|
235
|
+
cx = x;
|
|
236
|
+
cy = y;
|
|
237
|
+
base.style.transform = `translate(${x}px, ${y}px)`;
|
|
238
|
+
base.hidden = false;
|
|
239
|
+
element.setPointerCapture?.(e.pointerId);
|
|
240
|
+
e.preventDefault();
|
|
241
|
+
move(e);
|
|
242
|
+
};
|
|
243
|
+
const moved = (event) => {
|
|
244
|
+
const e = event;
|
|
245
|
+
if (e.pointerId === finger)
|
|
246
|
+
move(e);
|
|
247
|
+
};
|
|
248
|
+
const up = (event) => {
|
|
249
|
+
const e = event;
|
|
250
|
+
if (e.pointerId !== finger)
|
|
251
|
+
return;
|
|
252
|
+
finger = undefined;
|
|
253
|
+
base.hidden = true;
|
|
254
|
+
knob.style.transform = '';
|
|
255
|
+
actions.setStick(binding, 0, 0);
|
|
256
|
+
};
|
|
257
|
+
element.addEventListener('pointerdown', down);
|
|
258
|
+
element.addEventListener('pointermove', moved);
|
|
259
|
+
element.addEventListener('pointerup', up);
|
|
260
|
+
element.addEventListener('pointercancel', up);
|
|
261
|
+
return {
|
|
262
|
+
elements: [base, knob],
|
|
263
|
+
dispose() {
|
|
264
|
+
element.removeEventListener('pointerdown', down);
|
|
265
|
+
element.removeEventListener('pointermove', moved);
|
|
266
|
+
element.removeEventListener('pointerup', up);
|
|
267
|
+
element.removeEventListener('pointercancel', up);
|
|
268
|
+
base.remove();
|
|
269
|
+
if (finger !== undefined)
|
|
270
|
+
actions.setStick(binding, 0, 0);
|
|
271
|
+
}
|
|
272
|
+
};
|
|
273
|
+
}
|
|
274
|
+
/** Makes `element` an on-screen button that holds `binding` (such as `Touch:jump`) while a finger is on it. */
|
|
275
|
+
export function createTouchButton(element, actions, binding) {
|
|
276
|
+
if (!element || typeof element.addEventListener !== 'function' || !actions || typeof binding !== 'string')
|
|
277
|
+
throw new EgretError('INPUT_ACTIONS_INVALID');
|
|
278
|
+
const fingers = new Set();
|
|
279
|
+
const down = (event) => {
|
|
280
|
+
const e = event;
|
|
281
|
+
fingers.add(e.pointerId);
|
|
282
|
+
element.setPointerCapture?.(e.pointerId);
|
|
283
|
+
element.dataset['pressed'] = '';
|
|
284
|
+
e.preventDefault();
|
|
285
|
+
actions.press(binding);
|
|
286
|
+
};
|
|
287
|
+
const up = (event) => {
|
|
288
|
+
const e = event;
|
|
289
|
+
if (!fingers.delete(e.pointerId) || fingers.size > 0)
|
|
290
|
+
return;
|
|
291
|
+
delete element.dataset['pressed'];
|
|
292
|
+
actions.release(binding);
|
|
293
|
+
};
|
|
294
|
+
element.addEventListener('pointerdown', down);
|
|
295
|
+
element.addEventListener('pointerup', up);
|
|
296
|
+
element.addEventListener('pointercancel', up);
|
|
297
|
+
return {
|
|
298
|
+
elements: [element],
|
|
299
|
+
dispose() {
|
|
300
|
+
element.removeEventListener('pointerdown', down);
|
|
301
|
+
element.removeEventListener('pointerup', up);
|
|
302
|
+
element.removeEventListener('pointercancel', up);
|
|
303
|
+
if (fingers.size)
|
|
304
|
+
actions.release(binding);
|
|
305
|
+
fingers.clear();
|
|
306
|
+
}
|
|
307
|
+
};
|
|
308
|
+
}
|
|
309
|
+
/**
|
|
310
|
+
* The page's local storage as a save storage, or a memory stand-in where the page has none (a private window, a
|
|
311
|
+
* blocked site): every call is guarded, so a save never throws for want of storage.
|
|
312
|
+
*/
|
|
313
|
+
export function browserSaveStorage() {
|
|
314
|
+
let storage;
|
|
315
|
+
try {
|
|
316
|
+
storage = globalThis.localStorage;
|
|
317
|
+
const probe = '__egret_probe__';
|
|
318
|
+
storage?.setItem(probe, probe);
|
|
319
|
+
storage?.removeItem(probe);
|
|
320
|
+
}
|
|
321
|
+
catch {
|
|
322
|
+
storage = undefined;
|
|
323
|
+
}
|
|
324
|
+
const memory = new Map();
|
|
325
|
+
return {
|
|
326
|
+
persistent: storage !== undefined,
|
|
327
|
+
getItem(key) {
|
|
328
|
+
if (!storage)
|
|
329
|
+
return memory.get(key) ?? null;
|
|
330
|
+
return storage.getItem(key);
|
|
331
|
+
},
|
|
332
|
+
setItem(key, value) {
|
|
333
|
+
if (!storage)
|
|
334
|
+
return void memory.set(key, value);
|
|
335
|
+
// Thrown when the storage is full; the save store reports it.
|
|
336
|
+
storage.setItem(key, value);
|
|
337
|
+
},
|
|
338
|
+
removeItem(key) {
|
|
339
|
+
if (!storage)
|
|
340
|
+
return void memory.delete(key);
|
|
341
|
+
storage.removeItem(key);
|
|
342
|
+
}
|
|
343
|
+
};
|
|
344
|
+
}
|
|
345
|
+
//# sourceMappingURL=BrowserInputActions.js.map
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { KeyboardInput, KeyboardInputOptions } from '#egret-keyboard-input';
|
|
2
|
+
/** Canvas-local native keyboard bridge. Canvas focus remains application-owned. */
|
|
3
|
+
export declare function createBrowserKeyboardInput(options: KeyboardInputOptions): KeyboardInput;
|
|
4
|
+
//# sourceMappingURL=BrowserKeyboardInput.d.ts.map
|