Eve library

phase-155.md

Tracker

Revision 1

On this page

Historical task source. The Eve task board holds current task state.

Phase 155: Neith Curves-Based Hair & Grooming System — Blender 4.x Curves Hair / Maya XGen / Houdini Grooming / Ornatrix / Yeti / Weta Barbershop Parity#

Closes the hair/fur sovereignty gap. Phase 138.7 lists "XGen/Ornatrix-class hair grooming" and Phase 71 covers 3D generation, but neither plans a curves-primitive groom authoring system — the curve-based hair workflow that Blender 4.0+ introduced and that replaces the legacy particle-hair paradigm across DCCs. This phase delivers sovereign curves-based hair as a first-class geometry type with grooming brushes, simulation, and shading integration (Phase 154 / Phase 138).

Sovereign replacement for Blender Curves Hair (4.x), Autodesk Maya XGen Interactive, SideFX Houdini Grooming / KineFX hair, Ephere Ornatrix, Peregrine Labs Yeti, Weta Barbershop, Groom for Unreal, HairStrand Designer, and Arnold aiStandardHair / RenderMan PxrMarschnerHair.


155.1 @neith/hair-curve — Curve Primitive & Data Model#

  • 155.1.1 Curve geometry object (control points + weights)
  • 155.1.2 Bezier / Catmull-Rom / B-Spline / Poly types
  • 155.1.3 Per-curve attribute (root, tip, id, tag)
  • 155.1.4 Per-point attribute (position, radius, tangent, colour)
  • 155.1.5 Curve-as-geometry first-class type in scene graph
  • 155.1.6 Curves live on surface (uv-based root anchor)
  • 155.1.7 Root detach / reattach operations
  • 155.1.8 Curve sets (layered groups)
  • 155.1.9 Instance from curve (feather, scales, leaves)
  • 155.1.10 Curve-level LOD (control-point decimation)
  • 155.1.11 Unlimited curve count (100M strand scenes)
  • 155.1.12 USD curves / Alembic / MDD interchange <!-- USD BasisCurves and MDD plus optional SDK-backed Ogawa ICurves/ OCurves in interchange/alembic.rs; the native roundtrip is exercised against Unreal 5.5's Alembic 1.8.6 deployment -->
  • 155.1.13 FBX approximation exporter <!-- sovereign FBX 7.4 ASCII NurbsCurve exporter in interchange/fbx.rs; the FBX SDK is only needed for binary .fbx / verified re-import -->
  • 155.1.14 Hair .abc spec compatible with Arnold / RenderMan <!-- standard OCurves positions/counts, basis, wrap, vertex widths and uniform identity parameters, verified with the Alembic C++ reader -->
  • 155.1.15 Per-frame deform caching

155.2 @neith/hair-groom — Grooming Brushes & Tools#

  • 155.2.1 Add / remove strand brush
  • 155.2.2 Comb / direction brush
  • 155.2.3 Length (grow / trim) brush
  • 155.2.4 Density dial brush
  • 155.2.5 Clump brush with soft-core
  • 155.2.6 Smoothing brush
  • 155.2.7 Puff (root lift) brush
  • 155.2.8 Frizz / noise brush
  • 155.2.9 Part line brush (scalp parting)
  • 155.2.10 Curl brush with radius + frequency
  • 155.2.11 Twist brush
  • 155.2.12 Pose mode brush (sculpt while posed)
  • 155.2.13 Mask layer brush
  • 155.2.14 Snap-to-surface brush
  • 155.2.15 Mirror across symmetry plane

155.3 @neith/hair-nodes — Geometry-Node Graph for Curves#

  • 155.3.1 Generate curves from surface (face density)
  • 155.3.2 Generate from density map
  • 155.3.3 Interpolate guide → dense
  • 155.3.4 Trim curves
  • 155.3.5 Resample curves to N points
  • 155.3.6 Bend to face normal
  • 155.3.7 Set radius by random / attribute / length
  • 155.3.8 Noise offset (turbulence along curve)
  • 155.3.9 Curl primitive (helical)
  • 155.3.10 Clump to N nearest guides
  • 155.3.11 Braid generator (N plaits)
  • 155.3.12 Frizz at root / mid / tip blend
  • 155.3.13 Convert mesh-ribbon → curve strand
  • 155.3.14 Hair-cap stitch (connect strand groups)
  • 155.3.15 Transfer attribute from mesh to root
  • 155.3.16 Stamp / scatter instance on curve
  • 155.3.17 Split curves at collision
  • 155.3.18 Curve-bevel for stylised ribbon hair
  • 155.3.19 Coarse / fine LOD switcher
  • 155.3.20 Node group presets (afro, straight, curly, feather, fur)

