Interface LayerInfo

Zarr path (e.g. "group/channel_gfp") — used as unique key

Display name (last segment of path)

Geometry type the user sees this layer as. For specialized groups (kind=lod / kind=partition), this is the resolved display_type attr from disk — not 'group'.

Specialized-group kind, if the underlying scene-graph node is a kind=lod or kind=partition Group. Drives the layer-header badge and the inline LOD-level dropdown.

Whether the layer is visible in the scene

Opacity (0–1)

Absorption coefficient κ (≥ 0; only meaningful in volumetric mode)

Mesh shade floor (0–1) — the §6.2 wrapped-diffuse ambient. Only meaningful on a mesh layer, where it is what keeps a silhouette readable rather than black; 1.0 removes the diffuse gradient; specular remains independently controlled.

Mesh wrapped-diffuse falloff exponent (> 0) — the §6.2 shade_exponent. 1.0 is the plain linear wrap. Mesh-only, like the three around it.

Mesh additive specular strength (0–1).

Mesh specular highlight exponent (> 0).

Mesh shading capability for the layer controls. Only none is authoritative; smooth versus flat ignores the material's view-dependent normal-frame check.

Which material family a mesh layer renders with. 'luxar' (the house shader, and what every non-mesh layer carries) shows the shading sliders; 'physical' hides them and shows the physicalKnobs sliders instead.

The LIVE physical knobs in material space, seeded from the authored attrs and knob defaults. Slider mapping is presentation-only, so values beyond a finite track remain intact. Absent for every non-physical layer.

Mesh opaque-mode cutout threshold (0–1) — the §6.2 alpha_cutoff.

Only meaningful in opaque, which is a NARROWER condition than the other four (they apply in every blending mode when shading is lit), so the panel gates its slider on the mode as well as the type — the same shape as absorption's volumetric gate.

Current display-range minimum (maps to intensity+offset in shader)

Current display-range maximum

Slider lower bound. Wide enough to reach every window the layer can usefully take: the mode's default (scalar range / identity), the authored intensity/offset window, and — for a direct-colour layer — its color_data_range, so "stretch these colours" stays one drag away.

Slider upper bound (see LayerInfo.dataMin).

Gamma correction value

Blending mode

Whether this layer OWNS a blend mode — authored on the node ITSELF on disk, or chosen by the user via the panel. When false, blendingMode is merely the inherited/defaulted value shown in the dropdown, and the layer must not act as a blending_mode SETTER: liveLayerAttrs emits the attr only when this is true (a plain group layer would otherwise push its additive placeholder onto a mesh leaf and bury the mesh's own opaque default — #1272), and composeEffective's subtree-drop fires only when this is true (a wrapper owning no mode has no control value to impose, so it must not suppress a descendant's authored mode — #1275).

Deliberately the node's OWN attr, not the composed ancestry: a layer that merely INHERITS an ancestor's mode must not re-emit it as its own setter — the panel snapshot would go stale the moment the ancestor layer's live pick diverges from disk, and the re-emitted copy (being nearer the leaf) would shadow the ancestor's newer choice.

Effective cross-layer draw order (LAYER_ORDER_SPEC.md), including an inherited value, or undefined when the ancestry states none. Higher = nearer the camera = drawn later.

Effective order inherited from ancestors when this layer owns none.

Whether the level is EXPLICIT — the node's OWN attr, or a user pick in the panel — as opposed to inherited or absent. Same reasoning as blendingModeExplicit: re-emitting an inherited level as this layer's own would change which node owns the setter and make clearing the ancestor no longer restore auto here.

Whether this layer is selected in the list

Present on type === 'sound' layers only.

Active colormap name (undefined = direct RGB colors)

Whether this node supports colormap (has scalars or amplitudes)

Exact categorical vocabulary exposed by gsplat label_ids.

Render deterministic categorical colours instead of authored RGB.

Exact class id selection; undefined shows all classes.

Scalar data range for colormap normalization

Authored RGB spread (color_data_range). Never the starting window — see LayerInfo.dataMin — but kept so a colormap toggle can restore the direct-colour slider bounds, symmetric with LayerInfo.scalarDataRange.

Whether the current display window is a SCALAR window (a colormap is in play for the layer — on the node or a descendant) rather than an authored-RGB one. LayerApplyEngine.applyComposed routes on this per leaf: a leaf the C1 guard keeps on direct colour must NOT receive the scalar window as a colour gain (a mixed group layer contains both kinds). Follows the colormap toggle via LayerStateManager.setColormapWindow.

For kind === 'lod' layers: number of child levels. Drives the "Active level" dropdown's option count and the "N LODs" badge. Absent for non-LOD layers.

For kind === 'partition' layers: number of BSP child parts. Drives the "N parts" badge on the layer header. Absent for non-Partition layers.

For kind === 'partition' layers that wrap kind=lod descendants: absolute paths of every nested lod_group in the subtree. The "Active level" dropdown on the wrapper broadcasts to every path (clamped per-group by LODGroupRegistry.setSelectorMode on ragged ladders). Absent for non-Partition layers and for Partition layers with no nested LODs.

Also used to compute the [N parts × M LODs] combined badge: when this list is non-empty, M is the maximum child count across nested groups (matches the dropdown's "highest level offered" affordance).

Maximum LOD child count across the layer's nested lod_groups. Used by the dropdown to size its option list and by the combined badge. Absent unless nestedLodGroupPaths is non-empty.