https://github.com/johanhelsing/noisy_bevy

Simple stupid noise primitives for WGSL and Rust (glam/bevy types)
https://github.com/johanhelsing/noisy_bevy

bevy fbm noise procedural-generation simplex-noise

Last synced: 3 days ago
JSON representation

Simple stupid noise primitives for WGSL and Rust (glam/bevy types)

• Host: GitHub
• URL: https://github.com/johanhelsing/noisy_bevy
• Owner: johanhelsing
• License: other
• Created: 2022-10-24T19:54:29.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2024-07-10T19:16:22.000Z (6 months ago)
• Last Synced: 2024-10-29T17:55:44.834Z (about 2 months ago)
• Topics: bevy, fbm, noise, procedural-generation, simplex-noise
• Language: Rust
• Homepage:
• Size: 103 KB
• Stars: 75
• Watchers: 4
• Forks: 7
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# noisy_bevy

[![crates.io](https://img.shields.io/crates/v/noisy_bevy.svg)](https://crates.io/crates/noisy_bevy)

![MIT](https://img.shields.io/badge/license-MIT-blue.svg)

[![docs.rs](https://img.shields.io/docsrs/noisy_bevy)](https://docs.rs/noisy_bevy)

Simple stupid noise primitives for glam types (`Vec2`, `Vec3`) and wgsl.

Main motivations are:

- ergonomic usage with Bevy

- same results on rust and wgsl (not bit-level perfect, though)

![screenshot of an asteroid generated on the gpu and cpu](https://s3.johanhelsing.studio/dump/noisy_asteroid.png)

## Implemented noise primitives:

- [`simplex_noise_2d`]

- [`simplex_noise_2d_seeded`]

- [`simplex_noise_3d`]

- [`fbm_simplex_2d`]

- [`fbm_simplex_2d_seeded`]

- [`fbm_simplex_3d`]

## Usage

### From rust

Zero initialization, just call the noise functions:

```rust

use bevy::prelude::*;

use noisy_bevy::simplex_noise_2d;

let p = Vec2::new(12.3, 45.6);

let value = simplex_noise_2d(p);

```

### From wgsl shaders

First add the plugin to the Bevy app:

```rust ignore

App::new()

    .add_plugins(NoisyShaderPlugin)

```

And import it and use it in your shaders, with the same API as on the CPU-side:

```wgsl

#import noisy_bevy::simplex_noise_2d

// ...

let p = vec2(12.3, 45.6);

let value = simplex_noise_2d(p);

```

See the [`asteroids example`](https://github.com/johanhelsing/noisy_bevy/blob/main/examples/asteroids.rs), for an example that uses noise to procedurally generate a tilemap on the CPU and a matching background in a wgsl shader.

## Bevy Version Support

The `main` branch targets the latest bevy release.

|bevy|noisy_bevy|

|----|----------|

|0.15| 0.8, main|

|0.14| 0.7      |

|0.13| 0.6      |

|0.12| 0.5      |

|0.11| 0.4      |

|0.10| 0.3      |

|0.9 | 0.2      |

|0.8 | 0.1      |

## License

MIT

The original simplex noise source is MIT-only, however all changes made by me or PRs to this repo are also available under Apache-2.0.

## Acknowledgments

The noise primitives are ports/copies of these

- 

- 

## Contributions

PRs welcome!