@egret/engine 0.0.0-stage → 7.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (601) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +21 -0
  3. package/README.md +101 -2
  4. package/README.zh-CN.md +102 -0
  5. package/dist/Engine.d.ts +77 -0
  6. package/dist/Engine.js +469 -0
  7. package/dist/animation/index.d.ts +6 -0
  8. package/dist/animation/index.js +5 -0
  9. package/dist/animation/sequenceController.d.ts +22 -0
  10. package/dist/animation/sequenceController.js +618 -0
  11. package/dist/animation/sequenceCoordinator.d.ts +26 -0
  12. package/dist/animation/sequenceCoordinator.js +161 -0
  13. package/dist/animation/sequenceInput.d.ts +25 -0
  14. package/dist/animation/sequenceInput.js +108 -0
  15. package/dist/animation/sequenceMath.d.ts +35 -0
  16. package/dist/animation/sequenceMath.js +164 -0
  17. package/dist/animation/sequenceResetSlot.d.ts +7 -0
  18. package/dist/animation/sequenceResetSlot.js +367 -0
  19. package/dist/animation/sequenceResetTypes.d.ts +48 -0
  20. package/dist/animation/sequenceResetTypes.js +2 -0
  21. package/dist/animation/types.d.ts +75 -0
  22. package/dist/animation/types.js +2 -0
  23. package/dist/assetBundle.d.ts +54 -0
  24. package/dist/assetBundle.js +173 -0
  25. package/dist/assetGroup.d.ts +17 -0
  26. package/dist/assetGroup.js +332 -0
  27. package/dist/assetGroupTypes.d.ts +17 -0
  28. package/dist/assetGroupTypes.js +2 -0
  29. package/dist/audio.d.ts +4 -0
  30. package/dist/audio.js +4 -0
  31. package/dist/audioCues.d.ts +47 -0
  32. package/dist/audioCues.js +127 -0
  33. package/dist/audioMixer.d.ts +7 -0
  34. package/dist/audioMixer.js +785 -0
  35. package/dist/audioTypes.d.ts +246 -0
  36. package/dist/audioTypes.js +3 -0
  37. package/dist/bitmapBindingTicket.d.ts +24 -0
  38. package/dist/bitmapBindingTicket.js +215 -0
  39. package/dist/bitmapButton.d.ts +4 -0
  40. package/dist/bitmapButton.js +407 -0
  41. package/dist/bitmapButtonTypes.d.ts +31 -0
  42. package/dist/bitmapButtonTypes.js +2 -0
  43. package/dist/bitmapFontParse.d.ts +10 -0
  44. package/dist/bitmapFontParse.js +246 -0
  45. package/dist/bitmapFontTypes.d.ts +112 -0
  46. package/dist/bitmapFontTypes.js +2 -0
  47. package/dist/bitmapResourceSlot.d.ts +26 -0
  48. package/dist/bitmapResourceSlot.js +340 -0
  49. package/dist/bitmapText.d.ts +6 -0
  50. package/dist/bitmapText.js +320 -0
  51. package/dist/bitmapfont.d.ts +5 -0
  52. package/dist/bitmapfont.js +5 -0
  53. package/dist/camera.d.ts +4 -0
  54. package/dist/camera.js +4 -0
  55. package/dist/camera2d.d.ts +7 -0
  56. package/dist/camera2d.js +419 -0
  57. package/dist/cameraTypes.d.ts +126 -0
  58. package/dist/cameraTypes.js +2 -0
  59. package/dist/closeHost.d.ts +4 -0
  60. package/dist/closeHost.js +66 -0
  61. package/dist/contentArtifacts.d.ts +12 -0
  62. package/dist/contentArtifacts.js +153 -0
  63. package/dist/contentAtlasPages.d.ts +13 -0
  64. package/dist/contentAtlasPages.js +117 -0
  65. package/dist/contentLoader.d.ts +6 -0
  66. package/dist/contentLoader.js +327 -0
  67. package/dist/contentTypes.d.ts +35 -0
  68. package/dist/contentTypes.js +2 -0
  69. package/dist/createEngine.d.ts +7 -0
  70. package/dist/createEngine.js +25 -0
  71. package/dist/createEngineForProfile.d.ts +5 -0
  72. package/dist/createEngineForProfile.js +45 -0
  73. package/dist/displaySubtreeTicket.d.ts +25 -0
  74. package/dist/displaySubtreeTicket.js +76 -0
  75. package/dist/fontContentLoader.d.ts +6 -0
  76. package/dist/fontContentLoader.js +298 -0
  77. package/dist/fontContentTypes.d.ts +39 -0
  78. package/dist/fontContentTypes.js +2 -0
  79. package/dist/gameClock.d.ts +24 -0
  80. package/dist/gameClock.js +246 -0
  81. package/dist/gameClockTypes.d.ts +37 -0
  82. package/dist/gameClockTypes.js +2 -0
  83. package/dist/gameRun.d.ts +53 -0
  84. package/dist/gameRun.js +97 -0
  85. package/dist/gamepad.d.ts +5 -0
  86. package/dist/gamepad.js +5 -0
  87. package/dist/gamepadInput.d.ts +4 -0
  88. package/dist/gamepadInput.js +281 -0
  89. package/dist/gamepadKeys.d.ts +4 -0
  90. package/dist/gamepadKeys.js +205 -0
  91. package/dist/gamepadTypes.d.ts +142 -0
  92. package/dist/gamepadTypes.js +3 -0
  93. package/dist/hover.d.ts +4 -0
  94. package/dist/hover.js +4 -0
  95. package/dist/hoverInput.d.ts +8 -0
  96. package/dist/hoverInput.js +503 -0
  97. package/dist/hoverInputTypes.d.ts +129 -0
  98. package/dist/hoverInputTypes.js +2 -0
  99. package/dist/index.d.ts +52 -0
  100. package/dist/index.js +21 -0
  101. package/dist/input.d.ts +6 -0
  102. package/dist/input.js +5 -0
  103. package/dist/inputActions.d.ts +86 -0
  104. package/dist/inputActions.js +330 -0
  105. package/dist/internal/contentFactoryState.d.ts +19 -0
  106. package/dist/internal/contentFactoryState.js +42 -0
  107. package/dist/internal/mouseInputFactoryState.d.ts +57 -0
  108. package/dist/internal/mouseInputFactoryState.js +125 -0
  109. package/dist/internal/sequenceControllerFactoryState.d.ts +42 -0
  110. package/dist/internal/sequenceControllerFactoryState.js +98 -0
  111. package/dist/internal/textFieldFactoryState.d.ts +11 -0
  112. package/dist/internal/textFieldFactoryState.js +32 -0
  113. package/dist/internal/texturedFrameState.d.ts +4 -0
  114. package/dist/internal/texturedFrameState.js +12 -0
  115. package/dist/internal/uiFactoryState.d.ts +68 -0
  116. package/dist/internal/uiFactoryState.js +173 -0
  117. package/dist/internal/uiRootState.d.ts +67 -0
  118. package/dist/internal/uiRootState.js +103 -0
  119. package/dist/keyboardInput.d.ts +13 -0
  120. package/dist/keyboardInput.js +579 -0
  121. package/dist/keyboardInputTypes.d.ts +93 -0
  122. package/dist/keyboardInputTypes.js +2 -0
  123. package/dist/kit.d.ts +16 -0
  124. package/dist/kit.js +10 -0
  125. package/dist/layout.d.ts +5 -0
  126. package/dist/layout.js +132 -0
  127. package/dist/layoutTypes.d.ts +28 -0
  128. package/dist/layoutTypes.js +2 -0
  129. package/dist/manifestAssetGroup.d.ts +10 -0
  130. package/dist/manifestAssetGroup.js +477 -0
  131. package/dist/manifestResourceState.d.ts +17 -0
  132. package/dist/manifestResourceState.js +58 -0
  133. package/dist/manifestResourceTypes.d.ts +26 -0
  134. package/dist/manifestResourceTypes.js +2 -0
  135. package/dist/motion.d.ts +35 -0
  136. package/dist/motion.js +206 -0
  137. package/dist/mouseInput.d.ts +102 -0
  138. package/dist/mouseInput.js +562 -0
  139. package/dist/mouseInputTypes.d.ts +41 -0
  140. package/dist/mouseInputTypes.js +2 -0
  141. package/dist/paragraph.d.ts +8 -0
  142. package/dist/paragraph.js +7 -0
  143. package/dist/particleEmitter.d.ts +4 -0
  144. package/dist/particleEmitter.js +300 -0
  145. package/dist/particleTypes.d.ts +115 -0
  146. package/dist/particleTypes.js +2 -0
  147. package/dist/particles.d.ts +4 -0
  148. package/dist/particles.js +4 -0
  149. package/dist/physics2d.d.ts +4 -0
  150. package/dist/physics2d.js +4 -0
  151. package/dist/physics2dGeometry.d.ts +39 -0
  152. package/dist/physics2dGeometry.js +230 -0
  153. package/dist/physics2dTypes.d.ts +221 -0
  154. package/dist/physics2dTypes.js +2 -0
  155. package/dist/physics2dWorld.d.ts +4 -0
  156. package/dist/physics2dWorld.js +823 -0
  157. package/dist/pointerInput.d.ts +12 -0
  158. package/dist/pointerInput.js +300 -0
  159. package/dist/pointerInputTypes.d.ts +41 -0
  160. package/dist/pointerInputTypes.js +2 -0
  161. package/dist/random.d.ts +30 -0
  162. package/dist/random.js +131 -0
  163. package/dist/rendering/ownedPreparationFailure2D.d.ts +5 -0
  164. package/dist/rendering/ownedPreparationFailure2D.js +33 -0
  165. package/dist/rendering/packSharedDraws2D.d.ts +50 -0
  166. package/dist/rendering/packSharedDraws2D.js +379 -0
  167. package/dist/rendering/packedOrientation.d.ts +4 -0
  168. package/dist/rendering/packedOrientation.js +7 -0
  169. package/dist/rendering/prepareRectangles2D.d.ts +92 -0
  170. package/dist/rendering/prepareRectangles2D.js +481 -0
  171. package/dist/rendering/prepareSharedDraws2D.d.ts +90 -0
  172. package/dist/rendering/prepareSharedDraws2D.js +663 -0
  173. package/dist/rendering/preparedBatches2D.d.ts +17 -0
  174. package/dist/rendering/preparedBatches2D.js +30 -0
  175. package/dist/rendering/preparedSharedBatches2D.d.ts +44 -0
  176. package/dist/rendering/preparedSharedBatches2D.js +247 -0
  177. package/dist/rendering/sharedColor2D.d.ts +52 -0
  178. package/dist/rendering/sharedColor2D.js +191 -0
  179. package/dist/rendering/sharedEffects2D.d.ts +23 -0
  180. package/dist/rendering/sharedEffects2D.js +126 -0
  181. package/dist/rendering/sharedPreparationRetention2D.d.ts +120 -0
  182. package/dist/rendering/sharedPreparationRetention2D.js +357 -0
  183. package/dist/rendering/srgbBytes.d.ts +3 -0
  184. package/dist/rendering/srgbBytes.js +64 -0
  185. package/dist/rendering/texturedPreparationBudget2D.d.ts +31 -0
  186. package/dist/rendering/texturedPreparationBudget2D.js +81 -0
  187. package/dist/rendering/world3d/Animation3D.d.ts +104 -0
  188. package/dist/rendering/world3d/Animation3D.js +384 -0
  189. package/dist/rendering/world3d/AnimationTexture3D.d.ts +163 -0
  190. package/dist/rendering/world3d/AnimationTexture3D.js +603 -0
  191. package/dist/rendering/world3d/Batch3D.d.ts +75 -0
  192. package/dist/rendering/world3d/Batch3D.js +332 -0
  193. package/dist/rendering/world3d/Camera3D.d.ts +62 -0
  194. package/dist/rendering/world3d/Camera3D.js +132 -0
  195. package/dist/rendering/world3d/Character3D.d.ts +127 -0
  196. package/dist/rendering/world3d/Character3D.js +305 -0
  197. package/dist/rendering/world3d/Cloth3D.d.ts +130 -0
  198. package/dist/rendering/world3d/Cloth3D.js +503 -0
  199. package/dist/rendering/world3d/Compression3D.d.ts +22 -0
  200. package/dist/rendering/world3d/Compression3D.js +703 -0
  201. package/dist/rendering/world3d/Curves3D.d.ts +119 -0
  202. package/dist/rendering/world3d/Curves3D.js +460 -0
  203. package/dist/rendering/world3d/Decal3D.d.ts +43 -0
  204. package/dist/rendering/world3d/Decal3D.js +242 -0
  205. package/dist/rendering/world3d/Export3D.d.ts +13 -0
  206. package/dist/rendering/world3d/Export3D.js +263 -0
  207. package/dist/rendering/world3d/Geometry3D.d.ts +95 -0
  208. package/dist/rendering/world3d/Geometry3D.js +335 -0
  209. package/dist/rendering/world3d/GeometryBuilder3D.d.ts +53 -0
  210. package/dist/rendering/world3d/GeometryBuilder3D.js +196 -0
  211. package/dist/rendering/world3d/Gizmo3D.d.ts +80 -0
  212. package/dist/rendering/world3d/Gizmo3D.js +514 -0
  213. package/dist/rendering/world3d/Gltf3D.d.ts +73 -0
  214. package/dist/rendering/world3d/Gltf3D.js +996 -0
  215. package/dist/rendering/world3d/GpuParticles3D.d.ts +109 -0
  216. package/dist/rendering/world3d/GpuParticles3D.js +401 -0
  217. package/dist/rendering/world3d/Hdr3D.d.ts +35 -0
  218. package/dist/rendering/world3d/Hdr3D.js +191 -0
  219. package/dist/rendering/world3d/Jelly3D.d.ts +77 -0
  220. package/dist/rendering/world3d/Jelly3D.js +267 -0
  221. package/dist/rendering/world3d/Ktx23D.d.ts +30 -0
  222. package/dist/rendering/world3d/Ktx23D.js +112 -0
  223. package/dist/rendering/world3d/Light3D.d.ts +84 -0
  224. package/dist/rendering/world3d/Light3D.js +97 -0
  225. package/dist/rendering/world3d/Material3D.d.ts +253 -0
  226. package/dist/rendering/world3d/Material3D.js +269 -0
  227. package/dist/rendering/world3d/Mesh3D.d.ts +112 -0
  228. package/dist/rendering/world3d/Mesh3D.js +337 -0
  229. package/dist/rendering/world3d/Meshopt3D.d.ts +15 -0
  230. package/dist/rendering/world3d/Meshopt3D.js +276 -0
  231. package/dist/rendering/world3d/Navigation3D.d.ts +213 -0
  232. package/dist/rendering/world3d/Navigation3D.js +1043 -0
  233. package/dist/rendering/world3d/Object3D.d.ts +118 -0
  234. package/dist/rendering/world3d/Object3D.js +315 -0
  235. package/dist/rendering/world3d/Particles3D.d.ts +90 -0
  236. package/dist/rendering/world3d/Particles3D.js +277 -0
  237. package/dist/rendering/world3d/Physics3D.d.ts +430 -0
  238. package/dist/rendering/world3d/Physics3D.js +2840 -0
  239. package/dist/rendering/world3d/PhysicsHull3D.d.ts +37 -0
  240. package/dist/rendering/world3d/PhysicsHull3D.js +229 -0
  241. package/dist/rendering/world3d/PhysicsMesh3D.d.ts +41 -0
  242. package/dist/rendering/world3d/PhysicsMesh3D.js +340 -0
  243. package/dist/rendering/world3d/PhysicsQueries3D.d.ts +24 -0
  244. package/dist/rendering/world3d/PhysicsQueries3D.js +323 -0
  245. package/dist/rendering/world3d/PhysicsRemote3D.d.ts +179 -0
  246. package/dist/rendering/world3d/PhysicsRemote3D.js +536 -0
  247. package/dist/rendering/world3d/Ragdoll3D.d.ts +74 -0
  248. package/dist/rendering/world3d/Ragdoll3D.js +202 -0
  249. package/dist/rendering/world3d/Raycast3D.d.ts +40 -0
  250. package/dist/rendering/world3d/Raycast3D.js +247 -0
  251. package/dist/rendering/world3d/RenderList3D.d.ts +91 -0
  252. package/dist/rendering/world3d/RenderList3D.js +502 -0
  253. package/dist/rendering/world3d/Retarget3D.d.ts +21 -0
  254. package/dist/rendering/world3d/Retarget3D.js +185 -0
  255. package/dist/rendering/world3d/Rig3D.d.ts +57 -0
  256. package/dist/rendering/world3d/Rig3D.js +219 -0
  257. package/dist/rendering/world3d/Sdf3D.d.ts +181 -0
  258. package/dist/rendering/world3d/Sdf3D.js +1136 -0
  259. package/dist/rendering/world3d/SdfLod3D.d.ts +17 -0
  260. package/dist/rendering/world3d/SdfLod3D.js +56 -0
  261. package/dist/rendering/world3d/Serialize3D.d.ts +66 -0
  262. package/dist/rendering/world3d/Serialize3D.js +629 -0
  263. package/dist/rendering/world3d/Simplify3D.d.ts +29 -0
  264. package/dist/rendering/world3d/Simplify3D.js +426 -0
  265. package/dist/rendering/world3d/StateMachine3D.d.ts +87 -0
  266. package/dist/rendering/world3d/StateMachine3D.js +280 -0
  267. package/dist/rendering/world3d/SurfaceMaterial3D.d.ts +26 -0
  268. package/dist/rendering/world3d/SurfaceMaterial3D.js +138 -0
  269. package/dist/rendering/world3d/Terrain3D.d.ts +248 -0
  270. package/dist/rendering/world3d/Terrain3D.js +827 -0
  271. package/dist/rendering/world3d/Text3D.d.ts +95 -0
  272. package/dist/rendering/world3d/Text3D.js +560 -0
  273. package/dist/rendering/world3d/Texture3D.d.ts +148 -0
  274. package/dist/rendering/world3d/Texture3D.js +270 -0
  275. package/dist/rendering/world3d/Trail3D.d.ts +62 -0
  276. package/dist/rendering/world3d/Trail3D.js +195 -0
  277. package/dist/rendering/world3d/Vehicle3D.d.ts +102 -0
  278. package/dist/rendering/world3d/Vehicle3D.js +228 -0
  279. package/dist/rendering/world3d/VolumetricFog3D.d.ts +57 -0
  280. package/dist/rendering/world3d/VolumetricFog3D.js +230 -0
  281. package/dist/rendering/world3d/Water3D.d.ts +165 -0
  282. package/dist/rendering/world3d/Water3D.js +607 -0
  283. package/dist/rendering/world3d/core3D.d.ts +36 -0
  284. package/dist/rendering/world3d/core3D.js +99 -0
  285. package/dist/rendering/world3d/debug3D.d.ts +69 -0
  286. package/dist/rendering/world3d/debug3D.js +262 -0
  287. package/dist/rendering/world3d/decoders3D.d.ts +42 -0
  288. package/dist/rendering/world3d/decoders3D.js +133 -0
  289. package/dist/rendering/world3d/geometries3D.d.ts +111 -0
  290. package/dist/rendering/world3d/geometries3D.js +610 -0
  291. package/dist/rendering/world3d/helpers3D.d.ts +67 -0
  292. package/dist/rendering/world3d/helpers3D.js +178 -0
  293. package/dist/rendering/world3d/index.d.ts +103 -0
  294. package/dist/rendering/world3d/index.js +62 -0
  295. package/dist/rendering/world3d/math3D.d.ts +114 -0
  296. package/dist/rendering/world3d/math3D.js +675 -0
  297. package/dist/rendering/world3d/primitives3D.d.ts +67 -0
  298. package/dist/rendering/world3d/primitives3D.js +197 -0
  299. package/dist/resources.d.ts +8 -0
  300. package/dist/resources.js +6 -0
  301. package/dist/saveStore.d.ts +71 -0
  302. package/dist/saveStore.js +182 -0
  303. package/dist/semanticList.d.ts +126 -0
  304. package/dist/semanticList.js +175 -0
  305. package/dist/semanticTree.d.ts +10 -0
  306. package/dist/semanticTree.js +539 -0
  307. package/dist/semanticTypes.d.ts +175 -0
  308. package/dist/semanticTypes.js +2 -0
  309. package/dist/semantics.d.ts +6 -0
  310. package/dist/semantics.js +5 -0
  311. package/dist/sequencePlayback.d.ts +19 -0
  312. package/dist/sequencePlayback.js +391 -0
  313. package/dist/sequencePlaybackTypes.d.ts +24 -0
  314. package/dist/sequencePlaybackTypes.js +2 -0
  315. package/dist/sequenceTargetClaims.d.ts +10 -0
  316. package/dist/sequenceTargetClaims.js +31 -0
  317. package/dist/srgbBytes.d.ts +3 -0
  318. package/dist/srgbBytes.js +64 -0
  319. package/dist/startEngine.d.ts +5 -0
  320. package/dist/startEngine.js +31 -0
  321. package/dist/surfaceOwnership.d.ts +3 -0
  322. package/dist/surfaceOwnership.js +15 -0
  323. package/dist/text.d.ts +24 -0
  324. package/dist/text.js +4 -0
  325. package/dist/textField.d.ts +6 -0
  326. package/dist/textField.js +6 -0
  327. package/dist/textTable.d.ts +41 -0
  328. package/dist/textTable.js +114 -0
  329. package/dist/tileMapDraw.d.ts +7 -0
  330. package/dist/tileMapDraw.js +310 -0
  331. package/dist/tiledImport.d.ts +9 -0
  332. package/dist/tiledImport.js +357 -0
  333. package/dist/tilemap.d.ts +5 -0
  334. package/dist/tilemap.js +5 -0
  335. package/dist/tilemapTypes.d.ts +182 -0
  336. package/dist/tilemapTypes.js +2 -0
  337. package/dist/timer.d.ts +34 -0
  338. package/dist/timer.js +119 -0
  339. package/dist/tween.d.ts +15 -0
  340. package/dist/tween.js +329 -0
  341. package/dist/tweenTypes.d.ts +31 -0
  342. package/dist/tweenTypes.js +2 -0
  343. package/dist/ui/controlKeys.d.ts +113 -0
  344. package/dist/ui/controlKeys.js +250 -0
  345. package/dist/ui/controls.d.ts +58 -0
  346. package/dist/ui/controls.js +290 -0
  347. package/dist/ui/editing.d.ts +3 -0
  348. package/dist/ui/editing.js +3 -0
  349. package/dist/ui/index.d.ts +19 -0
  350. package/dist/ui/index.js +11 -0
  351. package/dist/ui/keyboardFocus.d.ts +32 -0
  352. package/dist/ui/keyboardFocus.js +146 -0
  353. package/dist/ui/layerTypes.d.ts +98 -0
  354. package/dist/ui/layerTypes.js +2 -0
  355. package/dist/ui/layers.d.ts +4 -0
  356. package/dist/ui/layers.js +586 -0
  357. package/dist/ui/leafContent.d.ts +21 -0
  358. package/dist/ui/leafContent.js +136 -0
  359. package/dist/ui/rangeControl.d.ts +53 -0
  360. package/dist/ui/rangeControl.js +168 -0
  361. package/dist/ui/scrollControl.d.ts +84 -0
  362. package/dist/ui/scrollControl.js +222 -0
  363. package/dist/ui/stateControls.d.ts +90 -0
  364. package/dist/ui/stateControls.js +331 -0
  365. package/dist/ui/textEditor.d.ts +54 -0
  366. package/dist/ui/textEditor.js +371 -0
  367. package/dist/ui/textEditorTypes.d.ts +85 -0
  368. package/dist/ui/textEditorTypes.js +2 -0
  369. package/dist/ui/textFieldControl.d.ts +100 -0
  370. package/dist/ui/textFieldControl.js +260 -0
  371. package/dist/ui/theme.d.ts +64 -0
  372. package/dist/ui/theme.js +166 -0
  373. package/dist/ui/types.d.ts +285 -0
  374. package/dist/ui/types.js +2 -0
  375. package/dist/ui/uiRoot.d.ts +4 -0
  376. package/dist/ui/uiRoot.js +1526 -0
  377. package/dist/ui/uiRootDisplay.d.ts +46 -0
  378. package/dist/ui/uiRootDisplay.js +148 -0
  379. package/dist/ui/uiRootModel.d.ts +114 -0
  380. package/dist/ui/uiRootModel.js +66 -0
  381. package/dist/ui/virtualList.d.ts +20 -0
  382. package/dist/ui/virtualList.js +105 -0
  383. package/dist/video.d.ts +4 -0
  384. package/dist/video.js +4 -0
  385. package/dist/videoPlayer.d.ts +4 -0
  386. package/dist/videoPlayer.js +215 -0
  387. package/dist/videoTypes.d.ts +77 -0
  388. package/dist/videoTypes.js +2 -0
  389. package/dist/web/BrowserAssetBundle.d.ts +41 -0
  390. package/dist/web/BrowserAssetBundle.js +136 -0
  391. package/dist/web/BrowserAudio.d.ts +74 -0
  392. package/dist/web/BrowserAudio.js +503 -0
  393. package/dist/web/BrowserFrameLoop.d.ts +69 -0
  394. package/dist/web/BrowserFrameLoop.js +125 -0
  395. package/dist/web/BrowserGame.d.ts +174 -0
  396. package/dist/web/BrowserGame.js +473 -0
  397. package/dist/web/BrowserGamepadInput.d.ts +38 -0
  398. package/dist/web/BrowserGamepadInput.js +134 -0
  399. package/dist/web/BrowserHoverInput.d.ts +25 -0
  400. package/dist/web/BrowserHoverInput.js +266 -0
  401. package/dist/web/BrowserImageTextures.d.ts +72 -0
  402. package/dist/web/BrowserImageTextures.js +169 -0
  403. package/dist/web/BrowserInputActions.d.ts +63 -0
  404. package/dist/web/BrowserInputActions.js +345 -0
  405. package/dist/web/BrowserKeyboardInput.d.ts +4 -0
  406. package/dist/web/BrowserKeyboardInput.js +223 -0
  407. package/dist/web/BrowserPlay.d.ts +417 -0
  408. package/dist/web/BrowserPlay.js +1648 -0
  409. package/dist/web/BrowserPointerInput.d.ts +4 -0
  410. package/dist/web/BrowserPointerInput.js +511 -0
  411. package/dist/web/BrowserPreferences.d.ts +10 -0
  412. package/dist/web/BrowserPreferences.js +39 -0
  413. package/dist/web/BrowserSemantics.d.ts +36 -0
  414. package/dist/web/BrowserSemantics.js +418 -0
  415. package/dist/web/BrowserStatsPanel.d.ts +56 -0
  416. package/dist/web/BrowserStatsPanel.js +143 -0
  417. package/dist/web/BrowserStorage.d.ts +35 -0
  418. package/dist/web/BrowserStorage.js +132 -0
  419. package/dist/web/BrowserTextEditor.d.ts +52 -0
  420. package/dist/web/BrowserTextEditor.js +839 -0
  421. package/dist/web/BrowserTextInput.d.ts +89 -0
  422. package/dist/web/BrowserTextInput.js +524 -0
  423. package/dist/web/BrowserTextureProvider.d.ts +58 -0
  424. package/dist/web/BrowserTextureProvider.js +935 -0
  425. package/dist/web/BrowserVideo.d.ts +40 -0
  426. package/dist/web/BrowserVideo.js +237 -0
  427. package/dist/web/CanvasKitFontSetProvider.d.ts +32 -0
  428. package/dist/web/CanvasKitFontSetProvider.js +215 -0
  429. package/dist/web/CanvasKitParagraphProvider.d.ts +173 -0
  430. package/dist/web/CanvasKitParagraphProvider.js +692 -0
  431. package/dist/web/CanvasTextRasterProvider.d.ts +4 -0
  432. package/dist/web/CanvasTextRasterProvider.js +312 -0
  433. package/dist/web/ManifestByteSource.d.ts +151 -0
  434. package/dist/web/ManifestByteSource.js +975 -0
  435. package/dist/web/ManifestFontContentLoader.d.ts +13 -0
  436. package/dist/web/ManifestFontContentLoader.js +30 -0
  437. package/dist/web/MouseInput.d.ts +4 -0
  438. package/dist/web/MouseInput.js +218 -0
  439. package/dist/web/WebGL2Host.d.ts +5 -0
  440. package/dist/web/WebGL2Host.js +2711 -0
  441. package/dist/web/WebGPUHost.d.ts +100 -0
  442. package/dist/web/WebGPUHost.js +3430 -0
  443. package/dist/web/audio.d.ts +3 -0
  444. package/dist/web/audio.js +4 -0
  445. package/dist/web/canvasKitParagraphGeometry.d.ts +27 -0
  446. package/dist/web/canvasKitParagraphGeometry.js +83 -0
  447. package/dist/web/editing.d.ts +5 -0
  448. package/dist/web/editing.js +4 -0
  449. package/dist/web/editorFonts.d.ts +54 -0
  450. package/dist/web/editorFonts.js +297 -0
  451. package/dist/web/game.d.ts +5 -0
  452. package/dist/web/game.js +6 -0
  453. package/dist/web/gamepad.d.ts +3 -0
  454. package/dist/web/gamepad.js +4 -0
  455. package/dist/web/hover.d.ts +3 -0
  456. package/dist/web/hover.js +4 -0
  457. package/dist/web/image.d.ts +4 -0
  458. package/dist/web/image.js +4 -0
  459. package/dist/web/imageProjections2D.d.ts +16 -0
  460. package/dist/web/imageProjections2D.js +2 -0
  461. package/dist/web/input.d.ts +6 -0
  462. package/dist/web/input.js +4 -0
  463. package/dist/web/keyboard.d.ts +3 -0
  464. package/dist/web/keyboard.js +3 -0
  465. package/dist/web/kit.d.ts +11 -0
  466. package/dist/web/kit.js +8 -0
  467. package/dist/web/loop.d.ts +3 -0
  468. package/dist/web/loop.js +4 -0
  469. package/dist/web/paragraph.d.ts +6 -0
  470. package/dist/web/paragraph.js +4 -0
  471. package/dist/web/play.d.ts +10 -0
  472. package/dist/web/play.js +9 -0
  473. package/dist/web/playMusic.d.ts +33 -0
  474. package/dist/web/playMusic.js +194 -0
  475. package/dist/web/playSfx.d.ts +36 -0
  476. package/dist/web/playSfx.js +112 -0
  477. package/dist/web/playTouch.d.ts +45 -0
  478. package/dist/web/playTouch.js +141 -0
  479. package/dist/web/playWidgets.d.ts +71 -0
  480. package/dist/web/playWidgets.js +431 -0
  481. package/dist/web/pointer.d.ts +3 -0
  482. package/dist/web/pointer.js +3 -0
  483. package/dist/web/prepareSharedSubmission2D.d.ts +27 -0
  484. package/dist/web/prepareSharedSubmission2D.js +63 -0
  485. package/dist/web/resources.d.ts +29 -0
  486. package/dist/web/resources.js +96 -0
  487. package/dist/web/semantics.d.ts +3 -0
  488. package/dist/web/semantics.js +4 -0
  489. package/dist/web/sharedDeviceSession.d.ts +64 -0
  490. package/dist/web/sharedDeviceSession.js +2 -0
  491. package/dist/web/sharedEffectShaders.d.ts +13 -0
  492. package/dist/web/sharedEffectShaders.js +181 -0
  493. package/dist/web/sharedFrameUpload.d.ts +25 -0
  494. package/dist/web/sharedFrameUpload.js +2 -0
  495. package/dist/web/sharedHostDeferred.d.ts +7 -0
  496. package/dist/web/sharedHostDeferred.js +12 -0
  497. package/dist/web/sharedRetentionLedger.d.ts +85 -0
  498. package/dist/web/sharedRetentionLedger.js +391 -0
  499. package/dist/web/sharedSubmissionStorage2D.d.ts +56 -0
  500. package/dist/web/sharedSubmissionStorage2D.js +73 -0
  501. package/dist/web/sharedWebGL2Arena.d.ts +40 -0
  502. package/dist/web/sharedWebGL2Arena.js +77 -0
  503. package/dist/web/sharedWebGL2Options.d.ts +33 -0
  504. package/dist/web/sharedWebGL2Options.js +102 -0
  505. package/dist/web/sharedWebGL2Shaders.d.ts +33 -0
  506. package/dist/web/sharedWebGL2Shaders.js +408 -0
  507. package/dist/web/sharedWebGPUOptions.d.ts +41 -0
  508. package/dist/web/sharedWebGPUOptions.js +130 -0
  509. package/dist/web/text.d.ts +3 -0
  510. package/dist/web/text.js +3 -0
  511. package/dist/web/textInput.d.ts +3 -0
  512. package/dist/web/textInput.js +3 -0
  513. package/dist/web/video.d.ts +3 -0
  514. package/dist/web/video.js +4 -0
  515. package/dist/web/webgl2.d.ts +7 -0
  516. package/dist/web/webgl2.js +4 -0
  517. package/dist/web/webgl2LayerState.d.ts +50 -0
  518. package/dist/web/webgl2LayerState.js +102 -0
  519. package/dist/web/webgl2Native.d.ts +72 -0
  520. package/dist/web/webgl2Native.js +572 -0
  521. package/dist/web/webgl2Types.d.ts +150 -0
  522. package/dist/web/webgl2Types.js +2 -0
  523. package/dist/web/webgpu.d.ts +6 -0
  524. package/dist/web/webgpu.js +2 -0
  525. package/dist/web/webgpuBindingCache.d.ts +26 -0
  526. package/dist/web/webgpuBindingCache.js +223 -0
  527. package/dist/web/webgpuBufferPool.d.ts +51 -0
  528. package/dist/web/webgpuBufferPool.js +58 -0
  529. package/dist/web/webgpuImageResidency.d.ts +56 -0
  530. package/dist/web/webgpuImageResidency.js +65 -0
  531. package/dist/web/webgpuLifetime.d.ts +45 -0
  532. package/dist/web/webgpuLifetime.js +64 -0
  533. package/dist/web/webgpuRetentionPool.d.ts +66 -0
  534. package/dist/web/webgpuRetentionPool.js +85 -0
  535. package/dist/web/webgpuSharedPass.d.ts +7 -0
  536. package/dist/web/webgpuSharedPass.js +293 -0
  537. package/dist/web/webgpuSharedResolvePass.d.ts +3 -0
  538. package/dist/web/webgpuSharedResolvePass.js +34 -0
  539. package/dist/web/world3d/Audio3D.d.ts +85 -0
  540. package/dist/web/world3d/Audio3D.js +271 -0
  541. package/dist/web/world3d/BrowserPlay3D.d.ts +295 -0
  542. package/dist/web/world3d/BrowserPlay3D.js +1256 -0
  543. package/dist/web/world3d/FlyControls3D.d.ts +59 -0
  544. package/dist/web/world3d/FlyControls3D.js +162 -0
  545. package/dist/web/world3d/FollowControls3D.d.ts +31 -0
  546. package/dist/web/world3d/FollowControls3D.js +119 -0
  547. package/dist/web/world3d/OrbitControls3D.d.ts +58 -0
  548. package/dist/web/world3d/OrbitControls3D.js +189 -0
  549. package/dist/web/world3d/TransformControls3D.d.ts +37 -0
  550. package/dist/web/world3d/TransformControls3D.js +128 -0
  551. package/dist/web/world3d/WebGL2Renderer3D.d.ts +136 -0
  552. package/dist/web/world3d/WebGL2Renderer3D.js +1175 -0
  553. package/dist/web/world3d/WebGPURenderer3D.d.ts +112 -0
  554. package/dist/web/world3d/WebGPURenderer3D.js +1916 -0
  555. package/dist/web/world3d/World3DView.d.ts +54 -0
  556. package/dist/web/world3d/World3DView.js +79 -0
  557. package/dist/web/world3d/app3D.d.ts +143 -0
  558. package/dist/web/world3d/app3D.js +305 -0
  559. package/dist/web/world3d/assets3D.d.ts +39 -0
  560. package/dist/web/world3d/assets3D.js +112 -0
  561. package/dist/web/world3d/atmosphere3D.d.ts +56 -0
  562. package/dist/web/world3d/atmosphere3D.js +193 -0
  563. package/dist/web/world3d/canvasFont3D.d.ts +21 -0
  564. package/dist/web/world3d/canvasFont3D.js +165 -0
  565. package/dist/web/world3d/frame3D.d.ts +144 -0
  566. package/dist/web/world3d/frame3D.js +388 -0
  567. package/dist/web/world3d/gpuResources3D.d.ts +98 -0
  568. package/dist/web/world3d/gpuResources3D.js +901 -0
  569. package/dist/web/world3d/host3D.d.ts +24 -0
  570. package/dist/web/world3d/host3D.js +61 -0
  571. package/dist/web/world3d/index.d.ts +40 -0
  572. package/dist/web/world3d/index.js +24 -0
  573. package/dist/web/world3d/loaders3D.d.ts +27 -0
  574. package/dist/web/world3d/loaders3D.js +138 -0
  575. package/dist/web/world3d/markers3D.d.ts +53 -0
  576. package/dist/web/world3d/markers3D.js +130 -0
  577. package/dist/web/world3d/materialWebGL23D.d.ts +34 -0
  578. package/dist/web/world3d/materialWebGL23D.js +218 -0
  579. package/dist/web/world3d/overlay3D.d.ts +47 -0
  580. package/dist/web/world3d/overlay3D.js +187 -0
  581. package/dist/web/world3d/post3D.d.ts +116 -0
  582. package/dist/web/world3d/post3D.js +462 -0
  583. package/dist/web/world3d/postWebGL23D.d.ts +24 -0
  584. package/dist/web/world3d/postWebGL23D.js +237 -0
  585. package/dist/web/world3d/postWebGPU3D.d.ts +23 -0
  586. package/dist/web/world3d/postWebGPU3D.js +255 -0
  587. package/dist/web/world3d/probe3D.d.ts +15 -0
  588. package/dist/web/world3d/probe3D.js +66 -0
  589. package/dist/web/world3d/shaders3D.d.ts +43 -0
  590. package/dist/web/world3d/shaders3D.js +851 -0
  591. package/dist/web/world3d/stats3D.d.ts +34 -0
  592. package/dist/web/world3d/stats3D.js +81 -0
  593. package/dist/web/world3d/webGL2FrameMetrics3D.d.ts +71 -0
  594. package/dist/web/world3d/webGL2FrameMetrics3D.js +185 -0
  595. package/dist/web/world3d/webgpu.d.ts +37 -0
  596. package/dist/web/world3d/webgpu.js +23 -0
  597. package/dist/web/world3d/webgpuPacking3D.d.ts +13 -0
  598. package/dist/web/world3d/webgpuPacking3D.js +85 -0
  599. package/dist/web/world3d/wgsl3D.d.ts +68 -0
  600. package/dist/web/world3d/wgsl3D.js +781 -0
  601. package/package.json +220 -4
