Skip to content

CutOptions

Defined in: network/lod.ts:999

optional expandPx?: number

Defined in: network/lod.ts:1007

Expand an aggregate into its children once its on-screen footprint (diameter = 2·extent·k, in px) reaches this threshold; below it the aggregate draws as a single glyph. Larger → coarser (fewer, bigger glyphs); smaller → finer. An absolute pixel size — omit it to get the tree-adaptive default (defaultExpandPx: 48 px for a binary coarsening tree, more for a coarser-branching one such as a provided module partition).


optional fadeAlpha?: Float32Array<ArrayBufferLike>

Defined in: network/lod.ts:1024

Scratch buffer, indexed by tree-node id (length ≥ tree.size), the cut fills with each emitted node’s draw alpha when fadeBand > 0 (only frontier nodes are written; stale entries are never read). Reusable across frames to avoid per-frame GC. Required when fadeBand > 0.


optional fadeBand?: number

Defined in: network/lod.ts:1018

Cross-fade band (#133): half-width, as a fraction of expandPx, of the zoom band around the expand threshold over which an aggregate and its children are drawn together — the aggregate easing out (alpha 1→0) as its children ease in (0→1), so a split/merge reads smoothly instead of popping. 0/absent ⇒ off (the hard threshold, zero added cost). When > 0, fill fadeAlpha.


optional maxAggregateRadius?: number

Defined in: network/lod.ts:1011

Aggregate draw-radius cap (matches rendering), so the cull margin reflects the drawn size.


optional screenSized?: boolean

Defined in: network/lod.ts:1009

True when glyphs are screen-pixel sized; converts the per-node draw radius to world for the cull margin.