Eve library

phase-156.md

Tracker

Revision 1

On this page

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

Phase 156: Neith Grease Pencil-Class 2D-in-3D Animation — Blender Grease Pencil / Adobe Animate 2D-in-3D / Toon Boom Storyboard 3D Parity#

Closes the 2D-in-3D sovereignty gap. Phase 141 ships a sovereign 2D animation suite (Toon Boom / TVPaint / Moho). Phase 44 covers general DCC creative tools. Neither delivers Blender Grease Pencil — the unique 2D-stroke-object-living-inside-3D-space paradigm that film, motion graphics, previs, and animation teams rely on for storyboarding, concept art-in-3D, hybrid 2D/3D animation, and layout-quality line art.

Sovereign replacement for Blender Grease Pencil (all versions incl. 4.x), Toon Boom Storyboard Pro 3D mode, Adobe Animate 3D workspace, Moho 2D-in-3D, Quill VR illustration / Open Brush / Tilt Brush (spatial-stroke portion), Pencil+ line rendering, and in-3D sketch tools inside Maya / Cinema 4D.


156.1 @neith/gpen-object — Grease Pencil Object & Data Model#

  • 156.1.1 GPencil object type in scene graph
  • 156.1.2 Layer hierarchy (per-object)
  • 156.1.3 Frame list per layer (keyframe 2D)
  • 156.1.4 Stroke primitive (ordered 3D points + radius + pressure)
  • 156.1.5 Per-point pressure / strength / uv / vertex-colour / time
  • 156.1.6 Fill stroke (closed triangulated region)
  • 156.1.7 Material slot per stroke
  • 156.1.8 Stroke-group tag
  • 156.1.9 Onion-skin settings per layer
  • 156.1.10 Frame-interpolation (inbetween shape-key on strokes)
  • 156.1.11 Object parenting + constraints
  • 156.1.12 Modifier stack on GPencil
  • 156.1.13 Shape-keys per stroke (deformable 2D)
  • 156.1.14 Stroke-level lock / visibility
  • 156.1.15 USD custom-prim exporter

156.2 @neith/gpen-tools — Draw / Fill / Sculpt / Edit Modes#

156.2.1 Draw#

  • 156.2.1.1 Pressure-sensitive brush with tilt
  • 156.2.1.2 Airbrush / pencil / pen / marker / ink brushes
  • 156.2.1.3 Stabilizer (lazy mouse / pulled string)
  • 156.2.1.4 Post-stroke smooth
  • 156.2.1.5 Stroke thickness from pressure + jitter
  • 156.2.1.6 Brush texture (paper / canvas / dry brush)
  • 156.2.1.7 Mirror draw symmetry
  • 156.2.1.8 Lasso / curve / polyline draw modes
  • 156.2.1.9 Draw on surface (3D mesh depth snap)
  • 156.2.1.10 Draw on plane (camera / front / cursor)
  • 156.2.1.11 Guided draw (straight / arc / circle / polygon)
  • 156.2.1.12 Vanishing-point perspective guide
  • 156.2.1.13 Multi-finger tablet draw
  • 156.2.1.14 Pressure curve editor
  • 156.2.1.15 Auto-close open stroke

156.2.2 Fill#

  • 156.2.2.1 Flood fill inside closed region
  • 156.2.2.2 Boundary-gap tolerance
  • 156.2.2.3 Fill by colour-match
  • 156.2.2.4 Texture / pattern fill
  • 156.2.2.5 Gradient fill (linear / radial / angular)
  • 156.2.2.6 Vertex-colour paint
  • 156.2.2.7 Fill material assignment
  • 156.2.2.8 Hole detection + mask
  • 156.2.2.9 Layer-ordered fill (under / over)
  • 156.2.2.10 Auto-fill from outline layer

156.2.3 Sculpt / Edit#

  • 156.2.3.1 Smooth brush
  • 156.2.3.2 Thickness brush
  • 156.2.3.3 Pinch / grab / twist / randomise brushes
  • 156.2.3.4 Multi-point select
  • 156.2.3.5 Bend / taper / warp operators
  • 156.2.3.6 Proportional edit
  • 156.2.3.7 Subdivide stroke
  • 156.2.3.8 Simplify / decimate stroke
  • 156.2.3.9 Bone-hook for rig-driven strokes
  • 156.2.3.10 Cut / trim / break stroke

