Struct Gpu 

pub(crate) struct Gpu {
    pub(crate) instance: Instance,
    pub(crate) adapter: Adapter,
    pub(crate) device: Device,
    pub(crate) queue: Queue,
    pub(crate) capabilities: DeviceCapabilities,
}

The GPU context a scene draws with, requested asynchronously.

Everything here is a Send + Sync wgpu handle, so the request can run off the event loop’s thread and the context can cross back to it. The scene itself cannot cross: its ECS world is single-threaded, so it is built on the main thread once this arrives.

The context and its device outlive a suspension: rebuilding them would drop every pipeline, buffer and texture the scene holds, for a change the platform only makes to the native window.

Fields

instance: Instance

adapter: Adapter

device: Device

queue: Queue

capabilities: DeviceCapabilities

What the device can do beyond the WebGPU baseline, captured while the adapter is still here to report it.

wgpu::Device exposes its limits and features but not the downlevel flags, and the adapter is not kept once the device exists, so this is read once and carried; see DeviceCapabilities.

Implementations

impl Gpu

pub(crate) async fn request( instance: Instance, surface: Surface<'static>, ) -> Result<Self, Box<dyn Error + Send + Sync>>

Request the adapter and device that can present to surface.

surface is a probe: it exists only so the adapter is required to be able to present to the window, and is dropped again before the device is requested. The context deliberately ends up owning no surface, because a surface is tied to the native window it was created from — Android replaces that window across a suspension — while the adapter and device are not. Whoever presents builds one for the window it has at that moment.

Async because both requests resolve on the browser’s task queue on the web; blocking on them there would hang the page.

Trait Implementations

impl Clone for Gpu

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.