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
123
124
125
126

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

  /// A builder for creating a `web_sys::GpuRenderPassColorAttachment`.
  #[ derive( Clone) ]
  pub struct ColorAttachment< 'a >
  {
    /// The texture view that will be rendered into. This is a required field.
    view : &'a web_sys::GpuTextureView, 
    /// The operation to perform on the color attachment at the beginning of the render pass.
    ///
    /// This can be `Clear` to clear the attachment to a specific color, or `Load`
    /// to preserve the existing contents.
    ///
    /// Defaults to `GpuLoadOp::Clear`.
    load_op : GpuLoadOp,
    /// The operation to perform on the color attachment at the end of the render pass.
    ///
    /// This can be `Store` to write the rendered results to the texture, or
    /// `Discard` to discard them.
    ///
    /// Defaults to `GpuStoreOp::Store`.
    store_op : GpuStoreOp,
    /// The color value to use when `load_op` is set to `GpuLoadOp::Clear`.
    ///
    /// This is a 4-component array of floating-point numbers representing RGBA.
    ///
    /// Defaults to `[ 0.0, 0.0, 0.0, 0.0 ]`.
    clear_value : Option< [ f32; 4 ] >,
     /// The multisample resolve target for the attachment.
    ///
    /// If the `view` is a multisampled texture, this specifies a non-multisampled
    /// texture view where the results of the multisample rendering will be
    /// resolved (blended and downsampled).
    ///
    /// Defaults to `None`.
    resolve_target : Option< &'a web_sys::GpuTextureView >,
     /// For 3D textures or texture arrays, this specifies the depth slice or array
    /// layer to render to.
    ///
    /// Defaults to `None`.
    depth_slice : Option< u32 >
  }

  impl< 'a > ColorAttachment< 'a > 
  {
    /// Creates a new `ColorAttachment` builder with a required texture view.
    pub fn new( view : &'a web_sys::GpuTextureView ) -> Self
    {
      let load_op = GpuLoadOp::Clear;
      let store_op = GpuStoreOp::Store;
      let clear_value = None;
      let resolve_target = None;
      let depth_slice = None;

      ColorAttachment
      {
        view,
        load_op,
        store_op,
        clear_value,
        resolve_target,
        depth_slice
      }
    }

    /// Sets the load operation for the attachment.
    pub fn load_op( mut self, op : GpuLoadOp ) -> Self
    {
      self.load_op = op;
      self
    }

    /// Sets the store operation for the attachment.
    pub fn store_op( mut self, op : GpuStoreOp ) -> Self
    {
      self.store_op = op;
      self
    }

    /// Sets the clear color value.
    pub fn clear_value( mut self, color : [ f32; 4 ] ) -> Self
    {
      self.clear_value = Some( color );
      self
    }

    /// Sets the resolve target for the attachment.
    pub fn resolve_target( mut self, view : &'a web_sys::GpuTextureView ) -> Self
    {
      self.resolve_target = Some( view );
      self
    }

    /// Sets the depth slice or array layer to render to.
    pub fn depth_slice( mut self, id : u32 ) -> Self
    {
      self.depth_slice = Some( id );
      self
    }
  }

  impl From< ColorAttachment< '_ > > for web_sys::GpuRenderPassColorAttachment
  {
    fn from( value: ColorAttachment< '_ > ) -> Self 
    {
      let a =  web_sys::GpuRenderPassColorAttachment::new( value.load_op, value.store_op, value.view);

      if let Some( v ) = value.clear_value { a.set_clear_value( &Vec::from( v ).into() ); }
      if let Some( v ) = value.resolve_target { a.set_resolve_target( &v ); }
      if let Some( v ) = value.depth_slice { a.set_depth_slice( v ); }

      a
    }
  }
}

crate::mod_interface!
{
  exposed use
  {
    ColorAttachment
  };
}