mirror of
https://github.com/slint-ui/slint.git
synced 2025-10-01 06:11:16 +00:00

The default backend does not select any features or backends by default on the Cargo.toml feature level. And with this change it also doesn't do that anymore based on the target platform. That means if the rust api crate is built with default-features = false, no backend will be selected and the user has to take care of backend initialization through other means. The feature defaults, generally, are in the rust API crate, the interpreter crate and C++ CMakeLists.txt. The latter triggers a cargo build of sixtyfps-cpp with --no-default-features. However the cpp_test job in the CI doesn't build sixtyfps-cpp with CMake but instead calls cargo directly. Therefore the defaults are now also coded in the sixtyfps-cpp Cargo.toml, to ensure that *a* rendering backend is chosen (since the cfg.target bit is gone).
96 lines
3.8 KiB
Rust
96 lines
3.8 KiB
Rust
/* LICENSE BEGIN
|
|
This file is part of the SixtyFPS Project -- https://sixtyfps.io
|
|
Copyright (c) 2021 Olivier Goffart <olivier.goffart@sixtyfps.io>
|
|
Copyright (c) 2021 Simon Hausmann <simon.hausmann@sixtyfps.io>
|
|
|
|
SPDX-License-Identifier: GPL-3.0-only
|
|
This file is also available under commercial licensing terms.
|
|
Please contact info@sixtyfps.io for more information.
|
|
LICENSE END */
|
|
/*!
|
|
|
|
**NOTE**: This library is an **internal** crate for the [SixtyFPS project](https://sixtyfps.io).
|
|
This crate should **not be used directly** by applications using SixtyFPS.
|
|
You should use the `sixtyfps` crate instead.
|
|
|
|
**WARNING**: This crate does not follow the semver convention for versioning and can
|
|
only be used with `version = "=x.y.z"` in Cargo.toml.
|
|
|
|
|
|
The purpose of this crate is to select the default backend for [SixtyFPS](https://sixtyfps.io)
|
|
|
|
The backend can either be a runtime or a build time decision. The runtime decision is decided
|
|
by the `SIXTYFPS_BACKEND` environment variable. The built time default depends on the platform.
|
|
In order for the crate to be available at runtime, they need to be added as feature
|
|
|
|
*/
|
|
#![doc(html_logo_url = "https://sixtyfps.io/resources/logo.drawio.svg")]
|
|
|
|
cfg_if::cfg_if! {
|
|
if #[cfg(feature = "sixtyfps-rendering-backend-qt")] {
|
|
use sixtyfps_rendering_backend_qt as default_backend;
|
|
} else if #[cfg(feature = "sixtyfps-rendering-backend-gl")] {
|
|
use sixtyfps_rendering_backend_gl as default_backend;
|
|
}
|
|
}
|
|
|
|
cfg_if::cfg_if! {
|
|
if #[cfg(any(
|
|
feature = "sixtyfps-rendering-backend-qt",
|
|
feature = "sixtyfps-rendering-backend-gl"
|
|
))] {
|
|
pub fn backend() -> &'static dyn sixtyfps_corelib::backend::Backend {
|
|
sixtyfps_corelib::backend::instance_or_init(|| {
|
|
let backend_config = std::env::var("SIXTYFPS_BACKEND").unwrap_or_default();
|
|
|
|
#[cfg(feature = "sixtyfps-rendering-backend-qt")]
|
|
if backend_config == "Qt" {
|
|
return Box::new(sixtyfps_rendering_backend_qt::Backend);
|
|
}
|
|
#[cfg(feature = "sixtyfps-rendering-backend-gl")]
|
|
if backend_config == "GL" {
|
|
return Box::new(sixtyfps_rendering_backend_gl::Backend);
|
|
}
|
|
|
|
#[cfg(any(
|
|
feature = "sixtyfps-rendering-backend-qt",
|
|
feature = "sixtyfps-rendering-backend-gl"
|
|
))]
|
|
if !backend_config.is_empty() {
|
|
eprintln!("Could not load rendering backend {}, fallback to default", backend_config)
|
|
}
|
|
|
|
#[cfg(feature = "sixtyfps-rendering-backend-gl")]
|
|
if !default_backend::IS_AVAILABLE {
|
|
// If Qt is not available always fallback to Gl
|
|
return Box::new(sixtyfps_rendering_backend_gl::Backend);
|
|
}
|
|
|
|
Box::new(default_backend::Backend)
|
|
})
|
|
}
|
|
pub use default_backend::{
|
|
native_widgets, Backend, NativeGlobals, NativeWidgets, HAS_NATIVE_STYLE,
|
|
};
|
|
} else {
|
|
pub fn backend() -> &'static dyn sixtyfps_corelib::backend::Backend {
|
|
sixtyfps_corelib::backend::instance().expect("no default backend configured, the backend must be initialized manually")
|
|
}
|
|
|
|
pub type NativeWidgets = ();
|
|
pub type NativeGlobals = ();
|
|
pub mod native_widgets {}
|
|
pub const HAS_NATIVE_STYLE: bool = false;
|
|
}
|
|
}
|
|
|
|
#[doc(hidden)]
|
|
#[cold]
|
|
#[cfg(not(target_arch = "wasm32"))]
|
|
pub fn use_modules() {
|
|
sixtyfps_corelib::use_modules();
|
|
#[cfg(feature = "sixtyfps-rendering-backend-qt")]
|
|
sixtyfps_rendering_backend_qt::use_modules();
|
|
#[cfg(feature = "sixtyfps-rendering-backend-gl")]
|
|
sixtyfps_rendering_backend_gl::use_modules();
|
|
}
|