Struct wgpu::Device

pub struct Device { /* fields omitted */ }

Open connection to a graphics and/or compute device.

Responsible for the creation of most rendering and compute resources. These are then used in commands, which are submitted to a Queue.

A device may be requested from an adapter with Adapter::request_device.

Implementations

impl Device

pub fn poll(&self, maintain: Maintain)

Check for resource cleanups and mapping callbacks.

no-op on the web, device is automatically polled.

pub fn features(&self) -> Features

List all features that may be used with this device.

Functions may panic if you use unsupported features.

pub fn limits(&self) -> Limits

List all limits that were requested of this device.

If any of these limits are exceeded, functions may panic.

pub fn create_shader_module(
    &self,
    desc: &ShaderModuleDescriptor<'_>
) -> ShaderModule

Creates a shader module from either SPIR-V or WGSL source code.

pub fn create_command_encoder(
    &self,
    desc: &CommandEncoderDescriptor<'_>
) -> CommandEncoder

Creates an empty CommandEncoder.

pub fn create_render_bundle_encoder(
    &self,
    desc: &RenderBundleEncoderDescriptor<'_>
) -> RenderBundleEncoder<'_>

Creates an empty RenderBundleEncoder.

pub fn create_bind_group(&self, desc: &BindGroupDescriptor<'_>) -> BindGroup

Creates a new BindGroup.

pub fn create_bind_group_layout(
    &self,
    desc: &BindGroupLayoutDescriptor<'_>
) -> BindGroupLayout

Creates a BindGroupLayout.

pub fn create_pipeline_layout(
    &self,
    desc: &PipelineLayoutDescriptor<'_>
) -> PipelineLayout

Creates a PipelineLayout.

pub fn create_render_pipeline(
    &self,
    desc: &RenderPipelineDescriptor<'_>
) -> RenderPipeline

Creates a RenderPipeline.

pub fn create_compute_pipeline(
    &self,
    desc: &ComputePipelineDescriptor<'_>
) -> ComputePipeline

Creates a ComputePipeline.

pub fn create_buffer(&self, desc: &BufferDescriptor<'_>) -> Buffer

Creates a Buffer.

pub fn create_texture(&self, desc: &TextureDescriptor<'_>) -> Texture

Creates a new Texture.

desc specifies the general format of the texture.

pub fn create_sampler(&self, desc: &SamplerDescriptor<'_>) -> Sampler

Creates a new Sampler.

desc specifies the behavior of the sampler.

pub fn create_query_set(&self, desc: &QuerySetDescriptor) -> QuerySet

Creates a new QuerySet.

pub fn create_swap_chain(
    &self,
    surface: &Surface,
    desc: &SwapChainDescriptor
) -> SwapChain

Create a new SwapChain which targets surface.

Panics

• A old SwapChainFrame is still alive referencing an old swapchain.
• Texture format requested is unsupported on the swap chain.

pub fn on_uncaptured_error(&self, handler: impl UncapturedErrorHandler)

Set a callback for errors that are not handled in error scopes.

pub fn start_capture(&self)

Starts frame capture.

pub fn stop_capture(&self)

Stops frame capture.

Trait Implementations

impl Debug for Device

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl DeviceExt for Device

fn create_buffer_init(&self, descriptor: &BufferInitDescriptor<'_>) -> Buffer

Creates a Buffer with data to initialize it.

fn create_texture_with_data(
    &self,
    queue: &Queue,
    desc: &TextureDescriptor<'_>,
    data: &[u8]
) -> Texture

Upload an entire texture and its mipmaps from a source buffer.

impl Drop for Device

fn drop(&mut self)

Executes the destructor for this type.