gaussian-splat-lite 1.2.2 → 1.3.1

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 (250) hide show
  1. package/CHANGELOG.md +61 -2
  2. package/CONTRIBUTING.md +4 -2
  3. package/README.md +4 -3
  4. package/dist/gaussian-splat-lite.cjs +6782 -1661
  5. package/dist/gaussian-splat-lite.cjs.map +1 -1
  6. package/dist/gaussian-splat-lite.min.cjs +991 -15
  7. package/dist/gaussian-splat-lite.min.cjs.map +1 -1
  8. package/dist/gaussian-splat-lite.module.js +6328 -1207
  9. package/dist/gaussian-splat-lite.module.js.map +1 -1
  10. package/dist/gaussian-splat-lite.module.min.js +8208 -3572
  11. package/dist/gaussian-splat-lite.module.min.js.map +1 -1
  12. package/dist/types/addons/NeuralDenoiseNode.d.cts +72 -0
  13. package/dist/types/addons/NeuralDenoiseNode.d.ts +72 -0
  14. package/dist/types/addons/NeuralDenoisePass.d.cts +34 -0
  15. package/dist/types/addons/NeuralDenoisePass.d.ts +34 -0
  16. package/dist/types/addons/TAANode.d.cts +46 -33
  17. package/dist/types/addons/TAANode.d.ts +46 -33
  18. package/dist/types/addons/TAAPass.d.cts +47 -32
  19. package/dist/types/addons/TAAPass.d.ts +47 -32
  20. package/dist/types/addons/neuralDenoiseGL.d.cts +25 -0
  21. package/dist/types/addons/neuralDenoiseGL.d.ts +25 -0
  22. package/dist/types/addons/neuralDenoiseGLSL.d.cts +8 -0
  23. package/dist/types/addons/neuralDenoiseGLSL.d.ts +8 -0
  24. package/dist/types/addons/neuralDenoisePasses.d.cts +26 -0
  25. package/dist/types/addons/neuralDenoisePasses.d.ts +26 -0
  26. package/dist/types/addons/neuralDenoiseShaders.d.cts +38 -0
  27. package/dist/types/addons/neuralDenoiseShaders.d.ts +38 -0
  28. package/dist/types/addons/neuralDenoiseWeights.d.cts +118 -0
  29. package/dist/types/addons/neuralDenoiseWeights.d.ts +118 -0
  30. package/dist/types/addons/stochasticCoverage.d.cts +14 -0
  31. package/dist/types/addons/stochasticCoverage.d.ts +14 -0
  32. package/dist/types/addons/taaShared.d.cts +58 -39
  33. package/dist/types/addons/taaShared.d.ts +58 -39
  34. package/dist/types/capture/SplatCapture.d.cts +54 -53
  35. package/dist/types/capture/SplatCapture.d.ts +54 -53
  36. package/dist/types/capture/WebGLCapture.d.cts +10 -10
  37. package/dist/types/capture/WebGLCapture.d.ts +10 -10
  38. package/dist/types/capture/WebGPUCapture.d.cts +14 -14
  39. package/dist/types/capture/WebGPUCapture.d.ts +14 -14
  40. package/dist/types/capture/pixels.d.cts +15 -4
  41. package/dist/types/capture/pixels.d.ts +15 -4
  42. package/dist/types/capture/rendererState.d.cts +5 -2
  43. package/dist/types/capture/rendererState.d.ts +5 -2
  44. package/dist/types/data/IndexedSplats.d.cts +83 -58
  45. package/dist/types/data/IndexedSplats.d.ts +83 -58
  46. package/dist/types/data/RadPagedSplats.d.cts +66 -61
  47. package/dist/types/data/RadPagedSplats.d.ts +66 -61
  48. package/dist/types/data/SogRegionSplats.d.cts +25 -19
  49. package/dist/types/data/SogRegionSplats.d.ts +25 -19
  50. package/dist/types/data/SplatOpacityTable.d.cts +36 -29
  51. package/dist/types/data/SplatOpacityTable.d.ts +36 -29
  52. package/dist/types/data/Splats.d.cts +99 -69
  53. package/dist/types/data/Splats.d.ts +99 -69
  54. package/dist/types/data/defines.d.cts +24 -24
  55. package/dist/types/data/defines.d.ts +24 -24
  56. package/dist/types/data/raycast.d.cts +13 -9
  57. package/dist/types/data/raycast.d.ts +13 -9
  58. package/dist/types/data/splatCodec.d.cts +29 -5
  59. package/dist/types/data/splatCodec.d.ts +29 -5
  60. package/dist/types/data/splatData.d.cts +18 -11
  61. package/dist/types/data/splatData.d.ts +18 -11
  62. package/dist/types/data/splatRange.d.cts +6 -2
  63. package/dist/types/data/splatRange.d.ts +6 -2
  64. package/dist/types/data/textureLayout.d.cts +9 -6
  65. package/dist/types/data/textureLayout.d.ts +9 -6
  66. package/dist/types/data/unpack.d.cts +16 -9
  67. package/dist/types/data/unpack.d.ts +16 -9
  68. package/dist/types/index.d.cts +65 -19
  69. package/dist/types/index.d.ts +65 -19
  70. package/dist/types/loaders/SplatLoader.d.cts +27 -14
  71. package/dist/types/loaders/SplatLoader.d.ts +27 -14
  72. package/dist/types/loaders/loadSplatData.d.cts +35 -17
  73. package/dist/types/loaders/loadSplatData.d.ts +35 -17
  74. package/dist/types/loaders/loadTypes.d.cts +46 -40
  75. package/dist/types/loaders/loadTypes.d.ts +46 -40
  76. package/dist/types/loaders/morton.d.cts +9 -3
  77. package/dist/types/loaders/morton.d.ts +9 -3
  78. package/dist/types/loaders/postDecode/builder.d.cts +222 -127
  79. package/dist/types/loaders/postDecode/builder.d.ts +222 -127
  80. package/dist/types/loaders/postDecode/compiler.d.cts +25 -11
  81. package/dist/types/loaders/postDecode/compiler.d.ts +25 -11
  82. package/dist/types/loaders/postDecode/operations.d.cts +22 -3
  83. package/dist/types/loaders/postDecode/operations.d.ts +22 -3
  84. package/dist/types/loaders/postDecode/optimizer.d.cts +5 -2
  85. package/dist/types/loaders/postDecode/optimizer.d.ts +5 -2
  86. package/dist/types/loaders/postDecode/program.d.cts +13 -6
  87. package/dist/types/loaders/postDecode/program.d.ts +13 -6
  88. package/dist/types/loaders/postDecode/protocol.d.cts +136 -111
  89. package/dist/types/loaders/postDecode/protocol.d.ts +136 -111
  90. package/dist/types/loaders/postDecode/registers.d.cts +12 -7
  91. package/dist/types/loaders/postDecode/registers.d.ts +12 -7
  92. package/dist/types/loaders/postDecode/runtime.d.cts +9 -2
  93. package/dist/types/loaders/postDecode/runtime.d.ts +9 -2
  94. package/dist/types/loaders/rad/RadSource.d.cts +81 -66
  95. package/dist/types/loaders/rad/RadSource.d.ts +81 -66
  96. package/dist/types/loaders/rad/radFormat.d.cts +41 -36
  97. package/dist/types/loaders/rad/radFormat.d.ts +41 -36
  98. package/dist/types/loaders/rad.d.cts +4 -4
  99. package/dist/types/loaders/rad.d.ts +4 -4
  100. package/dist/types/loaders/sog/SogSource.d.cts +14 -4
  101. package/dist/types/loaders/sog/SogSource.d.ts +14 -4
  102. package/dist/types/loaders/sog/sogZip.d.cts +12 -12
  103. package/dist/types/loaders/sog/sogZip.d.ts +12 -12
  104. package/dist/types/loaders/sog.d.cts +3 -3
  105. package/dist/types/loaders/sog.d.ts +3 -3
  106. package/dist/types/loaders/source.d.cts +43 -15
  107. package/dist/types/loaders/source.d.ts +43 -15
  108. package/dist/types/loaders/stream/StreamCameras.d.cts +27 -18
  109. package/dist/types/loaders/stream/StreamCameras.d.ts +27 -18
  110. package/dist/types/loaders/stream/StreamWorkerPool.d.cts +37 -37
  111. package/dist/types/loaders/stream/StreamWorkerPool.d.ts +37 -37
  112. package/dist/types/loaders/stream/rad-stream/RadSelectionState.d.cts +20 -13
  113. package/dist/types/loaders/stream/rad-stream/RadSelectionState.d.ts +20 -13
  114. package/dist/types/loaders/stream/rad-stream/RadStreamBatch.d.cts +13 -9
  115. package/dist/types/loaders/stream/rad-stream/RadStreamBatch.d.ts +13 -9
  116. package/dist/types/loaders/stream/rad-stream/RadStreamLoader.d.cts +69 -51
  117. package/dist/types/loaders/stream/rad-stream/RadStreamLoader.d.ts +69 -51
  118. package/dist/types/loaders/stream/rad-stream/RadStreamScheduler.d.cts +126 -102
  119. package/dist/types/loaders/stream/rad-stream/RadStreamScheduler.d.ts +126 -102
  120. package/dist/types/loaders/stream/rad-stream/RadStreamWorker.d.cts +4 -4
  121. package/dist/types/loaders/stream/rad-stream/RadStreamWorker.d.ts +4 -4
  122. package/dist/types/loaders/stream/rad-stream/prepareRadSelection.d.cts +20 -17
  123. package/dist/types/loaders/stream/rad-stream/prepareRadSelection.d.ts +20 -17
  124. package/dist/types/loaders/stream/rad-stream/radFade.d.cts +13 -8
  125. package/dist/types/loaders/stream/rad-stream/radFade.d.ts +13 -8
  126. package/dist/types/loaders/stream/rad-stream/radLod.d.cts +29 -27
  127. package/dist/types/loaders/stream/rad-stream/radLod.d.ts +29 -27
  128. package/dist/types/loaders/stream/rad-stream/worker.d.cts +3 -59
  129. package/dist/types/loaders/stream/rad-stream/worker.d.ts +3 -59
  130. package/dist/types/loaders/stream/rad-stream/workerHandlers.d.cts +58 -61
  131. package/dist/types/loaders/stream/rad-stream/workerHandlers.d.ts +58 -61
  132. package/dist/types/loaders/stream/sog-stream/SogStreamBatch.d.cts +16 -12
  133. package/dist/types/loaders/stream/sog-stream/SogStreamBatch.d.ts +16 -12
  134. package/dist/types/loaders/stream/sog-stream/SogStreamLoader.d.cts +56 -41
  135. package/dist/types/loaders/stream/sog-stream/SogStreamLoader.d.ts +56 -41
  136. package/dist/types/loaders/stream/sog-stream/SogStreamScheduler.d.cts +102 -81
  137. package/dist/types/loaders/stream/sog-stream/SogStreamScheduler.d.ts +102 -81
  138. package/dist/types/loaders/stream/sog-stream/SogStreamWorker.d.cts +3 -3
  139. package/dist/types/loaders/stream/sog-stream/SogStreamWorker.d.ts +3 -3
  140. package/dist/types/loaders/stream/sog-stream/sogLod.d.cts +67 -46
  141. package/dist/types/loaders/stream/sog-stream/sogLod.d.ts +67 -46
  142. package/dist/types/loaders/stream/sog-stream/sogVisibility.d.cts +28 -22
  143. package/dist/types/loaders/stream/sog-stream/sogVisibility.d.ts +28 -22
  144. package/dist/types/loaders/stream/sog-stream/worker.d.cts +7 -40
  145. package/dist/types/loaders/stream/sog-stream/worker.d.ts +7 -40
  146. package/dist/types/loaders/stream/sog-stream/workerHandlers.d.cts +63 -44
  147. package/dist/types/loaders/stream/sog-stream/workerHandlers.d.ts +63 -44
  148. package/dist/types/loaders/stream/streamOptions.d.cts +43 -33
  149. package/dist/types/loaders/stream/streamOptions.d.ts +43 -33
  150. package/dist/types/loaders/workerDecode.d.cts +30 -12
  151. package/dist/types/loaders/workerDecode.d.ts +30 -12
  152. package/dist/types/patches/threeR186.d.cts +3 -0
  153. package/dist/types/patches/threeR186.d.ts +3 -0
  154. package/dist/types/rendering/GaussianSplatRenderer.d.cts +393 -376
  155. package/dist/types/rendering/GaussianSplatRenderer.d.ts +393 -376
  156. package/dist/types/rendering/MaterialState.d.cts +9 -0
  157. package/dist/types/rendering/MaterialState.d.ts +9 -0
  158. package/dist/types/rendering/SortCenterCache.d.cts +17 -17
  159. package/dist/types/rendering/SortCenterCache.d.ts +17 -17
  160. package/dist/types/rendering/SplatAccumulator.d.cts +93 -77
  161. package/dist/types/rendering/SplatAccumulator.d.ts +93 -77
  162. package/dist/types/rendering/SplatGeometry.d.cts +2 -2
  163. package/dist/types/rendering/SplatGeometry.d.ts +2 -2
  164. package/dist/types/rendering/StochasticSplatMaterial.d.cts +14 -0
  165. package/dist/types/rendering/StochasticSplatMaterial.d.ts +14 -0
  166. package/dist/types/rendering/backend.d.cts +30 -18
  167. package/dist/types/rendering/backend.d.ts +30 -18
  168. package/dist/types/rendering/blueNoise.d.cts +1 -1
  169. package/dist/types/rendering/blueNoise.d.ts +1 -1
  170. package/dist/types/rendering/rendererUtils.d.cts +25 -10
  171. package/dist/types/rendering/rendererUtils.d.ts +25 -10
  172. package/dist/types/rendering/tsl/GenerateProgram.d.cts +19 -17
  173. package/dist/types/rendering/tsl/GenerateProgram.d.ts +19 -17
  174. package/dist/types/rendering/tsl/ProjectionProgram.d.cts +38 -33
  175. package/dist/types/rendering/tsl/ProjectionProgram.d.ts +38 -33
  176. package/dist/types/rendering/tsl/SplatBackend.d.cts +22 -10
  177. package/dist/types/rendering/tsl/SplatBackend.d.ts +22 -10
  178. package/dist/types/rendering/tsl/SplatMaterial.d.cts +38 -25
  179. package/dist/types/rendering/tsl/SplatMaterial.d.ts +38 -25
  180. package/dist/types/rendering/tsl/shaderUtils.d.cts +55 -17
  181. package/dist/types/rendering/tsl/shaderUtils.d.ts +55 -17
  182. package/dist/types/rendering/tsl/stochasticCoverage.d.cts +7 -0
  183. package/dist/types/rendering/tsl/stochasticCoverage.d.ts +7 -0
  184. package/dist/types/rendering/tsl/viewUniforms.d.cts +19 -9
  185. package/dist/types/rendering/tsl/viewUniforms.d.ts +19 -9
  186. package/dist/types/rendering/uniforms.d.cts +83 -83
  187. package/dist/types/rendering/uniforms.d.ts +83 -83
  188. package/dist/types/rendering/webgl/AccumulatorGenerator.d.cts +28 -12
  189. package/dist/types/rendering/webgl/AccumulatorGenerator.d.ts +28 -12
  190. package/dist/types/rendering/webgl/OrderingTexture.d.cts +10 -7
  191. package/dist/types/rendering/webgl/OrderingTexture.d.ts +10 -7
  192. package/dist/types/rendering/webgl/SplatBackend.d.cts +20 -15
  193. package/dist/types/rendering/webgl/SplatBackend.d.ts +20 -15
  194. package/dist/types/rendering/webgl/SplatMaterial.d.cts +9 -4
  195. package/dist/types/rendering/webgl/SplatMaterial.d.ts +9 -4
  196. package/dist/types/rendering/webgl/textureUtils.d.cts +10 -3
  197. package/dist/types/rendering/webgl/textureUtils.d.ts +10 -3
  198. package/dist/types/rendering/webgl-fallback/AccumulatorGenerator.d.cts +8 -10
  199. package/dist/types/rendering/webgl-fallback/AccumulatorGenerator.d.ts +8 -10
  200. package/dist/types/rendering/webgl-fallback/SplatBackend.d.cts +18 -14
  201. package/dist/types/rendering/webgl-fallback/SplatBackend.d.ts +18 -14
  202. package/dist/types/rendering/webgpu/ProjectedSplats.d.cts +76 -66
  203. package/dist/types/rendering/webgpu/ProjectedSplats.d.ts +76 -66
  204. package/dist/types/rendering/webgpu/ProjectionCache.d.cts +43 -28
  205. package/dist/types/rendering/webgpu/ProjectionCache.d.ts +43 -28
  206. package/dist/types/rendering/webgpu/ProjectionKernel.d.cts +22 -0
  207. package/dist/types/rendering/webgpu/ProjectionKernel.d.ts +22 -0
  208. package/dist/types/rendering/webgpu/RadixSort.d.cts +44 -40
  209. package/dist/types/rendering/webgpu/RadixSort.d.ts +44 -40
  210. package/dist/types/rendering/webgpu/SplatBackend.d.cts +14 -12
  211. package/dist/types/rendering/webgpu/SplatBackend.d.ts +14 -12
  212. package/dist/types/runtime/SplatWorker.d.cts +17 -13
  213. package/dist/types/runtime/SplatWorker.d.ts +17 -13
  214. package/dist/types/runtime/WorkerRpc.d.cts +26 -20
  215. package/dist/types/runtime/WorkerRpc.d.ts +26 -20
  216. package/dist/types/runtime/abort.d.cts +10 -5
  217. package/dist/types/runtime/abort.d.ts +10 -5
  218. package/dist/types/runtime/retry.d.cts +6 -6
  219. package/dist/types/runtime/retry.d.ts +6 -6
  220. package/dist/types/runtime/wasmCall.d.cts +3 -3
  221. package/dist/types/runtime/wasmCall.d.ts +3 -3
  222. package/dist/types/runtime/worker.d.cts +44 -24
  223. package/dist/types/runtime/worker.d.ts +44 -24
  224. package/dist/types/runtime/workerServer.d.cts +3 -1
  225. package/dist/types/runtime/workerServer.d.ts +3 -1
  226. package/dist/types/scene/SplatEdit.d.cts +74 -67
  227. package/dist/types/scene/SplatEdit.d.ts +74 -67
  228. package/dist/types/scene/SplatMesh.d.cts +92 -70
  229. package/dist/types/scene/SplatMesh.d.ts +92 -70
  230. package/dist/types/utils/index.d.cts +15 -7
  231. package/dist/types/utils/index.d.ts +15 -7
  232. package/dist/types/utils/three.d.cts +3 -3
  233. package/dist/types/utils/three.d.ts +3 -3
  234. package/dist/types/utils/transforms.d.cts +10 -3
  235. package/dist/types/utils/transforms.d.ts +10 -3
  236. package/docs/GaussianSplatRenderer.md +3 -1
  237. package/docs/NeuralDenoiseNode.md +148 -0
  238. package/docs/RadStreamScheduler.md +14 -5
  239. package/docs/SogStreamScheduler.md +8 -6
  240. package/docs/SplatMesh.md +1 -1
  241. package/docs/StochasticRendering.md +36 -10
  242. package/docs/TAAPass.md +20 -3
  243. package/package.json +9 -11
  244. package/dist/types/capture/sceneView.d.cts +0 -3
  245. package/dist/types/capture/sceneView.d.ts +0 -3
  246. package/dist/types/loaders/stream/StreamByteBudget.d.cts +0 -7
  247. package/dist/types/loaders/stream/StreamByteBudget.d.ts +0 -7
  248. package/dist/types/rendering/tsl/tslCompat.d.cts +0 -68
  249. package/dist/types/rendering/tsl/tslCompat.d.ts +0 -68
  250. package/docs/Architecture.md +0 -200
