@egret/engine 0.0.0-stage → 7.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (601) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +21 -0
  3. package/README.md +101 -2
  4. package/README.zh-CN.md +102 -0
  5. package/dist/Engine.d.ts +77 -0
  6. package/dist/Engine.js +469 -0
  7. package/dist/animation/index.d.ts +6 -0
  8. package/dist/animation/index.js +5 -0
  9. package/dist/animation/sequenceController.d.ts +22 -0
  10. package/dist/animation/sequenceController.js +618 -0
  11. package/dist/animation/sequenceCoordinator.d.ts +26 -0
  12. package/dist/animation/sequenceCoordinator.js +161 -0
  13. package/dist/animation/sequenceInput.d.ts +25 -0
  14. package/dist/animation/sequenceInput.js +108 -0
  15. package/dist/animation/sequenceMath.d.ts +35 -0
  16. package/dist/animation/sequenceMath.js +164 -0
  17. package/dist/animation/sequenceResetSlot.d.ts +7 -0
  18. package/dist/animation/sequenceResetSlot.js +367 -0
  19. package/dist/animation/sequenceResetTypes.d.ts +48 -0
  20. package/dist/animation/sequenceResetTypes.js +2 -0
  21. package/dist/animation/types.d.ts +75 -0
  22. package/dist/animation/types.js +2 -0
  23. package/dist/assetBundle.d.ts +54 -0
  24. package/dist/assetBundle.js +173 -0
  25. package/dist/assetGroup.d.ts +17 -0
  26. package/dist/assetGroup.js +332 -0
  27. package/dist/assetGroupTypes.d.ts +17 -0
  28. package/dist/assetGroupTypes.js +2 -0
  29. package/dist/audio.d.ts +4 -0
  30. package/dist/audio.js +4 -0
  31. package/dist/audioCues.d.ts +47 -0
  32. package/dist/audioCues.js +127 -0
  33. package/dist/audioMixer.d.ts +7 -0
  34. package/dist/audioMixer.js +785 -0
  35. package/dist/audioTypes.d.ts +246 -0
  36. package/dist/audioTypes.js +3 -0
  37. package/dist/bitmapBindingTicket.d.ts +24 -0
  38. package/dist/bitmapBindingTicket.js +215 -0
  39. package/dist/bitmapButton.d.ts +4 -0
  40. package/dist/bitmapButton.js +407 -0
  41. package/dist/bitmapButtonTypes.d.ts +31 -0
  42. package/dist/bitmapButtonTypes.js +2 -0
  43. package/dist/bitmapFontParse.d.ts +10 -0
  44. package/dist/bitmapFontParse.js +246 -0
  45. package/dist/bitmapFontTypes.d.ts +112 -0
  46. package/dist/bitmapFontTypes.js +2 -0
  47. package/dist/bitmapResourceSlot.d.ts +26 -0
  48. package/dist/bitmapResourceSlot.js +340 -0
  49. package/dist/bitmapText.d.ts +6 -0
  50. package/dist/bitmapText.js +320 -0
  51. package/dist/bitmapfont.d.ts +5 -0
  52. package/dist/bitmapfont.js +5 -0
  53. package/dist/camera.d.ts +4 -0
  54. package/dist/camera.js +4 -0
  55. package/dist/camera2d.d.ts +7 -0
  56. package/dist/camera2d.js +419 -0
  57. package/dist/cameraTypes.d.ts +126 -0
  58. package/dist/cameraTypes.js +2 -0
  59. package/dist/closeHost.d.ts +4 -0
  60. package/dist/closeHost.js +66 -0
  61. package/dist/contentArtifacts.d.ts +12 -0
  62. package/dist/contentArtifacts.js +153 -0
  63. package/dist/contentAtlasPages.d.ts +13 -0
  64. package/dist/contentAtlasPages.js +117 -0
  65. package/dist/contentLoader.d.ts +6 -0
  66. package/dist/contentLoader.js +327 -0
  67. package/dist/contentTypes.d.ts +35 -0
  68. package/dist/contentTypes.js +2 -0
  69. package/dist/createEngine.d.ts +7 -0
  70. package/dist/createEngine.js +25 -0
  71. package/dist/createEngineForProfile.d.ts +5 -0
  72. package/dist/createEngineForProfile.js +45 -0
  73. package/dist/displaySubtreeTicket.d.ts +25 -0
  74. package/dist/displaySubtreeTicket.js +76 -0
  75. package/dist/fontContentLoader.d.ts +6 -0
  76. package/dist/fontContentLoader.js +298 -0
  77. package/dist/fontContentTypes.d.ts +39 -0
  78. package/dist/fontContentTypes.js +2 -0
  79. package/dist/gameClock.d.ts +24 -0
  80. package/dist/gameClock.js +246 -0
  81. package/dist/gameClockTypes.d.ts +37 -0
  82. package/dist/gameClockTypes.js +2 -0
  83. package/dist/gameRun.d.ts +53 -0
  84. package/dist/gameRun.js +97 -0
  85. package/dist/gamepad.d.ts +5 -0
  86. package/dist/gamepad.js +5 -0
  87. package/dist/gamepadInput.d.ts +4 -0
  88. package/dist/gamepadInput.js +281 -0
  89. package/dist/gamepadKeys.d.ts +4 -0
  90. package/dist/gamepadKeys.js +205 -0
  91. package/dist/gamepadTypes.d.ts +142 -0
  92. package/dist/gamepadTypes.js +3 -0
  93. package/dist/hover.d.ts +4 -0
  94. package/dist/hover.js +4 -0
  95. package/dist/hoverInput.d.ts +8 -0
  96. package/dist/hoverInput.js +503 -0
  97. package/dist/hoverInputTypes.d.ts +129 -0
  98. package/dist/hoverInputTypes.js +2 -0
  99. package/dist/index.d.ts +52 -0
  100. package/dist/index.js +21 -0
  101. package/dist/input.d.ts +6 -0
  102. package/dist/input.js +5 -0
  103. package/dist/inputActions.d.ts +86 -0
  104. package/dist/inputActions.js +330 -0
  105. package/dist/internal/contentFactoryState.d.ts +19 -0
  106. package/dist/internal/contentFactoryState.js +42 -0
  107. package/dist/internal/mouseInputFactoryState.d.ts +57 -0
  108. package/dist/internal/mouseInputFactoryState.js +125 -0
  109. package/dist/internal/sequenceControllerFactoryState.d.ts +42 -0
  110. package/dist/internal/sequenceControllerFactoryState.js +98 -0
  111. package/dist/internal/textFieldFactoryState.d.ts +11 -0
  112. package/dist/internal/textFieldFactoryState.js +32 -0
  113. package/dist/internal/texturedFrameState.d.ts +4 -0
  114. package/dist/internal/texturedFrameState.js +12 -0
  115. package/dist/internal/uiFactoryState.d.ts +68 -0
  116. package/dist/internal/uiFactoryState.js +173 -0
  117. package/dist/internal/uiRootState.d.ts +67 -0
  118. package/dist/internal/uiRootState.js +103 -0
  119. package/dist/keyboardInput.d.ts +13 -0
  120. package/dist/keyboardInput.js +579 -0
  121. package/dist/keyboardInputTypes.d.ts +93 -0
  122. package/dist/keyboardInputTypes.js +2 -0
  123. package/dist/kit.d.ts +16 -0
  124. package/dist/kit.js +10 -0
  125. package/dist/layout.d.ts +5 -0
  126. package/dist/layout.js +132 -0
  127. package/dist/layoutTypes.d.ts +28 -0
  128. package/dist/layoutTypes.js +2 -0
  129. package/dist/manifestAssetGroup.d.ts +10 -0
  130. package/dist/manifestAssetGroup.js +477 -0
  131. package/dist/manifestResourceState.d.ts +17 -0
  132. package/dist/manifestResourceState.js +58 -0
  133. package/dist/manifestResourceTypes.d.ts +26 -0
  134. package/dist/manifestResourceTypes.js +2 -0
  135. package/dist/motion.d.ts +35 -0
  136. package/dist/motion.js +206 -0
  137. package/dist/mouseInput.d.ts +102 -0
  138. package/dist/mouseInput.js +562 -0
  139. package/dist/mouseInputTypes.d.ts +41 -0
  140. package/dist/mouseInputTypes.js +2 -0
  141. package/dist/paragraph.d.ts +8 -0
  142. package/dist/paragraph.js +7 -0
  143. package/dist/particleEmitter.d.ts +4 -0
  144. package/dist/particleEmitter.js +300 -0
  145. package/dist/particleTypes.d.ts +115 -0
  146. package/dist/particleTypes.js +2 -0
  147. package/dist/particles.d.ts +4 -0
  148. package/dist/particles.js +4 -0
  149. package/dist/physics2d.d.ts +4 -0
  150. package/dist/physics2d.js +4 -0
  151. package/dist/physics2dGeometry.d.ts +39 -0
  152. package/dist/physics2dGeometry.js +230 -0
  153. package/dist/physics2dTypes.d.ts +221 -0
  154. package/dist/physics2dTypes.js +2 -0
  155. package/dist/physics2dWorld.d.ts +4 -0
  156. package/dist/physics2dWorld.js +823 -0
  157. package/dist/pointerInput.d.ts +12 -0
  158. package/dist/pointerInput.js +300 -0
  159. package/dist/pointerInputTypes.d.ts +41 -0
  160. package/dist/pointerInputTypes.js +2 -0
  161. package/dist/random.d.ts +30 -0
  162. package/dist/random.js +131 -0
  163. package/dist/rendering/ownedPreparationFailure2D.d.ts +5 -0
  164. package/dist/rendering/ownedPreparationFailure2D.js +33 -0
  165. package/dist/rendering/packSharedDraws2D.d.ts +50 -0
  166. package/dist/rendering/packSharedDraws2D.js +379 -0
  167. package/dist/rendering/packedOrientation.d.ts +4 -0
  168. package/dist/rendering/packedOrientation.js +7 -0
  169. package/dist/rendering/prepareRectangles2D.d.ts +92 -0
  170. package/dist/rendering/prepareRectangles2D.js +481 -0
  171. package/dist/rendering/prepareSharedDraws2D.d.ts +90 -0
  172. package/dist/rendering/prepareSharedDraws2D.js +663 -0
  173. package/dist/rendering/preparedBatches2D.d.ts +17 -0
  174. package/dist/rendering/preparedBatches2D.js +30 -0
  175. package/dist/rendering/preparedSharedBatches2D.d.ts +44 -0
  176. package/dist/rendering/preparedSharedBatches2D.js +247 -0
  177. package/dist/rendering/sharedColor2D.d.ts +52 -0
  178. package/dist/rendering/sharedColor2D.js +191 -0
  179. package/dist/rendering/sharedEffects2D.d.ts +23 -0
  180. package/dist/rendering/sharedEffects2D.js +126 -0
  181. package/dist/rendering/sharedPreparationRetention2D.d.ts +120 -0
  182. package/dist/rendering/sharedPreparationRetention2D.js +357 -0
  183. package/dist/rendering/srgbBytes.d.ts +3 -0
  184. package/dist/rendering/srgbBytes.js +64 -0
  185. package/dist/rendering/texturedPreparationBudget2D.d.ts +31 -0
  186. package/dist/rendering/texturedPreparationBudget2D.js +81 -0
  187. package/dist/rendering/world3d/Animation3D.d.ts +104 -0
  188. package/dist/rendering/world3d/Animation3D.js +384 -0
  189. package/dist/rendering/world3d/AnimationTexture3D.d.ts +163 -0
  190. package/dist/rendering/world3d/AnimationTexture3D.js +603 -0
  191. package/dist/rendering/world3d/Batch3D.d.ts +75 -0
  192. package/dist/rendering/world3d/Batch3D.js +332 -0
  193. package/dist/rendering/world3d/Camera3D.d.ts +62 -0
  194. package/dist/rendering/world3d/Camera3D.js +132 -0
  195. package/dist/rendering/world3d/Character3D.d.ts +127 -0
  196. package/dist/rendering/world3d/Character3D.js +305 -0
  197. package/dist/rendering/world3d/Cloth3D.d.ts +130 -0
  198. package/dist/rendering/world3d/Cloth3D.js +503 -0
  199. package/dist/rendering/world3d/Compression3D.d.ts +22 -0
  200. package/dist/rendering/world3d/Compression3D.js +703 -0
  201. package/dist/rendering/world3d/Curves3D.d.ts +119 -0
  202. package/dist/rendering/world3d/Curves3D.js +460 -0
  203. package/dist/rendering/world3d/Decal3D.d.ts +43 -0
  204. package/dist/rendering/world3d/Decal3D.js +242 -0
  205. package/dist/rendering/world3d/Export3D.d.ts +13 -0
  206. package/dist/rendering/world3d/Export3D.js +263 -0
  207. package/dist/rendering/world3d/Geometry3D.d.ts +95 -0
  208. package/dist/rendering/world3d/Geometry3D.js +335 -0
  209. package/dist/rendering/world3d/GeometryBuilder3D.d.ts +53 -0
  210. package/dist/rendering/world3d/GeometryBuilder3D.js +196 -0
  211. package/dist/rendering/world3d/Gizmo3D.d.ts +80 -0
  212. package/dist/rendering/world3d/Gizmo3D.js +514 -0
  213. package/dist/rendering/world3d/Gltf3D.d.ts +73 -0
  214. package/dist/rendering/world3d/Gltf3D.js +996 -0
  215. package/dist/rendering/world3d/GpuParticles3D.d.ts +109 -0
  216. package/dist/rendering/world3d/GpuParticles3D.js +401 -0
  217. package/dist/rendering/world3d/Hdr3D.d.ts +35 -0
  218. package/dist/rendering/world3d/Hdr3D.js +191 -0
  219. package/dist/rendering/world3d/Jelly3D.d.ts +77 -0
  220. package/dist/rendering/world3d/Jelly3D.js +267 -0
  221. package/dist/rendering/world3d/Ktx23D.d.ts +30 -0
  222. package/dist/rendering/world3d/Ktx23D.js +112 -0
  223. package/dist/rendering/world3d/Light3D.d.ts +84 -0
  224. package/dist/rendering/world3d/Light3D.js +97 -0
  225. package/dist/rendering/world3d/Material3D.d.ts +253 -0
  226. package/dist/rendering/world3d/Material3D.js +269 -0
  227. package/dist/rendering/world3d/Mesh3D.d.ts +112 -0
  228. package/dist/rendering/world3d/Mesh3D.js +337 -0
  229. package/dist/rendering/world3d/Meshopt3D.d.ts +15 -0
  230. package/dist/rendering/world3d/Meshopt3D.js +276 -0
  231. package/dist/rendering/world3d/Navigation3D.d.ts +213 -0
  232. package/dist/rendering/world3d/Navigation3D.js +1043 -0
  233. package/dist/rendering/world3d/Object3D.d.ts +118 -0
  234. package/dist/rendering/world3d/Object3D.js +315 -0
  235. package/dist/rendering/world3d/Particles3D.d.ts +90 -0
  236. package/dist/rendering/world3d/Particles3D.js +277 -0
  237. package/dist/rendering/world3d/Physics3D.d.ts +430 -0
  238. package/dist/rendering/world3d/Physics3D.js +2840 -0
  239. package/dist/rendering/world3d/PhysicsHull3D.d.ts +37 -0
  240. package/dist/rendering/world3d/PhysicsHull3D.js +229 -0
  241. package/dist/rendering/world3d/PhysicsMesh3D.d.ts +41 -0
  242. package/dist/rendering/world3d/PhysicsMesh3D.js +340 -0
  243. package/dist/rendering/world3d/PhysicsQueries3D.d.ts +24 -0
  244. package/dist/rendering/world3d/PhysicsQueries3D.js +323 -0
  245. package/dist/rendering/world3d/PhysicsRemote3D.d.ts +179 -0
  246. package/dist/rendering/world3d/PhysicsRemote3D.js +536 -0
  247. package/dist/rendering/world3d/Ragdoll3D.d.ts +74 -0
  248. package/dist/rendering/world3d/Ragdoll3D.js +202 -0
  249. package/dist/rendering/world3d/Raycast3D.d.ts +40 -0
  250. package/dist/rendering/world3d/Raycast3D.js +247 -0
  251. package/dist/rendering/world3d/RenderList3D.d.ts +91 -0
  252. package/dist/rendering/world3d/RenderList3D.js +502 -0
  253. package/dist/rendering/world3d/Retarget3D.d.ts +21 -0
  254. package/dist/rendering/world3d/Retarget3D.js +185 -0
  255. package/dist/rendering/world3d/Rig3D.d.ts +57 -0
  256. package/dist/rendering/world3d/Rig3D.js +219 -0
  257. package/dist/rendering/world3d/Sdf3D.d.ts +181 -0
  258. package/dist/rendering/world3d/Sdf3D.js +1136 -0
  259. package/dist/rendering/world3d/SdfLod3D.d.ts +17 -0
  260. package/dist/rendering/world3d/SdfLod3D.js +56 -0
  261. package/dist/rendering/world3d/Serialize3D.d.ts +66 -0
  262. package/dist/rendering/world3d/Serialize3D.js +629 -0
  263. package/dist/rendering/world3d/Simplify3D.d.ts +29 -0
  264. package/dist/rendering/world3d/Simplify3D.js +426 -0
  265. package/dist/rendering/world3d/StateMachine3D.d.ts +87 -0
  266. package/dist/rendering/world3d/StateMachine3D.js +280 -0
  267. package/dist/rendering/world3d/SurfaceMaterial3D.d.ts +26 -0
  268. package/dist/rendering/world3d/SurfaceMaterial3D.js +138 -0
  269. package/dist/rendering/world3d/Terrain3D.d.ts +248 -0
  270. package/dist/rendering/world3d/Terrain3D.js +827 -0
  271. package/dist/rendering/world3d/Text3D.d.ts +95 -0
  272. package/dist/rendering/world3d/Text3D.js +560 -0
  273. package/dist/rendering/world3d/Texture3D.d.ts +148 -0
  274. package/dist/rendering/world3d/Texture3D.js +270 -0
  275. package/dist/rendering/world3d/Trail3D.d.ts +62 -0
  276. package/dist/rendering/world3d/Trail3D.js +195 -0
  277. package/dist/rendering/world3d/Vehicle3D.d.ts +102 -0
  278. package/dist/rendering/world3d/Vehicle3D.js +228 -0
  279. package/dist/rendering/world3d/VolumetricFog3D.d.ts +57 -0
  280. package/dist/rendering/world3d/VolumetricFog3D.js +230 -0
  281. package/dist/rendering/world3d/Water3D.d.ts +165 -0
  282. package/dist/rendering/world3d/Water3D.js +607 -0
  283. package/dist/rendering/world3d/core3D.d.ts +36 -0
  284. package/dist/rendering/world3d/core3D.js +99 -0
  285. package/dist/rendering/world3d/debug3D.d.ts +69 -0
  286. package/dist/rendering/world3d/debug3D.js +262 -0
  287. package/dist/rendering/world3d/decoders3D.d.ts +42 -0
  288. package/dist/rendering/world3d/decoders3D.js +133 -0
  289. package/dist/rendering/world3d/geometries3D.d.ts +111 -0
  290. package/dist/rendering/world3d/geometries3D.js +610 -0
  291. package/dist/rendering/world3d/helpers3D.d.ts +67 -0
  292. package/dist/rendering/world3d/helpers3D.js +178 -0
  293. package/dist/rendering/world3d/index.d.ts +103 -0
  294. package/dist/rendering/world3d/index.js +62 -0
  295. package/dist/rendering/world3d/math3D.d.ts +114 -0
  296. package/dist/rendering/world3d/math3D.js +675 -0
  297. package/dist/rendering/world3d/primitives3D.d.ts +67 -0
  298. package/dist/rendering/world3d/primitives3D.js +197 -0
  299. package/dist/resources.d.ts +8 -0
  300. package/dist/resources.js +6 -0
  301. package/dist/saveStore.d.ts +71 -0
  302. package/dist/saveStore.js +182 -0
  303. package/dist/semanticList.d.ts +126 -0
  304. package/dist/semanticList.js +175 -0
  305. package/dist/semanticTree.d.ts +10 -0
  306. package/dist/semanticTree.js +539 -0
  307. package/dist/semanticTypes.d.ts +175 -0
  308. package/dist/semanticTypes.js +2 -0
  309. package/dist/semantics.d.ts +6 -0
  310. package/dist/semantics.js +5 -0
  311. package/dist/sequencePlayback.d.ts +19 -0
  312. package/dist/sequencePlayback.js +391 -0
  313. package/dist/sequencePlaybackTypes.d.ts +24 -0
  314. package/dist/sequencePlaybackTypes.js +2 -0
  315. package/dist/sequenceTargetClaims.d.ts +10 -0
  316. package/dist/sequenceTargetClaims.js +31 -0
  317. package/dist/srgbBytes.d.ts +3 -0
  318. package/dist/srgbBytes.js +64 -0
  319. package/dist/startEngine.d.ts +5 -0
  320. package/dist/startEngine.js +31 -0
  321. package/dist/surfaceOwnership.d.ts +3 -0
  322. package/dist/surfaceOwnership.js +15 -0
  323. package/dist/text.d.ts +24 -0
  324. package/dist/text.js +4 -0
  325. package/dist/textField.d.ts +6 -0
  326. package/dist/textField.js +6 -0
  327. package/dist/textTable.d.ts +41 -0
  328. package/dist/textTable.js +114 -0
  329. package/dist/tileMapDraw.d.ts +7 -0
  330. package/dist/tileMapDraw.js +310 -0
  331. package/dist/tiledImport.d.ts +9 -0
  332. package/dist/tiledImport.js +357 -0
  333. package/dist/tilemap.d.ts +5 -0
  334. package/dist/tilemap.js +5 -0
  335. package/dist/tilemapTypes.d.ts +182 -0
  336. package/dist/tilemapTypes.js +2 -0
  337. package/dist/timer.d.ts +34 -0
  338. package/dist/timer.js +119 -0
  339. package/dist/tween.d.ts +15 -0
  340. package/dist/tween.js +329 -0
  341. package/dist/tweenTypes.d.ts +31 -0
  342. package/dist/tweenTypes.js +2 -0
  343. package/dist/ui/controlKeys.d.ts +113 -0
  344. package/dist/ui/controlKeys.js +250 -0
  345. package/dist/ui/controls.d.ts +58 -0
  346. package/dist/ui/controls.js +290 -0
  347. package/dist/ui/editing.d.ts +3 -0
  348. package/dist/ui/editing.js +3 -0
  349. package/dist/ui/index.d.ts +19 -0
  350. package/dist/ui/index.js +11 -0
  351. package/dist/ui/keyboardFocus.d.ts +32 -0
  352. package/dist/ui/keyboardFocus.js +146 -0
  353. package/dist/ui/layerTypes.d.ts +98 -0
  354. package/dist/ui/layerTypes.js +2 -0
  355. package/dist/ui/layers.d.ts +4 -0
  356. package/dist/ui/layers.js +586 -0
  357. package/dist/ui/leafContent.d.ts +21 -0
  358. package/dist/ui/leafContent.js +136 -0
  359. package/dist/ui/rangeControl.d.ts +53 -0
  360. package/dist/ui/rangeControl.js +168 -0
  361. package/dist/ui/scrollControl.d.ts +84 -0
  362. package/dist/ui/scrollControl.js +222 -0
  363. package/dist/ui/stateControls.d.ts +90 -0
  364. package/dist/ui/stateControls.js +331 -0
  365. package/dist/ui/textEditor.d.ts +54 -0
  366. package/dist/ui/textEditor.js +371 -0
  367. package/dist/ui/textEditorTypes.d.ts +85 -0
  368. package/dist/ui/textEditorTypes.js +2 -0
  369. package/dist/ui/textFieldControl.d.ts +100 -0
  370. package/dist/ui/textFieldControl.js +260 -0
  371. package/dist/ui/theme.d.ts +64 -0
  372. package/dist/ui/theme.js +166 -0
  373. package/dist/ui/types.d.ts +285 -0
  374. package/dist/ui/types.js +2 -0
  375. package/dist/ui/uiRoot.d.ts +4 -0
  376. package/dist/ui/uiRoot.js +1526 -0
  377. package/dist/ui/uiRootDisplay.d.ts +46 -0
  378. package/dist/ui/uiRootDisplay.js +148 -0
  379. package/dist/ui/uiRootModel.d.ts +114 -0
  380. package/dist/ui/uiRootModel.js +66 -0
  381. package/dist/ui/virtualList.d.ts +20 -0
  382. package/dist/ui/virtualList.js +105 -0
  383. package/dist/video.d.ts +4 -0
  384. package/dist/video.js +4 -0
  385. package/dist/videoPlayer.d.ts +4 -0
  386. package/dist/videoPlayer.js +215 -0
  387. package/dist/videoTypes.d.ts +77 -0
  388. package/dist/videoTypes.js +2 -0
  389. package/dist/web/BrowserAssetBundle.d.ts +41 -0
  390. package/dist/web/BrowserAssetBundle.js +136 -0
  391. package/dist/web/BrowserAudio.d.ts +74 -0
  392. package/dist/web/BrowserAudio.js +503 -0
  393. package/dist/web/BrowserFrameLoop.d.ts +69 -0
  394. package/dist/web/BrowserFrameLoop.js +125 -0
  395. package/dist/web/BrowserGame.d.ts +174 -0
  396. package/dist/web/BrowserGame.js +473 -0
  397. package/dist/web/BrowserGamepadInput.d.ts +38 -0
  398. package/dist/web/BrowserGamepadInput.js +134 -0
  399. package/dist/web/BrowserHoverInput.d.ts +25 -0
  400. package/dist/web/BrowserHoverInput.js +266 -0
  401. package/dist/web/BrowserImageTextures.d.ts +72 -0
  402. package/dist/web/BrowserImageTextures.js +169 -0
  403. package/dist/web/BrowserInputActions.d.ts +63 -0
  404. package/dist/web/BrowserInputActions.js +345 -0
  405. package/dist/web/BrowserKeyboardInput.d.ts +4 -0
  406. package/dist/web/BrowserKeyboardInput.js +223 -0
  407. package/dist/web/BrowserPlay.d.ts +417 -0
  408. package/dist/web/BrowserPlay.js +1648 -0
  409. package/dist/web/BrowserPointerInput.d.ts +4 -0
  410. package/dist/web/BrowserPointerInput.js +511 -0
  411. package/dist/web/BrowserPreferences.d.ts +10 -0
  412. package/dist/web/BrowserPreferences.js +39 -0
  413. package/dist/web/BrowserSemantics.d.ts +36 -0
  414. package/dist/web/BrowserSemantics.js +418 -0
  415. package/dist/web/BrowserStatsPanel.d.ts +56 -0
  416. package/dist/web/BrowserStatsPanel.js +143 -0
  417. package/dist/web/BrowserStorage.d.ts +35 -0
  418. package/dist/web/BrowserStorage.js +132 -0
  419. package/dist/web/BrowserTextEditor.d.ts +52 -0
  420. package/dist/web/BrowserTextEditor.js +839 -0
  421. package/dist/web/BrowserTextInput.d.ts +89 -0
  422. package/dist/web/BrowserTextInput.js +524 -0
  423. package/dist/web/BrowserTextureProvider.d.ts +58 -0
  424. package/dist/web/BrowserTextureProvider.js +935 -0
  425. package/dist/web/BrowserVideo.d.ts +40 -0
  426. package/dist/web/BrowserVideo.js +237 -0
  427. package/dist/web/CanvasKitFontSetProvider.d.ts +32 -0
  428. package/dist/web/CanvasKitFontSetProvider.js +215 -0
  429. package/dist/web/CanvasKitParagraphProvider.d.ts +173 -0
  430. package/dist/web/CanvasKitParagraphProvider.js +692 -0
  431. package/dist/web/CanvasTextRasterProvider.d.ts +4 -0
  432. package/dist/web/CanvasTextRasterProvider.js +312 -0
  433. package/dist/web/ManifestByteSource.d.ts +151 -0
  434. package/dist/web/ManifestByteSource.js +975 -0
  435. package/dist/web/ManifestFontContentLoader.d.ts +13 -0
  436. package/dist/web/ManifestFontContentLoader.js +30 -0
  437. package/dist/web/MouseInput.d.ts +4 -0
  438. package/dist/web/MouseInput.js +218 -0
  439. package/dist/web/WebGL2Host.d.ts +5 -0
  440. package/dist/web/WebGL2Host.js +2711 -0
  441. package/dist/web/WebGPUHost.d.ts +100 -0
  442. package/dist/web/WebGPUHost.js +3430 -0
  443. package/dist/web/audio.d.ts +3 -0
  444. package/dist/web/audio.js +4 -0
  445. package/dist/web/canvasKitParagraphGeometry.d.ts +27 -0
  446. package/dist/web/canvasKitParagraphGeometry.js +83 -0
  447. package/dist/web/editing.d.ts +5 -0
  448. package/dist/web/editing.js +4 -0
  449. package/dist/web/editorFonts.d.ts +54 -0
  450. package/dist/web/editorFonts.js +297 -0
  451. package/dist/web/game.d.ts +5 -0
  452. package/dist/web/game.js +6 -0
  453. package/dist/web/gamepad.d.ts +3 -0
  454. package/dist/web/gamepad.js +4 -0
  455. package/dist/web/hover.d.ts +3 -0
  456. package/dist/web/hover.js +4 -0
  457. package/dist/web/image.d.ts +4 -0
  458. package/dist/web/image.js +4 -0
  459. package/dist/web/imageProjections2D.d.ts +16 -0
  460. package/dist/web/imageProjections2D.js +2 -0
  461. package/dist/web/input.d.ts +6 -0
  462. package/dist/web/input.js +4 -0
  463. package/dist/web/keyboard.d.ts +3 -0
  464. package/dist/web/keyboard.js +3 -0
  465. package/dist/web/kit.d.ts +11 -0
  466. package/dist/web/kit.js +8 -0
  467. package/dist/web/loop.d.ts +3 -0
  468. package/dist/web/loop.js +4 -0
  469. package/dist/web/paragraph.d.ts +6 -0
  470. package/dist/web/paragraph.js +4 -0
  471. package/dist/web/play.d.ts +10 -0
  472. package/dist/web/play.js +9 -0
  473. package/dist/web/playMusic.d.ts +33 -0
  474. package/dist/web/playMusic.js +194 -0
  475. package/dist/web/playSfx.d.ts +36 -0
  476. package/dist/web/playSfx.js +112 -0
  477. package/dist/web/playTouch.d.ts +45 -0
  478. package/dist/web/playTouch.js +141 -0
  479. package/dist/web/playWidgets.d.ts +71 -0
  480. package/dist/web/playWidgets.js +431 -0
  481. package/dist/web/pointer.d.ts +3 -0
  482. package/dist/web/pointer.js +3 -0
  483. package/dist/web/prepareSharedSubmission2D.d.ts +27 -0
  484. package/dist/web/prepareSharedSubmission2D.js +63 -0
  485. package/dist/web/resources.d.ts +29 -0
  486. package/dist/web/resources.js +96 -0
  487. package/dist/web/semantics.d.ts +3 -0
  488. package/dist/web/semantics.js +4 -0
  489. package/dist/web/sharedDeviceSession.d.ts +64 -0
  490. package/dist/web/sharedDeviceSession.js +2 -0
  491. package/dist/web/sharedEffectShaders.d.ts +13 -0
  492. package/dist/web/sharedEffectShaders.js +181 -0
  493. package/dist/web/sharedFrameUpload.d.ts +25 -0
  494. package/dist/web/sharedFrameUpload.js +2 -0
  495. package/dist/web/sharedHostDeferred.d.ts +7 -0
  496. package/dist/web/sharedHostDeferred.js +12 -0
  497. package/dist/web/sharedRetentionLedger.d.ts +85 -0
  498. package/dist/web/sharedRetentionLedger.js +391 -0
  499. package/dist/web/sharedSubmissionStorage2D.d.ts +56 -0
  500. package/dist/web/sharedSubmissionStorage2D.js +73 -0
  501. package/dist/web/sharedWebGL2Arena.d.ts +40 -0
  502. package/dist/web/sharedWebGL2Arena.js +77 -0
  503. package/dist/web/sharedWebGL2Options.d.ts +33 -0
  504. package/dist/web/sharedWebGL2Options.js +102 -0
  505. package/dist/web/sharedWebGL2Shaders.d.ts +33 -0
  506. package/dist/web/sharedWebGL2Shaders.js +408 -0
  507. package/dist/web/sharedWebGPUOptions.d.ts +41 -0
  508. package/dist/web/sharedWebGPUOptions.js +130 -0
  509. package/dist/web/text.d.ts +3 -0
  510. package/dist/web/text.js +3 -0
  511. package/dist/web/textInput.d.ts +3 -0
  512. package/dist/web/textInput.js +3 -0
  513. package/dist/web/video.d.ts +3 -0
  514. package/dist/web/video.js +4 -0
  515. package/dist/web/webgl2.d.ts +7 -0
  516. package/dist/web/webgl2.js +4 -0
  517. package/dist/web/webgl2LayerState.d.ts +50 -0
  518. package/dist/web/webgl2LayerState.js +102 -0
  519. package/dist/web/webgl2Native.d.ts +72 -0
  520. package/dist/web/webgl2Native.js +572 -0
  521. package/dist/web/webgl2Types.d.ts +150 -0
  522. package/dist/web/webgl2Types.js +2 -0
  523. package/dist/web/webgpu.d.ts +6 -0
  524. package/dist/web/webgpu.js +2 -0
  525. package/dist/web/webgpuBindingCache.d.ts +26 -0
  526. package/dist/web/webgpuBindingCache.js +223 -0
  527. package/dist/web/webgpuBufferPool.d.ts +51 -0
  528. package/dist/web/webgpuBufferPool.js +58 -0
  529. package/dist/web/webgpuImageResidency.d.ts +56 -0
  530. package/dist/web/webgpuImageResidency.js +65 -0
  531. package/dist/web/webgpuLifetime.d.ts +45 -0
  532. package/dist/web/webgpuLifetime.js +64 -0
  533. package/dist/web/webgpuRetentionPool.d.ts +66 -0
  534. package/dist/web/webgpuRetentionPool.js +85 -0
  535. package/dist/web/webgpuSharedPass.d.ts +7 -0
  536. package/dist/web/webgpuSharedPass.js +293 -0
  537. package/dist/web/webgpuSharedResolvePass.d.ts +3 -0
  538. package/dist/web/webgpuSharedResolvePass.js +34 -0
  539. package/dist/web/world3d/Audio3D.d.ts +85 -0
  540. package/dist/web/world3d/Audio3D.js +271 -0
  541. package/dist/web/world3d/BrowserPlay3D.d.ts +295 -0
  542. package/dist/web/world3d/BrowserPlay3D.js +1256 -0
  543. package/dist/web/world3d/FlyControls3D.d.ts +59 -0
  544. package/dist/web/world3d/FlyControls3D.js +162 -0
  545. package/dist/web/world3d/FollowControls3D.d.ts +31 -0
  546. package/dist/web/world3d/FollowControls3D.js +119 -0
  547. package/dist/web/world3d/OrbitControls3D.d.ts +58 -0
  548. package/dist/web/world3d/OrbitControls3D.js +189 -0
  549. package/dist/web/world3d/TransformControls3D.d.ts +37 -0
  550. package/dist/web/world3d/TransformControls3D.js +128 -0
  551. package/dist/web/world3d/WebGL2Renderer3D.d.ts +136 -0
  552. package/dist/web/world3d/WebGL2Renderer3D.js +1175 -0
  553. package/dist/web/world3d/WebGPURenderer3D.d.ts +112 -0
  554. package/dist/web/world3d/WebGPURenderer3D.js +1916 -0
  555. package/dist/web/world3d/World3DView.d.ts +54 -0
  556. package/dist/web/world3d/World3DView.js +79 -0
  557. package/dist/web/world3d/app3D.d.ts +143 -0
  558. package/dist/web/world3d/app3D.js +305 -0
  559. package/dist/web/world3d/assets3D.d.ts +39 -0
  560. package/dist/web/world3d/assets3D.js +112 -0
  561. package/dist/web/world3d/atmosphere3D.d.ts +56 -0
  562. package/dist/web/world3d/atmosphere3D.js +193 -0
  563. package/dist/web/world3d/canvasFont3D.d.ts +21 -0
  564. package/dist/web/world3d/canvasFont3D.js +165 -0
  565. package/dist/web/world3d/frame3D.d.ts +144 -0
  566. package/dist/web/world3d/frame3D.js +388 -0
  567. package/dist/web/world3d/gpuResources3D.d.ts +98 -0
  568. package/dist/web/world3d/gpuResources3D.js +901 -0
  569. package/dist/web/world3d/host3D.d.ts +24 -0
  570. package/dist/web/world3d/host3D.js +61 -0
  571. package/dist/web/world3d/index.d.ts +40 -0
  572. package/dist/web/world3d/index.js +24 -0
  573. package/dist/web/world3d/loaders3D.d.ts +27 -0
  574. package/dist/web/world3d/loaders3D.js +138 -0
  575. package/dist/web/world3d/markers3D.d.ts +53 -0
  576. package/dist/web/world3d/markers3D.js +130 -0
  577. package/dist/web/world3d/materialWebGL23D.d.ts +34 -0
  578. package/dist/web/world3d/materialWebGL23D.js +218 -0
  579. package/dist/web/world3d/overlay3D.d.ts +47 -0
  580. package/dist/web/world3d/overlay3D.js +187 -0
  581. package/dist/web/world3d/post3D.d.ts +116 -0
  582. package/dist/web/world3d/post3D.js +462 -0
  583. package/dist/web/world3d/postWebGL23D.d.ts +24 -0
  584. package/dist/web/world3d/postWebGL23D.js +237 -0
  585. package/dist/web/world3d/postWebGPU3D.d.ts +23 -0
  586. package/dist/web/world3d/postWebGPU3D.js +255 -0
  587. package/dist/web/world3d/probe3D.d.ts +15 -0
  588. package/dist/web/world3d/probe3D.js +66 -0
  589. package/dist/web/world3d/shaders3D.d.ts +43 -0
  590. package/dist/web/world3d/shaders3D.js +851 -0
  591. package/dist/web/world3d/stats3D.d.ts +34 -0
  592. package/dist/web/world3d/stats3D.js +81 -0
  593. package/dist/web/world3d/webGL2FrameMetrics3D.d.ts +71 -0
  594. package/dist/web/world3d/webGL2FrameMetrics3D.js +185 -0
  595. package/dist/web/world3d/webgpu.d.ts +37 -0
  596. package/dist/web/world3d/webgpu.js +23 -0
  597. package/dist/web/world3d/webgpuPacking3D.d.ts +13 -0
  598. package/dist/web/world3d/webgpuPacking3D.js +85 -0
  599. package/dist/web/world3d/wgsl3D.d.ts +68 -0
  600. package/dist/web/world3d/wgsl3D.js +781 -0
  601. package/package.json +220 -4
