// SPDX-License-Identifier: MIT // SPDX-FileCopyrightText: 2026 Martino Ferrari // The compact readouts at the top of the dock: a read-only copy of the cursors table and of the // measurement values, in a fixed width, with an Edit button for each that opens the full panel. // // The strings are not formatted here. `update_cursors_pane()` and `update_measures()` format each value // once and hand the same variable to the page's label and to `dock_cursor_cell()` / `dock_measure_value()`, // so the two views cannot disagree. Every label is ellipsized at a fixed `width-chars`, so the dock's // layout does not depend on what a value reads; the full text is the label's tooltip. #include "ui_app.hpp" #include #include #include namespace udpscope { namespace ui_impl { namespace { /// The width, in characters, of a value cell and of a `who` / type cell. Fixed, so the dock is as wide /// with `--` as with `-123.456 mV`; their sum (5 + 3 x 9 characters) is what keeps the readouts inside the /// dock's 280 px. constexpr int kValueChars = 9; constexpr int kNameChars = 5; GtkWidget* fixed_label(const char* text, int chars, GtkAlign halign) { GtkWidget* l = gtk_label_new(text); gtk_widget_set_halign(l, halign); gtk_label_set_ellipsize(GTK_LABEL(l), PANGO_ELLIPSIZE_END); gtk_label_set_width_chars(GTK_LABEL(l), chars); gtk_label_set_max_width_chars(GTK_LABEL(l), chars); gtk_widget_add_css_class(l, "caption"); return l; } /// Sets a value label's text and, with it, the tooltip that carries what the ellipsis cut. The text is /// compared first so the per-frame write of an unchanged value costs nothing. void set_value_text(GtkWidget* label, const std::string& text) { if (label == nullptr) return; if (std::strcmp(gtk_label_get_text(GTK_LABEL(label)), text.c_str()) == 0) return; gtk_label_set_text(GTK_LABEL(label), text.c_str()); gtk_widget_set_tooltip_text(label, text.c_str()); } void on_edit_cursors(GtkButton*, gpointer user) { slideover_open(*static_cast(user), "cursors"); } void on_edit_measures(GtkButton*, gpointer user) { slideover_open(*static_cast(user), "measure"); } /// A click on a measurement's line opens that measurement's dialog, as the page row's `edit` button /// does. The line carries its index (plus one, so that zero is "none") in its data. void on_measure_line_pressed(GtkGestureClick* gesture, int n_press, double, double, gpointer user) { if (n_press != 1) return; GtkWidget* line = gtk_event_controller_get_widget(GTK_EVENT_CONTROLLER(gesture)); const int idx = GPOINTER_TO_INT(g_object_get_data(G_OBJECT(line), "udpscope-measure-index")) - 1; if (idx < 0) return; open_measure_dialog(*static_cast(user), idx); } /// A section's heading row: its title at the left, its Edit button at the right. GtkWidget* section_head(const char* title, GtkWidget** edit_out, GCallback on_edit, App* app, const char* tip) { GtkWidget* row = gtk_box_new(GTK_ORIENTATION_HORIZONTAL, 6); GtkWidget* t = gtk_label_new(title); gtk_widget_set_halign(t, GTK_ALIGN_START); gtk_widget_set_hexpand(t, true); gtk_widget_add_css_class(t, "caption-heading"); gtk_box_append(GTK_BOX(row), t); GtkWidget* edit = gtk_button_new_with_label("Edit"); gtk_widget_add_css_class(edit, "flat"); gtk_widget_set_tooltip_text(edit, tip); g_signal_connect(edit, "clicked", on_edit, app); gtk_box_append(GTK_BOX(row), edit); *edit_out = edit; return row; } /// The same header `cursors_header()` writes into the page's table, small. void dock_cursors_header(GtkGrid* grid) { const char* texts[4] = {"", "A", "B", "delta"}; for (int c = 0; c < 4; ++c) { GtkWidget* l = fixed_label(texts[c], c == 0 ? kNameChars : kValueChars, c == 0 ? GTK_ALIGN_START : GTK_ALIGN_END); gtk_widget_add_css_class(l, "dim-label"); gtk_grid_attach(grid, l, c, 0, 1, 1); } } } // namespace GtkWidget* build_readouts_dock(App& app) { GtkWidget* box = gtk_box_new(GTK_ORIENTATION_VERTICAL, 4); gtk_widget_set_margin_top(box, 6); gtk_widget_set_margin_bottom(box, 6); gtk_widget_set_margin_start(box, 6); gtk_widget_set_margin_end(box, 6); GtkWidget* heading = gtk_label_new("Readouts"); gtk_widget_set_halign(heading, GTK_ALIGN_START); gtk_widget_add_css_class(heading, "heading"); gtk_box_append(GTK_BOX(box), heading); gtk_box_append(GTK_BOX(box), section_head("Cursors", &app.dock_cursors_edit, G_CALLBACK(on_edit_cursors), &app, "the cursors' full panel")); app.dock_cursor_grid = gtk_grid_new(); gtk_grid_set_row_spacing(GTK_GRID(app.dock_cursor_grid), 2); gtk_grid_set_column_spacing(GTK_GRID(app.dock_cursor_grid), 4); gtk_box_append(GTK_BOX(box), app.dock_cursor_grid); gtk_box_append(GTK_BOX(box), section_head("Measurements", &app.dock_measures_edit, G_CALLBACK(on_edit_measures), &app, "the measurements' full panel")); app.dock_measures_box = gtk_box_new(GTK_ORIENTATION_VERTICAL, 2); gtk_box_append(GTK_BOX(box), app.dock_measures_box); app.dock_readouts = box; // The tables are built from the pages' current lines, which exist already when the pages were built // first; otherwise the pages' own rebuild fills them. dock_rebuild_cursors(app); dock_rebuild_measures(app); return box; } void dock_rebuild_cursors(App& app) { if (app.dock_cursor_grid == nullptr) return; GtkGrid* grid = GTK_GRID(app.dock_cursor_grid); GtkWidget* child = gtk_widget_get_first_child(app.dock_cursor_grid); while (child != nullptr) { GtkWidget* next = gtk_widget_get_next_sibling(child); gtk_grid_remove(grid, child); child = next; } app.dock_cursor_lines.clear(); dock_cursors_header(grid); int at = 1; for (const App::CursorLine& src : app.cursors_lines) { App::DockCursorLine line; line.label = fixed_label("", kNameChars, GTK_ALIGN_START); if (src.label != nullptr) { // The page's `who` cell, verbatim: a chip and a name as markup, or plain text. const char* text = gtk_label_get_label(GTK_LABEL(src.label)); if (gtk_label_get_use_markup(GTK_LABEL(src.label))) { gtk_label_set_markup(GTK_LABEL(line.label), text); } else { gtk_label_set_text(GTK_LABEL(line.label), text); } const char* tip = gtk_widget_get_tooltip_text(src.label); gtk_widget_set_tooltip_text(line.label, tip != nullptr ? tip : gtk_label_get_text(GTK_LABEL(src.label))); } gtk_grid_attach(grid, line.label, 0, at, 1, 1); GtkWidget** cells[3] = {&line.a, &line.b, &line.d}; for (int c = 0; c < 3; ++c) { GtkWidget* v = fixed_label("", kValueChars, GTK_ALIGN_END); gtk_widget_add_css_class(v, "numeric"); gtk_label_set_selectable(GTK_LABEL(v), true); gtk_grid_attach(grid, v, c + 1, at, 1, 1); *cells[c] = v; } app.dock_cursor_lines.push_back(line); ++at; } } void dock_rebuild_measures(App& app) { if (app.dock_measures_box == nullptr) return; GtkWidget* child = gtk_widget_get_first_child(app.dock_measures_box); while (child != nullptr) { GtkWidget* next = gtk_widget_get_next_sibling(child); gtk_box_remove(GTK_BOX(app.dock_measures_box), child); child = next; } app.dock_measure_labels.clear(); if (app.measures.empty()) { GtkWidget* none = gtk_label_new("no measurements"); gtk_widget_set_halign(none, GTK_ALIGN_START); gtk_widget_add_css_class(none, "caption"); gtk_widget_add_css_class(none, "dim-label"); gtk_box_append(GTK_BOX(app.dock_measures_box), none); return; } for (std::size_t i = 0; i < app.measures.size(); ++i) { const Measure& m = app.measures[i]; GtkWidget* line = gtk_box_new(GTK_ORIENTATION_HORIZONTAL, 6); g_object_set_data(G_OBJECT(line), "udpscope-measure-index", GINT_TO_POINTER(static_cast(i) + 1)); GtkWidget* chip = gtk_label_new(""); gtk_label_set_markup(GTK_LABEL(chip), measure_chip_markup(app, m.signal).c_str()); gtk_widget_set_tooltip_text(chip, m.signal.c_str()); gtk_box_append(GTK_BOX(line), chip); GtkWidget* kind = fixed_label(measure_type_name(m.type), 12, GTK_ALIGN_START); gtk_widget_set_hexpand(kind, true); gtk_widget_set_tooltip_text(kind, (m.signal + "\n" + measure_type_name(m.type)).c_str()); gtk_box_append(GTK_BOX(line), kind); GtkWidget* value = fixed_label("--", kValueChars, GTK_ALIGN_END); gtk_widget_add_css_class(value, "numeric"); gtk_label_set_selectable(GTK_LABEL(value), true); gtk_box_append(GTK_BOX(line), value); // On the line and not on the value label, which is selectable and so keeps its own clicks. GtkGesture* click = gtk_gesture_click_new(); g_signal_connect(click, "pressed", G_CALLBACK(on_measure_line_pressed), &app); gtk_widget_add_controller(line, GTK_EVENT_CONTROLLER(click)); gtk_box_append(GTK_BOX(app.dock_measures_box), line); app.dock_measure_labels.push_back(value); } } void dock_cursor_cell(App& app, std::size_t line, const std::string& a, const std::string& b, const std::string& d) { if (line >= app.dock_cursor_lines.size()) return; // mid-rebuild const App::DockCursorLine& l = app.dock_cursor_lines[line]; set_value_text(l.a, a); set_value_text(l.b, b); set_value_text(l.d, d); } void dock_measure_value(App& app, std::size_t i, const std::string& text) { if (i >= app.dock_measure_labels.size()) return; // mid-rebuild set_value_text(app.dock_measure_labels[i], text); } } // namespace ui_impl } // namespace udpscope