@chestnutlabs/gcode-colors
Renderer-agnostic per-segment color model for the Chestnut Labs G-code Preview toolpath stack (DD-014 D3).
This package is the single home for the toolpath color subsystem: the ColorMode union and an
honest, capability-gated mapping from a ToolpathIR segment to an RGB triple. Both the Three.js
renderer (@chestnutlabs/gcode-renderer-three) and the low-resource 2D renderer
(@chestnutlabs/gcode-renderer-2d) depend on it, so color and move-kind semantics never drift
between them.
It depends only on @chestnutlabs/toolpath-core — no three, no canvas, no framework.
Color modes
| Mode | Channel | Honest fallback |
|---|---|---|
single | — | n/a (one color) |
tool | segments.tool | fallback when no palette |
feature | segments.feature (0 = unknown) | fallback for unknown / no palette |
colorChange | colorChanges[] swap slot (M600, #147) | fallback when no changes / no palette |
feedrate | segments.feedrate (mm/min; NaN = unknown, #177) | fallback for NaN |
object | segments.object (1-based; 0 = none, #178) | fallback for none / non-only |
Every mode degrades to its fallback for unknown channel values — it never fabricates a
role/speed/object color. Modes that read an optional channel (feature, object, feedrate) must
be capability-gated by the caller before use.
Usage
import { createSegmentColorer } from '@chestnutlabs/gcode-colors';
// Build a colorer once (feedrate auto-range is resolved here), then O(1) per segment.
const colorOf = createSegmentColorer(ir, { mode: 'feedrate', ramp: [[0, 0, 1], [1, 0, 0]], fallback: [0.7, 0.7, 0.7] });
for (let i = 0; i < ir.segments.count; i++) {
const [r, g, b] = colorOf(i);
// …map onto your surface (WebGL vertex buffer, Canvas 2D strokeStyle, …)
}
License
MIT © Chestnut Labs. See the repository for provenance and the full support policy.