156.3 @neith/gpen-anim — 2D Animation Workflow#

  • 156.3.1 Key / breakdown / inbetween frame modes
  • 156.3.2 Onion-skin (prev/next frames with fade)
  • 156.3.3 Frame ghost across multiple layers
  • 156.3.4 Dope sheet for strokes
  • 156.3.5 Time-offset modifier
  • 156.3.6 Frame hold + loop + ping-pong
  • 156.3.7 Interpolate between strokes (Hermite / Catmull)
  • 156.3.8 Auto-inbetween across key poses
  • 156.3.9 Exposure sheet (X-sheet) export to Phase 141
  • 156.3.10 Animation curve editor for shape-keys
  • 156.3.11 Motion-path visualise per stroke
  • 156.3.12 Lip-sync attach (mouth shapes from audio, Phase 141 integration)
  • 156.3.13 Walk-cycle preset library
  • 156.3.14 Storyboard-to-animatic promotion
  • 156.3.15 Beat-mark from audio track

156.4 @neith/gpen-modifier — GPencil Modifier Stack#

  • 156.4.1 Array / build / subdivide modifiers
  • 156.4.2 Mirror / lattice / hook modifiers
  • 156.4.3 Opacity + thickness modifiers
  • 156.4.4 Offset / noise / smooth modifiers
  • 156.4.5 Shrinkwrap to 3D mesh
  • 156.4.6 Armature modifier for 2D rigs
  • 156.4.7 Multiply / fan-out modifier
  • 156.4.8 Length / tint / hue modifiers
  • 156.4.9 Simplify modifier for optimisation
  • 156.4.10 Time-offset modifier
  • 156.4.11 Build-out trail modifier (animated growth)
  • 156.4.12 Geometry-follow modifier
  • 156.4.13 Dot-dash modifier
  • 156.4.14 Weight-proximity modifier
  • 156.4.15 User-scripted Python / Rust modifier

156.5 @neith/gpen-lineart — Line Art Generator from 3D#

  • 156.5.1 Edge-contour from 3D mesh
  • 156.5.2 Crease / material / smooth edges
  • 156.5.3 Intersection edges across meshes
  • 156.5.4 Silhouette from view direction
  • 156.5.5 Chain strokes with angle threshold
  • 156.5.6 Baked per-frame update
  • 156.5.7 Live line-art (viewport update)
  • 156.5.8 Occlusion levels (through N layers)
  • 156.5.9 Per-object line-art override
  • 156.5.10 Noise / hand-drawn offset
  • 156.5.11 Colour from material
  • 156.5.12 Style-per-edge (dash / dot / continuous)
  • 156.5.13 GPU acceleration — real wgpu compute backend (gpu::GpuLineArt, gpu feature) dispatches contour_classify.wgsl (one invocation per edge, reproducing classify_edge in WGSL) over the CSR ContourGpuInput; output proven identical to the CPU classifier (parity test ran on the GPU adapter — llvmpipe headless, discrete GPU where present). WGSL naga-validated in every build; contour_edges_tiled remains as the rayon-ready CPU path
  • 156.5.14 Bake to GP object for hand-edit
  • 156.5.15 Cross-reference Phase 154 NPR output

156.6 @neith/gpen-shade — Materials & Rendering#

  • 156.6.1 Stroke-only, fill-only, both material modes
  • 156.6.2 Solid / gradient / texture / pattern shader
  • 156.6.3 Lit stroke (respond to scene lights)
  • 156.6.4 Shadow-casting strokes
  • 156.6.5 Stencil alpha
  • 156.6.6 Mix-mode (multiply / screen / overlay)
  • 156.6.7 Per-vertex colour
  • 156.6.8 Stroke variation along length
  • 156.6.9 GPU-rendered with MSAA — real wgpu compute rasterizer (gpu::GpuRasterizer, gpu feature) renders capsule strokes + fill triangles one-invocation-per-pixel via raster_msaa.wgsl, reproducing the CPU coverage/blend/AOV rules; output proven equal to the raster.rs reference within rasterization tolerance across 1/4/8 samples + all blend modes (parity test ran on the GPU adapter). WGSL naga-validated in every build; raster.rs remains the CPU reference path
  • 156.6.10 Depth-sorted vs screen-aligned
  • 156.6.11 Composite in Phase 135 (VFX Compositor)
  • 156.6.12 Export to PNG/EXR with alpha
  • 156.6.13 Render in offline path tracer (Phase 138)
  • 156.6.14 AOV for strokes + fills
  • 156.6.15 Cryptomatte per GP layer

