Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
72 changes: 72 additions & 0 deletions .github/workflows/native-canvas-windows.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,72 @@
name: Native JUCE Canvas Preview (Windows x64)
on:
push:
branches:
- feature/native-juce-mixer-canvas-20261027
paths:
- native/canvas-preview/**
- .github/workflows/native-canvas-windows.yml
workflow_dispatch:
pull_request:
paths:
- native/canvas-preview/**
- .github/workflows/native-canvas-windows.yml

permissions:
contents: read

jobs:
native-canvas-preview:
runs-on: windows-2022
timeout-minutes: 35
steps:
- name: Checkout ArSonMix prototype branch
uses: actions/checkout@v4
- name: Checkout pinned JUCE 8.0.15
uses: actions/checkout@v4
with:
repository: juce-framework/JUCE
ref: 8.0.15
path: third_party/JUCE
persist-credentials: false
- name: Configure independent JUCE native preview
shell: pwsh
run: |
cmake -S native/canvas-preview -B build/native-canvas -G "Visual Studio 17 2022" -A x64 -DJUCE_ROOT="${{ github.workspace }}/third_party/JUCE"
if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
- name: Build Windows x64 executable
shell: pwsh
run: |
cmake --build build/native-canvas --config Release --target ARMixNativeMixerCanvasPreview --parallel 2
if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
- name: Package inspected EXE and checksum
shell: pwsh
run: |
$exe = Get-ChildItem -Path build/native-canvas -Filter '*.exe' -Recurse -File |
Where-Object { $_.Name -like "*Native Canvas Preview*" -or $_.Name -like "*ARMixNativeMixerCanvasPreview*" } |
Select-Object -First 1
if ($null -eq $exe) {
Get-ChildItem -Path build/native-canvas -Filter '*.exe' -Recurse | ForEach-Object { Write-Host $_.FullName }
throw "JUCE preview EXE was not found"
}
New-Item -ItemType Directory -Force -Path dist/native-canvas | Out-Null
Copy-Item $exe.FullName "dist/native-canvas/ArSonMix-Native-JUCE-Mixer-Canvas-Windows-x64.exe"
Get-FileHash "dist/native-canvas/ArSonMix-Native-JUCE-Mixer-Canvas-Windows-x64.exe" -Algorithm SHA256 |
Format-List | Out-String | Set-Content "dist/native-canvas/SHA256.txt"
Set-Content "dist/native-canvas/README.txt" @'
ArSonMix Native JUCE Mixer Canvas PREVIEW (Windows x64)
UI-only proof of concept; no audio engine, no VST hosting.
Fader, PAN, MUTE, SOLO are interactive; meters require real native input.
Does NOT replace the production ArSonMix GUI.
Original Soundcraft Ui24 canvas graphics/code are NOT included.
'@
$len = (Get-Item "dist/native-canvas/ArSonMix-Native-JUCE-Mixer-Canvas-Windows-x64.exe").Length
Write-Host "Built executable size (bytes): $len"
if ($len -lt 102400) { throw "Executable unexpectedly small" }
- name: Upload Windows binary artifact
uses: actions/upload-artifact@v4
with:
name: ArSonMix-Native-JUCE-Mixer-Canvas-Windows-x64
path: dist/native-canvas/
retention-days: 14
if-no-files-found: error
35 changes: 35 additions & 0 deletions docs/ARD_NATIVE_JUCE_MIXER_CANVAS_20261027.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
# Native JUCE canvas research and proof of concept (2026-10-27)

Reference: https://www.soundcraft.com/ui24-software-demo/mixer.html

## Technical findings
The Soundcraft Ui24 demo uses HTML5 Canvas. A rendered canvas is a pixel surface, not an exportable collection of JUCE widgets. PNG screenshots cannot restore drawing logic, hit regions, channel state, or DSP. The original Soundcraft page blocked direct server-side fetch (403), while the connected browser tab showed an HTML5 Canvas fallback. No exact live-page pixel parity or original asset inventory has been verified.

## Implemented
- Separate, original JUCE paint-based MixerCanvas and standalone demo, not a copy of Soundcraft image/code assets.
- 12 input strips and master. Dedicated fader scale (+10 to -60 dB), separate meter scale (0 to -60 dB). Thumb index line matches gain position.
- Relative fader dragging without click-jump, double click to 0 dB, wheel adjustment, relative PAN dragging with centre detent, MUTE/SOLO toggles.
- Six visibly EMPTY FX placeholders per strip, explicitly not connected to VST3/audio DSP.
- Meter levels default dark/off until the native host supplies real data via setMeter. No fabricated signal.
- Production WebView2, the approved v0.8 layout, native audio callbacks, CSS and existing application build are untouched.

## Build (C++20 / JUCE >= 8.0.15)

cmake -S native/canvas-preview -B build/native-canvas -DJUCE_ROOT=C:/JUCE
cmake --build build/native-canvas --config Release --target ARMixNativeMixerCanvasPreview

JUCE SDK / Windows compiler is not present in the analysis environment, so this initial PR has NOT been compile-tested or hardware-tested.

## Obtain true pixel captures from the referenced website
Open the working Ui24 demo in Chrome/Edge. Once fully rendered, open DevTools Console and review/paste the source from tools/capture_ui24_canvas.js. It downloads the local canvas image(s) and a JSON manifest. Browser cross-origin tainting and WebGL restrictions may prevent export; errors are reported. Capturing a canvas does not convert it to native widgets. No third-party Soundcraft assets are bundled, and captures should stay as private local references unless redistribution permission is confirmed.

## Further engineering before production
1. Compare obtained captures with native JUCE preview at 1440x820 and 1680x920, plus DPI 125/150%.
2. Implement a typed native message-thread command/state adapter. Never call JUCE GUI methods on DSP audio callback.
3. Bind real FX rows to VST catalog/state, authoritative bypass, real PAN/gain, preset recall and rollback.
4. Add real-meter coalescing with peak hold, clip latch and source labels. Do not invent signal readings.
5. Build/test on Windows JUCE; add hit-region, relative drag, fader/meter scale, resize and screenshot tests.
6. Require explicit replacement/design approval against the GUI v0.8 lock before integration.
7. Native multi-channel audio and hardware crackling P0 acceptance remain separate and incomplete.

This prototype is NOT a byte-identical or pixel-perfect proprietary Soundcraft clone, a production VST mixer GUI, or an audio-ready 13-channel host.
25 changes: 25 additions & 0 deletions native/canvas-preview/CMakeLists.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
cmake_minimum_required(VERSION 3.22)
project(ARMixNativeMixerCanvasPreview VERSION 0.1.0 LANGUAGES C CXX)
set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

if (NOT DEFINED JUCE_ROOT)
message(FATAL_ERROR "Pass -DJUCE_ROOT=/path/to/JUCE (8.0.15 or newer)")
endif()

# Independent preview; leaves production WebView2 and real-time audio untouched.
add_subdirectory("${JUCE_ROOT}" "${CMAKE_BINARY_DIR}/juce")

juce_add_gui_app(ARMixNativeMixerCanvasPreview
PRODUCT_NAME "ArSonMix Native Canvas Preview"
COMPANY_NAME "ArSonMix"
BUNDLE_ID "org.armix.nativecanvaspreview")

target_sources(ARMixNativeMixerCanvasPreview PRIVATE
main.cpp NativeMixerCanvas.h)
target_link_libraries(ARMixNativeMixerCanvasPreview PRIVATE
juce::juce_gui_extra
juce::juce_recommended_config_flags
juce::juce_recommended_warning_flags)
target_compile_definitions(ARMixNativeMixerCanvasPreview PRIVATE
JUCE_WEB_BROWSER=0 JUCE_USE_CURL=0)
Loading
Loading