https://github.com/josephg/noisejs
Javascript 2D Perlin & Simplex noise functions
https://github.com/josephg/noisejs
Last synced: 8 months ago
JSON representation
Javascript 2D Perlin & Simplex noise functions
- Host: GitHub
- URL: https://github.com/josephg/noisejs
- Owner: josephg
- License: isc
- Created: 2012-07-01T10:44:25.000Z (over 13 years ago)
- Default Branch: master
- Last Pushed: 2022-11-02T18:24:03.000Z (about 3 years ago)
- Last Synced: 2025-04-14T19:58:22.501Z (9 months ago)
- Language: JavaScript
- Size: 12.7 KB
- Stars: 1,673
- Watchers: 29
- Forks: 249
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-frontend - Noise.js
README
# NOISE!
This is a simple library for 2d & 3d perlin noise and simplex noise in
javascript. Noise is
[pretty](https://josephg.com/perlin/3/).
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](http://josephg.github.com/noisejs/demo3d.html).
The code is based on Stefan Gustavson's implementation. Do whatever you want
with it, etc.
## How to make noise:
```javascript
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.