Trait iced::widget::shader::wgpu::hal::CommandEncoder

pub trait CommandEncoder<A>: WasmNotSendSync + Debugwhere
    A: Api,{
Show 43 methods    // Required methods
    unsafe fn begin_encoding(
        &mut self,
        label: Option<&str>
    ) -> Result<(), DeviceError>;
    unsafe fn discard_encoding(&mut self);
    unsafe fn end_encoding(
        &mut self
    ) -> Result<<A as Api>::CommandBuffer, DeviceError>;
    unsafe fn reset_all<I>(&mut self, command_buffers: I)
       where I: Iterator<Item = <A as Api>::CommandBuffer>;
    unsafe fn transition_buffers<'a, T>(&mut self, barriers: T)
       where T: Iterator<Item = BufferBarrier<'a, A>>;
    unsafe fn transition_textures<'a, T>(&mut self, barriers: T)
       where T: Iterator<Item = TextureBarrier<'a, A>>;
    unsafe fn clear_buffer(
        &mut self,
        buffer: &<A as Api>::Buffer,
        range: Range<u64>
    );
    unsafe fn copy_buffer_to_buffer<T>(
        &mut self,
        src: &<A as Api>::Buffer,
        dst: &<A as Api>::Buffer,
        regions: T
    )
       where T: Iterator<Item = BufferCopy>;
    unsafe fn copy_texture_to_texture<T>(
        &mut self,
        src: &<A as Api>::Texture,
        src_usage: TextureUses,
        dst: &<A as Api>::Texture,
        regions: T
    )
       where T: Iterator<Item = TextureCopy>;
    unsafe fn copy_buffer_to_texture<T>(
        &mut self,
        src: &<A as Api>::Buffer,
        dst: &<A as Api>::Texture,
        regions: T
    )
       where T: Iterator<Item = BufferTextureCopy>;
    unsafe fn copy_texture_to_buffer<T>(
        &mut self,
        src: &<A as Api>::Texture,
        src_usage: TextureUses,
        dst: &<A as Api>::Buffer,
        regions: T
    )
       where T: Iterator<Item = BufferTextureCopy>;
    unsafe fn set_bind_group(
        &mut self,
        layout: &<A as Api>::PipelineLayout,
        index: u32,
        group: &<A as Api>::BindGroup,
        dynamic_offsets: &[u32]
    );
    unsafe fn set_push_constants(
        &mut self,
        layout: &<A as Api>::PipelineLayout,
        stages: ShaderStages,
        offset_bytes: u32,
        data: &[u32]
    );
    unsafe fn insert_debug_marker(&mut self, label: &str);
    unsafe fn begin_debug_marker(&mut self, group_label: &str);
    unsafe fn end_debug_marker(&mut self);
    unsafe fn begin_query(&mut self, set: &<A as Api>::QuerySet, index: u32);
    unsafe fn end_query(&mut self, set: &<A as Api>::QuerySet, index: u32);
    unsafe fn write_timestamp(&mut self, set: &<A as Api>::QuerySet, index: u32);
    unsafe fn reset_queries(
        &mut self,
        set: &<A as Api>::QuerySet,
        range: Range<u32>
    );
    unsafe fn copy_query_results(
        &mut self,
        set: &<A as Api>::QuerySet,
        range: Range<u32>,
        buffer: &<A as Api>::Buffer,
        offset: u64,
        stride: NonZeroU64
    );
    unsafe fn begin_render_pass(&mut self, desc: &RenderPassDescriptor<'_, A>);
    unsafe fn end_render_pass(&mut self);
    unsafe fn set_render_pipeline(
        &mut self,
        pipeline: &<A as Api>::RenderPipeline
    );
    unsafe fn set_index_buffer<'a>(
        &mut self,
        binding: BufferBinding<'a, A>,
        format: IndexFormat
    );
    unsafe fn set_vertex_buffer<'a>(
        &mut self,
        index: u32,
        binding: BufferBinding<'a, A>
    );
    unsafe fn set_viewport(&mut self, rect: &Rect<f32>, depth_range: Range<f32>);
    unsafe fn set_scissor_rect(&mut self, rect: &Rect<u32>);
    unsafe fn set_stencil_reference(&mut self, value: u32);
    unsafe fn set_blend_constants(&mut self, color: &[f32; 4]);
    unsafe fn draw(
        &mut self,
        first_vertex: u32,
        vertex_count: u32,
        first_instance: u32,
        instance_count: u32
    );
    unsafe fn draw_indexed(
        &mut self,
        first_index: u32,
        index_count: u32,
        base_vertex: i32,
        first_instance: u32,
        instance_count: u32
    );
    unsafe fn draw_indirect(
        &mut self,
        buffer: &<A as Api>::Buffer,
        offset: u64,
        draw_count: u32
    );
    unsafe fn draw_indexed_indirect(
        &mut self,
        buffer: &<A as Api>::Buffer,
        offset: u64,
        draw_count: u32
    );
    unsafe fn draw_indirect_count(
        &mut self,
        buffer: &<A as Api>::Buffer,
        offset: u64,
        count_buffer: &<A as Api>::Buffer,
        count_offset: u64,
        max_count: u32
    );
    unsafe fn draw_indexed_indirect_count(
        &mut self,
        buffer: &<A as Api>::Buffer,
        offset: u64,
        count_buffer: &<A as Api>::Buffer,
        count_offset: u64,
        max_count: u32
    );
    unsafe fn begin_compute_pass(&mut self, desc: &ComputePassDescriptor<'_, A>);
    unsafe fn end_compute_pass(&mut self);
    unsafe fn set_compute_pipeline(
        &mut self,
        pipeline: &<A as Api>::ComputePipeline
    );
    unsafe fn dispatch(&mut self, count: [u32; 3]);
    unsafe fn dispatch_indirect(
        &mut self,
        buffer: &<A as Api>::Buffer,
        offset: u64
    );
    unsafe fn build_acceleration_structures<'a, T>(
        &mut self,
        descriptor_count: u32,
        descriptors: T
    )
       where A: 'a,
             T: IntoIterator<Item = BuildAccelerationStructureDescriptor<'a, A>>;
    unsafe fn place_acceleration_structure_barrier(
        &mut self,
        barrier: AccelerationStructureBarrier
    );
}

