@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,99 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // Shared error type, identity counters and the disposable resource base used
3
+ // by geometries, textures and materials. DOM-free; no backend dependency.
4
+ /** Stable machine-readable code plus a human-readable detail and the original cause. */
5
+ export class World3DError extends Error {
6
+ code;
7
+ detail;
8
+ constructor(code, detail, cause) {
9
+ super(detail === undefined ? code : code + ': ' + detail, { cause });
10
+ this.name = 'World3DError';
11
+ this.code = code;
12
+ this.detail = detail;
13
+ }
14
+ }
15
+ let nextId = 1;
16
+ /** Process-unique positive integer identity for sort keys and cache lookups. */
17
+ export function allocateId3D() {
18
+ return nextId++;
19
+ }
20
+ export function requireFinite3D(value, field) {
21
+ if (typeof value !== 'number' || !Number.isFinite(value))
22
+ throw new World3DError('WORLD3D_INPUT_INVALID', field);
23
+ return value;
24
+ }
25
+ export function requirePositive3D(value, field) {
26
+ const number = requireFinite3D(value, field);
27
+ if (number <= 0)
28
+ throw new World3DError('WORLD3D_INPUT_INVALID', field);
29
+ return number;
30
+ }
31
+ export function requireCount3D(value, field, max) {
32
+ if (typeof value !== 'number' || !Number.isSafeInteger(value) || value < 0)
33
+ throw new World3DError('WORLD3D_INPUT_INVALID', field);
34
+ if (value > max)
35
+ throw new World3DError('WORLD3D_BUDGET', field);
36
+ return value;
37
+ }
38
+ /**
39
+ * CPU-side resource with a version counter and terminal disposal.
40
+ * Backends subscribe through onDispose to retire their GPU objects; the
41
+ * resource never references a backend, so the core stays host-independent.
42
+ */
43
+ export class Resource3D {
44
+ id = allocateId3D();
45
+ name = '';
46
+ #version = 1;
47
+ #disposed = false;
48
+ #listeners;
49
+ /** Increases whenever content changed and a backend copy must be refreshed. */
50
+ get version() {
51
+ return this.#version;
52
+ }
53
+ get isDisposed() {
54
+ return this.#disposed;
55
+ }
56
+ /** Mark CPU content as changed. */
57
+ touch() {
58
+ this.#version++;
59
+ }
60
+ /** Returns an unsubscribe function. Listeners run once, in registration order. */
61
+ onDispose(listener) {
62
+ if (this.#disposed) {
63
+ listener();
64
+ return () => { };
65
+ }
66
+ (this.#listeners ??= new Set()).add(listener);
67
+ return () => {
68
+ this.#listeners?.delete(listener);
69
+ };
70
+ }
71
+ /** Idempotent. Listener failures are collected and rethrown after all have run. */
72
+ dispose() {
73
+ if (this.#disposed)
74
+ return;
75
+ this.#disposed = true;
76
+ const listeners = this.#listeners;
77
+ this.#listeners = undefined;
78
+ if (!listeners)
79
+ return;
80
+ const failures = [];
81
+ for (const listener of listeners) {
82
+ try {
83
+ listener();
84
+ }
85
+ catch (cause) {
86
+ failures.push(cause);
87
+ }
88
+ }
89
+ if (failures.length === 1)
90
+ throw failures[0];
91
+ if (failures.length > 1)
92
+ throw new AggregateError(failures, 'WORLD3D_RESOURCE_FAILED');
93
+ }
94
+ assertLive() {
95
+ if (this.#disposed)
96
+ throw new World3DError('WORLD3D_DISPOSED', this.name || undefined);
97
+ }
98
+ }
99
+ //# sourceMappingURL=core3D.js.map
@@ -0,0 +1,64 @@
1
+ import { Camera3D } from './Camera3D.js';
2
+ import { Light3D } from './Light3D.js';
3
+ import type { ColorInput3D } from './Material3D.js';
4
+ import { Bone3D, Mesh3D } from './Mesh3D.js';
5
+ import { Object3D } from './Object3D.js';
6
+ /**
7
+ * World-space bounds of an object and its descendants as
8
+ * [minX, minY, minZ, maxX, maxY, maxZ]. Empty (min > max) when nothing has geometry.
9
+ */
10
+ export declare function computeObjectBounds3D(object: Object3D, out?: Float32Array): Float32Array;
11
+ /** Shared base: a line mesh whose vertices are rewritten by update(). */
12
+ export declare abstract class LineHelper3D extends Mesh3D {
13
+ #private;
14
+ protected readonly positions: Float32Array;
15
+ constructor(segments: number, color: ColorInput3D, name: string);
16
+ /** Recompute the lines from the subject's current state. */
17
+ abstract update(): void;
18
+ protected segment(index: number, a: ArrayLike<number>, b: ArrayLike<number>): void;
19
+ protected commit(): void;
20
+ /** Release the helper's own geometry and material. */
21
+ dispose(): void;
22
+ }
23
+ /** Wire box around an object's world bounds. */
24
+ export declare class BoxHelper3D extends LineHelper3D {
25
+ #private;
26
+ readonly target: Object3D;
27
+ constructor(target: Object3D, color?: ColorInput3D);
28
+ update(): void;
29
+ }
30
+ /** Arrow from `origin` along `direction`; change them and call update(). */
31
+ export declare class ArrowHelper3D extends LineHelper3D {
32
+ readonly origin: Float32Array<ArrayBuffer>;
33
+ readonly direction: Float32Array<ArrayBuffer>;
34
+ length: number;
35
+ constructor(direction: ArrayLike<number>, origin?: ArrayLike<number>, length?: number, color?: ColorInput3D);
36
+ update(): void;
37
+ }
38
+ /** Outline of a camera's view volume. */
39
+ export declare class CameraHelper3D extends LineHelper3D {
40
+ readonly camera: Camera3D;
41
+ constructor(camera: Camera3D, color?: ColorInput3D);
42
+ update(): void;
43
+ }
44
+ /** Shows where a light is and where it points: a ray for directional, a cone for spot, a range sphere for point lights. */
45
+ export declare class LightHelper3D extends LineHelper3D {
46
+ readonly light: Light3D;
47
+ /** Drawn size for lights without a range. */
48
+ size: number;
49
+ constructor(light: Light3D, size?: number, color?: ColorInput3D);
50
+ update(): void;
51
+ }
52
+ /** A line from every bone to its parent bone. */
53
+ export declare class SkeletonHelper3D extends LineHelper3D {
54
+ readonly root: Object3D;
55
+ readonly bones: readonly Bone3D[];
56
+ constructor(root: Object3D, color?: ColorInput3D);
57
+ update(): void;
58
+ }
59
+ export declare function createBoxHelper3D(target: Object3D, color?: ColorInput3D): BoxHelper3D;
60
+ export declare function createArrowHelper3D(direction: ArrayLike<number>, origin?: ArrayLike<number>, length?: number, color?: ColorInput3D): ArrowHelper3D;
61
+ export declare function createCameraHelper3D(camera: Camera3D, color?: ColorInput3D): CameraHelper3D;
62
+ export declare function createLightHelper3D(light: Light3D, size?: number, color?: ColorInput3D): LightHelper3D;
63
+ export declare function createSkeletonHelper3D(root: Object3D, color?: ColorInput3D): SkeletonHelper3D;
64
+ //# sourceMappingURL=debug3D.d.ts.map
@@ -0,0 +1,257 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // Authoring and debug visuals that follow other objects: bounds, arrows,
3
+ // camera frusta, lights and skeletons. Each helper is a world-space line
4
+ // node; add it to the scene root and call update() after its subject moves.
5
+ import { Camera3D } from './Camera3D.js';
6
+ import { World3DError } from './core3D.js';
7
+ import { Attribute3D, Geometry3D } from './Geometry3D.js';
8
+ import { createLineMaterial3D } from './helpers3D.js';
9
+ import { Light3D } from './Light3D.js';
10
+ import { box3Empty, box3IsEmpty, box3Transform, box3Union, mat4Invert, vec3TransformMat4 } from './math3D.js';
11
+ import { Bone3D, Mesh3D } from './Mesh3D.js';
12
+ import { Object3D } from './Object3D.js';
13
+ const scratchBox = new Float32Array(6), scratchMatrix = new Float32Array(16), scratchPoint = new Float32Array(3);
14
+ /**
15
+ * World-space bounds of an object and its descendants as
16
+ * [minX, minY, minZ, maxX, maxY, maxZ]. Empty (min > max) when nothing has geometry.
17
+ */
18
+ export function computeObjectBounds3D(object, out = new Float32Array(6)) {
19
+ if (!(object instanceof Object3D))
20
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'object');
21
+ object.updateWorldMatrices();
22
+ box3Empty(out);
23
+ object.traverse(node => {
24
+ if (!(node instanceof Mesh3D) || node instanceof LineHelper3D)
25
+ return;
26
+ box3Transform(scratchBox, node.geometry.boundingBox, node.matrixWorld);
27
+ box3Union(out, out, scratchBox);
28
+ });
29
+ return out;
30
+ }
31
+ /** Shared base: a line mesh whose vertices are rewritten by update(). */
32
+ export class LineHelper3D extends Mesh3D {
33
+ positions;
34
+ #attribute;
35
+ constructor(segments, color, name) {
36
+ const geometry = new Geometry3D(), positions = new Float32Array(segments * 6), attribute = new Attribute3D(positions, 3);
37
+ geometry.topology = 'lines';
38
+ geometry.setAttribute('position', attribute);
39
+ super(geometry, createLineMaterial3D(color));
40
+ this.positions = positions;
41
+ this.#attribute = attribute;
42
+ this.castShadow = false;
43
+ this.receiveShadow = false;
44
+ this.frustumCulled = false;
45
+ this.name = name;
46
+ }
47
+ segment(index, a, b) {
48
+ const p = this.positions, at = index * 6;
49
+ p[at] = a[0];
50
+ p[at + 1] = a[1];
51
+ p[at + 2] = a[2];
52
+ p[at + 3] = b[0];
53
+ p[at + 4] = b[1];
54
+ p[at + 5] = b[2];
55
+ }
56
+ commit() {
57
+ this.#attribute.touch();
58
+ this.geometry.invalidateBounds();
59
+ }
60
+ /** Release the helper's own geometry and material. */
61
+ dispose() {
62
+ this.geometry.dispose();
63
+ this.material.dispose();
64
+ }
65
+ }
66
+ const BOX_EDGES = [0, 1, 1, 3, 3, 2, 2, 0, 4, 5, 5, 7, 7, 6, 6, 4, 0, 4, 1, 5, 2, 6, 3, 7];
67
+ /** Wire box around an object's world bounds. */
68
+ export class BoxHelper3D extends LineHelper3D {
69
+ target;
70
+ #bounds = new Float32Array(6);
71
+ constructor(target, color = 0xffff00) {
72
+ super(12, color, 'box-helper');
73
+ this.target = target;
74
+ this.update();
75
+ }
76
+ update() {
77
+ const b = computeObjectBounds3D(this.target, this.#bounds);
78
+ if (box3IsEmpty(b)) {
79
+ this.positions.fill(0);
80
+ this.commit();
81
+ return;
82
+ }
83
+ const corner = (i) => [b[i & 1 ? 3 : 0], b[i & 2 ? 4 : 1], b[i & 4 ? 5 : 2]];
84
+ for (let i = 0; i < 12; i++)
85
+ this.segment(i, corner(BOX_EDGES[i * 2]), corner(BOX_EDGES[i * 2 + 1]));
86
+ this.commit();
87
+ }
88
+ }
89
+ /** Arrow from `origin` along `direction`; change them and call update(). */
90
+ export class ArrowHelper3D extends LineHelper3D {
91
+ origin = new Float32Array(3);
92
+ direction = new Float32Array([0, 1, 0]);
93
+ length;
94
+ constructor(direction, origin = [0, 0, 0], length = 1, color = 0xffff00) {
95
+ super(5, color, 'arrow-helper');
96
+ this.direction.set([direction[0], direction[1], direction[2]]);
97
+ this.origin.set([origin[0], origin[1], origin[2]]);
98
+ this.length = length;
99
+ this.update();
100
+ }
101
+ update() {
102
+ const d = this.direction, size = Math.hypot(d[0], d[1], d[2]) || 1, x = d[0] / size, y = d[1] / size, z = d[2] / size, o = this.origin, length = this.length;
103
+ const tip = [o[0] + x * length, o[1] + y * length, o[2] + z * length], head = length * 0.2, back = [tip[0] - x * head, tip[1] - y * head, tip[2] - z * head];
104
+ // Two perpendiculars to the direction span the arrow head.
105
+ const ux = Math.abs(y) < 0.99 ? -z : 0, uy = Math.abs(y) < 0.99 ? 0 : -z, uz = Math.abs(y) < 0.99 ? x : y, us = Math.hypot(ux, uy, uz) || 1;
106
+ const u = [ux / us, uy / us, uz / us], v = [y * u[2] - z * u[1], z * u[0] - x * u[2], x * u[1] - y * u[0]], w = head * 0.4;
107
+ this.segment(0, o, tip);
108
+ [
109
+ [1, 0],
110
+ [-1, 0],
111
+ [0, 1],
112
+ [0, -1]
113
+ ].forEach(([a, b], i) => this.segment(1 + i, tip, [
114
+ back[0] + (u[0] * a + v[0] * b) * w,
115
+ back[1] + (u[1] * a + v[1] * b) * w,
116
+ back[2] + (u[2] * a + v[2] * b) * w
117
+ ]));
118
+ this.commit();
119
+ }
120
+ }
121
+ /** Outline of a camera's view volume. */
122
+ export class CameraHelper3D extends LineHelper3D {
123
+ camera;
124
+ constructor(camera, color = 0xffaa00) {
125
+ super(12, color, 'camera-helper');
126
+ this.camera = camera;
127
+ if (!(camera instanceof Camera3D))
128
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'camera');
129
+ this.update();
130
+ }
131
+ update() {
132
+ const camera = this.camera;
133
+ camera.updateWorldMatrices();
134
+ camera.updateViewMatrices();
135
+ if (!mat4Invert(scratchMatrix, camera.viewProjectionMatrix))
136
+ return;
137
+ const corners = [];
138
+ for (let i = 0; i < 8; i++) {
139
+ scratchPoint[0] = i & 1 ? 1 : -1;
140
+ scratchPoint[1] = i & 2 ? 1 : -1;
141
+ scratchPoint[2] = i & 4 ? 1 : -1;
142
+ vec3TransformMat4(scratchPoint, scratchPoint, scratchMatrix);
143
+ corners.push([scratchPoint[0], scratchPoint[1], scratchPoint[2]]);
144
+ }
145
+ for (let i = 0; i < 12; i++)
146
+ this.segment(i, corners[BOX_EDGES[i * 2]], corners[BOX_EDGES[i * 2 + 1]]);
147
+ this.commit();
148
+ }
149
+ }
150
+ const RING = 24;
151
+ /** Shows where a light is and where it points: a ray for directional, a cone for spot, a range sphere for point lights. */
152
+ export class LightHelper3D extends LineHelper3D {
153
+ light;
154
+ /** Drawn size for lights without a range. */
155
+ size;
156
+ constructor(light, size = 1, color) {
157
+ super(RING * 3 + 8, color ?? [light.color[0], light.color[1], light.color[2]], 'light-helper');
158
+ this.light = light;
159
+ this.size = size;
160
+ this.update();
161
+ }
162
+ update() {
163
+ const light = this.light;
164
+ light.updateWorldMatrices();
165
+ const m = light.matrixWorld, o = [m[12], m[13], m[14]], axis = (c) => {
166
+ const x = m[c * 4], y = m[c * 4 + 1], z = m[c * 4 + 2], s = Math.hypot(x, y, z) || 1;
167
+ return [x / s, y / s, z / s];
168
+ };
169
+ const right = axis(0), up = axis(1), back = axis(2), forward = [-back[0], -back[1], -back[2]];
170
+ const along = (a, b, c, x, y, z) => [
171
+ o[0] + a[0] * x + b[0] * y + c[0] * z,
172
+ o[1] + a[1] * x + b[1] * y + c[1] * z,
173
+ o[2] + a[2] * x + b[2] * y + c[2] * z
174
+ ];
175
+ this.positions.fill(0);
176
+ let next = 0;
177
+ const ring = (a, b, c, radius, offset) => {
178
+ for (let i = 0; i < RING; i++) {
179
+ const t0 = (i / RING) * Math.PI * 2, t1 = ((i + 1) / RING) * Math.PI * 2;
180
+ this.segment(next++, along(a, b, c, Math.cos(t0) * radius, Math.sin(t0) * radius, offset), along(a, b, c, Math.cos(t1) * radius, Math.sin(t1) * radius, offset));
181
+ }
182
+ };
183
+ if (light.lightType === 'point') {
184
+ const radius = light.range > 0 ? light.range : this.size * 0.25;
185
+ ring(right, up, forward, radius, 0);
186
+ ring(up, forward, right, radius, 0);
187
+ ring(forward, right, up, radius, 0);
188
+ }
189
+ else if (light.lightType === 'spot') {
190
+ const length = light.range > 0 ? light.range : this.size, radius = Math.tan(Math.min(light.angle, 1.5)) * length;
191
+ ring(right, up, forward, radius, length);
192
+ [
193
+ [1, 0],
194
+ [-1, 0],
195
+ [0, 1],
196
+ [0, -1]
197
+ ].forEach(([x, y]) => this.segment(next++, o, along(right, up, forward, x * radius, y * radius, length)));
198
+ }
199
+ else {
200
+ const half = this.size * 0.25;
201
+ ring(right, up, forward, half, 0);
202
+ this.segment(next++, o, along(right, up, forward, 0, 0, this.size));
203
+ [
204
+ [1, 0],
205
+ [-1, 0],
206
+ [0, 1],
207
+ [0, -1]
208
+ ].forEach(([x, y]) => this.segment(next++, along(right, up, forward, x * half, y * half, 0), along(right, up, forward, x * half, y * half, this.size * 0.6)));
209
+ }
210
+ this.commit();
211
+ }
212
+ }
213
+ /** A line from every bone to its parent bone. */
214
+ export class SkeletonHelper3D extends LineHelper3D {
215
+ root;
216
+ bones;
217
+ constructor(root, color = 0x00ffaa) {
218
+ const bones = [];
219
+ root.traverse(node => {
220
+ if (node instanceof Bone3D && node.parent instanceof Bone3D)
221
+ bones.push(node);
222
+ });
223
+ super(Math.max(bones.length, 1), color, 'skeleton-helper');
224
+ this.root = root;
225
+ this.bones = bones;
226
+ // Bones sit inside the mesh; draw the lines on top.
227
+ const material = this.material;
228
+ material.depthTest = false;
229
+ material.depthWrite = false;
230
+ this.renderOrder = 1e5;
231
+ this.update();
232
+ }
233
+ update() {
234
+ this.root.updateWorldMatrices();
235
+ this.bones.forEach((bone, i) => {
236
+ const a = bone.matrixWorld, b = bone.parent.matrixWorld;
237
+ this.segment(i, [a[12], a[13], a[14]], [b[12], b[13], b[14]]);
238
+ });
239
+ this.commit();
240
+ }
241
+ }
242
+ export function createBoxHelper3D(target, color) {
243
+ return new BoxHelper3D(target, color);
244
+ }
245
+ export function createArrowHelper3D(direction, origin, length, color) {
246
+ return new ArrowHelper3D(direction, origin, length, color);
247
+ }
248
+ export function createCameraHelper3D(camera, color) {
249
+ return new CameraHelper3D(camera, color);
250
+ }
251
+ export function createLightHelper3D(light, size, color) {
252
+ return new LightHelper3D(light, size, color);
253
+ }
254
+ export function createSkeletonHelper3D(root, color) {
255
+ return new SkeletonHelper3D(root, color);
256
+ }
257
+ //# sourceMappingURL=debug3D.js.map
@@ -0,0 +1,42 @@
1
+ import type { GltfDracoRequest3D, GltfDracoResult3D } from './Gltf3D.js';
2
+ import type { Ktx2Info3D, Ktx2Result3D } from './Ktx23D.js';
3
+ import type { CompressedFormat3D } from './Texture3D.js';
4
+ type Opaque = Record<string, unknown>;
5
+ /** The parts of an initialized Draco decoder module (`await DracoDecoderModule()`) this adapter calls. */
6
+ export interface DracoModule3D {
7
+ readonly Decoder: new () => Opaque;
8
+ readonly DecoderBuffer: new () => Opaque;
9
+ readonly Mesh: new () => Opaque;
10
+ readonly TRIANGULAR_MESH: number;
11
+ readonly DT_INT8: number;
12
+ readonly DT_UINT8: number;
13
+ readonly DT_INT16: number;
14
+ readonly DT_UINT16: number;
15
+ readonly DT_INT32: number;
16
+ readonly DT_UINT32: number;
17
+ readonly DT_FLOAT32: number;
18
+ readonly HEAPU8: Uint8Array;
19
+ _malloc(bytes: number): number;
20
+ _free(pointer: number): void;
21
+ destroy(object: Opaque): void;
22
+ }
23
+ /**
24
+ * Turn an initialized Draco decoder module into the `decodeDraco` option of
25
+ * the glTF loader. Only triangle meshes are decoded, as the glTF extension
26
+ * requires.
27
+ */
28
+ export declare function createDracoDecoder3D(draco: DracoModule3D): (request: GltfDracoRequest3D) => GltfDracoResult3D;
29
+ /** The parts of an initialized Basis Universal transcoder module (`await BASIS()`) this adapter calls. */
30
+ export interface BasisModule3D {
31
+ initializeBasis(): void;
32
+ readonly KTX2File: new (data: Uint8Array) => Opaque;
33
+ }
34
+ /**
35
+ * Turn an initialized Basis Universal transcoder module into the
36
+ * `transcodeKtx2` option. `supports` reports which compressed formats the
37
+ * device can sample (pass `format => renderer.supportsCompressedFormat(format)`);
38
+ * the best available one is chosen, with plain RGBA as the fallback.
39
+ */
40
+ export declare function createBasisTranscoder3D(basis: BasisModule3D, supports: (format: CompressedFormat3D) => boolean): (info: Ktx2Info3D) => Ktx2Result3D;
41
+ export {};
42
+ //# sourceMappingURL=decoders3D.d.ts.map
@@ -0,0 +1,133 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // Adapters for the two official WebAssembly decoders the engine does not
3
+ // reimplement: Google's Draco mesh decoder and the Basis Universal texture
4
+ // transcoder. The application loads the decoder module itself (the engine
5
+ // ships neither) and passes it here; the result plugs into `decodeDraco` and
6
+ // `transcodeKtx2`. Nothing in this file touches the DOM.
7
+ import { World3DError } from './core3D.js';
8
+ const call = (object, name, ...args) => {
9
+ const method = object[name];
10
+ if (typeof method !== 'function')
11
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'decoder module has no ' + name);
12
+ return method.apply(object, args);
13
+ };
14
+ /**
15
+ * Turn an initialized Draco decoder module into the `decodeDraco` option of
16
+ * the glTF loader. Only triangle meshes are decoded, as the glTF extension
17
+ * requires.
18
+ */
19
+ export function createDracoDecoder3D(draco) {
20
+ if (!draco || typeof draco.Decoder !== 'function' || typeof draco._malloc !== 'function')
21
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'Draco decoder module');
22
+ const types = {
23
+ 5120: [Int8Array, draco.DT_INT8],
24
+ 5121: [Uint8Array, draco.DT_UINT8],
25
+ 5122: [Int16Array, draco.DT_INT16],
26
+ 5123: [Uint16Array, draco.DT_UINT16],
27
+ 5125: [Uint32Array, draco.DT_UINT32],
28
+ 5126: [Float32Array, draco.DT_FLOAT32]
29
+ };
30
+ return request => {
31
+ const decoder = new draco.Decoder(), buffer = new draco.DecoderBuffer(), mesh = new draco.Mesh();
32
+ let pointer = 0;
33
+ try {
34
+ call(buffer, 'Init', request.bytes, request.bytes.byteLength);
35
+ if (call(decoder, 'GetEncodedGeometryType', buffer) !== draco.TRIANGULAR_MESH)
36
+ throw new World3DError('WORLD3D_GLTF_INVALID', 'Draco data is not a triangle mesh');
37
+ const status = call(decoder, 'DecodeBufferToMesh', buffer, mesh);
38
+ if (!call(status, 'ok'))
39
+ throw new World3DError('WORLD3D_GLTF_INVALID', 'Draco decoding failed: ' + String(call(status, 'error_msg')));
40
+ const points = call(mesh, 'num_points'), faces = call(mesh, 'num_faces');
41
+ // The module writes into its own memory; each array is copied out before the memory is released.
42
+ const read = (Type, length, fill) => {
43
+ const bytes = length * Type.BYTES_PER_ELEMENT;
44
+ pointer = draco._malloc(bytes);
45
+ if (fill(bytes, pointer) === false)
46
+ throw new World3DError('WORLD3D_GLTF_INVALID', 'Draco attribute could not be read');
47
+ const copy = new Type(draco.HEAPU8.buffer, pointer, length).slice();
48
+ draco._free(pointer);
49
+ pointer = 0;
50
+ return copy;
51
+ };
52
+ const attributes = {};
53
+ for (const [semantic, id] of Object.entries(request.attributes)) {
54
+ const attribute = call(decoder, 'GetAttributeByUniqueId', mesh, id), entry = types[request.componentTypes[semantic] ?? 5126];
55
+ if (!attribute || !entry)
56
+ throw new World3DError('WORLD3D_GLTF_INVALID', 'Draco attribute ' + semantic);
57
+ const components = call(attribute, 'num_components');
58
+ attributes[semantic] = read(entry[0], points * components, (bytes, at) => call(decoder, 'GetAttributeDataArrayForAllPoints', mesh, attribute, entry[1], bytes, at));
59
+ }
60
+ const wide = read(Uint32Array, faces * 3, (bytes, at) => call(decoder, 'GetTrianglesUInt32Array', mesh, bytes, at));
61
+ // Index arrays are handed back in the width the accessor declares.
62
+ const indices = request.indexComponentType === 5123 ? Uint16Array.from(wide) : wide;
63
+ return request.indexComponentType === undefined ? { attributes } : { attributes, indices };
64
+ }
65
+ finally {
66
+ if (pointer)
67
+ draco._free(pointer);
68
+ draco.destroy(mesh);
69
+ draco.destroy(buffer);
70
+ draco.destroy(decoder);
71
+ }
72
+ };
73
+ }
74
+ // Target numbers of the transcoder, which are fixed by its public interface.
75
+ const BASIS_TARGETS = Object.freeze({
76
+ 'etc2-rgba8': 1,
77
+ bc1: 2,
78
+ bc3: 3,
79
+ bc7: 6,
80
+ 'astc-4x4': 10,
81
+ rgba8: 13,
82
+ 'etc2-rgb8': 0
83
+ });
84
+ /**
85
+ * Turn an initialized Basis Universal transcoder module into the
86
+ * `transcodeKtx2` option. `supports` reports which compressed formats the
87
+ * device can sample (pass `format => renderer.supportsCompressedFormat(format)`);
88
+ * the best available one is chosen, with plain RGBA as the fallback.
89
+ */
90
+ export function createBasisTranscoder3D(basis, supports) {
91
+ if (!basis || typeof basis.KTX2File !== 'function' || typeof supports !== 'function')
92
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'Basis transcoder module');
93
+ let ready = false;
94
+ return info => {
95
+ if (!ready) {
96
+ basis.initializeBasis();
97
+ ready = true;
98
+ }
99
+ const file = new basis.KTX2File(info.file);
100
+ try {
101
+ if (!call(file, 'isValid'))
102
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'ktx2: the transcoder rejected the file');
103
+ const alpha = call(file, 'getHasAlpha') === true || call(file, 'getHasAlpha') === 1, uastc = call(file, 'isUASTC') === true || call(file, 'isUASTC') === 1;
104
+ // High-quality UASTC maps best onto ASTC and BC7; ETC1S is cheapest to turn into ETC.
105
+ const opaqueEtc = 'etc2-rgb8', order = uastc
106
+ ? ['astc-4x4', 'bc7', alpha ? 'etc2-rgba8' : opaqueEtc, alpha ? 'bc3' : 'bc1']
107
+ : [alpha ? 'etc2-rgba8' : opaqueEtc, 'bc7', 'astc-4x4', alpha ? 'bc3' : 'bc1'];
108
+ const format = order.find(candidate => supports(candidate)), target = BASIS_TARGETS[format ?? 'rgba8'];
109
+ if (!call(file, 'startTranscoding'))
110
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'ktx2: transcoding could not start');
111
+ // The transfer function byte of the data format descriptor says whether colors are sRGB.
112
+ const view = new DataView(info.file.buffer, info.file.byteOffset, info.file.byteLength), descriptor = view.getUint32(48, true);
113
+ const colorSpace = descriptor > 0 && descriptor + 15 <= info.file.byteLength && info.file[descriptor + 14] === 2
114
+ ? 'srgb'
115
+ : 'linear';
116
+ const levels = [];
117
+ for (let level = 0; level < (format ? info.levelCount : 1); level++) {
118
+ const size = call(file, 'getImageTranscodedSizeInBytes', level, 0, 0, target), pixels = new Uint8Array(size);
119
+ if (!call(file, 'transcodeImage', pixels, level, 0, 0, target, 0, -1, -1))
120
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'ktx2: level ' + level + ' could not be transcoded');
121
+ levels.push(pixels);
122
+ }
123
+ if (!format)
124
+ return { source: { width: info.width, height: info.height, data: levels[0] }, colorSpace };
125
+ return { source: { width: info.width, height: info.height, format, levels }, colorSpace };
126
+ }
127
+ finally {
128
+ call(file, 'close');
129
+ call(file, 'delete');
130
+ }
131
+ };
132
+ }
133
+ //# sourceMappingURL=decoders3D.js.map