@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,275 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // Decoder for the EXT_meshopt_compression glTF extension, written from the
3
+ // published bitstream description: the vertex codec ("ATTRIBUTES"), the
4
+ // triangle codec ("TRIANGLES"), the index sequence codec ("INDICES") and the
5
+ // three post-decoding filters. It needs no WebAssembly and no dependency, so
6
+ // glTF files compressed this way load without a decoder hook.
7
+ import { World3DError } from './core3D.js';
8
+ export const MESHOPT3D_LIMITS = Object.freeze({ maxStride: 256, maxElements: 268435456 });
9
+ const bad = (detail) => new World3DError('WORLD3D_GLTF_INVALID', 'meshopt ' + detail);
10
+ /** Vertex codec: each byte of the element is stored as deltas against the previous element, in groups of sixteen. */
11
+ function decodeVertices(source, count, stride, out) {
12
+ if (source.length < 1 + stride)
13
+ throw bad('vertex data is too short');
14
+ if ((source[0] & 0xf0) !== 0xa0 || (source[0] & 0x0f) !== 0)
15
+ throw bad('vertex header');
16
+ // The stream ends with a tail whose last `stride` bytes are the element before the first one.
17
+ const tail = Math.max(stride, 32), end = source.length, last = source.slice(end - stride, end);
18
+ const blockMax = Math.min(((8192 / stride) | 0) & ~15, 256), deltas = new Uint8Array(256);
19
+ let at = 1;
20
+ for (let first = 0; first < count; first += blockMax) {
21
+ const block = Math.min(blockMax, count - first), aligned = (block + 15) & ~15, headerBytes = ((aligned >> 4) + 3) >> 2;
22
+ for (let k = 0; k < stride; k++) {
23
+ const header = at;
24
+ at += headerBytes;
25
+ if (at > end)
26
+ throw bad('vertex data ends early');
27
+ for (let group = 0; group < aligned; group += 16) {
28
+ const index = group >> 4, mode = (source[header + (index >> 2)] >> ((index & 3) * 2)) & 3;
29
+ if (mode === 0)
30
+ deltas.fill(0, group, group + 16);
31
+ else if (mode === 3) {
32
+ if (at + 16 > end)
33
+ throw bad('vertex data ends early');
34
+ deltas.set(source.subarray(at, at + 16), group);
35
+ at += 16;
36
+ }
37
+ else {
38
+ // Packed 2-bit or 4-bit deltas; the largest packed value means "read a whole byte instead".
39
+ const bits = mode === 1 ? 2 : 4, sentinel = (1 << bits) - 1, packed = mode === 1 ? 4 : 8, perByte = 8 / bits;
40
+ let extra = at + packed;
41
+ if (extra > end)
42
+ throw bad('vertex data ends early');
43
+ for (let i = 0; i < 16; i++) {
44
+ const value = (source[at + ((i / perByte) | 0)] >> (8 - bits - (i % perByte) * bits)) & sentinel;
45
+ if (value !== sentinel) {
46
+ deltas[group + i] = value;
47
+ continue;
48
+ }
49
+ if (extra >= end)
50
+ throw bad('vertex data ends early');
51
+ deltas[group + i] = source[extra++];
52
+ }
53
+ at = extra;
54
+ }
55
+ }
56
+ let previous = last[k];
57
+ for (let i = 0, write = first * stride + k; i < block; i++, write += stride) {
58
+ // Deltas are stored zigzag: even values count up, odd values count down.
59
+ const delta = deltas[i];
60
+ previous = (previous + ((delta >> 1) ^ -(delta & 1))) & 255;
61
+ out[write] = previous;
62
+ }
63
+ last[k] = previous;
64
+ }
65
+ }
66
+ if (end - at !== tail)
67
+ throw bad('vertex data has the wrong length');
68
+ }
69
+ /** Read a little-endian base-128 number of up to five bytes. */
70
+ function readVarint(source, state, limit) {
71
+ let result = 0, shift = 0;
72
+ for (let i = 0; i < 5; i++) {
73
+ if (state.at >= limit)
74
+ throw bad('index data ends early');
75
+ const byte = source[state.at++];
76
+ result |= (byte & 127) << shift;
77
+ shift += 7;
78
+ if (byte < 128)
79
+ break;
80
+ }
81
+ return result >>> 0;
82
+ }
83
+ /** Triangle codec: one code byte per triangle refers to recently used edges and vertices. */
84
+ function decodeTriangles(source, count, out) {
85
+ if (count % 3 !== 0)
86
+ throw bad('triangle index count');
87
+ const triangles = count / 3;
88
+ if (source.length < 1 + triangles + 16)
89
+ throw bad('index data is too short');
90
+ const version = source[0] & 0x0f;
91
+ if ((source[0] & 0xf0) !== 0xe0 || version > 1)
92
+ throw bad('index header');
93
+ const edges = new Uint32Array(32).fill(0xffffffff), vertices = new Uint32Array(16).fill(0xffffffff);
94
+ const limit = source.length - 16, table = limit, state = { at: 1 + triangles }, directLimit = version >= 1 ? 13 : 15;
95
+ let edgeAt = 0, vertexAt = 0, next = 0, last = 0;
96
+ const pushEdge = (a, b) => {
97
+ edges[edgeAt * 2] = a;
98
+ edges[edgeAt * 2 + 1] = b;
99
+ edgeAt = (edgeAt + 1) & 15;
100
+ };
101
+ // The slot is always written; it only becomes part of the history when `keep` is set.
102
+ const pushVertex = (v, keep) => {
103
+ vertices[vertexAt] = v;
104
+ if (keep)
105
+ vertexAt = (vertexAt + 1) & 15;
106
+ };
107
+ const readIndex = () => {
108
+ const v = readVarint(source, state, limit);
109
+ return (last = (last + ((v >>> 1) ^ -(v & 1))) >>> 0);
110
+ };
111
+ for (let i = 0; i < triangles; i++) {
112
+ const code = source[1 + i];
113
+ let a, b, c;
114
+ if (code < 0xf0) {
115
+ // Reuse an edge from the history; the third corner is new, recent, or given outright.
116
+ const slot = (edgeAt - 1 - (code >> 4)) & 15, third = code & 15;
117
+ a = edges[slot * 2];
118
+ b = edges[slot * 2 + 1];
119
+ if (third < directLimit) {
120
+ c = third === 0 ? next++ : vertices[(vertexAt - 1 - third) & 15];
121
+ pushVertex(c, third === 0);
122
+ }
123
+ else {
124
+ c = third === 15 ? readIndex() : (last = (last + (third === 13 ? -1 : 1)) >>> 0);
125
+ pushVertex(c, true);
126
+ }
127
+ pushEdge(c, b);
128
+ pushEdge(a, c);
129
+ }
130
+ else {
131
+ if (code < 0xfe) {
132
+ // A new first corner; the other two come from a small table stored at the end of the stream.
133
+ const aux = source[table + (code & 15)], second = aux >> 4, third = aux & 15;
134
+ a = next++;
135
+ b = second === 0 ? next++ : vertices[(vertexAt - second) & 15];
136
+ c = third === 0 ? next++ : vertices[(vertexAt - third) & 15];
137
+ pushVertex(a, true);
138
+ pushVertex(b, second === 0);
139
+ pushVertex(c, third === 0);
140
+ }
141
+ else {
142
+ if (state.at >= limit)
143
+ throw bad('index data ends early');
144
+ const aux = source[state.at++], second = aux >> 4, third = aux & 15, firstGiven = code === 0xff;
145
+ if (aux === 0)
146
+ next = 0;
147
+ a = firstGiven ? 0 : next++;
148
+ b = second === 0 ? next++ : vertices[(vertexAt - second) & 15];
149
+ c = third === 0 ? next++ : vertices[(vertexAt - third) & 15];
150
+ if (firstGiven)
151
+ a = readIndex();
152
+ if (second === 15)
153
+ b = readIndex();
154
+ if (third === 15)
155
+ c = readIndex();
156
+ pushVertex(a, true);
157
+ pushVertex(b, second === 0 || second === 15);
158
+ pushVertex(c, third === 0 || third === 15);
159
+ }
160
+ pushEdge(b, a);
161
+ pushEdge(c, b);
162
+ pushEdge(a, c);
163
+ }
164
+ out[i * 3] = a;
165
+ out[i * 3 + 1] = b;
166
+ out[i * 3 + 2] = c;
167
+ }
168
+ if (state.at !== limit)
169
+ throw bad('index data has the wrong length');
170
+ }
171
+ /** Index sequence codec: each index is a delta against one of two running values. */
172
+ function decodeSequence(source, count, out) {
173
+ if (source.length < 1 + count + 4)
174
+ throw bad('index data is too short');
175
+ if ((source[0] & 0xf0) !== 0xd0 || (source[0] & 0x0f) > 1)
176
+ throw bad('index header');
177
+ const limit = source.length - 4, state = { at: 1 }, last = [0, 0];
178
+ for (let i = 0; i < count; i++) {
179
+ const v = readVarint(source, state, limit), which = v & 1, rest = v >>> 1;
180
+ out[i] = last[which] = (last[which] + ((rest >>> 1) ^ -(rest & 1))) >>> 0;
181
+ }
182
+ if (state.at !== limit)
183
+ throw bad('index data has the wrong length');
184
+ }
185
+ const round = (value) => (value >= 0 ? Math.floor(value + 0.5) : Math.ceil(value - 0.5));
186
+ /** Unit vectors stored as a point on an octahedron; the fourth component is left as it is. */
187
+ function filterOctahedral(data, count, stride) {
188
+ if (stride !== 4 && stride !== 8)
189
+ throw bad('octahedral filter stride');
190
+ const view = stride === 4
191
+ ? new Int8Array(data.buffer, data.byteOffset, count * 4)
192
+ : new Int16Array(data.buffer, data.byteOffset, count * 4), max = stride === 4 ? 127 : 32767;
193
+ for (let i = 0; i < count * 4; i += 4) {
194
+ let x = view[i], y = view[i + 1];
195
+ const one = view[i + 2], z = one - Math.abs(x) - Math.abs(y), fold = Math.max(-z, 0);
196
+ x += x >= 0 ? -fold : fold;
197
+ y += y >= 0 ? -fold : fold;
198
+ const scale = max / Math.sqrt(x * x + y * y + z * z);
199
+ view[i] = round(x * scale);
200
+ view[i + 1] = round(y * scale);
201
+ view[i + 2] = round(z * scale);
202
+ }
203
+ }
204
+ /** Unit quaternions stored as their three smallest components; the largest is rebuilt. */
205
+ function filterQuaternion(data, count, stride) {
206
+ if (stride !== 8)
207
+ throw bad('quaternion filter stride');
208
+ const view = new Int16Array(data.buffer, data.byteOffset, count * 4);
209
+ for (let i = 0; i < count * 4; i += 4) {
210
+ const packed = view[i + 3], scale = Math.SQRT1_2 / (packed | 3), x = view[i] * scale, y = view[i + 1] * scale, z = view[i + 2] * scale;
211
+ const w = Math.sqrt(Math.max(1 - x * x - y * y - z * z, 0)), largest = packed & 3;
212
+ view[i + ((largest + 1) & 3)] = round(x * 32767);
213
+ view[i + ((largest + 2) & 3)] = round(y * 32767);
214
+ view[i + ((largest + 3) & 3)] = round(z * 32767);
215
+ view[i + largest] = round(w * 32767);
216
+ }
217
+ }
218
+ /** Floats stored as an 8-bit exponent above a 24-bit mantissa. */
219
+ function filterExponential(data, count, stride) {
220
+ if (stride % 4 !== 0)
221
+ throw bad('exponential filter stride');
222
+ const total = (count * stride) / 4, ints = new Int32Array(data.buffer, data.byteOffset, total), floats = new Float32Array(data.buffer, data.byteOffset, total);
223
+ for (let i = 0; i < total; i++) {
224
+ const v = ints[i];
225
+ floats[i] = Math.pow(2, v >> 24) * ((v << 8) >> 8);
226
+ }
227
+ }
228
+ /**
229
+ * Decode one EXT_meshopt_compression buffer view. `count` elements of
230
+ * `stride` bytes are returned; for the two index modes the stride is 2 or 4.
231
+ */
232
+ export function decodeMeshopt3D(source, count, stride, mode, filter = 'NONE') {
233
+ if (!(source instanceof Uint8Array))
234
+ throw bad('source');
235
+ if (!Number.isSafeInteger(count) ||
236
+ count < 0 ||
237
+ !Number.isSafeInteger(stride) ||
238
+ stride <= 0 ||
239
+ stride > MESHOPT3D_LIMITS.maxStride)
240
+ throw bad('count or stride');
241
+ if (count * stride > MESHOPT3D_LIMITS.maxElements)
242
+ throw new World3DError('WORLD3D_BUDGET', 'meshopt output size');
243
+ // A four-byte multiple keeps the typed views used by the filters and index writers aligned.
244
+ const out = new Uint8Array(new ArrayBuffer((count * stride + 3) & ~3), 0, count * stride);
245
+ if (mode === 'ATTRIBUTES') {
246
+ if (stride % 4 !== 0)
247
+ throw bad('vertex stride must be a multiple of four');
248
+ if (count > 0)
249
+ decodeVertices(source, count, stride, out);
250
+ else if (source.length > 0 && (source[0] & 0xf0) !== 0xa0)
251
+ throw bad('vertex header');
252
+ if (filter === 'OCTAHEDRAL')
253
+ filterOctahedral(out, count, stride);
254
+ else if (filter === 'QUATERNION')
255
+ filterQuaternion(out, count, stride);
256
+ else if (filter === 'EXPONENTIAL')
257
+ filterExponential(out, count, stride);
258
+ else if (filter !== 'NONE')
259
+ throw bad('filter');
260
+ return out;
261
+ }
262
+ if (filter !== 'NONE')
263
+ throw bad('filters apply to vertex data only');
264
+ if (stride !== 2 && stride !== 4)
265
+ throw bad('index stride must be two or four');
266
+ const indices = stride === 2 ? new Uint16Array(out.buffer, 0, count) : new Uint32Array(out.buffer, 0, count);
267
+ if (mode === 'TRIANGLES')
268
+ decodeTriangles(source, count, indices);
269
+ else if (mode === 'INDICES')
270
+ decodeSequence(source, count, indices);
271
+ else
272
+ throw bad('mode');
273
+ return out;
274
+ }
275
+ //# sourceMappingURL=Meshopt3D.js.map
@@ -0,0 +1,173 @@
1
+ import { Geometry3D } from './Geometry3D.js';
2
+ import type { Object3D } from './Object3D.js';
3
+ export declare const NAVIGATION3D_LIMITS: Readonly<{
4
+ readonly maxTriangles: 1048576;
5
+ readonly maxAgents: 4096;
6
+ readonly maxGridCells: 16777216;
7
+ readonly maxCellReferences: 8388608;
8
+ }>;
9
+ export type NavPoint3D = [number, number, number];
10
+ export interface NavMeshOptions3D {
11
+ /** Steepest walkable slope in radians. Defaults to 45 degrees. */
12
+ readonly slopeLimit?: number;
13
+ /** Corners closer than this are treated as one, which joins triangles that only touch. Defaults to 0.001. */
14
+ readonly weldTolerance?: number;
15
+ }
16
+ export interface NavLocation3D {
17
+ /** Index of the triangle the point lies on. */
18
+ readonly triangle: number;
19
+ readonly point: NavPoint3D;
20
+ }
21
+ export interface NavPathOptions3D {
22
+ /** Keeps the path this far from the mesh edges at corners, and rules out gaps narrower than twice this. */
23
+ readonly agentRadius?: number;
24
+ /** Add a point wherever the path crosses from one triangle to the next, so it follows slopes. Defaults to false. */
25
+ readonly followSurface?: boolean;
26
+ /** How far the start and end may lie from the mesh. Defaults to 2. */
27
+ readonly snapDistance?: number;
28
+ }
29
+ export interface NavPath3D {
30
+ readonly points: NavPoint3D[];
31
+ /** False when the end could not be reached and the path stops at the closest reachable place. */
32
+ readonly complete: boolean;
33
+ /** Length of the path. */
34
+ readonly length: number;
35
+ }
36
+ export declare class NavMesh3D {
37
+ #private;
38
+ /** Welded corner positions, three floats each. */
39
+ readonly vertices: Float32Array;
40
+ /** Corner indices, three per triangle, counter-clockwise seen from above. */
41
+ readonly triangles: Uint32Array;
42
+ /** For each triangle edge (corner i to corner i + 1), the triangle on the other side or -1. */
43
+ readonly neighbors: Int32Array;
44
+ readonly triangleCount: number;
45
+ /** Connected region of each triangle; two points can reach each other only within one region. */
46
+ readonly regions: Int32Array;
47
+ /** @param positions Triangle corners in world space; @param indices three per triangle, or none for a plain list. */
48
+ constructor(positions: ArrayLike<number>, indices: ArrayLike<number> | undefined, options?: NavMeshOptions3D);
49
+ private column;
50
+ private row;
51
+ /** Travel cost multiplier of a triangle (mud, shallow water); 1 by default. */
52
+ setCost(triangle: number, cost: number): void;
53
+ /** Close or reopen a triangle, as for a door or a collapsed bridge. Paths and movement avoid closed triangles. */
54
+ setEnabled(triangle: number, enabled: boolean): void;
55
+ isEnabled(triangle: number): boolean;
56
+ private checked;
57
+ /** Middle of a triangle. */
58
+ center(triangle: number, out?: NavPoint3D): NavPoint3D;
59
+ /** Closest point of one triangle to a point, written to `out`; returns the squared distance. */
60
+ private closestOn;
61
+ /** Nearest place on the open part of the mesh within `maxDistance`, or undefined. */
62
+ findNearest(point: ArrayLike<number>, maxDistance?: number): NavLocation3D | undefined;
63
+ /** Height of a triangle's plane at a ground position. */
64
+ private heightAt;
65
+ /** True when the two places can reach each other across open triangles. */
66
+ isReachable(a: NavLocation3D, b: NavLocation3D): boolean;
67
+ /** A* over triangles. Returns the chain of triangles from start to the end, or to the open triangle nearest the end. */
68
+ private search;
69
+ /**
70
+ * Cost-guided walkable path between two points. The points are snapped onto
71
+ * the mesh first; undefined is returned when either lies too far from it.
72
+ */
73
+ findPath(start: ArrayLike<number>, end: ArrayLike<number>, options?: NavPathOptions3D): NavPath3D | undefined;
74
+ /**
75
+ * Walk from a place toward a ground position, staying on open triangles
76
+ * and sliding along the mesh edge when the way is blocked. `blocked`
77
+ * tells whether an edge stopped the move.
78
+ */
79
+ moveAlong(from: NavLocation3D, x: number, z: number): NavLocation3D & {
80
+ readonly blocked: boolean;
81
+ };
82
+ /** True when an agent of the given radius can walk straight from a place to a point. */
83
+ private clearWalk;
84
+ /**
85
+ * Line of sight along the ground: how far a straight walk from a place
86
+ * toward a ground position gets, as a share from 0 to 1. A value of 1
87
+ * means nothing is in the way. When `crossings` is given, the points
88
+ * where the walk passes from one triangle to the next are appended to it.
89
+ */
90
+ raycast(from: NavLocation3D, x: number, z: number, crossings?: NavPoint3D[]): number;
91
+ private trace;
92
+ /** A place chosen evenly over the open area; pass a random function for repeatable results. */
93
+ randomPoint(random?: () => number): NavLocation3D;
94
+ /** Line geometry of every triangle edge, for drawing the mesh while tuning a level. */
95
+ createDebugGeometry(lift?: number): Geometry3D;
96
+ }
97
+ /**
98
+ * Build a navigation mesh from level geometry: a geometry, or an object whose
99
+ * meshes are merged with their world transforms. Faces steeper than
100
+ * `slopeLimit` and faces pointing down are left out.
101
+ */
102
+ export declare function createNavMesh3D(source: Geometry3D | Object3D | {
103
+ readonly positions: ArrayLike<number>;
104
+ readonly indices?: ArrayLike<number>;
105
+ }, options?: NavMeshOptions3D): NavMesh3D;
106
+ export interface NavAgentOptions3D {
107
+ readonly position: ArrayLike<number>;
108
+ readonly radius?: number;
109
+ /** Walking speed in units per second. Defaults to 3.5. */
110
+ readonly speed?: number;
111
+ /** How quickly the agent reaches its speed, in units per second squared. Defaults to 20. */
112
+ readonly acceleration?: number;
113
+ /** Scene node moved with the agent; it must not have a transformed parent. */
114
+ readonly node?: Object3D;
115
+ readonly userData?: unknown;
116
+ }
117
+ export declare class NavAgent3D {
118
+ readonly position: NavPoint3D;
119
+ readonly velocity: NavPoint3D;
120
+ radius: number;
121
+ speed: number;
122
+ acceleration: number;
123
+ node: Object3D | undefined;
124
+ userData: unknown;
125
+ /** True once the agent has reached its target, or has none. */
126
+ arrived: boolean;
127
+ /** False when the last path request could not reach the target. */
128
+ reachable: boolean;
129
+ /** @internal */ triangle: number;
130
+ /** @internal */ corners: NavPoint3D[];
131
+ /** @internal */ target: NavPoint3D | undefined;
132
+ /** @internal */ stale: boolean;
133
+ /** @internal */ stalled: number;
134
+ /** @internal */ closest: number;
135
+ constructor(options: NavAgentOptions3D);
136
+ /** Walk to a point; the path is worked out on the next crowd update. */
137
+ setTarget(point: ArrayLike<number>): void;
138
+ /** Stop where the agent stands. */
139
+ stop(): void;
140
+ /** Remaining path corners, the next one first. */
141
+ get path(): readonly NavPoint3D[];
142
+ }
143
+ /**
144
+ * Agents walking on one navigation mesh. Each follows its own path and
145
+ * steers away from neighbors it would otherwise walk into.
146
+ */
147
+ export declare class NavCrowd3D {
148
+ readonly navMesh: NavMesh3D;
149
+ readonly agents: NavAgent3D[];
150
+ /** How strongly agents push apart when they overlap; 0 lets them pass through each other. */
151
+ separation: number;
152
+ constructor(navMesh: NavMesh3D);
153
+ addAgent(options: NavAgentOptions3D): NavAgent3D;
154
+ removeAgent(agent: NavAgent3D): void;
155
+ private sync;
156
+ /** Advance every agent by `deltaSeconds`. */
157
+ update(deltaSeconds: number): void;
158
+ }
159
+ export declare function createNavCrowd3D(navMesh: NavMesh3D): NavCrowd3D;
160
+ export interface GridPathOptions3D {
161
+ /** Allow diagonal steps (never cutting a blocked corner). Defaults to true. */
162
+ readonly diagonal?: boolean;
163
+ /** Give up after visiting this many cells. Defaults to every cell. */
164
+ readonly maxVisited?: number;
165
+ }
166
+ /**
167
+ * Shortest path on a grid of cells, for tile maps. `cost(x, y)` returns the
168
+ * finite positive price of entering a cell (including fractional costs).
169
+ * All other values mark a blocked cell. Returns the cells from start to end
170
+ * inclusive, or undefined when there is no way.
171
+ */
172
+ export declare function findGridPath3D(width: number, height: number, cost: (x: number, y: number) => number, start: readonly [number, number], end: readonly [number, number], options?: GridPathOptions3D): [number, number][] | undefined;
173
+ //# sourceMappingURL=Navigation3D.d.ts.map