Struct GlobalLayoutPool 

pub struct GlobalLayoutPool { /* private fields */ }

A named pool of bind group layouts shared across materials/compute passes — register a layout once (e.g. a camera’s, under "camera") as soon as it exists, then anywhere a material/compute wants it, pull it with get and wrap it in GroupEntry::Layout at whatever position that material/compute’s shader declares it.

WGPUPlugin inserts an empty pool as a resource, so it’s always there from the start — grab it with Res<GlobalLayoutPool>/ ResMut<GlobalLayoutPool> rather than constructing your own; a LazyResource that builds a shared layout (a camera, lights, …) registers it into that same pool from its own construct (or a follow-up system, once it has ResMut<GlobalLayoutPool> alongside it) — there’s no separate “finished pool” step, entries just accumulate as their sources become ready.

Implementations

impl GlobalLayoutPool

pub fn new() -> Self

pub fn register(&mut self, name: &'static str, layout: BindGroupLayout)

Register layout under name. Panics if name is already registered — almost always two sources registering under the same name by mistake, not an intentional overwrite.

pub fn get(&self, name: &str) -> Option<BindGroupLayout>

The layout registered under name, if any — clone it into a GroupEntry::Layout at whatever position your shader declares it. None if nothing has registered under that name (yet, or ever — a typo’d name and “not built yet” look the same from here, so callers with a hard requirement on a given global should treat a miss as “not ready” the same way any other Option-returning lookup in this engine does). Reach for GroupEntry::Global instead of calling this directly wherever possible — it defers this same lookup to upload time, so name doesn’t need to be registered yet at the point a material/compute is described.

Trait Implementations

impl Default for GlobalLayoutPool

fn default() -> GlobalLayoutPool

Returns the “default value” for a type.