@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,269 @@
|
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
// Surface descriptions consumed by the first-party shader library. All color
|
|
3
|
+
// values are linear RGB; factories accept 0xRRGGBB sRGB hex for convenience.
|
|
4
|
+
import { Resource3D, World3DError } from './core3D.js';
|
|
5
|
+
import { colorFromHex } from './math3D.js';
|
|
6
|
+
/** Makes a material drawn by shaders of your own. */
|
|
7
|
+
export function createCustomShader3D(input) {
|
|
8
|
+
if (!input || typeof input.key !== 'string' || input.key.length === 0 || /[\s|/]/.test(input.key))
|
|
9
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'shader key');
|
|
10
|
+
if (input.glsl === undefined &&
|
|
11
|
+
input.wgsl === undefined &&
|
|
12
|
+
input.glslVertex === undefined &&
|
|
13
|
+
input.wgslVertex === undefined &&
|
|
14
|
+
input.glslNormal === undefined &&
|
|
15
|
+
input.wgslNormal === undefined)
|
|
16
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'shader source');
|
|
17
|
+
const uniforms = new Float32Array(16);
|
|
18
|
+
if (input.uniforms)
|
|
19
|
+
uniforms.set(Array.from(input.uniforms).slice(0, 16));
|
|
20
|
+
return Object.freeze({
|
|
21
|
+
key: input.key,
|
|
22
|
+
...(input.glsl === undefined ? {} : { glsl: input.glsl }),
|
|
23
|
+
...(input.wgsl === undefined ? {} : { wgsl: input.wgsl }),
|
|
24
|
+
...(input.glslVertex === undefined ? {} : { glslVertex: input.glslVertex }),
|
|
25
|
+
...(input.wgslVertex === undefined ? {} : { wgslVertex: input.wgslVertex }),
|
|
26
|
+
...(input.glslNormal === undefined ? {} : { glslNormal: input.glslNormal }),
|
|
27
|
+
...(input.wgslNormal === undefined ? {} : { wgslNormal: input.wgslNormal }),
|
|
28
|
+
uniforms
|
|
29
|
+
});
|
|
30
|
+
}
|
|
31
|
+
/** Writes a color into a float array as red, green and blue. */
|
|
32
|
+
export function setColor3D(out, input) {
|
|
33
|
+
if (typeof input === 'number')
|
|
34
|
+
colorFromHex(out, input);
|
|
35
|
+
else if (Array.isArray(input) && input.length === 3 && input.every(Number.isFinite)) {
|
|
36
|
+
out[0] = input[0];
|
|
37
|
+
out[1] = input[1];
|
|
38
|
+
out[2] = input[2];
|
|
39
|
+
}
|
|
40
|
+
else
|
|
41
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'color');
|
|
42
|
+
return out;
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* One material class carries the superset of surface parameters; `shading`
|
|
46
|
+
* selects the lighting model. Assign fields freely and call touch() when a
|
|
47
|
+
* change alters shader features (maps added or removed, alpha mode, side).
|
|
48
|
+
* Scalar and color edits take effect on the next draw without touch().
|
|
49
|
+
*/
|
|
50
|
+
export class Material3D extends Resource3D {
|
|
51
|
+
shading;
|
|
52
|
+
color = new Float32Array([1, 1, 1]);
|
|
53
|
+
opacity = 1;
|
|
54
|
+
map;
|
|
55
|
+
side = 'front';
|
|
56
|
+
alphaMode = 'opaque';
|
|
57
|
+
/** Fragments below this alpha are discarded in 'mask' mode. */
|
|
58
|
+
alphaCutoff = 0.5;
|
|
59
|
+
/** How a blended fragment combines with what is behind it. Used only when `alphaMode` is 'blend'. */
|
|
60
|
+
blending = 'normal';
|
|
61
|
+
depthTest = true;
|
|
62
|
+
depthWrite = true;
|
|
63
|
+
/** Multiply the base color by the geometry's `color` attribute. */
|
|
64
|
+
vertexColors = false;
|
|
65
|
+
fog = true;
|
|
66
|
+
toneMapped = true;
|
|
67
|
+
visible = true;
|
|
68
|
+
emissive = new Float32Array([0, 0, 0]);
|
|
69
|
+
emissiveIntensity = 1;
|
|
70
|
+
emissiveMap;
|
|
71
|
+
normalMap;
|
|
72
|
+
normalScale = 1;
|
|
73
|
+
occlusionMap;
|
|
74
|
+
occlusionStrength = 1;
|
|
75
|
+
flatShading = false;
|
|
76
|
+
wireframe = false;
|
|
77
|
+
// Phong
|
|
78
|
+
specular = new Float32Array([0.07, 0.07, 0.07]);
|
|
79
|
+
shininess = 30;
|
|
80
|
+
/** Optional fragment hook. Call touch() after assigning a different shader. */
|
|
81
|
+
shader;
|
|
82
|
+
/**
|
|
83
|
+
* Baked lighting added to the indirect light of lit materials. It is sampled
|
|
84
|
+
* with the texture's `channel`, normally 1 for a second, non-overlapping UV set.
|
|
85
|
+
*/
|
|
86
|
+
lightMap;
|
|
87
|
+
lightMapIntensity = 1;
|
|
88
|
+
/**
|
|
89
|
+
* A mirror image of the scene for a flat reflective surface on a standard
|
|
90
|
+
* material, normally the texture of a PlanarReflection3D. It is read at
|
|
91
|
+
* the pixel's own place on screen, so the mesh needs no coordinates for
|
|
92
|
+
* it, and it takes the place of the environment map's reflection.
|
|
93
|
+
*/
|
|
94
|
+
reflectionMap;
|
|
95
|
+
reflectionStrength = 1;
|
|
96
|
+
/** How far the surface normal pushes the mirror image sideways, as a share of the screen. */
|
|
97
|
+
reflectionDistortion = 0.02;
|
|
98
|
+
/**
|
|
99
|
+
* For blended materials such as particles and haze: the distance over which
|
|
100
|
+
* the surface fades out where it comes close to the solid geometry behind
|
|
101
|
+
* it, instead of ending in a hard line. 0 turns the fade off.
|
|
102
|
+
*/
|
|
103
|
+
softness = 0;
|
|
104
|
+
/**
|
|
105
|
+
* Ground layers blended by a weight map, for terrain: up to four tiling
|
|
106
|
+
* textures, each shown where its channel of `weights` (R, G, B, A) is
|
|
107
|
+
* strong. Weights are read with the mesh's coordinates as they are and
|
|
108
|
+
* layers with those coordinates times their `repeat`. The layers take
|
|
109
|
+
* the texture slots of map, emissiveMap, occlusionMap, metallicRoughnessMap
|
|
110
|
+
* and lightMap, so leave those unset. Call touch() after assigning.
|
|
111
|
+
*/
|
|
112
|
+
splat;
|
|
113
|
+
/** Strength, 0 to 1, of a soft rim lobe for cloth and velvet on a standard material. */
|
|
114
|
+
sheen = 0;
|
|
115
|
+
sheenColor = new Float32Array([1, 1, 1]);
|
|
116
|
+
sheenRoughness = 0.5;
|
|
117
|
+
/**
|
|
118
|
+
* How much light passes through a standard material, 0 to 1, as for glass.
|
|
119
|
+
* What lies behind is drawn first and then seen through the surface,
|
|
120
|
+
* tinted by its color and blurred by its roughness. Such a material is
|
|
121
|
+
* drawn with the transparent objects whatever its alphaMode; other
|
|
122
|
+
* see-through and transparent objects behind it do not show through.
|
|
123
|
+
*/
|
|
124
|
+
transmission = 0;
|
|
125
|
+
/** Index of refraction for transmission: 1 does not bend light, 1.5 is glass, 1.33 water. */
|
|
126
|
+
ior = 1.5;
|
|
127
|
+
/** How far, in world units, light travels inside a transmitting object. Zero means a thin sheet that does not bend the view. */
|
|
128
|
+
thickness = 0;
|
|
129
|
+
/** Color white light takes on after travelling `attenuationDistance` inside a transmitting object. */
|
|
130
|
+
attenuationColor = new Float32Array([1, 1, 1]);
|
|
131
|
+
attenuationDistance = Infinity;
|
|
132
|
+
/** Strength, 0 to 1, of a clear lacquer layer over a standard material (car paint, varnish). */
|
|
133
|
+
clearcoat = 0;
|
|
134
|
+
clearcoatRoughness = 0.1;
|
|
135
|
+
/** Number of light bands for toon shading. */
|
|
136
|
+
toonSteps = 3;
|
|
137
|
+
// Standard (metallic-roughness PBR)
|
|
138
|
+
metallic = 0;
|
|
139
|
+
roughness = 1;
|
|
140
|
+
metallicRoughnessMap;
|
|
141
|
+
environmentIntensity = 1;
|
|
142
|
+
// Sprite and point rendering
|
|
143
|
+
billboard = false;
|
|
144
|
+
/** Treat vertex positions as normalized device coordinates; used by full-screen layers. */
|
|
145
|
+
screenSpace = false;
|
|
146
|
+
sizeAttenuation = true;
|
|
147
|
+
rotation = 0;
|
|
148
|
+
pointSize = 1;
|
|
149
|
+
/** Polygon offset to resolve coplanar decals: [factor, units]. */
|
|
150
|
+
polygonOffset;
|
|
151
|
+
constructor(shading, options = {}) {
|
|
152
|
+
super();
|
|
153
|
+
this.shading = shading;
|
|
154
|
+
this.name = options.name ?? '';
|
|
155
|
+
if (options.color !== undefined)
|
|
156
|
+
setColor3D(this.color, options.color);
|
|
157
|
+
if (options.emissive !== undefined)
|
|
158
|
+
setColor3D(this.emissive, options.emissive);
|
|
159
|
+
this.opacity = options.opacity ?? 1;
|
|
160
|
+
this.map = options.map;
|
|
161
|
+
this.side = options.side ?? 'front';
|
|
162
|
+
// Additive, multiply and premultiplied blending only take effect in the blended pass, so asking for one
|
|
163
|
+
// is asking for that pass.
|
|
164
|
+
this.alphaMode =
|
|
165
|
+
options.alphaMode ?? (this.opacity < 1 || (options.blending ?? 'normal') !== 'normal' ? 'blend' : 'opaque');
|
|
166
|
+
this.alphaCutoff = options.alphaCutoff ?? 0.5;
|
|
167
|
+
this.blending = options.blending ?? 'normal';
|
|
168
|
+
this.depthTest = options.depthTest ?? true;
|
|
169
|
+
this.depthWrite = options.depthWrite ?? this.alphaMode !== 'blend';
|
|
170
|
+
this.vertexColors = options.vertexColors ?? false;
|
|
171
|
+
this.fog = options.fog ?? true;
|
|
172
|
+
this.toneMapped = options.toneMapped ?? true;
|
|
173
|
+
this.emissiveIntensity = options.emissiveIntensity ?? 1;
|
|
174
|
+
this.emissiveMap = options.emissiveMap;
|
|
175
|
+
this.normalMap = options.normalMap;
|
|
176
|
+
this.normalScale = options.normalScale ?? 1;
|
|
177
|
+
this.occlusionMap = options.occlusionMap;
|
|
178
|
+
this.occlusionStrength = options.occlusionStrength ?? 1;
|
|
179
|
+
this.flatShading = options.flatShading ?? false;
|
|
180
|
+
this.wireframe = options.wireframe ?? false;
|
|
181
|
+
}
|
|
182
|
+
/** True when the material must be drawn in the sorted transparent pass. */
|
|
183
|
+
get isTransparent() {
|
|
184
|
+
return this.alphaMode === 'blend';
|
|
185
|
+
}
|
|
186
|
+
setColor(color) {
|
|
187
|
+
setColor3D(this.color, color);
|
|
188
|
+
return this;
|
|
189
|
+
}
|
|
190
|
+
setEmissive(color) {
|
|
191
|
+
setColor3D(this.emissive, color);
|
|
192
|
+
return this;
|
|
193
|
+
}
|
|
194
|
+
/** Independent copy sharing texture references. */
|
|
195
|
+
clone() {
|
|
196
|
+
const copy = new Material3D(this.shading);
|
|
197
|
+
const skip = new Set(['id', 'shading', 'color', 'emissive', 'specular', 'sheenColor', 'attenuationColor']);
|
|
198
|
+
for (const key of Object.keys(this)) {
|
|
199
|
+
if (!skip.has(key))
|
|
200
|
+
copy[key] = this[key];
|
|
201
|
+
}
|
|
202
|
+
copy.color.set(this.color);
|
|
203
|
+
copy.emissive.set(this.emissive);
|
|
204
|
+
copy.specular.set(this.specular);
|
|
205
|
+
copy.sheenColor.set(this.sheenColor);
|
|
206
|
+
copy.attenuationColor.set(this.attenuationColor);
|
|
207
|
+
return copy;
|
|
208
|
+
}
|
|
209
|
+
}
|
|
210
|
+
/** Constant color, unaffected by lights. */
|
|
211
|
+
export function createUnlitMaterial3D(options = {}) {
|
|
212
|
+
return new Material3D('unlit', options);
|
|
213
|
+
}
|
|
214
|
+
/** Diffuse-only lighting; the cheapest lit model. */
|
|
215
|
+
export function createLambertMaterial3D(options = {}) {
|
|
216
|
+
return new Material3D('lambert', options);
|
|
217
|
+
}
|
|
218
|
+
/** Diffuse plus Blinn-Phong specular highlights. */
|
|
219
|
+
export function createPhongMaterial3D(options = {}) {
|
|
220
|
+
const material = new Material3D('phong', options);
|
|
221
|
+
if (options.specular !== undefined)
|
|
222
|
+
setColor3D(material.specular, options.specular);
|
|
223
|
+
material.shininess = options.shininess ?? 30;
|
|
224
|
+
return material;
|
|
225
|
+
}
|
|
226
|
+
/** Cel shading: diffuse light quantized into `steps` flat bands. */
|
|
227
|
+
export function createToonMaterial3D(options = {}) {
|
|
228
|
+
const material = new Material3D('toon', options);
|
|
229
|
+
material.toonSteps = Math.max(1, Math.floor(options.steps ?? 3));
|
|
230
|
+
return material;
|
|
231
|
+
}
|
|
232
|
+
/**
|
|
233
|
+
* Lighting baked into a sphere image: the surface color is looked up by the
|
|
234
|
+
* view-space normal, so no lights are needed. The image is held in `emissiveMap`.
|
|
235
|
+
*/
|
|
236
|
+
export function createMatcapMaterial3D(options) {
|
|
237
|
+
const material = new Material3D('matcap', options);
|
|
238
|
+
material.emissiveMap = options.matcap;
|
|
239
|
+
return material;
|
|
240
|
+
}
|
|
241
|
+
/**
|
|
242
|
+
* A standard material set up as glass: smooth and see-through, with
|
|
243
|
+
* reflections kept. Give it a `thickness` to bend the view like a solid block.
|
|
244
|
+
*/
|
|
245
|
+
export function createGlassMaterial3D(options = {}) {
|
|
246
|
+
const material = createStandardMaterial3D({ roughness: 0.05, metallic: 0, ...options });
|
|
247
|
+
material.transmission = options.transmission ?? 1;
|
|
248
|
+
material.ior = options.ior ?? 1.5;
|
|
249
|
+
material.thickness = options.thickness ?? 0;
|
|
250
|
+
return material;
|
|
251
|
+
}
|
|
252
|
+
/** Physically based metallic-roughness model, matching glTF 2.0 materials. */
|
|
253
|
+
export function createStandardMaterial3D(options = {}) {
|
|
254
|
+
const material = new Material3D('standard', options);
|
|
255
|
+
material.metallic = options.metallic ?? 0;
|
|
256
|
+
material.roughness = options.roughness ?? 1;
|
|
257
|
+
material.metallicRoughnessMap = options.metallicRoughnessMap;
|
|
258
|
+
material.environmentIntensity = options.environmentIntensity ?? 1;
|
|
259
|
+
return material;
|
|
260
|
+
}
|
|
261
|
+
/** Camera-facing unlit quad material for Sprite3D. */
|
|
262
|
+
export function createSpriteMaterial3D(options = {}) {
|
|
263
|
+
const material = new Material3D('unlit', { alphaMode: 'blend', side: 'double', ...options });
|
|
264
|
+
material.billboard = true;
|
|
265
|
+
material.sizeAttenuation = options.sizeAttenuation ?? true;
|
|
266
|
+
material.rotation = options.rotation ?? 0;
|
|
267
|
+
return material;
|
|
268
|
+
}
|
|
269
|
+
//# sourceMappingURL=Material3D.js.map
|
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
import { Geometry3D } from './Geometry3D.js';
|
|
2
|
+
import { Material3D } from './Material3D.js';
|
|
3
|
+
import type { SpriteMaterialOptions3D } from './Material3D.js';
|
|
4
|
+
import { Object3D } from './Object3D.js';
|
|
5
|
+
/** The most bones, instances and materials a mesh has. */
|
|
6
|
+
export declare const MESH3D_LIMITS: Readonly<{
|
|
7
|
+
readonly maxBones: 1024;
|
|
8
|
+
readonly maxInstances: 1048576;
|
|
9
|
+
readonly maxMaterials: 64;
|
|
10
|
+
}>;
|
|
11
|
+
/** A bone of a skeleton. */
|
|
12
|
+
export declare class Bone3D extends Object3D {
|
|
13
|
+
constructor();
|
|
14
|
+
}
|
|
15
|
+
/** Ordered bones with their inverse bind matrices; one instance may drive many meshes. */
|
|
16
|
+
export declare class Skeleton3D {
|
|
17
|
+
#private;
|
|
18
|
+
readonly bones: readonly Object3D[];
|
|
19
|
+
/** 16 floats per bone: bind-pose mesh space to bone space. */
|
|
20
|
+
readonly inverseBindMatrices: Float32Array;
|
|
21
|
+
/** 16 floats per bone: boneWorld * inverseBind, refreshed by update(). */
|
|
22
|
+
readonly boneMatrices: Float32Array;
|
|
23
|
+
/** Increases on every update(); backends compare it before re-uploading. */
|
|
24
|
+
version: number;
|
|
25
|
+
constructor(bones: readonly Object3D[], inverseBindMatrices?: Float32Array);
|
|
26
|
+
/** Recompute skinning matrices once per frame id; later calls in the same frame are free. */
|
|
27
|
+
update(frame: number): void;
|
|
28
|
+
}
|
|
29
|
+
/** A geometry drawn with materials, with its morph weights and skeleton. */
|
|
30
|
+
export declare class Mesh3D extends Object3D {
|
|
31
|
+
#private;
|
|
32
|
+
/** Optional hook the render list calls once per frame before the mesh is culled and sorted. */
|
|
33
|
+
beforeRender?(camera: import('./Camera3D.js').Camera3D): void;
|
|
34
|
+
geometry: Geometry3D;
|
|
35
|
+
/** false leaves the mesh out of ray picking, as for effects whose drawn shape is not their geometry. */
|
|
36
|
+
pickable: boolean;
|
|
37
|
+
/** One material, or one per geometry group addressed by materialIndex. */
|
|
38
|
+
material: Material3D | Material3D[];
|
|
39
|
+
/** Weight per geometry morph target; resized automatically to the target count. */
|
|
40
|
+
morphWeights: Float32Array;
|
|
41
|
+
skeleton: Skeleton3D | undefined;
|
|
42
|
+
/** Mesh-space to skeleton-space matrix captured at bind time. */
|
|
43
|
+
readonly bindMatrix: Float32Array;
|
|
44
|
+
constructor(geometry?: Geometry3D, material?: Material3D | Material3D[]);
|
|
45
|
+
get isInstanced(): boolean;
|
|
46
|
+
/**
|
|
47
|
+
* True when an instanced draw could stand in for this mesh: it is a plain
|
|
48
|
+
* Mesh3D without skinning or morphing, and its transform is not mirrored.
|
|
49
|
+
* The renderer uses it to fold repeated meshes into one draw.
|
|
50
|
+
*/
|
|
51
|
+
get canInstance(): boolean;
|
|
52
|
+
/** Material for a geometry group index, falling back to the first slot. */
|
|
53
|
+
materialAt(index: number): Material3D;
|
|
54
|
+
/** Keep the weight array the same length as the geometry's morph target list. */
|
|
55
|
+
syncMorphWeights(): void;
|
|
56
|
+
/** Attach a skeleton; the current world matrix becomes the bind matrix. */
|
|
57
|
+
bind(skeleton: Skeleton3D, bindMatrix?: ArrayLike<number>): this;
|
|
58
|
+
/**
|
|
59
|
+
* World-space bounding sphere [x, y, z, radius], cached per geometry and
|
|
60
|
+
* world version. Skinned meshes are bounded by their bones instead.
|
|
61
|
+
*/
|
|
62
|
+
get worldBoundingSphere(): Float32Array;
|
|
63
|
+
private skinnedBounds;
|
|
64
|
+
clone(recursive?: boolean): this;
|
|
65
|
+
protected copyFrom(source: this): void;
|
|
66
|
+
}
|
|
67
|
+
interface InstanceStreamRevisions {
|
|
68
|
+
observed: number;
|
|
69
|
+
matrices: number;
|
|
70
|
+
colors: number;
|
|
71
|
+
}
|
|
72
|
+
declare const readInstanceStreamRevisions: unique symbol;
|
|
73
|
+
/** Reconcile legacy bulk edits before a renderer checks either instance stream. */
|
|
74
|
+
export declare function instanceStreamRevisions3D(mesh: InstancedMesh3D): Readonly<InstanceStreamRevisions>;
|
|
75
|
+
/** Draw one geometry many times in a single call with per-instance transforms and colors. */
|
|
76
|
+
export declare class InstancedMesh3D extends Mesh3D {
|
|
77
|
+
#private;
|
|
78
|
+
readonly capacity: number;
|
|
79
|
+
/** Number of instances drawn; at most `capacity`. */
|
|
80
|
+
count: number;
|
|
81
|
+
/** 16 floats per instance, relative to this node. */
|
|
82
|
+
readonly instanceMatrices: Float32Array;
|
|
83
|
+
/** Optional linear RGB (or RGBA) per instance, created on first setColorAt(). */
|
|
84
|
+
instanceColors: Float32Array | undefined;
|
|
85
|
+
/** Components per instance color: 3 for RGB, 4 when instances also carry opacity. */
|
|
86
|
+
readonly instanceColorSize: 3 | 4;
|
|
87
|
+
/** Bump after editing instance arrays directly. */
|
|
88
|
+
instanceVersion: number;
|
|
89
|
+
/** Multiplies each instance's bounding radius, for instances that move beyond the geometry, such as animated ones. */
|
|
90
|
+
boundsScale: number;
|
|
91
|
+
constructor(geometry: Geometry3D, material: Material3D | Material3D[], capacity: number, instanceColorSize?: 3 | 4);
|
|
92
|
+
get isInstanced(): boolean;
|
|
93
|
+
setMatrixAt(index: number, matrix: ArrayLike<number>): void;
|
|
94
|
+
setTransformAt(index: number, position: ArrayLike<number>, quaternion?: ArrayLike<number>, scale?: ArrayLike<number> | number): void;
|
|
95
|
+
setColorAt(index: number, r: number, g: number, b: number, a?: number): void;
|
|
96
|
+
[readInstanceStreamRevisions](): InstanceStreamRevisions;
|
|
97
|
+
private touchInstanceStream;
|
|
98
|
+
/** Sphere enclosing every instance, in world space. */
|
|
99
|
+
get worldBoundingSphere(): Float32Array;
|
|
100
|
+
private readonly localSphere;
|
|
101
|
+
clone(): this;
|
|
102
|
+
}
|
|
103
|
+
/** Camera-facing textured quad. Scale the node to size it; all sprites share one quad geometry. */
|
|
104
|
+
export declare class Sprite3D extends Mesh3D {
|
|
105
|
+
constructor(material?: Material3D);
|
|
106
|
+
get worldBoundingSphere(): Float32Array;
|
|
107
|
+
clone(): this;
|
|
108
|
+
}
|
|
109
|
+
/** Makes a sprite: a picture that always faces the camera. */
|
|
110
|
+
export declare function createSprite3D(options?: SpriteMaterialOptions3D): Sprite3D;
|
|
111
|
+
export {};
|
|
112
|
+
//# sourceMappingURL=Mesh3D.d.ts.map
|