Enum ControlFlow 

pub enum ControlFlow {
    Poll,
    Wait,
    WaitUntil(Instant),
    ExitWithCode(i32),
}

Set by the user callback given to the EventLoop::run method.

Indicates the desired behavior of the event loop after Event::RedrawEventsCleared is emitted.

Defaults to Poll.

Persistency

Almost every change is persistent between multiple calls to the event loop closure within a given run loop. The only exception to this is ExitWithCode which, once set, cannot be unset. Changes are not persistent between multiple calls to run_return - issuing a new call will reset the control flow to Poll.

Variants

Poll

When the current loop iteration finishes, immediately begin a new iteration regardless of whether or not new events are available to process.

Platform-specific

• Web: Events are queued and usually sent when requestAnimationFrame fires but sometimes the events in the queue may be sent before the next requestAnimationFrame callback, for example when the scaling of the page has changed. This should be treated as an implementation detail which should not be relied on.

Wait

When the current loop iteration finishes, suspend the thread until another event arrives.

WaitUntil(Instant)

When the current loop iteration finishes, suspend the thread until either another event arrives or the given time is reached.

Useful for implementing efficient timers. Applications which want to render at the display’s native refresh rate should instead use Poll and the VSync functionality of a graphics API to reduce odds of missed frames.

ExitWithCode(i32)

Send a LoopDestroyed event and stop the event loop. This variant is sticky - once set, control_flow cannot be changed from ExitWithCode, and any future attempts to do so will result in the control_flow parameter being reset to ExitWithCode.

The contained number will be used as exit code. The Exit constant is a shortcut for this with exit code 0.

Platform-specific

• Android / iOS / WASM: The supplied exit code is unused.
• Unix: On most Unix-like platforms, only the 8 least significant bits will be used, which can cause surprises with negative exit values (-42 would end up as 214). See std::process::exit.

Implementations

impl ControlFlow

pub const Exit: ControlFlow

Alias for ExitWithCode(0).

pub fn set_poll(&mut self)

Sets this to Poll.

Examples found in repository

examples/scene_example.rs (line 80)

