Struct Gpu 

pub struct Gpu { /* private fields */ }

wgpu device + surface bundle for one OS window.

Implementations

impl Gpu

pub fn new( target: impl Into<SurfaceTarget<'static>>, size: (u32, u32), config: GpuConfig, ) -> Result<Self, GpuInitError>

Create the surface, adapter, device and queue for target (typically an Arc<winit::window::Window>) and configure the swap chain at size physical pixels, clamped by clamp_surface_size.

A non-sRGB surface format is preferred so the renderer’s colour maths — which writes linear-space values — isn’t gamma-corrected twice by the surface.

pub fn device_lost(&self) -> bool

Has this device been lost since it was created?

Set from wgpu’s device-lost callback (TDR / driver reset / GPU removal / RDP session change); our own Device::destroy is not counted. A lost device cannot be revived — every resource created from it is dead too — so the only recovery is to build a fresh Gpu for the same window, rebuild the renderer on the new device, and drop any GPU resources the app cached. Shells should poll this once per frame.

pub fn device(&self) -> &Arc<Device>

pub fn queue(&self) -> &Arc<Queue>

pub fn surface(&self) -> &Surface<'static>

pub fn surface_format(&self) -> TextureFormat

pub fn config(&self) -> &SurfaceConfiguration

The live swap-chain configuration — width / height are the clamped physical pixel size the shell should hand to layout and WgpuGfxCtx.

pub fn resize(&mut self, w: u32, h: u32)

Reconfigure the swap chain for a new physical size. A zero-sized (minimized) window is ignored — there is no presentable surface then, and wgpu rejects a zero extent.

pub fn acquire_frame(&self, request_redraw: impl Fn()) -> Option<SurfaceTexture>

Acquire the next surface texture, recovering from a stale swapchain by reconfiguring and retrying once.

Returns None when the frame must be skipped. request_redraw is invoked for the skip cases that can still recover on their own, so a reactive event loop (ControlFlow::Wait) wakes up to try again instead of idling forever; pass a closure that calls Window::request_redraw.