diff --git a/Cargo.toml b/Cargo.toml index 3a70ebdfda342a..68c8770fa6853c 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -180,6 +180,10 @@ path = "examples/3d/load_gltf_pipelined.rs" name = "msaa" path = "examples/3d/msaa.rs" +[[example]] +name = "msaa_pipelined" +path = "examples/3d/msaa_pipelined.rs" + [[example]] name = "orthographic" path = "examples/3d/orthographic.rs" diff --git a/examples/3d/msaa_pipelined.rs b/examples/3d/msaa_pipelined.rs new file mode 100644 index 00000000000000..ef910f9e80739c --- /dev/null +++ b/examples/3d/msaa_pipelined.rs @@ -0,0 +1,65 @@ +use bevy::{ + ecs::prelude::*, + input::Input, + math::Vec3, + pbr2::{PbrBundle, PointLightBundle, StandardMaterial}, + prelude::{App, Assets, KeyCode, Transform}, + render2::{ + camera::PerspectiveCameraBundle, + color::Color, + mesh::{shape, Mesh}, + view::Msaa, + }, + PipelinedDefaultPlugins, +}; + +/// This example shows how to configure Multi-Sample Anti-Aliasing. Setting the sample count higher +/// will result in smoother edges, but it will also increase the cost to render those edges. The +/// range should generally be somewhere between 1 (no multi sampling, but cheap) to 8 (crisp but +/// expensive) +fn main() { + println!("Press 'm' to toggle MSAA"); + println!("Using 4x MSAA"); + App::new() + .insert_resource(Msaa { samples: 4 }) + .add_plugins(PipelinedDefaultPlugins) + .add_startup_system(setup.system()) + .add_system(cycle_msaa.system()) + .run(); +} + +/// set up a simple 3D scene +fn setup( + mut commands: Commands, + mut meshes: ResMut>, + mut materials: ResMut>, +) { + // cube + commands.spawn_bundle(PbrBundle { + mesh: meshes.add(Mesh::from(shape::Cube { size: 2.0 })), + material: materials.add(Color::rgb(0.8, 0.7, 0.6).into()), + ..Default::default() + }); + // light + commands.spawn_bundle(PointLightBundle { + transform: Transform::from_xyz(4.0, 8.0, 4.0), + ..Default::default() + }); + // camera + commands.spawn_bundle(PerspectiveCameraBundle { + transform: Transform::from_xyz(-3.0, 3.0, 5.0).looking_at(Vec3::ZERO, Vec3::Y), + ..Default::default() + }); +} + +fn cycle_msaa(input: Res>, mut msaa: ResMut) { + if input.just_pressed(KeyCode::M) { + msaa.samples = if msaa.samples == 4 { + println!("Not using MSAA"); + 1 + } else { + println!("Using 4x MSAA"); + 4 + }; + } +} diff --git a/examples/README.md b/examples/README.md index 1717dcff09da9e..6d8a563bd8fb61 100644 --- a/examples/README.md +++ b/examples/README.md @@ -103,6 +103,7 @@ Example | File | Description `load_gltf_pipelined` | [`3d/load_gltf_pipelined.rs`](./3d/load_gltf_pipelined.rs) | Loads and renders a gltf file as a scene `many_cubes_pipelined` | [`3d/many_cubes_pipelined.rs`](./3d/many_cubes_pipelined.rs) | Simple benchmark to test per-entity draw overhead `msaa` | [`3d/msaa.rs`](./3d/msaa.rs) | Configures MSAA (Multi-Sample Anti-Aliasing) for smoother edges +`msaa_pipelined` | [`3d/msaa_pipelined.rs`](./3d/msaa_pipelined.rs) | Configures MSAA (Multi-Sample Anti-Aliasing) for smoother edges `orthographic` | [`3d/orthographic.rs`](./3d/orthographic.rs) | Shows how to create a 3D orthographic view (for isometric-look games or CAD applications) `orthographic_pipelined` | [`3d/orthographic_pipelined.rs`](./3d/orthographic_pipelined.rs) | Shows how to create a 3D orthographic view (for isometric-look games or CAD applications) `parenting` | [`3d/parenting.rs`](./3d/parenting.rs) | Demonstrates parent->child relationships and relative transformations