Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tayloraswift/swift-noise
Generate and compose commonly-used procedural noises and distributions, in pure Swift
https://github.com/tayloraswift/swift-noise
graphics perlin-noise poisson-disc-sampling procedural-noise pseudo-random-generator simplex-noise supersimplex-noise worley-noise
Last synced: 1 day ago
JSON representation
Generate and compose commonly-used procedural noises and distributions, in pure Swift
- Host: GitHub
- URL: https://github.com/tayloraswift/swift-noise
- Owner: tayloraswift
- License: apache-2.0
- Created: 2017-05-22T20:04:11.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-12-13T21:19:33.000Z (18 days ago)
- Last Synced: 2024-12-23T00:06:46.005Z (8 days ago)
- Topics: graphics, perlin-noise, poisson-disc-sampling, procedural-noise, pseudo-random-generator, simplex-noise, supersimplex-noise, worley-noise
- Language: Swift
- Homepage: https://swiftinit.org/docs/swift-noise/noise
- Size: 26.5 MB
- Stars: 128
- Watchers: 5
- Forks: 12
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
***`noise`***
`2.0`
[](https://github.com/tayloraswift/swift-noise/actions/workflows/Tests.yml)
[](https://github.com/tayloraswift/swift-noise/actions/workflows/Documentation.yml)
**`swift-noise`** is a free, pure Swift procedural noise generation library. The library product has no dependencies and does not import Foundation or any system frameworks.
All popular types of procedural noise are supported, including three [gradient noises](https://en.wikipedia.org/wiki/Perlin_noise) (often called Perlin or simplex noises), and two [cellular noises](https://en.wikipedia.org/wiki/Worley_noise) (sometimes called Worley or Voronoi noises).
`swift-noise` includes a [fractal brownian motion](https://thebookofshaders.com/13/) (FBM) noise composition framework, and a [disk point sampler](https://en.wikipedia.org/wiki/Supersampling#Poisson_disc) (often called a Poisson sampler), for generating visually even point distributions in the plane. `swift-noise` also includes pseudo-random number generation and hashing tools.
`swift-noise`’s entire public API is [documented](https://swiftinit.org/docs/swift-noise/noise).
## Requirements
The swift-noise library requires Swift 5.10 or later.
| Platform | Status |
| -------- | ------ |
| 🐧 Linux | [](https://github.com/tayloraswift/swift-noise/actions/workflows/Tests.yml) |
| 🍏 Darwin | [](https://github.com/tayloraswift/swift-noise/actions/workflows/Tests.yml) |
| 🍏 Darwin (iOS) | [](https://github.com/tayloraswift/swift-noise/actions/workflows/iOS.yml) |
| 🍏 Darwin (tvOS) | [](https://github.com/tayloraswift/swift-noise/actions/workflows/tvOS.yml) |
| 🍏 Darwin (visionOS) | [](https://github.com/tayloraswift/swift-noise/actions/workflows/visionOS.yml) |
| 🍏 Darwin (watchOS) | [](https://github.com/tayloraswift/swift-noise/actions/workflows/watchOS.yml) |
[Check deployment minimums](https://swiftinit.org/docs/swift-noise#ss:platform-requirements)
## Building
Build *Noise* with the Swift Package Manager. *Noise* itself has no dependencies, but the tests use
The package includes an executable, `generate-noise`, that depends on [`swift-png`](https://github.com/tayloraswift/swift-png).
It generates noise locally for visual inspection.
To regenerate example images, run the following command in the terminal:
```
swift run -c release generate-noise
```