webgpu-shim 0.1.0

Webgpu shim based on wgpu
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

# WebGPU Shim

A thin shim layer that provides **WebGPU-compatible C ABI interfaces** on top of [wgpu-native](https://github.com/gfx-rs/wgpu-native).

## Problem

`wgpu-native` uses `wgpu-core` as its foundation, which means **Textures and other resources cannot be directly shared** between:
- A Rust application using the `wgpu` crate
- A C++ library expecting the standard WebGPU interface

This crate solves that interoperability problem.

## Overview

This library:
- Downloads the official [`webgpu.h`](https://github.com/webgpu-native/webgpu-headers) header
- Generates Rust bindings using `bindgen`
- Wraps wgpu-native types to expose them with WebGPU-compatible ABIs
- Adds a thin conversion layer between wgpu and WebGPU types

## Usage

Add to your `Cargo.toml`:

```toml
[dependencies]
webgpu-shim = { version = "0.1.0", path = "path/to/webgpu-shim" }
```

The crate exposes:
- WebGPU-compatible type definitions (e.g., `WGPUDevice`, `WGPUTexture`)
- Function bindings matching the WebGPU C API

## Build Requirements

- Rust 2024 edition
- `bindgen` (build dependency)
- Clang/LLVM (for bindgen)
- Network access (to download `webgpu.h` on first build)

## License

Dual-licensed under:
- Apache License, Version 2.0
- MIT License

See the [wgpu-native license](https://github.com/gfx-rs/wgpu-native) for the base code this is derived from.

## Related Projects

- [wgpu-native](https://github.com/gfx-rs/wgpu-native) - Native WebGPU implementation
- [webgpu-headers](https://github.com/webgpu-native/webgpu-headers) - Official WebGPU C API headers
- [wgpu](https://crates.io/crates/wgpu) - Rust WebGPU implementation