BuboBubo/Cagire
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Working on internal documentation

Browse Source
This commit is contained in:
Raphaël Forment
2026-01-31 02:41:05 +01:00
parent 8cd0ec92c0
commit 9b730c310e
5 changed files with 194 additions and 20 deletions
Download Patch File Download Diff File Expand all files Collapse all files

36
docs/grid.md
View File

@@ -1,16 +1,14 @@
# The Sequencer Grid
The sequencer grid is the heart of Cagire. Each cell represents a step that can contain a Forth script to generate sound.
## Structure
- **Steps**: Up to 128 per pattern, displayed 32 at a time
- **Patterns**: Up to 32 per bank
- **Banks**: Up to 32 per project
The sequencer grid is the main view of Cagire. This is the one you see when you open the application. On this view, you can see the step sequencer grid and edit each step using the `code editor`. At the top, you can optionally display an oscilloscope and a spectrum analyzer.
## Navigation
Use arrow keys to move between steps. The grid wraps around at pattern boundaries.
Use arrow keys to move between steps. The grid wraps around at pattern boundaries. You can move in any direction.
## Preview
Press `P` to enter preview mode. In preview mode, a view-only code editor opens so that you can see the script of the currently playing step. While in preview mode, you can still move around the grid. Press `Esc` to exit preview mode.
## Selection
@@ -18,20 +16,20 @@ Hold `Shift` while pressing arrow keys to select multiple steps. Press `Esc` to
## Editing Steps
- `Enter` - Open the script editor
- `t` - Toggle step active/inactive
- `r` - Rename a step
- `Del` - Delete selected steps
- `Enter` - Open the script editor.
- `t` - Toggle step active/inactive.
- `r` - Rename a step.
- `Del` - Delete selected steps.
## Copy & Paste
- `Ctrl+C` - Copy selected steps
- `Ctrl+V` - Paste as copies
- `Ctrl+B` - Paste as linked steps
- `Ctrl+D` - Duplicate selection
- `Ctrl+H` - Harden links (convert to copies)
- `Ctrl+C` - Copy selected steps.
- `Ctrl+V` - Paste as copies.
- `Ctrl+B` - Paste as linked steps.
- `Ctrl+D` - Duplicate selection.
- `Ctrl+H` - Harden links (convert to copies).
Linked steps share the same script as their source. When you edit the source, all linked steps update automatically.
`Linked steps` share the same script as their source. When you edit the source, all linked steps update automatically. This is an extremely important and powerful feature. It allows you to create complex patterns with minimal effort. `Ctrl+H` is your best friend to manage linked steps and convert them to real steps.
## Pattern Controls
@@ -51,4 +49,4 @@ Linked steps share the same script as their source. When you edit the source, al
- **Highlighted cell** - Currently playing step
- **Colored backgrounds** - Linked steps share colors by source
- **Arrow prefix** (→05) - Step is linked to step 05
- **Arrow prefix** (`→05`) - Step is linked to step 05