@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,303 @@
1
+ import { World3DError, requireFinite3D } from './core3D.js';
2
+ import { CharacterController3D } from './Physics3D.js';
3
+ /**
4
+ * A walking, jumping character. Each frame, after `world.step()`, call
5
+ * `update(deltaSeconds, wishX, wishZ, jump)` with the horizontal velocity the
6
+ * player asks for. The motor owns the capsule in `controller`.
7
+ */
8
+ export class CharacterMotor3D {
9
+ controller;
10
+ world;
11
+ /** Current velocity relative to whatever the character stands on. */
12
+ velocity = new Float64Array(3);
13
+ jumpSpeed;
14
+ gravity;
15
+ stepHeight;
16
+ acceleration;
17
+ airControl;
18
+ coyoteTime;
19
+ pushForce;
20
+ maxFallSpeed;
21
+ /** Turn, in radians about +Y, that the ground gave the character during the last update. Add it to the character's facing. */
22
+ carriedYaw = 0;
23
+ /** True on the update in which a jump started. */
24
+ jumped = false;
25
+ #airTime = Infinity;
26
+ #wasGrounded = false;
27
+ #platform;
28
+ #pushScale = 0;
29
+ #supported = false;
30
+ #ground;
31
+ #carry = new Float64Array(3);
32
+ constructor(world, options = {}) {
33
+ this.world = world;
34
+ this.controller = new CharacterController3D(world, options);
35
+ this.jumpSpeed = options.jumpSpeed ?? 5;
36
+ this.gravity = options.gravity ?? Math.hypot(world.gravity[0], world.gravity[1], world.gravity[2]);
37
+ this.stepHeight = options.stepHeight ?? 0.3;
38
+ this.acceleration = options.acceleration ?? 60;
39
+ this.airControl = options.airControl ?? 0.3;
40
+ this.coyoteTime = options.coyoteTime ?? 0.1;
41
+ this.pushForce = options.pushForce ?? 40;
42
+ this.maxFallSpeed = options.maxFallSpeed ?? 50;
43
+ // Walking into something loose shoves it, in proportion to the time spent pushing.
44
+ this.controller.onContact = (body, nx, ny, nz) => {
45
+ if (ny < -0.2)
46
+ this.#supported = true;
47
+ if (this.#pushScale <= 0 || body.type !== 'dynamic' || Math.abs(ny) > 0.5)
48
+ return;
49
+ // Push no harder than needed to move the body at the character's own pace.
50
+ const size = Math.sqrt(nx * nx + nz * nz) || 1, x = nx / size, z = nz / size, v = this.velocity, carry = this.#carry;
51
+ const closing = (v[0] + carry[0] - body.linearVelocity[0]) * x + (v[2] + carry[2] - body.linearVelocity[2]) * z;
52
+ const impulse = Math.min(this.pushForce * this.#pushScale, closing * body.mass);
53
+ if (impulse > 0)
54
+ body.applyImpulse(x * impulse, 0, z * impulse);
55
+ };
56
+ // Find the ground the character starts on.
57
+ this.#wasGrounded = this.settle(0, 0, 0);
58
+ this.#platform = this.#ground;
59
+ }
60
+ get position() {
61
+ return this.controller.position;
62
+ }
63
+ /** True when the character stands on walkable ground, including the edge of a step. */
64
+ get isGrounded() {
65
+ return this.#wasGrounded;
66
+ }
67
+ get groundBody() {
68
+ return this.#platform;
69
+ }
70
+ /**
71
+ * Move the capsule and report whether it ends up standing. The capsule's
72
+ * own test needs a walkable contact; perched on the lip of a step its round
73
+ * foot touches at a slant, so there the surface straight below decides.
74
+ */
75
+ settle(dx, dy, dz) {
76
+ const c = this.controller;
77
+ this.#supported = false;
78
+ c.move(dx, dy, dz);
79
+ this.#ground = c.groundBody;
80
+ if (c.isGrounded)
81
+ return true;
82
+ if (!this.#supported)
83
+ return false;
84
+ const hit = this.world.raycast(c.position, [0, -1, 0], c.height / 2 + this.stepHeight + 0.05, c.mask);
85
+ if (!hit || hit.normal[1] < Math.cos(c.slopeLimit))
86
+ return false;
87
+ this.#ground = hit.body;
88
+ return true;
89
+ }
90
+ /** Place the character somewhere else and forget its motion. Invalid coordinates leave the motor unchanged. */
91
+ teleport(x, y, z) {
92
+ this.controller.position.set([requireFinite3D(x, 'x'), requireFinite3D(y, 'y'), requireFinite3D(z, 'z')]);
93
+ this.velocity.fill(0);
94
+ this.#airTime = Infinity;
95
+ this.#wasGrounded = this.settle(0, 0, 0);
96
+ this.#platform = this.#ground;
97
+ }
98
+ /**
99
+ * Advance the character. `wishX` and `wishZ` are the horizontal velocity
100
+ * the player asks for in world units per second; `jump` asks for a jump
101
+ * this frame.
102
+ */
103
+ update(deltaSeconds, wishX, wishZ, jump = false) {
104
+ const dt = requireFinite3D(deltaSeconds, 'deltaSeconds'), c = this.controller, v = this.velocity, p = c.position;
105
+ requireFinite3D(wishX + wishZ, 'wish velocity');
106
+ this.carriedYaw = 0;
107
+ this.jumped = false;
108
+ if (!(dt > 0))
109
+ return;
110
+ // 1. Ride the ground: a moving or turning body under the feet carries the character along.
111
+ const platform = this.#wasGrounded ? this.#platform : undefined, carry = this.#carry;
112
+ carry.fill(0);
113
+ this.#pushScale = 0;
114
+ if (platform && platform.type !== 'static' && platform.world === this.world) {
115
+ const w = platform.angularVelocity, rx = p[0] - platform.position[0], ry = p[1] - platform.position[1], rz = p[2] - platform.position[2];
116
+ carry[0] = platform.linearVelocity[0] + w[1] * rz - w[2] * ry;
117
+ carry[1] = platform.linearVelocity[1] + w[2] * rx - w[0] * rz;
118
+ carry[2] = platform.linearVelocity[2] + w[0] * ry - w[1] * rx;
119
+ this.carriedYaw = w[1] * dt;
120
+ c.move(carry[0] * dt, carry[1] * dt, carry[2] * dt);
121
+ }
122
+ // 2. Vertical motion: stand, jump or fall.
123
+ const grounded = this.#wasGrounded;
124
+ this.#airTime = grounded ? 0 : this.#airTime + dt;
125
+ if (grounded && v[1] < 0)
126
+ v[1] = 0;
127
+ if (jump && this.#airTime <= this.coyoteTime) {
128
+ v[1] = this.jumpSpeed;
129
+ this.#airTime = Infinity;
130
+ this.jumped = true;
131
+ // Leaving a moving platform keeps its speed, like stepping off a moving walkway.
132
+ v[0] += carry[0];
133
+ v[2] += carry[2];
134
+ v[1] += Math.max(carry[1], 0);
135
+ }
136
+ else if (!grounded)
137
+ v[1] = Math.max(v[1] - this.gravity * dt, -this.maxFallSpeed);
138
+ // 3. Horizontal motion: head toward the wished velocity, quickly on the ground and weakly in the air.
139
+ const rate = this.acceleration * (grounded && !this.jumped ? 1 : this.airControl) * dt, ax = wishX - v[0], az = wishZ - v[2], gap = Math.sqrt(ax * ax + az * az);
140
+ if (gap <= rate || !(rate < Infinity)) {
141
+ v[0] = wishX;
142
+ v[2] = wishZ;
143
+ }
144
+ else {
145
+ v[0] += (ax / gap) * rate;
146
+ v[2] += (az / gap) * rate;
147
+ }
148
+ // 4. Move, climbing a step when a low ledge blocks the way.
149
+ const dx = v[0] * dt, dz = v[2] * dt, dy = v[1] * dt, wanted = Math.sqrt(dx * dx + dz * dz);
150
+ const startX = p[0], startY = p[1], startZ = p[2];
151
+ this.#pushScale = dt;
152
+ let standing = this.settle(dx, dy, dz), ground = this.#ground, ceiling = c.hitCeiling;
153
+ this.#pushScale = 0;
154
+ if (grounded && !this.jumped && this.stepHeight > 0 && wanted > 1e-6) {
155
+ const made = ((p[0] - startX) * dx) / wanted + ((p[2] - startZ) * dz) / wanted;
156
+ if (made < wanted * 0.75) {
157
+ const plainX = p[0], plainY = p[1], plainZ = p[2];
158
+ p[0] = startX;
159
+ p[1] = startY;
160
+ p[2] = startZ;
161
+ c.move(0, this.stepHeight, 0);
162
+ const lifted = p[1] - startY;
163
+ c.move(dx, 0, dz);
164
+ const landed = this.settle(0, -lifted - this.stepHeight, 0), stepped = ((p[0] - startX) * dx) / wanted + ((p[2] - startZ) * dz) / wanted;
165
+ // Keep the climb only when it ends standing, got farther, and did not vault higher than a step.
166
+ if (landed && stepped > made + 1e-4 && p[1] - startY <= this.stepHeight + c.skin * 4) {
167
+ standing = true;
168
+ ground = this.#ground;
169
+ ceiling = false;
170
+ }
171
+ else {
172
+ p[0] = plainX;
173
+ p[1] = plainY;
174
+ p[2] = plainZ;
175
+ c.move(0, 0, 0);
176
+ }
177
+ }
178
+ }
179
+ // 5. Stay on the ground when walking down steps and slopes instead of hopping off them.
180
+ if (grounded && !this.jumped && !standing && v[1] <= 0 && this.stepHeight > 0) {
181
+ const x = p[0], y = p[1], z = p[2];
182
+ if (this.settle(0, -this.stepHeight, 0)) {
183
+ standing = true;
184
+ ground = this.#ground;
185
+ }
186
+ else {
187
+ p[0] = x;
188
+ p[1] = y;
189
+ p[2] = z;
190
+ c.move(0, 0, 0);
191
+ }
192
+ }
193
+ if (ceiling && v[1] > 0)
194
+ v[1] = 0;
195
+ // Walking off a moving platform keeps its speed too.
196
+ if (grounded && !standing && !this.jumped) {
197
+ v[0] += carry[0];
198
+ v[2] += carry[2];
199
+ }
200
+ // Landing on a moving platform: only the motion relative to it remains.
201
+ if (!grounded && standing && ground && ground.type !== 'static') {
202
+ v[0] -= ground.linearVelocity[0];
203
+ v[2] -= ground.linearVelocity[2];
204
+ }
205
+ this.#wasGrounded = standing;
206
+ this.#platform = ground;
207
+ }
208
+ }
209
+ /**
210
+ * Third-person camera: orbits a target at a distance, and moves closer when
211
+ * a wall would hide the target, easing back out afterwards. Set `yaw`,
212
+ * `pitch` and `distance` from input, then call `update()` each frame after
213
+ * the target has moved. The camera must not sit under a transformed parent.
214
+ */
215
+ export class FollowCamera3D {
216
+ camera;
217
+ /** Followed object, or a fixed world position. */
218
+ target;
219
+ yaw;
220
+ pitch;
221
+ distance;
222
+ minDistance;
223
+ maxDistance;
224
+ minPitch;
225
+ maxPitch;
226
+ height;
227
+ world;
228
+ mask;
229
+ margin;
230
+ recovery;
231
+ /** Distance actually used on the last update, after obstacles. */
232
+ currentDistance;
233
+ #pivot = new Float32Array(3);
234
+ constructor(camera, target, options = {}) {
235
+ if (!camera || !target)
236
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'follow camera');
237
+ this.camera = camera;
238
+ this.target = target;
239
+ this.distance = options.distance ?? 6;
240
+ this.minDistance = options.minDistance ?? 1;
241
+ this.maxDistance = options.maxDistance ?? 30;
242
+ this.height = options.height ?? 1.4;
243
+ this.yaw = options.yaw ?? 0;
244
+ this.pitch = options.pitch ?? 0.35;
245
+ this.minPitch = options.minPitch ?? -0.3;
246
+ this.maxPitch = options.maxPitch ?? 1.4;
247
+ this.world = options.world;
248
+ this.mask = options.mask ?? -1;
249
+ this.margin = options.margin ?? 0.25;
250
+ this.recovery = options.recovery ?? 0.25;
251
+ this.currentDistance = this.distance;
252
+ }
253
+ /**
254
+ * Turn a "forward" and "right" input into a world-space direction on the
255
+ * ground, relative to where the camera looks: (1, 0) walks away from the camera.
256
+ */
257
+ moveDirection(forward, right, out = [0, 0, 0]) {
258
+ const s = Math.sin(this.yaw), c = Math.cos(this.yaw);
259
+ out[0] = -s * forward + c * right;
260
+ out[1] = 0;
261
+ out[2] = -c * forward - s * right;
262
+ return out;
263
+ }
264
+ /** Place the camera for the current target, angles and distance. */
265
+ update(deltaSeconds = 0) {
266
+ const target = this.target, pivot = this.#pivot;
267
+ if ('getWorldPosition' in target) {
268
+ target.updateWorldMatrix();
269
+ target.getWorldPosition(pivot);
270
+ }
271
+ else {
272
+ pivot[0] = target[0];
273
+ pivot[1] = target[1];
274
+ pivot[2] = target[2];
275
+ }
276
+ pivot[1] += this.height;
277
+ this.pitch = Math.min(Math.max(this.pitch, this.minPitch), this.maxPitch);
278
+ this.distance = Math.min(Math.max(this.distance, this.minDistance), this.maxDistance);
279
+ // Direction from the pivot back to the camera.
280
+ const cp = Math.cos(this.pitch), bx = Math.sin(this.yaw) * cp, by = Math.sin(this.pitch), bz = Math.cos(this.yaw) * cp;
281
+ let allowed = this.distance;
282
+ if (this.world) {
283
+ const hit = this.world.raycast(pivot, [bx, by, bz], this.distance + this.margin, this.mask);
284
+ if (hit)
285
+ allowed = Math.max(hit.distance - this.margin, Math.min(this.minDistance, hit.distance * 0.5));
286
+ }
287
+ // Move in at once so the target is never hidden; move back out gradually.
288
+ if (allowed <= this.currentDistance || !(this.recovery > 0) || !(deltaSeconds > 0))
289
+ this.currentDistance = allowed;
290
+ else
291
+ this.currentDistance += (allowed - this.currentDistance) * Math.min((deltaSeconds / this.recovery) * 3, 1);
292
+ const d = this.currentDistance, camera = this.camera;
293
+ camera.setPosition(pivot[0] + bx * d, pivot[1] + by * d, pivot[2] + bz * d);
294
+ camera.lookAt(pivot[0], pivot[1], pivot[2]);
295
+ }
296
+ }
297
+ export function createCharacterMotor3D(world, options = {}) {
298
+ return new CharacterMotor3D(world, options);
299
+ }
300
+ export function createFollowCamera3D(camera, target, options = {}) {
301
+ return new FollowCamera3D(camera, target, options);
302
+ }
303
+ //# sourceMappingURL=Character3D.js.map
@@ -0,0 +1,115 @@
1
+ import type { Material3D } from './Material3D.js';
2
+ import { Mesh3D } from './Mesh3D.js';
3
+ import type { RigidBody3D } from './Physics3D.js';
4
+ export declare const CLOTH3D_LIMITS: Readonly<{
5
+ readonly maxPoints: 16384;
6
+ readonly maxColliders: 32;
7
+ }>;
8
+ export interface StrandOptions3D {
9
+ /** Pull on every point, as an acceleration. Defaults to 9.81 downward. */
10
+ readonly gravity?: readonly [number, number, number];
11
+ /** Share of a point's speed lost per second to the air. Defaults to 0.6. */
12
+ readonly damping?: number;
13
+ /** Passes over the links per update; more keeps them closer to their lengths. Defaults to 8. */
14
+ readonly iterations?: number;
15
+ /** Distance kept between a point and a collider's surface. */
16
+ readonly thickness?: number;
17
+ /** Spheres, capsules, boxes and planes the points stay out of. Other shapes are ignored. */
18
+ readonly colliders?: readonly RigidBody3D[];
19
+ /** Share of a point's sliding speed lost where it touches a collider. Defaults to 0.3. */
20
+ readonly friction?: number;
21
+ }
22
+ /** Points and links shared by ropes and cloth. */
23
+ declare class Strands3D {
24
+ #private;
25
+ /** World positions, three numbers per point. Read them freely; write through setPoint(). */
26
+ readonly points: Float32Array;
27
+ readonly gravity: Float32Array<ArrayBuffer>;
28
+ /** A steady push on every free point, as an acceleration: wind. */
29
+ readonly wind: Float32Array<ArrayBuffer>;
30
+ damping: number;
31
+ iterations: number;
32
+ thickness: number;
33
+ friction: number;
34
+ readonly colliders: RigidBody3D[];
35
+ constructor(count: number, options: StrandOptions3D);
36
+ get pointCount(): number;
37
+ get linkCount(): number;
38
+ /** @internal Place a point and forget its motion. */
39
+ protected place(index: number, x: number, y: number, z: number): void;
40
+ /** @internal Join two points at the distance they are apart now. */
41
+ protected link(a: number, b: number): void;
42
+ private check;
43
+ /** Move a point and stop it; a pinned point is held at the new place. */
44
+ setPoint(index: number, x: number, y: number, z: number): void;
45
+ /**
46
+ * Hold a point where it is now. With a body, the point keeps its place on
47
+ * that body and follows it as the body moves and turns.
48
+ */
49
+ pinPoint(index: number, body?: RigidBody3D): void;
50
+ unpinPoint(index: number): void;
51
+ isPinned(index: number): boolean;
52
+ /** @internal Advance the points by one update. */
53
+ protected advance(deltaSeconds: number): void;
54
+ private collide;
55
+ }
56
+ export interface RopeOptions3D extends StrandOptions3D {
57
+ readonly start: readonly [number, number, number];
58
+ readonly end: readonly [number, number, number];
59
+ /** Number of links. Defaults to 16. */
60
+ readonly segments?: number;
61
+ /** Extra length as a share of the straight distance, so the rope hangs in a curve. Defaults to 0. */
62
+ readonly slack?: number;
63
+ /** Hold the first or the last point in place, or on a body. Both ends are free unless pinned. */
64
+ readonly pinStart?: boolean | RigidBody3D;
65
+ readonly pinEnd?: boolean | RigidBody3D;
66
+ }
67
+ /** A rope or cable. Call update() once per frame, after the bodies it is pinned to have moved. */
68
+ export declare class Rope3D extends Strands3D {
69
+ #private;
70
+ readonly segments: number;
71
+ /** Total length along the links at rest. */
72
+ readonly length: number;
73
+ constructor(options: RopeOptions3D);
74
+ /**
75
+ * A tube along the rope, rebuilt by update(). `radius` is its thickness and
76
+ * `sides` the number of faces around it.
77
+ */
78
+ createMesh(material: Material3D, radius?: number, sides?: number): Mesh3D;
79
+ get mesh(): Mesh3D | undefined;
80
+ update(deltaSeconds: number): void;
81
+ private rebuild;
82
+ }
83
+ export interface ClothOptions3D extends StrandOptions3D {
84
+ /** Number of points across and down; at least two each. */
85
+ readonly columns: number;
86
+ readonly rows: number;
87
+ /** World position of the first point of the first row. */
88
+ readonly origin: readonly [number, number, number];
89
+ /** Vectors along a full row and down a full column. */
90
+ readonly right: readonly [number, number, number];
91
+ readonly down: readonly [number, number, number];
92
+ /** Add links that skip a point, which makes the cloth resist folding. Defaults to true. */
93
+ readonly stiff?: boolean;
94
+ }
95
+ /** A rectangular sheet. Call update() once per frame, after the bodies it is pinned to have moved. */
96
+ export declare class Cloth3D extends Strands3D {
97
+ #private;
98
+ readonly columns: number;
99
+ readonly rows: number;
100
+ constructor(options: ClothOptions3D);
101
+ /** Index of the point at a column and row. */
102
+ indexOf(column: number, row: number): number;
103
+ /** Hold the point at a column and row where it is, or on a body. */
104
+ pin(column: number, row: number, body?: RigidBody3D): void;
105
+ unpin(column: number, row: number): void;
106
+ /** A mesh of the sheet, rebuilt by update(). Draw it with a double-sided material to see both faces. */
107
+ createMesh(material: Material3D): Mesh3D;
108
+ get mesh(): Mesh3D | undefined;
109
+ update(deltaSeconds: number): void;
110
+ private rebuild;
111
+ }
112
+ export declare function createRope3D(options: RopeOptions3D): Rope3D;
113
+ export declare function createCloth3D(options: ClothOptions3D): Cloth3D;
114
+ export {};
115
+ //# sourceMappingURL=Cloth3D.d.ts.map