blitzkit

Getting started

Mon, 01 Jan 0001 00:00:00 +0000

Getting started #

cargo add blitzkit

Rust 1.87 or newer.

A game is one trait #

Implement Game, call start(), and you have a window with an event loop behind it.

Short example:

use blitzkit::camera::Camera;
use blitzkit::geometry::Geometry;
use blitzkit::keyboard::KeyboardInput;
use blitzkit::renderer::render_text::TextRenderer;
use blitzkit::renderer::scene::Scene;
use blitzkit::sound::SoundSystem;
use blitzkit::{start, Game};

struct Hello {
 quitting: bool,
}

impl Game for Hello {
 fn initialize(
 &mut self,
 _geometry: &mut Geometry,
 _text: &mut TextRenderer,
 _sound: &SoundSystem,
 _size: (f32, f32),
 ) {
 }

 fn update(
 &mut self,
 _dt: f32,
 _geometry: &mut Geometry,
 _text: &mut TextRenderer,
 _sound: &SoundSystem,
 ) {
 }

 fn draw(&mut self, _scene: &mut Scene, _camera: &mut Camera) {}

 fn process_keyboard(&mut self, _input: KeyboardInput) {}

 fn is_quitting(&self) -> bool {
 self.quitting
 }

 fn focus_changed(&mut self, _focus: bool) {}
}

fn main() {
 start("hello", Box::new(Hello { quitting: false }));
}

Drawing #

draw gives you a Scene and a Camera. Fill the scene each frame and it is thrown away after, so there is nothing to clean up.

Examples

Mon, 01 Jan 0001 00:00:00 +0000

Examples #

Examples live in the engine to demonstrate improvements as they land.

rolling #

In which collision detection is demonstrated. Roll a ball around a walled room and watch it slide along said walls.

cargo run --release --example rolling

WASD or the arrows to roll the ball. The camera follows it.

drag or move the mouse to swing the camera round
scroll to zoom

Games

Mon, 01 Jan 0001 00:00:00 +0000

Games #

I built these on it. Each one is its own repo and each takes blitzkit from crates.io rather than a local checkout, so I’m using the engine the same way you would.

arcade #

An arcade with games built on this engine.

github.com/jvalol/arcade

pong #

In which i develop a pong game in rust using blitzkit, also an open repo currently in its early stages.