@egret/engine 0.0.0-stage → 7.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (601) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +21 -0
  3. package/README.md +101 -2
  4. package/README.zh-CN.md +102 -0
  5. package/dist/Engine.d.ts +77 -0
  6. package/dist/Engine.js +469 -0
  7. package/dist/animation/index.d.ts +6 -0
  8. package/dist/animation/index.js +5 -0
  9. package/dist/animation/sequenceController.d.ts +22 -0
  10. package/dist/animation/sequenceController.js +618 -0
  11. package/dist/animation/sequenceCoordinator.d.ts +26 -0
  12. package/dist/animation/sequenceCoordinator.js +161 -0
  13. package/dist/animation/sequenceInput.d.ts +25 -0
  14. package/dist/animation/sequenceInput.js +108 -0
  15. package/dist/animation/sequenceMath.d.ts +35 -0
  16. package/dist/animation/sequenceMath.js +164 -0
  17. package/dist/animation/sequenceResetSlot.d.ts +7 -0
  18. package/dist/animation/sequenceResetSlot.js +367 -0
  19. package/dist/animation/sequenceResetTypes.d.ts +48 -0
  20. package/dist/animation/sequenceResetTypes.js +2 -0
  21. package/dist/animation/types.d.ts +75 -0
  22. package/dist/animation/types.js +2 -0
  23. package/dist/assetBundle.d.ts +54 -0
  24. package/dist/assetBundle.js +173 -0
  25. package/dist/assetGroup.d.ts +17 -0
  26. package/dist/assetGroup.js +332 -0
  27. package/dist/assetGroupTypes.d.ts +17 -0
  28. package/dist/assetGroupTypes.js +2 -0
  29. package/dist/audio.d.ts +4 -0
  30. package/dist/audio.js +4 -0
  31. package/dist/audioCues.d.ts +47 -0
  32. package/dist/audioCues.js +127 -0
  33. package/dist/audioMixer.d.ts +7 -0
  34. package/dist/audioMixer.js +785 -0
  35. package/dist/audioTypes.d.ts +246 -0
  36. package/dist/audioTypes.js +3 -0
  37. package/dist/bitmapBindingTicket.d.ts +24 -0
  38. package/dist/bitmapBindingTicket.js +215 -0
  39. package/dist/bitmapButton.d.ts +4 -0
  40. package/dist/bitmapButton.js +407 -0
  41. package/dist/bitmapButtonTypes.d.ts +31 -0
  42. package/dist/bitmapButtonTypes.js +2 -0
  43. package/dist/bitmapFontParse.d.ts +10 -0
  44. package/dist/bitmapFontParse.js +246 -0
  45. package/dist/bitmapFontTypes.d.ts +112 -0
  46. package/dist/bitmapFontTypes.js +2 -0
  47. package/dist/bitmapResourceSlot.d.ts +26 -0
  48. package/dist/bitmapResourceSlot.js +340 -0
  49. package/dist/bitmapText.d.ts +6 -0
  50. package/dist/bitmapText.js +320 -0
  51. package/dist/bitmapfont.d.ts +5 -0
  52. package/dist/bitmapfont.js +5 -0
  53. package/dist/camera.d.ts +4 -0
  54. package/dist/camera.js +4 -0
  55. package/dist/camera2d.d.ts +7 -0
  56. package/dist/camera2d.js +419 -0
  57. package/dist/cameraTypes.d.ts +126 -0
  58. package/dist/cameraTypes.js +2 -0
  59. package/dist/closeHost.d.ts +4 -0
  60. package/dist/closeHost.js +66 -0
  61. package/dist/contentArtifacts.d.ts +12 -0
  62. package/dist/contentArtifacts.js +153 -0
  63. package/dist/contentAtlasPages.d.ts +13 -0
  64. package/dist/contentAtlasPages.js +117 -0
  65. package/dist/contentLoader.d.ts +6 -0
  66. package/dist/contentLoader.js +327 -0
  67. package/dist/contentTypes.d.ts +35 -0
  68. package/dist/contentTypes.js +2 -0
  69. package/dist/createEngine.d.ts +7 -0
  70. package/dist/createEngine.js +25 -0
  71. package/dist/createEngineForProfile.d.ts +5 -0
  72. package/dist/createEngineForProfile.js +45 -0
  73. package/dist/displaySubtreeTicket.d.ts +25 -0
  74. package/dist/displaySubtreeTicket.js +76 -0
  75. package/dist/fontContentLoader.d.ts +6 -0
  76. package/dist/fontContentLoader.js +298 -0
  77. package/dist/fontContentTypes.d.ts +39 -0
  78. package/dist/fontContentTypes.js +2 -0
  79. package/dist/gameClock.d.ts +24 -0
  80. package/dist/gameClock.js +246 -0
  81. package/dist/gameClockTypes.d.ts +37 -0
  82. package/dist/gameClockTypes.js +2 -0
  83. package/dist/gameRun.d.ts +53 -0
  84. package/dist/gameRun.js +97 -0
  85. package/dist/gamepad.d.ts +5 -0
  86. package/dist/gamepad.js +5 -0
  87. package/dist/gamepadInput.d.ts +4 -0
  88. package/dist/gamepadInput.js +281 -0
  89. package/dist/gamepadKeys.d.ts +4 -0
  90. package/dist/gamepadKeys.js +205 -0
  91. package/dist/gamepadTypes.d.ts +142 -0
  92. package/dist/gamepadTypes.js +3 -0
  93. package/dist/hover.d.ts +4 -0
  94. package/dist/hover.js +4 -0
  95. package/dist/hoverInput.d.ts +8 -0
  96. package/dist/hoverInput.js +503 -0
  97. package/dist/hoverInputTypes.d.ts +129 -0
  98. package/dist/hoverInputTypes.js +2 -0
  99. package/dist/index.d.ts +52 -0
  100. package/dist/index.js +21 -0
  101. package/dist/input.d.ts +6 -0
  102. package/dist/input.js +5 -0
  103. package/dist/inputActions.d.ts +86 -0
  104. package/dist/inputActions.js +330 -0
  105. package/dist/internal/contentFactoryState.d.ts +19 -0
  106. package/dist/internal/contentFactoryState.js +42 -0
  107. package/dist/internal/mouseInputFactoryState.d.ts +57 -0
  108. package/dist/internal/mouseInputFactoryState.js +125 -0
  109. package/dist/internal/sequenceControllerFactoryState.d.ts +42 -0
  110. package/dist/internal/sequenceControllerFactoryState.js +98 -0
  111. package/dist/internal/textFieldFactoryState.d.ts +11 -0
  112. package/dist/internal/textFieldFactoryState.js +32 -0
  113. package/dist/internal/texturedFrameState.d.ts +4 -0
  114. package/dist/internal/texturedFrameState.js +12 -0
  115. package/dist/internal/uiFactoryState.d.ts +68 -0
  116. package/dist/internal/uiFactoryState.js +173 -0
  117. package/dist/internal/uiRootState.d.ts +67 -0
  118. package/dist/internal/uiRootState.js +103 -0
  119. package/dist/keyboardInput.d.ts +13 -0
  120. package/dist/keyboardInput.js +579 -0
  121. package/dist/keyboardInputTypes.d.ts +93 -0
  122. package/dist/keyboardInputTypes.js +2 -0
  123. package/dist/kit.d.ts +16 -0
  124. package/dist/kit.js +10 -0
  125. package/dist/layout.d.ts +5 -0
  126. package/dist/layout.js +132 -0
  127. package/dist/layoutTypes.d.ts +28 -0
  128. package/dist/layoutTypes.js +2 -0
  129. package/dist/manifestAssetGroup.d.ts +10 -0
  130. package/dist/manifestAssetGroup.js +477 -0
  131. package/dist/manifestResourceState.d.ts +17 -0
  132. package/dist/manifestResourceState.js +58 -0
  133. package/dist/manifestResourceTypes.d.ts +26 -0
  134. package/dist/manifestResourceTypes.js +2 -0
  135. package/dist/motion.d.ts +35 -0
  136. package/dist/motion.js +206 -0
  137. package/dist/mouseInput.d.ts +102 -0
  138. package/dist/mouseInput.js +562 -0
  139. package/dist/mouseInputTypes.d.ts +41 -0
  140. package/dist/mouseInputTypes.js +2 -0
  141. package/dist/paragraph.d.ts +8 -0
  142. package/dist/paragraph.js +7 -0
  143. package/dist/particleEmitter.d.ts +4 -0
  144. package/dist/particleEmitter.js +300 -0
  145. package/dist/particleTypes.d.ts +115 -0
  146. package/dist/particleTypes.js +2 -0
  147. package/dist/particles.d.ts +4 -0
  148. package/dist/particles.js +4 -0
  149. package/dist/physics2d.d.ts +4 -0
  150. package/dist/physics2d.js +4 -0
  151. package/dist/physics2dGeometry.d.ts +39 -0
  152. package/dist/physics2dGeometry.js +230 -0
  153. package/dist/physics2dTypes.d.ts +221 -0
  154. package/dist/physics2dTypes.js +2 -0
  155. package/dist/physics2dWorld.d.ts +4 -0
  156. package/dist/physics2dWorld.js +823 -0
  157. package/dist/pointerInput.d.ts +12 -0
  158. package/dist/pointerInput.js +300 -0
  159. package/dist/pointerInputTypes.d.ts +41 -0
  160. package/dist/pointerInputTypes.js +2 -0
  161. package/dist/random.d.ts +30 -0
  162. package/dist/random.js +131 -0
  163. package/dist/rendering/ownedPreparationFailure2D.d.ts +5 -0
  164. package/dist/rendering/ownedPreparationFailure2D.js +33 -0
  165. package/dist/rendering/packSharedDraws2D.d.ts +50 -0
  166. package/dist/rendering/packSharedDraws2D.js +379 -0
  167. package/dist/rendering/packedOrientation.d.ts +4 -0
  168. package/dist/rendering/packedOrientation.js +7 -0
  169. package/dist/rendering/prepareRectangles2D.d.ts +92 -0
  170. package/dist/rendering/prepareRectangles2D.js +481 -0
  171. package/dist/rendering/prepareSharedDraws2D.d.ts +90 -0
  172. package/dist/rendering/prepareSharedDraws2D.js +663 -0
  173. package/dist/rendering/preparedBatches2D.d.ts +17 -0
  174. package/dist/rendering/preparedBatches2D.js +30 -0
  175. package/dist/rendering/preparedSharedBatches2D.d.ts +44 -0
  176. package/dist/rendering/preparedSharedBatches2D.js +247 -0
  177. package/dist/rendering/sharedColor2D.d.ts +52 -0
  178. package/dist/rendering/sharedColor2D.js +191 -0
  179. package/dist/rendering/sharedEffects2D.d.ts +23 -0
  180. package/dist/rendering/sharedEffects2D.js +126 -0
  181. package/dist/rendering/sharedPreparationRetention2D.d.ts +120 -0
  182. package/dist/rendering/sharedPreparationRetention2D.js +357 -0
  183. package/dist/rendering/srgbBytes.d.ts +3 -0
  184. package/dist/rendering/srgbBytes.js +64 -0
  185. package/dist/rendering/texturedPreparationBudget2D.d.ts +31 -0
  186. package/dist/rendering/texturedPreparationBudget2D.js +81 -0
  187. package/dist/rendering/world3d/Animation3D.d.ts +104 -0
  188. package/dist/rendering/world3d/Animation3D.js +384 -0
  189. package/dist/rendering/world3d/AnimationTexture3D.d.ts +163 -0
  190. package/dist/rendering/world3d/AnimationTexture3D.js +603 -0
  191. package/dist/rendering/world3d/Batch3D.d.ts +75 -0
  192. package/dist/rendering/world3d/Batch3D.js +332 -0
  193. package/dist/rendering/world3d/Camera3D.d.ts +62 -0
  194. package/dist/rendering/world3d/Camera3D.js +132 -0
  195. package/dist/rendering/world3d/Character3D.d.ts +127 -0
  196. package/dist/rendering/world3d/Character3D.js +305 -0
  197. package/dist/rendering/world3d/Cloth3D.d.ts +130 -0
  198. package/dist/rendering/world3d/Cloth3D.js +503 -0
  199. package/dist/rendering/world3d/Compression3D.d.ts +22 -0
  200. package/dist/rendering/world3d/Compression3D.js +703 -0
  201. package/dist/rendering/world3d/Curves3D.d.ts +119 -0
  202. package/dist/rendering/world3d/Curves3D.js +460 -0
  203. package/dist/rendering/world3d/Decal3D.d.ts +43 -0
  204. package/dist/rendering/world3d/Decal3D.js +242 -0
  205. package/dist/rendering/world3d/Export3D.d.ts +13 -0
  206. package/dist/rendering/world3d/Export3D.js +263 -0
  207. package/dist/rendering/world3d/Geometry3D.d.ts +95 -0
  208. package/dist/rendering/world3d/Geometry3D.js +335 -0
  209. package/dist/rendering/world3d/GeometryBuilder3D.d.ts +53 -0
  210. package/dist/rendering/world3d/GeometryBuilder3D.js +196 -0
  211. package/dist/rendering/world3d/Gizmo3D.d.ts +80 -0
  212. package/dist/rendering/world3d/Gizmo3D.js +514 -0
  213. package/dist/rendering/world3d/Gltf3D.d.ts +73 -0
  214. package/dist/rendering/world3d/Gltf3D.js +996 -0
  215. package/dist/rendering/world3d/GpuParticles3D.d.ts +109 -0
  216. package/dist/rendering/world3d/GpuParticles3D.js +401 -0
  217. package/dist/rendering/world3d/Hdr3D.d.ts +35 -0
  218. package/dist/rendering/world3d/Hdr3D.js +191 -0
  219. package/dist/rendering/world3d/Jelly3D.d.ts +77 -0
  220. package/dist/rendering/world3d/Jelly3D.js +267 -0
  221. package/dist/rendering/world3d/Ktx23D.d.ts +30 -0
  222. package/dist/rendering/world3d/Ktx23D.js +112 -0
  223. package/dist/rendering/world3d/Light3D.d.ts +84 -0
  224. package/dist/rendering/world3d/Light3D.js +97 -0
  225. package/dist/rendering/world3d/Material3D.d.ts +253 -0
  226. package/dist/rendering/world3d/Material3D.js +269 -0
  227. package/dist/rendering/world3d/Mesh3D.d.ts +112 -0
  228. package/dist/rendering/world3d/Mesh3D.js +337 -0
  229. package/dist/rendering/world3d/Meshopt3D.d.ts +15 -0
  230. package/dist/rendering/world3d/Meshopt3D.js +276 -0
  231. package/dist/rendering/world3d/Navigation3D.d.ts +213 -0
  232. package/dist/rendering/world3d/Navigation3D.js +1043 -0
  233. package/dist/rendering/world3d/Object3D.d.ts +118 -0
  234. package/dist/rendering/world3d/Object3D.js +315 -0
  235. package/dist/rendering/world3d/Particles3D.d.ts +90 -0
  236. package/dist/rendering/world3d/Particles3D.js +277 -0
  237. package/dist/rendering/world3d/Physics3D.d.ts +430 -0
  238. package/dist/rendering/world3d/Physics3D.js +2840 -0
  239. package/dist/rendering/world3d/PhysicsHull3D.d.ts +37 -0
  240. package/dist/rendering/world3d/PhysicsHull3D.js +229 -0
  241. package/dist/rendering/world3d/PhysicsMesh3D.d.ts +41 -0
  242. package/dist/rendering/world3d/PhysicsMesh3D.js +340 -0
  243. package/dist/rendering/world3d/PhysicsQueries3D.d.ts +24 -0
  244. package/dist/rendering/world3d/PhysicsQueries3D.js +323 -0
  245. package/dist/rendering/world3d/PhysicsRemote3D.d.ts +179 -0
  246. package/dist/rendering/world3d/PhysicsRemote3D.js +536 -0
  247. package/dist/rendering/world3d/Ragdoll3D.d.ts +74 -0
  248. package/dist/rendering/world3d/Ragdoll3D.js +202 -0
  249. package/dist/rendering/world3d/Raycast3D.d.ts +40 -0
  250. package/dist/rendering/world3d/Raycast3D.js +247 -0
  251. package/dist/rendering/world3d/RenderList3D.d.ts +91 -0
  252. package/dist/rendering/world3d/RenderList3D.js +502 -0
  253. package/dist/rendering/world3d/Retarget3D.d.ts +21 -0
  254. package/dist/rendering/world3d/Retarget3D.js +185 -0
  255. package/dist/rendering/world3d/Rig3D.d.ts +57 -0
  256. package/dist/rendering/world3d/Rig3D.js +219 -0
  257. package/dist/rendering/world3d/Sdf3D.d.ts +181 -0
  258. package/dist/rendering/world3d/Sdf3D.js +1136 -0
  259. package/dist/rendering/world3d/SdfLod3D.d.ts +17 -0
  260. package/dist/rendering/world3d/SdfLod3D.js +56 -0
  261. package/dist/rendering/world3d/Serialize3D.d.ts +66 -0
  262. package/dist/rendering/world3d/Serialize3D.js +629 -0
  263. package/dist/rendering/world3d/Simplify3D.d.ts +29 -0
  264. package/dist/rendering/world3d/Simplify3D.js +426 -0
  265. package/dist/rendering/world3d/StateMachine3D.d.ts +87 -0
  266. package/dist/rendering/world3d/StateMachine3D.js +280 -0
  267. package/dist/rendering/world3d/SurfaceMaterial3D.d.ts +26 -0
  268. package/dist/rendering/world3d/SurfaceMaterial3D.js +138 -0
  269. package/dist/rendering/world3d/Terrain3D.d.ts +248 -0
  270. package/dist/rendering/world3d/Terrain3D.js +827 -0
  271. package/dist/rendering/world3d/Text3D.d.ts +95 -0
  272. package/dist/rendering/world3d/Text3D.js +560 -0
  273. package/dist/rendering/world3d/Texture3D.d.ts +148 -0
  274. package/dist/rendering/world3d/Texture3D.js +270 -0
  275. package/dist/rendering/world3d/Trail3D.d.ts +62 -0
  276. package/dist/rendering/world3d/Trail3D.js +195 -0
  277. package/dist/rendering/world3d/Vehicle3D.d.ts +102 -0
  278. package/dist/rendering/world3d/Vehicle3D.js +228 -0
  279. package/dist/rendering/world3d/VolumetricFog3D.d.ts +57 -0
  280. package/dist/rendering/world3d/VolumetricFog3D.js +230 -0
  281. package/dist/rendering/world3d/Water3D.d.ts +165 -0
  282. package/dist/rendering/world3d/Water3D.js +607 -0
  283. package/dist/rendering/world3d/core3D.d.ts +36 -0
  284. package/dist/rendering/world3d/core3D.js +99 -0
  285. package/dist/rendering/world3d/debug3D.d.ts +69 -0
  286. package/dist/rendering/world3d/debug3D.js +262 -0
  287. package/dist/rendering/world3d/decoders3D.d.ts +42 -0
  288. package/dist/rendering/world3d/decoders3D.js +133 -0
  289. package/dist/rendering/world3d/geometries3D.d.ts +111 -0
  290. package/dist/rendering/world3d/geometries3D.js +610 -0
  291. package/dist/rendering/world3d/helpers3D.d.ts +67 -0
  292. package/dist/rendering/world3d/helpers3D.js +178 -0
  293. package/dist/rendering/world3d/index.d.ts +103 -0
  294. package/dist/rendering/world3d/index.js +62 -0
  295. package/dist/rendering/world3d/math3D.d.ts +114 -0
  296. package/dist/rendering/world3d/math3D.js +675 -0
  297. package/dist/rendering/world3d/primitives3D.d.ts +67 -0
  298. package/dist/rendering/world3d/primitives3D.js +197 -0
  299. package/dist/resources.d.ts +8 -0
  300. package/dist/resources.js +6 -0
  301. package/dist/saveStore.d.ts +71 -0
  302. package/dist/saveStore.js +182 -0
  303. package/dist/semanticList.d.ts +126 -0
  304. package/dist/semanticList.js +175 -0
  305. package/dist/semanticTree.d.ts +10 -0
  306. package/dist/semanticTree.js +539 -0
  307. package/dist/semanticTypes.d.ts +175 -0
  308. package/dist/semanticTypes.js +2 -0
  309. package/dist/semantics.d.ts +6 -0
  310. package/dist/semantics.js +5 -0
  311. package/dist/sequencePlayback.d.ts +19 -0
  312. package/dist/sequencePlayback.js +391 -0
  313. package/dist/sequencePlaybackTypes.d.ts +24 -0
  314. package/dist/sequencePlaybackTypes.js +2 -0
  315. package/dist/sequenceTargetClaims.d.ts +10 -0
  316. package/dist/sequenceTargetClaims.js +31 -0
  317. package/dist/srgbBytes.d.ts +3 -0
  318. package/dist/srgbBytes.js +64 -0
  319. package/dist/startEngine.d.ts +5 -0
  320. package/dist/startEngine.js +31 -0
  321. package/dist/surfaceOwnership.d.ts +3 -0
  322. package/dist/surfaceOwnership.js +15 -0
  323. package/dist/text.d.ts +24 -0
  324. package/dist/text.js +4 -0
  325. package/dist/textField.d.ts +6 -0
  326. package/dist/textField.js +6 -0
  327. package/dist/textTable.d.ts +41 -0
  328. package/dist/textTable.js +114 -0
  329. package/dist/tileMapDraw.d.ts +7 -0
  330. package/dist/tileMapDraw.js +310 -0
  331. package/dist/tiledImport.d.ts +9 -0
  332. package/dist/tiledImport.js +357 -0
  333. package/dist/tilemap.d.ts +5 -0
  334. package/dist/tilemap.js +5 -0
  335. package/dist/tilemapTypes.d.ts +182 -0
  336. package/dist/tilemapTypes.js +2 -0
  337. package/dist/timer.d.ts +34 -0
  338. package/dist/timer.js +119 -0
  339. package/dist/tween.d.ts +15 -0
  340. package/dist/tween.js +329 -0
  341. package/dist/tweenTypes.d.ts +31 -0
  342. package/dist/tweenTypes.js +2 -0
  343. package/dist/ui/controlKeys.d.ts +113 -0
  344. package/dist/ui/controlKeys.js +250 -0
  345. package/dist/ui/controls.d.ts +58 -0
  346. package/dist/ui/controls.js +290 -0
  347. package/dist/ui/editing.d.ts +3 -0
  348. package/dist/ui/editing.js +3 -0
  349. package/dist/ui/index.d.ts +19 -0
  350. package/dist/ui/index.js +11 -0
  351. package/dist/ui/keyboardFocus.d.ts +32 -0
  352. package/dist/ui/keyboardFocus.js +146 -0
  353. package/dist/ui/layerTypes.d.ts +98 -0
  354. package/dist/ui/layerTypes.js +2 -0
  355. package/dist/ui/layers.d.ts +4 -0
  356. package/dist/ui/layers.js +586 -0
  357. package/dist/ui/leafContent.d.ts +21 -0
  358. package/dist/ui/leafContent.js +136 -0
  359. package/dist/ui/rangeControl.d.ts +53 -0
  360. package/dist/ui/rangeControl.js +168 -0
  361. package/dist/ui/scrollControl.d.ts +84 -0
  362. package/dist/ui/scrollControl.js +222 -0
  363. package/dist/ui/stateControls.d.ts +90 -0
  364. package/dist/ui/stateControls.js +331 -0
  365. package/dist/ui/textEditor.d.ts +54 -0
  366. package/dist/ui/textEditor.js +371 -0
  367. package/dist/ui/textEditorTypes.d.ts +85 -0
  368. package/dist/ui/textEditorTypes.js +2 -0
  369. package/dist/ui/textFieldControl.d.ts +100 -0
  370. package/dist/ui/textFieldControl.js +260 -0
  371. package/dist/ui/theme.d.ts +64 -0
  372. package/dist/ui/theme.js +166 -0
  373. package/dist/ui/types.d.ts +285 -0
  374. package/dist/ui/types.js +2 -0
  375. package/dist/ui/uiRoot.d.ts +4 -0
  376. package/dist/ui/uiRoot.js +1526 -0
  377. package/dist/ui/uiRootDisplay.d.ts +46 -0
  378. package/dist/ui/uiRootDisplay.js +148 -0
  379. package/dist/ui/uiRootModel.d.ts +114 -0
  380. package/dist/ui/uiRootModel.js +66 -0
  381. package/dist/ui/virtualList.d.ts +20 -0
  382. package/dist/ui/virtualList.js +105 -0
  383. package/dist/video.d.ts +4 -0
  384. package/dist/video.js +4 -0
  385. package/dist/videoPlayer.d.ts +4 -0
  386. package/dist/videoPlayer.js +215 -0
  387. package/dist/videoTypes.d.ts +77 -0
  388. package/dist/videoTypes.js +2 -0
  389. package/dist/web/BrowserAssetBundle.d.ts +41 -0
  390. package/dist/web/BrowserAssetBundle.js +136 -0
  391. package/dist/web/BrowserAudio.d.ts +74 -0
  392. package/dist/web/BrowserAudio.js +503 -0
  393. package/dist/web/BrowserFrameLoop.d.ts +69 -0
  394. package/dist/web/BrowserFrameLoop.js +125 -0
  395. package/dist/web/BrowserGame.d.ts +174 -0
  396. package/dist/web/BrowserGame.js +473 -0
  397. package/dist/web/BrowserGamepadInput.d.ts +38 -0
  398. package/dist/web/BrowserGamepadInput.js +134 -0
  399. package/dist/web/BrowserHoverInput.d.ts +25 -0
  400. package/dist/web/BrowserHoverInput.js +266 -0
  401. package/dist/web/BrowserImageTextures.d.ts +72 -0
  402. package/dist/web/BrowserImageTextures.js +169 -0
  403. package/dist/web/BrowserInputActions.d.ts +63 -0
  404. package/dist/web/BrowserInputActions.js +345 -0
  405. package/dist/web/BrowserKeyboardInput.d.ts +4 -0
  406. package/dist/web/BrowserKeyboardInput.js +223 -0
  407. package/dist/web/BrowserPlay.d.ts +417 -0
  408. package/dist/web/BrowserPlay.js +1648 -0
  409. package/dist/web/BrowserPointerInput.d.ts +4 -0
  410. package/dist/web/BrowserPointerInput.js +511 -0
  411. package/dist/web/BrowserPreferences.d.ts +10 -0
  412. package/dist/web/BrowserPreferences.js +39 -0
  413. package/dist/web/BrowserSemantics.d.ts +36 -0
  414. package/dist/web/BrowserSemantics.js +418 -0
  415. package/dist/web/BrowserStatsPanel.d.ts +56 -0
  416. package/dist/web/BrowserStatsPanel.js +143 -0
  417. package/dist/web/BrowserStorage.d.ts +35 -0
  418. package/dist/web/BrowserStorage.js +132 -0
  419. package/dist/web/BrowserTextEditor.d.ts +52 -0
  420. package/dist/web/BrowserTextEditor.js +839 -0
  421. package/dist/web/BrowserTextInput.d.ts +89 -0
  422. package/dist/web/BrowserTextInput.js +524 -0
  423. package/dist/web/BrowserTextureProvider.d.ts +58 -0
  424. package/dist/web/BrowserTextureProvider.js +935 -0
  425. package/dist/web/BrowserVideo.d.ts +40 -0
  426. package/dist/web/BrowserVideo.js +237 -0
  427. package/dist/web/CanvasKitFontSetProvider.d.ts +32 -0
  428. package/dist/web/CanvasKitFontSetProvider.js +215 -0
  429. package/dist/web/CanvasKitParagraphProvider.d.ts +173 -0
  430. package/dist/web/CanvasKitParagraphProvider.js +692 -0
  431. package/dist/web/CanvasTextRasterProvider.d.ts +4 -0
  432. package/dist/web/CanvasTextRasterProvider.js +312 -0
  433. package/dist/web/ManifestByteSource.d.ts +151 -0
  434. package/dist/web/ManifestByteSource.js +975 -0
  435. package/dist/web/ManifestFontContentLoader.d.ts +13 -0
  436. package/dist/web/ManifestFontContentLoader.js +30 -0
  437. package/dist/web/MouseInput.d.ts +4 -0
  438. package/dist/web/MouseInput.js +218 -0
  439. package/dist/web/WebGL2Host.d.ts +5 -0
  440. package/dist/web/WebGL2Host.js +2711 -0
  441. package/dist/web/WebGPUHost.d.ts +100 -0
  442. package/dist/web/WebGPUHost.js +3430 -0
  443. package/dist/web/audio.d.ts +3 -0
  444. package/dist/web/audio.js +4 -0
  445. package/dist/web/canvasKitParagraphGeometry.d.ts +27 -0
  446. package/dist/web/canvasKitParagraphGeometry.js +83 -0
  447. package/dist/web/editing.d.ts +5 -0
  448. package/dist/web/editing.js +4 -0
  449. package/dist/web/editorFonts.d.ts +54 -0
  450. package/dist/web/editorFonts.js +297 -0
  451. package/dist/web/game.d.ts +5 -0
  452. package/dist/web/game.js +6 -0
  453. package/dist/web/gamepad.d.ts +3 -0
  454. package/dist/web/gamepad.js +4 -0
  455. package/dist/web/hover.d.ts +3 -0
  456. package/dist/web/hover.js +4 -0
  457. package/dist/web/image.d.ts +4 -0
  458. package/dist/web/image.js +4 -0
  459. package/dist/web/imageProjections2D.d.ts +16 -0
  460. package/dist/web/imageProjections2D.js +2 -0
  461. package/dist/web/input.d.ts +6 -0
  462. package/dist/web/input.js +4 -0
  463. package/dist/web/keyboard.d.ts +3 -0
  464. package/dist/web/keyboard.js +3 -0
  465. package/dist/web/kit.d.ts +11 -0
  466. package/dist/web/kit.js +8 -0
  467. package/dist/web/loop.d.ts +3 -0
  468. package/dist/web/loop.js +4 -0
  469. package/dist/web/paragraph.d.ts +6 -0
  470. package/dist/web/paragraph.js +4 -0
  471. package/dist/web/play.d.ts +10 -0
  472. package/dist/web/play.js +9 -0
  473. package/dist/web/playMusic.d.ts +33 -0
  474. package/dist/web/playMusic.js +194 -0
  475. package/dist/web/playSfx.d.ts +36 -0
  476. package/dist/web/playSfx.js +112 -0
  477. package/dist/web/playTouch.d.ts +45 -0
  478. package/dist/web/playTouch.js +141 -0
  479. package/dist/web/playWidgets.d.ts +71 -0
  480. package/dist/web/playWidgets.js +431 -0
  481. package/dist/web/pointer.d.ts +3 -0
  482. package/dist/web/pointer.js +3 -0
  483. package/dist/web/prepareSharedSubmission2D.d.ts +27 -0
  484. package/dist/web/prepareSharedSubmission2D.js +63 -0
  485. package/dist/web/resources.d.ts +29 -0
  486. package/dist/web/resources.js +96 -0
  487. package/dist/web/semantics.d.ts +3 -0
  488. package/dist/web/semantics.js +4 -0
  489. package/dist/web/sharedDeviceSession.d.ts +64 -0
  490. package/dist/web/sharedDeviceSession.js +2 -0
  491. package/dist/web/sharedEffectShaders.d.ts +13 -0
  492. package/dist/web/sharedEffectShaders.js +181 -0
  493. package/dist/web/sharedFrameUpload.d.ts +25 -0
  494. package/dist/web/sharedFrameUpload.js +2 -0
  495. package/dist/web/sharedHostDeferred.d.ts +7 -0
  496. package/dist/web/sharedHostDeferred.js +12 -0
  497. package/dist/web/sharedRetentionLedger.d.ts +85 -0
  498. package/dist/web/sharedRetentionLedger.js +391 -0
  499. package/dist/web/sharedSubmissionStorage2D.d.ts +56 -0
  500. package/dist/web/sharedSubmissionStorage2D.js +73 -0
  501. package/dist/web/sharedWebGL2Arena.d.ts +40 -0
  502. package/dist/web/sharedWebGL2Arena.js +77 -0
  503. package/dist/web/sharedWebGL2Options.d.ts +33 -0
  504. package/dist/web/sharedWebGL2Options.js +102 -0
  505. package/dist/web/sharedWebGL2Shaders.d.ts +33 -0
  506. package/dist/web/sharedWebGL2Shaders.js +408 -0
  507. package/dist/web/sharedWebGPUOptions.d.ts +41 -0
  508. package/dist/web/sharedWebGPUOptions.js +130 -0
  509. package/dist/web/text.d.ts +3 -0
  510. package/dist/web/text.js +3 -0
  511. package/dist/web/textInput.d.ts +3 -0
  512. package/dist/web/textInput.js +3 -0
  513. package/dist/web/video.d.ts +3 -0
  514. package/dist/web/video.js +4 -0
  515. package/dist/web/webgl2.d.ts +7 -0
  516. package/dist/web/webgl2.js +4 -0
  517. package/dist/web/webgl2LayerState.d.ts +50 -0
  518. package/dist/web/webgl2LayerState.js +102 -0
  519. package/dist/web/webgl2Native.d.ts +72 -0
  520. package/dist/web/webgl2Native.js +572 -0
  521. package/dist/web/webgl2Types.d.ts +150 -0
  522. package/dist/web/webgl2Types.js +2 -0
  523. package/dist/web/webgpu.d.ts +6 -0
  524. package/dist/web/webgpu.js +2 -0
  525. package/dist/web/webgpuBindingCache.d.ts +26 -0
  526. package/dist/web/webgpuBindingCache.js +223 -0
  527. package/dist/web/webgpuBufferPool.d.ts +51 -0
  528. package/dist/web/webgpuBufferPool.js +58 -0
  529. package/dist/web/webgpuImageResidency.d.ts +56 -0
  530. package/dist/web/webgpuImageResidency.js +65 -0
  531. package/dist/web/webgpuLifetime.d.ts +45 -0
  532. package/dist/web/webgpuLifetime.js +64 -0
  533. package/dist/web/webgpuRetentionPool.d.ts +66 -0
  534. package/dist/web/webgpuRetentionPool.js +85 -0
  535. package/dist/web/webgpuSharedPass.d.ts +7 -0
  536. package/dist/web/webgpuSharedPass.js +293 -0
  537. package/dist/web/webgpuSharedResolvePass.d.ts +3 -0
  538. package/dist/web/webgpuSharedResolvePass.js +34 -0
  539. package/dist/web/world3d/Audio3D.d.ts +85 -0
  540. package/dist/web/world3d/Audio3D.js +271 -0
  541. package/dist/web/world3d/BrowserPlay3D.d.ts +295 -0
  542. package/dist/web/world3d/BrowserPlay3D.js +1256 -0
  543. package/dist/web/world3d/FlyControls3D.d.ts +59 -0
  544. package/dist/web/world3d/FlyControls3D.js +162 -0
  545. package/dist/web/world3d/FollowControls3D.d.ts +31 -0
  546. package/dist/web/world3d/FollowControls3D.js +119 -0
  547. package/dist/web/world3d/OrbitControls3D.d.ts +58 -0
  548. package/dist/web/world3d/OrbitControls3D.js +189 -0
  549. package/dist/web/world3d/TransformControls3D.d.ts +37 -0
  550. package/dist/web/world3d/TransformControls3D.js +128 -0
  551. package/dist/web/world3d/WebGL2Renderer3D.d.ts +136 -0
  552. package/dist/web/world3d/WebGL2Renderer3D.js +1175 -0
  553. package/dist/web/world3d/WebGPURenderer3D.d.ts +112 -0
  554. package/dist/web/world3d/WebGPURenderer3D.js +1916 -0
  555. package/dist/web/world3d/World3DView.d.ts +54 -0
  556. package/dist/web/world3d/World3DView.js +79 -0
  557. package/dist/web/world3d/app3D.d.ts +143 -0
  558. package/dist/web/world3d/app3D.js +305 -0
  559. package/dist/web/world3d/assets3D.d.ts +39 -0
  560. package/dist/web/world3d/assets3D.js +112 -0
  561. package/dist/web/world3d/atmosphere3D.d.ts +56 -0
  562. package/dist/web/world3d/atmosphere3D.js +193 -0
  563. package/dist/web/world3d/canvasFont3D.d.ts +21 -0
  564. package/dist/web/world3d/canvasFont3D.js +165 -0
  565. package/dist/web/world3d/frame3D.d.ts +144 -0
  566. package/dist/web/world3d/frame3D.js +388 -0
  567. package/dist/web/world3d/gpuResources3D.d.ts +98 -0
  568. package/dist/web/world3d/gpuResources3D.js +901 -0
  569. package/dist/web/world3d/host3D.d.ts +24 -0
  570. package/dist/web/world3d/host3D.js +61 -0
  571. package/dist/web/world3d/index.d.ts +40 -0
  572. package/dist/web/world3d/index.js +24 -0
  573. package/dist/web/world3d/loaders3D.d.ts +27 -0
  574. package/dist/web/world3d/loaders3D.js +138 -0
  575. package/dist/web/world3d/markers3D.d.ts +53 -0
  576. package/dist/web/world3d/markers3D.js +130 -0
  577. package/dist/web/world3d/materialWebGL23D.d.ts +34 -0
  578. package/dist/web/world3d/materialWebGL23D.js +218 -0
  579. package/dist/web/world3d/overlay3D.d.ts +47 -0
  580. package/dist/web/world3d/overlay3D.js +187 -0
  581. package/dist/web/world3d/post3D.d.ts +116 -0
  582. package/dist/web/world3d/post3D.js +462 -0
  583. package/dist/web/world3d/postWebGL23D.d.ts +24 -0
  584. package/dist/web/world3d/postWebGL23D.js +237 -0
  585. package/dist/web/world3d/postWebGPU3D.d.ts +23 -0
  586. package/dist/web/world3d/postWebGPU3D.js +255 -0
  587. package/dist/web/world3d/probe3D.d.ts +15 -0
  588. package/dist/web/world3d/probe3D.js +66 -0
  589. package/dist/web/world3d/shaders3D.d.ts +43 -0
  590. package/dist/web/world3d/shaders3D.js +851 -0
  591. package/dist/web/world3d/stats3D.d.ts +34 -0
  592. package/dist/web/world3d/stats3D.js +81 -0
  593. package/dist/web/world3d/webGL2FrameMetrics3D.d.ts +71 -0
  594. package/dist/web/world3d/webGL2FrameMetrics3D.js +185 -0
  595. package/dist/web/world3d/webgpu.d.ts +37 -0
  596. package/dist/web/world3d/webgpu.js +23 -0
  597. package/dist/web/world3d/webgpuPacking3D.d.ts +13 -0
  598. package/dist/web/world3d/webgpuPacking3D.js +85 -0
  599. package/dist/web/world3d/wgsl3D.d.ts +68 -0
  600. package/dist/web/world3d/wgsl3D.js +781 -0
  601. package/package.json +220 -4
