Struct GameLoop 

pub struct GameLoop<F: FnMut(&mut FrameState<'_>)> { /* private fields */ }

A low-level game loop that drives a closure once per frame.

Owns the event loop, one or more windows, the GPU, a camera, timing, and gamepad state. The user provides a FnMut(&mut FrameState) closure that is invoked every frame.

This is the lower-level alternative to Game + Runtime. Use it when you want more control over the setup process or need multiple windows.

Example

use optic_loop::{GameLoop, WindowState};

let el = EventLoop::new().unwrap();
let ws = WindowState::new(&el, "App", (800, 600).into());
let gpu = GPU::new_headless()?;
let camera = Camera::new((800, 600).into(), CamProj::Persp);

let game = GameLoop::new(el, gpu, camera, vec![ws], |frame| {
    frame.gpu.clear();
})?;
game.run();

Implementations

impl<F: FnMut(&mut FrameState<'_>)> GameLoop<F>

pub fn new( el: EventLoop<()>, gpu: GPU, camera: Camera, windows: Vec<WindowState>, frame_fn: F, ) -> OpticResult<Self>

Constructs a new game loop.

Attaches each window’s raw handle to the GPU context and initialises gamepad support via gilrs.

Errors

Returns an error if window attachment to the GPU surface or gamepad initialisation fails.

pub fn run(self)

Starts the event loop, consuming self.

This call blocks until all windows are closed or the application exits.

Trait Implementations

impl<F: FnMut(&mut FrameState<'_>)> ApplicationHandler for GameLoop<F>

fn resumed(&mut self, _el: &ActiveEventLoop)

Emitted when the application has been resumed.

fn window_event( &mut self, _el: &ActiveEventLoop, id: WindowId, event: WindowEvent, )

Emitted when the OS sends an event to a winit window.

fn about_to_wait(&mut self, _el: &ActiveEventLoop)

Emitted when the event loop is about to block and wait for new events.

fn new_events(&mut self, event_loop: &ActiveEventLoop, cause: StartCause)

Emitted when new events arrive from the OS to be processed.

fn user_event(&mut self, event_loop: &ActiveEventLoop, event: T)

Emitted when an event is sent from EventLoopProxy::send_event.

fn device_event( &mut self, event_loop: &ActiveEventLoop, device_id: DeviceId, event: DeviceEvent, )

Emitted when the OS sends an event to a device.

fn suspended(&mut self, event_loop: &ActiveEventLoop)

Emitted when the application has been suspended.

fn exiting(&mut self, event_loop: &ActiveEventLoop)

Emitted when the event loop is being shut down.

fn memory_warning(&mut self, event_loop: &ActiveEventLoop)

Emitted when the application has received a memory warning.