@@ -1,107 +1,131 @@
1
- import { StreamResolutionSource } from '../StreamCameras';
2
- import { StreamSchedulerOptions, StreamStats } from '../streamOptions';
3
- import { RadStreamLoaderOptions } from './RadStreamLoader';
4
- import * as THREE from "three";
5
- export type RadStreamSchedulerOptions = RadStreamLoaderOptions & StreamSchedulerOptions;
1
+ import type * as THREE from "three";
2
+ import type { StreamResolutionSource } from "../StreamCameras.js";
3
+ import type { StreamSchedulerOptions, StreamStats } from "../streamOptions.js";
4
+ import type { RadStreamLoaderOptions } from "./RadStreamLoader.js";
5
+ export type RadStreamSchedulerOptions = RadStreamLoaderOptions &
6
+ StreamSchedulerOptions & {
7
+ /** Allowed fractional splat budget overshoot. Default: 0.1; 0 forbids overshoot. */
8
+ splatBudgetTolerance?: number;
9
+ /** Retained CPU byte budget, excluding pending copies and WASM. Default: 2 GiB. */
10
+ maxResidentCpuBytes?: number;
11
+ /** Estimated GPU byte budget for resident streaming data. Default: 1 GiB. */
12
+ maxResidentGpuBytes?: number;
13
+ };
6
14
  export type RadStreamStats = StreamStats & {
7
- pageBudget: number;
8
- lodTimeMs: number;
15
+ /** Resident page limit derived from the smaller CPU/GPU allowance. */
16
+ pageBudget: number;
17
+ lodTimeMs: number;
9
18
  };
