https://github.com/emoon/rust_minifb

Cross platfrom window and framebuffer crate for Rust
https://github.com/emoon/rust_minifb

framebuffer rust rust-crate window

Last synced: 3 days ago
JSON representation

Cross platfrom window and framebuffer crate for Rust

• Host: GitHub
• URL: https://github.com/emoon/rust_minifb
• Owner: emoon
• License: mit
• Created: 2015-11-22T17:54:25.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2024-10-24T04:44:08.000Z (about 2 months ago)
• Last Synced: 2024-12-03T02:04:19.643Z (10 days ago)
• Topics: framebuffer, rust, rust-crate, window
• Language: Rust
• Homepage:
• Size: 1.33 MB
• Stars: 1,041
• Watchers: 12
• Forks: 99
• Open Issues: 41
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-rust - emoon/rust_minifb - platform window setup with optional bitmap rendering. It also comes with easy mouse and keyboard input. Primarily designed for prototyping (Libraries / GUI)
• awesome-rust-cn - emoon/rust_minifb

README

        
[![Build Status](https://github.com/emoon/rust_minifb/workflows/CI/badge.svg)](https://github.com/emoon/rust_minifb/actions?workflow=CI)

[![Crates.io](https://img.shields.io/crates/v/minifb.svg)](https://crates.io/crates/minifb)

[![Documentation](https://docs.rs/minifb/badge.svg)](https://docs.rs/minifb)

minifb is a cross platform library written in [Rust](https://www.rust-lang.org) and that makes it easy to setup a window and to (optional) display a 32-bit pixel buffer.  It also makes it easy to get input from keyboard and mouse. Notice that minifb is primary designed for prototyping and may not include all the features found in full window handling libraries.

An example is the best way to show how it works:

[Changelog](https://github.com/emoon/rust_minifb/blob/master/CHANGELOG.md)

Usage

-----

```toml

# Cargo.toml

[dependencies]

minifb = "0.27"

```

Example

-------

```rust

use minifb::{Key, Window, WindowOptions};

const WIDTH: usize = 640;

const HEIGHT: usize = 360;

fn main() {

    let mut buffer: Vec = vec![0; WIDTH * HEIGHT];

    let mut window = Window::new(

        "Test - ESC to exit",

        WIDTH,

        HEIGHT,

        WindowOptions::default(),

    )

    .unwrap_or_else(|e| {

        panic!("{}", e);

    });

    // Limit to max ~60 fps update rate

    window.set_target_fps(60);

    while window.is_open() && !window.is_key_down(Key::Escape) {

        for i in buffer.iter_mut() {

            *i = 0; // write something more funny here!

        }

        // We unwrap here as we want this code to exit if it fails. Real applications may want to handle this in a different way

        window

            .update_with_buffer(&buffer, WIDTH, HEIGHT)

            .unwrap();

    }

}

```

Status

------

Currently macOS, Linux and Windows (64-bit and 32-bit) are the current supported platforms. X11 (Linux/FreeBSD/etc) support has been tested on Ubuntu (x64). Linux Wayland support is also available. Bug report(s) for other OSes/CPUs are welcome!

Notice: That after 0.13 Redox hasn't been updated and some work is required to get that working again. PR are welcome.

Build instructions

------------------

On Linux you may need to install these dependencies first:

```

sudo apt install libxkbcommon-dev libwayland-cursor0 libwayland-dev

```

```

cargo build

cargo run --example noise

```

This will run the [noise example](https://github.com/emoon/rust_minifb/blob/master/examples/noise.rs)

## License

Licensed under either of

 * Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)

 * MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)

at your option.

### Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.