summaryrefslogblamecommitdiffstats
path: root/winit/src/multi_window.rs
blob: 16b41e7d4c66641e79c2382a2d481732c73067d6 (plain) (tree)
1
2
3
4
5
6
7
8
9
                                                                    
          
                   


                     
                      
                
                          
                                   
                        
                      
                                           
                                                       

                                                      
                                                       



                                                          
                                          
                                               
 
                              
                           
                       
 
                                                                       
   
                                                                                         







                                                                                
                              
     
                                                          













                                                                                
                                                         


                                                                            
                                                  
 




                                                           
 
                                                     

              
                                                                           















                                                                             
                                                                      







                                                                             
                              
                                                       

           










                                                                          

                                                       
 




                                            



                                                        














                                                                        
                                                         

                                                                      
                                              
                        
                                             

                                     

                         


                                                 
                             






                                                  
                                          




                                                  

















                                                                          

     
                                                                          
 



                                                  

                        

                              
 

                                                                   
 








                                                        
                       
                               
       


                                                                        

                                                     


                   


                                                        
 

                                                            
 






























                                                                          

                         
                          
                              
                     





                                         
         


          

 





                                      
                                                    



                                               
         







                                                       


                               

                                                             
                     

                                                                   
                                      
                                            
                                        


                             

                                                       
 
                     
                                       
 




















                                                             
 
                                       


                                                                      




                                             
       
 

                     
                        


                       
                            

                   
                            
                       
      
 
                                                             
 
                                  
                                   


                             
                                                                
                     




                                      
                                                   

                           

                                    

                                          
 


                                                               
                       









                                                                               
 



                                        



                                                        

                      









                                                                             
                     
                                                   


                                                           

                                               
 
                                     




                                                                   


                              

                                                         
                     




                                                                   






                                                                         
 



                                                                                
 
                                               



                                                                           
 
                                                   
 


                                                                 
 



                                                                                
 
                                                    
 
                                                 


                                                                       
                                      

                                                         
                                                      
                                                                              
                                      
                                                          
                                  
 


                                                                                



                                                                  
 

                                                          

                                                  
 
                                                         
                                                    

                                                     
                              
 

                                                                
                         
 
                                                 



                                                            



                                                        
 

                                                                                      
                             











                                                                                  



                                                                    


                                     
                         
                     



                                               




                                                                   
 







                                                                     
 



                                                                               
 

                                                          
                             













                                                                          
                             
                         
                     
                           

                 
         




























































































































































                                                                                            

     
                                                      

 
                                                                
                                            




                                 
                   

                                               
                                                       

                         
                                    








                                                                           
                                                                               
                                                             
                                          
                        
                       
                                                            
                              

                                                              

                                   

                                                               
       

                                                       


                                       
                               
 




                                                                    
                       


                      
                           

                  
                           
                      


          
                                                  
                                               


                                      
                        
                    
                       
                                 
                                                            
                              

                                                              
                      

                                                               
       
                   
                

                                                       
 


                                  



                                                
                                                
             
                                                
                                              
             




                                                                
                                            





                                                              

                                                             
                                                                
 

                                                           
                               
                                     
                                                         
                                    
                          
                                                       
                 
                                              

                                                      
 
                                                  
                                      
                                                      

                                                           
                 
                                             


                                                                      
                 
                                                     
                                                                      





                                                              
                     
                 
                                                            












                                                                      
                 
                                                            


                                                                      
                 
                                                            


                                                                      
                 
                                                       







                                                                      
                 
                                                         






                                                                          
                 
                                                         


                                                                           
                 
                                                       










                                                                               
                 
                                                       


                                                                             
                 
                                                          


                                                                               
                 
                                                                             




                                                                           
                 
                                                  


                                                                      
                 
                                                           




                                                                               
                 
                                                     




                                                                      
                 
                                                        







                                                                      
 






                                                                    
                 
              



                                                             
                                                                           








                                                                          
                                                    
                                                                     




                                                
                                                         
 
                                                    
                                
                          
                                   
                                              

                  


                                                         
















                                                                                                       
                             



                         
                            
                                                                                





                                                                                                              

                                                              
                 
 
                     
                                               
                                                          




             

                                                                
                       
                      


                                                                           
     

                                                       
 
                          














                                                     
          
                  
 
 

                                                                         
                       

                                                
           
                 
                                   
                                                  


                                                                    



                                                               
                                                        
                   
     
 
//! Create interactive, native cross-platform applications for WGPU.
mod state;
mod window_manager;