10
19
  /** Camera-driven RAD tree cuts with crossfades, on-demand pages and cooldown. */
11
20
  export declare class RadStreamScheduler {
12
- private readonly options;
13
- readonly group: THREE.Group;
14
- readonly initialized: Promise<this>;
15
- readonly firstRenderable: Promise<this>;
16
- readonly cooldownMs: number;
17
- readonly fadeDurationMs: number;
18
- readonly maxConcurrentLoads: number;
19
- private _splatBudget;
20
- private readonly loader;
21
- private readonly abort;
22
- private readonly streamCameras;
23
- private readonly pages;
24
- private readonly pools;
25
- private readonly bounds;
26
- private readonly matrix;
27
- private meta?;
28
- private pageSize;
29
- private pageBudget;
30
- private numSh;
31
- private maxPagePendingBytes;
32
- private disposed;
33
- private shown;
34
- private displayed?;
35
- private ready?;
36
- private traversal?;
37
- private preparation?;
38
- private wanted;
39
- private revision;
40
- private lastRequestedRevision;
41
- private refinementStopped;
42
- private lastViewKey;
43
- private views;
44
- private lodTimeMs;
45
- private resolveFirst;
46
- private rejectFirst;
47
- constructor(options: RadStreamSchedulerOptions);
48
- /** Selected-node budget. Assigning a new value requests LOD selection. */
49
- get splatBudget(): number;
50
- set splatBudget(value: number);
51
- /** Cameras that select detail, in registration order. */
52
- get cameras(): readonly THREE.Camera[];
53
- hasCamera(camera: THREE.Camera): boolean;
54
- /**
55
- * Select detail for this camera on each update; set its resolution too. For
56
- * WebXR register renderer.xr.getCamera(): it selects with its eyes' combined
57
- * frustum, sized by an eye's viewport. Returns whether the camera was newly
58
- * added.
59
- */
60
- setCamera(camera: THREE.Camera): boolean;
61
- /** Stop selecting detail for this camera. Returns whether it was registered. */
62
- deleteCamera(camera: THREE.Camera): boolean;
63
- /**
64
- * Set a registered camera's render size in CSS pixels, without the device
65
- * pixel ratio. Returns whether the camera is registered.
66
- */
67
- setResolution(camera: THREE.Camera, xOrVec: number | THREE.Vector2, y?: number): boolean;
68
- /** Set a registered camera's resolution from renderer.getSize(). */
69
- setResolutionFromRenderer(camera: THREE.Camera, renderer: StreamResolutionSource): boolean;
70
- get stats(): RadStreamStats;
71
- /** Group-local root bounds plus selected Gaussian extents; approximate while streaming. */
72
- getBoundingBox(): THREE.Box3;
73
- private initialize;
74
- /**
75
- * Call before rendering. Registered cameras share one cut at the greatest
76
- * detail any of them needs.
77
- */
78
- update(): boolean;
79
- private requestSelection;
80
- private selectionPagesReady;
81
- private prepareSelection;
82
- private applySelection;
83
- private invalidatePendingSelection;
84
- private clearSelectionState;
85
- /** Worker snapshots and waiting cuts pin pages without renewing cooldown. */
86
- private isPagePinned;
87
- private cancelUnusedLoads;
88
- private updateFade;
89
- private page;
90
- private pump;
91
- private loadPage;
92
- private setInitialBounds;
93
- private findSlot;
94
- private reservePages;
95
- private uploadPages;
96
- private releasePage;
97
- private releaseUnused;
98
- /** Map a raycast hit's rendered index back to its stable file index. */
99
- getGlobalIndex(mesh: THREE.Object3D, renderedIndex: number): number;
100
- private changed;
101
- private failed;
102
- private stopRefinement;
103
- private scheduleRetry;
104
- private retryDeadlines;
105
- private readonly retryTimer;
106
- dispose(): void;
21
+ private readonly options;
22
+ readonly group: THREE.Group;
23
+ readonly initialized: Promise<this>;
24
+ readonly firstRenderable: Promise<this>;
25
+ readonly cooldownMs: number;
26
+ readonly fadeDurationMs: number;
27
+ readonly maxConcurrentLoads: number;
28
+ readonly maxResidentCpuBytes: number;
29
+ readonly maxResidentGpuBytes: number;
30
+ private _splatBudget;
31
+ private _splatBudgetTolerance;
32
+ private readonly loader;
33
+ private readonly abort;
34
+ private readonly streamCameras;
35
+ private readonly pages;
36
+ private readonly pools;
37
+ private readonly bounds;
38
+ private readonly matrix;
39
+ private meta?;
40
+ private pageSize;
41
+ private pageBudget;
42
+ private numSh;
43
+ private maxPagePendingBytes;
44
+ private disposed;
45
+ private shown;
46
+ private displayed?;
47
+ private ready?;
48
+ private traversal?;
49
+ private preparation?;
50
+ private wanted;
51
+ private revision;
52
+ private lastRequestedRevision;
53
+ private refinementStopped;
54
+ private lastViewKey;
55
+ private views;
56
+ private lodTimeMs;
57
+ private resolveFirst;
58
+ private rejectFirst;
59
+ constructor(options: RadStreamSchedulerOptions);
60
+ /** Target selected-node budget. Assigning a new value requests LOD selection. */
61
+ get splatBudget(): number;
62
+ set splatBudget(value: number);
63
+ /** Allowed fractional budget overshoot; zero forbids overshoot. */
64
+ get splatBudgetTolerance(): number;
65
+ set splatBudgetTolerance(value: number);
66
+ /** Cameras that select detail, in registration order. */
67
+ get cameras(): readonly THREE.Camera[];
68
+ hasCamera(camera: THREE.Camera): boolean;
69
+ /**
70
+ * Select detail for this camera on each update; set its resolution too. For
71
+ * WebXR register renderer.xr.getCamera(): it selects with its eyes' combined
72
+ * frustum, sized by an eye's viewport. Returns whether the camera was newly
73
+ * added.
74
+ */
75
+ setCamera(camera: THREE.Camera): boolean;
76
+ /** Stop selecting detail for this camera. Returns whether it was registered. */
77
+ deleteCamera(camera: THREE.Camera): boolean;
78
+ /**
79
+ * Set a registered camera's render size in CSS pixels, without the device
80
+ * pixel ratio. Returns whether the camera is registered.
81
+ */
82
+ setResolution(
83
+ camera: THREE.Camera,
84
+ xOrVec: number | THREE.Vector2,
85
+ y?: number,
86
+ ): boolean;
87
+ /** Set a registered camera's resolution from renderer.getSize(). */
88
+ setResolutionFromRenderer(
89
+ camera: THREE.Camera,
90
+ renderer: StreamResolutionSource,
91
+ ): boolean;
92
+ get stats(): RadStreamStats;
93
+ /** Group-local root bounds plus selected Gaussian extents; approximate while streaming. */
94
+ getBoundingBox(): THREE.Box3;
95
+ private initialize;
96
+ /**
97
+ * Call before rendering. Registered cameras share one cut at the greatest
98
+ * detail any of them needs.
99
+ */
100
+ update(): boolean;
101
+ private get selectionBaselineId();
102
+ private requestSelection;
103
+ private selectionPagesReady;
104
+ private prepareSelection;
105
+ private applySelection;
106
+ private invalidatePendingSelection;
107
+ private clearSelectionState;
108
+ /** Worker snapshots and waiting cuts pin pages without renewing cooldown. */
109
+ private isPagePinned;
110
+ private cancelUnusedLoads;
111
+ private updateFade;
112
+ private page;
113
+ private pump;
114
+ private loadPage;
115
+ private setInitialBounds;
116
+ private findSlot;
117
+ private reservePages;
118
+ private uploadPages;
119
+ private releasePage;
120
+ private isPageRequired;
121
+ private releaseUnused;
122
+ /** Map a raycast hit's rendered index back to its stable file index. */
123
+ getGlobalIndex(mesh: THREE.Object3D, renderedIndex: number): number;
124
+ private changed;
125
+ private failed;
126
+ private stopRefinement;
127
+ private scheduleRetry;
128
+ private retryDeadlines;
129
+ private readonly retryTimer;
130
+ dispose(): void;
107
131
  }
