wl-proxy 0.1.2

//! create ivi-style surfaces
//!
//! This interface is exposed as a global singleton.
//! This interface is implemented by servers that provide IVI-style user interfaces.
//! It allows clients to associate an ivi_surface with wl_surface.

use crate::protocol_helpers::prelude::*;
use super::super::all_types::*;

/// A ivi_application object.
///
/// See the documentation of [the module][self] for the interface description.
pub struct IviApplication {
    core: ObjectCore,
    handler: HandlerHolder<dyn IviApplicationHandler>,
}

struct DefaultHandler;

impl IviApplicationHandler for DefaultHandler { }

impl ConcreteObject for IviApplication {
    const XML_VERSION: u32 = 1;
    const INTERFACE: ObjectInterface = ObjectInterface::IviApplication;
    const INTERFACE_NAME: &str = "ivi_application";
}

impl IviApplication {
    /// Sets a new handler.
    pub fn set_handler(&self, handler: impl IviApplicationHandler) {
        self.set_boxed_handler(Box::new(handler));
    }

    /// Sets a new, already boxed handler.
    pub fn set_boxed_handler(&self, handler: Box<dyn IviApplicationHandler>) {
        if self.core.state.destroyed.get() {
            return;
        }
        self.handler.set(Some(handler));
    }
}

impl Debug for IviApplication {
    fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
        f.debug_struct("IviApplication")
            .field("server_obj_id", &self.core.server_obj_id.get())
            .field("client_id", &self.core.client_id.get())
            .field("client_obj_id", &self.core.client_obj_id.get())
            .finish()
    }
}

impl IviApplication {
    /// Since when the surface_create message is available.
    pub const MSG__SURFACE_CREATE__SINCE: u32 = 1;

    /// create ivi_surface with numeric ID in ivi compositor
    ///
    /// This request gives the wl_surface the role of an IVI Surface. Creating more than
    /// one ivi_surface for a wl_surface is not allowed. Note, that this still allows the
    /// following example:
    ///
    ///  1. create a wl_surface
    ///  2. create ivi_surface for the wl_surface
    ///  3. destroy the ivi_surface
    ///  4. create ivi_surface for the wl_surface (with the same or another ivi_id as before)
    ///
    /// surface_create will create an interface:ivi_surface with numeric ID; ivi_id in
    /// ivi compositor. These ivi_ids are defined as unique in the system to identify
    /// it inside of ivi compositor. The ivi compositor implements business logic how to
    /// set properties of the surface with ivi_id according to the status of the system.
    /// E.g. a unique ID for Car Navigation application is used for implementing special
    /// logic of the application about where it shall be located.
    /// The server regards the following cases as protocol errors and disconnects the client.
    ///  - wl_surface already has another role.
    ///  - ivi_id is already assigned to another wl_surface.
    ///
    /// If client destroys ivi_surface or wl_surface which is assigned to the ivi_surface,
    /// ivi_id which is assigned to the ivi_surface is free for reuse.
    ///
    /// # Arguments
    ///
    /// - `ivi_id`:
    /// - `surface`:
    /// - `id`:
    #[inline]
    pub fn try_send_surface_create(
        &self,
        ivi_id: u32,
        surface: &Rc<WlSurface>,
        id: &Rc<IviSurface>,
    ) -> Result<(), ObjectError> {
        let (
            arg0,
            arg1,
            arg2,
        ) = (
            ivi_id,
            surface,
            id,
        );
        let arg1 = arg1.core();
        let arg2_obj = arg2;
        let arg2 = arg2_obj.core();
        let core = self.core();
        let Some(id) = core.server_obj_id.get() else {
            return Err(ObjectError(ObjectErrorKind::ReceiverNoServerId));
        };
        let arg1_id = match arg1.server_obj_id.get() {
            None => return Err(ObjectError(ObjectErrorKind::ArgNoServerId("surface"))),
            Some(id) => id,
        };
        arg2.generate_server_id(arg2_obj.clone())
            .map_err(|e| ObjectError(ObjectErrorKind::GenerateServerId("id", e)))?;
        let arg2_id = arg2.server_obj_id.get().unwrap_or(0);
        #[cfg(feature = "logging")]
        if self.core.state.log {
            #[cold]
            fn log(state: &State, id: u32, arg0: u32, arg1: u32, arg2: u32) {
                let (millis, micros) = time_since_epoch();
                let prefix = &state.log_prefix;
                let args = format_args!("[{millis:7}.{micros:03}] {prefix}server      <= ivi_application#{}.surface_create(ivi_id: {}, surface: wl_surface#{}, id: ivi_surface#{})\n", id, arg0, arg1, arg2);
                state.log(args);
            }
            log(&self.core.state, id, arg0, arg1_id, arg2_id);
        }
        let Some(endpoint) = &self.core.state.server else {
            return Ok(());
        };
        if !endpoint.flush_queued.replace(true) {
            self.core.state.add_flushable_endpoint(endpoint, None);
        }
        let mut outgoing_ref = endpoint.outgoing.borrow_mut();
        let outgoing = &mut *outgoing_ref;
        let mut fmt = outgoing.formatter();
        fmt.words([
            id,
            0,
            arg0,
            arg1_id,
            arg2_id,
        ]);
        Ok(())
    }

