Struct nannou::wgpu::AdapterMap

pub struct AdapterMap { /* private fields */ }

A map from RequestAdapterOptions to active adapters.

Each time an adapter is requested via the App, it keeps track of which adapters are active. This is done in order to allow re-use of adapters and in turn re-use of logical devices and the sharing of resources between windows.

At the end of the application loop (after update and view have been called), adapters containing no active device connections are removed from the map.

Implementations

impl AdapterMap

pub fn get_or_request<'a, 'b>( &'a self, options: RequestAdapterOptions<&'b Surface>, instance: &'a Instance ) -> Option<Arc<ActiveAdapter>>

Check for an adaptor with the given options or request one.

First checks to see if an adapter for the given set of options is active. If so, returns a handle to this adapter. Otherwise, requests a new adapter via Adapter::request.

Returns None if there are no available adapters that meet the specified options.

pub fn request<'a, 'b>( &'a self, options: RequestAdapterOptions<&'b Surface>, instance: &'a Instance ) -> Option<Arc<ActiveAdapter>>

Request an adaptor with the given options.

This will always request a new adapter and will never attempt to share an existing one. The new adapter will take the place of the old within the map in the case that an existing active adapter exists.

Returns None if there are no available adapters that meet the specified options.

pub async fn get_or_request_async<'a, 'b>( &'a self, options: RequestAdapterOptions<&'b Surface>, instance: &'a Instance ) -> Option<Arc<ActiveAdapter>>

The async implementation of get_or_request.

pub async fn request_async<'a, 'b>( &'a self, options: RequestAdapterOptions<&'b Surface>, instance: &'b Instance ) -> Option<Arc<ActiveAdapter>>

The async implementation of request.

pub fn clear_inactive_adapters_and_devices(&self)

Clear all adapters that currently have no connected devices.

First clears all devices that no longer have any external references.

Trait Implementations

impl Default for AdapterMap

fn default() -> AdapterMap

Returns the “default value” for a type.