docs: refresh all screenshots and illustrate phase 58–68 workflows

This commit is contained in:
Johannes Findeisen 2026-11-06 00:56:27 +01:00
commit 66e07776a4
55 changed files with 178 additions and 21 deletions

View file

@ -1,24 +1,49 @@
# xtc screenshots
Captured from the Phase 38 FLTK application on 2026-10-28, with Phase 39
transport, mixer, arrangement and command captures refreshed on 2026-10-30 using
a virtual X11 screen. Images show actual rendered widgets, without mockups or image edits.
All captures refreshed from the Phase 68 FLTK application on 2026-11-06.
These are actual rendered application windows and menus on a 1440 × 960 virtual
X11 screen, without mockups, compositing or image edits.
![Overview of xtc screenshots](overview.png)
![Arrangement with named sections](overview.png)
Internal instrument dropdowns show Soft Keys and Sub Bass; internal delay and
reverb captures show the actual editable effect controls.
The temporary demonstration project starts from
`examples/projects/modern-session.xtc`, adding Intro/Verse/Chorus/Outro markers,
a routed music bus and gain automation. Editing results use the real control
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.
The arrangement uses `examples/projects/modern-session.xtc`. Mixer captures add
a bus, routing, pan/level settings and automation. The playing view shows actual
JACK callback meters; additional captures show the minimum 1220 × 720 layout and
a larger session scrolled to its final channels, with the master monitor pinned.
The audio view adds a temporary generated waveform. Plugin views use the
repository's LADSPA, CLAP, VST2 and VST3 test fixtures; these are demonstration
plugins, not commercial instruments. Preferences show application defaults and
the staged loop. The command palette shows the available application actions.
The workspace now includes direct BPM editing, a live track inspector and
arrangement navigation. No user configuration or example project was overwritten.
## New arrangement and composition workflows
| Phase | Feature | Captures |
| --- | --- | --- |
| 58 | Persistent named arrangement markers | [Ruler](arrangement-markers.png), [marker editor](marker-edit.png) |
| 59 | Section navigation and looping | [Current section loop](section-navigation.png) |
| 60 | Ripple time insertion/removal | [Controls](ripple-time.png), [inserted gap](ripple-result.png) |
| 61 | Complete track duplication | [Independent layered track](track-duplication.png) |
| 62 | Nondestructive MIDI splitting | [Split clip](midi-split.png) |
| 63 | MIDI clip consolidation | [Consolidated clip](midi-consolidation.png) |
| 64 | Seeded MIDI humanization | [Timing, velocity and seed](midi-humanize.png) |
| 65 | Chord construction | [Intervals](midi-chord-builder.png), [generated notes](midi-chords-result.png) |
| 66 | Offline arpeggio generation | [Step, gate and direction](midi-arpeggio.png), [written pattern](midi-arpeggio-result.png) |
| 67 | Audio peak normalization | [Target dBFS](audio-normalization.png), [normalized clip](audio-normalization-result.png) |
| 68 | Portable media collection | [New destination folder](project-collection.png) |
Collection is also executed by the capture tool into its temporary directory;
the screenshot shows its destination prompt, not a file browser or progress UI.
See [COMPOSITION_WORKFLOWS.md](../docs/COMPOSITION_WORKFLOWS.md) for precise
behavior, limits and commands. The screenshots illustrate implemented workflows;
they do not establish feature parity with other DAWs.
## Refreshed application views
All pre-existing images below were recaptured. Mixer playback meters come from
real JACK callbacks. The minimum-size capture uses a 1220 × 720 main window;
the scrolled view adds twelve tracks. Audio views import the repository's
`original-pluck.wav` and apply clip gain/fades. Plugin views use repository test
fixtures, not commercial plugins. Internal instrument menus and delay/reverb
editors show the real available devices and controls. The command palette uses
the current application action list.
- [Sequencer loop](sequencer-loop.png)
- [Mixer automation](mixer-automation.png)
@ -55,5 +80,25 @@ arrangement navigation. No user configuration or example project was overwritten
- [Detached mixer](mixer-detached.png)
- [Workspace with transport and mixer detached](workspace-detached.png)
- [Detached sequencer](sequencer-detached.png)
- [Detached modular graph](graph-detached.png)
Detach panels from the View menu; close a floating window or use its Dock button
to return it to the main window. The main arrangement uses the freed toolbar space.
to return it to the main window.
## Reproduce the gallery
From the repository root, run:
```sh
make BUILD_DIR=build/next-daw screenshots
```
This optional documentation target requires the existing FLTK/JACK build
prerequisites, a running JACK server, Xvfb (`xvfb-run`), ImageMagick (`import`) and
`xdotool`. It builds the repository plugin fixtures, runs
[the capture tool](../tools/capture_screenshots.cpp), and replaces the gallery
PNGs. All demonstration edits and collection outputs use an automatically removed
temporary directory; no preferences are saved. It neither installs dependencies
nor starts/reconfigures the audio server.