This is a wrapper for the Accidental Noise Library originally written by Joshua Tippetts, modified to be properly compiled for Godot Engine and be used freely in both GDScript and C#.
The master branch aims to be in sync with Godot's master branch. Checkout other branches and/or releases for compatible versions. You can decide which version you need based on the following compatibility table:
3.0 | 3.1 | 3.2 | 4.0 | |
---|---|---|---|---|
1.0 | π | π | π | π |
2.0 | π | π | π | π |
2.1 | π | π | π | π€ |
2.2 | π | β | β | π€ |
Note: the latests versions may not be released yet and are kept for reference, but expect them to be compatible.
- generate height, normal and bump maps from noise directly;
- ability to construct noise from visual nodes in editor and via code;
- make custom modular noise as components from base nodes.
See wiki on how to get started creating noise with visual nodes.
The AccidentalNoise class encapsulates the two main classes required for noise
generation: CKernel
and CNoiseExecutor
.
The kernel holds any amount of noise functions together creating compound noise function. The noise executor then evaluates the function chain at any point of the pipeline.
The library is full of features compared to other noise generation libraries with a drawback of poorer performance.
If you'd like to try out or develop the module:
git clone https://github.com/Xrayez/godot-anl anl
scons
Note that scons
will clone Godot Engine repository and compile the engine with
the module for you. Make sure that the module's directory name is exactly
anl
. Once the compilation is done, the resulting binaries should be available
under godot/bin
directory.
If you'd like to compile the module the traditional way, please refer to Godot Engine: Compiling documentation.
Noise functions will have a period of 256; with coordinates higher than that,
the patterns will repeat. If a larger period is required, build with
anl_use_expressions_camelcase
command line option to use a long-period hash
instead in exchange for a slight decrease in performance:
scons anl_use_long_period=yes
The original library uses camelCase
to parse function tokens in an expression,
yet the module uses snake_case
to confirm to Godot's naming convention. If you
still want to use camelCase
style, build with anl_use_expressions_camelcase
command line option:
scons anl_use_expressions_camelcase=yes
See landscape.gd.
You can also map the noise to an image with dedicated method instead to simplify the above example:
image = noise.get_image(width, height)
... or even tiled texture!
noise.mode = AccidentalNoise.SEAMLESS_XY
texture = noise.get_texture(width, height)
Expression builder can be used to simplify the process of chaining functions together to one-liners:
var n = AccidentalNoise.new()
var expression = "translate(select(0, 1, (x + y), 0.5, 0), 10)"
var function = noise.evaluate(expression)
var value = noise.color_2d(x, y, function)
But please note that the expression builder feature is a work in progress as stated by original author. Some functions work, some don't and might crash the engine.
See demo project: AnlTest.cs.
using Godot;
using System;
public class AnlTest : Godot.Node2D
{
public override void _Ready()
{
AccidentalNoise an = new Godot.AccidentalNoise();
AccidentalNoise.InterpolationTypes interp = AccidentalNoise.InterpolationTypes.Linear;
int seed = 37;
an.Function = an.GradientBasis(an.Constant((double)interp), an.Constant(seed));
an.Function = an.Scale(an.Function, an.Constant(5.0));
an.Mode = AccidentalNoise.MappingModes.Xy;
ImageTexture noise = an.GetTexture(128, 128) as ImageTexture;
GetNode<TextureRect>("Noise").Texture = noise;
}
}
It's possible to modify noise parameters via special noise variables which are
like constant()
but can be set and retrieved by name.
See random_noise.gd.