Struct Material 

pub struct Material { /* private fields */ }

Describes a render pipeline + its own bind group, the source type GPUMaterial is built from via build_material. Fields are private — start from Material::new and chain the setters below (or Material::default() for an opaque material with no shader source yet) rather than constructing one as a struct literal.

Implementations

impl Material

pub fn new(shader_source: &'static str) -> Self

Start building a material with the given WGSL shader source. All other fields are set to their defaults (see Default).

pub fn label(self, label: &'static str) -> Self

pub fn vertex_entry(self, entry: &'static str) -> Self

pub fn no_vertex_entry(self) -> Self

Clear vertex_entry — let wgpu auto-detect the module’s single @vertex function instead of naming one. Only valid if shader_source declares exactly one. The counterpart to vertex_entry, which can only set it to Some.

pub fn fragment_entry(self, entry: &'static str) -> Self

pub fn no_fragment_entry(self) -> Self

Clear fragment_entry — same rationale as no_vertex_entry, for the @fragment stage.

pub fn vertex_layouts(self, layouts: Vec<VertexBufferLayout>) -> Self

pub fn entries(self, groups: Vec<GroupEntry>) -> Self

This material’s bind groups, in @group(N) order — position in groups is the @group(N) index a shader must declare to match: the first element is @group(0), the second @group(1), and so on. Each element is either:

• GroupEntry::Own — this material’s own bind group entries, built into a fresh layout internally. At most one of these is allowed — the one group a GPUMaterialInstance binds concrete resources against — build_material panics on a second one.
• GroupEntry::Layout — an already-built layout occupying this position directly: a camera, lights, or anything else external, e.g. pulled from a GlobalLayoutPool via GlobalLayoutPool::get.

build_material also panics if any Own entry is visible to the compute stage, or if groups needs more bind groups than the device’s max_bind_groups allows (wgpu guarantees only 4) — list only the groups this material’s shader actually declares.

pub fn cull_mode(self, mode: Face) -> Self

Face culling mode. Defaults to Some(Face::Back).

pub fn no_cull_mode(self) -> Self

Clear cull_mode — render both faces (no backface culling). The counterpart to cull_mode, which can only set it to Some.

pub fn depth(self, depth: DepthStencilState) -> Self

pub fn targets(self, targets: Vec<ColorTargetState>) -> Self

pub fn polygon_mode(self, mode: PolygonMode) -> Self

pub fn sample_count(self, count: u32) -> Self

pub fn build(self) -> Self

Consume the builder and return the finished Material 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<Material>.

Trait Implementations

impl Default for Material

fn default() -> Self

Returns the “default value” for a type.