Installation

This guide covers how to add Horizon Lattice to your Rust project.

Requirements

• Rust: 1.89 or later (Edition 2024)
• Platform: Windows 10+, macOS 11+, or Linux with X11/Wayland

Platform-Specific Dependencies

Linux

On Linux, you’ll need development headers for graphics and windowing:

# Ubuntu/Debian
sudo apt install libxkbcommon-dev libwayland-dev

# Fedora
sudo dnf install libxkbcommon-devel wayland-devel

# Arch
sudo pacman -S libxkbcommon wayland

macOS

No additional dependencies required. Xcode Command Line Tools are recommended:

xcode-select --install

Windows

No additional dependencies required. Visual Studio Build Tools are recommended.

Adding to Your Project

Add Horizon Lattice to your Cargo.toml:

[dependencies]
horizon-lattice = "1.0"

Optional Features

Horizon Lattice provides several optional features:

[dependencies]
horizon-lattice = { version = "1.0", features = ["multimedia", "networking"] }

Verifying Installation

Create a simple test application:

// src/main.rs
use horizon_lattice::prelude::*;

fn main() -> Result<(), horizon_lattice::LatticeError> {
    let app = Application::new()?;

    let mut window = Window::new("Installation Test")
        .with_size(300.0, 200.0);
    window.show();

    app.run()
}

Run it:

cargo run

If a window appears, you’re ready to go!

Troubleshooting

“Failed to create graphics context”

This usually means the GPU drivers don’t support the required graphics API. Try:

• Updating your GPU drivers
• On Linux, ensure Vulkan is installed: sudo apt install mesa-vulkan-drivers

Build errors on Linux

Ensure you have all development headers installed (see Platform-Specific Dependencies above).

Next Steps

Continue to Your First Application to build something more interesting.