vello_shaders 0.8.0

Vello infrastructure to preprocess and cross-compile shaders at compile time.
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

// Copyright 2023 the Vello Authors
// SPDX-License-Identifier: Apache-2.0 OR MIT

//! Types that are shared between the main crate and build.

/// The type of resource that will be bound to a slot in a shader.
#[derive(Copy, Clone, PartialEq, Eq, Debug)]
pub enum BindType {
    /// A storage buffer with read/write access.
    Buffer,
    /// A storage buffer with read only access.
    BufReadOnly,
    /// A small storage buffer to be used as uniforms.
    Uniform,
    /// A storage image.
    Image,
    /// A storage image with read only access.
    ImageRead,
    // TODO: Sampler, maybe others
}

impl BindType {
    pub fn is_mutable(self) -> bool {
        matches!(self, Self::Buffer | Self::Image)
    }
}

#[derive(Clone, Debug)]
pub struct BindingInfo {
    pub name: Option<String>,
    pub location: (u32, u32),
    pub ty: BindType,
}

#[derive(Clone, Debug)]
pub struct WorkgroupBufferInfo {
    pub size_in_bytes: u32,
    /// The order in which the workgroup variable is declared in the shader module.
    pub index: u32,
}

#[cfg(feature = "msl")]
pub mod msl {
    use std::fmt;

    #[derive(Clone)]
    pub enum BindingIndex {
        Buffer(u8),
        Texture(u8),
    }

    impl fmt::Debug for BindingIndex {
        fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
            match *self {
                Self::Buffer(i) => write!(f, "msl::BindingIndex::Buffer({i})"),
                Self::Texture(i) => write!(f, "msl::BindingIndex::Texture({i})"),
            }
        }
    }
}