12 unstable releases (4 breaking)

0.5.0 Feb 6, 2024
0.4.0 Jun 26, 2023
0.3.0 Feb 1, 2023
0.2.4 Dec 23, 2022
0.1.0 Jul 4, 2021

#662 in Hardware support


Used in 2 crates

MIT license

75KB
1.5K SLoC

chargrid_wgpu

Version Documentation

A graphical frontend for chargrid which renders with wgpu.

Dependencies

Linux

On linux this renders with vulkan. You will need a vulkan loader and vulkan drivers installed in order to run graphical chargrid applications. This often takes the form of a library named "libvulkan.so". If you encounter the following error when running a graphical chargrid application it means you're missing a vulkan dependency:

Failed to initialize graphical context: FailedToRequestGraphicsAdapter

NixOS

The following shell.nix creates an environment in which graphical chargrid applications can be built and run:

with import <nixpkgs> {};
pkgs.mkShell {
  buildInputs = [
    gtk3 glib
    pkgconfig
    xorg.libX11
    vulkan-loader
  ];
  shellHook = ''
    export LD_LIBRARY_PATH="${vulkan-loader}/lib"
  '';
}

Compiling Shaders

To simplify building/runnig, pre-compiled shaders are checked into the repo. After changing the shader source, run the compile-shaders.sh script to update the compiled shaders. This script depends on the shader-translator tool.

cargo install shader-translator
./compile-shaders.sh

Dependencies

~13–50MB
~826K SLoC