@egret/engine 0.0.0-stage → 7.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (601) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +21 -0
  3. package/README.md +101 -2
  4. package/README.zh-CN.md +102 -0
  5. package/dist/Engine.d.ts +77 -0
  6. package/dist/Engine.js +469 -0
  7. package/dist/animation/index.d.ts +6 -0
  8. package/dist/animation/index.js +5 -0
  9. package/dist/animation/sequenceController.d.ts +22 -0
  10. package/dist/animation/sequenceController.js +618 -0
  11. package/dist/animation/sequenceCoordinator.d.ts +26 -0
  12. package/dist/animation/sequenceCoordinator.js +161 -0
  13. package/dist/animation/sequenceInput.d.ts +25 -0
  14. package/dist/animation/sequenceInput.js +108 -0
  15. package/dist/animation/sequenceMath.d.ts +35 -0
  16. package/dist/animation/sequenceMath.js +164 -0
  17. package/dist/animation/sequenceResetSlot.d.ts +7 -0
  18. package/dist/animation/sequenceResetSlot.js +367 -0
  19. package/dist/animation/sequenceResetTypes.d.ts +48 -0
  20. package/dist/animation/sequenceResetTypes.js +2 -0
  21. package/dist/animation/types.d.ts +75 -0
  22. package/dist/animation/types.js +2 -0
  23. package/dist/assetBundle.d.ts +54 -0
  24. package/dist/assetBundle.js +173 -0
  25. package/dist/assetGroup.d.ts +17 -0
  26. package/dist/assetGroup.js +332 -0
  27. package/dist/assetGroupTypes.d.ts +17 -0
  28. package/dist/assetGroupTypes.js +2 -0
  29. package/dist/audio.d.ts +4 -0
  30. package/dist/audio.js +4 -0
  31. package/dist/audioCues.d.ts +47 -0
  32. package/dist/audioCues.js +127 -0
  33. package/dist/audioMixer.d.ts +7 -0
  34. package/dist/audioMixer.js +785 -0
  35. package/dist/audioTypes.d.ts +246 -0
  36. package/dist/audioTypes.js +3 -0
  37. package/dist/bitmapBindingTicket.d.ts +24 -0
  38. package/dist/bitmapBindingTicket.js +215 -0
  39. package/dist/bitmapButton.d.ts +4 -0
  40. package/dist/bitmapButton.js +407 -0
  41. package/dist/bitmapButtonTypes.d.ts +31 -0
  42. package/dist/bitmapButtonTypes.js +2 -0
  43. package/dist/bitmapFontParse.d.ts +10 -0
  44. package/dist/bitmapFontParse.js +246 -0
  45. package/dist/bitmapFontTypes.d.ts +112 -0
  46. package/dist/bitmapFontTypes.js +2 -0
  47. package/dist/bitmapResourceSlot.d.ts +26 -0
  48. package/dist/bitmapResourceSlot.js +340 -0
  49. package/dist/bitmapText.d.ts +6 -0
  50. package/dist/bitmapText.js +320 -0
  51. package/dist/bitmapfont.d.ts +5 -0
  52. package/dist/bitmapfont.js +5 -0
  53. package/dist/camera.d.ts +4 -0
  54. package/dist/camera.js +4 -0
  55. package/dist/camera2d.d.ts +7 -0
  56. package/dist/camera2d.js +419 -0
  57. package/dist/cameraTypes.d.ts +126 -0
  58. package/dist/cameraTypes.js +2 -0
  59. package/dist/closeHost.d.ts +4 -0
  60. package/dist/closeHost.js +66 -0
  61. package/dist/contentArtifacts.d.ts +12 -0
  62. package/dist/contentArtifacts.js +153 -0
  63. package/dist/contentAtlasPages.d.ts +13 -0
  64. package/dist/contentAtlasPages.js +117 -0
  65. package/dist/contentLoader.d.ts +6 -0
  66. package/dist/contentLoader.js +327 -0
  67. package/dist/contentTypes.d.ts +35 -0
  68. package/dist/contentTypes.js +2 -0
  69. package/dist/createEngine.d.ts +7 -0
  70. package/dist/createEngine.js +25 -0
  71. package/dist/createEngineForProfile.d.ts +5 -0
  72. package/dist/createEngineForProfile.js +45 -0
  73. package/dist/displaySubtreeTicket.d.ts +25 -0
  74. package/dist/displaySubtreeTicket.js +76 -0
  75. package/dist/fontContentLoader.d.ts +6 -0
  76. package/dist/fontContentLoader.js +298 -0
  77. package/dist/fontContentTypes.d.ts +39 -0
  78. package/dist/fontContentTypes.js +2 -0
  79. package/dist/gameClock.d.ts +24 -0
  80. package/dist/gameClock.js +246 -0
  81. package/dist/gameClockTypes.d.ts +37 -0
  82. package/dist/gameClockTypes.js +2 -0
  83. package/dist/gameRun.d.ts +53 -0
  84. package/dist/gameRun.js +97 -0
  85. package/dist/gamepad.d.ts +5 -0
  86. package/dist/gamepad.js +5 -0
  87. package/dist/gamepadInput.d.ts +4 -0
  88. package/dist/gamepadInput.js +281 -0
  89. package/dist/gamepadKeys.d.ts +4 -0
  90. package/dist/gamepadKeys.js +205 -0
  91. package/dist/gamepadTypes.d.ts +142 -0
  92. package/dist/gamepadTypes.js +3 -0
  93. package/dist/hover.d.ts +4 -0
  94. package/dist/hover.js +4 -0
  95. package/dist/hoverInput.d.ts +8 -0
  96. package/dist/hoverInput.js +503 -0
  97. package/dist/hoverInputTypes.d.ts +129 -0
  98. package/dist/hoverInputTypes.js +2 -0
  99. package/dist/index.d.ts +52 -0
  100. package/dist/index.js +21 -0
  101. package/dist/input.d.ts +6 -0
  102. package/dist/input.js +5 -0
  103. package/dist/inputActions.d.ts +86 -0
  104. package/dist/inputActions.js +330 -0
  105. package/dist/internal/contentFactoryState.d.ts +19 -0
  106. package/dist/internal/contentFactoryState.js +42 -0
  107. package/dist/internal/mouseInputFactoryState.d.ts +57 -0
  108. package/dist/internal/mouseInputFactoryState.js +125 -0
  109. package/dist/internal/sequenceControllerFactoryState.d.ts +42 -0
  110. package/dist/internal/sequenceControllerFactoryState.js +98 -0
  111. package/dist/internal/textFieldFactoryState.d.ts +11 -0
  112. package/dist/internal/textFieldFactoryState.js +32 -0
  113. package/dist/internal/texturedFrameState.d.ts +4 -0
  114. package/dist/internal/texturedFrameState.js +12 -0
  115. package/dist/internal/uiFactoryState.d.ts +68 -0
  116. package/dist/internal/uiFactoryState.js +173 -0
  117. package/dist/internal/uiRootState.d.ts +67 -0
  118. package/dist/internal/uiRootState.js +103 -0
  119. package/dist/keyboardInput.d.ts +13 -0
  120. package/dist/keyboardInput.js +579 -0
  121. package/dist/keyboardInputTypes.d.ts +93 -0
  122. package/dist/keyboardInputTypes.js +2 -0
  123. package/dist/kit.d.ts +16 -0
  124. package/dist/kit.js +10 -0
  125. package/dist/layout.d.ts +5 -0
  126. package/dist/layout.js +132 -0
  127. package/dist/layoutTypes.d.ts +28 -0
  128. package/dist/layoutTypes.js +2 -0
  129. package/dist/manifestAssetGroup.d.ts +10 -0
  130. package/dist/manifestAssetGroup.js +477 -0
  131. package/dist/manifestResourceState.d.ts +17 -0
  132. package/dist/manifestResourceState.js +58 -0
  133. package/dist/manifestResourceTypes.d.ts +26 -0
  134. package/dist/manifestResourceTypes.js +2 -0
  135. package/dist/motion.d.ts +35 -0
  136. package/dist/motion.js +206 -0
  137. package/dist/mouseInput.d.ts +102 -0
  138. package/dist/mouseInput.js +562 -0
  139. package/dist/mouseInputTypes.d.ts +41 -0
  140. package/dist/mouseInputTypes.js +2 -0
  141. package/dist/paragraph.d.ts +8 -0
  142. package/dist/paragraph.js +7 -0
  143. package/dist/particleEmitter.d.ts +4 -0
  144. package/dist/particleEmitter.js +300 -0
  145. package/dist/particleTypes.d.ts +115 -0
  146. package/dist/particleTypes.js +2 -0
  147. package/dist/particles.d.ts +4 -0
  148. package/dist/particles.js +4 -0
  149. package/dist/physics2d.d.ts +4 -0
  150. package/dist/physics2d.js +4 -0
  151. package/dist/physics2dGeometry.d.ts +39 -0
  152. package/dist/physics2dGeometry.js +230 -0
  153. package/dist/physics2dTypes.d.ts +221 -0
  154. package/dist/physics2dTypes.js +2 -0
  155. package/dist/physics2dWorld.d.ts +4 -0
  156. package/dist/physics2dWorld.js +823 -0
  157. package/dist/pointerInput.d.ts +12 -0
  158. package/dist/pointerInput.js +300 -0
  159. package/dist/pointerInputTypes.d.ts +41 -0
  160. package/dist/pointerInputTypes.js +2 -0
  161. package/dist/random.d.ts +30 -0
  162. package/dist/random.js +131 -0
  163. package/dist/rendering/ownedPreparationFailure2D.d.ts +5 -0
  164. package/dist/rendering/ownedPreparationFailure2D.js +33 -0
  165. package/dist/rendering/packSharedDraws2D.d.ts +50 -0
  166. package/dist/rendering/packSharedDraws2D.js +379 -0
  167. package/dist/rendering/packedOrientation.d.ts +4 -0
  168. package/dist/rendering/packedOrientation.js +7 -0
  169. package/dist/rendering/prepareRectangles2D.d.ts +92 -0
  170. package/dist/rendering/prepareRectangles2D.js +481 -0
  171. package/dist/rendering/prepareSharedDraws2D.d.ts +90 -0
  172. package/dist/rendering/prepareSharedDraws2D.js +663 -0
  173. package/dist/rendering/preparedBatches2D.d.ts +17 -0
  174. package/dist/rendering/preparedBatches2D.js +30 -0
  175. package/dist/rendering/preparedSharedBatches2D.d.ts +44 -0
  176. package/dist/rendering/preparedSharedBatches2D.js +247 -0
  177. package/dist/rendering/sharedColor2D.d.ts +52 -0
  178. package/dist/rendering/sharedColor2D.js +191 -0
  179. package/dist/rendering/sharedEffects2D.d.ts +23 -0
  180. package/dist/rendering/sharedEffects2D.js +126 -0
  181. package/dist/rendering/sharedPreparationRetention2D.d.ts +120 -0
  182. package/dist/rendering/sharedPreparationRetention2D.js +357 -0
  183. package/dist/rendering/srgbBytes.d.ts +3 -0
  184. package/dist/rendering/srgbBytes.js +64 -0
  185. package/dist/rendering/texturedPreparationBudget2D.d.ts +31 -0
  186. package/dist/rendering/texturedPreparationBudget2D.js +81 -0
  187. package/dist/rendering/world3d/Animation3D.d.ts +104 -0
  188. package/dist/rendering/world3d/Animation3D.js +384 -0
  189. package/dist/rendering/world3d/AnimationTexture3D.d.ts +163 -0
  190. package/dist/rendering/world3d/AnimationTexture3D.js +603 -0
  191. package/dist/rendering/world3d/Batch3D.d.ts +75 -0
  192. package/dist/rendering/world3d/Batch3D.js +332 -0
  193. package/dist/rendering/world3d/Camera3D.d.ts +62 -0
  194. package/dist/rendering/world3d/Camera3D.js +132 -0
  195. package/dist/rendering/world3d/Character3D.d.ts +127 -0
  196. package/dist/rendering/world3d/Character3D.js +305 -0
  197. package/dist/rendering/world3d/Cloth3D.d.ts +130 -0
  198. package/dist/rendering/world3d/Cloth3D.js +503 -0
  199. package/dist/rendering/world3d/Compression3D.d.ts +22 -0
  200. package/dist/rendering/world3d/Compression3D.js +703 -0
  201. package/dist/rendering/world3d/Curves3D.d.ts +119 -0
  202. package/dist/rendering/world3d/Curves3D.js +460 -0
  203. package/dist/rendering/world3d/Decal3D.d.ts +43 -0
  204. package/dist/rendering/world3d/Decal3D.js +242 -0
  205. package/dist/rendering/world3d/Export3D.d.ts +13 -0
  206. package/dist/rendering/world3d/Export3D.js +263 -0
  207. package/dist/rendering/world3d/Geometry3D.d.ts +95 -0
  208. package/dist/rendering/world3d/Geometry3D.js +335 -0
  209. package/dist/rendering/world3d/GeometryBuilder3D.d.ts +53 -0
  210. package/dist/rendering/world3d/GeometryBuilder3D.js +196 -0
  211. package/dist/rendering/world3d/Gizmo3D.d.ts +80 -0
  212. package/dist/rendering/world3d/Gizmo3D.js +514 -0
  213. package/dist/rendering/world3d/Gltf3D.d.ts +73 -0
  214. package/dist/rendering/world3d/Gltf3D.js +996 -0
  215. package/dist/rendering/world3d/GpuParticles3D.d.ts +109 -0
  216. package/dist/rendering/world3d/GpuParticles3D.js +401 -0
  217. package/dist/rendering/world3d/Hdr3D.d.ts +35 -0
  218. package/dist/rendering/world3d/Hdr3D.js +191 -0
  219. package/dist/rendering/world3d/Jelly3D.d.ts +77 -0
  220. package/dist/rendering/world3d/Jelly3D.js +267 -0
  221. package/dist/rendering/world3d/Ktx23D.d.ts +30 -0
  222. package/dist/rendering/world3d/Ktx23D.js +112 -0
  223. package/dist/rendering/world3d/Light3D.d.ts +84 -0
  224. package/dist/rendering/world3d/Light3D.js +97 -0
  225. package/dist/rendering/world3d/Material3D.d.ts +253 -0
  226. package/dist/rendering/world3d/Material3D.js +269 -0
  227. package/dist/rendering/world3d/Mesh3D.d.ts +112 -0
  228. package/dist/rendering/world3d/Mesh3D.js +337 -0
  229. package/dist/rendering/world3d/Meshopt3D.d.ts +15 -0
  230. package/dist/rendering/world3d/Meshopt3D.js +276 -0
  231. package/dist/rendering/world3d/Navigation3D.d.ts +213 -0
  232. package/dist/rendering/world3d/Navigation3D.js +1043 -0
  233. package/dist/rendering/world3d/Object3D.d.ts +118 -0
  234. package/dist/rendering/world3d/Object3D.js +315 -0
  235. package/dist/rendering/world3d/Particles3D.d.ts +90 -0
  236. package/dist/rendering/world3d/Particles3D.js +277 -0
  237. package/dist/rendering/world3d/Physics3D.d.ts +430 -0
  238. package/dist/rendering/world3d/Physics3D.js +2840 -0
  239. package/dist/rendering/world3d/PhysicsHull3D.d.ts +37 -0
  240. package/dist/rendering/world3d/PhysicsHull3D.js +229 -0
  241. package/dist/rendering/world3d/PhysicsMesh3D.d.ts +41 -0
  242. package/dist/rendering/world3d/PhysicsMesh3D.js +340 -0
  243. package/dist/rendering/world3d/PhysicsQueries3D.d.ts +24 -0
  244. package/dist/rendering/world3d/PhysicsQueries3D.js +323 -0
  245. package/dist/rendering/world3d/PhysicsRemote3D.d.ts +179 -0
  246. package/dist/rendering/world3d/PhysicsRemote3D.js +536 -0
  247. package/dist/rendering/world3d/Ragdoll3D.d.ts +74 -0
  248. package/dist/rendering/world3d/Ragdoll3D.js +202 -0
  249. package/dist/rendering/world3d/Raycast3D.d.ts +40 -0
  250. package/dist/rendering/world3d/Raycast3D.js +247 -0
  251. package/dist/rendering/world3d/RenderList3D.d.ts +91 -0
  252. package/dist/rendering/world3d/RenderList3D.js +502 -0
  253. package/dist/rendering/world3d/Retarget3D.d.ts +21 -0
  254. package/dist/rendering/world3d/Retarget3D.js +185 -0
  255. package/dist/rendering/world3d/Rig3D.d.ts +57 -0
  256. package/dist/rendering/world3d/Rig3D.js +219 -0
  257. package/dist/rendering/world3d/Sdf3D.d.ts +181 -0
  258. package/dist/rendering/world3d/Sdf3D.js +1136 -0
  259. package/dist/rendering/world3d/SdfLod3D.d.ts +17 -0
  260. package/dist/rendering/world3d/SdfLod3D.js +56 -0
  261. package/dist/rendering/world3d/Serialize3D.d.ts +66 -0
  262. package/dist/rendering/world3d/Serialize3D.js +629 -0
  263. package/dist/rendering/world3d/Simplify3D.d.ts +29 -0
  264. package/dist/rendering/world3d/Simplify3D.js +426 -0
  265. package/dist/rendering/world3d/StateMachine3D.d.ts +87 -0
  266. package/dist/rendering/world3d/StateMachine3D.js +280 -0
  267. package/dist/rendering/world3d/SurfaceMaterial3D.d.ts +26 -0
  268. package/dist/rendering/world3d/SurfaceMaterial3D.js +138 -0
  269. package/dist/rendering/world3d/Terrain3D.d.ts +248 -0
  270. package/dist/rendering/world3d/Terrain3D.js +827 -0
  271. package/dist/rendering/world3d/Text3D.d.ts +95 -0
  272. package/dist/rendering/world3d/Text3D.js +560 -0
  273. package/dist/rendering/world3d/Texture3D.d.ts +148 -0
  274. package/dist/rendering/world3d/Texture3D.js +270 -0
  275. package/dist/rendering/world3d/Trail3D.d.ts +62 -0
  276. package/dist/rendering/world3d/Trail3D.js +195 -0
  277. package/dist/rendering/world3d/Vehicle3D.d.ts +102 -0
  278. package/dist/rendering/world3d/Vehicle3D.js +228 -0
  279. package/dist/rendering/world3d/VolumetricFog3D.d.ts +57 -0
  280. package/dist/rendering/world3d/VolumetricFog3D.js +230 -0
  281. package/dist/rendering/world3d/Water3D.d.ts +165 -0
  282. package/dist/rendering/world3d/Water3D.js +607 -0
  283. package/dist/rendering/world3d/core3D.d.ts +36 -0
  284. package/dist/rendering/world3d/core3D.js +99 -0
  285. package/dist/rendering/world3d/debug3D.d.ts +69 -0
  286. package/dist/rendering/world3d/debug3D.js +262 -0
  287. package/dist/rendering/world3d/decoders3D.d.ts +42 -0
  288. package/dist/rendering/world3d/decoders3D.js +133 -0
  289. package/dist/rendering/world3d/geometries3D.d.ts +111 -0
  290. package/dist/rendering/world3d/geometries3D.js +610 -0
  291. package/dist/rendering/world3d/helpers3D.d.ts +67 -0
  292. package/dist/rendering/world3d/helpers3D.js +178 -0
  293. package/dist/rendering/world3d/index.d.ts +103 -0
  294. package/dist/rendering/world3d/index.js +62 -0
  295. package/dist/rendering/world3d/math3D.d.ts +114 -0
  296. package/dist/rendering/world3d/math3D.js +675 -0
  297. package/dist/rendering/world3d/primitives3D.d.ts +67 -0
  298. package/dist/rendering/world3d/primitives3D.js +197 -0
  299. package/dist/resources.d.ts +8 -0
  300. package/dist/resources.js +6 -0
  301. package/dist/saveStore.d.ts +71 -0
  302. package/dist/saveStore.js +182 -0
  303. package/dist/semanticList.d.ts +126 -0
  304. package/dist/semanticList.js +175 -0
  305. package/dist/semanticTree.d.ts +10 -0
  306. package/dist/semanticTree.js +539 -0
  307. package/dist/semanticTypes.d.ts +175 -0
  308. package/dist/semanticTypes.js +2 -0
  309. package/dist/semantics.d.ts +6 -0
  310. package/dist/semantics.js +5 -0
  311. package/dist/sequencePlayback.d.ts +19 -0
  312. package/dist/sequencePlayback.js +391 -0
  313. package/dist/sequencePlaybackTypes.d.ts +24 -0
  314. package/dist/sequencePlaybackTypes.js +2 -0
  315. package/dist/sequenceTargetClaims.d.ts +10 -0
  316. package/dist/sequenceTargetClaims.js +31 -0
  317. package/dist/srgbBytes.d.ts +3 -0
  318. package/dist/srgbBytes.js +64 -0
  319. package/dist/startEngine.d.ts +5 -0
  320. package/dist/startEngine.js +31 -0
  321. package/dist/surfaceOwnership.d.ts +3 -0
  322. package/dist/surfaceOwnership.js +15 -0
  323. package/dist/text.d.ts +24 -0
  324. package/dist/text.js +4 -0
  325. package/dist/textField.d.ts +6 -0
  326. package/dist/textField.js +6 -0
  327. package/dist/textTable.d.ts +41 -0
  328. package/dist/textTable.js +114 -0
  329. package/dist/tileMapDraw.d.ts +7 -0
  330. package/dist/tileMapDraw.js +310 -0
  331. package/dist/tiledImport.d.ts +9 -0
  332. package/dist/tiledImport.js +357 -0
  333. package/dist/tilemap.d.ts +5 -0
  334. package/dist/tilemap.js +5 -0
  335. package/dist/tilemapTypes.d.ts +182 -0
  336. package/dist/tilemapTypes.js +2 -0
  337. package/dist/timer.d.ts +34 -0
  338. package/dist/timer.js +119 -0
  339. package/dist/tween.d.ts +15 -0
  340. package/dist/tween.js +329 -0
  341. package/dist/tweenTypes.d.ts +31 -0
  342. package/dist/tweenTypes.js +2 -0
  343. package/dist/ui/controlKeys.d.ts +113 -0
  344. package/dist/ui/controlKeys.js +250 -0
  345. package/dist/ui/controls.d.ts +58 -0
  346. package/dist/ui/controls.js +290 -0
  347. package/dist/ui/editing.d.ts +3 -0
  348. package/dist/ui/editing.js +3 -0
  349. package/dist/ui/index.d.ts +19 -0
  350. package/dist/ui/index.js +11 -0
  351. package/dist/ui/keyboardFocus.d.ts +32 -0
  352. package/dist/ui/keyboardFocus.js +146 -0
  353. package/dist/ui/layerTypes.d.ts +98 -0
  354. package/dist/ui/layerTypes.js +2 -0
  355. package/dist/ui/layers.d.ts +4 -0
  356. package/dist/ui/layers.js +586 -0
  357. package/dist/ui/leafContent.d.ts +21 -0
  358. package/dist/ui/leafContent.js +136 -0
  359. package/dist/ui/rangeControl.d.ts +53 -0
  360. package/dist/ui/rangeControl.js +168 -0
  361. package/dist/ui/scrollControl.d.ts +84 -0
  362. package/dist/ui/scrollControl.js +222 -0
  363. package/dist/ui/stateControls.d.ts +90 -0
  364. package/dist/ui/stateControls.js +331 -0
  365. package/dist/ui/textEditor.d.ts +54 -0
  366. package/dist/ui/textEditor.js +371 -0
  367. package/dist/ui/textEditorTypes.d.ts +85 -0
  368. package/dist/ui/textEditorTypes.js +2 -0
  369. package/dist/ui/textFieldControl.d.ts +100 -0
  370. package/dist/ui/textFieldControl.js +260 -0
  371. package/dist/ui/theme.d.ts +64 -0
  372. package/dist/ui/theme.js +166 -0
  373. package/dist/ui/types.d.ts +285 -0
  374. package/dist/ui/types.js +2 -0
  375. package/dist/ui/uiRoot.d.ts +4 -0
  376. package/dist/ui/uiRoot.js +1526 -0
  377. package/dist/ui/uiRootDisplay.d.ts +46 -0
  378. package/dist/ui/uiRootDisplay.js +148 -0
  379. package/dist/ui/uiRootModel.d.ts +114 -0
  380. package/dist/ui/uiRootModel.js +66 -0
  381. package/dist/ui/virtualList.d.ts +20 -0
  382. package/dist/ui/virtualList.js +105 -0
  383. package/dist/video.d.ts +4 -0
  384. package/dist/video.js +4 -0
  385. package/dist/videoPlayer.d.ts +4 -0
  386. package/dist/videoPlayer.js +215 -0
  387. package/dist/videoTypes.d.ts +77 -0
  388. package/dist/videoTypes.js +2 -0
  389. package/dist/web/BrowserAssetBundle.d.ts +41 -0
  390. package/dist/web/BrowserAssetBundle.js +136 -0
  391. package/dist/web/BrowserAudio.d.ts +74 -0
  392. package/dist/web/BrowserAudio.js +503 -0
  393. package/dist/web/BrowserFrameLoop.d.ts +69 -0
  394. package/dist/web/BrowserFrameLoop.js +125 -0
  395. package/dist/web/BrowserGame.d.ts +174 -0
  396. package/dist/web/BrowserGame.js +473 -0
  397. package/dist/web/BrowserGamepadInput.d.ts +38 -0
  398. package/dist/web/BrowserGamepadInput.js +134 -0
  399. package/dist/web/BrowserHoverInput.d.ts +25 -0
  400. package/dist/web/BrowserHoverInput.js +266 -0
  401. package/dist/web/BrowserImageTextures.d.ts +72 -0
  402. package/dist/web/BrowserImageTextures.js +169 -0
  403. package/dist/web/BrowserInputActions.d.ts +63 -0
  404. package/dist/web/BrowserInputActions.js +345 -0
  405. package/dist/web/BrowserKeyboardInput.d.ts +4 -0
  406. package/dist/web/BrowserKeyboardInput.js +223 -0
  407. package/dist/web/BrowserPlay.d.ts +417 -0
  408. package/dist/web/BrowserPlay.js +1648 -0
  409. package/dist/web/BrowserPointerInput.d.ts +4 -0
  410. package/dist/web/BrowserPointerInput.js +511 -0
  411. package/dist/web/BrowserPreferences.d.ts +10 -0
  412. package/dist/web/BrowserPreferences.js +39 -0
  413. package/dist/web/BrowserSemantics.d.ts +36 -0
  414. package/dist/web/BrowserSemantics.js +418 -0
  415. package/dist/web/BrowserStatsPanel.d.ts +56 -0
  416. package/dist/web/BrowserStatsPanel.js +143 -0
  417. package/dist/web/BrowserStorage.d.ts +35 -0
  418. package/dist/web/BrowserStorage.js +132 -0
  419. package/dist/web/BrowserTextEditor.d.ts +52 -0
  420. package/dist/web/BrowserTextEditor.js +839 -0
  421. package/dist/web/BrowserTextInput.d.ts +89 -0
  422. package/dist/web/BrowserTextInput.js +524 -0
  423. package/dist/web/BrowserTextureProvider.d.ts +58 -0
  424. package/dist/web/BrowserTextureProvider.js +935 -0
  425. package/dist/web/BrowserVideo.d.ts +40 -0
  426. package/dist/web/BrowserVideo.js +237 -0
  427. package/dist/web/CanvasKitFontSetProvider.d.ts +32 -0
  428. package/dist/web/CanvasKitFontSetProvider.js +215 -0
  429. package/dist/web/CanvasKitParagraphProvider.d.ts +173 -0
  430. package/dist/web/CanvasKitParagraphProvider.js +692 -0
  431. package/dist/web/CanvasTextRasterProvider.d.ts +4 -0
  432. package/dist/web/CanvasTextRasterProvider.js +312 -0
  433. package/dist/web/ManifestByteSource.d.ts +151 -0
  434. package/dist/web/ManifestByteSource.js +975 -0
  435. package/dist/web/ManifestFontContentLoader.d.ts +13 -0
  436. package/dist/web/ManifestFontContentLoader.js +30 -0
  437. package/dist/web/MouseInput.d.ts +4 -0
  438. package/dist/web/MouseInput.js +218 -0
  439. package/dist/web/WebGL2Host.d.ts +5 -0
  440. package/dist/web/WebGL2Host.js +2711 -0
  441. package/dist/web/WebGPUHost.d.ts +100 -0
  442. package/dist/web/WebGPUHost.js +3430 -0
  443. package/dist/web/audio.d.ts +3 -0
  444. package/dist/web/audio.js +4 -0
  445. package/dist/web/canvasKitParagraphGeometry.d.ts +27 -0
  446. package/dist/web/canvasKitParagraphGeometry.js +83 -0
  447. package/dist/web/editing.d.ts +5 -0
  448. package/dist/web/editing.js +4 -0
  449. package/dist/web/editorFonts.d.ts +54 -0
  450. package/dist/web/editorFonts.js +297 -0
  451. package/dist/web/game.d.ts +5 -0
  452. package/dist/web/game.js +6 -0
  453. package/dist/web/gamepad.d.ts +3 -0
  454. package/dist/web/gamepad.js +4 -0
  455. package/dist/web/hover.d.ts +3 -0
  456. package/dist/web/hover.js +4 -0
  457. package/dist/web/image.d.ts +4 -0
  458. package/dist/web/image.js +4 -0
  459. package/dist/web/imageProjections2D.d.ts +16 -0
  460. package/dist/web/imageProjections2D.js +2 -0
  461. package/dist/web/input.d.ts +6 -0
  462. package/dist/web/input.js +4 -0
  463. package/dist/web/keyboard.d.ts +3 -0
  464. package/dist/web/keyboard.js +3 -0
  465. package/dist/web/kit.d.ts +11 -0
  466. package/dist/web/kit.js +8 -0
  467. package/dist/web/loop.d.ts +3 -0
  468. package/dist/web/loop.js +4 -0
  469. package/dist/web/paragraph.d.ts +6 -0
  470. package/dist/web/paragraph.js +4 -0
  471. package/dist/web/play.d.ts +10 -0
  472. package/dist/web/play.js +9 -0
  473. package/dist/web/playMusic.d.ts +33 -0
  474. package/dist/web/playMusic.js +194 -0
  475. package/dist/web/playSfx.d.ts +36 -0
  476. package/dist/web/playSfx.js +112 -0
  477. package/dist/web/playTouch.d.ts +45 -0
  478. package/dist/web/playTouch.js +141 -0
  479. package/dist/web/playWidgets.d.ts +71 -0
  480. package/dist/web/playWidgets.js +431 -0
  481. package/dist/web/pointer.d.ts +3 -0
  482. package/dist/web/pointer.js +3 -0
  483. package/dist/web/prepareSharedSubmission2D.d.ts +27 -0
  484. package/dist/web/prepareSharedSubmission2D.js +63 -0
  485. package/dist/web/resources.d.ts +29 -0
  486. package/dist/web/resources.js +96 -0
  487. package/dist/web/semantics.d.ts +3 -0
  488. package/dist/web/semantics.js +4 -0
  489. package/dist/web/sharedDeviceSession.d.ts +64 -0
  490. package/dist/web/sharedDeviceSession.js +2 -0
  491. package/dist/web/sharedEffectShaders.d.ts +13 -0
  492. package/dist/web/sharedEffectShaders.js +181 -0
  493. package/dist/web/sharedFrameUpload.d.ts +25 -0
  494. package/dist/web/sharedFrameUpload.js +2 -0
  495. package/dist/web/sharedHostDeferred.d.ts +7 -0
  496. package/dist/web/sharedHostDeferred.js +12 -0
  497. package/dist/web/sharedRetentionLedger.d.ts +85 -0
  498. package/dist/web/sharedRetentionLedger.js +391 -0
  499. package/dist/web/sharedSubmissionStorage2D.d.ts +56 -0
  500. package/dist/web/sharedSubmissionStorage2D.js +73 -0
  501. package/dist/web/sharedWebGL2Arena.d.ts +40 -0
  502. package/dist/web/sharedWebGL2Arena.js +77 -0
  503. package/dist/web/sharedWebGL2Options.d.ts +33 -0
  504. package/dist/web/sharedWebGL2Options.js +102 -0
  505. package/dist/web/sharedWebGL2Shaders.d.ts +33 -0
  506. package/dist/web/sharedWebGL2Shaders.js +408 -0
  507. package/dist/web/sharedWebGPUOptions.d.ts +41 -0
  508. package/dist/web/sharedWebGPUOptions.js +130 -0
  509. package/dist/web/text.d.ts +3 -0
  510. package/dist/web/text.js +3 -0
  511. package/dist/web/textInput.d.ts +3 -0
  512. package/dist/web/textInput.js +3 -0
  513. package/dist/web/video.d.ts +3 -0
  514. package/dist/web/video.js +4 -0
  515. package/dist/web/webgl2.d.ts +7 -0
  516. package/dist/web/webgl2.js +4 -0
  517. package/dist/web/webgl2LayerState.d.ts +50 -0
  518. package/dist/web/webgl2LayerState.js +102 -0
  519. package/dist/web/webgl2Native.d.ts +72 -0
  520. package/dist/web/webgl2Native.js +572 -0
  521. package/dist/web/webgl2Types.d.ts +150 -0
  522. package/dist/web/webgl2Types.js +2 -0
  523. package/dist/web/webgpu.d.ts +6 -0
  524. package/dist/web/webgpu.js +2 -0
  525. package/dist/web/webgpuBindingCache.d.ts +26 -0
  526. package/dist/web/webgpuBindingCache.js +223 -0
  527. package/dist/web/webgpuBufferPool.d.ts +51 -0
  528. package/dist/web/webgpuBufferPool.js +58 -0
  529. package/dist/web/webgpuImageResidency.d.ts +56 -0
  530. package/dist/web/webgpuImageResidency.js +65 -0
  531. package/dist/web/webgpuLifetime.d.ts +45 -0
  532. package/dist/web/webgpuLifetime.js +64 -0
  533. package/dist/web/webgpuRetentionPool.d.ts +66 -0
  534. package/dist/web/webgpuRetentionPool.js +85 -0
  535. package/dist/web/webgpuSharedPass.d.ts +7 -0
  536. package/dist/web/webgpuSharedPass.js +293 -0
  537. package/dist/web/webgpuSharedResolvePass.d.ts +3 -0
  538. package/dist/web/webgpuSharedResolvePass.js +34 -0
  539. package/dist/web/world3d/Audio3D.d.ts +85 -0
  540. package/dist/web/world3d/Audio3D.js +271 -0
  541. package/dist/web/world3d/BrowserPlay3D.d.ts +295 -0
  542. package/dist/web/world3d/BrowserPlay3D.js +1256 -0
  543. package/dist/web/world3d/FlyControls3D.d.ts +59 -0
  544. package/dist/web/world3d/FlyControls3D.js +162 -0
  545. package/dist/web/world3d/FollowControls3D.d.ts +31 -0
  546. package/dist/web/world3d/FollowControls3D.js +119 -0
  547. package/dist/web/world3d/OrbitControls3D.d.ts +58 -0
  548. package/dist/web/world3d/OrbitControls3D.js +189 -0
  549. package/dist/web/world3d/TransformControls3D.d.ts +37 -0
  550. package/dist/web/world3d/TransformControls3D.js +128 -0
  551. package/dist/web/world3d/WebGL2Renderer3D.d.ts +136 -0
  552. package/dist/web/world3d/WebGL2Renderer3D.js +1175 -0
  553. package/dist/web/world3d/WebGPURenderer3D.d.ts +112 -0
  554. package/dist/web/world3d/WebGPURenderer3D.js +1916 -0
  555. package/dist/web/world3d/World3DView.d.ts +54 -0
  556. package/dist/web/world3d/World3DView.js +79 -0
  557. package/dist/web/world3d/app3D.d.ts +143 -0
  558. package/dist/web/world3d/app3D.js +305 -0
  559. package/dist/web/world3d/assets3D.d.ts +39 -0
  560. package/dist/web/world3d/assets3D.js +112 -0
  561. package/dist/web/world3d/atmosphere3D.d.ts +56 -0
  562. package/dist/web/world3d/atmosphere3D.js +193 -0
  563. package/dist/web/world3d/canvasFont3D.d.ts +21 -0
  564. package/dist/web/world3d/canvasFont3D.js +165 -0
  565. package/dist/web/world3d/frame3D.d.ts +144 -0
  566. package/dist/web/world3d/frame3D.js +388 -0
  567. package/dist/web/world3d/gpuResources3D.d.ts +98 -0
  568. package/dist/web/world3d/gpuResources3D.js +901 -0
  569. package/dist/web/world3d/host3D.d.ts +24 -0
  570. package/dist/web/world3d/host3D.js +61 -0
  571. package/dist/web/world3d/index.d.ts +40 -0
  572. package/dist/web/world3d/index.js +24 -0
  573. package/dist/web/world3d/loaders3D.d.ts +27 -0
  574. package/dist/web/world3d/loaders3D.js +138 -0
  575. package/dist/web/world3d/markers3D.d.ts +53 -0
  576. package/dist/web/world3d/markers3D.js +130 -0
  577. package/dist/web/world3d/materialWebGL23D.d.ts +34 -0
  578. package/dist/web/world3d/materialWebGL23D.js +218 -0
  579. package/dist/web/world3d/overlay3D.d.ts +47 -0
  580. package/dist/web/world3d/overlay3D.js +187 -0
  581. package/dist/web/world3d/post3D.d.ts +116 -0
  582. package/dist/web/world3d/post3D.js +462 -0
  583. package/dist/web/world3d/postWebGL23D.d.ts +24 -0
  584. package/dist/web/world3d/postWebGL23D.js +237 -0
  585. package/dist/web/world3d/postWebGPU3D.d.ts +23 -0
  586. package/dist/web/world3d/postWebGPU3D.js +255 -0
  587. package/dist/web/world3d/probe3D.d.ts +15 -0
  588. package/dist/web/world3d/probe3D.js +66 -0
  589. package/dist/web/world3d/shaders3D.d.ts +43 -0
  590. package/dist/web/world3d/shaders3D.js +851 -0
  591. package/dist/web/world3d/stats3D.d.ts +34 -0
  592. package/dist/web/world3d/stats3D.js +81 -0
  593. package/dist/web/world3d/webGL2FrameMetrics3D.d.ts +71 -0
  594. package/dist/web/world3d/webGL2FrameMetrics3D.js +185 -0
  595. package/dist/web/world3d/webgpu.d.ts +37 -0
  596. package/dist/web/world3d/webgpu.js +23 -0
  597. package/dist/web/world3d/webgpuPacking3D.d.ts +13 -0
  598. package/dist/web/world3d/webgpuPacking3D.js +85 -0
  599. package/dist/web/world3d/wgsl3D.d.ts +68 -0
  600. package/dist/web/world3d/wgsl3D.js +781 -0
  601. package/package.json +220 -4
