diff --git a/CMakeLists.txt b/CMakeLists.txt index b1d0637..1dcfd84 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -4,6 +4,10 @@ set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) option(ARSON_BUILD_PLUGIN "Build VST3 and standalone" ON) option(ARSON_SANITIZE "Enable address/undefined sanitizers for engine tests" OFF) +# JUCE defaults JUCE_ASIO=0. Native Maono PS22 / professional ASIO drivers +# are otherwise absent from the Windows Standalone "Options" device list. +# Keep switch explicit so third-party ASIO SDK licensing can be audited. +option(ARSON_WINDOWS_ASIO "Enable native ASIO devices for Windows Standalone" ON) add_library(arson_engine STATIC engine/Compressor.cpp) set_target_properties(arson_engine PROPERTIES POSITION_INDEPENDENT_CODE ON) target_include_directories(arson_engine PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}/engine) @@ -61,6 +65,13 @@ if(ARSON_BUILD_PLUGIN) endif() target_compile_definitions(ArSonComp PUBLIC JUCE_WEB_BROWSER=0 JUCE_USE_CURL=0 JUCE_VST3_CAN_REPLACE_VST2=0) + if(WIN32 AND ARSON_WINDOWS_ASIO) + # PUBLIC propagates to the generated Standalone wrapper and plugin smoke. + # Uses JUCE's bundled Steinberg ASIO headers (JUCE_ASIO_USE_EXTERNAL_SDK=0). + # VST3 still uses the host-selected driver; this affects Standalone only. + target_compile_definitions(ArSonComp PUBLIC JUCE_ASIO=1 + JUCE_ASIO_USE_EXTERNAL_SDK=0) + endif() target_link_libraries(ArSonComp PRIVATE arson_engine ArSonCompKnobAssets juce::juce_audio_utils PUBLIC juce::juce_recommended_config_flags juce::juce_recommended_lto_flags) if(BUILD_TESTING) diff --git a/docs/WINDOWS-QUICKSTART.md b/docs/WINDOWS-QUICKSTART.md index 2267147..8646c80 100644 --- a/docs/WINDOWS-QUICKSTART.md +++ b/docs/WINDOWS-QUICKSTART.md @@ -62,3 +62,13 @@ The updated full editor should now have a horizontally brushed grey metal backgr ### M4 compact, readable chassis The editor now defaults to **704×520**, with **660×490** as the minimum FULL layout and an unchanged 330px-high MINI view. Compared with the old 780×640 default, the window consumes approximately 27% less screen area without indiscriminately shrinking knobs. All header separators and unnecessary overline captions are removed; the only header captions are MODEL and PRESET. Brushed panel label contrast is checked by automated WCAG-style tests (>=4.5:1 against dark metal reference). The preset remains width-bounded. The footer technical slogan has been removed to prioritize the live value readout. Test at both minimum/default size and with the SIDECHAIN tab selected. + +## Windows interface crackle diagnostic — native ASIO (PS22 and similar) + +The standard JUCE `juce_audio_devices` build defaults `JUCE_ASIO=0`. ArSonComp Windows builds now enable `ARSON_WINDOWS_ASIO=ON` (and `JUCE_ASIO=1`) so **Standalone Options → Audio Settings** can list the system's native ASIO devices. This only enables the backend; install your interface manufacturer's official driver separately. **VST3 uses the audio driver selected by its DAW/host**, not the plug-in. + +For MAONO PS22, install the official [PS22 Windows driver and routing tool](https://faq.maono.com/docs/PS22-FAQs); in the application choose **ASIO** and the device named **Maono ASIO** (name may vary by driver version). Set input and output to PS22, start with **48 kHz, 512 samples**, then test 256 / 128 / 64 only if stable. Close other apps using the ASIO interface, use a direct motherboard USB connection, and disable PS22 direct monitoring if monitoring its software-processed audio to avoid doubled sound. MAONO specifically documents the Maono ASIO driver for its interfaces at https://faq.maono.com/docs/TrueRTA-REW-Software-Configuration-Guide . + +**Isolate the fault before claiming a fix:** (A) PS22 direct monitor (analog baseline, no ArSonComp), (B) unprocessed Windows/DAW input/output, (C) VST3 or Standalone with compressor host-bypassed, (D) compressor active with identical gain and routing. If A has crackles suspect input/cable/hardware; if B/C also crackle suspect driver, buffer, USB or operating-system scheduling; if only D crackles investigate DSP/automation and capture a digital audio recording. A single Task Manager CPU/GPU/memory snapshot is not an xrun measurement. Report driver name, sample rate, buffer, whether Standalone or VST3, and whether bypass removes crackles. A real audio-device test is required. + +`ARSON_WINDOWS_ASIO=OFF` can be used by downstream builders who cannot accept the Steinberg ASIO SDK's third-party licensing terms; review distribution compliance before a public release. Enabling ASIO does **not** ensure zero hardware latency or prevent all crackles. diff --git a/tests/PluginSmoke.cpp b/tests/PluginSmoke.cpp index 639ce60..ea469ce 100644 --- a/tests/PluginSmoke.cpp +++ b/tests/PluginSmoke.cpp @@ -6,12 +6,33 @@ #include "../plugin/SurfacePaint.h" #include "BinaryData.h" #include +#include #include #include #include #include int main(int argc,char** argv) { juce::ScopedJuceInitialiser_GUI gui; +#if JUCE_WINDOWS + // The standalone must offer native low-latency ASIO (e.g. Maono PS22) + // in Options, rather than silently hiding it behind Windows Audio. + // Only the *backend* is checked on CI, not a physical connected device. +#if !JUCE_ASIO +#error "Windows Standalone ASIO backend was disabled in this build" +#endif + { + juce::AudioDeviceManager deviceManager; + bool hasNativeAsio=false; + for(auto* type:deviceManager.getAvailableDeviceTypes()) + if(type && type->getTypeName().equalsIgnoreCase("ASIO")) + hasNativeAsio=true; + if(!hasNativeAsio) { + std::cerr<<"STANDALONE_ASIO_BACKEND_MISSING\n"; + return 81; + } + std::cout<<"PASS: native Windows ASIO device backend is registered\n"; + } +#endif // Quantitative edge-dissolve contract: endpoints transparent, the // central ~73% clearly visible, symmetric fades and stable RGB. {