pub use state::State;

use crate::conversion;
use crate::core;
use crate::core::renderer;
use crate::core::widget::operation;
use crate::core::window;
use crate::core::Size;
use crate::futures::futures::channel::mpsc;
use crate::futures::futures::{task, Future, StreamExt};
use crate::futures::{Executor, Runtime, Subscription};
use crate::graphics::{compositor, Compositor};
use crate::multi_window::window_manager::WindowManager;
use crate::runtime::command::{self, Command};
use crate::runtime::multi_window::Program;
use crate::runtime::user_interface::{self, UserInterface};
use crate::runtime::Debug;
use crate::style::application::StyleSheet;
use crate::{Clipboard, Error, Proxy, Settings};

use std::collections::HashMap;
use std::mem::ManuallyDrop;
use std::time::Instant;

/// An interactive, native, cross-platform, multi-windowed application.
///
/// This trait is the main entrypoint of multi-window Iced. Once implemented, you can run
/// your GUI application by simply calling [`run`]. It will run in
/// its own window.
///
/// An [`Application`] can execute asynchronous actions by returning a
/// [`Command`] in some of its methods.
///
/// When using an [`Application`] with the `debug` feature enabled, a debug view
/// can be toggled by pressing `F12`.
pub trait Application: Program
where
    <Self::Renderer as core::Renderer>::Theme: StyleSheet,
{
    /// The data needed to initialize your [`Application`].
    type Flags;

    /// Initializes the [`Application`] with the flags provided to
    /// [`run`] as part of the [`Settings`].
    ///
    /// Here is where you should return the initial state of your app.
    ///
    /// Additionally, you can return a [`Command`] if you need to perform some
    /// async action in the background on startup. This is useful if you want to
    /// load state from a file, perform an initial HTTP request, etc.
    fn new(flags: Self::Flags) -> (Self, Command<Self::Message>);

    /// Returns the current title of the [`Application`].
    ///
    /// This title can be dynamic! The runtime will automatically update the
    /// title of your application when necessary.
    fn title(&self, window: window::Id) -> String;

    /// Returns the current `Theme` of the [`Application`].
    fn theme(
        &self,
        window: window::Id,
    ) -> <Self::Renderer as core::Renderer>::Theme;

    /// Returns the `Style` variation of the `Theme`.
    fn style(
        &self,
    ) -> <<Self::Renderer as core::Renderer>::Theme as StyleSheet>::Style {
        Default::default()
    }

    /// Returns the event `Subscription` for the current state of the
    /// application.
    ///
    /// The messages produced by the `Subscription` will be handled by
    /// [`update`](#tymethod.update).
    ///
    /// A `Subscription` will be kept alive as long as you keep returning it!
    ///
    /// By default, it returns an empty subscription.
    fn subscription(&self) -> Subscription<Self::Message> {
        Subscription::none()
    }

    /// Returns the scale factor of the window of the [`Application`].
    ///
    /// It can be used to dynamically control the size of the UI at runtime
    /// (i.e. zooming).
    ///
    /// For instance, a scale factor of `2.0` will make widgets twice as big,
    /// while a scale factor of `0.5` will shrink them to half their size.
    ///
    /// By default, it returns `1.0`.
    #[allow(unused_variables)]
    fn scale_factor(&self, window: window::Id) -> f64 {
        1.0
    }
}

