layout 0.1.0

Optimized memory layout using struct of array, Data-oriented design in Rust, DOD SOA
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

use layout::SOA;

#[derive(Debug, Clone, PartialEq, SOA)]
pub struct Point {
    x: f32,
    y: f32,
}

mod other_mod {
    use layout::SOA;

    #[derive(Debug, Clone, PartialEq, SOA)]
    #[layout(Debug, Clone, PartialEq)]
    pub struct Color {
        pub r: u8,
        pub g: u8,
        pub b: u8,
        pub a: u8,
    }
}

use other_mod::*;

#[derive(Debug, Clone, PartialEq, SOA)]
#[layout(Debug, Clone, PartialEq)]
pub struct Particle {
    pub point: Point,
    #[nested_soa]
    pub color: Color,
    pub mass: f32,
}

#[test]
fn nested_soa() {
    let mut particle_vec = ParticleVec::new();
    particle_vec.push(Particle {
        point: Point { x: 1.0, y: 2.0 },
        color: Color {
            r: 255,
            g: 0,
            b: 0,
            a: 255,
        },
        mass: 1.0,
    });
    particle_vec.push(Particle {
        point: Point { x: 2.0, y: 3.0 },
        color: Color {
            r: 128,
            g: 255,
            b: 100,
            a: 23,
        },
        mass: 2.0,
    });
    assert_eq!(particle_vec.point[0], Point { x: 1.0, y: 2.0 });
    assert_eq!(particle_vec.color.r[0], 255);
    assert_eq!(particle_vec.color.g[0], 0);
    assert_eq!(particle_vec.color.b[0], 0);
    assert_eq!(particle_vec.color.a[0], 255);
    assert_eq!(particle_vec.point[1], Point { x: 2.0, y: 3.0 });
    assert_eq!(particle_vec.color.r[1], 128);
    assert_eq!(particle_vec.color.g[1], 255);
    assert_eq!(particle_vec.color.b[1], 100);
    assert_eq!(particle_vec.color.a[1], 23);
    assert_eq!(
        particle_vec.color,
        ColorVec {
            r: layout::Column::from_vec(vec![255, 128]),
            g: layout::Column::from_vec(vec![0, 255]),
            b: layout::Column::from_vec(vec![0, 100]),
            a: layout::Column::from_vec(vec![255, 23]),
        }
    );
}