grex_framebuffer_extract

A plugin for the Bevy engine which allows for exporting framebuffer data from a camera.

Currently it only supports cameras which render to a render texture.

Compatibility

Crate Version	Bevy Version
0.1	0.13

Installation

Using git URL in Cargo.toml

[dependencies.grex_framebuffer_extract]
git = "https://github.com/exvacuum/grex_framebuffer_extract.git"

Usage

In main.rs:

use bevy::prelude::*;
use grex_framebuffer_extract;

fn main() {
    App::new()
        .add_plugins((
            DefaultPlugins,
            grex_framebuffer_extract::FramebufferExtractPlugin,
        ))
        .run();
}

When spawning a camera:

let size = Extent3d {
    width: 640,
    height: 480,
    depth_or_array_layers: 1,
};

let mut image = Image {
    texture_descriptor: TextureDescriptor {
        label: None,
        size,
        dimension: TextureDimension::D2,
        format: TextureFormat::R8Unorm,
        mip_level_count: 1,
        sample_count: 1,
        usage: TextureUsages::TEXTURE_BINDING
            | TextureUsages::COPY_SRC
            | TextureUsages::RENDER_ATTACHMENT,
        view_formats: &[],
    },
    ..default()
};

image.resize(size);

let image_handle = images.add(image); // ResMut<Assets<Image>>

commands.spawn((
    Camera3dBundle {
        camera: Camera {
            target: image_handle.clone().into();
            ..Default::default()
        },
        ..Default::default()
    },
    grex_framebuffer_extract::ExtractFramebufferBundle {
        source: framebuffer_extract_sources.add(FramebufferExtractSource(image_handle.clone())), // ResMut<Assets<FramebufferExtractSource>>
        destination: FramebufferExtractDestination::default(),
    },
));

The FramebufferExtractDestination component will contain the extracted image which can be used or saved for whatever you need.