Struct Window 

pub struct Window { /* private fields */ }

A winit window wrapper with frame-tracking and cursor management.

Owns an optional [Arc<WinitWindow>]. When closed, the inner handle is set to None and all methods become no-ops returning default values.

Frame tracking

Call update_frame once per frame after processing events. This computes:

• Cursor delta (movement since last frame)
• Window position delta
• Cursor loopback wrapping

Cursor modes

The window supports three cursor modes:

• Grab — cursor is locked to the window (hidden, infinite movement)
• Confine — cursor is confined to the window area (visible, clamped)
• Loopback — cursor position wraps at window edges (software, for raw input in first-person controls)

Grab and confine are winit-level operations; loopback is implemented by update_frame warping the cursor.

Implementations

impl Window

pub fn new(el: &EventLoop<()>, title: &str, size: Size2D) -> Self

Create a new window.

The window starts hidden — call set_visible(true) when ready, or let the game loop manage visibility.

pub fn new_transparent(el: &EventLoop<()>, title: &str, size: Size2D) -> Self

Create a new transparent window (requires a compositor that supports transparency).

Same as new but sets with_transparent(true) on the winit window.

pub fn close(&mut self)

Close the window. The inner winit handle is dropped.

pub fn is_closed(&self) -> bool

True if the window has been closed.

pub fn is_running(&self) -> bool

True if the window is still open.

pub fn raw_handle(&self) -> Option<RawWindowHandle>

Raw window handle for EGL surface creation.

pub fn raw_display_handle(&self) -> Option<RawDisplayHandle>

Raw display handle for EGL display connection.

pub fn id(&self) -> Option<WindowId>

The winit window ID.

pub fn size(&self) -> Size2D

Current inner size (live winit query).

pub fn set_size(&self, size: Size2D)

Request a new inner size.

The OS may not honor the exact request — check size() later.

pub fn prev_size(&self) -> Size2D

The size cached at the last update_frame call.

pub fn min_size(&self) -> Option<Size2D>

Minimum window size (cached value, not a live winit query).

pub fn set_min_size(&mut self, size: Option<Size2D>)

Set the minimum window size.

pub fn max_size(&self) -> Option<Size2D>

Maximum window size (cached value, not a live winit query).

pub fn set_max_size(&mut self, size: Option<Size2D>)

Set the maximum window size.

pub fn resizable(&self) -> bool

True if the window is resizable (live winit query).

pub fn set_resizable(&self, enable: bool)

Enable or disable resizing.

pub fn position(&self) -> Coord2D

Desktop position of the window (live winit query via outer_position).

pub fn set_position(&self, pos: Coord2D)

Set the desktop position.

pub fn center_on_screen(&self)

Center the window on the current monitor.

pub fn prev_position(&self) -> Coord2D

Desktop position cached at the last update_frame call.

pub fn position_delta(&mut self) -> CoordOffset

Cumulative window position delta since the last call to this method (reset on read).

pub fn title(&self) -> String

Current window title (live winit query).

pub fn set_title(&self, title: &str)

Set the window title.

pub fn is_fullscreen(&self) -> bool

True if the window is currently fullscreen (live winit query).

pub fn set_fullscreen(&self, enable: bool)

Enter or exit borderless fullscreen.

pub fn toggle_fullscreen(&self)

Toggle fullscreen.

pub fn is_visible(&self) -> bool

True if the window is visible (live winit query).

pub fn set_visible(&self, visible: bool)

Show or hide the window.

pub fn is_minimized(&self) -> bool

True if the window is minimized (live winit query).

pub fn minimize(&self)

Minimize the window.

pub fn restore(&self)

Restore from minimized.

pub fn is_maximized(&self) -> bool

True if the window is maximized (live winit query).

pub fn maximize(&self)

Maximize the window.

pub fn unmaximize(&self)

Unmaximize the window (restore).

pub fn has_focus(&self) -> bool

True if the window has focus (live winit query).

pub fn focus(&self)

Request focus.

pub fn request_redraw(&self)

Request a redraw from winit.

pub fn screen_info(&self) -> Option<ScreenInfo>

Information about the monitor this window is on.

pub fn cursor_pos(&self) -> Coord2D

Cached cursor position (updated via events or set_cursor_pos).

pub fn set_cursor_pos(&mut self, pos: Coord2D)

Move the OS cursor and update the cached position.

pub fn cursor_delta(&self) -> CoordOffset

Cursor delta since the last frame (computed by update_frame).

Y is inverted (positive = up) to match screen coordinates.

pub fn cursor_pos_normalized(&self) -> Coord2D

Cursor position normalized to 0..1 where (0,0) = bottom-left, (1,1) = top-right.

pub fn is_cursor_inside(&self) -> bool

True if the cursor is inside the window client area (updated via events).

pub fn is_cursor_visible(&self) -> bool

True if the cursor is visible (cached, not a live winit query).

pub fn set_cursor_visible(&mut self, visible: bool)

Show or hide the cursor.

pub fn toggle_cursor_visible(&mut self)

Toggle cursor visibility.

pub fn is_cursor_grabbed(&self) -> bool

True if the cursor is grabbed (locked + hidden, for raw input).

pub fn set_cursor_grab(&mut self, grab: bool) -> Result<(), ()>

Lock or release the cursor (grab mode). Returns Err(()) if the platform does not support cursor locking.

pub fn toggle_cursor_grab(&mut self)

Toggle cursor grab.

pub fn is_cursor_confined(&self) -> bool

True if the cursor is confined (clamped to window, visible).

pub fn set_cursor_confine(&mut self, confine: bool) -> Result<(), ()>

Confine or release the cursor. Returns Err(()) if unsupported.

pub fn toggle_cursor_confine(&mut self)

Toggle cursor confine.

pub fn is_cursor_loopback(&self) -> bool

True if cursor loopback (software edge-wrapping) is enabled.

pub fn set_cursor_loopback(&mut self, loopback: bool)

Enable or disable loopback mode. When enabled, update_frame will wrap the cursor position at window edges, useful for first-person camera control.

pub fn update_frame(&mut self)

Call once per frame after processing events.

Snapshots cursor position, computes cursor/window deltas, and applies loopback wrapping if enabled.

Trait Implementations

impl Debug for Window

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.