hair.module

Grows strands over the surface of the mesh an entity draws.

grow(id, options) samples roots area-weighted across the triangles inside the region, marches a ribbon out of each along the surface normal, and files the result as a mesh on a child entity. Every vertex carries the strand's direction as its tangent — the axis the fibre highlights are taken around — and its root-to-tip shade as its colour. Returns the strand, vertex and triangle counts.

clear(id) takes the strands and their material with it. groom(id) reports what a groom was grown with, stats(id) what it built, list() every entity carrying one, and budget() what one groom may spend.

Growing is reproducible: the same entity, options and seed give the same strands.