Struct TileBuffer 

pub struct TileBuffer {
    pub tiles: Vec<TileEntry>,
    pub width_tiles: u16,
    pub height_tiles: u16,
    pub cursor: TilePos,
}

A configurable-width tile grid representing the text rendering surface.

Each cell carries a tile ID and ink colour. The cursor tracks the current write position for the next character. Dimensions are set at construction time via TileBuffer::new.

Fields

tiles: Vec<TileEntry>

Row-major tile entries. tiles[y * width_tiles + x].

width_tiles: u16

Width of the buffer in tiles.

height_tiles: u16

Height of the buffer in tiles.

cursor: TilePos

Current text cursor position.

Implementations

impl TileBuffer

pub fn new(width_tiles: u16, height_tiles: u16) -> Self

Creates a new, empty tile buffer with the cursor at (0, 0).

Examples found in repository

examples/hello_dotzuki.rs (line 464)

fn demo_dialog() {
    println!("\n╔══ NPC DIALOG ═══════════════════════════╗");
    let provider = HelloConfig::new();
    let mut engine = DialogEngine::new(provider);
    let mut buffer = TileBuffer::new(20, 18);

    // "Greetings, young hero!" + DONE
    let text: &[u8] = b"Greetings, young hero!";
    let mut full = text.to_vec();
    full.push(0xFF); // DONE

    engine.open_dialog(&full);
    while engine.is_active() { engine.update(&mut buffer); }

    print!("║ Merlin: \"");
    for i in 0..20usize {
        let t = buffer.tiles[i].tile_id;
        if (0x20..=0x7E).contains(&t) { print!("{}", t as u8 as char); }
    }
    println!("\"");
    println!("╚══════════════════════════════════════════╝");
}

pub fn clear(&mut self)

Clears all tiles and resets the cursor to (0, 0).

pub fn set_tile(&mut self, pos: TilePos, tile_id: u16, ink: u8)

Writes a tile at the given position. Silently does nothing if the position is out of bounds.

Examples found in repository

examples/hello_dotzuki.rs (line 273)

    fn render_char(&self, c: &AsciiChar, buffer: &mut TileBuffer) {
        if let AsciiChar::Char(ch) = c {
            let pos = buffer.cursor;
            buffer.set_tile(pos, *ch as u16, 0);
            buffer.cursor.x += 1;
        }
    }

pub fn newline(&mut self)

Moves the cursor to the start of the next line. Does not wrap or scroll.

pub fn scroll(&mut self)

Scrolls the entire buffer up by one row. The top row is discarded and the bottom row is filled with default entries.

Trait Implementations

impl Default for TileBuffer

fn default() -> Self

Returns the “default value” for a type.