Enum BindingKind 

pub enum BindingKind {
    Texture {
        visibility: ShaderStages,
        sample_type: TextureSampleType,
        view_dimension: TextureViewDimension,
        multisampled: bool,
    },
    StorageTexture {
        visibility: ShaderStages,
        format: TextureFormat,
        access: StorageTextureAccess,
        view_dimension: TextureViewDimension,
    },
    Sampler {
        visibility: ShaderStages,
    },
    ComparisonSampler {
        visibility: ShaderStages,
    },
    UniformBuffer {
        visibility: ShaderStages,
        has_dynamic_offset: bool,
        min_binding_size: Option<BufferSize>,
    },
    StorageBufferReadOnly {
        visibility: ShaderStages,
        has_dynamic_offset: bool,
        min_binding_size: Option<BufferSize>,
    },
    StorageBufferReadWrite {
        visibility: ShaderStages,
        has_dynamic_offset: bool,
        min_binding_size: Option<BufferSize>,
    },
}

What kind of resource a single BindingEntry binds, the wgpu binding parameters that go with it, and which shader stage(s) can see it. Construct via the texture_*/*_buffer/sampler/storage_texture associated functions rather than the variants directly — they fill in the usual defaults (filterable float textures, non-dynamic buffers) so only the cases that actually differ need spelling out.

Variants

Texture

A sampled texture (texture_2d<f32> and friends in WGSL).

Fields

visibility: ShaderStages

sample_type: TextureSampleType

view_dimension: TextureViewDimension

multisampled: bool

StorageTexture

A texture bound for direct read/write access (textureStore/ textureLoad in WGSL) rather than sampling.

Fields

visibility: ShaderStages

format: TextureFormat

access: StorageTextureAccess

view_dimension: TextureViewDimension

Sampler

A filtering sampler.

Fields

visibility: ShaderStages

ComparisonSampler

A comparison sampler (e.g. for shadow-map textureSampleCompare).

Fields

visibility: ShaderStages

UniformBuffer

A uniform buffer.

Fields

visibility: ShaderStages

has_dynamic_offset: bool

min_binding_size: Option<BufferSize>

StorageBufferReadOnly

A read-only storage buffer.

Fields

visibility: ShaderStages

has_dynamic_offset: bool

min_binding_size: Option<BufferSize>

StorageBufferReadWrite

A read-write storage buffer.

Fields

visibility: ShaderStages

has_dynamic_offset: bool

min_binding_size: Option<BufferSize>

Implementations

impl BindingKind

pub fn texture_2d(visibility: ShaderStages) -> Self

A filterable, non-multisampled 2D texture — the common case.

pub fn texture_2d_array(visibility: ShaderStages) -> Self

Same as texture_2d but for a 2D texture array (see GPUTextureArray).

pub fn texture_cubemap(visibility: ShaderStages) -> Self

Same as texture_2d but for a cubemap (see GPUCubemap).

pub fn storage_texture( visibility: ShaderStages, format: TextureFormat, access: StorageTextureAccess, view_dimension: TextureViewDimension, ) -> Self

A storage texture bound for direct read/write/read-write access (per access) rather than sampling.

pub fn sampler(visibility: ShaderStages) -> Self

A filtering sampler.

pub fn comparison_sampler(visibility: ShaderStages) -> Self

A comparison sampler (e.g. for shadow-map textureSampleCompare).

pub fn uniform_buffer(visibility: ShaderStages) -> Self

A uniform buffer, bound as a whole (no dynamic offset) — the common case. See dynamic_uniform_buffer for the per-draw/per-dispatch-offset variant.

pub fn dynamic_uniform_buffer( visibility: ShaderStages, element_size: u64, ) -> Self

A uniform buffer bound with a dynamic offset, e.g. one large buffer holding many objects’/elements’ data, rebound at a different offset via set_bind_group’s dynamic offsets slice instead of a bind group per object/dispatch. element_size is the size in bytes of a single element (before alignment padding). Use crate::wgpu::buffers::build_dynamic_uniform_buffer to allocate the backing buffer and crate::wgpu::buffers::dynamic_buffer_binding (not buffer.as_entire_binding()) to build the bind group entry for it — the entry must be scoped to one element’s size, not the whole buffer, or dynamic offsets will fail validation.

pub fn storage_buffer_read_only(visibility: ShaderStages) -> Self

A read-only storage buffer, bound as a whole (no dynamic offset).

pub fn storage_buffer_read_write(visibility: ShaderStages) -> Self

A read-write storage buffer, bound as a whole (no dynamic offset).

pub fn dynamic_storage_buffer( visibility: ShaderStages, element_size: u64, read_only: bool, ) -> Self

A storage buffer bound with a dynamic offset. See Self::dynamic_uniform_buffer.

pub fn visibility(&self) -> ShaderStages

Which shader stage(s) this binding is visible to.

pub fn layout_entry(&self, binding: u32) -> BindGroupLayoutEntry

Trait Implementations

impl Clone for BindingKind

fn clone(&self) -> BindingKind

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for BindingKind

impl Eq for BindingKind

impl Hash for BindingKind

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for BindingKind

fn eq(&self, other: &BindingKind) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for BindingKind