summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorskal <pascal.massimino@gmail.com>2026-02-16 08:41:51 +0100
committerskal <pascal.massimino@gmail.com>2026-02-16 08:41:51 +0100
commit673b09df703daf437add932494a583ed50394f14 (patch)
tree80cb206345346c4c9eb4209de89b4b3d929dd156 /doc
parentb17282752ee7aa384ca36daa21d034617ca34a4b (diff)
docs: update for Sequence v2 phases 1-2
Diffstat (limited to 'doc')
-rw-r--r--doc/SEQUENCE_v2.md37
1 files changed, 37 insertions, 0 deletions
diff --git a/doc/SEQUENCE_v2.md b/doc/SEQUENCE_v2.md
index 74692a6..0e9d5a9 100644
--- a/doc/SEQUENCE_v2.md
+++ b/doc/SEQUENCE_v2.md
@@ -1,5 +1,42 @@
# Sequence v2 System Documentation
+**Status:** Phase 1 & 2 complete (Foundation + Compiler operational)
+
+## Quick Start
+
+```bash
+# Compile v2 timeline to C++
+python3 tools/seq_compiler_v2.py input.seq --output generated/timeline_v2.cc
+
+# Final mode (flattened, no vtables)
+python3 tools/seq_compiler_v2.py input.seq --output timeline_v2.cc --flatten
+```
+
+## v2 Timeline Syntax
+
+```
+# BPM 120
+
+SEQUENCE 0.0 0 "sequence_name"
+ # Node declarations (optional, auto-inferred as u8x4_norm)
+ NODE gbuf_normal f16x8
+ NODE depth depth24
+
+ # Asset dependencies
+ ASSET shader_blur
+
+ # Effect routing: inputs... -> outputs...
+ EFFECT + DeferredRender source depth -> gbuf_normal gbuf_pos 0.0 10.0
+ EFFECT + Compose gbuf_normal gbuf_pos -> composed 0.0 10.0
+ EFFECT + Blur composed -> sink 0.0 10.0
+```
+
+**Node types:** `u8x4_norm`, `f32x4`, `f16x8`, `depth24`, `compute_f32`
+
+**Priority modifiers:** `+` (increment), `=` (same), `-` (decrement)
+
+---
+
This document describes the high-level ideas for an improved Sequence + Effects system "version 2".
## Goal