Struct WGPUBackend 

pub struct WGPUBackend {
    pub device: Device,
    pub queue: Queue,
    pub surface: Surface<'static>,
    pub config: SurfaceConfiguration,
}

The wgpu-backed Backend implementation. Inserted as a resource once init finishes (see the Backend trait docs for how that’s driven); everything in super that uploads to the GPU (Res<WGPUBackend> in an Asset::upload impl) reads device/queue directly off this.

Fields

device: Device

queue: Queue

surface: Surface<'static>

config: SurfaceConfiguration

Implementations

impl WGPUBackend

pub fn readback_buffer(&self, src: &Buffer) -> impl SpawnableFuture<Vec<u8>>

Copies src into a temporary staging buffer, begins a GPU readback, and returns a future that resolves to the copied bytes once it’s done.

The copy is submitted eagerly, right away — do not call mid-frame; call after present or outside of frame encoding. Only the wait for the GPU to finish mapping it is deferred into the returned future.

This doesn’t run itself — drive it with AsyncEventWriter::spawn to get the result delivered as an event, or BackgroundTasks::spawn_async directly if you’d rather hold onto a TaskHandle and poll it yourself.

pub fn readback_buffer_as<T: Pod + Send + 'static>( &self, src: &Buffer, ) -> impl SpawnableFuture<Vec<T>>

Same as readback_buffer but the resolved bytes are cast to T.

Trait Implementations

impl Asset<WGPUBackend> for GPUCompute

type Source = ComputeDescriptor<'static>

The raw source representation stored in Assets.

type Deps<'a> = ()

Resources (beyond B itself) required to perform the conversion. Use () when there are no extra dependencies.

fn upload<'a>( source: &ComputeDescriptor<'_>, backend: &WGPUBackend, _deps: &(), ) -> Option<Self>

Convert source into a processed asset using backend and deps.

impl Asset<WGPUBackend> for GPUCubemap

type Source = CubemapDescriptor

The raw source representation stored in Assets.

type Deps<'a> = Res<'a, MipmapGenerator>

Resources (beyond B itself) required to perform the conversion. Use () when there are no extra dependencies.

fn upload<'a>( source: &CubemapDescriptor, backend: &WGPUBackend, mipmap_generator: &Res<'a, MipmapGenerator>, ) -> Option<Self>

Convert source into a processed asset using backend and deps.

impl<T> Asset<WGPUBackend> for GPUBindingInstance<T>

where T: BindGroupTarget + 'static + Send + Sync,

type Source = BindingInstanceDescriptor<T>

The raw source representation stored in Assets.

type Deps<'a> = (Res<'a, ProcessedAssets<T>>, Res<'a, ProcessedAssets<GPUTexture>>, Res<'a, ProcessedAssets<GPUTextureArray>>, Res<'a, ProcessedAssets<GPUCubemap>>, Res<'a, GlobalSamplers>)

Resources (beyond B itself) required to perform the conversion. Use () when there are no extra dependencies.

fn upload<'a>( source: &Self::Source, backend: &WGPUBackend, deps: &Self::Deps<'a>, ) -> Option<Self>

Convert source into a processed asset using backend and deps.

impl Asset<WGPUBackend> for GPUMaterial

type Source = MaterialDescriptor<'static>

The raw source representation stored in Assets.

type Deps<'a> = ()

Resources (beyond B itself) required to perform the conversion. Use () when there are no extra dependencies.

fn upload<'a>( source: &MaterialDescriptor<'_>, backend: &WGPUBackend, _deps: &(), ) -> Option<Self>

Convert source into a processed asset using backend and deps.

impl Asset<WGPUBackend> for GPUMesh

type Source = MeshDescriptor

The raw source representation stored in Assets.

type Deps<'a> = ()

Resources (beyond B itself) required to perform the conversion. Use () when there are no extra dependencies.

fn upload<'a>( source: &MeshDescriptor, backend: &WGPUBackend, _deps: &(), ) -> Option<Self>

Convert source into a processed asset using backend and deps.

impl Asset<WGPUBackend> for GPUTextureArray

type Source = TextureArrayDescriptor

The raw source representation stored in Assets.

type Deps<'a> = Res<'a, MipmapGenerator>

Resources (beyond B itself) required to perform the conversion. Use () when there are no extra dependencies.

fn upload<'a>( source: &TextureArrayDescriptor, backend: &WGPUBackend, mipmap_generator: &Res<'a, MipmapGenerator>, ) -> Option<Self>

Convert source into a processed asset using backend and deps.

impl Asset<WGPUBackend> for GPUTexture

type Source = TextureDescriptor

The raw source representation stored in Assets.

type Deps<'a> = Res<'a, MipmapGenerator>

Resources (beyond B itself) required to perform the conversion. Use () when there are no extra dependencies.

fn upload<'a>( source: &TextureDescriptor, backend: &WGPUBackend, mipmap_generator: &Res<'a, MipmapGenerator>, ) -> Option<Self>

Convert source into a processed asset using backend and deps.

impl Backend for WGPUBackend

fn init( handle: impl GPUSurfaceHandle, width: u32, height: u32, sender: InitSender<Self>, )

Native blocks the calling thread on init_async via pollster::block_on (fine here — this only runs once, during App::build, and there’s no other work competing for the thread yet). Web can’t block its single thread, so it hands init_async to wasm_bindgen_futures::spawn_local instead and returns immediately — GraphicsPlugin polls the resulting sender/InitReceiver pair every tick either way, so callers don’t need to know which path ran. A second Backend implementation should follow the same split if it also needs to run on both targets.

type Frame = WGPUFrame

The per-frame type that exposes rendering operations.

fn resize(&mut self, width: u32, height: u32)

Called when the window is resized. Override to recreate the swapchain.

fn acquire(&mut self) -> Result<Self::Frame, AcquireError>

Acquire the next frame for rendering.

fn present(&mut self, frame: Self::Frame)

Present the completed frame to the display.

impl LazyResource<WGPUBackend> for MipmapGenerator

type Deps<'a> = ()

Other resources this singleton needs before it can be built. Use () if none are needed.

fn construct<'a>(backend: &WGPUBackend, _deps: &()) -> Option<Self>

Attempt to construct this singleton. Return None if construction can’t succeed yet for a reason not already covered by Deps readiness (e.g. a transient condition) — the plugin will retry next tick.

impl LazyResource<WGPUBackend> for GlobalSamplers

type Deps<'a> = ()

Other resources this singleton needs before it can be built. Use () if none are needed.

fn construct<'a>(backend: &WGPUBackend, _deps: &()) -> Option<Self>

Attempt to construct this singleton. Return None if construction can’t succeed yet for a reason not already covered by Deps readiness (e.g. a transient condition) — the plugin will retry next tick.