easy-gpu 0.3.1

wgpu wrapper to manage assets and remove boilerplate
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
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

use wgpu::{BindGroupLayout, BufferBindingType, ComputePipelineDescriptor, ShaderModule, StorageTextureAccess, TextureFormat, TextureViewDimension};
use crate::assets_manager::Handle;
use crate::Renderer;

pub struct ComputePipeline{
    pub pipeline: wgpu::ComputePipeline,
    pub layout: BindGroupLayout,
}

pub struct ComputePipelineBuilder<'a>{
    shader: Handle<ShaderModule>,
    entries: Vec<wgpu::BindGroupLayoutEntry>,
    entry_point: &'a str,
}

impl<'a> ComputePipelineBuilder<'a>{
    pub fn new(shader: Handle<ShaderModule>)->Self{
        Self{
            shader,
            entries: vec![],
            entry_point: "cs_main"
        }
    }
    pub fn entry_point(mut self, entry_point: &'a str)->Self{
        self.entry_point = entry_point;
        self
    }
    pub fn bind_group_layout(
        mut self,
        entries: &[wgpu::BindGroupLayoutEntry],
    ) -> Self {
        self.entries = entries.to_vec();
        self
    }
    pub fn build(&self,renderer: &mut Renderer) -> Handle<ComputePipeline>{
        let bind_group_layout = renderer.device.create_bind_group_layout(
            &wgpu::BindGroupLayoutDescriptor {
                label: Some("bind group layout"),
                entries: &self.entries,
            }
        );
        
        let layout = renderer.device.create_pipeline_layout(&wgpu::PipelineLayoutDescriptor{
            label: None,
            bind_group_layouts: &[Some(&bind_group_layout)],
            immediate_size: 0,
        });

        let pipeline = renderer.device.create_compute_pipeline(&ComputePipelineDescriptor{
            label: Some("Compute Pipeline"),
            layout: Some(&layout),
            module: renderer.asset_manager.shaders.get(self.shader).unwrap(),
            entry_point: Some(self.entry_point),
            compilation_options: Default::default(),
            cache: None,
        });

        renderer.asset_manager.compute_pipelines.insert(ComputePipeline{
            pipeline,
            layout: bind_group_layout,
        })
    }
}

pub fn storage(binding: u32,read_only: bool) -> wgpu::BindGroupLayoutEntry {
    wgpu::BindGroupLayoutEntry {
        binding,
        visibility: wgpu::ShaderStages::COMPUTE,
        ty: wgpu::BindingType::Buffer {
            ty: BufferBindingType::Storage { read_only },
            has_dynamic_offset: false,
            min_binding_size: None,
        },
        count: None,
    }
}

pub fn storage_texture(binding: u32) -> wgpu::BindGroupLayoutEntry {
    wgpu::BindGroupLayoutEntry {
        binding,
        visibility: wgpu::ShaderStages::COMPUTE,
        ty: wgpu::BindingType::StorageTexture {
            access: StorageTextureAccess::WriteOnly,
            format: TextureFormat::Rgba8Unorm,
            view_dimension: TextureViewDimension::D2,
        },
        count: None,
    }
}

pub fn compute_texture_float(binding: u32) -> wgpu::BindGroupLayoutEntry {
    wgpu::BindGroupLayoutEntry {
        binding,
        visibility: wgpu::ShaderStages::COMPUTE,
        ty: wgpu::BindingType::Texture {
            sample_type: wgpu::TextureSampleType::Float { filterable: true },
            view_dimension: TextureViewDimension::D2,
            multisampled: false,
        },
        count: None,
    }
}
pub fn compute_texture_uint(binding: u32) -> wgpu::BindGroupLayoutEntry {
    wgpu::BindGroupLayoutEntry {
        binding,
        visibility: wgpu::ShaderStages::COMPUTE,
        ty: wgpu::BindingType::Texture {
            sample_type: wgpu::TextureSampleType::Uint,
            view_dimension: TextureViewDimension::D2,
            multisampled: false,
        },
        count: None,
    }
}