simplenoise

JS noise functions

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
simplenoise
1.0.16 years ago6 years agoMinified + gzip package size for simplenoise in KB

Readme

NOISE!
This is a simple library for 2d & 3d perlin noise and simplex noise in javascript. Noise is pretty.
The library is pretty fast (10M queries / sec). But its still way slower than using a shader. For example, if you try and update an entire screen's worth of pixels, it'll be slow.
The code is based on Stefan Gustavson's implementation. Do whatever you want with it, etc.

How to make noise:

// Either import it via npm or <script src=noise.js></script>. This library works either way.
const noise = require('simplenoise')

noise.seed(Math.random())

for (var x = 0; x < canvas.width; x++) {
  for (var y = 0; y < canvas.height; y++) {
    // All noise functions return values in the range of -1 to 1.

    // noise.simplex2 and noise.perlin2 for 2d noise
    var value = noise.simplex2(x / 100, y / 100)
    // ... or noise.simplex3 and noise.perlin3:
    var value = noise.simplex3(x / 100, y / 100, time)

    image[x][y].r = Math.abs(value) * 256 // Or whatever. Open demo.html to see it used with canvas.
  }
}

The library exposes an object called noise with the following properties:
  • simplex2(x, y): 2D Simplex noise function
  • simplex3(x, y, z): 3D Simplex noise function
  • perlin2(x, y): 2D Perlin noise function
  • perlin3(x, y, z): 3D Perlin noise function
  • seed(val): Seed the noise functions. Only 65536 different seeds are supported. Use a float between 0 and 1 or an integer from 1 to 65536.