bevy_window_manager 0.18.2

Bevy plugin for primary window restoration and multi-monitor support
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111

//! Example demonstrating explicit path configuration with `WindowManagerPlugin`.
//!
//! Run with: `cargo run --example custom_path`
//!
//! This shows how to manually construct a cross-platform config path using `dirs`,
//! giving you full control over the app name and filename. Of course you can put it anywhere you
//! want, we're just using `dirs` for convenience in this example.
//!
//! Window state is saved to:
//! - macOS: `~/Library/Application Support/my_custom_app/window_state.ron`
//! - Linux: `~/.config/my_custom_app/window_state.ron`
//! - Windows: `C:\Users\{user}\AppData\Roaming\my_custom_app\window_state.ron`

use bevy::prelude::*;
use bevy::window::Monitor;
use bevy::window::PrimaryWindow;
use bevy_window_manager::CurrentMonitor;
use bevy_window_manager::Monitors;
use bevy_window_manager::WindowExt;
use bevy_window_manager::WindowManagerPlugin;

#[expect(
    clippy::expect_used,
    reason = "example code - panicking on missing config dir is acceptable"
)]
fn main() {
    // Construct a cross-platform config path manually
    let config_path = dirs::config_dir()
        .expect("Could not find config directory")
        .join("my_custom_app")
        .join("window_state.ron");

    App::new()
        .add_plugins(DefaultPlugins.set(WindowPlugin {
            primary_window: Some(Window {
                title: "Custom Path Example".to_string(),
                ..default()
            }),
            ..default()
        }))
        .add_plugins(WindowManagerPlugin::with_path(config_path))
        .add_systems(Startup, setup)
        .add_systems(Update, update_info_text)
        .run();
}

#[derive(Component)]
struct InfoText;

fn setup(mut commands: Commands) {
    commands.spawn(Camera2d);

    commands.spawn((
        InfoText,
        Text::default(),
        TextFont {
            font_size: 20.0,
            ..default()
        },
        Node {
            position_type: PositionType::Absolute,
            top: Val::Px(10.0),
            left: Val::Px(10.0),
            ..default()
        },
    ));
}

fn update_info_text(
    window_query: Single<(&Window, &CurrentMonitor), With<PrimaryWindow>>,
    monitors: Res<Monitors>,
    bevy_monitors: Query<&Monitor>,
    mut text: Single<&mut Text, With<InfoText>>,
) {
    let (window, monitor) = *window_query;
    let effective_mode = window.effective_mode(&monitors);

    // Find refresh rate from Bevy's Monitor by matching position
    let refresh_rate = bevy_monitors
        .iter()
        .find(|m| m.physical_position == monitor.position)
        .and_then(|m| m.refresh_rate_millihertz)
        .map(|r| r / 1000);

    let refresh_display = refresh_rate.map_or_else(|| "N/A".into(), |hz| format!("{hz}Hz"));

    text.0 = format!(
        "Window Position: {:?}\n\
         Window Size: {}x{}\n\
         Mode: {:?} (set value only, not dynamically updated)\n\
         Effective Mode: {:?}\n\
         \n\
         Monitor {}\n\
         Position: ({}, {})\n\
         Size: {}x{}\n\
         Scale: {}\n\
         Refresh Rate: {}",
        window.position,
        window.physical_width(),
        window.physical_height(),
        window.mode,
        effective_mode,
        monitor.index,
        monitor.position.x,
        monitor.position.y,
        monitor.size.x,
        monitor.size.y,
        monitor.scale,
        refresh_display
    );
}