iq-scm / screen-13

Screen 13 is an easy-to-use Vulkan rendering engine in the spirit of QBasic.

Screen 13

Screen 13 is an easy-to-use Vulkan rendering engine in the spirit of QBasic.

[dependencies]
screen-13 = "0.8"

Overview

Screen 13 provides a high performance Vulkan driver using smart pointers. The driver may be created manually for headless rendering or automatically using the built-in event loop abstraction:

use screen_13::prelude::*;

fn main() -> Result<(), DisplayError> {
    EventLoop::new().build()?.run(|frame| {
        // It's time to do some graphics! 😲
    })
}

Usage

Screen 13 provides a fully-generic render graph structure for simple and statically typed access to all the resources used while rendering. The RenderGraph structure allows Vulkan smart pointer resources to be bound as "nodes" which may be used anywhere in a graph. The graph itself is not tied to swapchain access and may be used to execute general command streams.

Features of the render graph:

• Compute, graphic, and ray-trace pipelines
• Automatic Vulkan management (render passes, subpasses, descriptors, pools, etc.)
• Automatic render pass scheduling, re-ordering, merging, with resource aliasing
• Interoperable with existing Vulkan code
• Optional shader hot-reload from disk

render_graph
    .begin_pass("Fancy new algorithm for shading a moving character who is actively on fire")
    .bind_pipeline(&gfx_pipeline)
    .read_descriptor(0, some_image)
    .read_descriptor(1, another_image)
    .read_descriptor(3, some_buf)
    .clear_color(0, swapchain_image)
    .store_color(0, swapchain_image)
    .record_subpass(move |subpass| {
        subpass.push_constants(some_u8_slice);
        subpass.draw(6, 1, 0, 0);
    });

Quick Start

Included are some examples you might find helpful:

• hello_world.rs — Displays a window on the screen. Please start here.
• triangle.rs — Shaders and full setup of index/vertex buffers; < 100 LOC.
• shader-toy/ — Recreation of a two-pass shader toy using the original shader code.

See the example code, documentation, or helpful getting started guide for more information.

NOTE: Required development packages and libraries are listed in the getting started guide. All new users should read and understand the guide.

History

As a child I was given access to a computer that had GW-Basic; and later one with QBasic. All of my favorite programs started with:

CLS
SCREEN 13

These commands cleared the screen of text and setup a 320x200 256-color paletized video mode. There were other video modes available, but none of them had the 'magic' of 256 colors.

Additional commands QBasic offered, such as DRAW, allowed you to build simple games quickly because you didn't have to grok the entirety of compiling and linking. I think we should have options like this today, and so I started this project to allow future developers to have the ability to get things done quickly while using modern tools.

Insipirations

Screen 13 was built from the learnings and lessons shared by others throughout our community. In particular, here are some of the repositories I found useful:

• Bevy: A refreshingly simple data-driven game engine built in Rust
• Granite - Open-source Vulkan renderer
• Kajiya - Experimental real-time global illumination renderer made with Rust and Vulkan