From 673b09df703daf437add932494a583ed50394f14 Mon Sep 17 00:00:00 2001 From: skal Date: Mon, 16 Feb 2026 08:41:51 +0100 Subject: docs: update for Sequence v2 phases 1-2 --- doc/SEQUENCE_v2.md | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) (limited to 'doc/SEQUENCE_v2.md') 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 -- cgit v1.2.3