Available on crate feature wgpu only.

Expand description

Encoder for commands in command buffers. Serves as a parent for all the encoded command buffers. Works in bursts of action: one or more command buffers are recorded, then submitted to a queue, and then it needs to be reset_all().

Required Methods§

unsafe fn begin_encoding( &mut self, label: Option<&str> ) -> Result<(), DeviceError>

Begin encoding a new command buffer.

unsafe fn discard_encoding(&mut self)

Discard currently recorded list, if any.

unsafe fn end_encoding( &mut self ) -> Result<<A as Api>::CommandBuffer, DeviceError>

unsafe fn reset_all<I>(&mut self, command_buffers: I)
where I: Iterator<Item = <A as Api>::CommandBuffer>,

Reclaims all resources that are allocated for this encoder. Must get all of the produced command buffers back, and they must not be used by GPU at this moment.

unsafe fn transition_buffers<'a, T>(&mut self, barriers: T)
where T: Iterator<Item = BufferBarrier<'a, A>>,

unsafe fn transition_textures<'a, T>(&mut self, barriers: T)
where T: Iterator<Item = TextureBarrier<'a, A>>,

unsafe fn clear_buffer( &mut self, buffer: &<A as Api>::Buffer, range: Range<u64> )

unsafe fn copy_buffer_to_buffer<T>( &mut self, src: &<A as Api>::Buffer, dst: &<A as Api>::Buffer, regions: T )
where T: Iterator<Item = BufferCopy>,

unsafe fn copy_texture_to_texture<T>( &mut self, src: &<A as Api>::Texture, src_usage: TextureUses, dst: &<A as Api>::Texture, regions: T )
where T: Iterator<Item = TextureCopy>,

Copy from one texture to another. Works with a single array layer. Note: dst current usage has to be TextureUses::COPY_DST. Note: the copy extent is in physical size (rounded to the block size)

unsafe fn copy_buffer_to_texture<T>( &mut self, src: &<A as Api>::Buffer, dst: &<A as Api>::Texture, regions: T )
where T: Iterator<Item = BufferTextureCopy>,

Copy from buffer to texture. Works with a single array layer. Note: dst current usage has to be TextureUses::COPY_DST. Note: the copy extent is in physical size (rounded to the block size)

unsafe fn copy_texture_to_buffer<T>( &mut self, src: &<A as Api>::Texture, src_usage: TextureUses, dst: &<A as Api>::Buffer, regions: T )
where T: Iterator<Item = BufferTextureCopy>,

Copy from texture to buffer. Works with a single array layer. Note: the copy extent is in physical size (rounded to the block size)

unsafe fn set_bind_group( &mut self, layout: &<A as Api>::PipelineLayout, index: u32, group: &<A as Api>::BindGroup, dynamic_offsets: &[u32] )

