turbine_process3d 0.11.1

Processing for the Turbine game engine
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
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

//! Mathematical algorithms.

pub use vecmath::{
    mat4_id,
    mat4_transposed,
};

use crate::{Chunk, Cube, Line, Matrix4, Point, Quad, Rgb, Rgba, Triangle};

/// Transform point.
///
/// This transform is row-major, which is standard mathematical notation.
/// To convert column-major to row-major, use `mat4_transposed`.
///
/// Notice! In OpenGL matrices are column-major.
pub fn transform_point(mat: &Matrix4, p: Point) -> Point {
    [
        mat[0][0] * p[0] + mat[0][1] * p[1] + mat[0][2] * p[2] + mat[0][3],
        mat[1][0] * p[0] + mat[1][1] * p[1] + mat[1][2] * p[2] + mat[1][3],
        mat[2][0] * p[0] + mat[2][1] * p[1] + mat[2][2] * p[2] + mat[2][3],
    ]
}

/// Transform triangle.
///
/// This transform is row-major, which is standard mathematical notation.
/// To convert column-major to row-major, use `mat4_transposed`.
///
/// Notice! In OpenGL matrices are column-major.
pub fn transform_triangle(mat: &Matrix4, (a, b, c): Triangle) -> Triangle {
    (transform_point(mat, a), transform_point(mat, b), transform_point(mat, c))
}

/// Transforms chunk.
pub fn transform_chunk(mat: &Matrix4, chunk: &mut Chunk<Triangle>) {
    for i in 0..64 {
        chunk[i] = transform_triangle(mat, chunk[i]);
    }
}

/// Transform quad.
///
/// This transform is row-major, which is standard mathematical notation.
/// To convert column-major to row-major, use `mat4_transposed`.
///
/// Notice! In OpenGL matrices are column-major.
pub fn transform_quad(mat: &Matrix4, [a, b, c, d]: Quad) -> Quad {
    [transform_point(mat, a), transform_point(mat, b),
     transform_point(mat, c), transform_point(mat, d)]
}

/// Transform cube.
///
/// This transform is row-major, which is standard mathematical notation.
/// To convert column-major to row-major, use `mat4_transposed`.
///
/// Notice! In OpenGL matrices are column-major.
pub fn transform_cube(mat: &Matrix4, [a, b, c, d, e, f, g, h]: Cube) -> Cube {
    [
        transform_point(mat, a), transform_point(mat, b),
        transform_point(mat, c), transform_point(mat, d),
        transform_point(mat, e), transform_point(mat, f),
        transform_point(mat, g), transform_point(mat, h),
    ]
}

/// Transform triangle through model and view.
///
/// This transform is row-major, which is standard mathematical notation.
/// To convert column-major to row-major, use `mat4_transposed`.
///
/// Notice! In OpenGL matrices are column-major.
pub fn transform_view_model_triangle(
    view: &Matrix4,
    model: &Matrix4,
    tri: Triangle
) -> Triangle {
    transform_triangle(view, transform_triangle(model, tri))
}

/// Linear interpolate line using a parameter.
pub fn lerp_line((a, b): Line, t: f32) -> Point {
    use vecmath::vec3_add as add;
    use vecmath::vec3_sub as sub;
    use vecmath::vec3_scale as scale;

    add(a, scale(sub(b, a), t))
}

/// Linear interpolate RGB using a parameter.
pub fn lerp_rgb(a: Rgb, b: Rgb, t: f32) -> Rgb {
    use crate::color::{rgb_gamma_linear_to_srgb, rgb_gamma_srgb_to_linear};

    use vecmath::vec3_add as add;
    use vecmath::vec3_sub as sub;
    use vecmath::vec3_scale as scale;

    let a = rgb_gamma_srgb_to_linear(a);
    let b = rgb_gamma_srgb_to_linear(b);
    rgb_gamma_linear_to_srgb(add(a, scale(sub(b, a), t)))
}

/// Linear interpolate RGBA using a parameter.
pub fn lerp_rgba(a: Rgba, b: Rgba, t: f32) -> Rgba {
    use crate::color::{rgba_gamma_linear_to_srgb, rgba_gamma_srgb_to_linear};

    use vecmath::vec4_add as add;
    use vecmath::vec4_sub as sub;
    use vecmath::vec4_scale as scale;

    let a = rgba_gamma_srgb_to_linear(a);
    let b = rgba_gamma_srgb_to_linear(b);
    rgba_gamma_linear_to_srgb(add(a, scale(sub(b, a), t)))
}

/// Linear interpolate scalars using a parameter.
pub fn lerp(a: f32, b: f32, t: f32) -> f32 {
    a + (b - a) * t
}

/// Clamp to unit interval.
pub fn clamp(a: f32) -> f32 {if a >= 1.0 {1.0} else if a <= 0.0 {0.0} else {a}}