@@ -1,6 +1,6 @@
1
- import { WorkerRpc } from '../../../runtime/WorkerRpc.cjs';
2
- import { RadStreamRpcHandlers } from './worker.cjs';
3
- /** Worker assigned either LOD ownership or a persistent page decoder. */
1
+ import { WorkerRpc } from "../../../runtime/WorkerRpc.cjs";
2
+ import type { RadStreamRpcHandlers } from "./worker.cjs";
3
+ /** Worker assigned traversal, display preparation, or page decoding. */
4
4
  export declare class RadStreamWorker extends WorkerRpc<RadStreamRpcHandlers> {
5
- constructor(onDispose?: () => void);
5
+ constructor(onDispose?: () => void);
6
6
  }
@@ -1,6 +1,6 @@
1
- import { WorkerRpc } from '../../../runtime/WorkerRpc';
2
- import { RadStreamRpcHandlers } from './worker';
3
- /** Worker assigned either LOD ownership or a persistent page decoder. */
1
+ import { WorkerRpc } from "../../../runtime/WorkerRpc.js";
2
+ import type { RadStreamRpcHandlers } from "./worker.js";
3
+ /** Worker assigned traversal, display preparation, or page decoding. */
4
4
  export declare class RadStreamWorker extends WorkerRpc<RadStreamRpcHandlers> {
5
- constructor(onDispose?: () => void);
5
+ constructor(onDispose?: () => void);
6
6
  }
