Struct Slot 

pub struct Slot { /* private fields */ }

What one part of a mesh draws with: a material and its maps, over some of the mesh’s triangles.

A slot is a length, not a range.

Implementations

impl Slot

pub fn new(index_count: u32, material: Material) -> Self

A slot drawn with material over a white default, for the next index_count indices.

pub fn textured(self, texture: TextureData) -> Self

Samples this slot from texture, in place of the white default.

pub fn relief(self, relief: ReliefData) -> Self

The relief is a texture map: RGB holds each texel’s normal, +Y up the map, and A its depth where the relief declares one, 1.0 one sprite width, half in front of the sprite and half behind.

Required if you want a surface lit by normals its own corners do not hold. A billboarded or upright draw reads the normal in the axes the camera turned; every other draw reads it through the derivative basis — the basis its own position and UV derivatives span — and ignores the depth. The relief is windowed like the color texture, so each sheet cell lines up with its own relief cell. A depth also decides what a billboarded or upright draw casts: a texel with no depth casts nothing, and depth under the sprite’s own texels, down to its foot, produces a shadow that starts at the ground it is drawn on.

pub fn shading(self, shading: ShadingData) -> Self

The shading map holds each texel’s occlusion in R, its roughness in G and its metallic in B. The roughness and metallic each scale the slot’s own lane; the occlusion instead darkens what the texel takes of the frame’s sky.

Required if you want the roughness, the metallic or the sky’s own light on one material to differ across the surface. Every light of the frame lands whole, whatever the occlusion holds.

pub fn emissive_map(self, emissive: TextureData) -> Self

The emissive map is the light this slot casts per texel, scaled by the material’s emissive color.

Required if you want part of a surface to cast light while the rest of it does not. A material casts none by default, so the map alone casts nothing.

pub fn index_count(&self) -> u32

The number of the mesh’s indices this slot covers.

pub fn material(&self) -> Material

The material used unless a draw overrides this slot.

pub fn texture(&self) -> Option<&TextureData>

The pixels this slot samples, absent while it is drawn over white.

Trait Implementations

impl Clone for Slot

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Slot

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.