@@ -0,0 +1,102 @@
1
+ import type { Object3D } from './Object3D.js';
2
+ import { type PhysicsWorld3D, type RigidBody3D } from './Physics3D.js';
3
+ /** The most wheels a vehicle has. */
4
+ export declare const VEHICLE3D_LIMITS: Readonly<{
5
+ readonly maxWheels: 16;
6
+ }>;
7
+ /** A wheel to add: where, its radius and suspension, whether it steers or drives, its grip and the node it turns. */
8
+ export interface WheelOptions3D {
9
+ /** Where the suspension is attached, in the chassis's local frame. */
10
+ readonly position: readonly [number, number, number];
11
+ readonly radius?: number;
12
+ /** Length of the suspension at rest, from the attachment to the wheel's center. Defaults to 0.3. */
13
+ readonly restLength?: number;
14
+ /** Most the suspension may shorten or lengthen from rest. Defaults to 0.2. */
15
+ readonly travel?: number;
16
+ /** Spring strength in force per unit of compression. Defaults to hold a quarter of the chassis at a third of the travel. */
17
+ readonly stiffness?: number;
18
+ /** Damper strength in force per unit of speed. Defaults to a firm ride for the stiffness. */
19
+ readonly damping?: number;
20
+ /** Turns with the steering. */
21
+ readonly steered?: boolean;
22
+ /** Pushes with the engine. */
23
+ readonly driven?: boolean;
24
+ /** Sideways and braking grip as a multiple of the load on the wheel. Defaults to 1.2. */
25
+ readonly grip?: number;
26
+ /** Node placed at the wheel's center and turned with it; give it to a mesh whose axle is its local X axis. */
27
+ readonly node?: Object3D;
28
+ }
29
+ /** A vehicle to make: its wheels, its engine and brakes, its steering, its top speed and how it rolls. */
30
+ export interface VehicleOptions3D {
31
+ readonly wheels: readonly WheelOptions3D[];
32
+ /** Force the engine shares between the driven wheels at full throttle. */
33
+ readonly engineForce?: number;
34
+ /** Force the brakes share between all wheels at full brake. */
35
+ readonly brakeForce?: number;
36
+ /** Largest steering angle in radians. Defaults to 0.6. */
37
+ readonly maxSteer?: number;
38
+ /** Speed along the ground beyond which the engine stops pushing. Defaults to 40. */
39
+ readonly topSpeed?: number;
40
+ /**
41
+ * How much of the tyres' sideways push tips the chassis: 1 applies it at the
42
+ * road, where a real tyre pushes, and lets a tall car roll over in a hard turn;
43
+ * 0 applies it level with the center of mass, so the car never leans. Defaults to 0.2.
44
+ */
45
+ readonly rollInfluence?: number;
46
+ /** Bodies the wheels' rays may land on. Defaults to everything. */
47
+ readonly mask?: number;
48
+ }
49
+ /** A wheel of a vehicle: its suspension and grip, and whether it touches the ground. */
50
+ export interface Wheel3D {
51
+ readonly position: Float64Array;
52
+ radius: number;
53
+ restLength: number;
54
+ travel: number;
55
+ stiffness: number;
56
+ damping: number;
57
+ steered: boolean;
58
+ driven: boolean;
59
+ grip: number;
60
+ node: Object3D | undefined;
61
+ /** True when the wheel's ray reached the ground in the last update. */
62
+ grounded: boolean;
63
+ /** Present length of the suspension. */
64
+ length: number;
65
+ /** Load the wheel carried in the last update, as a force. */
66
+ load: number;
67
+ /** How far the wheel has rolled, in radians. */
68
+ spin: number;
69
+ /** Body under the wheel when grounded. */
70
+ ground: RigidBody3D | undefined;
71
+ /** World position of the contact patch when grounded. */
72
+ readonly contact: Float64Array;
73
+ }
74
+ /**
75
+ * Drives a chassis body on ray wheels. Set `throttle` (-1 to 1), `brake` (0
76
+ * to 1) and `steering` (-1 to 1, positive turns left), then call update() once
77
+ * before each world.step(). The chassis's local -Z is forward and +Y is up.
78
+ */
79
+ export declare class Vehicle3D {
80
+ readonly world: PhysicsWorld3D;
81
+ readonly chassis: RigidBody3D;
82
+ readonly wheels: Wheel3D[];
83
+ engineForce: number;
84
+ brakeForce: number;
85
+ maxSteer: number;
86
+ topSpeed: number;
87
+ rollInfluence: number;
88
+ mask: number;
89
+ throttle: number;
90
+ brake: number;
91
+ steering: number;
92
+ /** Speed along the chassis's forward direction after the last update; negative in reverse. */
93
+ speed: number;
94
+ constructor(world: PhysicsWorld3D, chassis: RigidBody3D, options: VehicleOptions3D);
95
+ /** Number of wheels on the ground after the last update. */
96
+ get groundedWheels(): number;
97
+ /** Apply suspension, engine, brakes and tyre grip for the coming step of `deltaSeconds`. */
98
+ update(deltaSeconds: number): void;
99
+ }
100
+ /** Makes a vehicle of wheels on raycast suspension under a chassis body. */
101
+ export declare function createVehicle3D(world: PhysicsWorld3D, chassis: RigidBody3D, options: VehicleOptions3D): Vehicle3D;
102
+ //# sourceMappingURL=Vehicle3D.d.ts.map
@@ -0,0 +1,228 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // An arcade vehicle: one rigid body for the chassis, and wheels that are not
3
+ // bodies at all. Each wheel looks down along a ray, holds the chassis up with a
4
+ // spring and a damper where the ray meets the ground, and pushes at that point
5
+ // to drive, brake and resist sliding sideways. DOM-free and backend-independent.
6
+ import { World3DError, requireFinite3D, requirePositive3D } from './core3D.js';
7
+ import { raycastExcludingBody3D } from './Physics3D.js';
8
+ /** The most wheels a vehicle has. */
9
+ export const VEHICLE3D_LIMITS = Object.freeze({ maxWheels: 16 });
10
+ const down = new Float64Array(3), forward = new Float64Array(3), side = new Float64Array(3), from = new Float64Array(3), v = new Float64Array(3), w = new Float64Array(3), grip = new Float64Array(3);
11
+ /**
12
+ * Drives a chassis body on ray wheels. Set `throttle` (-1 to 1), `brake` (0
13
+ * to 1) and `steering` (-1 to 1, positive turns left), then call update() once
14
+ * before each world.step(). The chassis's local -Z is forward and +Y is up.
15
+ */
16
+ export class Vehicle3D {
17
+ world;
18
+ chassis;
19
+ wheels = [];
20
+ engineForce;
21
+ brakeForce;
22
+ maxSteer;
23
+ topSpeed;
24
+ rollInfluence;
25
+ mask;
26
+ throttle = 0;
27
+ brake = 0;
28
+ steering = 0;
29
+ /** Speed along the chassis's forward direction after the last update; negative in reverse. */
30
+ speed = 0;
31
+ constructor(world, chassis, options) {
32
+ if (!world || typeof world.raycast !== 'function')
33
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'physics world');
34
+ if (!chassis || chassis.type !== 'dynamic' || chassis.world !== world)
35
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'the chassis is a dynamic body in this world');
36
+ if (!options || !Array.isArray(options.wheels) || options.wheels.length === 0)
37
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'wheels');
38
+ if (options.wheels.length > VEHICLE3D_LIMITS.maxWheels)
39
+ throw new World3DError('WORLD3D_BUDGET', 'wheels');
40
+ this.world = world;
41
+ this.chassis = chassis;
42
+ this.engineForce = requireFinite3D(options.engineForce ?? chassis.mass * 8, 'engineForce');
43
+ this.brakeForce = requireFinite3D(options.brakeForce ?? chassis.mass * 12, 'brakeForce');
44
+ this.maxSteer = requireFinite3D(options.maxSteer ?? 0.6, 'maxSteer');
45
+ this.topSpeed = requirePositive3D(options.topSpeed ?? 40, 'topSpeed');
46
+ this.rollInfluence = Math.min(Math.max(requireFinite3D(options.rollInfluence ?? 0.2, 'rollInfluence'), 0), 1);
47
+ this.mask = options.mask ?? -1;
48
+ const weight = (chassis.mass * Math.hypot(world.gravity[0], world.gravity[1], world.gravity[2])) / options.wheels.length;
49
+ for (const wheel of options.wheels) {
50
+ if (!wheel || !wheel.position)
51
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'wheel position');
52
+ for (const value of wheel.position)
53
+ requireFinite3D(value, 'wheel position');
54
+ const travel = requirePositive3D(wheel.travel ?? 0.2, 'wheel travel');
55
+ // By default the car sits a third of the way into its travel, and the ride settles in about one bounce.
56
+ const stiffness = requirePositive3D(wheel.stiffness ?? Math.max(weight, 1) / (travel / 3), 'wheel stiffness');
57
+ this.wheels.push({
58
+ position: Float64Array.from(wheel.position),
59
+ radius: requirePositive3D(wheel.radius ?? 0.35, 'wheel radius'),
60
+ restLength: requirePositive3D(wheel.restLength ?? 0.3, 'wheel restLength'),
61
+ travel,
62
+ stiffness,
63
+ damping: requireFinite3D(wheel.damping ?? 1.4 * Math.sqrt((stiffness * chassis.mass) / options.wheels.length), 'wheel damping'),
64
+ steered: wheel.steered ?? false,
65
+ driven: wheel.driven ?? false,
66
+ grip: requireFinite3D(wheel.grip ?? 1.2, 'wheel grip'),
67
+ node: wheel.node,
68
+ grounded: false,
69
+ length: wheel.restLength ?? 0.3,
70
+ load: 0,
71
+ spin: 0,
72
+ ground: undefined,
73
+ contact: new Float64Array(3)
74
+ });
75
+ }
76
+ }
77
+ /** Number of wheels on the ground after the last update. */
78
+ get groundedWheels() {
79
+ let count = 0;
80
+ for (const wheel of this.wheels)
81
+ if (wheel.grounded)
82
+ count++;
83
+ return count;
84
+ }
85
+ /** Apply suspension, engine, brakes and tyre grip for the coming step of `deltaSeconds`. */
86
+ update(deltaSeconds) {
87
+ const dt = requireFinite3D(deltaSeconds, 'deltaSeconds');
88
+ if (!(dt > 0))
89
+ return;
90
+ const body = this.chassis, r = body.rotation, p = body.position;
91
+ // Every wheel is worked out from the chassis's motion as the update began, so the order of the wheels does not matter.
92
+ v[0] = body.linearVelocity[0];
93
+ v[1] = body.linearVelocity[1];
94
+ v[2] = body.linearVelocity[2];
95
+ w[0] = body.angularVelocity[0];
96
+ w[1] = body.angularVelocity[1];
97
+ w[2] = body.angularVelocity[2];
98
+ // Chassis axes in the world: right, up and back are the columns of its rotation.
99
+ down[0] = -r[1];
100
+ down[1] = -r[4];
101
+ down[2] = -r[7];
102
+ const fx = -r[2], fy = -r[5], fz = -r[8];
103
+ this.speed = v[0] * fx + v[1] * fy + v[2] * fz;
104
+ const throttle = Math.min(Math.max(this.throttle, -1), 1), braking = Math.min(Math.max(this.brake, 0), 1), steer = Math.min(Math.max(this.steering, -1), 1) * this.maxSteer;
105
+ let driven = 0;
106
+ for (const wheel of this.wheels)
107
+ if (wheel.driven)
108
+ driven++;
109
+ const count = this.wheels.length;
110
+ for (const wheel of this.wheels) {
111
+ const a = wheel.position;
112
+ from[0] = p[0] + r[0] * a[0] + r[1] * a[1] + r[2] * a[2];
113
+ from[1] = p[1] + r[3] * a[0] + r[4] * a[1] + r[5] * a[2];
114
+ from[2] = p[2] + r[6] * a[0] + r[7] * a[1] + r[8] * a[2];
115
+ const reach = wheel.restLength + wheel.travel + wheel.radius;
116
+ const hit = this.world[raycastExcludingBody3D](from, down, reach, this.mask, body);
117
+ wheel.grounded = hit !== undefined;
118
+ wheel.ground = hit?.body;
119
+ wheel.load = 0;
120
+ wheel.length = hit
121
+ ? Math.max(hit.distance - wheel.radius, wheel.restLength - wheel.travel)
122
+ : wheel.restLength + wheel.travel;
123
+ let forwardSpeed = this.speed;
124
+ if (hit) {
125
+ const c = wheel.contact, n = hit.normal;
126
+ c[0] = hit.point[0];
127
+ c[1] = hit.point[1];
128
+ c[2] = hit.point[2];
129
+ // Velocity of the chassis at the contact patch, relative to whatever is under the wheel.
130
+ const rx = c[0] - p[0], ry = c[1] - p[1], rz = c[2] - p[2];
131
+ // Motion of whatever is under the wheel, at the contact patch.
132
+ const other = hit.body;
133
+ let ux = 0, uy = 0, uz = 0;
134
+ if (other.type !== 'static') {
135
+ const ox = c[0] - other.position[0], oy = c[1] - other.position[1], oz = c[2] - other.position[2], ov = other.linearVelocity, ow = other.angularVelocity;
136
+ ux = ov[0] + ow[1] * oz - ow[2] * oy;
137
+ uy = ov[1] + ow[2] * ox - ow[0] * oz;
138
+ uz = ov[2] + ow[0] * oy - ow[1] * ox;
139
+ }
140
+ const px = v[0] + w[1] * rz - w[2] * ry - ux, py = v[1] + w[2] * rx - w[0] * rz - uy, pz = v[2] + w[0] * ry - w[1] * rx - uz;
141
+ // The suspension shortens as fast as the chassis nears the surface, however the car is tilted or travelling along it.
142
+ const facing = Math.max(-(n[0] * down[0] + n[1] * down[1] + n[2] * down[2]), 0.1);
143
+ // Past the end of its travel the spring keeps getting harder rather than giving up, so the car lands on its wheels and not its belly.
144
+ const squeeze = wheel.restLength - (hit.distance - wheel.radius), closing = -(px * n[0] + py * n[1] + pz * n[2]) / facing;
145
+ const load = Math.max(wheel.stiffness * squeeze + wheel.damping * closing, 0);
146
+ wheel.load = load;
147
+ const lift = load * dt;
148
+ body.applyImpulse(-down[0] * lift, -down[1] * lift, -down[2] * lift, c);
149
+ // The wheel's heading on the ground: the chassis's forward, turned by the steering, laid flat on the surface.
150
+ let hx = fx, hy = fy, hz = fz;
151
+ if (wheel.steered && steer !== 0) {
152
+ const cos = Math.cos(steer), sin = Math.sin(steer);
153
+ // Positive steering turns the heading toward the chassis's left.
154
+ hx = fx * cos - r[0] * sin;
155
+ hy = fy * cos - r[3] * sin;
156
+ hz = fz * cos - r[6] * sin;
157
+ }
158
+ const along = hx * n[0] + hy * n[1] + hz * n[2];
159
+ forward[0] = hx - n[0] * along;
160
+ forward[1] = hy - n[1] * along;
161
+ forward[2] = hz - n[2] * along;
162
+ const size = Math.hypot(forward[0], forward[1], forward[2]);
163
+ if (size > 1e-6) {
164
+ forward[0] /= size;
165
+ forward[1] /= size;
166
+ forward[2] /= size;
167
+ side[0] = n[1] * forward[2] - n[2] * forward[1];
168
+ side[1] = n[2] * forward[0] - n[0] * forward[2];
169
+ side[2] = n[0] * forward[1] - n[1] * forward[0];
170
+ forwardSpeed = px * forward[0] + py * forward[1] + pz * forward[2];
171
+ const most = wheel.grip * load * dt, share = body.mass / count;
172
+ // Raise the point the tyre pushes at toward the height of the center of mass, by as much as the car is kept from rolling.
173
+ const rise = (rx * down[0] + ry * down[1] + rz * down[2]) * (1 - this.rollInfluence);
174
+ grip[0] = c[0] - down[0] * rise;
175
+ grip[1] = c[1] - down[1] * rise;
176
+ grip[2] = c[2] - down[2] * rise;
177
+ // Sideways: take out this wheel's share of the slide at that point, as far as its grip allows. How much push
178
+ // that takes depends on how easily the chassis turns about the point, not only on its mass.
179
+ const gx = grip[0] - p[0], gy = grip[1] - p[1], gz = grip[2] - p[2];
180
+ const sideSpeed = (v[0] + w[1] * gz - w[2] * gy - ux) * side[0] +
181
+ (v[1] + w[2] * gx - w[0] * gz - uy) * side[1] +
182
+ (v[2] + w[0] * gy - w[1] * gx - uz) * side[2];
183
+ const tx = gy * side[2] - gz * side[1], ty = gz * side[0] - gx * side[2], tz = gx * side[1] - gy * side[0], m = body.inverseInertiaWorld;
184
+ const yielding = body.inverseMass +
185
+ tx * (m[0] * tx + m[1] * ty + m[2] * tz) +
186
+ ty * (m[3] * tx + m[4] * ty + m[5] * tz) +
187
+ tz * (m[6] * tx + m[7] * ty + m[8] * tz);
188
+ const hold = Math.min(Math.max(-sideSpeed / (yielding * count), -most), most);
189
+ // Along: engine below top speed, then brakes, which can stop the wheel's share of the car but not reverse it.
190
+ let push = wheel.driven && driven > 0 && Math.abs(forwardSpeed) < this.topSpeed
191
+ ? ((throttle * this.engineForce) / driven) * dt
192
+ : 0;
193
+ if (braking > 0) {
194
+ const stop = Math.min(((braking * this.brakeForce) / count) * dt, Math.abs(forwardSpeed) * share);
195
+ push -= Math.sign(forwardSpeed) * stop;
196
+ }
197
+ push = Math.min(Math.max(push, -most), most);
198
+ const ix = side[0] * hold + forward[0] * push, iy = side[1] * hold + forward[1] * push, iz = side[2] * hold + forward[2] * push;
199
+ body.applyImpulse(ix, iy, iz, grip);
200
+ // What the wheels push on is pushed back.
201
+ if (other.type === 'dynamic')
202
+ other.applyImpulse(-ix + down[0] * lift, -iy + down[1] * lift, -iz + down[2] * lift, c);
203
+ }
204
+ }
205
+ wheel.spin += (forwardSpeed / wheel.radius) * dt;
206
+ const node = wheel.node;
207
+ if (node) {
208
+ node.position[0] = from[0] + down[0] * wheel.length;
209
+ node.position[1] = from[1] + down[1] * wheel.length;
210
+ node.position[2] = from[2] + down[2] * wheel.length;
211
+ // Chassis orientation, then the steering about up, then the roll about the axle.
212
+ const q = body.quaternion, half = (wheel.steered ? steer : 0) / 2, sy = Math.sin(half), cy = Math.cos(half), roll = -wheel.spin / 2, sx = Math.sin(roll), cx = Math.cos(roll);
213
+ // (steer about Y) * (roll about X)
214
+ const lx = cy * sx, ly = sy * cx, lz = -sy * sx, lw = cy * cx, x = q[0], y = q[1], z = q[2], s = q[3];
215
+ node.quaternion[0] = s * lx + x * lw + y * lz - z * ly;
216
+ node.quaternion[1] = s * ly - x * lz + y * lw + z * lx;
217
+ node.quaternion[2] = s * lz + x * ly - y * lx + z * lw;
218
+ node.quaternion[3] = s * lw - x * lx - y * ly - z * lz;
219
+ node.markTransformDirty();
220
+ }
221
+ }
222
+ }
223
+ }
224
+ /** Makes a vehicle of wheels on raycast suspension under a chassis body. */
225
+ export function createVehicle3D(world, chassis, options) {
226
+ return new Vehicle3D(world, chassis, options);
227
+ }
228
+ //# sourceMappingURL=Vehicle3D.js.map
@@ -0,0 +1,57 @@
1
+ import { type ColorInput3D } from './Material3D.js';
2
+ import { Mesh3D } from './Mesh3D.js';
3
+ /** Volumetric fog to make: its color and density, its height and falloff, its distance, and how much the sun and lights shine through it. */
4
+ export interface VolumetricFogOptions3D {
5
+ readonly color?: ColorInput3D;
6
+ /** Fog thickness per world unit at `height`. Default 0.02. */
7
+ readonly density?: number;
8
+ /** World height at which the fog has its stated density. Default 0. */
9
+ readonly height?: number;
10
+ /** How quickly the fog thins with height, per world unit; 0 gives uniform fog. Default 0.1. */
11
+ readonly falloff?: number;
12
+ /** The fog is walked no further than this from the camera. Default 120. */
13
+ readonly distance?: number;
14
+ /** -1 to 1: above 0 the fog glows toward each light, as haze around the sun does. Default 0.6. */
15
+ readonly anisotropy?: number;
16
+ /** How strongly directional lights, ambient light, and spot and point lights light the fog. Defaults: 0.3, 0.5 and 1. */
17
+ readonly sunStrength?: number;
18
+ readonly ambientStrength?: number;
19
+ readonly lightStrength?: number;
20
+ }
21
+ /**
22
+ * Add one to the scene's root and keep `receiveShadow` on. Before each draw
23
+ * it places itself in front of whichever camera is rendering. It asks the
24
+ * renderer for the depth of the solid scene, so the walk stops at walls, and
25
+ * it replaces `scene.fog` and the atmosphere post hook rather than adding to
26
+ * them. Each pixel takes 24 steps, each reading every light.
27
+ */
28
+ export declare class VolumetricFog3D extends Mesh3D {
29
+ #private;
30
+ constructor(options?: VolumetricFogOptions3D);
31
+ get density(): number;
32
+ set density(value: number);
33
+ get falloff(): number;
34
+ set falloff(value: number);
35
+ get height(): number;
36
+ set height(value: number);
37
+ get distance(): number;
38
+ set distance(value: number);
39
+ get anisotropy(): number;
40
+ set anisotropy(value: number);
41
+ get sunStrength(): number;
42
+ set sunStrength(value: number);
43
+ get ambientStrength(): number;
44
+ set ambientStrength(value: number);
45
+ get lightStrength(): number;
46
+ set lightStrength(value: number);
47
+ /** Linear RGB fog color. */
48
+ setColor(color: ColorInput3D): void;
49
+ /** Release the geometry and the material. */
50
+ dispose(): void;
51
+ /** Stand just beyond the camera's near plane, turned as it is and large enough to cover its view. */
52
+ private face;
53
+ private amount;
54
+ }
55
+ /** Makes fog that light shines through. */
56
+ export declare function createVolumetricFog3D(options?: VolumetricFogOptions3D): VolumetricFog3D;
57
+ //# sourceMappingURL=VolumetricFog3D.d.ts.map
@@ -0,0 +1,230 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // Fog that is lit: every pixel's view ray is walked through the air, and at
3
+ // each step the fog there scatters the light that reaches it. The sun's
4
+ // shadow map is consulted on the way, so shafts of light and shadow stand in
5
+ // the fog wherever something blocks the sun, whether or not the sun is in
6
+ // view; spot and point lights glow in it too. DOM-free: it is a mesh drawn in
7
+ // front of the camera, with shader hooks in both languages.
8
+ import { World3DError, requireFinite3D } from './core3D.js';
9
+ import { createCustomShader3D, createLambertMaterial3D, setColor3D } from './Material3D.js';
10
+ import { Mesh3D } from './Mesh3D.js';
11
+ import { quatFromRotationMatrix } from './math3D.js';
12
+ import { createQuadGeometry3D } from './primitives3D.js';
13
+ // uniforms: [0] color, density; [1] falloff, height, distance, anisotropy; [2] sun, ambient and local light strength.
14
+ const GLSL = /* glsl */ `
15
+ float fogPhase(float cosine, float g) { return (1.0 - g * g) / pow(max(1.0 + g * g - 2.0 * g * cosine, 0.0001), 1.5); }
16
+ vec4 customFragment(vec4 color, vec3 worldPosition, vec3 normal, vec2 uv) {
17
+ vec4 fog = uCustom[0], shape = uCustom[1], strength = uCustom[2];
18
+ vec3 eye = uCameraPosition.xyz, ray = normalize(worldPosition - eye);
19
+ // How far the ray runs before it meets solid geometry, capped.
20
+ float reach = min(sceneDistance / max(dot(ray, -vec3(uView[0].z, uView[1].z, uView[2].z)), 0.05), shape.z);
21
+ float stride = reach / 24.0, jitter = fract(52.9829189 * fract(dot(surfacePixel, vec2(0.06711056, 0.00583715))));
22
+ vec3 ambient = (uAmbient.rgb + 0.5 * (uHemisphereSky.rgb + uHemisphereGround.rgb)) * strength.y, light = vec3(0.0);
23
+ float clear = 1.0;
24
+ int directionalCount = int(uLightCounts.x), pointCount = int(uLightCounts.y), spotCount = int(uLightCounts.z);
25
+ for (int i = 0; i < 24; i++) {
26
+ vec3 at = eye + ray * ((float(i) + jitter) * stride);
27
+ float through = exp(-fog.a * exp(-shape.x * (at.y - shape.y)) * stride);
28
+ vec3 lit = ambient;
29
+ for (int d = 0; d < directionalCount; d++) {
30
+ float visible = 1.0;
31
+ #ifdef RECEIVE_SHADOW
32
+ if (uDirectionalDirection[d].w >= 0.0) visible = volumeShadow(int(uDirectionalDirection[d].w), at, float(d) == uCascadeInfo.x);
33
+ #endif
34
+ lit += uDirectionalColor[d].rgb * (visible * fogPhase(dot(ray, -uDirectionalDirection[d].xyz), shape.w) * strength.x);
35
+ }
36
+ for (int s = 0; s < spotCount; s++) {
37
+ vec3 toLight = uSpotPosition[s].xyz - at;
38
+ float dist = length(toLight);
39
+ float cone = smoothstep(uSpotCone[s].x, uSpotCone[s].y, dot(-toLight / max(dist, 0.0001), uSpotDirection[s].xyz));
40
+ if (cone <= 0.0) continue;
41
+ float visible = 1.0;
42
+ #ifdef RECEIVE_SHADOW
43
+ if (uSpotDirection[s].w >= 0.0) visible = volumeShadow(int(uSpotDirection[s].w), at, false);
44
+ #endif
45
+ lit += uSpotColor[s].rgb * (rangeFalloff(dist, uSpotPosition[s].w) * cone * visible * strength.z);
46
+ }
47
+ for (int p = 0; p < pointCount; p++) lit += uPointColor[p].rgb * (rangeFalloff(max(distance(uPointPosition[p].xyz, at), 0.5), uPointPosition[p].w) * strength.z);
48
+ light += lit * (clear * (1.0 - through));
49
+ clear *= through;
50
+ }
51
+ float cover = 1.0 - clear;
52
+ return vec4(fog.rgb * light / max(cover, 0.0001), cover);
53
+ }
54
+ `;
55
+ const WGSL = /* wgsl */ `
56
+ fn fogPhase(cosine: f32, g: f32) -> f32 { return (1.0 - g * g) / pow(max(1.0 + g * g - 2.0 * g * cosine, 0.0001), 1.5); }
57
+ fn customFragment(color: vec4f, worldPosition: vec3f, normal: vec3f, uv: vec2f) -> vec4f {
58
+ let fog = material.custom[0];
59
+ let shape = material.custom[1];
60
+ let strength = material.custom[2];
61
+ let eye = frame.cameraPosition.xyz;
62
+ let ray = normalize(worldPosition - eye);
63
+ // How far the ray runs before it meets solid geometry, capped.
64
+ let reach = min(sceneDistance / max(dot(ray, -vec3f(frame.view[0].z, frame.view[1].z, frame.view[2].z)), 0.05), shape.z);
65
+ let stride = reach / 24.0;
66
+ let jitter = fract(52.9829189 * fract(dot(surfacePixel, vec2f(0.06711056, 0.00583715))));
67
+ let ambient = (frame.ambient.rgb + 0.5 * (frame.hemisphereSky.rgb + frame.hemisphereGround.rgb)) * strength.y;
68
+ var light = vec3f(0.0);
69
+ var clear = 1.0;
70
+ let directionalCount = i32(frame.lightCounts.x);
71
+ let pointCount = i32(frame.lightCounts.y);
72
+ let spotCount = i32(frame.lightCounts.z);
73
+ for (var i = 0; i < 24; i++) {
74
+ let at = eye + ray * ((f32(i) + jitter) * stride);
75
+ let through = exp(-fog.a * exp(-shape.x * (at.y - shape.y)) * stride);
76
+ var lit = ambient;
77
+ for (var d = 0; d < directionalCount; d++) {
78
+ var visible = 1.0;
79
+ if (frame.directionalDirection[d].w >= 0.0) { visible = volumeShadow(i32(frame.directionalDirection[d].w), at, f32(d) == frame.cascadeInfo.x); }
80
+ lit += frame.directionalColor[d].rgb * (visible * fogPhase(dot(ray, -frame.directionalDirection[d].xyz), shape.w) * strength.x);
81
+ }
82
+ for (var s = 0; s < spotCount; s++) {
83
+ let toLight = frame.spotPosition[s].xyz - at;
84
+ let dist = length(toLight);
85
+ let cone = smoothstep(frame.spotCone[s].x, frame.spotCone[s].y, dot(-toLight / max(dist, 0.0001), frame.spotDirection[s].xyz));
86
+ if (cone <= 0.0) { continue; }
87
+ var visible = 1.0;
88
+ if (frame.spotDirection[s].w >= 0.0) { visible = volumeShadow(i32(frame.spotDirection[s].w), at, false); }
89
+ lit += frame.spotColor[s].rgb * (rangeFalloff(dist, frame.spotPosition[s].w) * cone * visible * strength.z);
90
+ }
91
+ for (var p = 0; p < pointCount; p++) { lit += frame.pointColor[p].rgb * (rangeFalloff(max(distance(frame.pointPosition[p].xyz, at), 0.5), frame.pointPosition[p].w) * strength.z); }
92
+ light += lit * (clear * (1.0 - through));
93
+ clear *= through;
94
+ }
95
+ let cover = 1.0 - clear;
96
+ return vec4f(fog.rgb * light / max(cover, 0.0001), cover);
97
+ }
98
+ `;
99
+ /**
100
+ * Add one to the scene's root and keep `receiveShadow` on. Before each draw
101
+ * it places itself in front of whichever camera is rendering. It asks the
102
+ * renderer for the depth of the solid scene, so the walk stops at walls, and
103
+ * it replaces `scene.fog` and the atmosphere post hook rather than adding to
104
+ * them. Each pixel takes 24 steps, each reading every light.
105
+ */
106
+ export class VolumetricFog3D extends Mesh3D {
107
+ #uniforms;
108
+ #basis = new Float32Array(16);
109
+ constructor(options = {}) {
110
+ const material = createLambertMaterial3D({
111
+ color: 0x000000,
112
+ alphaMode: 'blend',
113
+ depthTest: false,
114
+ depthWrite: false,
115
+ fog: false,
116
+ side: 'double'
117
+ });
118
+ const shader = createCustomShader3D({ key: 'world3d-volumetric-fog', glsl: GLSL, wgsl: WGSL });
119
+ material.shader = shader;
120
+ // Asks for the depth image; next to the camera the fade it also brings is always complete.
121
+ material.softness = 1e-3;
122
+ super(createQuadGeometry3D(), material);
123
+ this.name = 'volumetric-fog';
124
+ this.castShadow = false;
125
+ this.receiveShadow = true;
126
+ this.frustumCulled = false;
127
+ this.pickable = false;
128
+ this.renderOrder = 1000;
129
+ this.#uniforms = shader.uniforms;
130
+ setColor3D(this.#uniforms.subarray(0, 3), options.color ?? 0xc8d4e0);
131
+ this.density = options.density ?? 0.02;
132
+ this.height = options.height ?? 0;
133
+ this.falloff = options.falloff ?? 0.1;
134
+ this.distance = options.distance ?? 120;
135
+ this.anisotropy = options.anisotropy ?? 0.6;
136
+ this.sunStrength = options.sunStrength ?? 0.3;
137
+ this.ambientStrength = options.ambientStrength ?? 0.5;
138
+ this.lightStrength = options.lightStrength ?? 1;
139
+ this.beforeRender = (camera) => this.face(camera);
140
+ }
141
+ get density() {
142
+ return this.#uniforms[3];
143
+ }
144
+ set density(value) {
145
+ this.#uniforms[3] = this.amount(value, 'density');
146
+ }
147
+ get falloff() {
148
+ return this.#uniforms[4];
149
+ }
150
+ set falloff(value) {
151
+ this.#uniforms[4] = this.amount(value, 'falloff');
152
+ }
153
+ get height() {
154
+ return this.#uniforms[5];
155
+ }
156
+ set height(value) {
157
+ this.#uniforms[5] = requireFinite3D(value, 'height');
158
+ }
159
+ get distance() {
160
+ return this.#uniforms[6];
161
+ }
162
+ set distance(value) {
163
+ this.#uniforms[6] = this.amount(value, 'distance');
164
+ }
165
+ get anisotropy() {
166
+ return this.#uniforms[7];
167
+ }
168
+ set anisotropy(value) {
169
+ if (!(Math.abs(requireFinite3D(value, 'anisotropy')) < 1))
170
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'anisotropy');
171
+ this.#uniforms[7] = value;
172
+ }
173
+ get sunStrength() {
174
+ return this.#uniforms[8];
175
+ }
176
+ set sunStrength(value) {
177
+ this.#uniforms[8] = this.amount(value, 'sunStrength');
178
+ }
179
+ get ambientStrength() {
180
+ return this.#uniforms[9];
181
+ }
182
+ set ambientStrength(value) {
183
+ this.#uniforms[9] = this.amount(value, 'ambientStrength');
184
+ }
185
+ get lightStrength() {
186
+ return this.#uniforms[10];
187
+ }
188
+ set lightStrength(value) {
189
+ this.#uniforms[10] = this.amount(value, 'lightStrength');
190
+ }
191
+ /** Linear RGB fog color. */
192
+ setColor(color) {
193
+ setColor3D(this.#uniforms.subarray(0, 3), color);
194
+ }
195
+ /** Release the geometry and the material. */
196
+ dispose() {
197
+ this.geometry.dispose();
198
+ if (!Array.isArray(this.material))
199
+ this.material.dispose();
200
+ }
201
+ /** Stand just beyond the camera's near plane, turned as it is and large enough to cover its view. */
202
+ face(camera) {
203
+ camera.updateWorldMatrix();
204
+ const eye = camera.matrixWorld, basis = this.#basis, p = camera.projectionMatrix;
205
+ for (let column = 0; column < 3; column++) {
206
+ const x = eye[column * 4], y = eye[column * 4 + 1], z = eye[column * 4 + 2], length = Math.hypot(x, y, z) || 1;
207
+ basis[column * 4] = x / length;
208
+ basis[column * 4 + 1] = y / length;
209
+ basis[column * 4 + 2] = z / length;
210
+ }
211
+ quatFromRotationMatrix(this.quaternion, basis);
212
+ // Twice the near distance keeps clear of the near plane; the projection's scale terms say how wide the view is there.
213
+ const perspective = p[15] === 0, away = perspective ? Math.max(camera.near * 2, 1e-3) : camera.near + (camera.far - camera.near) * 0.01;
214
+ const halfWidth = ((perspective ? away : 1) * (1 + Math.abs(p[8]))) / Math.max(Math.abs(p[0]), 1e-6), halfHeight = ((perspective ? away : 1) * (1 + Math.abs(p[9]))) / Math.max(Math.abs(p[5]), 1e-6);
215
+ this.setPosition(eye[12] - basis[8] * away, eye[13] - basis[9] * away, eye[14] - basis[10] * away);
216
+ this.setScale(halfWidth * 2.2, halfHeight * 2.2, 1);
217
+ this.markTransformDirty();
218
+ this.updateWorldMatrix();
219
+ }
220
+ amount(value, field) {
221
+ if (requireFinite3D(value, field) < 0)
222
+ throw new World3DError('WORLD3D_INPUT_INVALID', field);
223
+ return value;
224
+ }
225
+ }
226
+ /** Makes fog that light shines through. */
227
+ export function createVolumetricFog3D(options = {}) {
228
+ return new VolumetricFog3D(options);
229
+ }
230
+ //# sourceMappingURL=VolumetricFog3D.js.map