fn example() {
    let el = EventLoop::new();
    let (vk, window) = Vk::new(&el);
    window.set_cursor_grab(winit::window::CursorGrabMode::Confined).unwrap();
    window.set_cursor_visible(false);
    window.set_title("CHAOS-VK");
    window.set_window_icon({
        let w = 8;
        let h = 8;

        Some(Icon::from_rgba(
            (0..w*h*4).map(|_| rand_betw(0, 255)).collect(), 
            w, 
            h
        ).unwrap())
    });
    window.set_theme(Some(Theme::Dark));
    window.set_inner_size(PhysicalSize::new(1200, 900));
    let size = window.inner_size();

    
    let mut presenter = Presenter::new(vk.clone(), window.clone());
    let mut renderer = Renderer::new();
    let mut imgui = ImGui::new(vk.clone(), &presenter);

    renderer.camera.proj = Mat4::perspective_lh(
        80.0f32.to_radians(), 
        size.width as f32 / size.height as f32, 0.1, 1000.0
    );

    let vs = shaders::vs::load(vk.device.clone()).unwrap();
    let fs = shaders::fs::load(vk.device.clone()).unwrap();

    let rp = render_pass_with_depth(vk.clone(), Some(presenter.swapchain.clone()));

    let pipeline = instancing_pipeline(vk.clone(), vs.clone(), fs.clone(), rp.clone(), Viewport {
        offset: [0.0, 0.0],
        extent: size.into(),
        depth_range: 0.0..=1.0,
    });

    presenter.window_resized = true;
    presenter.recreate(vk.clone(), rp.clone(), window.clone());

    let sphere = sphere(5, 1.0);
    renderer.meshes.push(Mesh::new(vk.clone(), &sphere.vertices, &sphere.indices));

    let mut cursor_x = 0.0;
    let mut cursor_y = 0.0;

    let data = (0..250).map(|_| { PosInstanceData {
            ofs: [rand_betw(-100.0, 100.0), rand_betw(-10.0, 10.0), rand_betw(-100.0, 100.0)]
        }
    }).collect::<Vec<PosInstanceData>>();
    renderer.meshes[0].instances = data.clone();
    let instance_buffer = VkIterBuffer::vertex(vk.allocators.clone(), data);
    renderer.meshes[0].ibo = instance_buffer;

    let mut dt = 0.0;

    el.run(move |event, _target, control_flow| {
        control_flow.set_poll();

        match event {
            Event::WindowEvent { event: WindowEvent::CloseRequested, .. } => {
                control_flow.set_exit();
            },
            Event::WindowEvent { event, .. } => {
                renderer.camera.input(&event);

                match event {
                    WindowEvent::KeyboardInput { input, .. } => {
                        if input.virtual_keycode == Some(VirtualKeyCode::Escape) {
                            control_flow.set_exit();
                        }

                        if input.modifiers.ctrl() && input.virtual_keycode == Some(VirtualKeyCode::S) {
                            Scene::write("assets/scene.cf", &renderer).expect("Failed to write scene");
                        }

                        if input.modifiers.ctrl() && input.virtual_keycode == Some(VirtualKeyCode::L) {
                            Scene::read("assets/scene.cf", &mut renderer, vk.clone()).expect("Failed to load scene");
                        }

                       window.set_cursor_visible(input.modifiers.alt());
                    },

                    WindowEvent::CursorMoved { position, .. } => {
                        imgui.on_mouse_move(position.x as f32, position.y as f32);
                    }

                    WindowEvent::MouseInput { button, state, .. } => {
                        imgui.on_mouse_click(button, state);
                    }

                    WindowEvent::MouseWheel { delta: MouseScrollDelta::PixelDelta(pos), .. } => {
                        imgui.on_mouse_scroll(pos.x as f32, pos.y as f32);
                    }

                    _ => ()
                }
            }

            Event::DeviceEvent {
                event: DeviceEvent::Text { codepoint }, ..
            } => {
                dbg!(codepoint);
            }

            Event::DeviceEvent { event: DeviceEvent::MouseMotion { delta },.. } => {
                cursor_x += delta.0 as f32;
                cursor_y += delta.1 as f32;

                renderer.camera.mouse_callback(cursor_x, cursor_y);
            }

            Event::MainEventsCleared => {
                let now = std::time::Instant::now();
                
                let frame = imgui.frame(&window);
                frame.text("hello, world!");
                frame.text(format!("dt:{:.1}", dt*1000.0));
                
                presenter.recreate(vk.clone(), rp.clone(), window.clone());

                renderer.update(dt);
                presenter.cmd_bufs = get_cmd_bufs(
                    vk.clone(), 
                    &renderer,
                    &mut imgui,
                    &presenter, 
                    pipeline.clone()
                );
                
                presenter.present(vk.clone());
                
                sleep(Duration::from_millis(16).saturating_sub(Duration::from_millis((dt * 1000.0) as u64)));
                dt = now.elapsed().as_secs_f32();
            }

            Event::LoopDestroyed => {println!("EXIT");}
            _ => {}
        }
    });
}

pub fn set_wait(&mut self)

Sets this to Wait.

pub fn set_wait_until(&mut self, instant: Instant)

Sets this to WaitUntil(instant).

pub fn set_wait_timeout(&mut self, timeout: Duration)

Sets this to wait until a timeout has expired.

In most cases, this is set to WaitUntil. However, if the timeout overflows, it is instead set to Wait.

pub fn set_exit_with_code(&mut self, code: i32)

Sets this to ExitWithCode(code).

pub fn set_exit(&mut self)

Sets this to Exit.

Examples found in repository

examples/scene_example.rs (line 84)

