Struct ReliefData 

pub struct ReliefData { /* private fields */ }

The relief a mesh slot reads: 8-bit RGBA holding a normal and, where the constructor declares one, a depth per texel in place of color, row by row from the top left.

A relief holds no sampler of its own; it is sampled the way its slot’s color texture is.

Implementations

impl ReliefData

pub fn rgba8(size: UVec2, pixels: Vec<u8>) -> Self

A size-sized relief over pixels, 4 bytes per pixel: a normal in RGB and a depth in A.

The length must match size; checked only in debug builds.

pub fn normals(size: UVec2, pixels: Vec<u8>) -> Self

The same over pixels holding normals alone, whose alpha byte no draw reads.

Required if you want a relief that lights a surface without moving its texels off the plane; a .glb normal texture is read as one.

Examples found in repository

examples/material-playground.rs (line 354)

fn relief_bumps() -> ReliefData {
    let size = MAP_SIZE;
    let turns = core::f32::consts::TAU * BUMP_WAVES;
    let mut pixels = Vec::with_capacity((size.x * size.y * 4) as usize);
    for y in 0..size.y {
        for x in 0..size.x {
            let u = (x as f32 + 0.5) / size.x as f32;
            let v = (y as f32 + 0.5) / size.y as f32;
            let slope_u = BUMP_SLOPE * (turns * u).cos() * (turns * v).sin();
            let slope_v = BUMP_SLOPE * (turns * u).sin() * (turns * v).cos();
            let normal = Vec3::new(-slope_u, -slope_v, 1.0).normalize();
            let encode = |signed: f32| ((signed * 0.5 + 0.5) * 255.0).round() as u8;
            pixels.extend_from_slice(&[encode(normal.x), encode(normal.y), encode(normal.z), 0]);
        }
    }
    ReliefData::normals(size, pixels)
}

pub fn size(&self) -> UVec2

Pixels across and down; (0, 0) when there are none.

Trait Implementations

impl Clone for ReliefData

fn clone(&self) -> ReliefData

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ReliefData

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

Formats the value using the given formatter.

impl Default for ReliefData

fn default() -> ReliefData

Returns the “default value” for a type.

impl PartialEq for ReliefData

fn eq(&self, other: &ReliefData) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ReliefData