@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.
Files changed (575) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +21 -0
  3. package/README.md +101 -2
  4. package/README.zh-CN.md +102 -0
  5. package/dist/Engine.d.ts +77 -0
  6. package/dist/Engine.js +464 -0
  7. package/dist/animation/index.d.ts +6 -0
  8. package/dist/animation/index.js +5 -0
  9. package/dist/animation/sequenceController.d.ts +22 -0
  10. package/dist/animation/sequenceController.js +618 -0
  11. package/dist/animation/sequenceCoordinator.d.ts +26 -0
  12. package/dist/animation/sequenceCoordinator.js +161 -0
  13. package/dist/animation/sequenceInput.d.ts +25 -0
  14. package/dist/animation/sequenceInput.js +108 -0
  15. package/dist/animation/sequenceMath.d.ts +35 -0
  16. package/dist/animation/sequenceMath.js +164 -0
  17. package/dist/animation/sequenceResetSlot.d.ts +7 -0
  18. package/dist/animation/sequenceResetSlot.js +367 -0
  19. package/dist/animation/sequenceResetTypes.d.ts +42 -0
  20. package/dist/animation/sequenceResetTypes.js +2 -0
  21. package/dist/animation/types.d.ts +69 -0
  22. package/dist/animation/types.js +2 -0
  23. package/dist/assetBundle.d.ts +52 -0
  24. package/dist/assetBundle.js +173 -0
  25. package/dist/assetGroup.d.ts +17 -0
  26. package/dist/assetGroup.js +332 -0
  27. package/dist/assetGroupTypes.d.ts +15 -0
  28. package/dist/assetGroupTypes.js +2 -0
  29. package/dist/audio.d.ts +4 -0
  30. package/dist/audio.js +4 -0
  31. package/dist/audioCues.d.ts +43 -0
  32. package/dist/audioCues.js +127 -0
  33. package/dist/audioMixer.d.ts +7 -0
  34. package/dist/audioMixer.js +785 -0
  35. package/dist/audioTypes.d.ts +233 -0
  36. package/dist/audioTypes.js +3 -0
  37. package/dist/bitmapBindingTicket.d.ts +24 -0
  38. package/dist/bitmapBindingTicket.js +215 -0
  39. package/dist/bitmapButton.d.ts +4 -0
  40. package/dist/bitmapButton.js +407 -0
  41. package/dist/bitmapButtonTypes.d.ts +29 -0
  42. package/dist/bitmapButtonTypes.js +2 -0
  43. package/dist/bitmapFontParse.d.ts +10 -0
  44. package/dist/bitmapFontParse.js +246 -0
  45. package/dist/bitmapFontTypes.d.ts +109 -0
  46. package/dist/bitmapFontTypes.js +2 -0
  47. package/dist/bitmapResourceSlot.d.ts +25 -0
  48. package/dist/bitmapResourceSlot.js +340 -0
  49. package/dist/bitmapText.d.ts +6 -0
  50. package/dist/bitmapText.js +320 -0
  51. package/dist/bitmapfont.d.ts +5 -0
  52. package/dist/bitmapfont.js +5 -0
  53. package/dist/camera.d.ts +4 -0
  54. package/dist/camera.js +4 -0
  55. package/dist/camera2d.d.ts +7 -0
  56. package/dist/camera2d.js +411 -0
  57. package/dist/cameraTypes.d.ts +114 -0
  58. package/dist/cameraTypes.js +2 -0
  59. package/dist/closeHost.d.ts +4 -0
  60. package/dist/closeHost.js +66 -0
  61. package/dist/contentArtifacts.d.ts +12 -0
  62. package/dist/contentArtifacts.js +153 -0
  63. package/dist/contentAtlasPages.d.ts +13 -0
  64. package/dist/contentAtlasPages.js +117 -0
  65. package/dist/contentLoader.d.ts +6 -0
  66. package/dist/contentLoader.js +327 -0
  67. package/dist/contentTypes.d.ts +33 -0
  68. package/dist/contentTypes.js +2 -0
  69. package/dist/createEngine.d.ts +7 -0
  70. package/dist/createEngine.js +25 -0
  71. package/dist/createEngineForProfile.d.ts +5 -0
  72. package/dist/createEngineForProfile.js +42 -0
  73. package/dist/displaySubtreeTicket.d.ts +25 -0
  74. package/dist/displaySubtreeTicket.js +76 -0
  75. package/dist/fontContentLoader.d.ts +6 -0
  76. package/dist/fontContentLoader.js +298 -0
  77. package/dist/fontContentTypes.d.ts +34 -0
  78. package/dist/fontContentTypes.js +2 -0
  79. package/dist/gameClock.d.ts +24 -0
  80. package/dist/gameClock.js +246 -0
  81. package/dist/gameClockTypes.d.ts +31 -0
  82. package/dist/gameClockTypes.js +2 -0
  83. package/dist/gameRun.d.ts +50 -0
  84. package/dist/gameRun.js +97 -0
  85. package/dist/gamepad.d.ts +5 -0
  86. package/dist/gamepad.js +5 -0
  87. package/dist/gamepadInput.d.ts +4 -0
  88. package/dist/gamepadInput.js +281 -0
  89. package/dist/gamepadKeys.d.ts +4 -0
  90. package/dist/gamepadKeys.js +205 -0
  91. package/dist/gamepadTypes.d.ts +134 -0
  92. package/dist/gamepadTypes.js +3 -0
  93. package/dist/hover.d.ts +4 -0
  94. package/dist/hover.js +4 -0
  95. package/dist/hoverInput.d.ts +8 -0
  96. package/dist/hoverInput.js +503 -0
  97. package/dist/hoverInputTypes.d.ts +119 -0
  98. package/dist/hoverInputTypes.js +2 -0
  99. package/dist/index.d.ts +49 -0
  100. package/dist/index.js +20 -0
  101. package/dist/input.d.ts +6 -0
  102. package/dist/input.js +5 -0
  103. package/dist/inputActions.d.ts +81 -0
  104. package/dist/inputActions.js +330 -0
  105. package/dist/internal/contentFactoryState.d.ts +19 -0
  106. package/dist/internal/contentFactoryState.js +42 -0
  107. package/dist/internal/mouseInputFactoryState.d.ts +57 -0
  108. package/dist/internal/mouseInputFactoryState.js +125 -0
  109. package/dist/internal/sequenceControllerFactoryState.d.ts +42 -0
  110. package/dist/internal/sequenceControllerFactoryState.js +98 -0
  111. package/dist/internal/textFieldFactoryState.d.ts +11 -0
  112. package/dist/internal/textFieldFactoryState.js +32 -0
  113. package/dist/internal/texturedFrameState.d.ts +4 -0
  114. package/dist/internal/texturedFrameState.js +12 -0
  115. package/dist/internal/uiFactoryState.d.ts +64 -0
  116. package/dist/internal/uiFactoryState.js +157 -0
  117. package/dist/internal/uiRootState.d.ts +67 -0
  118. package/dist/internal/uiRootState.js +103 -0
  119. package/dist/keyboardInput.d.ts +12 -0
  120. package/dist/keyboardInput.js +578 -0
  121. package/dist/keyboardInputTypes.d.ts +81 -0
  122. package/dist/keyboardInputTypes.js +2 -0
  123. package/dist/kit.d.ts +14 -0
  124. package/dist/kit.js +9 -0
  125. package/dist/layout.d.ts +5 -0
  126. package/dist/layout.js +132 -0
  127. package/dist/layoutTypes.d.ts +28 -0
  128. package/dist/layoutTypes.js +2 -0
  129. package/dist/manifestAssetGroup.d.ts +10 -0
  130. package/dist/manifestAssetGroup.js +477 -0
  131. package/dist/manifestResourceState.d.ts +16 -0
  132. package/dist/manifestResourceState.js +57 -0
  133. package/dist/manifestResourceTypes.d.ts +25 -0
  134. package/dist/manifestResourceTypes.js +2 -0
  135. package/dist/motion.d.ts +33 -0
  136. package/dist/motion.js +206 -0
  137. package/dist/mouseInput.d.ts +102 -0
  138. package/dist/mouseInput.js +562 -0
  139. package/dist/mouseInputTypes.d.ts +37 -0
  140. package/dist/mouseInputTypes.js +2 -0
  141. package/dist/paragraph.d.ts +8 -0
  142. package/dist/paragraph.js +7 -0
  143. package/dist/particleEmitter.d.ts +4 -0
  144. package/dist/particleEmitter.js +292 -0
  145. package/dist/particleTypes.d.ts +107 -0
  146. package/dist/particleTypes.js +2 -0
  147. package/dist/particles.d.ts +4 -0
  148. package/dist/particles.js +4 -0
  149. package/dist/physics2d.d.ts +4 -0
  150. package/dist/physics2d.js +4 -0
  151. package/dist/physics2dGeometry.d.ts +39 -0
  152. package/dist/physics2dGeometry.js +230 -0
  153. package/dist/physics2dTypes.d.ts +167 -0
  154. package/dist/physics2dTypes.js +2 -0
  155. package/dist/physics2dWorld.d.ts +4 -0
  156. package/dist/physics2dWorld.js +623 -0
  157. package/dist/pointerInput.d.ts +11 -0
  158. package/dist/pointerInput.js +299 -0
  159. package/dist/pointerInputTypes.d.ts +38 -0
  160. package/dist/pointerInputTypes.js +2 -0
  161. package/dist/random.d.ts +29 -0
  162. package/dist/random.js +131 -0
  163. package/dist/rendering/ownedPreparationFailure2D.d.ts +5 -0
  164. package/dist/rendering/ownedPreparationFailure2D.js +33 -0
  165. package/dist/rendering/packSharedDraws2D.d.ts +50 -0
  166. package/dist/rendering/packSharedDraws2D.js +331 -0
  167. package/dist/rendering/packedOrientation.d.ts +4 -0
  168. package/dist/rendering/packedOrientation.js +7 -0
  169. package/dist/rendering/prepareRectangles2D.d.ts +92 -0
  170. package/dist/rendering/prepareRectangles2D.js +481 -0
  171. package/dist/rendering/prepareSharedDraws2D.d.ts +88 -0
  172. package/dist/rendering/prepareSharedDraws2D.js +652 -0
  173. package/dist/rendering/preparedBatches2D.d.ts +17 -0
  174. package/dist/rendering/preparedBatches2D.js +30 -0
  175. package/dist/rendering/preparedSharedBatches2D.d.ts +44 -0
  176. package/dist/rendering/preparedSharedBatches2D.js +247 -0
  177. package/dist/rendering/sharedColor2D.d.ts +18 -0
  178. package/dist/rendering/sharedColor2D.js +68 -0
  179. package/dist/rendering/sharedEffects2D.d.ts +23 -0
  180. package/dist/rendering/sharedEffects2D.js +118 -0
  181. package/dist/rendering/sharedPreparationRetention2D.d.ts +120 -0
  182. package/dist/rendering/sharedPreparationRetention2D.js +357 -0
  183. package/dist/rendering/srgbBytes.d.ts +3 -0
  184. package/dist/rendering/srgbBytes.js +64 -0
  185. package/dist/rendering/texturedPreparationBudget2D.d.ts +31 -0
  186. package/dist/rendering/texturedPreparationBudget2D.js +81 -0
  187. package/dist/rendering/world3d/Animation3D.d.ts +95 -0
  188. package/dist/rendering/world3d/Animation3D.js +380 -0
  189. package/dist/rendering/world3d/AnimationTexture3D.d.ts +157 -0
  190. package/dist/rendering/world3d/AnimationTexture3D.js +601 -0
  191. package/dist/rendering/world3d/Batch3D.d.ts +71 -0
  192. package/dist/rendering/world3d/Batch3D.js +329 -0
  193. package/dist/rendering/world3d/Camera3D.d.ts +57 -0
  194. package/dist/rendering/world3d/Camera3D.js +129 -0
  195. package/dist/rendering/world3d/Character3D.d.ts +123 -0
  196. package/dist/rendering/world3d/Character3D.js +303 -0
  197. package/dist/rendering/world3d/Cloth3D.d.ts +115 -0
  198. package/dist/rendering/world3d/Cloth3D.js +498 -0
  199. package/dist/rendering/world3d/Compression3D.d.ts +21 -0
  200. package/dist/rendering/world3d/Compression3D.js +702 -0
  201. package/dist/rendering/world3d/Curves3D.d.ts +111 -0
  202. package/dist/rendering/world3d/Curves3D.js +455 -0
  203. package/dist/rendering/world3d/Decal3D.d.ts +41 -0
  204. package/dist/rendering/world3d/Decal3D.js +241 -0
  205. package/dist/rendering/world3d/Geometry3D.d.ts +85 -0
  206. package/dist/rendering/world3d/Geometry3D.js +326 -0
  207. package/dist/rendering/world3d/GeometryBuilder3D.d.ts +51 -0
  208. package/dist/rendering/world3d/GeometryBuilder3D.js +196 -0
  209. package/dist/rendering/world3d/Gizmo3D.d.ts +75 -0
  210. package/dist/rendering/world3d/Gizmo3D.js +512 -0
  211. package/dist/rendering/world3d/Gltf3D.d.ts +67 -0
  212. package/dist/rendering/world3d/Gltf3D.js +976 -0
  213. package/dist/rendering/world3d/GpuParticles3D.d.ts +107 -0
  214. package/dist/rendering/world3d/GpuParticles3D.js +400 -0
  215. package/dist/rendering/world3d/Hdr3D.d.ts +33 -0
  216. package/dist/rendering/world3d/Hdr3D.js +190 -0
  217. package/dist/rendering/world3d/Jelly3D.d.ts +75 -0
  218. package/dist/rendering/world3d/Jelly3D.js +266 -0
  219. package/dist/rendering/world3d/Ktx23D.d.ts +27 -0
  220. package/dist/rendering/world3d/Ktx23D.js +112 -0
  221. package/dist/rendering/world3d/Light3D.d.ts +75 -0
  222. package/dist/rendering/world3d/Light3D.js +93 -0
  223. package/dist/rendering/world3d/Material3D.d.ts +243 -0
  224. package/dist/rendering/world3d/Material3D.js +267 -0
  225. package/dist/rendering/world3d/Mesh3D.d.ts +108 -0
  226. package/dist/rendering/world3d/Mesh3D.js +323 -0
  227. package/dist/rendering/world3d/Meshopt3D.d.ts +12 -0
  228. package/dist/rendering/world3d/Meshopt3D.js +275 -0
  229. package/dist/rendering/world3d/Navigation3D.d.ts +173 -0
  230. package/dist/rendering/world3d/Navigation3D.js +971 -0
  231. package/dist/rendering/world3d/Object3D.d.ts +107 -0
  232. package/dist/rendering/world3d/Object3D.js +305 -0
  233. package/dist/rendering/world3d/Particles3D.d.ts +85 -0
  234. package/dist/rendering/world3d/Particles3D.js +274 -0
  235. package/dist/rendering/world3d/Physics3D.d.ts +416 -0
  236. package/dist/rendering/world3d/Physics3D.js +2835 -0
  237. package/dist/rendering/world3d/PhysicsHull3D.d.ts +35 -0
  238. package/dist/rendering/world3d/PhysicsHull3D.js +227 -0
  239. package/dist/rendering/world3d/PhysicsMesh3D.d.ts +39 -0
  240. package/dist/rendering/world3d/PhysicsMesh3D.js +338 -0
  241. package/dist/rendering/world3d/PhysicsQueries3D.d.ts +24 -0
  242. package/dist/rendering/world3d/PhysicsQueries3D.js +323 -0
  243. package/dist/rendering/world3d/PhysicsRemote3D.d.ts +174 -0
  244. package/dist/rendering/world3d/PhysicsRemote3D.js +534 -0
  245. package/dist/rendering/world3d/Ragdoll3D.d.ts +69 -0
  246. package/dist/rendering/world3d/Ragdoll3D.js +200 -0
  247. package/dist/rendering/world3d/Raycast3D.d.ts +37 -0
  248. package/dist/rendering/world3d/Raycast3D.js +246 -0
  249. package/dist/rendering/world3d/RenderList3D.d.ts +88 -0
  250. package/dist/rendering/world3d/RenderList3D.js +490 -0
  251. package/dist/rendering/world3d/Retarget3D.d.ts +20 -0
  252. package/dist/rendering/world3d/Retarget3D.js +185 -0
  253. package/dist/rendering/world3d/Serialize3D.d.ts +49 -0
  254. package/dist/rendering/world3d/Serialize3D.js +607 -0
  255. package/dist/rendering/world3d/StateMachine3D.d.ts +78 -0
  256. package/dist/rendering/world3d/StateMachine3D.js +277 -0
  257. package/dist/rendering/world3d/Terrain3D.d.ts +227 -0
  258. package/dist/rendering/world3d/Terrain3D.js +803 -0
  259. package/dist/rendering/world3d/Text3D.d.ts +90 -0
  260. package/dist/rendering/world3d/Text3D.js +558 -0
  261. package/dist/rendering/world3d/Texture3D.d.ts +133 -0
  262. package/dist/rendering/world3d/Texture3D.js +252 -0
  263. package/dist/rendering/world3d/Trail3D.d.ts +59 -0
  264. package/dist/rendering/world3d/Trail3D.js +193 -0
  265. package/dist/rendering/world3d/Vehicle3D.d.ts +97 -0
  266. package/dist/rendering/world3d/Vehicle3D.js +226 -0
  267. package/dist/rendering/world3d/VolumetricFog3D.d.ts +55 -0
  268. package/dist/rendering/world3d/VolumetricFog3D.js +229 -0
  269. package/dist/rendering/world3d/Water3D.d.ts +163 -0
  270. package/dist/rendering/world3d/Water3D.js +606 -0
  271. package/dist/rendering/world3d/core3D.d.ts +34 -0
  272. package/dist/rendering/world3d/core3D.js +99 -0
  273. package/dist/rendering/world3d/debug3D.d.ts +64 -0
  274. package/dist/rendering/world3d/debug3D.js +257 -0
  275. package/dist/rendering/world3d/decoders3D.d.ts +42 -0
  276. package/dist/rendering/world3d/decoders3D.js +133 -0
  277. package/dist/rendering/world3d/geometries3D.d.ts +99 -0
  278. package/dist/rendering/world3d/geometries3D.js +605 -0
  279. package/dist/rendering/world3d/helpers3D.d.ts +65 -0
  280. package/dist/rendering/world3d/helpers3D.js +177 -0
  281. package/dist/rendering/world3d/index.d.ts +91 -0
  282. package/dist/rendering/world3d/index.js +56 -0
  283. package/dist/rendering/world3d/math3D.d.ts +78 -0
  284. package/dist/rendering/world3d/math3D.js +640 -0
  285. package/dist/rendering/world3d/primitives3D.d.ts +60 -0
  286. package/dist/rendering/world3d/primitives3D.js +196 -0
  287. package/dist/resources.d.ts +8 -0
  288. package/dist/resources.js +6 -0
  289. package/dist/saveStore.d.ts +56 -0
  290. package/dist/saveStore.js +163 -0
  291. package/dist/semanticList.d.ts +122 -0
  292. package/dist/semanticList.js +174 -0
  293. package/dist/semanticTree.d.ts +10 -0
  294. package/dist/semanticTree.js +532 -0
  295. package/dist/semanticTypes.d.ts +167 -0
  296. package/dist/semanticTypes.js +2 -0
  297. package/dist/semantics.d.ts +6 -0
  298. package/dist/semantics.js +5 -0
  299. package/dist/sequencePlayback.d.ts +19 -0
  300. package/dist/sequencePlayback.js +391 -0
  301. package/dist/sequencePlaybackTypes.d.ts +21 -0
  302. package/dist/sequencePlaybackTypes.js +2 -0
  303. package/dist/sequenceTargetClaims.d.ts +10 -0
  304. package/dist/sequenceTargetClaims.js +31 -0
  305. package/dist/srgbBytes.d.ts +3 -0
  306. package/dist/srgbBytes.js +64 -0
  307. package/dist/startEngine.d.ts +5 -0
  308. package/dist/startEngine.js +31 -0
  309. package/dist/surfaceOwnership.d.ts +3 -0
  310. package/dist/surfaceOwnership.js +15 -0
  311. package/dist/text.d.ts +23 -0
  312. package/dist/text.js +4 -0
  313. package/dist/textField.d.ts +6 -0
  314. package/dist/textField.js +6 -0
  315. package/dist/tileMapDraw.d.ts +7 -0
  316. package/dist/tileMapDraw.js +310 -0
  317. package/dist/tiledImport.d.ts +9 -0
  318. package/dist/tiledImport.js +357 -0
  319. package/dist/tilemap.d.ts +5 -0
  320. package/dist/tilemap.js +5 -0
  321. package/dist/tilemapTypes.d.ts +169 -0
  322. package/dist/tilemapTypes.js +2 -0
  323. package/dist/tween.d.ts +15 -0
  324. package/dist/tween.js +329 -0
  325. package/dist/tweenTypes.d.ts +27 -0
  326. package/dist/tweenTypes.js +2 -0
  327. package/dist/ui/controlKeys.d.ts +109 -0
  328. package/dist/ui/controlKeys.js +249 -0
  329. package/dist/ui/controls.d.ts +52 -0
  330. package/dist/ui/controls.js +288 -0
  331. package/dist/ui/editing.d.ts +3 -0
  332. package/dist/ui/editing.js +3 -0
  333. package/dist/ui/index.d.ts +19 -0
  334. package/dist/ui/index.js +11 -0
  335. package/dist/ui/keyboardFocus.d.ts +32 -0
  336. package/dist/ui/keyboardFocus.js +146 -0
  337. package/dist/ui/layerTypes.d.ts +91 -0
  338. package/dist/ui/layerTypes.js +2 -0
  339. package/dist/ui/layers.d.ts +4 -0
  340. package/dist/ui/layers.js +586 -0
  341. package/dist/ui/leafContent.d.ts +21 -0
  342. package/dist/ui/leafContent.js +136 -0
  343. package/dist/ui/rangeControl.d.ts +50 -0
  344. package/dist/ui/rangeControl.js +167 -0
  345. package/dist/ui/scrollControl.d.ts +72 -0
  346. package/dist/ui/scrollControl.js +218 -0
  347. package/dist/ui/stateControls.d.ts +82 -0
  348. package/dist/ui/stateControls.js +328 -0
  349. package/dist/ui/textEditor.d.ts +53 -0
  350. package/dist/ui/textEditor.js +370 -0
  351. package/dist/ui/textEditorTypes.d.ts +78 -0
  352. package/dist/ui/textEditorTypes.js +2 -0
  353. package/dist/ui/textFieldControl.d.ts +96 -0
  354. package/dist/ui/textFieldControl.js +259 -0
  355. package/dist/ui/theme.d.ts +59 -0
  356. package/dist/ui/theme.js +165 -0
  357. package/dist/ui/types.d.ts +265 -0
  358. package/dist/ui/types.js +2 -0
  359. package/dist/ui/uiRoot.d.ts +4 -0
  360. package/dist/ui/uiRoot.js +1497 -0
  361. package/dist/ui/uiRootDisplay.d.ts +46 -0
  362. package/dist/ui/uiRootDisplay.js +148 -0
  363. package/dist/ui/uiRootModel.d.ts +112 -0
  364. package/dist/ui/uiRootModel.js +60 -0
  365. package/dist/ui/virtualList.d.ts +20 -0
  366. package/dist/ui/virtualList.js +105 -0
  367. package/dist/video.d.ts +4 -0
  368. package/dist/video.js +4 -0
  369. package/dist/videoPlayer.d.ts +4 -0
  370. package/dist/videoPlayer.js +215 -0
  371. package/dist/videoTypes.d.ts +74 -0
  372. package/dist/videoTypes.js +2 -0
  373. package/dist/web/BrowserAssetBundle.d.ts +39 -0
  374. package/dist/web/BrowserAssetBundle.js +136 -0
  375. package/dist/web/BrowserAudio.d.ts +41 -0
  376. package/dist/web/BrowserAudio.js +473 -0
  377. package/dist/web/BrowserFrameLoop.d.ts +65 -0
  378. package/dist/web/BrowserFrameLoop.js +125 -0
  379. package/dist/web/BrowserGame.d.ts +112 -0
  380. package/dist/web/BrowserGame.js +352 -0
  381. package/dist/web/BrowserGamepadInput.d.ts +35 -0
  382. package/dist/web/BrowserGamepadInput.js +134 -0
  383. package/dist/web/BrowserHoverInput.d.ts +24 -0
  384. package/dist/web/BrowserHoverInput.js +266 -0
  385. package/dist/web/BrowserImageTextures.d.ts +66 -0
  386. package/dist/web/BrowserImageTextures.js +169 -0
  387. package/dist/web/BrowserInputActions.d.ts +53 -0
  388. package/dist/web/BrowserInputActions.js +342 -0
  389. package/dist/web/BrowserKeyboardInput.d.ts +4 -0
  390. package/dist/web/BrowserKeyboardInput.js +223 -0
  391. package/dist/web/BrowserPlay.d.ts +289 -0
  392. package/dist/web/BrowserPlay.js +1301 -0
  393. package/dist/web/BrowserPointerInput.d.ts +4 -0
  394. package/dist/web/BrowserPointerInput.js +511 -0
  395. package/dist/web/BrowserSemantics.d.ts +34 -0
  396. package/dist/web/BrowserSemantics.js +418 -0
  397. package/dist/web/BrowserStatsPanel.d.ts +46 -0
  398. package/dist/web/BrowserStatsPanel.js +137 -0
  399. package/dist/web/BrowserStorage.d.ts +33 -0
  400. package/dist/web/BrowserStorage.js +132 -0
  401. package/dist/web/BrowserTextEditor.d.ts +49 -0
  402. package/dist/web/BrowserTextEditor.js +839 -0
  403. package/dist/web/BrowserTextInput.d.ts +83 -0
  404. package/dist/web/BrowserTextInput.js +524 -0
  405. package/dist/web/BrowserTextureProvider.d.ts +52 -0
  406. package/dist/web/BrowserTextureProvider.js +935 -0
  407. package/dist/web/BrowserVideo.d.ts +28 -0
  408. package/dist/web/BrowserVideo.js +211 -0
  409. package/dist/web/CanvasKitFontSetProvider.d.ts +29 -0
  410. package/dist/web/CanvasKitFontSetProvider.js +215 -0
  411. package/dist/web/CanvasKitParagraphProvider.d.ts +169 -0
  412. package/dist/web/CanvasKitParagraphProvider.js +691 -0
  413. package/dist/web/CanvasTextRasterProvider.d.ts +4 -0
  414. package/dist/web/CanvasTextRasterProvider.js +312 -0
  415. package/dist/web/ManifestByteSource.d.ts +147 -0
  416. package/dist/web/ManifestByteSource.js +974 -0
  417. package/dist/web/ManifestFontContentLoader.d.ts +12 -0
  418. package/dist/web/ManifestFontContentLoader.js +30 -0
  419. package/dist/web/MouseInput.d.ts +4 -0
  420. package/dist/web/MouseInput.js +218 -0
  421. package/dist/web/WebGL2Host.d.ts +5 -0
  422. package/dist/web/WebGL2Host.js +2672 -0
  423. package/dist/web/WebGPUHost.d.ts +87 -0
  424. package/dist/web/WebGPUHost.js +3349 -0
  425. package/dist/web/audio.d.ts +3 -0
  426. package/dist/web/audio.js +4 -0
  427. package/dist/web/canvasKitParagraphGeometry.d.ts +27 -0
  428. package/dist/web/canvasKitParagraphGeometry.js +83 -0
  429. package/dist/web/editing.d.ts +5 -0
  430. package/dist/web/editing.js +4 -0
  431. package/dist/web/editorFonts.d.ts +50 -0
  432. package/dist/web/editorFonts.js +297 -0
  433. package/dist/web/game.d.ts +5 -0
  434. package/dist/web/game.js +6 -0
  435. package/dist/web/gamepad.d.ts +3 -0
  436. package/dist/web/gamepad.js +4 -0
  437. package/dist/web/hover.d.ts +3 -0
  438. package/dist/web/hover.js +4 -0
  439. package/dist/web/image.d.ts +4 -0
  440. package/dist/web/image.js +4 -0
  441. package/dist/web/imageProjections2D.d.ts +14 -0
  442. package/dist/web/imageProjections2D.js +2 -0
  443. package/dist/web/input.d.ts +6 -0
  444. package/dist/web/input.js +4 -0
  445. package/dist/web/keyboard.d.ts +3 -0
  446. package/dist/web/keyboard.js +3 -0
  447. package/dist/web/kit.d.ts +10 -0
  448. package/dist/web/kit.js +7 -0
  449. package/dist/web/loop.d.ts +3 -0
  450. package/dist/web/loop.js +4 -0
  451. package/dist/web/paragraph.d.ts +6 -0
  452. package/dist/web/paragraph.js +4 -0
  453. package/dist/web/play.d.ts +5 -0
  454. package/dist/web/play.js +6 -0
  455. package/dist/web/playSfx.d.ts +36 -0
  456. package/dist/web/playSfx.js +112 -0
  457. package/dist/web/pointer.d.ts +3 -0
  458. package/dist/web/pointer.js +3 -0
  459. package/dist/web/prepareSharedSubmission2D.d.ts +27 -0
  460. package/dist/web/prepareSharedSubmission2D.js +57 -0
  461. package/dist/web/resources.d.ts +27 -0
  462. package/dist/web/resources.js +96 -0
  463. package/dist/web/semantics.d.ts +3 -0
  464. package/dist/web/semantics.js +4 -0
  465. package/dist/web/sharedDeviceSession.d.ts +64 -0
  466. package/dist/web/sharedDeviceSession.js +2 -0
  467. package/dist/web/sharedEffectShaders.d.ts +9 -0
  468. package/dist/web/sharedEffectShaders.js +165 -0
  469. package/dist/web/sharedFrameUpload.d.ts +25 -0
  470. package/dist/web/sharedFrameUpload.js +2 -0
  471. package/dist/web/sharedHostDeferred.d.ts +7 -0
  472. package/dist/web/sharedHostDeferred.js +12 -0
  473. package/dist/web/sharedRetentionLedger.d.ts +85 -0
  474. package/dist/web/sharedRetentionLedger.js +391 -0
  475. package/dist/web/sharedSubmissionStorage2D.d.ts +56 -0
  476. package/dist/web/sharedSubmissionStorage2D.js +73 -0
  477. package/dist/web/sharedWebGL2Arena.d.ts +40 -0
  478. package/dist/web/sharedWebGL2Arena.js +77 -0
  479. package/dist/web/sharedWebGL2Options.d.ts +30 -0
  480. package/dist/web/sharedWebGL2Options.js +96 -0
  481. package/dist/web/sharedWebGL2Shaders.d.ts +20 -0
  482. package/dist/web/sharedWebGL2Shaders.js +314 -0
  483. package/dist/web/sharedWebGPUOptions.d.ts +37 -0
  484. package/dist/web/sharedWebGPUOptions.js +126 -0
  485. package/dist/web/text.d.ts +3 -0
  486. package/dist/web/text.js +3 -0
  487. package/dist/web/textInput.d.ts +3 -0
  488. package/dist/web/textInput.js +3 -0
  489. package/dist/web/video.d.ts +3 -0
  490. package/dist/web/video.js +4 -0
  491. package/dist/web/webgl2.d.ts +7 -0
  492. package/dist/web/webgl2.js +4 -0
  493. package/dist/web/webgl2LayerState.d.ts +50 -0
  494. package/dist/web/webgl2LayerState.js +102 -0
  495. package/dist/web/webgl2Native.d.ts +70 -0
  496. package/dist/web/webgl2Native.js +568 -0
  497. package/dist/web/webgl2Types.d.ts +132 -0
  498. package/dist/web/webgl2Types.js +2 -0
  499. package/dist/web/webgpu.d.ts +6 -0
  500. package/dist/web/webgpu.js +2 -0
  501. package/dist/web/webgpuBindingCache.d.ts +26 -0
  502. package/dist/web/webgpuBindingCache.js +223 -0
  503. package/dist/web/webgpuBufferPool.d.ts +51 -0
  504. package/dist/web/webgpuBufferPool.js +58 -0
  505. package/dist/web/webgpuImageResidency.d.ts +53 -0
  506. package/dist/web/webgpuImageResidency.js +61 -0
  507. package/dist/web/webgpuLifetime.d.ts +45 -0
  508. package/dist/web/webgpuLifetime.js +64 -0
  509. package/dist/web/webgpuRetentionPool.d.ts +66 -0
  510. package/dist/web/webgpuRetentionPool.js +84 -0
  511. package/dist/web/webgpuSharedPass.d.ts +7 -0
  512. package/dist/web/webgpuSharedPass.js +211 -0
  513. package/dist/web/webgpuSharedResolvePass.d.ts +3 -0
  514. package/dist/web/webgpuSharedResolvePass.js +29 -0
  515. package/dist/web/world3d/Audio3D.d.ts +68 -0
  516. package/dist/web/world3d/Audio3D.js +212 -0
  517. package/dist/web/world3d/BrowserPlay3D.d.ts +182 -0
  518. package/dist/web/world3d/BrowserPlay3D.js +851 -0
  519. package/dist/web/world3d/FlyControls3D.d.ts +55 -0
  520. package/dist/web/world3d/FlyControls3D.js +160 -0
  521. package/dist/web/world3d/FollowControls3D.d.ts +28 -0
  522. package/dist/web/world3d/FollowControls3D.js +117 -0
  523. package/dist/web/world3d/OrbitControls3D.d.ts +55 -0
  524. package/dist/web/world3d/OrbitControls3D.js +187 -0
  525. package/dist/web/world3d/TransformControls3D.d.ts +34 -0
  526. package/dist/web/world3d/TransformControls3D.js +125 -0
  527. package/dist/web/world3d/WebGL2Renderer3D.d.ts +133 -0
  528. package/dist/web/world3d/WebGL2Renderer3D.js +1173 -0
  529. package/dist/web/world3d/WebGPURenderer3D.d.ts +110 -0
  530. package/dist/web/world3d/WebGPURenderer3D.js +1915 -0
  531. package/dist/web/world3d/World3DView.d.ts +51 -0
  532. package/dist/web/world3d/World3DView.js +77 -0
  533. package/dist/web/world3d/app3D.d.ts +136 -0
  534. package/dist/web/world3d/app3D.js +304 -0
  535. package/dist/web/world3d/assets3D.d.ts +38 -0
  536. package/dist/web/world3d/assets3D.js +112 -0
  537. package/dist/web/world3d/atmosphere3D.d.ts +47 -0
  538. package/dist/web/world3d/atmosphere3D.js +178 -0
  539. package/dist/web/world3d/frame3D.d.ts +142 -0
  540. package/dist/web/world3d/frame3D.js +388 -0
  541. package/dist/web/world3d/gpuResources3D.d.ts +98 -0
  542. package/dist/web/world3d/gpuResources3D.js +901 -0
  543. package/dist/web/world3d/host3D.d.ts +23 -0
  544. package/dist/web/world3d/host3D.js +61 -0
  545. package/dist/web/world3d/index.d.ts +38 -0
  546. package/dist/web/world3d/index.js +23 -0
  547. package/dist/web/world3d/loaders3D.d.ts +26 -0
  548. package/dist/web/world3d/loaders3D.js +138 -0
  549. package/dist/web/world3d/markers3D.d.ts +49 -0
  550. package/dist/web/world3d/markers3D.js +130 -0
  551. package/dist/web/world3d/materialWebGL23D.d.ts +34 -0
  552. package/dist/web/world3d/materialWebGL23D.js +218 -0
  553. package/dist/web/world3d/overlay3D.d.ts +28 -0
  554. package/dist/web/world3d/overlay3D.js +170 -0
  555. package/dist/web/world3d/post3D.d.ts +112 -0
  556. package/dist/web/world3d/post3D.js +459 -0
  557. package/dist/web/world3d/postWebGL23D.d.ts +24 -0
  558. package/dist/web/world3d/postWebGL23D.js +237 -0
  559. package/dist/web/world3d/postWebGPU3D.d.ts +23 -0
  560. package/dist/web/world3d/postWebGPU3D.js +255 -0
  561. package/dist/web/world3d/probe3D.d.ts +14 -0
  562. package/dist/web/world3d/probe3D.js +66 -0
  563. package/dist/web/world3d/shaders3D.d.ts +43 -0
  564. package/dist/web/world3d/shaders3D.js +851 -0
  565. package/dist/web/world3d/stats3D.d.ts +31 -0
  566. package/dist/web/world3d/stats3D.js +80 -0
  567. package/dist/web/world3d/webGL2FrameMetrics3D.d.ts +66 -0
  568. package/dist/web/world3d/webGL2FrameMetrics3D.js +185 -0
  569. package/dist/web/world3d/webgpu.d.ts +35 -0
  570. package/dist/web/world3d/webgpu.js +22 -0
  571. package/dist/web/world3d/webgpuPacking3D.d.ts +13 -0
  572. package/dist/web/world3d/webgpuPacking3D.js +85 -0
  573. package/dist/web/world3d/wgsl3D.d.ts +68 -0
  574. package/dist/web/world3d/wgsl3D.js +781 -0
  575. package/package.json +220 -4