/// Runs an [`Application`] with an executor, compositor, and the provided
/// settings.
pub fn run<A, E, C>(
    settings: Settings<A::Flags>,
    compositor_settings: C::Settings,
) -> Result<(), Error>
where
    A: Application + 'static,
    E: Executor + 'static,
    C: Compositor<Renderer = A::Renderer> + 'static,
    <A::Renderer as core::Renderer>::Theme: StyleSheet,
{
    use winit::event_loop::EventLoopBuilder;

    let mut debug = Debug::new();
    debug.startup_started();

    let event_loop = EventLoopBuilder::with_user_event()
        .build()
        .expect("Create event loop");

    let proxy = event_loop.create_proxy();

    let runtime = {
        let proxy = Proxy::new(event_loop.create_proxy());
        let executor = E::new().map_err(Error::ExecutorCreationFailed)?;

        Runtime::new(executor, proxy)
    };

    let (application, init_command) = {
        let flags = settings.flags;

        runtime.enter(|| A::new(flags))
    };

    let should_main_be_visible = settings.window.visible;
    let exit_on_close_request = settings.window.exit_on_close_request;

    let builder = conversion::window_settings(
        settings.window,
        &application.title(window::Id::MAIN),
        event_loop.primary_monitor(),
        settings.id,
    )
    .with_visible(false);

    log::info!("Window builder: {:#?}", builder);

    let main_window = builder
        .build(&event_loop)
        .map_err(Error::WindowCreationFailed)?;

    #[cfg(target_arch = "wasm32")]
    {
        use winit::platform::web::WindowExtWebSys;

        let canvas = main_window.canvas();

        let window = web_sys::window().unwrap();
        let document = window.document().unwrap();
        let body = document.body().unwrap();

        let target = target.and_then(|target| {
            body.query_selector(&format!("#{}", target))
                .ok()
                .unwrap_or(None)
        });

        match target {
            Some(node) => {
                let _ = node
                    .replace_with_with_node_1(&canvas)
                    .expect(&format!("Could not replace #{}", node.id()));
            }
            None => {
                let _ = body
                    .append_child(&canvas)
                    .expect("Append canvas to HTML body");
            }
        };
    }

    let mut compositor = C::new(compositor_settings, Some(&main_window))?;

    let mut window_manager = WindowManager::new();
    let _ = window_manager.insert(
        window::Id::MAIN,
        main_window,
        &application,
        &mut compositor,
        exit_on_close_request,
    );

    let (mut event_sender, event_receiver) = mpsc::unbounded();
    let (control_sender, mut control_receiver) = mpsc::unbounded();

    let mut instance = Box::pin(run_instance::<A, E, C>(
        application,
        compositor,
        runtime,
        proxy,
        debug,
        event_receiver,
        control_sender,
        init_command,
        window_manager,
        should_main_be_visible,
    ));

    let mut context = task::Context::from_waker(task::noop_waker_ref());

    let _ = event_loop.run(move |event, event_loop| {
        if event_loop.exiting() {
            return;
        }

        event_sender
            .start_send(Event::EventLoopAwakened(event))
            .expect("Send event");

        loop {
            let poll = instance.as_mut().poll(&mut context);

            match poll {
                task::Poll::Pending => match control_receiver.try_next() {
                    Ok(Some(control)) => match control {
                        Control::ChangeFlow(flow) => {
                            event_loop.set_control_flow(flow);
                        }
                        Control::CreateWindow {
                            id,
                            settings,
                            title,
                            monitor,
                        } => {
                            let exit_on_close_request =
                                settings.exit_on_close_request;

                            let window = conversion::window_settings(
                                settings, &title, monitor, None,
                            )
                            .build(event_loop)
                            .expect("Failed to build window");

                            event_sender
                                .start_send(Event::WindowCreated {
                                    id,
                                    window,
                                    exit_on_close_request,
                                })
                                .expect("Send event");
                        }
                        Control::Exit => {
                            event_loop.exit();
                        }
                    },
                    _ => {
                        break;
                    }
                },
                task::Poll::Ready(_) => {
                    event_loop.exit();
                    break;
                }
            };
        }
    });

    Ok(())
}

enum Event<Message: 'static> {
    WindowCreated {
        id: window::Id,
        window: winit::window::Window,
        exit_on_close_request: bool,
    },
    EventLoopAwakened(winit::event::Event<Message>),
}

enum Control {
    ChangeFlow(winit::event_loop::ControlFlow),
    Exit,
    CreateWindow {
        id: window::Id,
        settings: window::Settings,
        title: String,
        monitor: Option<winit::monitor::MonitorHandle>,
    },
}

