iodeviceslib Rust

Rust crate for building applications using the Wasmer Experimental IO Devices. 🔌

Features

• Supports the Wasmer Framebuffers, so you can use WASI Modules to draw graphics! 🖼️
• Supports Keyboard and Mouse Input APIs, so you can retrieve and use Input! ⌨️🐭

Installation

Add wasmer-experimental-io-devices-lib = "0.1" to your [dependencies] in your Cargo.toml

Quick Start

TODO(mark): restructure io-devices-lib so that current stuff is namespaced under framebuffer

The program below demonstrates how to use this API to create an interactive framebuffer application.

```Rust use std::iter; use wasmerexperimentaliodeviceslib::{color::*, *};

const XRES: u32 = 300; const YRES: u32 = 300;

fn main() { // create a framebuffer instance with the specified resolution let mut fbctx = FrameBufferCtx::new(XRES, Y_RES).unwrap();

// declare some data
let colors: Vec<RGBA> = vec![
    (255, 0, 0).into(),     // red
    (0, 255, 0).into(),     // green
    (0, 0, 255).into(),     // blue
    (255, 255, 0).into(),   // yellow
    (255, 255, 255).into(), // white
];

let mut color_selector = 1;
'mainloop: loop {
    // get input event iterator
    let iter = fb_ctx.get_input().unwrap();

    for ie in iter {
        match ie {
            InputEvent::WindowClosed | InputEvent::KeyPress(Key::Escape) => break 'mainloop,
            InputEvent::KeyPress(Key::Key1) => color_selector = 1,
            InputEvent::KeyPress(Key::Key2) => color_selector = 2,
            InputEvent::KeyPress(Key::Key3) => color_selector = 3,
            InputEvent::KeyPress(Key::Key4) => color_selector = 4,
            InputEvent::KeyPress(Key::Key5) => color_selector = 5,
            InputEvent::MouseEvent(x, y, et) => {
                println!("{:?} at {}, {}", et, x, y);
            }
            _ => (),
        }
    }

    let color = colors[color_selector - 1];
    // draw all the pixels with the selected color
    fb_ctx
        .update_pixels(0, 0, iter::repeat(color).take((X_RES * Y_RES) as usize))
        .unwrap();

    fb_ctx.draw().unwrap();
    // std::thread::sleep_ms(16);
}

} ```

Inside your crate, just run cargo build --release --target=wasm32-wasi to compile.

Check your version of wasmer with wasmer -V, if you haven't updated to version 0.12.0 or higher yet, run wasmer self-update.

Then, run wasmer run --enable-experimental-io-devices target/wasm32-wasi/release/wasm-module-name.wasm.

TODO: add screenshot