#mesh #bevy #game-engine #png #load #heightmap #height

bevy_heightmap

Create meshes from heightmap PNGs in the Bevy game engine

5 releases

0.2.3 Aug 5, 2024
0.2.2 Aug 5, 2024
0.2.1 Jul 15, 2024
0.2.0 Jul 15, 2024
0.1.0 Jul 15, 2024

#573 in Game dev

MIT/Apache

3MB
203 lines

bevy_heightmap

License Crates.io Docs

Load height map PNGs as meshes in bevy.

Height map Generated
example_image example_image

Usage

Create a height map from a value function:

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(), 4 * 10 * 10);

Load a height map as a mesh from an image (requires .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");
}

Examples

cargo run --example image

Bevy support table

bevy bevy_heightmap
0.14 0.2.0
0.13 0.1.0

Dependencies

~27MB
~513K SLoC