minwebgpu 0.2.0

Minimal WebGPU toolkit for modern graphics programming with compute shaders and rendering pipelines
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
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

/// Internal namespace.
mod private
{

  use crate::*;

  /// Describes the layout for a WebGPU bind group.
  #[ derive( Clone ) ]
  pub struct  BindGroupLayoutDescriptor
  {
    /// Auto compute `binding` value of the entries. Defaults to `false`
    auto_bindings : bool,
    /// Visibility, that is shared between the entries. Defaults to `0`
    visibility : u32,
    /// Layouts of the entries of the bindgroup
    entries: Vec< web_sys::GpuBindGroupLayoutEntry >
  }

  impl BindGroupLayoutDescriptor
  {
    /// Creates a new `BindGroupLayoutDescriptor` with default values.
    pub fn new() -> Self
    {
      let auto_bindings = false;
      let visibility = 0;
      let entries = Vec::new();
      BindGroupLayoutDescriptor
      {
        auto_bindings,
        visibility,
        entries
      }
    }

    /// Set the `auto_bindings` property to `true`
    pub fn auto_bindings( mut self ) -> Self
    {
      self.auto_bindings = true;
      self
    }

    /// Sets the `visibility` to `All`
    pub fn all( self ) -> Self
    {
      self.fragment().compute().vertex()
    }

    /// Add `FRAGMENT` stage to the `visibility`
    pub fn fragment( mut self ) -> Self
    {
      self.visibility |= web_sys::gpu_shader_stage::FRAGMENT;
      self
    }

    /// Add `VERTEX` stage to the `visibility`
    pub fn vertex( mut self ) -> Self
    {
      self.visibility |= web_sys::gpu_shader_stage::VERTEX;
      self
    }

    /// Add `COMPUTE` stage to the `visibility`
    pub fn compute( mut self ) -> Self
    {
      self.visibility |= web_sys::gpu_shader_stage::COMPUTE;
      self
    }

    /// Adds an entry to the layout
    pub fn entry( mut self, entry : impl Into< web_sys::GpuBindGroupLayoutEntry > ) -> Self
    {
      self.entries.push( entry.into() );
      self
    }

    /// Adds an entry to the layout
    pub fn entry_from_ty( mut self, ty : impl Into< BindingType > ) -> Self
    {
      let entry = BindGroupLayoutEntry::new().ty( ty );
      self.entries.push( entry.into() );
      self
    }

    /// Creates a `web_sys::GpuBindGroupLayout` from this descriptor.
    pub fn create( self, device : &web_sys::GpuDevice ) -> Result< web_sys::GpuBindGroupLayout, WebGPUError >
    {
      layout::bind_group::create( device, &self.into() )
    } 
  }

  impl From< BindGroupLayoutDescriptor > for web_sys::GpuBindGroupLayoutDescriptor 
  {
    fn from( mut value: BindGroupLayoutDescriptor ) -> Self 
    {
      let mut binding : u32 = 0;
      for entry in value.entries.iter_mut()
      {
        if value.auto_bindings 
        { 
          entry.set_binding( binding ); 
          binding += 1;
        }

        entry.set_visibility( entry.get_visibility() | value.visibility );
      }

      let layout = web_sys::GpuBindGroupLayoutDescriptor::new( &value.entries.into() );
      layout
    }    
  }

}

crate::mod_interface!
{

  exposed use
  {
    BindGroupLayoutDescriptor
  };

}