Goldy: Modern GPU Library

A modern Rust GPU library that deliberately sheds legacy baggage. Goldy targets only modern GPU APIs (Vulkan 1.3+, DX12, Metal) and can therefore be significantly simpler than libraries that must maintain backward compatibility.

Quick Example

use goldy::{Instance, DeviceType, Buffer, BufferUsage, Color, CommandEncoder, FrameOutput, TextureFormat};

fn main() -> anyhow::Result<()> {
    let instance = Instance::new()?;
    let device = instance.create_device(DeviceType::DiscreteGpu)?;
    
    let frame = FrameOutput::new(&device, 800, 600, TextureFormat::Rgba8Unorm);
    let mut encoder = CommandEncoder::new();
    {
        let mut pass = encoder.begin_render_pass();
        pass.clear(Color::CORNFLOWER_BLUE);
    }
    
    let pixels = frame.render(encoder)?;
    Ok(())
}

Features

Installation

[dependencies]
goldy = "0.1"

Documentation

📖 Full Documentation

• Getting Started
• Examples
• API Reference
• Design Philosophy

Examples

Run the interactive examples:

cargo run --example triangle --release      # Basic triangle
cargo run --example digital_clock --release # 7-segment clock
cargo run --example plasma --release        # Demoscene plasma
cargo run --example mandelbrot --release    # Fractal explorer
cargo run --example starfield --release     # 3D starfield
cargo run --example particles --release     # Rain/snow

See all examples.

Motivation

Goldy is inspired by Sebastian Aaltonen's "No Graphics API" vision of what's possible with modern GPU hardware. By targeting only modern GPUs (2018+), Goldy can:

• Use dynamic rendering (no render pass objects)
• Use bindless descriptors (no descriptor sets)
• Assume coherent caches (simpler synchronization)
• Provide a dramatically simpler API

Goldy is also inspired by:

• Wayland's compositor architecture
• Ralph Levien's "Requiem for piet-gpu-hal"
• Slang's vision for unified shader language
• WGPU
• This paper on GPU abstractions: https://www.kom.tu-darmstadt.de/papers/KCGS17.pdf

Read more in Design Philosophy.

Target Hardware

License

MIT License - see LICENSE for details.

Author

Mohamed Koubaa

Contributing

Contributions welcome! See CONTRIBUTING.