vera 0.3.0

Vulkan Engine in Rust for Animation
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

/// The evolution of a transformation or colorization.
#[derive(Copy, Clone)]
pub enum Evolution {
    /// Constant speed from start to end.
    Linear,
    /// Fast at the beginning, slow at the end.
    FastIn,
    /// Fast at the beginning, slow at the end.
    SlowOut,
    /// Slow at the beginning, fast at the end.
    FastOut,
    /// Slow at the beginning, fast at the end.
    SlowIn,
    /// Slow at ends, fast in middle.
    FastMiddle,
    /// Slow at ends, fast in middle.
    SlowInOut,
    /// Fast at ends, slow in middle.
    FastInOut,
    /// Fast at ends, slow in middle.
    SlowMiddle,
}

// -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

/// Data for the transformation of a single vertex or shape.
/// You can have several transformations happening simultaneously, but the order of the transformations is likely important.
pub struct Tf {
    /// The type & value of the transformation.
    pub t: Transformation,
    /// The speed evolution of the transformation.
    pub e: Evolution,
    /// The start time of the transformation.
    pub start: f32,
    /// The duration of the transformation.
    pub end: f32,
}

/// The available transformations
/// Their doc is prefixed with their general use case: Vertex/Model, View, Projection.
#[derive(Clone, Copy)]
pub enum Transformation {
    /// Vertex/Model: A scale operation with the provided X, Y and Z scaling.
    Scale(f32, f32, f32),
    /// Vertex/Model: A translate operation with the provided X, Y and Z scaling.
    Translate(f32, f32, f32),
    /// Vertex/Model: A rotate operation around the X axis with the provided counter-clockwise angle, in radians.
    RotateX(f32),
    /// Vertex/Model: A rotate operation around the Y axis with the provided counter-clockwise angle, in radians.
    RotateY(f32),
    /// Vertex/Model: A rotate operation around the Z axis with the provided counter-clockwise angle, in radians.
    RotateZ(f32),

    /// View: 
    Lookat(f32, f32, f32, f32, f32, f32, f32, f32, f32),
    /// View: 
    Move(f32, f32, f32),
    /// View: 
    Pitch(f32),
    /// View: 
    Yaw(f32),
    /// View: 
    Roll(f32),

    /// Projection: 
    Orthographic(f32, f32, f32, f32, f32, f32),
    /// Projection: 
    Perspective(f32, f32, f32, f32, f32, f32),
}

// -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

/// Data for the transformation of a single vertex or shape.
/// You can have several transformations happening simultaneously, but the order of the transformations is likely important.
pub struct Cl {
    /// The type & value of the transformation.
    pub c: Colorization,
    /// The speed evolution of the transformation.
    pub e: Evolution,
    /// The start time of the transformation.
    pub start: f32,
    /// The duration of the transformation.
    pub end: f32,
}

/// The available transformations
/// Their doc is prefixed with their general use case: Vertex/Model, View, Projection.
#[derive(Clone, Copy)]
pub enum Colorization {
    /// Changes the current color to this new rgba color.
    ToColor(f32, f32, f32, f32),
}