@egret/engine 0.0.0-stage → 7.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (601) 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 +469 -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 +48 -0
  20. package/dist/animation/sequenceResetTypes.js +2 -0
  21. package/dist/animation/types.d.ts +75 -0
  22. package/dist/animation/types.js +2 -0
  23. package/dist/assetBundle.d.ts +54 -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 +17 -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 +47 -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 +246 -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 +31 -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 +112 -0
  46. package/dist/bitmapFontTypes.js +2 -0
  47. package/dist/bitmapResourceSlot.d.ts +26 -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 +419 -0
  57. package/dist/cameraTypes.d.ts +126 -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 +35 -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 +45 -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 +39 -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 +37 -0
  82. package/dist/gameClockTypes.js +2 -0
  83. package/dist/gameRun.d.ts +53 -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 +142 -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 +129 -0
  98. package/dist/hoverInputTypes.js +2 -0
  99. package/dist/index.d.ts +52 -0
  100. package/dist/index.js +21 -0
  101. package/dist/input.d.ts +6 -0
  102. package/dist/input.js +5 -0
  103. package/dist/inputActions.d.ts +86 -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 +68 -0
  116. package/dist/internal/uiFactoryState.js +173 -0
  117. package/dist/internal/uiRootState.d.ts +67 -0
  118. package/dist/internal/uiRootState.js +103 -0
  119. package/dist/keyboardInput.d.ts +13 -0
  120. package/dist/keyboardInput.js +579 -0
  121. package/dist/keyboardInputTypes.d.ts +93 -0
  122. package/dist/keyboardInputTypes.js +2 -0
  123. package/dist/kit.d.ts +16 -0
  124. package/dist/kit.js +10 -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 +17 -0
  132. package/dist/manifestResourceState.js +58 -0
  133. package/dist/manifestResourceTypes.d.ts +26 -0
  134. package/dist/manifestResourceTypes.js +2 -0
  135. package/dist/motion.d.ts +35 -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 +41 -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 +300 -0
  145. package/dist/particleTypes.d.ts +115 -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 +221 -0
  154. package/dist/physics2dTypes.js +2 -0
  155. package/dist/physics2dWorld.d.ts +4 -0
  156. package/dist/physics2dWorld.js +823 -0
  157. package/dist/pointerInput.d.ts +12 -0
  158. package/dist/pointerInput.js +300 -0
  159. package/dist/pointerInputTypes.d.ts +41 -0
  160. package/dist/pointerInputTypes.js +2 -0
  161. package/dist/random.d.ts +30 -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 +379 -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 +90 -0
  172. package/dist/rendering/prepareSharedDraws2D.js +663 -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 +52 -0
  178. package/dist/rendering/sharedColor2D.js +191 -0
  179. package/dist/rendering/sharedEffects2D.d.ts +23 -0
  180. package/dist/rendering/sharedEffects2D.js +126 -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 +104 -0
  188. package/dist/rendering/world3d/Animation3D.js +384 -0
  189. package/dist/rendering/world3d/AnimationTexture3D.d.ts +163 -0
  190. package/dist/rendering/world3d/AnimationTexture3D.js +603 -0
  191. package/dist/rendering/world3d/Batch3D.d.ts +75 -0
  192. package/dist/rendering/world3d/Batch3D.js +332 -0
  193. package/dist/rendering/world3d/Camera3D.d.ts +62 -0
  194. package/dist/rendering/world3d/Camera3D.js +132 -0
  195. package/dist/rendering/world3d/Character3D.d.ts +127 -0
  196. package/dist/rendering/world3d/Character3D.js +305 -0
  197. package/dist/rendering/world3d/Cloth3D.d.ts +130 -0
  198. package/dist/rendering/world3d/Cloth3D.js +503 -0
  199. package/dist/rendering/world3d/Compression3D.d.ts +22 -0
  200. package/dist/rendering/world3d/Compression3D.js +703 -0
  201. package/dist/rendering/world3d/Curves3D.d.ts +119 -0
  202. package/dist/rendering/world3d/Curves3D.js +460 -0
  203. package/dist/rendering/world3d/Decal3D.d.ts +43 -0
  204. package/dist/rendering/world3d/Decal3D.js +242 -0
  205. package/dist/rendering/world3d/Export3D.d.ts +13 -0
  206. package/dist/rendering/world3d/Export3D.js +263 -0
  207. package/dist/rendering/world3d/Geometry3D.d.ts +95 -0
  208. package/dist/rendering/world3d/Geometry3D.js +335 -0
  209. package/dist/rendering/world3d/GeometryBuilder3D.d.ts +53 -0
  210. package/dist/rendering/world3d/GeometryBuilder3D.js +196 -0
  211. package/dist/rendering/world3d/Gizmo3D.d.ts +80 -0
  212. package/dist/rendering/world3d/Gizmo3D.js +514 -0
  213. package/dist/rendering/world3d/Gltf3D.d.ts +73 -0
  214. package/dist/rendering/world3d/Gltf3D.js +996 -0
  215. package/dist/rendering/world3d/GpuParticles3D.d.ts +109 -0
  216. package/dist/rendering/world3d/GpuParticles3D.js +401 -0
  217. package/dist/rendering/world3d/Hdr3D.d.ts +35 -0
  218. package/dist/rendering/world3d/Hdr3D.js +191 -0
  219. package/dist/rendering/world3d/Jelly3D.d.ts +77 -0
  220. package/dist/rendering/world3d/Jelly3D.js +267 -0
  221. package/dist/rendering/world3d/Ktx23D.d.ts +30 -0
  222. package/dist/rendering/world3d/Ktx23D.js +112 -0
  223. package/dist/rendering/world3d/Light3D.d.ts +84 -0
  224. package/dist/rendering/world3d/Light3D.js +97 -0
  225. package/dist/rendering/world3d/Material3D.d.ts +253 -0
  226. package/dist/rendering/world3d/Material3D.js +269 -0
  227. package/dist/rendering/world3d/Mesh3D.d.ts +112 -0
  228. package/dist/rendering/world3d/Mesh3D.js +337 -0
  229. package/dist/rendering/world3d/Meshopt3D.d.ts +15 -0
  230. package/dist/rendering/world3d/Meshopt3D.js +276 -0
  231. package/dist/rendering/world3d/Navigation3D.d.ts +213 -0
  232. package/dist/rendering/world3d/Navigation3D.js +1043 -0
  233. package/dist/rendering/world3d/Object3D.d.ts +118 -0
  234. package/dist/rendering/world3d/Object3D.js +315 -0
  235. package/dist/rendering/world3d/Particles3D.d.ts +90 -0
  236. package/dist/rendering/world3d/Particles3D.js +277 -0
  237. package/dist/rendering/world3d/Physics3D.d.ts +430 -0
  238. package/dist/rendering/world3d/Physics3D.js +2840 -0
  239. package/dist/rendering/world3d/PhysicsHull3D.d.ts +37 -0
  240. package/dist/rendering/world3d/PhysicsHull3D.js +229 -0
  241. package/dist/rendering/world3d/PhysicsMesh3D.d.ts +41 -0
  242. package/dist/rendering/world3d/PhysicsMesh3D.js +340 -0
  243. package/dist/rendering/world3d/PhysicsQueries3D.d.ts +24 -0
  244. package/dist/rendering/world3d/PhysicsQueries3D.js +323 -0
  245. package/dist/rendering/world3d/PhysicsRemote3D.d.ts +179 -0
  246. package/dist/rendering/world3d/PhysicsRemote3D.js +536 -0
  247. package/dist/rendering/world3d/Ragdoll3D.d.ts +74 -0
  248. package/dist/rendering/world3d/Ragdoll3D.js +202 -0
  249. package/dist/rendering/world3d/Raycast3D.d.ts +40 -0
  250. package/dist/rendering/world3d/Raycast3D.js +247 -0
  251. package/dist/rendering/world3d/RenderList3D.d.ts +91 -0
  252. package/dist/rendering/world3d/RenderList3D.js +502 -0
  253. package/dist/rendering/world3d/Retarget3D.d.ts +21 -0
  254. package/dist/rendering/world3d/Retarget3D.js +185 -0
  255. package/dist/rendering/world3d/Rig3D.d.ts +57 -0
  256. package/dist/rendering/world3d/Rig3D.js +219 -0
  257. package/dist/rendering/world3d/Sdf3D.d.ts +181 -0
  258. package/dist/rendering/world3d/Sdf3D.js +1136 -0
  259. package/dist/rendering/world3d/SdfLod3D.d.ts +17 -0
  260. package/dist/rendering/world3d/SdfLod3D.js +56 -0
  261. package/dist/rendering/world3d/Serialize3D.d.ts +66 -0
  262. package/dist/rendering/world3d/Serialize3D.js +629 -0
  263. package/dist/rendering/world3d/Simplify3D.d.ts +29 -0
  264. package/dist/rendering/world3d/Simplify3D.js +426 -0
  265. package/dist/rendering/world3d/StateMachine3D.d.ts +87 -0
  266. package/dist/rendering/world3d/StateMachine3D.js +280 -0
  267. package/dist/rendering/world3d/SurfaceMaterial3D.d.ts +26 -0
  268. package/dist/rendering/world3d/SurfaceMaterial3D.js +138 -0
  269. package/dist/rendering/world3d/Terrain3D.d.ts +248 -0
  270. package/dist/rendering/world3d/Terrain3D.js +827 -0
  271. package/dist/rendering/world3d/Text3D.d.ts +95 -0
  272. package/dist/rendering/world3d/Text3D.js +560 -0
  273. package/dist/rendering/world3d/Texture3D.d.ts +148 -0
  274. package/dist/rendering/world3d/Texture3D.js +270 -0
  275. package/dist/rendering/world3d/Trail3D.d.ts +62 -0
  276. package/dist/rendering/world3d/Trail3D.js +195 -0
  277. package/dist/rendering/world3d/Vehicle3D.d.ts +102 -0
  278. package/dist/rendering/world3d/Vehicle3D.js +228 -0
  279. package/dist/rendering/world3d/VolumetricFog3D.d.ts +57 -0
  280. package/dist/rendering/world3d/VolumetricFog3D.js +230 -0
  281. package/dist/rendering/world3d/Water3D.d.ts +165 -0
  282. package/dist/rendering/world3d/Water3D.js +607 -0
  283. package/dist/rendering/world3d/core3D.d.ts +36 -0
  284. package/dist/rendering/world3d/core3D.js +99 -0
  285. package/dist/rendering/world3d/debug3D.d.ts +69 -0
  286. package/dist/rendering/world3d/debug3D.js +262 -0
  287. package/dist/rendering/world3d/decoders3D.d.ts +42 -0
  288. package/dist/rendering/world3d/decoders3D.js +133 -0
  289. package/dist/rendering/world3d/geometries3D.d.ts +111 -0
  290. package/dist/rendering/world3d/geometries3D.js +610 -0
  291. package/dist/rendering/world3d/helpers3D.d.ts +67 -0
  292. package/dist/rendering/world3d/helpers3D.js +178 -0
  293. package/dist/rendering/world3d/index.d.ts +103 -0
  294. package/dist/rendering/world3d/index.js +62 -0
  295. package/dist/rendering/world3d/math3D.d.ts +114 -0
  296. package/dist/rendering/world3d/math3D.js +675 -0
  297. package/dist/rendering/world3d/primitives3D.d.ts +67 -0
  298. package/dist/rendering/world3d/primitives3D.js +197 -0
  299. package/dist/resources.d.ts +8 -0
  300. package/dist/resources.js +6 -0
  301. package/dist/saveStore.d.ts +71 -0
  302. package/dist/saveStore.js +182 -0
  303. package/dist/semanticList.d.ts +126 -0
  304. package/dist/semanticList.js +175 -0
  305. package/dist/semanticTree.d.ts +10 -0
  306. package/dist/semanticTree.js +539 -0
  307. package/dist/semanticTypes.d.ts +175 -0
  308. package/dist/semanticTypes.js +2 -0
  309. package/dist/semantics.d.ts +6 -0
  310. package/dist/semantics.js +5 -0
  311. package/dist/sequencePlayback.d.ts +19 -0
  312. package/dist/sequencePlayback.js +391 -0
  313. package/dist/sequencePlaybackTypes.d.ts +24 -0
  314. package/dist/sequencePlaybackTypes.js +2 -0
  315. package/dist/sequenceTargetClaims.d.ts +10 -0
  316. package/dist/sequenceTargetClaims.js +31 -0
  317. package/dist/srgbBytes.d.ts +3 -0
  318. package/dist/srgbBytes.js +64 -0
  319. package/dist/startEngine.d.ts +5 -0
  320. package/dist/startEngine.js +31 -0
  321. package/dist/surfaceOwnership.d.ts +3 -0
  322. package/dist/surfaceOwnership.js +15 -0
  323. package/dist/text.d.ts +24 -0
  324. package/dist/text.js +4 -0
  325. package/dist/textField.d.ts +6 -0
  326. package/dist/textField.js +6 -0
  327. package/dist/textTable.d.ts +41 -0
  328. package/dist/textTable.js +114 -0
  329. package/dist/tileMapDraw.d.ts +7 -0
  330. package/dist/tileMapDraw.js +310 -0
  331. package/dist/tiledImport.d.ts +9 -0
  332. package/dist/tiledImport.js +357 -0
  333. package/dist/tilemap.d.ts +5 -0
  334. package/dist/tilemap.js +5 -0
  335. package/dist/tilemapTypes.d.ts +182 -0
  336. package/dist/tilemapTypes.js +2 -0
  337. package/dist/timer.d.ts +34 -0
  338. package/dist/timer.js +119 -0
  339. package/dist/tween.d.ts +15 -0
  340. package/dist/tween.js +329 -0
  341. package/dist/tweenTypes.d.ts +31 -0
  342. package/dist/tweenTypes.js +2 -0
  343. package/dist/ui/controlKeys.d.ts +113 -0
  344. package/dist/ui/controlKeys.js +250 -0
  345. package/dist/ui/controls.d.ts +58 -0
  346. package/dist/ui/controls.js +290 -0
  347. package/dist/ui/editing.d.ts +3 -0
  348. package/dist/ui/editing.js +3 -0
  349. package/dist/ui/index.d.ts +19 -0
  350. package/dist/ui/index.js +11 -0
  351. package/dist/ui/keyboardFocus.d.ts +32 -0
  352. package/dist/ui/keyboardFocus.js +146 -0
  353. package/dist/ui/layerTypes.d.ts +98 -0
  354. package/dist/ui/layerTypes.js +2 -0
  355. package/dist/ui/layers.d.ts +4 -0
  356. package/dist/ui/layers.js +586 -0
  357. package/dist/ui/leafContent.d.ts +21 -0
  358. package/dist/ui/leafContent.js +136 -0
  359. package/dist/ui/rangeControl.d.ts +53 -0
  360. package/dist/ui/rangeControl.js +168 -0
  361. package/dist/ui/scrollControl.d.ts +84 -0
  362. package/dist/ui/scrollControl.js +222 -0
  363. package/dist/ui/stateControls.d.ts +90 -0
  364. package/dist/ui/stateControls.js +331 -0
  365. package/dist/ui/textEditor.d.ts +54 -0
  366. package/dist/ui/textEditor.js +371 -0
  367. package/dist/ui/textEditorTypes.d.ts +85 -0
  368. package/dist/ui/textEditorTypes.js +2 -0
  369. package/dist/ui/textFieldControl.d.ts +100 -0
  370. package/dist/ui/textFieldControl.js +260 -0
  371. package/dist/ui/theme.d.ts +64 -0
  372. package/dist/ui/theme.js +166 -0
  373. package/dist/ui/types.d.ts +285 -0
  374. package/dist/ui/types.js +2 -0
  375. package/dist/ui/uiRoot.d.ts +4 -0
  376. package/dist/ui/uiRoot.js +1526 -0
  377. package/dist/ui/uiRootDisplay.d.ts +46 -0
  378. package/dist/ui/uiRootDisplay.js +148 -0
  379. package/dist/ui/uiRootModel.d.ts +114 -0
  380. package/dist/ui/uiRootModel.js +66 -0
  381. package/dist/ui/virtualList.d.ts +20 -0
  382. package/dist/ui/virtualList.js +105 -0
  383. package/dist/video.d.ts +4 -0
  384. package/dist/video.js +4 -0
  385. package/dist/videoPlayer.d.ts +4 -0
  386. package/dist/videoPlayer.js +215 -0
  387. package/dist/videoTypes.d.ts +77 -0
  388. package/dist/videoTypes.js +2 -0
  389. package/dist/web/BrowserAssetBundle.d.ts +41 -0
  390. package/dist/web/BrowserAssetBundle.js +136 -0
  391. package/dist/web/BrowserAudio.d.ts +74 -0
  392. package/dist/web/BrowserAudio.js +503 -0
  393. package/dist/web/BrowserFrameLoop.d.ts +69 -0
  394. package/dist/web/BrowserFrameLoop.js +125 -0
  395. package/dist/web/BrowserGame.d.ts +174 -0
  396. package/dist/web/BrowserGame.js +473 -0
  397. package/dist/web/BrowserGamepadInput.d.ts +38 -0
  398. package/dist/web/BrowserGamepadInput.js +134 -0
  399. package/dist/web/BrowserHoverInput.d.ts +25 -0
  400. package/dist/web/BrowserHoverInput.js +266 -0
  401. package/dist/web/BrowserImageTextures.d.ts +72 -0
  402. package/dist/web/BrowserImageTextures.js +169 -0
  403. package/dist/web/BrowserInputActions.d.ts +63 -0
  404. package/dist/web/BrowserInputActions.js +345 -0
  405. package/dist/web/BrowserKeyboardInput.d.ts +4 -0
  406. package/dist/web/BrowserKeyboardInput.js +223 -0
  407. package/dist/web/BrowserPlay.d.ts +417 -0
  408. package/dist/web/BrowserPlay.js +1648 -0
  409. package/dist/web/BrowserPointerInput.d.ts +4 -0
  410. package/dist/web/BrowserPointerInput.js +511 -0
  411. package/dist/web/BrowserPreferences.d.ts +10 -0
  412. package/dist/web/BrowserPreferences.js +39 -0
  413. package/dist/web/BrowserSemantics.d.ts +36 -0
  414. package/dist/web/BrowserSemantics.js +418 -0
  415. package/dist/web/BrowserStatsPanel.d.ts +56 -0
  416. package/dist/web/BrowserStatsPanel.js +143 -0
  417. package/dist/web/BrowserStorage.d.ts +35 -0
  418. package/dist/web/BrowserStorage.js +132 -0
  419. package/dist/web/BrowserTextEditor.d.ts +52 -0
  420. package/dist/web/BrowserTextEditor.js +839 -0
  421. package/dist/web/BrowserTextInput.d.ts +89 -0
  422. package/dist/web/BrowserTextInput.js +524 -0
  423. package/dist/web/BrowserTextureProvider.d.ts +58 -0
  424. package/dist/web/BrowserTextureProvider.js +935 -0
  425. package/dist/web/BrowserVideo.d.ts +40 -0
  426. package/dist/web/BrowserVideo.js +237 -0
  427. package/dist/web/CanvasKitFontSetProvider.d.ts +32 -0
  428. package/dist/web/CanvasKitFontSetProvider.js +215 -0
  429. package/dist/web/CanvasKitParagraphProvider.d.ts +173 -0
  430. package/dist/web/CanvasKitParagraphProvider.js +692 -0
  431. package/dist/web/CanvasTextRasterProvider.d.ts +4 -0
  432. package/dist/web/CanvasTextRasterProvider.js +312 -0
  433. package/dist/web/ManifestByteSource.d.ts +151 -0
  434. package/dist/web/ManifestByteSource.js +975 -0
  435. package/dist/web/ManifestFontContentLoader.d.ts +13 -0
  436. package/dist/web/ManifestFontContentLoader.js +30 -0
  437. package/dist/web/MouseInput.d.ts +4 -0
  438. package/dist/web/MouseInput.js +218 -0
  439. package/dist/web/WebGL2Host.d.ts +5 -0
  440. package/dist/web/WebGL2Host.js +2711 -0
  441. package/dist/web/WebGPUHost.d.ts +100 -0
  442. package/dist/web/WebGPUHost.js +3430 -0
  443. package/dist/web/audio.d.ts +3 -0
  444. package/dist/web/audio.js +4 -0
  445. package/dist/web/canvasKitParagraphGeometry.d.ts +27 -0
  446. package/dist/web/canvasKitParagraphGeometry.js +83 -0
  447. package/dist/web/editing.d.ts +5 -0
  448. package/dist/web/editing.js +4 -0
  449. package/dist/web/editorFonts.d.ts +54 -0
  450. package/dist/web/editorFonts.js +297 -0
  451. package/dist/web/game.d.ts +5 -0
  452. package/dist/web/game.js +6 -0
  453. package/dist/web/gamepad.d.ts +3 -0
  454. package/dist/web/gamepad.js +4 -0
  455. package/dist/web/hover.d.ts +3 -0
  456. package/dist/web/hover.js +4 -0
  457. package/dist/web/image.d.ts +4 -0
  458. package/dist/web/image.js +4 -0
  459. package/dist/web/imageProjections2D.d.ts +16 -0
  460. package/dist/web/imageProjections2D.js +2 -0
  461. package/dist/web/input.d.ts +6 -0
  462. package/dist/web/input.js +4 -0
  463. package/dist/web/keyboard.d.ts +3 -0
  464. package/dist/web/keyboard.js +3 -0
  465. package/dist/web/kit.d.ts +11 -0
  466. package/dist/web/kit.js +8 -0
  467. package/dist/web/loop.d.ts +3 -0
  468. package/dist/web/loop.js +4 -0
  469. package/dist/web/paragraph.d.ts +6 -0
  470. package/dist/web/paragraph.js +4 -0
  471. package/dist/web/play.d.ts +10 -0
  472. package/dist/web/play.js +9 -0
  473. package/dist/web/playMusic.d.ts +33 -0
  474. package/dist/web/playMusic.js +194 -0
  475. package/dist/web/playSfx.d.ts +36 -0
  476. package/dist/web/playSfx.js +112 -0
  477. package/dist/web/playTouch.d.ts +45 -0
  478. package/dist/web/playTouch.js +141 -0
  479. package/dist/web/playWidgets.d.ts +71 -0
  480. package/dist/web/playWidgets.js +431 -0
  481. package/dist/web/pointer.d.ts +3 -0
  482. package/dist/web/pointer.js +3 -0
  483. package/dist/web/prepareSharedSubmission2D.d.ts +27 -0
  484. package/dist/web/prepareSharedSubmission2D.js +63 -0
  485. package/dist/web/resources.d.ts +29 -0
  486. package/dist/web/resources.js +96 -0
  487. package/dist/web/semantics.d.ts +3 -0
  488. package/dist/web/semantics.js +4 -0
  489. package/dist/web/sharedDeviceSession.d.ts +64 -0
  490. package/dist/web/sharedDeviceSession.js +2 -0
  491. package/dist/web/sharedEffectShaders.d.ts +13 -0
  492. package/dist/web/sharedEffectShaders.js +181 -0
  493. package/dist/web/sharedFrameUpload.d.ts +25 -0
  494. package/dist/web/sharedFrameUpload.js +2 -0
  495. package/dist/web/sharedHostDeferred.d.ts +7 -0
  496. package/dist/web/sharedHostDeferred.js +12 -0
  497. package/dist/web/sharedRetentionLedger.d.ts +85 -0
  498. package/dist/web/sharedRetentionLedger.js +391 -0
  499. package/dist/web/sharedSubmissionStorage2D.d.ts +56 -0
  500. package/dist/web/sharedSubmissionStorage2D.js +73 -0
  501. package/dist/web/sharedWebGL2Arena.d.ts +40 -0
  502. package/dist/web/sharedWebGL2Arena.js +77 -0
  503. package/dist/web/sharedWebGL2Options.d.ts +33 -0
  504. package/dist/web/sharedWebGL2Options.js +102 -0
  505. package/dist/web/sharedWebGL2Shaders.d.ts +33 -0
  506. package/dist/web/sharedWebGL2Shaders.js +408 -0
  507. package/dist/web/sharedWebGPUOptions.d.ts +41 -0
  508. package/dist/web/sharedWebGPUOptions.js +130 -0
  509. package/dist/web/text.d.ts +3 -0
  510. package/dist/web/text.js +3 -0
  511. package/dist/web/textInput.d.ts +3 -0
  512. package/dist/web/textInput.js +3 -0
  513. package/dist/web/video.d.ts +3 -0
  514. package/dist/web/video.js +4 -0
  515. package/dist/web/webgl2.d.ts +7 -0
  516. package/dist/web/webgl2.js +4 -0
  517. package/dist/web/webgl2LayerState.d.ts +50 -0
  518. package/dist/web/webgl2LayerState.js +102 -0
  519. package/dist/web/webgl2Native.d.ts +72 -0
  520. package/dist/web/webgl2Native.js +572 -0
  521. package/dist/web/webgl2Types.d.ts +150 -0
  522. package/dist/web/webgl2Types.js +2 -0
  523. package/dist/web/webgpu.d.ts +6 -0
  524. package/dist/web/webgpu.js +2 -0
  525. package/dist/web/webgpuBindingCache.d.ts +26 -0
  526. package/dist/web/webgpuBindingCache.js +223 -0
  527. package/dist/web/webgpuBufferPool.d.ts +51 -0
  528. package/dist/web/webgpuBufferPool.js +58 -0
  529. package/dist/web/webgpuImageResidency.d.ts +56 -0
  530. package/dist/web/webgpuImageResidency.js +65 -0
  531. package/dist/web/webgpuLifetime.d.ts +45 -0
  532. package/dist/web/webgpuLifetime.js +64 -0
  533. package/dist/web/webgpuRetentionPool.d.ts +66 -0
  534. package/dist/web/webgpuRetentionPool.js +85 -0
  535. package/dist/web/webgpuSharedPass.d.ts +7 -0
  536. package/dist/web/webgpuSharedPass.js +293 -0
  537. package/dist/web/webgpuSharedResolvePass.d.ts +3 -0
  538. package/dist/web/webgpuSharedResolvePass.js +34 -0
  539. package/dist/web/world3d/Audio3D.d.ts +85 -0
  540. package/dist/web/world3d/Audio3D.js +271 -0
  541. package/dist/web/world3d/BrowserPlay3D.d.ts +295 -0
  542. package/dist/web/world3d/BrowserPlay3D.js +1256 -0
  543. package/dist/web/world3d/FlyControls3D.d.ts +59 -0
  544. package/dist/web/world3d/FlyControls3D.js +162 -0
  545. package/dist/web/world3d/FollowControls3D.d.ts +31 -0
  546. package/dist/web/world3d/FollowControls3D.js +119 -0
  547. package/dist/web/world3d/OrbitControls3D.d.ts +58 -0
  548. package/dist/web/world3d/OrbitControls3D.js +189 -0
  549. package/dist/web/world3d/TransformControls3D.d.ts +37 -0
  550. package/dist/web/world3d/TransformControls3D.js +128 -0
  551. package/dist/web/world3d/WebGL2Renderer3D.d.ts +136 -0
  552. package/dist/web/world3d/WebGL2Renderer3D.js +1175 -0
  553. package/dist/web/world3d/WebGPURenderer3D.d.ts +112 -0
  554. package/dist/web/world3d/WebGPURenderer3D.js +1916 -0
  555. package/dist/web/world3d/World3DView.d.ts +54 -0
  556. package/dist/web/world3d/World3DView.js +79 -0
  557. package/dist/web/world3d/app3D.d.ts +143 -0
  558. package/dist/web/world3d/app3D.js +305 -0
  559. package/dist/web/world3d/assets3D.d.ts +39 -0
  560. package/dist/web/world3d/assets3D.js +112 -0
  561. package/dist/web/world3d/atmosphere3D.d.ts +56 -0
  562. package/dist/web/world3d/atmosphere3D.js +193 -0
  563. package/dist/web/world3d/canvasFont3D.d.ts +21 -0
  564. package/dist/web/world3d/canvasFont3D.js +165 -0
  565. package/dist/web/world3d/frame3D.d.ts +144 -0
  566. package/dist/web/world3d/frame3D.js +388 -0
  567. package/dist/web/world3d/gpuResources3D.d.ts +98 -0
  568. package/dist/web/world3d/gpuResources3D.js +901 -0
  569. package/dist/web/world3d/host3D.d.ts +24 -0
  570. package/dist/web/world3d/host3D.js +61 -0
  571. package/dist/web/world3d/index.d.ts +40 -0
  572. package/dist/web/world3d/index.js +24 -0
  573. package/dist/web/world3d/loaders3D.d.ts +27 -0
  574. package/dist/web/world3d/loaders3D.js +138 -0
  575. package/dist/web/world3d/markers3D.d.ts +53 -0
  576. package/dist/web/world3d/markers3D.js +130 -0
  577. package/dist/web/world3d/materialWebGL23D.d.ts +34 -0
  578. package/dist/web/world3d/materialWebGL23D.js +218 -0
  579. package/dist/web/world3d/overlay3D.d.ts +47 -0
  580. package/dist/web/world3d/overlay3D.js +187 -0
  581. package/dist/web/world3d/post3D.d.ts +116 -0
  582. package/dist/web/world3d/post3D.js +462 -0
  583. package/dist/web/world3d/postWebGL23D.d.ts +24 -0
  584. package/dist/web/world3d/postWebGL23D.js +237 -0
  585. package/dist/web/world3d/postWebGPU3D.d.ts +23 -0
  586. package/dist/web/world3d/postWebGPU3D.js +255 -0
  587. package/dist/web/world3d/probe3D.d.ts +15 -0
  588. package/dist/web/world3d/probe3D.js +66 -0
  589. package/dist/web/world3d/shaders3D.d.ts +43 -0
  590. package/dist/web/world3d/shaders3D.js +851 -0
  591. package/dist/web/world3d/stats3D.d.ts +34 -0
  592. package/dist/web/world3d/stats3D.js +81 -0
  593. package/dist/web/world3d/webGL2FrameMetrics3D.d.ts +71 -0
  594. package/dist/web/world3d/webGL2FrameMetrics3D.js +185 -0
  595. package/dist/web/world3d/webgpu.d.ts +37 -0
  596. package/dist/web/world3d/webgpu.js +23 -0
  597. package/dist/web/world3d/webgpuPacking3D.d.ts +13 -0
  598. package/dist/web/world3d/webgpuPacking3D.js +85 -0
  599. package/dist/web/world3d/wgsl3D.d.ts +68 -0
  600. package/dist/web/world3d/wgsl3D.js +781 -0
  601. package/package.json +220 -4
