@egret/engine 0.0.0-stage → 7.0.1-rc.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (575) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +21 -0
  3. package/README.md +101 -2
  4. package/README.zh-CN.md +102 -0
  5. package/dist/Engine.d.ts +77 -0
  6. package/dist/Engine.js +464 -0
  7. package/dist/animation/index.d.ts +6 -0
  8. package/dist/animation/index.js +5 -0
  9. package/dist/animation/sequenceController.d.ts +22 -0
  10. package/dist/animation/sequenceController.js +618 -0
  11. package/dist/animation/sequenceCoordinator.d.ts +26 -0
  12. package/dist/animation/sequenceCoordinator.js +161 -0
  13. package/dist/animation/sequenceInput.d.ts +25 -0
  14. package/dist/animation/sequenceInput.js +108 -0
  15. package/dist/animation/sequenceMath.d.ts +35 -0
  16. package/dist/animation/sequenceMath.js +164 -0
  17. package/dist/animation/sequenceResetSlot.d.ts +7 -0
  18. package/dist/animation/sequenceResetSlot.js +367 -0
  19. package/dist/animation/sequenceResetTypes.d.ts +42 -0
  20. package/dist/animation/sequenceResetTypes.js +2 -0
  21. package/dist/animation/types.d.ts +69 -0
  22. package/dist/animation/types.js +2 -0
  23. package/dist/assetBundle.d.ts +52 -0
  24. package/dist/assetBundle.js +173 -0
  25. package/dist/assetGroup.d.ts +17 -0
  26. package/dist/assetGroup.js +332 -0
  27. package/dist/assetGroupTypes.d.ts +15 -0
  28. package/dist/assetGroupTypes.js +2 -0
  29. package/dist/audio.d.ts +4 -0
  30. package/dist/audio.js +4 -0
  31. package/dist/audioCues.d.ts +43 -0
  32. package/dist/audioCues.js +127 -0
  33. package/dist/audioMixer.d.ts +7 -0
  34. package/dist/audioMixer.js +785 -0
  35. package/dist/audioTypes.d.ts +233 -0
  36. package/dist/audioTypes.js +3 -0
  37. package/dist/bitmapBindingTicket.d.ts +24 -0
  38. package/dist/bitmapBindingTicket.js +215 -0
  39. package/dist/bitmapButton.d.ts +4 -0
  40. package/dist/bitmapButton.js +407 -0
  41. package/dist/bitmapButtonTypes.d.ts +29 -0
  42. package/dist/bitmapButtonTypes.js +2 -0
  43. package/dist/bitmapFontParse.d.ts +10 -0
  44. package/dist/bitmapFontParse.js +246 -0
  45. package/dist/bitmapFontTypes.d.ts +109 -0
  46. package/dist/bitmapFontTypes.js +2 -0
  47. package/dist/bitmapResourceSlot.d.ts +25 -0
  48. package/dist/bitmapResourceSlot.js +340 -0
  49. package/dist/bitmapText.d.ts +6 -0
  50. package/dist/bitmapText.js +320 -0
  51. package/dist/bitmapfont.d.ts +5 -0
  52. package/dist/bitmapfont.js +5 -0
  53. package/dist/camera.d.ts +4 -0
  54. package/dist/camera.js +4 -0
  55. package/dist/camera2d.d.ts +7 -0
  56. package/dist/camera2d.js +411 -0
  57. package/dist/cameraTypes.d.ts +114 -0
  58. package/dist/cameraTypes.js +2 -0
  59. package/dist/closeHost.d.ts +4 -0
  60. package/dist/closeHost.js +66 -0
  61. package/dist/contentArtifacts.d.ts +12 -0
  62. package/dist/contentArtifacts.js +153 -0
  63. package/dist/contentAtlasPages.d.ts +13 -0
  64. package/dist/contentAtlasPages.js +117 -0
  65. package/dist/contentLoader.d.ts +6 -0
  66. package/dist/contentLoader.js +327 -0
  67. package/dist/contentTypes.d.ts +33 -0
  68. package/dist/contentTypes.js +2 -0
  69. package/dist/createEngine.d.ts +7 -0
  70. package/dist/createEngine.js +25 -0
  71. package/dist/createEngineForProfile.d.ts +5 -0
  72. package/dist/createEngineForProfile.js +42 -0
  73. package/dist/displaySubtreeTicket.d.ts +25 -0
  74. package/dist/displaySubtreeTicket.js +76 -0
  75. package/dist/fontContentLoader.d.ts +6 -0
  76. package/dist/fontContentLoader.js +298 -0
  77. package/dist/fontContentTypes.d.ts +34 -0
  78. package/dist/fontContentTypes.js +2 -0
  79. package/dist/gameClock.d.ts +24 -0
  80. package/dist/gameClock.js +246 -0
  81. package/dist/gameClockTypes.d.ts +31 -0
  82. package/dist/gameClockTypes.js +2 -0
  83. package/dist/gameRun.d.ts +50 -0
  84. package/dist/gameRun.js +97 -0
  85. package/dist/gamepad.d.ts +5 -0
  86. package/dist/gamepad.js +5 -0
  87. package/dist/gamepadInput.d.ts +4 -0
  88. package/dist/gamepadInput.js +281 -0
  89. package/dist/gamepadKeys.d.ts +4 -0
  90. package/dist/gamepadKeys.js +205 -0
  91. package/dist/gamepadTypes.d.ts +134 -0
  92. package/dist/gamepadTypes.js +3 -0
  93. package/dist/hover.d.ts +4 -0
  94. package/dist/hover.js +4 -0
  95. package/dist/hoverInput.d.ts +8 -0
  96. package/dist/hoverInput.js +503 -0
  97. package/dist/hoverInputTypes.d.ts +119 -0
  98. package/dist/hoverInputTypes.js +2 -0
  99. package/dist/index.d.ts +49 -0
  100. package/dist/index.js +20 -0
  101. package/dist/input.d.ts +6 -0
  102. package/dist/input.js +5 -0
  103. package/dist/inputActions.d.ts +81 -0
  104. package/dist/inputActions.js +330 -0
  105. package/dist/internal/contentFactoryState.d.ts +19 -0
  106. package/dist/internal/contentFactoryState.js +42 -0
  107. package/dist/internal/mouseInputFactoryState.d.ts +57 -0
  108. package/dist/internal/mouseInputFactoryState.js +125 -0
  109. package/dist/internal/sequenceControllerFactoryState.d.ts +42 -0
  110. package/dist/internal/sequenceControllerFactoryState.js +98 -0
  111. package/dist/internal/textFieldFactoryState.d.ts +11 -0
  112. package/dist/internal/textFieldFactoryState.js +32 -0
  113. package/dist/internal/texturedFrameState.d.ts +4 -0
  114. package/dist/internal/texturedFrameState.js +12 -0
  115. package/dist/internal/uiFactoryState.d.ts +64 -0
  116. package/dist/internal/uiFactoryState.js +157 -0
  117. package/dist/internal/uiRootState.d.ts +67 -0
  118. package/dist/internal/uiRootState.js +103 -0
  119. package/dist/keyboardInput.d.ts +12 -0
  120. package/dist/keyboardInput.js +578 -0
  121. package/dist/keyboardInputTypes.d.ts +81 -0
  122. package/dist/keyboardInputTypes.js +2 -0
  123. package/dist/kit.d.ts +14 -0
  124. package/dist/kit.js +9 -0
  125. package/dist/layout.d.ts +5 -0
  126. package/dist/layout.js +132 -0
  127. package/dist/layoutTypes.d.ts +28 -0
  128. package/dist/layoutTypes.js +2 -0
  129. package/dist/manifestAssetGroup.d.ts +10 -0
  130. package/dist/manifestAssetGroup.js +477 -0
  131. package/dist/manifestResourceState.d.ts +16 -0
  132. package/dist/manifestResourceState.js +57 -0
  133. package/dist/manifestResourceTypes.d.ts +25 -0
  134. package/dist/manifestResourceTypes.js +2 -0
  135. package/dist/motion.d.ts +33 -0
  136. package/dist/motion.js +206 -0
  137. package/dist/mouseInput.d.ts +102 -0
  138. package/dist/mouseInput.js +562 -0
  139. package/dist/mouseInputTypes.d.ts +37 -0
  140. package/dist/mouseInputTypes.js +2 -0
  141. package/dist/paragraph.d.ts +8 -0
  142. package/dist/paragraph.js +7 -0
  143. package/dist/particleEmitter.d.ts +4 -0
  144. package/dist/particleEmitter.js +292 -0
  145. package/dist/particleTypes.d.ts +107 -0
  146. package/dist/particleTypes.js +2 -0
  147. package/dist/particles.d.ts +4 -0
  148. package/dist/particles.js +4 -0
  149. package/dist/physics2d.d.ts +4 -0
  150. package/dist/physics2d.js +4 -0
  151. package/dist/physics2dGeometry.d.ts +39 -0
  152. package/dist/physics2dGeometry.js +230 -0
  153. package/dist/physics2dTypes.d.ts +167 -0
  154. package/dist/physics2dTypes.js +2 -0
  155. package/dist/physics2dWorld.d.ts +4 -0
  156. package/dist/physics2dWorld.js +623 -0
  157. package/dist/pointerInput.d.ts +11 -0
  158. package/dist/pointerInput.js +299 -0
  159. package/dist/pointerInputTypes.d.ts +38 -0
  160. package/dist/pointerInputTypes.js +2 -0
  161. package/dist/random.d.ts +29 -0
  162. package/dist/random.js +131 -0
  163. package/dist/rendering/ownedPreparationFailure2D.d.ts +5 -0
  164. package/dist/rendering/ownedPreparationFailure2D.js +33 -0
  165. package/dist/rendering/packSharedDraws2D.d.ts +50 -0
  166. package/dist/rendering/packSharedDraws2D.js +331 -0
  167. package/dist/rendering/packedOrientation.d.ts +4 -0
  168. package/dist/rendering/packedOrientation.js +7 -0
  169. package/dist/rendering/prepareRectangles2D.d.ts +92 -0
  170. package/dist/rendering/prepareRectangles2D.js +481 -0
  171. package/dist/rendering/prepareSharedDraws2D.d.ts +88 -0
  172. package/dist/rendering/prepareSharedDraws2D.js +652 -0
  173. package/dist/rendering/preparedBatches2D.d.ts +17 -0
  174. package/dist/rendering/preparedBatches2D.js +30 -0
  175. package/dist/rendering/preparedSharedBatches2D.d.ts +44 -0
  176. package/dist/rendering/preparedSharedBatches2D.js +247 -0
  177. package/dist/rendering/sharedColor2D.d.ts +18 -0
  178. package/dist/rendering/sharedColor2D.js +68 -0
  179. package/dist/rendering/sharedEffects2D.d.ts +23 -0
  180. package/dist/rendering/sharedEffects2D.js +118 -0
  181. package/dist/rendering/sharedPreparationRetention2D.d.ts +120 -0
  182. package/dist/rendering/sharedPreparationRetention2D.js +357 -0
  183. package/dist/rendering/srgbBytes.d.ts +3 -0
  184. package/dist/rendering/srgbBytes.js +64 -0
  185. package/dist/rendering/texturedPreparationBudget2D.d.ts +31 -0
  186. package/dist/rendering/texturedPreparationBudget2D.js +81 -0
  187. package/dist/rendering/world3d/Animation3D.d.ts +95 -0
  188. package/dist/rendering/world3d/Animation3D.js +380 -0
  189. package/dist/rendering/world3d/AnimationTexture3D.d.ts +157 -0
  190. package/dist/rendering/world3d/AnimationTexture3D.js +601 -0
  191. package/dist/rendering/world3d/Batch3D.d.ts +71 -0
  192. package/dist/rendering/world3d/Batch3D.js +329 -0
  193. package/dist/rendering/world3d/Camera3D.d.ts +57 -0
  194. package/dist/rendering/world3d/Camera3D.js +129 -0
  195. package/dist/rendering/world3d/Character3D.d.ts +123 -0
  196. package/dist/rendering/world3d/Character3D.js +303 -0
  197. package/dist/rendering/world3d/Cloth3D.d.ts +115 -0
  198. package/dist/rendering/world3d/Cloth3D.js +498 -0
  199. package/dist/rendering/world3d/Compression3D.d.ts +21 -0
  200. package/dist/rendering/world3d/Compression3D.js +702 -0
  201. package/dist/rendering/world3d/Curves3D.d.ts +111 -0
  202. package/dist/rendering/world3d/Curves3D.js +455 -0
  203. package/dist/rendering/world3d/Decal3D.d.ts +41 -0
  204. package/dist/rendering/world3d/Decal3D.js +241 -0
  205. package/dist/rendering/world3d/Geometry3D.d.ts +85 -0
  206. package/dist/rendering/world3d/Geometry3D.js +326 -0
  207. package/dist/rendering/world3d/GeometryBuilder3D.d.ts +51 -0
  208. package/dist/rendering/world3d/GeometryBuilder3D.js +196 -0
  209. package/dist/rendering/world3d/Gizmo3D.d.ts +75 -0
  210. package/dist/rendering/world3d/Gizmo3D.js +512 -0
  211. package/dist/rendering/world3d/Gltf3D.d.ts +67 -0
  212. package/dist/rendering/world3d/Gltf3D.js +976 -0
  213. package/dist/rendering/world3d/GpuParticles3D.d.ts +107 -0
  214. package/dist/rendering/world3d/GpuParticles3D.js +400 -0
  215. package/dist/rendering/world3d/Hdr3D.d.ts +33 -0
  216. package/dist/rendering/world3d/Hdr3D.js +190 -0
  217. package/dist/rendering/world3d/Jelly3D.d.ts +75 -0
  218. package/dist/rendering/world3d/Jelly3D.js +266 -0
  219. package/dist/rendering/world3d/Ktx23D.d.ts +27 -0
  220. package/dist/rendering/world3d/Ktx23D.js +112 -0
  221. package/dist/rendering/world3d/Light3D.d.ts +75 -0
  222. package/dist/rendering/world3d/Light3D.js +93 -0
  223. package/dist/rendering/world3d/Material3D.d.ts +243 -0
  224. package/dist/rendering/world3d/Material3D.js +267 -0
  225. package/dist/rendering/world3d/Mesh3D.d.ts +108 -0
  226. package/dist/rendering/world3d/Mesh3D.js +323 -0
  227. package/dist/rendering/world3d/Meshopt3D.d.ts +12 -0
  228. package/dist/rendering/world3d/Meshopt3D.js +275 -0
  229. package/dist/rendering/world3d/Navigation3D.d.ts +173 -0
  230. package/dist/rendering/world3d/Navigation3D.js +971 -0
  231. package/dist/rendering/world3d/Object3D.d.ts +107 -0
  232. package/dist/rendering/world3d/Object3D.js +305 -0
  233. package/dist/rendering/world3d/Particles3D.d.ts +85 -0
  234. package/dist/rendering/world3d/Particles3D.js +274 -0
  235. package/dist/rendering/world3d/Physics3D.d.ts +416 -0
  236. package/dist/rendering/world3d/Physics3D.js +2835 -0
  237. package/dist/rendering/world3d/PhysicsHull3D.d.ts +35 -0
  238. package/dist/rendering/world3d/PhysicsHull3D.js +227 -0
  239. package/dist/rendering/world3d/PhysicsMesh3D.d.ts +39 -0
  240. package/dist/rendering/world3d/PhysicsMesh3D.js +338 -0
  241. package/dist/rendering/world3d/PhysicsQueries3D.d.ts +24 -0
  242. package/dist/rendering/world3d/PhysicsQueries3D.js +323 -0
  243. package/dist/rendering/world3d/PhysicsRemote3D.d.ts +174 -0
  244. package/dist/rendering/world3d/PhysicsRemote3D.js +534 -0
  245. package/dist/rendering/world3d/Ragdoll3D.d.ts +69 -0
  246. package/dist/rendering/world3d/Ragdoll3D.js +200 -0
  247. package/dist/rendering/world3d/Raycast3D.d.ts +37 -0
  248. package/dist/rendering/world3d/Raycast3D.js +246 -0
  249. package/dist/rendering/world3d/RenderList3D.d.ts +88 -0
  250. package/dist/rendering/world3d/RenderList3D.js +490 -0
  251. package/dist/rendering/world3d/Retarget3D.d.ts +20 -0
  252. package/dist/rendering/world3d/Retarget3D.js +185 -0
  253. package/dist/rendering/world3d/Serialize3D.d.ts +49 -0
  254. package/dist/rendering/world3d/Serialize3D.js +607 -0
  255. package/dist/rendering/world3d/StateMachine3D.d.ts +78 -0
  256. package/dist/rendering/world3d/StateMachine3D.js +277 -0
  257. package/dist/rendering/world3d/Terrain3D.d.ts +227 -0
  258. package/dist/rendering/world3d/Terrain3D.js +803 -0
  259. package/dist/rendering/world3d/Text3D.d.ts +90 -0
  260. package/dist/rendering/world3d/Text3D.js +558 -0
  261. package/dist/rendering/world3d/Texture3D.d.ts +133 -0
  262. package/dist/rendering/world3d/Texture3D.js +252 -0
  263. package/dist/rendering/world3d/Trail3D.d.ts +59 -0
  264. package/dist/rendering/world3d/Trail3D.js +193 -0
  265. package/dist/rendering/world3d/Vehicle3D.d.ts +97 -0
  266. package/dist/rendering/world3d/Vehicle3D.js +226 -0
  267. package/dist/rendering/world3d/VolumetricFog3D.d.ts +55 -0
  268. package/dist/rendering/world3d/VolumetricFog3D.js +229 -0
  269. package/dist/rendering/world3d/Water3D.d.ts +163 -0
  270. package/dist/rendering/world3d/Water3D.js +606 -0
  271. package/dist/rendering/world3d/core3D.d.ts +34 -0
  272. package/dist/rendering/world3d/core3D.js +99 -0
  273. package/dist/rendering/world3d/debug3D.d.ts +64 -0
  274. package/dist/rendering/world3d/debug3D.js +257 -0
  275. package/dist/rendering/world3d/decoders3D.d.ts +42 -0
  276. package/dist/rendering/world3d/decoders3D.js +133 -0
  277. package/dist/rendering/world3d/geometries3D.d.ts +99 -0
  278. package/dist/rendering/world3d/geometries3D.js +605 -0
  279. package/dist/rendering/world3d/helpers3D.d.ts +65 -0
  280. package/dist/rendering/world3d/helpers3D.js +177 -0
  281. package/dist/rendering/world3d/index.d.ts +91 -0
  282. package/dist/rendering/world3d/index.js +56 -0
  283. package/dist/rendering/world3d/math3D.d.ts +78 -0
  284. package/dist/rendering/world3d/math3D.js +640 -0
  285. package/dist/rendering/world3d/primitives3D.d.ts +60 -0
  286. package/dist/rendering/world3d/primitives3D.js +196 -0
  287. package/dist/resources.d.ts +8 -0
  288. package/dist/resources.js +6 -0
  289. package/dist/saveStore.d.ts +56 -0
  290. package/dist/saveStore.js +163 -0
  291. package/dist/semanticList.d.ts +122 -0
  292. package/dist/semanticList.js +174 -0
  293. package/dist/semanticTree.d.ts +10 -0
  294. package/dist/semanticTree.js +532 -0
  295. package/dist/semanticTypes.d.ts +167 -0
  296. package/dist/semanticTypes.js +2 -0
  297. package/dist/semantics.d.ts +6 -0
  298. package/dist/semantics.js +5 -0
  299. package/dist/sequencePlayback.d.ts +19 -0
  300. package/dist/sequencePlayback.js +391 -0
  301. package/dist/sequencePlaybackTypes.d.ts +21 -0
  302. package/dist/sequencePlaybackTypes.js +2 -0
  303. package/dist/sequenceTargetClaims.d.ts +10 -0
  304. package/dist/sequenceTargetClaims.js +31 -0
  305. package/dist/srgbBytes.d.ts +3 -0
  306. package/dist/srgbBytes.js +64 -0
  307. package/dist/startEngine.d.ts +5 -0
  308. package/dist/startEngine.js +31 -0
  309. package/dist/surfaceOwnership.d.ts +3 -0
  310. package/dist/surfaceOwnership.js +15 -0
  311. package/dist/text.d.ts +23 -0
  312. package/dist/text.js +4 -0
  313. package/dist/textField.d.ts +6 -0
  314. package/dist/textField.js +6 -0
  315. package/dist/tileMapDraw.d.ts +7 -0
  316. package/dist/tileMapDraw.js +310 -0
  317. package/dist/tiledImport.d.ts +9 -0
  318. package/dist/tiledImport.js +357 -0
  319. package/dist/tilemap.d.ts +5 -0
  320. package/dist/tilemap.js +5 -0
  321. package/dist/tilemapTypes.d.ts +169 -0
  322. package/dist/tilemapTypes.js +2 -0
  323. package/dist/tween.d.ts +15 -0
  324. package/dist/tween.js +329 -0
  325. package/dist/tweenTypes.d.ts +27 -0
  326. package/dist/tweenTypes.js +2 -0
  327. package/dist/ui/controlKeys.d.ts +109 -0
  328. package/dist/ui/controlKeys.js +249 -0
  329. package/dist/ui/controls.d.ts +52 -0
  330. package/dist/ui/controls.js +288 -0
  331. package/dist/ui/editing.d.ts +3 -0
  332. package/dist/ui/editing.js +3 -0
  333. package/dist/ui/index.d.ts +19 -0
  334. package/dist/ui/index.js +11 -0
  335. package/dist/ui/keyboardFocus.d.ts +32 -0
  336. package/dist/ui/keyboardFocus.js +146 -0
  337. package/dist/ui/layerTypes.d.ts +91 -0
  338. package/dist/ui/layerTypes.js +2 -0
  339. package/dist/ui/layers.d.ts +4 -0
  340. package/dist/ui/layers.js +586 -0
  341. package/dist/ui/leafContent.d.ts +21 -0
  342. package/dist/ui/leafContent.js +136 -0
  343. package/dist/ui/rangeControl.d.ts +50 -0
  344. package/dist/ui/rangeControl.js +167 -0
  345. package/dist/ui/scrollControl.d.ts +72 -0
  346. package/dist/ui/scrollControl.js +218 -0
  347. package/dist/ui/stateControls.d.ts +82 -0
  348. package/dist/ui/stateControls.js +328 -0
  349. package/dist/ui/textEditor.d.ts +53 -0
  350. package/dist/ui/textEditor.js +370 -0
  351. package/dist/ui/textEditorTypes.d.ts +78 -0
  352. package/dist/ui/textEditorTypes.js +2 -0
  353. package/dist/ui/textFieldControl.d.ts +96 -0
  354. package/dist/ui/textFieldControl.js +259 -0
  355. package/dist/ui/theme.d.ts +59 -0
  356. package/dist/ui/theme.js +165 -0
  357. package/dist/ui/types.d.ts +265 -0
  358. package/dist/ui/types.js +2 -0
  359. package/dist/ui/uiRoot.d.ts +4 -0
  360. package/dist/ui/uiRoot.js +1497 -0
  361. package/dist/ui/uiRootDisplay.d.ts +46 -0
  362. package/dist/ui/uiRootDisplay.js +148 -0
  363. package/dist/ui/uiRootModel.d.ts +112 -0
  364. package/dist/ui/uiRootModel.js +60 -0
  365. package/dist/ui/virtualList.d.ts +20 -0
  366. package/dist/ui/virtualList.js +105 -0
  367. package/dist/video.d.ts +4 -0
  368. package/dist/video.js +4 -0
  369. package/dist/videoPlayer.d.ts +4 -0
  370. package/dist/videoPlayer.js +215 -0
  371. package/dist/videoTypes.d.ts +74 -0
  372. package/dist/videoTypes.js +2 -0
  373. package/dist/web/BrowserAssetBundle.d.ts +39 -0
  374. package/dist/web/BrowserAssetBundle.js +136 -0
  375. package/dist/web/BrowserAudio.d.ts +41 -0
  376. package/dist/web/BrowserAudio.js +473 -0
  377. package/dist/web/BrowserFrameLoop.d.ts +65 -0
  378. package/dist/web/BrowserFrameLoop.js +125 -0
  379. package/dist/web/BrowserGame.d.ts +112 -0
  380. package/dist/web/BrowserGame.js +352 -0
  381. package/dist/web/BrowserGamepadInput.d.ts +35 -0
  382. package/dist/web/BrowserGamepadInput.js +134 -0
  383. package/dist/web/BrowserHoverInput.d.ts +24 -0
  384. package/dist/web/BrowserHoverInput.js +266 -0
  385. package/dist/web/BrowserImageTextures.d.ts +66 -0
  386. package/dist/web/BrowserImageTextures.js +169 -0
  387. package/dist/web/BrowserInputActions.d.ts +53 -0
  388. package/dist/web/BrowserInputActions.js +342 -0
  389. package/dist/web/BrowserKeyboardInput.d.ts +4 -0
  390. package/dist/web/BrowserKeyboardInput.js +223 -0
  391. package/dist/web/BrowserPlay.d.ts +289 -0
  392. package/dist/web/BrowserPlay.js +1301 -0
  393. package/dist/web/BrowserPointerInput.d.ts +4 -0
  394. package/dist/web/BrowserPointerInput.js +511 -0
  395. package/dist/web/BrowserSemantics.d.ts +34 -0
  396. package/dist/web/BrowserSemantics.js +418 -0
  397. package/dist/web/BrowserStatsPanel.d.ts +46 -0
  398. package/dist/web/BrowserStatsPanel.js +137 -0
  399. package/dist/web/BrowserStorage.d.ts +33 -0
  400. package/dist/web/BrowserStorage.js +132 -0
  401. package/dist/web/BrowserTextEditor.d.ts +49 -0
  402. package/dist/web/BrowserTextEditor.js +839 -0
  403. package/dist/web/BrowserTextInput.d.ts +83 -0
  404. package/dist/web/BrowserTextInput.js +524 -0
  405. package/dist/web/BrowserTextureProvider.d.ts +52 -0
  406. package/dist/web/BrowserTextureProvider.js +935 -0
  407. package/dist/web/BrowserVideo.d.ts +28 -0
  408. package/dist/web/BrowserVideo.js +211 -0
  409. package/dist/web/CanvasKitFontSetProvider.d.ts +29 -0
  410. package/dist/web/CanvasKitFontSetProvider.js +215 -0
  411. package/dist/web/CanvasKitParagraphProvider.d.ts +169 -0
  412. package/dist/web/CanvasKitParagraphProvider.js +691 -0
  413. package/dist/web/CanvasTextRasterProvider.d.ts +4 -0
  414. package/dist/web/CanvasTextRasterProvider.js +312 -0
  415. package/dist/web/ManifestByteSource.d.ts +147 -0
  416. package/dist/web/ManifestByteSource.js +974 -0
  417. package/dist/web/ManifestFontContentLoader.d.ts +12 -0
  418. package/dist/web/ManifestFontContentLoader.js +30 -0
  419. package/dist/web/MouseInput.d.ts +4 -0
  420. package/dist/web/MouseInput.js +218 -0
  421. package/dist/web/WebGL2Host.d.ts +5 -0
  422. package/dist/web/WebGL2Host.js +2672 -0
  423. package/dist/web/WebGPUHost.d.ts +87 -0
  424. package/dist/web/WebGPUHost.js +3349 -0
  425. package/dist/web/audio.d.ts +3 -0
  426. package/dist/web/audio.js +4 -0
  427. package/dist/web/canvasKitParagraphGeometry.d.ts +27 -0
  428. package/dist/web/canvasKitParagraphGeometry.js +83 -0
  429. package/dist/web/editing.d.ts +5 -0
  430. package/dist/web/editing.js +4 -0
  431. package/dist/web/editorFonts.d.ts +50 -0
  432. package/dist/web/editorFonts.js +297 -0
  433. package/dist/web/game.d.ts +5 -0
  434. package/dist/web/game.js +6 -0
  435. package/dist/web/gamepad.d.ts +3 -0
  436. package/dist/web/gamepad.js +4 -0
  437. package/dist/web/hover.d.ts +3 -0
  438. package/dist/web/hover.js +4 -0
  439. package/dist/web/image.d.ts +4 -0
  440. package/dist/web/image.js +4 -0
  441. package/dist/web/imageProjections2D.d.ts +14 -0
  442. package/dist/web/imageProjections2D.js +2 -0
  443. package/dist/web/input.d.ts +6 -0
  444. package/dist/web/input.js +4 -0
  445. package/dist/web/keyboard.d.ts +3 -0
  446. package/dist/web/keyboard.js +3 -0
  447. package/dist/web/kit.d.ts +10 -0
  448. package/dist/web/kit.js +7 -0
  449. package/dist/web/loop.d.ts +3 -0
  450. package/dist/web/loop.js +4 -0
  451. package/dist/web/paragraph.d.ts +6 -0
  452. package/dist/web/paragraph.js +4 -0
  453. package/dist/web/play.d.ts +5 -0
  454. package/dist/web/play.js +6 -0
  455. package/dist/web/playSfx.d.ts +36 -0
  456. package/dist/web/playSfx.js +112 -0
  457. package/dist/web/pointer.d.ts +3 -0
  458. package/dist/web/pointer.js +3 -0
  459. package/dist/web/prepareSharedSubmission2D.d.ts +27 -0
  460. package/dist/web/prepareSharedSubmission2D.js +57 -0
  461. package/dist/web/resources.d.ts +27 -0
  462. package/dist/web/resources.js +96 -0
  463. package/dist/web/semantics.d.ts +3 -0
  464. package/dist/web/semantics.js +4 -0
  465. package/dist/web/sharedDeviceSession.d.ts +64 -0
  466. package/dist/web/sharedDeviceSession.js +2 -0
  467. package/dist/web/sharedEffectShaders.d.ts +9 -0
  468. package/dist/web/sharedEffectShaders.js +165 -0
  469. package/dist/web/sharedFrameUpload.d.ts +25 -0
  470. package/dist/web/sharedFrameUpload.js +2 -0
  471. package/dist/web/sharedHostDeferred.d.ts +7 -0
  472. package/dist/web/sharedHostDeferred.js +12 -0
  473. package/dist/web/sharedRetentionLedger.d.ts +85 -0
  474. package/dist/web/sharedRetentionLedger.js +391 -0
  475. package/dist/web/sharedSubmissionStorage2D.d.ts +56 -0
  476. package/dist/web/sharedSubmissionStorage2D.js +73 -0
  477. package/dist/web/sharedWebGL2Arena.d.ts +40 -0
  478. package/dist/web/sharedWebGL2Arena.js +77 -0
  479. package/dist/web/sharedWebGL2Options.d.ts +30 -0
  480. package/dist/web/sharedWebGL2Options.js +96 -0
  481. package/dist/web/sharedWebGL2Shaders.d.ts +20 -0
  482. package/dist/web/sharedWebGL2Shaders.js +314 -0
  483. package/dist/web/sharedWebGPUOptions.d.ts +37 -0
  484. package/dist/web/sharedWebGPUOptions.js +126 -0
  485. package/dist/web/text.d.ts +3 -0
  486. package/dist/web/text.js +3 -0
  487. package/dist/web/textInput.d.ts +3 -0
  488. package/dist/web/textInput.js +3 -0
  489. package/dist/web/video.d.ts +3 -0
  490. package/dist/web/video.js +4 -0
  491. package/dist/web/webgl2.d.ts +7 -0
  492. package/dist/web/webgl2.js +4 -0
  493. package/dist/web/webgl2LayerState.d.ts +50 -0
  494. package/dist/web/webgl2LayerState.js +102 -0
  495. package/dist/web/webgl2Native.d.ts +70 -0
  496. package/dist/web/webgl2Native.js +568 -0
  497. package/dist/web/webgl2Types.d.ts +132 -0
  498. package/dist/web/webgl2Types.js +2 -0
  499. package/dist/web/webgpu.d.ts +6 -0
  500. package/dist/web/webgpu.js +2 -0
  501. package/dist/web/webgpuBindingCache.d.ts +26 -0
  502. package/dist/web/webgpuBindingCache.js +223 -0
  503. package/dist/web/webgpuBufferPool.d.ts +51 -0
  504. package/dist/web/webgpuBufferPool.js +58 -0
  505. package/dist/web/webgpuImageResidency.d.ts +53 -0
  506. package/dist/web/webgpuImageResidency.js +61 -0
  507. package/dist/web/webgpuLifetime.d.ts +45 -0
  508. package/dist/web/webgpuLifetime.js +64 -0
  509. package/dist/web/webgpuRetentionPool.d.ts +66 -0
  510. package/dist/web/webgpuRetentionPool.js +84 -0
  511. package/dist/web/webgpuSharedPass.d.ts +7 -0
  512. package/dist/web/webgpuSharedPass.js +211 -0
  513. package/dist/web/webgpuSharedResolvePass.d.ts +3 -0
  514. package/dist/web/webgpuSharedResolvePass.js +29 -0
  515. package/dist/web/world3d/Audio3D.d.ts +68 -0
  516. package/dist/web/world3d/Audio3D.js +212 -0
  517. package/dist/web/world3d/BrowserPlay3D.d.ts +182 -0
  518. package/dist/web/world3d/BrowserPlay3D.js +851 -0
  519. package/dist/web/world3d/FlyControls3D.d.ts +55 -0
  520. package/dist/web/world3d/FlyControls3D.js +160 -0
  521. package/dist/web/world3d/FollowControls3D.d.ts +28 -0
  522. package/dist/web/world3d/FollowControls3D.js +117 -0
  523. package/dist/web/world3d/OrbitControls3D.d.ts +55 -0
  524. package/dist/web/world3d/OrbitControls3D.js +187 -0
  525. package/dist/web/world3d/TransformControls3D.d.ts +34 -0
  526. package/dist/web/world3d/TransformControls3D.js +125 -0
  527. package/dist/web/world3d/WebGL2Renderer3D.d.ts +133 -0
  528. package/dist/web/world3d/WebGL2Renderer3D.js +1173 -0
  529. package/dist/web/world3d/WebGPURenderer3D.d.ts +110 -0
  530. package/dist/web/world3d/WebGPURenderer3D.js +1915 -0
  531. package/dist/web/world3d/World3DView.d.ts +51 -0
  532. package/dist/web/world3d/World3DView.js +77 -0
  533. package/dist/web/world3d/app3D.d.ts +136 -0
  534. package/dist/web/world3d/app3D.js +304 -0
  535. package/dist/web/world3d/assets3D.d.ts +38 -0
  536. package/dist/web/world3d/assets3D.js +112 -0
  537. package/dist/web/world3d/atmosphere3D.d.ts +47 -0
  538. package/dist/web/world3d/atmosphere3D.js +178 -0
  539. package/dist/web/world3d/frame3D.d.ts +142 -0
  540. package/dist/web/world3d/frame3D.js +388 -0
  541. package/dist/web/world3d/gpuResources3D.d.ts +98 -0
  542. package/dist/web/world3d/gpuResources3D.js +901 -0
  543. package/dist/web/world3d/host3D.d.ts +23 -0
  544. package/dist/web/world3d/host3D.js +61 -0
  545. package/dist/web/world3d/index.d.ts +38 -0
  546. package/dist/web/world3d/index.js +23 -0
  547. package/dist/web/world3d/loaders3D.d.ts +26 -0
  548. package/dist/web/world3d/loaders3D.js +138 -0
  549. package/dist/web/world3d/markers3D.d.ts +49 -0
  550. package/dist/web/world3d/markers3D.js +130 -0
  551. package/dist/web/world3d/materialWebGL23D.d.ts +34 -0
  552. package/dist/web/world3d/materialWebGL23D.js +218 -0
  553. package/dist/web/world3d/overlay3D.d.ts +28 -0
  554. package/dist/web/world3d/overlay3D.js +170 -0
  555. package/dist/web/world3d/post3D.d.ts +112 -0
  556. package/dist/web/world3d/post3D.js +459 -0
  557. package/dist/web/world3d/postWebGL23D.d.ts +24 -0
  558. package/dist/web/world3d/postWebGL23D.js +237 -0
  559. package/dist/web/world3d/postWebGPU3D.d.ts +23 -0
  560. package/dist/web/world3d/postWebGPU3D.js +255 -0
  561. package/dist/web/world3d/probe3D.d.ts +14 -0
  562. package/dist/web/world3d/probe3D.js +66 -0
  563. package/dist/web/world3d/shaders3D.d.ts +43 -0
  564. package/dist/web/world3d/shaders3D.js +851 -0
  565. package/dist/web/world3d/stats3D.d.ts +31 -0
  566. package/dist/web/world3d/stats3D.js +80 -0
  567. package/dist/web/world3d/webGL2FrameMetrics3D.d.ts +66 -0
  568. package/dist/web/world3d/webGL2FrameMetrics3D.js +185 -0
  569. package/dist/web/world3d/webgpu.d.ts +35 -0
  570. package/dist/web/world3d/webgpu.js +22 -0
  571. package/dist/web/world3d/webgpuPacking3D.d.ts +13 -0
  572. package/dist/web/world3d/webgpuPacking3D.js +85 -0
  573. package/dist/web/world3d/wgsl3D.d.ts +68 -0
  574. package/dist/web/world3d/wgsl3D.js +781 -0
  575. package/package.json +220 -4