@@ -1,20 +1,23 @@
1
- import { RadPreparedSelection, RadSelectionSnapshot } from '../../../data/RadPagedSplats.cjs';
2
- import { RadStreamSelection } from './radFade.cjs';
3
- import { RadLodChunk } from './radLod.cjs';
4
- export type RadSelectionChunk = Pick<RadLodChunk, "sourceToStorage" | "boundsBlocks">;
1
+ import type {
2
+ RadPreparedSelection,
3
+ RadSelectionSnapshot,
4
+ } from "../../../data/RadPagedSplats.cjs";
5
+ import type { RadStreamSelection } from "./radFade.cjs";
6
+ import type { RadLodChunk } from "./radLod.cjs";
7
+ export type RadSelectionChunk = Pick<
8
+ RadLodChunk,
9
+ "sourceToStorage" | "boundsBlocks"
10
+ >;
11
+ export type RadSelectionPreparation = {
12
+ selection: Omit<RadStreamSelection, "fade">;
13
+ fade: boolean;
14
+ pools: RadPreparedSelection[];
15
+ };
5
16
  /** The scheduler snapshots and pins resident pages before dispatching this work. */
6
- export declare function prepareRadSelection({ selection, pools, }: {
17
+ export declare function prepareRadSelection(
18
+ request: {
7
19
  selection: RadStreamSelection;
8
20
  pools: RadSelectionSnapshot[];
9
- }, chunks: ReadonlyMap<number, RadSelectionChunk>): {
10
- selection: {
11
- indices: Uint32Array;
12
- wantedChunks: Uint32Array;
13
- touchedChunks: Uint32Array;
14
- selectionId: number;
15
- changedChunks: Uint32Array;
16
- };
17
- fade: boolean;
18
- pools: RadPreparedSelection[];
19
- };
20
- export type RadSelectionPreparation = ReturnType<typeof prepareRadSelection>;
21
+ },
22
+ chunks: ReadonlyMap<number, RadSelectionChunk>,
23
+ ): RadSelectionPreparation;
@@ -1,20 +1,23 @@
1
- import { RadPreparedSelection, RadSelectionSnapshot } from '../../../data/RadPagedSplats';
2
- import { RadStreamSelection } from './radFade';
3
- import { RadLodChunk } from './radLod';
4
- export type RadSelectionChunk = Pick<RadLodChunk, "sourceToStorage" | "boundsBlocks">;
1
+ import type {
2
+ RadPreparedSelection,
3
+ RadSelectionSnapshot,
4
+ } from "../../../data/RadPagedSplats.js";
5
+ import type { RadStreamSelection } from "./radFade.js";
6
+ import type { RadLodChunk } from "./radLod.js";
7
+ export type RadSelectionChunk = Pick<
8
+ RadLodChunk,
9
+ "sourceToStorage" | "boundsBlocks"
10
+ >;
11
+ export type RadSelectionPreparation = {
12
+ selection: Omit<RadStreamSelection, "fade">;
13
+ fade: boolean;
14
+ pools: RadPreparedSelection[];
15
+ };
5
16
  /** The scheduler snapshots and pins resident pages before dispatching this work. */
