// 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::GString;
use glib_sys;
use gst_sys;
use std::boxed::Box as Box_;
use std::mem::transmute;
use ClockTime;

glib_wrapper! {
    /// `Object` provides a root for the object hierarchy tree filed in by the
    /// GStreamer library. It is currently a thin wrapper on top of
    /// `gobject::InitiallyUnowned`. It is an abstract class that is not very usable on its own.
    ///
    /// `Object` gives us basic refcounting, parenting functionality and locking.
    /// Most of the functions are just extended for special GStreamer needs and can be
    /// found under the same name in the base class of `Object` which is `gobject::Object`
    /// (e.g. `gobject::ObjectExt::ref` becomes `GstObjectExt::ref`).
    ///
    /// Since `Object` derives from `gobject::InitiallyUnowned`, it also inherits the
    /// floating reference. Be aware that functions such as `GstBinExt::add` and
    /// `ElementExt::add_pad` take ownership of the floating reference.
    ///
    /// In contrast to `gobject::Object` instances, `Object` adds a name property. The functions
    /// `Object::set_name` and `GstObjectExt::get_name` are used to set/get the name
    /// of the object.
    ///
    /// ## controlled properties
    ///
    /// Controlled properties offers a lightweight way to adjust gobject properties
    /// over stream-time. It works by using time-stamped value pairs that are queued
    /// for element-properties. At run-time the elements continuously pull value
    /// changes for the current stream-time.
    ///
    /// What needs to be changed in a `Element`?
    /// Very little - it is just two steps to make a plugin controllable!
    ///
    ///  * mark gobject-properties paramspecs that make sense to be controlled,
    ///  by GST_PARAM_CONTROLLABLE.
    ///
    ///  * when processing data (get, chain, loop function) at the beginning call
    ///  gst_object_sync_values(element,timestamp).
    ///  This will make the controller update all GObject properties that are
    ///  under its control with the current values based on the timestamp.
    ///
    /// What needs to be done in applications? Again it's not a lot to change.
    ///
    ///  * create a `ControlSource`.
    ///  csource = gst_interpolation_control_source_new ();
    ///  g_object_set (csource, "mode", GST_INTERPOLATION_MODE_LINEAR, NULL);
    ///
    ///  * Attach the `ControlSource` on the controller to a property.
    ///  gst_object_add_control_binding (object, gst_direct_control_binding_new (object, "prop1", csource));
    ///
    ///  * Set the control values
    ///  gst_timed_value_control_source_set ((GstTimedValueControlSource *)csource,0 * GST_SECOND, value1);
    ///  gst_timed_value_control_source_set ((GstTimedValueControlSource *)csource,1 * GST_SECOND, value2);
    ///
    ///  * start your pipeline
    ///
    /// # Implements
    ///
    /// [`GstObjectExt`](trait.GstObjectExt.html), [`glib::object::ObjectExt`](../glib/object/trait.ObjectExt.html)
    pub struct Object(Object<gst_sys::GstObject, gst_sys::GstObjectClass, ObjectClass>);

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

impl Object {
    /// Checks to see if there is any object named `name` in `list`. This function
    /// does not do any locking of any kind. You might want to protect the
    /// provided list with the lock of the owner of the list. This function
    /// will lock each `Object` in the list to compare the name, so be
    /// careful when passing a list with a locked object.
    /// ## `list`
    /// a list of `Object` to
    ///  check through
    /// ## `name`
    /// the name to search for
    ///
    /// # Returns
    ///
    /// `true` if a `Object` named `name` does not appear in `list`,
    /// `false` if it does.
    ///
    /// MT safe. Grabs and releases the LOCK of each object in the list.
    pub fn check_uniqueness(list: &[Object], name: &str) -> bool {
        assert_initialized_main_thread!();
        unsafe {
            from_glib(gst_sys::gst_object_check_uniqueness(
                list.to_glib_none().0,
                name.to_glib_none().0,
            ))
        }
    }

    //pub fn default_deep_notify<P: IsA<glib::Object>, Q: IsA<Object>>(object: &P, orig: &Q, pspec: /*Ignored*/&glib::ParamSpec, excluded_props: &[&str]) {
    //    unsafe { TODO: call gst_sys:gst_object_default_deep_notify() }
    //}

    //pub fn ref_sink(object: /*Unimplemented*/Option<Fundamental: Pointer>) -> /*Unimplemented*/Option<Fundamental: Pointer> {
    //    unsafe { TODO: call gst_sys:gst_object_ref_sink() }
    //}

    //pub fn replace<P: IsA<Object>, Q: IsA<Object>>(oldobj: Option<&P>, newobj: Option<&Q>) -> bool {
    //    unsafe { TODO: call gst_sys:gst_object_replace() }
    //}
}

unsafe impl Send for Object {}
unsafe impl Sync for Object {}

pub const NONE_OBJECT: Option<&Object> = None;

/// Trait containing all `Object` methods.
///
/// # Implementors
///
/// [`Allocator`](struct.Allocator.html), [`BufferPool`](struct.BufferPool.html), [`Bus`](struct.Bus.html), [`Clock`](struct.Clock.html), [`DeviceMonitor`](struct.DeviceMonitor.html), [`DeviceProvider`](struct.DeviceProvider.html), [`Device`](struct.Device.html), [`Element`](struct.Element.html), [`Object`](struct.Object.html), [`PadTemplate`](struct.PadTemplate.html), [`Pad`](struct.Pad.html), [`PluginFeature`](struct.PluginFeature.html), [`Plugin`](struct.Plugin.html), [`Registry`](struct.Registry.html), [`StreamCollection`](struct.StreamCollection.html), [`Stream`](struct.Stream.html)
pub trait GstObjectExt: 'static {
    //fn add_control_binding(&self, binding: /*Ignored*/&ControlBinding) -> bool;

    /// A default error function that uses `g_printerr` to display the error message
    /// and the optional debug string..
    ///
    /// The default handler will simply print the error string using g_print.
    /// ## `error`
    /// the GError.
    /// ## `debug`
    /// an additional debug information string, or `None`
    fn default_error(&self, error: &glib::Error, debug: Option<&str>);

    //fn get_control_binding(&self, property_name: &str) -> /*Ignored*/Option<ControlBinding>;

    /// Obtain the control-rate for this `self`. Audio processing `Element`
    /// objects will use this rate to sub-divide their processing loop and call
    /// `GstObjectExt::sync_values` in between. The length of the processing segment
    /// should be up to `control`-rate nanoseconds.
    ///
    /// If the `self` is not under property control, this will return
    /// `GST_CLOCK_TIME_NONE`. This allows the element to avoid the sub-dividing.
    ///
    /// The control-rate is not expected to change if the element is in
    /// `State::Paused` or `State::Playing`.
    ///
    /// # Returns
    ///
    /// the control rate in nanoseconds
    fn get_control_rate(&self) -> ClockTime;

    //fn get_g_value_array(&self, property_name: &str, timestamp: ClockTime, interval: ClockTime, values: /*Ignored*/&[&glib::Value]) -> bool;

    /// Returns a copy of the name of `self`.
    /// Caller should `g_free` the return value after usage.
    /// For a nameless object, this returns `None`, which you can safely `g_free`
    /// as well.
    ///
    /// Free-function: g_free
    ///
    /// # Returns
    ///
    /// the name of `self`. `g_free`
    /// after usage.
    ///
    /// MT safe. This function grabs and releases `self`'s LOCK.
    fn get_name(&self) -> GString;

    /// Returns the parent of `self`. This function increases the refcount
    /// of the parent object so you should `GstObjectExt::unref` it after usage.
    ///
    /// # Returns
    ///
    /// parent of `self`, this can be
    ///  `None` if `self` has no parent. unref after usage.
    ///
    /// MT safe. Grabs and releases `self`'s LOCK.
    fn get_parent(&self) -> Option<Object>;

    /// Generates a string describing the path of `self` in
    /// the object hierarchy. Only useful (or used) for debugging.
    ///
    /// Free-function: g_free
    ///
    /// # Returns
    ///
    /// a string describing the path of `self`. You must
    ///  `g_free` the string after usage.
    ///
    /// MT safe. Grabs and releases the `Object`'s LOCK for all objects
    ///  in the hierarchy.
    fn get_path_string(&self) -> GString;

    //fn get_value(&self, property_name: &str, timestamp: ClockTime) -> /*Ignored*/Option<glib::Value>;

    //fn get_value_array(&self, property_name: &str, timestamp: ClockTime, interval: ClockTime, n_values: u32, values: /*Unimplemented*/Option<Fundamental: Pointer>) -> bool;

    /// Check if the `self` has active controlled properties.
    ///
    /// # Returns
    ///
    /// `true` if the object has active controlled properties
    fn has_active_control_bindings(&self) -> bool;

    /// Check if `self` has an ancestor `ancestor` somewhere up in
    /// the hierarchy. One can e.g. check if a `Element` is inside a `Pipeline`.
    ///
    /// # Deprecated
    ///
    /// Use `GstObjectExt::has_as_ancestor` instead.
    ///
    /// MT safe. Grabs and releases `self`'s locks.
    /// ## `ancestor`
    /// a `Object` to check as ancestor
    ///
    /// # Returns
    ///
    /// `true` if `ancestor` is an ancestor of `self`.
    fn has_ancestor<P: IsA<Object>>(&self, ancestor: &P) -> bool;

    /// Check if `self` has an ancestor `ancestor` somewhere up in
    /// the hierarchy. One can e.g. check if a `Element` is inside a `Pipeline`.
    /// ## `ancestor`
    /// a `Object` to check as ancestor
    ///
    /// # Returns
    ///
    /// `true` if `ancestor` is an ancestor of `self`.
    ///
    /// MT safe. Grabs and releases `self`'s locks.
    fn has_as_ancestor<P: IsA<Object>>(&self, ancestor: &P) -> bool;

    /// Check if `parent` is the parent of `self`.
    /// E.g. a `Element` can check if it owns a given `Pad`.
    /// ## `parent`
    /// a `Object` to check as parent
    ///
    /// # Returns
    ///
    /// `false` if either `self` or `parent` is `None`. `true` if `parent` is
    ///  the parent of `self`. Otherwise `false`.
    ///
    /// MT safe. Grabs and releases `self`'s locks.
    fn has_as_parent<P: IsA<Object>>(&self, parent: &P) -> bool;

    //fn remove_control_binding(&self, binding: /*Ignored*/&ControlBinding) -> bool;

    /// This function is used to disable the control bindings on a property for
    /// some time, i.e. `GstObjectExt::sync_values` will do nothing for the
    /// property.
    /// ## `property_name`
    /// property to disable
    /// ## `disabled`
    /// boolean that specifies whether to disable the controller
    /// or not.
    fn set_control_binding_disabled(&self, property_name: &str, disabled: bool);

    /// This function is used to disable all controlled properties of the `self` for
    /// some time, i.e. `GstObjectExt::sync_values` will do nothing.
    /// ## `disabled`
    /// boolean that specifies whether to disable the controller
    /// or not.
    fn set_control_bindings_disabled(&self, disabled: bool);

    /// Change the control-rate for this `self`. Audio processing `Element`
    /// objects will use this rate to sub-divide their processing loop and call
    /// `GstObjectExt::sync_values` in between. The length of the processing segment
    /// should be up to `control`-rate nanoseconds.
    ///
    /// The control-rate should not change if the element is in `State::Paused` or
    /// `State::Playing`.
    /// ## `control_rate`
    /// the new control-rate in nanoseconds.
    fn set_control_rate(&self, control_rate: ClockTime);

    /// Sets the parent of `self` to `parent`. The object's reference count will
    /// be incremented, and any floating reference will be removed (see `Object::ref_sink`).
    /// ## `parent`
    /// new parent of object
    ///
    /// # Returns
    ///
    /// `true` if `parent` could be set or `false` when `self`
    /// already had a parent or `self` and `parent` are the same.
    ///
    /// MT safe. Grabs and releases `self`'s LOCK.
    fn set_parent<P: IsA<Object>>(&self, parent: &P) -> Result<(), glib::error::BoolError>;

    /// Returns a suggestion for timestamps where buffers should be split
    /// to get best controller results.
    ///
    /// # Returns
    ///
    /// Returns the suggested timestamp or `GST_CLOCK_TIME_NONE`
    /// if no control-rate was set.
    fn suggest_next_sync(&self) -> ClockTime;

    /// Sets the properties of the object, according to the `GstControlSources` that
    /// (maybe) handle them and for the given timestamp.
    ///
    /// If this function fails, it is most likely the application developers fault.
    /// Most probably the control sources are not setup correctly.
    /// ## `timestamp`
    /// the time that should be processed
    ///
    /// # Returns
    ///
    /// `true` if the controller values could be applied to the object
    /// properties, `false` otherwise
    fn sync_values(&self, timestamp: ClockTime) -> Result<(), glib::error::BoolError>;

    /// Clear the parent of `self`, removing the associated reference.
    /// This function decreases the refcount of `self`.
    ///
    /// MT safe. Grabs and releases `self`'s lock.
    fn unparent(&self);

    //fn connect_deep_notify<Unsupported or ignored types>(&self, f: F) -> SignalHandlerId;

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

impl<O: IsA<Object>> GstObjectExt for O {
    //fn add_control_binding(&self, binding: /*Ignored*/&ControlBinding) -> bool {
    //    unsafe { TODO: call gst_sys:gst_object_add_control_binding() }
    //}

    fn default_error(&self, error: &glib::Error, debug: Option<&str>) {
        unsafe {
            gst_sys::gst_object_default_error(
                self.as_ref().to_glib_none().0,
                error.to_glib_none().0,
                debug.to_glib_none().0,
            );
        }
    }

    //fn get_control_binding(&self, property_name: &str) -> /*Ignored*/Option<ControlBinding> {
    //    unsafe { TODO: call gst_sys:gst_object_get_control_binding() }
    //}

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

    //fn get_g_value_array(&self, property_name: &str, timestamp: ClockTime, interval: ClockTime, values: /*Ignored*/&[&glib::Value]) -> bool {
    //    unsafe { TODO: call gst_sys:gst_object_get_g_value_array() }
    //}

    fn get_name(&self) -> GString {
        unsafe { from_glib_full(gst_sys::gst_object_get_name(self.as_ref().to_glib_none().0)) }
    }

    fn get_parent(&self) -> Option<Object> {
        unsafe {
            from_glib_full(gst_sys::gst_object_get_parent(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    fn get_path_string(&self) -> GString {
        unsafe {
            from_glib_full(gst_sys::gst_object_get_path_string(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    //fn get_value(&self, property_name: &str, timestamp: ClockTime) -> /*Ignored*/Option<glib::Value> {
    //    unsafe { TODO: call gst_sys:gst_object_get_value() }
    //}

    //fn get_value_array(&self, property_name: &str, timestamp: ClockTime, interval: ClockTime, n_values: u32, values: /*Unimplemented*/Option<Fundamental: Pointer>) -> bool {
    //    unsafe { TODO: call gst_sys:gst_object_get_value_array() }
    //}

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

    fn has_ancestor<P: IsA<Object>>(&self, ancestor: &P) -> bool {
        unsafe {
            from_glib(gst_sys::gst_object_has_ancestor(
                self.as_ref().to_glib_none().0,
                ancestor.as_ref().to_glib_none().0,
            ))
        }
    }

    fn has_as_ancestor<P: IsA<Object>>(&self, ancestor: &P) -> bool {
        unsafe {
            from_glib(gst_sys::gst_object_has_as_ancestor(
                self.as_ref().to_glib_none().0,
                ancestor.as_ref().to_glib_none().0,
            ))
        }
    }

    fn has_as_parent<P: IsA<Object>>(&self, parent: &P) -> bool {
        unsafe {
            from_glib(gst_sys::gst_object_has_as_parent(
                self.as_ref().to_glib_none().0,
                parent.as_ref().to_glib_none().0,
            ))
        }
    }

    //fn remove_control_binding(&self, binding: /*Ignored*/&ControlBinding) -> bool {
    //    unsafe { TODO: call gst_sys:gst_object_remove_control_binding() }
    //}

    fn set_control_binding_disabled(&self, property_name: &str, disabled: bool) {
        unsafe {
            gst_sys::gst_object_set_control_binding_disabled(
                self.as_ref().to_glib_none().0,
                property_name.to_glib_none().0,
                disabled.to_glib(),
            );
        }
    }

    fn set_control_bindings_disabled(&self, disabled: bool) {
        unsafe {
            gst_sys::gst_object_set_control_bindings_disabled(
                self.as_ref().to_glib_none().0,
                disabled.to_glib(),
            );
        }
    }

    fn set_control_rate(&self, control_rate: ClockTime) {
        unsafe {
            gst_sys::gst_object_set_control_rate(
                self.as_ref().to_glib_none().0,
                control_rate.to_glib(),
            );
        }
    }

    fn set_parent<P: IsA<Object>>(&self, parent: &P) -> Result<(), glib::error::BoolError> {
        unsafe {
            glib_result_from_gboolean!(
                gst_sys::gst_object_set_parent(
                    self.as_ref().to_glib_none().0,
                    parent.as_ref().to_glib_none().0
                ),
                "Failed to set parent object"
            )
        }
    }

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

    fn sync_values(&self, timestamp: ClockTime) -> Result<(), glib::error::BoolError> {
        unsafe {
            glib_result_from_gboolean!(
                gst_sys::gst_object_sync_values(
                    self.as_ref().to_glib_none().0,
                    timestamp.to_glib()
                ),
                "Failed to sync values"
            )
        }
    }

    fn unparent(&self) {
        unsafe {
            gst_sys::gst_object_unparent(self.as_ref().to_glib_none().0);
        }
    }

    //fn connect_deep_notify<Unsupported or ignored types>(&self, f: F) -> SignalHandlerId {
    //    Ignored prop: GObject.ParamSpec
    //}

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