// 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::object::Cast;
use glib::object::IsA;
use glib::signal::connect_raw;
use glib::signal::SignalHandlerId;
use glib::translate::*;
use glib_sys;
use gst_sys;
use std::boxed::Box as Box_;
use std::mem::transmute;
use Bin;
use ChildProxy;
use Clock;
use ClockTime;
use Element;
use Object;

glib_wrapper! {
    /// A `Pipeline` is a special `Bin` used as the toplevel container for
    /// the filter graph. The `Pipeline` will manage the selection and
    /// distribution of a global `Clock` as well as provide a `Bus` to the
    /// application.
    ///
    /// `Pipeline::new` is used to create a pipeline. when you are done with
    /// the pipeline, use `GstObjectExt::unref` to free its resources including all
    /// added `Element` objects (if not otherwise referenced).
    ///
    /// Elements are added and removed from the pipeline using the `Bin`
    /// methods like `GstBinExt::add` and `GstBinExt::remove` (see `Bin`).
    ///
    /// Before changing the state of the `Pipeline` (see `Element`) a `Bus`
    /// can be retrieved with `Pipeline::get_bus`. This bus can then be
    /// used to receive `Message` from the elements in the pipeline.
    ///
    /// By default, a `Pipeline` will automatically flush the pending `Bus`
    /// messages when going to the NULL state to ensure that no circular
    /// references exist when no messages are read from the `Bus`. This
    /// behaviour can be changed with `PipelineExt::set_auto_flush_bus`.
    ///
    /// When the `Pipeline` performs the PAUSED to PLAYING state change it will
    /// select a clock for the elements. The clock selection algorithm will by
    /// default select a clock provided by an element that is most upstream
    /// (closest to the source). For live pipelines (ones that return
    /// `StateChangeReturn::NoPreroll` from the `Element::set_state` call) this
    /// will select the clock provided by the live source. For normal pipelines
    /// this will select a clock provided by the sinks (most likely the audio
    /// sink). If no element provides a clock, a default `SystemClock` is used.
    ///
    /// The clock selection can be controlled with the `PipelineExt::use_clock`
    /// method, which will enforce a given clock on the pipeline. With
    /// `PipelineExt::auto_clock` the default clock selection algorithm can be
    /// restored.
    ///
    /// A `Pipeline` maintains a running time for the elements. The running
    /// time is defined as the difference between the current clock time and
    /// the base time. When the pipeline goes to READY or a flushing seek is
    /// performed on it, the running time is reset to 0. When the pipeline is
    /// set from PLAYING to PAUSED, the current clock time is sampled and used to
    /// configure the base time for the elements when the pipeline is set
    /// to PLAYING again. The effect is that the running time (as the difference
    /// between the clock time and the base time) will count how much time was spent
    /// in the PLAYING state. This default behaviour can be changed with the
    /// `ElementExt::set_start_time` method.
    ///
    /// # Implements
    ///
    /// [`PipelineExt`](trait.PipelineExt.html), [`GstBinExt`](trait.GstBinExt.html), [`ElementExt`](trait.ElementExt.html), [`GstObjectExt`](trait.GstObjectExt.html), [`glib::object::ObjectExt`](../glib/object/trait.ObjectExt.html), [`ChildProxyExt`](trait.ChildProxyExt.html), [`ElementExtManual`](prelude/trait.ElementExtManual.html), [`ChildProxyExtManual`](prelude/trait.ChildProxyExtManual.html)
    pub struct Pipeline(Object<gst_sys::GstPipeline, gst_sys::GstPipelineClass, PipelineClass>) @extends Bin, Element, Object, @implements ChildProxy;

    match fn {
        get_type => || gst_sys::gst_pipeline_get_type(),
    }
}