Sets the bind group at index to group, assuming the layout of all the preceeding groups to be taken from layout.

unsafe fn set_push_constants( &mut self, layout: &<A as Api>::PipelineLayout, stages: ShaderStages, offset_bytes: u32, data: &[u32] )

Sets a range in push constant data.

IMPORTANT: while the data is passed as words, the offset is in bytes!

Safety

offset_bytes must be a multiple of 4.
The range of push constants written must be valid for the pipeline layout at draw time.

unsafe fn insert_debug_marker(&mut self, label: &str)

unsafe fn begin_debug_marker(&mut self, group_label: &str)

unsafe fn end_debug_marker(&mut self)

unsafe fn begin_query(&mut self, set: &<A as Api>::QuerySet, index: u32)

Safety:

If set is an occlusion query set, it must be the same one as used in the RenderPassDescriptor::occlusion_query_set parameter.

unsafe fn end_query(&mut self, set: &<A as Api>::QuerySet, index: u32)

Safety:

If set is an occlusion query set, it must be the same one as used in the RenderPassDescriptor::occlusion_query_set parameter.

unsafe fn write_timestamp(&mut self, set: &<A as Api>::QuerySet, index: u32)

unsafe fn reset_queries( &mut self, set: &<A as Api>::QuerySet, range: Range<u32> )

unsafe fn copy_query_results( &mut self, set: &<A as Api>::QuerySet, range: Range<u32>, buffer: &<A as Api>::Buffer, offset: u64, stride: NonZeroU64 )

unsafe fn begin_render_pass(&mut self, desc: &RenderPassDescriptor<'_, A>)

unsafe fn end_render_pass(&mut self)

unsafe fn set_render_pipeline(&mut self, pipeline: &<A as Api>::RenderPipeline)

unsafe fn set_index_buffer<'a>( &mut self, binding: BufferBinding<'a, A>, format: IndexFormat )

unsafe fn set_vertex_buffer<'a>( &mut self, index: u32, binding: BufferBinding<'a, A> )

unsafe fn set_viewport(&mut self, rect: &Rect<f32>, depth_range: Range<f32>)

unsafe fn set_scissor_rect(&mut self, rect: &Rect<u32>)

unsafe fn set_stencil_reference(&mut self, value: u32)

unsafe fn set_blend_constants(&mut self, color: &[f32; 4])

unsafe fn draw( &mut self, first_vertex: u32, vertex_count: u32, first_instance: u32, instance_count: u32 )

unsafe fn draw_indexed( &mut self, first_index: u32, index_count: u32, base_vertex: i32, first_instance: u32, instance_count: u32 )

unsafe fn draw_indirect( &mut self, buffer: &<A as Api>::Buffer, offset: u64, draw_count: u32 )

unsafe fn draw_indexed_indirect( &mut self, buffer: &<A as Api>::Buffer, offset: u64, draw_count: u32 )

unsafe fn draw_indirect_count( &mut self, buffer: &<A as Api>::Buffer, offset: u64, count_buffer: &<A as Api>::Buffer, count_offset: u64, max_count: u32 )

unsafe fn draw_indexed_indirect_count( &mut self, buffer: &<A as Api>::Buffer, offset: u64, count_buffer: &<A as Api>::Buffer, count_offset: u64, max_count: u32 )

unsafe fn begin_compute_pass(&mut self, desc: &ComputePassDescriptor<'_, A>)

unsafe fn end_compute_pass(&mut self)

unsafe fn set_compute_pipeline( &mut self, pipeline: &<A as Api>::ComputePipeline )

unsafe fn dispatch(&mut self, count: [u32; 3])

unsafe fn dispatch_indirect(&mut self, buffer: &<A as Api>::Buffer, offset: u64)

unsafe fn build_acceleration_structures<'a, T>( &mut self, descriptor_count: u32, descriptors: T )
where A: 'a, T: IntoIterator<Item = BuildAccelerationStructureDescriptor<'a, A>>,

To get the required sizes for the buffer allocations use get_acceleration_structure_build_sizes per descriptor All buffers must be synchronized externally All buffer regions, which are written to may only be passed once per function call, with the exception of updates in the same descriptor. Consequences of this limitation:

scratch buffers need to be unique
a tlas can’t be build in the same call with a blas it contains

unsafe fn place_acceleration_structure_barrier( &mut self, barrier: AccelerationStructureBarrier )

Object Safety§

This trait is not object safe.

Implementors§

§

impl CommandEncoder<Api> for Encoder

§

impl CommandEncoder<Api> for iced::widget::shader::wgpu::hal::gles::CommandEncoder

§