@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,185 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // Plays one rig's animation on another: motion capture or a bought clip on a
3
+ // game's own skeleton, or one character's walk on another of other size. Both
4
+ // rigs are given in their rest pose. For each target bone the clip's turn of
5
+ // the matching source bone away from its rest, taken in world space, is laid
6
+ // onto the target bone's own rest, so rigs whose bones point along different
7
+ // axes still move alike. The root bone also moves, its travel scaled by the
8
+ // two rigs' heights. The result is an ordinary clip for the target rig.
9
+ import { World3DError } from './core3D.js';
10
+ import { AnimationClip3D, sampleAnimationTrack3D } from './Animation3D.js';
11
+ import { quatMultiply, quatNormalize } from './math3D.js';
12
+ const inverse = (q) => [-q[0], -q[1], -q[2], q[3]];
13
+ const mul = (a, b) => quatMultiply([0, 0, 0, 1], a, b);
14
+ /** Every named node under `root`, with its parent among them and its rest. */
15
+ function bonesOf(root) {
16
+ const out = new Map();
17
+ const walk = (node, parent) => {
18
+ let bone = parent;
19
+ if (node.name) {
20
+ bone = {
21
+ node,
22
+ parent,
23
+ restLocal: [...node.quaternion],
24
+ restPosition: [...node.position]
25
+ };
26
+ if (!out.has(node.name))
27
+ out.set(node.name, bone);
28
+ }
29
+ for (const child of node.children)
30
+ walk(child, bone);
31
+ };
32
+ walk(root, undefined);
33
+ return out;
34
+ }
35
+ /** The rest rotation of a bone in the rig's space: its parents' rest turns, outermost first. */
36
+ function restWorld(bone) {
37
+ let q = [0, 0, 0, 1];
38
+ const chain = [];
39
+ for (let b = bone; b; b = b.parent)
40
+ chain.unshift(b);
41
+ for (const b of chain)
42
+ q = mul(q, b.restLocal);
43
+ return q;
44
+ }
45
+ /** Height of a bone above the rig origin at rest, from rest positions alone. */
46
+ function restHeight(bone) {
47
+ let y = 0;
48
+ const chain = [];
49
+ for (let b = bone; b; b = b.parent)
50
+ chain.unshift(b);
51
+ let q = [0, 0, 0, 1];
52
+ for (const b of chain) {
53
+ // Rotate the bone's offset by its parent's rest turn before adding it.
54
+ const [x, py, z] = b.restPosition;
55
+ const v = mul(mul(q, [x, py, z, 0]), inverse(q));
56
+ y += v[1];
57
+ q = mul(q, b.restLocal);
58
+ }
59
+ return y;
60
+ }
61
+ /** A clip for the target rig that moves it as `clip` moves the source rig. */
62
+ export function retargetAnimationClip3D(clip, options) {
63
+ if (!(clip instanceof AnimationClip3D))
64
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'clip');
65
+ if (!options?.source || !options.target)
66
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'rigs');
67
+ const fps = options.fps ?? 30;
68
+ if (!(fps > 0 && fps <= 240))
69
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'fps');
70
+ const source = bonesOf(options.source), target = bonesOf(options.target);
71
+ const pairs = options.bones
72
+ ? Object.entries(options.bones)
73
+ : [...target.keys()].filter(name => source.has(name)).map(name => [name, name]);
74
+ for (const [t, s] of pairs)
75
+ if (!target.has(t) || !source.has(s))
76
+ throw new World3DError('WORLD3D_INPUT_INVALID', `bone ${t} or ${s}`);
77
+ if (pairs.length === 0)
78
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'no shared bones');
79
+ const sourceOf = new Map(pairs);
80
+ // Source tracks by bone: rotation and position, sampled into the bone's local transform.
81
+ const rotations = new Map(), positions = new Map();
82
+ for (const track of clip.tracks) {
83
+ if (track.path === 'quaternion')
84
+ rotations.set(track.targetName, track);
85
+ else if (track.path === 'position')
86
+ positions.set(track.targetName, track);
87
+ }
88
+ const frames = Math.max(2, Math.round(clip.duration * fps) + 1);
89
+ const times = Float32Array.from({ length: frames }, (_, i) => (i / (frames - 1)) * clip.duration);
90
+ const hints = new Map();
91
+ const sample = (name, track, time, rest, size) => {
92
+ if (!track)
93
+ return Array.from(rest);
94
+ const out = new Float32Array(size);
95
+ let hint = hints.get(name + track.path);
96
+ if (!hint)
97
+ hints.set(name + track.path, (hint = { index: 0 }));
98
+ sampleAnimationTrack3D(track, time, out, hint);
99
+ return Array.from(out);
100
+ };
101
+ // A source bone's world turn at a time: its chain's animated local turns.
102
+ const sourceWorld = (bone, time, cache) => {
103
+ if (!bone)
104
+ return [0, 0, 0, 1];
105
+ const known = cache.get(bone);
106
+ if (known)
107
+ return known;
108
+ const local = sample(bone.node.name, rotations.get(bone.node.name), time, bone.restLocal, 4);
109
+ const world = quatNormalize([0, 0, 0, 1], mul(sourceWorld(bone.parent, time, cache), local));
110
+ cache.set(bone, world);
111
+ return world;
112
+ };
113
+ const restSource = new Map(), restTarget = new Map();
114
+ for (const [t, s] of pairs) {
115
+ restSource.set(s, restWorld(source.get(s)));
116
+ restTarget.set(t, restWorld(target.get(t)));
117
+ }
118
+ // Target bones are solved parent first, so each local turn is taken against its parent's animated turn.
119
+ const order = [...target.values()].filter(bone => sourceOf.has(bone.node.name));
120
+ const depth = (bone) => (bone.parent ? depth(bone.parent) + 1 : 0);
121
+ order.sort((a, b) => depth(a) - depth(b));
122
+ const values = new Map(order.map(bone => [bone.node.name, []]));
123
+ const rootName = options.root;
124
+ if (rootName !== undefined && !sourceOf.has(rootName))
125
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'root');
126
+ const rootPositions = [];
127
+ let scale = options.scale;
128
+ if (rootName !== undefined && scale === undefined) {
129
+ const sh = restHeight(source.get(sourceOf.get(rootName))), th = restHeight(target.get(rootName));
130
+ scale = Math.abs(sh) > 1e-6 ? th / sh : 1;
131
+ }
132
+ if (scale !== undefined && !Number.isFinite(scale))
133
+ throw new World3DError('WORLD3D_INPUT_INVALID', 'scale');
134
+ for (const time of times) {
135
+ const sourceCache = new Map();
136
+ const targetWorld = new Map();
137
+ const worldOfTarget = (bone) => {
138
+ if (!bone)
139
+ return [0, 0, 0, 1];
140
+ const solved = targetWorld.get(bone);
141
+ if (solved)
142
+ return solved;
143
+ // A bone with no source keeps its rest turn under its parent.
144
+ const world = mul(worldOfTarget(bone.parent), bone.restLocal);
145
+ targetWorld.set(bone, world);
146
+ return world;
147
+ };
148
+ for (const bone of order) {
149
+ const name = bone.node.name, s = source.get(sourceOf.get(name));
150
+ // The source bone's turn away from rest, in rig space, laid on the target bone's rest.
151
+ const offset = mul(sourceWorld(s, time, sourceCache), inverse(restSource.get(s.node.name)));
152
+ const world = mul(offset, restTarget.get(name));
153
+ targetWorld.set(bone, world);
154
+ const local = quatNormalize([0, 0, 0, 1], mul(inverse(worldOfTarget(bone.parent)), world));
155
+ // Keep neighbouring keys on the same side of the sphere so interpolation takes the short way.
156
+ const list = values.get(name);
157
+ if (list.length >= 4) {
158
+ const dot = list[list.length - 4] * local[0] +
159
+ list[list.length - 3] * local[1] +
160
+ list[list.length - 2] * local[2] +
161
+ list[list.length - 1] * local[3];
162
+ if (dot < 0)
163
+ for (let i = 0; i < 4; i++)
164
+ local[i] = -local[i];
165
+ }
166
+ list.push(local[0], local[1], local[2], local[3]);
167
+ }
168
+ if (rootName !== undefined) {
169
+ const s = source.get(sourceOf.get(rootName)), t = target.get(rootName);
170
+ const p = sample(s.node.name, positions.get(s.node.name), time, s.restPosition, 3);
171
+ for (let i = 0; i < 3; i++)
172
+ rootPositions.push(t.restPosition[i] + (p[i] - s.restPosition[i]) * scale);
173
+ }
174
+ }
175
+ const tracks = order.map(bone => ({
176
+ targetName: bone.node.name,
177
+ path: 'quaternion',
178
+ times,
179
+ values: values.get(bone.node.name)
180
+ }));
181
+ if (rootName !== undefined)
182
+ tracks.push({ targetName: rootName, path: 'position', times, values: rootPositions });
183
+ return new AnimationClip3D(options.name ?? clip.name, tracks, clip.duration);
184
+ }
185
+ //# sourceMappingURL=Retarget3D.js.map
@@ -0,0 +1,57 @@
1
+ import { AnimationClip3D, AnimationMixer3D, type AnimationAction3D } from './Animation3D.js';
2
+ import { type Material3D } from './Material3D.js';
3
+ import { Bone3D, Mesh3D, Skeleton3D } from './Mesh3D.js';
4
+ import { Object3D } from './Object3D.js';
5
+ import { SdfShape3D, type SdfMeshOptions3D } from './Sdf3D.js';
6
+ type Vec3 = readonly [number, number, number];
7
+ /** A bone of a rig: where it turns, what it moves, and the bone it hangs from. */
8
+ export interface SdfBone3D {
9
+ /** Its name, by which clips move it. A pair made by `mirror` is named `name.L` (on +x) and `name.R`. */
10
+ readonly name: string;
11
+ /** The bone it hangs from, moving with it; the rig's root unless given. A pair hangs from the parent of its side. */
12
+ readonly parent?: string;
13
+ /** The joint, in the model's coordinates: where the bone turns, such as a shoulder or a hip. */
14
+ readonly at: Vec3;
15
+ /** The shapes this bone moves: the vertices nearest them follow it. A bone without parts only carries others. */
16
+ readonly parts?: SdfShape3D | readonly SdfShape3D[];
17
+ /** 'x' makes a pair from one side: `at` and `parts` on +x for `name.L`, mirrored across x for `name.R`. */
18
+ readonly mirror?: 'x';
19
+ }
20
+ /** How a rig is made: the options of its mesh, its material, and how wide a joint bends. */
21
+ export interface SdfRigOptions3D extends SdfMeshOptions3D {
22
+ /** The mesh's material; a standard one with vertex colours unless given. */
23
+ readonly material?: Material3D;
24
+ /**
25
+ * How far, in the model's units, the skin at a joint is shared between the bones on either side: a fiftieth of the
26
+ * model's size unless given. Larger bends more softly; smaller keeps parts stiff up to the joint.
27
+ */
28
+ readonly blend?: number;
29
+ }
30
+ /** A pose key: a time in seconds, the bone's turn as Euler angles in radians, and optionally how far it moves. */
31
+ export type SdfPoseKey3D = readonly [time: number, rotation: Vec3, offset?: Vec3];
32
+ /** A model that moves: its root to add to a scene, its skinned mesh, its bones by name, and its animation. */
33
+ export interface SdfRig3D {
34
+ /** Add this to the scene and move it to move the model. */
35
+ readonly root: Object3D;
36
+ readonly mesh: Mesh3D;
37
+ readonly bones: Readonly<Record<string, Bone3D>>;
38
+ readonly skeleton: Skeleton3D;
39
+ readonly mixer: AnimationMixer3D;
40
+ /**
41
+ * A clip from poses of named bones: `{ 'leg.L': [[0, [0.4, 0, 0]], [0.5, [-0.4, 0, 0]], [1, [0.4, 0, 0]]] }`. A
42
+ * rotation is from the bone's rest pose; an offset moves it from where it rests. A clip loops cleanly when its last
43
+ * key of each bone equals its first.
44
+ */
45
+ clip(name: string, duration: number, poses: Readonly<Record<string, readonly SdfPoseKey3D[]>>): AnimationClip3D;
46
+ /** Plays a clip, fading out what was playing over `fade` seconds (0.2 unless given). */
47
+ play(clip: AnimationClip3D, fade?: number): AnimationAction3D;
48
+ /** Moves the animation on; call once a frame. */
49
+ update(seconds: number): void;
50
+ }
51
+ /**
52
+ * A rig of `shape`: its mesh, made as `createSdfGeometry3D` makes it, skinned to bones at the joints of the model.
53
+ * Every vertex follows at most four bones, those whose parts are nearest it.
54
+ */
55
+ export declare function createSdfRig3D(shape: SdfShape3D, bones: readonly SdfBone3D[], options?: SdfRigOptions3D): SdfRig3D;
56
+ export {};
57
+ //# sourceMappingURL=Rig3D.d.ts.map
@@ -0,0 +1,219 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // Models made from distance fields that move: a skeleton of bones placed at the joints of the model, each bone naming
3
+ // the parts it moves, and a skinned mesh whose every vertex follows the bones whose parts are nearest. The parts are
4
+ // the shapes the model was built from, so the weights come from the model itself: a vertex on the thigh follows the
5
+ // leg, one on the belly the body, and one at the hip a share of each, so the skin bends at the joint rather than
6
+ // tearing. A clip of the rig is written as poses of named bones at given times.
7
+ import { AnimationClip3D, AnimationMixer3D } from './Animation3D.js';
8
+ import { World3DError } from './core3D.js';
9
+ import { Attribute3D } from './Geometry3D.js';
10
+ import { createStandardMaterial3D } from './Material3D.js';
11
+ import { quatFromEuler } from './math3D.js';
12
+ import { Bone3D, Mesh3D, Skeleton3D } from './Mesh3D.js';
13
+ import { Object3D } from './Object3D.js';
14
+ import { createSdfGeometry3D, SdfShape3D } from './Sdf3D.js';
15
+ function invalid(what) {
16
+ return new World3DError('WORLD3D_INPUT_INVALID', what);
17
+ }
18
+ function vec3(value, what) {
19
+ if (!Array.isArray(value) || value.length !== 3 || !value.every(Number.isFinite))
20
+ throw invalid(what);
21
+ return value;
22
+ }
23
+ /**
24
+ * A rig of `shape`: its mesh, made as `createSdfGeometry3D` makes it, skinned to bones at the joints of the model.
25
+ * Every vertex follows at most four bones, those whose parts are nearest it.
26
+ */
27
+ export function createSdfRig3D(shape, bones, options = {}) {
28
+ if (!(shape instanceof SdfShape3D))
29
+ throw invalid('rig shape');
30
+ if (!Array.isArray(bones) || bones.length === 0)
31
+ throw invalid('rig bones');
32
+ if (options === null || typeof options !== 'object')
33
+ throw invalid('rig options');
34
+ // Each bone as planned, pairs split into their two sides.
35
+ const mirrored = new Set();
36
+ for (const bone of bones)
37
+ if (bone && bone.mirror === 'x')
38
+ mirrored.add(bone.name);
39
+ const planned = [];
40
+ for (const bone of bones) {
41
+ if (!bone || typeof bone !== 'object' || typeof bone.name !== 'string' || bone.name.length === 0)
42
+ throw invalid('rig bone name');
43
+ if (bone.mirror !== undefined && bone.mirror !== 'x')
44
+ throw invalid('rig bone mirror');
45
+ if (bone.parent !== undefined && typeof bone.parent !== 'string')
46
+ throw invalid('rig bone parent');
47
+ const at = vec3(bone.at, 'rig bone at');
48
+ const list = bone.parts === undefined ? [] : bone.parts instanceof SdfShape3D ? [bone.parts] : bone.parts;
49
+ if (!Array.isArray(list) || !list.every(part => part instanceof SdfShape3D))
50
+ throw invalid('rig bone parts');
51
+ if (bone.mirror === 'x')
52
+ for (const [side, flip] of [
53
+ ['L', false],
54
+ ['R', true]
55
+ ]) {
56
+ const parent = bone.parent !== undefined && mirrored.has(bone.parent) ? bone.parent + '.' + side : bone.parent;
57
+ planned.push({
58
+ name: bone.name + '.' + side,
59
+ parent,
60
+ at: flip ? [-at[0], at[1], at[2]] : at,
61
+ parts: list,
62
+ flip
63
+ });
64
+ }
65
+ else
66
+ planned.push({ name: bone.name, parent: bone.parent, at, parts: list, flip: false });
67
+ }
68
+ const index = new Map();
69
+ planned.forEach((bone, i) => {
70
+ if (index.has(bone.name))
71
+ throw invalid('rig bone name twice: ' + bone.name);
72
+ index.set(bone.name, i);
73
+ });
74
+ for (const bone of planned)
75
+ if (bone.parent !== undefined && !index.has(bone.parent))
76
+ throw invalid('rig bone parent: ' + bone.parent);
77
+ if (!planned.some(bone => bone.parts.length > 0))
78
+ throw invalid('rig bones have no parts');
79
+ // A parent named after its child would make a loop.
80
+ for (const bone of planned) {
81
+ const seen = new Set();
82
+ for (let at = bone; at; at = at.parent ? planned[index.get(at.parent)] : undefined) {
83
+ if (seen.has(at.name))
84
+ throw invalid('rig bone loop: ' + bone.name);
85
+ seen.add(at.name);
86
+ }
87
+ }
88
+ const geometry = createSdfGeometry3D(shape, options);
89
+ const b = shape.bounds;
90
+ const size = Math.max(b[3] - b[0], b[4] - b[1], b[5] - b[2]);
91
+ const blend = options.blend === undefined
92
+ ? size / 50
93
+ : typeof options.blend === 'number' && options.blend > 0 && Number.isFinite(options.blend)
94
+ ? options.blend
95
+ : (() => {
96
+ throw invalid('rig blend');
97
+ })();
98
+ // Weights: each vertex follows the bones whose parts are nearest, falling off over `blend` from the nearest.
99
+ const position = geometry.getAttribute('position').data;
100
+ const count = position.length / 3;
101
+ const joints = new Uint16Array(count * 4), weights = new Float32Array(count * 4);
102
+ const skinned = planned.map((bone, i) => ({ i, bone })).filter(entry => entry.bone.parts.length > 0);
103
+ const distances = new Float64Array(skinned.length);
104
+ for (let v = 0; v < count; v++) {
105
+ const x = position[v * 3], y = position[v * 3 + 1], z = position[v * 3 + 2];
106
+ let nearest = Infinity;
107
+ for (let k = 0; k < skinned.length; k++) {
108
+ const { bone } = skinned[k];
109
+ const px = bone.flip ? -x : x;
110
+ let d = Infinity;
111
+ for (const part of bone.parts)
112
+ d = Math.min(d, part.distance(px, y, z));
113
+ distances[k] = d;
114
+ if (d < nearest)
115
+ nearest = d;
116
+ }
117
+ const best = [];
118
+ for (let k = 0; k < skinned.length; k++) {
119
+ const w = Math.exp(-(distances[k] - nearest) / blend);
120
+ if (w < 1e-3)
121
+ continue;
122
+ best.push([w, skinned[k].i]);
123
+ }
124
+ best.sort((p, q) => q[0] - p[0]);
125
+ const kept = best.slice(0, 4);
126
+ const total = kept.reduce((sum, [w]) => sum + w, 0);
127
+ kept.forEach(([w, bone], slot) => {
128
+ joints[v * 4 + slot] = bone;
129
+ weights[v * 4 + slot] = w / total;
130
+ });
131
+ }
132
+ geometry.setAttribute('joints', new Attribute3D(joints, 4));
133
+ geometry.setAttribute('weights', new Attribute3D(weights, 4));
134
+ // The skeleton in its rest pose: each bone at its joint, placed from its parent's.
135
+ const root = new Object3D();
136
+ root.name = 'rig';
137
+ const made = planned.map(bone => {
138
+ const node = new Bone3D();
139
+ node.name = bone.name;
140
+ return node;
141
+ });
142
+ planned.forEach((bone, i) => {
143
+ const parent = bone.parent === undefined ? undefined : planned[index.get(bone.parent)];
144
+ const base = parent?.at ?? [0, 0, 0];
145
+ made[i].setPosition(bone.at[0] - base[0], bone.at[1] - base[1], bone.at[2] - base[2]);
146
+ (parent === undefined ? root : made[index.get(bone.parent)]).addChild(made[i]);
147
+ });
148
+ root.updateWorldMatrices(true);
149
+ const skeleton = new Skeleton3D(made);
150
+ const mesh = new Mesh3D(geometry, options.material ?? createStandardMaterial3D({ vertexColors: true, roughness: 0.75 }));
151
+ mesh.name = 'skin';
152
+ root.addChild(mesh);
153
+ root.updateWorldMatrices(true);
154
+ mesh.bind(skeleton);
155
+ const byName = {};
156
+ planned.forEach((bone, i) => (byName[bone.name] = made[i]));
157
+ const rest = new Map(planned.map((bone, i) => [bone.name, Array.from(made[i].position)]));
158
+ const mixer = new AnimationMixer3D(root);
159
+ let playing;
160
+ return {
161
+ root,
162
+ mesh,
163
+ bones: Object.freeze(byName),
164
+ skeleton,
165
+ mixer,
166
+ clip(name, duration, poses) {
167
+ if (typeof name !== 'string')
168
+ throw invalid('rig clip name');
169
+ if (typeof duration !== 'number' || !(duration > 0))
170
+ throw invalid('rig clip duration');
171
+ if (poses === null || typeof poses !== 'object')
172
+ throw invalid('rig clip poses');
173
+ const tracks = [];
174
+ for (const [bone, keys] of Object.entries(poses)) {
175
+ if (!rest.has(bone))
176
+ throw invalid('rig clip bone: ' + bone);
177
+ if (!Array.isArray(keys) || keys.length === 0)
178
+ throw invalid('rig clip keys: ' + bone);
179
+ const times = [], turns = [], moves = [];
180
+ let moved = false;
181
+ const q = new Float32Array(4), base = rest.get(bone);
182
+ for (const key of keys) {
183
+ if (!Array.isArray(key) || typeof key[0] !== 'number')
184
+ throw invalid('rig clip key: ' + bone);
185
+ const r = vec3(key[1], 'rig clip rotation: ' + bone);
186
+ times.push(key[0]);
187
+ quatFromEuler(q, r[0], r[1], r[2]);
188
+ turns.push(q[0], q[1], q[2], q[3]);
189
+ const offset = key[2] === undefined ? [0, 0, 0] : vec3(key[2], 'rig clip offset: ' + bone);
190
+ if (key[2] !== undefined)
191
+ moved = true;
192
+ moves.push(base[0] + offset[0], base[1] + offset[1], base[2] + offset[2]);
193
+ }
194
+ tracks.push({ targetName: bone, path: 'quaternion', times, values: turns });
195
+ if (moved)
196
+ tracks.push({ targetName: bone, path: 'position', times, values: moves });
197
+ }
198
+ return new AnimationClip3D(name, tracks, duration);
199
+ },
200
+ play(clip, fade = 0.2) {
201
+ if (!(clip instanceof AnimationClip3D))
202
+ throw invalid('rig play clip');
203
+ const action = mixer.clipAction(clip);
204
+ if (action === playing)
205
+ return action;
206
+ if (playing !== undefined)
207
+ playing.fadeOut(fade);
208
+ action.reset().play();
209
+ if (playing !== undefined && fade > 0)
210
+ action.fadeIn(fade);
211
+ playing = action;
212
+ return action;
213
+ },
214
+ update(seconds) {
215
+ mixer.update(seconds);
216
+ }
217
+ };
218
+ }
219
+ //# sourceMappingURL=Rig3D.js.map
@@ -0,0 +1,181 @@
1
+ import { Geometry3D } from './Geometry3D.js';
2
+ import type { ColorInput3D } from './Material3D.js';
3
+ type Vec3 = readonly [number, number, number];
4
+ /** Where a shape goes and how it looks: moved by `at`, turned by `rotation`, scaled by `scale`, painted `color`. */
5
+ export interface SdfOptions3D {
6
+ /** Where the shape's centre goes; [0, 0, 0] by default. */
7
+ readonly at?: Vec3;
8
+ /** Euler angles in radians, in the order of `quatFromEuler`. */
9
+ readonly rotation?: Vec3;
10
+ /** One factor for all three axes. A field stays a distance only when scaled the same way on every axis. */
11
+ readonly scale?: number;
12
+ /** A hex colour as seen on screen, or linear RGB. A shape without one takes the colour of the group it is in. */
13
+ readonly color?: ColorInput3D;
14
+ }
15
+ /** A group of shapes: `smooth` is how far, in the model's units, the blend between them reaches. */
16
+ export interface SdfGroupOptions3D extends SdfOptions3D {
17
+ /** 0 joins shapes with a crease; 0.05 to 0.2 of a part's size reads as one soft body. */
18
+ readonly smooth?: number;
19
+ }
20
+ /** A shape as a signed distance field: negative inside, positive outside, zero on the surface. */
21
+ export declare abstract class SdfShape3D {
22
+ #private;
23
+ /** The box the shape lies in, as [minX, minY, minZ, maxX, maxY, maxZ]. */
24
+ readonly bounds: readonly [number, number, number, number, number, number];
25
+ /** @internal */
26
+ readonly paint: Float32Array | undefined;
27
+ /** @internal */
28
+ constructor(options: SdfOptions3D | undefined, local: readonly number[]);
29
+ /** How far the point is from the surface: negative inside. */
30
+ distance(x: number, y: number, z: number): number;
31
+ /** @internal The linear colour of the shape at a point, written to `out`; `inherited` when it has none. */
32
+ colorAt(x: number, y: number, z: number, out: Float32Array, inherited: Float32Array): void;
33
+ /** @internal */
34
+ protected abstract local(x: number, y: number, z: number): number;
35
+ /** @internal */
36
+ protected localColor(_x: number, _y: number, _z: number, out: Float32Array, paint: Float32Array): void;
37
+ }
38
+ /** A ball of `radius`. */
39
+ export declare function sdfSphere(radius: number, options?: SdfOptions3D): SdfShape3D;
40
+ /** A box of `size` [width, height, depth], its edges rounded by `round` (0 for sharp; more than half the smallest side is taken as that). */
41
+ export declare function sdfBox(size: Vec3, options?: SdfOptions3D & {
42
+ readonly round?: number;
43
+ }): SdfShape3D;
44
+ /** A stretched ball with `radii` [x, y, z]: heads, bodies, eggs and stones. */
45
+ export declare function sdfEllipsoid(radii: Vec3, options?: SdfOptions3D): SdfShape3D;
46
+ /**
47
+ * A rounded limb from `from` to `to`: `radius` thick at the start, `radiusEnd` (the same unless given) at the end.
48
+ * Arms, legs, necks, tails, branches and horns.
49
+ */
50
+ export declare function sdfCapsule(from: Vec3, to: Vec3, radius: number, options?: SdfOptions3D & {
51
+ readonly radiusEnd?: number;
52
+ }): SdfShape3D;
53
+ /** An upright cylinder of `radius` and `height` along y, its rims rounded by `round` (at most the radius or half the height). */
54
+ export declare function sdfCylinder(radius: number, height: number, options?: SdfOptions3D & {
55
+ readonly round?: number;
56
+ }): SdfShape3D;
57
+ /** An upright cone of `height` along y, `bottom` wide at its foot and `top` (0 for a point) at its head. */
58
+ export declare function sdfCone(bottom: number, top: number, height: number, options?: SdfOptions3D): SdfShape3D;
59
+ /** A ring lying flat: `radius` to the middle of the tube, `tube` the tube's radius. */
60
+ export declare function sdfTorus(radius: number, tube: number, options?: SdfOptions3D): SdfShape3D;
61
+ /**
62
+ * A shape turned about the y axis from its `profile`: points [radius, height] going round a closed outline, as a
63
+ * potter draws half a vase. Vases, bottles, pillars, bells, towers, lamp posts, chess pieces.
64
+ */
65
+ export declare function sdfLathe(profile: readonly (readonly [number, number])[], options?: SdfOptions3D & {
66
+ readonly round?: number;
67
+ }): SdfShape3D;
68
+ /**
69
+ * A flat `outline` of points [x, y] in the xy plane, closed, pushed `depth` deep along z about its middle, its
70
+ * edges rounded by `round`: signs, gables, blades, stars, letters, tiles, cut-out shapes.
71
+ */
72
+ export declare function sdfExtrude(outline: readonly (readonly [number, number])[], depth: number, options?: SdfOptions3D & {
73
+ readonly round?: number;
74
+ }): SdfShape3D;
75
+ /** The shapes joined into one; with `smooth`, blended where they meet. */
76
+ export declare function sdfUnion(items: SdfShape3D | readonly SdfShape3D[], options?: SdfGroupOptions3D): SdfShape3D;
77
+ /**
78
+ * `base` with `cut` taken away; with `smooth`, the edges of the hollow rounded. A cut that has a colour paints the
79
+ * faces it leaves, as the inside of a mouth or a window.
80
+ */
81
+ export declare function sdfSubtract(base: SdfShape3D, cut: SdfShape3D | readonly SdfShape3D[], options?: SdfGroupOptions3D): SdfShape3D;
82
+ /**
83
+ * What the shapes have in common; with `smooth`, its edges rounded. The shapes with a colour paint it, cut faces
84
+ * included; a shape without one only cuts.
85
+ */
86
+ export declare function sdfIntersect(items: readonly SdfShape3D[], options?: SdfGroupOptions3D): SdfShape3D;
87
+ /**
88
+ * The shape and its mirror image across the plane through the origin square to `axis` ('x' unless given): make one
89
+ * eye, ear, arm or leg on the positive side and get the pair.
90
+ */
91
+ export declare function sdfMirror(shape: SdfShape3D, options?: SdfOptions3D & {
92
+ readonly axis?: 'x' | 'y' | 'z';
93
+ }): SdfShape3D;
94
+ /** The shape grown by `radius` all round, its edges rounded by as much. */
95
+ export declare function sdfRound(shape: SdfShape3D, radius: number, options?: SdfOptions3D): SdfShape3D;
96
+ /** A hollow skin of the shape, `thickness` thick: bowls, pots, helmets, when cut open. */
97
+ export declare function sdfShell(shape: SdfShape3D, thickness: number, options?: SdfOptions3D): SdfShape3D;
98
+ /** What `sdfDisplace` does: how far, how fine and which noise. */
99
+ export interface SdfDisplaceOptions3D {
100
+ /** How far the surface moves in and out, in the model's units. */
101
+ readonly amount: number;
102
+ /** How many bumps per unit; 4 unless given. */
103
+ readonly frequency?: number;
104
+ /** Which noise: the same seed gives the same bumps. 0 unless given. */
105
+ readonly seed?: number;
106
+ }
107
+ /** The surface pushed in and out by smooth noise: rocks, bark, rough earth, a lumpy creature. */
108
+ export declare function sdfDisplace(shape: SdfShape3D, options: SdfDisplaceOptions3D): SdfShape3D;
109
+ /** A pattern painted over a shape's colours. */
110
+ export interface SdfPatternOptions3D {
111
+ /**
112
+ * 'spots' (a coat, a toadstool, lichen), 'stripes' (a tiger, a bee, planks, layers of rock), 'noise' (patches of
113
+ * moss, dirt, wear, a mottled skin) or 'gradient' (darker feet, a sunset belly, moss creeping up a wall).
114
+ */
115
+ readonly kind: 'spots' | 'stripes' | 'noise' | 'gradient';
116
+ /** The colour painted. */
117
+ readonly color: ColorInput3D;
118
+ /** How many spots, stripes or patches per unit; 4 unless given. Not used by 'gradient'. */
119
+ readonly frequency?: number;
120
+ /** How much of the colour at most, 0 to 1; 1 unless given. */
121
+ readonly amount?: number;
122
+ /** Stripes run across this axis and a gradient along it; 'y' unless given. */
123
+ readonly axis?: 'x' | 'y' | 'z';
124
+ /** Spots: their size, 0 to 1 of the space between them (0.35 unless given). Stripes: the share painted (0.5). */
125
+ readonly size?: number;
126
+ /** Gradient: where along `axis` the colour is absent and where it is whole; the shape's extent unless given. */
127
+ readonly from?: number;
128
+ readonly to?: number;
129
+ /** Which noise or which spots: the same seed gives the same pattern. 0 unless given. */
130
+ readonly seed?: number;
131
+ }
132
+ /**
133
+ * `shape` with a pattern painted over its colours, in the coordinates of the model; the surface does not move. The
134
+ * pattern is written into vertex colours, so it is as fine as the mesh: keep `frequency` at a few per unit.
135
+ */
136
+ export declare function sdfPattern(shape: SdfShape3D, options: SdfPatternOptions3D): SdfShape3D;
137
+ /** How a field becomes a mesh. */
138
+ export interface SdfMeshOptions3D {
139
+ /** Cells along the longest side of the model: 64 unless given, from 8 to 192. More is finer and slower. */
140
+ readonly resolution?: number;
141
+ /** How dark creases and hollows get, from 0 (no shading baked) to 1; 0.7 unless given. */
142
+ readonly occlusion?: number;
143
+ /** How far, in the model's units, a hollow is looked into for that shade; a tenth of the model's size unless given. */
144
+ readonly occlusionRadius?: number;
145
+ /** Uneven colour, so a large part is not one flat tone: `amount` 0 to 1 of brightness, `frequency` per unit. */
146
+ readonly variation?: {
147
+ readonly amount: number;
148
+ readonly frequency?: number;
149
+ readonly seed?: number;
150
+ };
151
+ /** The colour of shapes that have none; white unless given. */
152
+ readonly color?: ColorInput3D;
153
+ /**
154
+ * At most this many triangles: the mesh is simplified to it with `simplifyGeometry3D`. 8000 unless given, enough for a
155
+ * prop or a character seen close in a game; 0 keeps every triangle the grid gives.
156
+ */
157
+ readonly triangles?: number;
158
+ /**
159
+ * Light caught on the outer edges, as on worn wood, chipped paint or polished stone: `amount` 0 to 1 of the way to
160
+ * `color` (a lighter shade of each part unless given). Off unless given.
161
+ */
162
+ readonly edges?: {
163
+ readonly amount: number;
164
+ readonly color?: ColorInput3D;
165
+ };
166
+ /**
167
+ * Hard surfaces: corners and edges kept sharp, as on crates, walls, roofs, weapons and machines, instead of rounded
168
+ * to the grid. Each vertex is placed where the planes of the surface around it meet (dual contouring), and the
169
+ * normals are split where faces meet at more than an angle, so an edge shades as an edge. `true` splits at 40
170
+ * degrees; a number gives the angle. Off unless given: soft creatures and plants look better without it.
171
+ */
172
+ readonly sharp?: boolean | number;
173
+ }
174
+ /**
175
+ * The mesh of the field's surface, with smooth normals and linear vertex colours (draw it with a material that has
176
+ * `vertexColors: true`). Made once, when a level or a model is set up: at the default resolution a model takes a few
177
+ * tens of milliseconds.
178
+ */
179
+ export declare function createSdfGeometry3D(shape: SdfShape3D, options?: SdfMeshOptions3D): Geometry3D;
180
+ export {};
181
+ //# sourceMappingURL=Sdf3D.d.ts.map