@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,502 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // Backend-neutral frame preparation: refresh transforms, cull against the
3
+ // camera frustum, gather lights and produce sorted draw items. Item records
4
+ // are pooled so a steady scene allocates nothing per frame. Two things keep
5
+ // large scenes cheap: when the same items are visible as in the frame before,
6
+ // their sorted order is kept instead of sorted again; and runs of plain meshes
7
+ // that share a geometry and a material are handed to the backend as one
8
+ // instanced draw.
9
+ import { worldRenderSphere3D } from './AnimationTexture3D.js';
10
+ import { Lod3D, ScreenLayer3D } from './helpers3D.js';
11
+ import { LIGHT3D_LIMITS, Light3D } from './Light3D.js';
12
+ import { frustumIntersectsSphere } from './math3D.js';
13
+ import { InstancedMesh3D, Mesh3D } from './Mesh3D.js';
14
+ function compareOpaque(a, b) {
15
+ // Group by material, then geometry, to minimize state changes; draw near
16
+ // objects first within a group so early depth rejection saves shading.
17
+ return (a.order - b.order ||
18
+ a.material.id - b.material.id ||
19
+ a.geometry.id - b.geometry.id ||
20
+ a.start - b.start ||
21
+ a.depth - b.depth);
22
+ }
23
+ function compareTransparent(a, b) {
24
+ return a.mesh.renderOrder - b.mesh.renderOrder || b.depth - a.depth || a.mesh.id - b.mesh.id;
25
+ }
26
+ function foldable(material) {
27
+ return !material.billboard && !material.screenSpace && !material.wireframe;
28
+ }
29
+ /** What a camera sees, sorted for drawing: opaque and transparent items, shadow casters and lights. */
30
+ export class RenderList3D {
31
+ opaque = [];
32
+ transparent = [];
33
+ /** Visible-to-light meshes; shadow passes cull these against each light volume. */
34
+ shadowCasters = [];
35
+ directionalLights = [];
36
+ pointLights = [];
37
+ spotLights = [];
38
+ /**
39
+ * Point lights past the eight a frame lights directly, nearest first: they are lit through the tiled light
40
+ * list instead, each only where its range reaches. Lights with no range are not among them.
41
+ */
42
+ tiledPointLights = [];
43
+ /** Whether lights past the eight go to the tiled list (the renderer sets this) or are dropped. */
44
+ tiledLights = true;
45
+ /** Summed ambient radiance, plus hemisphere sky and ground radiance. */
46
+ ambient = new Float32Array(3);
47
+ hemisphereSky = new Float32Array(3);
48
+ hemisphereGround = new Float32Array(3);
49
+ stats = { visited: 0, culled: 0, lightsDropped: 0 };
50
+ /**
51
+ * Runs of at least this many plain meshes with the same geometry and
52
+ * material are drawn as one instanced draw; shadow casters are grouped the
53
+ * same way. 0 draws every mesh on its own.
54
+ */
55
+ autoInstanceThreshold = 8;
56
+ /** How many instanced draws automatic instancing made in the last build, and how many meshes they stand for. */
57
+ instancing = { batches: 0, meshes: 0 };
58
+ #pool = [];
59
+ // Opaque items in sorted order, before runs are folded into instanced draws.
60
+ #sorted = [];
61
+ #same = true;
62
+ #lastUsed = -1;
63
+ #batches = new Map();
64
+ #batchItems = [];
65
+ #batchItemsUsed = 0;
66
+ #casters = [];
67
+ #members = [];
68
+ #kinds = [];
69
+ #sizes = [];
70
+ #casterGroups = new Map();
71
+ // Every lit point and spot light found this build, before the nearest are kept.
72
+ #pointFound = [];
73
+ #spotFound = [];
74
+ #scores = [];
75
+ #used = 0;
76
+ #frame = 0;
77
+ /** Monotonic frame id, used to update each skeleton once per frame. */
78
+ get frame() {
79
+ return this.#frame;
80
+ }
81
+ build(scene, camera, filter) {
82
+ this.#override = scene.overrideMaterial && !scene.overrideMaterial.isDisposed ? scene.overrideMaterial : undefined;
83
+ this.#frame++;
84
+ this.#used = 0;
85
+ this.#same = true;
86
+ this.#batchItemsUsed = 0;
87
+ this.instancing.batches = this.instancing.meshes = 0;
88
+ this.opaque.length = this.transparent.length = this.shadowCasters.length = this.#casters.length = 0;
89
+ this.directionalLights.length = this.pointLights.length = this.spotLights.length = 0;
90
+ this.ambient.fill(0);
91
+ this.hemisphereSky.fill(0);
92
+ this.hemisphereGround.fill(0);
93
+ this.stats.visited = this.stats.culled = this.stats.lightsDropped = 0;
94
+ scene.updateWorldMatrices();
95
+ camera.updateViewMatrices();
96
+ this.#pointFound.length = this.#spotFound.length = 0;
97
+ this.visit(scene, camera, filter?.layerMask ?? camera.layerMask, filter?.hidden);
98
+ this.tiledPointLights.length = 0;
99
+ this.keepLights(this.#pointFound, this.pointLights, LIGHT3D_LIMITS.maxPoint, camera, this.tiledLights ? this.tiledPointLights : undefined);
100
+ this.keepLights(this.#spotFound, this.spotLights, LIGHT3D_LIMITS.maxSpot, camera);
101
+ // The same items as last frame, in the same roles: last frame's order still groups them by material and geometry.
102
+ if (!this.#same || this.#used !== this.#lastUsed) {
103
+ const sorted = this.#sorted, pool = this.#pool;
104
+ sorted.length = 0;
105
+ for (let i = 0; i < this.#used; i++)
106
+ if (pool[i].opaque)
107
+ sorted.push(pool[i]);
108
+ sorted.sort(compareOpaque);
109
+ }
110
+ this.#lastUsed = this.#used;
111
+ this.transparent.sort(compareTransparent);
112
+ this.fold();
113
+ this.groupCasters();
114
+ if (this.#frame % 256 === 0)
115
+ this.retire();
116
+ }
117
+ /** Copy the sorted opaque items out, replacing each long enough run of like meshes with one instanced item. */
118
+ fold() {
119
+ const sorted = this.#sorted, out = this.opaque, least = this.autoInstanceThreshold;
120
+ if (!(least > 1)) {
121
+ for (let i = 0; i < sorted.length; i++)
122
+ out.push(sorted[i]);
123
+ return;
124
+ }
125
+ const members = this.#members, kinds = this.#kinds, sizes = this.#sizes;
126
+ for (let i = 0; i < sorted.length;) {
127
+ // A span: neighbours in sorted order that draw the same range of the same geometry with the same material.
128
+ const first = sorted[i];
129
+ let end = i + 1;
130
+ while (end < sorted.length) {
131
+ const next = sorted[end];
132
+ if (next.material !== first.material ||
133
+ next.geometry !== first.geometry ||
134
+ next.start !== first.start ||
135
+ next.count !== first.count ||
136
+ next.order !== first.order)
137
+ break;
138
+ end++;
139
+ }
140
+ if (end - i < least || !foldable(first.material)) {
141
+ for (; i < end; i++)
142
+ out.push(sorted[i]);
143
+ continue;
144
+ }
145
+ // Within a span, meshes fold together only when layers and shadow reception match and each can be instanced.
146
+ let kindCount = 0;
147
+ for (let k = i; k < end; k++) {
148
+ const group = sorted[k].group;
149
+ let at = 0;
150
+ while (at < kindCount && kinds[at] !== group)
151
+ at++;
152
+ if (at === kindCount) {
153
+ kinds[kindCount] = group;
154
+ sizes[kindCount] = 0;
155
+ kindCount++;
156
+ }
157
+ sizes[at] = sizes[at] + 1;
158
+ }
159
+ for (let kind = 0; kind < kindCount; kind++) {
160
+ const group = kinds[kind];
161
+ if (group < 8589934592 || sizes[kind] < least)
162
+ continue;
163
+ members.length = 0;
164
+ let lead;
165
+ for (let k = i; k < end; k++)
166
+ if (sorted[k].group === group) {
167
+ members.push(sorted[k].mesh);
168
+ lead ??= sorted[k];
169
+ }
170
+ const batch = this.batch(first.geometry, first.material, lead.mesh.receiveShadow ? 1 : 0, members.length, k => members[k]);
171
+ // Layers travel with the stand-in: outlines and masks select meshes by them.
172
+ batch.mesh.castShadow = false;
173
+ batch.mesh.layers = lead.mesh.layers;
174
+ let item = this.#batchItems[this.#batchItemsUsed];
175
+ if (!item)
176
+ this.#batchItems[this.#batchItemsUsed] = item = {
177
+ mesh: batch.mesh,
178
+ geometry: first.geometry,
179
+ material: first.material,
180
+ start: first.start,
181
+ count: first.count,
182
+ depth: lead.depth,
183
+ opaque: true,
184
+ order: first.order,
185
+ group
186
+ };
187
+ else {
188
+ item.mesh = batch.mesh;
189
+ item.geometry = first.geometry;
190
+ item.material = first.material;
191
+ item.start = first.start;
192
+ item.count = first.count;
193
+ item.depth = lead.depth;
194
+ item.order = first.order;
195
+ item.group = group;
196
+ }
197
+ this.#batchItemsUsed++;
198
+ out.push(item);
199
+ this.instancing.batches++;
200
+ this.instancing.meshes += members.length;
201
+ sizes[kind] = -1;
202
+ }
203
+ // What was not folded keeps its front-to-back order.
204
+ for (let k = i; k < end; k++) {
205
+ const group = sorted[k].group;
206
+ let at = 0;
207
+ while (kinds[at] !== group)
208
+ at++;
209
+ if (sizes[at] !== -1)
210
+ out.push(sorted[k]);
211
+ }
212
+ i = end;
213
+ }
214
+ }
215
+ /** Shadow casters that share a geometry and a material are drawn into the shadow maps as one instanced mesh. */
216
+ groupCasters() {
217
+ const casters = this.#casters, out = this.shadowCasters, least = this.autoInstanceThreshold, groups = this.#casterGroups;
218
+ if (!(least > 1)) {
219
+ for (let i = 0; i < casters.length; i++)
220
+ out.push(casters[i]);
221
+ return;
222
+ }
223
+ for (const list of groups.values())
224
+ list.length = 0;
225
+ for (let i = 0; i < casters.length; i++) {
226
+ const mesh = casters[i], material = mesh.material;
227
+ if (Array.isArray(material) || !mesh.canInstance || !foldable(material) || material.id >= 4194304) {
228
+ out.push(mesh);
229
+ continue;
230
+ }
231
+ const key = mesh.geometry.id * 4194304 + material.id;
232
+ let list = groups.get(key);
233
+ if (!list)
234
+ groups.set(key, (list = []));
235
+ list.push(mesh);
236
+ }
237
+ for (const list of groups.values()) {
238
+ if (list.length === 0)
239
+ continue;
240
+ if (list.length < least) {
241
+ for (let i = 0; i < list.length; i++)
242
+ out.push(list[i]);
243
+ continue;
244
+ }
245
+ const batch = this.batch(list[0].geometry, list[0].material, 2, list.length, k => list[k]);
246
+ batch.mesh.castShadow = true;
247
+ out.push(batch.mesh);
248
+ }
249
+ }
250
+ /** The instanced stand-in for a run of meshes, with their world matrices as its instances. */
251
+ batch(geometry, material, role, count, at) {
252
+ const key = geometry.id * 4194304 + (material.id % 4194304);
253
+ let slots = this.#batches.get(key);
254
+ if (!slots)
255
+ this.#batches.set(key, (slots = []));
256
+ // One stand-in per role (receiving shadows or not, casting) and per run within a frame.
257
+ let found;
258
+ for (const slot of slots)
259
+ if (slot.role === role &&
260
+ slot.frame !== this.#frame &&
261
+ slot.material === material &&
262
+ slot.geometry === geometry) {
263
+ found = slot;
264
+ break;
265
+ }
266
+ if (!found || found.mesh.capacity < count) {
267
+ const capacity = Math.max(16, 2 ** Math.ceil(Math.log2(count)));
268
+ const mesh = new InstancedMesh3D(geometry, material, capacity);
269
+ mesh.name = 'auto-instances';
270
+ mesh.pickable = false;
271
+ mesh.frustumCulled = false;
272
+ if (found) {
273
+ found.mesh = mesh;
274
+ found.stamp = -1;
275
+ }
276
+ else
277
+ slots.push((found = { mesh, geometry, material, role, frame: 0, stamp: -1 }));
278
+ }
279
+ found.frame = this.#frame;
280
+ const mesh = found.mesh;
281
+ mesh.receiveShadow = role === 1;
282
+ // Rewrite the matrices only when a member changed or moved since they were last written.
283
+ let stamp = count;
284
+ for (let k = 0; k < count; k++) {
285
+ const member = at(k);
286
+ stamp = (Math.imul(stamp, 31) + member.id + Math.imul(member.worldVersion, 131)) | 0;
287
+ }
288
+ if (stamp !== found.stamp || mesh.count !== count) {
289
+ const matrices = mesh.instanceMatrices;
290
+ for (let k = 0; k < count; k++)
291
+ matrices.set(at(k).matrixWorld, k * 16);
292
+ mesh.count = count;
293
+ mesh.instanceVersion++;
294
+ found.stamp = stamp;
295
+ }
296
+ return found;
297
+ }
298
+ /** Forget stand-ins that have not been used for a while. */
299
+ retire() {
300
+ for (const [key, slots] of this.#batches) {
301
+ for (let i = slots.length - 1; i >= 0; i--)
302
+ if (this.#frame - slots[i].frame > 256)
303
+ slots.splice(i, 1);
304
+ if (slots.length === 0)
305
+ this.#batches.delete(key);
306
+ }
307
+ for (const [key, list] of this.#casterGroups)
308
+ if (list.length === 0)
309
+ this.#casterGroups.delete(key);
310
+ }
311
+ visit(object, camera, layerMask, hidden) {
312
+ if (!object.visible || hidden?.includes(object))
313
+ return;
314
+ if (object instanceof Lod3D) {
315
+ const eye = camera.matrixWorld;
316
+ object.select(eye[12], eye[13], eye[14]);
317
+ }
318
+ if (object.kind === 'mesh')
319
+ this.addMesh(object, camera, layerMask);
320
+ else if (object.kind === 'light')
321
+ this.addLight(object);
322
+ const children = object.children;
323
+ for (let i = 0; i < children.length; i++)
324
+ this.visit(children[i], camera, layerMask, hidden);
325
+ }
326
+ addLight(light) {
327
+ const intensity = light.intensity;
328
+ if (!(intensity > 0))
329
+ return;
330
+ const color = light.color;
331
+ switch (light.lightType) {
332
+ case 'ambient':
333
+ for (let i = 0; i < 3; i++)
334
+ this.ambient[i] += color[i] * intensity;
335
+ break;
336
+ case 'hemisphere':
337
+ for (let i = 0; i < 3; i++) {
338
+ this.hemisphereSky[i] += color[i] * intensity;
339
+ this.hemisphereGround[i] += light.groundColor[i] * intensity;
340
+ }
341
+ break;
342
+ case 'directional':
343
+ if (this.directionalLights.length < LIGHT3D_LIMITS.maxDirectional)
344
+ this.directionalLights.push(light);
345
+ break;
346
+ case 'point':
347
+ this.#pointFound.push(light);
348
+ break;
349
+ case 'spot':
350
+ this.#spotFound.push(light);
351
+ break;
352
+ }
353
+ }
354
+ /**
355
+ * Keeps at most `limit` of the lights found, the ones that matter most to the camera: a light whose range
356
+ * reaches the camera before one that does not, then the brightest at the camera's distance. A light that
357
+ * casts a shadow counts as reaching. Kept lights stay in scene order, so a frame with no more lights than
358
+ * the limit is unchanged.
359
+ */
360
+ keepLights(found, kept, limit, camera, rest) {
361
+ if (found.length <= limit) {
362
+ for (let i = 0; i < found.length; i++)
363
+ kept.push(found[i]);
364
+ return;
365
+ }
366
+ const eye = camera.matrixWorld, scores = this.#scores;
367
+ scores.length = found.length;
368
+ for (let i = 0; i < found.length; i++) {
369
+ const light = found[i], m = light.matrixWorld, dx = m[12] - eye[12], dy = m[13] - eye[13], dz = m[14] - eye[14], distanceSq = dx * dx + dy * dy + dz * dz, c = light.color, brightness = light.intensity * Math.max(c[0], c[1], c[2]), reaches = light.castShadow || light.range <= 0 || distanceSq <= light.range * light.range;
370
+ // Reaching lights score above every other; within each group, brightness falls off with distance squared.
371
+ scores[i] = (reaches ? 1 : 0) + Math.min(0.999999, brightness / (1 + distanceSq) / (1 + brightness));
372
+ }
373
+ const threshold = scores.slice().sort((a, b) => b - a)[limit - 1];
374
+ // Keep everything above the threshold, then lights equal to it in scene order until the limit is met.
375
+ let above = 0;
376
+ for (let i = 0; i < found.length; i++)
377
+ if (scores[i] > threshold)
378
+ above++;
379
+ let ties = limit - above;
380
+ const others = [];
381
+ for (let i = 0; i < found.length; i++) {
382
+ const score = scores[i];
383
+ if (score > threshold || (score === threshold && ties-- > 0))
384
+ kept.push(found[i]);
385
+ else if (rest && found[i].range > 0)
386
+ others.push(i);
387
+ }
388
+ if (rest) {
389
+ // The rest, best first, up to what the tiled list holds.
390
+ others.sort((a, b) => scores[b] - scores[a]);
391
+ for (const i of others) {
392
+ if (rest.length >= LIGHT3D_LIMITS.maxTiledPoint)
393
+ break;
394
+ rest.push(found[i]);
395
+ }
396
+ }
397
+ this.stats.lightsDropped += found.length - limit - (rest?.length ?? 0);
398
+ }
399
+ addMesh(mesh, camera, layerMask) {
400
+ // Meshes that build their geometry on demand (batches, camera-facing lines) do it here.
401
+ mesh.beforeRender?.(camera);
402
+ const geometry = mesh.geometry;
403
+ if (geometry.isDisposed || geometry.drawCount === 0)
404
+ return;
405
+ this.stats.visited++;
406
+ if (mesh.skeleton)
407
+ mesh.skeleton.update(this.#frame);
408
+ if (mesh instanceof ScreenLayer3D && mesh.autoUpdate)
409
+ mesh.refreshSource();
410
+ // Too far to be seen: neither drawn nor casting a shadow.
411
+ if (mesh.cullDistance < Infinity) {
412
+ const bounds = worldRenderSphere3D(mesh);
413
+ if (bounds && bounds[3] >= 0) {
414
+ const eye = camera.matrixWorld, away = Math.hypot(bounds[0] - eye[12], bounds[1] - eye[13], bounds[2] - eye[14]) - bounds[3];
415
+ if (away > mesh.cullDistance) {
416
+ this.stats.culled++;
417
+ return;
418
+ }
419
+ }
420
+ }
421
+ if (mesh.castShadow)
422
+ this.#casters.push(mesh);
423
+ if ((mesh.layers & layerMask) === 0)
424
+ return;
425
+ const sphere = worldRenderSphere3D(mesh);
426
+ if (mesh.frustumCulled && sphere && sphere[3] >= 0 && !frustumIntersectsSphere(camera.frustum, sphere)) {
427
+ this.stats.culled++;
428
+ return;
429
+ }
430
+ // Use the batch origin when no posed bound is available.
431
+ const sortOrigin = sphere ?? mesh.matrixWorld, offset = sphere ? 0 : 12;
432
+ const view = camera.viewMatrix;
433
+ const depth = -(view[2] * sortOrigin[offset] +
434
+ view[6] * sortOrigin[offset + 1] +
435
+ view[10] * sortOrigin[offset + 2] +
436
+ view[14]);
437
+ const groups = geometry.groups;
438
+ if (Array.isArray(mesh.material) && groups.length > 0) {
439
+ for (let i = 0; i < groups.length; i++) {
440
+ const group = groups[i];
441
+ this.push(mesh, geometry, mesh.materialAt(group.materialIndex), group.start, group.count, depth);
442
+ }
443
+ }
444
+ else
445
+ this.push(mesh, geometry, mesh.materialAt(0), 0, geometry.drawCount, depth);
446
+ }
447
+ #override;
448
+ push(mesh, geometry, own, start, count, depth) {
449
+ // An invisible material still hides its mesh when the scene overrides materials.
450
+ if (!own.visible)
451
+ return;
452
+ const material = this.#override ?? own;
453
+ if (!material.visible || material.isDisposed || count <= 0)
454
+ return;
455
+ // A transmitting surface shows what was drawn before it, so it waits for the opaque pass like blended ones.
456
+ const opaque = !(material.isTransparent || material.transmission > 0), order = mesh.renderOrder;
457
+ // Layers are a 32-bit mask; the two flags ride above it.
458
+ const group = (mesh.layers >>> 0) + (mesh.receiveShadow ? 4294967296 : 0) + (opaque && mesh.canInstance ? 8589934592 : 0);
459
+ let item = this.#pool[this.#used];
460
+ if (!item) {
461
+ this.#pool[this.#used] = item = { mesh, geometry, material, start, count, depth, opaque, order, group };
462
+ this.#same = false;
463
+ }
464
+ else {
465
+ if (item.mesh !== mesh ||
466
+ item.material !== material ||
467
+ item.geometry !== geometry ||
468
+ item.start !== start ||
469
+ item.count !== count ||
470
+ item.opaque !== opaque ||
471
+ item.order !== order ||
472
+ item.group !== group)
473
+ this.#same = false;
474
+ item.mesh = mesh;
475
+ item.geometry = geometry;
476
+ item.material = material;
477
+ item.start = start;
478
+ item.count = count;
479
+ item.depth = depth;
480
+ item.opaque = opaque;
481
+ item.order = order;
482
+ item.group = group;
483
+ }
484
+ this.#used++;
485
+ if (!opaque)
486
+ this.transparent.push(item);
487
+ }
488
+ /** Drop pooled references so retired scene content can be collected. */
489
+ clear() {
490
+ this.#pool = [];
491
+ this.#used = 0;
492
+ this.#lastUsed = -1;
493
+ this.#sorted.length = this.#casters.length = this.#batchItems.length = 0;
494
+ this.#batches.clear();
495
+ this.#casterGroups.clear();
496
+ this.opaque.length = this.transparent.length = this.shadowCasters.length = 0;
497
+ this.directionalLights.length = this.pointLights.length = this.spotLights.length = 0;
498
+ this.tiledPointLights.length = 0;
499
+ this.#pointFound.length = this.#spotFound.length = 0;
500
+ }
501
+ }
502
+ //# sourceMappingURL=RenderList3D.js.map
@@ -0,0 +1,21 @@
1
+ import { AnimationClip3D } from './Animation3D.js';
2
+ import type { Object3D } from './Object3D.js';
3
+ /** How a clip is moved to another skeleton: from where to where, which bones match, the root, scale and frame rate. */
4
+ export interface RetargetOptions3D {
5
+ /** The rig the clip was made for, in its rest pose. */
6
+ readonly source: Object3D;
7
+ /** The rig to make a clip for, in its rest pose. */
8
+ readonly target: Object3D;
9
+ /** Target bone name to source bone name. Defaults to the same names, for every target bone the source has. */
10
+ readonly bones?: Readonly<Record<string, string>>;
11
+ /** The target bone that carries the travel, such as the hips; its source is found through `bones`. */
12
+ readonly root?: string;
13
+ /** Scale of the root's travel; by default the ratio of the two root bones' heights above the rig origin. */
14
+ readonly scale?: number;
15
+ /** Keys a second. Defaults to 30. */
16
+ readonly fps?: number;
17
+ readonly name?: string;
18
+ }
19
+ /** A clip for the target rig that moves it as `clip` moves the source rig. */
20
+ export declare function retargetAnimationClip3D(clip: AnimationClip3D, options: RetargetOptions3D): AnimationClip3D;
21
+ //# sourceMappingURL=Retarget3D.d.ts.map