impl Pipeline {
    /// Create a new pipeline with the given name.
    /// ## `name`
    /// name of new pipeline
    ///
    /// # Returns
    ///
    /// newly created GstPipeline
    ///
    /// MT safe.
    pub fn new(name: Option<&str>) -> Pipeline {
        assert_initialized_main_thread!();
        unsafe {
            Element::from_glib_none(gst_sys::gst_pipeline_new(name.to_glib_none().0)).unsafe_cast()
        }
    }
}

unsafe impl Send for Pipeline {}
unsafe impl Sync for Pipeline {}

pub const NONE_PIPELINE: Option<&Pipeline> = None;

/// Trait containing all `Pipeline` methods.
///
/// # Implementors
///
/// [`Pipeline`](struct.Pipeline.html)
pub trait PipelineExt: 'static {
    /// Let `self` select a clock automatically. This is the default
    /// behaviour.
    ///
    /// Use this function if you previous forced a fixed clock with
    /// `PipelineExt::use_clock` and want to restore the default
    /// pipeline clock selection algorithm.
    ///
    /// MT safe.
    fn auto_clock(&self);

    /// Check if `self` will automatically flush messages when going to
    /// the NULL state.
    ///
    /// # Returns
    ///
    /// whether the pipeline will automatically flush its bus when
    /// going from READY to NULL state or not.
    ///
    /// MT safe.
    fn get_auto_flush_bus(&self) -> bool;

    /// Get the configured delay (see `PipelineExt::set_delay`).
    ///
    /// # Returns
    ///
    /// The configured delay.
    ///
    /// MT safe.
    fn get_delay(&self) -> ClockTime;

    /// Gets the latency that should be configured on the pipeline. See
    /// `PipelineExt::set_latency`.
    ///
    /// # Returns
    ///
    /// Latency to configure on the pipeline or GST_CLOCK_TIME_NONE
    fn get_latency(&self) -> ClockTime;

    /// Gets the current clock used by `self`.
    ///
    /// Unlike `ElementExt::get_clock`, this function will always return a
    /// clock, even if the pipeline is not in the PLAYING state.
    ///
    /// # Returns
    ///
    /// a `Clock`, unref after usage.
    fn get_pipeline_clock(&self) -> Option<Clock>;

    /// Usually, when a pipeline goes from READY to NULL state, it automatically
    /// flushes all pending messages on the bus, which is done for refcounting
    /// purposes, to break circular references.
    ///
    /// This means that applications that update state using (async) bus messages
    /// (e.g. do certain things when a pipeline goes from PAUSED to READY) might
    /// not get to see messages when the pipeline is shut down, because they might
    /// be flushed before they can be dispatched in the main thread. This behaviour
    /// can be disabled using this function.
    ///
    /// It is important that all messages on the bus are handled when the
    /// automatic flushing is disabled else memory leaks will be introduced.
    ///
    /// MT safe.
    /// ## `auto_flush`
    /// whether or not to automatically flush the bus when
    /// the pipeline goes from READY to NULL state
    fn set_auto_flush_bus(&self, auto_flush: bool);

    /// Set the expected delay needed for all elements to perform the
    /// PAUSED to PLAYING state change. `delay` will be added to the
    /// base time of the elements so that they wait an additional `delay`
    /// amount of time before starting to process buffers and cannot be
    /// `GST_CLOCK_TIME_NONE`.
    ///
    /// This option is used for tuning purposes and should normally not be
    /// used.
    ///
    /// MT safe.
    /// ## `delay`
    /// the delay
    fn set_delay(&self, delay: ClockTime);

    /// Sets the latency that should be configured on the pipeline. Setting
    /// GST_CLOCK_TIME_NONE will restore the default behaviour of using the minimum
    /// latency from the LATENCY query. Setting this is usually not required and
    /// the pipeline will figure out an appropriate latency automatically.
    ///
    /// Setting a too low latency, especially lower than the minimum latency from
    /// the LATENCY query, will most likely cause the pipeline to fail.
    /// ## `latency`
    /// latency to configure
    fn set_latency(&self, latency: ClockTime);

    /// Force `self` to use the given `clock`. The pipeline will
    /// always use the given clock even if new clock providers are added
    /// to this pipeline.
    ///
    /// If `clock` is `None` all clocking will be disabled which will make
    /// the pipeline run as fast as possible.
    ///
    /// MT safe.
    /// ## `clock`
    /// the clock to use
    fn use_clock<P: IsA<Clock>>(&self, clock: Option<&P>);

    fn connect_property_auto_flush_bus_notify<F: Fn(&Self) + Send + Sync + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId;

    fn connect_property_delay_notify<F: Fn(&Self) + Send + Sync + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId;

    fn connect_property_latency_notify<F: Fn(&Self) + Send + Sync + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId;
}