155.4 @neith/hair-guide — Guide Curves & Interpolation#

  • 155.4.1 Guide curve mode (authored strands)
  • 155.4.2 Guide weight painting
  • 155.4.3 Blend N nearest guides
  • 155.4.4 Radial basis function interpolation
  • 155.4.5 UV-aware interpolation
  • 155.4.6 Feather symmetry (left / right mirror group)
  • 155.4.7 Drag-along-guides (move all dense curves with guide)
  • 155.4.8 Guide priority (layered grooms)
  • 155.4.9 Guide blending across animation frames
  • 155.4.10 Guide sculpt tools inherited from 155.2

155.5 @neith/hair-sim — Simulation & Dynamics#

  • 155.5.1 Cosserat rod / Discrete Elastic Rod model
  • 155.5.2 Position-based dynamics (PBD) strand
  • 155.5.3 Fast-Projection for stiff hair
  • 155.5.4 Bending / twisting / stretching stiffness
  • 155.5.5 Strand-strand self-collision (hash grid)
  • 155.5.6 Strand-mesh collision (body)
  • 155.5.7 Wind + turbulence forces
  • 155.5.8 Wet hair (clumping, mass increase)
  • 155.5.9 Material presets (thin / thick / kinky / straight)
  • 155.5.10 Simulation LOD (only every Nth strand)
  • 155.5.11 GPU solver (CUDA / HIP / Metal / WebGPU) <!-- canonical WGSL compute pipeline with validated ABI/dispatch plan; WebGPU cross-compiles it to Vulkan/Metal/HLSL and the backend trait exposes the same packed buffers to native CUDA/HIP implementations -->
  • 155.5.12 Multi-frame cache (bake + scrub)
  • 155.5.13 Bake direction reverse (inverse dynamics)
  • 155.5.14 Attached-prop collision (hat, hood)
  • 155.5.15 Animation-rig driven root deformation

155.6 @neith/hair-shade — Shading Integration#

  • 155.6.1 Marschner hair BSDF
  • 155.6.2 Chiang hair (Disney) BSDF
  • 155.6.3 Kajiya-Kay for stylised
  • 155.6.4 Melanin concentration + redness
  • 155.6.5 Root-to-tip colour gradient
  • 155.6.6 Per-strand colour noise
  • 155.6.7 UV parametric texture along strand
  • 155.6.8 Dirt / dye map
  • 155.6.9 Strand orientation AOV
  • 155.6.10 Strand-id Cryptomatte
  • 155.6.11 Viewport preview (Phase 154 EEVEE-class) <!-- non-destructive density/mode preview integrated with raster-hair -->
  • 155.6.12 Path-tracer integration (Phase 138) <!-- native curve primitives, analytic intersection and Marschner/Chiang evaluation -->
  • 155.6.13 LOD-aware shading (billboard at distance)
  • 155.6.14 Dual-scattering approximation
  • 155.6.15 Real-time engine (Phase 42) strand shader <!-- phase-42 GPU material/substrate/slab integration with hair flags and indirect draw -->

155.7 @neith/hair-render — Rendering & LOD#

  • 155.7.1 GPU strand rasteriser (tube + ribbon) <!-- exact CurveSet ingestion to indexed tube/ribbon geometry, GPU upload packet, render-graph depth/color passes and stable strand IDs -->
  • 155.7.2 Ray-trace strand intersection
  • 155.7.3 Order-independent transparency (OIT)
  • 155.7.4 Alpha-tested opaque mode (for shadows)
  • 155.7.5 Distance-LOD (strand → clump → card)
  • 155.7.6 Auto hair-card bake for game engines
  • 155.7.7 Billboard hair for backgrounds
  • 155.7.8 Motion-blur strand
  • 155.7.9 Shadow-only cheap pass
  • 155.7.10 Procedural LOD cross-fade

