Struct Heightfield 

pub struct Heightfield {
    pub origin: Vec3,
    pub cell: f64,
    pub nx: usize,
    pub ny: usize,
    pub heights: Vec<f32>,
}

A regular grid of terrain heights, sampled bilinearly.

Node (ix, iy) sits at world (origin.x + ix·cell, origin.y + iy·cell) with surface height origin.z + heights[iy·nx + ix]. Between nodes the surface is the bilinear patch through the four surrounding nodes; outside the grid the query is clamped to the border, so the terrain extends flatly (per-edge) to infinity rather than falling away to zero. That clamp is also what makes a 1×1 field an exact infinite plane.

Heights are stored as f32 deliberately: the GPU contact shader consumes this buffer verbatim, and keeping one representation means the CPU and GPU paths sample identical terrain instead of terrain that agrees to rounding. Construction is a couple of allocations, cheap enough to draw a fresh field per training iteration.

Fields

origin: Vec3

World position of node (0, 0); origin.z is added to every height.

cell: f64

Grid spacing in metres, same in x and y. Must be positive.

nx: usize

Number of nodes along x. At least 1.

ny: usize

Number of nodes along y. At least 1.

heights: Vec<f32>

Row-major heights, ny rows of nx: heights[iy * nx + ix].

Implementations

impl Heightfield

pub fn new(origin: Vec3, cell: f64, nx: usize, ny: usize) -> Self

A heightfield of nx × ny nodes spaced cell apart, all at height zero above origin.

Panics

If nx or ny is zero or cell is not a positive finite number.

pub fn flat(height: f64) -> Self

The infinite flat plane at z = height: a single node whose border clamp covers the whole world.

pub fn height(&self, x: f64, y: f64) -> f64

Surface height at world (x, y), bilinear between nodes, clamped to the border outside the grid.

pub fn normal(&self, x: f64, y: f64) -> Vec3

Unit surface normal at world (x, y).

The analytic normal of the bilinear patch: (-∂h/∂x, -∂h/∂y, 1) normalized. Outside the grid the clamp makes the surface flat, so the normal degrades to +ẑ there, and a 1×1 field reports +ẑ everywhere — exactly the flat-plane contact normal.

Trait Implementations

impl Clone for Heightfield

fn clone(&self) -> Heightfield

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Heightfield

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

Formats the value using the given formatter.

impl PartialEq for Heightfield

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Heightfield