Bevy Image Export

A Bevy plugin for rendering image sequences.

Compatability

| Bevy Version | Crate Version | | ------------ | ------------------- | | 0.10 | 0.4 - 0.7 | | 0.9 | 0.3 | | 0.8 | 0.1, 0.2 |

Usage

```rust use bevy::{prelude::*, winit::WinitSettings}; use bevyimageexport::{ImageExportPlugin, ImageExportBundle, ImageExportSource};

fn main() { let exportplugin = ImageExportPlugin::default(); let exportthreads = export_plugin.threads.clone();

App::new()
    .insert_resource(WinitSettings {
        return_from_run: true,
        ..default()
    })
    .add_plugins(DefaultPlugins.set(WindowPlugin {
        primary_window: Some(Window {
            resolution: (768.0, 768.0).into(),
            ..default()
        }),
        ..default()
    }))
    .add_plugin(export_plugin)
    // ...
    .run();

// This line is optional but recommended.
// It blocks the main thread until all image files have been saved successfully.
export_threads.finish();

}

fn setup( mut commands: Commands, mut images: ResMut>, mut exportsources: ResMut>, ) { // Create an output texture. let outputtexturehandle = { let size = Extent3d { width: 768, height: 768, ..default() }; let mut exporttexture = Image { texturedescriptor: TextureDescriptor { label: None, size, dimension: TextureDimension::D2, format: TextureFormat::Rgba8UnormSrgb, miplevelcount: 1, samplecount: 1, usage: TextureUsages::COPYDST | TextureUsages::COPYSRC | TextureUsages::RENDERATTACHMENT, viewformats: &[], }, ..default() }; export_texture.resize(size);

    images.add(export_texture)
};

commands
    .spawn(Camera3dBundle {
        transform: Transform::from_translation(5.0 * Vec3::Z),
        ..default()
    })
    .with_children(|parent| {
        parent.spawn(Camera3dBundle {
            camera: Camera {
                // Connect the output texture to a camera as a RenderTarget.
                target: RenderTarget::Image(output_texture_handle.clone()),
                ..default()
            },
            ..default()
        });
    });

// Spawn the ImageExportBundle to initiate the export of the output texture.
commands.spawn(ImageExportBundle {
    source: export_sources.add(output_texture_handle.into()),
    settings: ImageExportSettings {
        // Frames will be saved to "./out/[#####].png".
        output_dir: "out".into(),
        // Choose "exr" for HDR renders.
        extension: "png".into(),
    },
});

// ...

} ```

Video file export

With FFmpeg installed, you can run the following command to convert your exported image sequence to an MP4 video file:

bash ffmpeg -r 60 -i out/%05d.png -vcodec libx264 -crf 25 -pix_fmt yuv420p out.mp4