@@ -0,0 +1,108 @@
1
+ import { Geometry3D } from './Geometry3D.js';
2
+ import { Material3D } from './Material3D.js';
3
+ import type { SpriteMaterialOptions3D } from './Material3D.js';
4
+ import { Object3D } from './Object3D.js';
5
+ export declare const MESH3D_LIMITS: Readonly<{
6
+ readonly maxBones: 1024;
7
+ readonly maxInstances: 1048576;
8
+ readonly maxMaterials: 64;
9
+ }>;
10
+ export declare class Bone3D extends Object3D {
11
+ constructor();
12
+ }
13
+ /** Ordered bones with their inverse bind matrices; one instance may drive many meshes. */
14
+ export declare class Skeleton3D {
15
+ #private;
16
+ readonly bones: readonly Object3D[];
17
+ /** 16 floats per bone: bind-pose mesh space to bone space. */
18
+ readonly inverseBindMatrices: Float32Array;
19
+ /** 16 floats per bone: boneWorld * inverseBind, refreshed by update(). */
20
+ readonly boneMatrices: Float32Array;
21
+ /** Increases on every update(); backends compare it before re-uploading. */
22
+ version: number;
23
+ constructor(bones: readonly Object3D[], inverseBindMatrices?: Float32Array);
24
+ /** Recompute skinning matrices once per frame id; later calls in the same frame are free. */
25
+ update(frame: number): void;
26
+ }
27
+ export declare class Mesh3D extends Object3D {
28
+ #private;
29
+ /** Optional hook the render list calls once per frame before the mesh is culled and sorted. */
30
+ beforeRender?(camera: import('./Camera3D.js').Camera3D): void;
31
+ geometry: Geometry3D;
32
+ /** false leaves the mesh out of ray picking, as for effects whose drawn shape is not their geometry. */
33
+ pickable: boolean;
34
+ /** One material, or one per geometry group addressed by materialIndex. */
35
+ material: Material3D | Material3D[];
36
+ /** Weight per geometry morph target; resized automatically to the target count. */
37
+ morphWeights: Float32Array;
38
+ skeleton: Skeleton3D | undefined;
39
+ /** Mesh-space to skeleton-space matrix captured at bind time. */
40
+ readonly bindMatrix: Float32Array;
41
+ constructor(geometry?: Geometry3D, material?: Material3D | Material3D[]);
42
+ get isInstanced(): boolean;
43
+ /**
44
+ * True when an instanced draw could stand in for this mesh: it is a plain
45
+ * Mesh3D without skinning or morphing, and its transform is not mirrored.
46
+ * The renderer uses it to fold repeated meshes into one draw.
47
+ */
48
+ get canInstance(): boolean;
49
+ /** Material for a geometry group index, falling back to the first slot. */
50
+ materialAt(index: number): Material3D;
51
+ /** Keep the weight array the same length as the geometry's morph target list. */
52
+ syncMorphWeights(): void;
53
+ /** Attach a skeleton; the current world matrix becomes the bind matrix. */
54
+ bind(skeleton: Skeleton3D, bindMatrix?: ArrayLike<number>): this;
55
+ /**
56
+ * World-space bounding sphere [x, y, z, radius], cached per geometry and
57
+ * world version. Skinned meshes are bounded by their bones instead.
58
+ */
59
+ get worldBoundingSphere(): Float32Array;
60
+ private skinnedBounds;
61
+ clone(recursive?: boolean): this;
62
+ protected copyFrom(source: this): void;
63
+ }
64
+ interface InstanceStreamRevisions {
65
+ observed: number;
66
+ matrices: number;
67
+ colors: number;
68
+ }
69
+ declare const readInstanceStreamRevisions: unique symbol;
70
+ /** Reconcile legacy bulk edits before a renderer checks either instance stream. */
71
+ export declare function instanceStreamRevisions3D(mesh: InstancedMesh3D): Readonly<InstanceStreamRevisions>;
72
+ /** Draw one geometry many times in a single call with per-instance transforms and colors. */
73
+ export declare class InstancedMesh3D extends Mesh3D {
74
+ #private;
75
+ readonly capacity: number;
76
+ /** Number of instances drawn; at most `capacity`. */
77
+ count: number;
78
+ /** 16 floats per instance, relative to this node. */
79
+ readonly instanceMatrices: Float32Array;
80
+ /** Optional linear RGB (or RGBA) per instance, created on first setColorAt(). */
81
+ instanceColors: Float32Array | undefined;
82
+ /** Components per instance color: 3 for RGB, 4 when instances also carry opacity. */
83
+ readonly instanceColorSize: 3 | 4;
84
+ /** Bump after editing instance arrays directly. */
85
+ instanceVersion: number;
86
+ /** Multiplies each instance's bounding radius, for instances that move beyond the geometry, such as animated ones. */
87
+ boundsScale: number;
88
+ constructor(geometry: Geometry3D, material: Material3D | Material3D[], capacity: number, instanceColorSize?: 3 | 4);
89
+ get isInstanced(): boolean;
90
+ setMatrixAt(index: number, matrix: ArrayLike<number>): void;
91
+ setTransformAt(index: number, position: ArrayLike<number>, quaternion?: ArrayLike<number>, scale?: ArrayLike<number> | number): void;
92
+ setColorAt(index: number, r: number, g: number, b: number, a?: number): void;
93
+ [readInstanceStreamRevisions](): InstanceStreamRevisions;
94
+ private touchInstanceStream;
95
+ /** Sphere enclosing every instance, in world space. */
96
+ get worldBoundingSphere(): Float32Array;
97
+ private readonly localSphere;
98
+ clone(): this;
99
+ }
100
+ /** Camera-facing textured quad. Scale the node to size it; all sprites share one quad geometry. */
101
+ export declare class Sprite3D extends Mesh3D {
102
+ constructor(material?: Material3D);
103
+ get worldBoundingSphere(): Float32Array;
104
+ clone(): this;
105
+ }
106
+ export declare function createSprite3D(options?: SpriteMaterialOptions3D): Sprite3D;
107
+ export {};
108
+ //# sourceMappingURL=Mesh3D.d.ts.map
@@ -0,0 +1,323 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // Renderable nodes: meshes with optional skinning, morphing and instancing,
3
+ // plus bones, skeletons and camera-facing sprites.
4
+ import { World3DError, requireCount3D } from './core3D.js';
5
+ import { Geometry3D } from './Geometry3D.js';
6
+ import { Material3D, createSpriteMaterial3D } from './Material3D.js';
7
+ import { box3Empty, box3ExpandByPoint, mat4Compose, mat4Copy, mat4Identity, mat4Invert, mat4Multiply, sphereFromBox, sphereTransform } from './math3D.js';
8
+ import { Object3D } from './Object3D.js';
9
+ import { createQuadGeometry3D } from './primitives3D.js';
10
+ export const MESH3D_LIMITS = Object.freeze({ maxBones: 1024, maxInstances: 1048576, maxMaterials: 64 });
11
+ export class Bone3D extends Object3D {
12
+ constructor() {
13
+ super('bone');
14
+ }
15
+ }
16
+ /** Ordered bones with their inverse bind matrices; one instance may drive many meshes. */
17
+ export class Skeleton3D {
18
+ bones;
19
+ /** 16 floats per bone: bind-pose mesh space to bone space. */
20
+ inverseBindMatrices;
21
+ /** 16 floats per bone: boneWorld * inverseBind, refreshed by update(). */
22
+ boneMatrices;
23
+ /** Increases on every update(); backends compare it before re-uploading. */
24
+ version = 0;
25
+ #lastFrame = -1;
26
+ constructor(bones, inverseBindMatrices) {
27
+ requireCount3D(bones.length, 'bones', MESH3D_LIMITS.maxBones);
28
+ if (inverseBindMatrices && inverseBindMatrices.length !== bones.length * 16)
29
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'inverseBindMatrices');
30
+ this.bones = Object.freeze([...bones]);
31
+ this.boneMatrices = new Float32Array(bones.length * 16);
32
+ if (inverseBindMatrices)
33
+ this.inverseBindMatrices = inverseBindMatrices;
34
+ else {
35
+ // Without explicit data, the current pose becomes the bind pose.
36
+ this.inverseBindMatrices = new Float32Array(bones.length * 16);
37
+ bones.forEach((bone, index) => {
38
+ bone.updateWorldMatrix();
39
+ const view = this.inverseBindMatrices.subarray(index * 16, index * 16 + 16);
40
+ if (!mat4Invert(view, bone.matrixWorld))
41
+ mat4Identity(view);
42
+ });
43
+ }
44
+ }
45
+ /** Recompute skinning matrices once per frame id; later calls in the same frame are free. */
46
+ update(frame) {
47
+ if (frame === this.#lastFrame)
48
+ return;
49
+ this.#lastFrame = frame;
50
+ const bones = this.bones, out = this.boneMatrices, inverse = this.inverseBindMatrices;
51
+ // Written out in place: a view per bone per frame would be thousands of short-lived objects.
52
+ for (let i = 0; i < bones.length; i++) {
53
+ const o = i * 16, a = bones[i].matrixWorld;
54
+ const a00 = a[0], a01 = a[1], a02 = a[2], a10 = a[4], a11 = a[5], a12 = a[6], a20 = a[8], a21 = a[9], a22 = a[10], a30 = a[12], a31 = a[13], a32 = a[14];
55
+ for (let column = 0; column < 4; column++) {
56
+ const c = o + column * 4, b0 = inverse[c], b1 = inverse[c + 1], b2 = inverse[c + 2], b3 = inverse[c + 3];
57
+ out[c] = a00 * b0 + a10 * b1 + a20 * b2 + a30 * b3;
58
+ out[c + 1] = a01 * b0 + a11 * b1 + a21 * b2 + a31 * b3;
59
+ out[c + 2] = a02 * b0 + a12 * b1 + a22 * b2 + a32 * b3;
60
+ // Bone and bind matrices are affine, so the last row stays 0 0 0 1.
61
+ out[c + 3] = b3;
62
+ }
63
+ }
64
+ this.version++;
65
+ }
66
+ }
67
+ export class Mesh3D extends Object3D {
68
+ geometry;
69
+ /** false leaves the mesh out of ray picking, as for effects whose drawn shape is not their geometry. */
70
+ pickable = true;
71
+ /** One material, or one per geometry group addressed by materialIndex. */
72
+ material;
73
+ /** Weight per geometry morph target; resized automatically to the target count. */
74
+ morphWeights = new Float32Array(0);
75
+ skeleton;
76
+ /** Mesh-space to skeleton-space matrix captured at bind time. */
77
+ bindMatrix = mat4Identity(new Float32Array(16));
78
+ #worldSphere = new Float32Array(4);
79
+ #sphereGeometry;
80
+ // Whether this is exactly a Mesh3D, and whether its transform keeps the winding: asked for every mesh on every frame.
81
+ #exact = false;
82
+ #windingWorld = -1;
83
+ #winding = true;
84
+ #sphereVersion = -1;
85
+ #sphereWorld = -1;
86
+ constructor(geometry = new Geometry3D(), material = new Material3D('unlit')) {
87
+ super('mesh');
88
+ this.#exact = new.target === Mesh3D;
89
+ if (!(geometry instanceof Geometry3D))
90
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'geometry');
91
+ const list = Array.isArray(material) ? material : [material];
92
+ if (list.length === 0 ||
93
+ list.length > MESH3D_LIMITS.maxMaterials ||
94
+ !list.every(item => item instanceof Material3D))
95
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'material');
96
+ this.geometry = geometry;
97
+ this.material = material;
98
+ this.castShadow = true;
99
+ this.syncMorphWeights();
100
+ }
101
+ get isInstanced() {
102
+ return false;
103
+ }
104
+ /**
105
+ * True when an instanced draw could stand in for this mesh: it is a plain
106
+ * Mesh3D without skinning or morphing, and its transform is not mirrored.
107
+ * The renderer uses it to fold repeated meshes into one draw.
108
+ */
109
+ get canInstance() {
110
+ if (!this.#exact || this.skeleton !== undefined || this.geometry.morphTargets.length > 0)
111
+ return false;
112
+ const version = this.worldVersion;
113
+ if (version !== this.#windingWorld) {
114
+ const m = this.matrixWorld;
115
+ this.#winding =
116
+ m[0] * (m[5] * m[10] - m[6] * m[9]) -
117
+ m[4] * (m[1] * m[10] - m[2] * m[9]) +
118
+ m[8] * (m[1] * m[6] - m[2] * m[5]) >
119
+ 0;
120
+ this.#windingWorld = version;
121
+ }
122
+ return this.#winding;
123
+ }
124
+ /** Material for a geometry group index, falling back to the first slot. */
125
+ materialAt(index) {
126
+ return Array.isArray(this.material) ? (this.material[index] ?? this.material[0]) : this.material;
127
+ }
128
+ /** Keep the weight array the same length as the geometry's morph target list. */
129
+ syncMorphWeights() {
130
+ const count = this.geometry.morphTargets.length;
131
+ if (this.morphWeights.length !== count) {
132
+ const next = new Float32Array(count);
133
+ next.set(this.morphWeights.subarray(0, Math.min(count, this.morphWeights.length)));
134
+ this.morphWeights = next;
135
+ }
136
+ }
137
+ /** Attach a skeleton; the current world matrix becomes the bind matrix. */
138
+ bind(skeleton, bindMatrix) {
139
+ this.skeleton = skeleton;
140
+ if (bindMatrix)
141
+ mat4Copy(this.bindMatrix, bindMatrix);
142
+ else {
143
+ this.updateWorldMatrix();
144
+ mat4Copy(this.bindMatrix, this.matrixWorld);
145
+ }
146
+ return this;
147
+ }
148
+ /**
149
+ * World-space bounding sphere [x, y, z, radius], cached per geometry and
150
+ * world version. Skinned meshes are bounded by their bones instead.
151
+ */
152
+ get worldBoundingSphere() {
153
+ if (this.skeleton)
154
+ return this.skinnedBounds();
155
+ // Compared as numbers: this runs for every mesh on every frame.
156
+ const geometry = this.geometry, version = geometry.version, world = this.worldVersion;
157
+ if (geometry !== this.#sphereGeometry || version !== this.#sphereVersion || world !== this.#sphereWorld) {
158
+ sphereTransform(this.#worldSphere, geometry.boundingSphere, this.matrixWorld);
159
+ this.#sphereGeometry = geometry;
160
+ this.#sphereVersion = version;
161
+ this.#sphereWorld = world;
162
+ }
163
+ return this.#worldSphere;
164
+ }
165
+ skinnedBounds() {
166
+ const box = box3Empty(new Float32Array(6));
167
+ for (const bone of this.skeleton.bones)
168
+ box3ExpandByPoint(box, bone.matrixWorld[12], bone.matrixWorld[13], bone.matrixWorld[14]);
169
+ sphereFromBox(this.#worldSphere, box);
170
+ // Pad by the rest-pose radius so skin extending beyond joints stays visible.
171
+ const rest = this.geometry.boundingSphere[3];
172
+ if (this.#worldSphere[3] >= 0 && rest > 0)
173
+ this.#worldSphere[3] += rest * 0.5;
174
+ return this.#worldSphere;
175
+ }
176
+ clone(recursive = true) {
177
+ const copy = new Mesh3D(this.geometry, this.material);
178
+ copy.copyFrom(this);
179
+ if (recursive)
180
+ for (const child of this.children)
181
+ copy.addChild(child.clone(true));
182
+ return copy;
183
+ }
184
+ copyFrom(source) {
185
+ super.copyFrom(source);
186
+ this.morphWeights = source.morphWeights.slice();
187
+ this.skeleton = source.skeleton;
188
+ this.bindMatrix.set(source.bindMatrix);
189
+ }
190
+ }
191
+ const scratchScale = new Float32Array(3);
192
+ const readInstanceStreamRevisions = Symbol('instanceStreamRevisions3D');
193
+ /** Reconcile legacy bulk edits before a renderer checks either instance stream. */
194
+ export function instanceStreamRevisions3D(mesh) {
195
+ return mesh[readInstanceStreamRevisions]();
196
+ }
197
+ /** Draw one geometry many times in a single call with per-instance transforms and colors. */
198
+ export class InstancedMesh3D extends Mesh3D {
199
+ capacity;
200
+ /** Number of instances drawn; at most `capacity`. */
201
+ count;
202
+ /** 16 floats per instance, relative to this node. */
203
+ instanceMatrices;
204
+ /** Optional linear RGB (or RGBA) per instance, created on first setColorAt(). */
205
+ instanceColors;
206
+ /** Components per instance color: 3 for RGB, 4 when instances also carry opacity. */
207
+ instanceColorSize;
208
+ /** Bump after editing instance arrays directly. */
209
+ instanceVersion = 1;
210
+ #streamRevisions = { observed: 1, matrices: 1, colors: 1 };
211
+ /** Multiplies each instance's bounding radius, for instances that move beyond the geometry, such as animated ones. */
212
+ boundsScale = 1;
213
+ #boundsVersion = 0;
214
+ #boundsCount = -1;
215
+ #instanceSphere = new Float32Array(4);
216
+ constructor(geometry, material, capacity, instanceColorSize = 3) {
217
+ super(geometry, material);
218
+ if (instanceColorSize !== 3 && instanceColorSize !== 4)
219
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'instanceColorSize');
220
+ this.instanceColorSize = instanceColorSize;
221
+ this.capacity = requireCount3D(capacity, 'capacity', MESH3D_LIMITS.maxInstances);
222
+ this.count = this.capacity;
223
+ this.instanceMatrices = new Float32Array(this.capacity * 16);
224
+ for (let i = 0; i < this.capacity; i++)
225
+ mat4Identity(this.instanceMatrices.subarray(i * 16, i * 16 + 16));
226
+ }
227
+ get isInstanced() {
228
+ return true;
229
+ }
230
+ setMatrixAt(index, matrix) {
231
+ if (!Number.isSafeInteger(index) || index < 0 || index >= this.capacity)
232
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'instance index');
233
+ for (let i = 0; i < 16; i++)
234
+ this.instanceMatrices[index * 16 + i] = matrix[i];
235
+ this.touchInstanceStream('matrices');
236
+ }
237
+ setTransformAt(index, position, quaternion = [0, 0, 0, 1], scale = 1) {
238
+ if (!Number.isSafeInteger(index) || index < 0 || index >= this.capacity)
239
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'instance index');
240
+ const s = typeof scale === 'number' ? ((scratchScale[0] = scratchScale[1] = scratchScale[2] = scale), scratchScale) : scale;
241
+ mat4Compose(this.instanceMatrices.subarray(index * 16, index * 16 + 16), position, quaternion, s);
242
+ this.touchInstanceStream('matrices');
243
+ }
244
+ setColorAt(index, r, g, b, a = 1) {
245
+ if (!Number.isSafeInteger(index) || index < 0 || index >= this.capacity)
246
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'instance index');
247
+ const size = this.instanceColorSize, colors = (this.instanceColors ??= new Float32Array(this.capacity * size).fill(1));
248
+ colors[index * size] = r;
249
+ colors[index * size + 1] = g;
250
+ colors[index * size + 2] = b;
251
+ if (size === 4)
252
+ colors[index * size + 3] = a;
253
+ this.touchInstanceStream('colors');
254
+ }
255
+ [readInstanceStreamRevisions]() {
256
+ const revisions = this.#streamRevisions;
257
+ if (revisions.observed !== this.instanceVersion) {
258
+ revisions.observed = this.instanceVersion;
259
+ revisions.matrices++;
260
+ revisions.colors++;
261
+ }
262
+ return revisions;
263
+ }
264
+ touchInstanceStream(stream) {
265
+ // A raw write can precede a narrow setter before either stream reaches a renderer.
266
+ const revisions = this[readInstanceStreamRevisions]();
267
+ revisions.observed = ++this.instanceVersion;
268
+ revisions[stream]++;
269
+ }
270
+ /** Sphere enclosing every instance, in world space. */
271
+ get worldBoundingSphere() {
272
+ const sphere = this.#instanceSphere;
273
+ if (this.#boundsVersion !== this.instanceVersion || this.#boundsCount !== this.count) {
274
+ const base = this.geometry.boundingSphere, box = box3Empty(new Float32Array(6)), m = this.instanceMatrices;
275
+ let radius = 0;
276
+ for (let i = 0; i < this.count; i++) {
277
+ const o = i * 16, x = base[0], y = base[1], z = base[2];
278
+ box3ExpandByPoint(box, m[o] * x + m[o + 4] * y + m[o + 8] * z + m[o + 12], m[o + 1] * x + m[o + 5] * y + m[o + 9] * z + m[o + 13], m[o + 2] * x + m[o + 6] * y + m[o + 10] * z + m[o + 14]);
279
+ const scale = Math.sqrt(Math.max(m[o] ** 2 + m[o + 1] ** 2 + m[o + 2] ** 2, m[o + 4] ** 2 + m[o + 5] ** 2 + m[o + 6] ** 2, m[o + 8] ** 2 + m[o + 9] ** 2 + m[o + 10] ** 2));
280
+ radius = Math.max(radius, base[3] * scale * this.boundsScale);
281
+ }
282
+ sphereFromBox(this.localSphere, box);
283
+ if (this.localSphere[3] >= 0)
284
+ this.localSphere[3] += radius;
285
+ this.#boundsVersion = this.instanceVersion;
286
+ this.#boundsCount = this.count;
287
+ }
288
+ return sphereTransform(sphere, this.localSphere, this.matrixWorld);
289
+ }
290
+ localSphere = new Float32Array(4);
291
+ clone() {
292
+ const copy = new InstancedMesh3D(this.geometry, this.material, this.capacity, this.instanceColorSize);
293
+ copy.copyFrom(this);
294
+ copy.count = this.count;
295
+ copy.instanceMatrices.set(this.instanceMatrices);
296
+ if (this.instanceColors)
297
+ copy.instanceColors = this.instanceColors.slice();
298
+ return copy;
299
+ }
300
+ }
301
+ let sharedQuad;
302
+ /** Camera-facing textured quad. Scale the node to size it; all sprites share one quad geometry. */
303
+ export class Sprite3D extends Mesh3D {
304
+ constructor(material = createSpriteMaterial3D()) {
305
+ super((sharedQuad ??= createQuadGeometry3D()), material);
306
+ this.castShadow = false;
307
+ this.receiveShadow = false;
308
+ }
309
+ get worldBoundingSphere() {
310
+ // A billboard may rotate to any orientation: bound it by its diagonal.
311
+ const sphere = super.worldBoundingSphere;
312
+ return sphere;
313
+ }
314
+ clone() {
315
+ const copy = new Sprite3D(this.material);
316
+ copy.copyFrom(this);
317
+ return copy;
318
+ }
319
+ }
320
+ export function createSprite3D(options = {}) {
321
+ return new Sprite3D(createSpriteMaterial3D(options));
322
+ }
323
+ //# sourceMappingURL=Mesh3D.js.map
@@ -0,0 +1,12 @@
1
+ export type MeshoptMode3D = 'ATTRIBUTES' | 'TRIANGLES' | 'INDICES';
2
+ export type MeshoptFilter3D = 'NONE' | 'OCTAHEDRAL' | 'QUATERNION' | 'EXPONENTIAL';
3
+ export declare const MESHOPT3D_LIMITS: Readonly<{
4
+ readonly maxStride: 256;
5
+ readonly maxElements: 268435456;
6
+ }>;
7
+ /**
8
+ * Decode one EXT_meshopt_compression buffer view. `count` elements of
9
+ * `stride` bytes are returned; for the two index modes the stride is 2 or 4.
10
+ */
11
+ export declare function decodeMeshopt3D(source: Uint8Array, count: number, stride: number, mode: MeshoptMode3D, filter?: MeshoptFilter3D): Uint8Array;
12
+ //# sourceMappingURL=Meshopt3D.d.ts.map