Jungfraujoch/viewer/windows/JFJochMouseShortcutsWindow.cpp

// SPDX-FileCopyrightText: 2026 Filip Leonarski, Paul Scherrer Institute <filip.leonarski@psi.ch>
// SPDX-License-Identifier: GPL-3.0-only

#include "JFJochMouseShortcutsWindow.h"

#include <QTextBrowser>
#include <QVBoxLayout>

namespace {
    struct Shortcut { QString action; QString effect; };
    struct Section { QString title; QVector<Shortcut> rows; };

    QString BuildHtml() {
        const QVector<Section> sections = {
            // JFJochImage / JFJochDiffractionImage mouse handling
            {"Diffraction image", {
                {"Wheel",                     "Zoom in / out, centred on the cursor"},
                {"Shift + wheel",             "Move the foreground (upper contrast limit) in linear steps"},
                {"Ctrl + wheel",              "Move the foreground in multiplicative steps (&times;1.15 per notch)"},
                {"F held + wheel",            "Same as Shift + wheel, for as long as F is held"},
                {"A",                         "Apply auto-contrast once; press again to switch on continuous Auto"},
                {"Home / End",                "Jump to the first / last image in the dataset"},
                {"Page Up / Page Down",       "Step one image forward / back"},
                {"Hover",                     "Status bar shows the pixel position, its value and the resolution"},
                {"Drag",                      "Pan the image"},
                {"Shift + move",              "Move the magnifier panel to the cursor; a frame shows the area it covers"},
                {"Shift + drag",              "Draw a rectangular ROI"},
                {"Shift + Ctrl + drag",       "Draw a circular ROI"},
                {"Drag an ROI or its handle", "Move or resize the selected ROI"},
                {"Right click",               "Copy / save the image, fit to view, clear the ROI"},
            }},
            // JFJochGridScanImage
            {"Grid scan", {
                {"Hover",         "Status bar shows the image number, the grid position and its value"},
                {"Shift + hover", "Load the image under the cursor while moving over the grid"},
                {"Double click",  "Load the image under the cursor"},
            }},
            {"Other views", {
                {"2D azimuthal image: double click",     "Zoom the diffraction image on the corresponding detector position"},
                {"Dataset-info plot: hover",             "Status bar shows the image number and the plotted value"},
                {"Dataset-info plot: Shift + hover",     "Load the hovered image"},
                {"Spot / reflection list: double click", "Zoom the diffraction image on that spot or prediction"},
                {"Image list: double click",             "Load that image"},
            }},
        };

        QString html = "<html><body>";
        for (const auto &section : sections) {
            html += "<h3>" + section.title + "</h3>";
            html += "<table cellspacing='0' cellpadding='4' width='100%'>";
            for (const auto &row : section.rows)
                html += "<tr><td width='38%'><b>" + row.action + "</b></td><td>" + row.effect + "</td></tr>";
            html += "</table>";
        }
        html += "</body></html>";
        return html;
    }
}

JFJochMouseShortcutsWindow::JFJochMouseShortcutsWindow(QWidget *parent) : QDialog(parent) {
    setWindowTitle("Mouse Shortcuts");
    resize(620, 620);

    auto *browser = new QTextBrowser(this);
    browser->setHtml(BuildHtml());

    auto *layout = new QVBoxLayout(this);
    layout->addWidget(browser);
}