Struct TerrainTileData 

pub struct TerrainTileData { /* private fields */ }

The meshes of a terrain tile at every detail level, made on the CPU from its heights: build them on a worker thread with a Job, then Ctx::upload_terrain_tile on the game’s.

let data = TerrainTileData::new(&[0.0; 5 * 5], 8.0);
assert_eq!(data.size(), 8.0);

Implementations

impl TerrainTileData

pub fn new(heights: &[f32], size: f32) -> Self

A tile size wide from a square grid of heights, as Ctx::create_terrain_tile takes them.

let flat = TerrainTileData::new(&[1.0; 3 * 3], 4.0);
assert_eq!(flat.size(), 4.0);

Panics

If heights isn’t a square grid of at least 2 × 2 or size isn’t above 0.

Examples found in repository

examples/streaming.rs (line 79)

fn tile_data(corner: Vec3) -> TerrainTileData {
    let heights: Vec<f32> = (0..N * N)
        .map(|i| height(corner.x + (i % N) as f32 * 2.0, corner.z + (i / N) as f32 * 2.0))
        .collect();
    TerrainTileData::new(&heights, TILE)
}

pub fn size(&self) -> f32

How wide the tile is.

assert_eq!(TerrainTileData::new(&[0.0; 4], 2.0).size(), 2.0);

pub fn heightfield(&self) -> &Heightfield

The tile’s heights, for finding the ground under a point (keep it when the meshes go to the GPU).

let data = TerrainTileData::new(&[3.0; 3 * 3], 4.0);
assert_eq!(data.heightfield().height_at(1.0, 1.0), Some(3.0));

Trait Implementations

impl Clone for TerrainTileData

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 TerrainTileData

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

Formats the value using the given formatter.