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

/// Internal namespace.
mod private
{
  use crate::*;

  /// Represents the layout of a single buffer binding within a WebGPU bind group.
  #[ derive( Default, Clone ) ]
  pub struct BufferBindingLayout
  {
    /// The type of the buffer binding.
    /// Defaults to `uniform`
    b_type : Option< GpuBufferBindingType >,
    /// Indicates whether dynamic offsets are enabled for this buffer binding.
    /// 
    /// When `true`, the offset into the buffer can be specified dynamically when
    /// the bind group is used, which is useful for rendering multiple objects with
    /// a single draw call. Defaults to `false`.
    has_dynamic_offset : Option< bool >,
    /// The minimum size, in bytes, that the buffer must have.
    ///
    /// This is used by WebGPU for validation. A value of `0` indicates no minimum
    /// size requirement. Defaults to `0`.
    min_binding_size : Option< f64 >
  }

  impl BufferBindingLayout 
  {
    /// Creates a new `BufferBindingLayout` with default values.
    pub fn new() -> Self
    {
      Self::default()
    }

    /// Sets the type of the buffer from the provided type
    pub fn set_type( mut self, b_type : GpuBufferBindingType ) -> Self
    {
      self.b_type = Some( b_type );
      self
    }

    /// Sets the type of the buffer to `Uniform`
    pub fn uniform( mut self ) -> Self
    {
      self.b_type = Some( GpuBufferBindingType::Uniform );
      self
    }

    /// Sets the type of the buffer to `Storage`
    pub fn storage( mut self ) -> Self
    {
      self.b_type = Some( GpuBufferBindingType::Storage );
      self
    }

    /// Sets the type of the buffer to `ReadOnlyStorage`
    pub fn storage_readonly( mut self ) -> Self
    {
      self.b_type = Some( GpuBufferBindingType::ReadOnlyStorage );
      self
    }

    /// Sets the property `has_dynamic_offset` of the buffer to `true`
    pub fn dynamic_offset( mut self ) -> Self
    {
      self.has_dynamic_offset = Some( true );
      self
    }

    /// Sets the property `min_binding_size` of the buffer to specified value
    pub fn min_binding_size( mut self, size : f64 ) -> Self
    {
      self.min_binding_size = Some( size );
      self
    }
  }

  impl From< BufferBindingLayout > for web_sys::GpuBufferBindingLayout
  {
    fn from( value: BufferBindingLayout ) -> Self 
    {
      let layout = web_sys::GpuBufferBindingLayout::new();

      if let Some( v ) = value.b_type { layout.set_type( v ); }
      if let Some( v ) = value.has_dynamic_offset { layout.set_has_dynamic_offset( v ); }
      if let Some( v ) = value.min_binding_size { layout.set_min_binding_size( v ); }

      layout
    }
  }
}

crate::mod_interface!
{
  orphan use
  {
    BufferBindingLayout
  };
}