87 lines
2.3 KiB
Markdown
87 lines
2.3 KiB
Markdown
# bevy_framebuffer_extract
|
|
|
|
|
|
|
|
|
|
[](https://exvacuum.github.io/bevy_terminal_display)
|
|
|
|
A plugin for the [Bevy](https://bevyengine.org) 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
|
|
```toml
|
|
[dependencies.bevy_framebuffer_extract]
|
|
git = "https://github.com/exvacuum/bevy_framebuffer_extract.git"
|
|
```
|
|
|
|
## Usage
|
|
|
|
In `main.rs`:
|
|
```rs
|
|
use bevy::prelude::*;
|
|
use bevy_framebuffer_extract;
|
|
|
|
fn main() {
|
|
App::new()
|
|
.add_plugins((
|
|
DefaultPlugins,
|
|
bevy_framebuffer_extract::FramebufferExtractPlugin,
|
|
))
|
|
.run();
|
|
}
|
|
```
|
|
|
|
When spawning a camera:
|
|
```rs
|
|
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()
|
|
},
|
|
bevy_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.
|