4 releases
new 0.2.1 | Oct 9, 2024 |
---|---|
0.2.0 | Jul 13, 2024 |
0.1.1 | Jun 1, 2024 |
0.1.0 | May 29, 2024 |
#270 in Game dev
123 downloads per month
44KB
995 lines
bevy_compute_noise
A plugin for bevy 0.14
for generating tilable 2D/3D noise textures using compute shaders.
Check out a demo of the plugin here: https://jadedbay.com/demo/bevy_compute_noise (Chrome only)
Usage
Add the bevy_compute_noise
dependency to Cargo.toml
:
[dependencies]
bevy_compute_noise = "0.2.0"
Add Noise Plugin
use bevy_compute_noise::prelude::*;
App::default()
.add_plugins(DefaultPlugins)
.add_plugins(ComputeNoisePlugin::<Perlin2D>::default()) // add new plugin for each type of noise needed
.run();
Queue Noise Generation
fn setup(
mut images: ResMut<Assets<Image>>,
mut perlin_2d_queue: ResMut<ComputeNoiseQueue<Perlin2D>>
) {
// Create and queue noise image
let noise_image: Handle<Image> = perlin_2d_queue.add(
&mut images,
ComputeNoiseSize::D2(128, 128), // Use ComputeNoiseSize::D3 for 3D noise
Perlin2d {
seed: 0,
frequency: 5,
octaves: 4
}
);
}
Alternatively, you can add ComputeNoiseComponent<T: ComputeNoise>
to an entity and it will be automatically queued whenever it has been updated:
fn setup(
commands: Commands,
mut images: ResMut<Assets<Image>>,
) {
// Manually create noise image, so it can be used elsewhere.
let noise_image = ComputeNoiseImage::create_image(ComputeNoiseSize::D2(128, 128));
commands.spawn(ComputeNoiseComponent::<Perlin2d> {
image: noise_image.clone();
noise: Perlin2d {
seed: 0,
frequency: 5,
octaves: 4
}
});
}
Noise Types
- Worley2D
- Worley3D
- Perlin2D
TODO
- Add more noise types.
- Allow combination of noise.
- Allow writing into specific texture channels.
Version Compatibility
bevy_compute_noise |
Bevy |
---|---|
0.2 |
0.14 |
0.1 |
0.13 |
Readback
If you need to readback the noise texture to the CPU, you can clone the readback branch and view the example in there. I'm not completely happy with the implementation and it's better to just generate the noise on the CPU using another crate anyway.
Dependencies
~34–71MB
~1.5M SLoC