Struct BindingInstance 

pub struct BindingInstance<T> { /* private fields */ }

A bind group asset for a Material/Compute target — named textures/samplers/uniforms/storage buffers, matched to the target’s declared entries by name. Usually used via its aliases MaterialInstance/ComputeInstance.

Implementations

impl<T> BindingInstance<T>

where T: Asset<Backend>, T::Processed: BindGroupTarget,

pub fn new(target: Handle<T>) -> Self

pub fn with_texture(self, name: &'static str, handle: Handle<Texture>) -> Self

pub fn with_texture_array( self, name: &'static str, handle: Handle<TextureArray>, ) -> Self

pub fn with_cubemap(self, name: &'static str, handle: Handle<Cubemap>) -> Self

pub fn with_texture_view(self, name: &'static str, view: TextureView) -> Self

Binds an already-built TextureView directly — e.g. one mip level from GPUTexture::get_view, or a standalone render target from RenderTargetTextureBuilder. Unlike .with_texture/.with_texture_array/.with_cubemap, no Handle lookup happens at upload time — view must already exist.

pub fn with_sampler(self, name: &'static str, kind: SamplerKind) -> Self

pub fn with_uniform(self, name: &'static str, data: Vec<u8>) -> Self

pub fn with_storage(self, name: &'static str, data: Vec<u8>) -> Self

pub fn with_buffer(self, name: &'static str, buffer: Buffer) -> Self

Binds an existing Buffer instead of uploading raw bytes — for a buffer you already built yourself (e.g. one a compute pass writes to, then another pass reads from). Unlike .with_uniform/.with_storage, no buffer is created here; buffer must already carry the usage flags this binding needs (BufferUsages::UNIFORM or ::STORAGE, matching how the target’s own entry for name was declared).

pub fn with_dynamic_buffer( self, name: &'static str, buffer: DynamicBuffer, ) -> Self

Binds an existing DynamicBuffer — the dynamic-offset counterpart to .with_buffer. The target’s own entry for name must have been declared with BindingKind::dynamic_uniform_buffer/dynamic_storage_buffer (has_dynamic_offset: true) to match, or bind group creation fails validation.

pub fn with_param(self, name: &'static str, entry: BindingInstanceEntry) -> Self

pub fn build_asset( self, name: &str, assets: &mut Assets<BindingInstance<T>>, ) -> Handle<BindingInstance<T>>

where BindingInstance<T>: AssetSource,

Trait Implementations

impl<T> Asset<Backend> for BindingInstance<T>

where T: Asset<Backend>, T::Processed: BindGroupTarget,

type Deps<'a> = (Read<'a, Assets<T>>, Read<'a, Assets<Texture>>, Read<'a, Assets<TextureArray>>, Read<'a, Assets<Cubemap>>, Read<'a, GlobalSamplers>)

fn upload<'a>( &self, backend: &Backend, deps: &Self::Deps<'a>, ) -> Option<GPUBindingInstance<T>>

impl<T> AssetSource for BindingInstance<T>

where T: Asset<Backend>, T::Processed: BindGroupTarget,

type Processed = GPUBindingInstance<T>