GroomLab

Quick start

Create a groom on a scalp mesh, place and comb guides, generate child guides and add look nodes.

Create a groom

Select the scalp mesh and choose GroomLab > Create Groom from Selection.

No mesh yet? GroomLab > Add Sample Mesh (or the button under Create Groom from Selection in Groom Tools) adds Nika (a head and shoulders), Manny (a head), a sitting wolf or Buddy, a posable cartoon character rig, already selected. Buddy's body is selected: groom it, then pose the rig with its controls (head_CTL, the arms, the fingers...) and the hair follows (see Follow the scalp). All are free to use, commercially too, with credit: "Nika head by Nick Rutlinh (GroomLab), CC BY 4.0", "Manny head by Nick Rutlinh (GroomLab), CC BY 4.0", "Wolf by Nick Rutlinh (GroomLab), CC BY 4.0" or "Buddy by Nick Rutlinh (GroomLab), CC BY 4.0".

This creates a groom node with a default graph, scaled to the scalp's size: Scalp → Scatter → Interpolate ← Guides → Length → Noise → HairColor → Width → Resample → Output. The viewport draws 10% of the strands (previewDensity). The preview is a subset of the render strands, not a separate low-density groom, so clumps and curls look the same at any preview density.

Open the Groom Tools

GroomLab > Groom Tools docks beside the viewport. The Tools tab lists the brushes as icons; the active brush's settings are shown below the tabs.

Place guides

Pick Place and click on the scalp, or drag to place several. A new guide takes the shape of the guides near it, and the strands update as you work.

Shape them

Shape the guides with Comb, then refine them with Smooth, Lift, Swing, Attract and the other shaping brushes. Stretch lets Comb change guide length. Hold B (radius) or M (strength) and drag to resize the brush. Shift+drag over guides to select them (all other guides freeze); Ctrl does the brush's opposite (Length shortens, Lift lays down). See Guides & brushes.

Add children

Select some guides and choose Edit Guides > Children under Guide groups. Child guides are generated inside each parent's tube and stored relative to the parent, so they follow it when you edit it.

Build the look

Open GroomLab > Graph Editor. Add Node inserts a node after the selected one; drag between ports to connect nodes. Add a Clump, then a Curl, or load a look from Presets. See Node graph.

The Graph Editor
The Graph Editor

The same in Python

from maya import cmds
import groomlab

groom = groomlab.create_groom("head")
groomlab.generate_children(groom, "primary", name="children", count=8)
cmds.setAttr(groom + ".previewDensity", 1.0)

Errors

Evaluation errors (a missing map, an expression that does not parse, invalid guide data) are reported in the Graph Editor's status bar, in the Script Editor and by groomlab.errors(groom).

On this page