xtc/screenshots/README.md

104 lines
5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# xtc screenshots
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.
![Arrangement with named sections](overview.png)
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.
## 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)
- [Modular graph](modular-graph.png)
- [Piano roll velocity](piano-roll-velocity.png)
- [Sequencer audio waveform](sequencer-audio-waveform.png)
- [Preferences audio](preferences-audio.png)
- [Preferences plugins](preferences-plugins.png)
- [Preferences interface](preferences-interface.png)
- [Preferences editing](preferences-editing.png)
- [Preferences project defaults](preferences-project_defaults.png)
- [Preferences transport](preferences-transport.png)
- [Plugin library](plugin-library.png)
- [Plugin descriptors](plugin-descriptors.png)
- [Plugin controls](plugin-controls.png)
- [Midi controller mapping](midi-controller-mapping.png)
- [Loop range](loop-range.png)
- [About](about.png)
- [Audio clip properties](audio-clip-properties.png)
- [Clap instrument descriptors](clap-instrument-descriptors.png)
- [Vst2 instrument descriptors](vst2-instrument-descriptors.png)
- [Vst3 instrument descriptors](vst3-instrument-descriptors.png)
- [Mixer playing](mixer-playing.png)
- [Mixer minimum size](mixer-minimum-size.png)
- [Mixer scrolled session](mixer-scrolled-session.png)
- [Commands](commands.png)
- [Internal instruments](internal-instruments.png)
- [Internal delay](internal-delay.png)
- [Internal reverb](internal-reverb.png)
- [Detached transport with BPM and loop settings](transport-detached.png)
- [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.
## 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.