feat(qt): consume the renderer preference at startup (#104)

The Settings > Appearance RENDERER row rendered and persisted into the
SAME ui_prefs the Slint reads (settings_qt.rs:2105-2110) but nothing
consumed it — pick "software", restart, and Qt stayed on its default:
the row lied. apply_renderer_preference() now runs before
QGuiApplication::new with the Slint engine's precedence
(main.rs:7825-7848): explicit Qt envs (QSG_RHI_BACKEND /
QT_QUICK_BACKEND) > QBZ_RENDERER > persisted pref > Qt default (Metal
on macOS, OpenGL on Linux — both measured healthy). Cross-frontend
mapping: the GPU tiers (auto/wgpu/gpu/hardware/hw) ARE Qt's default on
both platforms; gl -> QSG_RHI_BACKEND=opengl on Linux and the Metal
default on macOS (the Slint remaps GL to skia(Metal) there,
main.rs:7651-7653); software -> QT_QUICK_BACKEND=software.

Still owed and kept in PARITY-DEBT #104: the crash auto-revert
sentinel and the frame-liveness watchdog — forcing a renderer without
them can leave a broken startup.

Gate: build + 204/204 tests + both QML audits green.

km
This commit is contained in:
vicrodh committed 2026-08-02 00:30:26 -06:00
1 parent 9db2176d2e
commit 447efe2cd7
1 file changed
+53
+53
View File
@@ -2126,6 +2126,57 @@ fn publish_home_sections(sections: &home_qt::DiscoverSections) {
}
/// The Settings > Appearance RENDERER row, consumed at startup (PARITY-DEBT
/// #104 — the row rendered and persisted into the SAME ui_prefs the Slint
/// reads, but nothing consumed it, so it lied).
///
/// Precedence (Slint `requested_renderer_tier`, main.rs:7825-7848): explicit
/// Qt envs (`QSG_RHI_BACKEND` / `QT_QUICK_BACKEND`) > `QBZ_RENDERER` > the
/// persisted pref > Qt's default backend (Metal on macOS, OpenGL on Linux —
/// both measured healthy, 2026-08-01/02). Cross-frontend mapping: the GPU
/// tiers (`auto`/`wgpu`/`gpu`/`hardware`/`hw`) ARE Qt's default on both
/// platforms; `gl` maps to `QSG_RHI_BACKEND=opengl` on Linux and to the
/// Metal default on macOS (the Slint remaps GL to skia(Metal) there,
/// main.rs:7651-7653); `software` maps to `QT_QUICK_BACKEND=software`.
///
/// OWED and kept in PARITY-DEBT #104: the crash auto-revert sentinel and
/// the frame-liveness watchdog — forcing a renderer without them can leave
/// a broken startup, exactly what the Slint sentinel was built for.
fn apply_renderer_preference() {
if std::env::var_os("QSG_RHI_BACKEND").is_some()
|| std::env::var_os("QT_QUICK_BACKEND").is_some()
{
log::info!("[renderer] explicit Qt backend env present; leaving the choice to it");
return;
}
let choice = match std::env::var("QBZ_RENDERER")
.ok()
.map(|s| s.trim().to_ascii_lowercase())
.filter(|s| !s.is_empty() && s != "auto")
{
Some(v) => v,
None => settings_qt::pref_str("renderer", "auto"),
};
match choice.as_str() {
"software" | "cpu" | "soft" => {
std::env::set_var("QT_QUICK_BACKEND", "software");
log::info!("[renderer] '{choice}' -> QT_QUICK_BACKEND=software");
}
"gl" | "gles" | "femtovg" => {
if cfg!(target_os = "macos") {
log::info!("[renderer] '{choice}' on macOS -> Metal default (the Slint GL remap)");
} else {
std::env::set_var("QSG_RHI_BACKEND", "opengl");
log::info!("[renderer] '{choice}' -> QSG_RHI_BACKEND=opengl");
}
}
"auto" | "wgpu" | "gpu" | "hardware" | "hw" => {
log::info!("[renderer] '{choice}' -> Qt default backend (GPU path)");
}
other => log::warn!("[renderer] unrecognized choice '{other}' -> Qt default backend"),
}
}
fn main() {
qbz_log::install("info");
// i18n (phase 20): honor the persisted ui_prefs language; "auto"/missing
@@ -2159,6 +2210,8 @@ fn main() {
}
let _ = APP.set(runtime);
apply_renderer_preference();
let mut app = QGuiApplication::new();
let mut engine = QQmlApplicationEngine::new();