Struct wgpu::Instance

[+] Show declaration

pub struct Instance { /* fields omitted */ }

[−] Expand description

Context for all other wgpu objects. Instance of wgpu.

This is the first thing you create when using wgpu. Its primary use is to create Adapters and Surfaces.

Does not have to be kept alive.

Implementations

impl Instance[−]

pub fn new(backends: BackendBit) -> Self[−]

Create an new instance of wgpu.

Arguments

• backends - Controls from which backends wgpu will choose during instantiation.

pub fn enumerate_adapters(
    &self,
    backends: BackendBit
) -> impl Iterator<Item = Adapter>[−]

Retrieves all available Adapters that match the given BackendBit.

Arguments

• backends - Backends from which to enumerate adapters.

pub fn request_adapter(
    &self,
    options: &RequestAdapterOptions<'_>
) -> impl Future<Output = Option<Adapter>> + Send[−]

Retrieves an Adapter which matches the given RequestAdapterOptions.

Some options are "soft", so treated as non-mandatory. Others are "hard".

If no adapters are found that suffice all the "hard" options, None is returned.

pub unsafe fn create_surface<W: HasRawWindowHandle>(
    &self,
    window: &W
) -> Surface[−]

Creates a surface from a raw window handle.

Safety

• Raw Window Handle must be a valid object to create a surface upon.

Trait Implementations

impl Debug for Instance[+]

[+] Show hidden undocumented items

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

Formats the value using the given formatter.