Struct RenderContext 

pub struct RenderContext {
    pub instance: Instance,
    pub devices: Vec<DeviceHandle>,
    /* private fields */
}

wgpu state for one process, with a memory hint that fits a shared GPU.

Fields

instance: Instance

devices: Vec<DeviceHandle>

Implementations

impl RenderContext

pub fn new() -> RenderContext

A context on the backends WGPU_BACKEND names, or this platform’s default_backends. WGPU_BACKEND stays available for explicit diagnostics and alternate drivers, and is never second-guessed.

pub async fn device( &mut self, compatible_surface: Option<&Surface<'_>>, ) -> Option<usize>

Index of a device that can present to compatible_surface, opening one if none of the existing devices can.

pub async fn create_surface<'w>( &mut self, window: impl Into<SurfaceTarget<'w>>, width: u32, height: u32, present_mode: PresentMode, ) -> Result<RenderSurface<'w>, CreateSurfaceError>

A surface for window, rendered at width x height.

Errors

Returns CreateSurfaceError::Surface if wgpu cannot create a surface for window, CreateSurfaceError::NoCompatibleDevice if no adapter can present to it, or CreateSurfaceError::UnsupportedSurfaceFormat if the surface offers neither Rgba8Unorm nor Bgra8Unorm.

pub async fn create_surface_unconfigured<'w>( &mut self, window: impl Into<SurfaceTarget<'w>>, width: u32, height: u32, present_mode: PresentMode, ) -> Result<RenderSurface<'w>, CreateSurfaceError>

Build a surface and render targets without creating its swapchain.

A caller that adjusts alpha or other configuration must configure the returned surface before acquiring a frame. Native windows do that once inside their existing validation error scope.

Errors

Returns the same surface, device and format errors as Self::create_surface.

pub fn resize_surface( &self, surface: &mut RenderSurface<'_>, width: u32, height: u32, )

Panics

If width or height is zero.

pub fn configure_surface(&self, surface: &RenderSurface<'_>)

Trait Implementations

impl Default for RenderContext

fn default() -> RenderContext

Returns the “default value” for a type.