summaryrefslogtreecommitdiff
path: root/doc/SEQUENCE.md
diff options
context:
space:
mode:
authorskal <pascal.massimino@gmail.com>2026-02-05 00:44:11 +0100
committerskal <pascal.massimino@gmail.com>2026-02-05 00:44:11 +0100
commitabd1d77d4718a680f17d8ca25d31294d72068acb (patch)
treed52f7a29a731dc85ec713a21ccfea2290388190b /doc/SEQUENCE.md
parente2543192e90a43a26444a27ccc3b49276a944b2c (diff)
feat: Enhance Gantt charts with sequence names, adaptive ticks, and sorting
Improvements to seq_compiler Gantt chart visualization: - Add optional sequence name support: SEQUENCE <start> <pri> ["name"] [end] Names displayed in both ASCII and HTML Gantt charts for better readability - Implement adaptive tick intervals based on demo duration: * ≤5s: 1s intervals * ≤40s: 2s intervals (fixes 32.5s demo from 5s to 2s) * ≤100s: 5s intervals * >100s: 10s+ intervals - Sort sequences by start time in Gantt output for chronological visualization - Add horizontal visual separators between sequences in both ASCII and HTML - Update documentation (SEQUENCE.md) and quick reference (demo.seq) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Diffstat (limited to 'doc/SEQUENCE.md')
-rw-r--r--doc/SEQUENCE.md13
1 files changed, 12 insertions, 1 deletions
diff --git a/doc/SEQUENCE.md b/doc/SEQUENCE.md
index 614339e..7aa951d 100644
--- a/doc/SEQUENCE.md
+++ b/doc/SEQUENCE.md
@@ -63,7 +63,7 @@ Specifies when the demo should automatically exit (optional).
### SEQUENCE Declaration
```
-SEQUENCE <global_start> <priority> [optional_end]
+SEQUENCE <global_start> <priority> ["optional_name"] [optional_end]
EFFECT <EffectClassName> <local_start> <local_end> <priority> [constructor_args...]
```
@@ -72,11 +72,22 @@ SEQUENCE <global_start> <priority> [optional_end]
- `priority`: Render order between sequences (higher = rendered later/on top)
- Use 0-9 for scene effects
- Use 10+ for post-processing
+- `"optional_name"`: Optional human-readable name in quotes (e.g., `"Opening Scene"`)
+ - If specified, the name will be displayed in Gantt charts for better readability
+ - Helps identify sequences when visualizing complex timelines
- `[optional_end]`: Optional end time in brackets (e.g., `[30.0]`)
- If specified, all effects in the sequence will be forcefully ended at this time
- Time is relative to the sequence start
- If omitted, effects run until their individual end times
+**Examples:**
+```
+SEQUENCE 0 0 # Basic sequence (no name, no explicit end)
+SEQUENCE 0 0 "Intro" # Named sequence
+SEQUENCE 0 0 [5.0] # Sequence with explicit end time
+SEQUENCE 0 0 "Action Scene" [10.0] # Named sequence with explicit end time
+```
+
### EFFECT Declaration
```
EFFECT <+|=|-> <EffectClassName> <local_start> <local_end> [constructor_args...]