Struct SurfaceContext 

pub struct SurfaceContext {
    pub device: Device,
    pub queue: Queue,
    pub surface: Surface<'static>,
    pub surface_format: TextureFormat,
    /* private fields */
}

A windowed GPU context: device, queue, surface, and swap-chain config.

Unlike crate::GpuContext (headless), SurfaceContext presents frames to an OS window via a wgpu swap-chain.

Fields

device: Device

The logical GPU device.

queue: Queue

The command queue for the device.

surface: Surface<'static>

The wgpu surface attached to the OS window.

surface_format: TextureFormat

The texture format selected for the swap-chain.

Implementations

impl SurfaceContext

pub unsafe fn from_raw_handles( window_handle: RawWindowHandle, display_handle: RawDisplayHandle, config: SurfaceConfig, ) -> Result<Self, UiError>

Create a windowed surface context from raw OS window/display handles.

Safety

The caller must ensure that both window_handle and display_handle refer to valid OS objects and remain valid for the entire lifetime of the returned SurfaceContext. Dropping the underlying window while a SurfaceContext is live is undefined behaviour.

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

Resize the swap-chain to new dimensions.

Dimensions are clamped to a minimum of 1×1 to avoid a wgpu validation error.

pub fn acquire_frame(&self) -> Option<SurfaceTexture>

Acquire the next swap-chain frame.

Returns None on surface timeout, occlusion, or any other transient condition — the caller should skip the frame and try again next tick. Permanent errors (surface lost / outdated) are logged to stderr; the caller can recreate the SurfaceContext if needed.

pub fn present_frame(&self, frame: SurfaceTexture)

Present a previously acquired frame to the display.

pub fn width(&self) -> u32

Current swap-chain width in physical pixels.

pub fn height(&self) -> u32

Current swap-chain height in physical pixels.

pub fn format(&self) -> TextureFormat

The texture format used by the swap-chain.