    /// create ivi_surface with numeric ID in ivi compositor
    ///
    /// This request gives the wl_surface the role of an IVI Surface. Creating more than
    /// one ivi_surface for a wl_surface is not allowed. Note, that this still allows the
    /// following example:
    ///
    ///  1. create a wl_surface
    ///  2. create ivi_surface for the wl_surface
    ///  3. destroy the ivi_surface
    ///  4. create ivi_surface for the wl_surface (with the same or another ivi_id as before)
    ///
    /// surface_create will create an interface:ivi_surface with numeric ID; ivi_id in
    /// ivi compositor. These ivi_ids are defined as unique in the system to identify
    /// it inside of ivi compositor. The ivi compositor implements business logic how to
    /// set properties of the surface with ivi_id according to the status of the system.
    /// E.g. a unique ID for Car Navigation application is used for implementing special
    /// logic of the application about where it shall be located.
    /// The server regards the following cases as protocol errors and disconnects the client.
    ///  - wl_surface already has another role.
    ///  - ivi_id is already assigned to another wl_surface.
    ///
    /// If client destroys ivi_surface or wl_surface which is assigned to the ivi_surface,
    /// ivi_id which is assigned to the ivi_surface is free for reuse.
    ///
    /// # Arguments
    ///
    /// - `ivi_id`:
    /// - `surface`:
    /// - `id`:
    #[inline]
    pub fn send_surface_create(
        &self,
        ivi_id: u32,
        surface: &Rc<WlSurface>,
        id: &Rc<IviSurface>,
    ) {
        let res = self.try_send_surface_create(
            ivi_id,
            surface,
            id,
        );
        if let Err(e) = res {
            log_send("ivi_application.surface_create", &e);
        }
    }

    /// create ivi_surface with numeric ID in ivi compositor
    ///
    /// This request gives the wl_surface the role of an IVI Surface. Creating more than
    /// one ivi_surface for a wl_surface is not allowed. Note, that this still allows the
    /// following example:
    ///
    ///  1. create a wl_surface
    ///  2. create ivi_surface for the wl_surface
    ///  3. destroy the ivi_surface
    ///  4. create ivi_surface for the wl_surface (with the same or another ivi_id as before)
    ///
    /// surface_create will create an interface:ivi_surface with numeric ID; ivi_id in
    /// ivi compositor. These ivi_ids are defined as unique in the system to identify
    /// it inside of ivi compositor. The ivi compositor implements business logic how to
    /// set properties of the surface with ivi_id according to the status of the system.
    /// E.g. a unique ID for Car Navigation application is used for implementing special
    /// logic of the application about where it shall be located.
    /// The server regards the following cases as protocol errors and disconnects the client.
    ///  - wl_surface already has another role.
    ///  - ivi_id is already assigned to another wl_surface.
    ///
    /// If client destroys ivi_surface or wl_surface which is assigned to the ivi_surface,
    /// ivi_id which is assigned to the ivi_surface is free for reuse.
    ///
    /// # Arguments
    ///
    /// - `ivi_id`:
    /// - `surface`:
    #[inline]
    pub fn new_try_send_surface_create(
        &self,
        ivi_id: u32,
        surface: &Rc<WlSurface>,
    ) -> Result<Rc<IviSurface>, ObjectError> {
        let id = self.core.create_child();
        self.try_send_surface_create(
            ivi_id,
            surface,
            &id,
        )?;
        Ok(id)
    }

    /// create ivi_surface with numeric ID in ivi compositor
    ///
    /// This request gives the wl_surface the role of an IVI Surface. Creating more than
    /// one ivi_surface for a wl_surface is not allowed. Note, that this still allows the
    /// following example:
    ///
    ///  1. create a wl_surface
    ///  2. create ivi_surface for the wl_surface
    ///  3. destroy the ivi_surface
    ///  4. create ivi_surface for the wl_surface (with the same or another ivi_id as before)
    ///
    /// surface_create will create an interface:ivi_surface with numeric ID; ivi_id in
    /// ivi compositor. These ivi_ids are defined as unique in the system to identify
    /// it inside of ivi compositor. The ivi compositor implements business logic how to
    /// set properties of the surface with ivi_id according to the status of the system.
    /// E.g. a unique ID for Car Navigation application is used for implementing special
    /// logic of the application about where it shall be located.
    /// The server regards the following cases as protocol errors and disconnects the client.
    ///  - wl_surface already has another role.
    ///  - ivi_id is already assigned to another wl_surface.
    ///
    /// If client destroys ivi_surface or wl_surface which is assigned to the ivi_surface,
    /// ivi_id which is assigned to the ivi_surface is free for reuse.
    ///
    /// # Arguments
    ///
    /// - `ivi_id`:
    /// - `surface`:
    #[inline]
    pub fn new_send_surface_create(
        &self,
        ivi_id: u32,
        surface: &Rc<WlSurface>,
    ) -> Rc<IviSurface> {
        let id = self.core.create_child();
        self.send_surface_create(
            ivi_id,
            surface,
            &id,
        );
        id
    }
}