fn example() {
    let el = EventLoop::new();
    let (vk, window) = Vk::new(&el);
    window.set_cursor_grab(winit::window::CursorGrabMode::Confined).unwrap();
    window.set_cursor_visible(false);
    window.set_title("CHAOS-VK");
    window.set_window_icon({
        let w = 8;
        let h = 8;

        Some(Icon::from_rgba(
            (0..w*h*4).map(|_| rand_betw(0, 255)).collect(), 
            w, 
            h
        ).unwrap())
    });
    window.set_theme(Some(Theme::Dark));
    window.set_inner_size(PhysicalSize::new(1200, 900));
    let size = window.inner_size();

    
    let mut presenter = Presenter::new(vk.clone(), window.clone());
    let mut renderer = Renderer::new();
    let mut imgui = ImGui::new(vk.clone(), &presenter);

    renderer.camera.proj = Mat4::perspective_lh(
        80.0f32.to_radians(), 
        size.width as f32 / size.height as f32, 0.1, 1000.0
    );

    let vs = shaders::vs::load(vk.device.clone()).unwrap();
    let fs = shaders::fs::load(vk.device.clone()).unwrap();

    let rp = render_pass_with_depth(vk.clone(), Some(presenter.swapchain.clone()));

    let pipeline = instancing_pipeline(vk.clone(), vs.clone(), fs.clone(), rp.clone(), Viewport {
        offset: [0.0, 0.0],
        extent: size.into(),
        depth_range: 0.0..=1.0,
    });

    presenter.window_resized = true;
    presenter.recreate(vk.clone(), rp.clone(), window.clone());

    let sphere = sphere(5, 1.0);
    renderer.meshes.push(Mesh::new(vk.clone(), &sphere.vertices, &sphere.indices));

    let mut cursor_x = 0.0;
    let mut cursor_y = 0.0;

    let data = (0..250).map(|_| { PosInstanceData {
            ofs: [rand_betw(-100.0, 100.0), rand_betw(-10.0, 10.0), rand_betw(-100.0, 100.0)]
        }
    }).collect::<Vec<PosInstanceData>>();
    renderer.meshes[0].instances = data.clone();
    let instance_buffer = VkIterBuffer::vertex(vk.allocators.clone(), data);
    renderer.meshes[0].ibo = instance_buffer;

    let mut dt = 0.0;

    el.run(move |event, _target, control_flow| {
        control_flow.set_poll();

        match event {
            Event::WindowEvent { event: WindowEvent::CloseRequested, .. } => {
                control_flow.set_exit();
            },
            Event::WindowEvent { event, .. } => {
                renderer.camera.input(&event);

                match event {
                    WindowEvent::KeyboardInput { input, .. } => {
                        if input.virtual_keycode == Some(VirtualKeyCode::Escape) {
                            control_flow.set_exit();
                        }

                        if input.modifiers.ctrl() && input.virtual_keycode == Some(VirtualKeyCode::S) {
                            Scene::write("assets/scene.cf", &renderer).expect("Failed to write scene");
                        }

                        if input.modifiers.ctrl() && input.virtual_keycode == Some(VirtualKeyCode::L) {
                            Scene::read("assets/scene.cf", &mut renderer, vk.clone()).expect("Failed to load scene");
                        }

                       window.set_cursor_visible(input.modifiers.alt());
                    },

                    WindowEvent::CursorMoved { position, .. } => {
                        imgui.on_mouse_move(position.x as f32, position.y as f32);
                    }

                    WindowEvent::MouseInput { button, state, .. } => {
                        imgui.on_mouse_click(button, state);
                    }

                    WindowEvent::MouseWheel { delta: MouseScrollDelta::PixelDelta(pos), .. } => {
                        imgui.on_mouse_scroll(pos.x as f32, pos.y as f32);
                    }

                    _ => ()
                }
            }

            Event::DeviceEvent {
                event: DeviceEvent::Text { codepoint }, ..
            } => {
                dbg!(codepoint);
            }

            Event::DeviceEvent { event: DeviceEvent::MouseMotion { delta },.. } => {
                cursor_x += delta.0 as f32;
                cursor_y += delta.1 as f32;

                renderer.camera.mouse_callback(cursor_x, cursor_y);
            }

            Event::MainEventsCleared => {
                let now = std::time::Instant::now();
                
                let frame = imgui.frame(&window);
                frame.text("hello, world!");
                frame.text(format!("dt:{:.1}", dt*1000.0));
                
                presenter.recreate(vk.clone(), rp.clone(), window.clone());

                renderer.update(dt);
                presenter.cmd_bufs = get_cmd_bufs(
                    vk.clone(), 
                    &renderer,
                    &mut imgui,
                    &presenter, 
                    pipeline.clone()
                );
                
                presenter.present(vk.clone());
                
                sleep(Duration::from_millis(16).saturating_sub(Duration::from_millis((dt * 1000.0) as u64)));
                dt = now.elapsed().as_secs_f32();
            }

            Event::LoopDestroyed => {println!("EXIT");}
            _ => {}
        }
    });
}

Trait Implementations

impl Clone for ControlFlow

fn clone(&self) -> ControlFlow

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ControlFlow

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

Formats the value using the given formatter.

impl Default for ControlFlow

fn default() -> ControlFlow

Returns the “default value” for a type.

impl PartialEq for ControlFlow

fn eq(&self, other: &ControlFlow) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for ControlFlow

impl Eq for ControlFlow

impl StructuralPartialEq for ControlFlow