bevy-clipmap 1.0.4

Render huge 3D worlds using Bevy!
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
51
52
53
54
55
56
57
58
59
60
61
62

# Bevy Clipmap


[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)
[![Doc](https://docs.rs/bevy-clipmap/badge.svg)](https://docs.rs/bevy-clipmap)
[![Crate](https://img.shields.io/crates/v/bevy-clipmap.svg)](https://crates.io/crates/bevy-clipmap)

![Screenshot](https://raw.githubusercontent.com/kirillsurkov/bevy-clipmap/refs/heads/main/screenshot.png)

## Overview


This project implements GPU-Based Geometry Clipmaps from this paper: https://hhoppe.com/gpugcm.pdf

This is an adaptive LOD technique that allows us to render huge worlds for cheap!

## Usage


The example usage can be seen in the [examples](examples/basic.rs) directory.
This example uses very low-resolution maps to save space when cloning this repository. Especially horizon maps can become quite huge. For better visual results, create your own higher-resolution textures.

## How to create textures


To create heightmap and horizon map textures you can use the [clipmap.py](convert/clipmap.py) script.

First of all, you have to install required libraries:
```sh
> pip install -r requirements.txt
```

```sh
> python clipmap.py --help
usage: clipmap.py [-h] filename {ktx,horizon} ...

Heightmap processing tool for the bevy-clipmap plugin

positional arguments:
  filename       16-bit PNG heightmap
  {ktx,horizon}
    ktx          Convert the heightmap to KTX2
    horizon      Create KTX2 horizon map

options:
  -h, --help     show this help message and exit
```

### Example usage:

```sh
> python clipmap.py heightmap.png ktx 8192 8192 # Convert 16-bit PNG to 8192x8192 KTX
> python clipmap.py heightmap.png horizon 2048 2048 16 # Convert 16-bit PNG to 2048x2048 horizon map with 16 FFT coefficients
```

Warning: Horizon maps require significant disk space. It generates 360 horizon maps and requires `360 * W * H * 4` bytes. For 1k map it requires only 1.4GB, but for 16k map it leads to 360GB.

## Compatible Bevy versions

| `bevy-clipmap` | `bevy`   |
| :--            | :--      |
| `1.0.4`        | `0.18.0` |
| `1.0.3`        | `0.17.3` |

## Contributing

PRs are very welcome!