pub struct Instance { /* private fields */ }
Expand description
Context for all other wgpu objects. Instance of wgpu.
This is the first thing you create when using wgpu.
Its primary use is to create Adapter
s and Surface
s.
Does not have to be kept alive.
Corresponds to WebGPU GPU
.
Implementations§
source§impl Instance
impl Instance
sourcepub fn enumerate_adapters(
&self,
backends: Backends
) -> impl Iterator<Item = Adapter>
pub fn enumerate_adapters(
&self,
backends: Backends
) -> impl Iterator<Item = Adapter>
sourcepub fn request_adapter(
&self,
options: &RequestAdapterOptions<'_>
) -> impl Future<Output = Option<Adapter>> + Send
pub fn request_adapter(
&self,
options: &RequestAdapterOptions<'_>
) -> impl Future<Output = Option<Adapter>> + Send
Retrieves an Adapter
which matches the given RequestAdapterOptions
.
Some options are “soft”, so treated as non-mandatory. Others are “hard”.
If no adapters are found that suffice all the “hard” options, None
is returned.
sourcepub unsafe fn create_adapter_from_hal<A: HalApi>(
&self,
hal_adapter: ExposedAdapter<A>
) -> Adapter
pub unsafe fn create_adapter_from_hal<A: HalApi>(
&self,
hal_adapter: ExposedAdapter<A>
) -> Adapter
sourcepub unsafe fn create_surface<W: HasRawWindowHandle + HasRawDisplayHandle>(
&self,
window: &W
) -> Surface
pub unsafe fn create_surface<W: HasRawWindowHandle + HasRawDisplayHandle>(
&self,
window: &W
) -> Surface
Creates a surface from a raw window handle.
If the specified display and window handle are not supported by any of the backends, then the surface will not be supported by any adapters.
Safety
- Raw Window Handle must be a valid object to create a surface upon and must remain valid for the lifetime of the returned surface.
- If not called on the main thread, metal backend will panic.
sourcepub fn poll_all(&self, force_wait: bool) -> bool
pub fn poll_all(&self, force_wait: bool) -> bool
Polls all devices.
If force_wait
is true and this is not running on the web, then this
function will block until all in-flight buffers have been mapped and
all submitted commands have finished execution.
Return true
if all devices’ queues are empty, or false
if there are
queue submissions still in flight. (Note that, unless access to all
Queue
s associated with this Instance
is coordinated somehow,
this information could be out of date by the time the caller receives
it. Queue
s can be shared between threads, and other threads could
submit new work at any time.)
On the web, this is a no-op. Device
s are automatically polled.
sourcepub fn generate_report(&self) -> GlobalReport
pub fn generate_report(&self) -> GlobalReport
Generates memory report.