// This file was generated by gir (https://github.com/gtk-rs/gir)
// from gir-files (https://github.com/gtk-rs/gir-files)
// DO NOT EDIT

use glib;
use glib::object::Cast;
use glib::object::IsA;
use glib::signal::connect_raw;
use glib::signal::SignalHandlerId;
use glib::translate::*;
use glib_sys;
use gst;
use gst_gl_sys;
use std::boxed::Box as Box_;
use std::mem::transmute;
use std::ptr;
use GLContext;
use GLDisplayType;
use GLWindow;
use GLAPI;

glib_wrapper! {
    /// `GLDisplay` represents a connection to the underlying windowing system.
    /// Elements are required to make use of `gst::Context` to share and propogate
    /// a `GLDisplay`.
    ///
    /// There are a number of environment variables that influence the choice of
    /// platform and window system specific functionality.
    /// - GST_GL_WINDOW influences the window system to use. Common values are
    ///  'x11', 'wayland', 'win32' or 'cocoa'.
    /// - GST_GL_PLATFORM influences the OpenGL platform to use. Common values are
    ///  'egl', 'glx', 'wgl' or 'cgl'.
    /// - GST_GL_API influences the OpenGL API requested by the OpenGL platform.
    ///  Common values are 'opengl', 'opengl3' and 'gles2'.
    ///
    /// > Certain window systems require a special function to be called to
    /// > initialize threading support. As this GStreamer GL library does not preclude
    /// > concurrent access to the windowing system, it is strongly advised that
    /// > applications ensure that threading support has been initialized before any
    /// > other toolkit/library functionality is accessed. Failure to do so could
    /// > result in sudden application abortion during execution. The most notably
    /// > example of such a function is X11's XInitThreads\().
    ///
    /// # Implements
    ///
    /// [`GLDisplayExt`](trait.GLDisplayExt.html), [`gst::ObjectExt`](../gst/trait.ObjectExt.html), [`glib::object::ObjectExt`](../glib/object/trait.ObjectExt.html)
    pub struct GLDisplay(Object<gst_gl_sys::GstGLDisplay, gst_gl_sys::GstGLDisplayClass, GLDisplayClass>) @extends gst::Object;

    match fn {
        get_type => || gst_gl_sys::gst_gl_display_get_type(),
    }
}

impl GLDisplay {
    ///
    /// # Returns
    ///
    /// a new `GLDisplay`
    pub fn new() -> GLDisplay {
        assert_initialized_main_thread!();
        unsafe { from_glib_full(gst_gl_sys::gst_gl_display_new()) }
    }
}

impl Default for GLDisplay {
    fn default() -> Self {
        Self::new()
    }
}

unsafe impl Send for GLDisplay {}
unsafe impl Sync for GLDisplay {}

pub const NONE_GL_DISPLAY: Option<&GLDisplay> = None;

/// Trait containing all `GLDisplay` methods.
///
/// # Implementors
///
/// [`GLDisplayEGL`](struct.GLDisplayEGL.html), [`GLDisplayWayland`](struct.GLDisplayWayland.html), [`GLDisplayX11`](struct.GLDisplayX11.html), [`GLDisplay`](struct.GLDisplay.html)
pub trait GLDisplayExt: 'static {
    /// ## `context`
    /// a `GLContext`
    ///
    /// # Returns
    ///
    /// whether `context` was successfully added. `false` may be returned
    /// if there already exists another context for `context`'s active thread.
    ///
    /// Must be called with the object lock held.
    fn add_context<P: IsA<GLContext>>(&self, context: &P) -> Result<(), glib::error::BoolError>;

    /// It requires the display's object lock to be held.
    /// ## `other_context`
    /// other `GLContext` to share resources with.
    /// ## `p_context`
    /// resulting `GLContext`
    ///
    /// # Returns
    ///
    /// whether a new context could be created.
    fn create_context<P: IsA<GLContext>>(
        &self,
        other_context: &P,
    ) -> Result<GLContext, glib::Error>;

    /// It requires the display's object lock to be held.
    ///
    /// # Returns
    ///
    /// a new `GLWindow` for `self` or `None`.
    fn create_window(&self) -> Result<GLWindow, glib::BoolError>;

    /// limit the use of OpenGL to the requested `gl_api`. This is intended to allow
    /// application and elements to request a specific set of OpenGL API's based on
    /// what they support. See `GLContextExt::get_gl_api` for the retreiving the
    /// API supported by a `GLContext`.
    /// ## `gl_api`
    /// a `GLAPI` to filter with
    fn filter_gl_api(&self, gl_api: GLAPI);

    /// see `GLDisplayExt::filter_gl_api` for what the returned value represents
    ///
    /// # Returns
    ///
    /// the `GLAPI` configured for `self`
    fn get_gl_api(&self) -> GLAPI;

    fn get_gl_api_unlocked(&self) -> GLAPI;

    ///
    /// # Returns
    ///
    /// the `GLDisplayType` of `self`
    fn get_handle_type(&self) -> GLDisplayType;

    /// ## `window`
    /// a `GLWindow` to remove
    ///
    /// # Returns
    ///
    /// if `window` could be removed from `self`
    fn remove_window<P: IsA<GLWindow>>(&self, window: &P) -> Result<(), glib::error::BoolError>;

    /// Overrides the `GLContext` creation mechanism.
    /// It can be called in any thread and it is emitted with
    /// display's object lock held.
    /// ## `context`
    /// other context to share resources with.
    ///
    /// # Returns
    ///
    /// the new context.
    fn connect_create_context<F: Fn(&Self, &GLContext) -> GLContext + Send + Sync + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId;
}

