Struct HeightFieldSurface 

pub struct HeightFieldSurface {
    pub noise: NoiseSource,
    pub origin: Vec2,
    pub size: Vec2,
    pub resolution_x: usize,
    pub resolution_z: usize,
    pub heights: Vec<f32>,
    pub time: f32,
    pub animations: Vec<HeightFieldAnimation>,
}

A height field surface driven by a noise source.

The surface occupies a rectangular region in XZ-space. Each grid cell stores a height value (Y coordinate). Heights are lazily generated from the noise source.

Fields

noise: NoiseSource

The noise source generating heights.

origin: Vec2

World-space origin (bottom-left corner of the heightfield in XZ).

size: Vec2

World-space size of the heightfield in XZ.

resolution_x: usize

Number of samples along X.

resolution_z: usize

Number of samples along Z.

heights: Vec<f32>

Computed height values. Row-major: heights[z * resolution_x + x].

time: f32

Time parameter for animated deformations.

animations: Vec<HeightFieldAnimation>

Animation modes applied to the surface.

Implementations

impl HeightFieldSurface

pub fn new( noise: NoiseSource, origin: Vec2, size: Vec2, resolution_x: usize, resolution_z: usize, ) -> Self

Create a new height field surface.

pub fn regenerate(&mut self)

Regenerate all height values from the noise source.

pub fn height_at_index(&self, ix: usize, iz: usize) -> f32

Get the height at grid indices (ix, iz).

pub fn set_height(&mut self, ix: usize, iz: usize, h: f32)

Set the height at grid indices (ix, iz).

pub fn sample_height(&self, x: f32, z: f32) -> f32

Sample height at world-space (x, z) using bilinear interpolation.

pub fn normal_at(&self, x: f32, z: f32) -> Vec3

Compute the surface normal at world-space (x, z) using central differences.

pub fn normal_at_index(&self, ix: usize, iz: usize) -> Vec3

Compute the normal at grid index using central differences.

pub fn tick(&mut self, dt: f32)

Update time and apply real-time animations.

pub fn deform_brush(&mut self, cx: f32, cz: f32, radius: f32, strength: f32)

Apply a deformation brush: raise or lower terrain in a radius around (cx, cz).

pub fn flatten_brush( &mut self, cx: f32, cz: f32, radius: f32, target: f32, strength: f32, )

Flatten terrain in a radius around (cx, cz) toward a target height.

pub fn world_position(&self, ix: usize, iz: usize) -> Vec3

Get the world-space position of a grid vertex.

pub fn bounding_box(&self) -> (Vec3, Vec3)

Compute the bounding box: (min, max).

pub fn to_vertex_data(&self) -> (Vec<Vec3>, Vec<Vec3>)

Export to a list of positions and normals (interleaved grid).

pub fn generate_indices(&self) -> Vec<[u32; 3]>

Generate triangle indices for the height field grid.

pub fn sample_noise(&self, x: f32, z: f32) -> f32

Sample height directly from noise (without grid interpolation).

Trait Implementations

impl Clone for HeightFieldSurface

fn clone(&self) -> HeightFieldSurface

Returns a duplicate of the value.

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

Performs copy-assignment from source.