Struct SurfaceState 

pub struct SurfaceState { /* private fields */ }

A configured wgpu surface, ready for frame acquisition.

Does NOT own the wgpu::Surface — the consumer creates the surface from their windowing system and passes it in. This struct manages configuration, resize, and frame acquisition.

Examples

let mut state = SurfaceState::configure(
    &surface, &adapter, &device, width, height,
    PresentModePreference::Vsync,
)?;

// On window resize:
state.resize(&surface, &device, new_width, new_height);

// Each frame:
let frame = state.get_current_texture(&surface)?;

Implementations

impl SurfaceState

pub fn configure( surface: &Surface<'_>, adapter: &Adapter, device: &Device, width: u32, height: u32, present_mode: PresentModePreference, ) -> Result<Self>

Configure a surface for rendering.

Selects the best available format (preferring sRGB) and alpha mode.

pub fn resize( &mut self, surface: &Surface<'_>, device: &Device, width: u32, height: u32, )

Reconfigure the surface after a resize.

Silently skips zero-size dimensions (common during window minimize).

pub fn acquire(&self, surface: &Surface<'_>) -> Result<SurfaceTexture>

Acquire the next frame texture.

pub fn format(&self) -> TextureFormat

The surface texture format.

pub fn size(&self) -> (u32, u32)

Current surface dimensions.