ve

A small Vulkan Rendering Engine

Warning

ve is currently under active development and is not recommended for production use. The API may change significantly between versions.

Platform Support Note: Currently only Linux is supported. Windows support is planned for future releases.

Key Features

Pipeline Hot Reloading

Real-time shader and pipeline recompilation during runtime

    if (ve.is_key_pressed(.R)) {
        gfx.hot_reload_shaders()
    }

Material Code Generation

Automatic material system generation from material structures. A key advantage of this approach is type-safe material interfaces. The generator also handles std140 memory alignment by automatically adding the necessary padding.

Example:

package main

import "ve"
import gfx "ve/graphics"

@(material)
My_Material :: struct {
    color:   ve.vec4,
    vector:  ve.vec3,
    texture: gfx.Texture_Handle,
}

After defining your material struct, run:

$ make gen

This generates two files:

1. An Odin source file in your project package.
2. A shader header file at assets/shader/gen_types.h.

The generated Odin source file provides type-safe getter and setter functions for each field in your material struct:

    material: gfx.Material

    init_mtrl_my(&material, pipeline_h)

    mtrl_my_set_color(&material, {0.5, 1, 0, 1})
    mtrl_my_set_texture(&material, texture_h)
    mtrl_my_set_vector(&material, {1, 1, 1})

    my_texture := mtrl_my_get_texture(material)
    my_color := mtrl_my_get_color(material)
    my_vector := mtrl_my_get_vector(material)

Bindless Rendering

Leverages modern GPU bindless descriptors to eliminate explicit texture and buffer bind calls, improving performance and simplifying resource management.

🚧Archetype ECS🚧

In development

Vulkan Features

• Dynamic Rendering
• Descriptor Indexing
• Synchronization 2

Installetion

# Clone the repository
git clone https://github.com/yourusername/ve.git
cd ve

unzip dependencies.zip
make gen-ve
make gen
make run

Examples

Postprocessing

Demonstrates a combination of screen-space blur and custom background color grading applied in post-processing.

Text

Shows anti-aliased text rendering with support for custom fonts and layouts.

Light

Example of simple lighting with ambient, diffuse components.