Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/arctic-marmoset/wgpu-renderer

Last synced: about 1 month ago
JSON representation

Host: GitHub
URL: https://github.com/arctic-marmoset/wgpu-renderer
Owner: arctic-marmoset
License: mit
Created: 2024-08-28T22:57:15.000Z (5 months ago)
Default Branch: trunk
Last Pushed: 2024-09-17T07:04:53.000Z (5 months ago)
Last Synced: 2024-09-18T06:47:16.857Z (5 months ago)
Language: Zig
Size: 69.2 MB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # WGPU Renderer

Yes, this is yet another renderer to add to my list of renderers, which, as of

writing, includes Vulkan, OpenGL, and Direct3D11.

Except, this one is written in Zig, and is, by the nature of WebGPU, fully

cross-platform for no extra effort.

Zig's toolchain is also very easy to set up, so even development is

cross-platform. (That is, if and when I figure out how to get all the non-Zig

dependencies to cross-compile cleanly.)

# Details

## Design

- Right-handed world space coordinate system like Vulkan clip space (+Z forward, -Y up)

- Reversed Z buffer with infinite far plane

- glTF binary meshes

- KTX2 textures

    - BC7 (SDR diffuse + specular)

    - BC6H (HDR base color)

    - BC4u (monochrome)

## Preview

![2024-09-16 Models with Multiple Materials](docs/media/2024-09-16_complex_textured_models.jpg)

# Development

## Requirements

| Tool | Version                                            |

|------|----------------------------------------------------|

| Zig  | `>=0.14.0`                                         |

| Rust | `>=1.80.1` (not sure what the minimum required is) |

## Setting Up

```

git clone --recursive https://github.com/arctic-marmoset/wgpu-renderer.git

cd wgpu-renderer

zig build

```

# Third-Party

- [cglm](https://github.com/recp/cglm)

- [GLFW (ported to Zig build system)](https://github.com/slimsag/glfw)

- [imgui](https://github.com/ocornut/imgui)

    - C bindings provided by [dear_bindings](https://github.com/dearimgui/dear_bindings)

- [libktx](https://github.com/KhronosGroup/KTX-Software)

- [wgpu-native [v0.19.4.1]](https://github.com/gfx-rs/wgpu-native)

- [zgltf](https://github.com/kooparse/zgltf)

With [Zig to Rust target conversion code](extern/wgpu-native/build-src/rust.zig)

modified from [build.crab](https://github.com/akarpovskii/build.crab).