Public Access
Fn+h on any screen, text fields included, and ? outside Text Entry, open a panel over the content area: the screen's own keys, then the ones that work everywhere. Every App declares its keys for the state it is in (pages, viewers, dialogs and text fields answer for themselves); the App manager opens the panel and takes every key while it is open. About 30 hint lines are gone, from every App. What stays on a screen is state. The first-start Setup keeps its hints and teaches the key; a device set up before gets one Toast, once. The guide and the FAQ open with it. `key help` over the consoles. 476 host tests (8 new). Checked on the device with key help and screenshots: the Launcher, all nine Apps and several of their states. 8.5 KB of flash and 40 bytes of static RAM. Decisions Q196 to Q203 in docs/milestones/U1.md. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01EhqxQ49eCju4CzKYNjZzwT
70 lines
2.8 KiB
C++
70 lines
2.8 KiB
C++
#pragma once
|
|
|
|
#include <functional>
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
#include "canvas.h"
|
|
#include "dialog_model.h"
|
|
#include "key_help.h"
|
|
#include "line_editor.h"
|
|
#include "list_model.h"
|
|
#include "text_wrap.h"
|
|
#include "theme.h"
|
|
#include "toast_queue.h"
|
|
|
|
namespace roro {
|
|
|
|
struct StatusInfo {
|
|
std::string title;
|
|
int batteryPercent = -1; // -1: unknown
|
|
std::string clock = "--:--";
|
|
bool sdPresent = false;
|
|
int sdLevel = 0; // StorageMonitor level
|
|
char compose = 0; // pending Compose Key state
|
|
enum class Wifi { None, Searching, Connected, Monitoring } wifi = Wifi::None;
|
|
int wifiBars = 0; // 0..3 when Connected
|
|
int unread = 0; // unread messages across Services
|
|
enum class Gnss { None, Searching, TwoD, ThreeD } gnss = Gnss::None; // None: GNSS off (Q61)
|
|
int gnssSatellites = 0; // used in the Fix
|
|
bool tracking = false; // a Track is recording (Q63)
|
|
enum class Radio { None, Listening, Packet, Sweep } radio = Radio::None; // M3, Q101: Packet flashes
|
|
bool capturing = false; // a LoRa Capture is recording (Q97)
|
|
enum class Debug { Off, On, Client } debug = Debug::Off; // the Debug Console listens (ADR 0010, Q190)
|
|
|
|
bool operator==(const StatusInfo& o) const {
|
|
return title == o.title && batteryPercent == o.batteryPercent && clock == o.clock &&
|
|
sdPresent == o.sdPresent && sdLevel == o.sdLevel && compose == o.compose && wifi == o.wifi &&
|
|
wifiBars == o.wifiBars && unread == o.unread && gnss == o.gnss && gnssSatellites == o.gnssSatellites &&
|
|
tracking == o.tracking && radio == o.radio && capturing == o.capturing && debug == o.debug;
|
|
}
|
|
bool operator!=(const StatusInfo& o) const { return !(*this == o); }
|
|
};
|
|
|
|
namespace widgets {
|
|
|
|
// Width in pixels of text in the body font.
|
|
MeasureText bodyMeasure(Canvas& canvas);
|
|
|
|
void statusBar(Canvas& c, const StatusInfo& info);
|
|
|
|
// A selectable list; `label(i)` gives row i's text and `value(i)`, if given, a right-aligned value.
|
|
void list(Canvas& c, const ListModel& model, theme::Rect area, const std::function<std::string(int)>& label,
|
|
const std::function<std::string(int)>& value = nullptr);
|
|
|
|
// Pre-wrapped lines starting at `firstLine`, with a scroll indicator when they don't all fit.
|
|
void textLines(Canvas& c, const std::vector<std::string>& lines, int firstLine, theme::Rect area);
|
|
|
|
// One line of editable text with a cursor; scrolls horizontally to keep the cursor visible.
|
|
void lineEditor(Canvas& c, const LineEditor& editor, theme::Rect area);
|
|
|
|
void dialog(Canvas& c, const std::string& title, const std::string& message, const DialogModel& model);
|
|
|
|
// The help panel (Fn+h): the keys of the screen under it, over the whole content area.
|
|
void help(Canvas& c, const HelpModel& model);
|
|
|
|
void toast(Canvas& c, const Toast& t);
|
|
|
|
} // namespace widgets
|
|
} // namespace roro
|