@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,51 @@
1
+ import { Geometry3D } from './Geometry3D.js';
2
+ import type { ColorInput3D } from './Material3D.js';
3
+ export interface GeometryPart3D {
4
+ /** Where the part goes; [0, 0, 0] by default. */
5
+ readonly position?: readonly [number, number, number];
6
+ /** Euler angles in radians, applied X then Y then Z, as `quatFromEuler`. Ignored when `quaternion` is given. */
7
+ readonly rotation?: readonly [number, number, number];
8
+ readonly quaternion?: readonly [number, number, number, number];
9
+ /** One number for all three axes, or one per axis. */
10
+ readonly scale?: number | readonly [number, number, number];
11
+ /** A 4 x 4 column-major matrix that places the part, instead of position, rotation and scale. */
12
+ readonly matrix?: ArrayLike<number>;
13
+ /** A hex colour as seen on screen, or linear RGB; white by default. */
14
+ readonly color?: ColorInput3D;
15
+ /** Multiplies each vertex colour already in the part, as for shading baked into it. */
16
+ readonly keepColors?: boolean;
17
+ }
18
+ export interface GeometryBuilder3D {
19
+ /** Parts added so far. */
20
+ readonly parts: number;
21
+ /** Vertices added so far. */
22
+ readonly vertexCount: number;
23
+ /** Adds a placed, coloured copy of `geometry`; the geometry itself is not changed. */
24
+ add(geometry: Geometry3D, part?: GeometryPart3D): this;
25
+ /** One geometry with position, normal, uv (when every part has one) and colour; the builder is emptied. */
26
+ build(): Geometry3D;
27
+ }
28
+ /** A builder that merges placed, coloured parts into one geometry. */
29
+ export declare function createGeometryBuilder3D(): GeometryBuilder3D;
30
+ /** A hex colour as seen on screen in the linear RGB the renderer lights, for vertex colours written by hand. */
31
+ export declare function linearColor3D(hex: number): [number, number, number];
32
+ /** Where a world point falls in a viewport, for labels, markers and pointers drawn over the picture. */
33
+ export interface ViewportPoint3D {
34
+ /** Pixels from the viewport's left and top edges. */
35
+ x: number;
36
+ y: number;
37
+ /** Normalized depth, -1 at the near plane and 1 at the far plane. */
38
+ depth: number;
39
+ /** False when the point is behind the camera; x and y then point the way it lies, mirrored back. */
40
+ inFront: boolean;
41
+ /** True when the point is in front of the camera and inside the viewport. */
42
+ onScreen: boolean;
43
+ }
44
+ /**
45
+ * Projects a world point into a viewport of `width` by `height` pixels through `camera`. Call
46
+ * `camera.updateViewMatrices()` first, or use it after the frame was drawn.
47
+ */
48
+ export declare function projectToViewport3D(camera: {
49
+ readonly viewProjectionMatrix: ArrayLike<number>;
50
+ }, point: ArrayLike<number>, width: number, height: number, out?: ViewportPoint3D): ViewportPoint3D;
51
+ //# sourceMappingURL=GeometryBuilder3D.d.ts.map
@@ -0,0 +1,196 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // Puts many placed, coloured parts into one geometry: models made in code (a
3
+ // truck from boxes, a soldier from tapered limbs) and static scenery that
4
+ // should draw in one call. Each part is a copy of a geometry moved by a
5
+ // position, rotation and scale or by a matrix, with one colour written into the
6
+ // vertex colours. Colours are given the way they look on screen and stored as
7
+ // the linear values the renderer lights.
8
+ import { World3DError } from './core3D.js';
9
+ import { Attribute3D, Geometry3D } from './Geometry3D.js';
10
+ import { colorFromHex, mat3NormalFromMat4, mat4Compose, quatFromEuler, srgbToLinear } from './math3D.js';
11
+ const UP_LIMIT = 4294967295;
12
+ function color3(input) {
13
+ const out = new Float32Array([1, 1, 1]);
14
+ if (input === undefined)
15
+ return out;
16
+ if (typeof input === 'number')
17
+ return colorFromHex(out, input);
18
+ if (Array.isArray(input) && input.length === 3 && input.every(Number.isFinite)) {
19
+ out.set(input);
20
+ return out;
21
+ }
22
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'part color');
23
+ }
24
+ function triple(value, fallback, what) {
25
+ if (value === undefined)
26
+ return [fallback, fallback, fallback];
27
+ if (typeof value === 'number' && Number.isFinite(value))
28
+ return [value, value, value];
29
+ if (Array.isArray(value) && value.length === 3 && value.every(Number.isFinite))
30
+ return value;
31
+ throw new World3DError('WORLD3D_INPUT_INVALID', what);
32
+ }
33
+ function placement(part) {
34
+ const m = new Float32Array(16);
35
+ if (part.matrix !== undefined) {
36
+ if (!part.matrix || part.matrix.length !== 16 || !Array.from(part.matrix).every(Number.isFinite))
37
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'part matrix');
38
+ m.set(Array.from(part.matrix));
39
+ return m;
40
+ }
41
+ const t = triple(part.position, 0, 'part position');
42
+ const s = triple(part.scale, 1, 'part scale');
43
+ let q;
44
+ if (part.quaternion !== undefined) {
45
+ if (!Array.isArray(part.quaternion) || part.quaternion.length !== 4 || !part.quaternion.every(Number.isFinite))
46
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'part quaternion');
47
+ q = part.quaternion;
48
+ }
49
+ else {
50
+ const r = triple(part.rotation, 0, 'part rotation');
51
+ q = quatFromEuler(new Float32Array(4), r[0], r[1], r[2]);
52
+ }
53
+ return mat4Compose(m, t, q, s);
54
+ }
55
+ /** A builder that merges placed, coloured parts into one geometry. */
56
+ export function createGeometryBuilder3D() {
57
+ let pieces = [], vertices = 0;
58
+ const builder = {
59
+ get parts() {
60
+ return pieces.length;
61
+ },
62
+ get vertexCount() {
63
+ return vertices;
64
+ },
65
+ add(geometry, part = {}) {
66
+ if (!(geometry instanceof Geometry3D) || geometry.isDisposed)
67
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'geometry');
68
+ if (geometry.topology !== 'triangles')
69
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'part topology');
70
+ if (typeof part !== 'object' || part === null)
71
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'part');
72
+ const position = geometry.getAttribute('position');
73
+ if (!position || position.itemSize !== 3)
74
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'part position data');
75
+ const count = position.count;
76
+ if (vertices + count > UP_LIMIT)
77
+ throw new World3DError('WORLD3D_BUDGET', 'vertices');
78
+ const m = placement(part);
79
+ const n = mat3NormalFromMat4(new Float32Array(9), m);
80
+ const tint = color3(part.color);
81
+ const src = position.data;
82
+ const positions = new Float32Array(count * 3);
83
+ for (let i = 0; i < count; i++) {
84
+ const x = src[i * 3], y = src[i * 3 + 1], z = src[i * 3 + 2];
85
+ positions[i * 3] = m[0] * x + m[4] * y + m[8] * z + m[12];
86
+ positions[i * 3 + 1] = m[1] * x + m[5] * y + m[9] * z + m[13];
87
+ positions[i * 3 + 2] = m[2] * x + m[6] * y + m[10] * z + m[14];
88
+ }
89
+ let normals;
90
+ const normal = geometry.getAttribute('normal');
91
+ if (normal && normal.itemSize === 3) {
92
+ normals = new Float32Array(count * 3);
93
+ const d = normal.data;
94
+ for (let i = 0; i < count; i++) {
95
+ const x = d[i * 3], y = d[i * 3 + 1], z = d[i * 3 + 2];
96
+ const nx = n[0] * x + n[3] * y + n[6] * z, ny = n[1] * x + n[4] * y + n[7] * z, nz = n[2] * x + n[5] * y + n[8] * z;
97
+ const length = Math.hypot(nx, ny, nz) || 1;
98
+ normals[i * 3] = nx / length;
99
+ normals[i * 3 + 1] = ny / length;
100
+ normals[i * 3 + 2] = nz / length;
101
+ }
102
+ }
103
+ let uvs;
104
+ const uv = geometry.getAttribute('uv');
105
+ if (uv && uv.itemSize === 2)
106
+ uvs = Float32Array.from(uv.data);
107
+ const colors = new Float32Array(count * 3);
108
+ const own = part.keepColors ? geometry.getAttribute('color') : undefined;
109
+ for (let i = 0; i < count; i++)
110
+ for (let c = 0; c < 3; c++)
111
+ colors[i * 3 + c] = tint[c] * (own ? own.data[i * own.itemSize + c] : 1);
112
+ // A mirrored placement turns triangles inside out; their winding is flipped back.
113
+ const det = m[0] * (m[5] * m[10] - m[6] * m[9]) -
114
+ m[4] * (m[1] * m[10] - m[2] * m[9]) +
115
+ m[8] * (m[1] * m[6] - m[2] * m[5]);
116
+ const index = geometry.index;
117
+ const indices = index
118
+ ? Uint32Array.from(index.data)
119
+ : Uint32Array.from({ length: count }, (_, i) => i);
120
+ if (det < 0)
121
+ for (let i = 0; i + 2 < indices.length; i += 3) {
122
+ const a = indices[i + 1];
123
+ indices[i + 1] = indices[i + 2];
124
+ indices[i + 2] = a;
125
+ }
126
+ pieces.push({ positions, normals, uvs, colors, indices });
127
+ vertices += count;
128
+ return builder;
129
+ },
130
+ build() {
131
+ if (pieces.length === 0)
132
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'no parts');
133
+ const withNormals = pieces.every(piece => piece.normals), withUvs = pieces.every(piece => piece.uvs);
134
+ const indexTotal = pieces.reduce((sum, piece) => sum + piece.indices.length, 0);
135
+ const positions = new Float32Array(vertices * 3), colors = new Float32Array(vertices * 3), normals = withNormals ? new Float32Array(vertices * 3) : undefined, uvs = withUvs ? new Float32Array(vertices * 2) : undefined, indices = vertices > 65535 ? new Uint32Array(indexTotal) : new Uint16Array(indexTotal);
136
+ let v = 0, k = 0;
137
+ for (const piece of pieces) {
138
+ positions.set(piece.positions, v * 3);
139
+ colors.set(piece.colors, v * 3);
140
+ if (normals)
141
+ normals.set(piece.normals, v * 3);
142
+ if (uvs)
143
+ uvs.set(piece.uvs, v * 2);
144
+ for (let i = 0; i < piece.indices.length; i++)
145
+ indices[k + i] = piece.indices[i] + v;
146
+ v += piece.positions.length / 3;
147
+ k += piece.indices.length;
148
+ }
149
+ const geometry = new Geometry3D();
150
+ geometry.setAttribute('position', new Attribute3D(positions, 3));
151
+ if (normals)
152
+ geometry.setAttribute('normal', new Attribute3D(normals, 3));
153
+ if (uvs)
154
+ geometry.setAttribute('uv', new Attribute3D(uvs, 2));
155
+ geometry.setAttribute('color', new Attribute3D(colors, 3));
156
+ geometry.setIndex(indices);
157
+ if (!normals)
158
+ geometry.computeNormals();
159
+ pieces = [];
160
+ vertices = 0;
161
+ return geometry;
162
+ }
163
+ };
164
+ return builder;
165
+ }
166
+ /** A hex colour as seen on screen in the linear RGB the renderer lights, for vertex colours written by hand. */
167
+ export function linearColor3D(hex) {
168
+ if (!Number.isInteger(hex) || hex < 0 || hex > 0xffffff)
169
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'hex');
170
+ return [
171
+ srgbToLinear(((hex >> 16) & 255) / 255),
172
+ srgbToLinear(((hex >> 8) & 255) / 255),
173
+ srgbToLinear((hex & 255) / 255)
174
+ ];
175
+ }
176
+ /**
177
+ * Projects a world point into a viewport of `width` by `height` pixels through `camera`. Call
178
+ * `camera.updateViewMatrices()` first, or use it after the frame was drawn.
179
+ */
180
+ export function projectToViewport3D(camera, point, width, height, out = { x: 0, y: 0, depth: 0, inFront: false, onScreen: false }) {
181
+ if (!camera?.viewProjectionMatrix || !(width > 0) || !(height > 0))
182
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'viewport');
183
+ const m = camera.viewProjectionMatrix, x = point[0], y = point[1], z = point[2];
184
+ const cx = m[0] * x + m[4] * y + m[8] * z + m[12], cy = m[1] * x + m[5] * y + m[9] * z + m[13], cz = m[2] * x + m[6] * y + m[10] * z + m[14], cw = m[3] * x + m[7] * y + m[11] * z + m[15];
185
+ const inFront = cw > 1e-6;
186
+ // Behind the camera the division flips the point; dividing by |w| keeps it on the side where it lies.
187
+ const w = Math.abs(cw) > 1e-6 ? Math.abs(cw) : 1e-6;
188
+ const nx = cx / w, ny = cy / w;
189
+ out.x = (nx * 0.5 + 0.5) * width;
190
+ out.y = (0.5 - ny * 0.5) * height;
191
+ out.depth = cz / w;
192
+ out.inFront = inFront;
193
+ out.onScreen = inFront && nx >= -1 && nx <= 1 && ny >= -1 && ny <= 1 && out.depth <= 1;
194
+ return out;
195
+ }
196
+ //# sourceMappingURL=GeometryBuilder3D.js.map
@@ -0,0 +1,75 @@
1
+ import type { Camera3D } from './Camera3D.js';
2
+ import { Object3D } from './Object3D.js';
3
+ export type GizmoMode3D = 'translate' | 'rotate' | 'scale';
4
+ export type GizmoSpace3D = 'world' | 'local';
5
+ /** A single axis, a plane spanned by two axes, or 'xyz' for the center handle of the scale mode. */
6
+ export type GizmoHandle3D = 'x' | 'y' | 'z' | 'xy' | 'yz' | 'xz' | 'xyz';
7
+ export interface TransformGizmoOptions3D {
8
+ readonly mode?: GizmoMode3D;
9
+ readonly space?: GizmoSpace3D;
10
+ /** Length of the handles as a share of the view height. Defaults to 0.18. */
11
+ readonly size?: number;
12
+ }
13
+ export declare class TransformGizmo3D extends Object3D {
14
+ #private;
15
+ readonly camera: Camera3D;
16
+ mode: GizmoMode3D;
17
+ space: GizmoSpace3D;
18
+ size: number;
19
+ /** Step sizes for dragging: world units, radians and scale factor. Undefined moves freely. */
20
+ translationSnap: number | undefined;
21
+ rotationSnap: number | undefined;
22
+ scaleSnap: number | undefined;
23
+ enabled: boolean;
24
+ /** Called while a drag changes the attached object. */
25
+ onChange: ((object: Object3D) => void) | undefined;
26
+ /** Called when a drag starts (true) or ends (false), for example to pause camera controls. */
27
+ onDraggingChanged: ((dragging: boolean) => void) | undefined;
28
+ constructor(camera: Camera3D, options?: TransformGizmoOptions3D);
29
+ /** The object being edited. */
30
+ get object(): Object3D | undefined;
31
+ get dragging(): boolean;
32
+ /** The handle under the last hover ray, or the one being dragged. */
33
+ get activeHandle(): GizmoHandle3D | undefined;
34
+ attach(object: Object3D): this;
35
+ detach(): this;
36
+ private handleMaterial;
37
+ private part;
38
+ private build;
39
+ /** World scale that keeps the handles the same size on screen. */
40
+ private screenScale;
41
+ /** World pose of the attached object. */
42
+ private pose;
43
+ /**
44
+ * Place the handles on the attached object and size them for the camera.
45
+ * Call once per frame before rendering, after moving the camera or object.
46
+ */
47
+ update(): void;
48
+ private highlight;
49
+ /** World directions of the three handle axes. */
50
+ private axes;
51
+ /** Handle met by a world-space ray, or undefined. Also sets the highlight. */
52
+ hover(origin: ArrayLike<number>, direction: ArrayLike<number>): GizmoHandle3D | undefined;
53
+ private pick;
54
+ private raySphere;
55
+ /** Distance along the line (point, axis) at which it comes closest to a ray. */
56
+ private alongAxis;
57
+ /** Point where a ray meets the plane through `point` with normal `normal`, or undefined when it runs alongside. */
58
+ private onPlane;
59
+ /** Direction from the object toward the camera, used as a drag plane that always faces the viewer. */
60
+ private towardCamera;
61
+ /** Start dragging the handle under the ray. Returns false when the ray misses every handle. */
62
+ beginDrag(origin: ArrayLike<number>, direction: ArrayLike<number>): boolean;
63
+ /** Continue a drag with the current ray, updating the attached object. */
64
+ drag(origin: ArrayLike<number>, direction: ArrayLike<number>): void;
65
+ /** Finish the current drag, keeping the object where it is. */
66
+ endDrag(): void;
67
+ /** Abandon the current drag and put the object back where it started. */
68
+ cancelDrag(): void;
69
+ private setWorldPosition;
70
+ private setWorldQuaternion;
71
+ /** Release the handle geometry and materials. */
72
+ dispose(): void;
73
+ }
74
+ export declare function createTransformGizmo3D(camera: Camera3D, options?: TransformGizmoOptions3D): TransformGizmo3D;
75
+ //# sourceMappingURL=Gizmo3D.d.ts.map