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