glsl-layout 0.5.0

Provides data types and traits to build structures ready to upload into UBO.
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

/// Special marker trait implemented only for `std140` types.
///
/// # Safety
/// The type must not have any padding bytes
pub unsafe trait Std140: Sized + Uniform<Std140 = Self> {
    /// Convert to bytes-slice.
    fn as_raw(&self) -> &[u8] {
        use std::{mem::size_of, slice::from_raw_parts};
        unsafe { from_raw_parts(self as *const Self as *const u8, size_of::<Self>()) }
    }
}

/// Structure to transform data from rust's structure to the raw data ready to upload to UBO.
/// Users should prefer to use `derive(Uniform)` instead of implementing this manually.
pub trait Uniform: Copy {
    /// ZST that enforces alignment required for this type.
    type Align: Copy + Default;

    /// Type that contain same data with memory layout matching glsl's `layout(std140)`.
    type Std140: Std140;

    /// Get aligned data from structure.
    fn std140(&self) -> Self::Std140;
}