ribbon
set 2× in templates and rigs
A line through `points` on a smooth curve that draws itself on: the `head` and `tail` channels set the stretch that shows, so it writes like a pen, traces a route or runs as a comet. A pen stroke is `material=basic` with `color`; a light line is a dark `color` with the hue in `emissive`. Its width is even along the line.
ribbon(color=#ffffff material=basic points=…)
Attributes
colorcolour #rrggbb2×materialtext`standard` (default), `physical` or `basic`; `basic` is unlit, so `color` is exactly the ink.2×pointsnumbersThe points the line passes through, `x y z, x y z, …` in mm.2×radialnumberSegments around the tube (default 12).2×radiusnumberHalf the line's width, mm (default 2).2×segmentsnumberSamples along the line (default one per 4 mm, 64 to 2400): raise it for sharp detail such as a spike.2×blendingtext0×emissivecolour #rrggbbThe glow colour; the glow recipe is a dark `color` with the hue in `emissive`.0×emissive-intensitynumber0×headnumberWhere the stretch that shows ends, a fraction of the line's length, 0 to 1 (default 1).0×head-sizenumberRadius of a bright bead riding the head, mm (default 0, none).0×line-lighttrue / false`true` lights the scene along the line with real rect area lights, one per chord, following the trim; standard and physical materials only, no shadows, one-sided. `line-light-segments` (at most 6 by default), `line-light-intensity` (60 × emissive-intensity), `line-light-face` (`0 -1 0`), `line-light-height` (12 mm).0×line-light-face"x y z"0×line-light-heightnumber0×line-light-intensitynumber0×line-light-segmentsnumber0×metalnessnumber0×roughnessnumber0×tailnumberWhere the stretch that shows starts, a fraction of the line's length, 0 to 1 (default 0).0×wire-aatrue / false`true`: the tube is never drawn thinner than about 1.5 px, and the width it lacks comes back as transparency, so a far thin line fades instead of breaking into dashes. Off by default.0×