TakWolf's Game Engine (tge)

A lightweight cross-platform 2D game framework written in pure Rust and based on OpenGL 3.3+.

Inspired by LÖVE.

This is an attempt of Rust in game development.

Tge is currently in a very early stage of development. The API may be changed. Until the version to 0.1.0.

Features

• 2D only and use pixel unit.
• Hardware-accelerated rendering base on OpenGL.
• Automatically process rendering batch.
• Dynamic font rendering with text layout.
• Support high-DPI.
• Keyboard, mouse, touch, touchpad and gamepad input handling.
• Audio play. (TODO)

Non goals

• 3D.
• Visual editor.

The following does not contain, but can easily work with other crates:

• Entity Component System (ECS).
• Physics engines and collision detection.
• Network.

Usage

Add the dependency line to your Cargo.toml file:

[dependencies]
tge = "0.0.4"

To release performance, also add the following configs:

[profile.dev]
opt-level = 3

Then create a basic template. Here is the minimal example that will create a window:

use tge::prelude::*;

struct App {}

impl App {
    fn new(_: &mut Engine) -> GameResult<Self> {
        // load assets
        Ok(Self {})
    }
}

impl Game for App {
    fn update(&mut self, _: &mut Engine) -> GameResult {
        // handle logic
        Ok(())
    }

    fn render(&mut self, engine: &mut Engine) -> GameResult {
        engine.graphics().clear(Color::BLUE);
        // draw sprites
        Ok(())
    }
}

fn main() -> GameResult {
    let mut engine = EngineBuilder::new()
        .window_config(WindowConfig::new()
            .title("My Game")
            .inner_size((1024.0, 600.0)))
        .build()?;
    let mut app = App::new(&mut engine)?;
    engine.run(&mut app)
}

That is!

You can also see the examples/ directory to learn other examples.

Examples

camera

cannon

clock

bunny_mark

hare_mark

frame_animation

parallax_forest

parallax_mountain

dvd

text_layout

stroke_text

TODO

The following is working in progress:

• blend
• program uniform
• screenshot
• virtual assets path
• assets load async
• audio
• document

License

MIT OR Apache-2.0