3个版本 (破坏性更新)
0.2.0 | 2021年12月22日 |
---|---|
0.1.0 | 2021年11月4日 |
0.0.0 | 2021年9月19日 |
#520 in 并发
500KB
1K SLoC
gpgpu
一个基于wgpu
的实验性异步GPU计算库。它旨在与wgpu
一起使用,如果需要的话。
要开始使用gpgpu
,只需创建一个Framework
实例,并遵循主仓库中的示例。
示例
一个小程序,用于乘以两个向量A和B;并将结果存储在另一个向量C中。
Rust程序
use gpgpu::*;
fn main() -> Result<(), Box<dyn std::error::Error>> {
// Framework initialization
let fw = Framework::default();
// Original CPU data
let cpu_data = (0..10000).into_iter().collect::<Vec<u32>>();
// GPU buffer creation
let buf_a = GpuBuffer::from_slice(&fw, &cpu_data); // Input
let buf_b = GpuBuffer::from_slice(&fw, &cpu_data); // Input
let buf_c = GpuBuffer::<u32>::with_capacity(&fw, cpu_data.len() as u64); // Output
// Shader load from SPIR-V binary file
let shader = Shader::from_spirv_file(&fw, "<SPIR-V shader path>")?;
// or from a WGSL source file
let shader = Shader::from_wgsl_file(&fw, "<WGSL shader path>")?;
// Descriptor set and program creation
let desc = DescriptorSet::default()
.bind_buffer(&buf_a, GpuBufferUsage::ReadOnly)
.bind_buffer(&buf_b, GpuBufferUsage::ReadOnly)
.bind_buffer(&buf_c, GpuBufferUsage::ReadWrite);
let program = Program::new(&shader, "main").add_descriptor_set(desc); // Entry point
// Kernel creation and enqueuing
Kernel::new(&fw, program).enqueue(cpu_data.len() as u32, 1, 1); // Enqueuing, not very optimus 😅
let output = buf_c.read_vec_blocking()?; // Read back C from GPU
for (a, b) in cpu_data.into_iter().zip(output) {
assert_eq!(a.pow(2), b);
}
Ok(())
}
着色器程序
着色器是用WGSL编写的
// Vector type definition. Used for both input and output
struct Vector {
data: [[stride(4)]] array<u32>;
};
// A, B and C vectors
[[group(0), binding(0)]] var<storage, read> a: Vector;
[[group(0), binding(1)]] var<storage, read> b: Vector;
[[group(0), binding(2)]] var<storage, read_write> c: Vector;
[[stage(compute), workgroup_size(1)]]
fn main([[builtin(global_invocation_id)]] global_id: vec3<u32>) {
c.data[global_id.x] = a.data[global_id.x] * b.data[global_id.x];
}
依赖项
~9–24MB
303K SLoC