pixel-weaver 0.1.2

A multi-threaded pixel-by-pixel image renderer
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

use cgmath::{
    Vector2,
    Vector3,
    vec2,
    vec3
};
use crate::ImageData;

/// Returns the UV space conversion of the pixel coordinate.
/// Centered at (0,0).
/// Adjusted for aspect ratio.
pub fn uv(image_data: &ImageData, coord: &Vector2<u32>) -> Vector2<f64> {
    let mut uv: Vector2<f64> = vec2(0., 0.);
    uv.y = ((coord.x as f64 / image_data.resolution.y as f64) * 2. - 1.0) * -1.;
    uv.x = ((coord.y as f64 / image_data.resolution.x as f64) * 2. - 1.0) * image_data.aspect_ratio;
    uv
}

/// Returns the length of UV coordinate
pub fn length(coord: Vector2<f64>) -> f64 {
    (coord.x.powi(2) + coord.y.powi(2)).sqrt()
}

/// Takes a normalized `Vector3<f64>` and returns a conversion to `Vector3<u8>` in 24 bit color space
pub fn f64_vector3_to_u8(vector: Vector3<f64>) -> Vector3<u8> {
    vec3(
        (vector.x * 255.).clamp(0.0, 255.0) as u8,
        (vector.y * 255.).clamp(0.0, 255.0) as u8,
        (vector.z * 255.).clamp(0.0, 255.0) as u8,
    )
}

/// Takes a normalized value and returns a conversion to a single 8 bit color channel
pub fn normal_to_rgb(val: f64) -> u8 {
    (val * 255.0).clamp(0., 255.) as u8
}