Skip to content
Merged
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
5 changes: 5 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,3 +14,8 @@
- Always reconcile the GUI development branch and M2 realtime-performance branch before producing a Windows test binary. An artifact from one branch alone is not a combined release.
- Host bypass must pass the first block bit-exactly and must not latch the parameter bypass state. User bypass remains a smoothed, separately attached parameter.
- Build M3 in one PR with both Windows JUCE editor smoke and Linux sanitizer, inspect four actual Windows screenshots and benchmark/stress files before declaring ready-to-test. Do not call CI throughput a hardware xrun proof.

## M4 compact GUI gate
- Default FULL 704x520, minimum 660x490; MINI remains 330 high. Do not increase default GUI size without measuring element collision and user workflow.
- Header has no decorative separator rules. Only MODEL and PRESET need small captions; buttons self-label. Maintain >=4.5:1 contrast between static captions and their dark metal background, using the shared palette contract.
- Inspect screenshots from compiled JUCE at default/minimum, MINI and SIDECHAIN; preserve readable controls, meters, telemetry, preset and APVTS bindings. GUI changes must never modify engine DSP or latency.
22 changes: 22 additions & 0 deletions docs/GUI-PERFORMANCE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# ArSonComp GUI Performance — isolated LCD (2026-10-31)

## User observation
Task Manager screenshot: 0.4% CPU, 46.4 MB process memory and 2.7% GPU at one instant. These are not host callback duration, continuous memory growth, nor proof of a memory leak. Audio stutter cannot be diagnosed from one Task Manager sample.

## Change
- Split live graph/IN/GR/OUT into an **opaque child canvas**. Parent GUI paints the cached brushed chassis, toolbar and fixed hardware controls. Only the graph canvas receives continuous timer invalidation, preventing re-execution of the parent's text, material and header drawing every meter tick.
- Full canvas draws pre-rendered black LCD/grid plus actual signals/meters. MINI repaints only the 47px meter well. All image decoding and path generation remain on JUCE message thread.
- Preserve native threshold drag by forwarding graph canvas mouse coordinates to parent editor. APVTS automation and host callbacks remain untouched.
- Coalesce idle repaint requests when no new SPSC telemetry, no stopped-transport history ageing, and no perceptible meter decay. Keep the 30 Hz live visualization while active.
- Restore the intended 660×490 minimum / 704×520 default resize limits. No new audio worker, mutex, audio allocation, latency, DSP modification, or file I/O from processBlock.

## Test gate
- Actual Windows VST3 + Standalone, JUCE GUI render screenshots at minimum/default/SIDECHAIN/MINI; engine-safety test on Linux.
- Editor smoke asserts the opaque child bounds at 660×490, 704×520 and MINI, plus restored FULL layout.
- Physical Windows interface/DAW comparison is still required for GUI on/off, same driver/buffer and 30–60-minute run; measure actual xrun counters and sustained CPU/GPU and memory, not Task Manager snapshot alone.

Technical reference: JUCE developer ADC 2025 session on component hierarchy, opaque components, cached painting and avoiding repeated work in paint: https://conference.audio.dev/session/2025/understanding-juce-drawing/

## M4 compact and legible isolated LCD

Keep the optimized opaque LCD child and idle-repaint coalescing with the new default 704×520 and minimum 660×490. MINI remains 330px high with a 47px meter well. Captions have higher contrast, separator rules are removed, and the new geometry is covered by actual JUCE visual smoke tests. CI CPU timing is not real-device XRUN proof.
8 changes: 6 additions & 2 deletions docs/WINDOWS-QUICKSTART.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ Run `Standalone/ArSonComp.exe`. Select the input/output device in the standalone
- Vocal: listen for pumping, sibilance, level consistency and dry/wet behavior.
- Bass: use low frequencies and aggressive attack to check distortion and filter interactions.
- Transients: check drums with attack/hold/release; zero lookahead is not a true-peak limiter.
- UI: switch MINI/FULL; resize to 740x585 and 780x640, then try a larger window. Confirm bottom LCD value readout, labels, metering, and HP/LP controls.
- UI: switch MINI/FULL; resize to 660x490 and 704x520, then try a larger window. Confirm bottom LCD value readout, labels, metering, and HP/LP controls.
- Project: save, close, reload; confirm host parameters, style, bypass and input/output routing.
- For performance, use multiple instances in your host and compare CPU with plugin editors hidden/visible.

Expand All @@ -35,7 +35,7 @@ Check upper central transfer graph, red fading curve and live gain reduction lin

### Compact responsive GUI and bottom-of-LCD value display

The editor now defaults to **780×640**, with **740×585** minimum full size and **330px** high MINI. FULL restores the preceding expanded dimensions. The primary rotary row is shorter, Sidechain positions adapt to the editor width, and the actual meter/graph canvas retains useful space.
The editor now defaults to **704×520**, with **660×490** minimum full size and **330px** high MINI. FULL restores the preceding expanded dimensions. The primary rotary row is shorter, Sidechain positions adapt to the editor width, and the actual meter/graph canvas retains useful space.

Hover or drag **any** rotary knob or horizontal slider to show its name, exact value and unit in the **bottom centre of the black LCD**. The last focused value remains visible rather than flashing away. MINI uses the right-hand footer for the readout. There are **no overlay value bubbles or TooltipWindow**, so nothing obscures the controls. Double-click a knob or slider to restore its factory value. The JUCE APVTS host-automation attachments and audio DSP remain unchanged.

Expand All @@ -58,3 +58,7 @@ All rotary knobs retain their coral sector behind the black brushed-metal face a
### Premium brushed-metal and glass UI

The updated full editor should now have a horizontally brushed grey metal background and a recessed jet-black LCD for the dynamics history/transfer graph and segmented IN/GR/OUT meters. The knob area is shorter, leaving more room for the screen. Range/Hold/Mix/Link/HP/LP rails have a deep shadowed well sized to the original metallic thumb; all toggle captions appear on the left of their switches, including ACTIVE/BYPASS in the header. Both DYNAMICS and SIDECHAIN pages, MINI, old presets/automation and all audio routes continue working. No plugin audio processing or added algorithmic sample delay has changed.

### 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.
Loading
Loading