noise-rs
A procedural noise generation library for Rust.
use Fbm;
let fbm = new;
let val = fbm.get;
API
Gradient Noise
Gradient noise produces a smooth, continuous value over space. It's achieved by dividing space into regions, and placing a random gradient at each vertex, then blending between those gradients.
Perlin noise
A very fast and reasonable quality gradient noise:
Perlin::new()
OpenSimplex noise (To be deprecated)
A slower but higher quality form of gradient noise:
open_simplex2
open_simplex3
open_simplex4
Value Noise (To be deprecated)
Value noise (sometimes mistaken with gradient noise) produces lower quality smooth noise. It exhibits pronounced grid artifacts, but can be slightly faster than gradient noise. Benchmarks show it's about 1.2–1.3× faster than Perlin noise.
Cell neighbours are blended using a weighted S-curve linear interpolation method. This removes any discontinuities across grid edges.
value2
value3
value4
Fractional Brownian Motion
A way of combining multiple octaves of a noise function to create a richer and more varied output:
Fbm::new()
Worley Noise
Named after Steven Worley, and also called voronoi noise, is based on dividing space into cells based on proximity to a random set of seed points.
Worley::new()
Noise Modules
These are the actual noise modules, which just take a coordinate using get()
and return
a value. They can be chained together when declared, creating very complex noise results.
See the individual module pages for their descriptions, and the examples for their usage.
License
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT) at your option.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you shall be dual licensed as above, without any additional terms or conditions.