#glsl #graphics #gamedev

macro glsl-layout-derive

Custom derive for glsl-layout crate

6 releases (3 breaking)

Uses old Rust 2015

0.4.0 Jan 11, 2021
0.3.2 Aug 17, 2019
0.3.0 Feb 25, 2019
0.2.0 Jun 6, 2018
0.1.1 May 17, 2018

#89 in #glsl

Download history 804/week @ 2024-07-25 714/week @ 2024-08-01 1448/week @ 2024-08-08 956/week @ 2024-08-15 843/week @ 2024-08-22 851/week @ 2024-08-29 867/week @ 2024-09-05 867/week @ 2024-09-12 896/week @ 2024-09-19 1023/week @ 2024-09-26 508/week @ 2024-10-03 413/week @ 2024-10-10 633/week @ 2024-10-17 754/week @ 2024-10-24 764/week @ 2024-10-31 364/week @ 2024-11-07

2,673 downloads per month
Used in 39 crates (via glsl-layout)

MIT/Apache

6KB
122 lines

GLSL-LAYOUT

This crates provides data types and traits to build structures ready to upload into UBO.

Usage

Deriving Uniform with proc-macro will produce associated type Std140 with same data layout as uniform blocks declared with layout(std140). All members of structure that derives Uniform must implement Uniform as well.

Implementing Uniform should be done via deriving. Implementing it manually is possible. It requires to provide associated type Std140 which must implement Std140 trait. But trait Std140 is marked unsafe so be careful.

Trait Uniform also requires Copy.

Typical usage scenario is:

#[derive(Copy, Clone, Uniform)]
struct FragmentArgs {
    pos: vec3,
    dir: vec3,
    count: uint,
}

write_to_buffer(&FragmentArgs {
    pos: [0.0, 1.0, 2.0].into(),
    dir: [3.0, 4.0, 5.0].into(),
    count: 42,
}.std140());

Data types

There are basic data types from glsl:

  • boolean (name bool is already occupied)
  • int
  • uint
  • float
  • double

Also more complex types:

  • vectors - (vec2, vec3, vec4, bvec2, ivec2, uvec2, dvec2 etc)
  • matrices - (mat2x3, dmat4 etc)
  • arrays -

License

glsl-layout is free and open source software distributed under the terms of both the MIT License and the Apache License 2.0.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Known issues

On MacOS

If uniform block contains array of structures and this array accessed with dynamic index (variable instead of literal) it may load wrong bytes for members not aligned to size of vec4 (16 bytes). In this case manual padding can be the fix.

Dependencies

~1.5MB
~37K SLoC