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:
1 file changed
+53
@@ -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();
|
||||
|
||||
|
||||
Reference in new issue
Block a user