/// A message handler for [`IviApplication`] proxies.
pub trait IviApplicationHandler: Any {
    /// Event handler for wl_display.delete_id messages deleting the ID of this object.
    ///
    /// The default handler forwards the event to the client, if any.
    #[inline]
    fn delete_id(&mut self, slf: &Rc<IviApplication>) {
        slf.core.delete_id();
    }

    /// create ivi_surface with numeric ID in ivi compositor
    ///
    /// This request gives the wl_surface the role of an IVI Surface. Creating more than
    /// one ivi_surface for a wl_surface is not allowed. Note, that this still allows the
    /// following example:
    ///
    ///  1. create a wl_surface
    ///  2. create ivi_surface for the wl_surface
    ///  3. destroy the ivi_surface
    ///  4. create ivi_surface for the wl_surface (with the same or another ivi_id as before)
    ///
    /// surface_create will create an interface:ivi_surface with numeric ID; ivi_id in
    /// ivi compositor. These ivi_ids are defined as unique in the system to identify
    /// it inside of ivi compositor. The ivi compositor implements business logic how to
    /// set properties of the surface with ivi_id according to the status of the system.
    /// E.g. a unique ID for Car Navigation application is used for implementing special
    /// logic of the application about where it shall be located.
    /// The server regards the following cases as protocol errors and disconnects the client.
    ///  - wl_surface already has another role.
    ///  - ivi_id is already assigned to another wl_surface.
    ///
    /// If client destroys ivi_surface or wl_surface which is assigned to the ivi_surface,
    /// ivi_id which is assigned to the ivi_surface is free for reuse.
    ///
    /// # Arguments
    ///
    /// - `ivi_id`:
    /// - `surface`:
    /// - `id`:
    ///
    /// All borrowed proxies passed to this function are guaranteed to be
    /// immutable and non-null.
    #[inline]
    fn handle_surface_create(
        &mut self,
        slf: &Rc<IviApplication>,
        ivi_id: u32,
        surface: &Rc<WlSurface>,
        id: &Rc<IviSurface>,
    ) {
        if !slf.core.forward_to_server.get() {
            return;
        }
        let res = slf.try_send_surface_create(
            ivi_id,
            surface,
            id,
        );
        if let Err(e) = res {
            log_forward("ivi_application.surface_create", &e);
        }
    }
}

impl ObjectPrivate for IviApplication {
    fn new(state: &Rc<State>, version: u32) -> Rc<Self> {
        Rc::<Self>::new_cyclic(|slf| Self {
            core: ObjectCore::new(state, slf.clone(), ObjectInterface::IviApplication, version),
            handler: Default::default(),
        })
    }

    fn delete_id(self: Rc<Self>) -> Result<(), (ObjectError, Rc<dyn Object>)> {
        let Some(mut handler) = self.handler.try_borrow_mut() else {
            return Err((ObjectError(ObjectErrorKind::HandlerBorrowed), self));
        };
        if let Some(handler) = &mut *handler {
            handler.delete_id(&self);
        } else {
            self.core.delete_id();
        }
        Ok(())
    }

