Installation

RequirementsCopy Anchor Link

• Stable Rust 1.90 or newer, as declared in Cargo.toml.
• A desktop display and a functioning GPU backend for applications and GPU smoke tests.
• The platform libraries required by winit and wgpu. Backend dependencies are not optional.

Update the stable toolchain with rustup:

rustup update stable

The minimum supported Rust version is checked in CI with the committed lockfile. Newer compatible dependency releases may raise their own compiler requirements; retain a compatible lockfile or update Rust when resolving them.

Add the dependencyCopy Anchor Link

The current development release is 0.0.3 Genetic. Its public API may change between development releases. Once published on crates.io:

[dependencies]
zaxis = "=0.0.3"

Before publication, or to follow repository development:

[dependencies]
zaxis = { git = "https://github.com/nihmadev/zaxis" }

For a checkout next to your application:

[dependencies]
zaxis = { path = "../zaxis" }

Pin a Git dependency with rev = "<commit>" when reproducible builds require a specific library revision. Commit your application's Cargo.lock.

Run from sourceCopy Anchor Link

git clone https://github.com/nihmadev/zaxis.git
cd zaxis
cargo run --example demo

The demo selects immediate presentation. Enable synchronized presentation with:

cargo run --example demo -- --vsync

Dependency versionsCopy Anchor Link

These are the manifest requirements, not a claim about the newest upstream releases.

PNG/JPEG/WebP/BMP/SVG work without initialization. Default features image-gif and image-tiff additionally enable GIF and TIFF. Disable default features to omit those codecs and the bundled emoji font; built-in core formats remain available. The default bundled-emoji feature uses the separate z-emoji data crate. To omit only that font while keeping optional codecs:

[dependencies]
zaxis = { version = "=0.0.3", default-features = false, features = ["image-gif", "image-tiff"] }

Emoji then use system font fallback, with coverage depending on installed fonts. The opt-in bundled-icons feature adds the Lucide icon set; see Icons. The default accesskit feature exposes the UI to screen readers on Windows and macOS; the opt-in accesskit_unix feature adds AT-SPI on Linux and the BSDs. Add accesskit to the feature list to keep it when you disable default features; see Accessibility. See Image for limits, identity, async host wakeup and SVG resource/font policy.

zaxis::winit, zaxis::wgpu, zaxis::Vec2, and zaxis::vec2 re-export the integration types. Use these paths to keep your host aligned with the library's dependency versions. Custom hosts that use pollster and applications that load ab_glyph::FontArc need their own direct dependencies on those crates.

To create an application, use First application.