colorgrad-rs

Rust color scales library for charts, maps, data-visualization and creative coding.

Index

Custom Gradient
Preset Gradients
Hard-Edged Gradient
Examples

Usage

Add colorgrad to your Cargo.toml [dependencies] colorgrad = "0.2.0"

Custom Gradient

Basic

rust let g = colorgrad::CustomGradient::new().build().unwrap();

Custom Colors

```rust use colorgrad::Color;

let g = colorgrad::CustomGradient::new() .colors(&[ Color::fromrgbu8(0, 206, 209), Color::fromrgbu8(255, 105, 180), Color::fromrgb(0.274, 0.5, 0.7), Color::fromhsv(50., 1., 1.), Color::from_hsv(348., 0.9, 0.8), ]) .build() .unwrap(); ```

Using Web Color Format

.html_colors() method accepts named colors, hexadecimal (#rgb, #rgba, #rrggbb, #rrggbbaa), rgb(), rgba(), hsl(), hsla(), hwb(), and hsv().

rust let g = colorgrad::CustomGradient::new() .html_colors(&["#c41189", "#00BFFF", "#FFD700"]) .build() .unwrap();

rust let g = colorgrad::CustomGradient::new() .html_colors(&["gold", "hotpink", "darkturquoise"]) .build() .unwrap();

rust let g = colorgrad::CustomGradient::new() .html_colors(&["rgb(125,110,221)", "rgb(90%,45%,97%)", "hsl(229,79%,85%)"]) .build() .unwrap();

Domain & Color Position

```rust let g = colorgrad::CustomGradient::new() .html_colors(&["deeppink", "gold", "seagreen"]) .build() .unwrap();

assert_eq!(g.domain(), (0., 1.)); ```

```rust let g = colorgrad::CustomGradient::new() .html_colors(&["deeppink", "gold", "seagreen"]) .domain(&[0., 100.]) .build() .unwrap();

assert_eq!(g.domain(), (0., 100.)); ```

```rust let g = colorgrad::CustomGradient::new() .html_colors(&["deeppink", "gold", "seagreen"]) .domain(&[-1., 1.]) .build() .unwrap();

assert_eq!(g.domain(), (-1., 1.)); ```

```rust let g = colorgrad::CustomGradient::new() .html_colors(&["deeppink", "gold", "seagreen"]) .domain(&[0., 0.7, 1.]) .build() .unwrap();

assert_eq!(g.domain(), (0., 1.)); ```

```rust let g = colorgrad::CustomGradient::new() .html_colors(&["deeppink", "gold", "seagreen"]) .domain(&[15., 30., 80.]) .build() .unwrap();

assert_eq!(g.domain(), (15., 80.)); ```

Blending Mode

rust let g = colorgrad::CustomGradient::new() .html_colors(&["#ff0", "#008ae5"]) .mode(colorgrad::BlendMode::Rgb) .build() .unwrap();

rust let g = colorgrad::CustomGradient::new() .html_colors(&["#ff0", "#008ae5"]) .mode(colorgrad::BlendMode::Lrgb) .build() .unwrap();

rust let g = colorgrad::CustomGradient::new() .html_colors(&["#ff0", "#008ae5"]) .mode(colorgrad::BlendMode::Hsv) .build() .unwrap();

Preset Gradients

All preset gradients are in the domain 0..1.

Diverging

colorgrad::brbg()

colorgrad::prgn()

colorgrad::piyg()

colorgrad::puor()

colorgrad::rdbu()

colorgrad::rdgy()

colorgrad::rdylbu()

colorgrad::rdylgn()

colorgrad::spectral()

Sequential (Single Hue)

colorgrad::blues()

colorgrad::greens()

colorgrad::greys()

colorgrad::oranges()

colorgrad::purples()

colorgrad::reds()

Sequential (Multi-Hue)

colorgrad::turbo()

colorgrad::viridis()

colorgrad::inferno()

colorgrad::magma()

colorgrad::plasma()

colorgrad::cividis()

colorgrad::warm()

colorgrad::cool()

colorgrad::cubehelix_default()

colorgrad::bugn()

colorgrad::bupu()

colorgrad::gnbu()

colorgrad::orrd()

colorgrad::pubugn()

colorgrad::pubu()

colorgrad::purd()

colorgrad::rdpu()

colorgrad::ylgnbu()

colorgrad::ylgn()

colorgrad::ylorbr()

colorgrad::ylorrd()

Cyclical

colorgrad::rainbow()

colorgrad::sinebow()

Hard-Edged Gradient

```rust let g1 = colorgrad::CustomGradient::new() .html_colors(&["#18dbf4", "#f6ff56"]) .build() .unwrap();

let g2 = g1.sharp(7); ```

rust let g = colorgrad::spectral().sharp(19);

Examples

Gradient Image

```rust extern crate colorgrad; extern crate image;

fn main() { let grad = colorgrad::CustomGradient::new() .html_colors(&["deeppink", "gold", "seagreen"]) .build() .unwrap();

let w = 1500;
let h = 70;
let fw = w as f64;

let mut imgbuf = image::ImageBuffer::new(w, h);

for (x, _y, pixel) in imgbuf.enumerate_pixels_mut() {
    let (r, g, b, _) = grad.at(x as f64 / fw).rgba_u8();
    *pixel = image::Rgb([r, g, b]);
}

imgbuf.save("gradient.png").unwrap();

} ```

Colored Noise

```rust extern crate colorgrad; extern crate image; extern crate noise;

use noise::NoiseFn;

fn main() { let w = 600; let h = 350; let scale = 0.015;

let grad = colorgrad::spectral();
let ns = noise::OpenSimplex::new();
let mut imgbuf = image::ImageBuffer::new(w, h);

for (x, y, pixel) in imgbuf.enumerate_pixels_mut() {
    let t = ns.get([x as f64 * scale, y as f64 * scale]);
    let (r, g, b, _) = grad.at(remap(t, -0.5, 0.5, 0.0, 1.0)).rgba_u8();
    *pixel = image::Rgb([r, g, b]);
}
imgbuf.save("noise.png").unwrap();

}

// Map value which is in range [a, b] to range [c, d] fn remap(value: f64, a: f64, b: f64, c: f64, d: f64) -> f64 { (value - a) * ((d - c) / (b - a)) + c } ```