@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,607 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // Save and restore a World3D subtree as plain JSON-safe data. Node
3
+ // transforms, cameras, lights, meshes, materials, geometries, skeletons and
4
+ // level-of-detail groups round-trip. Geometry data and small owned textures
5
+ // are embedded as base64; other textures are stored by a caller-chosen key
6
+ // and resolved again on load, so large images stay outside the saved data.
7
+ import { Camera3D } from './Camera3D.js';
8
+ import { World3DError } from './core3D.js';
9
+ import { Attribute3D, Geometry3D } from './Geometry3D.js';
10
+ import { Lod3D, ScreenLayer3D } from './helpers3D.js';
11
+ import { Light3D } from './Light3D.js';
12
+ import { Material3D } from './Material3D.js';
13
+ import { Bone3D, InstancedMesh3D, Mesh3D, Skeleton3D } from './Mesh3D.js';
14
+ import { Object3D, Scene3D } from './Object3D.js';
15
+ import { ParticleEmitter3D } from './Particles3D.js';
16
+ import { RenderTarget3D, Texture3D, isCompressedPixels3D, isTexturePixels3D } from './Texture3D.js';
17
+ export const SCENE_DOCUMENT_FORMAT_3D = 'egret.world3d.scene';
18
+ export const SCENE_DOCUMENT_VERSION_3D = 1;
19
+ export const SERIALIZE3D_LIMITS = Object.freeze({
20
+ maxNodes: 65536,
21
+ maxEmbeddedTextureBytes: 1048576,
22
+ maxDocumentBytes: 268435456
23
+ });
24
+ const ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
25
+ function encodeBase64(bytes) {
26
+ let out = '';
27
+ for (let i = 0; i < bytes.length; i += 3) {
28
+ const a = bytes[i], b = bytes[i + 1], c = bytes[i + 2];
29
+ out +=
30
+ ALPHABET[a >> 2] +
31
+ ALPHABET[((a & 3) << 4) | ((b ?? 0) >> 4)] +
32
+ (b === undefined ? '=' : ALPHABET[((b & 15) << 2) | ((c ?? 0) >> 6)]) +
33
+ (c === undefined ? '=' : ALPHABET[c & 63]);
34
+ }
35
+ return out;
36
+ }
37
+ function decodeBase64(text) {
38
+ if (typeof text !== 'string' || text.length % 4 !== 0)
39
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'saved scene: base64');
40
+ const padding = text.endsWith('==') ? 2 : text.endsWith('=') ? 1 : 0, out = new Uint8Array((text.length / 4) * 3 - padding);
41
+ let o = 0;
42
+ for (let i = 0; i < text.length; i += 4) {
43
+ let bits = 0;
44
+ for (let k = 0; k < 4; k++) {
45
+ const char = text[i + k], value = char === '=' ? 0 : ALPHABET.indexOf(char);
46
+ if (value < 0)
47
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'saved scene: base64');
48
+ bits = (bits << 6) | value;
49
+ }
50
+ if (o < out.length)
51
+ out[o++] = (bits >> 16) & 255;
52
+ if (o < out.length)
53
+ out[o++] = (bits >> 8) & 255;
54
+ if (o < out.length)
55
+ out[o++] = bits & 255;
56
+ }
57
+ return out;
58
+ }
59
+ const ARRAY_TYPES = {
60
+ f32: Float32Array,
61
+ u32: Uint32Array,
62
+ u16: Uint16Array,
63
+ u8: Uint8Array,
64
+ i16: Int16Array,
65
+ i8: Int8Array
66
+ };
67
+ function packArray(data) {
68
+ const type = Object.keys(ARRAY_TYPES).find(tag => data instanceof ARRAY_TYPES[tag]);
69
+ return { type, data: encodeBase64(new Uint8Array(data.buffer, data.byteOffset, data.byteLength)) };
70
+ }
71
+ function unpackArray(packed) {
72
+ const Type = ARRAY_TYPES[packed?.type];
73
+ if (!Type)
74
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'saved scene: array type');
75
+ const bytes = decodeBase64(packed.data);
76
+ if (bytes.byteLength % Type.BYTES_PER_ELEMENT !== 0)
77
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'saved scene: array length');
78
+ // Copy into an aligned buffer of the element type.
79
+ return new Type(bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength));
80
+ }
81
+ /** Keep only JSON-representable application data; functions, cycles and class instances are dropped. */
82
+ function plainData(value, depth = 0) {
83
+ if (value === null || typeof value === 'string' || typeof value === 'boolean')
84
+ return value;
85
+ if (typeof value === 'number')
86
+ return Number.isFinite(value) ? value : undefined;
87
+ if (depth > 16 || typeof value !== 'object')
88
+ return undefined;
89
+ if (Array.isArray(value))
90
+ return value.map(item => plainData(item, depth + 1) ?? null);
91
+ if (Object.getPrototypeOf(value) !== Object.prototype)
92
+ return undefined;
93
+ const out = {};
94
+ for (const [key, item] of Object.entries(value)) {
95
+ const plain = plainData(item, depth + 1);
96
+ if (plain !== undefined)
97
+ out[key] = plain;
98
+ }
99
+ return out;
100
+ }
101
+ const MATERIAL_SCALARS = [
102
+ 'opacity',
103
+ 'side',
104
+ 'alphaMode',
105
+ 'alphaCutoff',
106
+ 'blending',
107
+ 'depthTest',
108
+ 'depthWrite',
109
+ 'vertexColors',
110
+ 'fog',
111
+ 'toneMapped',
112
+ 'visible',
113
+ 'emissiveIntensity',
114
+ 'normalScale',
115
+ 'occlusionStrength',
116
+ 'flatShading',
117
+ 'wireframe',
118
+ 'shininess',
119
+ 'toonSteps',
120
+ 'clearcoat',
121
+ 'clearcoatRoughness',
122
+ 'lightMapIntensity',
123
+ 'reflectionStrength',
124
+ 'reflectionDistortion',
125
+ 'softness',
126
+ 'sheen',
127
+ 'sheenRoughness',
128
+ 'transmission',
129
+ 'ior',
130
+ 'thickness',
131
+ 'metallic',
132
+ 'roughness',
133
+ 'environmentIntensity',
134
+ 'billboard',
135
+ 'screenSpace',
136
+ 'sizeAttenuation',
137
+ 'rotation',
138
+ 'pointSize'
139
+ ];
140
+ const MATERIAL_MAPS = ['map', 'emissiveMap', 'normalMap', 'occlusionMap', 'metallicRoughnessMap', 'lightMap'];
141
+ const NODE_FLAGS = ['visible', 'layers', 'renderOrder', 'castShadow', 'receiveShadow', 'frustumCulled'];
142
+ /** Write the subtree under `root` as JSON-safe data. */
143
+ export function serializeScene3D(root, options = {}) {
144
+ if (!(root instanceof Object3D))
145
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'root');
146
+ const nodes = [], geometries = [], materials = [], textures = [], skeletons = [], skipped = [];
147
+ const nodeIds = new Map(), geometryIds = new Map(), materialIds = new Map();
148
+ const textureIds = new Map(), skeletonIds = new Map();
149
+ const pendingSkins = [];
150
+ const texture = (value) => {
151
+ if (!value || value.isDisposed)
152
+ return undefined;
153
+ const known = textureIds.get(value);
154
+ if (known !== undefined)
155
+ return known;
156
+ const entry = {
157
+ name: value.name,
158
+ wrapS: value.wrapS,
159
+ wrapT: value.wrapT,
160
+ magFilter: value.magFilter,
161
+ minFilter: value.minFilter,
162
+ mipmaps: value.mipmaps,
163
+ colorSpace: value.colorSpace,
164
+ flipY: value.flipY,
165
+ anisotropy: value.anisotropy,
166
+ offset: [...value.offset],
167
+ repeat: [...value.repeat],
168
+ rotation: value.rotation
169
+ };
170
+ if (value.channel === 1)
171
+ entry['channel'] = 1;
172
+ const key = options.textureKey?.(value), source = value.source;
173
+ if (typeof key === 'string' && key.length > 0)
174
+ entry['key'] = key;
175
+ else if (isTexturePixels3D(source) && source.data.byteLength <= SERIALIZE3D_LIMITS.maxEmbeddedTextureBytes) {
176
+ entry['pixels'] = { width: source.width, height: source.height, data: encodeBase64(source.data) };
177
+ }
178
+ else if (isCompressedPixels3D(source) &&
179
+ source.levels.reduce((sum, level) => sum + level.byteLength, 0) <= SERIALIZE3D_LIMITS.maxEmbeddedTextureBytes) {
180
+ entry['compressed'] = {
181
+ width: source.width,
182
+ height: source.height,
183
+ format: source.format,
184
+ levels: source.levels.map(encodeBase64)
185
+ };
186
+ }
187
+ else
188
+ return undefined; // Host images, render targets and large textures need a key.
189
+ textureIds.set(value, textures.length);
190
+ textures.push(entry);
191
+ return textures.length - 1;
192
+ };
193
+ const material = (value) => {
194
+ const known = materialIds.get(value);
195
+ if (known !== undefined)
196
+ return known;
197
+ const entry = {
198
+ name: value.name,
199
+ shading: value.shading,
200
+ color: [...value.color],
201
+ emissive: [...value.emissive],
202
+ specular: [...value.specular]
203
+ };
204
+ for (const field of MATERIAL_SCALARS)
205
+ entry[field] = value[field];
206
+ if (value.polygonOffset)
207
+ entry['polygonOffset'] = [...value.polygonOffset];
208
+ for (const field of MATERIAL_MAPS) {
209
+ const id = texture(value[field]);
210
+ if (id !== undefined)
211
+ entry[field] = id;
212
+ }
213
+ materialIds.set(value, materials.length);
214
+ materials.push(entry);
215
+ return materials.length - 1;
216
+ };
217
+ const geometry = (value) => {
218
+ const known = geometryIds.get(value);
219
+ if (known !== undefined)
220
+ return known;
221
+ const attributes = {};
222
+ for (const [name, attribute] of value.attributes)
223
+ attributes[name] = {
224
+ ...packArray(attribute.data),
225
+ itemSize: attribute.itemSize,
226
+ normalized: attribute.normalized
227
+ };
228
+ const entry = {
229
+ name: value.name,
230
+ topology: value.topology,
231
+ attributes,
232
+ groups: value.groups.map(group => ({ ...group }))
233
+ };
234
+ if (value.index)
235
+ entry['index'] = packArray(value.index.data);
236
+ if (value.morphTargets.length > 0) {
237
+ entry['morphTargets'] = value.morphTargets.map(target => ({
238
+ name: target.name,
239
+ ...(target.position ? { position: packArray(target.position) } : {}),
240
+ ...(target.normal ? { normal: packArray(target.normal) } : {})
241
+ }));
242
+ }
243
+ geometryIds.set(value, geometries.length);
244
+ geometries.push(entry);
245
+ return geometries.length - 1;
246
+ };
247
+ const visit = (object, parent) => {
248
+ if (nodes.length >= SERIALIZE3D_LIMITS.maxNodes)
249
+ throw new World3DError('WORLD3D_BUDGET', 'saved scene nodes');
250
+ const id = nodes.length;
251
+ const entry = {
252
+ name: object.name,
253
+ type: 'object',
254
+ position: [...object.position],
255
+ quaternion: [...object.quaternion],
256
+ scale: [...object.scale],
257
+ ...(parent === undefined ? {} : { parent })
258
+ };
259
+ for (const flag of NODE_FLAGS)
260
+ entry[flag] = object[flag];
261
+ const userData = plainData(object.userData);
262
+ if (userData && Object.keys(userData).length > 0)
263
+ entry['userData'] = userData;
264
+ nodeIds.set(object, id);
265
+ nodes.push(entry);
266
+ if (object instanceof ParticleEmitter3D || object instanceof ScreenLayer3D)
267
+ skipped.push(object.name || object.constructor.name);
268
+ else if (object instanceof Scene3D) {
269
+ entry['type'] = 'scene';
270
+ if (Array.isArray(object.background))
271
+ entry['background'] = [...object.background];
272
+ entry['backgroundIntensity'] = object.backgroundIntensity;
273
+ entry['environmentIntensity'] = object.environmentIntensity;
274
+ if (object.fog)
275
+ entry['fog'] = { ...object.fog, color: [...object.fog.color] };
276
+ }
277
+ else if (object instanceof Camera3D) {
278
+ entry['type'] = 'camera';
279
+ Object.assign(entry, {
280
+ projection: object.projectionKind,
281
+ fov: object.fov,
282
+ orthographicHeight: object.orthographicHeight,
283
+ aspect: object.aspect,
284
+ near: object.near,
285
+ far: object.far,
286
+ zoom: object.zoom,
287
+ layerMask: object.layerMask
288
+ });
289
+ }
290
+ else if (object instanceof Light3D) {
291
+ entry['type'] = 'light';
292
+ Object.assign(entry, {
293
+ lightType: object.lightType,
294
+ color: [...object.color],
295
+ groundColor: [...object.groundColor],
296
+ intensity: object.intensity,
297
+ range: object.range,
298
+ angle: object.angle,
299
+ penumbra: object.penumbra,
300
+ shadow: { ...object.shadow }
301
+ });
302
+ }
303
+ else if (object instanceof Mesh3D) {
304
+ entry['type'] = object instanceof InstancedMesh3D ? 'instanced' : 'mesh';
305
+ entry['geometry'] = geometry(object.geometry);
306
+ entry['material'] = Array.isArray(object.material) ? object.material.map(material) : material(object.material);
307
+ if (object.morphWeights.length > 0)
308
+ entry['morphWeights'] = [...object.morphWeights];
309
+ if (object.skeleton) {
310
+ entry['bindMatrix'] = [...object.bindMatrix];
311
+ pendingSkins.push({ node: entry, skeleton: object.skeleton });
312
+ }
313
+ if (object instanceof InstancedMesh3D) {
314
+ entry['capacity'] = object.capacity;
315
+ entry['count'] = object.count;
316
+ entry['instanceColorSize'] = object.instanceColorSize;
317
+ entry['instanceMatrices'] = packArray(object.instanceMatrices.subarray(0, object.count * 16));
318
+ if (object.instanceColors)
319
+ entry['instanceColors'] = packArray(object.instanceColors.subarray(0, object.count * object.instanceColorSize));
320
+ }
321
+ }
322
+ else if (object instanceof Bone3D)
323
+ entry['type'] = 'bone';
324
+ else if (object instanceof Lod3D)
325
+ entry['type'] = 'lod';
326
+ for (const child of object.children)
327
+ visit(child, id);
328
+ if (object instanceof Lod3D)
329
+ entry['levels'] = object.levels.map(level => ({ node: nodeIds.get(level.object), distance: level.distance }));
330
+ };
331
+ visit(root, undefined);
332
+ for (const { node, skeleton } of pendingSkins) {
333
+ let id = skeletonIds.get(skeleton);
334
+ if (id === undefined) {
335
+ const bones = skeleton.bones.map(bone => nodeIds.get(bone));
336
+ // A skeleton whose bones lie outside the saved subtree cannot be restored.
337
+ if (bones.some(bone => bone === undefined))
338
+ continue;
339
+ id = skeletons.length;
340
+ skeletonIds.set(skeleton, id);
341
+ skeletons.push({ bones, inverseBindMatrices: packArray(skeleton.inverseBindMatrices) });
342
+ }
343
+ node['skeleton'] = id;
344
+ }
345
+ return {
346
+ format: SCENE_DOCUMENT_FORMAT_3D,
347
+ version: SCENE_DOCUMENT_VERSION_3D,
348
+ root: 0,
349
+ nodes,
350
+ geometries,
351
+ materials,
352
+ textures,
353
+ skeletons,
354
+ skipped
355
+ };
356
+ }
357
+ function vector(value, length, field) {
358
+ if (!Array.isArray(value) || value.length !== length || !value.every(Number.isFinite))
359
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'saved scene: ' + field);
360
+ return value;
361
+ }
362
+ /** Rebuild a subtree from data produced by serializeScene3D. */
363
+ export function deserializeScene3D(saved, options = {}) {
364
+ const doc = saved;
365
+ if (!doc || doc['format'] !== SCENE_DOCUMENT_FORMAT_3D)
366
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'saved scene: format');
367
+ if (doc['version'] !== SCENE_DOCUMENT_VERSION_3D)
368
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'saved scene: version ' + doc['version']);
369
+ for (const list of ['nodes', 'geometries', 'materials', 'textures', 'skeletons'])
370
+ if (!Array.isArray(doc[list]))
371
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'saved scene: ' + list);
372
+ if (doc['nodes'].length === 0 || doc['nodes'].length > SERIALIZE3D_LIMITS.maxNodes)
373
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'saved scene: nodes');
374
+ const created = [], ownedTextures = [], geometries = [], materials = [], cameras = [];
375
+ try {
376
+ const textures = doc['textures'].map((entry) => {
377
+ if (typeof entry['key'] === 'string') {
378
+ const resolved = options.resolveTexture?.(entry['key']);
379
+ if (resolved)
380
+ return resolved;
381
+ return undefined; // A missing reference leaves the slot empty instead of failing the whole scene.
382
+ }
383
+ let source;
384
+ if (entry['pixels'])
385
+ source = {
386
+ width: entry['pixels'].width,
387
+ height: entry['pixels'].height,
388
+ data: decodeBase64(entry['pixels'].data)
389
+ };
390
+ else if (entry['compressed'])
391
+ source = {
392
+ width: entry['compressed'].width,
393
+ height: entry['compressed'].height,
394
+ format: entry['compressed'].format,
395
+ levels: entry['compressed'].levels.map(decodeBase64)
396
+ };
397
+ else
398
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'saved scene: texture source');
399
+ const texture = new Texture3D(source, {
400
+ name: entry['name'],
401
+ wrapS: entry['wrapS'],
402
+ wrapT: entry['wrapT'],
403
+ magFilter: entry['magFilter'],
404
+ minFilter: entry['minFilter'],
405
+ mipmaps: entry['mipmaps'],
406
+ colorSpace: entry['colorSpace'],
407
+ flipY: entry['flipY'],
408
+ anisotropy: entry['anisotropy'],
409
+ channel: entry['channel']
410
+ });
411
+ texture.offset.set(vector(entry['offset'], 2, 'texture offset'));
412
+ texture.repeat.set(vector(entry['repeat'], 2, 'texture repeat'));
413
+ texture.rotation = entry['rotation'] ?? 0;
414
+ created.push(texture);
415
+ ownedTextures.push(texture);
416
+ return texture;
417
+ });
418
+ for (const entry of doc['materials']) {
419
+ if (!['unlit', 'lambert', 'phong', 'standard', 'toon', 'matcap'].includes(entry['shading']))
420
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'saved scene: shading');
421
+ const material = new Material3D(entry['shading'], { name: entry['name'] ?? '' });
422
+ created.push(material);
423
+ materials.push(material);
424
+ material.color.set(vector(entry['color'], 3, 'color'));
425
+ material.emissive.set(vector(entry['emissive'], 3, 'emissive'));
426
+ material.specular.set(vector(entry['specular'], 3, 'specular'));
427
+ const target = material;
428
+ for (const field of MATERIAL_SCALARS)
429
+ if (entry[field] !== undefined && typeof entry[field] === typeof target[field])
430
+ target[field] = entry[field];
431
+ if (entry['polygonOffset'])
432
+ material.polygonOffset = vector(entry['polygonOffset'], 2, 'polygonOffset');
433
+ for (const field of MATERIAL_MAPS)
434
+ if (typeof entry[field] === 'number')
435
+ material[field] = textures[entry[field]];
436
+ }
437
+ for (const entry of doc['geometries']) {
438
+ const geometry = new Geometry3D();
439
+ created.push(geometry);
440
+ geometries.push(geometry);
441
+ geometry.name = entry['name'] ?? '';
442
+ geometry.topology = entry['topology'];
443
+ // Positions first: the index and morph targets are validated against the vertex count.
444
+ const names = Object.keys(entry['attributes'] ?? {}).sort((a, b) => (a === 'position' ? -1 : 0) - (b === 'position' ? -1 : 0));
445
+ for (const name of names) {
446
+ const packed = entry['attributes'][name];
447
+ geometry.setAttribute(name, new Attribute3D(unpackArray(packed), packed.itemSize, packed.normalized === true));
448
+ }
449
+ if (entry['index'])
450
+ geometry.setIndex(unpackArray(entry['index']));
451
+ for (const group of (entry['groups'] ?? []))
452
+ geometry.addGroup(group['start'], group['count'], group['materialIndex']);
453
+ if (entry['morphTargets']) {
454
+ geometry.setMorphTargets(entry['morphTargets'].map((target) => ({
455
+ name: target['name'],
456
+ ...(target['position'] ? { position: unpackArray(target['position']) } : {}),
457
+ ...(target['normal'] ? { normal: unpackArray(target['normal']) } : {})
458
+ })));
459
+ }
460
+ }
461
+ const pick = (list, index, field) => {
462
+ const item = typeof index === 'number' ? list[index] : undefined;
463
+ if (item === undefined)
464
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'saved scene: ' + field);
465
+ return item;
466
+ };
467
+ const nodes = doc['nodes'].map((entry) => {
468
+ let node;
469
+ switch (entry['type']) {
470
+ case 'scene': {
471
+ const scene = new Scene3D();
472
+ if (entry['background'])
473
+ scene.background = vector(entry['background'], 3, 'background');
474
+ scene.backgroundIntensity = entry['backgroundIntensity'] ?? 1;
475
+ scene.environmentIntensity = entry['environmentIntensity'] ?? 1;
476
+ if (entry['fog'])
477
+ scene.fog = entry['fog'];
478
+ node = scene;
479
+ break;
480
+ }
481
+ case 'camera': {
482
+ const camera = new Camera3D(entry['projection'] === 'orthographic' ? 'orthographic' : 'perspective');
483
+ camera.fov = entry['fov'];
484
+ camera.orthographicHeight = entry['orthographicHeight'];
485
+ camera.aspect = entry['aspect'];
486
+ camera.near = entry['near'];
487
+ camera.far = entry['far'];
488
+ camera.zoom = entry['zoom'];
489
+ camera.layerMask = entry['layerMask'];
490
+ cameras.push(camera);
491
+ node = camera;
492
+ break;
493
+ }
494
+ case 'light': {
495
+ const light = new Light3D(entry['lightType']);
496
+ light.color.set(vector(entry['color'], 3, 'light color'));
497
+ light.groundColor.set(vector(entry['groundColor'], 3, 'ground color'));
498
+ light.intensity = entry['intensity'];
499
+ light.range = entry['range'];
500
+ light.angle = entry['angle'];
501
+ light.penumbra = entry['penumbra'];
502
+ Object.assign(light.shadow, entry['shadow']);
503
+ node = light;
504
+ break;
505
+ }
506
+ case 'mesh':
507
+ case 'instanced': {
508
+ const geometry = pick(geometries, entry['geometry'], 'mesh geometry');
509
+ const material = Array.isArray(entry['material'])
510
+ ? entry['material'].map(index => pick(materials, index, 'mesh material'))
511
+ : pick(materials, entry['material'], 'mesh material');
512
+ if (entry['type'] === 'instanced') {
513
+ const mesh = new InstancedMesh3D(geometry, material, entry['capacity'], entry['instanceColorSize'] === 4 ? 4 : 3);
514
+ mesh.count = Math.min(entry['count'], mesh.capacity);
515
+ mesh.instanceMatrices.set(unpackArray(entry['instanceMatrices']).subarray(0, mesh.count * 16));
516
+ if (entry['instanceColors']) {
517
+ mesh.instanceColors = new Float32Array(mesh.capacity * mesh.instanceColorSize).fill(1);
518
+ mesh.instanceColors.set(unpackArray(entry['instanceColors']).subarray(0, mesh.count * mesh.instanceColorSize));
519
+ }
520
+ mesh.instanceVersion++;
521
+ node = mesh;
522
+ }
523
+ else
524
+ node = new Mesh3D(geometry, material);
525
+ const mesh = node;
526
+ if (entry['morphWeights']) {
527
+ mesh.syncMorphWeights();
528
+ mesh.morphWeights.set(entry['morphWeights'].slice(0, mesh.morphWeights.length));
529
+ }
530
+ break;
531
+ }
532
+ case 'bone':
533
+ node = new Bone3D();
534
+ break;
535
+ case 'lod':
536
+ node = new Lod3D();
537
+ break;
538
+ default:
539
+ node = new Object3D();
540
+ }
541
+ node.name = typeof entry['name'] === 'string' ? entry['name'] : '';
542
+ node.position.set(vector(entry['position'], 3, 'position'));
543
+ node.quaternion.set(vector(entry['quaternion'], 4, 'quaternion'));
544
+ node.scale.set(vector(entry['scale'], 3, 'scale'));
545
+ node.markTransformDirty();
546
+ const target = node;
547
+ for (const flag of NODE_FLAGS)
548
+ if (typeof entry[flag] === typeof target[flag])
549
+ target[flag] = entry[flag];
550
+ if (entry['userData'])
551
+ node.userData = plainData(entry['userData']);
552
+ return node;
553
+ });
554
+ // Parents always precede their children in the saved data, so one pass links the tree.
555
+ doc['nodes'].forEach((entry, index) => {
556
+ if (entry['parent'] === undefined)
557
+ return;
558
+ if (typeof entry['parent'] !== 'number' || entry['parent'] >= index)
559
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'saved scene: parent order');
560
+ const parent = nodes[entry['parent']], node = nodes[index];
561
+ if (parent instanceof Lod3D)
562
+ return; // Level-of-detail children are attached with their distances below.
563
+ parent.addChild(node);
564
+ });
565
+ doc['nodes'].forEach((entry, index) => {
566
+ const node = nodes[index];
567
+ if (node instanceof Lod3D)
568
+ for (const level of (entry['levels'] ?? []))
569
+ node.addLevel(pick(nodes, level['node'], 'lod level'), level['distance']);
570
+ });
571
+ const root = pick(nodes, doc['root'], 'root');
572
+ root.updateWorldMatrices();
573
+ const skeletons = doc['skeletons'].map(entry => new Skeleton3D(entry['bones'].map(index => pick(nodes, index, 'bone')), unpackArray(entry['inverseBindMatrices'])));
574
+ doc['nodes'].forEach((entry, index) => {
575
+ if (entry['skeleton'] === undefined)
576
+ return;
577
+ const mesh = nodes[index];
578
+ if (mesh instanceof Mesh3D)
579
+ mesh.bind(pick(skeletons, entry['skeleton'], 'skeleton'), vector(entry['bindMatrix'], 16, 'bindMatrix'));
580
+ });
581
+ let disposed = false;
582
+ return Object.freeze({
583
+ root,
584
+ cameras: Object.freeze(cameras),
585
+ geometries: Object.freeze(geometries),
586
+ materials: Object.freeze(materials),
587
+ textures: Object.freeze(ownedTextures),
588
+ dispose() {
589
+ if (disposed)
590
+ return;
591
+ disposed = true;
592
+ for (const resource of created)
593
+ resource.dispose();
594
+ }
595
+ });
596
+ }
597
+ catch (cause) {
598
+ // Never leak partially created resources when the input is refused midway.
599
+ for (const resource of created)
600
+ resource.dispose();
601
+ if (cause instanceof World3DError)
602
+ throw cause;
603
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'saved scene: malformed', cause);
604
+ }
605
+ }
606
+ void RenderTarget3D;
607
+ //# sourceMappingURL=Serialize3D.js.map
@@ -0,0 +1,78 @@
1
+ import { AnimationMixer3D } from './Animation3D.js';
2
+ import type { AnimationClip3D } from './Animation3D.js';
3
+ export declare const STATE_MACHINE3D_LIMITS: Readonly<{
4
+ readonly maxStates: 256;
5
+ readonly maxTransitions: 2048;
6
+ readonly maxTransitionsPerUpdate: 8;
7
+ }>;
8
+ export type StateParameter3D = number | boolean;
9
+ export type StateConditionOperator3D = '>' | '>=' | '<' | '<=' | '==' | '!=';
10
+ export interface StateCondition3D {
11
+ readonly parameter: string;
12
+ /** Comparison against `value`. Omit both to test a boolean or a trigger for true. */
13
+ readonly op?: StateConditionOperator3D;
14
+ readonly value?: StateParameter3D;
15
+ }
16
+ export interface StateBlendEntry3D {
17
+ readonly clip: AnimationClip3D;
18
+ /** Parameter value at which this clip plays alone. */
19
+ readonly threshold: number;
20
+ }
21
+ export interface StateOptions3D {
22
+ /** A single clip, or omit it and give `blend`. */
23
+ readonly clip?: AnimationClip3D;
24
+ /** Blend neighbouring clips by a numeric parameter, with their phases kept in step. */
25
+ readonly blend?: {
26
+ readonly parameter: string;
27
+ readonly clips: readonly StateBlendEntry3D[];
28
+ };
29
+ /** Repeat (default) or play once and hold the last frame. */
30
+ readonly loop?: boolean;
31
+ readonly speed?: number;
32
+ readonly onEnter?: () => void;
33
+ readonly onExit?: () => void;
34
+ }
35
+ export interface TransitionOptions3D {
36
+ /** Source state, or '*' for any state. */
37
+ readonly from: string;
38
+ readonly to: string;
39
+ /** Cross-fade length in seconds. */
40
+ readonly duration?: number;
41
+ /** Every condition must hold. With none, the transition needs an exit time. */
42
+ readonly conditions?: readonly StateCondition3D[];
43
+ /** Normalized play time of the source state (1 = one full pass) that must be reached first. */
44
+ readonly exitTime?: number;
45
+ /** Allow this transition to start while another fade is still running. Defaults to true. */
46
+ readonly canInterrupt?: boolean;
47
+ }
48
+ export declare class AnimationStateMachine3D {
49
+ #private;
50
+ readonly mixer: AnimationMixer3D;
51
+ /** Called after every state change, including forced ones. */
52
+ onStateChange: ((from: string | undefined, to: string) => void) | undefined;
53
+ constructor(mixer: AnimationMixer3D);
54
+ /** Name of the active state; during a fade this is the state being faded in. */
55
+ get current(): string | undefined;
56
+ get isTransitioning(): boolean;
57
+ /** Play time of the active state in passes of its duration. */
58
+ get normalizedTime(): number;
59
+ addState(name: string, options: StateOptions3D): this;
60
+ addTransition(options: TransitionOptions3D): this;
61
+ /** Run `callback` each time `state` passes `normalizedTime` (0 to 1 within one pass). */
62
+ addEvent(state: string, normalizedTime: number, callback: () => void): this;
63
+ set(parameter: string, value: StateParameter3D): this;
64
+ get(parameter: string): StateParameter3D | undefined;
65
+ /** Raise a one-shot flag; the first transition that tests it consumes it. */
66
+ trigger(parameter: string): this;
67
+ resetTrigger(parameter: string): this;
68
+ /** Switch to `state` now, cross-fading over `duration` seconds. */
69
+ play(state: string, duration?: number): this;
70
+ private enter;
71
+ private holds;
72
+ private evaluate;
73
+ private applyState;
74
+ /** Evaluate transitions, advance fades and drive the mixer by `deltaSeconds`. */
75
+ update(deltaSeconds: number): void;
76
+ }
77
+ export declare function createAnimationStateMachine3D(mixer: AnimationMixer3D): AnimationStateMachine3D;
78
+ //# sourceMappingURL=StateMachine3D.d.ts.map