6
- export declare function prepareRadSelection({ selection, pools, }: {
17
+ export declare function prepareRadSelection(
18
+ request: {
7
19
  selection: RadStreamSelection;
8
20
  pools: RadSelectionSnapshot[];
9
- }, chunks: ReadonlyMap<number, RadSelectionChunk>): {
10
- selection: {
11
- indices: Uint32Array;
12
- wantedChunks: Uint32Array;
13
- touchedChunks: Uint32Array;
14
- selectionId: number;
15
- changedChunks: Uint32Array;
16
- };
17
- fade: boolean;
18
- pools: RadPreparedSelection[];
19
- };
20
- export type RadSelectionPreparation = ReturnType<typeof prepareRadSelection>;
21
+ },
22
+ chunks: ReadonlyMap<number, RadSelectionChunk>,
23
+ ): RadSelectionPreparation;
@@ -1,16 +1,21 @@
1
- import { RadMeta } from '../../rad/radFormat.cjs';
2
- import { RadLodSelection } from './radLod.cjs';
1
+ import type { RadMeta } from "../../rad/radFormat.cjs";
2
+ import type { RadLodSelection } from "./radLod.cjs";
3
3
  export type RadFade = {
4
- indices: Uint32Array;
5
- fades: Uint8Array;
4
+ indices: Uint32Array;
5
+ fades: Uint8Array;
6
6
  };
