tiny_wgpu 0.1.10

wgpu helper library
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

use wgpu::BufferUsages;
use pollster::FutureExt;

use tiny_wgpu::{
    BindGroupItem, Compute, ComputeKernel, ComputeProgram, Storage
};

struct ComputeExample {
    storage: Storage,
    compute: Compute
}

impl ComputeProgram for ComputeExample {
    fn storage(&self) -> &tiny_wgpu::Storage {
        &self.storage
    }

    fn storage_mut(&mut self) -> &mut tiny_wgpu::Storage {
        &mut self.storage
    }

    fn compute(&self) -> &tiny_wgpu::Compute {
        &self.compute
    }
}

fn main() {
    let compute = Compute::new(
        wgpu::Features::empty(),
        wgpu::Limits::default()
    ).block_on();
    
    let storage = Default::default();
    let mut program = ComputeExample { compute, storage };

    program.add_module("compute", wgpu::include_wgsl!("compute.wgsl"));

    program.add_buffer(
        "example_buffer", 
        BufferUsages::STORAGE | BufferUsages::COPY_DST | BufferUsages::COPY_SRC,
        128 * 4
    );

    // To send the data back to the CPU
    program.add_staging_buffer("example_buffer");

    program.add_bind_group("example_bind_group", &[
        BindGroupItem::StorageBuffer { label: "example_buffer", min_binding_size: 4, read_only: false }
    ]);

    {
        let bind_groups = &["example_bind_group"];
        let push_constant_ranges = &[];
        program.add_compute_pipelines("compute", bind_groups, &[ComputeKernel { label: "compute", entry_point: "compute" }], push_constant_ranges, None);
    }
    
    // Write data to GPU
    {
        let data: Vec<u32> = (0u32..128).collect();

        program.compute.queue.write_buffer(
            &program.storage().buffers["example_buffer"], 
            0, 
            bytemuck::cast_slice(&data)
        );
    }

    // Run the compute pass
    let mut encoder = program.compute.device.create_command_encoder(&wgpu::CommandEncoderDescriptor {
        label: None
    });

    {
        let mut cpass = encoder.begin_compute_pass(&wgpu::ComputePassDescriptor {
            label: None,
            timestamp_writes: None
        });

        cpass.set_pipeline(&program.storage().compute_pipelines["compute"]);
        cpass.set_bind_group(0, &program.storage().bind_groups["example_bind_group"], &[]);
        cpass.dispatch_workgroups(8, 1, 1);
    }

    // To send data back to the CPU, we need to copy it into a staging buffer
    program.copy_buffer_to_staging(&mut encoder, "example_buffer");

    program.compute.queue.submit(Some(encoder.finish()));

    // Then start to map that data
    program.prepare_staging_buffer("example_buffer");

    // Wait for GPU to finish
    program.compute.device.poll(wgpu::Maintain::Wait);

    // Collect output data
    let mut output = vec![0u32; 128];

    program.read_staging_buffer(
        "example_buffer", 
        &mut output[..]
    );

    for i in 0..128 {
        print!("{} ", output[i]);
        assert_eq!(output[i], (i as u32) * 2);
    }
}