Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/auburn/fastnoiselite
Fast Portable Noise Library - C# C++ C Java HLSL GLSL JavaScript Rust Go
https://github.com/auburn/fastnoiselite
cellular-noise cubic-noise fractal-algorithms hacktoberfest noise noise-2d noise-3d noise-algorithms noise-generator noise-library perlin perlin-noise procedural procedural-generation shader simplex simplex-algorithm terrain-generation voronoi
Last synced: about 1 month ago
JSON representation
Fast Portable Noise Library - C# C++ C Java HLSL GLSL JavaScript Rust Go
- Host: GitHub
- URL: https://github.com/auburn/fastnoiselite
- Owner: Auburn
- License: mit
- Created: 2016-03-28T02:35:12.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-04-01T14:04:26.000Z (8 months ago)
- Last Synced: 2024-05-01T16:20:38.123Z (7 months ago)
- Topics: cellular-noise, cubic-noise, fractal-algorithms, hacktoberfest, noise, noise-2d, noise-3d, noise-algorithms, noise-generator, noise-library, perlin, perlin-noise, procedural, procedural-generation, shader, simplex, simplex-algorithm, terrain-generation, voronoi
- Language: Rust
- Homepage: http://auburn.github.io/FastNoiseLite/
- Size: 1.73 MB
- Stars: 2,564
- Watchers: 59
- Forks: 311
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](https://discord.gg/SHVaVfV)
# FastNoise Lite
[Web Preview App](https://auburn.github.io/FastNoiseLite)
FastNoise Lite is an extremely portable open source noise generation library with a large selection of noise algorithms. This library focuses on high performance while avoiding platform/language specific features, allowing for easy ports to as many possible languages.
This project is an evolution of the [original FastNoise](https://github.com/Auburn/FastNoiseLite/tree/FastNoise-Legacy) library and shares the same goal: An easy to use library that can quickly be integrated into a project and provides performant modern noise generation. See a breakdown of changes from the transition to FastNoise Lite [here](https://github.com/Auburn/FastNoiseLite/pull/49)
If you are looking for a more extensive noise generation library consider using [FastNoise2](https://github.com/Auburn/FastNoise2). It provides large performance gains thanks to SIMD and uses a node graph structure to allow complex noise configurations with lots of flexibility.
## Features
- 2D & 3D sampling
- OpenSimplex2 noise
- OpenSimplex2S noise
- Cellular (Voronoi) noise
- Perlin noise
- Value noise
- Value Cubic noise
- OpenSimplex2-based domain warp
- Basic Grid Gradient domain warp
- Multiple fractal options for all of the above
- Supports floats and/or doubles
### Supported Languages
- [C#](/CSharp/)
- [C++98](/Cpp/)
- [C99](/C/)
- [HLSL](/HLSL/)
- [GLSL](/GLSL/)
- [Go](/Go/)
- [Java](/Java/)
- [JavaScript](/JavaScript/)
[](https://www.npmjs.com/package/fastnoise-lite)
- [Rust](/Rust/)
[](https://crates.io/crates/fastnoise-lite)
- [Fortran](/Fortran/)
- [Zig](/Zig/)
If you want to port FastNoise Lite to a new language create a pull request or discuss it on the discord linked above
### [Getting Started](https://github.com/Auburn/FastNoiseLite/wiki#getting-started)
### [Documentation](https://github.com/Auburn/FastNoiseLite/wiki/Documentation)
## FastNoise Lite Web Preview App
Link: [https://auburn.github.io/FastNoiseLite](https://auburn.github.io/FastNoiseLite)
A compact testing application is available for testing all features included in FastNoise Lite with a visual representation. This can be used for development purposes, testing noise settings and generating noise textures for export.
Source code can be found in the [WebPreviewApp](/WebPreviewApp/) directory.
## Performance Comparisons
Benchmarked using C++ version with [NoiseBenchmarking](https://github.com/Auburn/NoiseBenchmarking)
- CPU: Intel 7820X @ 4.9Ghz
- OS: Win10 x64
- Compiler: clang-cl 10.0.0 -m64 /O2
Million points of noise generated per second (higher = better)
| 3D | Value | Perlin | (*Open)Simplex | Cellular |
|--------------------|--------|--------|----------------|----------|
| FastNoise Lite | 64.13 | 47.93 | 36.83* | 12.49 |
| FastNoise (Legacy) | 49.34 | 37.75 | 44.74 | 13.27 |
| FastNoise 2 (AVX2) | 494.49 | 261.10 | 268.44 | 52.43 |
| libnoise | | 27.35 | | 0.65 |
| stb perlin | | 34.32 | | |
| 2D | Value | Perlin | Simplex | Cellular |
|--------------------|--------|--------|---------|----------|
| FastNoise Lite | 114.01 | 92.83 | 71.30 | 39.15 |
| FastNoise (Legacy) | 102.12 | 87.99 | 65.29 | 36.84 |
| FastNoise 2 (AVX2) | 776.33 | 624.27 | 466.03 | 194.30 |
## Credits:
- [OpenSimplex2](https://github.com/KdotJPG/OpenSimplex2) for the OpenSimplex2 noise algorithm
- [@KdotJPG](https://github.com/KdotJPG) for implementing all the OpenSimplex algorithms and the Java port
- [CubicNoise](https://github.com/jobtalle/CubicNoise) for the Value (Cubic) noise algorithm
- [@Rover656](https://github.com/Rover656) for creating the preview GUI and porting FastNoise Lite to C and HLSL.
- [@snowfoxsh](https://github.com/snowfoxsh) for creating the JavaScript port.
- [@dotlogix](https://github.com/dotlogix) for creating the GLSL port.
- [@ForeverZer0](https://github.com/ForeverZer0) for creating the Zig and Go ports.
- [@Keavon](https://github.com/Keavon) for creating the Rust port.
- [@jordan4ibanez](https://github.com/jordan4ibanez) for creating the Fortran port.
## Contributing
New ports of FastNoise Lite are always welcome, create a PR or come discuss the port with me on the discord linked above.
I'm not an expert or even familiar with every language FastNoise lite has been ported to, so if you see something that could be improved please contribute or create a GitHub issue.
# Examples