@@ -0,0 +1,512 @@
1
+ import { World3DError } from './core3D.js';
2
+ import { createUnlitMaterial3D } from './Material3D.js';
3
+ import { mat4Decompose, mat4Invert, quatFromAxisAngle, quatMultiply, quatNormalize, vec3TransformMat4, vec3TransformQuat } from './math3D.js';
4
+ import { Mesh3D } from './Mesh3D.js';
5
+ import { Object3D } from './Object3D.js';
6
+ import { createBoxGeometry3D, createCylinderGeometry3D, createPlaneGeometry3D, createSphereGeometry3D, createTorusGeometry3D } from './primitives3D.js';
7
+ const AXES = [
8
+ [1, 0, 0],
9
+ [0, 1, 0],
10
+ [0, 0, 1]
11
+ ];
12
+ const COLORS = [
13
+ [0.9, 0.15, 0.2],
14
+ [0.3, 0.8, 0.15],
15
+ [0.15, 0.4, 0.95]
16
+ ];
17
+ const HIGHLIGHT = [1, 0.85, 0.1];
18
+ const PICK = 0.09, RING = 1, PLANE_FROM = 0.25, PLANE_TO = 0.5;
19
+ const dot = (a, b) => a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
20
+ const cross = (a, b) => [
21
+ a[1] * b[2] - a[2] * b[1],
22
+ a[2] * b[0] - a[0] * b[2],
23
+ a[0] * b[1] - a[1] * b[0]
24
+ ];
25
+ const unit = (a) => {
26
+ const size = Math.hypot(a[0], a[1], a[2]) || 1;
27
+ return [a[0] / size, a[1] / size, a[2] / size];
28
+ };
29
+ const snap = (value, step) => step !== undefined && step > 0 ? Math.round(value / step) * step : value;
30
+ export class TransformGizmo3D extends Object3D {
31
+ camera;
32
+ mode;
33
+ space;
34
+ size;
35
+ /** Step sizes for dragging: world units, radians and scale factor. Undefined moves freely. */
36
+ translationSnap;
37
+ rotationSnap;
38
+ scaleSnap;
39
+ enabled = true;
40
+ /** Called while a drag changes the attached object. */
41
+ onChange;
42
+ /** Called when a drag starts (true) or ends (false), for example to pause camera controls. */
43
+ onDraggingChanged;
44
+ #object;
45
+ #drag;
46
+ #hovered;
47
+ #shownMode;
48
+ #groups = {
49
+ translate: new Object3D(),
50
+ rotate: new Object3D(),
51
+ scale: new Object3D()
52
+ };
53
+ #materials = new Map();
54
+ constructor(camera, options = {}) {
55
+ super();
56
+ if (!camera)
57
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'gizmo camera');
58
+ this.camera = camera;
59
+ this.mode = options.mode ?? 'translate';
60
+ this.space = options.space ?? 'world';
61
+ this.size = options.size ?? 0.18;
62
+ this.name = 'TransformGizmo3D';
63
+ this.visible = false;
64
+ this.build();
65
+ for (const group of Object.values(this.#groups))
66
+ this.addChild(group);
67
+ }
68
+ /** The object being edited. */
69
+ get object() {
70
+ return this.#object;
71
+ }
72
+ get dragging() {
73
+ return this.#drag !== undefined;
74
+ }
75
+ /** The handle under the last hover ray, or the one being dragged. */
76
+ get activeHandle() {
77
+ return this.#drag?.handle ?? this.#hovered;
78
+ }
79
+ attach(object) {
80
+ if (!(object instanceof Object3D) || object === this)
81
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'gizmo object');
82
+ this.endDrag();
83
+ this.#object = object;
84
+ this.update();
85
+ return this;
86
+ }
87
+ detach() {
88
+ this.endDrag();
89
+ this.#object = undefined;
90
+ this.visible = false;
91
+ return this;
92
+ }
93
+ handleMaterial(handle, color, opacity = 1) {
94
+ // Drawn last and without depth, so the handles stay visible through the object.
95
+ const material = createUnlitMaterial3D({
96
+ color,
97
+ opacity,
98
+ alphaMode: 'blend',
99
+ depthTest: false,
100
+ depthWrite: false,
101
+ side: 'double',
102
+ fog: false,
103
+ toneMapped: false
104
+ });
105
+ let list = this.#materials.get(handle);
106
+ if (!list)
107
+ this.#materials.set(handle, (list = []));
108
+ list.push({ material, color });
109
+ return material;
110
+ }
111
+ part(group, geometry, material, axis, offset) {
112
+ const mesh = new Mesh3D(geometry, material);
113
+ // Primitives point along +Y; turn them onto the wanted axis.
114
+ if (axis === 0)
115
+ quatFromAxisAngle(mesh.quaternion, [0, 0, 1], -Math.PI / 2);
116
+ else if (axis === 2)
117
+ quatFromAxisAngle(mesh.quaternion, [1, 0, 0], Math.PI / 2);
118
+ mesh.position[axis] = offset;
119
+ mesh.markTransformDirty();
120
+ mesh.renderOrder = 100000;
121
+ mesh.frustumCulled = false;
122
+ mesh.castShadow = false;
123
+ mesh.receiveShadow = false;
124
+ group.addChild(mesh);
125
+ return mesh;
126
+ }
127
+ build() {
128
+ const names = ['x', 'y', 'z'], shaft = createCylinderGeometry3D({ radiusTop: 0.012, radiusBottom: 0.012, height: 0.8, radialSegments: 8 });
129
+ const tip = createCylinderGeometry3D({ radiusTop: 0, radiusBottom: 0.05, height: 0.2, radialSegments: 12 }), knob = createBoxGeometry3D({ width: 0.09, height: 0.09, depth: 0.09 });
130
+ const ring = createTorusGeometry3D({ radius: RING, tube: 0.012, radialSegments: 6, tubularSegments: 64 }), square = createPlaneGeometry3D({ width: PLANE_TO - PLANE_FROM, height: PLANE_TO - PLANE_FROM });
131
+ for (let i = 0; i < 3; i++) {
132
+ const name = names[i], color = COLORS[i];
133
+ this.part(this.#groups.translate, shaft, this.handleMaterial(name, color), i, 0.4);
134
+ this.part(this.#groups.translate, tip, this.handleMaterial(name, color), i, 0.9);
135
+ this.part(this.#groups.scale, shaft, this.handleMaterial(name, color), i, 0.4);
136
+ this.part(this.#groups.scale, knob, this.handleMaterial(name, color), i, 0.85);
137
+ // The torus lies around Z; stand it around the wanted axis.
138
+ const circle = new Mesh3D(ring, this.handleMaterial(name, color));
139
+ if (i === 0)
140
+ quatFromAxisAngle(circle.quaternion, [0, 1, 0], Math.PI / 2);
141
+ else if (i === 1)
142
+ quatFromAxisAngle(circle.quaternion, [1, 0, 0], Math.PI / 2);
143
+ circle.markTransformDirty();
144
+ circle.renderOrder = 100000;
145
+ circle.frustumCulled = false;
146
+ this.#groups.rotate.addChild(circle);
147
+ // Plane handles: a small square between two axes, colored like the axis it leaves out.
148
+ const plane = ['yz', 'xz', 'xy'][i], middle = (PLANE_FROM + PLANE_TO) / 2;
149
+ const tile = new Mesh3D(square, this.handleMaterial(plane, color, 0.5));
150
+ if (i === 0)
151
+ quatFromAxisAngle(tile.quaternion, [0, 1, 0], Math.PI / 2);
152
+ else if (i === 1)
153
+ quatFromAxisAngle(tile.quaternion, [1, 0, 0], Math.PI / 2);
154
+ tile.position.set([i === 0 ? 0 : middle, i === 1 ? 0 : middle, i === 2 ? 0 : middle]);
155
+ tile.markTransformDirty();
156
+ tile.renderOrder = 100000;
157
+ tile.frustumCulled = false;
158
+ this.#groups.translate.addChild(tile);
159
+ }
160
+ const center = new Mesh3D(createSphereGeometry3D({ radius: 0.07, widthSegments: 12, heightSegments: 8 }), this.handleMaterial('xyz', [0.85, 0.85, 0.85]));
161
+ center.renderOrder = 100000;
162
+ center.frustumCulled = false;
163
+ this.#groups.scale.addChild(center);
164
+ }
165
+ /** World scale that keeps the handles the same size on screen. */
166
+ screenScale(position) {
167
+ const camera = this.camera, m = camera.matrixWorld;
168
+ if (camera.projectionKind === 'orthographic')
169
+ return (camera.orthographicHeight / camera.zoom) * this.size;
170
+ // Distance along the viewing direction, which is -Z of the camera.
171
+ const depth = -((position[0] - m[12]) * m[8] +
172
+ (position[1] - m[13]) * m[9] +
173
+ (position[2] - m[14]) * m[10]);
174
+ return ((Math.max(depth, 1e-4) * 2 * Math.tan((camera.fov * Math.PI) / 360)) / camera.zoom) * this.size;
175
+ }
176
+ /** World pose of the attached object. */
177
+ pose() {
178
+ const object = this.#object, t = [0, 0, 0], q = [0, 0, 0, 1], s = [1, 1, 1];
179
+ object.updateWorldMatrix();
180
+ mat4Decompose(object.matrixWorld, t, q, s);
181
+ return { position: [t[0], t[1], t[2]], quaternion: [q[0], q[1], q[2], q[3]] };
182
+ }
183
+ /**
184
+ * Place the handles on the attached object and size them for the camera.
185
+ * Call once per frame before rendering, after moving the camera or object.
186
+ */
187
+ update() {
188
+ const object = this.#object;
189
+ if (!object || !this.enabled) {
190
+ this.visible = false;
191
+ return;
192
+ }
193
+ this.camera.updateWorldMatrix();
194
+ const { position, quaternion } = this.pose(), local = this.space === 'local' || this.mode === 'scale';
195
+ this.visible = true;
196
+ this.position.set(position);
197
+ // While turning in world space the rings stay put; in local space they follow the object.
198
+ this.quaternion.set(local ? quaternion : [0, 0, 0, 1]);
199
+ const scale = this.screenScale(position);
200
+ this.scale.set([scale, scale, scale]);
201
+ this.markTransformDirty();
202
+ if (this.#shownMode !== this.mode) {
203
+ this.#shownMode = this.mode;
204
+ for (const mode of ['translate', 'rotate', 'scale'])
205
+ this.#groups[mode].visible = mode === this.mode;
206
+ }
207
+ }
208
+ highlight(handle) {
209
+ if (handle === this.#hovered)
210
+ return;
211
+ this.#hovered = handle;
212
+ for (const [name, list] of this.#materials)
213
+ for (const entry of list)
214
+ entry.material.color.set(name === handle ? HIGHLIGHT : entry.color);
215
+ }
216
+ /** World directions of the three handle axes. */
217
+ axes(quaternion) {
218
+ const local = this.space === 'local' || this.mode === 'scale';
219
+ return AXES.map(axis => local ? unit(vec3TransformQuat([0, 0, 0], axis, quaternion)) : [axis[0], axis[1], axis[2]]);
220
+ }
221
+ /** Handle met by a world-space ray, or undefined. Also sets the highlight. */
222
+ hover(origin, direction) {
223
+ if (this.#drag)
224
+ return this.#drag.handle;
225
+ const handle = this.pick(origin, direction);
226
+ this.highlight(handle);
227
+ return handle;
228
+ }
229
+ pick(origin, direction) {
230
+ if (!this.#object || !this.enabled)
231
+ return undefined;
232
+ const { position, quaternion } = this.pose(), size = this.screenScale(position), axes = this.axes(quaternion), d = unit(direction);
233
+ const o = [origin[0] - position[0], origin[1] - position[1], origin[2] - position[2]], names = ['x', 'y', 'z'];
234
+ let best, nearest = Infinity;
235
+ const offer = (handle, distance) => {
236
+ if (distance >= 0 && distance < nearest) {
237
+ nearest = distance;
238
+ best = handle;
239
+ }
240
+ };
241
+ if (this.mode === 'rotate') {
242
+ for (let i = 0; i < 3; i++) {
243
+ const n = axes[i], facing = dot(d, n);
244
+ if (Math.abs(facing) < 1e-4)
245
+ continue;
246
+ const t = -dot(o, n) / facing;
247
+ if (t < 0)
248
+ continue;
249
+ const radius = Math.hypot(o[0] + d[0] * t, o[1] + d[1] * t, o[2] + d[2] * t);
250
+ if (Math.abs(radius - RING * size) < PICK * size)
251
+ offer(names[i], t);
252
+ }
253
+ return best;
254
+ }
255
+ if (this.mode === 'scale' && this.raySphere(o, d, 0.12 * size) >= 0)
256
+ return 'xyz';
257
+ for (let i = 0; i < 3; i++) {
258
+ // Closest approach between the ray and the handle segment from the center to its tip.
259
+ const a = axes[i], b = dot(d, a), c = dot(d, o), e = dot(a, o), denominator = 1 - b * b;
260
+ let s = Math.abs(denominator) < 1e-9 ? 0 : (b * c - e) / -denominator;
261
+ s = Math.min(Math.max(s, 0.1 * size), size);
262
+ const t = Math.max(s * b - c, 0);
263
+ const gap = Math.hypot(o[0] + d[0] * t - a[0] * s, o[1] + d[1] * t - a[1] * s, o[2] + d[2] * t - a[2] * s);
264
+ if (gap < PICK * size)
265
+ offer(names[i], t);
266
+ }
267
+ if (this.mode === 'translate') {
268
+ const planes = [
269
+ ['yz', 1, 2],
270
+ ['xz', 0, 2],
271
+ ['xy', 0, 1]
272
+ ];
273
+ for (let i = 0; i < 3; i++) {
274
+ const n = axes[i], facing = dot(d, n);
275
+ if (Math.abs(facing) < 1e-4)
276
+ continue;
277
+ const t = -dot(o, n) / facing;
278
+ if (t < 0)
279
+ continue;
280
+ const hit = [o[0] + d[0] * t, o[1] + d[1] * t, o[2] + d[2] * t], [name, first, second] = planes[i];
281
+ const u = dot(hit, axes[first]) / size, v = dot(hit, axes[second]) / size;
282
+ if (u > PLANE_FROM && u < PLANE_TO && v > PLANE_FROM && v < PLANE_TO)
283
+ offer(name, t - 1e-3 * size);
284
+ }
285
+ }
286
+ return best;
287
+ }
288
+ raySphere(o, d, radius) {
289
+ const b = dot(o, d), c = dot(o, o) - radius * radius, discriminant = b * b - c;
290
+ return discriminant < 0 ? -1 : Math.max(-b - Math.sqrt(discriminant), 0);
291
+ }
292
+ /** Distance along the line (point, axis) at which it comes closest to a ray. */
293
+ alongAxis(origin, d, point, axis) {
294
+ const o = [origin[0] - point[0], origin[1] - point[1], origin[2] - point[2]], b = dot(d, axis), denominator = 1 - b * b;
295
+ return Math.abs(denominator) < 1e-6 ? 0 : (dot(axis, o) - b * dot(d, o)) / denominator;
296
+ }
297
+ /** Point where a ray meets the plane through `point` with normal `normal`, or undefined when it runs alongside. */
298
+ onPlane(origin, d, point, normal) {
299
+ const facing = dot(d, normal);
300
+ if (Math.abs(facing) < 1e-5)
301
+ return undefined;
302
+ const t = ((point[0] - origin[0]) * normal[0] +
303
+ (point[1] - origin[1]) * normal[1] +
304
+ (point[2] - origin[2]) * normal[2]) /
305
+ facing;
306
+ return [origin[0] + d[0] * t, origin[1] + d[1] * t, origin[2] + d[2] * t];
307
+ }
308
+ /** Direction from the object toward the camera, used as a drag plane that always faces the viewer. */
309
+ towardCamera() {
310
+ const m = this.camera.matrixWorld;
311
+ return unit([m[8], m[9], m[10]]);
312
+ }
313
+ /** Start dragging the handle under the ray. Returns false when the ray misses every handle. */
314
+ beginDrag(origin, direction) {
315
+ if (this.#drag)
316
+ this.endDrag();
317
+ const handle = this.pick(origin, direction), object = this.#object;
318
+ if (!handle || !object)
319
+ return false;
320
+ const { position, quaternion } = this.pose(), axes = this.axes(quaternion), d = unit(direction), size = this.screenScale(position), index = 'xyz'.indexOf(handle);
321
+ const drag = {
322
+ handle,
323
+ position,
324
+ quaternion,
325
+ scale: [object.scale[0], object.scale[1], object.scale[2]],
326
+ axes,
327
+ along: 0,
328
+ point: [0, 0, 0],
329
+ normal: [0, 0, 1],
330
+ edgeOn: false,
331
+ size
332
+ };
333
+ if (this.mode === 'rotate') {
334
+ drag.normal = axes[index];
335
+ // Seen edge-on, a ring's own plane cannot be hit reliably; drag across the view instead.
336
+ drag.edgeOn = Math.abs(dot(d, drag.normal)) < 0.2;
337
+ if (drag.edgeOn)
338
+ drag.normal = this.towardCamera();
339
+ }
340
+ else if (handle.length === 1)
341
+ drag.along = this.alongAxis(origin, d, position, axes[index]);
342
+ else
343
+ drag.normal = handle === 'xyz' ? this.towardCamera() : axes[handle === 'yz' ? 0 : handle === 'xz' ? 1 : 2];
344
+ if (this.mode === 'rotate' || handle.length > 1) {
345
+ const point = this.onPlane(origin, d, position, drag.normal);
346
+ if (!point)
347
+ return false;
348
+ drag.point = point;
349
+ }
350
+ this.#drag = drag;
351
+ this.highlight(handle);
352
+ this.onDraggingChanged?.(true);
353
+ return true;
354
+ }
355
+ /** Continue a drag with the current ray, updating the attached object. */
356
+ drag(origin, direction) {
357
+ const drag = this.#drag, object = this.#object;
358
+ if (!drag || !object)
359
+ return;
360
+ const d = unit(direction), index = 'xyz'.indexOf(drag.handle);
361
+ if (this.mode === 'translate') {
362
+ let move;
363
+ if (drag.handle.length === 1) {
364
+ const axis = drag.axes[index], amount = snap(this.alongAxis(origin, d, drag.position, axis) - drag.along, this.translationSnap);
365
+ move = [axis[0] * amount, axis[1] * amount, axis[2] * amount];
366
+ }
367
+ else {
368
+ const point = this.onPlane(origin, d, drag.position, drag.normal);
369
+ if (!point)
370
+ return;
371
+ move = [0, 0, 0];
372
+ // Split the movement over the two axes of the plane so each can snap.
373
+ for (let i = 0; i < 3; i++) {
374
+ if (!drag.handle.includes('xyz'[i]))
375
+ continue;
376
+ const axis = drag.axes[i], amount = snap((point[0] - drag.point[0]) * axis[0] +
377
+ (point[1] - drag.point[1]) * axis[1] +
378
+ (point[2] - drag.point[2]) * axis[2], this.translationSnap);
379
+ move[0] += axis[0] * amount;
380
+ move[1] += axis[1] * amount;
381
+ move[2] += axis[2] * amount;
382
+ }
383
+ }
384
+ this.setWorldPosition(object, [
385
+ drag.position[0] + move[0],
386
+ drag.position[1] + move[1],
387
+ drag.position[2] + move[2]
388
+ ]);
389
+ }
390
+ else if (this.mode === 'rotate') {
391
+ const point = this.onPlane(origin, d, drag.position, drag.normal);
392
+ if (!point)
393
+ return;
394
+ const axis = drag.axes[index];
395
+ let angle;
396
+ if (drag.edgeOn) {
397
+ // Movement across the ring, as seen by the camera, turns it like a wheel pushed at its rim.
398
+ const tangent = unit(cross(axis, drag.normal));
399
+ angle =
400
+ ((point[0] - drag.point[0]) * tangent[0] +
401
+ (point[1] - drag.point[1]) * tangent[1] +
402
+ (point[2] - drag.point[2]) * tangent[2]) /
403
+ (RING * drag.size);
404
+ }
405
+ else {
406
+ const from = [
407
+ drag.point[0] - drag.position[0],
408
+ drag.point[1] - drag.position[1],
409
+ drag.point[2] - drag.position[2]
410
+ ];
411
+ const to = [point[0] - drag.position[0], point[1] - drag.position[1], point[2] - drag.position[2]];
412
+ angle = Math.atan2(dot(cross(from, to), axis), dot(from, to));
413
+ }
414
+ angle = snap(angle, this.rotationSnap);
415
+ const turn = quatFromAxisAngle([0, 0, 0, 1], axis, angle), world = quatNormalize([0, 0, 0, 1], quatMultiply([0, 0, 0, 1], turn, drag.quaternion));
416
+ this.setWorldQuaternion(object, world);
417
+ }
418
+ else {
419
+ let factor;
420
+ if (drag.handle === 'xyz') {
421
+ const point = this.onPlane(origin, d, drag.position, drag.normal);
422
+ if (!point)
423
+ return;
424
+ // Dragging up or to the right grows the object, down or left shrinks it.
425
+ const m = this.camera.matrixWorld;
426
+ factor =
427
+ 1 +
428
+ ((point[0] - drag.point[0]) * (m[0] + m[4]) +
429
+ (point[1] - drag.point[1]) * (m[1] + m[5]) +
430
+ (point[2] - drag.point[2]) * (m[2] + m[6])) /
431
+ drag.size;
432
+ }
433
+ else {
434
+ const start = Math.abs(drag.along) < 1e-6 ? 1e-6 : drag.along;
435
+ factor = this.alongAxis(origin, d, drag.position, drag.axes[index]) / start;
436
+ }
437
+ factor = Math.max(snap(factor, this.scaleSnap), 1e-4);
438
+ for (let i = 0; i < 3; i++)
439
+ object.scale[i] = drag.handle === 'xyz' || i === index ? drag.scale[i] * factor : drag.scale[i];
440
+ object.markTransformDirty();
441
+ }
442
+ this.update();
443
+ this.onChange?.(object);
444
+ }
445
+ /** Finish the current drag, keeping the object where it is. */
446
+ endDrag() {
447
+ if (!this.#drag)
448
+ return;
449
+ this.#drag = undefined;
450
+ this.onDraggingChanged?.(false);
451
+ }
452
+ /** Abandon the current drag and put the object back where it started. */
453
+ cancelDrag() {
454
+ const drag = this.#drag, object = this.#object;
455
+ if (!drag || !object)
456
+ return;
457
+ this.setWorldPosition(object, drag.position);
458
+ this.setWorldQuaternion(object, drag.quaternion);
459
+ object.scale.set(drag.scale);
460
+ object.markTransformDirty();
461
+ this.endDrag();
462
+ this.update();
463
+ this.onChange?.(object);
464
+ }
465
+ setWorldPosition(object, world) {
466
+ const parent = object.parent;
467
+ if (parent) {
468
+ parent.updateWorldMatrix();
469
+ const inverse = new Float32Array(16);
470
+ if (!mat4Invert(inverse, parent.matrixWorld))
471
+ return;
472
+ vec3TransformMat4(object.position, world, inverse);
473
+ }
474
+ else
475
+ object.position.set(world);
476
+ object.markTransformDirty();
477
+ }
478
+ setWorldQuaternion(object, world) {
479
+ const parent = object.parent;
480
+ if (parent) {
481
+ parent.updateWorldMatrix();
482
+ const t = [0, 0, 0], q = [0, 0, 0, 1], s = [1, 1, 1];
483
+ mat4Decompose(parent.matrixWorld, t, q, s);
484
+ // The inverse of a unit quaternion is its conjugate.
485
+ quatMultiply(object.quaternion, [-q[0], -q[1], -q[2], q[3]], world);
486
+ }
487
+ else
488
+ object.quaternion.set(world);
489
+ quatNormalize(object.quaternion, object.quaternion);
490
+ object.markTransformDirty();
491
+ }
492
+ /** Release the handle geometry and materials. */
493
+ dispose() {
494
+ this.endDrag();
495
+ this.removeFromParent();
496
+ const seen = new Set();
497
+ this.traverse(node => {
498
+ if (node instanceof Mesh3D && !seen.has(node.geometry)) {
499
+ seen.add(node.geometry);
500
+ node.geometry.dispose();
501
+ }
502
+ return true;
503
+ });
504
+ for (const list of this.#materials.values())
505
+ for (const entry of list)
506
+ entry.material.dispose();
507
+ }
508
+ }
509
+ export function createTransformGizmo3D(camera, options = {}) {
510
+ return new TransformGizmo3D(camera, options);
511
+ }
512
+ //# sourceMappingURL=Gizmo3D.js.map
@@ -0,0 +1,67 @@
1
+ import { AnimationClip3D } from './Animation3D.js';
2
+ import { Camera3D } from './Camera3D.js';
3
+ import { Geometry3D } from './Geometry3D.js';
4
+ import { Material3D } from './Material3D.js';
5
+ import { Object3D } from './Object3D.js';
6
+ import type { Ktx2Options3D } from './Ktx23D.js';
7
+ import { Texture3D } from './Texture3D.js';
8
+ import type { TextureSource3D } from './Texture3D.js';
9
+ export interface GltfImageRequest3D {
10
+ readonly index: number;
11
+ readonly mimeType: string | undefined;
12
+ /** Encoded image bytes when embedded in a buffer or data URI. */
13
+ readonly bytes: Uint8Array | undefined;
14
+ /** Relative or absolute URI when the image is external. */
15
+ readonly uri: string | undefined;
16
+ }
17
+ export interface GltfLoadOptions3D {
18
+ /** Decode an encoded image into pixels or a host image object. */
19
+ readonly decodeImage?: (request: GltfImageRequest3D) => Promise<TextureSource3D>;
20
+ /** Fetch an external .bin buffer referenced by a .gltf file. */
21
+ readonly loadBuffer?: (uri: string) => Promise<Uint8Array>;
22
+ /** Transcode KTX2 payloads the built-in reader cannot use directly (Basis Universal, supercompressed). */
23
+ readonly transcodeKtx2?: Ktx2Options3D['transcode'];
24
+ /**
25
+ * Decode one EXT_meshopt_compression buffer view into `count * stride`
26
+ * bytes, with the view's filter already applied.
27
+ */
28
+ readonly decodeMeshopt?: (request: GltfMeshoptRequest3D) => Uint8Array;
29
+ /** Decode one KHR_draco_mesh_compression primitive. */
30
+ readonly decodeDraco?: (request: GltfDracoRequest3D) => Promise<GltfDracoResult3D> | GltfDracoResult3D;
31
+ }
32
+ export interface GltfMeshoptRequest3D {
33
+ readonly source: Uint8Array;
34
+ readonly count: number;
35
+ readonly stride: number;
36
+ readonly mode: 'ATTRIBUTES' | 'TRIANGLES' | 'INDICES';
37
+ readonly filter: 'NONE' | 'OCTAHEDRAL' | 'QUATERNION' | 'EXPONENTIAL';
38
+ }
39
+ export interface GltfDracoRequest3D {
40
+ readonly bytes: Uint8Array;
41
+ /** glTF semantic (POSITION, NORMAL, ...) to Draco attribute id. */
42
+ readonly attributes: Readonly<Record<string, number>>;
43
+ /** glTF component type (5120 to 5126) each semantic's accessor asks for. */
44
+ readonly componentTypes: Readonly<Record<string, number>>;
45
+ /** glTF component type of the index accessor, when the primitive is indexed. */
46
+ readonly indexComponentType: number | undefined;
47
+ }
48
+ export interface GltfDracoResult3D {
49
+ /** Decoded arrays by glTF semantic, in the component type of the matching accessor. */
50
+ readonly attributes: Readonly<Record<string, Float32Array | Uint32Array | Uint16Array | Uint8Array | Int16Array | Int8Array>>;
51
+ readonly indices?: Uint32Array | Uint16Array;
52
+ }
53
+ export interface GltfAsset3D {
54
+ /** Root of the default scene (or the first one). */
55
+ readonly scene: Object3D;
56
+ readonly scenes: readonly Object3D[];
57
+ readonly animations: readonly AnimationClip3D[];
58
+ readonly cameras: readonly Camera3D[];
59
+ readonly materials: readonly Material3D[];
60
+ readonly textures: readonly Texture3D[];
61
+ readonly geometries: readonly Geometry3D[];
62
+ /** Release every geometry, material and texture created for this asset. */
63
+ dispose(): void;
64
+ }
65
+ /** Parse a glTF 2.0 asset from .glb bytes, .gltf JSON bytes or an already parsed JSON object. */
66
+ export declare function loadGltf3D(data: Uint8Array | object, options?: GltfLoadOptions3D): Promise<GltfAsset3D>;
67
+ //# sourceMappingURL=Gltf3D.d.ts.map