## 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

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

---

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

#### 156.2.1 Draw

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

#### 156.2.2 Fill

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

#### 156.2.3 Sculpt / Edit

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

---

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

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

---

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

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

---

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

- [x] **156.5.1** Edge-contour from 3D mesh
- [x] **156.5.2** Crease / material / smooth edges
- [x] **156.5.3** Intersection edges across meshes
- [x] **156.5.4** Silhouette from view direction
- [x] **156.5.5** Chain strokes with angle threshold
- [x] **156.5.6** Baked per-frame update
- [x] **156.5.7** Live line-art (viewport update)
- [x] **156.5.8** Occlusion levels (through N layers)
- [x] **156.5.9** Per-object line-art override
- [x] **156.5.10** Noise / hand-drawn offset
- [x] **156.5.11** Colour from material
- [x] **156.5.12** Style-per-edge (dash / dot / continuous)
- [x] **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_
- [x] **156.5.14** Bake to GP object for hand-edit
- [x] **156.5.15** Cross-reference Phase 154 NPR output

---

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

- [x] **156.6.1** Stroke-only, fill-only, both material modes
- [x] **156.6.2** Solid / gradient / texture / pattern shader
- [x] **156.6.3** Lit stroke (respond to scene lights)
- [x] **156.6.4** Shadow-casting strokes
- [x] **156.6.5** Stencil alpha
- [x] **156.6.6** Mix-mode (multiply / screen / overlay)
- [x] **156.6.7** Per-vertex colour
- [x] **156.6.8** Stroke variation along length
- [x] **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_
- [x] **156.6.10** Depth-sorted vs screen-aligned
- [x] **156.6.11** Composite in Phase 135 (VFX Compositor)
- [x] **156.6.12** Export to PNG/EXR with alpha
- [x] **156.6.13** Render in offline path tracer (Phase 138)
- [x] **156.6.14** AOV for strokes + fills
- [x] **156.6.15** Cryptomatte per GP layer

---

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

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

---

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

- [x] **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_
- [x] **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_
- [x] **156.8.3** Volumetric stroke (tube / ribbon / brush) in 3D space
- [x] **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_
- [x] **156.8.5** Quill / Open Brush file import
- [x] **156.8.6** Spatial audio annotation on stroke
- [x] **156.8.7** Ambient-brush (light-emitting stroke)
- [x] **156.8.8** Gesture to symbol library
- [x] **156.8.9** 360° canvas / billboard
- [x] **156.8.10** Export to USD spatial doc

---

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

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

---

### 156.10 Testing & Validation

- [x] **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`
- [x] **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_
- [x] **156.10.4** USD curves GP round-trip
- [x] **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_
- [x] **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`
- [x] **156.10.9** End-to-end animated short produced
- [x] **156.10.10** Integration with Phase 141 2D suite
