More specifically, ggez is a lightweight game framework for making 2D games with minimum friction. It aims to implement an API based on (a Rustified version of) the LÖVE game framework. Thus it contains portable 2D drawing, sound, resource loading and event handling.
extern crate ggez;
use ggez::*;
use ggez::graphics::{DrawMode, Point2};
struct MainState {
pos_x: f32,
}
impl MainState {
fn new(_ctx: &mut Context) -> GameResult<MainState> {
let s = MainState { pos_x: 0.0 };
Ok(s)
}
}
impl event::EventHandler for MainState {
fn update(&mut self, _ctx: &mut Context) -> GameResult<()> {
self.pos_x = self.pos_x % 800.0 + 1.0;
Ok(())
}
fn draw(&mut self, ctx: &mut Context) -> GameResult<()> {
graphics::clear(ctx);
graphics::circle(ctx,
DrawMode::Fill,
Point2::new(self.pos_x, 380.0),
100.0,
2.0)?;
graphics::present(ctx);
Ok(())
}
}
pub fn main() {
let c = conf::Conf::new();
let ctx = &mut Context::load_from_conf("super_simple", "ggez", c).unwrap();
let state = &mut MainState::new(ctx).unwrap();
event::run(ctx, state).unwrap();
}
ggez is not meant to be everything to everyone, but rather a good base upon which to build higher-level systems and a useful tool that lets you immediately get started on projects such as game jams. As such, it provides:
- Filesystem abstraction that lets you load resources from folders or zip files
- Hardware-accelerated rendering engine built on the `gfx-rs` graphics engine
- Playing and loading .ogg, .wav and .flac files via the `rodio` crate
- TTF font rendering with `rusttype`, as well as bitmap fonts
- Interface for handling keyboard and mouse events easily through callbacks
- Config file for defining engine and game settings
- Easy timing and FPS measurement functions
- Math integration with nalgebra
- Some more advanced graphics options: shaders, sprite batches and render targets