tetra 0.2.4

A simple 2D game framework written in Rust


Crates.io Minimum Rust Version Documentation License Gitter chat

Tetra is a simple 2D game framework written in Rust. It uses SDL2 for event handling and OpenGL 3.2+ for rendering.

Note that Tetra is still extremely early in development! It may/will have bugs and missing features (the big one currently being audio playback). That said, you're welcome to give it a go and let me know what you think :)


  • XNA/MonoGame-inspired API
  • Efficient 2D rendering, with draw call batching by default
  • Simple input handling
  • Animations/spritesheets
  • TTF font rendering
  • Multiple screen scaling algorithms, including pixel-perfect variants (for those chunky retro pixels)
  • Deterministic game loop, à la Fix Your Timestep


To add Tetra to your project, add the following line to your Cargo.toml file:

tetra = "0.2"

Tetra currently requires Rust 1.31 or higher.

You will also need to install the SDL2 native libraries, as described here. The 'bundled' and 'static linking' features described can be activated using the sdl2_bundled and sdl2_static_link Cargo features in Tetra.


To get a simple window displayed on screen, the following code can be used:

use tetra::graphics::{self, Color};
use tetra::{Context, ContextBuilder, State};

struct GameState;

impl State for GameState {
    fn draw(&mut self, ctx: &mut Context, _dt: f64) -> tetra::Result {
        // Cornflour blue, as is tradition
        graphics::clear(ctx, Color::rgb(0.392, 0.584, 0.929));

fn main() -> tetra::Result {
    ContextBuilder::new("Hello, world!", 1280, 720)
        .run(&mut GameState)

You can see this example in action by running cargo run --example hello_world.

The full list of examples available are:

  • hello_world - Opens a window and clears it with a solid color.
  • texture - Loads and displays a texture.
  • animation - Displays an animation, made up of regions from a texture.
  • text - Displays text using a TTF font.
  • nineslice - Slices a texture into nine segments to display a dialog box.
  • keyboard - Moves a texture around based on keyboard input.
  • mouse - Moves a texture around based on mouse input.
  • gamepad - Displays the input from a connected gamepad.
  • text_input - Displays text as it is typed in by the player.
  • scaling - Demonstrates the different screen scaling algorithms.
  • tetras - A full example game (which is entirely legally distinct from a certain other block-based puzzle game cough).


As mentioned above, Tetra is fairly early in development, so there's likely to be bugs/flaky docs/general weirdness. Please feel free to open an issue/PR if you find something, or leave a question in the Gitter chat.

You can also contact me via Twitter, or find me lurking in the #gamedev channel on the Rust Community Discord.