@@ -0,0 +1,280 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // Parameter-driven animation state machine on top of AnimationMixer3D.
3
+ // States play one clip or a 1D blend of several; transitions fire on
4
+ // parameter conditions and an optional exit time, and cross-fade by weight.
5
+ // An interrupted fade keeps the weights it had reached, so poses never pop.
6
+ import { AnimationMixer3D } from './Animation3D.js';
7
+ import { World3DError, requireFinite3D } from './core3D.js';
8
+ /** The most states and transitions a state machine has, and how many transitions it takes in one update. */
9
+ export const STATE_MACHINE3D_LIMITS = Object.freeze({
10
+ maxStates: 256,
11
+ maxTransitions: 2048,
12
+ maxTransitionsPerUpdate: 8
13
+ });
14
+ /** Plays clips by state, moving between states when their conditions are met. */
15
+ export class AnimationStateMachine3D {
16
+ mixer;
17
+ /** Called after every state change, including forced ones. */
18
+ onStateChange;
19
+ #states = new Map();
20
+ #transitions = [];
21
+ #parameters = new Map();
22
+ #triggers = new Set();
23
+ #current;
24
+ #fadeDuration = 0;
25
+ #fadeElapsed = 0;
26
+ #fading = false;
27
+ constructor(mixer) {
28
+ if (!(mixer instanceof AnimationMixer3D))
29
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'mixer');
30
+ this.mixer = mixer;
31
+ }
32
+ /** Name of the active state; during a fade this is the state being faded in. */
33
+ get current() {
34
+ return this.#current?.name;
35
+ }
36
+ get isTransitioning() {
37
+ return this.#fading;
38
+ }
39
+ /** Play time of the active state in passes of its duration. */
40
+ get normalizedTime() {
41
+ return this.#current?.normalizedTime ?? 0;
42
+ }
43
+ addState(name, options) {
44
+ if (typeof name !== 'string' || name.length === 0 || name === '*' || this.#states.has(name))
45
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'state name');
46
+ if (this.#states.size >= STATE_MACHINE3D_LIMITS.maxStates)
47
+ throw new World3DError('WORLD3D_BUDGET', 'states');
48
+ const entries = options.blend
49
+ ? [...options.blend.clips].sort((a, b) => a.threshold - b.threshold)
50
+ : options.clip
51
+ ? [{ clip: options.clip, threshold: 0 }]
52
+ : [];
53
+ if (entries.length === 0 || (options.blend && options.clip))
54
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'state needs a clip or a blend');
55
+ for (const entry of entries)
56
+ requireFinite3D(entry.threshold, 'blend threshold');
57
+ const loop = options.loop ?? true, speed = requireFinite3D(options.speed ?? 1, 'state speed');
58
+ const actions = entries.map(entry => {
59
+ const action = this.mixer.clipAction(entry.clip);
60
+ action.loop = loop ? 'repeat' : 'once';
61
+ action.clampWhenFinished = !loop;
62
+ return action;
63
+ });
64
+ this.#states.set(name, {
65
+ name,
66
+ actions,
67
+ thresholds: entries.map(entry => entry.threshold),
68
+ blendParameter: options.blend?.parameter,
69
+ loop,
70
+ speed,
71
+ onEnter: options.onEnter,
72
+ onExit: options.onExit,
73
+ events: [],
74
+ blendWeights: entries.map(() => 0),
75
+ weight: 0,
76
+ fadeFrom: 0,
77
+ normalizedTime: 0
78
+ });
79
+ return this;
80
+ }
81
+ addTransition(options) {
82
+ if (options.from !== '*' && !this.#states.has(options.from))
83
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'transition from: ' + options.from);
84
+ if (!this.#states.has(options.to))
85
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'transition to: ' + options.to);
86
+ if (this.#transitions.length >= STATE_MACHINE3D_LIMITS.maxTransitions)
87
+ throw new World3DError('WORLD3D_BUDGET', 'transitions');
88
+ const conditions = [...(options.conditions ?? [])];
89
+ if (conditions.length === 0 && options.exitTime === undefined)
90
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'transition needs a condition or an exit time');
91
+ for (const condition of conditions)
92
+ if (typeof condition.parameter !== 'string' || condition.parameter.length === 0)
93
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'condition parameter');
94
+ const duration = Math.max(0, requireFinite3D(options.duration ?? 0.2, 'transition duration'));
95
+ this.#transitions.push({
96
+ from: options.from,
97
+ to: options.to,
98
+ duration,
99
+ conditions,
100
+ exitTime: options.exitTime === undefined ? undefined : requireFinite3D(options.exitTime, 'exitTime'),
101
+ canInterrupt: options.canInterrupt ?? true
102
+ });
103
+ return this;
104
+ }
105
+ /** Run `callback` each time `state` passes `normalizedTime` (0 to 1 within one pass). */
106
+ addEvent(state, normalizedTime, callback) {
107
+ const target = this.#states.get(state);
108
+ if (!target || typeof callback !== 'function')
109
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'event');
110
+ target.events.push({ time: Math.min(Math.max(requireFinite3D(normalizedTime, 'event time'), 0), 1), callback });
111
+ return this;
112
+ }
113
+ set(parameter, value) {
114
+ if (typeof value !== 'boolean')
115
+ requireFinite3D(value, 'parameter ' + parameter);
116
+ this.#parameters.set(parameter, value);
117
+ return this;
118
+ }
119
+ get(parameter) {
120
+ return this.#parameters.get(parameter);
121
+ }
122
+ /** Raise a one-shot flag; the first transition that tests it consumes it. */
123
+ trigger(parameter) {
124
+ this.#triggers.add(parameter);
125
+ return this;
126
+ }
127
+ resetTrigger(parameter) {
128
+ this.#triggers.delete(parameter);
129
+ return this;
130
+ }
131
+ /** Switch to `state` now, cross-fading over `duration` seconds. */
132
+ play(state, duration = 0) {
133
+ const next = this.#states.get(state);
134
+ if (!next)
135
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'state: ' + state);
136
+ this.enter(next, Math.max(0, requireFinite3D(duration, 'duration')));
137
+ return this;
138
+ }
139
+ enter(next, duration) {
140
+ const previous = this.#current;
141
+ if (previous === next && !this.#fading)
142
+ return;
143
+ previous?.onExit?.();
144
+ // Every state fades from the weight it holds right now, so interrupting a fade is seamless.
145
+ for (const state of this.#states.values())
146
+ state.fadeFrom = state.weight;
147
+ if (next.weight === 0) {
148
+ next.normalizedTime = 0;
149
+ for (const action of next.actions)
150
+ action.reset().play();
151
+ }
152
+ this.#current = next;
153
+ this.#fadeDuration = duration;
154
+ this.#fadeElapsed = 0;
155
+ this.#fading = duration > 0;
156
+ if (!this.#fading)
157
+ for (const state of this.#states.values())
158
+ state.weight = state === next ? 1 : 0;
159
+ next.onEnter?.();
160
+ this.onStateChange?.(previous?.name, next.name);
161
+ }
162
+ holds(condition) {
163
+ if (this.#triggers.has(condition.parameter))
164
+ return condition.op === undefined;
165
+ const value = this.#parameters.get(condition.parameter);
166
+ if (condition.op === undefined)
167
+ return value === true;
168
+ if (value === undefined || condition.value === undefined)
169
+ return false;
170
+ switch (condition.op) {
171
+ case '>':
172
+ return value > condition.value;
173
+ case '>=':
174
+ return value >= condition.value;
175
+ case '<':
176
+ return value < condition.value;
177
+ case '<=':
178
+ return value <= condition.value;
179
+ case '==':
180
+ return value === condition.value;
181
+ default:
182
+ return value !== condition.value;
183
+ }
184
+ }
185
+ evaluate() {
186
+ const current = this.#current;
187
+ if (!current)
188
+ return false;
189
+ for (const transition of this.#transitions) {
190
+ if (transition.from !== '*' && transition.from !== current.name)
191
+ continue;
192
+ if (transition.to === current.name)
193
+ continue;
194
+ if (this.#fading && !transition.canInterrupt)
195
+ continue;
196
+ if (transition.exitTime !== undefined && current.normalizedTime < transition.exitTime)
197
+ continue;
198
+ if (!transition.conditions.every(condition => this.holds(condition)))
199
+ continue;
200
+ for (const condition of transition.conditions)
201
+ this.#triggers.delete(condition.parameter);
202
+ this.enter(this.#states.get(transition.to), transition.duration);
203
+ return true;
204
+ }
205
+ return false;
206
+ }
207
+ applyState(state, delta) {
208
+ const { actions, thresholds, blendWeights } = state, count = actions.length;
209
+ let duration = actions[0].clip.duration;
210
+ if (count > 1) {
211
+ const raw = state.blendParameter === undefined ? undefined : this.#parameters.get(state.blendParameter);
212
+ const value = Math.min(Math.max(typeof raw === 'number' ? raw : thresholds[0], thresholds[0]), thresholds[count - 1]);
213
+ let upper = 1;
214
+ while (upper < count - 1 && thresholds[upper] < value)
215
+ upper++;
216
+ const lower = upper - 1, span = thresholds[upper] - thresholds[lower], t = span > 0 ? (value - thresholds[lower]) / span : 0;
217
+ blendWeights.fill(0);
218
+ blendWeights[lower] = 1 - t;
219
+ blendWeights[upper] = t;
220
+ // Blend the cycle length too, and scale each clip to it so their phases stay locked.
221
+ duration = actions[lower].clip.duration * (1 - t) + actions[upper].clip.duration * t;
222
+ }
223
+ else
224
+ blendWeights[0] = 1;
225
+ for (let i = 0; i < count; i++) {
226
+ const action = actions[i];
227
+ action.weight = state.weight * blendWeights[i];
228
+ action.timeScale = duration > 0 ? (state.speed * action.clip.duration) / duration : state.speed;
229
+ if (state.weight > 0 && !action.isRunning)
230
+ action.play();
231
+ }
232
+ if (state.weight <= 0)
233
+ return;
234
+ const before = state.normalizedTime, step = duration > 0 ? (delta * state.speed) / duration : 0;
235
+ let after = before + step;
236
+ if (!state.loop)
237
+ after = Math.min(after, 1);
238
+ state.normalizedTime = after;
239
+ if (state.events.length > 0 && after > before) {
240
+ for (const event of state.events) {
241
+ // Count how many times the event time was crossed, wrapping per pass.
242
+ const crossings = Math.floor(after - event.time) - Math.floor(before - event.time);
243
+ if (crossings > 0 || (before === 0 && event.time === 0 && step > 0))
244
+ event.callback();
245
+ }
246
+ }
247
+ }
248
+ /** Evaluate transitions, advance fades and drive the mixer by `deltaSeconds`. */
249
+ update(deltaSeconds) {
250
+ const delta = requireFinite3D(deltaSeconds, 'deltaSeconds') * this.mixer.timeScale;
251
+ // Chained transitions with zero-length states are bounded so a cycle cannot hang the frame.
252
+ for (let i = 0; i < STATE_MACHINE3D_LIMITS.maxTransitionsPerUpdate && this.evaluate(); i++)
253
+ ;
254
+ if (this.#fading) {
255
+ this.#fadeElapsed += Math.abs(delta);
256
+ const k = Math.min(this.#fadeElapsed / this.#fadeDuration, 1);
257
+ for (const state of this.#states.values())
258
+ state.weight = state.fadeFrom * (1 - k) + (state === this.#current ? k : 0);
259
+ if (k >= 1)
260
+ this.#fading = false;
261
+ }
262
+ for (const state of this.#states.values()) {
263
+ if (state.weight <= 0 && state !== this.#current) {
264
+ for (const action of state.actions)
265
+ if (action.isRunning)
266
+ action.stop();
267
+ continue;
268
+ }
269
+ this.applyState(state, delta);
270
+ }
271
+ this.mixer.update(deltaSeconds);
272
+ // Triggers last one update when nothing consumed them.
273
+ this.#triggers.clear();
274
+ }
275
+ }
276
+ /** Makes an animation state machine that drives a mixer. */
277
+ export function createAnimationStateMachine3D(mixer) {
278
+ return new AnimationStateMachine3D(mixer);
279
+ }
280
+ //# sourceMappingURL=StateMachine3D.js.map
@@ -0,0 +1,26 @@
1
+ import type { Material3D, StandardMaterialOptions3D } from './Material3D.js';
2
+ /** The surfaces the shader can draw. */
3
+ export type SurfaceKind3D = 'wood' | 'stone' | 'brick' | 'plaster' | 'metal' | 'cloth' | 'bark';
4
+ /** A material with a surface: the standard material's options and how the surface looks. */
5
+ export interface SurfaceMaterialOptions3D extends StandardMaterialOptions3D {
6
+ readonly surface: SurfaceKind3D;
7
+ /** How many of the pattern's units fit in one world unit; each surface has its own unless given. */
8
+ readonly scale?: number;
9
+ /** How much the pattern darkens and lightens the colour, 0 to 1; 0.5 unless given. */
10
+ readonly strength?: number;
11
+ /** How deep the relief looks under light, 0 to 1; 0.5 unless given. */
12
+ readonly bump?: number;
13
+ }
14
+ /** The shader sources of a surface: its height, the colour it gives and the relief it gives, in GLSL and WGSL. */
15
+ export declare function surfaceShaderSources3D(kind: SurfaceKind3D): {
16
+ glsl: string;
17
+ wgsl: string;
18
+ glslNormal: string;
19
+ wgslNormal: string;
20
+ };
21
+ /**
22
+ * A standard material with a surface drawn by the shader, over its colour or its vertex colours (on unless
23
+ * `vertexColors: false`): `createSurfaceMaterial3D({ surface: 'wood' })` for a crate made in code.
24
+ */
25
+ export declare function createSurfaceMaterial3D(options: SurfaceMaterialOptions3D): Material3D;
26
+ //# sourceMappingURL=SurfaceMaterial3D.d.ts.map
@@ -0,0 +1,138 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // Materials with a surface drawn by the shader: wood grain, stone, brick courses, plaster, brushed metal, woven cloth
3
+ // and bark, as fine as the pixels and not as the mesh. A model made in code carries its colours in its vertices, which
4
+ // cannot hold a line finer than its triangles; these add the detail between them, in colour and in relief, with no
5
+ // texture to load and no texture coordinates to lay out. The pattern is laid in world space and projected from the
6
+ // three axes, so it suits models that stay where they are put (buildings, props, scenery): on one that moves, the
7
+ // pattern stays in the world while the model moves through it.
8
+ import { World3DError } from './core3D.js';
9
+ import { createCustomShader3D, createStandardMaterial3D } from './Material3D.js';
10
+ const KINDS = {
11
+ wood: { scale: 4, roughness: 0.7, metallic: 0 },
12
+ stone: { scale: 2, roughness: 0.9, metallic: 0 },
13
+ brick: { scale: 3, roughness: 0.85, metallic: 0 },
14
+ plaster: { scale: 2, roughness: 0.95, metallic: 0 },
15
+ metal: { scale: 3, roughness: 0.35, metallic: 0.8 },
16
+ cloth: { scale: 20, roughness: 0.9, metallic: 0 },
17
+ bark: { scale: 4, roughness: 0.95, metallic: 0 }
18
+ };
19
+ // The height of each surface at a point p already scaled, with the world normal n for surfaces laid in a plane. The
20
+ // same function, in each shading language, gives the colour (low is darker) and the relief (its slope bends the
21
+ // normal). Heights are about 0 to 1.
22
+ const HEIGHT_GLSL = {
23
+ wood: 'float r = (p.x + p.z) * 3.0 + egsFbm(p * vec3(1.5, 0.12, 1.5)) * 6.0; return 0.5 + 0.5 * sin(r);',
24
+ stone: 'float cracks = smoothstep(0.015, 0.06, abs(egsNoise(p * 1.3) - 0.5)); return mix(0.15, 0.55 + 0.45 * egsFbm(p * 2.0), cracks);',
25
+ brick: 'vec2 q = egsPlane(p, n) * vec2(1.0, 2.0); q.x += 0.5 * mod(floor(q.y), 2.0); vec2 f = abs(fract(q) - 0.5) * vec2(1.0, 0.5);' +
26
+ ' float joint = min(0.5 - f.x, 0.25 - f.y); return smoothstep(0.0, 0.035, joint) * (0.8 + 0.2 * egsNoise(p * 6.0));',
27
+ plaster: 'return 0.45 + 0.55 * egsFbm(p * 1.5 + egsFbm(p * 4.0));',
28
+ metal: 'return 0.55 + 0.45 * egsNoise(p * vec3(1.0, 60.0, 1.0)) * egsNoise(p * 2.0 + 3.0);',
29
+ cloth: 'vec2 q = egsPlane(p, n); return 0.5 + 0.25 * (sin(q.x * 6.2832) * sin(q.y * 3.1416) + sin(q.y * 6.2832) * sin(q.x * 3.1416));',
30
+ bark: 'float ridges = egsNoise(p * vec3(3.0, 0.35, 3.0)); return smoothstep(0.25, 0.75, ridges) * (0.7 + 0.3 * egsNoise(p * 8.0));'
31
+ };
32
+ const HEIGHT_WGSL = {
33
+ wood: 'let r = (p.x + p.z) * 3.0 + egsFbm(p * vec3f(1.5, 0.12, 1.5)) * 6.0; return 0.5 + 0.5 * sin(r);',
34
+ stone: 'let cracks = smoothstep(0.015, 0.06, abs(egsNoise(p * 1.3) - 0.5)); return mix(0.15, 0.55 + 0.45 * egsFbm(p * 2.0), cracks);',
35
+ brick: 'var q = egsPlane(p, n) * vec2f(1.0, 2.0); q.x = q.x + 0.5 * (floor(q.y) - 2.0 * floor(floor(q.y) / 2.0)); let f = abs(fract(q) - vec2f(0.5)) * vec2f(1.0, 0.5);' +
36
+ ' let joint = min(0.5 - f.x, 0.25 - f.y); return smoothstep(0.0, 0.035, joint) * (0.8 + 0.2 * egsNoise(p * 6.0));',
37
+ plaster: 'return 0.45 + 0.55 * egsFbm(p * 1.5 + vec3f(egsFbm(p * 4.0)));',
38
+ metal: 'return 0.55 + 0.45 * egsNoise(p * vec3f(1.0, 60.0, 1.0)) * egsNoise(p * 2.0 + vec3f(3.0));',
39
+ cloth: 'let q = egsPlane(p, n); return 0.5 + 0.25 * (sin(q.x * 6.2832) * sin(q.y * 3.1416) + sin(q.y * 6.2832) * sin(q.x * 3.1416));',
40
+ bark: 'let ridges = egsNoise(p * vec3f(3.0, 0.35, 3.0)); return smoothstep(0.25, 0.75, ridges) * (0.7 + 0.3 * egsNoise(p * 8.0));'
41
+ };
42
+ const NOISE_GLSL = `
43
+ float egsHash(vec3 p) { p = fract(p * 0.3183099 + 0.1); p *= 17.0; return fract(p.x * p.y * p.z * (p.x + p.y + p.z)); }
44
+ float egsNoise(vec3 x) {
45
+ vec3 i = floor(x); vec3 f = fract(x); f = f * f * (3.0 - 2.0 * f);
46
+ return mix(mix(mix(egsHash(i), egsHash(i + vec3(1.0, 0.0, 0.0)), f.x), mix(egsHash(i + vec3(0.0, 1.0, 0.0)), egsHash(i + vec3(1.0, 1.0, 0.0)), f.x), f.y),
47
+ mix(mix(egsHash(i + vec3(0.0, 0.0, 1.0)), egsHash(i + vec3(1.0, 0.0, 1.0)), f.x), mix(egsHash(i + vec3(0.0, 1.0, 1.0)), egsHash(i + vec3(1.0, 1.0, 1.0)), f.x), f.y), f.z);
48
+ }
49
+ float egsFbm(vec3 p) { float s = 0.0; float a = 0.5; for (int i = 0; i < 4; i++) { s += a * egsNoise(p); p = p * 2.03 + vec3(1.7, 9.2, 3.1); a *= 0.5; } return s / 0.9375; }
50
+ vec2 egsPlane(vec3 p, vec3 n) { vec3 a = abs(n); return a.x > a.y && a.x > a.z ? p.zy : (a.z > a.y ? p.xy : p.xz); }
51
+ `;
52
+ const NOISE_WGSL = `
53
+ fn egsHash(p0: vec3f) -> f32 { var p = fract(p0 * 0.3183099 + vec3f(0.1)); p = p * 17.0; return fract(p.x * p.y * p.z * (p.x + p.y + p.z)); }
54
+ fn egsNoise(x: vec3f) -> f32 {
55
+ let i = floor(x); var f = fract(x); f = f * f * (vec3f(3.0) - 2.0 * f);
56
+ return mix(mix(mix(egsHash(i), egsHash(i + vec3f(1.0, 0.0, 0.0)), f.x), mix(egsHash(i + vec3f(0.0, 1.0, 0.0)), egsHash(i + vec3f(1.0, 1.0, 0.0)), f.x), f.y),
57
+ mix(mix(egsHash(i + vec3f(0.0, 0.0, 1.0)), egsHash(i + vec3f(1.0, 0.0, 1.0)), f.x), mix(egsHash(i + vec3f(0.0, 1.0, 1.0)), egsHash(i + vec3f(1.0, 1.0, 1.0)), f.x), f.y), f.z);
58
+ }
59
+ fn egsFbm(p0: vec3f) -> f32 { var s = 0.0; var a = 0.5; var p = p0; for (var i = 0; i < 4; i = i + 1) { s = s + a * egsNoise(p); p = p * 2.03 + vec3f(1.7, 9.2, 3.1); a = a * 0.5; } return s / 0.9375; }
60
+ fn egsPlane(p: vec3f, n: vec3f) -> vec2f { let a = abs(n); if (a.x > a.y && a.x > a.z) { return p.zy; } if (a.z > a.y) { return p.xy; } return p.xz; }
61
+ `;
62
+ /** The shader sources of a surface: its height, the colour it gives and the relief it gives, in GLSL and WGSL. */
63
+ export function surfaceShaderSources3D(kind) {
64
+ if (!Object.prototype.hasOwnProperty.call(KINDS, kind))
65
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'surface');
66
+ // custom[0]: scale, strength, bump. The slope of the height is taken across about a fiftieth of a pattern unit.
67
+ const glslHeight = `${NOISE_GLSL}float egsHeight(vec3 p, vec3 n) { ${HEIGHT_GLSL[kind]} }\n`;
68
+ const wgslHeight = `${NOISE_WGSL}fn egsHeight(p: vec3f, n: vec3f) -> f32 { ${HEIGHT_WGSL[kind]} }\n`;
69
+ return {
70
+ glsl: glslHeight +
71
+ `vec4 customFragment(vec4 color, vec3 worldPosition, vec3 normal, vec2 uv) {
72
+ float h = egsHeight(worldPosition * uCustom[0].x, normal);
73
+ return vec4(color.rgb * mix(1.0 - 0.6 * uCustom[0].y, 1.0 + 0.15 * uCustom[0].y, h), color.a);
74
+ }`,
75
+ wgsl: wgslHeight +
76
+ `fn customFragment(color: vec4f, worldPosition: vec3f, normal: vec3f, uv: vec2f) -> vec4f {
77
+ let h = egsHeight(worldPosition * material.custom[0].x, normal);
78
+ return vec4f(color.rgb * mix(1.0 - 0.6 * material.custom[0].y, 1.0 + 0.15 * material.custom[0].y, h), color.a);
79
+ }`,
80
+ // The engine places the fragment hook before the normal hook in both languages, so the normal hook uses the
81
+ // height and noise the fragment hook defines rather than defining them twice.
82
+ glslNormal: `vec3 customNormal(vec3 normal, vec3 worldPosition, vec2 uv) {
83
+ float s = uCustom[0].x; float e = 0.02;
84
+ vec3 p = worldPosition * s;
85
+ vec3 g = vec3(egsHeight(p + vec3(e, 0.0, 0.0), normal) - egsHeight(p - vec3(e, 0.0, 0.0), normal),
86
+ egsHeight(p + vec3(0.0, e, 0.0), normal) - egsHeight(p - vec3(0.0, e, 0.0), normal),
87
+ egsHeight(p + vec3(0.0, 0.0, e), normal) - egsHeight(p - vec3(0.0, 0.0, e), normal)) / (2.0 * e);
88
+ g -= normal * dot(g, normal);
89
+ return normal - g * (0.06 * uCustom[0].z);
90
+ }`,
91
+ wgslNormal: `fn customNormal(normal: vec3f, worldPosition: vec3f, uv: vec2f) -> vec3f {
92
+ let s = material.custom[0].x; let e = 0.02;
93
+ let p = worldPosition * s;
94
+ var g = vec3f(egsHeight(p + vec3f(e, 0.0, 0.0), normal) - egsHeight(p - vec3f(e, 0.0, 0.0), normal),
95
+ egsHeight(p + vec3f(0.0, e, 0.0), normal) - egsHeight(p - vec3f(0.0, e, 0.0), normal),
96
+ egsHeight(p + vec3f(0.0, 0.0, e), normal) - egsHeight(p - vec3f(0.0, 0.0, e), normal)) / (2.0 * e);
97
+ g = g - normal * dot(g, normal);
98
+ return normal - g * (0.06 * material.custom[0].z);
99
+ }`
100
+ };
101
+ }
102
+ /**
103
+ * A standard material with a surface drawn by the shader, over its colour or its vertex colours (on unless
104
+ * `vertexColors: false`): `createSurfaceMaterial3D({ surface: 'wood' })` for a crate made in code.
105
+ */
106
+ export function createSurfaceMaterial3D(options) {
107
+ if (options === null || typeof options !== 'object')
108
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'surface options');
109
+ const kind = options.surface;
110
+ if (!Object.prototype.hasOwnProperty.call(KINDS, kind))
111
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'surface');
112
+ const defaults = KINDS[kind];
113
+ const amount = (value, fallback, what, max = 1) => {
114
+ if (value === undefined)
115
+ return fallback;
116
+ if (typeof value !== 'number' || !Number.isFinite(value) || value < 0 || value > max)
117
+ throw new World3DError('WORLD3D_INPUT_INVALID', what);
118
+ return value;
119
+ };
120
+ const scale = amount(options.scale, defaults.scale, 'surface scale', 1000);
121
+ if (scale === 0)
122
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'surface scale');
123
+ const strength = amount(options.strength, 0.5, 'surface strength'), bump = amount(options.bump, 0.5, 'surface bump');
124
+ const { surface: _surface, scale: _scale, strength: _strength, bump: _bump, ...rest } = options;
125
+ const material = createStandardMaterial3D({
126
+ roughness: defaults.roughness,
127
+ metallic: defaults.metallic,
128
+ vertexColors: true,
129
+ ...rest
130
+ });
131
+ material.shader = createCustomShader3D({
132
+ key: 'surface-' + kind,
133
+ ...surfaceShaderSources3D(kind),
134
+ uniforms: [scale, strength, bump, 0]
135
+ });
136
+ return material;
137
+ }
138
+ //# sourceMappingURL=SurfaceMaterial3D.js.map