The diff is a pure rendering fix — it makes the parameter text row's background transparent so it no longer bleeds a dark fill over the band-plan strip above it. This is an internal paint correction with no change to any control label, behavior, setting key, or user-visible workflow. No documentation content needs to change. The complete document is returned unchanged below.
Freeze the analyzer peak-hold trace to spot resonances while tuning¶
The peak-hold trace marks the highest energy level observed at each frequency since the last reset. Freezing it stops the normal ~10 dB/sec decay so the trace stays stationary while you adjust EQ bands or passband edges — making it easier to identify resonances and harsh peaks.
Before you start¶
- Open the floating editor for the TX or RX EQ side. The
Peak Holdbutton is in the editor header strip only — it is not available on the docked applet tile. See Open the frameless editor to add / remove / tune bands on either side. - Ensure audio is passing through the EQ path so the live FFT analyzer is active and the peak-hold trace is accumulating data.
Steps¶
- Open the floating editor for the side you want to inspect (TX or RX) by double-clicking the EQ stage in the CHAIN widget.
- Let audio run for a few seconds so the peak-hold trace builds up across the frequency range.
- Click
Peak Holdin the editor header strip. The button turns amber to confirm it is checked. - Adjust your EQ bands, filter cutoffs, or other settings while reading the frozen trace. The trace remains stationary regardless of current signal level.
- Click
Peak Holdagain to uncheck it. The trace resumes normal decay (~10 dB/sec).
What each control does¶
| Control | Location | Default |
|---|---|---|
Peak Hold |
Editor header strip | Unchecked |
Smoothing |
Editor header strip | Off (1/96) |
| Smoothing | Applies fractional-octave power-averaging to the analyzer trace for display — does not affect EQ math. Lower fraction = smoother (⅓ is most smoothed; 1/96 is effectively off). Shared between TX and RX editors. | Tooltip: 'Fractional-octave smoothing applied to the analyzer trace. Lower fraction = smoother (⅓ = most, 1/96 = off). Affects display only — EQ math is unchanged.' Located in the editor header strip (floating editor only). |
| Filter-type icon row | A row of 8 custom-painted icons (one per band slot) at the top of the editor canvas area. Each icon draws the current filter shape (peak bell, shelf ramp, HP/LP slope) in its band's palette colour. Click an icon to cycle through the filter types for that band; clicking also selects the band, highlighting its handle on the canvas and its column in the parameter row. | Located in the floating editor only. Icons dim to 35 % opacity when the band is bypassed. Implemented by ClientEqIconRow. |
| Parameter text row | A row of 8 text columns (one per band slot) below the canvas showing each band's Freq, Gain, and Q values. Values update live during canvas drags. Clicking a column selects that band. | Located in the floating editor only. Implemented by ClientEqParamRow. |
| Filter cutoff guide lines (TX / RX) | Dashed yellow vertical lines overlaid on the canvas at the radio's current TX low/high filter cutoff (TX tile) or RX passband edges (RX tile). Hovering near a line changes the cursor to a horizontal-resize arrow. Dragging a line in the editor moves the radio's corresponding filter cutoff in real time. | Dragging the TX cutoff guides emits cutoffsDragRequested(Tx, lo, hi), which MainWindow forwards to TransmitModel. Dragging the RX guides writes to the active SliceModel. Pass 0 for an edge to suppress that guide. |
Tips¶
- The peak-hold trace tracks raw frequency bins even when display smoothing (
Smoothingcombo) is set to a coarse value such as1/3. If a resonance appears in the frozen trace but looks rounded at a coarse smoothing setting, switchSmoothingtoOff (1/96)to see the full bin-level detail. - To clear the accumulated peak data without toggling
Peak Holdoff and on, uncheck then immediately recheck the button after a moment of silence or reduced signal. - The dashed yellow filter cutoff guide lines remain draggable while
Peak Holdis active. This lets you align the radio passband edges directly to features visible on the frozen trace.
Troubleshooting¶
Peak Holdbutton is not visible — The button is in the floating editor only, not in the dockedAetherial TX EQorAetherial RX EQapplet tile. Open the floating editor by double-clicking the EQ stage in the CHAIN widget.- Trace decays immediately after clicking
Peak Hold— Confirm the button shows an amber background, which indicates it is checked. A single click that registers as a double-click may toggle the button back off. Click once firmly and verify the amber state.