Struct SurfaceBootstrapConfig

pub struct SurfaceBootstrapConfig {
    pub requested_backends: Backends,
    pub allow_fallback_backends: bool,
    pub preferred_backends: Backends,
    pub power_preference: PowerPreference,
    pub force_fallback_adapter: bool,
}

Configuration used when bootstrapping GPU instances/adapters.

Defaults request all backends, prefer primary backends and high performance, allow backend fallback, and do not force a software adapter.

Examples

use ailloli_ui_render_wgpu::pipeline_cache::SurfaceBootstrapConfig;

let config = SurfaceBootstrapConfig::default();
assert_eq!(config.requested_backends, wgpu::Backends::all());
assert!(config.allow_fallback_backends);

Fields

requested_backends: Backends

Backends to request explicitly from wgpu.

allow_fallback_backends: bool

Allow falling back to non-requested backends.

preferred_backends: Backends

Preferred backend for ranking candidates.

power_preference: PowerPreference

Power preference used when requesting devices.

force_fallback_adapter: bool

Whether to request a fallback adapter if the preferred backend cannot be opened.

Implementations

impl SurfaceBootstrapConfig

pub fn with_requested_backends(requested: Backends) -> Self

Explicit backend selection by environment (no fallback to non-requested backends).

Examples

use ailloli_ui_render_wgpu::pipeline_cache::SurfaceBootstrapConfig;

let config = SurfaceBootstrapConfig::with_requested_backends(wgpu::Backends::GL);
assert_eq!(config.requested_backends, wgpu::Backends::GL);
assert!(!config.allow_fallback_backends);

pub fn vulkan_first() -> Self

Vulkan-first bootstrap with fallback to other available backends.

Examples

use ailloli_ui_render_wgpu::pipeline_cache::SurfaceBootstrapConfig;

let config = SurfaceBootstrapConfig::vulkan_first();
assert_eq!(config.requested_backends, wgpu::Backends::VULKAN);
assert!(config.allow_fallback_backends);

pub fn vulkan_only() -> Self

Vulkan-only bootstrap (strict, no fallback).

Examples

use ailloli_ui_render_wgpu::pipeline_cache::SurfaceBootstrapConfig;

let config = SurfaceBootstrapConfig::vulkan_only();
assert_eq!(config.preferred_backends, wgpu::Backends::VULKAN);
assert!(!config.allow_fallback_backends);

Trait Implementations

impl Clone for SurfaceBootstrapConfig

fn clone(&self) -> SurfaceBootstrapConfig

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SurfaceBootstrapConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for SurfaceBootstrapConfig

fn default() -> Self

Returns the “default value” for a type.

impl Copy for SurfaceBootstrapConfig