@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,133 @@
1
+ import { Resource3D } from './core3D.js';
2
+ export type TextureWrap3D = 'repeat' | 'clamp' | 'mirror';
3
+ export type TextureFilter3D = 'nearest' | 'linear';
4
+ export type TextureColorSpace3D = 'srgb' | 'linear';
5
+ export declare const TEXTURE3D_LIMITS: Readonly<{
6
+ readonly maxEdge: 8192;
7
+ readonly maxBytes: 268435456;
8
+ }>;
9
+ /** Tightly packed straight-alpha RGBA8 rows, top row first. */
10
+ export interface TexturePixels3D {
11
+ readonly width: number;
12
+ readonly height: number;
13
+ readonly data: Uint8Array;
14
+ }
15
+ /** Owned pixels, or a host image object carrying its own dimensions. */
16
+ /** Block-compressed GPU formats that can be uploaded without transcoding. */
17
+ export type CompressedFormat3D = 'bc1' | 'bc3' | 'bc7' | 'etc2-rgb8' | 'etc2-rgba8' | 'astc-4x4';
18
+ /** Bytes per 4x4 block of each compressed format. */
19
+ export declare const COMPRESSED_BLOCK_BYTES_3D: Readonly<Record<CompressedFormat3D, number>>;
20
+ /**
21
+ * A pre-compressed mip chain, largest level first. Each level halves the
22
+ * previous one and stores whole 4x4 blocks. Support depends on the device:
23
+ * ask the renderer with supportsCompressedFormat() before choosing a format.
24
+ */
25
+ export interface CompressedPixels3D {
26
+ readonly width: number;
27
+ readonly height: number;
28
+ readonly format: CompressedFormat3D;
29
+ readonly levels: readonly Uint8Array[];
30
+ }
31
+ export type TextureSource3D = TexturePixels3D | CompressedPixels3D | object;
32
+ export declare function isCompressedPixels3D(source: unknown): source is CompressedPixels3D;
33
+ export interface TextureOptions3D {
34
+ readonly name?: string;
35
+ readonly wrapS?: TextureWrap3D;
36
+ readonly wrapT?: TextureWrap3D;
37
+ readonly magFilter?: TextureFilter3D;
38
+ readonly minFilter?: TextureFilter3D;
39
+ readonly mipmaps?: boolean;
40
+ readonly colorSpace?: TextureColorSpace3D;
41
+ readonly flipY?: boolean;
42
+ readonly anisotropy?: number;
43
+ /** Texture coordinate set to sample with: 0 for `uv`, 1 for `uv1`. */
44
+ readonly channel?: 0 | 1;
45
+ }
46
+ export declare function isTexturePixels3D(source: unknown): source is TexturePixels3D;
47
+ declare abstract class TextureBase3D extends Resource3D {
48
+ wrapS: TextureWrap3D;
49
+ wrapT: TextureWrap3D;
50
+ magFilter: TextureFilter3D;
51
+ minFilter: TextureFilter3D;
52
+ /** Generate a full mip chain and sample it trilinearly. */
53
+ mipmaps: boolean;
54
+ /** Color textures are 'srgb'; data textures (normal, roughness, occlusion) are 'linear'. */
55
+ colorSpace: TextureColorSpace3D;
56
+ /**
57
+ * Flip rows at upload so V = 0 addresses the bottom row. glTF textures keep this false.
58
+ * WebGL ignores the flag for ImageBitmap sources: decode those with `imageOrientation: 'flipY'`
59
+ * instead, as loadTexture3D does.
60
+ */
61
+ flipY: boolean;
62
+ anisotropy: number;
63
+ /**
64
+ * Texture coordinate set used when this texture is a material's occlusion
65
+ * or emissive map: 0 reads `uv`, 1 reads `uv1`, the usual home of baked
66
+ * lighting. Other map slots always use `uv`.
67
+ */
68
+ channel: 0 | 1;
69
+ protected constructor(options: TextureOptions3D);
70
+ }
71
+ export declare class Texture3D extends TextureBase3D {
72
+ #private;
73
+ /** UV transform applied as: uv' = rotate(uv * repeat) + offset. */
74
+ readonly offset: Float32Array<ArrayBuffer>;
75
+ readonly repeat: Float32Array<ArrayBuffer>;
76
+ rotation: number;
77
+ constructor(source: TextureSource3D, options?: TextureOptions3D);
78
+ get source(): TextureSource3D;
79
+ /** Replace the pixel source and schedule a backend upload. */
80
+ setSource(source: TextureSource3D): void;
81
+ /** True when offset, repeat or rotation differ from the identity transform. */
82
+ get hasTransform(): boolean;
83
+ }
84
+ /** Six square faces in +X, -X, +Y, -Y, +Z, -Z order. */
85
+ export declare class CubeTexture3D extends TextureBase3D {
86
+ readonly faces: readonly TextureSource3D[];
87
+ constructor(faces: readonly TextureSource3D[], options?: TextureOptions3D);
88
+ }
89
+ /** Single-color 1x1 texture, useful as a placeholder or constant map. */
90
+ export declare function createSolidTexture3D(r: number, g: number, b: number, a?: number, options?: TextureOptions3D): Texture3D;
91
+ /** Color storage of a render target: 8-bit sRGB, or half-float linear for values above 1. */
92
+ export type RenderTargetFormat3D = 'rgba8' | 'rgba16f';
93
+ export interface RenderTargetOptions3D {
94
+ readonly name?: string;
95
+ /**
96
+ * 'rgba16f' keeps unclamped linear light and skips tone mapping, for
97
+ * post-processing. Backends without float targets fall back to 'rgba8'.
98
+ */
99
+ readonly format?: RenderTargetFormat3D;
100
+ /** Keep depth in a texture the post-processing chain can read, instead of a write-only buffer. */
101
+ readonly depthTexture?: boolean;
102
+ /** Attach a depth buffer so the target can be rendered with depth testing. */
103
+ readonly depth?: boolean;
104
+ readonly magFilter?: TextureFilter3D;
105
+ readonly minFilter?: TextureFilter3D;
106
+ readonly wrapS?: TextureWrap3D;
107
+ readonly wrapT?: TextureWrap3D;
108
+ }
109
+ /**
110
+ * Off-screen color target. Render a scene into it, then use `texture` as any
111
+ * material map. A backend owns the pixels; the CPU side only carries the size.
112
+ */
113
+ export declare class RenderTarget3D extends Resource3D {
114
+ #private;
115
+ readonly depth: boolean;
116
+ readonly format: RenderTargetFormat3D;
117
+ readonly depthTexture: boolean;
118
+ /** Sampled view of the color attachment; its source is this target. */
119
+ readonly texture: Texture3D;
120
+ constructor(width: number, height: number, options?: RenderTargetOptions3D);
121
+ get width(): number;
122
+ get height(): number;
123
+ /** Reallocate the attachments at a new size; previous contents are discarded. */
124
+ setSize(width: number, height: number): void;
125
+ dispose(): void;
126
+ }
127
+ /**
128
+ * Procedural sky cube: a vertical gradient from `ground` through `horizon` to
129
+ * `zenith`, in sRGB bytes. Useful as a background and a soft light probe.
130
+ */
131
+ export declare function createGradientCubeTexture3D(zenith: readonly [number, number, number], horizon: readonly [number, number, number], ground: readonly [number, number, number], size?: number): CubeTexture3D;
132
+ export {};
133
+ //# sourceMappingURL=Texture3D.d.ts.map
@@ -0,0 +1,252 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // CPU-side texture descriptions. The pixel source is either owned RGBA bytes
3
+ // or an opaque host image (ImageBitmap, canvas, video) that only a backend
4
+ // interprets, which keeps this module DOM-free.
5
+ import { Resource3D, World3DError, requireCount3D } from './core3D.js';
6
+ export const TEXTURE3D_LIMITS = Object.freeze({ maxEdge: 8192, maxBytes: 268435456 });
7
+ /** Bytes per 4x4 block of each compressed format. */
8
+ export const COMPRESSED_BLOCK_BYTES_3D = Object.freeze({
9
+ 'bc1': 8,
10
+ 'bc3': 16,
11
+ 'bc7': 16,
12
+ 'etc2-rgb8': 8,
13
+ 'etc2-rgba8': 16,
14
+ 'astc-4x4': 16
15
+ });
16
+ export function isCompressedPixels3D(source) {
17
+ return (typeof source === 'object' &&
18
+ source !== null &&
19
+ Array.isArray(source.levels) &&
20
+ typeof source.format === 'string');
21
+ }
22
+ export function isTexturePixels3D(source) {
23
+ return typeof source === 'object' && source !== null && source.data instanceof Uint8Array;
24
+ }
25
+ function checkSource(source) {
26
+ if (typeof source !== 'object' || source === null)
27
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'texture source');
28
+ if (isCompressedPixels3D(source)) {
29
+ const block = COMPRESSED_BLOCK_BYTES_3D[source.format];
30
+ if (block === undefined)
31
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'compressed format');
32
+ let width = requireCount3D(source.width, 'texture width', TEXTURE3D_LIMITS.maxEdge), height = requireCount3D(source.height, 'texture height', TEXTURE3D_LIMITS.maxEdge);
33
+ if (width === 0 || height === 0 || source.levels.length === 0 || source.levels.length > 14)
34
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'compressed levels');
35
+ for (const level of source.levels) {
36
+ if (!(level instanceof Uint8Array) || level.byteLength !== Math.ceil(width / 4) * Math.ceil(height / 4) * block)
37
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'compressed level size');
38
+ width = Math.max(1, width >> 1);
39
+ height = Math.max(1, height >> 1);
40
+ }
41
+ return;
42
+ }
43
+ if (!isTexturePixels3D(source))
44
+ return;
45
+ const width = requireCount3D(source.width, 'texture width', TEXTURE3D_LIMITS.maxEdge);
46
+ const height = requireCount3D(source.height, 'texture height', TEXTURE3D_LIMITS.maxEdge);
47
+ if (width === 0 || height === 0 || source.data.byteLength !== width * height * 4)
48
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'texture pixels');
49
+ }
50
+ class TextureBase3D extends Resource3D {
51
+ wrapS;
52
+ wrapT;
53
+ magFilter;
54
+ minFilter;
55
+ /** Generate a full mip chain and sample it trilinearly. */
56
+ mipmaps;
57
+ /** Color textures are 'srgb'; data textures (normal, roughness, occlusion) are 'linear'. */
58
+ colorSpace;
59
+ /**
60
+ * Flip rows at upload so V = 0 addresses the bottom row. glTF textures keep this false.
61
+ * WebGL ignores the flag for ImageBitmap sources: decode those with `imageOrientation: 'flipY'`
62
+ * instead, as loadTexture3D does.
63
+ */
64
+ flipY;
65
+ anisotropy;
66
+ /**
67
+ * Texture coordinate set used when this texture is a material's occlusion
68
+ * or emissive map: 0 reads `uv`, 1 reads `uv1`, the usual home of baked
69
+ * lighting. Other map slots always use `uv`.
70
+ */
71
+ channel;
72
+ constructor(options) {
73
+ super();
74
+ if (options.channel !== undefined && options.channel !== 0 && options.channel !== 1)
75
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'texture channel');
76
+ this.channel = options.channel ?? 0;
77
+ this.name = options.name ?? '';
78
+ this.wrapS = options.wrapS ?? 'repeat';
79
+ this.wrapT = options.wrapT ?? 'repeat';
80
+ this.magFilter = options.magFilter ?? 'linear';
81
+ this.minFilter = options.minFilter ?? 'linear';
82
+ this.mipmaps = options.mipmaps ?? true;
83
+ this.colorSpace = options.colorSpace ?? 'srgb';
84
+ this.flipY = options.flipY ?? false;
85
+ this.anisotropy = options.anisotropy ?? 1;
86
+ }
87
+ }
88
+ export class Texture3D extends TextureBase3D {
89
+ #source;
90
+ /** UV transform applied as: uv' = rotate(uv * repeat) + offset. */
91
+ offset = new Float32Array([0, 0]);
92
+ repeat = new Float32Array([1, 1]);
93
+ rotation = 0;
94
+ constructor(source, options = {}) {
95
+ super(options);
96
+ checkSource(source);
97
+ this.#source = source;
98
+ }
99
+ get source() {
100
+ return this.#source;
101
+ }
102
+ /** Replace the pixel source and schedule a backend upload. */
103
+ setSource(source) {
104
+ this.assertLive();
105
+ checkSource(source);
106
+ this.#source = source;
107
+ this.touch();
108
+ }
109
+ /** True when offset, repeat or rotation differ from the identity transform. */
110
+ get hasTransform() {
111
+ return (this.offset[0] !== 0 ||
112
+ this.offset[1] !== 0 ||
113
+ this.repeat[0] !== 1 ||
114
+ this.repeat[1] !== 1 ||
115
+ this.rotation !== 0);
116
+ }
117
+ }
118
+ /** Six square faces in +X, -X, +Y, -Y, +Z, -Z order. */
119
+ export class CubeTexture3D extends TextureBase3D {
120
+ faces;
121
+ constructor(faces, options = {}) {
122
+ super({ wrapS: 'clamp', wrapT: 'clamp', ...options });
123
+ if (!Array.isArray(faces) || faces.length !== 6)
124
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'cube faces');
125
+ for (const face of faces)
126
+ checkSource(face);
127
+ this.faces = Object.freeze([...faces]);
128
+ }
129
+ }
130
+ /** Single-color 1x1 texture, useful as a placeholder or constant map. */
131
+ export function createSolidTexture3D(r, g, b, a = 255, options = {}) {
132
+ return new Texture3D({ width: 1, height: 1, data: new Uint8Array([r, g, b, a]) }, { mipmaps: false, ...options });
133
+ }
134
+ /**
135
+ * Off-screen color target. Render a scene into it, then use `texture` as any
136
+ * material map. A backend owns the pixels; the CPU side only carries the size.
137
+ */
138
+ export class RenderTarget3D extends Resource3D {
139
+ #width;
140
+ #height;
141
+ depth;
142
+ format;
143
+ depthTexture;
144
+ /** Sampled view of the color attachment; its source is this target. */
145
+ texture;
146
+ constructor(width, height, options = {}) {
147
+ super();
148
+ this.name = options.name ?? '';
149
+ this.#width = requireCount3D(width, 'target width', TEXTURE3D_LIMITS.maxEdge);
150
+ this.#height = requireCount3D(height, 'target height', TEXTURE3D_LIMITS.maxEdge);
151
+ if (this.#width === 0 || this.#height === 0)
152
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'target size');
153
+ this.depth = options.depth ?? true;
154
+ if (options.format !== undefined && options.format !== 'rgba8' && options.format !== 'rgba16f')
155
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'target format');
156
+ this.format = options.format ?? 'rgba8';
157
+ this.depthTexture = this.depth && (options.depthTexture ?? false);
158
+ this.texture = new Texture3D(this, {
159
+ mipmaps: false,
160
+ wrapS: options.wrapS ?? 'clamp',
161
+ wrapT: options.wrapT ?? 'clamp',
162
+ magFilter: options.magFilter ?? 'linear',
163
+ minFilter: options.minFilter ?? 'linear',
164
+ colorSpace: this.format === 'rgba16f' ? 'linear' : 'srgb'
165
+ });
166
+ }
167
+ get width() {
168
+ return this.#width;
169
+ }
170
+ get height() {
171
+ return this.#height;
172
+ }
173
+ /** Reallocate the attachments at a new size; previous contents are discarded. */
174
+ setSize(width, height) {
175
+ this.assertLive();
176
+ const w = requireCount3D(width, 'target width', TEXTURE3D_LIMITS.maxEdge), h = requireCount3D(height, 'target height', TEXTURE3D_LIMITS.maxEdge);
177
+ if (w === 0 || h === 0)
178
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'target size');
179
+ if (w === this.#width && h === this.#height)
180
+ return;
181
+ this.#width = w;
182
+ this.#height = h;
183
+ this.touch();
184
+ }
185
+ dispose() {
186
+ try {
187
+ this.texture.dispose();
188
+ }
189
+ finally {
190
+ super.dispose();
191
+ }
192
+ }
193
+ }
194
+ /**
195
+ * Procedural sky cube: a vertical gradient from `ground` through `horizon` to
196
+ * `zenith`, in sRGB bytes. Useful as a background and a soft light probe.
197
+ */
198
+ export function createGradientCubeTexture3D(zenith, horizon, ground, size = 32) {
199
+ const edge = requireCount3D(size, 'cube size', 1024);
200
+ if (edge < 2)
201
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'cube size');
202
+ const faces = [];
203
+ for (let face = 0; face < 6; face++) {
204
+ const data = new Uint8Array(edge * edge * 4);
205
+ for (let y = 0; y < edge; y++) {
206
+ for (let x = 0; x < edge; x++) {
207
+ // Texel center on the cube surface, following the OpenGL cube-map face layout.
208
+ const s = ((x + 0.5) / edge) * 2 - 1, t = ((y + 0.5) / edge) * 2 - 1;
209
+ let dx = 0, dy = 0, dz = 0;
210
+ if (face === 0) {
211
+ dx = 1;
212
+ dy = -t;
213
+ dz = -s;
214
+ }
215
+ else if (face === 1) {
216
+ dx = -1;
217
+ dy = -t;
218
+ dz = s;
219
+ }
220
+ else if (face === 2) {
221
+ dx = s;
222
+ dy = 1;
223
+ dz = t;
224
+ }
225
+ else if (face === 3) {
226
+ dx = s;
227
+ dy = -1;
228
+ dz = -t;
229
+ }
230
+ else if (face === 4) {
231
+ dx = s;
232
+ dy = -t;
233
+ dz = 1;
234
+ }
235
+ else {
236
+ dx = -s;
237
+ dy = -t;
238
+ dz = -1;
239
+ }
240
+ const up = dy / Math.hypot(dx, dy, dz), from = up >= 0 ? horizon : ground, to = up >= 0 ? zenith : ground;
241
+ const k = up >= 0 ? Math.pow(up, 0.6) : Math.min(1, -up * 4), o = (y * edge + x) * 4;
242
+ const base = up >= 0 ? from : horizon;
243
+ for (let c = 0; c < 3; c++)
244
+ data[o + c] = Math.round(base[c] + (to[c] - base[c]) * k);
245
+ data[o + 3] = 255;
246
+ }
247
+ }
248
+ faces.push({ width: edge, height: edge, data });
249
+ }
250
+ return new CubeTexture3D(faces, { mipmaps: true });
251
+ }
252
+ //# sourceMappingURL=Texture3D.js.map
@@ -0,0 +1,59 @@
1
+ import { type Blending3D, type ColorInput3D } from './Material3D.js';
2
+ import { Mesh3D } from './Mesh3D.js';
3
+ import type { Object3D } from './Object3D.js';
4
+ import type { Texture3D } from './Texture3D.js';
5
+ export declare const TRAIL3D_LIMITS: Readonly<{
6
+ readonly maxPoints: 4096;
7
+ }>;
8
+ export interface TrailOptions3D {
9
+ /** The object whose world position the trail follows. Without one, feed points with `push`. */
10
+ readonly target?: Object3D;
11
+ /** Seconds a point of the trail stays visible. Default 0.6. */
12
+ readonly lifetime?: number;
13
+ /** Most points kept; older ones drop off the end. Default 64. */
14
+ readonly points?: number;
15
+ /** A new point is recorded once the head has moved this far. Default 0.05. */
16
+ readonly minDistance?: number;
17
+ /** Width at the head and at the tail. Defaults: 0.3 and 0. */
18
+ readonly width?: number;
19
+ readonly endWidth?: number;
20
+ readonly color?: ColorInput3D;
21
+ readonly endColor?: ColorInput3D;
22
+ /** Opacity at the head and at the tail. Defaults: 1 and 0. */
23
+ readonly opacity?: number;
24
+ readonly endOpacity?: number;
25
+ /** Sampled with u running from head to tail and v across the ribbon. */
26
+ readonly map?: Texture3D;
27
+ readonly blending?: Blending3D;
28
+ }
29
+ /**
30
+ * Add the trail to the scene itself, not under the object it follows: its
31
+ * vertices are world positions. Call `update(deltaSeconds)` once per frame.
32
+ */
33
+ export declare class Trail3D extends Mesh3D {
34
+ #private;
35
+ target: Object3D | undefined;
36
+ lifetime: number;
37
+ minDistance: number;
38
+ width: number;
39
+ endWidth: number;
40
+ opacity: number;
41
+ endOpacity: number;
42
+ readonly color: Float32Array<ArrayBuffer>;
43
+ readonly endColor: Float32Array<ArrayBuffer>;
44
+ readonly capacity: number;
45
+ constructor(options?: TrailOptions3D);
46
+ /** Points currently in the trail, the moving head included. */
47
+ get pointCount(): number;
48
+ /** Age every point, drop the expired ones, and follow the target. */
49
+ update(deltaSeconds: number): void;
50
+ /** Move the head of the trail to a world position; a point is recorded once it has moved far enough. */
51
+ push(x: number, y: number, z: number): void;
52
+ /** Remove every point, as after teleporting the target. */
53
+ clear(): void;
54
+ /** Release the geometry and the material. */
55
+ dispose(): void;
56
+ private build;
57
+ }
58
+ export declare function createTrail3D(options?: TrailOptions3D): Trail3D;
59
+ //# sourceMappingURL=Trail3D.d.ts.map
@@ -0,0 +1,193 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // A ribbon left behind by a moving point: sword swings, tracers, exhaust.
3
+ // Points are recorded in world space and age out; before each draw the ribbon
4
+ // is rebuilt to face the camera. DOM-free and backend-independent: it is an
5
+ // ordinary mesh with a dynamic geometry.
6
+ import { World3DError, requireCount3D, requireFinite3D, requirePositive3D } from './core3D.js';
7
+ import { Attribute3D, Geometry3D } from './Geometry3D.js';
8
+ import { createUnlitMaterial3D, setColor3D } from './Material3D.js';
9
+ import { Mesh3D } from './Mesh3D.js';
10
+ export const TRAIL3D_LIMITS = Object.freeze({ maxPoints: 4096 });
11
+ /**
12
+ * Add the trail to the scene itself, not under the object it follows: its
13
+ * vertices are world positions. Call `update(deltaSeconds)` once per frame.
14
+ */
15
+ export class Trail3D extends Mesh3D {
16
+ target;
17
+ lifetime;
18
+ minDistance;
19
+ width;
20
+ endWidth;
21
+ opacity;
22
+ endOpacity;
23
+ color = new Float32Array([1, 1, 1]);
24
+ endColor = new Float32Array([1, 1, 1]);
25
+ capacity;
26
+ // Recorded points, newest first: x, y, z and age in seconds.
27
+ #points;
28
+ #count = 0;
29
+ #positions;
30
+ #colors;
31
+ #uvs;
32
+ #head = [0, 0, 0];
33
+ #hasHead = false;
34
+ constructor(options = {}) {
35
+ const capacity = requireCount3D(options.points ?? 64, 'points', TRAIL3D_LIMITS.maxPoints);
36
+ if (capacity < 2)
37
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'a trail needs at least 2 points');
38
+ const geometry = new Geometry3D(), vertices = capacity * 2, indices = new Uint16Array((capacity - 1) * 6);
39
+ for (let i = 0; i < capacity - 1; i++)
40
+ indices.set([i * 2, i * 2 + 1, i * 2 + 2, i * 2 + 1, i * 2 + 3, i * 2 + 2], i * 6);
41
+ const positions = new Attribute3D(new Float32Array(vertices * 3), 3), colors = new Attribute3D(new Float32Array(vertices * 4), 4), uvs = new Attribute3D(new Float32Array(vertices * 2), 2);
42
+ positions.dynamic = colors.dynamic = uvs.dynamic = true;
43
+ geometry.setAttribute('position', positions);
44
+ geometry.setAttribute('color', colors);
45
+ geometry.setAttribute('uv', uvs);
46
+ geometry.setIndex(indices);
47
+ const material = createUnlitMaterial3D({
48
+ alphaMode: 'blend',
49
+ blending: options.blending ?? 'additive',
50
+ depthWrite: false,
51
+ side: 'double',
52
+ vertexColors: true,
53
+ fog: false,
54
+ ...(options.map === undefined ? {} : { map: options.map })
55
+ });
56
+ super(geometry, material);
57
+ this.name = 'trail';
58
+ this.pickable = false;
59
+ this.castShadow = false;
60
+ this.frustumCulled = false;
61
+ this.capacity = capacity;
62
+ this.#points = new Float32Array(capacity * 4);
63
+ this.#positions = positions;
64
+ this.#colors = colors;
65
+ this.#uvs = uvs;
66
+ this.target = options.target;
67
+ this.lifetime = requirePositive3D(options.lifetime ?? 0.6, 'lifetime');
68
+ this.minDistance = requireFinite3D(options.minDistance ?? 0.05, 'minDistance');
69
+ this.width = requireFinite3D(options.width ?? 0.3, 'width');
70
+ this.endWidth = requireFinite3D(options.endWidth ?? 0, 'endWidth');
71
+ this.opacity = requireFinite3D(options.opacity ?? 1, 'opacity');
72
+ this.endOpacity = requireFinite3D(options.endOpacity ?? 0, 'endOpacity');
73
+ if (options.color !== undefined)
74
+ setColor3D(this.color, options.color);
75
+ setColor3D(this.endColor, options.endColor ?? options.color ?? 0xffffff);
76
+ this.beforeRender = (camera) => this.build(camera);
77
+ }
78
+ /** Points currently in the trail, the moving head included. */
79
+ get pointCount() {
80
+ return this.#count + (this.#hasHead ? 1 : 0);
81
+ }
82
+ /** Age every point, drop the expired ones, and follow the target. */
83
+ update(deltaSeconds) {
84
+ const dt = requireFinite3D(deltaSeconds, 'deltaSeconds'), points = this.#points;
85
+ for (let i = 0; i < this.#count; i++)
86
+ points[i * 4 + 3] = points[i * 4 + 3] + dt;
87
+ while (this.#count > 0 && points[(this.#count - 1) * 4 + 3] >= this.lifetime)
88
+ this.#count--;
89
+ const target = this.target;
90
+ if (target) {
91
+ target.updateWorldMatrix();
92
+ this.push(target.matrixWorld[12], target.matrixWorld[13], target.matrixWorld[14]);
93
+ }
94
+ }
95
+ /** Move the head of the trail to a world position; a point is recorded once it has moved far enough. */
96
+ push(x, y, z) {
97
+ const points = this.#points, head = this.#head;
98
+ head[0] = requireFinite3D(x, 'x');
99
+ head[1] = requireFinite3D(y, 'y');
100
+ head[2] = requireFinite3D(z, 'z');
101
+ this.#hasHead = true;
102
+ if (this.#count > 0 && Math.hypot(x - points[0], y - points[1], z - points[2]) < this.minDistance)
103
+ return;
104
+ // The newest point goes first; the oldest falls off when the buffer is full.
105
+ const kept = Math.min(this.#count, this.capacity - 2);
106
+ points.copyWithin(4, 0, kept * 4);
107
+ points[0] = x;
108
+ points[1] = y;
109
+ points[2] = z;
110
+ points[3] = 0;
111
+ this.#count = kept + 1;
112
+ }
113
+ /** Remove every point, as after teleporting the target. */
114
+ clear() {
115
+ this.#count = 0;
116
+ this.#hasHead = false;
117
+ }
118
+ /** Release the geometry and the material. */
119
+ dispose() {
120
+ this.geometry.dispose();
121
+ if (!Array.isArray(this.material))
122
+ this.material.dispose();
123
+ }
124
+ build(camera) {
125
+ const positions = this.#positions.data, colors = this.#colors.data, uvs = this.#uvs.data;
126
+ const points = this.#points, head = this.#head, live = this.#hasHead ? this.#count + 1 : 0, eye = camera.matrixWorld;
127
+ // Point k of the ribbon: the head first, then the recorded points.
128
+ const px = (k) => (k === 0 ? head[0] : points[(k - 1) * 4]), py = (k) => (k === 0 ? head[1] : points[(k - 1) * 4 + 1]), pz = (k) => (k === 0 ? head[2] : points[(k - 1) * 4 + 2]);
129
+ let lastX = 0, lastY = 0, lastZ = 0;
130
+ for (let i = 0; i < this.capacity; i++) {
131
+ const k = Math.min(i, live - 1), o = i * 2;
132
+ if (live < 2) {
133
+ positions.fill(0, o * 3, o * 3 + 6);
134
+ colors.fill(0, o * 4, o * 4 + 8);
135
+ continue;
136
+ }
137
+ const age = k === 0 ? 0 : Math.min(points[(k - 1) * 4 + 3] / this.lifetime, 1), x = px(k), y = py(k), z = pz(k);
138
+ // Across the ribbon: perpendicular to its direction and to the line of sight.
139
+ let a = Math.max(k - 1, 0), b = Math.min(k + 1, live - 1);
140
+ let tx = px(a) - px(b), ty = py(a) - py(b), tz = pz(a) - pz(b);
141
+ // The head sits on the newest recorded point right after it is recorded; look further along for a direction.
142
+ while (tx * tx + ty * ty + tz * tz < 1e-12 && (b < live - 1 || a > 0)) {
143
+ if (b < live - 1)
144
+ b++;
145
+ else
146
+ a--;
147
+ tx = px(a) - px(b);
148
+ ty = py(a) - py(b);
149
+ tz = pz(a) - pz(b);
150
+ }
151
+ const vx = eye[12] - x, vy = eye[13] - y, vz = eye[14] - z;
152
+ let sx = ty * vz - tz * vy, sy = tz * vx - tx * vz, sz = tx * vy - ty * vx;
153
+ const length = Math.hypot(sx, sy, sz);
154
+ if (length > 1e-9) {
155
+ sx /= length;
156
+ sy /= length;
157
+ sz /= length;
158
+ lastX = sx;
159
+ lastY = sy;
160
+ lastZ = sz;
161
+ }
162
+ else {
163
+ sx = lastX;
164
+ sy = lastY;
165
+ sz = lastZ;
166
+ }
167
+ const half = (this.width + (this.endWidth - this.width) * age) / 2, alpha = i < live ? this.opacity + (this.endOpacity - this.opacity) * age : 0;
168
+ positions[o * 3] = x + sx * half;
169
+ positions[o * 3 + 1] = y + sy * half;
170
+ positions[o * 3 + 2] = z + sz * half;
171
+ positions[o * 3 + 3] = x - sx * half;
172
+ positions[o * 3 + 4] = y - sy * half;
173
+ positions[o * 3 + 5] = z - sz * half;
174
+ for (let side = 0; side < 2; side++) {
175
+ const c = (o + side) * 4;
176
+ colors[c] = this.color[0] + (this.endColor[0] - this.color[0]) * age;
177
+ colors[c + 1] = this.color[1] + (this.endColor[1] - this.color[1]) * age;
178
+ colors[c + 2] = this.color[2] + (this.endColor[2] - this.color[2]) * age;
179
+ colors[c + 3] = alpha;
180
+ uvs[(o + side) * 2] = age;
181
+ uvs[(o + side) * 2 + 1] = side;
182
+ }
183
+ }
184
+ this.#positions.touch();
185
+ this.#colors.touch();
186
+ this.#uvs.touch();
187
+ this.geometry.invalidateBounds();
188
+ }
189
+ }
190
+ export function createTrail3D(options = {}) {
191
+ return new Trail3D(options);
192
+ }
193
+ //# sourceMappingURL=Trail3D.js.map