nimble install noisy
Noisy is a SIMD-accelerated Nim implementation of Simplex (Perlin) noise. The goal of this library is to be easy to use, performant and dependency-free.
Noisy works well using Nim's relatively new --gc:arc and --gc:orc as well as the default garbage collector. This library also works using both nim c and nim cpp, in addition to --cc:vcc on Windows.
I have also verified that Noisy builds with --experimental:strictFuncs on Nim 1.4.0.
import noisy, strformat
var simplex = initSimplex(1988)
simplex.frequency = 0.1
# Starting at (0, 0) generate a 16x16 grid of 2D noise values.
let values = simplex.grid((0, 0), (16, 16))
for x in 0 ..< 16:
for y in 0 ..< 16:
let value = values[x, y]
echo &"({x},{y}): {value}"Benchmarks can be run comparing methods for generating noise values. Check the performance yourself by running tests/benchmark.nim.
nim c -d:release -r .\tests\benchmark.nim (256 x 256 x 256 cube of 3D simplex noise with 3 octaves, lower time is better)
| Method | Time |
|---|---|
Point by point using value(x, y, z) |
1.6066s |
Using grid() (SIMD accelerated, GCC default) |
1.0281s |
Using grid() (SIMD accelerated, --passC:"-mavx") |
0.7476s |
nimble test
import noisySimplex = object
octaves*: int
amplitude*, frequency*, lacunarity*, gain*: float32Grid = ref object
width*, height*, depth*: int
values*: seq[float32]NoisyError = object of ValueErrorfunc initSimplex(seed: int): SimplexReturns the noise value at (x, y) or (x, y, z).
func `[]`(g: Grid; x, y: int; z = 0): float32 {.inline.}Generates the 2D noise value at (x, y) based on the Simplex parameters.
func value(simplex: Simplex; x, y: float32): float32 {.raises: [NoisyError], tags: [].}Generates the 3D noise value at (x, y, z) based on the Simplex parameters.
func value(simplex: Simplex; x, y, z: float32): float32 {.raises: [NoisyError], tags: [].}Helper for working with ints.
func value(simplex: Simplex; x, y: int): float32 {.inline, raises: [NoisyError], tags: [].}Helper for working with ints
func value(simplex: Simplex; x, y, z: int): float32 {.inline, raises: [NoisyError].}Beginning at position start, generate a grid of 2D noise based on the Simplex parameters. The width and height of the grid is set by the dimens parameter.
func grid(simplex: Simplex; start: (float32, float32); dimens: (int, int)): Grid {.raises: [NoisyError].}Helper for working with ints.
func grid(simplex: Simplex; start: (int, int); dimens: (int, int)): Grid {. inline, raises: [NoisyError].}Beginning at position start, generate a grid of 3D noise based on the Simplex parameters. The width, depth, and height of the grid is set by the dimens parameter.
func grid(simplex: Simplex; start: (float32, float32, float32);
dimens: (int, int, int)): Grid {.raises: [NoisyError].}Helper for working with ints.
func grid(simplex: Simplex; start: (int, int, int); dimens: (int, int, int)): Grid {. inline, raises: [NoisyError].}