Interface XGFViewStreamControllerParams

Optional loading backpressure gate checked between chunk commits.

Maximum number of chunks committed per scheduling batch.

When true, keeps resolved XGF file bytes in memory for reuse after chunk unload/reload.

Debounce delay after schedule() before a streaming pass begins.

Optional filter for references-only chunks controlled by this instance.

Camera point used to prioritize nearer chunks. Defaults to "look".

Approximate per-frame commit budget, in milliseconds.

When true, unloads least-recently-used references-only chunks after loads exceed maxResidentChunks.

Maximum number of chunk fetches allowed at the same time.

Optional multiplier applied to the camera eye-to-look distance to cap the streaming frustum depth. This only affects chunk scheduling; it does not change the view's render far clip.

Optional minimum depth, in view units, for the streaming frustum cap. This prevents close-focus viewpoints from capping streaming to only a few meters while preserving the render camera's far clip.

When true, only chunks intersecting the current frustum are committed.

Optional child stream index resolver. Defaults to fetch(stream.uri).json().

Stream index containing asset-library and references-only chunks.

Optional loader instance. A default XGFStreamingLoader is created when omitted.

Options forwarded to chunk loads.

Maximum bytes of resolved XGF file data to retain when cacheFileData is enabled.

Maximum resident references-only chunks to keep when LRU eviction is enabled.

Optional CSS-pixel threshold for view-driven streaming. Chunks whose AABB projects smaller than this size on both canvas axes are treated as not visible for scheduling and unload decisions. Conservative cases such as hidden canvases or near-plane intersections remain visible.

Called after one chunk has loaded.

Called with per-chunk timing and creation stats.

Called before a batch of chunks begins loading.

Called when an async controller operation fails unexpectedly.

Called when queue progress changes.

Called with coarse controller status messages.

Minimum time between non-final progress callbacks, in milliseconds.

This lets streaming UIs batch redraws while chunks are being committed. Omit or set to zero to emit progress after every chunk, matching the default behavior.

SceneModel that receives streamed chunk content.

Base URI used to resolve child stream URIs in index.streams.

When true, unloads child stream chunks and unregisters their manifests after their stream AABB leaves the frustum.

View whose camera/frustum drives stream prioritization.