bevy_heightmap 0.4.0

Create meshes from heightmap PNGs in the Bevy game engine.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

/// Simple crate for loading a heightmap .png image as a mesh.
use asset_loader::HeightMapLoader;

pub mod asset_loader;
pub mod mesh_builder;

use bevy_app::{App, Plugin};
use bevy_asset::AssetApp;
use bevy_math::{UVec2, Vec2};
use bevy_render::mesh::Mesh;
use mesh_builder::MeshBuilder;

/// Minimal representation of a rectangular height map.
/// ```
/// use bevy::prelude::*;
/// use bevy_heightmap::*;
/// let heightmap = HeightMap {
///   size: UVec2::new(10, 10),
///   h: |p: Vec2| ((20. * p.x).sin() + (20. * p.y).sin()) / 2.
/// };
/// let mesh: Mesh = heightmap.into();
/// assert_eq!(mesh.count_vertices(), 10 * 10);
/// ```
pub struct HeightMap<H: Fn(Vec2) -> f32> {
    pub size: UVec2,
    pub h: H,
}
impl<H: Fn(Vec2) -> f32> From<HeightMap<H>> for Mesh {
    fn from(HeightMap { size, h }: HeightMap<H>) -> Self {
        MeshBuilder::grid(size, &h).build()
    }
}

/// Enables loading Meshes from images with `.hmp.png` extension.
/// ```
/// use bevy::prelude::*;
/// use bevy_heightmap::*;
/// fn setup(asset_server: Res<AssetServer>) {
///     let mesh: Handle<Mesh> = asset_server.load("textures/terrain.hmp.png");
/// }
/// ```
pub struct HeightMapPlugin;
impl Plugin for HeightMapPlugin {
    fn build(&self, app: &mut App) {
        app.preregister_asset_loader::<HeightMapLoader>(HeightMapLoader::EXTENSIONS);
    }
    fn finish(&self, app: &mut App) {
        app.init_asset_loader::<asset_loader::HeightMapLoader>();
    }
}