Added velocity to tracks in the sequencer.

screenshots/ALL.md

@@ -0,0 +1,588 @@
+# xtc — the complete screenshot gallery
+
+Browse every screenshot, from arranging and editing to mixing, plugins and workspace preferences.
+See [capture notes and reproduction instructions](README.md) for image provenance and workflow limits.
+
+---
+
+## The xtc workspace at a glance
+
+![The xtc workspace at a glance](overview.png)
+
+A promotional composite of the arrangement, piano roll, mixer and track insert views.
+
+---
+
+## A compact workspace for composition
+
+![A compact workspace for composition](compact-workspace.png)
+
+The sequencer brings track creation, arrangement tools and transport controls into one view.
+
+---
+
+## Arrange clips around a loop
+
+![Arrange clips around a loop](sequencer-loop.png)
+
+MIDI clips sit beneath section markers and a highlighted loop range.
+
+---
+
+## Edit velocity beneath each track
+
+![Edit velocity beneath each track](track-velocity-expanded.png)
+
+Keys and Bass expand downward to reveal MIDI velocity bars while following tracks move down.
+
+---
+
+## Start a new track
+
+![Start a new track](create-track-menu.png)
+
+The Create dropdown opens over the arrangement with track creation choices.
+
+---
+
+## Give the song a structure
+
+![Give the song a structure](arrangement-markers.png)
+
+Named Intro, Verse, Chorus and Outro markers identify sections along the ruler.
+
+---
+
+## Name an arrangement marker
+
+![Name an arrangement marker](marker-edit.png)
+
+The marker editor provides a name for a position in the song.
+
+---
+
+## Navigate song sections
+
+![Navigate song sections](section-navigation.png)
+
+The arrangement shows a loop around the current song section.
+
+---
+
+## Set the loop boundaries
+
+![Set the loop boundaries](loop-range.png)
+
+The loop range dialog controls the start and end of repeated playback.
+
+---
+
+## Make room in the arrangement
+
+![Make room in the arrangement](ripple-time.png)
+
+The ripple time dialog requests a duration to insert or remove at the cursor.
+
+---
+
+## See the inserted space
+
+![See the inserted space](ripple-result.png)
+
+The arrangement shows the gap created by inserting time.
+
+---
+
+## Build an independent track layer
+
+![Build an independent track layer](track-duplication.png)
+
+A duplicated track appears alongside the original arrangement.
+
+---
+
+## Split a MIDI clip
+
+![Split a MIDI clip](midi-split.png)
+
+The arrangement displays separate MIDI regions after a nondestructive split.
+
+---
+
+## Bring MIDI regions together
+
+![Bring MIDI regions together](midi-consolidation.png)
+
+Separate MIDI material is consolidated into a single clip.
+
+---
+
+## Shape notes and their dynamics
+
+![Shape notes and their dynamics](piano-roll-velocity.png)
+
+The piano roll combines note editing with a dedicated velocity lane.
+
+---
+
+## Add timing and velocity variation
+
+![Add timing and velocity variation](midi-humanize.png)
+
+The humanization dialog exposes timing variation, velocity variation and a repeatable seed.
+
+---
+
+## Build chords from intervals
+
+![Build chords from intervals](midi-chord-builder.png)
+
+The chord dialog accepts intervals for constructing notes around a root.
+
+---
+
+## Review the generated chords
+
+![Review the generated chords](midi-chords-result.png)
+
+The piano roll displays the notes written by the chord builder.
+
+---
+
+## Turn chords into patterns
+
+![Turn chords into patterns](midi-arpeggio.png)
+
+The arpeggio dialog controls step duration, gate and note direction.
+
+---
+
+## Review an arpeggiated pattern
+
+![Review an arpeggiated pattern](midi-arpeggio-result.png)
+
+The piano roll shows the sequence of notes produced by arpeggiation.
+
+---
+
+## Spread chord notes in time
+
+![Spread chord notes in time](creative-strum-dialog.png)
+
+The strumming dialog configures spacing and direction for chord notes.
+
+---
+
+## Review a strummed chord
+
+![Review a strummed chord](creative-strum-result.png)
+
+The piano roll shows staggered note starts after applying chord strumming.
+
+---
+
+## Exchange standard MIDI files
+
+![Exchange standard MIDI files](midi-file-menu.png)
+
+The File menu exposes MIDI import and selected-clip export commands.
+
+---
+
+## Bring MIDI into the song
+
+![Bring MIDI into the song](midi-import-arrangement.png)
+
+An exported MIDI clip has been imported into the arrangement.
+
+---
+
+## Inspect imported MIDI notes
+
+![Inspect imported MIDI notes](midi-import-piano-roll.png)
+
+The piano roll displays imported notes and their velocities.
+
+---
+
+## Arrange audio alongside MIDI
+
+![Arrange audio alongside MIDI](sequencer-audio-waveform.png)
+
+An imported audio clip displays its waveform directly in the sequencer.
+
+---
+
+## Adjust clip gain and fades
+
+![Adjust clip gain and fades](audio-clip-properties.png)
+
+The audio clip properties dialog exposes nondestructive gain and fade settings.
+
+---
+
+## Choose a normalization target
+
+![Choose a normalization target](audio-normalization.png)
+
+The normalization dialog requests a target peak level in dBFS.
+
+---
+
+## Review normalized audio
+
+![Review normalized audio](audio-normalization-result.png)
+
+The arrangement shows the audio clip after normalization.
+
+---
+
+## Work directly with an audio source
+
+![Work directly with an audio source](sample-editor.png)
+
+The sample editor displays waveform selection, statistics and processing controls.
+
+---
+
+## Find attacks for slicing
+
+![Find attacks for slicing](sample-transients.png)
+
+Detected source attacks appear alongside the sample editor's slicing controls.
+
+---
+
+## Collect portable project media
+
+![Collect portable project media](project-collection.png)
+
+The collection prompt requests a destination folder for the project and its media.
+
+---
+
+## Monitor the mix during playback
+
+![Monitor the mix during playback](mixer-playing.png)
+
+The mixer shows track controls and meters driven by actual JACK playback callbacks.
+
+---
+
+## Shape the mix over time
+
+![Shape the mix over time](mixer-automation.png)
+
+The mixer presents track controls together with automation editing.
+
+---
+
+## Mix in a smaller window
+
+![Mix in a smaller window](mixer-minimum-size.png)
+
+The mixer is shown at the supported 1220 × 720 minimum main-window size.
+
+---
+
+## Navigate a larger session
+
+![Navigate a larger session](mixer-scrolled-session.png)
+
+A session with additional tracks demonstrates scrolling through the mixer.
+
+---
+
+## Explore the signal flow
+
+![Explore the signal flow](modular-graph.png)
+
+The modular graph displays connected processing nodes and their routing.
+
+---
+
+## Chain installed VST3 effects
+
+![Chain installed VST3 effects](track-inserts-vst3.png)
+
+The Keys track hosts ZamEQ2, ZamAutoSat and ZamDelay in its insert graph.
+
+---
+
+## Inspect a hosted VST3 effect
+
+![Inspect a hosted VST3 effect](track-insert-vst3-identity.png)
+
+The identity view reports the plugin and the current adapter capabilities.
+
+---
+
+## Create parallel effect branches
+
+![Create parallel effect branches](track-inserts-parallel.png)
+
+The insert graph shows parallel wet and dry signal paths.
+
+---
+
+## Start with a Dub Echo rack
+
+![Start with a Dub Echo rack](creative-dub-rack.png)
+
+The insert graph displays the internal Dub Echo template and its idle meters.
+
+---
+
+## Manage a complete effect rack
+
+![Manage a complete effect rack](creative-rack-actions.png)
+
+Rack actions expose bulk operations, comparison and chain clipboard controls.
+
+---
+
+## Browse the plugin library
+
+![Browse the plugin library](plugin-library.png)
+
+The library presents available plugins for selection.
+
+---
+
+## Inspect plugin descriptors
+
+![Inspect plugin descriptors](plugin-descriptors.png)
+
+The descriptor browser displays metadata from repository plugin fixtures.
+
+---
+
+## Adjust hosted plugin controls
+
+![Adjust hosted plugin controls](plugin-controls.png)
+
+The control editor exposes parameters provided by a repository plugin fixture.
+
+---
+
+## Choose an internal instrument
+
+![Choose an internal instrument](internal-instruments.png)
+
+The instrument menu presents the built-in devices available to a track.
+
+---
+
+## Configure an internal delay
+
+![Configure an internal delay](internal-delay.png)
+
+The delay editor presents its available device controls.
+
+---
+
+## Configure an internal reverb
+
+![Configure an internal reverb](internal-reverb.png)
+
+The reverb editor presents its available device controls.
+
+---
+
+## Inspect a CLAP instrument
+
+![Inspect a CLAP instrument](clap-instrument-descriptors.png)
+
+The host displays descriptor information for a CLAP instrument.
+
+---
+
+## Inspect a VST2 instrument
+
+![Inspect a VST2 instrument](vst2-instrument-descriptors.png)
+
+The host displays descriptor information for a VST2 instrument.
+
+---
+
+## Inspect a VST3 instrument
+
+![Inspect a VST3 instrument](vst3-instrument-descriptors.png)
+
+The host displays descriptor information for a VST3 instrument.
+
+---
+
+## Host the Steinberg SDK example effect
+
+![Host the Steinberg SDK example effect](steinberg-sdk-track-insert.png)
+
+The actual SDK-built Half Gain effect appears in xtc's track insert graph.
+
+---
+
+## Inspect the SDK effect identity
+
+![Inspect the SDK effect identity](steinberg-sdk-identity.png)
+
+The host reports the Steinberg SDK effect's identity and current adapter limits.
+
+---
+
+## Discover the SDK sine instrument
+
+![Discover the SDK sine instrument](steinberg-sdk-instrument.png)
+
+The plugin chooser displays the instrument from the Steinberg SDK example bundle.
+
+---
+
+## Discover the JUCE instrument
+
+![Discover the JUCE instrument](juce-vst3-instrument.png)
+
+The plugin chooser displays the actual JUCE VST3 instrument bundle.
+
+---
+
+## Play with the Soft Keys interface
+
+![Play with the Soft Keys interface](juce-soft-keys-editor.png)
+
+The actual JUCE editor is rendered directly, showing presets, parameter controls and an on-screen keyboard.
+
+---
+
+## Connect MIDI controllers to parameters
+
+![Connect MIDI controllers to parameters](midi-controller-mapping.png)
+
+The controller mapping interface exposes MIDI control assignments.
+
+---
+
+## Configure audio preferences
+
+![Configure audio preferences](preferences-audio.png)
+
+The audio preferences tab presents the application's audio settings.
+
+---
+
+## Choose MIDI sources and destinations
+
+![Choose MIDI sources and destinations](preferences-midi.png)
+
+MIDI preferences provide port choices, channel filtering and thru settings.
+
+---
+
+## Browse real MIDI input devices
+
+![Browse real MIDI input devices](preferences-midi-input-devices.png)
+
+The open input dropdown lists actual MIDI sources exposed by the host; no route is selected.
+
+---
+
+## Understand MIDI setup and defaults
+
+![Understand MIDI setup and defaults](preferences-midi-help.png)
+
+The preferences help page explains device routing and MIDI editing defaults.
+
+---
+
+## Configure plugin preferences
+
+![Configure plugin preferences](preferences-plugins.png)
+
+The plugin preferences tab presents plugin discovery settings.
+
+---
+
+## Adjust the workspace preferences
+
+![Adjust the workspace preferences](preferences-interface.png)
+
+The interface preferences tab presents appearance and layout settings.
+
+---
+
+## Set editing defaults
+
+![Set editing defaults](preferences-editing.png)
+
+The editing preferences tab includes defaults for new MIDI notes.
+
+---
+
+## Set project defaults
+
+![Set project defaults](preferences-project_defaults.png)
+
+The project defaults tab presents settings used when creating project content.
+
+---
+
+## Configure transport preferences
+
+![Configure transport preferences](preferences-transport.png)
+
+The transport preferences tab presents playback and navigation settings.
+
+---
+
+## Find an application command
+
+![Find an application command](commands.png)
+
+The command palette provides access to the current application action list.
+
+---
+
+## Keep transport controls within reach
+
+![Keep transport controls within reach](transport-detached.png)
+
+The transport floats in a separate window with BPM and loop settings.
+
+---
+
+## Give the mixer its own window
+
+![Give the mixer its own window](mixer-detached.png)
+
+The mixer is detached from the main workspace.
+
+---
+
+## Spread the workspace across windows
+
+![Spread the workspace across windows](workspace-detached.png)
+
+Transport and mixer panels float alongside the main application window.
+
+---
+
+## Arrange in a separate window
+
+![Arrange in a separate window](sequencer-detached.png)
+
+The sequencer is detached from the main workspace.
+
+---
+
+## Route signals in a separate window
+
+![Route signals in a separate window](graph-detached.png)
+
+The modular graph is detached from the main workspace.
+
+---
+
+## About xtc
+
+![About xtc](about.png)
+
+The About dialog presents application information.

