bevy_pixels 0.5.0

Usage

Add bevy and bevy_pixels to Cargo.toml. Be sure to disable bevy's render and bevy_wgpu features (with default-features = false) as they will conflict with rendering provided by bevy_pixels.

[dependencies]
bevy = { version = "0.7", default_features = false }
bevy_pixels = "0.5"

Add PixelsPlugin to your Bevy project.

use bevy::prelude::*;
use bevy_pixels::prelude::*;

fn main() {
    App::new()
        .add_plugins(DefaultPlugins)
        .add_plugin(PixelsPlugin)
        .add_system(main_system)
        .run();
}

Use PixelsResource in your systems.

fn main_system(mut pixels_resource: ResMut<PixelsResource>) {
    // Get a mutable slice for the pixel buffer
    let frame: &mut [u8] = pixels_resource.pixels.get_frame();

    // Fill frame with pixel data
    // ...
}

Bevy and Pixels version mapping

bevy_pixels	bevy	pixels
0.1	0.5	0.3
0.2	0.5	0.8
0.3-0.4	0.6	0.9
0.5	0.7	0.9

Examples

Hello Bevy Pixels

This example is based off minimal-winit example from the pixels project.

cargo run --release --example minimal

minimal example

License

Licensed under either of

MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)

at your option.

Contribution

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

Todo

Add more configuration around how rendering is performed.
Add support for multiple windows.