fastnoise2 provides an easy-to-use and mostly safe interface for the FastNoise2 C++ library, which provides modular node graph-based noise generation using SIMD.

This crate acts as a wrapper around fastnoise2-sys, the unsafe bindings for FastNoise2.

Here is an example of a encoded node tree, exported by FastNoise2's Node Editor.

use fastnoise2::SafeNode;

let (x_size, y_size) = (1000, 1000);
let step_size = 3.0;
let encoded_node_tree = "E@BBZEG@BD8JFgIECArXIzwECiQIw/UoPwkuAAE@BJDQAH@BC@AIEAJBw@ABZEED0KV78YZmZmPwQDmpkZPwsAAIA/HAMAAHBCBA==";
let node = SafeNode::from_encoded_node_tree(encoded_node_tree).unwrap();

// Allocate a buffer of enough size to hold all output data.
let mut noise_out = vec![0.0; (x_size * y_size) as usize];

let min_max = node.gen_uniform_grid_2d(
    &mut noise_out,
    -x_size as f32 / 2.0 * step_size, // x offset
    -y_size as f32 / 2.0 * step_size, // y offset
    x_size,                           // x size
    y_size,                           // y size
    step_size,                        // x step size
    step_size,                        // y step size
    1337,                             // seed
);

// use `noise_out`!

You can also manually code a node tree using FastNoise2's metadata system, either with Node, or by combining generators, see SafeNode.

Take a look at examples to find out more.

fastnoise2-sys, the underlying bindings for fastnoise2, uses a build script that follows a specific order of preference for compiling and/or linking the FastNoise2 library:

1. Building from source, if the build-from-source feature is enabled.
2. If the FASTNOISE2_LIB_DIR environment variable is set to /path/to/lib/, that path will be searched for static FastNoise library.
3. If not set, it falls back to building from source.

To build FastNoise2 from source using fastnoise2-sys, ensure you have:

• CMake
• a C++17 compiler

• If you prefer not to build from source, precompiled binaries are available for download from the FastNoise2 Releases.
• For a web-based Node Editor experience, check out the official Web WASM Node Editor.
• For desktop platforms, you can download compiled Node Editor binaries from the FastNoise2 Releases.
• The FASTNOISE2_SOURCE_DIR environment variable is generally not needed as fastnoise2-sys includes the FastNoise2 source code as a Git submodule. If you need to use a different source directory, set FASTNOISE2_SOURCE_DIR to point to the root of the FastNoise2 source code.