@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,95 @@
1
+ import type { Object3D } from './Object3D.js';
2
+ export type AnimationPath3D = 'position' | 'quaternion' | 'scale' | 'weights';
3
+ export type AnimationInterpolation3D = 'step' | 'linear' | 'cubic';
4
+ export type AnimationLoop3D = 'repeat' | 'once' | 'pingpong';
5
+ export declare const ANIMATION3D_LIMITS: Readonly<{
6
+ readonly maxTracks: 4096;
7
+ readonly maxKeys: 1048576;
8
+ readonly maxActions: 256;
9
+ }>;
10
+ export interface AnimationTrackInput3D {
11
+ /** Name of the animated node, resolved under the mixer root. */
12
+ readonly targetName: string;
13
+ readonly path: AnimationPath3D;
14
+ /** Strictly increasing key times in seconds. */
15
+ readonly times: ArrayLike<number>;
16
+ /**
17
+ * Key values, `size` numbers per key. Cubic tracks store in-tangent,
18
+ * value and out-tangent for every key (3 * size numbers), as in glTF.
19
+ */
20
+ readonly values: ArrayLike<number>;
21
+ readonly interpolation?: AnimationInterpolation3D;
22
+ }
23
+ export interface AnimationTrack3D {
24
+ readonly targetName: string;
25
+ readonly path: AnimationPath3D;
26
+ readonly times: Float32Array;
27
+ readonly values: Float32Array;
28
+ readonly interpolation: AnimationInterpolation3D;
29
+ /** Components per key: 3, 4, or the morph target count. */
30
+ readonly size: number;
31
+ }
32
+ export declare class AnimationClip3D {
33
+ readonly name: string;
34
+ readonly tracks: readonly AnimationTrack3D[];
35
+ readonly duration: number;
36
+ constructor(name: string, tracks: readonly AnimationTrackInput3D[], duration?: number);
37
+ }
38
+ export declare function createAnimationClip3D(input: {
39
+ readonly name?: string;
40
+ readonly tracks: readonly AnimationTrackInput3D[];
41
+ readonly duration?: number;
42
+ }): AnimationClip3D;
43
+ /** Evaluate one track at `time` into `out`; `hint` caches the last key index. */
44
+ export declare function sampleAnimationTrack3D(track: AnimationTrack3D, time: number, out: Float32Array, hint: {
45
+ index: number;
46
+ }): void;
47
+ export declare class AnimationAction3D {
48
+ #private;
49
+ readonly clip: AnimationClip3D;
50
+ /** Blend weight before fading is applied. */
51
+ weight: number;
52
+ timeScale: number;
53
+ loop: AnimationLoop3D;
54
+ /** Hold the last frame after a 'once' action ends instead of releasing the pose. */
55
+ clampWhenFinished: boolean;
56
+ paused: boolean;
57
+ /** Invoked once when a non-repeating action reaches its end. */
58
+ onFinished: ((action: AnimationAction3D) => void) | undefined;
59
+ /** @internal Created by AnimationMixer3D.clipAction(). */
60
+ constructor(clip: AnimationClip3D, bound: readonly unknown[]);
61
+ get time(): number;
62
+ set time(value: number);
63
+ get isRunning(): boolean;
64
+ /** Weight actually applied this frame, including any fade in progress. */
65
+ get effectiveWeight(): number;
66
+ play(): this;
67
+ /** Stop contributing and rewind. */
68
+ stop(): this;
69
+ reset(): this;
70
+ fadeIn(seconds: number): this;
71
+ fadeOut(seconds: number): this;
72
+ /** Fade this action out while fading `next` in over the same interval. */
73
+ crossFadeTo(next: AnimationAction3D, seconds: number): this;
74
+ private currentFade;
75
+ private fade;
76
+ /** @internal Advance time and add this action's samples to the property mixes. */
77
+ advance(delta: number, scratch: Float32Array): void;
78
+ }
79
+ /** Plays clips on the subtree under `root`, blending concurrent actions by weight. */
80
+ export declare class AnimationMixer3D {
81
+ #private;
82
+ readonly root: Object3D;
83
+ timeScale: number;
84
+ constructor(root: Object3D);
85
+ /** Create (or return the existing) action for a clip. Tracks whose target is missing are skipped. */
86
+ clipAction(clip: AnimationClip3D): AnimationAction3D;
87
+ /** Advance every running action by `deltaSeconds` and write the blended pose. */
88
+ update(deltaSeconds: number): void;
89
+ stopAll(): void;
90
+ /** Stop every action and restore the pose captured when each property was first bound. */
91
+ restorePose(): void;
92
+ /** Forget an action so its clip can be collected. */
93
+ uncache(clip: AnimationClip3D): void;
94
+ }
95
+ //# sourceMappingURL=Animation3D.d.ts.map
@@ -0,0 +1,380 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // Keyframe animation: tracks, clips and a mixer that blends any number of
3
+ // weighted actions onto a node hierarchy. Time is explicit; the mixer never
4
+ // reads a clock, so callers drive it from the Engine game clock.
5
+ import { World3DError, requireCount3D, requireFinite3D } from './core3D.js';
6
+ import { quatNormalize, quatSlerp } from './math3D.js';
7
+ import { Mesh3D } from './Mesh3D.js';
8
+ export const ANIMATION3D_LIMITS = Object.freeze({ maxTracks: 4096, maxKeys: 1048576, maxActions: 256 });
9
+ export class AnimationClip3D {
10
+ name;
11
+ tracks;
12
+ duration;
13
+ constructor(name, tracks, duration) {
14
+ if (typeof name !== 'string')
15
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'clip name');
16
+ requireCount3D(tracks.length, 'tracks', ANIMATION3D_LIMITS.maxTracks);
17
+ let end = 0;
18
+ this.tracks = Object.freeze(tracks.map(input => {
19
+ const times = Float32Array.from(input.times), values = Float32Array.from(input.values);
20
+ const interpolation = input.interpolation ?? 'linear';
21
+ requireCount3D(times.length, 'keys', ANIMATION3D_LIMITS.maxKeys);
22
+ if (times.length === 0 || typeof input.targetName !== 'string')
23
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'track');
24
+ for (let i = 0; i < times.length; i++) {
25
+ if (!Number.isFinite(times[i]) || times[i] < 0 || (i > 0 && times[i] <= times[i - 1]))
26
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'track times');
27
+ }
28
+ const perKey = values.length / times.length / (interpolation === 'cubic' ? 3 : 1);
29
+ const fixed = input.path === 'quaternion' ? 4 : input.path === 'weights' ? perKey : 3;
30
+ if (!Number.isSafeInteger(perKey) || perKey < 1 || perKey !== fixed)
31
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'track values');
32
+ end = Math.max(end, times[times.length - 1]);
33
+ return Object.freeze({
34
+ targetName: input.targetName,
35
+ path: input.path,
36
+ times,
37
+ values,
38
+ interpolation,
39
+ size: perKey
40
+ });
41
+ }));
42
+ this.name = name;
43
+ this.duration = duration === undefined ? end : requireFinite3D(duration, 'clip duration');
44
+ }
45
+ }
46
+ export function createAnimationClip3D(input) {
47
+ return new AnimationClip3D(input.name ?? '', input.tracks, input.duration);
48
+ }
49
+ /** Evaluate one track at `time` into `out`; `hint` caches the last key index. */
50
+ export function sampleAnimationTrack3D(track, time, out, hint) {
51
+ const times = track.times, values = track.values, size = track.size, last = times.length - 1;
52
+ const cubic = track.interpolation === 'cubic', stride = cubic ? size * 3 : size, valueOffset = cubic ? size : 0;
53
+ if (time <= times[0] || last === 0) {
54
+ for (let i = 0; i < size; i++)
55
+ out[i] = values[valueOffset + i];
56
+ return;
57
+ }
58
+ if (time >= times[last]) {
59
+ for (let i = 0; i < size; i++)
60
+ out[i] = values[last * stride + valueOffset + i];
61
+ return;
62
+ }
63
+ // Playback usually advances monotonically: try the cached interval, then
64
+ // its successor, before falling back to binary search.
65
+ let index = hint.index;
66
+ if (!(index >= 0 && index < last && times[index] <= time && time < times[index + 1])) {
67
+ if (index + 1 < last && times[index + 1] <= time && time < times[index + 2])
68
+ index++;
69
+ else {
70
+ let low = 0, high = last;
71
+ while (high - low > 1) {
72
+ const middle = (low + high) >> 1;
73
+ if (times[middle] <= time)
74
+ low = middle;
75
+ else
76
+ high = middle;
77
+ }
78
+ index = low;
79
+ }
80
+ hint.index = index;
81
+ }
82
+ const t0 = times[index], span = times[index + 1] - t0, t = (time - t0) / span;
83
+ const a = index * stride + valueOffset, b = a + stride;
84
+ if (track.interpolation === 'step') {
85
+ for (let i = 0; i < size; i++)
86
+ out[i] = values[a + i];
87
+ }
88
+ else if (cubic) {
89
+ // Hermite spline with glTF tangents scaled by the key interval.
90
+ const t2 = t * t, t3 = t2 * t, h00 = 2 * t3 - 3 * t2 + 1, h10 = (t3 - 2 * t2 + t) * span, h01 = -2 * t3 + 3 * t2, h11 = (t3 - t2) * span;
91
+ for (let i = 0; i < size; i++) {
92
+ out[i] = h00 * values[a + i] + h10 * values[a + size + i] + h01 * values[b + i] + h11 * values[b - size + i];
93
+ }
94
+ if (track.path === 'quaternion')
95
+ quatNormalize(out, out);
96
+ }
97
+ else if (track.path === 'quaternion') {
98
+ quatSlerp(out, values.subarray(a, a + 4), values.subarray(b, b + 4), t);
99
+ }
100
+ else {
101
+ for (let i = 0; i < size; i++)
102
+ out[i] = values[a + i] + (values[b + i] - values[a + i]) * t;
103
+ }
104
+ }
105
+ /** Accumulates weighted samples for one animated property of one node. */
106
+ class PropertyMix {
107
+ target;
108
+ path;
109
+ size;
110
+ accumulated;
111
+ rest;
112
+ weight = 0;
113
+ constructor(target, path, size) {
114
+ this.target = target;
115
+ this.path = path;
116
+ this.size = size;
117
+ this.accumulated = new Float32Array(size);
118
+ this.rest = Float32Array.from(this.storage());
119
+ }
120
+ storage() {
121
+ const target = this.target;
122
+ if (this.path === 'position')
123
+ return target.position;
124
+ if (this.path === 'quaternion')
125
+ return target.quaternion;
126
+ if (this.path === 'scale')
127
+ return target.scale;
128
+ return target.morphWeights;
129
+ }
130
+ add(sample, weight) {
131
+ const accumulated = this.accumulated, size = this.size;
132
+ if (this.weight === 0) {
133
+ for (let i = 0; i < size; i++)
134
+ accumulated[i] = sample[i] * weight;
135
+ }
136
+ else if (this.path === 'quaternion') {
137
+ // Keep both rotations in the same hemisphere before the weighted sum.
138
+ const sign = accumulated[0] * sample[0] +
139
+ accumulated[1] * sample[1] +
140
+ accumulated[2] * sample[2] +
141
+ accumulated[3] * sample[3] <
142
+ 0
143
+ ? -weight
144
+ : weight;
145
+ for (let i = 0; i < 4; i++)
146
+ accumulated[i] += sample[i] * sign;
147
+ }
148
+ else {
149
+ for (let i = 0; i < size; i++)
150
+ accumulated[i] += sample[i] * weight;
151
+ }
152
+ this.weight += weight;
153
+ }
154
+ /** Write the blended value; missing weight is filled from the rest pose. */
155
+ apply() {
156
+ const weight = this.weight;
157
+ if (weight === 0)
158
+ return;
159
+ const accumulated = this.accumulated, storage = this.storage(), size = Math.min(this.size, storage.length);
160
+ if (weight < 1)
161
+ this.add(this.rest, 1 - weight);
162
+ const total = this.weight;
163
+ if (this.path === 'quaternion')
164
+ quatNormalize(storage, accumulated);
165
+ else
166
+ for (let i = 0; i < size; i++)
167
+ storage[i] = accumulated[i] / total;
168
+ if (this.path !== 'weights')
169
+ this.target.markTransformDirty();
170
+ this.weight = 0;
171
+ }
172
+ restore() {
173
+ this.storage().set(this.rest.subarray(0, this.storage().length));
174
+ if (this.path !== 'weights')
175
+ this.target.markTransformDirty();
176
+ }
177
+ }
178
+ export class AnimationAction3D {
179
+ clip;
180
+ /** Blend weight before fading is applied. */
181
+ weight = 1;
182
+ timeScale = 1;
183
+ loop = 'repeat';
184
+ /** Hold the last frame after a 'once' action ends instead of releasing the pose. */
185
+ clampWhenFinished = false;
186
+ paused = false;
187
+ /** Invoked once when a non-repeating action reaches its end. */
188
+ onFinished;
189
+ #time = 0;
190
+ #running = false;
191
+ #direction = 1;
192
+ #fadeFrom = 1;
193
+ #fadeTo = 1;
194
+ #fadeDuration = 0;
195
+ #fadeElapsed = 0;
196
+ #bound;
197
+ /** @internal Created by AnimationMixer3D.clipAction(). */
198
+ constructor(clip, bound) {
199
+ this.clip = clip;
200
+ this.#bound = bound;
201
+ }
202
+ get time() {
203
+ return this.#time;
204
+ }
205
+ set time(value) {
206
+ this.#time = Math.max(0, Math.min(this.clip.duration, requireFinite3D(value, 'time')));
207
+ }
208
+ get isRunning() {
209
+ return this.#running;
210
+ }
211
+ /** Weight actually applied this frame, including any fade in progress. */
212
+ get effectiveWeight() {
213
+ if (!this.#running)
214
+ return 0;
215
+ const fade = this.#fadeDuration > 0
216
+ ? this.#fadeFrom + (this.#fadeTo - this.#fadeFrom) * Math.min(1, this.#fadeElapsed / this.#fadeDuration)
217
+ : this.#fadeTo;
218
+ return this.weight * fade;
219
+ }
220
+ play() {
221
+ this.#running = true;
222
+ return this;
223
+ }
224
+ /** Stop contributing and rewind. */
225
+ stop() {
226
+ this.#running = false;
227
+ return this.reset();
228
+ }
229
+ reset() {
230
+ this.#time = 0;
231
+ this.#direction = 1;
232
+ this.paused = false;
233
+ this.#fadeFrom = this.#fadeTo = 1;
234
+ this.#fadeDuration = this.#fadeElapsed = 0;
235
+ return this;
236
+ }
237
+ fadeIn(seconds) {
238
+ return this.fade(0, 1, seconds);
239
+ }
240
+ fadeOut(seconds) {
241
+ return this.fade(this.currentFade(), 0, seconds);
242
+ }
243
+ /** Fade this action out while fading `next` in over the same interval. */
244
+ crossFadeTo(next, seconds) {
245
+ this.fadeOut(seconds);
246
+ next.reset().play().fadeIn(seconds);
247
+ return this;
248
+ }
249
+ currentFade() {
250
+ return this.#fadeDuration > 0
251
+ ? this.#fadeFrom + (this.#fadeTo - this.#fadeFrom) * Math.min(1, this.#fadeElapsed / this.#fadeDuration)
252
+ : this.#fadeTo;
253
+ }
254
+ fade(from, to, seconds) {
255
+ this.#fadeFrom = from;
256
+ this.#fadeTo = to;
257
+ this.#fadeDuration = Math.max(0, requireFinite3D(seconds, 'fade seconds'));
258
+ this.#fadeElapsed = 0;
259
+ if (this.#fadeDuration === 0)
260
+ this.#fadeFrom = to;
261
+ return this;
262
+ }
263
+ /** @internal Advance time and add this action's samples to the property mixes. */
264
+ advance(delta, scratch) {
265
+ if (!this.#running)
266
+ return;
267
+ const duration = this.clip.duration;
268
+ let finished = false;
269
+ if (!this.paused) {
270
+ if (this.#fadeDuration > 0) {
271
+ this.#fadeElapsed += Math.abs(delta);
272
+ // A completed fade-out retires the action.
273
+ if (this.#fadeElapsed >= this.#fadeDuration && this.#fadeTo === 0) {
274
+ this.#running = false;
275
+ return;
276
+ }
277
+ }
278
+ let time = this.#time + delta * this.timeScale * this.#direction;
279
+ if (duration <= 0)
280
+ time = 0;
281
+ else if (this.loop === 'repeat')
282
+ time = ((time % duration) + duration) % duration;
283
+ else if (this.loop === 'pingpong') {
284
+ while (time > duration || time < 0) {
285
+ time = time > duration ? 2 * duration - time : -time;
286
+ this.#direction = -this.#direction;
287
+ }
288
+ }
289
+ else if (time >= duration || time < 0) {
290
+ time = time < 0 ? 0 : duration;
291
+ finished = true;
292
+ }
293
+ this.#time = time;
294
+ }
295
+ const weight = this.effectiveWeight;
296
+ if (weight > 0) {
297
+ for (const bound of this.#bound) {
298
+ const sample = scratch.subarray(0, bound.track.size);
299
+ sampleAnimationTrack3D(bound.track, this.#time, sample, bound.hint);
300
+ bound.mix.add(sample, weight);
301
+ }
302
+ }
303
+ if (finished) {
304
+ if (this.clampWhenFinished)
305
+ this.paused = true;
306
+ else
307
+ this.#running = false;
308
+ this.onFinished?.(this);
309
+ }
310
+ }
311
+ }
312
+ /** Plays clips on the subtree under `root`, blending concurrent actions by weight. */
313
+ export class AnimationMixer3D {
314
+ root;
315
+ timeScale = 1;
316
+ #mixes = new Map();
317
+ #actions = new Map();
318
+ #scratch = new Float32Array(16);
319
+ constructor(root) {
320
+ this.root = root;
321
+ }
322
+ /** Create (or return the existing) action for a clip. Tracks whose target is missing are skipped. */
323
+ clipAction(clip) {
324
+ const existing = this.#actions.get(clip);
325
+ if (existing)
326
+ return existing;
327
+ requireCount3D(this.#actions.size + 1, 'actions', ANIMATION3D_LIMITS.maxActions);
328
+ const names = new Map();
329
+ this.root.traverse(object => {
330
+ if (object.name && !names.has(object.name))
331
+ names.set(object.name, object);
332
+ });
333
+ const bound = [];
334
+ for (const track of clip.tracks) {
335
+ const target = names.get(track.targetName);
336
+ if (!target)
337
+ continue;
338
+ if (track.path === 'weights') {
339
+ if (!(target instanceof Mesh3D))
340
+ continue;
341
+ target.syncMorphWeights();
342
+ if (target.morphWeights.length < track.size)
343
+ continue;
344
+ }
345
+ const key = target.id + ':' + track.path;
346
+ let mix = this.#mixes.get(key);
347
+ if (!mix)
348
+ this.#mixes.set(key, (mix = new PropertyMix(target, track.path, track.size)));
349
+ if (track.size > this.#scratch.length)
350
+ this.#scratch = new Float32Array(track.size);
351
+ bound.push({ track, mix, hint: { index: 0 } });
352
+ }
353
+ const action = new AnimationAction3D(clip, bound);
354
+ this.#actions.set(clip, action);
355
+ return action;
356
+ }
357
+ /** Advance every running action by `deltaSeconds` and write the blended pose. */
358
+ update(deltaSeconds) {
359
+ const delta = requireFinite3D(deltaSeconds, 'deltaSeconds') * this.timeScale;
360
+ for (const action of this.#actions.values())
361
+ action.advance(delta, this.#scratch);
362
+ for (const mix of this.#mixes.values())
363
+ mix.apply();
364
+ }
365
+ stopAll() {
366
+ for (const action of this.#actions.values())
367
+ action.stop();
368
+ }
369
+ /** Stop every action and restore the pose captured when each property was first bound. */
370
+ restorePose() {
371
+ this.stopAll();
372
+ for (const mix of this.#mixes.values())
373
+ mix.restore();
374
+ }
375
+ /** Forget an action so its clip can be collected. */
376
+ uncache(clip) {
377
+ this.#actions.delete(clip);
378
+ }
379
+ }
380
+ //# sourceMappingURL=Animation3D.js.map
@@ -0,0 +1,157 @@
1
+ import { Resource3D } from './core3D.js';
2
+ import { type AnimationClip3D } from './Animation3D.js';
3
+ import type { Geometry3D } from './Geometry3D.js';
4
+ import type { Material3D } from './Material3D.js';
5
+ import type { Camera3D } from './Camera3D.js';
6
+ import { InstancedMesh3D, type Mesh3D } from './Mesh3D.js';
7
+ import type { Object3D } from './Object3D.js';
8
+ export declare const ANIMATION_TEXTURE3D_LIMITS: Readonly<{
9
+ readonly maxMatrices: 2097152;
10
+ readonly maxClips: 256;
11
+ readonly maxFps: 240;
12
+ }>;
13
+ export interface BakedClip3D {
14
+ readonly name: string;
15
+ /** First frame of the clip in the table. */
16
+ readonly start: number;
17
+ /** Frames stored, first and last pose included. */
18
+ readonly frames: number;
19
+ readonly duration: number;
20
+ }
21
+ /**
22
+ * Bone matrices of one skinned mesh for every frame of a set of clips. The
23
+ * table is a run of frames, each `stride` matrices of 16 floats: one per
24
+ * bone, taking a vertex from the mesh's bind pose to its posed place in the
25
+ * mesh's own space, and a last one whose 16 floats are the frame's morph
26
+ * weights. Frame 0 is not a pose: its matrix for a bone holds, in the fourth
27
+ * column, the point that bone turns about in the bind pose.
28
+ */
29
+ export declare class AnimationTexture3D extends Resource3D {
30
+ readonly boneCount: number;
31
+ /** Matrices per frame: the bones and one for morph weights. */
32
+ readonly stride: number;
33
+ /** Morph targets whose weights are stored, at most 16. */
34
+ readonly morphCount: number;
35
+ readonly frameCount: number;
36
+ readonly fps: number;
37
+ readonly data: Float32Array;
38
+ readonly clips: readonly BakedClip3D[];
39
+ /** How far a bone travels from the mesh origin in any frame, relative to the geometry's bounding radius; instances widen their bounds by it. */
40
+ readonly reach: number;
41
+ constructor(boneCount: number, fps: number, data: Float32Array, clips: readonly BakedClip3D[], reach?: number, morphCount?: number);
42
+ /** Index of the clip with this name, or -1. */
43
+ clipIndex(name: string): number;
44
+ /**
45
+ * The two table frames around a time in a clip and the blend between
46
+ * them, written to `out` as [first, second, blend].
47
+ */
48
+ framesAt(clip: number, time: number, loop: boolean, out: Float32Array | number[], offset?: number): void;
49
+ }
50
+ export interface BakeAnimationOptions3D {
51
+ /** Poses stored per second of each clip. Default 30. */
52
+ readonly fps?: number;
53
+ }
54
+ /**
55
+ * Sample clips into an animation texture. `root` is the subtree the clips
56
+ * animate, as for an AnimationMixer3D, and `mesh` the skinned mesh inside it
57
+ * whose skeleton is baked. The subtree is posed while baking and put back as
58
+ * it was. Bone transforms are stored, and the weights of the mesh's first 16
59
+ * morph targets where a clip animates them.
60
+ */
61
+ export declare function bakeAnimationTexture3D(root: Object3D, mesh: Mesh3D, clips: readonly AnimationClip3D[], options?: BakeAnimationOptions3D): AnimationTexture3D;
62
+ export interface InstanceClipOptions3D {
63
+ /** Where in the clip to start, in seconds. Default 0. */
64
+ readonly time?: number;
65
+ /** Playback rate; negative plays backwards. Default 1. */
66
+ readonly speed?: number;
67
+ /** Wrap around at the end instead of holding the last pose. Default true. */
68
+ readonly loop?: boolean;
69
+ /** Seconds to cross-fade from the clip the instance is playing now, which keeps running while it fades. Default 0. */
70
+ readonly fade?: number;
71
+ }
72
+ export interface InstanceBlendOptions3D {
73
+ readonly time?: number;
74
+ readonly speed?: number;
75
+ readonly loop?: boolean;
76
+ /** Keep the second clip at the same share of its length as the first, as for a walk blended into a run. Default true. */
77
+ readonly sync?: boolean;
78
+ }
79
+ /**
80
+ * Many copies of one skinned mesh in a single draw call, each at its own
81
+ * place in its own clip. The geometry needs `joints` and `weights`; the mesh
82
+ * needs no skeleton, because poses come from the animation texture. Call
83
+ * `update(deltaSeconds)` once per frame.
84
+ *
85
+ * An instance plays one clip, optionally blended with a second at a weight
86
+ * you set (walk into run) or cross-faded from the one before. One bone,
87
+ * `lookBone`, can be given an extra rotation per instance, as for heads that
88
+ * turn toward something. Before each draw the instances outside the camera's
89
+ * view may be left out of the draw arrays. `count` and its alias `total`
90
+ * remain the number of active instances, and `drawCount` reports the visible range.
91
+ */
92
+ export declare class SkinnedInstancedMesh3D extends InstancedMesh3D {
93
+ #private;
94
+ readonly animations: AnimationTexture3D;
95
+ /** Four floats per logical instance: first frame, second frame, blend and bone count. */
96
+ get instanceAnimation(): Float32Array;
97
+ /** Alias for the active instance count. */
98
+ get total(): number;
99
+ set total(value: number);
100
+ /** Number of entries prepared for the current draw. */
101
+ get drawCount(): number;
102
+ /** Draw matrices in the prepared instance order. */
103
+ get drawMatrices(): Float32Array;
104
+ /** Draw colors in the prepared instance order. */
105
+ get drawColors(): Float32Array | undefined;
106
+ /** Packed GPU animation data in the prepared instance order. */
107
+ get drawAnimation(): Float32Array;
108
+ /** Enables view culling when a conservative posed radius is available. */
109
+ cullInstances: boolean;
110
+ /** Extra radius multiples retained around the view. Default 3. */
111
+ cullPadding: number;
112
+ /**
113
+ * A sphere about the instance origin covering every used skin, morph and bone pose.
114
+ * Without this authored bound, drawing keeps all instances.
115
+ */
116
+ get cullRadius(): number | undefined;
117
+ set cullRadius(value: number | undefined);
118
+ constructor(geometry: Geometry3D, material: Material3D | Material3D[], animations: AnimationTexture3D, capacity: number, instanceColorSize?: 3 | 4);
119
+ /** The bone that per-instance rotations apply to, or -1. Vertices weighted to it turn about its joint; bones below it do not follow. */
120
+ get lookBone(): number;
121
+ set lookBone(bone: number);
122
+ /** Extra rotation of the look bone for one instance, as a quaternion in the mesh's own axes. */
123
+ setBoneRotationAt(index: number, x: number, y: number, z: number, w: number): void;
124
+ /** Play a clip, by index or name, on one instance. */
125
+ setClipAt(index: number, clip: number | string, options?: InstanceClipOptions3D): void;
126
+ /**
127
+ * Blend a second clip into an instance at a weight from 0 to 1, until
128
+ * changed: 0.3 shows 70% of its clip and 30% of this one. A weight of 0
129
+ * removes the second clip.
130
+ */
131
+ setBlendAt(index: number, clip: number | string, weight: number, options?: InstanceBlendOptions3D): void;
132
+ clipAt(index: number): number;
133
+ timeAt(index: number): number;
134
+ /** Weight of the instance's second clip, 0 when it has none. */
135
+ blendAt(index: number): number;
136
+ setTimeAt(index: number, seconds: number): void;
137
+ setSpeedAt(index: number, speed: number): void;
138
+ /** True once a clip that does not loop has reached its end. */
139
+ isFinishedAt(index: number): boolean;
140
+ /** Advance every instance by a time step in seconds. */
141
+ update(deltaSeconds: number): void;
142
+ /**
143
+ * Fill the drawn arrays from the instances a camera can see, or from all
144
+ * of them without one. Rendering does this by itself.
145
+ */
146
+ compact(camera: Camera3D | undefined): void;
147
+ clone(): this;
148
+ private place;
149
+ private resolve;
150
+ private check;
151
+ private write;
152
+ private writeLegacy;
153
+ }
154
+ /** A baked skin can extend beyond the available sphere, including when a bone scales in place. */
155
+ export declare function worldRenderSphere3D(mesh: Mesh3D): Float32Array | undefined;
156
+ export declare function createSkinnedInstancedMesh3D(geometry: Geometry3D, material: Material3D | Material3D[], animations: AnimationTexture3D, capacity: number, instanceColorSize?: 3 | 4): SkinnedInstancedMesh3D;
157
+ //# sourceMappingURL=AnimationTexture3D.d.ts.map