search

atheriel / grunge

A coherent noise library in its very early stages.
2 stars 1 forks source link

readme

Grunge Build Status

Grunge is a pseudo-random coherent noise library in the spirit of libnoise, ACL, and the Coherent Noise Library. Unlike earlier libraries, it uses the [Simplex Noise] (http://en.wikipedia.org/wiki/Simplex_noise) algorithm, and should have better performance as a result. Hopefully, it will one day contain more features as well.

The API should be familiar to users of libnoise and the Coherent Noise Library, but is subject to change without notice at this point in the project -- which is currently in the very early stages of development.

Example

The following writes a PGM file using the PinkNoise generator.

use std::io::{File, Truncate, Write};
use cgmath::vector::Vector2;
use grunge::module::{NoiseModule, PinkNoise};

let noise = PinkNoise::new(0u);
let p = Path::new("example.pgm");

let mut file = match File::open_mode(&p, Truncate, Write) {
    Ok(f) => f,
    Err(e) => fail!("--- File error: {}", e),
};

// Write the PGM header first. P5 is for binary data (i.e. u8).
let _ = file.write_str(format!("P5\n{0} {1}\n{2}\n", 500u, 500u, 255u).as_slice());

// Write a sample of 500x500 pixels to the image file
for y in range(-250i, 250i) {
    for x in range(-250i, 250i) {
        let point = Vector2::new((x as f32) / 100.0, (y as f32) / 100.0);
        let tmp = noise.generate_2d(point).unwrap() * 0.15 + 0.5; // Usually fits in [0, 1]
        let _ = file.write_u8((tmp * 255.0) as u8);
    }
}

println!("--- Output image written to example.pgm");

In case you can't open the PGM format, ImageMagick's convert example.pgm example.png may do the trick.

Planned Features