@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,215 @@
|
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
import { AssetManager, Bitmap, DisplayObjectContainer, EgretError, createAssetRef, createAssetType, createTexture, isTexture } from '@egret/runtime';
|
|
3
|
+
const invalid = () => new EgretError('VIDEO_OPTIONS_INVALID');
|
|
4
|
+
const finite = (value) => typeof value === 'number' && Number.isFinite(value);
|
|
5
|
+
let made = 0;
|
|
6
|
+
function sourceOk(source) {
|
|
7
|
+
if (source === null || typeof source !== 'object')
|
|
8
|
+
return false;
|
|
9
|
+
const s = source;
|
|
10
|
+
return ['readFrame', 'play', 'pause', 'seek', 'dispose'].every(name => typeof s[name] === 'function');
|
|
11
|
+
}
|
|
12
|
+
/** A video as a display object: each new picture its source gives becomes, through the Engine's assets, the texture of one Bitmap. */
|
|
13
|
+
export function createVideo(options) {
|
|
14
|
+
if (options === null || typeof options !== 'object')
|
|
15
|
+
throw invalid();
|
|
16
|
+
const { assets, source } = options;
|
|
17
|
+
if (!(assets instanceof AssetManager) || !sourceOk(source))
|
|
18
|
+
throw invalid();
|
|
19
|
+
// Each picture is an asset of this video's own type, leased while it is shown and let go when the next one is.
|
|
20
|
+
// Asset names are shared by all types of an Engine, so each video names its pictures under its own name.
|
|
21
|
+
const name = 'egret.video.' + ++made, waiting = new Map(), type = createAssetType(name, value => isTexture(value));
|
|
22
|
+
assets.register(type, {
|
|
23
|
+
load: async (ref) => {
|
|
24
|
+
const texture = waiting.get(ref.id);
|
|
25
|
+
if (texture === undefined)
|
|
26
|
+
throw new EgretError('VIDEO_FRAME_INVALID');
|
|
27
|
+
return texture;
|
|
28
|
+
},
|
|
29
|
+
dispose: texture => {
|
|
30
|
+
texture.dispose();
|
|
31
|
+
}
|
|
32
|
+
});
|
|
33
|
+
const display = new DisplayObjectContainer(), listeners = new Set();
|
|
34
|
+
let bitmap, shown, busy = false, closed = false, frames = 0, skipped = 0, count = 0, shownTime = NaN, endedTold = false;
|
|
35
|
+
const open = () => {
|
|
36
|
+
if (closed)
|
|
37
|
+
throw new EgretError('VIDEO_CLOSED');
|
|
38
|
+
};
|
|
39
|
+
/** Tells of the end once each time the source comes to it. */
|
|
40
|
+
function watchEnd() {
|
|
41
|
+
const ended = source.state === 'ended';
|
|
42
|
+
if (ended && !endedTold) {
|
|
43
|
+
endedTold = true;
|
|
44
|
+
const failures = [];
|
|
45
|
+
for (const listener of [...listeners])
|
|
46
|
+
try {
|
|
47
|
+
listener();
|
|
48
|
+
}
|
|
49
|
+
catch (cause) {
|
|
50
|
+
failures.push(cause);
|
|
51
|
+
}
|
|
52
|
+
if (failures.length > 0)
|
|
53
|
+
throw new EgretError('VIDEO_LISTENER_FAILED', { cause: failures[0], cleanupErrors: failures.slice(1) });
|
|
54
|
+
}
|
|
55
|
+
else if (!ended)
|
|
56
|
+
endedTold = false;
|
|
57
|
+
}
|
|
58
|
+
return Object.freeze({
|
|
59
|
+
get state() {
|
|
60
|
+
return closed ? 'closed' : source.state;
|
|
61
|
+
},
|
|
62
|
+
display,
|
|
63
|
+
get width() {
|
|
64
|
+
return source.width;
|
|
65
|
+
},
|
|
66
|
+
get height() {
|
|
67
|
+
return source.height;
|
|
68
|
+
},
|
|
69
|
+
get duration() {
|
|
70
|
+
return source.duration;
|
|
71
|
+
},
|
|
72
|
+
get currentTime() {
|
|
73
|
+
return source.currentTime;
|
|
74
|
+
},
|
|
75
|
+
get loop() {
|
|
76
|
+
return source.loop;
|
|
77
|
+
},
|
|
78
|
+
set loop(value) {
|
|
79
|
+
if (typeof value !== 'boolean')
|
|
80
|
+
throw invalid();
|
|
81
|
+
open();
|
|
82
|
+
source.loop = value;
|
|
83
|
+
},
|
|
84
|
+
get muted() {
|
|
85
|
+
return source.muted;
|
|
86
|
+
},
|
|
87
|
+
set muted(value) {
|
|
88
|
+
if (typeof value !== 'boolean')
|
|
89
|
+
throw invalid();
|
|
90
|
+
open();
|
|
91
|
+
source.muted = value;
|
|
92
|
+
},
|
|
93
|
+
get volume() {
|
|
94
|
+
return source.volume;
|
|
95
|
+
},
|
|
96
|
+
set volume(value) {
|
|
97
|
+
if (!finite(value) || value < 0 || value > 1)
|
|
98
|
+
throw invalid();
|
|
99
|
+
open();
|
|
100
|
+
source.volume = value;
|
|
101
|
+
},
|
|
102
|
+
async play() {
|
|
103
|
+
open();
|
|
104
|
+
endedTold = false;
|
|
105
|
+
try {
|
|
106
|
+
await source.play();
|
|
107
|
+
}
|
|
108
|
+
catch (cause) {
|
|
109
|
+
throw new EgretError('VIDEO_PLAY_REFUSED', { cause });
|
|
110
|
+
}
|
|
111
|
+
},
|
|
112
|
+
pause() {
|
|
113
|
+
open();
|
|
114
|
+
source.pause();
|
|
115
|
+
},
|
|
116
|
+
seek(seconds) {
|
|
117
|
+
if (!finite(seconds) || seconds < 0)
|
|
118
|
+
throw invalid();
|
|
119
|
+
open();
|
|
120
|
+
source.seek(seconds);
|
|
121
|
+
},
|
|
122
|
+
async update() {
|
|
123
|
+
open();
|
|
124
|
+
// A picture still on its way to a texture: the next update takes whatever is newest then.
|
|
125
|
+
if (busy) {
|
|
126
|
+
skipped++;
|
|
127
|
+
return false;
|
|
128
|
+
}
|
|
129
|
+
const frame = source.readFrame();
|
|
130
|
+
if (frame === undefined) {
|
|
131
|
+
watchEnd();
|
|
132
|
+
return false;
|
|
133
|
+
}
|
|
134
|
+
if (frame === null || typeof frame !== 'object' || !finite(frame.time))
|
|
135
|
+
throw new EgretError('VIDEO_FRAME_INVALID');
|
|
136
|
+
let texture;
|
|
137
|
+
try {
|
|
138
|
+
texture = createTexture(frame.image);
|
|
139
|
+
}
|
|
140
|
+
catch (cause) {
|
|
141
|
+
throw new EgretError('VIDEO_FRAME_INVALID', { cause });
|
|
142
|
+
}
|
|
143
|
+
const id = name + '/frame-' + ++count;
|
|
144
|
+
waiting.set(id, texture);
|
|
145
|
+
busy = true;
|
|
146
|
+
let lease;
|
|
147
|
+
try {
|
|
148
|
+
lease = await assets.acquire(createAssetRef(type, id));
|
|
149
|
+
}
|
|
150
|
+
finally {
|
|
151
|
+
waiting.delete(id);
|
|
152
|
+
busy = false;
|
|
153
|
+
}
|
|
154
|
+
if (closed) {
|
|
155
|
+
lease.release();
|
|
156
|
+
return false;
|
|
157
|
+
}
|
|
158
|
+
if (bitmap === undefined) {
|
|
159
|
+
bitmap = new Bitmap(lease);
|
|
160
|
+
display.addChild(bitmap);
|
|
161
|
+
}
|
|
162
|
+
else
|
|
163
|
+
bitmap.textureLease = lease;
|
|
164
|
+
const previous = shown;
|
|
165
|
+
shown = lease;
|
|
166
|
+
previous?.release();
|
|
167
|
+
frames++;
|
|
168
|
+
shownTime = frame.time;
|
|
169
|
+
watchEnd();
|
|
170
|
+
return true;
|
|
171
|
+
},
|
|
172
|
+
onEnded(listener) {
|
|
173
|
+
if (typeof listener !== 'function')
|
|
174
|
+
throw invalid();
|
|
175
|
+
open();
|
|
176
|
+
listeners.add(listener);
|
|
177
|
+
return () => {
|
|
178
|
+
listeners.delete(listener);
|
|
179
|
+
};
|
|
180
|
+
},
|
|
181
|
+
snapshot() {
|
|
182
|
+
return Object.freeze({
|
|
183
|
+
state: closed ? 'closed' : source.state,
|
|
184
|
+
frames,
|
|
185
|
+
skipped,
|
|
186
|
+
currentTime: source.currentTime,
|
|
187
|
+
shownTime
|
|
188
|
+
});
|
|
189
|
+
},
|
|
190
|
+
dispose() {
|
|
191
|
+
if (closed)
|
|
192
|
+
return;
|
|
193
|
+
closed = true;
|
|
194
|
+
listeners.clear();
|
|
195
|
+
const failures = [];
|
|
196
|
+
for (const step of [
|
|
197
|
+
() => bitmap?.dispose(),
|
|
198
|
+
() => shown?.release(),
|
|
199
|
+
() => display.dispose(),
|
|
200
|
+
() => source.dispose()
|
|
201
|
+
])
|
|
202
|
+
try {
|
|
203
|
+
step();
|
|
204
|
+
}
|
|
205
|
+
catch (cause) {
|
|
206
|
+
failures.push(cause);
|
|
207
|
+
}
|
|
208
|
+
bitmap = undefined;
|
|
209
|
+
shown = undefined;
|
|
210
|
+
if (failures.length > 0)
|
|
211
|
+
throw new EgretError('VIDEO_CLEANUP_FAILED', { cause: failures[0], cleanupErrors: failures.slice(1) });
|
|
212
|
+
}
|
|
213
|
+
});
|
|
214
|
+
}
|
|
215
|
+
//# sourceMappingURL=videoPlayer.js.map
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
import type { AssetManager, DisplayObjectContainer } from '@egret/runtime';
|
|
2
|
+
import type { ImageData2D } from '@egret/contracts';
|
|
3
|
+
/** Where a source is: still opening, able to show a frame, playing, paused, at its end, or unable to play. */
|
|
4
|
+
export type VideoSourceState = 'loading' | 'ready' | 'playing' | 'paused' | 'ended' | 'failed';
|
|
5
|
+
/** Whether a video is loading, ready, playing, paused, ended, failed or closed. */
|
|
6
|
+
export type VideoState = VideoSourceState | 'closed';
|
|
7
|
+
/** One picture of a video, the time of the video it shows. */
|
|
8
|
+
export interface VideoFrame {
|
|
9
|
+
readonly image: ImageData2D;
|
|
10
|
+
readonly time: number;
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* What a video player reads its pictures from and is driven through. The browser video entry makes one from a video
|
|
14
|
+
* element of the page; a game or a test may give its own.
|
|
15
|
+
*/
|
|
16
|
+
export interface VideoSource {
|
|
17
|
+
readonly state: VideoSourceState;
|
|
18
|
+
/** The size of the pictures it gives, which is 0 by 0 until it knows. */
|
|
19
|
+
readonly width: number;
|
|
20
|
+
readonly height: number;
|
|
21
|
+
/** Seconds; Infinity for a stream, NaN until it knows. */
|
|
22
|
+
readonly duration: number;
|
|
23
|
+
readonly currentTime: number;
|
|
24
|
+
loop: boolean;
|
|
25
|
+
muted: boolean;
|
|
26
|
+
volume: number;
|
|
27
|
+
/** The newest picture not yet read, or undefined when it has not changed since the last read. */
|
|
28
|
+
readFrame(): VideoFrame | undefined;
|
|
29
|
+
/** Resolves when it plays; rejects when the page does not let it, as a browser does with sound before a press. */
|
|
30
|
+
play(): Promise<void>;
|
|
31
|
+
pause(): void;
|
|
32
|
+
seek(seconds: number): void;
|
|
33
|
+
dispose(): void;
|
|
34
|
+
}
|
|
35
|
+
/** A video to show: the asset manager that leases its pictures, and its source. */
|
|
36
|
+
export interface VideoOptions {
|
|
37
|
+
/** The Engine's assets, which lease each picture as a texture. */
|
|
38
|
+
readonly assets: AssetManager;
|
|
39
|
+
readonly source: VideoSource;
|
|
40
|
+
}
|
|
41
|
+
/** A video as it is now: its state, its pictures shown and skipped, and its times. */
|
|
42
|
+
export interface VideoSnapshot {
|
|
43
|
+
readonly state: VideoState;
|
|
44
|
+
/** Pictures shown since it was made. */
|
|
45
|
+
readonly frames: number;
|
|
46
|
+
/** Times a newer picture was waiting while the last was still being made a texture, and was taken next time instead. */
|
|
47
|
+
readonly skipped: number;
|
|
48
|
+
readonly currentTime: number;
|
|
49
|
+
/** The time of the picture shown, or NaN before the first. */
|
|
50
|
+
readonly shownTime: number;
|
|
51
|
+
}
|
|
52
|
+
/** A video shown as a display object: each new picture of its source becomes the texture of one Bitmap. */
|
|
53
|
+
export interface Video {
|
|
54
|
+
readonly state: VideoState;
|
|
55
|
+
/** Holds the Bitmap once there is a first picture. */
|
|
56
|
+
readonly display: DisplayObjectContainer;
|
|
57
|
+
readonly width: number;
|
|
58
|
+
readonly height: number;
|
|
59
|
+
readonly duration: number;
|
|
60
|
+
readonly currentTime: number;
|
|
61
|
+
loop: boolean;
|
|
62
|
+
muted: boolean;
|
|
63
|
+
volume: number;
|
|
64
|
+
play(): Promise<void>;
|
|
65
|
+
pause(): void;
|
|
66
|
+
seek(seconds: number): void;
|
|
67
|
+
/**
|
|
68
|
+
* Shows the newest picture of the source, if there is one: call it once a frame. Resolves true when a new picture is
|
|
69
|
+
* shown; false when there was none, or one is still being made a texture.
|
|
70
|
+
*/
|
|
71
|
+
update(): Promise<boolean>;
|
|
72
|
+
/** Called when the source reaches its end without looping. Returns a function that stops it. */
|
|
73
|
+
onEnded(listener: () => void): () => void;
|
|
74
|
+
snapshot(): VideoSnapshot;
|
|
75
|
+
dispose(): void;
|
|
76
|
+
}
|
|
77
|
+
//# sourceMappingURL=videoTypes.d.ts.map
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
import type { AssetBundleEntry, AssetBundleIndex } from '@egret/engine/kit';
|
|
2
|
+
/** An asset bundle to open: how it is fetched and from where, whether it is read whole, and the cache it is kept in. */
|
|
3
|
+
export interface BrowserAssetBundleOptions {
|
|
4
|
+
/** `fetch` by default; tests and service workers give their own. */
|
|
5
|
+
readonly fetch?: (url: string, init?: {
|
|
6
|
+
headers?: Record<string, string>;
|
|
7
|
+
signal?: AbortSignal;
|
|
8
|
+
}) => Promise<Response>;
|
|
9
|
+
readonly signal?: AbortSignal;
|
|
10
|
+
/** Fetch the whole file at once instead of by ranges. */
|
|
11
|
+
readonly whole?: boolean;
|
|
12
|
+
/**
|
|
13
|
+
* Keeps the index and every entry read, so the bundle opens and reads again without the network. Entries are
|
|
14
|
+
* kept by the bundle's address and their checksums, so a rebuilt bundle never serves an old one.
|
|
15
|
+
* `openBrowserBundleCache` makes one.
|
|
16
|
+
*/
|
|
17
|
+
readonly cache?: {
|
|
18
|
+
match(key: string): Promise<Uint8Array | undefined>;
|
|
19
|
+
put(key: string, bytes: Uint8Array): Promise<void>;
|
|
20
|
+
};
|
|
21
|
+
}
|
|
22
|
+
/** An asset bundle opened in the browser: its index and entries, and calls that read an entry's bytes. */
|
|
23
|
+
export interface BrowserAssetBundle {
|
|
24
|
+
readonly url: string;
|
|
25
|
+
readonly index: AssetBundleIndex;
|
|
26
|
+
/** True when the host answered byte ranges; false when the whole file was fetched. */
|
|
27
|
+
readonly ranged: boolean;
|
|
28
|
+
/** Entries whose tags include every tag given. */
|
|
29
|
+
entries(...tags: string[]): readonly AssetBundleEntry[];
|
|
30
|
+
/** The bytes of each named entry, fetched in as few requests as their places allow. */
|
|
31
|
+
read(names: readonly string[]): Promise<Map<string, Uint8Array>>;
|
|
32
|
+
/** The bytes of one entry. */
|
|
33
|
+
get(name: string): Promise<Uint8Array>;
|
|
34
|
+
/** Bytes fetched so far. */
|
|
35
|
+
readonly transferred: number;
|
|
36
|
+
/** True when the index came from the cache because the bundle could not be fetched. */
|
|
37
|
+
readonly offline: boolean;
|
|
38
|
+
}
|
|
39
|
+
/** Opens the bundle at `url`, reading its index. */
|
|
40
|
+
export declare function openBrowserAssetBundle(url: string, options?: BrowserAssetBundleOptions): Promise<BrowserAssetBundle>;
|
|
41
|
+
//# sourceMappingURL=BrowserAssetBundle.d.ts.map
|
|
@@ -0,0 +1,136 @@
|
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
// Reads an asset bundle over HTTP. Where the host serves byte ranges, only the
|
|
3
|
+
// header, the index and the entries asked for are fetched, neighbouring ones in
|
|
4
|
+
// one request; where it does not (a static host that ignores Range), the whole
|
|
5
|
+
// file is fetched once and kept. Entries are checked against the index.
|
|
6
|
+
import { EgretError } from '@egret/runtime';
|
|
7
|
+
import { ASSET_BUNDLE_HEADER_BYTES, planAssetBundleRanges, readAssetBundleHeader, readAssetBundleIndex, sliceAssetBundle } from '@egret/engine/kit';
|
|
8
|
+
/** Opens the bundle at `url`, reading its index. */
|
|
9
|
+
export async function openBrowserAssetBundle(url, options = {}) {
|
|
10
|
+
if (typeof url !== 'string' || url === '')
|
|
11
|
+
throw new EgretError('ASSET_BUNDLE_INVALID');
|
|
12
|
+
const get = options.fetch ?? ((u, init) => fetch(u, init));
|
|
13
|
+
let transferred = 0;
|
|
14
|
+
let whole;
|
|
15
|
+
const signal = options.signal;
|
|
16
|
+
const body = async (response) => {
|
|
17
|
+
const bytes = new Uint8Array(await response.arrayBuffer());
|
|
18
|
+
transferred += bytes.length;
|
|
19
|
+
return bytes;
|
|
20
|
+
};
|
|
21
|
+
const fetchWhole = async () => {
|
|
22
|
+
const response = await get(url, signal ? { signal } : {});
|
|
23
|
+
if (!response.ok)
|
|
24
|
+
throw new EgretError('ASSET_BUNDLE_FETCH_FAILED', { cause: new Error(String(response.status)) });
|
|
25
|
+
return body(response);
|
|
26
|
+
};
|
|
27
|
+
// Asks for bytes [start, end); returns them with where they start, or the whole file when the host ignored Range.
|
|
28
|
+
const fetchRange = async (start, end) => {
|
|
29
|
+
if (whole)
|
|
30
|
+
return { bytes: whole, start: 0 };
|
|
31
|
+
const response = await get(url, { headers: { Range: `bytes=${start}-${end - 1}` }, ...(signal ? { signal } : {}) });
|
|
32
|
+
if (response.status === 206) {
|
|
33
|
+
const bytes = await body(response);
|
|
34
|
+
const range = /^bytes (\d+)-(\d+)\/(\d+|\*)$/.exec(response.headers.get('Content-Range') ?? '');
|
|
35
|
+
const from = range ? Number(range[1]) : start;
|
|
36
|
+
// A file shorter than the range asked for ends the answer early: that is the whole of what was asked.
|
|
37
|
+
const total = range && range[3] !== '*' ? Number(range[3]) : undefined;
|
|
38
|
+
const reachesEnd = total !== undefined && from + bytes.length === total;
|
|
39
|
+
if (from > start || (from + bytes.length < end && !reachesEnd))
|
|
40
|
+
throw new EgretError('ASSET_BUNDLE_RANGE_INVALID', {
|
|
41
|
+
cause: new Error(`asked ${start}-${end}, got ${from}+${bytes.length}`)
|
|
42
|
+
});
|
|
43
|
+
return { bytes, start: from };
|
|
44
|
+
}
|
|
45
|
+
if (response.ok) {
|
|
46
|
+
whole = await body(response);
|
|
47
|
+
return { bytes: whole, start: 0 };
|
|
48
|
+
}
|
|
49
|
+
throw new EgretError('ASSET_BUNDLE_FETCH_FAILED', { cause: new Error(String(response.status)) });
|
|
50
|
+
};
|
|
51
|
+
const cache = options.cache;
|
|
52
|
+
const indexKey = url + '#index';
|
|
53
|
+
const openIndex = async () => {
|
|
54
|
+
if (options.whole) {
|
|
55
|
+
whole = await fetchWhole();
|
|
56
|
+
return readAssetBundleIndex(whole);
|
|
57
|
+
}
|
|
58
|
+
// The header and a guess at the index in one request; a second when the index is longer.
|
|
59
|
+
const guess = 64 * 1024;
|
|
60
|
+
const first = await fetchRange(0, guess);
|
|
61
|
+
if (first.bytes.length < ASSET_BUNDLE_HEADER_BYTES)
|
|
62
|
+
throw new EgretError('ASSET_BUNDLE_FORMAT_INVALID');
|
|
63
|
+
const { indexBytes } = readAssetBundleHeader(first.bytes);
|
|
64
|
+
let head = first.bytes;
|
|
65
|
+
if (head.length < ASSET_BUNDLE_HEADER_BYTES + indexBytes)
|
|
66
|
+
head = (await fetchRange(0, ASSET_BUNDLE_HEADER_BYTES + indexBytes)).bytes;
|
|
67
|
+
const read = readAssetBundleIndex(head);
|
|
68
|
+
await cache?.put(indexKey, head.slice(0, ASSET_BUNDLE_HEADER_BYTES + indexBytes));
|
|
69
|
+
return read;
|
|
70
|
+
};
|
|
71
|
+
let index;
|
|
72
|
+
let offline = false;
|
|
73
|
+
try {
|
|
74
|
+
index = await openIndex();
|
|
75
|
+
}
|
|
76
|
+
catch (cause) {
|
|
77
|
+
// Without the network a kept index still opens the bundle; entries then come only from the cache.
|
|
78
|
+
const kept = cache && (await cache.match(indexKey));
|
|
79
|
+
if (!kept || (cause instanceof EgretError && cause.code === 'ASSET_BUNDLE_FORMAT_INVALID'))
|
|
80
|
+
throw cause;
|
|
81
|
+
index = readAssetBundleIndex(kept);
|
|
82
|
+
offline = true;
|
|
83
|
+
}
|
|
84
|
+
const entryKey = (name) => {
|
|
85
|
+
const entry = index.entries.find(e => e.name === name);
|
|
86
|
+
return url + '#' + name + '@' + (entry?.check ?? '');
|
|
87
|
+
};
|
|
88
|
+
const read = async (names) => {
|
|
89
|
+
const out = new Map();
|
|
90
|
+
const missing = [];
|
|
91
|
+
for (const name of names) {
|
|
92
|
+
const kept = cache && (await cache.match(entryKey(name)));
|
|
93
|
+
// A kept entry is checked like a fetched one, so a damaged cache is fetched past.
|
|
94
|
+
if (kept) {
|
|
95
|
+
try {
|
|
96
|
+
out.set(name, sliceAssetBundle(index, name, kept, index.entries.find(e => e.name === name).offset));
|
|
97
|
+
continue;
|
|
98
|
+
}
|
|
99
|
+
catch {
|
|
100
|
+
/* fetched again below */
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
missing.push(name);
|
|
104
|
+
}
|
|
105
|
+
if (missing.length && offline)
|
|
106
|
+
throw new EgretError('ASSET_BUNDLE_FETCH_FAILED', { cause: new Error('offline') });
|
|
107
|
+
for (const range of planAssetBundleRanges(index, missing)) {
|
|
108
|
+
const got = await fetchRange(range.start, range.end);
|
|
109
|
+
for (const name of range.names) {
|
|
110
|
+
const bytes = sliceAssetBundle(index, name, got.bytes, got.start);
|
|
111
|
+
out.set(name, bytes);
|
|
112
|
+
await cache?.put(entryKey(name), bytes);
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
return out;
|
|
116
|
+
};
|
|
117
|
+
return {
|
|
118
|
+
url,
|
|
119
|
+
index,
|
|
120
|
+
get ranged() {
|
|
121
|
+
return whole === undefined;
|
|
122
|
+
},
|
|
123
|
+
get transferred() {
|
|
124
|
+
return transferred;
|
|
125
|
+
},
|
|
126
|
+
get offline() {
|
|
127
|
+
return offline;
|
|
128
|
+
},
|
|
129
|
+
entries: (...tags) => index.entries.filter(entry => tags.every(tag => entry.tags.includes(tag))),
|
|
130
|
+
read,
|
|
131
|
+
async get(name) {
|
|
132
|
+
return (await read([name])).get(name);
|
|
133
|
+
}
|
|
134
|
+
};
|
|
135
|
+
}
|
|
136
|
+
//# sourceMappingURL=BrowserAssetBundle.js.map
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
import type { AudioBackend, AudioMixer, AudioMixerOptions } from '@egret/engine/audio';
|
|
2
|
+
/** Browser audio to make: its audio context, what unlocks it, whether it pauses when the page is hidden, and its limiter. */
|
|
3
|
+
export interface BrowserAudioOptions extends Omit<AudioMixerOptions, 'backend' | 'locked'> {
|
|
4
|
+
/** An output the page made. It is used as it is and is not closed with the mixer. Without it one is made. */
|
|
5
|
+
readonly context?: BaseAudioContext;
|
|
6
|
+
/** Where the first touch or key of the person is listened for. Defaults to the document. */
|
|
7
|
+
readonly unlockTarget?: EventTarget;
|
|
8
|
+
/** Silence while the page is hidden. Defaults to true. */
|
|
9
|
+
readonly pauseWhenHidden?: boolean;
|
|
10
|
+
/**
|
|
11
|
+
* Told what failed where nothing could be returned: in a listener of the page, or after the
|
|
12
|
+
* output was asked to start or stop. Without it the failure is reported to the page.
|
|
13
|
+
*/
|
|
14
|
+
readonly onError?: (cause: unknown) => void;
|
|
15
|
+
/**
|
|
16
|
+
* A limiter on the way out, so many sounds at once do not clip. `true` uses a gentle setting that leaves
|
|
17
|
+
* ordinary transients alone; an object sets the compressor itself. Off by default.
|
|
18
|
+
*/
|
|
19
|
+
readonly limiter?: boolean | BrowserAudioLimiter;
|
|
20
|
+
}
|
|
21
|
+
/** The compressor of the limiter, in its own units: decibels for threshold and knee, seconds for the times. */
|
|
22
|
+
export interface BrowserAudioLimiter {
|
|
23
|
+
readonly threshold?: number;
|
|
24
|
+
readonly knee?: number;
|
|
25
|
+
readonly ratio?: number;
|
|
26
|
+
readonly attack?: number;
|
|
27
|
+
readonly release?: number;
|
|
28
|
+
}
|
|
29
|
+
/** The Web Audio half of browser sound alone: its output, what unlocks it, whether it pauses when hidden, its limiter. */
|
|
30
|
+
export interface WebAudioBackendOptions {
|
|
31
|
+
readonly context?: BaseAudioContext;
|
|
32
|
+
readonly unlockTarget?: EventTarget;
|
|
33
|
+
readonly pauseWhenHidden?: boolean;
|
|
34
|
+
readonly onError?: (cause: unknown) => void;
|
|
35
|
+
readonly limiter?: boolean | BrowserAudioLimiter;
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* A backend for `createAudioMixer` that plays through Web Audio. Give `locked` to the mixer as it is made, and then the
|
|
39
|
+
* mixer to `attach`, so the lock follows the first touch and the sound pauses while the page is hidden.
|
|
40
|
+
*/
|
|
41
|
+
export interface WebAudioBackend extends AudioBackend {
|
|
42
|
+
readonly context: BaseAudioContext;
|
|
43
|
+
/** What every sound passes on its way out, once the mixer has made its master bus. */
|
|
44
|
+
readonly output: AudioNode | undefined;
|
|
45
|
+
/** Whether the output is waiting for the person to touch the page before it may sound. */
|
|
46
|
+
readonly locked: boolean;
|
|
47
|
+
/** The mixer made on this backend: its lock follows the output from now on. Once only. */
|
|
48
|
+
attach(mixer: AudioMixer): void;
|
|
49
|
+
}
|
|
50
|
+
/** A sound mixer playing through Web Audio, with its context and output node. */
|
|
51
|
+
export interface BrowserAudio {
|
|
52
|
+
readonly mixer: AudioMixer;
|
|
53
|
+
readonly context: BaseAudioContext;
|
|
54
|
+
/** What every sound passes on its way out. An analyser of the page can listen here. */
|
|
55
|
+
readonly output: AudioNode;
|
|
56
|
+
/** The same as disposing the mixer. A scope can own the sound of a game through this. */
|
|
57
|
+
dispose(): void;
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* A Web Audio backend for a mixer the page makes itself with `createAudioMixer`:
|
|
61
|
+
*
|
|
62
|
+
* const backend = createWebAudioBackend();
|
|
63
|
+
* const mixer = createAudioMixer({ backend, locked: backend.locked });
|
|
64
|
+
* backend.attach(mixer);
|
|
65
|
+
*
|
|
66
|
+
* `createBrowserAudio` does these three steps in one call.
|
|
67
|
+
*/
|
|
68
|
+
export declare function createWebAudioBackend(options?: WebAudioBackendOptions): WebAudioBackend;
|
|
69
|
+
/**
|
|
70
|
+
* Sound for a page on Web Audio. A page may not sound before the person has touched it: until
|
|
71
|
+
* then the mixer is locked, music asked for waits, and the first touch or key lets it start.
|
|
72
|
+
*/
|
|
73
|
+
export declare function createBrowserAudio(options?: BrowserAudioOptions): BrowserAudio;
|
|
74
|
+
//# sourceMappingURL=BrowserAudio.d.ts.map
|