impl<O: IsA<GLDisplay>> GLDisplayExt for O {
    fn add_context<P: IsA<GLContext>>(&self, context: &P) -> Result<(), glib::error::BoolError> {
        unsafe {
            glib_result_from_gboolean!(
                gst_gl_sys::gst_gl_display_add_context(
                    self.as_ref().to_glib_none().0,
                    context.as_ref().to_glib_none().0
                ),
                "Failed to add OpenGL context"
            )
        }
    }

    fn create_context<P: IsA<GLContext>>(
        &self,
        other_context: &P,
    ) -> Result<GLContext, glib::Error> {
        unsafe {
            let mut p_context = ptr::null_mut();
            let mut error = ptr::null_mut();
            let _ = gst_gl_sys::gst_gl_display_create_context(
                self.as_ref().to_glib_none().0,
                other_context.as_ref().to_glib_none().0,
                &mut p_context,
                &mut error,
            );
            if error.is_null() {
                Ok(from_glib_full(p_context))
            } else {
                Err(from_glib_full(error))
            }
        }
    }

    fn create_window(&self) -> Result<GLWindow, glib::BoolError> {
        unsafe {
            Option::<_>::from_glib_full(gst_gl_sys::gst_gl_display_create_window(
                self.as_ref().to_glib_none().0,
            ))
            .ok_or_else(|| glib_bool_error!("Failed to create window"))
        }
    }

    fn filter_gl_api(&self, gl_api: GLAPI) {
        unsafe {
            gst_gl_sys::gst_gl_display_filter_gl_api(
                self.as_ref().to_glib_none().0,
                gl_api.to_glib(),
            );
        }
    }

    fn get_gl_api(&self) -> GLAPI {
        unsafe {
            from_glib(gst_gl_sys::gst_gl_display_get_gl_api(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    fn get_gl_api_unlocked(&self) -> GLAPI {
        unsafe {
            from_glib(gst_gl_sys::gst_gl_display_get_gl_api_unlocked(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    fn get_handle_type(&self) -> GLDisplayType {
        unsafe {
            from_glib(gst_gl_sys::gst_gl_display_get_handle_type(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    fn remove_window<P: IsA<GLWindow>>(&self, window: &P) -> Result<(), glib::error::BoolError> {
        unsafe {
            glib_result_from_gboolean!(
                gst_gl_sys::gst_gl_display_remove_window(
                    self.as_ref().to_glib_none().0,
                    window.as_ref().to_glib_none().0
                ),
                "Failed to remove window"
            )
        }
    }

    fn connect_create_context<F: Fn(&Self, &GLContext) -> GLContext + Send + Sync + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn create_context_trampoline<
            P,
            F: Fn(&P, &GLContext) -> GLContext + Send + Sync + 'static,
        >(
            this: *mut gst_gl_sys::GstGLDisplay,
            context: *mut gst_gl_sys::GstGLContext,
            f: glib_sys::gpointer,
        ) -> *mut gst_gl_sys::GstGLContext
        where
            P: IsA<GLDisplay>,
        {
            let f: &F = &*(f as *const F);
            f(
                &GLDisplay::from_glib_borrow(this).unsafe_cast(),
                &from_glib_borrow(context),
            )
            .to_glib_full()
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"create-context\0".as_ptr() as *const _,
                Some(transmute(create_context_trampoline::<Self, F> as usize)),
                Box_::into_raw(f),
            )
        }
    }
}