@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,84 @@
|
|
|
1
|
+
import type { ColorInput3D } from './Material3D.js';
|
|
2
|
+
import { Object3D } from './Object3D.js';
|
|
3
|
+
/** The kind of a light: ambient, hemisphere, directional, point or spot. */
|
|
4
|
+
export type LightType3D = 'ambient' | 'hemisphere' | 'directional' | 'point' | 'spot';
|
|
5
|
+
/** The most directional, point, tiled point and spot lights a scene lights, and the most shadows. */
|
|
6
|
+
export declare const LIGHT3D_LIMITS: Readonly<{
|
|
7
|
+
readonly maxDirectional: 4;
|
|
8
|
+
readonly maxPoint: 8;
|
|
9
|
+
/** Point lights with a range lit through the tiled list, beyond the eight lit directly. */
|
|
10
|
+
readonly maxTiledPoint: 256;
|
|
11
|
+
readonly maxSpot: 4;
|
|
12
|
+
readonly maxShadows: 4;
|
|
13
|
+
}>;
|
|
14
|
+
/** How a light casts shadows: its map size, biases, range, extent, softness and cascades. */
|
|
15
|
+
export interface LightShadow3D {
|
|
16
|
+
/** Edge of this light's square tile in the shared shadow atlas, in texels. */
|
|
17
|
+
mapSize: number;
|
|
18
|
+
/** Constant depth offset against shadow acne. */
|
|
19
|
+
bias: number;
|
|
20
|
+
/** Offset along the surface normal, in world units. */
|
|
21
|
+
normalBias: number;
|
|
22
|
+
near: number;
|
|
23
|
+
far: number;
|
|
24
|
+
/** Half extent of the orthographic volume used by directional lights. */
|
|
25
|
+
extent: number;
|
|
26
|
+
/** Percentage-closer filter radius in texels; 0 samples once. */
|
|
27
|
+
radius: number;
|
|
28
|
+
/**
|
|
29
|
+
* Number of cascades for a directional light, 1 to 4. Each cascade takes
|
|
30
|
+
* one atlas tile and follows the camera, so `extent` is ignored above 1.
|
|
31
|
+
* Only the first cascaded directional light in a scene is split.
|
|
32
|
+
*/
|
|
33
|
+
cascades: number;
|
|
34
|
+
/** Distance from the camera, in world units, that cascaded shadows cover. */
|
|
35
|
+
cascadeDistance: number;
|
|
36
|
+
/** Split distribution: 0 spaces cascades evenly, 1 logarithmically. */
|
|
37
|
+
cascadeLambda: number;
|
|
38
|
+
}
|
|
39
|
+
/** A light to make: its color and intensity, and whether it casts shadows. */
|
|
40
|
+
export interface LightOptions3D {
|
|
41
|
+
readonly color?: ColorInput3D;
|
|
42
|
+
readonly intensity?: number;
|
|
43
|
+
readonly castShadow?: boolean;
|
|
44
|
+
}
|
|
45
|
+
/** A point light to make: how far it reaches. */
|
|
46
|
+
export interface PointLightOptions3D extends LightOptions3D {
|
|
47
|
+
/** Distance at which the light fades to zero; 0 means unbounded inverse-square falloff. */
|
|
48
|
+
readonly range?: number;
|
|
49
|
+
}
|
|
50
|
+
/** A spot light to make: its cone's angle and soft edge. */
|
|
51
|
+
export interface SpotLightOptions3D extends PointLightOptions3D {
|
|
52
|
+
/** Half angle of the cone in radians. */
|
|
53
|
+
readonly angle?: number;
|
|
54
|
+
/** Fraction of the cone over which intensity falls off, in [0, 1]. */
|
|
55
|
+
readonly penumbra?: number;
|
|
56
|
+
}
|
|
57
|
+
/** A light in a scene: its kind and its shadow. */
|
|
58
|
+
export declare class Light3D extends Object3D {
|
|
59
|
+
readonly lightType: LightType3D;
|
|
60
|
+
readonly color: Float32Array<ArrayBuffer>;
|
|
61
|
+
intensity: number;
|
|
62
|
+
/** Lower hemisphere color for hemisphere lights. */
|
|
63
|
+
readonly groundColor: Float32Array<ArrayBuffer>;
|
|
64
|
+
range: number;
|
|
65
|
+
angle: number;
|
|
66
|
+
penumbra: number;
|
|
67
|
+
readonly shadow: LightShadow3D;
|
|
68
|
+
constructor(lightType?: LightType3D);
|
|
69
|
+
clone(recursive?: boolean): this;
|
|
70
|
+
protected copyFrom(source: this): void;
|
|
71
|
+
}
|
|
72
|
+
/** Uniform light from every direction. */
|
|
73
|
+
export declare function createAmbientLight3D(options?: LightOptions3D): Light3D;
|
|
74
|
+
/** Sky color from above blending to a ground color from below (world Y axis). */
|
|
75
|
+
export declare function createHemisphereLight3D(options?: LightOptions3D & {
|
|
76
|
+
readonly groundColor?: ColorInput3D;
|
|
77
|
+
}): Light3D;
|
|
78
|
+
/** Parallel rays, such as sunlight. Aim it with lookAt(). */
|
|
79
|
+
export declare function createDirectionalLight3D(options?: LightOptions3D): Light3D;
|
|
80
|
+
/** Makes a light that shines from a point in every direction. */
|
|
81
|
+
export declare function createPointLight3D(options?: PointLightOptions3D): Light3D;
|
|
82
|
+
/** Makes a light that shines from a point in a cone. */
|
|
83
|
+
export declare function createSpotLight3D(options?: SpotLightOptions3D): Light3D;
|
|
84
|
+
//# sourceMappingURL=Light3D.d.ts.map
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
// Light nodes. Directional and spot lights shine along their local negative
|
|
3
|
+
// Z axis, matching cameras and glTF punctual lights. Colors are linear RGB.
|
|
4
|
+
import { setColor3D } from './Material3D.js';
|
|
5
|
+
import { Object3D } from './Object3D.js';
|
|
6
|
+
/** The most directional, point, tiled point and spot lights a scene lights, and the most shadows. */
|
|
7
|
+
export const LIGHT3D_LIMITS = Object.freeze({
|
|
8
|
+
maxDirectional: 4,
|
|
9
|
+
maxPoint: 8,
|
|
10
|
+
/** Point lights with a range lit through the tiled list, beyond the eight lit directly. */
|
|
11
|
+
maxTiledPoint: 256,
|
|
12
|
+
maxSpot: 4,
|
|
13
|
+
maxShadows: 4
|
|
14
|
+
});
|
|
15
|
+
/** A light in a scene: its kind and its shadow. */
|
|
16
|
+
export class Light3D extends Object3D {
|
|
17
|
+
lightType;
|
|
18
|
+
color = new Float32Array([1, 1, 1]);
|
|
19
|
+
intensity = 1;
|
|
20
|
+
/** Lower hemisphere color for hemisphere lights. */
|
|
21
|
+
groundColor = new Float32Array([0, 0, 0]);
|
|
22
|
+
range = 0;
|
|
23
|
+
angle = Math.PI / 4;
|
|
24
|
+
penumbra = 0.1;
|
|
25
|
+
shadow = {
|
|
26
|
+
mapSize: 1024,
|
|
27
|
+
bias: 0.0005,
|
|
28
|
+
normalBias: 0.02,
|
|
29
|
+
near: 0.1,
|
|
30
|
+
far: 100,
|
|
31
|
+
extent: 10,
|
|
32
|
+
radius: 1,
|
|
33
|
+
cascades: 1,
|
|
34
|
+
cascadeDistance: 100,
|
|
35
|
+
cascadeLambda: 0.7
|
|
36
|
+
};
|
|
37
|
+
constructor(lightType = 'directional') {
|
|
38
|
+
super('light');
|
|
39
|
+
this.lightType = lightType;
|
|
40
|
+
this.castShadow = false;
|
|
41
|
+
}
|
|
42
|
+
clone(recursive = true) {
|
|
43
|
+
const copy = new Light3D(this.lightType);
|
|
44
|
+
copy.copyFrom(this);
|
|
45
|
+
if (recursive)
|
|
46
|
+
for (const child of this.children)
|
|
47
|
+
copy.addChild(child.clone(true));
|
|
48
|
+
return copy;
|
|
49
|
+
}
|
|
50
|
+
copyFrom(source) {
|
|
51
|
+
super.copyFrom(source);
|
|
52
|
+
this.color.set(source.color);
|
|
53
|
+
this.groundColor.set(source.groundColor);
|
|
54
|
+
this.intensity = source.intensity;
|
|
55
|
+
this.range = source.range;
|
|
56
|
+
this.angle = source.angle;
|
|
57
|
+
this.penumbra = source.penumbra;
|
|
58
|
+
Object.assign(this.shadow, source.shadow);
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
function base(light, options) {
|
|
62
|
+
if (options.color !== undefined)
|
|
63
|
+
setColor3D(light.color, options.color);
|
|
64
|
+
light.intensity = options.intensity ?? 1;
|
|
65
|
+
light.castShadow = options.castShadow ?? false;
|
|
66
|
+
return light;
|
|
67
|
+
}
|
|
68
|
+
/** Uniform light from every direction. */
|
|
69
|
+
export function createAmbientLight3D(options = {}) {
|
|
70
|
+
return base(new Light3D('ambient'), { ...options, castShadow: false });
|
|
71
|
+
}
|
|
72
|
+
/** Sky color from above blending to a ground color from below (world Y axis). */
|
|
73
|
+
export function createHemisphereLight3D(options = {}) {
|
|
74
|
+
const light = base(new Light3D('hemisphere'), { ...options, castShadow: false });
|
|
75
|
+
if (options.groundColor !== undefined)
|
|
76
|
+
setColor3D(light.groundColor, options.groundColor);
|
|
77
|
+
return light;
|
|
78
|
+
}
|
|
79
|
+
/** Parallel rays, such as sunlight. Aim it with lookAt(). */
|
|
80
|
+
export function createDirectionalLight3D(options = {}) {
|
|
81
|
+
return base(new Light3D('directional'), options);
|
|
82
|
+
}
|
|
83
|
+
/** Makes a light that shines from a point in every direction. */
|
|
84
|
+
export function createPointLight3D(options = {}) {
|
|
85
|
+
const light = base(new Light3D('point'), options);
|
|
86
|
+
light.range = options.range ?? 0;
|
|
87
|
+
return light;
|
|
88
|
+
}
|
|
89
|
+
/** Makes a light that shines from a point in a cone. */
|
|
90
|
+
export function createSpotLight3D(options = {}) {
|
|
91
|
+
const light = base(new Light3D('spot'), options);
|
|
92
|
+
light.range = options.range ?? 0;
|
|
93
|
+
light.angle = options.angle ?? Math.PI / 4;
|
|
94
|
+
light.penumbra = options.penumbra ?? 0.1;
|
|
95
|
+
return light;
|
|
96
|
+
}
|
|
97
|
+
//# sourceMappingURL=Light3D.js.map
|
|
@@ -0,0 +1,253 @@
|
|
|
1
|
+
import { Resource3D } from './core3D.js';
|
|
2
|
+
import type { Texture3D } from './Texture3D.js';
|
|
3
|
+
/**
|
|
4
|
+
* A fragment hook that post-processes a material's shaded color. Supply the
|
|
5
|
+
* function in each shading language you target:
|
|
6
|
+
* GLSL: vec4 customFragment(vec4 color, vec3 worldPosition, vec3 normal, vec2 uv) reading uCustom[0..3]
|
|
7
|
+
* WGSL: fn customFragment(color: vec4f, worldPosition: vec3f, normal: vec3f, uv: vec2f) -> vec4f reading material.custom[0..3]
|
|
8
|
+
* `color` is linear and not yet fogged or tone mapped; return the new color and alpha.
|
|
9
|
+
* A backend without source for its language draws the material unchanged.
|
|
10
|
+
*
|
|
11
|
+
* A vertex hook displaces vertices in world space, in the visible pass and in
|
|
12
|
+
* shadow maps alike, so swaying foliage casts swaying shadows:
|
|
13
|
+
* GLSL: vec3 customVertex(vec3 worldPosition, vec3 localPosition, vec3 normal, vec2 uv, vec4 color)
|
|
14
|
+
* WGSL: fn customVertex(worldPosition: vec3f, localPosition: vec3f, normal: vec3f, uv: vec2f, color: vec4f) -> vec3f
|
|
15
|
+
* Return the new world position. Use only the arguments and the custom
|
|
16
|
+
* parameters; per-frame camera data is not available while drawing shadows.
|
|
17
|
+
* `color` is the vertex color when the material enables vertexColors, else white.
|
|
18
|
+
*
|
|
19
|
+
* A normal hook replaces the shading normal of a lit material before any
|
|
20
|
+
* light is computed, for surfaces whose detail is a formula rather than a
|
|
21
|
+
* texture, such as ripples on water:
|
|
22
|
+
* GLSL: vec3 customNormal(vec3 normal, vec3 worldPosition, vec2 uv)
|
|
23
|
+
* WGSL: fn customNormal(normal: vec3f, worldPosition: vec3f, uv: vec2f) -> vec3f
|
|
24
|
+
* The result is normalized for you.
|
|
25
|
+
*/
|
|
26
|
+
export interface CustomShader3D {
|
|
27
|
+
/** Identifies the source; materials with the same key share compiled programs. */
|
|
28
|
+
readonly key: string;
|
|
29
|
+
readonly glsl?: string;
|
|
30
|
+
readonly wgsl?: string;
|
|
31
|
+
readonly glslVertex?: string;
|
|
32
|
+
readonly wgslVertex?: string;
|
|
33
|
+
readonly glslNormal?: string;
|
|
34
|
+
readonly wgslNormal?: string;
|
|
35
|
+
/** Four vec4 parameters, written by the application (time, colors, thresholds). */
|
|
36
|
+
readonly uniforms: Float32Array;
|
|
37
|
+
}
|
|
38
|
+
/** Makes a material drawn by shaders of your own. */
|
|
39
|
+
export declare function createCustomShader3D(input: {
|
|
40
|
+
readonly key: string;
|
|
41
|
+
readonly glsl?: string;
|
|
42
|
+
readonly wgsl?: string;
|
|
43
|
+
readonly glslVertex?: string;
|
|
44
|
+
readonly wgslVertex?: string;
|
|
45
|
+
readonly glslNormal?: string;
|
|
46
|
+
readonly wgslNormal?: string;
|
|
47
|
+
readonly uniforms?: ArrayLike<number>;
|
|
48
|
+
}): CustomShader3D;
|
|
49
|
+
/** How a material is lit: not at all, Lambert, Phong, physically based, toon, or by a matcap. */
|
|
50
|
+
export type Shading3D = 'unlit' | 'lambert' | 'phong' | 'standard' | 'toon' | 'matcap';
|
|
51
|
+
/** Which sides of a material's triangles are drawn. */
|
|
52
|
+
export type Side3D = 'front' | 'back' | 'double';
|
|
53
|
+
/** How a material's alpha is used: ignored, cut at a threshold, or blended. */
|
|
54
|
+
export type AlphaMode3D = 'opaque' | 'mask' | 'blend';
|
|
55
|
+
/** How a material's color mixes with what is behind it. */
|
|
56
|
+
export type Blending3D = 'normal' | 'additive' | 'multiply' | 'premultiplied';
|
|
57
|
+
/** A color as 0xRRGGBB sRGB hex or linear RGB components. */
|
|
58
|
+
export type ColorInput3D = number | readonly [number, number, number];
|
|
59
|
+
/** A material to make: its color and maps, its sides and alpha, its blending and depth, and its emission, normals and occlusion. */
|
|
60
|
+
export interface MaterialOptions3D {
|
|
61
|
+
readonly name?: string;
|
|
62
|
+
readonly color?: ColorInput3D;
|
|
63
|
+
readonly opacity?: number;
|
|
64
|
+
readonly map?: Texture3D;
|
|
65
|
+
readonly side?: Side3D;
|
|
66
|
+
readonly alphaMode?: AlphaMode3D;
|
|
67
|
+
readonly alphaCutoff?: number;
|
|
68
|
+
/** Anything but 'normal' also makes 'blend' the default `alphaMode`. */
|
|
69
|
+
readonly blending?: Blending3D;
|
|
70
|
+
readonly depthTest?: boolean;
|
|
71
|
+
readonly depthWrite?: boolean;
|
|
72
|
+
readonly vertexColors?: boolean;
|
|
73
|
+
readonly fog?: boolean;
|
|
74
|
+
readonly toneMapped?: boolean;
|
|
75
|
+
readonly emissive?: ColorInput3D;
|
|
76
|
+
readonly emissiveIntensity?: number;
|
|
77
|
+
readonly emissiveMap?: Texture3D;
|
|
78
|
+
readonly normalMap?: Texture3D;
|
|
79
|
+
readonly normalScale?: number;
|
|
80
|
+
readonly occlusionMap?: Texture3D;
|
|
81
|
+
readonly occlusionStrength?: number;
|
|
82
|
+
readonly flatShading?: boolean;
|
|
83
|
+
readonly wireframe?: boolean;
|
|
84
|
+
}
|
|
85
|
+
/** A Phong material's specular color and shininess. */
|
|
86
|
+
export interface PhongMaterialOptions3D extends MaterialOptions3D {
|
|
87
|
+
readonly specular?: ColorInput3D;
|
|
88
|
+
readonly shininess?: number;
|
|
89
|
+
}
|
|
90
|
+
/** A physically based material's metalness and roughness, and how much the environment lights it. */
|
|
91
|
+
export interface StandardMaterialOptions3D extends MaterialOptions3D {
|
|
92
|
+
readonly metallic?: number;
|
|
93
|
+
readonly roughness?: number;
|
|
94
|
+
/** Roughness in G and metallic in B, as in glTF. */
|
|
95
|
+
readonly metallicRoughnessMap?: Texture3D;
|
|
96
|
+
readonly environmentIntensity?: number;
|
|
97
|
+
}
|
|
98
|
+
/** A sprite material: whether sprites shrink with distance, and their rotation. */
|
|
99
|
+
export interface SpriteMaterialOptions3D extends MaterialOptions3D {
|
|
100
|
+
/** Keep a constant on-screen size regardless of distance. */
|
|
101
|
+
readonly sizeAttenuation?: boolean;
|
|
102
|
+
/** Rotation about the view axis in radians. */
|
|
103
|
+
readonly rotation?: number;
|
|
104
|
+
}
|
|
105
|
+
/** Writes a color into a float array as red, green and blue. */
|
|
106
|
+
export declare function setColor3D(out: Float32Array, input: ColorInput3D): Float32Array;
|
|
107
|
+
/**
|
|
108
|
+
* One material class carries the superset of surface parameters; `shading`
|
|
109
|
+
* selects the lighting model. Assign fields freely and call touch() when a
|
|
110
|
+
* change alters shader features (maps added or removed, alpha mode, side).
|
|
111
|
+
* Scalar and color edits take effect on the next draw without touch().
|
|
112
|
+
*/
|
|
113
|
+
export declare class Material3D extends Resource3D {
|
|
114
|
+
readonly shading: Shading3D;
|
|
115
|
+
readonly color: Float32Array<ArrayBuffer>;
|
|
116
|
+
opacity: number;
|
|
117
|
+
map: Texture3D | undefined;
|
|
118
|
+
side: Side3D;
|
|
119
|
+
alphaMode: AlphaMode3D;
|
|
120
|
+
/** Fragments below this alpha are discarded in 'mask' mode. */
|
|
121
|
+
alphaCutoff: number;
|
|
122
|
+
/** How a blended fragment combines with what is behind it. Used only when `alphaMode` is 'blend'. */
|
|
123
|
+
blending: Blending3D;
|
|
124
|
+
depthTest: boolean;
|
|
125
|
+
depthWrite: boolean;
|
|
126
|
+
/** Multiply the base color by the geometry's `color` attribute. */
|
|
127
|
+
vertexColors: boolean;
|
|
128
|
+
fog: boolean;
|
|
129
|
+
toneMapped: boolean;
|
|
130
|
+
visible: boolean;
|
|
131
|
+
readonly emissive: Float32Array<ArrayBuffer>;
|
|
132
|
+
emissiveIntensity: number;
|
|
133
|
+
emissiveMap: Texture3D | undefined;
|
|
134
|
+
normalMap: Texture3D | undefined;
|
|
135
|
+
normalScale: number;
|
|
136
|
+
occlusionMap: Texture3D | undefined;
|
|
137
|
+
occlusionStrength: number;
|
|
138
|
+
flatShading: boolean;
|
|
139
|
+
wireframe: boolean;
|
|
140
|
+
readonly specular: Float32Array<ArrayBuffer>;
|
|
141
|
+
shininess: number;
|
|
142
|
+
/** Optional fragment hook. Call touch() after assigning a different shader. */
|
|
143
|
+
shader: CustomShader3D | undefined;
|
|
144
|
+
/**
|
|
145
|
+
* Baked lighting added to the indirect light of lit materials. It is sampled
|
|
146
|
+
* with the texture's `channel`, normally 1 for a second, non-overlapping UV set.
|
|
147
|
+
*/
|
|
148
|
+
lightMap: Texture3D | undefined;
|
|
149
|
+
lightMapIntensity: number;
|
|
150
|
+
/**
|
|
151
|
+
* A mirror image of the scene for a flat reflective surface on a standard
|
|
152
|
+
* material, normally the texture of a PlanarReflection3D. It is read at
|
|
153
|
+
* the pixel's own place on screen, so the mesh needs no coordinates for
|
|
154
|
+
* it, and it takes the place of the environment map's reflection.
|
|
155
|
+
*/
|
|
156
|
+
reflectionMap: Texture3D | undefined;
|
|
157
|
+
reflectionStrength: number;
|
|
158
|
+
/** How far the surface normal pushes the mirror image sideways, as a share of the screen. */
|
|
159
|
+
reflectionDistortion: number;
|
|
160
|
+
/**
|
|
161
|
+
* For blended materials such as particles and haze: the distance over which
|
|
162
|
+
* the surface fades out where it comes close to the solid geometry behind
|
|
163
|
+
* it, instead of ending in a hard line. 0 turns the fade off.
|
|
164
|
+
*/
|
|
165
|
+
softness: number;
|
|
166
|
+
/**
|
|
167
|
+
* Ground layers blended by a weight map, for terrain: up to four tiling
|
|
168
|
+
* textures, each shown where its channel of `weights` (R, G, B, A) is
|
|
169
|
+
* strong. Weights are read with the mesh's coordinates as they are and
|
|
170
|
+
* layers with those coordinates times their `repeat`. The layers take
|
|
171
|
+
* the texture slots of map, emissiveMap, occlusionMap, metallicRoughnessMap
|
|
172
|
+
* and lightMap, so leave those unset. Call touch() after assigning.
|
|
173
|
+
*/
|
|
174
|
+
splat: {
|
|
175
|
+
readonly weights: Texture3D;
|
|
176
|
+
readonly layers: readonly Texture3D[];
|
|
177
|
+
readonly repeat: readonly number[];
|
|
178
|
+
} | undefined;
|
|
179
|
+
/** Strength, 0 to 1, of a soft rim lobe for cloth and velvet on a standard material. */
|
|
180
|
+
sheen: number;
|
|
181
|
+
readonly sheenColor: Float32Array<ArrayBuffer>;
|
|
182
|
+
sheenRoughness: number;
|
|
183
|
+
/**
|
|
184
|
+
* How much light passes through a standard material, 0 to 1, as for glass.
|
|
185
|
+
* What lies behind is drawn first and then seen through the surface,
|
|
186
|
+
* tinted by its color and blurred by its roughness. Such a material is
|
|
187
|
+
* drawn with the transparent objects whatever its alphaMode; other
|
|
188
|
+
* see-through and transparent objects behind it do not show through.
|
|
189
|
+
*/
|
|
190
|
+
transmission: number;
|
|
191
|
+
/** Index of refraction for transmission: 1 does not bend light, 1.5 is glass, 1.33 water. */
|
|
192
|
+
ior: number;
|
|
193
|
+
/** How far, in world units, light travels inside a transmitting object. Zero means a thin sheet that does not bend the view. */
|
|
194
|
+
thickness: number;
|
|
195
|
+
/** Color white light takes on after travelling `attenuationDistance` inside a transmitting object. */
|
|
196
|
+
readonly attenuationColor: Float32Array<ArrayBuffer>;
|
|
197
|
+
attenuationDistance: number;
|
|
198
|
+
/** Strength, 0 to 1, of a clear lacquer layer over a standard material (car paint, varnish). */
|
|
199
|
+
clearcoat: number;
|
|
200
|
+
clearcoatRoughness: number;
|
|
201
|
+
/** Number of light bands for toon shading. */
|
|
202
|
+
toonSteps: number;
|
|
203
|
+
metallic: number;
|
|
204
|
+
roughness: number;
|
|
205
|
+
metallicRoughnessMap: Texture3D | undefined;
|
|
206
|
+
environmentIntensity: number;
|
|
207
|
+
billboard: boolean;
|
|
208
|
+
/** Treat vertex positions as normalized device coordinates; used by full-screen layers. */
|
|
209
|
+
screenSpace: boolean;
|
|
210
|
+
sizeAttenuation: boolean;
|
|
211
|
+
rotation: number;
|
|
212
|
+
pointSize: number;
|
|
213
|
+
/** Polygon offset to resolve coplanar decals: [factor, units]. */
|
|
214
|
+
polygonOffset: readonly [number, number] | undefined;
|
|
215
|
+
constructor(shading: Shading3D, options?: MaterialOptions3D);
|
|
216
|
+
/** True when the material must be drawn in the sorted transparent pass. */
|
|
217
|
+
get isTransparent(): boolean;
|
|
218
|
+
setColor(color: ColorInput3D): this;
|
|
219
|
+
setEmissive(color: ColorInput3D): this;
|
|
220
|
+
/** Independent copy sharing texture references. */
|
|
221
|
+
clone(): Material3D;
|
|
222
|
+
}
|
|
223
|
+
/** Constant color, unaffected by lights. */
|
|
224
|
+
export declare function createUnlitMaterial3D(options?: MaterialOptions3D): Material3D;
|
|
225
|
+
/** Diffuse-only lighting; the cheapest lit model. */
|
|
226
|
+
export declare function createLambertMaterial3D(options?: MaterialOptions3D): Material3D;
|
|
227
|
+
/** Diffuse plus Blinn-Phong specular highlights. */
|
|
228
|
+
export declare function createPhongMaterial3D(options?: PhongMaterialOptions3D): Material3D;
|
|
229
|
+
/** Cel shading: diffuse light quantized into `steps` flat bands. */
|
|
230
|
+
export declare function createToonMaterial3D(options?: MaterialOptions3D & {
|
|
231
|
+
readonly steps?: number;
|
|
232
|
+
}): Material3D;
|
|
233
|
+
/**
|
|
234
|
+
* Lighting baked into a sphere image: the surface color is looked up by the
|
|
235
|
+
* view-space normal, so no lights are needed. The image is held in `emissiveMap`.
|
|
236
|
+
*/
|
|
237
|
+
export declare function createMatcapMaterial3D(options: MaterialOptions3D & {
|
|
238
|
+
readonly matcap: Texture3D;
|
|
239
|
+
}): Material3D;
|
|
240
|
+
/**
|
|
241
|
+
* A standard material set up as glass: smooth and see-through, with
|
|
242
|
+
* reflections kept. Give it a `thickness` to bend the view like a solid block.
|
|
243
|
+
*/
|
|
244
|
+
export declare function createGlassMaterial3D(options?: StandardMaterialOptions3D & {
|
|
245
|
+
readonly transmission?: number;
|
|
246
|
+
readonly ior?: number;
|
|
247
|
+
readonly thickness?: number;
|
|
248
|
+
}): Material3D;
|
|
249
|
+
/** Physically based metallic-roughness model, matching glTF 2.0 materials. */
|
|
250
|
+
export declare function createStandardMaterial3D(options?: StandardMaterialOptions3D): Material3D;
|
|
251
|
+
/** Camera-facing unlit quad material for Sprite3D. */
|
|
252
|
+
export declare function createSpriteMaterial3D(options?: SpriteMaterialOptions3D): Material3D;
|
|
253
|
+
//# sourceMappingURL=Material3D.d.ts.map
|