async fn run_instance<A, E, C>(
    mut application: A,
    mut compositor: C,
    mut runtime: Runtime<E, Proxy<A::Message>, A::Message>,
    mut proxy: winit::event_loop::EventLoopProxy<A::Message>,
    mut debug: Debug,
    mut event_receiver: mpsc::UnboundedReceiver<Event<A::Message>>,
    mut control_sender: mpsc::UnboundedSender<Control>,
    init_command: Command<A::Message>,
    mut window_manager: WindowManager<A, C>,
    should_main_window_be_visible: bool,
) where
    A: Application + 'static,
    E: Executor + 'static,
    C: Compositor<Renderer = A::Renderer> + 'static,
    <A::Renderer as core::Renderer>::Theme: StyleSheet,
{
    use winit::event;
    use winit::event_loop::ControlFlow;

    let main_window = window_manager
        .get_mut(window::Id::MAIN)
        .expect("Get main window");

    if should_main_window_be_visible {
        main_window.raw.set_visible(true);
    }

    let mut clipboard = Clipboard::connect(&main_window.raw);
    let mut events = {
        vec![(
            Some(window::Id::MAIN),
            core::Event::Window(
                window::Id::MAIN,
                window::Event::Opened {
                    position: main_window.position(),
                    size: main_window.size(),
                },
            ),
        )]
    };

    let mut ui_caches = HashMap::new();
    let mut user_interfaces = ManuallyDrop::new(build_user_interfaces(
        &application,
        &mut debug,
        &mut window_manager,
        HashMap::from_iter([(
            window::Id::MAIN,
            user_interface::Cache::default(),
        )]),
    ));

    run_command(
        &application,
        &mut compositor,
        init_command,
        &mut runtime,
        &mut clipboard,
        &mut control_sender,
        &mut proxy,
        &mut debug,
        &mut window_manager,
        &mut ui_caches,
    );

    runtime.track(application.subscription().into_recipes());

    let mut messages = Vec::new();
    let mut redraw_pending = false;

    debug.startup_finished();

    'main: while let Some(event) = event_receiver.next().await {
        match event {
            Event::WindowCreated {
                id,
                window,
                exit_on_close_request,
            } => {
                let window = window_manager.insert(
                    id,
                    window,
                    &application,
                    &mut compositor,
                    exit_on_close_request,
                );

                let logical_size = window.state.logical_size();

                let _ = user_interfaces.insert(
                    id,
                    build_user_interface(
                        &application,
                        user_interface::Cache::default(),
                        &mut window.renderer,
                        logical_size,
                        &mut debug,
                        id,
                    ),
                );
                let _ = ui_caches.insert(id, user_interface::Cache::default());

                events.push((
                    Some(id),
                    core::Event::Window(
                        id,
                        window::Event::Opened {
                            position: window.position(),
                            size: window.size(),
                        },
                    ),
                ));
            }
            Event::EventLoopAwakened(event) => {
                match event {
                    event::Event::NewEvents(start_cause) => {
                        redraw_pending = matches!(
                            start_cause,
                            event::StartCause::Init
                                | event::StartCause::Poll
                                | event::StartCause::ResumeTimeReached { .. }
                        );
                    }
                    event::Event::PlatformSpecific(
                        event::PlatformSpecific::MacOS(
                            event::MacOS::ReceivedUrl(url),
                        ),
                    ) => {
                        use crate::core::event;

                        events.push((
                            None,
                            event::Event::PlatformSpecific(
                                event::PlatformSpecific::MacOS(
                                    event::MacOS::ReceivedUrl(url),
                                ),
                            ),
                        ));
                    }
                    event::Event::UserEvent(message) => {
                        messages.push(message);
                    }
                    event::Event::WindowEvent {
                        window_id: id,
                        event: event::WindowEvent::RedrawRequested,
                        ..
                    } => {
                        let Some((id, window)) =
                            window_manager.get_mut_alias(id)
                        else {
                            continue;
                        };

                        let physical_size = window.state.physical_size();

                        if physical_size.width == 0 || physical_size.height == 0
                        {
                            continue;
                        }

                        debug.render_started();
                        if window.viewport_version
                            != window.state.viewport_version()
                        {
                            let logical_size = window.state.logical_size();

                            debug.layout_started();

                            let ui = user_interfaces
                                .remove(&id)
                                .expect("Remove user interface");

                            let _ = user_interfaces.insert(
                                id,
                                ui.relayout(logical_size, &mut window.renderer),
                            );

                            debug.layout_finished();

                            debug.draw_started();
                            let new_mouse_interaction = user_interfaces
                                .get_mut(&id)
                                .expect("Get user interface")
                                .draw(
                                    &mut window.renderer,
                                    window.state.theme(),
                                    &renderer::Style {
                                        text_color: window.state.text_color(),
                                    },
                                    window.state.cursor(),
                                );

                            if new_mouse_interaction != window.mouse_interaction
                            {
                                window.raw.set_cursor_icon(
                                    conversion::mouse_interaction(
                                        new_mouse_interaction,
                                    ),
                                );

                                window.mouse_interaction =
                                    new_mouse_interaction;
                            }
                            debug.draw_finished();

                            compositor.configure_surface(
                                &mut window.surface,
                                physical_size.width,
                                physical_size.height,
                            );

                            window.viewport_version =
                                window.state.viewport_version();
                        }

                        match compositor.present(
                            &mut window.renderer,
                            &mut window.surface,
                            window.state.viewport(),
                            window.state.background_color(),
                            &debug.overlay(),
                        ) {
                            Ok(()) => {
                                debug.render_finished();

                                // TODO: Handle animations!
                                // Maybe we can use `ControlFlow::WaitUntil` for this.
                            }
                            Err(error) => match error {
                                // This is an unrecoverable error.
                                compositor::SurfaceError::OutOfMemory => {
                                    panic!("{:?}", error);
                                }
                                _ => {
                                    debug.render_finished();
                                    log::error!(
                                "Error {error:?} when presenting surface."
                            );

                                    // Try rendering all windows again next frame.
                                    for (_id, window) in
                                        window_manager.iter_mut()
                                    {
                                        window.raw.request_redraw();
                                    }
                                }
                            },
                        }
                    }
                    event::Event::WindowEvent {
                        event: window_event,
                        window_id,
                    } => {
                        let Some((id, window)) =
                            window_manager.get_mut_alias(window_id)
                        else {
                            continue;
                        };

                        if matches!(
                            window_event,
                            winit::event::WindowEvent::CloseRequested
                        ) && window.exit_on_close_request
                        {
                            let _ = window_manager.remove(id);
                            let _ = user_interfaces.remove(&id);
                            let _ = ui_caches.remove(&id);

                            events.push((
                                None,
                                core::Event::Window(id, window::Event::Closed),
                            ));

                            if window_manager.is_empty() {
                                break 'main;
                            }
                        } else {
                            window.state.update(
                                &window.raw,
                                &window_event,
                                &mut debug,
                            );

                            if let Some(event) = conversion::window_event(
                                id,
                                &window_event,
                                window.state.scale_factor(),
                                window.state.modifiers(),
                            ) {
                                events.push((Some(id), event));
                            }
                        }
                    }
                    _ => {}
                }
            }
        }

        debug.event_processing_started();
        let mut uis_stale = false;

        for (id, window) in window_manager.iter_mut() {
            let mut window_events = vec![];

            events.retain(|(window_id, event)| {
                if *window_id == Some(id) || window_id.is_none() {
                    window_events.push(event.clone());
                    false
                } else {
                    true
                }
            });

            if !redraw_pending
                && window_events.is_empty()
                && messages.is_empty()
            {
                continue;
            }

            let (ui_state, statuses) = user_interfaces
                .get_mut(&id)
                .expect("Get user interface")
                .update(
                    &window_events,
                    window.state.cursor(),
                    &mut window.renderer,
                    &mut clipboard,
                    &mut messages,
                );

            if !uis_stale {
                uis_stale = matches!(ui_state, user_interface::State::Outdated);
            }

            for (event, status) in
                window_events.into_iter().zip(statuses.into_iter())
            {
                runtime.broadcast(event, status);
            }
        }

        debug.event_processing_finished();

        // TODO mw application update returns which window IDs to update
        if !messages.is_empty() || uis_stale {
            let mut cached_interfaces: HashMap<
                window::Id,
                user_interface::Cache,
            > = ManuallyDrop::into_inner(user_interfaces)
                .drain()
                .map(|(id, ui)| (id, ui.into_cache()))
                .collect();

            // Update application
            update(
                &mut application,
                &mut compositor,
                &mut runtime,
                &mut clipboard,
                &mut control_sender,
                &mut proxy,
                &mut debug,
                &mut messages,
                &mut window_manager,
                &mut cached_interfaces,
            );

            // we must synchronize all window states with application state after an
            // application update since we don't know what changed
            for (id, window) in window_manager.iter_mut() {
                window.state.synchronize(&application, id, &window.raw);
            }

            // rebuild UIs with the synchronized states
            user_interfaces = ManuallyDrop::new(build_user_interfaces(
                &application,
                &mut debug,
                &mut window_manager,
                cached_interfaces,
            ));
        }

        debug.draw_started();

        for (id, window) in window_manager.iter_mut() {
            // TODO: Avoid redrawing all the time by forcing widgets to
            //  request redraws on state changes
            //
            // Then, we can use the `interface_state` here to decide if a redraw
            // is needed right away, or simply wait until a specific time.
            let redraw_event = core::Event::Window(
                id,
                window::Event::RedrawRequested(Instant::now()),
            );

            let cursor = window.state.cursor();

            let ui = user_interfaces.get_mut(&id).expect("Get user interface");

            let (ui_state, _) = ui.update(
                &[redraw_event.clone()],
                cursor,
                &mut window.renderer,
                &mut clipboard,
                &mut messages,
            );

            let new_mouse_interaction = {
                let state = &window.state;

                ui.draw(
                    &mut window.renderer,
                    state.theme(),
                    &renderer::Style {
                        text_color: state.text_color(),
                    },
                    cursor,
                )
            };

            if new_mouse_interaction != window.mouse_interaction {
                window.raw.set_cursor_icon(conversion::mouse_interaction(
                    new_mouse_interaction,
                ));

                window.mouse_interaction = new_mouse_interaction;
            }

            // TODO once widgets can request to be redrawn, we can avoid always requesting a
            // redraw
            window.raw.request_redraw();

            runtime
                .broadcast(redraw_event.clone(), core::event::Status::Ignored);

            let _ = control_sender.start_send(Control::ChangeFlow(
                match ui_state {
                    user_interface::State::Updated {
                        redraw_request: Some(redraw_request),
                    } => match redraw_request {
                        window::RedrawRequest::NextFrame => ControlFlow::Poll,
                        window::RedrawRequest::At(at) => {
                            ControlFlow::WaitUntil(at)
                        }
                    },
                    _ => ControlFlow::Wait,
                },
            ));
        }

        redraw_pending = false;

        debug.draw_finished();
    }

    let _ = ManuallyDrop::into_inner(user_interfaces);
}

