impeller-zig-examples

Runnable GLFW examples for impeller-zig.

     

Prerequisites

Install Zig 0.17.0 directly, or use mise to install the toolchain pinned by this repository:

mise install

Only is optional and provides shorter versions of the commands below.

Build

Build both the API showcase and the shader example:

zig build
# or:
# only build

Run Examples

zig build run
# or:
# only run

Run Shader Example

The shader example uses Vulkan on Linux and Windows, or Metal on macOS:

zig build run-shader
# or:
# only run-shader

Linux

The Linux example forces the X11 video driver for now.

Cross-compilation

Cross compile with Zig's standard target option. For example, macOS to Windows:

zig build -Dtarget=x86_64-windows-gnu

Supported Impeller SDK targets:

Platform	-Dtarget
Linux x64	x86_64-linux-gnu
Linux arm64	aarch64-linux-gnu
macOS x64	x86_64-macos
macOS arm64	aarch64-macos
Windows x64	x86_64-windows-gnu
Windows arm64	aarch64-windows-gnu

macOS targets require Apple's SDK/frameworks. Linux targets currently need to be built on a Linux host, because the X11 package builds makekeys for the target and runs it during the build.