The colors zarr array.
Item ranges to load (splats / vertices etc).
Shared encoding-dispatch loader.
Store used to resolve array_ref targets.
Caller tag for the array_ref resolution log line.
OptionaltargetBuffer: ColorBuffer
Optional pre-allocated buffer (zero-allocation path).
End-to-end load for a colors array, encoded or unencoded, with native-type preservation and original_dtype restoration. Composes the helpers above to reproduce the load-color flow the geometry loaders run (points, lines, gsplats).
Branches:
rgb_uint8/rgb_uint16encoded colors with a target buffer of the matching kind: skip the decode pipeline and stream raw bytes directly (downstream renderer normalizes 0-255 → 0-1).zarrStore, then cast back tooriginal_dtypeif the encoding records one.Channel count (3 = RGB, 4 = RGBA) is read from the array shape — the optional alpha column is per-element opacity (see VOLUMETRIC_BLENDING_SPEC.md). Use colorComponentsOf to learn which layout a loaded buffer uses.