screenshots/README.md

@@ -1,5 +1,7 @@
 # xtc screenshots
 
+[Browse all screenshots with captions](ALL.md).
+
 The complete gallery was refreshed after Phases 100–105 on 2026-11-06, including
 MIDI preferences/import, the sample editor, creative workflows and real installed
 VST3 insert chains.
@@ -30,6 +32,24 @@ APIs and GUI history/preparation paths. Original projects, media and user
 configuration are not overwritten. Black margins are the virtual desktop;
 floating views show the actual detached windows together.
 
+## Expandable track velocity lanes (Phase 109)
+
+![Tracks expanded downward with editable MIDI velocity bars](track-velocity-expanded.png)
+
+Captured from the real application on 2026-11-06. Keys and Bass are expanded;
+subsequent tracks move downward. Click the arrow beside a track name, then drag
+a note bar's cap to edit velocity. The compact workspace, sequencer loop and
+promotional overview were also refreshed to show the disclosure arrows.
+
+Reproduce these sequencer captures without replacing the rest of the gallery:
+
+```sh
+cmake --build build --target capture_screenshots
+XTC_CAPTURE_VELOCITY_ONLY=1 xvfb-run -a -s '-screen 0 1440x960x24' \
+  ./build/capture_screenshots "$PWD/screenshots"
+python3 tools/create_promotional_overview.py
+```
+
 ## Steinberg and JUCE SDK integration (Phases 106–107)
 
 Captured on 2026-11-06 from the built SDK examples, with no fabricated UI.