155.8 @neith/hair-presets — Groom Preset Library#

  • 155.8.1 Realistic human hair (70+ presets)
  • 155.8.2 Realistic animal fur (50+)
  • 155.8.3 Feathers (birds, dino)
  • 155.8.4 Scales / reptile
  • 155.8.5 Mossy / botanical fur
  • 155.8.6 Stylised / cartoon / anime hair
  • 155.8.7 Historical wigs
  • 155.8.8 Afro / textured coils (4A/4B/4C etc., diverse library)
  • 155.8.9 Beards & moustaches
  • 155.8.10 Braid / cornrow / locs preset
  • 155.8.11 Fantasy (elf / orc / troll)
  • 155.8.12 Hair accessories (band, clip, scrunchie meshes)
  • 155.8.13 Preset download + share (Phase 138.11 asset library) <!-- content-addressed versioned envelopes, asset records and resumable BLAKE3-verified out-of-order download chunks -->
  • 155.8.14 Rights-cleared source attribution
  • 155.8.15 Community contribution workflow <!-- marketplace lifecycle with independent review plus technical, rights and cultural-context moderation gates -->

155.9 @neith/hair-anim — Animation & Rigging#

  • 155.9.1 Rest-pose vs dynamic-pose modes
  • 155.9.2 Bake simulation → animation
  • 155.9.3 Keyframe hair shape
  • 155.9.4 Blendshape between grooms
  • 155.9.5 Motion-vector computation for post
  • 155.9.6 Control-curve drives multiple strands
  • 155.9.7 Lattice / mesh deform of groom
  • 155.9.8 Wind anim driver
  • 155.9.9 Hair-layer blend per frame
  • 155.9.10 Corrective shape after sim

155.10 @neith/hair-transfer — Cross-Mesh Transfer#

  • 155.10.1 Transfer groom to new mesh (UV projection)
  • 155.10.2 Transfer with auto-scale
  • 155.10.3 Cross-topology transfer (non-matching UV)
  • 155.10.4 Retopology compat (preserve groom after retopo)
  • 155.10.5 Morph-target resync
  • 155.10.6 Groom-pack bundle (mesh + curves + attrs)
  • 155.10.7 Fit-check tools (hair-scalp penetration)
  • 155.10.8 AI-assist ("give me a similar groom on a new head") — the deterministic transfer primitive is provided. The AI-assist is a learned model; needs an owner decision on a compute and data budget to train it (stated 2026-09-18). blocked:governance
  • 155.10.9 Cross-character rig retarget groom
  • 155.10.10 Part-line relocation algorithm

155.11 Testing & Validation#

  • 155.11.1 1M-strand realtime viewport edit: measure on the Mac's GPU (a real target GPU; GPU convention). (Blocker made visible 2026-09-18: the prior HTML comment said this needs a target-GPU performance run.) Verify: an interactive edit of a 1M-strand groom on the Mac records the per-edit viewport frame time, targeting realtime (≤ 33 ms), with the achieved time recorded and a regression guard.

  • 155.11.2 100M-strand offline render — needs a target-hardware performance run. 100M strands is memory-bound well beyond the 16 GB MacBook Air and the GPU-less Linux server; it needs a high-memory GPU workstation the fleet lacks (stated 2026-09-18). blocked:hardware

  • 155.11.3 Simulation stability at 24 FPS deterministic

  • 155.11.4 USD curves roundtrip conformance <!-- interchange/usd.rs export→import is lossless (positions/ids/order/ attrs/layers exact, width⇄radius is an exact ×2 scale); verified by roundtrip_is_lossless + all_bases_and_periodic_wrap_roundtrip -->

  • 155.11.5 Alembic curves roundtrip <!-- mixed bases, widths, IDs, ordering, attributes and layers roundtrip through Alembic 1.8.6 OCurves -> ICurves -->

  • 155.11.6 Marschner / Chiang BSDF visual validation: validate the hair BSDF against the analytic Marschner and Chiang reference models from the published papers (not against Arnold, which is licensed). (Blocker made visible 2026-09-18.) Verify: a spec evaluates the BSDF over a set of incidence/azimuth angles and asserts it matches the analytic Marschner R/TT/TRT lobe energies and the Chiang model within a stated tolerance, and renders a reference-angle image matching a golden.

  • 155.11.7 Groom transfer across 100-head test set

  • 155.11.8 Diverse afro / coily texture fidelity tests

  • 155.11.9 Real-time engine (Phase 42) integration at 60 FPS with 200k strands: the phase-42 strand shader exists; measure it on the Mac's GPU in a Maya-engine scene. Verify: a 200k-strand groom renders in a Maya-engine scene on the Mac recording ≤ 16.6 ms/frame, or the achieved frame time is recorded as the baseline with a regression guard.

  • 155.11.10 Phase 162 MetaHuman-class groom interop <!-- attached groom binds into authored scalp tangent frames and reconstructs every point after deformation while preserving IDs/basis/radii/attrs -->