7
7
  export type RadVersionedSelection = RadLodSelection & {
8
- selectionId: number;
8
+ selectionId: number;
9
9
  };
10
10
  export type RadStreamSelection = RadVersionedSelection & {
11
- changedChunks: Uint32Array;
12
- fade?: RadFade;
11
+ changedChunks: Uint32Array;
12
+ fade?: RadFade;
13
13
  };
14
14
  /** Compare sorted cuts and build their optional fade union in one pass. Allocate
15
15
  * the union only after a difference, so unchanged decisions allocate no fade. */
16
- export declare function prepareRadFade(meta: RadMeta, previous: Uint32Array, next: Uint32Array, enableFade: boolean): Pick<RadStreamSelection, "changedChunks" | "fade">;
16
+ export declare function prepareRadFade(
17
+ meta: RadMeta,
18
+ previous: Uint32Array,
19
+ next: Uint32Array,
20
+ enableFade: boolean,
21
+ ): Pick<RadStreamSelection, "changedChunks" | "fade">;
@@ -1,16 +1,21 @@
1
- import { RadMeta } from '../../rad/radFormat';
2
- import { RadLodSelection } from './radLod';
1
+ import type { RadMeta } from "../../rad/radFormat.js";
2
+ import type { RadLodSelection } from "./radLod.js";
3
3
  export type RadFade = {
4
- indices: Uint32Array;
5
- fades: Uint8Array;
4
+ indices: Uint32Array;
5
+ fades: Uint8Array;
6
6
  };
7
7
  export type RadVersionedSelection = RadLodSelection & {
8
- selectionId: number;
8
+ selectionId: number;
9
9
  };
10
10
  export type RadStreamSelection = RadVersionedSelection & {
11
- changedChunks: Uint32Array;
12
- fade?: RadFade;
11
+ changedChunks: Uint32Array;
12
+ fade?: RadFade;
13
13
  };
14
14
  /** Compare sorted cuts and build their optional fade union in one pass. Allocate
15
15
  * the union only after a difference, so unchanged decisions allocate no fade. */
16
- export declare function prepareRadFade(meta: RadMeta, previous: Uint32Array, next: Uint32Array, enableFade: boolean): Pick<RadStreamSelection, "changedChunks" | "fade">;
16
+ export declare function prepareRadFade(
17
+ meta: RadMeta,
18
+ previous: Uint32Array,
19
+ next: Uint32Array,
20
+ enableFade: boolean,
21
+ ): Pick<RadStreamSelection, "changedChunks" | "fade">;
@@ -1,37 +1,39 @@
1
- import { RadMeta } from '../../rad/radFormat.cjs';
2
- /** CPU-only data retained in the dataset worker, never GPU source storage. */
1
+ import type { RadMeta } from "../../rad/radFormat.cjs";
2
+ /** CPU-only page data split between traversal and display preparation workers. */
3
3
  export type RadLodChunk = {
4
- centers: Float32Array;
5
- radii: Float32Array;
6
- childStart: Uint32Array;
7
- childCount: Uint16Array;
8
- /** Original page index to Morton storage; tree arrays keep file order. */
9
- sourceToStorage: Uint32Array;
10
- /** Center and scale/rotation bounds per Morton storage block. */
11
- boundsBlocks: Float32Array;
4
+ centers: Float32Array;
5
+ radii: Float32Array;
6
+ childStart: Uint32Array;
7
+ childCount: Uint16Array;
8
+ /** Original page index to Morton storage; tree arrays keep file order. */
9
+ sourceToStorage: Uint32Array;
10
+ /** Center and scale/rotation bounds per Morton storage block. */
11
+ boundsBlocks: Float32Array;
12
12
  };
13
13
  export type RadLodView = {
14
- /** Object-to-camera transform; doubles preserve large scene translations. */
15
- viewFromObject: number[];
16
- /** Camera projection's X/Y rows (8 values), including zoom and view offsets. */
17
- projectionRows: number[];
18
- /** Pixels per camera-space unit at depth 1, including projection zoom. */
19
- pixelScale: number;
20
- orthographic: boolean;
14
+ /** Object-to-camera transform; doubles preserve large scene translations. */
15
+ viewFromObject: number[];
16
+ /** Camera projection's X/Y rows (8 values), including zoom and view offsets. */
17
+ projectionRows: number[];
18
+ /** Pixels per camera-space unit at depth 1, including projection zoom. */
19
+ pixelScale: number;
20
+ orthographic: boolean;
21
21
  };
22
22
  export type RadLodRequest = {
23
- views: RadLodView[];
24
- splatBudget: number;
25
- pixelThreshold: number;
26
- residentChunks: number[];
27
- hysteresis?: number;
23
+ views: RadLodView[];
24
+ splatBudget: number;
25
+ splatBudgetTolerance: number;
26
+ /** Combined limit for resident tree paths and requested pages. */
27
+ pageBudget: number;
28
+ pixelThreshold: number;
29
+ residentChunks: number[];
28
30
  };
29
31
  export type RadLodSelection = {
30
- /** Stable file indices. The scheduler maps these to occupied GPU slots. */
31
- indices: Uint32Array;
32
- wantedChunks: Uint32Array;
33
- /** Ancestor and selected pages required by this cut. */
34
- touchedChunks: Uint32Array;
32
+ /** Stable file indices. The scheduler maps these to occupied GPU slots. */
33
+ indices: Uint32Array;
34
+ wantedChunks: Uint32Array;
35
+ /** Ancestor and selected pages required by this cut. */
36
+ touchedChunks: Uint32Array;
35
37
  };
36
38
  /** Resolve validated LOD indices without assuming that chunks are 64K records. */
37
39
  export declare function radChunkIndex(meta: RadMeta, index: number): number;