/// Builds a window's [`UserInterface`] for the [`Application`].
fn build_user_interface<'a, A: Application>(
    application: &'a A,
    cache: user_interface::Cache,
    renderer: &mut A::Renderer,
    size: Size,
    debug: &mut Debug,
    id: window::Id,
) -> UserInterface<'a, A::Message, A::Renderer>
where
    <A::Renderer as core::Renderer>::Theme: StyleSheet,
{
    debug.view_started();
    let view = application.view(id);
    debug.view_finished();

    debug.layout_started();
    let user_interface = UserInterface::build(view, size, cache, renderer);
    debug.layout_finished();

    user_interface
}

/// Updates a multi-window [`Application`] by feeding it messages, spawning any
/// resulting [`Command`], and tracking its [`Subscription`].
fn update<A: Application, C, E: Executor>(
    application: &mut A,
    compositor: &mut C,
    runtime: &mut Runtime<E, Proxy<A::Message>, A::Message>,
    clipboard: &mut Clipboard,
    control_sender: &mut mpsc::UnboundedSender<Control>,
    proxy: &mut winit::event_loop::EventLoopProxy<A::Message>,
    debug: &mut Debug,
    messages: &mut Vec<A::Message>,
    window_manager: &mut WindowManager<A, C>,
    ui_caches: &mut HashMap<window::Id, user_interface::Cache>,
) where
    C: Compositor<Renderer = A::Renderer> + 'static,
    <A::Renderer as core::Renderer>::Theme: StyleSheet,
{
    for message in messages.drain(..) {
        debug.log_message(&message);
        debug.update_started();

        let command = runtime.enter(|| application.update(message));
        debug.update_finished();

        run_command(
            application,
            compositor,
            command,
            runtime,
            clipboard,
            control_sender,
            proxy,
            debug,
            window_manager,
            ui_caches,
        );
    }

    let subscription = application.subscription();
    runtime.track(subscription.into_recipes());
}

