@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,55 @@
1
+ import type { Disposable } from '@egret/contracts';
2
+ import type { Camera3D } from '../../rendering/world3d/Camera3D.js';
3
+ export interface FlyControlsOptions3D {
4
+ /** Units per second. */
5
+ readonly moveSpeed?: number;
6
+ /** Multiplier while the sprint key is held. */
7
+ readonly sprintMultiplier?: number;
8
+ /** Radians per pixel of pointer movement. */
9
+ readonly lookSpeed?: number;
10
+ /** Move along the view direction and allow vertical keys; otherwise stay level. */
11
+ readonly fly?: boolean;
12
+ /** Request pointer lock on click. Without it, drag to look. */
13
+ readonly pointerLock?: boolean;
14
+ /** Fraction of velocity kept per 1/60 s; 0 stops at once. */
15
+ readonly damping?: number;
16
+ /** Key codes (KeyboardEvent.code) for each action. */
17
+ readonly keys?: Partial<FlyControlsKeys3D>;
18
+ }
19
+ export interface FlyControlsKeys3D {
20
+ readonly forward: readonly string[];
21
+ readonly back: readonly string[];
22
+ readonly left: readonly string[];
23
+ readonly right: readonly string[];
24
+ readonly up: readonly string[];
25
+ readonly down: readonly string[];
26
+ readonly sprint: readonly string[];
27
+ }
28
+ export declare class FlyControls3D implements Disposable {
29
+ #private;
30
+ readonly camera: Camera3D;
31
+ readonly element: HTMLElement;
32
+ moveSpeed: number;
33
+ sprintMultiplier: number;
34
+ lookSpeed: number;
35
+ fly: boolean;
36
+ pointerLock: boolean;
37
+ damping: number;
38
+ enabled: boolean;
39
+ /** Heading about +Y and elevation, in radians. Write them to aim the camera. */
40
+ yaw: number;
41
+ pitch: number;
42
+ /** Current velocity in world units per second. */
43
+ readonly velocity: Float32Array<ArrayBuffer>;
44
+ constructor(camera: Camera3D, element: HTMLElement, options?: FlyControlsOptions3D);
45
+ private isLooking;
46
+ /** True while the pointer is captured for looking around. */
47
+ get isLocked(): boolean;
48
+ /** Release pointer lock, as when opening a menu. */
49
+ unlock(): void;
50
+ private pressed;
51
+ update(deltaSeconds: number): void;
52
+ dispose(): void;
53
+ }
54
+ export declare function createFlyControls3D(camera: Camera3D, element: HTMLElement, options?: FlyControlsOptions3D): FlyControls3D;
55
+ //# sourceMappingURL=FlyControls3D.d.ts.map
@@ -0,0 +1,160 @@
1
+ import { World3DError } from '../../rendering/world3d/core3D.js';
2
+ const DEFAULT_KEYS = Object.freeze({
3
+ forward: ['KeyW', 'ArrowUp'],
4
+ back: ['KeyS', 'ArrowDown'],
5
+ left: ['KeyA', 'ArrowLeft'],
6
+ right: ['KeyD', 'ArrowRight'],
7
+ up: ['Space', 'KeyE'],
8
+ down: ['KeyC', 'KeyQ'],
9
+ sprint: ['ShiftLeft', 'ShiftRight']
10
+ });
11
+ const LIMIT = Math.PI / 2 - 0.001;
12
+ export class FlyControls3D {
13
+ camera;
14
+ element;
15
+ moveSpeed;
16
+ sprintMultiplier;
17
+ lookSpeed;
18
+ fly;
19
+ pointerLock;
20
+ damping;
21
+ enabled = true;
22
+ /** Heading about +Y and elevation, in radians. Write them to aim the camera. */
23
+ yaw = 0;
24
+ pitch = 0;
25
+ /** Current velocity in world units per second. */
26
+ velocity = new Float32Array(3);
27
+ #keys;
28
+ #down = new Set();
29
+ #listeners = [];
30
+ #dragging = false;
31
+ #disposed = false;
32
+ constructor(camera, element, options = {}) {
33
+ if (!camera || !element || typeof element.addEventListener !== 'function')
34
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'controls target');
35
+ this.camera = camera;
36
+ this.element = element;
37
+ this.moveSpeed = options.moveSpeed ?? 5;
38
+ this.sprintMultiplier = options.sprintMultiplier ?? 2.5;
39
+ this.lookSpeed = options.lookSpeed ?? 0.0025;
40
+ this.fly = options.fly ?? true;
41
+ this.pointerLock = options.pointerLock ?? true;
42
+ this.damping = options.damping ?? 0.8;
43
+ this.#keys = { ...DEFAULT_KEYS, ...options.keys };
44
+ // Start from the camera's current facing: its local -Z axis in world space.
45
+ camera.updateWorldMatrices();
46
+ const m = camera.matrixWorld, fx = -m[8], fy = -m[9], fz = -m[10], length = Math.hypot(fx, fy, fz) || 1;
47
+ this.pitch = Math.asin(Math.min(Math.max(fy / length, -1), 1));
48
+ this.yaw = Math.atan2(-fx, -fz);
49
+ const root = element.ownerDocument, listen = (target, type, listener) => {
50
+ target.addEventListener(type, listener);
51
+ this.#listeners.push([target, type, listener]);
52
+ };
53
+ listen(element, 'pointerdown', event => {
54
+ if (!this.enabled)
55
+ return;
56
+ if (this.pointerLock) {
57
+ if (root.pointerLockElement !== element)
58
+ void Promise.resolve(element.requestPointerLock?.()).catch(() => undefined);
59
+ }
60
+ else {
61
+ this.#dragging = true;
62
+ element.setPointerCapture?.(event.pointerId);
63
+ }
64
+ });
65
+ listen(element, 'pointerup', event => {
66
+ this.#dragging = false;
67
+ element.releasePointerCapture?.(event.pointerId);
68
+ });
69
+ listen(element, 'pointercancel', () => {
70
+ this.#dragging = false;
71
+ });
72
+ listen(root, 'pointermove', event => {
73
+ if (!this.enabled || !(this.pointerLock ? root.pointerLockElement === element : this.#dragging))
74
+ return;
75
+ const move = event;
76
+ this.yaw -= move.movementX * this.lookSpeed;
77
+ this.pitch = Math.min(Math.max(this.pitch - move.movementY * this.lookSpeed, -LIMIT), LIMIT);
78
+ });
79
+ const view = root.defaultView ?? globalThis;
80
+ listen(view, 'keydown', event => {
81
+ if (this.enabled && this.isLooking(root))
82
+ this.#down.add(event.code);
83
+ });
84
+ listen(view, 'keyup', event => {
85
+ this.#down.delete(event.code);
86
+ });
87
+ // Keys released while the window is unfocused never send keyup.
88
+ listen(view, 'blur', () => {
89
+ this.#down.clear();
90
+ this.#dragging = false;
91
+ });
92
+ }
93
+ isLooking(root) {
94
+ return !this.pointerLock || root.pointerLockElement === this.element;
95
+ }
96
+ /** True while the pointer is captured for looking around. */
97
+ get isLocked() {
98
+ return this.element.ownerDocument.pointerLockElement === this.element;
99
+ }
100
+ /** Release pointer lock, as when opening a menu. */
101
+ unlock() {
102
+ if (this.isLocked)
103
+ this.element.ownerDocument.exitPointerLock();
104
+ }
105
+ pressed(action) {
106
+ for (const code of action)
107
+ if (this.#down.has(code))
108
+ return true;
109
+ return false;
110
+ }
111
+ update(deltaSeconds) {
112
+ if (this.#disposed)
113
+ return;
114
+ const keys = this.#keys, dt = Math.max(deltaSeconds, 0), cosPitch = Math.cos(this.pitch), sinYaw = Math.sin(this.yaw), cosYaw = Math.cos(this.yaw);
115
+ // Forward and right in world space; walking keeps forward level.
116
+ const fx = -sinYaw * (this.fly ? cosPitch : 1), fy = this.fly ? Math.sin(this.pitch) : 0, fz = -cosYaw * (this.fly ? cosPitch : 1), rx = cosYaw, rz = -sinYaw;
117
+ let ahead = 0, side = 0, lift = 0;
118
+ if (this.enabled) {
119
+ ahead = (this.pressed(keys.forward) ? 1 : 0) - (this.pressed(keys.back) ? 1 : 0);
120
+ side = (this.pressed(keys.right) ? 1 : 0) - (this.pressed(keys.left) ? 1 : 0);
121
+ if (this.fly)
122
+ lift = (this.pressed(keys.up) ? 1 : 0) - (this.pressed(keys.down) ? 1 : 0);
123
+ }
124
+ let x = fx * ahead + rx * side, y = fy * ahead + lift, z = fz * ahead + rz * side;
125
+ const length = Math.hypot(x, y, z), speed = this.moveSpeed * (this.pressed(keys.sprint) ? this.sprintMultiplier : 1);
126
+ if (length > 0) {
127
+ x = (x / length) * speed;
128
+ y = (y / length) * speed;
129
+ z = (z / length) * speed;
130
+ }
131
+ // Ease toward the wanted velocity; the factor is frame-rate independent.
132
+ const keep = this.damping > 0 ? Math.pow(this.damping, dt * 60) : 0, v = this.velocity;
133
+ v[0] = x + (v[0] - x) * keep;
134
+ v[1] = y + (v[1] - y) * keep;
135
+ v[2] = z + (v[2] - z) * keep;
136
+ const camera = this.camera, p = camera.position;
137
+ camera.setPosition(p[0] + v[0] * dt, p[1] + v[1] * dt, p[2] + v[2] * dt);
138
+ // Yaw about +Y, then pitch about the camera's own X axis.
139
+ const hy = this.yaw / 2, hp = this.pitch / 2, sy = Math.sin(hy), cy = Math.cos(hy), sp = Math.sin(hp), cp = Math.cos(hp);
140
+ camera.quaternion[0] = cy * sp;
141
+ camera.quaternion[1] = sy * cp;
142
+ camera.quaternion[2] = -sy * sp;
143
+ camera.quaternion[3] = cy * cp;
144
+ camera.markTransformDirty();
145
+ }
146
+ dispose() {
147
+ if (this.#disposed)
148
+ return;
149
+ this.#disposed = true;
150
+ this.unlock();
151
+ for (const [target, type, listener] of this.#listeners)
152
+ target.removeEventListener(type, listener);
153
+ this.#listeners.length = 0;
154
+ this.#down.clear();
155
+ }
156
+ }
157
+ export function createFlyControls3D(camera, element, options = {}) {
158
+ return new FlyControls3D(camera, element, options);
159
+ }
160
+ //# sourceMappingURL=FlyControls3D.js.map
@@ -0,0 +1,28 @@
1
+ import type { Disposable } from '@egret/contracts';
2
+ import type { Camera3D } from '../../rendering/world3d/Camera3D.js';
3
+ import { FollowCamera3D } from '../../rendering/world3d/Character3D.js';
4
+ import type { FollowCameraOptions3D } from '../../rendering/world3d/Character3D.js';
5
+ import type { Object3D } from '../../rendering/world3d/Object3D.js';
6
+ export interface FollowControlsOptions3D extends FollowCameraOptions3D {
7
+ /** Radians turned per pixel dragged. Defaults to 0.005. */
8
+ readonly rotateSpeed?: number;
9
+ /** Share of the distance changed per wheel notch. Defaults to 0.1. */
10
+ readonly zoomSpeed?: number;
11
+ }
12
+ export declare class FollowControls3D implements Disposable {
13
+ #private;
14
+ readonly element: HTMLElement;
15
+ /** The camera rig; read `follow.yaw` or call `follow.moveDirection()` to steer a character relative to the view. */
16
+ readonly follow: FollowCamera3D;
17
+ rotateSpeed: number;
18
+ zoomSpeed: number;
19
+ enabled: boolean;
20
+ constructor(camera: Camera3D, element: HTMLElement, target: Object3D | ArrayLike<number>, options?: FollowControlsOptions3D);
21
+ /** Place the camera; call once per frame after moving the target. */
22
+ update(deltaSeconds?: number): void;
23
+ dispose(): void;
24
+ private forgetPointer;
25
+ private releaseCapture;
26
+ }
27
+ export declare function createFollowControls3D(camera: Camera3D, element: HTMLElement, target: Object3D | ArrayLike<number>, options?: FollowControlsOptions3D): FollowControls3D;
28
+ //# sourceMappingURL=FollowControls3D.d.ts.map
@@ -0,0 +1,117 @@
1
+ import { FollowCamera3D } from '../../rendering/world3d/Character3D.js';
2
+ import { World3DError } from '../../rendering/world3d/core3D.js';
3
+ export class FollowControls3D {
4
+ element;
5
+ /** The camera rig; read `follow.yaw` or call `follow.moveDirection()` to steer a character relative to the view. */
6
+ follow;
7
+ rotateSpeed;
8
+ zoomSpeed;
9
+ enabled = true;
10
+ #pointers = new Map();
11
+ #listeners;
12
+ #previousTouchAction;
13
+ #previousTouchActionPriority;
14
+ #pinch = 0;
15
+ #disposed = false;
16
+ constructor(camera, element, target, options = {}) {
17
+ if (!camera || !element || typeof element.addEventListener !== 'function')
18
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'controls');
19
+ this.element = element;
20
+ this.follow = new FollowCamera3D(camera, target, options);
21
+ this.rotateSpeed = options.rotateSpeed ?? 0.005;
22
+ this.zoomSpeed = options.zoomSpeed ?? 0.1;
23
+ const down = (event) => {
24
+ if (!this.enabled)
25
+ return;
26
+ this.#pointers.set(event.pointerId, { x: event.clientX, y: event.clientY });
27
+ this.element.setPointerCapture?.(event.pointerId);
28
+ this.#pinch = 0;
29
+ };
30
+ const move = (event) => {
31
+ const last = this.#pointers.get(event.pointerId);
32
+ if (!last || !this.enabled)
33
+ return;
34
+ const dx = event.clientX - last.x, dy = event.clientY - last.y;
35
+ last.x = event.clientX;
36
+ last.y = event.clientY;
37
+ if (this.#pointers.size === 1) {
38
+ this.follow.yaw -= dx * this.rotateSpeed;
39
+ this.follow.pitch += dy * this.rotateSpeed;
40
+ return;
41
+ }
42
+ // Two fingers: the change in their spread zooms.
43
+ const [a, b] = [...this.#pointers.values()], spread = Math.hypot(a.x - b.x, a.y - b.y);
44
+ if (this.#pinch > 0 && spread > 0)
45
+ this.follow.distance *= this.#pinch / spread;
46
+ this.#pinch = spread;
47
+ };
48
+ const up = (event) => {
49
+ if (this.forgetPointer(event.pointerId))
50
+ this.releaseCapture(event.pointerId);
51
+ };
52
+ const lost = (event) => {
53
+ // A descendant losing its capture does not end a capture on this element.
54
+ if (event.target === element)
55
+ this.forgetPointer(event.pointerId);
56
+ };
57
+ const wheel = (event) => {
58
+ if (!this.enabled)
59
+ return;
60
+ event.preventDefault();
61
+ this.follow.distance *= 1 + Math.sign(event.deltaY) * this.zoomSpeed;
62
+ };
63
+ this.#listeners = [
64
+ ['pointerdown', down, undefined],
65
+ ['pointermove', move, undefined],
66
+ ['pointerup', up, undefined],
67
+ ['pointercancel', up, undefined],
68
+ ['lostpointercapture', lost, undefined],
69
+ ['wheel', wheel, { passive: false }]
70
+ ];
71
+ for (const [type, listener, listenerOptions] of this.#listeners)
72
+ element.addEventListener(type, listener, listenerOptions);
73
+ // Disable native gestures while attached without losing the host's inline style.
74
+ this.#previousTouchAction = element.style.getPropertyValue('touch-action');
75
+ this.#previousTouchActionPriority = element.style.getPropertyPriority('touch-action');
76
+ if (this.#previousTouchAction !== 'none')
77
+ element.style.setProperty('touch-action', 'none', this.#previousTouchActionPriority);
78
+ }
79
+ /** Place the camera; call once per frame after moving the target. */
80
+ update(deltaSeconds = 0) {
81
+ if (!this.#disposed)
82
+ this.follow.update(deltaSeconds);
83
+ }
84
+ dispose() {
85
+ if (this.#disposed)
86
+ return;
87
+ this.#disposed = true;
88
+ const element = this.element;
89
+ for (const [type, listener, listenerOptions] of this.#listeners)
90
+ element.removeEventListener(type, listener, listenerOptions);
91
+ for (const id of this.#pointers.keys())
92
+ this.releaseCapture(id);
93
+ this.#pointers.clear();
94
+ this.#pinch = 0;
95
+ const style = element.style;
96
+ // Preserve any later inline style installed by the caller.
97
+ if (this.#previousTouchAction !== 'none' &&
98
+ style.getPropertyValue('touch-action') === 'none' &&
99
+ style.getPropertyPriority('touch-action') === this.#previousTouchActionPriority) {
100
+ style.setProperty('touch-action', this.#previousTouchAction, this.#previousTouchActionPriority);
101
+ }
102
+ }
103
+ forgetPointer(id) {
104
+ if (!this.#pointers.delete(id))
105
+ return false;
106
+ this.#pinch = 0;
107
+ return true;
108
+ }
109
+ releaseCapture(id) {
110
+ if (this.element.hasPointerCapture?.(id))
111
+ this.element.releasePointerCapture(id);
112
+ }
113
+ }
114
+ export function createFollowControls3D(camera, element, target, options = {}) {
115
+ return new FollowControls3D(camera, element, target, options);
116
+ }
117
+ //# sourceMappingURL=FollowControls3D.js.map
@@ -0,0 +1,55 @@
1
+ import type { Disposable } from '@egret/contracts';
2
+ import type { Camera3D } from '../../rendering/world3d/Camera3D.js';
3
+ export interface OrbitControlsOptions3D {
4
+ readonly target?: readonly [number, number, number];
5
+ readonly minDistance?: number;
6
+ readonly maxDistance?: number;
7
+ /** Polar angle limits in radians, measured from the +Y axis. */
8
+ readonly minPolarAngle?: number;
9
+ readonly maxPolarAngle?: number;
10
+ readonly rotateSpeed?: number;
11
+ readonly panSpeed?: number;
12
+ readonly zoomSpeed?: number;
13
+ /** Fraction of motion kept per 1/60 s; 0 disables inertia. */
14
+ readonly damping?: number;
15
+ readonly enablePan?: boolean;
16
+ readonly enableZoom?: boolean;
17
+ readonly enableRotate?: boolean;
18
+ /** Radians per second of automatic rotation about the Y axis. */
19
+ readonly autoRotateSpeed?: number;
20
+ }
21
+ export declare class OrbitControls3D implements Disposable {
22
+ #private;
23
+ readonly camera: Camera3D;
24
+ readonly element: HTMLElement;
25
+ readonly target: Float32Array<ArrayBuffer>;
26
+ minDistance: number;
27
+ maxDistance: number;
28
+ minPolarAngle: number;
29
+ maxPolarAngle: number;
30
+ rotateSpeed: number;
31
+ panSpeed: number;
32
+ zoomSpeed: number;
33
+ damping: number;
34
+ enablePan: boolean;
35
+ enableZoom: boolean;
36
+ enableRotate: boolean;
37
+ autoRotateSpeed: number;
38
+ enabled: boolean;
39
+ constructor(camera: Camera3D, element: HTMLElement, options?: OrbitControlsOptions3D);
40
+ /** Recompute the orbit parameters after moving the camera or target directly. */
41
+ syncFromCamera(): void;
42
+ private readonly onContextMenu;
43
+ private readonly onPointerDown;
44
+ private readonly onPointerUp;
45
+ private pinchDistance;
46
+ private readonly onPointerMove;
47
+ private addPan;
48
+ private readonly onWheel;
49
+ /** Apply pending input and place the camera. Returns true while the view is still moving. */
50
+ update(deltaSeconds?: number): boolean;
51
+ /** Detach every listener. Idempotent. */
52
+ dispose(): void;
53
+ }
54
+ export declare function createOrbitControls3D(camera: Camera3D, element: HTMLElement, options?: OrbitControlsOptions3D): OrbitControls3D;
55
+ //# sourceMappingURL=OrbitControls3D.d.ts.map
@@ -0,0 +1,187 @@
1
+ import { World3DError } from '../../rendering/world3d/core3D.js';
2
+ const EPSILON = 1e-4;
3
+ export class OrbitControls3D {
4
+ camera;
5
+ element;
6
+ target = new Float32Array(3);
7
+ minDistance;
8
+ maxDistance;
9
+ minPolarAngle;
10
+ maxPolarAngle;
11
+ rotateSpeed;
12
+ panSpeed;
13
+ zoomSpeed;
14
+ damping;
15
+ enablePan;
16
+ enableZoom;
17
+ enableRotate;
18
+ autoRotateSpeed;
19
+ enabled = true;
20
+ // Spherical position of the camera relative to the target.
21
+ #radius = 1;
22
+ #theta = 0;
23
+ #phi = Math.PI / 2;
24
+ // Pending motion, consumed (and decayed when damping) by update().
25
+ #deltaTheta = 0;
26
+ #deltaPhi = 0;
27
+ #zoom = 1;
28
+ #pan = new Float32Array(3);
29
+ #pointers = new Map();
30
+ #pinch = 0;
31
+ #disposed = false;
32
+ #listeners;
33
+ constructor(camera, element, options = {}) {
34
+ if (!camera || !element || typeof element.addEventListener !== 'function')
35
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'controls');
36
+ this.camera = camera;
37
+ this.element = element;
38
+ if (options.target)
39
+ this.target.set(options.target);
40
+ this.minDistance = options.minDistance ?? 0.01;
41
+ this.maxDistance = options.maxDistance ?? Infinity;
42
+ this.minPolarAngle = options.minPolarAngle ?? 0;
43
+ this.maxPolarAngle = options.maxPolarAngle ?? Math.PI;
44
+ this.rotateSpeed = options.rotateSpeed ?? 1;
45
+ this.panSpeed = options.panSpeed ?? 1;
46
+ this.zoomSpeed = options.zoomSpeed ?? 1;
47
+ this.damping = options.damping ?? 0.85;
48
+ this.enablePan = options.enablePan ?? true;
49
+ this.enableZoom = options.enableZoom ?? true;
50
+ this.enableRotate = options.enableRotate ?? true;
51
+ this.autoRotateSpeed = options.autoRotateSpeed ?? 0;
52
+ this.syncFromCamera();
53
+ this.#listeners = [
54
+ ['pointerdown', this.onPointerDown, undefined],
55
+ ['pointermove', this.onPointerMove, undefined],
56
+ ['pointerup', this.onPointerUp, undefined],
57
+ ['pointercancel', this.onPointerUp, undefined],
58
+ ['wheel', this.onWheel, { passive: false }],
59
+ ['contextmenu', this.onContextMenu, undefined]
60
+ ];
61
+ for (const [type, listener, listenerOptions] of this.#listeners)
62
+ element.addEventListener(type, listener, listenerOptions);
63
+ // Stop the browser from scrolling or zooming the page during a drag.
64
+ element.style.touchAction = 'none';
65
+ }
66
+ /** Recompute the orbit parameters after moving the camera or target directly. */
67
+ syncFromCamera() {
68
+ const p = this.camera.position, x = p[0] - this.target[0], y = p[1] - this.target[1], z = p[2] - this.target[2];
69
+ this.#radius = Math.max(Math.hypot(x, y, z), EPSILON);
70
+ this.#theta = Math.atan2(x, z);
71
+ this.#phi = Math.acos(Math.min(Math.max(y / this.#radius, -1), 1));
72
+ }
73
+ onContextMenu = (event) => {
74
+ if (this.enabled)
75
+ event.preventDefault();
76
+ };
77
+ onPointerDown = (event) => {
78
+ if (!this.enabled)
79
+ return;
80
+ this.element.setPointerCapture?.(event.pointerId);
81
+ this.#pointers.set(event.pointerId, { x: event.clientX, y: event.clientY });
82
+ this.#pinch = this.pinchDistance();
83
+ };
84
+ onPointerUp = (event) => {
85
+ this.#pointers.delete(event.pointerId);
86
+ this.element.releasePointerCapture?.(event.pointerId);
87
+ this.#pinch = this.pinchDistance();
88
+ };
89
+ pinchDistance() {
90
+ if (this.#pointers.size !== 2)
91
+ return 0;
92
+ const [a, b] = [...this.#pointers.values()];
93
+ return Math.hypot(a.x - b.x, a.y - b.y);
94
+ }
95
+ onPointerMove = (event) => {
96
+ const previous = this.#pointers.get(event.pointerId);
97
+ if (!this.enabled || !previous)
98
+ return;
99
+ const dx = event.clientX - previous.x, dy = event.clientY - previous.y;
100
+ previous.x = event.clientX;
101
+ previous.y = event.clientY;
102
+ const height = Math.max(this.element.clientHeight, 1);
103
+ if (this.#pointers.size === 2) {
104
+ // Two contacts: each moves the view by half its motion, and their spacing zooms.
105
+ if (this.enablePan)
106
+ this.addPan(dx * 0.5, dy * 0.5, height);
107
+ const distance = this.pinchDistance();
108
+ if (this.enableZoom && this.#pinch > 0 && distance > 0)
109
+ this.#zoom *= this.#pinch / distance;
110
+ this.#pinch = distance;
111
+ return;
112
+ }
113
+ const panning = (event.pointerType === 'mouse' && (event.buttons & 2) !== 0) || event.shiftKey;
114
+ if (panning) {
115
+ if (this.enablePan)
116
+ this.addPan(dx, dy, height);
117
+ return;
118
+ }
119
+ if (!this.enableRotate)
120
+ return;
121
+ // A drag across the element height turns the view by half a revolution.
122
+ this.#deltaTheta -= (dx / height) * Math.PI * this.rotateSpeed;
123
+ this.#deltaPhi -= (dy / height) * Math.PI * this.rotateSpeed;
124
+ };
125
+ addPan(dx, dy, height) {
126
+ const camera = this.camera, m = camera.matrixWorld;
127
+ // World units per pixel at the target's depth.
128
+ const span = camera.projectionKind === 'perspective'
129
+ ? (2 * this.#radius * Math.tan((camera.fov * Math.PI) / 360)) / camera.zoom
130
+ : camera.orthographicHeight / camera.zoom;
131
+ const scale = (span / height) * this.panSpeed;
132
+ for (let i = 0; i < 3; i++)
133
+ this.#pan[i] += (-dx * m[i] + dy * m[4 + i]) * scale;
134
+ }
135
+ onWheel = (event) => {
136
+ if (!this.enabled || !this.enableZoom)
137
+ return;
138
+ event.preventDefault();
139
+ const lines = event.deltaMode === 1 ? event.deltaY * 16 : event.deltaY;
140
+ this.#zoom *= Math.pow(1.001, lines * this.zoomSpeed);
141
+ };
142
+ /** Apply pending input and place the camera. Returns true while the view is still moving. */
143
+ update(deltaSeconds = 1 / 60) {
144
+ if (this.#disposed)
145
+ return false;
146
+ const dt = Math.min(Math.max(deltaSeconds, 0), 0.1);
147
+ if (this.autoRotateSpeed !== 0 && this.#pointers.size === 0)
148
+ this.#theta += this.autoRotateSpeed * dt;
149
+ this.#theta += this.#deltaTheta;
150
+ this.#phi = Math.min(Math.max(this.#phi + this.#deltaPhi, Math.max(this.minPolarAngle, EPSILON)), Math.min(this.maxPolarAngle, Math.PI - EPSILON));
151
+ if (this.camera.projectionKind === 'orthographic')
152
+ this.camera.zoom = Math.max(this.camera.zoom / this.#zoom, EPSILON);
153
+ else
154
+ this.#radius = Math.min(Math.max(this.#radius * this.#zoom, this.minDistance), this.maxDistance);
155
+ for (let i = 0; i < 3; i++)
156
+ this.target[i] += this.#pan[i];
157
+ const moving = Math.abs(this.#deltaTheta) +
158
+ Math.abs(this.#deltaPhi) +
159
+ Math.abs(this.#zoom - 1) +
160
+ Math.hypot(this.#pan[0], this.#pan[1], this.#pan[2]) >
161
+ 1e-6;
162
+ // Frame-rate independent decay of the remaining motion.
163
+ const keep = this.damping > 0 ? Math.pow(Math.min(this.damping, 0.999), dt * 60) : 0;
164
+ this.#deltaTheta *= keep;
165
+ this.#deltaPhi *= keep;
166
+ this.#zoom = 1 + (this.#zoom - 1) * keep;
167
+ for (let i = 0; i < 3; i++)
168
+ this.#pan[i] *= keep;
169
+ const sinPhi = Math.sin(this.#phi), r = this.#radius;
170
+ this.camera.setPosition(this.target[0] + r * sinPhi * Math.sin(this.#theta), this.target[1] + r * Math.cos(this.#phi), this.target[2] + r * sinPhi * Math.cos(this.#theta));
171
+ this.camera.lookAt(this.target[0], this.target[1], this.target[2]);
172
+ return moving || this.autoRotateSpeed !== 0;
173
+ }
174
+ /** Detach every listener. Idempotent. */
175
+ dispose() {
176
+ if (this.#disposed)
177
+ return;
178
+ this.#disposed = true;
179
+ for (const [type, listener, listenerOptions] of this.#listeners)
180
+ this.element.removeEventListener(type, listener, listenerOptions);
181
+ this.#pointers.clear();
182
+ }
183
+ }
184
+ export function createOrbitControls3D(camera, element, options = {}) {
185
+ return new OrbitControls3D(camera, element, options);
186
+ }
187
+ //# sourceMappingURL=OrbitControls3D.js.map
@@ -0,0 +1,34 @@
1
+ import type { Disposable } from '@egret/contracts';
2
+ import type { Camera3D } from '../../rendering/world3d/Camera3D.js';
3
+ import { TransformGizmo3D } from '../../rendering/world3d/Gizmo3D.js';
4
+ import type { GizmoMode3D, GizmoSpace3D, TransformGizmoOptions3D } from '../../rendering/world3d/Gizmo3D.js';
5
+ import type { Object3D } from '../../rendering/world3d/Object3D.js';
6
+ export declare class TransformControls3D implements Disposable {
7
+ #private;
8
+ readonly camera: Camera3D;
9
+ readonly element: HTMLElement;
10
+ /** The handles; add this to the scene that holds the edited object. */
11
+ readonly gizmo: TransformGizmo3D;
12
+ /**
13
+ * Create these before orbit or fly controls on the same element: a press
14
+ * that lands on a handle is then kept from reaching them.
15
+ */
16
+ constructor(camera: Camera3D, element: HTMLElement, options?: TransformGizmoOptions3D);
17
+ get mode(): GizmoMode3D;
18
+ set mode(value: GizmoMode3D);
19
+ get space(): GizmoSpace3D;
20
+ set space(value: GizmoSpace3D);
21
+ get enabled(): boolean;
22
+ set enabled(value: boolean);
23
+ get dragging(): boolean;
24
+ get object(): Object3D | undefined;
25
+ attach(object: Object3D): this;
26
+ detach(): this;
27
+ /** Turn a pointer position into a world-space ray; false when the element has no size. */
28
+ private ray;
29
+ /** Keep the handles on the object and at a steady size; call once per frame. */
30
+ update(): void;
31
+ dispose(): void;
32
+ }
33
+ export declare function createTransformControls3D(camera: Camera3D, element: HTMLElement, options?: TransformGizmoOptions3D): TransformControls3D;
34
+ //# sourceMappingURL=TransformControls3D.d.ts.map