Struct BindingInstance 

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

Source data for a GPUBindingInstance<T>: which T (a GPUMaterial or GPUCompute) to bind against, and the concrete resource for each of its named binding entries.

T is a marker only — this holds no T value, just a RawAssetHandle into whichever ProcessedAssets<T> store T lives in. See the MaterialInstance/ComputeInstance aliases for the two concrete instantiations. Fields are private — start from BindingInstance::new and chain the per-kind binding methods below (mirroring how BindGroupBuilder adds one resource per call) rather than constructing one as a struct literal.

Implementations

impl<T: Asset<WGPUBackend>> BindingInstance<T>

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

Start building an instance targeting target — the source handle for T (e.g. a Handle<Material> for a MaterialInstance), looked up in ProcessedAssets<T> once that target itself has finished uploading. Chain the binding methods below to add entries.

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

Bind a processed GPUTexture, by its source handle, under name.

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

Bind a processed GPUTextureArray, by its source handle, under name.

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

Bind a processed GPUCubemap, by its source handle, under name.

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

Bind a sampler from the global sampler cache under name.

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

Bind raw bytes as a uniform buffer owned by this instance, under name — updatable later via GPUBindingInstance::update.

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

Same as uniform but as a storage buffer.

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

Escape hatch for a dynamically-selected entry kind that doesn’t fit the typed methods above (building entries in a loop over heterogeneous data, say). Prefer texture/ sampler/etc. when the kind is known statically.

pub fn build(self) -> Self

Consume the builder and return the finished BindingInstance value.

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

Consume the builder, insert into assets under name, and return the resulting Handle<BindingInstance<T>>.