Struct Device 

pub struct Device { /* private fields */ }

Available on crate feature unstable-wgpu-28 and gles only.

Implementations

impl Device

pub fn context(&self) -> &AdapterContext

Returns the underlying EGL context.

impl Device

pub unsafe fn texture_from_raw( &self, name: NonZero<u32>, desc: &TextureDescriptor<'_>, drop_callback: Option<Box<dyn FnOnce() + Sync + Send>>, ) -> Texture

Available on native or Emscripten only.

Safety

• name must be created respecting desc
• name must be a texture
• If drop_callback is None, wgpu-hal will take ownership of the texture. If drop_callback is Some, the texture must be valid until the callback is called.

pub unsafe fn texture_from_raw_renderbuffer( &self, name: NonZero<u32>, desc: &TextureDescriptor<'_>, drop_callback: Option<Box<dyn FnOnce() + Sync + Send>>, ) -> Texture

Available on native or Emscripten only.

Safety

• name must be created respecting desc
• name must be a renderbuffer
• If drop_callback is None, wgpu-hal will take ownership of the renderbuffer. If drop_callback is Some, the renderbuffer must be valid until the callback is called.

Trait Implementations

impl Device for Device

type A = Api

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

Creates a new buffer.

unsafe fn destroy_buffer(&self, buffer: Buffer)

Free buffer and any GPU resources it owns.

unsafe fn add_raw_buffer(&self, _buffer: &Buffer)

A hook for when a wgpu-core buffer is created from a raw wgpu-hal buffer.

unsafe fn map_buffer( &self, buffer: &Buffer, range: Range<u64>, ) -> Result<BufferMapping, DeviceError>

Return a pointer to CPU memory mapping the contents of buffer.

unsafe fn unmap_buffer(&self, buffer: &Buffer)

Remove the mapping established by the last call to Device::map_buffer.

unsafe fn flush_mapped_ranges<I>(&self, buffer: &Buffer, ranges: I)

where I: Iterator<Item = Range<u64>>,

Indicate that CPU writes to mapped buffer memory should be made visible to the GPU.

unsafe fn invalidate_mapped_ranges<I>(&self, _buffer: &Buffer, _ranges: I)

Indicate that GPU writes to mapped buffer memory should be made visible to the CPU.

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

Creates a new texture.

unsafe fn destroy_texture(&self, texture: Texture)

unsafe fn add_raw_texture(&self, _texture: &Texture)

A hook for when a wgpu-core texture is created from a raw wgpu-hal texture.

unsafe fn create_texture_view( &self, texture: &Texture, desc: &TextureViewDescriptor<'_>, ) -> Result<TextureView, DeviceError>

unsafe fn destroy_texture_view(&self, _view: TextureView)

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

unsafe fn destroy_sampler(&self, sampler: Sampler)

unsafe fn create_command_encoder( &self, _desc: &CommandEncoderDescriptor<'_, Queue>, ) -> Result<CommandEncoder, DeviceError>

Create a fresh CommandEncoder.

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

Creates a bind group layout.

unsafe fn destroy_bind_group_layout(&self, _bg_layout: BindGroupLayout)

unsafe fn create_pipeline_layout( &self, desc: &PipelineLayoutDescriptor<'_, BindGroupLayout>, ) -> Result<PipelineLayout, DeviceError>

unsafe fn destroy_pipeline_layout(&self, _pipeline_layout: PipelineLayout)

unsafe fn create_bind_group( &self, desc: &BindGroupDescriptor<'_, BindGroupLayout, Buffer, Sampler, TextureView, AccelerationStructure>, ) -> Result<BindGroup, DeviceError>

unsafe fn destroy_bind_group(&self, _group: BindGroup)

unsafe fn create_shader_module( &self, desc: &ShaderModuleDescriptor<'_>, shader: ShaderInput<'_>, ) -> Result<ShaderModule, ShaderError>

unsafe fn destroy_shader_module(&self, _module: ShaderModule)

unsafe fn create_render_pipeline( &self, desc: &RenderPipelineDescriptor<'_, PipelineLayout, ShaderModule, PipelineCache>, ) -> Result<RenderPipeline, PipelineError>

unsafe fn destroy_render_pipeline(&self, pipeline: RenderPipeline)

unsafe fn create_compute_pipeline( &self, desc: &ComputePipelineDescriptor<'_, PipelineLayout, ShaderModule, PipelineCache>, ) -> Result<ComputePipeline, PipelineError>

unsafe fn destroy_compute_pipeline(&self, pipeline: ComputePipeline)

unsafe fn create_pipeline_cache( &self, _: &PipelineCacheDescriptor<'_>, ) -> Result<PipelineCache, PipelineCacheError>

unsafe fn destroy_pipeline_cache(&self, _: PipelineCache)

unsafe fn create_query_set( &self, desc: &QuerySetDescriptor<Option<&str>>, ) -> Result<QuerySet, DeviceError>

unsafe fn destroy_query_set(&self, set: QuerySet)

unsafe fn create_fence(&self) -> Result<Fence, DeviceError>

unsafe fn destroy_fence(&self, fence: Fence)

unsafe fn get_fence_value(&self, fence: &Fence) -> Result<u64, DeviceError>

unsafe fn wait( &self, fence: &Fence, wait_value: u64, timeout: Option<Duration>, ) -> Result<bool, DeviceError>

Wait for fence to reach value.

unsafe fn start_graphics_debugger_capture(&self) -> bool

Start a graphics debugger capture.

unsafe fn stop_graphics_debugger_capture(&self)

Stop a graphics debugger capture.

unsafe fn create_acceleration_structure( &self, _desc: &AccelerationStructureDescriptor<'_>, ) -> Result<AccelerationStructure, DeviceError>

unsafe fn get_acceleration_structure_build_sizes<'a>( &self, _desc: &GetAccelerationStructureBuildSizesDescriptor<'a, Buffer>, ) -> AccelerationStructureBuildSizes

unsafe fn get_acceleration_structure_device_address( &self, _acceleration_structure: &AccelerationStructure, ) -> u64

unsafe fn destroy_acceleration_structure( &self, _acceleration_structure: AccelerationStructure, )

fn tlas_instance_to_bytes(&self, _instance: TlasInstance) -> Vec<u8>

fn get_internal_counters(&self) -> HalCounters

fn check_if_oom(&self) -> Result<(), DeviceError>

fn pipeline_cache_validation_key(&self) -> Option<[u8; 16]>

unsafe fn pipeline_cache_get_data( &self, cache: &<Self::A as Api>::PipelineCache, ) -> Option<Vec<u8>>

fn generate_allocator_report(&self) -> Option<AllocatorReport>

impl Drop for Device

fn drop(&mut self)

Executes the destructor for this type.

impl DynResource for Device

fn as_any(&self) -> &(dyn Any + 'static)

fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

impl Send for Device

Available on send_sync only.

impl Sync for Device

Available on send_sync only.