156.7 @neith/gpen-rig — 2D Rigging#

  • 156.7.1 Armature skeleton for GP strokes
  • 156.7.2 Weight paint per point
  • 156.7.3 IK / FK chain
  • 156.7.4 Mesh-deform cage for strokes
  • 156.7.5 Expression rig (blendshape between mouth / eye shapes)
  • 156.7.6 Auto-rig from body template
  • 156.7.7 Pose library (pose-picker UI)
  • 156.7.8 Cut-out puppet with layer ordering
  • 156.7.9 Paper-doll mode (swap parts)
  • 156.7.10 Animation retarget from 3D skeleton

156.8 @neith/gpen-vr — VR / AR Spatial Drawing#

  • 156.8.1 VR stroke input (OpenXR controllers) — gpen-vr runtime.rs registers/activates the pose + analog-trigger action set, binds standard left/right OpenXR paths, locates the aim action space per sync, releases safely on tracking loss, and feeds the pressure-aware stroke state machine; integration-tested through Neith's OpenXR runtime
  • 156.8.2 AR stroke placement (Phase 166 spatial) — live XR_EXT_spatial_anchor entities are resolved through the Phase-166 runtime, tracking/resolution gated, converted from Pose6Dof to Mat4, placed and re-anchored under runtime pose updates
  • 156.8.3 Volumetric stroke (tube / ribbon / brush) in 3D space
  • 156.8.4 Multi-user collaborative VR drawing — op-based CRDT merge (Lamport ids, commutative/idempotent/LWW) in collab.rs + a real network transport in sync.rs: length-prefixed JSON frames + a delta-state anti-entropy exchange (advertise-have → send-missing → merge) over any byte stream. Proven end-to-end by two replicas converging (and resolving a concurrent-edit LWW) over a live localhost TCP socket. Only WAN signalling/relay to discover a remote headset remains external
  • 156.8.5 Quill / Open Brush file import
  • 156.8.6 Spatial audio annotation on stroke
  • 156.8.7 Ambient-brush (light-emitting stroke)
  • 156.8.8 Gesture to symbol library
  • 156.8.9 360° canvas / billboard
  • 156.8.10 Export to USD spatial doc

156.9 @neith/gpen-storyboard — Storyboard & Previs#

  • 156.9.1 Board panel manager
  • 156.9.2 Shot / scene / act hierarchy
  • 156.9.3 Camera storyboard widget (framing rectangle)
  • 156.9.4 Action / dialogue / notes sidecar
  • 156.9.5 Animatic auto-timing with audio
  • 156.9.6 Promote to layout scene (inherit camera)
  • 156.9.7 Board review / approval flow
  • 156.9.8 Export PDF boards
  • 156.9.9 Export EDL / OTIO for edit
  • 156.9.10 Live link to Phase 133 (scoring-to-picture)

156.10 Testing & Validation#

  • 156.10.1 100k-stroke scene viewport interactive performance
  • 156.10.2 Pressure-latency ≤ 16 ms on a tablet — the input path is implemented. Needs a physical pen tablet and a windowed input loop to measure end-to-end pressure latency; not runnable headless and the fleet has no tablet (stated 2026-09-18). blocked:hardware
  • 156.10.3 Blender GP file import (.blend GP data) — native embedded-SDNA reader imports both legacy bGPdata (Blender 2.8–4.0) and CurvesGeometry-backed GreasePencil (4.3+) without launching Blender; authoritative uncompressed Blender 4.0.2 + 4.5.4 LTS fixtures validate layers, frames, strokes and per-point signal
  • 156.10.4 USD curves GP round-trip
  • 156.10.5 Line-art vs Blender reference visual diff — Blender 4.0 EEVEE-rendered canonical cube silhouette is committed as a golden PGM; Neith contours are independently rasterized and gated by bidirectional two-pixel coverage plus strict binary IoU, with a displaced-image negative control
  • 156.10.6 Cross-NPR consistency with Phase 154
  • 156.10.7 Diverse hand-drawn tablet test (low-end to Cintiq Pro). Needs a range of physical drawing tablets to test against; the fleet has none (stated 2026-09-18). blocked:hardware
  • 156.10.8 VR spatial drawing frame-time ≤ 11 ms — the volumetric tube-build compute path is validated in gpen-testing perf.rs. The on-headset render frame-time needs a VR headset to measure; the fleet has none (stated 2026-09-18). blocked:hardware
  • 156.10.9 End-to-end animated short produced
  • 156.10.10 Integration with Phase 141 2D suite