#bevy #game-engine #mesh #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

#628 in Game dev

Download history 276/week @ 2024-07-12 26/week @ 2024-07-19 58/week @ 2024-07-26 241/week @ 2024-08-02 30/week @ 2024-08-09

275 downloads per month

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

~26MB
~474K SLoC