# Objective - The current `EventReader::iter` has been determined to cause confusion among new Bevy users. It was suggested by @JoJoJet to rename the method to better clarify its usage. - Solves #9624 ## Solution - Rename `EventReader::iter` to `EventReader::read`. - Rename `EventReader::iter_with_id` to `EventReader::read_with_id`. - Rename `ManualEventReader::iter` to `ManualEventReader::read`. - Rename `ManualEventReader::iter_with_id` to `ManualEventReader::read_with_id`. --- ## Changelog - `EventReader::iter` has been renamed to `EventReader::read`. - `EventReader::iter_with_id` has been renamed to `EventReader::read_with_id`. - `ManualEventReader::iter` has been renamed to `ManualEventReader::read`. - `ManualEventReader::iter_with_id` has been renamed to `ManualEventReader::read_with_id`. - Deprecated `EventReader::iter` - Deprecated `EventReader::iter_with_id` - Deprecated `ManualEventReader::iter` - Deprecated `ManualEventReader::iter_with_id` ## Migration Guide - Existing usages of `EventReader::iter` and `EventReader::iter_with_id` will have to be changed to `EventReader::read` and `EventReader::read_with_id` respectively. - Existing usages of `ManualEventReader::iter` and `ManualEventReader::iter_with_id` will have to be changed to `ManualEventReader::read` and `ManualEventReader::read_with_id` respectively.
		
			
				
	
	
		
			121 lines
		
	
	
		
			3.8 KiB
		
	
	
	
		
			Rust
		
	
	
	
	
	
			
		
		
	
	
			121 lines
		
	
	
		
			3.8 KiB
		
	
	
	
		
			Rust
		
	
	
	
	
	
//! Renders two cameras to the same window to accomplish "split screen".
 | 
						|
 | 
						|
use std::f32::consts::PI;
 | 
						|
 | 
						|
use bevy::{
 | 
						|
    core_pipeline::clear_color::ClearColorConfig, pbr::CascadeShadowConfigBuilder, prelude::*,
 | 
						|
    render::camera::Viewport, window::WindowResized,
 | 
						|
};
 | 
						|
 | 
						|
fn main() {
 | 
						|
    App::new()
 | 
						|
        .add_plugins(DefaultPlugins)
 | 
						|
        .add_systems(Startup, setup)
 | 
						|
        .add_systems(Update, set_camera_viewports)
 | 
						|
        .run();
 | 
						|
}
 | 
						|
 | 
						|
/// set up a simple 3D scene
 | 
						|
fn setup(
 | 
						|
    mut commands: Commands,
 | 
						|
    asset_server: Res<AssetServer>,
 | 
						|
    mut meshes: ResMut<Assets<Mesh>>,
 | 
						|
    mut materials: ResMut<Assets<StandardMaterial>>,
 | 
						|
) {
 | 
						|
    // plane
 | 
						|
    commands.spawn(PbrBundle {
 | 
						|
        mesh: meshes.add(shape::Plane::from_size(100.0).into()),
 | 
						|
        material: materials.add(Color::rgb(0.3, 0.5, 0.3).into()),
 | 
						|
        ..default()
 | 
						|
    });
 | 
						|
 | 
						|
    commands.spawn(SceneBundle {
 | 
						|
        scene: asset_server.load("models/animated/Fox.glb#Scene0"),
 | 
						|
        ..default()
 | 
						|
    });
 | 
						|
 | 
						|
    // Light
 | 
						|
    commands.spawn(DirectionalLightBundle {
 | 
						|
        transform: Transform::from_rotation(Quat::from_euler(EulerRot::ZYX, 0.0, 1.0, -PI / 4.)),
 | 
						|
        directional_light: DirectionalLight {
 | 
						|
            shadows_enabled: true,
 | 
						|
            ..default()
 | 
						|
        },
 | 
						|
        cascade_shadow_config: CascadeShadowConfigBuilder {
 | 
						|
            num_cascades: 2,
 | 
						|
            first_cascade_far_bound: 200.0,
 | 
						|
            maximum_distance: 280.0,
 | 
						|
            ..default()
 | 
						|
        }
 | 
						|
        .into(),
 | 
						|
        ..default()
 | 
						|
    });
 | 
						|
 | 
						|
    // Left Camera
 | 
						|
    commands.spawn((
 | 
						|
        Camera3dBundle {
 | 
						|
            transform: Transform::from_xyz(0.0, 200.0, -100.0).looking_at(Vec3::ZERO, Vec3::Y),
 | 
						|
            ..default()
 | 
						|
        },
 | 
						|
        LeftCamera,
 | 
						|
    ));
 | 
						|
 | 
						|
    // Right Camera
 | 
						|
    commands.spawn((
 | 
						|
        Camera3dBundle {
 | 
						|
            transform: Transform::from_xyz(100.0, 100., 150.0).looking_at(Vec3::ZERO, Vec3::Y),
 | 
						|
            camera: Camera {
 | 
						|
                // Renders the right camera after the left camera, which has a default priority of 0
 | 
						|
                order: 1,
 | 
						|
                ..default()
 | 
						|
            },
 | 
						|
            camera_3d: Camera3d {
 | 
						|
                // don't clear on the second camera because the first camera already cleared the window
 | 
						|
                clear_color: ClearColorConfig::None,
 | 
						|
                ..default()
 | 
						|
            },
 | 
						|
            ..default()
 | 
						|
        },
 | 
						|
        RightCamera,
 | 
						|
    ));
 | 
						|
}
 | 
						|
 | 
						|
#[derive(Component)]
 | 
						|
struct LeftCamera;
 | 
						|
 | 
						|
#[derive(Component)]
 | 
						|
struct RightCamera;
 | 
						|
 | 
						|
fn set_camera_viewports(
 | 
						|
    windows: Query<&Window>,
 | 
						|
    mut resize_events: EventReader<WindowResized>,
 | 
						|
    mut left_camera: Query<&mut Camera, (With<LeftCamera>, Without<RightCamera>)>,
 | 
						|
    mut right_camera: Query<&mut Camera, With<RightCamera>>,
 | 
						|
) {
 | 
						|
    // We need to dynamically resize the camera's viewports whenever the window size changes
 | 
						|
    // so then each camera always takes up half the screen.
 | 
						|
    // A resize_event is sent when the window is first created, allowing us to reuse this system for initial setup.
 | 
						|
    for resize_event in resize_events.read() {
 | 
						|
        let window = windows.get(resize_event.window).unwrap();
 | 
						|
        let mut left_camera = left_camera.single_mut();
 | 
						|
        left_camera.viewport = Some(Viewport {
 | 
						|
            physical_position: UVec2::new(0, 0),
 | 
						|
            physical_size: UVec2::new(
 | 
						|
                window.resolution.physical_width() / 2,
 | 
						|
                window.resolution.physical_height(),
 | 
						|
            ),
 | 
						|
            ..default()
 | 
						|
        });
 | 
						|
 | 
						|
        let mut right_camera = right_camera.single_mut();
 | 
						|
        right_camera.viewport = Some(Viewport {
 | 
						|
            physical_position: UVec2::new(window.resolution.physical_width() / 2, 0),
 | 
						|
            physical_size: UVec2::new(
 | 
						|
                window.resolution.physical_width() / 2,
 | 
						|
                window.resolution.physical_height(),
 | 
						|
            ),
 | 
						|
            ..default()
 | 
						|
        });
 | 
						|
    }
 | 
						|
}
 |