HTTPS clone URL
Subversion checkout URL
Clone this wiki locally
This repository contains GLSL source code for Perlin noise in 2D, 3D and 4D, both the modern simplex versions and the classic versions, including periodic noise similar to the
pnoise() function in RenderMan SL. The functions have very good performance and no dependencies on external data. The code is open source, licensed under the terms of the OSI-approved and very permissive MIT license. For licensing details, please refer to the LICENSE file in the repository.
A scientific paper about this was accepted for publication in JGT, (Journal of Graphics Tools), and after a long delay it finally appeared in print in June 2012. You are also welcome to read our preprint on http://www.itn.liu.se/~stegu/jgt2012/.
The source code has been available online here on Github for some time, and you can of course use the functions without reading any part of the article. They require no setup or external data, just the GLSL source provided here, and they should work on any current OpenGL platform, including OpenGL 2.1, OpenGL 3.x and 4.x, OpenGL ES 2.x and WebGL 1.0. They will also work in limited vertex shader environments where texture lookup is not available.
NOTE: You do not need a super fast GPU to use these functions. They are useful even on low end hardware, old hardware and embedded OpenGL ES hardware with low performance.
The repository also contains C code for a cross-platform benchmark and a demo. To compile and run these programs, you need a desktop OS like Linux, Windows, MacOSX or some flavor of Unix with OpenGL support, and the GLFW library (http://glfw.sourceforge.net). Makefiles are provided for Linux, Windows and MacOS X.
The GLSL source files and the noise functions you will currently find here are:
noise2D.glsl - 2D simplex noise
float snoise(vec2 x). Very fast, very compact code.
noise3D.glsl - 3D simplex noise
float snoise(vec3 x). Fast, compact code.
noise4D.glsl - 4D simplex noise
float snoise(vec4 x). Reasonably fast, reasonably compact code.
classicnoise2D.glsl - 2D classic Perlin noise
float cnoise(vec2 x), and a periodic variant
float pnoise(vec2 x, vec2 period). Fast and compact code, only slightly slower than 2D simplex noise.
classicnoise3D.glsl - 3D classic Perlin noise
float cnoise(vec3 x), and a periodic variant
float pnoise(vec3 x, vec3 period). Reasonably fast but not very compact code. Not quite as fast as 3D simplex noise.
classicnoise4D.glsl - 4D classic Perlin noise
float cnoise(vec4 x), and a periodic variant
float pnoise(vec4 x, vec4 period). Only about half as fast as 4D simplex noise, and rather bloated code, but still useful.
The source files here are further optimized compared to the versions in the published JGT paper. Not by a lot, but they are somewhat faster still.
All the functions above return a single float. For the equivalents of
noise4(), you need to call these noise functions several times with different constant offsets for the arguments, e.g.
vec3(snoise(P), snoise(P+17.0), snoise(P-43.0)). People have different opinions on whether these offsets should be integers for the classic noise functions to match the spacing of the zeroes, so we have left that for you to decide for yourself. For most applications, the exact offsets don't really matter as long as they are not too small or too close to the noise lattice period (289 in our implementation).
The motivation for these functions not using any textures is ease of use, self-sufficiency and scalability for massively parallel execution. Noise is seldom used by itself, and these functions can make use of the often untapped ALU resources when run concurrently with traditional texture-intensive real time rendering tasks. However, if you are generating noise by itself and using a lot of it, the texture-intensive noise implementations this work was based on are still up to twice as fast on current generation desktop GPU hardware with lots of texture units and smart texture caching. You can find the original release of the old noise code on http://www.itn.liu.se/~stegu/simplexnoise/GLSL-noise.zip (Windows binary, Windows-dependent source code). A newly written cross platform benchmark comparing it to this new version is on http://www.itn.liu.se/~stegu/simplexnoise/GLSL-noise-vs-noise.zip. For the convenience of Windows users, a version with a precompiled Windows binary is in http://www.itn.liu.se/~stegu/simplexnoise/GLSL-noise-vs-noise-Win32.zip.
A GLSL 1.20 compatible implementation of cellular noise ("Worley noise") is available on http://www.itn.liu.se/~stegu/GLSL-cellular/. It is a straightforward but non-trivial implementation of previous ideas from software procedural shading, using the ideas for pseudo-random permutation from the computational Perlin noise presented in this repository and with some optional shortcuts for situations where speed is more important than accuracy.
A GLSL 1.20 compatible re-implementation of "flow noise", as presented by Perlin and Neyret, is available as part of this demo: http://www.itn.liu.se/~stegu/gpunoise/. It is undocumented, but the example and the original Siggraph publication below should be enough to use it: http://citeseerx.ist.psu.edu/viewdoc/download?doi=10.1.1.141.5266&rep=rep1&type=pdf
- Ooman - Simplex noise is used for milestone platforms and 15-puzzle tiles
- Altered Qualia's Noise Shader Demo Pages: flesh, slime, copper, mercury, gold, stucco, amber, sparks
- Miaumiau Labs' Curl Noise + Volume Shadow particles demonstration
- Jax WebGL Framework's standard noise fallback as seen in their meadow demo and material demo on machines where their standard texture lookup method fails
Do you have a WebGL application or demonstration that uses this noise library? Let us know and we will add it to this list.