Struct tetra::Context

pub struct Context { /* fields omitted */ }

A struct containing all of the 'global' state within the framework.

Methods

impl Context

pub fn run<S>(&mut self, state: &mut S) -> Result where
    S: State, 

Runs the game using the provided State implementation.

Errors

If the State returns an error from update or draw, the game will stop running and this method will return the error.

Examples

struct GameState;

impl State for GameState { }

fn main() -> tetra::Result {
   ContextBuilder::default().build()?.run(&mut GameState)
}

pub fn run_with<S, F>(&mut self, init: F) -> Result where
    S: State,
    F: FnOnce(&mut Context) -> Result<S>, 

Constructs an implementation of State using the given closure, and then runs it.

This is mainly handy when chaining methods, as it allows you to call your State constructor without breaking the chain.

Errors

If the State returns an error from update or draw, the game will stop running and this method will return the error.

Examples

struct GameState {
    texture: Texture,
}

impl GameState {
    fn new(ctx: &mut Context) -> tetra::Result<GameState> {
        Ok(GameState {
            texture: Texture::new(ctx, "./examples/resources/player.png")?,
        })
    }
}

impl State for GameState { }

fn main() -> tetra::Result {
   ContextBuilder::default().build()?.run_with(GameState::new)
}