@@ -0,0 +1,59 @@
1
+ import type { Disposable } from '@egret/contracts';
2
+ import type { Camera3D } from '../../rendering/world3d/Camera3D.js';
3
+ /** Fly controls to make: how fast they move and look, whether they fly, use pointer lock or damp, and their keys. */
4
+ export interface FlyControlsOptions3D {
5
+ /** Units per second. */
6
+ readonly moveSpeed?: number;
7
+ /** Multiplier while the sprint key is held. */
8
+ readonly sprintMultiplier?: number;
9
+ /** Radians per pixel of pointer movement. */
10
+ readonly lookSpeed?: number;
11
+ /** Move along the view direction and allow vertical keys; otherwise stay level. */
12
+ readonly fly?: boolean;
13
+ /** Request pointer lock on click. Without it, drag to look. */
14
+ readonly pointerLock?: boolean;
15
+ /** Fraction of velocity kept per 1/60 s; 0 stops at once. */
16
+ readonly damping?: number;
17
+ /** Key codes (KeyboardEvent.code) for each action. */
18
+ readonly keys?: Partial<FlyControlsKeys3D>;
19
+ }
20
+ /** The keys of fly controls: forward, back, left, right, up, down and sprint. */
21
+ export interface FlyControlsKeys3D {
22
+ readonly forward: readonly string[];
23
+ readonly back: readonly string[];
24
+ readonly left: readonly string[];
25
+ readonly right: readonly string[];
26
+ readonly up: readonly string[];
27
+ readonly down: readonly string[];
28
+ readonly sprint: readonly string[];
29
+ }
30
+ /** Moves a camera with the keyboard and mouse, walking or flying. */
31
+ export declare class FlyControls3D implements Disposable {
32
+ #private;
33
+ readonly camera: Camera3D;
34
+ readonly element: HTMLElement;
35
+ moveSpeed: number;
36
+ sprintMultiplier: number;
37
+ lookSpeed: number;
38
+ fly: boolean;
39
+ pointerLock: boolean;
40
+ damping: number;
41
+ enabled: boolean;
42
+ /** Heading about +Y and elevation, in radians. Write them to aim the camera. */
43
+ yaw: number;
44
+ pitch: number;
45
+ /** Current velocity in world units per second. */
46
+ readonly velocity: Float32Array<ArrayBuffer>;
47
+ constructor(camera: Camera3D, element: HTMLElement, options?: FlyControlsOptions3D);
48
+ private isLooking;
49
+ /** True while the pointer is captured for looking around. */
50
+ get isLocked(): boolean;
51
+ /** Release pointer lock, as when opening a menu. */
52
+ unlock(): void;
53
+ private pressed;
54
+ update(deltaSeconds: number): void;
55
+ dispose(): void;
56
+ }
57
+ /** Makes fly controls for a camera on an element. */
58
+ export declare function createFlyControls3D(camera: Camera3D, element: HTMLElement, options?: FlyControlsOptions3D): FlyControls3D;
59
+ //# sourceMappingURL=FlyControls3D.d.ts.map
@@ -0,0 +1,162 @@
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
+ /** Moves a camera with the keyboard and mouse, walking or flying. */
13
+ export class FlyControls3D {
14
+ camera;
15
+ element;
16
+ moveSpeed;
17
+ sprintMultiplier;
18
+ lookSpeed;
19
+ fly;
20
+ pointerLock;
21
+ damping;
22
+ enabled = true;
23
+ /** Heading about +Y and elevation, in radians. Write them to aim the camera. */
24
+ yaw = 0;
25
+ pitch = 0;
26
+ /** Current velocity in world units per second. */
27
+ velocity = new Float32Array(3);
28
+ #keys;
29
+ #down = new Set();
30
+ #listeners = [];
31
+ #dragging = false;
32
+ #disposed = false;
33
+ constructor(camera, element, options = {}) {
34
+ if (!camera || !element || typeof element.addEventListener !== 'function')
35
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'controls target');
36
+ this.camera = camera;
37
+ this.element = element;
38
+ this.moveSpeed = options.moveSpeed ?? 5;
39
+ this.sprintMultiplier = options.sprintMultiplier ?? 2.5;
40
+ this.lookSpeed = options.lookSpeed ?? 0.0025;
41
+ this.fly = options.fly ?? true;
42
+ this.pointerLock = options.pointerLock ?? true;
43
+ this.damping = options.damping ?? 0.8;
44
+ this.#keys = { ...DEFAULT_KEYS, ...options.keys };
45
+ // Start from the camera's current facing: its local -Z axis in world space.
46
+ camera.updateWorldMatrices();
47
+ const m = camera.matrixWorld, fx = -m[8], fy = -m[9], fz = -m[10], length = Math.hypot(fx, fy, fz) || 1;
48
+ this.pitch = Math.asin(Math.min(Math.max(fy / length, -1), 1));
49
+ this.yaw = Math.atan2(-fx, -fz);
50
+ const root = element.ownerDocument, listen = (target, type, listener) => {
51
+ target.addEventListener(type, listener);
52
+ this.#listeners.push([target, type, listener]);
53
+ };
54
+ listen(element, 'pointerdown', event => {
55
+ if (!this.enabled)
56
+ return;
57
+ if (this.pointerLock) {
58
+ if (root.pointerLockElement !== element)
59
+ void Promise.resolve(element.requestPointerLock?.()).catch(() => undefined);
60
+ }
61
+ else {
62
+ this.#dragging = true;
63
+ element.setPointerCapture?.(event.pointerId);
64
+ }
65
+ });
66
+ listen(element, 'pointerup', event => {
67
+ this.#dragging = false;
68
+ element.releasePointerCapture?.(event.pointerId);
69
+ });
70
+ listen(element, 'pointercancel', () => {
71
+ this.#dragging = false;
72
+ });
73
+ listen(root, 'pointermove', event => {
74
+ if (!this.enabled || !(this.pointerLock ? root.pointerLockElement === element : this.#dragging))
75
+ return;
76
+ const move = event;
77
+ this.yaw -= move.movementX * this.lookSpeed;
78
+ this.pitch = Math.min(Math.max(this.pitch - move.movementY * this.lookSpeed, -LIMIT), LIMIT);
79
+ });
80
+ const view = root.defaultView ?? globalThis;
81
+ listen(view, 'keydown', event => {
82
+ if (this.enabled && this.isLooking(root))
83
+ this.#down.add(event.code);
84
+ });
85
+ listen(view, 'keyup', event => {
86
+ this.#down.delete(event.code);
87
+ });
88
+ // Keys released while the window is unfocused never send keyup.
89
+ listen(view, 'blur', () => {
90
+ this.#down.clear();
91
+ this.#dragging = false;
92
+ });
93
+ }
94
+ isLooking(root) {
95
+ return !this.pointerLock || root.pointerLockElement === this.element;
96
+ }
97
+ /** True while the pointer is captured for looking around. */
98
+ get isLocked() {
99
+ return this.element.ownerDocument.pointerLockElement === this.element;
100
+ }
101
+ /** Release pointer lock, as when opening a menu. */
102
+ unlock() {
103
+ if (this.isLocked)
104
+ this.element.ownerDocument.exitPointerLock();
105
+ }
106
+ pressed(action) {
107
+ for (const code of action)
108
+ if (this.#down.has(code))
109
+ return true;
110
+ return false;
111
+ }
112
+ update(deltaSeconds) {
113
+ if (this.#disposed)
114
+ return;
115
+ const keys = this.#keys, dt = Math.max(deltaSeconds, 0), cosPitch = Math.cos(this.pitch), sinYaw = Math.sin(this.yaw), cosYaw = Math.cos(this.yaw);
116
+ // Forward and right in world space; walking keeps forward level.
117
+ 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;
118
+ let ahead = 0, side = 0, lift = 0;
119
+ if (this.enabled) {
120
+ ahead = (this.pressed(keys.forward) ? 1 : 0) - (this.pressed(keys.back) ? 1 : 0);
121
+ side = (this.pressed(keys.right) ? 1 : 0) - (this.pressed(keys.left) ? 1 : 0);
122
+ if (this.fly)
123
+ lift = (this.pressed(keys.up) ? 1 : 0) - (this.pressed(keys.down) ? 1 : 0);
124
+ }
125
+ let x = fx * ahead + rx * side, y = fy * ahead + lift, z = fz * ahead + rz * side;
126
+ const length = Math.hypot(x, y, z), speed = this.moveSpeed * (this.pressed(keys.sprint) ? this.sprintMultiplier : 1);
127
+ if (length > 0) {
128
+ x = (x / length) * speed;
129
+ y = (y / length) * speed;
130
+ z = (z / length) * speed;
131
+ }
132
+ // Ease toward the wanted velocity; the factor is frame-rate independent.
133
+ const keep = this.damping > 0 ? Math.pow(this.damping, dt * 60) : 0, v = this.velocity;
134
+ v[0] = x + (v[0] - x) * keep;
135
+ v[1] = y + (v[1] - y) * keep;
136
+ v[2] = z + (v[2] - z) * keep;
137
+ const camera = this.camera, p = camera.position;
138
+ camera.setPosition(p[0] + v[0] * dt, p[1] + v[1] * dt, p[2] + v[2] * dt);
139
+ // Yaw about +Y, then pitch about the camera's own X axis.
140
+ 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);
141
+ camera.quaternion[0] = cy * sp;
142
+ camera.quaternion[1] = sy * cp;
143
+ camera.quaternion[2] = -sy * sp;
144
+ camera.quaternion[3] = cy * cp;
145
+ camera.markTransformDirty();
146
+ }
147
+ dispose() {
148
+ if (this.#disposed)
149
+ return;
150
+ this.#disposed = true;
151
+ this.unlock();
152
+ for (const [target, type, listener] of this.#listeners)
153
+ target.removeEventListener(type, listener);
154
+ this.#listeners.length = 0;
155
+ this.#down.clear();
156
+ }
157
+ }
158
+ /** Makes fly controls for a camera on an element. */
159
+ export function createFlyControls3D(camera, element, options = {}) {
160
+ return new FlyControls3D(camera, element, options);
161
+ }
162
+ //# sourceMappingURL=FlyControls3D.js.map
@@ -0,0 +1,31 @@
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
+ /** Follow controls to make: how fast they turn and zoom. */
7
+ export interface FollowControlsOptions3D extends FollowCameraOptions3D {
8
+ /** Radians turned per pixel dragged. Defaults to 0.005. */
9
+ readonly rotateSpeed?: number;
10
+ /** Share of the distance changed per wheel notch. Defaults to 0.1. */
11
+ readonly zoomSpeed?: number;
12
+ }
13
+ /** Turns and zooms a follow camera with the mouse and touch. */
14
+ export declare class FollowControls3D implements Disposable {
15
+ #private;
16
+ readonly element: HTMLElement;
17
+ /** The camera rig; read `follow.yaw` or call `follow.moveDirection()` to steer a character relative to the view. */
18
+ readonly follow: FollowCamera3D;
19
+ rotateSpeed: number;
20
+ zoomSpeed: number;
21
+ enabled: boolean;
22
+ constructor(camera: Camera3D, element: HTMLElement, target: Object3D | ArrayLike<number>, options?: FollowControlsOptions3D);
23
+ /** Place the camera; call once per frame after moving the target. */
24
+ update(deltaSeconds?: number): void;
25
+ dispose(): void;
26
+ private forgetPointer;
27
+ private releaseCapture;
28
+ }
29
+ /** Makes follow controls for a follow camera on an element. */
30
+ export declare function createFollowControls3D(camera: Camera3D, element: HTMLElement, target: Object3D | ArrayLike<number>, options?: FollowControlsOptions3D): FollowControls3D;
31
+ //# sourceMappingURL=FollowControls3D.d.ts.map
@@ -0,0 +1,119 @@
1
+ import { FollowCamera3D } from '../../rendering/world3d/Character3D.js';
2
+ import { World3DError } from '../../rendering/world3d/core3D.js';
3
+ /** Turns and zooms a follow camera with the mouse and touch. */
4
+ export class FollowControls3D {
5
+ element;
6
+ /** The camera rig; read `follow.yaw` or call `follow.moveDirection()` to steer a character relative to the view. */
7
+ follow;
8
+ rotateSpeed;
9
+ zoomSpeed;
10
+ enabled = true;
11
+ #pointers = new Map();
12
+ #listeners;
13
+ #previousTouchAction;
14
+ #previousTouchActionPriority;
15
+ #pinch = 0;
16
+ #disposed = false;
17
+ constructor(camera, element, target, options = {}) {
18
+ if (!camera || !element || typeof element.addEventListener !== 'function')
19
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'controls');
20
+ this.element = element;
21
+ this.follow = new FollowCamera3D(camera, target, options);
22
+ this.rotateSpeed = options.rotateSpeed ?? 0.005;
23
+ this.zoomSpeed = options.zoomSpeed ?? 0.1;
24
+ const down = (event) => {
25
+ if (!this.enabled)
26
+ return;
27
+ this.#pointers.set(event.pointerId, { x: event.clientX, y: event.clientY });
28
+ this.element.setPointerCapture?.(event.pointerId);
29
+ this.#pinch = 0;
30
+ };
31
+ const move = (event) => {
32
+ const last = this.#pointers.get(event.pointerId);
33
+ if (!last || !this.enabled)
34
+ return;
35
+ const dx = event.clientX - last.x, dy = event.clientY - last.y;
36
+ last.x = event.clientX;
37
+ last.y = event.clientY;
38
+ if (this.#pointers.size === 1) {
39
+ this.follow.yaw -= dx * this.rotateSpeed;
40
+ this.follow.pitch += dy * this.rotateSpeed;
41
+ return;
42
+ }
43
+ // Two fingers: the change in their spread zooms.
44
+ const [a, b] = [...this.#pointers.values()], spread = Math.hypot(a.x - b.x, a.y - b.y);
45
+ if (this.#pinch > 0 && spread > 0)
46
+ this.follow.distance *= this.#pinch / spread;
47
+ this.#pinch = spread;
48
+ };
49
+ const up = (event) => {
50
+ if (this.forgetPointer(event.pointerId))
51
+ this.releaseCapture(event.pointerId);
52
+ };
53
+ const lost = (event) => {
54
+ // A descendant losing its capture does not end a capture on this element.
55
+ if (event.target === element)
56
+ this.forgetPointer(event.pointerId);
57
+ };
58
+ const wheel = (event) => {
59
+ if (!this.enabled)
60
+ return;
61
+ event.preventDefault();
62
+ this.follow.distance *= 1 + Math.sign(event.deltaY) * this.zoomSpeed;
63
+ };
64
+ this.#listeners = [
65
+ ['pointerdown', down, undefined],
66
+ ['pointermove', move, undefined],
67
+ ['pointerup', up, undefined],
68
+ ['pointercancel', up, undefined],
69
+ ['lostpointercapture', lost, undefined],
70
+ ['wheel', wheel, { passive: false }]
71
+ ];
72
+ for (const [type, listener, listenerOptions] of this.#listeners)
73
+ element.addEventListener(type, listener, listenerOptions);
74
+ // Disable native gestures while attached without losing the host's inline style.
75
+ this.#previousTouchAction = element.style.getPropertyValue('touch-action');
76
+ this.#previousTouchActionPriority = element.style.getPropertyPriority('touch-action');
77
+ if (this.#previousTouchAction !== 'none')
78
+ element.style.setProperty('touch-action', 'none', this.#previousTouchActionPriority);
79
+ }
80
+ /** Place the camera; call once per frame after moving the target. */
81
+ update(deltaSeconds = 0) {
82
+ if (!this.#disposed)
83
+ this.follow.update(deltaSeconds);
84
+ }
85
+ dispose() {
86
+ if (this.#disposed)
87
+ return;
88
+ this.#disposed = true;
89
+ const element = this.element;
90
+ for (const [type, listener, listenerOptions] of this.#listeners)
91
+ element.removeEventListener(type, listener, listenerOptions);
92
+ for (const id of this.#pointers.keys())
93
+ this.releaseCapture(id);
94
+ this.#pointers.clear();
95
+ this.#pinch = 0;
96
+ const style = element.style;
97
+ // Preserve any later inline style installed by the caller.
98
+ if (this.#previousTouchAction !== 'none' &&
99
+ style.getPropertyValue('touch-action') === 'none' &&
100
+ style.getPropertyPriority('touch-action') === this.#previousTouchActionPriority) {
101
+ style.setProperty('touch-action', this.#previousTouchAction, this.#previousTouchActionPriority);
102
+ }
103
+ }
104
+ forgetPointer(id) {
105
+ if (!this.#pointers.delete(id))
106
+ return false;
107
+ this.#pinch = 0;
108
+ return true;
109
+ }
110
+ releaseCapture(id) {
111
+ if (this.element.hasPointerCapture?.(id))
112
+ this.element.releasePointerCapture(id);
113
+ }
114
+ }
115
+ /** Makes follow controls for a follow camera on an element. */
116
+ export function createFollowControls3D(camera, element, target, options = {}) {
117
+ return new FollowControls3D(camera, element, target, options);
118
+ }
119
+ //# sourceMappingURL=FollowControls3D.js.map
@@ -0,0 +1,58 @@
1
+ import type { Disposable } from '@egret/contracts';
2
+ import type { Camera3D } from '../../rendering/world3d/Camera3D.js';
3
+ /** Orbit controls to make: their target, distances and angles, how fast they turn, pan and zoom, and which of these are on. */
4
+ export interface OrbitControlsOptions3D {
5
+ readonly target?: readonly [number, number, number];
6
+ readonly minDistance?: number;
7
+ readonly maxDistance?: number;
8
+ /** Polar angle limits in radians, measured from the +Y axis. */
9
+ readonly minPolarAngle?: number;
10
+ readonly maxPolarAngle?: number;
11
+ readonly rotateSpeed?: number;
12
+ readonly panSpeed?: number;
13
+ readonly zoomSpeed?: number;
14
+ /** Fraction of motion kept per 1/60 s; 0 disables inertia. */
15
+ readonly damping?: number;
16
+ readonly enablePan?: boolean;
17
+ readonly enableZoom?: boolean;
18
+ readonly enableRotate?: boolean;
19
+ /** Radians per second of automatic rotation about the Y axis. */
20
+ readonly autoRotateSpeed?: number;
21
+ }
22
+ /** Turns a camera around a target, pans and zooms it, with the mouse and touch. */
23
+ export declare class OrbitControls3D implements Disposable {
24
+ #private;
25
+ readonly camera: Camera3D;
26
+ readonly element: HTMLElement;
27
+ readonly target: Float32Array<ArrayBuffer>;
28
+ minDistance: number;
29
+ maxDistance: number;
30
+ minPolarAngle: number;
31
+ maxPolarAngle: number;
32
+ rotateSpeed: number;
33
+ panSpeed: number;
34
+ zoomSpeed: number;
35
+ damping: number;
36
+ enablePan: boolean;
37
+ enableZoom: boolean;
38
+ enableRotate: boolean;
39
+ autoRotateSpeed: number;
40
+ enabled: boolean;
41
+ constructor(camera: Camera3D, element: HTMLElement, options?: OrbitControlsOptions3D);
42
+ /** Recompute the orbit parameters after moving the camera or target directly. */
43
+ syncFromCamera(): void;
44
+ private readonly onContextMenu;
45
+ private readonly onPointerDown;
46
+ private readonly onPointerUp;
47
+ private pinchDistance;
48
+ private readonly onPointerMove;
49
+ private addPan;
50
+ private readonly onWheel;
51
+ /** Apply pending input and place the camera. Returns true while the view is still moving. */
52
+ update(deltaSeconds?: number): boolean;
53
+ /** Detach every listener. Idempotent. */
54
+ dispose(): void;
55
+ }
56
+ /** Makes orbit controls for a camera on an element. */
57
+ export declare function createOrbitControls3D(camera: Camera3D, element: HTMLElement, options?: OrbitControlsOptions3D): OrbitControls3D;
58
+ //# sourceMappingURL=OrbitControls3D.d.ts.map
@@ -0,0 +1,189 @@
1
+ import { World3DError } from '../../rendering/world3d/core3D.js';
2
+ const EPSILON = 1e-4;
3
+ /** Turns a camera around a target, pans and zooms it, with the mouse and touch. */
4
+ export class OrbitControls3D {
5
+ camera;
6
+ element;
7
+ target = new Float32Array(3);
8
+ minDistance;
9
+ maxDistance;
10
+ minPolarAngle;
11
+ maxPolarAngle;
12
+ rotateSpeed;
13
+ panSpeed;
14
+ zoomSpeed;
15
+ damping;
16
+ enablePan;
17
+ enableZoom;
18
+ enableRotate;
19
+ autoRotateSpeed;
20
+ enabled = true;
21
+ // Spherical position of the camera relative to the target.
22
+ #radius = 1;
23
+ #theta = 0;
24
+ #phi = Math.PI / 2;
25
+ // Pending motion, consumed (and decayed when damping) by update().
26
+ #deltaTheta = 0;
27
+ #deltaPhi = 0;
28
+ #zoom = 1;
29
+ #pan = new Float32Array(3);
30
+ #pointers = new Map();
31
+ #pinch = 0;
32
+ #disposed = false;
33
+ #listeners;
34
+ constructor(camera, element, options = {}) {
35
+ if (!camera || !element || typeof element.addEventListener !== 'function')
36
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'controls');
37
+ this.camera = camera;
38
+ this.element = element;
39
+ if (options.target)
40
+ this.target.set(options.target);
41
+ this.minDistance = options.minDistance ?? 0.01;
42
+ this.maxDistance = options.maxDistance ?? Infinity;
43
+ this.minPolarAngle = options.minPolarAngle ?? 0;
44
+ this.maxPolarAngle = options.maxPolarAngle ?? Math.PI;
45
+ this.rotateSpeed = options.rotateSpeed ?? 1;
46
+ this.panSpeed = options.panSpeed ?? 1;
47
+ this.zoomSpeed = options.zoomSpeed ?? 1;
48
+ this.damping = options.damping ?? 0.85;
49
+ this.enablePan = options.enablePan ?? true;
50
+ this.enableZoom = options.enableZoom ?? true;
51
+ this.enableRotate = options.enableRotate ?? true;
52
+ this.autoRotateSpeed = options.autoRotateSpeed ?? 0;
53
+ this.syncFromCamera();
54
+ this.#listeners = [
55
+ ['pointerdown', this.onPointerDown, undefined],
56
+ ['pointermove', this.onPointerMove, undefined],
57
+ ['pointerup', this.onPointerUp, undefined],
58
+ ['pointercancel', this.onPointerUp, undefined],
59
+ ['wheel', this.onWheel, { passive: false }],
60
+ ['contextmenu', this.onContextMenu, undefined]
61
+ ];
62
+ for (const [type, listener, listenerOptions] of this.#listeners)
63
+ element.addEventListener(type, listener, listenerOptions);
64
+ // Stop the browser from scrolling or zooming the page during a drag.
65
+ element.style.touchAction = 'none';
66
+ }
67
+ /** Recompute the orbit parameters after moving the camera or target directly. */
68
+ syncFromCamera() {
69
+ const p = this.camera.position, x = p[0] - this.target[0], y = p[1] - this.target[1], z = p[2] - this.target[2];
70
+ this.#radius = Math.max(Math.hypot(x, y, z), EPSILON);
71
+ this.#theta = Math.atan2(x, z);
72
+ this.#phi = Math.acos(Math.min(Math.max(y / this.#radius, -1), 1));
73
+ }
74
+ onContextMenu = (event) => {
75
+ if (this.enabled)
76
+ event.preventDefault();
77
+ };
78
+ onPointerDown = (event) => {
79
+ if (!this.enabled)
80
+ return;
81
+ this.element.setPointerCapture?.(event.pointerId);
82
+ this.#pointers.set(event.pointerId, { x: event.clientX, y: event.clientY });
83
+ this.#pinch = this.pinchDistance();
84
+ };
85
+ onPointerUp = (event) => {
86
+ this.#pointers.delete(event.pointerId);
87
+ this.element.releasePointerCapture?.(event.pointerId);
88
+ this.#pinch = this.pinchDistance();
89
+ };
90
+ pinchDistance() {
91
+ if (this.#pointers.size !== 2)
92
+ return 0;
93
+ const [a, b] = [...this.#pointers.values()];
94
+ return Math.hypot(a.x - b.x, a.y - b.y);
95
+ }
96
+ onPointerMove = (event) => {
97
+ const previous = this.#pointers.get(event.pointerId);
98
+ if (!this.enabled || !previous)
99
+ return;
100
+ const dx = event.clientX - previous.x, dy = event.clientY - previous.y;
101
+ previous.x = event.clientX;
102
+ previous.y = event.clientY;
103
+ const height = Math.max(this.element.clientHeight, 1);
104
+ if (this.#pointers.size === 2) {
105
+ // Two contacts: each moves the view by half its motion, and their spacing zooms.
106
+ if (this.enablePan)
107
+ this.addPan(dx * 0.5, dy * 0.5, height);
108
+ const distance = this.pinchDistance();
109
+ if (this.enableZoom && this.#pinch > 0 && distance > 0)
110
+ this.#zoom *= this.#pinch / distance;
111
+ this.#pinch = distance;
112
+ return;
113
+ }
114
+ const panning = (event.pointerType === 'mouse' && (event.buttons & 2) !== 0) || event.shiftKey;
115
+ if (panning) {
116
+ if (this.enablePan)
117
+ this.addPan(dx, dy, height);
118
+ return;
119
+ }
120
+ if (!this.enableRotate)
121
+ return;
122
+ // A drag across the element height turns the view by half a revolution.
123
+ this.#deltaTheta -= (dx / height) * Math.PI * this.rotateSpeed;
124
+ this.#deltaPhi -= (dy / height) * Math.PI * this.rotateSpeed;
125
+ };
126
+ addPan(dx, dy, height) {
127
+ const camera = this.camera, m = camera.matrixWorld;
128
+ // World units per pixel at the target's depth.
129
+ const span = camera.projectionKind === 'perspective'
130
+ ? (2 * this.#radius * Math.tan((camera.fov * Math.PI) / 360)) / camera.zoom
131
+ : camera.orthographicHeight / camera.zoom;
132
+ const scale = (span / height) * this.panSpeed;
133
+ for (let i = 0; i < 3; i++)
134
+ this.#pan[i] += (-dx * m[i] + dy * m[4 + i]) * scale;
135
+ }
136
+ onWheel = (event) => {
137
+ if (!this.enabled || !this.enableZoom)
138
+ return;
139
+ event.preventDefault();
140
+ const lines = event.deltaMode === 1 ? event.deltaY * 16 : event.deltaY;
141
+ this.#zoom *= Math.pow(1.001, lines * this.zoomSpeed);
142
+ };
143
+ /** Apply pending input and place the camera. Returns true while the view is still moving. */
144
+ update(deltaSeconds = 1 / 60) {
145
+ if (this.#disposed)
146
+ return false;
147
+ const dt = Math.min(Math.max(deltaSeconds, 0), 0.1);
148
+ if (this.autoRotateSpeed !== 0 && this.#pointers.size === 0)
149
+ this.#theta += this.autoRotateSpeed * dt;
150
+ this.#theta += this.#deltaTheta;
151
+ this.#phi = Math.min(Math.max(this.#phi + this.#deltaPhi, Math.max(this.minPolarAngle, EPSILON)), Math.min(this.maxPolarAngle, Math.PI - EPSILON));
152
+ if (this.camera.projectionKind === 'orthographic')
153
+ this.camera.zoom = Math.max(this.camera.zoom / this.#zoom, EPSILON);
154
+ else
155
+ this.#radius = Math.min(Math.max(this.#radius * this.#zoom, this.minDistance), this.maxDistance);
156
+ for (let i = 0; i < 3; i++)
157
+ this.target[i] += this.#pan[i];
158
+ const moving = Math.abs(this.#deltaTheta) +
159
+ Math.abs(this.#deltaPhi) +
160
+ Math.abs(this.#zoom - 1) +
161
+ Math.hypot(this.#pan[0], this.#pan[1], this.#pan[2]) >
162
+ 1e-6;
163
+ // Frame-rate independent decay of the remaining motion.
164
+ const keep = this.damping > 0 ? Math.pow(Math.min(this.damping, 0.999), dt * 60) : 0;
165
+ this.#deltaTheta *= keep;
166
+ this.#deltaPhi *= keep;
167
+ this.#zoom = 1 + (this.#zoom - 1) * keep;
168
+ for (let i = 0; i < 3; i++)
169
+ this.#pan[i] *= keep;
170
+ const sinPhi = Math.sin(this.#phi), r = this.#radius;
171
+ 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));
172
+ this.camera.lookAt(this.target[0], this.target[1], this.target[2]);
173
+ return moving || this.autoRotateSpeed !== 0;
174
+ }
175
+ /** Detach every listener. Idempotent. */
176
+ dispose() {
177
+ if (this.#disposed)
178
+ return;
179
+ this.#disposed = true;
180
+ for (const [type, listener, listenerOptions] of this.#listeners)
181
+ this.element.removeEventListener(type, listener, listenerOptions);
182
+ this.#pointers.clear();
183
+ }
184
+ }
185
+ /** Makes orbit controls for a camera on an element. */
186
+ export function createOrbitControls3D(camera, element, options = {}) {
187
+ return new OrbitControls3D(camera, element, options);
188
+ }
189
+ //# sourceMappingURL=OrbitControls3D.js.map
@@ -0,0 +1,37 @@
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
+ /** Drags a transform gizmo with the mouse and touch to move, turn or scale an object. */
7
+ export declare class TransformControls3D implements Disposable {
8
+ #private;
9
+ readonly camera: Camera3D;
10
+ readonly element: HTMLElement;
11
+ /** The handles; add this to the scene that holds the edited object. */
12
+ readonly gizmo: TransformGizmo3D;
13
+ /**
14
+ * A press that lands on a handle is kept from orbit, fly and follow controls
15
+ * on the same element, made before or after these: the handles listen in the
16
+ * capture phase, which runs first. A press anywhere else reaches them.
17
+ */
18
+ constructor(camera: Camera3D, element: HTMLElement, options?: TransformGizmoOptions3D);
19
+ get mode(): GizmoMode3D;
20
+ set mode(value: GizmoMode3D);
21
+ get space(): GizmoSpace3D;
22
+ set space(value: GizmoSpace3D);
23
+ get enabled(): boolean;
24
+ set enabled(value: boolean);
25
+ get dragging(): boolean;
26
+ get object(): Object3D | undefined;
27
+ attach(object: Object3D): this;
28
+ detach(): this;
29
+ /** Turn a pointer position into a world-space ray; false when the element has no size. */
30
+ private ray;
31
+ /** Keep the handles on the object and at a steady size; call once per frame. */
32
+ update(): void;
33
+ dispose(): void;
34
+ }
35
+ /** Makes transform controls for a camera on an element. */
36
+ export declare function createTransformControls3D(camera: Camera3D, element: HTMLElement, options?: TransformGizmoOptions3D): TransformControls3D;
37
+ //# sourceMappingURL=TransformControls3D.d.ts.map