#graphics #opengl #2d-game #cross-platform #hardware-accelerated #game-engine #font-rendering

tge

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

5 releases

0.0.4 Oct 20, 2021
0.0.3 Aug 21, 2020
0.0.2 Aug 7, 2020
0.0.1 Mar 6, 2020
0.0.0 Feb 1, 2019

#1547 in Game dev

24 downloads per month

MIT/Apache

190KB
5K SLoC

TakWolf's Game Engine (tge)

Crates.io Docs.rs License

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

Inspired by LÖVE.

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.

Performance

See the example bunny_mark and hare_mark.

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

Dependencies

~18MB
~374K SLoC