@@ -0,0 +1,269 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // Surface descriptions consumed by the first-party shader library. All color
3
+ // values are linear RGB; factories accept 0xRRGGBB sRGB hex for convenience.
4
+ import { Resource3D, World3DError } from './core3D.js';
5
+ import { colorFromHex } from './math3D.js';
6
+ /** Makes a material drawn by shaders of your own. */
7
+ export function createCustomShader3D(input) {
8
+ if (!input || typeof input.key !== 'string' || input.key.length === 0 || /[\s|/]/.test(input.key))
9
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'shader key');
10
+ if (input.glsl === undefined &&
11
+ input.wgsl === undefined &&
12
+ input.glslVertex === undefined &&
13
+ input.wgslVertex === undefined &&
14
+ input.glslNormal === undefined &&
15
+ input.wgslNormal === undefined)
16
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'shader source');
17
+ const uniforms = new Float32Array(16);
18
+ if (input.uniforms)
19
+ uniforms.set(Array.from(input.uniforms).slice(0, 16));
20
+ return Object.freeze({
21
+ key: input.key,
22
+ ...(input.glsl === undefined ? {} : { glsl: input.glsl }),
23
+ ...(input.wgsl === undefined ? {} : { wgsl: input.wgsl }),
24
+ ...(input.glslVertex === undefined ? {} : { glslVertex: input.glslVertex }),
25
+ ...(input.wgslVertex === undefined ? {} : { wgslVertex: input.wgslVertex }),
26
+ ...(input.glslNormal === undefined ? {} : { glslNormal: input.glslNormal }),
27
+ ...(input.wgslNormal === undefined ? {} : { wgslNormal: input.wgslNormal }),
28
+ uniforms
29
+ });
30
+ }
31
+ /** Writes a color into a float array as red, green and blue. */
32
+ export function setColor3D(out, input) {
33
+ if (typeof input === 'number')
34
+ colorFromHex(out, input);
35
+ else if (Array.isArray(input) && input.length === 3 && input.every(Number.isFinite)) {
36
+ out[0] = input[0];
37
+ out[1] = input[1];
38
+ out[2] = input[2];
39
+ }
40
+ else
41
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'color');
42
+ return out;
43
+ }
44
+ /**
45
+ * One material class carries the superset of surface parameters; `shading`
46
+ * selects the lighting model. Assign fields freely and call touch() when a
47
+ * change alters shader features (maps added or removed, alpha mode, side).
48
+ * Scalar and color edits take effect on the next draw without touch().
49
+ */
50
+ export class Material3D extends Resource3D {
51
+ shading;
52
+ color = new Float32Array([1, 1, 1]);
53
+ opacity = 1;
54
+ map;
55
+ side = 'front';
56
+ alphaMode = 'opaque';
57
+ /** Fragments below this alpha are discarded in 'mask' mode. */
58
+ alphaCutoff = 0.5;
59
+ /** How a blended fragment combines with what is behind it. Used only when `alphaMode` is 'blend'. */
60
+ blending = 'normal';
61
+ depthTest = true;
62
+ depthWrite = true;
63
+ /** Multiply the base color by the geometry's `color` attribute. */
64
+ vertexColors = false;
65
+ fog = true;
66
+ toneMapped = true;
67
+ visible = true;
68
+ emissive = new Float32Array([0, 0, 0]);
69
+ emissiveIntensity = 1;
70
+ emissiveMap;
71
+ normalMap;
72
+ normalScale = 1;
73
+ occlusionMap;
74
+ occlusionStrength = 1;
75
+ flatShading = false;
76
+ wireframe = false;
77
+ // Phong
78
+ specular = new Float32Array([0.07, 0.07, 0.07]);
79
+ shininess = 30;
80
+ /** Optional fragment hook. Call touch() after assigning a different shader. */
81
+ shader;
82
+ /**
83
+ * Baked lighting added to the indirect light of lit materials. It is sampled
84
+ * with the texture's `channel`, normally 1 for a second, non-overlapping UV set.
85
+ */
86
+ lightMap;
87
+ lightMapIntensity = 1;
88
+ /**
89
+ * A mirror image of the scene for a flat reflective surface on a standard
90
+ * material, normally the texture of a PlanarReflection3D. It is read at
91
+ * the pixel's own place on screen, so the mesh needs no coordinates for
92
+ * it, and it takes the place of the environment map's reflection.
93
+ */
94
+ reflectionMap;
95
+ reflectionStrength = 1;
96
+ /** How far the surface normal pushes the mirror image sideways, as a share of the screen. */
97
+ reflectionDistortion = 0.02;
98
+ /**
99
+ * For blended materials such as particles and haze: the distance over which
100
+ * the surface fades out where it comes close to the solid geometry behind
101
+ * it, instead of ending in a hard line. 0 turns the fade off.
102
+ */
103
+ softness = 0;
104
+ /**
105
+ * Ground layers blended by a weight map, for terrain: up to four tiling
106
+ * textures, each shown where its channel of `weights` (R, G, B, A) is
107
+ * strong. Weights are read with the mesh's coordinates as they are and
108
+ * layers with those coordinates times their `repeat`. The layers take
109
+ * the texture slots of map, emissiveMap, occlusionMap, metallicRoughnessMap
110
+ * and lightMap, so leave those unset. Call touch() after assigning.
111
+ */
112
+ splat;
113
+ /** Strength, 0 to 1, of a soft rim lobe for cloth and velvet on a standard material. */
114
+ sheen = 0;
115
+ sheenColor = new Float32Array([1, 1, 1]);
116
+ sheenRoughness = 0.5;
117
+ /**
118
+ * How much light passes through a standard material, 0 to 1, as for glass.
119
+ * What lies behind is drawn first and then seen through the surface,
120
+ * tinted by its color and blurred by its roughness. Such a material is
121
+ * drawn with the transparent objects whatever its alphaMode; other
122
+ * see-through and transparent objects behind it do not show through.
123
+ */
124
+ transmission = 0;
125
+ /** Index of refraction for transmission: 1 does not bend light, 1.5 is glass, 1.33 water. */
126
+ ior = 1.5;
127
+ /** How far, in world units, light travels inside a transmitting object. Zero means a thin sheet that does not bend the view. */
128
+ thickness = 0;
129
+ /** Color white light takes on after travelling `attenuationDistance` inside a transmitting object. */
130
+ attenuationColor = new Float32Array([1, 1, 1]);
131
+ attenuationDistance = Infinity;
132
+ /** Strength, 0 to 1, of a clear lacquer layer over a standard material (car paint, varnish). */
133
+ clearcoat = 0;
134
+ clearcoatRoughness = 0.1;
135
+ /** Number of light bands for toon shading. */
136
+ toonSteps = 3;
137
+ // Standard (metallic-roughness PBR)
138
+ metallic = 0;
139
+ roughness = 1;
140
+ metallicRoughnessMap;
141
+ environmentIntensity = 1;
142
+ // Sprite and point rendering
143
+ billboard = false;
144
+ /** Treat vertex positions as normalized device coordinates; used by full-screen layers. */
145
+ screenSpace = false;
146
+ sizeAttenuation = true;
147
+ rotation = 0;
148
+ pointSize = 1;
149
+ /** Polygon offset to resolve coplanar decals: [factor, units]. */
150
+ polygonOffset;
151
+ constructor(shading, options = {}) {
152
+ super();
153
+ this.shading = shading;
154
+ this.name = options.name ?? '';
155
+ if (options.color !== undefined)
156
+ setColor3D(this.color, options.color);
157
+ if (options.emissive !== undefined)
158
+ setColor3D(this.emissive, options.emissive);
159
+ this.opacity = options.opacity ?? 1;
160
+ this.map = options.map;
161
+ this.side = options.side ?? 'front';
162
+ // Additive, multiply and premultiplied blending only take effect in the blended pass, so asking for one
163
+ // is asking for that pass.
164
+ this.alphaMode =
165
+ options.alphaMode ?? (this.opacity < 1 || (options.blending ?? 'normal') !== 'normal' ? 'blend' : 'opaque');
166
+ this.alphaCutoff = options.alphaCutoff ?? 0.5;
167
+ this.blending = options.blending ?? 'normal';
168
+ this.depthTest = options.depthTest ?? true;
169
+ this.depthWrite = options.depthWrite ?? this.alphaMode !== 'blend';
170
+ this.vertexColors = options.vertexColors ?? false;
171
+ this.fog = options.fog ?? true;
172
+ this.toneMapped = options.toneMapped ?? true;
173
+ this.emissiveIntensity = options.emissiveIntensity ?? 1;
174
+ this.emissiveMap = options.emissiveMap;
175
+ this.normalMap = options.normalMap;
176
+ this.normalScale = options.normalScale ?? 1;
177
+ this.occlusionMap = options.occlusionMap;
178
+ this.occlusionStrength = options.occlusionStrength ?? 1;
179
+ this.flatShading = options.flatShading ?? false;
180
+ this.wireframe = options.wireframe ?? false;
181
+ }
182
+ /** True when the material must be drawn in the sorted transparent pass. */
183
+ get isTransparent() {
184
+ return this.alphaMode === 'blend';
185
+ }
186
+ setColor(color) {
187
+ setColor3D(this.color, color);
188
+ return this;
189
+ }
190
+ setEmissive(color) {
191
+ setColor3D(this.emissive, color);
192
+ return this;
193
+ }
194
+ /** Independent copy sharing texture references. */
195
+ clone() {
196
+ const copy = new Material3D(this.shading);
197
+ const skip = new Set(['id', 'shading', 'color', 'emissive', 'specular', 'sheenColor', 'attenuationColor']);
198
+ for (const key of Object.keys(this)) {
199
+ if (!skip.has(key))
200
+ copy[key] = this[key];
201
+ }
202
+ copy.color.set(this.color);
203
+ copy.emissive.set(this.emissive);
204
+ copy.specular.set(this.specular);
205
+ copy.sheenColor.set(this.sheenColor);
206
+ copy.attenuationColor.set(this.attenuationColor);
207
+ return copy;
208
+ }
209
+ }
210
+ /** Constant color, unaffected by lights. */
211
+ export function createUnlitMaterial3D(options = {}) {
212
+ return new Material3D('unlit', options);
213
+ }
214
+ /** Diffuse-only lighting; the cheapest lit model. */
215
+ export function createLambertMaterial3D(options = {}) {
216
+ return new Material3D('lambert', options);
217
+ }
218
+ /** Diffuse plus Blinn-Phong specular highlights. */
219
+ export function createPhongMaterial3D(options = {}) {
220
+ const material = new Material3D('phong', options);
221
+ if (options.specular !== undefined)
222
+ setColor3D(material.specular, options.specular);
223
+ material.shininess = options.shininess ?? 30;
224
+ return material;
225
+ }
226
+ /** Cel shading: diffuse light quantized into `steps` flat bands. */
227
+ export function createToonMaterial3D(options = {}) {
228
+ const material = new Material3D('toon', options);
229
+ material.toonSteps = Math.max(1, Math.floor(options.steps ?? 3));
230
+ return material;
231
+ }
232
+ /**
233
+ * Lighting baked into a sphere image: the surface color is looked up by the
234
+ * view-space normal, so no lights are needed. The image is held in `emissiveMap`.
235
+ */
236
+ export function createMatcapMaterial3D(options) {
237
+ const material = new Material3D('matcap', options);
238
+ material.emissiveMap = options.matcap;
239
+ return material;
240
+ }
241
+ /**
242
+ * A standard material set up as glass: smooth and see-through, with
243
+ * reflections kept. Give it a `thickness` to bend the view like a solid block.
244
+ */
245
+ export function createGlassMaterial3D(options = {}) {
246
+ const material = createStandardMaterial3D({ roughness: 0.05, metallic: 0, ...options });
247
+ material.transmission = options.transmission ?? 1;
248
+ material.ior = options.ior ?? 1.5;
249
+ material.thickness = options.thickness ?? 0;
250
+ return material;
251
+ }
252
+ /** Physically based metallic-roughness model, matching glTF 2.0 materials. */
253
+ export function createStandardMaterial3D(options = {}) {
254
+ const material = new Material3D('standard', options);
255
+ material.metallic = options.metallic ?? 0;
256
+ material.roughness = options.roughness ?? 1;
257
+ material.metallicRoughnessMap = options.metallicRoughnessMap;
258
+ material.environmentIntensity = options.environmentIntensity ?? 1;
259
+ return material;
260
+ }
261
+ /** Camera-facing unlit quad material for Sprite3D. */
262
+ export function createSpriteMaterial3D(options = {}) {
263
+ const material = new Material3D('unlit', { alphaMode: 'blend', side: 'double', ...options });
264
+ material.billboard = true;
265
+ material.sizeAttenuation = options.sizeAttenuation ?? true;
266
+ material.rotation = options.rotation ?? 0;
267
+ return material;
268
+ }
269
+ //# sourceMappingURL=Material3D.js.map
@@ -0,0 +1,112 @@
1
+ import { Geometry3D } from './Geometry3D.js';
2
+ import { Material3D } from './Material3D.js';
3
+ import type { SpriteMaterialOptions3D } from './Material3D.js';
4
+ import { Object3D } from './Object3D.js';
5
+ /** The most bones, instances and materials a mesh has. */
6
+ export declare const MESH3D_LIMITS: Readonly<{
7
+ readonly maxBones: 1024;
8
+ readonly maxInstances: 1048576;
9
+ readonly maxMaterials: 64;
10
+ }>;
11
+ /** A bone of a skeleton. */
12
+ export declare class Bone3D extends Object3D {
13
+ constructor();
14
+ }
15
+ /** Ordered bones with their inverse bind matrices; one instance may drive many meshes. */
16
+ export declare class Skeleton3D {
17
+ #private;
18
+ readonly bones: readonly Object3D[];
19
+ /** 16 floats per bone: bind-pose mesh space to bone space. */
20
+ readonly inverseBindMatrices: Float32Array;
21
+ /** 16 floats per bone: boneWorld * inverseBind, refreshed by update(). */
22
+ readonly boneMatrices: Float32Array;
23
+ /** Increases on every update(); backends compare it before re-uploading. */
24
+ version: number;
25
+ constructor(bones: readonly Object3D[], inverseBindMatrices?: Float32Array);
26
+ /** Recompute skinning matrices once per frame id; later calls in the same frame are free. */
27
+ update(frame: number): void;
28
+ }
29
+ /** A geometry drawn with materials, with its morph weights and skeleton. */
30
+ export declare class Mesh3D extends Object3D {
31
+ #private;
32
+ /** Optional hook the render list calls once per frame before the mesh is culled and sorted. */
33
+ beforeRender?(camera: import('./Camera3D.js').Camera3D): void;
34
+ geometry: Geometry3D;
35
+ /** false leaves the mesh out of ray picking, as for effects whose drawn shape is not their geometry. */
36
+ pickable: boolean;
37
+ /** One material, or one per geometry group addressed by materialIndex. */
38
+ material: Material3D | Material3D[];
39
+ /** Weight per geometry morph target; resized automatically to the target count. */
40
+ morphWeights: Float32Array;
41
+ skeleton: Skeleton3D | undefined;
42
+ /** Mesh-space to skeleton-space matrix captured at bind time. */
43
+ readonly bindMatrix: Float32Array;
44
+ constructor(geometry?: Geometry3D, material?: Material3D | Material3D[]);
45
+ get isInstanced(): boolean;
46
+ /**
47
+ * True when an instanced draw could stand in for this mesh: it is a plain
48
+ * Mesh3D without skinning or morphing, and its transform is not mirrored.
49
+ * The renderer uses it to fold repeated meshes into one draw.
50
+ */
51
+ get canInstance(): boolean;
52
+ /** Material for a geometry group index, falling back to the first slot. */
53
+ materialAt(index: number): Material3D;
54
+ /** Keep the weight array the same length as the geometry's morph target list. */
55
+ syncMorphWeights(): void;
56
+ /** Attach a skeleton; the current world matrix becomes the bind matrix. */
57
+ bind(skeleton: Skeleton3D, bindMatrix?: ArrayLike<number>): this;
58
+ /**
59
+ * World-space bounding sphere [x, y, z, radius], cached per geometry and
60
+ * world version. Skinned meshes are bounded by their bones instead.
61
+ */
62
+ get worldBoundingSphere(): Float32Array;
63
+ private skinnedBounds;
64
+ clone(recursive?: boolean): this;
65
+ protected copyFrom(source: this): void;
66
+ }
67
+ interface InstanceStreamRevisions {
68
+ observed: number;
69
+ matrices: number;
70
+ colors: number;
71
+ }
72
+ declare const readInstanceStreamRevisions: unique symbol;
73
+ /** Reconcile legacy bulk edits before a renderer checks either instance stream. */
74
+ export declare function instanceStreamRevisions3D(mesh: InstancedMesh3D): Readonly<InstanceStreamRevisions>;
75
+ /** Draw one geometry many times in a single call with per-instance transforms and colors. */
76
+ export declare class InstancedMesh3D extends Mesh3D {
77
+ #private;
78
+ readonly capacity: number;
79
+ /** Number of instances drawn; at most `capacity`. */
80
+ count: number;
81
+ /** 16 floats per instance, relative to this node. */
82
+ readonly instanceMatrices: Float32Array;
83
+ /** Optional linear RGB (or RGBA) per instance, created on first setColorAt(). */
84
+ instanceColors: Float32Array | undefined;
85
+ /** Components per instance color: 3 for RGB, 4 when instances also carry opacity. */
86
+ readonly instanceColorSize: 3 | 4;
87
+ /** Bump after editing instance arrays directly. */
88
+ instanceVersion: number;
89
+ /** Multiplies each instance's bounding radius, for instances that move beyond the geometry, such as animated ones. */
90
+ boundsScale: number;
91
+ constructor(geometry: Geometry3D, material: Material3D | Material3D[], capacity: number, instanceColorSize?: 3 | 4);
92
+ get isInstanced(): boolean;
93
+ setMatrixAt(index: number, matrix: ArrayLike<number>): void;
94
+ setTransformAt(index: number, position: ArrayLike<number>, quaternion?: ArrayLike<number>, scale?: ArrayLike<number> | number): void;
95
+ setColorAt(index: number, r: number, g: number, b: number, a?: number): void;
96
+ [readInstanceStreamRevisions](): InstanceStreamRevisions;
97
+ private touchInstanceStream;
98
+ /** Sphere enclosing every instance, in world space. */
99
+ get worldBoundingSphere(): Float32Array;
100
+ private readonly localSphere;
101
+ clone(): this;
102
+ }
103
+ /** Camera-facing textured quad. Scale the node to size it; all sprites share one quad geometry. */
104
+ export declare class Sprite3D extends Mesh3D {
105
+ constructor(material?: Material3D);
106
+ get worldBoundingSphere(): Float32Array;
107
+ clone(): this;
108
+ }
109
+ /** Makes a sprite: a picture that always faces the camera. */
110
+ export declare function createSprite3D(options?: SpriteMaterialOptions3D): Sprite3D;
111
+ export {};
112
+ //# sourceMappingURL=Mesh3D.d.ts.map