Skip to content

dBm scale: tooltip / docs for Ctrl-drag zoom shortcut #2724

Description

@ten9876

Follow-up from PR #2717 review.

The Ctrl-drag-on-the-dBm-strip span-zoom shortcut just shipped (smooth alternative to the 10 dB arrow-button steps) but is undocumented in the UI. New users will discover the up/down arrow buttons (visible affordance) but not the Ctrl-drag shortcut.

Suggested fix

Pick one (both is fine too):

A. In-UI tooltip on the dBm strip. In `SpectrumWidget` (where the strip is painted at `width() - DBM_STRIP_W`), wire a tooltip via `setToolTip()` (or the per-region tooltip path AetherSDR already uses for other spectrum-overlay surfaces). Suggested text:

dBm scale
• Drag — pan reference level
• Ctrl-drag — zoom span (anchor at bottom)
• ▲ / ▼ — ±10 dB steps

B. User-help docs. Add a "dBm scale" entry under `resources/help/` (or wherever the in-app help index lives) documenting the same three operations.

Why

Ctrl-modifiers on draggable surfaces are a power-user idiom — discoverable only by people who already expect Ctrl to be a "modifier mode" on a drag. A tooltip closes that gap without cluttering the visible UI.

Scope

Tooltip option is one file (`SpectrumWidget.cpp` setup site for the strip). Docs option is a couple of paragraphs under `resources/help/`. No behaviour change either way.

🤖 Spotted by Claude reviewing PR #2717; carried forward at maintainer (KK7GWY) request.

Metadata

Metadata

Assignees

No one assigned

    Labels

    GUIUser interfaceenhancementImprovement to existing featuregood first issueGood for newcomersmaintainer-reviewRequires maintainer review before any action is takenspectrumPanadapter and waterfall

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions