f3l_glam 0.1.1

3D Point Cloud Library
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

# F3l Glam

An improve crate to get and set for glam types.<br>
Because glam is `column-based`, it provides some traits to quickly obtain `row information`.

## F3lMatrix

Use to get row vector from matrix.
```rust
/// A trait of matrix for glam type
pub trait F3lMatrix {
    type RowType: Copy;

    // getter
    fn cols(&self) -> usize;
    fn rows(&self) -> usize;
    fn row(&self, r: usize) -> Self::RowType;
    /// get value with bound check
    fn get(&self, r: usize, c: usize) -> Option<f32>;
    fn at(&self, r: usize, c: usize) -> f32 {
        self.get(r, c).unwrap()
    }

    // setter
    fn set_row<R: Into<Self::RowType> + Copy>(&mut self, row: usize, v: R);
    /// pos: (row, col)
    fn set_element(&mut self, pos: (usize, usize), v: f32);
}
```
## ArrayRowMajor

To get row data and from / into row matrix.
```rust
/// A trait of from/to for glam types
pub trait ArrayRowMajor {
    type Row: Copy;
    type Mat: Copy;

    fn from_rows<R: Index<usize, Output = f32>>(rows: &[R]) -> Self;
    fn from_rows_slice(m: &[f32]) -> Self;
    fn to_rows_array(&self) -> Self::Row;
    fn from_cols_array_2d(m: &Self::Mat) -> Self;
    fn to_rows_array_2d(&self) -> Self::Mat;
    fn write_rows_to_slice(self, slice: &mut [f32]);
}

/// A dimension getter
pub trait ArrayDimensions {
    fn nb_cols() -> usize;
    fn nb_rows() -> usize;
}
```

## More Implementation

See each file.
```rust
pub mod mat2;
pub mod mat3;
pub mod mat3a;
pub mod mat4;
pub mod vec2;
pub mod vec3;
pub mod vec3a;
pub mod vec4;
```