sixtyfps-rendering-backend-default 0.1.6

// Copyright © SixtyFPS GmbH <info@sixtyfps.io>
// SPDX-License-Identifier: (GPL-3.0-only OR LicenseRef-SixtyFPS-commercial)

/*!

**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_attr(
    not(any(
        feature = "sixtyfps-rendering-backend-qt",
        feature = "sixtyfps-rendering-backend-gl"
    )),
    no_std
)]

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();
}