bevy_heightmap 0.2.1

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

# `bevy_heightmap`



[![License](https://img.shields.io/badge/license-MIT%2FApache-blue.svg)](https://github.com/Katsutoshii/bevy_heightmap#license)
[![Crates.io](https://img.shields.io/crates/v/bevy_heightmap.svg)](https://crates.io/crates/bevy_heightmap)
[![Docs](https://docs.rs/bevy_heightmap/badge.svg)](https://docs.rs/bevy_heightmap/latest/bevy_heightmap/)

Load height map PNGs as meshes in `bevy`.
| Height map                           | Generated                          |
|--------------------------------------|----------------------------------------|
|![example_image](docs/terrain.hmp.png)|![example_image](docs/example_image.png)|

## Usage


Create a height map from a value function:

```rust
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):

```rust
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          |