    fn handle_request(self: Rc<Self>, client: &Rc<Client>, msg: &[u32], fds: &mut VecDeque<Rc<OwnedFd>>) -> Result<(), ObjectError> {
        let Some(mut handler) = self.handler.try_borrow_mut() else {
            return Err(ObjectError(ObjectErrorKind::HandlerBorrowed));
        };
        let handler = &mut *handler;
        match msg[1] & 0xffff {
            0 => {
                let [
                    arg0,
                    arg1,
                    arg2,
                ] = msg[2..] else {
                    return Err(ObjectError(ObjectErrorKind::WrongMessageSize(msg.len() as u32 * 4, 20)));
                };
                #[cfg(feature = "logging")]
                if self.core.state.log {
                    #[cold]
                    fn log(state: &State, client_id: u64, id: u32, arg0: u32, arg1: u32, arg2: u32) {
                        let (millis, micros) = time_since_epoch();
                        let prefix = &state.log_prefix;
                        let args = format_args!("[{millis:7}.{micros:03}] {prefix}client#{:<4} -> ivi_application#{}.surface_create(ivi_id: {}, surface: wl_surface#{}, id: ivi_surface#{})\n", client_id, id, arg0, arg1, arg2);
                        state.log(args);
                    }
                    log(&self.core.state, client.endpoint.id, msg[0], arg0, arg1, arg2);
                }
                let arg1_id = arg1;
                let Some(arg1) = client.endpoint.lookup(arg1_id) else {
                    return Err(ObjectError(ObjectErrorKind::NoClientObject(client.endpoint.id, arg1_id)));
                };
                let Ok(arg1) = (arg1 as Rc<dyn Any>).downcast::<WlSurface>() else {
                    let o = client.endpoint.lookup(arg1_id).unwrap();
                    return Err(ObjectError(ObjectErrorKind::WrongObjectType("surface", o.core().interface, ObjectInterface::WlSurface)));
                };
                let arg2_id = arg2;
                let arg2 = IviSurface::new(&self.core.state, self.core.version);
                arg2.core().set_client_id(client, arg2_id, arg2.clone())
                    .map_err(|e| ObjectError(ObjectErrorKind::SetClientId(arg2_id, "id", e)))?;
                let arg1 = &arg1;
                let arg2 = &arg2;
                if let Some(handler) = handler {
                    (**handler).handle_surface_create(&self, arg0, arg1, arg2);
                } else {
                    DefaultHandler.handle_surface_create(&self, arg0, arg1, arg2);
                }
            }
            n => {
                let _ = client;
                let _ = msg;
                let _ = fds;
                let _ = handler;
                return Err(ObjectError(ObjectErrorKind::UnknownMessageId(n)));
            }
        }
        Ok(())
    }

    fn handle_event(self: Rc<Self>, server: &Endpoint, msg: &[u32], fds: &mut VecDeque<Rc<OwnedFd>>) -> Result<(), ObjectError> {
        let Some(mut handler) = self.handler.try_borrow_mut() else {
            return Err(ObjectError(ObjectErrorKind::HandlerBorrowed));
        };
        let handler = &mut *handler;
        match msg[1] & 0xffff {
            n => {
                let _ = server;
                let _ = msg;
                let _ = fds;
                let _ = handler;
                return Err(ObjectError(ObjectErrorKind::UnknownMessageId(n)));
            }
        }
    }

    fn get_request_name(&self, id: u32) -> Option<&'static str> {
        let name = match id {
            0 => "surface_create",
            _ => return None,
        };
        Some(name)
    }

    fn get_event_name(&self, id: u32) -> Option<&'static str> {
        let _ = id;
        None
    }
}

impl Object for IviApplication {
    fn core(&self) -> &ObjectCore {
        &self.core
    }

    fn unset_handler(&self) {
        self.handler.set(None);
    }

    fn get_handler_any_ref(&self) -> Result<HandlerRef<'_, dyn Any>, HandlerAccessError> {
        let borrowed = self.handler.try_borrow().ok_or(HandlerAccessError::AlreadyBorrowed)?;
        if borrowed.is_none() {
            return Err(HandlerAccessError::NoHandler);
        }
        Ok(HandlerRef::map(borrowed, |handler| &**handler.as_ref().unwrap() as &dyn Any))
    }

    fn get_handler_any_mut(&self) -> Result<HandlerMut<'_, dyn Any>, HandlerAccessError> {
        let borrowed = self.handler.try_borrow_mut().ok_or(HandlerAccessError::AlreadyBorrowed)?;
        if borrowed.is_none() {
            return Err(HandlerAccessError::NoHandler);
        }
        Ok(HandlerMut::map(borrowed, |handler| &mut **handler.as_mut().unwrap() as &mut dyn Any))
    }
}

impl IviApplication {
    /// Since when the error.role enum variant is available.
    pub const ENM__ERROR_ROLE__SINCE: u32 = 1;
    /// Since when the error.ivi_id enum variant is available.
    pub const ENM__ERROR_IVI_ID__SINCE: u32 = 1;
}

#[derive(Copy, Clone, Eq, PartialEq, Ord, PartialOrd, Hash)]
pub struct IviApplicationError(pub u32);

impl IviApplicationError {
    /// given wl_surface has another role
    pub const ROLE: Self = Self(0);

    /// given ivi_id is assigned to another wl_surface
    pub const IVI_ID: Self = Self(1);
}

impl Debug for IviApplicationError {
    fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
        let name = match *self {
            Self::ROLE => "ROLE",
            Self::IVI_ID => "IVI_ID",
            _ => return Debug::fmt(&self.0, f),
        };
        f.write_str(name)
    }
}