Struct storm::Engine

pub struct Engine { /* fields omitted */ }

The main entry point into the Storm engine. All interactions with the engine are managed by the API on this type. The engine is send, and can be moved between threads.

Methods

impl Engine

pub fn start(
    desc: WindowSettings,
    game_loop: impl FnMut(Engine) + Send + 'static
)

pub fn input_poll(&mut self) -> Option<InputMessage>

Polls for an input message. If there are no buffered input messages, then this returns None.

pub fn batch_create(&mut self, desc: &BatchSettings) -> BatchToken

Creates a new batch with the given settings and returns a token to reference the batch by later. The returned token can be freely copied.

pub fn batch_update(&mut self, batch: &BatchToken, desc: &BatchSettings)

Updates the settings for an existing batch. If the token references an invalid or removed batch, this will panic.

pub fn batch_remove(&mut self, batch: &BatchToken)

Removes an existing batch from the engine. If the token references an invalid or removed batch, this will panic.

pub fn sprite_set(&mut self, batch: &BatchToken, descs: &Vec<Sprite>)

Sets the sprites to render for a given batch. If the token references an invalid or removed batch, this will panic.

pub fn sprite_clear(&mut self, batch: &BatchToken)

Clears all sprites from the given batch. This does the same thing as passing an empty Vec to sprite_set. If the token references an invalid or removed batch, this will panic.

pub fn font_load(&mut self, path: &str) -> FontToken

Loads a new font and returns a token to reference it with later.

pub fn text_set(&mut self, batch: &BatchToken, descs: &Vec<Text>)

Sets the text to render for a given batch. If the token references an invalid or removed batch, this will panic.

pub fn text_clear(&mut self, batch: &BatchToken)

Clears all text from the given batch. This does the same thing as passing an empty Vec to sprite_set. If the token references an invalid or removed batch, this will panic.

pub fn texture_load(&mut self, path: &str) -> Texture

Loads a new texture.

pub fn window_title(&mut self, title: &str)

Sets the title of the window.

pub fn window_commit(&mut self)

Commits the queued window, batch, sprite, text, and texture related changes to the renderer. This function will not block.