Class DensityGuard

Owns the per-node keep ladder; driven by the tracker's onVisit hook.

Index

Constructors

Properties

deps changed captureActive

Methods

keepOf configure setCaptureActive observe applyBrightness desiredKeep release takeChanged

Constructors

constructor

new DensityGuard(): DensityGuard

Returns DensityGuard

Properties

`Private`deps

deps: DensityGuardDeps | null = null

`Private`changed

changed: boolean = false

`Private`captureActive

captureActive: boolean = false

Methods

`Static`keepOf

keepOf(mesh: Mesh): number
Current keep on a mesh's material (1 when unthinned / no uniform).
Parameters
- mesh: Mesh
Returns number
- Defined in src/scene/density-guard.ts:237

configure

configure(deps: DensityGuardDeps): void
Parameters
- deps: DensityGuardDeps
Returns void
- Defined in src/scene/density-guard.ts:131

setCaptureActive

setCaptureActive(active: boolean): void
Suspend the guard for an offline capture (true) or resume it (false). While suspended every visited node is released to keep 1 — an export renders the whole node, whatever the view's density.
Parameters
- active: boolean
Returns void
- Defined in src/scene/density-guard.ts:140

observe

observe(mesh: Mesh, rec: NodeDensity): void
Tracker visit hook: re-derive this node's keep fraction from its fresh density record, apply a step change to material + brightness, and re-assert the uniform. Off-screen nodes hold their step (no churn on nodes nobody sees; they re-evaluate the frame they return).
Parameters
- mesh: Mesh
- rec: NodeDensity
Returns void
- Defined in src/scene/density-guard.ts:152

`Private`applyBrightness

applyBrightness(
    mesh: Mesh,
    current: number,
    next: number,
    blendable: boolean,
    deps: DensityGuardDeps,
): void
Re-apply the brightness term when it changed. Keyed on (keep, blendability): a thinned node switching between a sum mode and normal keeps its keep but changes its term. An unthinned node (keep 1 before and after) is never touched.
Parameters
- mesh: Mesh
- current: number
- next: number
- blendable: boolean
- deps: DensityGuardDeps
Returns void
- Defined in src/scene/density-guard.ts:178

`Private`desiredKeep

desiredKeep(
    current: number,
    mode: string | undefined,
    rec: NodeDensity,
    deps: DensityGuardDeps,
): number
The keep fraction for this frame: 1 while an offline capture runs or for a mode the guard never thins; the held step while off-screen; otherwise the hysteresis ladder.
Parameters
- current: number
- mode: string | undefined
- rec: NodeDensity
- deps: DensityGuardDeps
Returns number
- Defined in src/scene/density-guard.ts:200

release

release(obj: Object3D): void
Undo this node's thinning (guard turned off at runtime): keep back to 1, brightness recomputed without the density term, uniform cleared. A no-op on anything that is not a thinned data mesh.
Parameters
- obj: Object3D
Returns void
- Defined in src/scene/density-guard.ts:215

takeChanged

takeChanged(): boolean
True once since the last call if any node changed step (or drifted).

Returns boolean
- Defined in src/scene/density-guard.ts:230