@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,329 @@
1
+ import { World3DError, requireFinite3D } from './core3D.js';
2
+ import { Attribute3D, Geometry3D } from './Geometry3D.js';
3
+ import { Material3D } from './Material3D.js';
4
+ import { mat3NormalFromMat4, mat4Identity } from './math3D.js';
5
+ import { Mesh3D } from './Mesh3D.js';
6
+ export const BATCH3D_LIMITS = Object.freeze({ maxItems: 65536, maxVertices: 4194304, maxLinePoints: 65536 });
7
+ const IDENTITY = mat4Identity(new Float32Array(16));
8
+ /**
9
+ * Many geometries drawn as one mesh with one material and one draw call.
10
+ * Each added geometry keeps its own transform, visibility and tint, which
11
+ * can change afterwards; the combined buffers are rebuilt only when something
12
+ * did. Best for props that move rarely, since a change rewrites the batch.
13
+ */
14
+ export class BatchedMesh3D extends Mesh3D {
15
+ #items = [];
16
+ #normalMatrix = new Float32Array(9);
17
+ #dirty = false;
18
+ #useColors = false;
19
+ constructor(material) {
20
+ const geometry = new Geometry3D();
21
+ geometry.setAttribute('position', new Attribute3D(new Float32Array(9), 3));
22
+ super(geometry, material);
23
+ this.name = 'batch';
24
+ }
25
+ /** Number of geometries added and not deleted. */
26
+ get itemCount() {
27
+ let count = 0;
28
+ for (const item of this.#items)
29
+ if (item)
30
+ count++;
31
+ return count;
32
+ }
33
+ /** Add a triangle geometry and return its id within this batch. The geometry itself is copied. */
34
+ addGeometry(geometry, matrix = IDENTITY) {
35
+ if (!(geometry instanceof Geometry3D) || geometry.topology !== 'triangles')
36
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'batch geometry');
37
+ const position = geometry.getAttribute('position'), normal = geometry.getAttribute('normal'), uv = geometry.getAttribute('uv');
38
+ if (!position || !normal)
39
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'batch geometry needs positions and normals');
40
+ if (this.#items.length >= BATCH3D_LIMITS.maxItems)
41
+ throw new World3DError('WORLD3D_BUDGET', 'batch items');
42
+ const count = position.count, indices = geometry.index
43
+ ? Uint32Array.from(geometry.index.data)
44
+ : Uint32Array.from({ length: count }, (_, i) => i);
45
+ this.#items.push({
46
+ positions: Float32Array.from(position.data),
47
+ normals: Float32Array.from(normal.data),
48
+ uvs: uv ? Float32Array.from(uv.data) : undefined,
49
+ indices,
50
+ matrix: this.checkedMatrix(matrix),
51
+ visible: true,
52
+ color: undefined
53
+ });
54
+ this.#dirty = true;
55
+ return this.#items.length - 1;
56
+ }
57
+ checkedMatrix(matrix) {
58
+ if (!matrix || matrix.length !== 16)
59
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'batch matrix');
60
+ const out = new Float32Array(16);
61
+ for (let i = 0; i < 16; i++)
62
+ out[i] = requireFinite3D(matrix[i], 'batch matrix');
63
+ return out;
64
+ }
65
+ item(id) {
66
+ const item = this.#items[id];
67
+ if (!item)
68
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'batch id');
69
+ return item;
70
+ }
71
+ setMatrixAt(id, matrix) {
72
+ this.item(id).matrix = this.checkedMatrix(matrix);
73
+ this.#dirty = true;
74
+ return this;
75
+ }
76
+ getMatrixAt(id, out = new Float32Array(16)) {
77
+ out.set(this.item(id).matrix);
78
+ return out;
79
+ }
80
+ setVisibleAt(id, visible) {
81
+ const item = this.item(id);
82
+ if (item.visible !== visible) {
83
+ item.visible = visible;
84
+ this.#dirty = true;
85
+ }
86
+ return this;
87
+ }
88
+ getVisibleAt(id) {
89
+ return this.item(id).visible;
90
+ }
91
+ /** Tint one item through vertex colors; the material needs `vertexColors` enabled. */
92
+ setColorAt(id, r, g, b) {
93
+ this.item(id).color = new Float32Array([r, g, b]);
94
+ this.#useColors = true;
95
+ this.#dirty = true;
96
+ return this;
97
+ }
98
+ /** Remove an item. Its id is not reused. */
99
+ deleteGeometry(id) {
100
+ this.item(id);
101
+ this.#items[id] = undefined;
102
+ this.#dirty = true;
103
+ return this;
104
+ }
105
+ /** Rebuild the combined buffers now instead of at the next frame. */
106
+ flush() {
107
+ if (!this.#dirty)
108
+ return;
109
+ this.#dirty = false;
110
+ let vertexTotal = 0, indexTotal = 0, anyUv = false;
111
+ for (const item of this.#items) {
112
+ if (!item || !item.visible)
113
+ continue;
114
+ vertexTotal += item.positions.length / 3;
115
+ indexTotal += item.indices.length;
116
+ if (item.uvs)
117
+ anyUv = true;
118
+ }
119
+ if (vertexTotal > BATCH3D_LIMITS.maxVertices)
120
+ throw new World3DError('WORLD3D_BUDGET', 'batch vertices');
121
+ const geometry = this.geometry;
122
+ // An empty batch keeps one degenerate triangle so the geometry stays valid; it draws nothing.
123
+ const positions = new Float32Array(Math.max(vertexTotal, 3) * 3), normals = new Float32Array(Math.max(vertexTotal, 3) * 3);
124
+ const uvs = anyUv ? new Float32Array(Math.max(vertexTotal, 3) * 2) : undefined, colors = this.#useColors ? new Float32Array(Math.max(vertexTotal, 3) * 3).fill(1) : undefined;
125
+ const indices = new Uint32Array(indexTotal);
126
+ let vertex = 0, index = 0;
127
+ for (const item of this.#items) {
128
+ if (!item || !item.visible)
129
+ continue;
130
+ const m = item.matrix, n = mat3NormalFromMat4(this.#normalMatrix, m), count = item.positions.length / 3;
131
+ for (let i = 0; i < count; i++) {
132
+ const x = item.positions[i * 3], y = item.positions[i * 3 + 1], z = item.positions[i * 3 + 2], o = (vertex + i) * 3;
133
+ positions[o] = m[0] * x + m[4] * y + m[8] * z + m[12];
134
+ positions[o + 1] = m[1] * x + m[5] * y + m[9] * z + m[13];
135
+ positions[o + 2] = m[2] * x + m[6] * y + m[10] * z + m[14];
136
+ const nx = item.normals[i * 3], ny = item.normals[i * 3 + 1], nz = item.normals[i * 3 + 2];
137
+ const tx = n[0] * nx + n[3] * ny + n[6] * nz, ty = n[1] * nx + n[4] * ny + n[7] * nz, tz = n[2] * nx + n[5] * ny + n[8] * nz, length = Math.hypot(tx, ty, tz) || 1;
138
+ normals[o] = tx / length;
139
+ normals[o + 1] = ty / length;
140
+ normals[o + 2] = tz / length;
141
+ if (colors && item.color)
142
+ colors.set(item.color, o);
143
+ }
144
+ if (uvs && item.uvs)
145
+ uvs.set(item.uvs, vertex * 2);
146
+ // A mirrored transform flips winding; swap two corners so faces stay outward.
147
+ const mirrored = m[0] * (m[5] * m[10] - m[6] * m[9]) -
148
+ m[4] * (m[1] * m[10] - m[2] * m[9]) +
149
+ m[8] * (m[1] * m[6] - m[2] * m[5]) <
150
+ 0;
151
+ for (let i = 0; i < item.indices.length; i += 3) {
152
+ indices[index + i] = item.indices[i] + vertex;
153
+ indices[index + i + 1] = item.indices[i + (mirrored ? 2 : 1)] + vertex;
154
+ indices[index + i + 2] = item.indices[i + (mirrored ? 1 : 2)] + vertex;
155
+ }
156
+ vertex += count;
157
+ index += item.indices.length;
158
+ }
159
+ geometry.setIndex(undefined);
160
+ geometry.setAttribute('position', new Attribute3D(positions, 3));
161
+ geometry.setAttribute('normal', new Attribute3D(normals, 3));
162
+ if (uvs)
163
+ geometry.setAttribute('uv', new Attribute3D(uvs, 2));
164
+ else
165
+ geometry.removeAttribute('uv');
166
+ if (colors)
167
+ geometry.setAttribute('color', new Attribute3D(colors, 3));
168
+ else
169
+ geometry.removeAttribute('color');
170
+ geometry.setIndex(indices.length > 0 ? indices : new Uint32Array(3));
171
+ geometry.invalidateBounds();
172
+ }
173
+ beforeRender() {
174
+ this.flush();
175
+ }
176
+ /** Release the combined geometry. The material stays with its owner. */
177
+ dispose() {
178
+ this.geometry.dispose();
179
+ }
180
+ }
181
+ /**
182
+ * A polyline drawn as a ribbon of triangles that turns to face the camera,
183
+ * so it can be wider than the one pixel that plain lines allow. Give points
184
+ * in the line's local space; call setPoints() to change them.
185
+ */
186
+ export class FatLine3D extends Mesh3D {
187
+ width;
188
+ screenSpace;
189
+ /** Output height in pixels, used to convert a pixel width to world units. */
190
+ resolutionHeight = 720;
191
+ closed;
192
+ #points = new Float32Array(0);
193
+ #count = 0;
194
+ #positions = new Float32Array(0);
195
+ #attribute;
196
+ #local = new Float32Array(3);
197
+ constructor(points, options = {}) {
198
+ const material = new Material3D('unlit', { color: options.color ?? 0xffffff, side: 'double' });
199
+ material.fog = false;
200
+ const geometry = new Geometry3D();
201
+ geometry.setAttribute('position', new Attribute3D(new Float32Array(9), 3));
202
+ super(geometry, material);
203
+ this.width = options.width ?? 0.05;
204
+ this.screenSpace = options.screenSpace ?? false;
205
+ this.closed = options.closed ?? false;
206
+ this.castShadow = false;
207
+ this.receiveShadow = false;
208
+ // The ribbon is rebuilt around the camera each frame, so stale bounds must not cull it.
209
+ this.frustumCulled = false;
210
+ this.name = 'fat-line';
211
+ this.setPoints(points);
212
+ }
213
+ /** Replace the points: a flat [x, y, z, ...] array or a list of [x, y, z]. */
214
+ setPoints(points) {
215
+ const flat = [];
216
+ if (points.length > 0 && typeof points[0] === 'number')
217
+ for (let i = 0; i < points.length; i++)
218
+ flat.push(points[i]);
219
+ else
220
+ for (const p of points)
221
+ flat.push(p[0], p[1], p[2]);
222
+ if (flat.length < 6 || flat.length % 3 !== 0 || !flat.every(Number.isFinite))
223
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'line points');
224
+ if (flat.length / 3 > BATCH3D_LIMITS.maxLinePoints)
225
+ throw new World3DError('WORLD3D_BUDGET', 'line points');
226
+ this.#points = Float32Array.from(flat);
227
+ const count = (this.#count = flat.length / 3), segments = this.closed ? count : count - 1;
228
+ // Two vertices per point (plus a repeated first pair when closed) and two triangles per segment.
229
+ const pairs = this.closed ? count + 1 : count, indices = new Uint32Array(segments * 6);
230
+ for (let i = 0; i < segments; i++) {
231
+ const a = i * 2;
232
+ indices.set([a, a + 1, a + 2, a + 1, a + 3, a + 2], i * 6);
233
+ }
234
+ this.#positions = new Float32Array(pairs * 6);
235
+ const geometry = this.geometry;
236
+ geometry.setIndex(undefined);
237
+ geometry.setAttribute('position', (this.#attribute = new Attribute3D(this.#positions, 3)));
238
+ geometry.setIndex(indices);
239
+ return this;
240
+ }
241
+ /** Rebuild the ribbon so it faces `camera`. The render list calls this each frame. */
242
+ beforeRender(camera) {
243
+ const count = this.#count, points = this.#points, out = this.#positions, attribute = this.#attribute;
244
+ if (count < 2 || !attribute)
245
+ return;
246
+ // Camera position in the line's local space, so the ribbon can be built there directly.
247
+ const eye = this.worldToLocal(this.#local, [
248
+ camera.matrixWorld[12],
249
+ camera.matrixWorld[13],
250
+ camera.matrixWorld[14]
251
+ ]);
252
+ const ex = eye[0], ey = eye[1], ez = eye[2], pairs = this.closed ? count + 1 : count;
253
+ const pixel = this.screenSpace && camera.projectionKind === 'perspective'
254
+ ? (2 * Math.tan((camera.fov * Math.PI) / 360)) / (camera.zoom * Math.max(this.resolutionHeight, 1))
255
+ : this.screenSpace
256
+ ? camera.orthographicHeight / (camera.zoom * Math.max(this.resolutionHeight, 1))
257
+ : 0;
258
+ for (let i = 0; i < pairs; i++) {
259
+ const at = (i % count) * 3, x = points[at], y = points[at + 1], z = points[at + 2];
260
+ // Direction of travel: toward the next point, blended with the previous one at joints.
261
+ const wrap = this.closed, previous = (wrap ? (i - 1 + count) % count : Math.max(i - 1, 0)) * 3, next = (wrap ? (i + 1) % count : Math.min(i + 1, count - 1)) * 3;
262
+ // Unit directions into and out of the point; their sum is the miter direction at a joint.
263
+ let ax = x - points[previous], ay = y - points[previous + 1], az = z - points[previous + 2], bx = points[next] - x, by = points[next + 1] - y, bz = points[next + 2] - z;
264
+ const al = Math.hypot(ax, ay, az), bl = Math.hypot(bx, by, bz);
265
+ if (al > 1e-12) {
266
+ ax /= al;
267
+ ay /= al;
268
+ az /= al;
269
+ }
270
+ if (bl > 1e-12) {
271
+ bx /= bl;
272
+ by /= bl;
273
+ bz /= bl;
274
+ }
275
+ let dx = ax + bx, dy = ay + by, dz = az + bz;
276
+ const sum = Math.hypot(dx, dy, dz);
277
+ // A hairpin has no usable miter; fall back to the outgoing direction.
278
+ if (sum < 1e-6) {
279
+ dx = bx;
280
+ dy = by;
281
+ dz = bz;
282
+ }
283
+ // Widen the joint so the ribbon keeps its width on both sides of a corner, within reason.
284
+ const miter = al > 1e-12 && bl > 1e-12 && sum >= 1e-6 ? 1 / Math.max(sum / 2, 0.35) : 1;
285
+ const vx = ex - x, vy = ey - y, vz = ez - z;
286
+ // The ribbon's side vector is perpendicular to both the line and the view direction.
287
+ let sx = dy * vz - dz * vy, sy = dz * vx - dx * vz, sz = dx * vy - dy * vx;
288
+ const length = Math.hypot(sx, sy, sz);
289
+ let half = this.width / 2;
290
+ if (this.screenSpace && camera.projectionKind === 'perspective') {
291
+ // A pixel's size grows with depth along the view axis, not with straight-line distance.
292
+ const m = this.matrixWorld, wx = m[0] * x + m[4] * y + m[8] * z + m[12], wy = m[1] * x + m[5] * y + m[9] * z + m[13], wz = m[2] * x + m[6] * y + m[10] * z + m[14];
293
+ const view = camera.viewMatrix;
294
+ half *= pixel * Math.max(-(view[2] * wx + view[6] * wy + view[10] * wz + view[14]), 0);
295
+ }
296
+ else if (this.screenSpace)
297
+ half *= pixel;
298
+ half *= miter;
299
+ if (length > 1e-12) {
300
+ sx *= half / length;
301
+ sy *= half / length;
302
+ sz *= half / length;
303
+ }
304
+ else {
305
+ sx = sy = sz = 0;
306
+ }
307
+ const o = i * 6;
308
+ out[o] = x - sx;
309
+ out[o + 1] = y - sy;
310
+ out[o + 2] = z - sz;
311
+ out[o + 3] = x + sx;
312
+ out[o + 4] = y + sy;
313
+ out[o + 5] = z + sz;
314
+ }
315
+ attribute.touch();
316
+ }
317
+ /** Release the line's own geometry and material. */
318
+ dispose() {
319
+ this.geometry.dispose();
320
+ this.material.dispose();
321
+ }
322
+ }
323
+ export function createBatchedMesh3D(material) {
324
+ return new BatchedMesh3D(material);
325
+ }
326
+ export function createFatLine3D(points, options = {}) {
327
+ return new FatLine3D(points, options);
328
+ }
329
+ //# sourceMappingURL=Batch3D.js.map
@@ -0,0 +1,57 @@
1
+ import { Object3D } from './Object3D.js';
2
+ export interface PerspectiveCameraOptions3D {
3
+ /** Vertical field of view in degrees. */
4
+ readonly fov?: number;
5
+ readonly aspect?: number;
6
+ readonly near?: number;
7
+ readonly far?: number;
8
+ }
9
+ export interface OrthographicCameraOptions3D {
10
+ /** Visible world height; width follows from the aspect ratio. */
11
+ readonly height?: number;
12
+ readonly aspect?: number;
13
+ readonly near?: number;
14
+ readonly far?: number;
15
+ }
16
+ export declare class Camera3D extends Object3D {
17
+ #private;
18
+ readonly projectionKind: 'perspective' | 'orthographic';
19
+ fov: number;
20
+ orthographicHeight: number;
21
+ aspect: number;
22
+ near: number;
23
+ far: number;
24
+ /** Extra magnification applied to either projection. */
25
+ zoom: number;
26
+ /** Objects render when (object.layers & camera.layerMask) is non-zero. */
27
+ layerMask: number;
28
+ /**
29
+ * A complete projection matrix (OpenGL clip conventions, column-major) used
30
+ * instead of the one derived from fov, aspect, near and far: for off-center
31
+ * frusta, oblique near planes and portals. Assign undefined to return to the
32
+ * derived projection.
33
+ */
34
+ customProjection: ArrayLike<number> | undefined;
35
+ readonly projectionMatrix: Float32Array<ArrayBuffer>;
36
+ readonly viewMatrix: Float32Array<ArrayBuffer>;
37
+ readonly viewProjectionMatrix: Float32Array<ArrayBuffer>;
38
+ /** Six inward world-space planes, refreshed by updateViewMatrices(). */
39
+ readonly frustum: Float32Array<ArrayBuffer>;
40
+ constructor(kind?: 'perspective' | 'orthographic');
41
+ /** Recompute the projection when a parameter changed since the last call. */
42
+ updateProjectionMatrix(): void;
43
+ /** Refresh view, view-projection and frustum from the current world matrix. */
44
+ updateViewMatrices(): void;
45
+ /**
46
+ * World-space ray through normalized device coordinates (x, y in [-1, 1],
47
+ * y up). Writes the origin and unit direction; call updateViewMatrices() first.
48
+ */
49
+ screenPointToRay(ndcX: number, ndcY: number, origin: Float32Array | number[], direction: Float32Array | number[]): void;
50
+ /** Project a world point to normalized device coordinates; z in [-1, 1] is depth. */
51
+ worldToScreenPoint(out: Float32Array | number[], point: ArrayLike<number>): Float32Array | number[];
52
+ clone(recursive?: boolean): this;
53
+ protected copyFrom(source: this): void;
54
+ }
55
+ export declare function createPerspectiveCamera3D(options?: PerspectiveCameraOptions3D): Camera3D;
56
+ export declare function createOrthographicCamera3D(options?: OrthographicCameraOptions3D): Camera3D;
57
+ //# sourceMappingURL=Camera3D.d.ts.map
@@ -0,0 +1,129 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // Perspective and orthographic cameras. A camera is an ordinary scene node
3
+ // that looks down its local negative Z axis.
4
+ import { World3DError, requireFinite3D, requirePositive3D } from './core3D.js';
5
+ import { frustumFromMatrix, mat4Invert, mat4Multiply, mat4Orthographic, mat4Perspective, vec3Normalize, vec3Sub, vec3TransformMat4 } from './math3D.js';
6
+ import { Object3D } from './Object3D.js';
7
+ export class Camera3D extends Object3D {
8
+ projectionKind;
9
+ fov = 50;
10
+ orthographicHeight = 10;
11
+ aspect = 1;
12
+ near = 0.1;
13
+ far = 1000;
14
+ /** Extra magnification applied to either projection. */
15
+ zoom = 1;
16
+ /** Objects render when (object.layers & camera.layerMask) is non-zero. */
17
+ layerMask = 0xffffffff;
18
+ /**
19
+ * A complete projection matrix (OpenGL clip conventions, column-major) used
20
+ * instead of the one derived from fov, aspect, near and far: for off-center
21
+ * frusta, oblique near planes and portals. Assign undefined to return to the
22
+ * derived projection.
23
+ */
24
+ customProjection;
25
+ projectionMatrix = new Float32Array(16);
26
+ viewMatrix = new Float32Array(16);
27
+ viewProjectionMatrix = new Float32Array(16);
28
+ /** Six inward world-space planes, refreshed by updateViewMatrices(). */
29
+ frustum = new Float32Array(24);
30
+ #projectionKey = '';
31
+ constructor(kind = 'perspective') {
32
+ super('camera');
33
+ this.projectionKind = kind;
34
+ }
35
+ /** Recompute the projection when a parameter changed since the last call. */
36
+ updateProjectionMatrix() {
37
+ const custom = this.customProjection;
38
+ if (custom) {
39
+ if (custom.length !== 16)
40
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'camera.customProjection');
41
+ for (let i = 0; i < 16; i++)
42
+ this.projectionMatrix[i] = requireFinite3D(custom[i], 'camera.customProjection');
43
+ this.#projectionKey = 'custom';
44
+ return;
45
+ }
46
+ const key = this.fov + '|' + this.orthographicHeight + '|' + this.aspect + '|' + this.near + '|' + this.far + '|' + this.zoom;
47
+ if (key === this.#projectionKey)
48
+ return;
49
+ const aspect = requirePositive3D(this.aspect, 'camera.aspect'), zoom = requirePositive3D(this.zoom, 'camera.zoom');
50
+ const near = requireFinite3D(this.near, 'camera.near'), far = requireFinite3D(this.far, 'camera.far');
51
+ if (far <= near)
52
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'camera.far');
53
+ if (this.projectionKind === 'perspective') {
54
+ const fov = requirePositive3D(this.fov, 'camera.fov');
55
+ if (fov >= 180 || near <= 0)
56
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'camera.fov/near');
57
+ const zoomed = 2 * Math.atan(Math.tan((fov * Math.PI) / 360) / zoom);
58
+ mat4Perspective(this.projectionMatrix, zoomed, aspect, near, far);
59
+ }
60
+ else {
61
+ const halfHeight = requirePositive3D(this.orthographicHeight, 'camera.orthographicHeight') / (2 * zoom), halfWidth = halfHeight * aspect;
62
+ mat4Orthographic(this.projectionMatrix, -halfWidth, halfWidth, -halfHeight, halfHeight, near, far);
63
+ }
64
+ this.#projectionKey = key;
65
+ }
66
+ /** Refresh view, view-projection and frustum from the current world matrix. */
67
+ updateViewMatrices() {
68
+ this.updateWorldMatrix();
69
+ this.updateProjectionMatrix();
70
+ if (!mat4Invert(this.viewMatrix, this.matrixWorld))
71
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'camera transform is singular');
72
+ mat4Multiply(this.viewProjectionMatrix, this.projectionMatrix, this.viewMatrix);
73
+ frustumFromMatrix(this.frustum, this.viewProjectionMatrix);
74
+ }
75
+ /**
76
+ * World-space ray through normalized device coordinates (x, y in [-1, 1],
77
+ * y up). Writes the origin and unit direction; call updateViewMatrices() first.
78
+ */
79
+ screenPointToRay(ndcX, ndcY, origin, direction) {
80
+ const inverse = new Float32Array(16);
81
+ if (!mat4Invert(inverse, this.viewProjectionMatrix))
82
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'camera matrices');
83
+ const far = vec3TransformMat4(new Float32Array(3), [ndcX, ndcY, 1], inverse);
84
+ vec3TransformMat4(origin, [ndcX, ndcY, -1], inverse);
85
+ vec3Normalize(direction, vec3Sub(direction, far, origin));
86
+ }
87
+ /** Project a world point to normalized device coordinates; z in [-1, 1] is depth. */
88
+ worldToScreenPoint(out, point) {
89
+ return vec3TransformMat4(out, point, this.viewProjectionMatrix);
90
+ }
91
+ clone(recursive = true) {
92
+ const copy = new Camera3D(this.projectionKind);
93
+ copy.copyFrom(this);
94
+ if (recursive)
95
+ for (const child of this.children)
96
+ copy.addChild(child.clone(true));
97
+ return copy;
98
+ }
99
+ copyFrom(source) {
100
+ super.copyFrom(source);
101
+ this.fov = source.fov;
102
+ this.orthographicHeight = source.orthographicHeight;
103
+ this.aspect = source.aspect;
104
+ this.near = source.near;
105
+ this.far = source.far;
106
+ this.zoom = source.zoom;
107
+ this.layerMask = source.layerMask;
108
+ this.customProjection = source.customProjection === undefined ? undefined : Array.from(source.customProjection);
109
+ }
110
+ }
111
+ export function createPerspectiveCamera3D(options = {}) {
112
+ const camera = new Camera3D('perspective');
113
+ camera.fov = options.fov ?? 50;
114
+ camera.aspect = options.aspect ?? 1;
115
+ camera.near = options.near ?? 0.1;
116
+ camera.far = options.far ?? 1000;
117
+ camera.updateProjectionMatrix();
118
+ return camera;
119
+ }
120
+ export function createOrthographicCamera3D(options = {}) {
121
+ const camera = new Camera3D('orthographic');
122
+ camera.orthographicHeight = options.height ?? 10;
123
+ camera.aspect = options.aspect ?? 1;
124
+ camera.near = options.near ?? 0.1;
125
+ camera.far = options.far ?? 1000;
126
+ camera.updateProjectionMatrix();
127
+ return camera;
128
+ }
129
+ //# sourceMappingURL=Camera3D.js.map
@@ -0,0 +1,123 @@
1
+ import type { Camera3D } from './Camera3D.js';
2
+ import type { Object3D } from './Object3D.js';
3
+ import { CharacterController3D } from './Physics3D.js';
4
+ import type { CharacterControllerOptions3D, PhysicsWorld3D, RigidBody3D } from './Physics3D.js';
5
+ export interface CharacterMotorOptions3D extends CharacterControllerOptions3D {
6
+ /** Upward speed given by a jump, in units per second. Defaults to 5. */
7
+ readonly jumpSpeed?: number;
8
+ /** Downward acceleration. Defaults to the size of the world's gravity. */
9
+ readonly gravity?: number;
10
+ /** Tallest ledge the character walks up without jumping. Defaults to 0.3. */
11
+ readonly stepHeight?: number;
12
+ /** How quickly walking speed changes on the ground, in units per second squared. Defaults to 60. */
13
+ readonly acceleration?: number;
14
+ /** Share of the ground acceleration available in the air, 0 to 1. Defaults to 0.3. */
15
+ readonly airControl?: number;
16
+ /** Seconds after walking off a ledge during which a jump still works. Defaults to 0.1. */
17
+ readonly coyoteTime?: number;
18
+ /** Force used to shove dynamic bodies the character walks into. Zero disables pushing. Defaults to 40. */
19
+ readonly pushForce?: number;
20
+ /** Fastest fall, in units per second. Defaults to 50. */
21
+ readonly maxFallSpeed?: number;
22
+ }
23
+ /**
24
+ * A walking, jumping character. Each frame, after `world.step()`, call
25
+ * `update(deltaSeconds, wishX, wishZ, jump)` with the horizontal velocity the
26
+ * player asks for. The motor owns the capsule in `controller`.
27
+ */
28
+ export declare class CharacterMotor3D {
29
+ #private;
30
+ readonly controller: CharacterController3D;
31
+ readonly world: PhysicsWorld3D;
32
+ /** Current velocity relative to whatever the character stands on. */
33
+ readonly velocity: Float64Array<ArrayBuffer>;
34
+ jumpSpeed: number;
35
+ gravity: number;
36
+ stepHeight: number;
37
+ acceleration: number;
38
+ airControl: number;
39
+ coyoteTime: number;
40
+ pushForce: number;
41
+ maxFallSpeed: number;
42
+ /** Turn, in radians about +Y, that the ground gave the character during the last update. Add it to the character's facing. */
43
+ carriedYaw: number;
44
+ /** True on the update in which a jump started. */
45
+ jumped: boolean;
46
+ constructor(world: PhysicsWorld3D, options?: CharacterMotorOptions3D);
47
+ get position(): Float64Array;
48
+ /** True when the character stands on walkable ground, including the edge of a step. */
49
+ get isGrounded(): boolean;
50
+ get groundBody(): RigidBody3D | undefined;
51
+ /**
52
+ * Move the capsule and report whether it ends up standing. The capsule's
53
+ * own test needs a walkable contact; perched on the lip of a step its round
54
+ * foot touches at a slant, so there the surface straight below decides.
55
+ */
56
+ private settle;
57
+ /** Place the character somewhere else and forget its motion. Invalid coordinates leave the motor unchanged. */
58
+ teleport(x: number, y: number, z: number): void;
59
+ /**
60
+ * Advance the character. `wishX` and `wishZ` are the horizontal velocity
61
+ * the player asks for in world units per second; `jump` asks for a jump
62
+ * this frame.
63
+ */
64
+ update(deltaSeconds: number, wishX: number, wishZ: number, jump?: boolean): void;
65
+ }
66
+ export interface FollowCameraOptions3D {
67
+ /** Distance kept behind the target when nothing is in the way. Defaults to 6. */
68
+ readonly distance?: number;
69
+ readonly minDistance?: number;
70
+ readonly maxDistance?: number;
71
+ /** Height above the target's position that the camera looks at. Defaults to 1.4. */
72
+ readonly height?: number;
73
+ /** Starting direction: `yaw` about +Y (0 looks along -Z) and `pitch` downward, in radians. */
74
+ readonly yaw?: number;
75
+ readonly pitch?: number;
76
+ readonly minPitch?: number;
77
+ readonly maxPitch?: number;
78
+ /** Physics world whose solid bodies block the view. Leave out for no collision. */
79
+ readonly world?: PhysicsWorld3D;
80
+ /** Collision categories that block the view. */
81
+ readonly mask?: number;
82
+ /** Space kept between the camera and a blocking surface. Defaults to 0.25. */
83
+ readonly margin?: number;
84
+ /** Seconds the camera takes to settle back after an obstacle clears. Zero snaps. Defaults to 0.25. */
85
+ readonly recovery?: number;
86
+ }
87
+ /**
88
+ * Third-person camera: orbits a target at a distance, and moves closer when
89
+ * a wall would hide the target, easing back out afterwards. Set `yaw`,
90
+ * `pitch` and `distance` from input, then call `update()` each frame after
91
+ * the target has moved. The camera must not sit under a transformed parent.
92
+ */
93
+ export declare class FollowCamera3D {
94
+ #private;
95
+ readonly camera: Camera3D;
96
+ /** Followed object, or a fixed world position. */
97
+ target: Object3D | ArrayLike<number>;
98
+ yaw: number;
99
+ pitch: number;
100
+ distance: number;
101
+ minDistance: number;
102
+ maxDistance: number;
103
+ minPitch: number;
104
+ maxPitch: number;
105
+ height: number;
106
+ world: PhysicsWorld3D | undefined;
107
+ mask: number;
108
+ margin: number;
109
+ recovery: number;
110
+ /** Distance actually used on the last update, after obstacles. */
111
+ currentDistance: number;
112
+ constructor(camera: Camera3D, target: Object3D | ArrayLike<number>, options?: FollowCameraOptions3D);
113
+ /**
114
+ * Turn a "forward" and "right" input into a world-space direction on the
115
+ * ground, relative to where the camera looks: (1, 0) walks away from the camera.
116
+ */
117
+ moveDirection(forward: number, right: number, out?: Float32Array | number[]): Float32Array | number[];
118
+ /** Place the camera for the current target, angles and distance. */
119
+ update(deltaSeconds?: number): void;
120
+ }
121
+ export declare function createCharacterMotor3D(world: PhysicsWorld3D, options?: CharacterMotorOptions3D): CharacterMotor3D;
122
+ export declare function createFollowCamera3D(camera: Camera3D, target: Object3D | ArrayLike<number>, options?: FollowCameraOptions3D): FollowCamera3D;
123
+ //# sourceMappingURL=Character3D.d.ts.map