layout 0.0.1

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

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: vec![255, 128],
        g: vec![0, 255],
        b: vec![0, 100],
        a: vec![255, 23],
    });
}