@egret/engine 0.0.0-stage → 7.0.1-rc.3
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 +464 -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 +42 -0
- package/dist/animation/sequenceResetTypes.js +2 -0
- package/dist/animation/types.d.ts +69 -0
- package/dist/animation/types.js +2 -0
- package/dist/assetBundle.d.ts +52 -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 +15 -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 +43 -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 +233 -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 +29 -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 +109 -0
- package/dist/bitmapFontTypes.js +2 -0
- package/dist/bitmapResourceSlot.d.ts +25 -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 +411 -0
- package/dist/cameraTypes.d.ts +114 -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 +33 -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 +42 -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 +34 -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 +31 -0
- package/dist/gameClockTypes.js +2 -0
- package/dist/gameRun.d.ts +50 -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 +134 -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 +119 -0
- package/dist/hoverInputTypes.js +2 -0
- package/dist/index.d.ts +49 -0
- package/dist/index.js +20 -0
- package/dist/input.d.ts +6 -0
- package/dist/input.js +5 -0
- package/dist/inputActions.d.ts +81 -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 +64 -0
- package/dist/internal/uiFactoryState.js +157 -0
- package/dist/internal/uiRootState.d.ts +67 -0
- package/dist/internal/uiRootState.js +103 -0
- package/dist/keyboardInput.d.ts +12 -0
- package/dist/keyboardInput.js +578 -0
- package/dist/keyboardInputTypes.d.ts +81 -0
- package/dist/keyboardInputTypes.js +2 -0
- package/dist/kit.d.ts +14 -0
- package/dist/kit.js +9 -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 +16 -0
- package/dist/manifestResourceState.js +57 -0
- package/dist/manifestResourceTypes.d.ts +25 -0
- package/dist/manifestResourceTypes.js +2 -0
- package/dist/motion.d.ts +33 -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 +37 -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 +292 -0
- package/dist/particleTypes.d.ts +107 -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 +167 -0
- package/dist/physics2dTypes.js +2 -0
- package/dist/physics2dWorld.d.ts +4 -0
- package/dist/physics2dWorld.js +623 -0
- package/dist/pointerInput.d.ts +11 -0
- package/dist/pointerInput.js +299 -0
- package/dist/pointerInputTypes.d.ts +38 -0
- package/dist/pointerInputTypes.js +2 -0
- package/dist/random.d.ts +29 -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 +331 -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 +88 -0
- package/dist/rendering/prepareSharedDraws2D.js +652 -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 +18 -0
- package/dist/rendering/sharedColor2D.js +68 -0
- package/dist/rendering/sharedEffects2D.d.ts +23 -0
- package/dist/rendering/sharedEffects2D.js +118 -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 +95 -0
- package/dist/rendering/world3d/Animation3D.js +380 -0
- package/dist/rendering/world3d/AnimationTexture3D.d.ts +157 -0
- package/dist/rendering/world3d/AnimationTexture3D.js +601 -0
- package/dist/rendering/world3d/Batch3D.d.ts +71 -0
- package/dist/rendering/world3d/Batch3D.js +329 -0
- package/dist/rendering/world3d/Camera3D.d.ts +57 -0
- package/dist/rendering/world3d/Camera3D.js +129 -0
- package/dist/rendering/world3d/Character3D.d.ts +123 -0
- package/dist/rendering/world3d/Character3D.js +303 -0
- package/dist/rendering/world3d/Cloth3D.d.ts +115 -0
- package/dist/rendering/world3d/Cloth3D.js +498 -0
- package/dist/rendering/world3d/Compression3D.d.ts +21 -0
- package/dist/rendering/world3d/Compression3D.js +702 -0
- package/dist/rendering/world3d/Curves3D.d.ts +111 -0
- package/dist/rendering/world3d/Curves3D.js +455 -0
- package/dist/rendering/world3d/Decal3D.d.ts +41 -0
- package/dist/rendering/world3d/Decal3D.js +241 -0
- package/dist/rendering/world3d/Geometry3D.d.ts +85 -0
- package/dist/rendering/world3d/Geometry3D.js +326 -0
- package/dist/rendering/world3d/GeometryBuilder3D.d.ts +51 -0
- package/dist/rendering/world3d/GeometryBuilder3D.js +196 -0
- package/dist/rendering/world3d/Gizmo3D.d.ts +75 -0
- package/dist/rendering/world3d/Gizmo3D.js +512 -0
- package/dist/rendering/world3d/Gltf3D.d.ts +67 -0
- package/dist/rendering/world3d/Gltf3D.js +976 -0
- package/dist/rendering/world3d/GpuParticles3D.d.ts +107 -0
- package/dist/rendering/world3d/GpuParticles3D.js +400 -0
- package/dist/rendering/world3d/Hdr3D.d.ts +33 -0
- package/dist/rendering/world3d/Hdr3D.js +190 -0
- package/dist/rendering/world3d/Jelly3D.d.ts +75 -0
- package/dist/rendering/world3d/Jelly3D.js +266 -0
- package/dist/rendering/world3d/Ktx23D.d.ts +27 -0
- package/dist/rendering/world3d/Ktx23D.js +112 -0
- package/dist/rendering/world3d/Light3D.d.ts +75 -0
- package/dist/rendering/world3d/Light3D.js +93 -0
- package/dist/rendering/world3d/Material3D.d.ts +243 -0
- package/dist/rendering/world3d/Material3D.js +267 -0
- package/dist/rendering/world3d/Mesh3D.d.ts +108 -0
- package/dist/rendering/world3d/Mesh3D.js +323 -0
- package/dist/rendering/world3d/Meshopt3D.d.ts +12 -0
- package/dist/rendering/world3d/Meshopt3D.js +275 -0
- package/dist/rendering/world3d/Navigation3D.d.ts +173 -0
- package/dist/rendering/world3d/Navigation3D.js +971 -0
- package/dist/rendering/world3d/Object3D.d.ts +107 -0
- package/dist/rendering/world3d/Object3D.js +305 -0
- package/dist/rendering/world3d/Particles3D.d.ts +85 -0
- package/dist/rendering/world3d/Particles3D.js +274 -0
- package/dist/rendering/world3d/Physics3D.d.ts +416 -0
- package/dist/rendering/world3d/Physics3D.js +2835 -0
- package/dist/rendering/world3d/PhysicsHull3D.d.ts +35 -0
- package/dist/rendering/world3d/PhysicsHull3D.js +227 -0
- package/dist/rendering/world3d/PhysicsMesh3D.d.ts +39 -0
- package/dist/rendering/world3d/PhysicsMesh3D.js +338 -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 +174 -0
- package/dist/rendering/world3d/PhysicsRemote3D.js +534 -0
- package/dist/rendering/world3d/Ragdoll3D.d.ts +69 -0
- package/dist/rendering/world3d/Ragdoll3D.js +200 -0
- package/dist/rendering/world3d/Raycast3D.d.ts +37 -0
- package/dist/rendering/world3d/Raycast3D.js +246 -0
- package/dist/rendering/world3d/RenderList3D.d.ts +88 -0
- package/dist/rendering/world3d/RenderList3D.js +490 -0
- package/dist/rendering/world3d/Retarget3D.d.ts +20 -0
- package/dist/rendering/world3d/Retarget3D.js +185 -0
- package/dist/rendering/world3d/Serialize3D.d.ts +49 -0
- package/dist/rendering/world3d/Serialize3D.js +607 -0
- package/dist/rendering/world3d/StateMachine3D.d.ts +78 -0
- package/dist/rendering/world3d/StateMachine3D.js +277 -0
- package/dist/rendering/world3d/Terrain3D.d.ts +227 -0
- package/dist/rendering/world3d/Terrain3D.js +803 -0
- package/dist/rendering/world3d/Text3D.d.ts +90 -0
- package/dist/rendering/world3d/Text3D.js +558 -0
- package/dist/rendering/world3d/Texture3D.d.ts +133 -0
- package/dist/rendering/world3d/Texture3D.js +252 -0
- package/dist/rendering/world3d/Trail3D.d.ts +59 -0
- package/dist/rendering/world3d/Trail3D.js +193 -0
- package/dist/rendering/world3d/Vehicle3D.d.ts +97 -0
- package/dist/rendering/world3d/Vehicle3D.js +226 -0
- package/dist/rendering/world3d/VolumetricFog3D.d.ts +55 -0
- package/dist/rendering/world3d/VolumetricFog3D.js +229 -0
- package/dist/rendering/world3d/Water3D.d.ts +163 -0
- package/dist/rendering/world3d/Water3D.js +606 -0
- package/dist/rendering/world3d/core3D.d.ts +34 -0
- package/dist/rendering/world3d/core3D.js +99 -0
- package/dist/rendering/world3d/debug3D.d.ts +64 -0
- package/dist/rendering/world3d/debug3D.js +257 -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 +99 -0
- package/dist/rendering/world3d/geometries3D.js +605 -0
- package/dist/rendering/world3d/helpers3D.d.ts +65 -0
- package/dist/rendering/world3d/helpers3D.js +177 -0
- package/dist/rendering/world3d/index.d.ts +91 -0
- package/dist/rendering/world3d/index.js +56 -0
- package/dist/rendering/world3d/math3D.d.ts +78 -0
- package/dist/rendering/world3d/math3D.js +640 -0
- package/dist/rendering/world3d/primitives3D.d.ts +60 -0
- package/dist/rendering/world3d/primitives3D.js +196 -0
- package/dist/resources.d.ts +8 -0
- package/dist/resources.js +6 -0
- package/dist/saveStore.d.ts +56 -0
- package/dist/saveStore.js +163 -0
- package/dist/semanticList.d.ts +122 -0
- package/dist/semanticList.js +174 -0
- package/dist/semanticTree.d.ts +10 -0
- package/dist/semanticTree.js +532 -0
- package/dist/semanticTypes.d.ts +167 -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 +21 -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 +23 -0
- package/dist/text.js +4 -0
- package/dist/textField.d.ts +6 -0
- package/dist/textField.js +6 -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 +169 -0
- package/dist/tilemapTypes.js +2 -0
- package/dist/tween.d.ts +15 -0
- package/dist/tween.js +329 -0
- package/dist/tweenTypes.d.ts +27 -0
- package/dist/tweenTypes.js +2 -0
- package/dist/ui/controlKeys.d.ts +109 -0
- package/dist/ui/controlKeys.js +249 -0
- package/dist/ui/controls.d.ts +52 -0
- package/dist/ui/controls.js +288 -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 +91 -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 +50 -0
- package/dist/ui/rangeControl.js +167 -0
- package/dist/ui/scrollControl.d.ts +72 -0
- package/dist/ui/scrollControl.js +218 -0
- package/dist/ui/stateControls.d.ts +82 -0
- package/dist/ui/stateControls.js +328 -0
- package/dist/ui/textEditor.d.ts +53 -0
- package/dist/ui/textEditor.js +370 -0
- package/dist/ui/textEditorTypes.d.ts +78 -0
- package/dist/ui/textEditorTypes.js +2 -0
- package/dist/ui/textFieldControl.d.ts +96 -0
- package/dist/ui/textFieldControl.js +259 -0
- package/dist/ui/theme.d.ts +59 -0
- package/dist/ui/theme.js +165 -0
- package/dist/ui/types.d.ts +265 -0
- package/dist/ui/types.js +2 -0
- package/dist/ui/uiRoot.d.ts +4 -0
- package/dist/ui/uiRoot.js +1497 -0
- package/dist/ui/uiRootDisplay.d.ts +46 -0
- package/dist/ui/uiRootDisplay.js +148 -0
- package/dist/ui/uiRootModel.d.ts +112 -0
- package/dist/ui/uiRootModel.js +60 -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 +74 -0
- package/dist/videoTypes.js +2 -0
- package/dist/web/BrowserAssetBundle.d.ts +39 -0
- package/dist/web/BrowserAssetBundle.js +136 -0
- package/dist/web/BrowserAudio.d.ts +41 -0
- package/dist/web/BrowserAudio.js +473 -0
- package/dist/web/BrowserFrameLoop.d.ts +65 -0
- package/dist/web/BrowserFrameLoop.js +125 -0
- package/dist/web/BrowserGame.d.ts +112 -0
- package/dist/web/BrowserGame.js +352 -0
- package/dist/web/BrowserGamepadInput.d.ts +35 -0
- package/dist/web/BrowserGamepadInput.js +134 -0
- package/dist/web/BrowserHoverInput.d.ts +24 -0
- package/dist/web/BrowserHoverInput.js +266 -0
- package/dist/web/BrowserImageTextures.d.ts +66 -0
- package/dist/web/BrowserImageTextures.js +169 -0
- package/dist/web/BrowserInputActions.d.ts +53 -0
- package/dist/web/BrowserInputActions.js +342 -0
- package/dist/web/BrowserKeyboardInput.d.ts +4 -0
- package/dist/web/BrowserKeyboardInput.js +223 -0
- package/dist/web/BrowserPlay.d.ts +289 -0
- package/dist/web/BrowserPlay.js +1301 -0
- package/dist/web/BrowserPointerInput.d.ts +4 -0
- package/dist/web/BrowserPointerInput.js +511 -0
- package/dist/web/BrowserSemantics.d.ts +34 -0
- package/dist/web/BrowserSemantics.js +418 -0
- package/dist/web/BrowserStatsPanel.d.ts +46 -0
- package/dist/web/BrowserStatsPanel.js +137 -0
- package/dist/web/BrowserStorage.d.ts +33 -0
- package/dist/web/BrowserStorage.js +132 -0
- package/dist/web/BrowserTextEditor.d.ts +49 -0
- package/dist/web/BrowserTextEditor.js +839 -0
- package/dist/web/BrowserTextInput.d.ts +83 -0
- package/dist/web/BrowserTextInput.js +524 -0
- package/dist/web/BrowserTextureProvider.d.ts +52 -0
- package/dist/web/BrowserTextureProvider.js +935 -0
- package/dist/web/BrowserVideo.d.ts +28 -0
- package/dist/web/BrowserVideo.js +211 -0
- package/dist/web/CanvasKitFontSetProvider.d.ts +29 -0
- package/dist/web/CanvasKitFontSetProvider.js +215 -0
- package/dist/web/CanvasKitParagraphProvider.d.ts +169 -0
- package/dist/web/CanvasKitParagraphProvider.js +691 -0
- package/dist/web/CanvasTextRasterProvider.d.ts +4 -0
- package/dist/web/CanvasTextRasterProvider.js +312 -0
- package/dist/web/ManifestByteSource.d.ts +147 -0
- package/dist/web/ManifestByteSource.js +974 -0
- package/dist/web/ManifestFontContentLoader.d.ts +12 -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 +2672 -0
- package/dist/web/WebGPUHost.d.ts +87 -0
- package/dist/web/WebGPUHost.js +3349 -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 +50 -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 +14 -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 +10 -0
- package/dist/web/kit.js +7 -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 +5 -0
- package/dist/web/play.js +6 -0
- package/dist/web/playSfx.d.ts +36 -0
- package/dist/web/playSfx.js +112 -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 +57 -0
- package/dist/web/resources.d.ts +27 -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 +9 -0
- package/dist/web/sharedEffectShaders.js +165 -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 +30 -0
- package/dist/web/sharedWebGL2Options.js +96 -0
- package/dist/web/sharedWebGL2Shaders.d.ts +20 -0
- package/dist/web/sharedWebGL2Shaders.js +314 -0
- package/dist/web/sharedWebGPUOptions.d.ts +37 -0
- package/dist/web/sharedWebGPUOptions.js +126 -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 +70 -0
- package/dist/web/webgl2Native.js +568 -0
- package/dist/web/webgl2Types.d.ts +132 -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 +53 -0
- package/dist/web/webgpuImageResidency.js +61 -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 +84 -0
- package/dist/web/webgpuSharedPass.d.ts +7 -0
- package/dist/web/webgpuSharedPass.js +211 -0
- package/dist/web/webgpuSharedResolvePass.d.ts +3 -0
- package/dist/web/webgpuSharedResolvePass.js +29 -0
- package/dist/web/world3d/Audio3D.d.ts +68 -0
- package/dist/web/world3d/Audio3D.js +212 -0
- package/dist/web/world3d/BrowserPlay3D.d.ts +182 -0
- package/dist/web/world3d/BrowserPlay3D.js +851 -0
- package/dist/web/world3d/FlyControls3D.d.ts +55 -0
- package/dist/web/world3d/FlyControls3D.js +160 -0
- package/dist/web/world3d/FollowControls3D.d.ts +28 -0
- package/dist/web/world3d/FollowControls3D.js +117 -0
- package/dist/web/world3d/OrbitControls3D.d.ts +55 -0
- package/dist/web/world3d/OrbitControls3D.js +187 -0
- package/dist/web/world3d/TransformControls3D.d.ts +34 -0
- package/dist/web/world3d/TransformControls3D.js +125 -0
- package/dist/web/world3d/WebGL2Renderer3D.d.ts +133 -0
- package/dist/web/world3d/WebGL2Renderer3D.js +1173 -0
- package/dist/web/world3d/WebGPURenderer3D.d.ts +110 -0
- package/dist/web/world3d/WebGPURenderer3D.js +1915 -0
- package/dist/web/world3d/World3DView.d.ts +51 -0
- package/dist/web/world3d/World3DView.js +77 -0
- package/dist/web/world3d/app3D.d.ts +136 -0
- package/dist/web/world3d/app3D.js +304 -0
- package/dist/web/world3d/assets3D.d.ts +38 -0
- package/dist/web/world3d/assets3D.js +112 -0
- package/dist/web/world3d/atmosphere3D.d.ts +47 -0
- package/dist/web/world3d/atmosphere3D.js +178 -0
- package/dist/web/world3d/frame3D.d.ts +142 -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 +23 -0
- package/dist/web/world3d/host3D.js +61 -0
- package/dist/web/world3d/index.d.ts +38 -0
- package/dist/web/world3d/index.js +23 -0
- package/dist/web/world3d/loaders3D.d.ts +26 -0
- package/dist/web/world3d/loaders3D.js +138 -0
- package/dist/web/world3d/markers3D.d.ts +49 -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 +28 -0
- package/dist/web/world3d/overlay3D.js +170 -0
- package/dist/web/world3d/post3D.d.ts +112 -0
- package/dist/web/world3d/post3D.js +459 -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 +14 -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 +31 -0
- package/dist/web/world3d/stats3D.js +80 -0
- package/dist/web/world3d/webGL2FrameMetrics3D.d.ts +66 -0
- package/dist/web/world3d/webGL2FrameMetrics3D.js +185 -0
- package/dist/web/world3d/webgpu.d.ts +35 -0
- package/dist/web/world3d/webgpu.js +22 -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,241 @@
|
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
// Decals: a texture laid onto existing geometry, such as a bullet hole, a
|
|
3
|
+
// scorch mark or a painted sign. The triangles of the target that fall inside
|
|
4
|
+
// a box are cut out and returned as a new geometry that hugs the surface, so
|
|
5
|
+
// the decal is lit and shadowed like any other mesh on both backends.
|
|
6
|
+
import { World3DError, requireFinite3D, requirePositive3D } from './core3D.js';
|
|
7
|
+
import { Attribute3D, Geometry3D } from './Geometry3D.js';
|
|
8
|
+
import { Mesh3D } from './Mesh3D.js';
|
|
9
|
+
import { mat4Invert, mat4Multiply } from './math3D.js';
|
|
10
|
+
export const DECAL3D_LIMITS = Object.freeze({ maxTriangles: 262144 });
|
|
11
|
+
/**
|
|
12
|
+
* Cut the part of a mesh's surface that lies inside the decal box. The
|
|
13
|
+
* result is in the mesh's local space, with coordinates running 0 to 1 across
|
|
14
|
+
* the box, or undefined when nothing is inside. A skinned mesh is cut in its
|
|
15
|
+
* bind pose, where `position` and `normal` must lie too, and the result keeps
|
|
16
|
+
* joints and weights so it can follow the same skeleton. Interpolated weights
|
|
17
|
+
* approximate the posed surface where the source vertices have different weights.
|
|
18
|
+
*/
|
|
19
|
+
export function createDecalGeometry3D(mesh, options) {
|
|
20
|
+
if (!(mesh instanceof Mesh3D) || !options)
|
|
21
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'decal target');
|
|
22
|
+
const geometry = mesh.geometry, source = geometry.getAttribute('position');
|
|
23
|
+
if (!source || geometry.topology !== 'triangles')
|
|
24
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'decal target needs triangles');
|
|
25
|
+
const width = requirePositive3D(options.width ?? 1, 'width'), height = requirePositive3D(options.height ?? 1, 'height'), depth = requirePositive3D(options.depth ?? Math.max(width, height) / 2, 'depth');
|
|
26
|
+
const limit = Math.cos(requireFinite3D(options.maxAngle ?? 1.4, 'maxAngle')), lift = requireFinite3D(options.offset ?? 0.002, 'offset');
|
|
27
|
+
// The decal's frame in world space: Z faces away from the surface.
|
|
28
|
+
let zx = requireFinite3D(options.normal[0], 'normal'), zy = requireFinite3D(options.normal[1], 'normal'), zz = requireFinite3D(options.normal[2], 'normal');
|
|
29
|
+
const zl = Math.hypot(zx, zy, zz);
|
|
30
|
+
if (zl < 1e-9)
|
|
31
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'normal');
|
|
32
|
+
zx /= zl;
|
|
33
|
+
zy /= zl;
|
|
34
|
+
zz /= zl;
|
|
35
|
+
const hint = options.up ?? (Math.abs(zy) > 0.99 ? [0, 0, -1] : [0, 1, 0]);
|
|
36
|
+
let xx = hint[1] * zz - hint[2] * zy, xy = hint[2] * zx - hint[0] * zz, xz = hint[0] * zy - hint[1] * zx;
|
|
37
|
+
const xl = Math.hypot(xx, xy, xz);
|
|
38
|
+
if (xl < 1e-9)
|
|
39
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'up must not be parallel to the normal');
|
|
40
|
+
xx /= xl;
|
|
41
|
+
xy /= xl;
|
|
42
|
+
xz /= xl;
|
|
43
|
+
let yx = zy * xz - zz * xy, yy = zz * xx - zx * xz, yz = zx * xy - zy * xx;
|
|
44
|
+
const turn = requireFinite3D(options.rotation ?? 0, 'rotation'), c = Math.cos(turn), s = Math.sin(turn);
|
|
45
|
+
[xx, xy, xz, yx, yy, yz] = [
|
|
46
|
+
xx * c + yx * s,
|
|
47
|
+
xy * c + yy * s,
|
|
48
|
+
xz * c + yz * s,
|
|
49
|
+
yx * c - xx * s,
|
|
50
|
+
yy * c - xy * s,
|
|
51
|
+
yz * c - xz * s
|
|
52
|
+
];
|
|
53
|
+
const frame = new Float32Array([
|
|
54
|
+
xx,
|
|
55
|
+
xy,
|
|
56
|
+
xz,
|
|
57
|
+
0,
|
|
58
|
+
yx,
|
|
59
|
+
yy,
|
|
60
|
+
yz,
|
|
61
|
+
0,
|
|
62
|
+
zx,
|
|
63
|
+
zy,
|
|
64
|
+
zz,
|
|
65
|
+
0,
|
|
66
|
+
requireFinite3D(options.position[0], 'position'),
|
|
67
|
+
requireFinite3D(options.position[1], 'position'),
|
|
68
|
+
requireFinite3D(options.position[2], 'position'),
|
|
69
|
+
1
|
|
70
|
+
]);
|
|
71
|
+
mesh.updateWorldMatrix();
|
|
72
|
+
// Mesh space to decal space and back.
|
|
73
|
+
const toDecal = new Float32Array(16), toMesh = new Float32Array(16);
|
|
74
|
+
if (!mat4Invert(toDecal, frame))
|
|
75
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'decal frame');
|
|
76
|
+
mat4Multiply(toDecal, toDecal, mesh.matrixWorld);
|
|
77
|
+
if (!mat4Invert(toMesh, toDecal))
|
|
78
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'mesh transform is singular');
|
|
79
|
+
const p = source.data, normals = geometry.getAttribute('normal')?.data, index = geometry.index?.data, count = index ? index.length : source.count;
|
|
80
|
+
if (count / 3 > DECAL3D_LIMITS.maxTriangles)
|
|
81
|
+
throw new World3DError('WORLD3D_BUDGET', 'decal target triangles');
|
|
82
|
+
const hx = width / 2, hy = height / 2, hz = depth / 2, m = toDecal;
|
|
83
|
+
// Reflected transforms reverse winding, but the renderers keep the same visible face.
|
|
84
|
+
const determinant = m[0] * (m[5] * m[10] - m[6] * m[9]) -
|
|
85
|
+
m[4] * (m[1] * m[10] - m[2] * m[9]) +
|
|
86
|
+
m[8] * (m[1] * m[6] - m[2] * m[5]);
|
|
87
|
+
const facing = determinant < 0 ? -1 : 1;
|
|
88
|
+
const joints = geometry.getAttribute('joints')?.data, weights = geometry.getAttribute('weights')?.data, skinned = joints !== undefined && weights !== undefined;
|
|
89
|
+
const read = (i) => {
|
|
90
|
+
const x = p[i * 3], y = p[i * 3 + 1], z = p[i * 3 + 2];
|
|
91
|
+
const out = [
|
|
92
|
+
m[0] * x + m[4] * y + m[8] * z + m[12],
|
|
93
|
+
m[1] * x + m[5] * y + m[9] * z + m[13],
|
|
94
|
+
m[2] * x + m[6] * y + m[10] * z + m[14],
|
|
95
|
+
0,
|
|
96
|
+
0,
|
|
97
|
+
0
|
|
98
|
+
];
|
|
99
|
+
if (normals) {
|
|
100
|
+
const nx = normals[i * 3], ny = normals[i * 3 + 1], nz = normals[i * 3 + 2];
|
|
101
|
+
// Normals use the inverse transpose, so lifting the decal follows the surface under nonuniform scale.
|
|
102
|
+
const inverse = toMesh;
|
|
103
|
+
out[3] = inverse[0] * nx + inverse[1] * ny + inverse[2] * nz;
|
|
104
|
+
out[4] = inverse[4] * nx + inverse[5] * ny + inverse[6] * nz;
|
|
105
|
+
out[5] = inverse[8] * nx + inverse[9] * ny + inverse[10] * nz;
|
|
106
|
+
}
|
|
107
|
+
if (skinned) {
|
|
108
|
+
out.bones = [];
|
|
109
|
+
for (let k = 0; k < 4; k++)
|
|
110
|
+
if (weights[i * 4 + k] > 0)
|
|
111
|
+
out.bones.push(joints[i * 4 + k], weights[i * 4 + k]);
|
|
112
|
+
}
|
|
113
|
+
return out;
|
|
114
|
+
};
|
|
115
|
+
// Sutherland-Hodgman: keep the part of a polygon on the inner side of one face of the box.
|
|
116
|
+
const clip = (polygon, axis, sign, half) => {
|
|
117
|
+
const out = [];
|
|
118
|
+
for (let i = 0; i < polygon.length; i++) {
|
|
119
|
+
const a = polygon[i], b = polygon[(i + 1) % polygon.length], da = half - a[axis] * sign, db = half - b[axis] * sign;
|
|
120
|
+
if (da >= 0)
|
|
121
|
+
out.push(a);
|
|
122
|
+
if (da >= 0 !== db >= 0) {
|
|
123
|
+
const t = da / (da - db);
|
|
124
|
+
const cut = [
|
|
125
|
+
a[0] + (b[0] - a[0]) * t,
|
|
126
|
+
a[1] + (b[1] - a[1]) * t,
|
|
127
|
+
a[2] + (b[2] - a[2]) * t,
|
|
128
|
+
a[3] + (b[3] - a[3]) * t,
|
|
129
|
+
a[4] + (b[4] - a[4]) * t,
|
|
130
|
+
a[5] + (b[5] - a[5]) * t
|
|
131
|
+
];
|
|
132
|
+
if (a.bones && b.bones) {
|
|
133
|
+
// Blend endpoint influences to approximate attachment along the clipped edge.
|
|
134
|
+
cut.bones = [];
|
|
135
|
+
for (let k = 0; k < a.bones.length; k += 2)
|
|
136
|
+
cut.bones.push(a.bones[k], a.bones[k + 1] * (1 - t));
|
|
137
|
+
for (let k = 0; k < b.bones.length; k += 2) {
|
|
138
|
+
const known = cut.bones.findIndex((value, at) => at % 2 === 0 && value === b.bones[k]);
|
|
139
|
+
if (known >= 0)
|
|
140
|
+
cut.bones[known + 1] = cut.bones[known + 1] + b.bones[k + 1] * t;
|
|
141
|
+
else
|
|
142
|
+
cut.bones.push(b.bones[k], b.bones[k + 1] * t);
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
out.push(cut);
|
|
146
|
+
}
|
|
147
|
+
}
|
|
148
|
+
return out;
|
|
149
|
+
};
|
|
150
|
+
const outPositions = [], outNormals = [], outUvs = [], outJoints = [], outWeights = [];
|
|
151
|
+
for (let t = 0; t < count; t += 3) {
|
|
152
|
+
const a = read(index ? index[t] : t), b = read(index ? index[t + 1] : t + 1), d = read(index ? index[t + 2] : t + 2);
|
|
153
|
+
// Quick rejects: wholly outside one face of the box, or turned away from the decal.
|
|
154
|
+
if (Math.min(a[0], b[0], d[0]) > hx ||
|
|
155
|
+
Math.max(a[0], b[0], d[0]) < -hx ||
|
|
156
|
+
Math.min(a[1], b[1], d[1]) > hy ||
|
|
157
|
+
Math.max(a[1], b[1], d[1]) < -hy ||
|
|
158
|
+
Math.min(a[2], b[2], d[2]) > hz ||
|
|
159
|
+
Math.max(a[2], b[2], d[2]) < -hz)
|
|
160
|
+
continue;
|
|
161
|
+
const ux = b[0] - a[0], uy = b[1] - a[1], uz = b[2] - a[2], vx = d[0] - a[0], vy = d[1] - a[1], vz = d[2] - a[2];
|
|
162
|
+
let fx = uy * vz - uz * vy, fy = uz * vx - ux * vz, fz = ux * vy - uy * vx;
|
|
163
|
+
const fl = Math.hypot(fx, fy, fz);
|
|
164
|
+
if (fl < 1e-12 || (facing * fz) / fl < limit)
|
|
165
|
+
continue;
|
|
166
|
+
const normalScale = facing / fl;
|
|
167
|
+
fx *= normalScale;
|
|
168
|
+
fy *= normalScale;
|
|
169
|
+
fz *= normalScale;
|
|
170
|
+
if (!normals)
|
|
171
|
+
for (const vertex of [a, b, d]) {
|
|
172
|
+
vertex[3] = fx;
|
|
173
|
+
vertex[4] = fy;
|
|
174
|
+
vertex[5] = fz;
|
|
175
|
+
}
|
|
176
|
+
let polygon = [a, b, d];
|
|
177
|
+
polygon = clip(polygon, 0, 1, hx);
|
|
178
|
+
polygon = clip(polygon, 0, -1, hx);
|
|
179
|
+
polygon = clip(polygon, 1, 1, hy);
|
|
180
|
+
polygon = clip(polygon, 1, -1, hy);
|
|
181
|
+
polygon = clip(polygon, 2, 1, hz);
|
|
182
|
+
polygon = clip(polygon, 2, -1, hz);
|
|
183
|
+
for (let i = 1; i + 1 < polygon.length; i++) {
|
|
184
|
+
for (const vertex of [polygon[0], polygon[i], polygon[i + 1]]) {
|
|
185
|
+
const nl = Math.hypot(vertex[3], vertex[4], vertex[5]) || 1, nx = vertex[3] / nl, ny = vertex[4] / nl, nz = vertex[5] / nl;
|
|
186
|
+
const x = vertex[0] + nx * lift, y = vertex[1] + ny * lift, z = vertex[2] + nz * lift, w = toMesh;
|
|
187
|
+
outPositions.push(w[0] * x + w[4] * y + w[8] * z + w[12], w[1] * x + w[5] * y + w[9] * z + w[13], w[2] * x + w[6] * y + w[10] * z + w[14]);
|
|
188
|
+
const mx = m[0] * nx + m[1] * ny + m[2] * nz, my = m[4] * nx + m[5] * ny + m[6] * nz, mz = m[8] * nx + m[9] * ny + m[10] * nz;
|
|
189
|
+
const ml = Math.hypot(mx, my, mz) || 1;
|
|
190
|
+
outNormals.push(mx / ml, my / ml, mz / ml);
|
|
191
|
+
outUvs.push(vertex[0] / width + 0.5, vertex[1] / height + 0.5);
|
|
192
|
+
if (skinned) {
|
|
193
|
+
// Keep the four strongest bones and make their weights sum to one.
|
|
194
|
+
const pairs = [];
|
|
195
|
+
for (let k = 0; k < (vertex.bones?.length ?? 0); k += 2)
|
|
196
|
+
pairs.push([vertex.bones[k], vertex.bones[k + 1]]);
|
|
197
|
+
pairs.sort((first, second) => second[1] - first[1]);
|
|
198
|
+
const kept = pairs.slice(0, 4), total = kept.reduce((sum, pair) => sum + pair[1], 0) || 1;
|
|
199
|
+
for (let k = 0; k < 4; k++) {
|
|
200
|
+
outJoints.push(kept[k]?.[0] ?? 0);
|
|
201
|
+
outWeights.push((kept[k]?.[1] ?? 0) / total);
|
|
202
|
+
}
|
|
203
|
+
}
|
|
204
|
+
}
|
|
205
|
+
}
|
|
206
|
+
}
|
|
207
|
+
if (outPositions.length === 0)
|
|
208
|
+
return undefined;
|
|
209
|
+
const out = new Geometry3D();
|
|
210
|
+
out.setAttribute('position', new Attribute3D(new Float32Array(outPositions), 3));
|
|
211
|
+
out.setAttribute('normal', new Attribute3D(new Float32Array(outNormals), 3));
|
|
212
|
+
out.setAttribute('uv', new Attribute3D(new Float32Array(outUvs), 2));
|
|
213
|
+
if (skinned) {
|
|
214
|
+
out.setAttribute('joints', new Attribute3D(new Uint16Array(outJoints), 4));
|
|
215
|
+
out.setAttribute('weights', new Attribute3D(new Float32Array(outWeights), 4));
|
|
216
|
+
}
|
|
217
|
+
return out;
|
|
218
|
+
}
|
|
219
|
+
/**
|
|
220
|
+
* A decal mesh on a target mesh, added as its child so it moves with it.
|
|
221
|
+
* The material is used as given except that it stops writing depth and gains a
|
|
222
|
+
* depth offset when it has none. On a skinned mesh the decal follows the
|
|
223
|
+
* skeleton. Returns undefined when the box misses the surface.
|
|
224
|
+
*/
|
|
225
|
+
export function createDecal3D(mesh, material, options) {
|
|
226
|
+
const geometry = createDecalGeometry3D(mesh, options);
|
|
227
|
+
if (!geometry)
|
|
228
|
+
return undefined;
|
|
229
|
+
material.depthWrite = false;
|
|
230
|
+
material.polygonOffset ??= [-2, -4];
|
|
231
|
+
const decal = new Mesh3D(geometry, material);
|
|
232
|
+
decal.name = 'decal';
|
|
233
|
+
decal.castShadow = false;
|
|
234
|
+
decal.receiveShadow = mesh.receiveShadow;
|
|
235
|
+
mesh.addChild(decal);
|
|
236
|
+
// On a skinned target the decal is moved by the same bones.
|
|
237
|
+
if (mesh.skeleton && geometry.getAttribute('joints'))
|
|
238
|
+
decal.bind(mesh.skeleton, mesh.bindMatrix);
|
|
239
|
+
return decal;
|
|
240
|
+
}
|
|
241
|
+
//# sourceMappingURL=Decal3D.js.map
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
import { Resource3D } from './core3D.js';
|
|
2
|
+
export type AttributeArray3D = Float32Array | Uint32Array | Uint16Array | Uint8Array | Int16Array | Int8Array;
|
|
3
|
+
export type Topology3D = 'triangles' | 'lines' | 'line-strip' | 'points';
|
|
4
|
+
export declare const GEOMETRY3D_LIMITS: Readonly<{
|
|
5
|
+
readonly maxVertices: 4194304;
|
|
6
|
+
readonly maxIndices: 12582912;
|
|
7
|
+
readonly maxMorphTargets: 256;
|
|
8
|
+
readonly maxGroups: 1024;
|
|
9
|
+
}>;
|
|
10
|
+
/** Well-known attribute names understood by the built-in materials. */
|
|
11
|
+
export declare const ATTRIBUTE_3D: Readonly<{
|
|
12
|
+
readonly position: 'position';
|
|
13
|
+
readonly normal: 'normal';
|
|
14
|
+
readonly tangent: 'tangent';
|
|
15
|
+
readonly uv: 'uv';
|
|
16
|
+
readonly uv1: 'uv1';
|
|
17
|
+
readonly color: 'color';
|
|
18
|
+
readonly joints: 'joints';
|
|
19
|
+
readonly weights: 'weights';
|
|
20
|
+
}>;
|
|
21
|
+
export declare class Attribute3D {
|
|
22
|
+
#private;
|
|
23
|
+
readonly data: AttributeArray3D;
|
|
24
|
+
readonly itemSize: number;
|
|
25
|
+
/** Integer data is mapped to [0, 1] or [-1, 1] when sampled as float. */
|
|
26
|
+
readonly normalized: boolean;
|
|
27
|
+
/** Hint that data changes often, so the backend picks a streaming buffer. */
|
|
28
|
+
dynamic: boolean;
|
|
29
|
+
constructor(data: AttributeArray3D, itemSize: number, normalized?: boolean);
|
|
30
|
+
get count(): number;
|
|
31
|
+
get version(): number;
|
|
32
|
+
touch(): void;
|
|
33
|
+
}
|
|
34
|
+
export interface GeometryGroup3D {
|
|
35
|
+
readonly start: number;
|
|
36
|
+
readonly count: number;
|
|
37
|
+
readonly materialIndex: number;
|
|
38
|
+
}
|
|
39
|
+
export interface MorphTarget3D {
|
|
40
|
+
readonly name: string;
|
|
41
|
+
/** Per-vertex deltas relative to the base attribute. */
|
|
42
|
+
readonly position?: Float32Array;
|
|
43
|
+
readonly normal?: Float32Array;
|
|
44
|
+
}
|
|
45
|
+
export declare class Geometry3D extends Resource3D {
|
|
46
|
+
#private;
|
|
47
|
+
topology: Topology3D;
|
|
48
|
+
get attributes(): ReadonlyMap<string, Attribute3D>;
|
|
49
|
+
get index(): Attribute3D | undefined;
|
|
50
|
+
get groups(): readonly GeometryGroup3D[];
|
|
51
|
+
get morphTargets(): readonly MorphTarget3D[];
|
|
52
|
+
get layoutVersion(): number;
|
|
53
|
+
get vertexCount(): number;
|
|
54
|
+
/** Number of indices, or vertices when the geometry is not indexed. */
|
|
55
|
+
get drawCount(): number;
|
|
56
|
+
setAttribute(name: string, attribute: Attribute3D): this;
|
|
57
|
+
getAttribute(name: string): Attribute3D | undefined;
|
|
58
|
+
removeAttribute(name: string): this;
|
|
59
|
+
setIndex(index: Uint16Array | Uint32Array | readonly number[] | undefined): this;
|
|
60
|
+
/** Assign a material slot to an index (or vertex) range. */
|
|
61
|
+
addGroup(start: number, count: number, materialIndex?: number): this;
|
|
62
|
+
clearGroups(): this;
|
|
63
|
+
setMorphTargets(targets: readonly MorphTarget3D[]): this;
|
|
64
|
+
/** Local-space [minX, minY, minZ, maxX, maxY, maxZ], cached until positions change. */
|
|
65
|
+
get boundingBox(): Float32Array;
|
|
66
|
+
/** Local-space [x, y, z, radius]; radius is negative for an empty geometry. */
|
|
67
|
+
get boundingSphere(): Float32Array;
|
|
68
|
+
/** Call after editing position data in place. */
|
|
69
|
+
invalidateBounds(): void;
|
|
70
|
+
/** Area-weighted smooth normals for triangle geometry. */
|
|
71
|
+
computeNormals(): this;
|
|
72
|
+
/** Per-vertex tangents (xyz + handedness) from positions, normals and UVs. */
|
|
73
|
+
computeTangents(): this;
|
|
74
|
+
}
|
|
75
|
+
export interface GeometryInput3D {
|
|
76
|
+
readonly positions: ArrayLike<number>;
|
|
77
|
+
readonly normals?: ArrayLike<number>;
|
|
78
|
+
readonly uvs?: ArrayLike<number>;
|
|
79
|
+
readonly colors?: ArrayLike<number>;
|
|
80
|
+
readonly indices?: ArrayLike<number>;
|
|
81
|
+
readonly topology?: Topology3D;
|
|
82
|
+
}
|
|
83
|
+
/** Build a geometry from plain arrays; missing normals are computed for triangles. */
|
|
84
|
+
export declare function createGeometry3D(input: GeometryInput3D): Geometry3D;
|
|
85
|
+
//# sourceMappingURL=Geometry3D.d.ts.map
|
|
@@ -0,0 +1,326 @@
|
|
|
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
|
+
export const GEOMETRY3D_LIMITS = Object.freeze({
|
|
8
|
+
maxVertices: 4194304,
|
|
9
|
+
maxIndices: 12582912,
|
|
10
|
+
maxMorphTargets: 256,
|
|
11
|
+
maxGroups: 1024
|
|
12
|
+
});
|
|
13
|
+
/** Well-known attribute names understood by the built-in materials. */
|
|
14
|
+
export const ATTRIBUTE_3D = Object.freeze({
|
|
15
|
+
position: 'position',
|
|
16
|
+
normal: 'normal',
|
|
17
|
+
tangent: 'tangent',
|
|
18
|
+
uv: 'uv',
|
|
19
|
+
uv1: 'uv1',
|
|
20
|
+
color: 'color',
|
|
21
|
+
joints: 'joints',
|
|
22
|
+
weights: 'weights'
|
|
23
|
+
});
|
|
24
|
+
export class Attribute3D {
|
|
25
|
+
data;
|
|
26
|
+
itemSize;
|
|
27
|
+
/** Integer data is mapped to [0, 1] or [-1, 1] when sampled as float. */
|
|
28
|
+
normalized;
|
|
29
|
+
/** Hint that data changes often, so the backend picks a streaming buffer. */
|
|
30
|
+
dynamic = false;
|
|
31
|
+
#version = 1;
|
|
32
|
+
constructor(data, itemSize, normalized = false) {
|
|
33
|
+
if (!ArrayBuffer.isView(data) || data instanceof DataView)
|
|
34
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'attribute data');
|
|
35
|
+
if (!Number.isSafeInteger(itemSize) || itemSize < 1 || itemSize > 4 || data.length % itemSize !== 0)
|
|
36
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'attribute itemSize');
|
|
37
|
+
this.data = data;
|
|
38
|
+
this.itemSize = itemSize;
|
|
39
|
+
this.normalized = normalized;
|
|
40
|
+
}
|
|
41
|
+
get count() {
|
|
42
|
+
return this.data.length / this.itemSize;
|
|
43
|
+
}
|
|
44
|
+
get version() {
|
|
45
|
+
return this.#version;
|
|
46
|
+
}
|
|
47
|
+
touch() {
|
|
48
|
+
this.#version++;
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
export class Geometry3D extends Resource3D {
|
|
52
|
+
topology = 'triangles';
|
|
53
|
+
#attributes = new Map();
|
|
54
|
+
#index;
|
|
55
|
+
#groups = [];
|
|
56
|
+
#morphTargets = [];
|
|
57
|
+
#boundingBox;
|
|
58
|
+
#boundingSphere;
|
|
59
|
+
/** Structure version: attribute set, index or morph targets changed. */
|
|
60
|
+
#layoutVersion = 1;
|
|
61
|
+
get attributes() {
|
|
62
|
+
return this.#attributes;
|
|
63
|
+
}
|
|
64
|
+
get index() {
|
|
65
|
+
return this.#index;
|
|
66
|
+
}
|
|
67
|
+
get groups() {
|
|
68
|
+
return this.#groups;
|
|
69
|
+
}
|
|
70
|
+
get morphTargets() {
|
|
71
|
+
return this.#morphTargets;
|
|
72
|
+
}
|
|
73
|
+
get layoutVersion() {
|
|
74
|
+
return this.#layoutVersion;
|
|
75
|
+
}
|
|
76
|
+
get vertexCount() {
|
|
77
|
+
return this.#attributes.get('position')?.count ?? 0;
|
|
78
|
+
}
|
|
79
|
+
/** Number of indices, or vertices when the geometry is not indexed. */
|
|
80
|
+
get drawCount() {
|
|
81
|
+
return this.#index ? this.#index.count : this.vertexCount;
|
|
82
|
+
}
|
|
83
|
+
setAttribute(name, attribute) {
|
|
84
|
+
this.assertLive();
|
|
85
|
+
if (!(attribute instanceof Attribute3D) || typeof name !== 'string' || name.length === 0)
|
|
86
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'attribute');
|
|
87
|
+
requireCount3D(attribute.count, 'vertex count', GEOMETRY3D_LIMITS.maxVertices);
|
|
88
|
+
this.#attributes.set(name, attribute);
|
|
89
|
+
if (name === 'position')
|
|
90
|
+
this.invalidateBounds();
|
|
91
|
+
this.#layoutVersion++;
|
|
92
|
+
this.touch();
|
|
93
|
+
return this;
|
|
94
|
+
}
|
|
95
|
+
getAttribute(name) {
|
|
96
|
+
return this.#attributes.get(name);
|
|
97
|
+
}
|
|
98
|
+
removeAttribute(name) {
|
|
99
|
+
if (this.#attributes.delete(name)) {
|
|
100
|
+
this.#layoutVersion++;
|
|
101
|
+
this.touch();
|
|
102
|
+
}
|
|
103
|
+
return this;
|
|
104
|
+
}
|
|
105
|
+
setIndex(index) {
|
|
106
|
+
this.assertLive();
|
|
107
|
+
if (index === undefined)
|
|
108
|
+
this.#index = undefined;
|
|
109
|
+
else {
|
|
110
|
+
const data = ArrayBuffer.isView(index)
|
|
111
|
+
? index
|
|
112
|
+
: this.vertexCount > 65535
|
|
113
|
+
? new Uint32Array(index)
|
|
114
|
+
: new Uint16Array(index);
|
|
115
|
+
requireCount3D(data.length, 'index count', GEOMETRY3D_LIMITS.maxIndices);
|
|
116
|
+
// An index past the vertex data would read outside the vertex buffers.
|
|
117
|
+
const vertexCount = this.vertexCount;
|
|
118
|
+
if (vertexCount > 0) {
|
|
119
|
+
for (let i = 0; i < data.length; i++)
|
|
120
|
+
if (data[i] >= vertexCount)
|
|
121
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'index out of range');
|
|
122
|
+
}
|
|
123
|
+
if (!ArrayBuffer.isView(index)) {
|
|
124
|
+
for (let i = 0; i < index.length; i++)
|
|
125
|
+
if (!Number.isSafeInteger(index[i]) || index[i] < 0)
|
|
126
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'index value');
|
|
127
|
+
}
|
|
128
|
+
this.#index = new Attribute3D(data, 1);
|
|
129
|
+
}
|
|
130
|
+
this.#layoutVersion++;
|
|
131
|
+
this.touch();
|
|
132
|
+
return this;
|
|
133
|
+
}
|
|
134
|
+
/** Assign a material slot to an index (or vertex) range. */
|
|
135
|
+
addGroup(start, count, materialIndex = 0) {
|
|
136
|
+
requireCount3D(this.#groups.length + 1, 'groups', GEOMETRY3D_LIMITS.maxGroups);
|
|
137
|
+
this.#groups.push(Object.freeze({ start, count, materialIndex }));
|
|
138
|
+
return this;
|
|
139
|
+
}
|
|
140
|
+
clearGroups() {
|
|
141
|
+
this.#groups = [];
|
|
142
|
+
return this;
|
|
143
|
+
}
|
|
144
|
+
setMorphTargets(targets) {
|
|
145
|
+
this.assertLive();
|
|
146
|
+
requireCount3D(targets.length, 'morph targets', GEOMETRY3D_LIMITS.maxMorphTargets);
|
|
147
|
+
const expected = this.vertexCount * 3;
|
|
148
|
+
for (const target of targets) {
|
|
149
|
+
if ((target.position && target.position.length !== expected) ||
|
|
150
|
+
(target.normal && target.normal.length !== expected)) {
|
|
151
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'morph target length');
|
|
152
|
+
}
|
|
153
|
+
}
|
|
154
|
+
this.#morphTargets = targets.map(target => Object.freeze({ ...target }));
|
|
155
|
+
this.#layoutVersion++;
|
|
156
|
+
this.touch();
|
|
157
|
+
return this;
|
|
158
|
+
}
|
|
159
|
+
// ---- bounds ------------------------------------------------------------
|
|
160
|
+
/** Local-space [minX, minY, minZ, maxX, maxY, maxZ], cached until positions change. */
|
|
161
|
+
get boundingBox() {
|
|
162
|
+
if (this.#boundingBox)
|
|
163
|
+
return this.#boundingBox;
|
|
164
|
+
const box = box3Empty(new Float32Array(6));
|
|
165
|
+
const position = this.#attributes.get('position');
|
|
166
|
+
if (position) {
|
|
167
|
+
const data = position.data, size = position.itemSize;
|
|
168
|
+
for (let i = 0; i < data.length; i += size)
|
|
169
|
+
box3ExpandByPoint(box, data[i], data[i + 1], size > 2 ? data[i + 2] : 0);
|
|
170
|
+
// Morph deltas can move vertices outside the base bounds.
|
|
171
|
+
if (this.#morphTargets.length) {
|
|
172
|
+
const grow = new Float32Array(3);
|
|
173
|
+
for (const target of this.#morphTargets) {
|
|
174
|
+
const delta = target.position;
|
|
175
|
+
if (!delta)
|
|
176
|
+
continue;
|
|
177
|
+
let x = 0, y = 0, z = 0;
|
|
178
|
+
for (let i = 0; i < delta.length; i += 3) {
|
|
179
|
+
x = Math.max(x, Math.abs(delta[i]));
|
|
180
|
+
y = Math.max(y, Math.abs(delta[i + 1]));
|
|
181
|
+
z = Math.max(z, Math.abs(delta[i + 2]));
|
|
182
|
+
}
|
|
183
|
+
grow[0] += x;
|
|
184
|
+
grow[1] += y;
|
|
185
|
+
grow[2] += z;
|
|
186
|
+
}
|
|
187
|
+
box[0] -= grow[0];
|
|
188
|
+
box[1] -= grow[1];
|
|
189
|
+
box[2] -= grow[2];
|
|
190
|
+
box[3] += grow[0];
|
|
191
|
+
box[4] += grow[1];
|
|
192
|
+
box[5] += grow[2];
|
|
193
|
+
}
|
|
194
|
+
}
|
|
195
|
+
return (this.#boundingBox = box);
|
|
196
|
+
}
|
|
197
|
+
/** Local-space [x, y, z, radius]; radius is negative for an empty geometry. */
|
|
198
|
+
get boundingSphere() {
|
|
199
|
+
return (this.#boundingSphere ??= sphereFromBox(new Float32Array(4), this.boundingBox));
|
|
200
|
+
}
|
|
201
|
+
/** Call after editing position data in place. */
|
|
202
|
+
invalidateBounds() {
|
|
203
|
+
this.#boundingBox = undefined;
|
|
204
|
+
this.#boundingSphere = undefined;
|
|
205
|
+
}
|
|
206
|
+
// ---- derived attributes ------------------------------------------------
|
|
207
|
+
/** Area-weighted smooth normals for triangle geometry. */
|
|
208
|
+
computeNormals() {
|
|
209
|
+
const position = this.#attributes.get('position');
|
|
210
|
+
if (!position || this.topology !== 'triangles')
|
|
211
|
+
return this;
|
|
212
|
+
const p = position.data, vertexCount = position.count, normals = new Float32Array(vertexCount * 3);
|
|
213
|
+
const index = this.#index?.data, triangles = (index ? index.length : vertexCount) / 3;
|
|
214
|
+
for (let t = 0; t < triangles; t++) {
|
|
215
|
+
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;
|
|
216
|
+
const e1x = p[b] - p[a], e1y = p[b + 1] - p[a + 1], e1z = p[b + 2] - p[a + 2];
|
|
217
|
+
const e2x = p[c] - p[a], e2y = p[c + 1] - p[a + 1], e2z = p[c + 2] - p[a + 2];
|
|
218
|
+
const nx = e1y * e2z - e1z * e2y, ny = e1z * e2x - e1x * e2z, nz = e1x * e2y - e1y * e2x;
|
|
219
|
+
for (const v of [a, b, c]) {
|
|
220
|
+
normals[v] += nx;
|
|
221
|
+
normals[v + 1] += ny;
|
|
222
|
+
normals[v + 2] += nz;
|
|
223
|
+
}
|
|
224
|
+
}
|
|
225
|
+
for (let i = 0; i < normals.length; i += 3) {
|
|
226
|
+
const length = Math.hypot(normals[i], normals[i + 1], normals[i + 2]) || 1;
|
|
227
|
+
normals[i] /= length;
|
|
228
|
+
normals[i + 1] /= length;
|
|
229
|
+
normals[i + 2] /= length;
|
|
230
|
+
}
|
|
231
|
+
return this.setAttribute('normal', new Attribute3D(normals, 3));
|
|
232
|
+
}
|
|
233
|
+
/** Per-vertex tangents (xyz + handedness) from positions, normals and UVs. */
|
|
234
|
+
computeTangents() {
|
|
235
|
+
const position = this.#attributes.get('position'), normal = this.#attributes.get('normal'), uv = this.#attributes.get('uv');
|
|
236
|
+
if (!position || !normal || !uv || this.topology !== 'triangles')
|
|
237
|
+
return this;
|
|
238
|
+
const p = position.data, n = normal.data, t = uv.data, vertexCount = position.count;
|
|
239
|
+
const tan = new Float32Array(vertexCount * 3), bitan = new Float32Array(vertexCount * 3), out = new Float32Array(vertexCount * 4);
|
|
240
|
+
const index = this.#index?.data, triangles = (index ? index.length : vertexCount) / 3;
|
|
241
|
+
for (let k = 0; k < triangles; k++) {
|
|
242
|
+
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;
|
|
243
|
+
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];
|
|
244
|
+
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];
|
|
245
|
+
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];
|
|
246
|
+
const determinant = du1 * dv2 - du2 * dv1;
|
|
247
|
+
if (determinant === 0)
|
|
248
|
+
continue;
|
|
249
|
+
const r = 1 / determinant;
|
|
250
|
+
const tx = (e1x * dv2 - e2x * dv1) * r, ty = (e1y * dv2 - e2y * dv1) * r, tz = (e1z * dv2 - e2z * dv1) * r;
|
|
251
|
+
const bx = (e2x * du1 - e1x * du2) * r, by = (e2y * du1 - e1y * du2) * r, bz = (e2z * du1 - e1z * du2) * r;
|
|
252
|
+
for (const v of [a, b, c]) {
|
|
253
|
+
tan[v * 3] += tx;
|
|
254
|
+
tan[v * 3 + 1] += ty;
|
|
255
|
+
tan[v * 3 + 2] += tz;
|
|
256
|
+
bitan[v * 3] += bx;
|
|
257
|
+
bitan[v * 3 + 1] += by;
|
|
258
|
+
bitan[v * 3 + 2] += bz;
|
|
259
|
+
}
|
|
260
|
+
}
|
|
261
|
+
for (let v = 0; v < vertexCount; v++) {
|
|
262
|
+
const nx = n[v * 3], ny = n[v * 3 + 1], nz = n[v * 3 + 2];
|
|
263
|
+
let tx = tan[v * 3], ty = tan[v * 3 + 1], tz = tan[v * 3 + 2];
|
|
264
|
+
// Gram-Schmidt orthogonalization against the normal.
|
|
265
|
+
const d = nx * tx + ny * ty + nz * tz;
|
|
266
|
+
tx -= nx * d;
|
|
267
|
+
ty -= ny * d;
|
|
268
|
+
tz -= nz * d;
|
|
269
|
+
const length = Math.hypot(tx, ty, tz);
|
|
270
|
+
if (length > 0) {
|
|
271
|
+
tx /= length;
|
|
272
|
+
ty /= length;
|
|
273
|
+
tz /= length;
|
|
274
|
+
}
|
|
275
|
+
else {
|
|
276
|
+
tx = 1;
|
|
277
|
+
ty = 0;
|
|
278
|
+
tz = 0;
|
|
279
|
+
}
|
|
280
|
+
const cx = ny * tz - nz * ty, cy = nz * tx - nx * tz, cz = nx * ty - ny * tx;
|
|
281
|
+
const handedness = cx * bitan[v * 3] + cy * bitan[v * 3 + 1] + cz * bitan[v * 3 + 2] < 0 ? -1 : 1;
|
|
282
|
+
out[v * 4] = tx;
|
|
283
|
+
out[v * 4 + 1] = ty;
|
|
284
|
+
out[v * 4 + 2] = tz;
|
|
285
|
+
out[v * 4 + 3] = handedness;
|
|
286
|
+
}
|
|
287
|
+
return this.setAttribute('tangent', new Attribute3D(out, 4));
|
|
288
|
+
}
|
|
289
|
+
}
|
|
290
|
+
/** Build a geometry from plain arrays; missing normals are computed for triangles. */
|
|
291
|
+
export function createGeometry3D(input) {
|
|
292
|
+
if (!input || typeof input !== 'object' || !input.positions || input.positions.length % 3 !== 0)
|
|
293
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'positions');
|
|
294
|
+
const geometry = new Geometry3D();
|
|
295
|
+
geometry.topology = input.topology ?? 'triangles';
|
|
296
|
+
const vertexCount = input.positions.length / 3;
|
|
297
|
+
geometry.setAttribute('position', new Attribute3D(Float32Array.from(input.positions), 3));
|
|
298
|
+
if (input.uvs) {
|
|
299
|
+
if (input.uvs.length !== vertexCount * 2)
|
|
300
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'uvs');
|
|
301
|
+
geometry.setAttribute('uv', new Attribute3D(Float32Array.from(input.uvs), 2));
|
|
302
|
+
}
|
|
303
|
+
if (input.colors) {
|
|
304
|
+
const size = input.colors.length / vertexCount;
|
|
305
|
+
if (size !== 3 && size !== 4)
|
|
306
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'colors');
|
|
307
|
+
geometry.setAttribute('color', new Attribute3D(Float32Array.from(input.colors), size));
|
|
308
|
+
}
|
|
309
|
+
if (input.indices) {
|
|
310
|
+
for (let i = 0; i < input.indices.length; i++) {
|
|
311
|
+
const value = input.indices[i];
|
|
312
|
+
if (!Number.isSafeInteger(value) || value < 0 || value >= vertexCount)
|
|
313
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'indices');
|
|
314
|
+
}
|
|
315
|
+
geometry.setIndex(vertexCount > 65535 ? Uint32Array.from(input.indices) : Uint16Array.from(input.indices));
|
|
316
|
+
}
|
|
317
|
+
if (input.normals) {
|
|
318
|
+
if (input.normals.length !== vertexCount * 3)
|
|
319
|
+
throw new World3DError('WORLD3D_INPUT_INVALID', 'normals');
|
|
320
|
+
geometry.setAttribute('normal', new Attribute3D(Float32Array.from(input.normals), 3));
|
|
321
|
+
}
|
|
322
|
+
else if (geometry.topology === 'triangles')
|
|
323
|
+
geometry.computeNormals();
|
|
324
|
+
return geometry;
|
|
325
|
+
}
|
|
326
|
+
//# sourceMappingURL=Geometry3D.js.map
|