@@ -1,37 +1,39 @@
1
- import { RadMeta } from '../../rad/radFormat';
2
- /** CPU-only data retained in the dataset worker, never GPU source storage. */
1
+ import type { RadMeta } from "../../rad/radFormat.js";
2
+ /** CPU-only page data split between traversal and display preparation workers. */
3
3
  export type RadLodChunk = {
4
- centers: Float32Array;
5
- radii: Float32Array;
6
- childStart: Uint32Array;
7
- childCount: Uint16Array;
8
- /** Original page index to Morton storage; tree arrays keep file order. */
9
- sourceToStorage: Uint32Array;
10
- /** Center and scale/rotation bounds per Morton storage block. */
11
- boundsBlocks: Float32Array;
4
+ centers: Float32Array;
5
+ radii: Float32Array;
6
+ childStart: Uint32Array;
7
+ childCount: Uint16Array;
8
+ /** Original page index to Morton storage; tree arrays keep file order. */
9
+ sourceToStorage: Uint32Array;
10
+ /** Center and scale/rotation bounds per Morton storage block. */
11
+ boundsBlocks: Float32Array;
12
12
  };
13
13
  export type RadLodView = {
14
- /** Object-to-camera transform; doubles preserve large scene translations. */
15
- viewFromObject: number[];
16
- /** Camera projection's X/Y rows (8 values), including zoom and view offsets. */
17
- projectionRows: number[];
18
- /** Pixels per camera-space unit at depth 1, including projection zoom. */
19
- pixelScale: number;
20
- orthographic: boolean;
14
+ /** Object-to-camera transform; doubles preserve large scene translations. */
15
+ viewFromObject: number[];
16
+ /** Camera projection's X/Y rows (8 values), including zoom and view offsets. */
17
+ projectionRows: number[];
18
+ /** Pixels per camera-space unit at depth 1, including projection zoom. */
19
+ pixelScale: number;
20
+ orthographic: boolean;
21
21
  };
22
22
  export type RadLodRequest = {
23
- views: RadLodView[];
24
- splatBudget: number;
25
- pixelThreshold: number;
26
- residentChunks: number[];
27
- hysteresis?: number;
23
+ views: RadLodView[];
24
+ splatBudget: number;
25
+ splatBudgetTolerance: number;
26
+ /** Combined limit for resident tree paths and requested pages. */
27
+ pageBudget: number;
28
+ pixelThreshold: number;
29
+ residentChunks: number[];
28
30
  };
29
31
  export type RadLodSelection = {
30
- /** Stable file indices. The scheduler maps these to occupied GPU slots. */
31
- indices: Uint32Array;
32
- wantedChunks: Uint32Array;
33
- /** Ancestor and selected pages required by this cut. */
34
- touchedChunks: Uint32Array;
32
+ /** Stable file indices. The scheduler maps these to occupied GPU slots. */
33
+ indices: Uint32Array;
34
+ wantedChunks: Uint32Array;
35
+ /** Ancestor and selected pages required by this cut. */
36
+ touchedChunks: Uint32Array;
35
37
  };
36
38
  /** Resolve validated LOD indices without assuming that chunks are 64K records. */
37
39
  export declare function radChunkIndex(meta: RadMeta, index: number): number;
@@ -1,59 +1,3 @@
1
- declare const rpcHandlers: {
2
- prepareRadSelection(request: Parameters<typeof import('./prepareRadSelection.cjs').prepareRadSelection>[0]): {
3
- selection: {
4
- indices: Uint32Array;
5
- wantedChunks: Uint32Array;
6
- touchedChunks: Uint32Array;
7
- selectionId: number;
8
- changedChunks: Uint32Array;
9
- };
10
- fade: boolean;
11
- pools: import('../../../data/RadPagedSplats.cjs').RadPreparedSelection[];
12
- };
13
- initializeRad({ bytes }: {
14
- bytes: Uint8Array;
15
- }): import('../../rad/radFormat.cjs').RadHeader;
16
- initializeRadDecoder({ header: value, rootBytes, }: {
17
- header: import('../../rad/radFormat.cjs').RadHeader;
18
- rootBytes?: Uint8Array;
19
- }): void;
20
- loadRadChunk({ index, generation, request, }: {
21
- index: number;
22
- generation: number;
23
- request: import('../../rad/RadSource.cjs').RadReadRequest;
24
- }, { sendStatus }: {
25
- sendStatus: (data: {
26
- loaded: number;
27
- }) => void;
28
- }): Promise<{
29
- data: {
30
- numSplats: number;
31
- splatArrays: [Uint32Array<ArrayBufferLike>, Uint32Array<ArrayBufferLike>];
32
- extra: import('../../../data/defines.cjs').SplatExtra;
33
- rootRadius: number | undefined;
34
- } & import('../../../data/defines.cjs').SplatResult & {
35
- sourceIds: Uint32Array;
36
- centerOnlyBoundingBox: Float32Array;
37
- boundingBox: Float32Array;
38
- spatialBounds: Float32Array;
39
- };
40
- tree: import('./radLod.cjs').RadLodChunk;
41
- state: import('../../rad/RadSource.cjs').RadResourceState | undefined;
42
- rootBytes: Uint8Array<ArrayBufferLike> | undefined;
43
- }>;
44
- cancelRadLoad({ generation }: {
45
- generation: number;
46
- }): void;
47
- retainRadChunk({ index, generation, tree, }: {
48
- index: number;
49
- generation: number;
50
- tree: import('./radLod.cjs').RadLodChunk;
51
- }): void;
52
- selectRadLod(request: import('./RadSelectionState.cjs').RadSelectionRequest): import('./RadSelectionState.cjs').RadSelectionReply;
53
- releaseRadChunk({ index, generation, }: {
54
- index: number;
55
- generation?: number;
56
- }): void;
57
- };
58
- export type RadStreamRpcHandlers = typeof rpcHandlers;
59
- export {};
1
+ import type { createRadStreamHandlers } from "./workerHandlers.cjs";
2
+
3
+ export type RadStreamRpcHandlers = ReturnType<typeof createRadStreamHandlers>;