@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,191 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // High-dynamic-range environment images: a reader for Radiance .hdr (RGBE)
3
+ // files and a converter from an equirectangular panorama to a cube texture
4
+ // usable as a background and as image-based lighting.
5
+ import { World3DError, requireCount3D } from './core3D.js';
6
+ import { linearToSrgb, srgbToLinear } from './math3D.js';
7
+ import { CubeTexture3D } from './Texture3D.js';
8
+ /** The largest HDR image read. */
9
+ export const HDR3D_LIMITS = Object.freeze({ maxEdge: 16384, maxPixels: 67108864 });
10
+ function fail(detail) {
11
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'hdr: ' + detail);
12
+ }
13
+ /** Decode a Radiance .hdr file (flat or run-length encoded, -Y +X orientation). */
14
+ export function parseRgbe3D(bytes) {
15
+ if (!(bytes instanceof Uint8Array))
16
+ fail('bytes');
17
+ let offset = 0;
18
+ const line = () => {
19
+ let text = '';
20
+ while (offset < bytes.length && bytes[offset] !== 10) {
21
+ text += String.fromCharCode(bytes[offset]);
22
+ offset++;
23
+ if (text.length > 1024)
24
+ fail('header line');
25
+ }
26
+ offset++;
27
+ return text;
28
+ };
29
+ if (!/^#\?(RADIANCE|RGBE)/.test(line()))
30
+ fail('signature');
31
+ let format = '';
32
+ for (;;) {
33
+ if (offset >= bytes.length)
34
+ fail('header');
35
+ const text = line();
36
+ if (text.length === 0)
37
+ break;
38
+ if (text.startsWith('FORMAT='))
39
+ format = text.slice(7).trim();
40
+ }
41
+ if (format !== '' && format !== '32-bit_rle_rgbe')
42
+ fail('format ' + format);
43
+ const size = /^-Y (\d+) \+X (\d+)$/.exec(line().trim());
44
+ if (!size)
45
+ fail('orientation');
46
+ const height = Number(size[1]), width = Number(size[2]);
47
+ if (width < 1 ||
48
+ height < 1 ||
49
+ width > HDR3D_LIMITS.maxEdge ||
50
+ height > HDR3D_LIMITS.maxEdge ||
51
+ width * height > HDR3D_LIMITS.maxPixels)
52
+ throw new World3DError('WORLD3D_BUDGET', 'hdr size');
53
+ const data = new Float32Array(width * height * 3), scanline = new Uint8Array(width * 4);
54
+ for (let y = 0; y < height; y++) {
55
+ if (offset + 4 > bytes.length)
56
+ fail('truncated');
57
+ if (width >= 8 &&
58
+ width < 32768 &&
59
+ bytes[offset] === 2 &&
60
+ bytes[offset + 1] === 2 &&
61
+ ((bytes[offset + 2] << 8) | bytes[offset + 3]) === width) {
62
+ // New-style run-length encoding: the four channels are stored one after another.
63
+ offset += 4;
64
+ for (let channel = 0; channel < 4; channel++) {
65
+ let x = 0;
66
+ while (x < width) {
67
+ if (offset >= bytes.length)
68
+ fail('truncated');
69
+ let count = bytes[offset++];
70
+ if (count > 128) {
71
+ count -= 128;
72
+ if (count === 0 || x + count > width || offset >= bytes.length)
73
+ fail('run');
74
+ const value = bytes[offset++];
75
+ while (count-- > 0)
76
+ scanline[x++ * 4 + channel] = value;
77
+ }
78
+ else {
79
+ if (count === 0 || x + count > width || offset + count > bytes.length)
80
+ fail('run');
81
+ while (count-- > 0)
82
+ scanline[x++ * 4 + channel] = bytes[offset++];
83
+ }
84
+ }
85
+ }
86
+ }
87
+ else {
88
+ if (offset + width * 4 > bytes.length)
89
+ fail('truncated');
90
+ scanline.set(bytes.subarray(offset, offset + width * 4));
91
+ offset += width * 4;
92
+ }
93
+ for (let x = 0; x < width; x++) {
94
+ const e = scanline[x * 4 + 3], o = (y * width + x) * 3;
95
+ if (e === 0)
96
+ continue;
97
+ const scale = Math.pow(2, e - 136);
98
+ data[o] = scanline[x * 4] * scale;
99
+ data[o + 1] = scanline[x * 4 + 1] * scale;
100
+ data[o + 2] = scanline[x * 4 + 2] * scale;
101
+ }
102
+ }
103
+ return { width, height, data };
104
+ }
105
+ /**
106
+ * Build a cube texture from an equirectangular panorama. The source is either
107
+ * linear floats (three per pixel, as parseRgbe3D returns) or sRGB bytes (four
108
+ * per pixel). Faces are stored as 8-bit sRGB after exposure and soft
109
+ * compression of highlights.
110
+ */
111
+ export function createCubeTextureFromEquirect3D(image, options = {}) {
112
+ const width = image?.width, height = image?.height, source = image?.data;
113
+ const float = source instanceof Float32Array, channels = float ? 3 : 4;
114
+ if (!source || !(width > 0) || !(height > 0) || source.length !== width * height * channels)
115
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'equirect image');
116
+ const edge = requireCount3D(options.size ?? 256, 'cube size', 2048);
117
+ if (edge < 2)
118
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'cube size');
119
+ const exposure = options.exposure ?? 1, limit = Math.max(options.maxValue ?? 1, 1e-3), faces = [], sample = [0, 0, 0];
120
+ const texel = (x, y, weight) => {
121
+ const column = ((x % width) + width) % width, row = Math.min(Math.max(y, 0), height - 1), o = (row * width + column) * channels;
122
+ if (float) {
123
+ sample[0] += source[o] * weight;
124
+ sample[1] += source[o + 1] * weight;
125
+ sample[2] += source[o + 2] * weight;
126
+ }
127
+ else {
128
+ sample[0] += srgbToLinear(source[o] / 255) * weight;
129
+ sample[1] += srgbToLinear(source[o + 1] / 255) * weight;
130
+ sample[2] += srgbToLinear(source[o + 2] / 255) * weight;
131
+ }
132
+ };
133
+ for (let face = 0; face < 6; face++) {
134
+ const data = new Uint8Array(edge * edge * 4);
135
+ for (let y = 0; y < edge; y++)
136
+ for (let x = 0; x < edge; x++) {
137
+ // Texel center on the cube surface, following the OpenGL cube-map face layout.
138
+ const s = ((x + 0.5) / edge) * 2 - 1, t = ((y + 0.5) / edge) * 2 - 1;
139
+ let dx = 0, dy = 0, dz = 0;
140
+ if (face === 0) {
141
+ dx = 1;
142
+ dy = -t;
143
+ dz = -s;
144
+ }
145
+ else if (face === 1) {
146
+ dx = -1;
147
+ dy = -t;
148
+ dz = s;
149
+ }
150
+ else if (face === 2) {
151
+ dx = s;
152
+ dy = 1;
153
+ dz = t;
154
+ }
155
+ else if (face === 3) {
156
+ dx = s;
157
+ dy = -1;
158
+ dz = -t;
159
+ }
160
+ else if (face === 4) {
161
+ dx = s;
162
+ dy = -t;
163
+ dz = 1;
164
+ }
165
+ else {
166
+ dx = -s;
167
+ dy = -t;
168
+ dz = -1;
169
+ }
170
+ const length = Math.hypot(dx, dy, dz);
171
+ // Longitude wraps around +Y with -Z at the image center; latitude runs top to bottom.
172
+ const u = (Math.atan2(dx, -dz) / (Math.PI * 2) + 0.5) * width - 0.5, v = (Math.acos(Math.min(Math.max(dy / length, -1), 1)) / Math.PI) * height - 0.5;
173
+ const x0 = Math.floor(u), y0 = Math.floor(v), fx = u - x0, fy = v - y0;
174
+ sample[0] = sample[1] = sample[2] = 0;
175
+ texel(x0, y0, (1 - fx) * (1 - fy));
176
+ texel(x0 + 1, y0, fx * (1 - fy));
177
+ texel(x0, y0 + 1, (1 - fx) * fy);
178
+ texel(x0 + 1, y0 + 1, fx * fy);
179
+ const o = (y * edge + x) * 4;
180
+ for (let c = 0; c < 3; c++) {
181
+ const value = sample[c] * exposure;
182
+ // Reinhard-style shoulder scaled so `limit` maps to 1.
183
+ data[o + c] = Math.round(linearToSrgb(Math.min((value * (1 + value / (limit * limit))) / (1 + value), 1)) * 255);
184
+ }
185
+ data[o + 3] = 255;
186
+ }
187
+ faces.push({ width: edge, height: edge, data });
188
+ }
189
+ return new CubeTexture3D(faces, { colorSpace: 'srgb', mipmaps: true, name: 'equirect' });
190
+ }
191
+ //# sourceMappingURL=Hdr3D.js.map
@@ -0,0 +1,77 @@
1
+ import { type CustomShader3D } from './Material3D.js';
2
+ import { Mesh3D } from './Mesh3D.js';
3
+ import type { Object3D } from './Object3D.js';
4
+ import type { RigidBody3D } from './Physics3D.js';
5
+ /** How a jelly wobbles: its stiffness and damping, how far it squashes, how it reacts, and how it idles. */
6
+ export interface JellyOptions3D {
7
+ /** How many times per second the shape swings back and forth after a knock. Defaults to 3.5. */
8
+ readonly stiffness?: number;
9
+ /** 0 swings forever, 1 settles without overshoot. Defaults to 0.22. */
10
+ readonly damping?: number;
11
+ /** Most the shape may flatten or lengthen, as a share of its size. Defaults to 0.4. */
12
+ readonly squash?: number;
13
+ /** How strongly a change of speed deforms the shape: flattening per metre per second. Defaults to 0.05. */
14
+ readonly sensitivity?: number;
15
+ /** How far the top trails behind a sudden move, in seconds of the speed change. Defaults to 0.035; 0 turns it off. */
16
+ readonly wobble?: number;
17
+ /** Height of the object in world units, measured along `up` from its base. Defaults to twice the bounding radius. */
18
+ readonly height?: number;
19
+ /** Offset from the target's origin to the point the shape is squashed about, as a share of the height below the origin. Defaults to 0.5: the base. */
20
+ readonly base?: number;
21
+ /** Direction that counts as up. Defaults to +Y. */
22
+ readonly up?: readonly [number, number, number];
23
+ /** A slow breathing motion while idle: its size as a share of the height. Defaults to 0. */
24
+ readonly idle?: number;
25
+ /** Breaths per second of the idle motion. Defaults to 0.8. */
26
+ readonly idleRate?: number;
27
+ /** Body whose speed drives the jelly. Without one, the speed is taken from how the target moves. */
28
+ readonly body?: RigidBody3D;
29
+ }
30
+ /** The vertex hook a jelly drives. Its parameters start as "no change". */
31
+ export declare function createJellyShader3D(): CustomShader3D;
32
+ /**
33
+ * Makes everything drawn under `target` behave like jelly. Each mesh gets its
34
+ * own copy of its material carrying the jelly's vertex hook, so other objects
35
+ * that shared the material are not affected; a material that already has a
36
+ * shader hook is left as it is. Call update() once per frame.
37
+ */
38
+ export declare class Jelly3D {
39
+ #private;
40
+ readonly target: Object3D;
41
+ readonly shader: CustomShader3D;
42
+ stiffness: number;
43
+ damping: number;
44
+ squash: number;
45
+ sensitivity: number;
46
+ wobble: number;
47
+ height: number;
48
+ base: number;
49
+ idle: number;
50
+ idleRate: number;
51
+ body: RigidBody3D | undefined;
52
+ /** Meshes whose material now carries the hook. */
53
+ readonly meshes: Mesh3D[];
54
+ constructor(target: Object3D, options?: JellyOptions3D);
55
+ /** How flat the shape is along its squash line right now: positive when pressed, negative when stretched. */
56
+ get amount(): number;
57
+ /** The line the shape is squashed along, as a unit direction. */
58
+ get axis(): ArrayLike<number>;
59
+ /** How far the top currently trails, in world units. */
60
+ get lag(): ArrayLike<number>;
61
+ /**
62
+ * Knock the jelly: `direction` is the way the blow travels, `strength` the
63
+ * change of speed it stands for in metres per second.
64
+ */
65
+ impact(direction: ArrayLike<number>, strength: number): void;
66
+ private kick;
67
+ /** Advance the springs and hand the new shape to the shader. */
68
+ update(deltaSeconds: number): void;
69
+ /** Bring the shape back to rest at once. */
70
+ reset(): void;
71
+ private write;
72
+ /** Where the shader puts a world-space point, for tests and for attaching things to the surface. */
73
+ deform(out: Float32Array | Float64Array | number[], x: number, y: number, z: number): typeof out;
74
+ }
75
+ /** Makes an object squash, stretch and wobble like jelly as it moves. */
76
+ export declare function createJelly3D(target: Object3D, options?: JellyOptions3D): Jelly3D;
77
+ //# sourceMappingURL=Jelly3D.d.ts.map
@@ -0,0 +1,267 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // A soft, springy look for rigid things. The body that collides stays rigid;
3
+ // what is drawn squashes along the direction of each knock, stretches back,
4
+ // and lets its top trail behind sudden moves before settling. The motion is a
5
+ // pair of damped springs on the CPU and a vertex hook that reshapes the mesh,
6
+ // so a jelly costs a few numbers per object and no extra simulation.
7
+ // DOM-free and backend-independent.
8
+ import { World3DError, requireFinite3D, requirePositive3D } from './core3D.js';
9
+ import { createCustomShader3D } from './Material3D.js';
10
+ import { Mesh3D } from './Mesh3D.js';
11
+ const GLSL_VERTEX = `
12
+ vec3 customVertex(vec3 worldPosition, vec3 localPosition, vec3 normal, vec2 uv, vec4 color) {
13
+ vec3 d = worldPosition - uCustom[2].xyz;
14
+ float along = dot(d, uCustom[0].xyz);
15
+ vec3 across = d - uCustom[0].xyz * along;
16
+ float rise = clamp(dot(d, uCustom[3].xyz) * uCustom[1].w, 0.0, 1.0);
17
+ return uCustom[2].xyz + across * uCustom[2].w + uCustom[0].xyz * (along * uCustom[0].w) + uCustom[1].xyz * (rise * rise);
18
+ }`;
19
+ const WGSL_VERTEX = `
20
+ fn customVertex(worldPosition: vec3f, localPosition: vec3f, normal: vec3f, uv: vec2f, color: vec4f) -> vec3f {
21
+ let d = worldPosition - material.custom[2].xyz;
22
+ let along = dot(d, material.custom[0].xyz);
23
+ let across = d - material.custom[0].xyz * along;
24
+ let rise = clamp(dot(d, material.custom[3].xyz) * material.custom[1].w, 0.0, 1.0);
25
+ return material.custom[2].xyz + across * material.custom[2].w + material.custom[0].xyz * (along * material.custom[0].w) + material.custom[1].xyz * (rise * rise);
26
+ }`;
27
+ /** The vertex hook a jelly drives. Its parameters start as "no change". */
28
+ export function createJellyShader3D() {
29
+ return createCustomShader3D({
30
+ key: 'world3d-jelly',
31
+ glslVertex: GLSL_VERTEX,
32
+ wgslVertex: WGSL_VERTEX,
33
+ uniforms: [0, 1, 0, 1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 1, 0, 0]
34
+ });
35
+ }
36
+ /**
37
+ * Makes everything drawn under `target` behave like jelly. Each mesh gets its
38
+ * own copy of its material carrying the jelly's vertex hook, so other objects
39
+ * that shared the material are not affected; a material that already has a
40
+ * shader hook is left as it is. Call update() once per frame.
41
+ */
42
+ export class Jelly3D {
43
+ target;
44
+ shader;
45
+ stiffness;
46
+ damping;
47
+ squash;
48
+ sensitivity;
49
+ wobble;
50
+ height;
51
+ base;
52
+ idle;
53
+ idleRate;
54
+ body;
55
+ /** Meshes whose material now carries the hook. */
56
+ meshes = [];
57
+ #up = new Float64Array([0, 1, 0]);
58
+ // The squash is a vector: its direction is the line of the knock, its length how flat the shape is along it.
59
+ #strain = new Float64Array(3);
60
+ #strainSpeed = new Float64Array(3);
61
+ #axis = new Float64Array([0, 1, 0]);
62
+ #lag = new Float64Array(3);
63
+ #lagSpeed = new Float64Array(3);
64
+ #velocity = new Float64Array(3);
65
+ #place = new Float64Array(3);
66
+ #seen = false;
67
+ #clock = 0;
68
+ constructor(target, options = {}) {
69
+ if (!target || typeof target.traverse !== 'function')
70
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'jelly target');
71
+ this.target = target;
72
+ this.stiffness = requirePositive3D(options.stiffness ?? 3.5, 'stiffness');
73
+ this.damping = requireFinite3D(options.damping ?? 0.22, 'damping');
74
+ this.squash = requireFinite3D(options.squash ?? 0.4, 'squash');
75
+ this.sensitivity = requireFinite3D(options.sensitivity ?? 0.05, 'sensitivity');
76
+ this.wobble = requireFinite3D(options.wobble ?? 0.035, 'wobble');
77
+ this.base = requireFinite3D(options.base ?? 0.5, 'base');
78
+ this.idle = requireFinite3D(options.idle ?? 0, 'idle');
79
+ this.idleRate = requireFinite3D(options.idleRate ?? 0.8, 'idleRate');
80
+ if (this.damping < 0 || this.squash < 0 || this.squash > 0.9 || this.wobble < 0 || this.idle < 0)
81
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'jelly options');
82
+ this.body = options.body;
83
+ if (options.up) {
84
+ const size = Math.hypot(options.up[0], options.up[1], options.up[2]);
85
+ if (!(size > 0))
86
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'up');
87
+ this.#up[0] = options.up[0] / size;
88
+ this.#up[1] = options.up[1] / size;
89
+ this.#up[2] = options.up[2] / size;
90
+ }
91
+ this.shader = createJellyShader3D();
92
+ let radius = 0;
93
+ target.updateWorldMatrix();
94
+ const origin = target.matrixWorld;
95
+ target.traverse(object => {
96
+ if (!(object instanceof Mesh3D))
97
+ return;
98
+ const own = (material) => {
99
+ if (Array.isArray(material))
100
+ return material.map(one => own(one));
101
+ if (material.shader)
102
+ return material;
103
+ const copy = material.clone();
104
+ copy.shader = this.shader;
105
+ copy.touch();
106
+ return copy;
107
+ };
108
+ object.material = own(object.material);
109
+ this.meshes.push(object);
110
+ object.updateWorldMatrix();
111
+ const sphere = object.worldBoundingSphere;
112
+ if (sphere[3] >= 0)
113
+ radius = Math.max(radius, Math.hypot(sphere[0] - origin[12], sphere[1] - origin[13], sphere[2] - origin[14]) + sphere[3]);
114
+ });
115
+ this.height = requirePositive3D(options.height ?? (radius > 0 ? radius * 2 : 1), 'height');
116
+ this.write();
117
+ }
118
+ /** How flat the shape is along its squash line right now: positive when pressed, negative when stretched. */
119
+ get amount() {
120
+ return this.#strain[0] * this.#axis[0] + this.#strain[1] * this.#axis[1] + this.#strain[2] * this.#axis[2];
121
+ }
122
+ /** The line the shape is squashed along, as a unit direction. */
123
+ get axis() {
124
+ return this.#axis;
125
+ }
126
+ /** How far the top currently trails, in world units. */
127
+ get lag() {
128
+ return this.#lag;
129
+ }
130
+ /**
131
+ * Knock the jelly: `direction` is the way the blow travels, `strength` the
132
+ * change of speed it stands for in metres per second.
133
+ */
134
+ impact(direction, strength) {
135
+ const size = Math.hypot(direction[0], direction[1], direction[2]), speed = requireFinite3D(strength, 'strength');
136
+ if (!(size > 0))
137
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'direction');
138
+ this.kick((direction[0] / size) * speed, (direction[1] / size) * speed, (direction[2] / size) * speed);
139
+ }
140
+ kick(dx, dy, dz) {
141
+ const omega = 2 * Math.PI * this.stiffness, press = this.sensitivity * omega, s = this.#strainSpeed, l = this.#lagSpeed;
142
+ s[0] += dx * press;
143
+ s[1] += dy * press;
144
+ s[2] += dz * press;
145
+ // The top is left behind by the change of speed, then catches up.
146
+ const trail = this.wobble * omega;
147
+ l[0] -= dx * trail;
148
+ l[1] -= dy * trail;
149
+ l[2] -= dz * trail;
150
+ }
151
+ /** Advance the springs and hand the new shape to the shader. */
152
+ update(deltaSeconds) {
153
+ const dt = Math.min(Math.max(requireFinite3D(deltaSeconds, 'deltaSeconds'), 0), 0.1), body = this.body, target = this.target, place = this.#place, velocity = this.#velocity;
154
+ target.updateWorldMatrix();
155
+ const world = target.matrixWorld, x = world[12], y = world[13], z = world[14];
156
+ if (dt > 0) {
157
+ let vx, vy, vz;
158
+ if (body) {
159
+ vx = body.linearVelocity[0];
160
+ vy = body.linearVelocity[1];
161
+ vz = body.linearVelocity[2];
162
+ }
163
+ else if (this.#seen) {
164
+ vx = (x - place[0]) / dt;
165
+ vy = (y - place[1]) / dt;
166
+ vz = (z - place[2]) / dt;
167
+ }
168
+ else {
169
+ vx = vy = vz = 0;
170
+ }
171
+ if (this.#seen) {
172
+ const dx = vx - velocity[0], dy = vy - velocity[1], dz = vz - velocity[2];
173
+ // Free fall and steady motion change speed gently; only a real jolt is felt.
174
+ if (dx * dx + dy * dy + dz * dz > 0.25)
175
+ this.kick(dx, dy, dz);
176
+ }
177
+ velocity[0] = vx;
178
+ velocity[1] = vy;
179
+ velocity[2] = vz;
180
+ this.#seen = true;
181
+ // Small fixed slices keep the springs stable whatever the frame time.
182
+ const omega = 2 * Math.PI * this.stiffness, steps = Math.max(1, Math.ceil((dt * omega) / 0.35)), h = dt / steps, drag = 2 * this.damping * omega;
183
+ for (let step = 0; step < steps; step++) {
184
+ for (const [value, speed] of [
185
+ [this.#strain, this.#strainSpeed],
186
+ [this.#lag, this.#lagSpeed]
187
+ ]) {
188
+ for (let i = 0; i < 3; i++) {
189
+ speed[i] = (speed[i] - omega * omega * value[i] * h) / (1 + drag * h);
190
+ value[i] = value[i] + speed[i] * h;
191
+ }
192
+ }
193
+ }
194
+ this.#clock += dt;
195
+ }
196
+ place[0] = x;
197
+ place[1] = y;
198
+ place[2] = z;
199
+ this.write();
200
+ }
201
+ /** Bring the shape back to rest at once. */
202
+ reset() {
203
+ this.#strain.fill(0);
204
+ this.#strainSpeed.fill(0);
205
+ this.#lag.fill(0);
206
+ this.#lagSpeed.fill(0);
207
+ this.#seen = false;
208
+ this.write();
209
+ }
210
+ write() {
211
+ const u = this.shader.uniforms, strain = this.#strain, axis = this.#axis, up = this.#up, lag = this.#lag, most = this.squash;
212
+ const size = Math.hypot(strain[0], strain[1], strain[2]);
213
+ if (size > 1e-6) {
214
+ // Keep the line's direction from flipping as the shape swings through rest, so pressing turns into stretching.
215
+ const facing = strain[0] * axis[0] + strain[1] * axis[1] + strain[2] * axis[2] < 0 ? -1 : 1;
216
+ axis[0] = (strain[0] / size) * facing;
217
+ axis[1] = (strain[1] / size) * facing;
218
+ axis[2] = (strain[2] / size) * facing;
219
+ }
220
+ let amount = this.amount;
221
+ amount = amount > most ? most : amount < -most ? -most : amount;
222
+ let along = 1 - amount;
223
+ const world = this.target.matrixWorld, drop = this.height * this.base;
224
+ // Breathing presses and releases along up, on top of whatever the springs are doing.
225
+ const breath = this.idle > 0
226
+ ? this.idle *
227
+ Math.sin(this.#clock * this.idleRate * 2 * Math.PI) *
228
+ Math.abs(axis[0] * up[0] + axis[1] * up[1] + axis[2] * up[2])
229
+ : 0;
230
+ along -= breath;
231
+ // Whatever is lost along the line is gained across it, so the volume stays about the same.
232
+ const across = 1 / Math.sqrt(along);
233
+ const reach = this.height * 0.5, far = Math.hypot(lag[0], lag[1], lag[2]), fit = far > reach ? reach / far : 1;
234
+ u[0] = axis[0];
235
+ u[1] = axis[1];
236
+ u[2] = axis[2];
237
+ u[3] = along;
238
+ u[4] = lag[0] * fit;
239
+ u[5] = lag[1] * fit;
240
+ u[6] = lag[2] * fit;
241
+ u[7] = 1 / this.height;
242
+ u[8] = world[12] - up[0] * drop;
243
+ u[9] = world[13] - up[1] * drop;
244
+ u[10] = world[14] - up[2] * drop;
245
+ u[11] = across;
246
+ u[12] = up[0];
247
+ u[13] = up[1];
248
+ u[14] = up[2];
249
+ u[15] = 0;
250
+ }
251
+ /** Where the shader puts a world-space point, for tests and for attaching things to the surface. */
252
+ deform(out, x, y, z) {
253
+ const u = this.shader.uniforms, dx = x - u[8], dy = y - u[9], dz = z - u[10], along = dx * u[0] + dy * u[1] + dz * u[2];
254
+ let rise = (dx * u[12] + dy * u[13] + dz * u[14]) * u[7];
255
+ rise = rise < 0 ? 0 : rise > 1 ? 1 : rise;
256
+ const lift = rise * rise, keep = u[11], stretch = along * u[3];
257
+ out[0] = u[8] + (dx - u[0] * along) * keep + u[0] * stretch + u[4] * lift;
258
+ out[1] = u[9] + (dy - u[1] * along) * keep + u[1] * stretch + u[5] * lift;
259
+ out[2] = u[10] + (dz - u[2] * along) * keep + u[2] * stretch + u[6] * lift;
260
+ return out;
261
+ }
262
+ }
263
+ /** Makes an object squash, stretch and wobble like jelly as it moves. */
264
+ export function createJelly3D(target, options = {}) {
265
+ return new Jelly3D(target, options);
266
+ }
267
+ //# sourceMappingURL=Jelly3D.js.map
@@ -0,0 +1,30 @@
1
+ import type { CompressedPixels3D, TextureColorSpace3D, TexturePixels3D } from './Texture3D.js';
2
+ /** What a KTX2 file holds: its format, size, levels and supercompression. */
3
+ export interface Ktx2Info3D {
4
+ /** Vulkan format number; 0 marks a Basis Universal payload. */
5
+ readonly vkFormat: number;
6
+ readonly width: number;
7
+ readonly height: number;
8
+ readonly levelCount: number;
9
+ /** 0 none, 1 BasisLZ, 2 Zstandard, 3 zlib. */
10
+ readonly supercompression: number;
11
+ /** Stored level byte ranges, largest level first. */
12
+ readonly levels: readonly Uint8Array[];
13
+ /** The complete file, for transcoders that parse the container themselves. */
14
+ readonly file: Uint8Array;
15
+ }
16
+ /** A transcoded KTX2 texture: its pixels and color space. */
17
+ export interface Ktx2Result3D {
18
+ readonly source: TexturePixels3D | CompressedPixels3D;
19
+ readonly colorSpace: TextureColorSpace3D;
20
+ }
21
+ /** How a KTX2 file is transcoded for the GPU in use. */
22
+ export interface Ktx2Options3D {
23
+ /** Convert supercompressed or unknown-format payloads, overriding built-in decompression when provided. */
24
+ readonly transcode?: (info: Ktx2Info3D) => Promise<Ktx2Result3D> | Ktx2Result3D;
25
+ }
26
+ /** True when `bytes` starts with the KTX 2.0 file identifier. */
27
+ export declare function isKtx23D(bytes: Uint8Array): boolean;
28
+ /** Read a KTX 2.0 file holding one 2D texture and its mip chain. */
29
+ export declare function parseKtx23D(bytes: Uint8Array, options?: Ktx2Options3D): Promise<Ktx2Result3D>;
30
+ //# sourceMappingURL=Ktx23D.d.ts.map
@@ -0,0 +1,112 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // KTX 2.0 container reader for 2D textures. Block-compressed and RGBA8
3
+ // payloads are read directly, including levels wrapped in Zstandard or zlib
4
+ // supercompression. Basis Universal payloads need a transcoder, which the
5
+ // caller injects so this module stays dependency-free and DOM-free.
6
+ import { decompressZstd3D, inflate3D } from './Compression3D.js';
7
+ import { World3DError } from './core3D.js';
8
+ import { COMPRESSED_BLOCK_BYTES_3D } from './Texture3D.js';
9
+ const IDENTIFIER = [0xab, 0x4b, 0x54, 0x58, 0x20, 0x32, 0x30, 0xbb, 0x0d, 0x0a, 0x1a, 0x0a];
10
+ const FORMATS = Object.freeze({
11
+ 37: { format: 'rgba8', colorSpace: 'linear' },
12
+ 43: { format: 'rgba8', colorSpace: 'srgb' },
13
+ 133: { format: 'bc1', colorSpace: 'linear' },
14
+ 134: { format: 'bc1', colorSpace: 'srgb' },
15
+ 137: { format: 'bc3', colorSpace: 'linear' },
16
+ 138: { format: 'bc3', colorSpace: 'srgb' },
17
+ 145: { format: 'bc7', colorSpace: 'linear' },
18
+ 146: { format: 'bc7', colorSpace: 'srgb' },
19
+ 147: { format: 'etc2-rgb8', colorSpace: 'linear' },
20
+ 148: { format: 'etc2-rgb8', colorSpace: 'srgb' },
21
+ 151: { format: 'etc2-rgba8', colorSpace: 'linear' },
22
+ 152: { format: 'etc2-rgba8', colorSpace: 'srgb' },
23
+ 157: { format: 'astc-4x4', colorSpace: 'linear' },
24
+ 158: { format: 'astc-4x4', colorSpace: 'srgb' }
25
+ });
26
+ const KTX2_LIMITS = Object.freeze({ maxEdge: 8192, maxLevels: 14 });
27
+ /** True when `bytes` starts with the KTX 2.0 file identifier. */
28
+ export function isKtx23D(bytes) {
29
+ if (!(bytes instanceof Uint8Array) || bytes.byteLength < 12)
30
+ return false;
31
+ for (let i = 0; i < 12; i++)
32
+ if (bytes[i] !== IDENTIFIER[i])
33
+ return false;
34
+ return true;
35
+ }
36
+ function fail(detail) {
37
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'ktx2: ' + detail);
38
+ }
39
+ /** Read a KTX 2.0 file holding one 2D texture and its mip chain. */
40
+ export async function parseKtx23D(bytes, options = {}) {
41
+ if (!isKtx23D(bytes))
42
+ fail('identifier');
43
+ if (bytes.byteLength < 80)
44
+ fail('header');
45
+ const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
46
+ const vkFormat = view.getUint32(12, true), width = view.getUint32(20, true), height = view.getUint32(24, true);
47
+ const depth = view.getUint32(28, true), layers = view.getUint32(32, true), faces = view.getUint32(36, true);
48
+ const levelCount = Math.max(1, view.getUint32(40, true)), supercompression = view.getUint32(44, true);
49
+ if (width === 0 || height === 0 || width > KTX2_LIMITS.maxEdge || height > KTX2_LIMITS.maxEdge)
50
+ fail('size');
51
+ if (depth !== 0 || layers !== 0 || faces !== 1)
52
+ throw new World3DError('WORLD3D_GLTF_UNSUPPORTED', 'ktx2: only single 2D textures are supported');
53
+ if (levelCount > KTX2_LIMITS.maxLevels || 80 + levelCount * 24 > bytes.byteLength)
54
+ fail('level index');
55
+ const levels = [], unpackedSizes = [];
56
+ for (let level = 0; level < levelCount; level++) {
57
+ const base = 80 + level * 24;
58
+ // Offsets are 64-bit; files this reader accepts fit comfortably in the low 53 bits.
59
+ const offset = Number(view.getBigUint64(base, true)), length = Number(view.getBigUint64(base + 8, true));
60
+ if (!Number.isSafeInteger(offset) || !Number.isSafeInteger(length) || length > bytes.byteLength - offset)
61
+ fail('level range');
62
+ levels.push(bytes.subarray(offset, offset + length));
63
+ unpackedSizes.push(Number(view.getBigUint64(base + 16, true)));
64
+ }
65
+ const known = FORMATS[vkFormat];
66
+ if (supercompression !== 0 || !known) {
67
+ if (options.transcode)
68
+ return await options.transcode({ vkFormat, width, height, levelCount, supercompression, levels, file: bytes });
69
+ if (!known || (supercompression !== 2 && supercompression !== 3)) {
70
+ throw new World3DError('WORLD3D_GLTF_UNSUPPORTED', 'ktx2: this payload needs a transcoder (vkFormat ' + vkFormat + ', supercompression ' + supercompression + ')');
71
+ }
72
+ // Validate the whole chain before a decoder can allocate from a declared size.
73
+ if (levelCount > 1 + Math.floor(Math.log2(Math.max(width, height))))
74
+ fail('level count exceeds mip chain');
75
+ for (let level = 0; level < levelCount; level++) {
76
+ const w = Math.max(1, width >> level);
77
+ const h = Math.max(1, height >> level);
78
+ const expected = known.format === 'rgba8'
79
+ ? w * h * 4
80
+ : Math.ceil(w / 4) * Math.ceil(h / 4) * COMPRESSED_BLOCK_BYTES_3D[known.format];
81
+ if (unpackedSizes[level] !== expected)
82
+ fail('level size');
83
+ }
84
+ const decompress = supercompression === 2 ? decompressZstd3D : inflate3D;
85
+ for (let level = 0; level < levelCount; level++) {
86
+ const size = unpackedSizes[level];
87
+ const unpacked = decompress(levels[level], { sizeHint: size, maxBytes: size });
88
+ if (unpacked.byteLength !== size)
89
+ fail('level does not unpack to its stated size');
90
+ levels[level] = unpacked;
91
+ }
92
+ }
93
+ if (known.format === 'rgba8') {
94
+ const first = levels[0];
95
+ if (first.byteLength !== width * height * 4)
96
+ fail('rgba8 level size');
97
+ return { source: { width, height, data: first.slice() }, colorSpace: known.colorSpace };
98
+ }
99
+ const block = COMPRESSED_BLOCK_BYTES_3D[known.format];
100
+ let w = width, h = height;
101
+ for (const level of levels) {
102
+ if (level.byteLength !== Math.ceil(w / 4) * Math.ceil(h / 4) * block)
103
+ fail('compressed level size');
104
+ w = Math.max(1, w >> 1);
105
+ h = Math.max(1, h >> 1);
106
+ }
107
+ return {
108
+ source: { width, height, format: known.format, levels: levels.map(level => level.slice()) },
109
+ colorSpace: known.colorSpace
110
+ };
111
+ }
112
+ //# sourceMappingURL=Ktx23D.js.map