Struct InstanceDescriptor 

pub struct InstanceDescriptor {
    pub backends: Backends,
    pub flags: InstanceFlags,
    pub memory_budget_thresholds: MemoryBudgetThresholds,
    pub backend_options: BackendOptions,
    pub display: Option<Box<dyn WgpuHasDisplayHandle>>,
}

Options for creating an instance.

If you want to allow control of instance settings via environment variables, call either InstanceDescriptor::from_env_or_default() or InstanceDescriptor::with_env(). Each type within this descriptor has its own equivalent methods, so you can select which options you want to expose to influence from the environment.

Fields

backends: Backends

Which Backends to enable.

Backends::BROWSER_WEBGPU has an additional effect: If it is set and a navigator.gpu object is present, this instance will only be able to create WebGPU adapters.

⚠️ On some browsers this check is insufficient to determine whether WebGPU is supported, as the browser may define the navigator.gpu object, but be unable to create any WebGPU adapters. For targeting both WebGPU & WebGL, it is recommended to use crate::util::new_instance_with_webgpu_detection.

If you instead want to force use of WebGL, either disable the webgpu compile-time feature or don’t include the Backends::BROWSER_WEBGPU flag in this field. If it is set and WebGPU support is not detected, the instance will use wgpu-core to create adapters, meaning that if the webgl feature is enabled, it is able to create a WebGL adapter.

flags: InstanceFlags

Flags to tune the behavior of the instance.

memory_budget_thresholds: MemoryBudgetThresholds

Memory budget thresholds used by some backends.

backend_options: BackendOptions

Options the control the behavior of specific backends.

display: Option<Box<dyn WgpuHasDisplayHandle>>

System platform or compositor connection to connect this Instance to.

If not None, it is invalid to pass a different [raw_window_handle::HasDisplayHandle] to create_surface().

• On GLES, this is required when intending to present on the platform, especially for Wayland.
• On Vulkan, Metal and Dx12, this is currently unused.

When used with winit, callers are expected to pass its OwnedDisplayHandle (created from the EventLoop) here.

Implementations

impl InstanceDescriptor

pub fn from_env_or_default() -> InstanceDescriptor

Choose instance options entirely from environment variables.

This is equivalent to calling from_env on every field.

pub fn with_env(self) -> InstanceDescriptor

Takes the given options, modifies them based on the environment variables, and returns the result.

This is equivalent to calling with_env on every field.

pub fn with_display_handle( self, display: Box<dyn WgpuHasDisplayHandle>, ) -> InstanceDescriptor

Appends the given display object to the descriptor.

Trait Implementations

impl Debug for InstanceDescriptor

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

Formats the value using the given formatter.

impl Default for InstanceDescriptor

fn default() -> InstanceDescriptor

Returns the “default value” for a type.