@@ -0,0 +1,202 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // A ragdoll: rigid bodies and joints laid over a skeleton, built from the pose the
3
+ // character is in at the moment it goes limp, and written back to the bones after each
4
+ // physics step. DOM-free and backend-independent.
5
+ import { World3DError, requireFinite3D } from './core3D.js';
6
+ import { mat4Compose, mat4Decompose, mat4Invert, mat4Multiply, quatNormalize } from './math3D.js';
7
+ /** The most parts a ragdoll has. */
8
+ export const RAGDOLL3D_LIMITS = Object.freeze({ maxParts: 64 });
9
+ const world = new Float32Array(16), local = new Float32Array(16), inverse = new Float32Array(16);
10
+ const place = new Float32Array(3), turn = new Float32Array(4), size = new Float32Array(3);
11
+ /**
12
+ * Bodies and joints for a skeleton, created from the current pose by activate()
13
+ * and removed again by deactivate(). While active, call update() after each
14
+ * world.step() to move the bones with the bodies; bones that no part names
15
+ * keep whatever pose they had, carried along by their parents.
16
+ */
17
+ export class Ragdoll3D {
18
+ world;
19
+ root;
20
+ options;
21
+ /** One body per part while active, in the order the parts were given. */
22
+ bodies = [];
23
+ joints = [];
24
+ #parts;
25
+ #bones = [];
26
+ #scales = [];
27
+ constructor(physics, root, parts, options = {}) {
28
+ if (!physics || typeof physics.createBody !== 'function')
29
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'physics world');
30
+ if (!root || typeof root.traverse !== 'function')
31
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'ragdoll root');
32
+ if (!Array.isArray(parts) || parts.length === 0)
33
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'ragdoll parts');
34
+ if (parts.length > RAGDOLL3D_LIMITS.maxParts)
35
+ throw new World3DError('WORLD3D_BUDGET', 'ragdoll parts');
36
+ const named = new Map();
37
+ root.traverse(object => {
38
+ if (object.name && !named.has(object.name))
39
+ named.set(object.name, object);
40
+ });
41
+ let roots = 0;
42
+ for (const [index, part] of parts.entries()) {
43
+ const bone = typeof part?.bone === 'string' ? named.get(part.bone) : part?.bone;
44
+ if (!bone || typeof bone.updateWorldMatrix !== 'function')
45
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'ragdoll bone ' + index);
46
+ if (this.#bones.includes(bone))
47
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'a bone is named by two parts');
48
+ const kind = part.shape?.type;
49
+ if (kind !== 'sphere' && kind !== 'capsule' && kind !== 'box')
50
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'ragdoll shapes are spheres, capsules or boxes');
51
+ if (part.parent === undefined)
52
+ roots++;
53
+ else if (!Number.isInteger(part.parent) || part.parent < 0 || part.parent >= index)
54
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'a ragdoll parent comes before its children');
55
+ if (part.offset)
56
+ for (const value of part.offset)
57
+ requireFinite3D(value, 'ragdoll offset');
58
+ const joint = part.joint;
59
+ if (joint && joint.type !== undefined && joint.type !== 'point' && joint.type !== 'hinge')
60
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'ragdoll joint type');
61
+ this.#bones.push(bone);
62
+ }
63
+ if (roots !== 1)
64
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'a ragdoll has exactly one part without a parent');
65
+ this.world = physics;
66
+ this.root = root;
67
+ this.options = { ...options };
68
+ this.#parts = parts.map(part => ({ ...part }));
69
+ }
70
+ get active() {
71
+ return this.bodies.length > 0;
72
+ }
73
+ get bones() {
74
+ return this.#bones;
75
+ }
76
+ /**
77
+ * Go limp from the pose the skeleton is in now. `velocity` is the speed
78
+ * every part starts with, such as the character's own; `spin` adds a turn
79
+ * about the root part.
80
+ */
81
+ activate(velocity = [0, 0, 0], spin = [0, 0, 0]) {
82
+ if (this.active)
83
+ return;
84
+ const o = this.options;
85
+ this.root.updateWorldMatrix();
86
+ const bodies = [], joints = [], scales = [];
87
+ try {
88
+ for (const [index, part] of this.#parts.entries()) {
89
+ const bone = this.#bones[index];
90
+ bone.updateWorldMatrix();
91
+ const m = bone.matrixWorld, at = part.offset ?? [0, 0, 0], scale = new Float32Array(3);
92
+ mat4Decompose(m, place, turn, scale);
93
+ scales[index] = scale;
94
+ const body = this.world.createBody({
95
+ type: 'dynamic',
96
+ shape: part.shape,
97
+ mass: part.mass ?? 1,
98
+ position: [
99
+ m[0] * at[0] + m[4] * at[1] + m[8] * at[2] + m[12],
100
+ m[1] * at[0] + m[5] * at[1] + m[9] * at[2] + m[13],
101
+ m[2] * at[0] + m[6] * at[1] + m[10] * at[2] + m[14]
102
+ ],
103
+ quaternion: [turn[0], turn[1], turn[2], turn[3]],
104
+ friction: o.friction ?? 0.6,
105
+ restitution: o.restitution ?? 0,
106
+ linearDamping: o.linearDamping ?? 0.05,
107
+ angularDamping: o.angularDamping ?? 0.4,
108
+ ...(o.layer === undefined ? {} : { layer: o.layer }),
109
+ ...(o.mask === undefined ? {} : { mask: o.mask }),
110
+ userData: this
111
+ });
112
+ bodies.push(body);
113
+ body.setLinearVelocity(velocity[0], velocity[1], velocity[2]);
114
+ }
115
+ const rootBody = bodies[this.#parts.findIndex(part => part.parent === undefined)];
116
+ rootBody.setAngularVelocity(spin[0], spin[1], spin[2]);
117
+ for (const [index, part] of this.#parts.entries()) {
118
+ if (part.parent === undefined)
119
+ continue;
120
+ const bone = this.#bones[index], m = bone.matrixWorld, joint = part.joint ?? {}, axis = joint.axis ?? [0, 1, 0];
121
+ // The direction is given in the bone's frame; the joint wants it in the world.
122
+ const ax = m[0] * axis[0] + m[4] * axis[1] + m[8] * axis[2], ay = m[1] * axis[0] + m[5] * axis[1] + m[9] * axis[2], az = m[2] * axis[0] + m[6] * axis[1] + m[10] * axis[2];
123
+ const options = {
124
+ type: joint.type ?? 'point',
125
+ bodyA: bodies[index],
126
+ bodyB: bodies[part.parent],
127
+ anchor: [m[12], m[13], m[14]],
128
+ axis: [ax, ay, az],
129
+ ...(joint.limits && joint.type === 'hinge' ? { limits: joint.limits } : {}),
130
+ ...(joint.coneLimit !== undefined && joint.type !== 'hinge' ? { coneLimit: joint.coneLimit } : {})
131
+ };
132
+ joints.push(this.world.createJoint(options));
133
+ }
134
+ }
135
+ catch (error) {
136
+ // Only objects from this activation are rolled back. Keep the original refusal.
137
+ for (const joint of joints)
138
+ this.world.removeJoint(joint);
139
+ for (const body of bodies)
140
+ this.world.removeBody(body);
141
+ throw error;
142
+ }
143
+ this.bodies.push(...bodies);
144
+ this.joints.push(...joints);
145
+ this.#scales.push(...scales);
146
+ }
147
+ /** Remove the bodies and joints; the bones stay where the bodies left them. */
148
+ deactivate() {
149
+ for (const joint of this.joints)
150
+ this.world.removeJoint(joint);
151
+ for (const body of this.bodies)
152
+ this.world.removeBody(body);
153
+ this.joints.length = 0;
154
+ this.bodies.length = 0;
155
+ this.#scales.length = 0;
156
+ }
157
+ /** Move each bone to its body. Call after world.step() while active. */
158
+ update() {
159
+ if (!this.active)
160
+ return;
161
+ for (const [index, part] of this.#parts.entries()) {
162
+ const bone = this.#bones[index], body = this.bodies[index], at = part.offset ?? [0, 0, 0], scale = this.#scales[index];
163
+ turn[0] = body.quaternion[0];
164
+ turn[1] = body.quaternion[1];
165
+ turn[2] = body.quaternion[2];
166
+ turn[3] = body.quaternion[3];
167
+ quatNormalize(turn, turn);
168
+ // The bone's origin lies back from the body's center by the offset.
169
+ place[0] = place[1] = place[2] = 0;
170
+ mat4Compose(world, place, turn, scale);
171
+ place[0] = body.position[0] - (world[0] * at[0] + world[4] * at[1] + world[8] * at[2]);
172
+ place[1] = body.position[1] - (world[1] * at[0] + world[5] * at[1] + world[9] * at[2]);
173
+ place[2] = body.position[2] - (world[2] * at[0] + world[6] * at[1] + world[10] * at[2]);
174
+ world[12] = place[0];
175
+ world[13] = place[1];
176
+ world[14] = place[2];
177
+ const parent = bone.parent;
178
+ if (parent) {
179
+ // Parents were written first, so their world matrices are already the new ones.
180
+ parent.updateWorldMatrix();
181
+ if (!mat4Invert(inverse, parent.matrixWorld))
182
+ continue;
183
+ mat4Multiply(local, inverse, world);
184
+ mat4Decompose(local, place, turn, size);
185
+ }
186
+ else
187
+ mat4Decompose(world, place, turn, size);
188
+ bone.position.set(place);
189
+ bone.quaternion.set(turn);
190
+ bone.scale.set(size);
191
+ bone.markTransformDirty();
192
+ }
193
+ }
194
+ dispose() {
195
+ this.deactivate();
196
+ }
197
+ }
198
+ /** Makes a ragdoll of physics bodies that a skeleton follows. */
199
+ export function createRagdoll3D(world, root, parts, options = {}) {
200
+ return new Ragdoll3D(world, root, parts, options);
201
+ }
202
+ //# sourceMappingURL=Ragdoll3D.js.map
@@ -0,0 +1,40 @@
1
+ import type { Camera3D } from './Camera3D.js';
2
+ import { Mesh3D } from './Mesh3D.js';
3
+ import type { Object3D } from './Object3D.js';
4
+ /** What a ray hit: how far, where, the object, its face, its texture coordinate and its instance. */
5
+ export interface RaycastHit3D {
6
+ /** Distance from the ray origin in world units. */
7
+ readonly distance: number;
8
+ /** World-space hit position. */
9
+ readonly point: readonly [number, number, number];
10
+ readonly object: Mesh3D;
11
+ /** Index of the hit triangle within the geometry. */
12
+ readonly faceIndex: number;
13
+ /** Interpolated texture coordinates when the geometry has a `uv` attribute. */
14
+ readonly uv: readonly [number, number] | undefined;
15
+ /** Instance index for instanced meshes. */
16
+ readonly instanceId: number | undefined;
17
+ }
18
+ /** How a ray is cast: its near and far distances, its layers, and whether only the first hit is wanted. */
19
+ export interface RaycastOptions3D {
20
+ readonly near?: number;
21
+ readonly far?: number;
22
+ /** Only objects whose layers intersect this mask are tested. */
23
+ readonly layerMask?: number;
24
+ /** Stop at the first hit per mesh and skip sorting of further triangles. */
25
+ readonly firstHitOnly?: boolean;
26
+ }
27
+ /** Casts rays through a scene, from a point or from the camera through a screen point. */
28
+ export declare class Raycaster3D {
29
+ readonly origin: Float32Array<ArrayBuffer>;
30
+ readonly direction: Float32Array<ArrayBuffer>;
31
+ /** Set a world-space ray; the direction is normalized. */
32
+ set(origin: ArrayLike<number>, direction: ArrayLike<number>): this;
33
+ /** Ray through normalized device coordinates (x, y in [-1, 1], y up). */
34
+ setFromCamera(ndcX: number, ndcY: number, camera: Camera3D): this;
35
+ /** Intersect the subtree under `root`. World matrices are refreshed first. */
36
+ intersect(root: Object3D, options?: RaycastOptions3D): RaycastHit3D[];
37
+ private intersectMesh;
38
+ private intersectTriangles;
39
+ }
40
+ //# sourceMappingURL=Raycast3D.d.ts.map
@@ -0,0 +1,247 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // CPU ray picking against mesh triangles. Skinned and morphed meshes are
3
+ // tested in their rest shape; sprites are tested as their camera-facing quad
4
+ // bounds. Results are sorted nearest first.
5
+ import { World3DError, requireFinite3D } from './core3D.js';
6
+ import { mat4Invert, mat4Multiply, rayIntersectBox, rayIntersectSphere, rayIntersectTriangle, vec3Normalize, vec3TransformDirection, vec3TransformMat4 } from './math3D.js';
7
+ import { InstancedMesh3D, Mesh3D } from './Mesh3D.js';
8
+ const inverse = new Float32Array(16), instanceWorld = new Float32Array(16);
9
+ const localOrigin = new Float32Array(3), localDirection = new Float32Array(3);
10
+ const hit = new Float32Array(3), worldPoint = new Float32Array(3);
11
+ /** Casts rays through a scene, from a point or from the camera through a screen point. */
12
+ export class Raycaster3D {
13
+ origin = new Float32Array(3);
14
+ direction = new Float32Array([0, 0, -1]);
15
+ /** Set a world-space ray; the direction is normalized. */
16
+ set(origin, direction) {
17
+ for (let i = 0; i < 3; i++) {
18
+ this.origin[i] = requireFinite3D(origin[i], 'ray origin');
19
+ this.direction[i] = requireFinite3D(direction[i], 'ray direction');
20
+ }
21
+ vec3Normalize(this.direction, this.direction);
22
+ if (this.direction[0] === 0 && this.direction[1] === 0 && this.direction[2] === 0)
23
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'ray direction');
24
+ return this;
25
+ }
26
+ /** Ray through normalized device coordinates (x, y in [-1, 1], y up). */
27
+ setFromCamera(ndcX, ndcY, camera) {
28
+ camera.updateViewMatrices();
29
+ camera.screenPointToRay(requireFinite3D(ndcX, 'ndcX'), requireFinite3D(ndcY, 'ndcY'), this.origin, this.direction);
30
+ return this;
31
+ }
32
+ /** Intersect the subtree under `root`. World matrices are refreshed first. */
33
+ intersect(root, options = {}) {
34
+ const near = options.near ?? 0, far = options.far ?? Infinity, mask = options.layerMask ?? 0xffffffff;
35
+ const hits = [];
36
+ root.updateWorldMatrix();
37
+ root.updateWorldMatrices();
38
+ root.traverse(object => {
39
+ if (!object.visible)
40
+ return false;
41
+ if (object instanceof Mesh3D && object.pickable && (object.layers & mask) !== 0)
42
+ this.intersectMesh(object, near, far, options.firstHitOnly === true, hits);
43
+ return true;
44
+ });
45
+ return hits.sort((a, b) => a.distance - b.distance);
46
+ }
47
+ intersectMesh(mesh, near, far, firstOnly, hits) {
48
+ const geometry = mesh.geometry;
49
+ if (geometry.topology !== 'triangles' || !geometry.getAttribute('position'))
50
+ return;
51
+ if (rayIntersectSphere(this.origin, this.direction, mesh.worldBoundingSphere) < 0)
52
+ return;
53
+ if (mesh instanceof InstancedMesh3D) {
54
+ for (let i = 0; i < mesh.count; i++) {
55
+ mat4Multiply(instanceWorld, mesh.matrixWorld, mesh.instanceMatrices.subarray(i * 16, i * 16 + 16));
56
+ this.intersectTriangles(mesh, instanceWorld, i, near, far, firstOnly, hits);
57
+ }
58
+ }
59
+ else
60
+ this.intersectTriangles(mesh, mesh.matrixWorld, undefined, near, far, firstOnly, hits);
61
+ }
62
+ intersectTriangles(mesh, world, instanceId, near, far, firstOnly, hits) {
63
+ if (!mat4Invert(inverse, world))
64
+ return;
65
+ // Work in local space so vertices need no transformation.
66
+ vec3TransformMat4(localOrigin, this.origin, inverse);
67
+ vec3TransformDirection(localDirection, this.direction, inverse);
68
+ const scale = Math.hypot(localDirection[0], localDirection[1], localDirection[2]);
69
+ if (scale === 0)
70
+ return;
71
+ vec3Normalize(localDirection, localDirection);
72
+ const geometry = mesh.geometry;
73
+ if (rayIntersectBox(localOrigin, localDirection, geometry.boundingBox) < 0)
74
+ return;
75
+ const positions = geometry.getAttribute('position').data, index = geometry.index?.data, uvs = geometry.getAttribute('uv')?.data;
76
+ const count = (index ? index.length : positions.length / 3) / 3;
77
+ const material = mesh.materialAt(0), cull = material.side === 'front' && mat4DeterminantSign(world) > 0;
78
+ let best;
79
+ const test = (face) => {
80
+ const a = index ? index[face * 3] : face * 3, b = index ? index[face * 3 + 1] : face * 3 + 1, c = index ? index[face * 3 + 2] : face * 3 + 2;
81
+ if (!rayIntersectTriangle(hit, localOrigin, localDirection, positions, a * 3, b * 3, c * 3, cull))
82
+ return;
83
+ // Convert the local hit distance back to world units.
84
+ const distance = hit[0] / scale;
85
+ if (distance < near || distance > far)
86
+ return;
87
+ if (firstOnly && best && best.distance <= distance)
88
+ return;
89
+ worldPoint[0] = this.origin[0] + this.direction[0] * distance;
90
+ worldPoint[1] = this.origin[1] + this.direction[1] * distance;
91
+ worldPoint[2] = this.origin[2] + this.direction[2] * distance;
92
+ const u = hit[1], v = hit[2], w = 1 - u - v;
93
+ const record = {
94
+ distance,
95
+ point: [worldPoint[0], worldPoint[1], worldPoint[2]],
96
+ object: mesh,
97
+ faceIndex: face,
98
+ instanceId,
99
+ uv: uvs
100
+ ? [
101
+ uvs[a * 2] * w + uvs[b * 2] * u + uvs[c * 2] * v,
102
+ uvs[a * 2 + 1] * w + uvs[b * 2 + 1] * u + uvs[c * 2 + 1] * v
103
+ ]
104
+ : undefined
105
+ };
106
+ if (firstOnly)
107
+ best = record;
108
+ else
109
+ hits.push(record);
110
+ };
111
+ // Dense geometry is searched through a hierarchy of boxes, built once and kept until the geometry changes.
112
+ const tree = count >= PICK_TREE_MINIMUM ? pickTree(geometry, count) : undefined;
113
+ if (tree) {
114
+ const first = hits.length, bounds = tree.bounds, stack = pickStack, ox = localOrigin[0], oy = localOrigin[1], oz = localOrigin[2];
115
+ // A ray along an axis gets a huge, finite reciprocal there instead of an infinite one.
116
+ const safe = (d) => 1 / (Math.abs(d) < 1e-30 ? 1e-30 : d);
117
+ const ix = safe(localDirection[0]), iy = safe(localDirection[1]), iz = safe(localDirection[2]);
118
+ let top = 0;
119
+ stack[top++] = 0;
120
+ while (top > 0) {
121
+ const node = stack[--top], at = node * 6;
122
+ // Slab test; a box the ray misses, or that lies wholly behind it, is skipped with everything in it.
123
+ let t0 = (bounds[at] - ox) * ix, t1 = (bounds[at + 3] - ox) * ix, low = Math.min(t0, t1), high = Math.max(t0, t1);
124
+ t0 = (bounds[at + 1] - oy) * iy;
125
+ t1 = (bounds[at + 4] - oy) * iy;
126
+ low = Math.max(low, Math.min(t0, t1));
127
+ high = Math.min(high, Math.max(t0, t1));
128
+ t0 = (bounds[at + 2] - oz) * iz;
129
+ t1 = (bounds[at + 5] - oz) * iz;
130
+ low = Math.max(low, Math.min(t0, t1));
131
+ high = Math.min(high, Math.max(t0, t1));
132
+ if (!(high >= Math.max(low, 0)))
133
+ continue;
134
+ const child = tree.left[node];
135
+ if (child >= 0) {
136
+ if (top < pickStack.length - 1) {
137
+ stack[top++] = child;
138
+ stack[top++] = child + 1;
139
+ }
140
+ continue;
141
+ }
142
+ for (let i = tree.start[node], end = i + tree.count[node]; i < end; i++)
143
+ test(tree.faces[i]);
144
+ }
145
+ // Faces come out in tree order; callers were promised face order among equal distances.
146
+ if (!firstOnly && hits.length - first > 1) {
147
+ const found = hits.splice(first).sort((p, q) => p.faceIndex - q.faceIndex);
148
+ for (const record of found)
149
+ hits.push(record);
150
+ }
151
+ }
152
+ else
153
+ for (let face = 0; face < count; face++)
154
+ test(face);
155
+ if (firstOnly && best)
156
+ hits.push(best);
157
+ }
158
+ }
159
+ function mat4DeterminantSign(m) {
160
+ // Sign of the upper 3x3 determinant: negative means a mirrored transform.
161
+ return (m[0] * (m[5] * m[10] - m[6] * m[9]) -
162
+ m[4] * (m[1] * m[10] - m[2] * m[9]) +
163
+ m[8] * (m[1] * m[6] - m[2] * m[5]));
164
+ }
165
+ const PICK_TREE_MINIMUM = 512, pickStack = new Int32Array(96);
166
+ const pickTrees = new WeakMap();
167
+ /** A hierarchy of boxes over a geometry's triangles, rebuilt when its positions or indices change. */
168
+ function pickTree(geometry, faceCount) {
169
+ const position = geometry.getAttribute('position'), indexAttribute = geometry.index, key = position.version * 1048576 + (indexAttribute?.version ?? 0);
170
+ const known = pickTrees.get(geometry);
171
+ if (known && known.key === key && known.positions === position.data && known.index === indexAttribute?.data)
172
+ return known;
173
+ const p = position.data, index = indexAttribute?.data, boxes = new Float32Array(faceCount * 6), centers = new Float32Array(faceCount * 3), faces = new Uint32Array(faceCount);
174
+ for (let face = 0; face < faceCount; face++) {
175
+ faces[face] = face;
176
+ const a = (index ? index[face * 3] : face * 3) * 3, b = (index ? index[face * 3 + 1] : face * 3 + 1) * 3, c = (index ? index[face * 3 + 2] : face * 3 + 2) * 3;
177
+ for (let axis = 0; axis < 3; axis++) {
178
+ const x = p[a + axis], y = p[b + axis], z = p[c + axis];
179
+ boxes[face * 6 + axis] = Math.min(x, y, z);
180
+ boxes[face * 6 + 3 + axis] = Math.max(x, y, z);
181
+ centers[face * 3 + axis] = (x + y + z) / 3;
182
+ }
183
+ }
184
+ const most = Math.max(2 * faceCount, 2), bounds = new Float32Array(most * 6), left = new Int32Array(most).fill(-1), start = new Int32Array(most), count = new Int32Array(most), pending = [0];
185
+ let used = 1;
186
+ count[0] = faceCount;
187
+ while (pending.length > 0) {
188
+ const node = pending.pop(), from = start[node], size = count[node];
189
+ let x0 = Infinity, y0 = Infinity, z0 = Infinity, x1 = -Infinity, y1 = -Infinity, z1 = -Infinity, cx0 = Infinity, cy0 = Infinity, cz0 = Infinity, cx1 = -Infinity, cy1 = -Infinity, cz1 = -Infinity;
190
+ for (let i = from; i < from + size; i++) {
191
+ const f = faces[i];
192
+ x0 = Math.min(x0, boxes[f * 6]);
193
+ y0 = Math.min(y0, boxes[f * 6 + 1]);
194
+ z0 = Math.min(z0, boxes[f * 6 + 2]);
195
+ x1 = Math.max(x1, boxes[f * 6 + 3]);
196
+ y1 = Math.max(y1, boxes[f * 6 + 4]);
197
+ z1 = Math.max(z1, boxes[f * 6 + 5]);
198
+ cx0 = Math.min(cx0, centers[f * 3]);
199
+ cy0 = Math.min(cy0, centers[f * 3 + 1]);
200
+ cz0 = Math.min(cz0, centers[f * 3 + 2]);
201
+ cx1 = Math.max(cx1, centers[f * 3]);
202
+ cy1 = Math.max(cy1, centers[f * 3 + 1]);
203
+ cz1 = Math.max(cz1, centers[f * 3 + 2]);
204
+ }
205
+ // A hair of padding keeps triangles lying exactly in a box face from being missed.
206
+ const pad = 1e-6 * Math.max(x1 - x0, y1 - y0, z1 - z0, 1e-6);
207
+ bounds.set([x0 - pad, y0 - pad, z0 - pad, x1 + pad, y1 + pad, z1 + pad], node * 6);
208
+ if (size <= 8)
209
+ continue;
210
+ const ex = cx1 - cx0, ey = cy1 - cy0, ez = cz1 - cz0, axis = ex >= ey && ex >= ez ? 0 : ey >= ez ? 1 : 2, middle = axis === 0 ? (cx0 + cx1) / 2 : axis === 1 ? (cy0 + cy1) / 2 : (cz0 + cz1) / 2;
211
+ let i = from, j = from + size - 1;
212
+ while (i <= j) {
213
+ if (centers[faces[i] * 3 + axis] < middle)
214
+ i++;
215
+ else {
216
+ const swap = faces[i];
217
+ faces[i] = faces[j];
218
+ faces[j] = swap;
219
+ j--;
220
+ }
221
+ }
222
+ let leftSize = i - from;
223
+ if (leftSize === 0 || leftSize === size)
224
+ leftSize = size >> 1;
225
+ const child = used;
226
+ used += 2;
227
+ left[node] = child;
228
+ start[child] = from;
229
+ count[child] = leftSize;
230
+ start[child + 1] = from + leftSize;
231
+ count[child + 1] = size - leftSize;
232
+ pending.push(child, child + 1);
233
+ }
234
+ const tree = {
235
+ key,
236
+ positions: p,
237
+ index,
238
+ bounds: bounds.slice(0, used * 6),
239
+ left: left.slice(0, used),
240
+ start: start.slice(0, used),
241
+ count: count.slice(0, used),
242
+ faces
243
+ };
244
+ pickTrees.set(geometry, tree);
245
+ return tree;
246
+ }
247
+ //# sourceMappingURL=Raycast3D.js.map
@@ -0,0 +1,91 @@
1
+ import type { Camera3D } from './Camera3D.js';
2
+ import type { Geometry3D } from './Geometry3D.js';
3
+ import { Light3D } from './Light3D.js';
4
+ import type { Material3D } from './Material3D.js';
5
+ import { Mesh3D } from './Mesh3D.js';
6
+ import type { Object3D, Scene3D } from './Object3D.js';
7
+ /** One thing to draw: its mesh, geometry and material, its range, its depth and order. */
8
+ export interface RenderItem3D {
9
+ mesh: Mesh3D;
10
+ geometry: Geometry3D;
11
+ material: Material3D;
12
+ /** First index (or vertex) and count of the range to draw. */
13
+ start: number;
14
+ count: number;
15
+ /** View-space distance along the camera axis; larger is farther. */
16
+ depth: number;
17
+ /** Drawn before blended items, and the mesh's render order: kept on the item so sorting need not look them up. */
18
+ opaque?: boolean;
19
+ order?: number;
20
+ /** What else must match for meshes to share an instanced draw: layers, receiving shadows, being instanceable at all. */
21
+ group?: number;
22
+ }
23
+ /** What building a render list counted: nodes visited, culled, and lights dropped. */
24
+ export interface RenderStats3D {
25
+ visited: number;
26
+ culled: number;
27
+ /** Point and spot lights past the renderer's limits that the last build left out. */
28
+ lightsDropped: number;
29
+ }
30
+ /** What a camera sees, sorted for drawing: opaque and transparent items, shadow casters and lights. */
31
+ export declare class RenderList3D {
32
+ #private;
33
+ readonly opaque: RenderItem3D[];
34
+ readonly transparent: RenderItem3D[];
35
+ /** Visible-to-light meshes; shadow passes cull these against each light volume. */
36
+ readonly shadowCasters: Mesh3D[];
37
+ readonly directionalLights: Light3D[];
38
+ readonly pointLights: Light3D[];
39
+ readonly spotLights: Light3D[];
40
+ /**
41
+ * Point lights past the eight a frame lights directly, nearest first: they are lit through the tiled light
42
+ * list instead, each only where its range reaches. Lights with no range are not among them.
43
+ */
44
+ readonly tiledPointLights: Light3D[];
45
+ /** Whether lights past the eight go to the tiled list (the renderer sets this) or are dropped. */
46
+ tiledLights: boolean;
47
+ /** Summed ambient radiance, plus hemisphere sky and ground radiance. */
48
+ readonly ambient: Float32Array<ArrayBuffer>;
49
+ readonly hemisphereSky: Float32Array<ArrayBuffer>;
50
+ readonly hemisphereGround: Float32Array<ArrayBuffer>;
51
+ readonly stats: RenderStats3D;
52
+ /**
53
+ * Runs of at least this many plain meshes with the same geometry and
54
+ * material are drawn as one instanced draw; shadow casters are grouped the
55
+ * same way. 0 draws every mesh on its own.
56
+ */
57
+ autoInstanceThreshold: number;
58
+ /** How many instanced draws automatic instancing made in the last build, and how many meshes they stand for. */
59
+ readonly instancing: {
60
+ batches: number;
61
+ meshes: number;
62
+ };
63
+ /** Monotonic frame id, used to update each skeleton once per frame. */
64
+ get frame(): number;
65
+ build(scene: Scene3D, camera: Camera3D, filter?: {
66
+ readonly layerMask: number;
67
+ readonly hidden: readonly Object3D[];
68
+ }): void;
69
+ /** Copy the sorted opaque items out, replacing each long enough run of like meshes with one instanced item. */
70
+ private fold;
71
+ /** Shadow casters that share a geometry and a material are drawn into the shadow maps as one instanced mesh. */
72
+ private groupCasters;
73
+ /** The instanced stand-in for a run of meshes, with their world matrices as its instances. */
74
+ private batch;
75
+ /** Forget stand-ins that have not been used for a while. */
76
+ private retire;
77
+ private visit;
78
+ private addLight;
79
+ /**
80
+ * Keeps at most `limit` of the lights found, the ones that matter most to the camera: a light whose range
81
+ * reaches the camera before one that does not, then the brightest at the camera's distance. A light that
82
+ * casts a shadow counts as reaching. Kept lights stay in scene order, so a frame with no more lights than
83
+ * the limit is unchanged.
84
+ */
85
+ private keepLights;
86
+ private addMesh;
87
+ private push;
88
+ /** Drop pooled references so retired scene content can be collected. */
89
+ clear(): void;
90
+ }
91
+ //# sourceMappingURL=RenderList3D.d.ts.map