/// Runs the actions of a [`Command`].
fn run_command<A, C, E>(
    application: &A,
    compositor: &mut C,
    command: Command<A::Message>,
    runtime: &mut Runtime<E, Proxy<A::Message>, A::Message>,
    clipboard: &mut Clipboard,
    control_sender: &mut mpsc::UnboundedSender<Control>,
    proxy: &mut winit::event_loop::EventLoopProxy<A::Message>,
    debug: &mut Debug,
    window_manager: &mut WindowManager<A, C>,
    ui_caches: &mut HashMap<window::Id, user_interface::Cache>,
) where
    A: Application,
    E: Executor,
    C: Compositor<Renderer = A::Renderer> + 'static,
    <A::Renderer as core::Renderer>::Theme: StyleSheet,
{
    use crate::runtime::clipboard;
    use crate::runtime::system;
    use crate::runtime::window;

    for action in command.actions() {
        match action {
            command::Action::Future(future) => {
                runtime.spawn(Box::pin(future));
            }
            command::Action::Stream(stream) => {
                runtime.run(Box::pin(stream));
            }
            command::Action::Clipboard(action) => match action {
                clipboard::Action::Read(tag) => {
                    let message = tag(clipboard.read());

                    proxy
                        .send_event(message)
                        .expect("Send message to event loop");
                }
                clipboard::Action::Write(contents) => {
                    clipboard.write(contents);
                }
            },
            command::Action::Window(action) => match action {
                window::Action::Spawn(id, settings) => {
                    let monitor = window_manager.last_monitor();

                    control_sender
                        .start_send(Control::CreateWindow {
                            id,
                            settings,
                            title: application.title(id),
                            monitor,
                        })
                        .expect("Send control action");
                }
                window::Action::Close(id) => {
                    let _ = window_manager.remove(id);
                    let _ = ui_caches.remove(&id);

                    if window_manager.is_empty() {
                        control_sender
                            .start_send(Control::Exit)
                            .expect("Send control action");
                    }
                }
                window::Action::Drag(id) => {
                    if let Some(window) = window_manager.get_mut(id) {
                        let _ = window.raw.drag_window();
                    }
                }
                window::Action::Resize(id, size) => {
                    if let Some(window) = window_manager.get_mut(id) {
                        let _ = window.raw.request_inner_size(
                            winit::dpi::LogicalSize {
                                width: size.width,
                                height: size.height,
                            },
                        );
                    }
                }
                window::Action::FetchSize(id, callback) => {
                    if let Some(window) = window_manager.get_mut(id) {
                        let size = window
                            .raw
                            .inner_size()
                            .to_logical(window.raw.scale_factor());

                        proxy
                            .send_event(callback(Size::new(
                                size.width,
                                size.height,
                            )))
                            .expect("Send message to event loop");
                    }
                }
                window::Action::Maximize(id, maximized) => {
                    if let Some(window) = window_manager.get_mut(id) {
                        window.raw.set_maximized(maximized);
                    }
                }
                window::Action::Minimize(id, minimized) => {
                    if let Some(window) = window_manager.get_mut(id) {
                        window.raw.set_minimized(minimized);
                    }
                }
                window::Action::Move(id, position) => {
                    if let Some(window) = window_manager.get_mut(id) {
                        window.raw.set_outer_position(
                            winit::dpi::LogicalPosition {
                                x: position.x,
                                y: position.y,
                            },
                        );
                    }
                }
                window::Action::ChangeMode(id, mode) => {
                    if let Some(window) = window_manager.get_mut(id) {
                        window.raw.set_visible(conversion::visible(mode));
                        window.raw.set_fullscreen(conversion::fullscreen(
                            window.raw.current_monitor(),
                            mode,
                        ));
                    }
                }
                window::Action::ChangeIcon(id, icon) => {
                    if let Some(window) = window_manager.get_mut(id) {
                        window.raw.set_window_icon(conversion::icon(icon));
                    }
                }
                window::Action::FetchMode(id, tag) => {
                    if let Some(window) = window_manager.get_mut(id) {
                        let mode = if window.raw.is_visible().unwrap_or(true) {
                            conversion::mode(window.raw.fullscreen())
                        } else {
                            core::window::Mode::Hidden
                        };

                        proxy
                            .send_event(tag(mode))
                            .expect("Event loop doesn't exist.");
                    }
                }
                window::Action::ToggleMaximize(id) => {
                    if let Some(window) = window_manager.get_mut(id) {
                        window.raw.set_maximized(!window.raw.is_maximized());
                    }
                }
                window::Action::ToggleDecorations(id) => {
                    if let Some(window) = window_manager.get_mut(id) {
                        window.raw.set_decorations(!window.raw.is_decorated());
                    }
                }
                window::Action::RequestUserAttention(id, attention_type) => {
                    if let Some(window) = window_manager.get_mut(id) {
                        window.raw.request_user_attention(
                            attention_type.map(conversion::user_attention),
                        );
                    }
                }
                window::Action::GainFocus(id) => {
                    if let Some(window) = window_manager.get_mut(id) {
                        window.raw.focus_window();
                    }
                }
                window::Action::ChangeLevel(id, level) => {
                    if let Some(window) = window_manager.get_mut(id) {
                        window
                            .raw
                            .set_window_level(conversion::window_level(level));
                    }
                }
                window::Action::FetchId(id, tag) => {
                    if let Some(window) = window_manager.get_mut(id) {
                        proxy
                            .send_event(tag(window.raw.id().into()))
                            .expect("Event loop doesn't exist.");
                    }
                }
                window::Action::Screenshot(id, tag) => {
                    if let Some(window) = window_manager.get_mut(id) {
                        let bytes = compositor.screenshot(
                            &mut window.renderer,
                            &mut window.surface,
                            window.state.viewport(),
                            window.state.background_color(),
                            &debug.overlay(),
                        );

                        proxy
                            .send_event(tag(window::Screenshot::new(
                                bytes,
                                window.state.physical_size(),
                            )))
                            .expect("Event loop doesn't exist.");
                    }
                }
            },
            command::Action::System(action) => match action {
                system::Action::QueryInformation(_tag) => {
                    #[cfg(feature = "system")]
                    {
                        let graphics_info = compositor.fetch_information();
                        let proxy = proxy.clone();

                        let _ = std::thread::spawn(move || {
                            let information =
                                crate::system::information(graphics_info);

                            let message = _tag(information);

                            proxy
                                .send_event(message)
                                .expect("Event loop doesn't exist.");
                        });
                    }
                }
            },
            command::Action::Widget(action) => {
                let mut current_operation = Some(action);

                let mut uis = build_user_interfaces(
                    application,
                    debug,
                    window_manager,
                    std::mem::take(ui_caches),
                );

                'operate: while let Some(mut operation) =
                    current_operation.take()
                {
                    for (id, ui) in uis.iter_mut() {
                        if let Some(window) = window_manager.get_mut(*id) {
                            ui.operate(&window.renderer, operation.as_mut());

                            match operation.finish() {
                                operation::Outcome::None => {}
                                operation::Outcome::Some(message) => {
                                    proxy
                                        .send_event(message)
                                        .expect("Event loop doesn't exist.");

                                    // operation completed, don't need to try to operate on rest of UIs
                                    break 'operate;
                                }
                                operation::Outcome::Chain(next) => {
                                    current_operation = Some(next);
                                }
                            }
                        }
                    }
                }

                *ui_caches =
                    uis.drain().map(|(id, ui)| (id, ui.into_cache())).collect();
            }
            command::Action::LoadFont { bytes, tagger } => {
                use crate::core::text::Renderer;

                // TODO change this once we change each renderer to having a single backend reference.. :pain:
                // TODO: Error handling (?)
                for (_, window) in window_manager.iter_mut() {
                    window.renderer.load_font(bytes.clone());
                }

                proxy
                    .send_event(tagger(Ok(())))
                    .expect("Send message to event loop");
            }
        }
    }
}