impl<O: IsA<Pipeline>> PipelineExt for O {
    fn auto_clock(&self) {
        unsafe {
            gst_sys::gst_pipeline_auto_clock(self.as_ref().to_glib_none().0);
        }
    }

    fn get_auto_flush_bus(&self) -> bool {
        unsafe {
            from_glib(gst_sys::gst_pipeline_get_auto_flush_bus(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    fn get_delay(&self) -> ClockTime {
        unsafe {
            from_glib(gst_sys::gst_pipeline_get_delay(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    fn get_latency(&self) -> ClockTime {
        unsafe {
            from_glib(gst_sys::gst_pipeline_get_latency(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    fn get_pipeline_clock(&self) -> Option<Clock> {
        unsafe {
            from_glib_full(gst_sys::gst_pipeline_get_pipeline_clock(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    fn set_auto_flush_bus(&self, auto_flush: bool) {
        unsafe {
            gst_sys::gst_pipeline_set_auto_flush_bus(
                self.as_ref().to_glib_none().0,
                auto_flush.to_glib(),
            );
        }
    }

    fn set_delay(&self, delay: ClockTime) {
        unsafe {
            gst_sys::gst_pipeline_set_delay(self.as_ref().to_glib_none().0, delay.to_glib());
        }
    }

    fn set_latency(&self, latency: ClockTime) {
        unsafe {
            gst_sys::gst_pipeline_set_latency(self.as_ref().to_glib_none().0, latency.to_glib());
        }
    }

    fn use_clock<P: IsA<Clock>>(&self, clock: Option<&P>) {
        unsafe {
            gst_sys::gst_pipeline_use_clock(
                self.as_ref().to_glib_none().0,
                clock.map(|p| p.as_ref()).to_glib_none().0,
            );
        }
    }

    fn connect_property_auto_flush_bus_notify<F: Fn(&Self) + Send + Sync + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn notify_auto_flush_bus_trampoline<
            P,
            F: Fn(&P) + Send + Sync + 'static,
        >(
            this: *mut gst_sys::GstPipeline,
            _param_spec: glib_sys::gpointer,
            f: glib_sys::gpointer,
        ) where
            P: IsA<Pipeline>,
        {
            let f: &F = &*(f as *const F);
            f(&Pipeline::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::auto-flush-bus\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_auto_flush_bus_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    fn connect_property_delay_notify<F: Fn(&Self) + Send + Sync + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn notify_delay_trampoline<P, F: Fn(&P) + Send + Sync + 'static>(
            this: *mut gst_sys::GstPipeline,
            _param_spec: glib_sys::gpointer,
            f: glib_sys::gpointer,
        ) where
            P: IsA<Pipeline>,
        {
            let f: &F = &*(f as *const F);
            f(&Pipeline::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::delay\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_delay_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    fn connect_property_latency_notify<F: Fn(&Self) + Send + Sync + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn notify_latency_trampoline<P, F: Fn(&P) + Send + Sync + 'static>(
            this: *mut gst_sys::GstPipeline,
            _param_spec: glib_sys::gpointer,
            f: glib_sys::gpointer,
        ) where
            P: IsA<Pipeline>,
        {
            let f: &F = &*(f as *const F);
            f(&Pipeline::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::latency\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_latency_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }
}