@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,335 @@
|
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
// Indexed vertex data with named attributes, material groups, morph targets
|
|
3
|
+
// and cached bounds. Attribute arrays are caller-visible typed arrays: write
|
|
4
|
+
// into them, then call touch() on the attribute to schedule a GPU refresh.
|
|
5
|
+
import { Resource3D, World3DError, requireCount3D } from './core3D.js';
|
|
6
|
+
import { box3Empty, box3ExpandByPoint, sphereFromBox } from './math3D.js';
|
|
7
|
+
/** The most vertices, indices, morph targets and groups a geometry has. */
|
|
8
|
+
export const GEOMETRY3D_LIMITS = Object.freeze({
|
|
9
|
+
maxVertices: 4194304,
|
|
10
|
+
maxIndices: 12582912,
|
|
11
|
+
maxMorphTargets: 256,
|
|
12
|
+
maxGroups: 1024
|
|
13
|
+
});
|
|
14
|
+
/** Well-known attribute names understood by the built-in materials. */
|
|
15
|
+
export const ATTRIBUTE_3D = Object.freeze({
|
|
16
|
+
position: 'position',
|
|
17
|
+
normal: 'normal',
|
|
18
|
+
tangent: 'tangent',
|
|
19
|
+
uv: 'uv',
|
|
20
|
+
uv1: 'uv1',
|
|
21
|
+
color: 'color',
|
|
22
|
+
joints: 'joints',
|
|
23
|
+
weights: 'weights'
|
|
24
|
+
});
|
|
25
|
+
/** One attribute of a geometry, such as positions: its data, how many numbers each vertex has, and whether they are normalized. */
|
|
26
|
+
export class Attribute3D {
|
|
27
|
+
data;
|
|
28
|
+
itemSize;
|
|
29
|
+
/** Integer data is mapped to [0, 1] or [-1, 1] when sampled as float. */
|
|
30
|
+
normalized;
|
|
31
|
+
/** Hint that data changes often, so the backend picks a streaming buffer. */
|
|
32
|
+
dynamic = false;
|
|
33
|
+
#version = 1;
|
|
34
|
+
constructor(data, itemSize, normalized = false) {
|
|
35
|
+
if (!ArrayBuffer.isView(data) || data instanceof DataView)
|
|
36
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'attribute data');
|
|
37
|
+
if (!Number.isSafeInteger(itemSize) || itemSize < 1 || itemSize > 4 || data.length % itemSize !== 0)
|
|
38
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'attribute itemSize');
|
|
39
|
+
this.data = data;
|
|
40
|
+
this.itemSize = itemSize;
|
|
41
|
+
this.normalized = normalized;
|
|
42
|
+
}
|
|
43
|
+
get count() {
|
|
44
|
+
return this.data.length / this.itemSize;
|
|
45
|
+
}
|
|
46
|
+
get version() {
|
|
47
|
+
return this.#version;
|
|
48
|
+
}
|
|
49
|
+
touch() {
|
|
50
|
+
this.#version++;
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
/** The vertices of a mesh: its attributes and indices, its groups and morph targets, and calls that compute normals and tangents. */
|
|
54
|
+
export class Geometry3D extends Resource3D {
|
|
55
|
+
topology = 'triangles';
|
|
56
|
+
#attributes = new Map();
|
|
57
|
+
#index;
|
|
58
|
+
#groups = [];
|
|
59
|
+
#morphTargets = [];
|
|
60
|
+
#boundingBox;
|
|
61
|
+
#boundingSphere;
|
|
62
|
+
/** Structure version: attribute set, index or morph targets changed. */
|
|
63
|
+
#layoutVersion = 1;
|
|
64
|
+
get attributes() {
|
|
65
|
+
return this.#attributes;
|
|
66
|
+
}
|
|
67
|
+
get index() {
|
|
68
|
+
return this.#index;
|
|
69
|
+
}
|
|
70
|
+
get groups() {
|
|
71
|
+
return this.#groups;
|
|
72
|
+
}
|
|
73
|
+
get morphTargets() {
|
|
74
|
+
return this.#morphTargets;
|
|
75
|
+
}
|
|
76
|
+
get layoutVersion() {
|
|
77
|
+
return this.#layoutVersion;
|
|
78
|
+
}
|
|
79
|
+
get vertexCount() {
|
|
80
|
+
return this.#attributes.get('position')?.count ?? 0;
|
|
81
|
+
}
|
|
82
|
+
/** Number of indices, or vertices when the geometry is not indexed. */
|
|
83
|
+
get drawCount() {
|
|
84
|
+
return this.#index ? this.#index.count : this.vertexCount;
|
|
85
|
+
}
|
|
86
|
+
setAttribute(name, attribute) {
|
|
87
|
+
this.assertLive();
|
|
88
|
+
if (!(attribute instanceof Attribute3D) || typeof name !== 'string' || name.length === 0)
|
|
89
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'attribute');
|
|
90
|
+
requireCount3D(attribute.count, 'vertex count', GEOMETRY3D_LIMITS.maxVertices);
|
|
91
|
+
this.#attributes.set(name, attribute);
|
|
92
|
+
if (name === 'position')
|
|
93
|
+
this.invalidateBounds();
|
|
94
|
+
this.#layoutVersion++;
|
|
95
|
+
this.touch();
|
|
96
|
+
return this;
|
|
97
|
+
}
|
|
98
|
+
getAttribute(name) {
|
|
99
|
+
return this.#attributes.get(name);
|
|
100
|
+
}
|
|
101
|
+
removeAttribute(name) {
|
|
102
|
+
if (this.#attributes.delete(name)) {
|
|
103
|
+
this.#layoutVersion++;
|
|
104
|
+
this.touch();
|
|
105
|
+
}
|
|
106
|
+
return this;
|
|
107
|
+
}
|
|
108
|
+
setIndex(index) {
|
|
109
|
+
this.assertLive();
|
|
110
|
+
if (index === undefined)
|
|
111
|
+
this.#index = undefined;
|
|
112
|
+
else {
|
|
113
|
+
const data = ArrayBuffer.isView(index)
|
|
114
|
+
? index
|
|
115
|
+
: this.vertexCount > 65535
|
|
116
|
+
? new Uint32Array(index)
|
|
117
|
+
: new Uint16Array(index);
|
|
118
|
+
requireCount3D(data.length, 'index count', GEOMETRY3D_LIMITS.maxIndices);
|
|
119
|
+
// An index past the vertex data would read outside the vertex buffers.
|
|
120
|
+
const vertexCount = this.vertexCount;
|
|
121
|
+
if (vertexCount > 0) {
|
|
122
|
+
for (let i = 0; i < data.length; i++)
|
|
123
|
+
if (data[i] >= vertexCount)
|
|
124
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'index out of range');
|
|
125
|
+
}
|
|
126
|
+
if (!ArrayBuffer.isView(index)) {
|
|
127
|
+
for (let i = 0; i < index.length; i++)
|
|
128
|
+
if (!Number.isSafeInteger(index[i]) || index[i] < 0)
|
|
129
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'index value');
|
|
130
|
+
}
|
|
131
|
+
this.#index = new Attribute3D(data, 1);
|
|
132
|
+
}
|
|
133
|
+
this.#layoutVersion++;
|
|
134
|
+
this.touch();
|
|
135
|
+
return this;
|
|
136
|
+
}
|
|
137
|
+
/** Assign a material slot to an index (or vertex) range. */
|
|
138
|
+
addGroup(start, count, materialIndex = 0) {
|
|
139
|
+
requireCount3D(this.#groups.length + 1, 'groups', GEOMETRY3D_LIMITS.maxGroups);
|
|
140
|
+
this.#groups.push(Object.freeze({ start, count, materialIndex }));
|
|
141
|
+
return this;
|
|
142
|
+
}
|
|
143
|
+
clearGroups() {
|
|
144
|
+
this.#groups = [];
|
|
145
|
+
return this;
|
|
146
|
+
}
|
|
147
|
+
setMorphTargets(targets) {
|
|
148
|
+
this.assertLive();
|
|
149
|
+
requireCount3D(targets.length, 'morph targets', GEOMETRY3D_LIMITS.maxMorphTargets);
|
|
150
|
+
const expected = this.vertexCount * 3;
|
|
151
|
+
for (const target of targets) {
|
|
152
|
+
if ((target.position && target.position.length !== expected) ||
|
|
153
|
+
(target.normal && target.normal.length !== expected)) {
|
|
154
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'morph target length');
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
this.#morphTargets = targets.map(target => Object.freeze({ ...target }));
|
|
158
|
+
this.#layoutVersion++;
|
|
159
|
+
this.touch();
|
|
160
|
+
return this;
|
|
161
|
+
}
|
|
162
|
+
// ---- bounds ------------------------------------------------------------
|
|
163
|
+
/** Local-space [minX, minY, minZ, maxX, maxY, maxZ], cached until positions change. */
|
|
164
|
+
get boundingBox() {
|
|
165
|
+
if (this.#boundingBox)
|
|
166
|
+
return this.#boundingBox;
|
|
167
|
+
const box = box3Empty(new Float32Array(6));
|
|
168
|
+
const position = this.#attributes.get('position');
|
|
169
|
+
if (position) {
|
|
170
|
+
const data = position.data, size = position.itemSize;
|
|
171
|
+
for (let i = 0; i < data.length; i += size)
|
|
172
|
+
box3ExpandByPoint(box, data[i], data[i + 1], size > 2 ? data[i + 2] : 0);
|
|
173
|
+
// Morph deltas can move vertices outside the base bounds.
|
|
174
|
+
if (this.#morphTargets.length) {
|
|
175
|
+
const grow = new Float32Array(3);
|
|
176
|
+
for (const target of this.#morphTargets) {
|
|
177
|
+
const delta = target.position;
|
|
178
|
+
if (!delta)
|
|
179
|
+
continue;
|
|
180
|
+
let x = 0, y = 0, z = 0;
|
|
181
|
+
for (let i = 0; i < delta.length; i += 3) {
|
|
182
|
+
x = Math.max(x, Math.abs(delta[i]));
|
|
183
|
+
y = Math.max(y, Math.abs(delta[i + 1]));
|
|
184
|
+
z = Math.max(z, Math.abs(delta[i + 2]));
|
|
185
|
+
}
|
|
186
|
+
grow[0] += x;
|
|
187
|
+
grow[1] += y;
|
|
188
|
+
grow[2] += z;
|
|
189
|
+
}
|
|
190
|
+
box[0] -= grow[0];
|
|
191
|
+
box[1] -= grow[1];
|
|
192
|
+
box[2] -= grow[2];
|
|
193
|
+
box[3] += grow[0];
|
|
194
|
+
box[4] += grow[1];
|
|
195
|
+
box[5] += grow[2];
|
|
196
|
+
}
|
|
197
|
+
}
|
|
198
|
+
return (this.#boundingBox = box);
|
|
199
|
+
}
|
|
200
|
+
/** Local-space [x, y, z, radius]; radius is negative for an empty geometry. */
|
|
201
|
+
get boundingSphere() {
|
|
202
|
+
return (this.#boundingSphere ??= sphereFromBox(new Float32Array(4), this.boundingBox));
|
|
203
|
+
}
|
|
204
|
+
#boundsVersion = 0;
|
|
205
|
+
/** Counts `invalidateBounds` calls: what a mesh's world bounds are kept by, beside the structure version. */
|
|
206
|
+
get boundsVersion() {
|
|
207
|
+
return this.#boundsVersion;
|
|
208
|
+
}
|
|
209
|
+
/** Call after editing position data in place. Meshes of this geometry find their world bounds again. */
|
|
210
|
+
invalidateBounds() {
|
|
211
|
+
this.#boundingBox = undefined;
|
|
212
|
+
this.#boundingSphere = undefined;
|
|
213
|
+
this.#boundsVersion++;
|
|
214
|
+
}
|
|
215
|
+
// ---- derived attributes ------------------------------------------------
|
|
216
|
+
/** Area-weighted smooth normals for triangle geometry. */
|
|
217
|
+
computeNormals() {
|
|
218
|
+
const position = this.#attributes.get('position');
|
|
219
|
+
if (!position || this.topology !== 'triangles')
|
|
220
|
+
return this;
|
|
221
|
+
const p = position.data, vertexCount = position.count, normals = new Float32Array(vertexCount * 3);
|
|
222
|
+
const index = this.#index?.data, triangles = (index ? index.length : vertexCount) / 3;
|
|
223
|
+
for (let t = 0; t < triangles; t++) {
|
|
224
|
+
const a = (index ? index[t * 3] : t * 3) * 3, b = (index ? index[t * 3 + 1] : t * 3 + 1) * 3, c = (index ? index[t * 3 + 2] : t * 3 + 2) * 3;
|
|
225
|
+
const e1x = p[b] - p[a], e1y = p[b + 1] - p[a + 1], e1z = p[b + 2] - p[a + 2];
|
|
226
|
+
const e2x = p[c] - p[a], e2y = p[c + 1] - p[a + 1], e2z = p[c + 2] - p[a + 2];
|
|
227
|
+
const nx = e1y * e2z - e1z * e2y, ny = e1z * e2x - e1x * e2z, nz = e1x * e2y - e1y * e2x;
|
|
228
|
+
for (const v of [a, b, c]) {
|
|
229
|
+
normals[v] += nx;
|
|
230
|
+
normals[v + 1] += ny;
|
|
231
|
+
normals[v + 2] += nz;
|
|
232
|
+
}
|
|
233
|
+
}
|
|
234
|
+
for (let i = 0; i < normals.length; i += 3) {
|
|
235
|
+
const length = Math.hypot(normals[i], normals[i + 1], normals[i + 2]) || 1;
|
|
236
|
+
normals[i] /= length;
|
|
237
|
+
normals[i + 1] /= length;
|
|
238
|
+
normals[i + 2] /= length;
|
|
239
|
+
}
|
|
240
|
+
return this.setAttribute('normal', new Attribute3D(normals, 3));
|
|
241
|
+
}
|
|
242
|
+
/** Per-vertex tangents (xyz + handedness) from positions, normals and UVs. */
|
|
243
|
+
computeTangents() {
|
|
244
|
+
const position = this.#attributes.get('position'), normal = this.#attributes.get('normal'), uv = this.#attributes.get('uv');
|
|
245
|
+
if (!position || !normal || !uv || this.topology !== 'triangles')
|
|
246
|
+
return this;
|
|
247
|
+
const p = position.data, n = normal.data, t = uv.data, vertexCount = position.count;
|
|
248
|
+
const tan = new Float32Array(vertexCount * 3), bitan = new Float32Array(vertexCount * 3), out = new Float32Array(vertexCount * 4);
|
|
249
|
+
const index = this.#index?.data, triangles = (index ? index.length : vertexCount) / 3;
|
|
250
|
+
for (let k = 0; k < triangles; k++) {
|
|
251
|
+
const a = index ? index[k * 3] : k * 3, b = index ? index[k * 3 + 1] : k * 3 + 1, c = index ? index[k * 3 + 2] : k * 3 + 2;
|
|
252
|
+
const e1x = p[b * 3] - p[a * 3], e1y = p[b * 3 + 1] - p[a * 3 + 1], e1z = p[b * 3 + 2] - p[a * 3 + 2];
|
|
253
|
+
const e2x = p[c * 3] - p[a * 3], e2y = p[c * 3 + 1] - p[a * 3 + 1], e2z = p[c * 3 + 2] - p[a * 3 + 2];
|
|
254
|
+
const du1 = t[b * 2] - t[a * 2], dv1 = t[b * 2 + 1] - t[a * 2 + 1], du2 = t[c * 2] - t[a * 2], dv2 = t[c * 2 + 1] - t[a * 2 + 1];
|
|
255
|
+
const determinant = du1 * dv2 - du2 * dv1;
|
|
256
|
+
if (determinant === 0)
|
|
257
|
+
continue;
|
|
258
|
+
const r = 1 / determinant;
|
|
259
|
+
const tx = (e1x * dv2 - e2x * dv1) * r, ty = (e1y * dv2 - e2y * dv1) * r, tz = (e1z * dv2 - e2z * dv1) * r;
|
|
260
|
+
const bx = (e2x * du1 - e1x * du2) * r, by = (e2y * du1 - e1y * du2) * r, bz = (e2z * du1 - e1z * du2) * r;
|
|
261
|
+
for (const v of [a, b, c]) {
|
|
262
|
+
tan[v * 3] += tx;
|
|
263
|
+
tan[v * 3 + 1] += ty;
|
|
264
|
+
tan[v * 3 + 2] += tz;
|
|
265
|
+
bitan[v * 3] += bx;
|
|
266
|
+
bitan[v * 3 + 1] += by;
|
|
267
|
+
bitan[v * 3 + 2] += bz;
|
|
268
|
+
}
|
|
269
|
+
}
|
|
270
|
+
for (let v = 0; v < vertexCount; v++) {
|
|
271
|
+
const nx = n[v * 3], ny = n[v * 3 + 1], nz = n[v * 3 + 2];
|
|
272
|
+
let tx = tan[v * 3], ty = tan[v * 3 + 1], tz = tan[v * 3 + 2];
|
|
273
|
+
// Gram-Schmidt orthogonalization against the normal.
|
|
274
|
+
const d = nx * tx + ny * ty + nz * tz;
|
|
275
|
+
tx -= nx * d;
|
|
276
|
+
ty -= ny * d;
|
|
277
|
+
tz -= nz * d;
|
|
278
|
+
const length = Math.hypot(tx, ty, tz);
|
|
279
|
+
if (length > 0) {
|
|
280
|
+
tx /= length;
|
|
281
|
+
ty /= length;
|
|
282
|
+
tz /= length;
|
|
283
|
+
}
|
|
284
|
+
else {
|
|
285
|
+
tx = 1;
|
|
286
|
+
ty = 0;
|
|
287
|
+
tz = 0;
|
|
288
|
+
}
|
|
289
|
+
const cx = ny * tz - nz * ty, cy = nz * tx - nx * tz, cz = nx * ty - ny * tx;
|
|
290
|
+
const handedness = cx * bitan[v * 3] + cy * bitan[v * 3 + 1] + cz * bitan[v * 3 + 2] < 0 ? -1 : 1;
|
|
291
|
+
out[v * 4] = tx;
|
|
292
|
+
out[v * 4 + 1] = ty;
|
|
293
|
+
out[v * 4 + 2] = tz;
|
|
294
|
+
out[v * 4 + 3] = handedness;
|
|
295
|
+
}
|
|
296
|
+
return this.setAttribute('tangent', new Attribute3D(out, 4));
|
|
297
|
+
}
|
|
298
|
+
}
|
|
299
|
+
/** Build a geometry from plain arrays; missing normals are computed for triangles. */
|
|
300
|
+
export function createGeometry3D(input) {
|
|
301
|
+
if (!input || typeof input !== 'object' || !input.positions || input.positions.length % 3 !== 0)
|
|
302
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'positions');
|
|
303
|
+
const geometry = new Geometry3D();
|
|
304
|
+
geometry.topology = input.topology ?? 'triangles';
|
|
305
|
+
const vertexCount = input.positions.length / 3;
|
|
306
|
+
geometry.setAttribute('position', new Attribute3D(Float32Array.from(input.positions), 3));
|
|
307
|
+
if (input.uvs) {
|
|
308
|
+
if (input.uvs.length !== vertexCount * 2)
|
|
309
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'uvs');
|
|
310
|
+
geometry.setAttribute('uv', new Attribute3D(Float32Array.from(input.uvs), 2));
|
|
311
|
+
}
|
|
312
|
+
if (input.colors) {
|
|
313
|
+
const size = input.colors.length / vertexCount;
|
|
314
|
+
if (size !== 3 && size !== 4)
|
|
315
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'colors');
|
|
316
|
+
geometry.setAttribute('color', new Attribute3D(Float32Array.from(input.colors), size));
|
|
317
|
+
}
|
|
318
|
+
if (input.indices) {
|
|
319
|
+
for (let i = 0; i < input.indices.length; i++) {
|
|
320
|
+
const value = input.indices[i];
|
|
321
|
+
if (!Number.isSafeInteger(value) || value < 0 || value >= vertexCount)
|
|
322
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'indices');
|
|
323
|
+
}
|
|
324
|
+
geometry.setIndex(vertexCount > 65535 ? Uint32Array.from(input.indices) : Uint16Array.from(input.indices));
|
|
325
|
+
}
|
|
326
|
+
if (input.normals) {
|
|
327
|
+
if (input.normals.length !== vertexCount * 3)
|
|
328
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'normals');
|
|
329
|
+
geometry.setAttribute('normal', new Attribute3D(Float32Array.from(input.normals), 3));
|
|
330
|
+
}
|
|
331
|
+
else if (geometry.topology === 'triangles')
|
|
332
|
+
geometry.computeNormals();
|
|
333
|
+
return geometry;
|
|
334
|
+
}
|
|
335
|
+
//# sourceMappingURL=Geometry3D.js.map
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
import { Geometry3D } from './Geometry3D.js';
|
|
2
|
+
import type { ColorInput3D } from './Material3D.js';
|
|
3
|
+
/** One geometry added to a builder: where, turned and scaled how, and its color. */
|
|
4
|
+
export interface GeometryPart3D {
|
|
5
|
+
/** Where the part goes; [0, 0, 0] by default. */
|
|
6
|
+
readonly position?: readonly [number, number, number];
|
|
7
|
+
/** Euler angles in radians, applied X then Y then Z, as `quatFromEuler`. Ignored when `quaternion` is given. */
|
|
8
|
+
readonly rotation?: readonly [number, number, number];
|
|
9
|
+
readonly quaternion?: readonly [number, number, number, number];
|
|
10
|
+
/** One number for all three axes, or one per axis. */
|
|
11
|
+
readonly scale?: number | readonly [number, number, number];
|
|
12
|
+
/** A 4 x 4 column-major matrix that places the part, instead of position, rotation and scale. */
|
|
13
|
+
readonly matrix?: ArrayLike<number>;
|
|
14
|
+
/** A hex colour as seen on screen, or linear RGB; white by default. */
|
|
15
|
+
readonly color?: ColorInput3D;
|
|
16
|
+
/** Multiplies each vertex colour already in the part, as for shading baked into it. */
|
|
17
|
+
readonly keepColors?: boolean;
|
|
18
|
+
}
|
|
19
|
+
/** Joins many geometries, each placed, into one. */
|
|
20
|
+
export interface GeometryBuilder3D {
|
|
21
|
+
/** Parts added so far. */
|
|
22
|
+
readonly parts: number;
|
|
23
|
+
/** Vertices added so far. */
|
|
24
|
+
readonly vertexCount: number;
|
|
25
|
+
/** Adds a placed, coloured copy of `geometry`; the geometry itself is not changed. */
|
|
26
|
+
add(geometry: Geometry3D, part?: GeometryPart3D): this;
|
|
27
|
+
/** One geometry with position, normal, uv (when every part has one) and colour; the builder is emptied. */
|
|
28
|
+
build(): Geometry3D;
|
|
29
|
+
}
|
|
30
|
+
/** A builder that merges placed, coloured parts into one geometry. */
|
|
31
|
+
export declare function createGeometryBuilder3D(): GeometryBuilder3D;
|
|
32
|
+
/** A hex colour as seen on screen in the linear RGB the renderer lights, for vertex colours written by hand. */
|
|
33
|
+
export declare function linearColor3D(hex: number): [number, number, number];
|
|
34
|
+
/** Where a world point falls in a viewport, for labels, markers and pointers drawn over the picture. */
|
|
35
|
+
export interface ViewportPoint3D {
|
|
36
|
+
/** Pixels from the viewport's left and top edges. */
|
|
37
|
+
x: number;
|
|
38
|
+
y: number;
|
|
39
|
+
/** Normalized depth, -1 at the near plane and 1 at the far plane. */
|
|
40
|
+
depth: number;
|
|
41
|
+
/** False when the point is behind the camera; x and y then point the way it lies, mirrored back. */
|
|
42
|
+
inFront: boolean;
|
|
43
|
+
/** True when the point is in front of the camera and inside the viewport. */
|
|
44
|
+
onScreen: boolean;
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* Projects a world point into a viewport of `width` by `height` pixels through `camera`. Call
|
|
48
|
+
* `camera.updateViewMatrices()` first, or use it after the frame was drawn.
|
|
49
|
+
*/
|
|
50
|
+
export declare function projectToViewport3D(camera: {
|
|
51
|
+
readonly viewProjectionMatrix: ArrayLike<number>;
|
|
52
|
+
}, point: ArrayLike<number>, width: number, height: number, out?: ViewportPoint3D): ViewportPoint3D;
|
|
53
|
+
//# sourceMappingURL=GeometryBuilder3D.d.ts.map
|
|
@@ -0,0 +1,196 @@
|
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
// Puts many placed, coloured parts into one geometry: models made in code (a
|
|
3
|
+
// truck from boxes, a soldier from tapered limbs) and static scenery that
|
|
4
|
+
// should draw in one call. Each part is a copy of a geometry moved by a
|
|
5
|
+
// position, rotation and scale or by a matrix, with one colour written into the
|
|
6
|
+
// vertex colours. Colours are given the way they look on screen and stored as
|
|
7
|
+
// the linear values the renderer lights.
|
|
8
|
+
import { World3DError } from './core3D.js';
|
|
9
|
+
import { Attribute3D, Geometry3D } from './Geometry3D.js';
|
|
10
|
+
import { colorFromHex, mat3NormalFromMat4, mat4Compose, quatFromEuler, srgbToLinear } from './math3D.js';
|
|
11
|
+
const UP_LIMIT = 4294967295;
|
|
12
|
+
function color3(input) {
|
|
13
|
+
const out = new Float32Array([1, 1, 1]);
|
|
14
|
+
if (input === undefined)
|
|
15
|
+
return out;
|
|
16
|
+
if (typeof input === 'number')
|
|
17
|
+
return colorFromHex(out, input);
|
|
18
|
+
if (Array.isArray(input) && input.length === 3 && input.every(Number.isFinite)) {
|
|
19
|
+
out.set(input);
|
|
20
|
+
return out;
|
|
21
|
+
}
|
|
22
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'part color');
|
|
23
|
+
}
|
|
24
|
+
function triple(value, fallback, what) {
|
|
25
|
+
if (value === undefined)
|
|
26
|
+
return [fallback, fallback, fallback];
|
|
27
|
+
if (typeof value === 'number' && Number.isFinite(value))
|
|
28
|
+
return [value, value, value];
|
|
29
|
+
if (Array.isArray(value) && value.length === 3 && value.every(Number.isFinite))
|
|
30
|
+
return value;
|
|
31
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', what);
|
|
32
|
+
}
|
|
33
|
+
function placement(part) {
|
|
34
|
+
const m = new Float32Array(16);
|
|
35
|
+
if (part.matrix !== undefined) {
|
|
36
|
+
if (!part.matrix || part.matrix.length !== 16 || !Array.from(part.matrix).every(Number.isFinite))
|
|
37
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'part matrix');
|
|
38
|
+
m.set(Array.from(part.matrix));
|
|
39
|
+
return m;
|
|
40
|
+
}
|
|
41
|
+
const t = triple(part.position, 0, 'part position');
|
|
42
|
+
const s = triple(part.scale, 1, 'part scale');
|
|
43
|
+
let q;
|
|
44
|
+
if (part.quaternion !== undefined) {
|
|
45
|
+
if (!Array.isArray(part.quaternion) || part.quaternion.length !== 4 || !part.quaternion.every(Number.isFinite))
|
|
46
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'part quaternion');
|
|
47
|
+
q = part.quaternion;
|
|
48
|
+
}
|
|
49
|
+
else {
|
|
50
|
+
const r = triple(part.rotation, 0, 'part rotation');
|
|
51
|
+
q = quatFromEuler(new Float32Array(4), r[0], r[1], r[2]);
|
|
52
|
+
}
|
|
53
|
+
return mat4Compose(m, t, q, s);
|
|
54
|
+
}
|
|
55
|
+
/** A builder that merges placed, coloured parts into one geometry. */
|
|
56
|
+
export function createGeometryBuilder3D() {
|
|
57
|
+
let pieces = [], vertices = 0;
|
|
58
|
+
const builder = {
|
|
59
|
+
get parts() {
|
|
60
|
+
return pieces.length;
|
|
61
|
+
},
|
|
62
|
+
get vertexCount() {
|
|
63
|
+
return vertices;
|
|
64
|
+
},
|
|
65
|
+
add(geometry, part = {}) {
|
|
66
|
+
if (!(geometry instanceof Geometry3D) || geometry.isDisposed)
|
|
67
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'geometry');
|
|
68
|
+
if (geometry.topology !== 'triangles')
|
|
69
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'part topology');
|
|
70
|
+
if (typeof part !== 'object' || part === null)
|
|
71
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'part');
|
|
72
|
+
const position = geometry.getAttribute('position');
|
|
73
|
+
if (!position || position.itemSize !== 3)
|
|
74
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'part position data');
|
|
75
|
+
const count = position.count;
|
|
76
|
+
if (vertices + count > UP_LIMIT)
|
|
77
|
+
throw new World3DError('WORLD3D_BUDGET', 'vertices');
|
|
78
|
+
const m = placement(part);
|
|
79
|
+
const n = mat3NormalFromMat4(new Float32Array(9), m);
|
|
80
|
+
const tint = color3(part.color);
|
|
81
|
+
const src = position.data;
|
|
82
|
+
const positions = new Float32Array(count * 3);
|
|
83
|
+
for (let i = 0; i < count; i++) {
|
|
84
|
+
const x = src[i * 3], y = src[i * 3 + 1], z = src[i * 3 + 2];
|
|
85
|
+
positions[i * 3] = m[0] * x + m[4] * y + m[8] * z + m[12];
|
|
86
|
+
positions[i * 3 + 1] = m[1] * x + m[5] * y + m[9] * z + m[13];
|
|
87
|
+
positions[i * 3 + 2] = m[2] * x + m[6] * y + m[10] * z + m[14];
|
|
88
|
+
}
|
|
89
|
+
let normals;
|
|
90
|
+
const normal = geometry.getAttribute('normal');
|
|
91
|
+
if (normal && normal.itemSize === 3) {
|
|
92
|
+
normals = new Float32Array(count * 3);
|
|
93
|
+
const d = normal.data;
|
|
94
|
+
for (let i = 0; i < count; i++) {
|
|
95
|
+
const x = d[i * 3], y = d[i * 3 + 1], z = d[i * 3 + 2];
|
|
96
|
+
const nx = n[0] * x + n[3] * y + n[6] * z, ny = n[1] * x + n[4] * y + n[7] * z, nz = n[2] * x + n[5] * y + n[8] * z;
|
|
97
|
+
const length = Math.hypot(nx, ny, nz) || 1;
|
|
98
|
+
normals[i * 3] = nx / length;
|
|
99
|
+
normals[i * 3 + 1] = ny / length;
|
|
100
|
+
normals[i * 3 + 2] = nz / length;
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
let uvs;
|
|
104
|
+
const uv = geometry.getAttribute('uv');
|
|
105
|
+
if (uv && uv.itemSize === 2)
|
|
106
|
+
uvs = Float32Array.from(uv.data);
|
|
107
|
+
const colors = new Float32Array(count * 3);
|
|
108
|
+
const own = part.keepColors ? geometry.getAttribute('color') : undefined;
|
|
109
|
+
for (let i = 0; i < count; i++)
|
|
110
|
+
for (let c = 0; c < 3; c++)
|
|
111
|
+
colors[i * 3 + c] = tint[c] * (own ? own.data[i * own.itemSize + c] : 1);
|
|
112
|
+
// A mirrored placement turns triangles inside out; their winding is flipped back.
|
|
113
|
+
const det = m[0] * (m[5] * m[10] - m[6] * m[9]) -
|
|
114
|
+
m[4] * (m[1] * m[10] - m[2] * m[9]) +
|
|
115
|
+
m[8] * (m[1] * m[6] - m[2] * m[5]);
|
|
116
|
+
const index = geometry.index;
|
|
117
|
+
const indices = index
|
|
118
|
+
? Uint32Array.from(index.data)
|
|
119
|
+
: Uint32Array.from({ length: count }, (_, i) => i);
|
|
120
|
+
if (det < 0)
|
|
121
|
+
for (let i = 0; i + 2 < indices.length; i += 3) {
|
|
122
|
+
const a = indices[i + 1];
|
|
123
|
+
indices[i + 1] = indices[i + 2];
|
|
124
|
+
indices[i + 2] = a;
|
|
125
|
+
}
|
|
126
|
+
pieces.push({ positions, normals, uvs, colors, indices });
|
|
127
|
+
vertices += count;
|
|
128
|
+
return builder;
|
|
129
|
+
},
|
|
130
|
+
build() {
|
|
131
|
+
if (pieces.length === 0)
|
|
132
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'no parts');
|
|
133
|
+
const withNormals = pieces.every(piece => piece.normals), withUvs = pieces.every(piece => piece.uvs);
|
|
134
|
+
const indexTotal = pieces.reduce((sum, piece) => sum + piece.indices.length, 0);
|
|
135
|
+
const positions = new Float32Array(vertices * 3), colors = new Float32Array(vertices * 3), normals = withNormals ? new Float32Array(vertices * 3) : undefined, uvs = withUvs ? new Float32Array(vertices * 2) : undefined, indices = vertices > 65535 ? new Uint32Array(indexTotal) : new Uint16Array(indexTotal);
|
|
136
|
+
let v = 0, k = 0;
|
|
137
|
+
for (const piece of pieces) {
|
|
138
|
+
positions.set(piece.positions, v * 3);
|
|
139
|
+
colors.set(piece.colors, v * 3);
|
|
140
|
+
if (normals)
|
|
141
|
+
normals.set(piece.normals, v * 3);
|
|
142
|
+
if (uvs)
|
|
143
|
+
uvs.set(piece.uvs, v * 2);
|
|
144
|
+
for (let i = 0; i < piece.indices.length; i++)
|
|
145
|
+
indices[k + i] = piece.indices[i] + v;
|
|
146
|
+
v += piece.positions.length / 3;
|
|
147
|
+
k += piece.indices.length;
|
|
148
|
+
}
|
|
149
|
+
const geometry = new Geometry3D();
|
|
150
|
+
geometry.setAttribute('position', new Attribute3D(positions, 3));
|
|
151
|
+
if (normals)
|
|
152
|
+
geometry.setAttribute('normal', new Attribute3D(normals, 3));
|
|
153
|
+
if (uvs)
|
|
154
|
+
geometry.setAttribute('uv', new Attribute3D(uvs, 2));
|
|
155
|
+
geometry.setAttribute('color', new Attribute3D(colors, 3));
|
|
156
|
+
geometry.setIndex(indices);
|
|
157
|
+
if (!normals)
|
|
158
|
+
geometry.computeNormals();
|
|
159
|
+
pieces = [];
|
|
160
|
+
vertices = 0;
|
|
161
|
+
return geometry;
|
|
162
|
+
}
|
|
163
|
+
};
|
|
164
|
+
return builder;
|
|
165
|
+
}
|
|
166
|
+
/** A hex colour as seen on screen in the linear RGB the renderer lights, for vertex colours written by hand. */
|
|
167
|
+
export function linearColor3D(hex) {
|
|
168
|
+
if (!Number.isInteger(hex) || hex < 0 || hex > 0xffffff)
|
|
169
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'hex');
|
|
170
|
+
return [
|
|
171
|
+
srgbToLinear(((hex >> 16) & 255) / 255),
|
|
172
|
+
srgbToLinear(((hex >> 8) & 255) / 255),
|
|
173
|
+
srgbToLinear((hex & 255) / 255)
|
|
174
|
+
];
|
|
175
|
+
}
|
|
176
|
+
/**
|
|
177
|
+
* Projects a world point into a viewport of `width` by `height` pixels through `camera`. Call
|
|
178
|
+
* `camera.updateViewMatrices()` first, or use it after the frame was drawn.
|
|
179
|
+
*/
|
|
180
|
+
export function projectToViewport3D(camera, point, width, height, out = { x: 0, y: 0, depth: 0, inFront: false, onScreen: false }) {
|
|
181
|
+
if (!camera?.viewProjectionMatrix || !(width > 0) || !(height > 0))
|
|
182
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'viewport');
|
|
183
|
+
const m = camera.viewProjectionMatrix, x = point[0], y = point[1], z = point[2];
|
|
184
|
+
const cx = m[0] * x + m[4] * y + m[8] * z + m[12], cy = m[1] * x + m[5] * y + m[9] * z + m[13], cz = m[2] * x + m[6] * y + m[10] * z + m[14], cw = m[3] * x + m[7] * y + m[11] * z + m[15];
|
|
185
|
+
const inFront = cw > 1e-6;
|
|
186
|
+
// Behind the camera the division flips the point; dividing by |w| keeps it on the side where it lies.
|
|
187
|
+
const w = Math.abs(cw) > 1e-6 ? Math.abs(cw) : 1e-6;
|
|
188
|
+
const nx = cx / w, ny = cy / w;
|
|
189
|
+
out.x = (nx * 0.5 + 0.5) * width;
|
|
190
|
+
out.y = (0.5 - ny * 0.5) * height;
|
|
191
|
+
out.depth = cz / w;
|
|
192
|
+
out.inFront = inFront;
|
|
193
|
+
out.onScreen = inFront && nx >= -1 && nx <= 1 && ny >= -1 && ny <= 1 && out.depth <= 1;
|
|
194
|
+
return out;
|
|
195
|
+
}
|
|
196
|
+
//# sourceMappingURL=GeometryBuilder3D.js.map
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
import type { Camera3D } from './Camera3D.js';
|
|
2
|
+
import { Object3D } from './Object3D.js';
|
|
3
|
+
/** Whether a gizmo moves, turns or scales what it is attached to. */
|
|
4
|
+
export type GizmoMode3D = 'translate' | 'rotate' | 'scale';
|
|
5
|
+
/** Whether a gizmo's axes are the world's or the object's own. */
|
|
6
|
+
export type GizmoSpace3D = 'world' | 'local';
|
|
7
|
+
/** A single axis, a plane spanned by two axes, or 'xyz' for the center handle of the scale mode. */
|
|
8
|
+
export type GizmoHandle3D = 'x' | 'y' | 'z' | 'xy' | 'yz' | 'xz' | 'xyz';
|
|
9
|
+
/** A gizmo to make: its mode, its space and its size. */
|
|
10
|
+
export interface TransformGizmoOptions3D {
|
|
11
|
+
readonly mode?: GizmoMode3D;
|
|
12
|
+
readonly space?: GizmoSpace3D;
|
|
13
|
+
/** Length of the handles as a share of the view height. Defaults to 0.18. */
|
|
14
|
+
readonly size?: number;
|
|
15
|
+
}
|
|
16
|
+
/** Handles to move, turn or scale an object by dragging them, with snapping. */
|
|
17
|
+
export declare class TransformGizmo3D extends Object3D {
|
|
18
|
+
#private;
|
|
19
|
+
readonly camera: Camera3D;
|
|
20
|
+
mode: GizmoMode3D;
|
|
21
|
+
space: GizmoSpace3D;
|
|
22
|
+
size: number;
|
|
23
|
+
/** Step sizes for dragging: world units, radians and scale factor. Undefined moves freely. */
|
|
24
|
+
translationSnap: number | undefined;
|
|
25
|
+
rotationSnap: number | undefined;
|
|
26
|
+
scaleSnap: number | undefined;
|
|
27
|
+
enabled: boolean;
|
|
28
|
+
/** Called while a drag changes the attached object. */
|
|
29
|
+
onChange: ((object: Object3D) => void) | undefined;
|
|
30
|
+
/** Called when a drag starts (true) or ends (false), for example to pause camera controls. */
|
|
31
|
+
onDraggingChanged: ((dragging: boolean) => void) | undefined;
|
|
32
|
+
constructor(camera: Camera3D, options?: TransformGizmoOptions3D);
|
|
33
|
+
/** The object being edited. */
|
|
34
|
+
get object(): Object3D | undefined;
|
|
35
|
+
get dragging(): boolean;
|
|
36
|
+
/** The handle under the last hover ray, or the one being dragged. */
|
|
37
|
+
get activeHandle(): GizmoHandle3D | undefined;
|
|
38
|
+
attach(object: Object3D): this;
|
|
39
|
+
detach(): this;
|
|
40
|
+
private handleMaterial;
|
|
41
|
+
private part;
|
|
42
|
+
private build;
|
|
43
|
+
/** World scale that keeps the handles the same size on screen. */
|
|
44
|
+
private screenScale;
|
|
45
|
+
/** World pose of the attached object. */
|
|
46
|
+
private pose;
|
|
47
|
+
/**
|
|
48
|
+
* Place the handles on the attached object and size them for the camera.
|
|
49
|
+
* Call once per frame before rendering, after moving the camera or object.
|
|
50
|
+
*/
|
|
51
|
+
update(): void;
|
|
52
|
+
private highlight;
|
|
53
|
+
/** World directions of the three handle axes. */
|
|
54
|
+
private axes;
|
|
55
|
+
/** Handle met by a world-space ray, or undefined. Also sets the highlight. */
|
|
56
|
+
hover(origin: ArrayLike<number>, direction: ArrayLike<number>): GizmoHandle3D | undefined;
|
|
57
|
+
private pick;
|
|
58
|
+
private raySphere;
|
|
59
|
+
/** Distance along the line (point, axis) at which it comes closest to a ray. */
|
|
60
|
+
private alongAxis;
|
|
61
|
+
/** Point where a ray meets the plane through `point` with normal `normal`, or undefined when it runs alongside. */
|
|
62
|
+
private onPlane;
|
|
63
|
+
/** Direction from the object toward the camera, used as a drag plane that always faces the viewer. */
|
|
64
|
+
private towardCamera;
|
|
65
|
+
/** Start dragging the handle under the ray. Returns false when the ray misses every handle. */
|
|
66
|
+
beginDrag(origin: ArrayLike<number>, direction: ArrayLike<number>): boolean;
|
|
67
|
+
/** Continue a drag with the current ray, updating the attached object. */
|
|
68
|
+
drag(origin: ArrayLike<number>, direction: ArrayLike<number>): void;
|
|
69
|
+
/** Finish the current drag, keeping the object where it is. */
|
|
70
|
+
endDrag(): void;
|
|
71
|
+
/** Abandon the current drag and put the object back where it started. */
|
|
72
|
+
cancelDrag(): void;
|
|
73
|
+
private setWorldPosition;
|
|
74
|
+
private setWorldQuaternion;
|
|
75
|
+
/** Release the handle geometry and materials. */
|
|
76
|
+
dispose(): void;
|
|
77
|
+
}
|
|
78
|
+
/** Makes a transform gizmo seen by a camera. */
|
|
79
|
+
export declare function createTransformGizmo3D(camera: Camera3D, options?: TransformGizmoOptions3D): TransformGizmo3D;
|
|
80
|
+
//# sourceMappingURL=Gizmo3D.d.ts.map
|