GroomLab

Presets

The shipped graph presets (hair, fur, feathers, scales, motion, techniques, add-ons), how they scale to your scalp, inserting a preset as a compound, saving your own and sharing a graph as text.

In the app and in Blender

App: the Presets pill beside the Graph pill (or View > Graph Presets, or Start from a preset on the start card). Each preset has Apply and Insert after selected node; Save as Preset..., Copy Graph and Paste Graph are in the same menu (GroomLab app).

Blender: Presets in the Graph Editor's header, in the sidebar's GroomLab tab and in the top bar's GroomLab menu, with apply and insert as here. Create Groom from Selection asks for a preset to start from (Blender).

Load one

In the Graph Editor, Presets lists the presets by category. Hover a preset for a one-line description; pick it to load its graph, laid out left to right (backdrops label the branches of the technique presets).

  • Scaled to the scalp. The hair presets are built on a 20 cm head, the fur presets on a wolf-sized body (100 cm). On a larger or smaller scalp, lengths and widths are scaled with its size, densities with its area, and curl frequency (turns per centimeter) inversely, so the look is the same on any size of scalp.
  • Clumps sized by distance. Clumps are sized in centimeters (Clump's clumpBy size), so a whole body gets more clumps than a head at the same clump size.
  • Guides required. Most presets interpolate from your guides; place or comb a few first. The fur presets marked "no guides" follow flow arrows instead.
  • Descriptive node names. For example, frizzNoise is a Noise applied to a fraction of the strands (frizz is a Noise setting, not a separate node); curlsControl is a slider on the groom.
  • Insert instead of replace. Each preset's submenu has Apply (replaces the graph) and Insert After Selected Node: the preset's look (every node between its sources and its Output) is inserted as one Compound after the selected node (or before the Output), scaled to your scalp, in one undo step. The Add-ons below are small looks meant for this.
  • Exposed controls. An inserted Compound shows the look's main parameters on its own panel (clump strength and count, noise, curl, color, width, depending on the preset), with the same groups, units and sliders as the nodes inside. Edit, key or save them like any parameter; they set the nodes inside.

Hair

PresetWhat it shows
hair_basicsThe basic chain: Scatter, Interpolate, soft clumps, a little noise, brown color, tapered width.
cinematic_hairA detailed hero look: large locks with finer clumps inside them, restrained noise, frizz on a few strands near the tips, a few flyaways, uneven lengths and widths, color variation.
curlyRinglets: small clumps curled together (Curl with coherence clump), a little frizz, and the segments curls need.
braidsBox braids without drawn paths: the Braid node places one braid per 2.6 cm of scalp (braidSpacing).
braids_beadedBox braids sealed at the ends with beads and cuffs near the tips: the braid's ties and an Instance node on them (beadsPerBraid, beadSpacing, cinch).
braids_curly_endsBox braids tied off near the end, the ends below the tie curling: a Curl mapped by the Braid's braidTail channel (curlyLength, curlFrequency).
braids_twistsTwo-strand twists all over the head: the Braid's rope style (plies 3 for three-strand twists).
braids_cornrowsCornrows along rows you draw: each row picks up the hair on its sides into every crossing, hanging as braids past onTheHeadUntil, a bead at each end.
braids_frenchA French braid along one path you draw down the back, fed from both sides, tied off at the end (dutch for a Dutch braid).
braids_looseA loose braid along one path you draw: pulled apart (pancake), sections looping out of it and back (loops, loopSize).
braids_fishtail_ponytailA fishtail ponytail from one path you draw from its base: all the hair sweeps into it, tied at the base and the end.
parted_styleA part drawn with the Part tool, respected by Interpolate and Clump.
tube_locksTube locks (anime): stylized locks shaped as a whole. Interpolate's Fill Tubes (with a soft edge) fills each guide's tube, soft clumps follow the tubes, a little noise, tapered tips. Place guides, then shape their tubes with the Shape brush (see Tube guides).

Fur

PresetWhat it shows
creature_furFur for a whole animal, laid by flow arrows (no guides): soft tufts about a centimeter across, lighter tips.
agouti_furThe creature fur in wild-type bands (a Bands node after HairColor): dark roots, a pale band, black tips, a plain undercoat.
white_woolDense, crimped white fleece in soft locks: a picked off-white (HairColor's color mode), white tips.
flow_with_guidesFur along the flow, and your guides (clumped) where you paint the guideAreas map white: tufts, a ruff, a mane. The map is made for you, black (all fur).

Feathers

feathers_contour, feathers_down, feathers_flight, feathers_afterfeather and feathers_barred (bars, iridescence and a downy base: Color patterns): one per design of the Feathers tool, each as a Compound with its main params exposed. feathers_afterfeather shows branching inside a design: the vane, a fluffy base and its barbules are three Propagates on the same shafts, each with its own HairColor, joined by Merge. feathers_spotted, feathers_eye_spot and feathers_iridescent are stylized color patterns of the barred design. layered_feathers lays the contour design's feathers over one another and off the body with a Plume node. hand_placed_feathers (Flight feathers (hand-placed)) starts a wing or tail by hand: it makes an empty feathers guide group and picks the Draw tool drawing into it, and every guide you draw is one flight feather (Hand-placed flight feathers). See Fur & feathers.

Scales

PresetWhat it shows
dragon_scalesScales placed by strands: combed down the body, larger on the back, green with darker tips, keeled plates on the back and shields on the belly, overlapping and conformed to the skin.
scales_from_guidesScales pointed by your guides through Interpolate: comb or brush the guides and the scales turn with them. A Bend lays them down the body until you place guides.
scales_from_flowScales pointed by flow arrows, no guides: draw flow arrows with the Flow tool and the scales follow.
swept_spikesSpikes or quills that bend with the guides: long, narrow plates in the Scales node's follow strand, based on the skin and bent along their strands' curves.

Motion and games

PresetWhat it shows
everyday_simShoulder-length hair whose guides are simulated with calm settings. Play the timeline.
wind_and_jiggleWind and Jiggle after the look, before Collide. Play the timeline.
game_cardsA Cards node at the mid level of detail: Show cards, Bake Maps, export.

Techniques

PresetWhat it shows
expression_drivenExpressions: longer hair at the crown (a keyable variable), harder clumps on long strands.
painted_mapsOne color map, three masks: R clumps, G frizz, B length. The map is made for you.
blend_two_looksBlend mixes a sleek and a curly look; its mix is the keyable ctl_curls. Key it to animate.
merge_layersLayers, compounds and switches: a sparse layer of longer, wavy strands with its own Scatter (its waves packed in a Compound with its own sliders), merged onto the base; a Switch picks the full look or a light one.
vine_leavesThe Instance node: leaves along curling vines, each bent along its vine (deform alongStrand). Pick your leaf with Prototype from Selection.

Add-ons

Small looks meant for Insert After Selected Node; each adds one effect to an existing groom. They can also be applied on their own.

PresetWhat it adds
wetTight clumps and a darker color, for hair just out of water.
frizzKinky noise on a share of the strands, growing toward the tips.
flyawaysA few strands leave the flow near the tip and stand out.
cards_midA Cards node at the mid level of detail; insert it before the Output.
gravityStrands hang under their weight, stiff at the root (a Collide after it keeps them off the scalp).
two_tone_tipsA picked root color (a skin tone) blending to white tips, each strand a little lighter or darker (Color patterns).

Save your own

Presets > Save as Preset... saves the graph, its layout and its compounds to your presets folder. Your presets appear at the top level of the menu. From Python:

from groomlab import presets
presets.save_preset(groom, "my_look", about={"title": "My look", "category": "Hair",
                                             "description": "Wavy, for the lead."})
presets.apply_preset(other_groom, "my_look")

Studios can share presets through the GROOMLAB_PRESET_PATH environment variable.

Choose what an inserted preset shows

A preset file may list the params its Compound shows when inserted, in an "exposed" field:

"exposed": [
  {"node": "clump", "param": "strength", "name": "clumpStrength"},
  {"node": "color", "param": "melanin", "name": "melanin"},
  {"node": "width", "param": "width"}
]

Each entry names a node of the look and one of its params; name is what the Compound calls it (the param's own name when left out, or node and param together, clumpStrength, when the Compound has that name already). Entries naming a node outside the look (its Scatter or Guides) are skipped. The panel lists them in the look's order, each with its node's slider range, unit and group. Every shipped preset with a look lists 1 to 8.

A preset without the list (for example one saved from a graph) exposes a default selection: one param per look node for up to six nodes, prioritizing clumps, curls, noise, braids, tangles, flyaways, gravity, combs, length, color and width, and using each node's first plain numeric param (not an advanced one, and not one driven by a map, a port or a key).

Share a look as text

Presets > Copy Graph copies the groom's graph to the clipboard as JSON text, in the same format Save as Preset writes, titled after the groom, in the "Shared" category, plus its control values ("controls"). It can be pasted in a chat, a forum or an email.

  • Paste Graph puts copied text on the groom shown, fitted to its scalp, in one undo step. Text in a code block (```json) works too.
  • Saved as a .json file in a presets folder, the text is a preset like any other: it shows under Shared, and loading it sets the control values too.
  • Not included: painted maps, keys, referenced files and scene meshes are not part of the text. The status bar lists what the target groom lacks; those nodes use their defaults.
text = groomlab.copy_graph_text(groom)
report = groomlab.paste_graph_text(other_groom, text)
print(report["message"])

On this page