hanez/xtc
2
1
Fork 1
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Migrated from Make to CMake.

Browse source
This commit is contained in:
Johannes Findeisen 2026-11-06 19:05:14 +01:00
commit b6ba093000
52 changed files with 1276 additions and 1210 deletions
Download patch file Download diff file Expand all files Collapse all files

21
screenshots/README.md
View file

@ -56,10 +56,11 @@ The host is stopped and meters are idle. No ASIO interface is shown or implied.
See [Steinberg integration](../docs/STEINBERG.md) and
[JUCE integration](../docs/JUCE.md).
After building both SDK examples, reproduce only these host captures with:
After configuring the root CMake project and building both SDK examples,
reproduce only these host captures with:
```sh
make build/capture_screenshots
cmake --build build --target capture_screenshots
XTC_CAPTURE_STEINBERG_BUNDLE="$PWD/build/steinberg-sdk/VST3/Release/xtc-sdk-examples.vst3" \
XTC_CAPTURE_JUCE_BUNDLE="$PWD/build/juce/XtcJuceSynth_artefacts/Release/VST3/xtc JUCE Synth.vst3" \
xvfb-run -a -s '-screen 0 1440x960x24' \
@ -91,14 +92,15 @@ mean no automatic connection. Actual device choices depend on host JACK/PipeWire
exposure. Configuration paths are disabled in captures to preserve user settings.
See [MIDI workflows and limits](../docs/MIDI_WORKFLOWS.md).
Reproduce these five captures with
`XTC_CAPTURE_MIDI_ONLY=1 make BUILD_DIR=build/audio-editor screenshots`.
After configuring `build/audio-editor` with the root CMake project,
reproduce these five captures with
`XTC_CAPTURE_MIDI_ONLY=1 cmake --build build/audio-editor --target screenshots`.
The open input dropdown was captured after the device-label lifetime fix. It
shows actual host sources, including UMC204HD, USB MIDI, Oxygen Pro 25 and BLE
MIDI ports. No route is selected and user preferences are preserved. Reproduce
just this image with real MIDI sources exposed by JACK/PipeWire:
`XTC_CAPTURE_MIDI_INPUT_ONLY=1 make BUILD_DIR=build/audio-editor screenshots`.
`XTC_CAPTURE_MIDI_INPUT_ONLY=1 cmake --build build/audio-editor --target screenshots`.
The capture fails explicitly if the host exposes no input sources.
## Creative workflows (Phases 90–99)
@ -112,7 +114,7 @@ creative controls; the rest of the gallery also reflects the current UI.
- [Strummed chord notes in the piano roll](creative-strum-result.png)
Reproduce only these captures with
`XTC_CAPTURE_CREATIVE_ONLY=1 make BUILD_DIR=build/audio-editor screenshots`.
`XTC_CAPTURE_CREATIVE_ONLY=1 cmake --build build/audio-editor --target screenshots`.
The rack shows the actual template and idle meter; no live peak readings are
fabricated. See [creative workflow limits](../docs/CREATIVE_WORKFLOWS.md).
@ -219,7 +221,8 @@ to return it to the main window.
From the repository root, run:
```sh
make BUILD_DIR=build/next-daw screenshots
cmake -S . -B build/next-daw -DCMAKE_BUILD_TYPE=Debug
cmake --build build/next-daw --target screenshots
```
This optional documentation target requires the existing FLTK/JACK build
@ -230,7 +233,7 @@ PNGs. All demonstration edits and collection outputs use an automatically remove
temporary directory; no preferences are saved. It neither installs dependencies
nor starts/reconfigures the audio server.
Set `XTC_CAPTURE_SAMPLE_ONLY=1` for the capture tool (or the make target) to write
Set `XTC_CAPTURE_SAMPLE_ONLY=1` for the capture tool (or the CMake target) to write
only the two sample-editor images while retaining the existing gallery.
@ -241,6 +244,6 @@ XTC_CAPTURE_HOST_VST3=1 xvfb-run -a -s '-screen 0 1440x960x24' \
./build/audio-editor/capture_screenshots "$PWD/screenshots"
```
Run `make BUILD_DIR=build/audio-editor screenshots` first to build the tool and
Run `cmake --build build/audio-editor --target screenshots` first to build the tool and
refresh the full fixture/demo gallery. All captures use temporary projects and
preserve user settings and original media.