README.md

bevy_gaussian_splatting 🌌

bevy gaussian splatting render pipeline plugin. view the live demo

capabilities

• ply to gcloud converter
• gcloud and ply asset loaders
• bevy gaussian cloud render pipeline
• gaussian cloud particle effects
• wasm support /w live demo
• depth colorization
• normal rendering
• f16 and f32 gcloud
• wgl2 and webgpu
• 2dgs
• 3dgs
• 4dgs
• temporal gaussian hierarchy
• gcloud, spherical harmonic coefficients Huffman encoding
• spz format io
• spherical harmonic coefficients clustering
• 4D gaussian cloud wavelet compression
• accelerated spatial queries
• temporal depth sorting
• skeletons
• volume masks
• level of detail
• lighting and shadows
• bevy_openxr support
• bevy 3D camera to gaussian cloud pipeline

usage

use bevy::prelude::*;
use bevy_gaussian_splatting::GaussianSplattingPlugin;

fn main() {
    App::build()
        .add_plugins(DefaultPlugins)
        .add_plugins(GaussianSplattingPlugin)
        .add_systems(Startup, setup_gaussian_cloud)
        .run();
}

fn setup_gaussian_cloud(
    mut commands: Commands,
    asset_server: Res<AssetServer>,
) {
    // GaussianCloudSettings and Visibility are automatically added
    commands.spawn(
        GaussianCloudHandle(asset_server.load("scenes/icecream.gcloud")),
    );

    commands.spawn(Camera3dBundle::default());
}

tools

• ply to gcloud converter
• gaussian cloud training pipeline
• aabb vs. obb gaussian comparison via cargo run --bin compare_aabb_obb

compatible bevy versions

bevy_gaussian_splatting	bevy
3.0	0.15
2.3	0.14
2.1	0.13
0.4 - 2.0	0.12
0.1 - 0.3	0.11

license

licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (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.