Text

Show how to draw text from a font bitmap.

Text is a bitmap split into exact sizes for each glyph.

The Beachball.png font image for this example is:

With the following Beachball.ron RON file:

(glyph_width: 10,  glyph_height: 10)

Source

use chuot::{Config, Context, Game};

/// Define a game state for our example.
#[derive(Default)]
struct GameState;

impl Game for GameState {
    /// Render the game.
    fn render(&mut self, ctx: Context) {
        // Load a graphical font
        ctx.font("Beachball")
            // Draw a string with it
            .text("Hello world!")
            // Use the UI camera which draws the center in the top left
            .use_ui_camera()
            // Draw at the top of the screen
            .translate((1.0, 1.0))
            // Draw the text on the screen
            .draw();

        // We can also load a glyph from a font as a sprite asset and use it like a sprite would be used
        ctx.font("Beachball")
            .glyph('@' as usize)
            // Draw the sprite on the screen, it is centered because by default it uses the main camera
            .draw();
    }

    /// Do nothing during the update loop.
    fn update(&mut self, _ctx: Context) {}
}

/// Open an empty window.
fn main() {
    // Game configuration
    let config = Config {
        buffer_width: 120.0,
        buffer_height: 96.0,
        // Apply a minimum of 6 times scaling for the buffer
        // Will result in a minimum, and on web exact, window size of 960x720
        scaling: 6.0,
        ..Default::default()
    };

    // Spawn the window and run the 'game'
    GameState.run(chuot::load_assets!(), config);
}

Compatibility