This repository is about the implementation of Native WebGPU (Dawn) Engine. The goal of this project is not a general-purpose game engine, but to demonstrate engine technologies and tools that provide cross-platform based on WebGPU. Therefore, the development of the project is aimed at flattening and avoiding excessive encapsulation. You can refer to the internal technical implementation and apply it to your own project. For more thoughts on the project, visit the project blog.
This project is very similar to Unity's component entity pattern (not ECS). Based on entity and component, it is easy to combine other open-source ability:
- ImGui: GUI system
- OZZ-Animation: Animation system
- JoltPhysics: Physics system
The asset pipeline is based on ozz-animation and assimp:
- All skeletal animation should use asset pipeline to generate OZZ files, which will compress raw-animation data and make runtime more efficiently. Now the skin only support FBX format, we will support GLTF convert in the future.
- All static model is loaded by using assimp which support a lot of data format and include geometry preprocessor.
This repository contains submodules for external dependencies, so when doing a fresh clone you need to clone recursively:
git clone --recursive https://github.com/ArcheGraphics/Arche-cpp.git
Existing repositories can be updated manually:
git submodule init
git submodule update
Because this project uses the SPIRV toolchain to compile shaders and implement shader reflections, and the KTX texture
format requires Vulkan support, be sure to install the Vulkan toolchain (even on a
Mac). At the same time, since the
interface for reading SPIRV by Tint requires Vulkan support, you need to open the switch on CMakeLists.txt of dawn
before compiling Tint, and install depot_tools at the same
time.
cd third_party/dawn && vim CMakeLists.txt
set(ENABLE_VULKAN ON)
After all those work, use the script in third_party folder to build them all:
./build.sh
I recommend use Clion as main IDE(which can load cmake directly), but I also add xcode project which can capture metal frame when debug graphics feature.
You can read code in apps to find the feature in this code, like physics and shadow(WIP):
You can also redirect to repos to see more effects.