/// Build the user interface for every window.
pub fn build_user_interfaces<'a, A: Application, C: Compositor>(
    application: &'a A,
    debug: &mut Debug,
    window_manager: &mut WindowManager<A, C>,
    mut cached_user_interfaces: HashMap<window::Id, user_interface::Cache>,
) -> HashMap<window::Id, UserInterface<'a, A::Message, A::Renderer>>
where
    <A::Renderer as core::Renderer>::Theme: StyleSheet,
    C: Compositor<Renderer = A::Renderer>,
{
    cached_user_interfaces
        .drain()
        .filter_map(|(id, cache)| {
            let window = window_manager.get_mut(id)?;

            Some((
                id,
                build_user_interface(
                    application,
                    cache,
                    &mut window.renderer,
                    window.state.logical_size(),
                    debug,
                    id,
                ),
            ))
        })
        .collect()
}

/// Returns true if the provided event should cause an [`Application`] to
/// exit.
pub fn user_force_quit(
    event: &winit::event::WindowEvent,
    _modifiers: winit::keyboard::ModifiersState,
) -> bool {
    match event {
        #[cfg(target_os = "macos")]
        winit::event::WindowEvent::KeyboardInput {
            event:
                winit::event::KeyEvent {
                    logical_key: winit::keyboard::Key::Character(c),
                    state: winit::event::ElementState::Pressed,
                    ..
                },
            ..
        } if c == "q" && _modifiers.super_key() => true,
        _ => false,
    }
}