// This file was generated by gir (https://github.com/gtk-rs/gir)
// from gir-files (https://github.com/gtk-rs/gir-files)
// from gst-gir-files (https://gitlab.freedesktop.org/gstreamer/gir-files-rs.git)
// DO NOT EDIT

use crate::Asset;
#[cfg(any(feature = "v1_18", feature = "dox"))]
#[cfg_attr(feature = "dox", doc(cfg(feature = "v1_18")))]
use crate::Clip;
use crate::Extractable;
#[cfg(any(feature = "v1_18", feature = "dox"))]
#[cfg_attr(feature = "dox", doc(cfg(feature = "v1_18")))]
use crate::FrameNumber;
use crate::Group;
use crate::Layer;
use crate::TimelineElement;
use crate::Track;
use crate::TrackElement;
use glib::object::Cast;
use glib::object::IsA;
use glib::signal::connect_raw;
use glib::signal::SignalHandlerId;
use glib::translate::*;
use std::boxed::Box as Box_;
use std::mem::transmute;
use std::ptr;

glib::wrapper! {
    /// [`crate::Timeline`] is the central object for any multimedia timeline.
    ///
    /// A timeline is composed of a set of [`crate::Track`]-s and a set of
    /// [`crate::Layer`]-s, which are added to the timeline using
    /// [`crate::prelude::TimelineExt::add_track()`] and [`crate::prelude::TimelineExt::append_layer()`], respectively.
    ///
    /// The contained tracks define the supported types of the timeline
    /// and provide the media output. Essentially, each track provides an
    /// additional source [`crate::gst::Pad`].
    ///
    /// Most usage of a timeline will likely only need a single [`crate::AudioTrack`]
    /// and/or a single [`crate::VideoTrack`]. You can create such a timeline with
    /// [`Self::new_audio_video()`]. After this, you are unlikely to need to
    /// work with the tracks directly.
    ///
    /// A timeline's layers contain [`crate::Clip`]-s, which in turn control the
    /// creation of [`crate::TrackElement`]-s, which are added to the timeline's
    /// tracks. See [`crate::Timeline::select-tracks-for-object`] if you wish to have
    /// more control over which track a clip's elements are added to.
    ///
    /// The layers are ordered, with higher priority layers having their
    /// content prioritised in the tracks. This ordering can be changed using
    /// [`crate::prelude::TimelineExt::move_layer()`].
    ///
    /// ## Editing
    ///
    /// See [`crate::TimelineElement`] for the various ways the elements of a timeline
    /// can be edited.
    ///
    /// If you change the timing or ordering of a timeline's
    /// [`crate::TimelineElement`]-s, then these changes will not actually be taken
    /// into account in the output of the timeline's tracks until the
    /// [`crate::prelude::TimelineExt::commit()`] method is called. This allows you to move its
    /// elements around, say, in response to an end user's mouse dragging, with
    /// little expense before finalising their effect on the produced data.
    ///
    /// ## Overlaps and Auto-Transitions
    ///
    /// There are certain restrictions placed on how [`crate::Source`]-s may overlap
    /// in a [`crate::Track`] that belongs to a timeline. These will be enforced by
    /// GES, so the user will not need to keep track of them, but they should
    /// be aware that certain edits will be refused as a result if the overlap
    /// rules would be broken.
    ///
    /// Consider two [`crate::Source`]-s, `A` and `B`, with start times `startA` and
    /// `startB`, and end times `endA` and `endB`, respectively. The start
    /// time refers to their [`crate::TimelineElement:start`], and the end time is
    /// their [`crate::TimelineElement:start`] + [`crate::TimelineElement:duration`]. These
    /// two sources *overlap* if:
    ///
    /// + they share the same [`crate::TrackElement:track`] (non [`None`]), which belongs
    ///  to the timeline;
    /// + they share the same `GES_TIMELINE_ELEMENT_LAYER_PRIORITY`; and
    /// + `startA < endB` and `startB < endA `.
    ///
    /// Note that when `startA = endB` or `startB = endA` then the two sources
    /// will *touch* at their edges, but are not considered overlapping.
    ///
    /// If, in addition, `startA < startB < endA`, then we can say that the
    /// end of `A` overlaps the start of `B`.
    ///
    /// If, instead, `startA <= startB` and `endA >= endB`, then we can say
    /// that `A` fully overlaps `B`.
    ///
    /// The overlap rules for a timeline are that:
    ///
    /// 1. One source cannot fully overlap another source.
    /// 2. A source can only overlap the end of up to one other source at its
    ///  start.
    /// 3. A source can only overlap the start of up to one other source at its
    ///  end.
    ///
    /// The last two rules combined essentially mean that at any given timeline
    /// position, only up to two [`crate::Source`]-s may overlap at that position. So
    /// triple or more overlaps are not allowed.
    ///
    /// If you switch on [`crate::Timeline:auto-transition`], then at any moment when
    /// the end of one source (the first source) overlaps the start of another
    /// (the second source), a [`crate::TransitionClip`] will be automatically created
    /// for the pair in the same layer and it will cover their overlap. If the
    /// two elements are edited in a way such that the end of the first source
    /// no longer overlaps the start of the second, the transition will be
    /// automatically removed from the timeline. However, if the two sources
    /// still overlap at the same edges after the edit, then the same
    /// transition object will be kept, but with its timing and layer adjusted
    /// accordingly.
    ///
    /// ## Saving
    ///
    /// To save/load a timeline, you can use the [`crate::prelude::TimelineExt::load_from_uri()`]
    /// and [`crate::prelude::TimelineExt::save_to_uri()`] methods that use the default format.
    ///
    /// ## Playing
    ///
    /// A timeline is a [`crate::gst::Bin`] with a source [`crate::gst::Pad`] for each of its
    /// tracks, which you can fetch with [`crate::prelude::TimelineExt::get_pad_for_track()`]. You
    /// will likely want to link these to some compatible sink [`crate::gst::Element`]-s to
    /// be able to play or capture the content of the timeline.
    ///
    /// You can use a [`crate::Pipeline`] to easily preview/play the timeline's
    /// content, or render it to a file.
    ///
    /// # Implements
    ///
    /// [`trait@crate::prelude::TimelineExt`], [`trait@gst::prelude::ElementExt`], [`trait@gst::prelude::GstObjectExt`], [`trait@glib::object::ObjectExt`], [`trait@crate::prelude::ExtractableExt`]
    pub struct Timeline(Object<ffi::GESTimeline, ffi::GESTimelineClass>) @extends gst::Element, gst::Object, @implements Extractable;

    match fn {
        type_ => || ffi::ges_timeline_get_type(),
    }
}

impl Timeline {
    /// Creates a new empty timeline.
    ///
    /// # Returns
    ///
    /// The new timeline.
    #[doc(alias = "ges_timeline_new")]
    pub fn new() -> Timeline {
        assert_initialized_main_thread!();
        unsafe { from_glib_none(ffi::ges_timeline_new()) }
    }

    /// Creates a new timeline containing a single [`crate::AudioTrack`] and a
    /// single [`crate::VideoTrack`].
    ///
    /// # Returns
    ///
    /// The new timeline, or [`None`] if the tracks
    /// could not be created and added.
    #[doc(alias = "ges_timeline_new_audio_video")]
    pub fn new_audio_video() -> Timeline {
        assert_initialized_main_thread!();
        unsafe { from_glib_none(ffi::ges_timeline_new_audio_video()) }
    }

    /// Creates a timeline from the given URI.
    /// ## `uri`
    /// The URI to load from
    ///
    /// # Returns
    ///
    /// A new timeline if the uri was loaded
    /// successfully, or [`None`] if the uri could not be loaded.
    #[doc(alias = "ges_timeline_new_from_uri")]
    #[doc(alias = "new_from_uri")]
    pub fn from_uri(uri: &str) -> Result<Option<Timeline>, glib::Error> {
        assert_initialized_main_thread!();
        unsafe {
            let mut error = ptr::null_mut();
            let ret = ffi::ges_timeline_new_from_uri(uri.to_glib_none().0, &mut error);
            if error.is_null() {
                Ok(from_glib_none(ret))
            } else {
                Err(from_glib_full(error))
            }
        }
    }
}

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

pub const NONE_TIMELINE: Option<&Timeline> = None;

/// Trait containing all `Timeline` methods.
///
/// # Implementors
///
/// [`struct@crate::Timeline`]
pub trait TimelineExt: 'static {
    /// Add a layer to the timeline.
    ///
    /// If the layer contains [`crate::Clip`]-s, then this may trigger the creation of
    /// their core track element children for the timeline's tracks, and the
    /// placement of the clip's children in the tracks of the timeline using
    /// [`crate::Timeline::select-tracks-for-object`]. Some errors may occur if this
    /// would break one of the configuration rules of the timeline in one of
    /// its tracks. In such cases, some track elements would fail to be added
    /// to their tracks, but this method would still return [`true`]. As such, it
    /// is advised that you only add clips to layers that already part of a
    /// timeline. In such situations, [`crate::prelude::LayerExt::add_clip()`] is able to fail if
    /// adding the clip would cause such an error.
    ///
    /// # Deprecated since 1.18
    ///
    /// This method requires you to ensure the layer's
    /// [`crate::Layer:priority`] will be unique to the timeline. Use
    /// [`Self::append_layer()`] and [`Self::move_layer()`] instead.
    /// ## `layer`
    /// The layer to add
    ///
    /// # Returns
    ///
    /// [`true`] if `layer` was properly added.
    #[cfg_attr(feature = "v1_18", deprecated = "Since 1.18")]
    #[doc(alias = "ges_timeline_add_layer")]
    fn add_layer<P: IsA<Layer>>(&self, layer: &P) -> Result<(), glib::error::BoolError>;

    /// Add a track to the timeline.
    ///
    /// If the timeline already contains clips, then this may trigger the
    /// creation of their core track element children for the track, and the
    /// placement of the clip's children in the track of the timeline using
    /// [`crate::Timeline::select-tracks-for-object`]. Some errors may occur if this
    /// would break one of the configuration rules for the timeline in the
    /// track. In such cases, some track elements would fail to be added to the
    /// track, but this method would still return [`true`]. As such, it is advised
    /// that you avoid adding tracks to timelines that already contain clips.
    /// ## `track`
    /// The track to add
    ///
    /// # Returns
    ///
    /// [`true`] if `track` was properly added.
    #[doc(alias = "ges_timeline_add_track")]
    fn add_track<P: IsA<Track>>(&self, track: &P) -> Result<(), glib::error::BoolError>;

    /// Append a newly created layer to the timeline. The layer will
    /// be added at the lowest [`crate::Layer:priority`] (numerically, the highest).
    ///
    /// # Returns
    ///
    /// The newly created layer.
    #[doc(alias = "ges_timeline_append_layer")]
    fn append_layer(&self) -> Layer;

    /// Commit all the pending changes of the clips contained in the
    /// timeline.
    ///
    /// When changes happen in a timeline, they are not immediately executed
    /// internally, in a way that effects the output data of the timeline. You
    /// should call this method when you are done with a set of changes and you
    /// want them to be executed.
    ///
    /// Any pending changes will be executed in the backend. The
    /// [`crate::Timeline::commited`] signal will be emitted once this has completed.
    /// You should not try to change the state of the timeline, seek it or add
    /// tracks to it before receiving this signal. You can use
    /// [`Self::commit_sync()`] if you do not want to perform other tasks in
    /// the mean time.
    ///
    /// Note that all the pending changes will automatically be executed when
    /// the timeline goes from [`crate::gst::State::Ready`] to [`crate::gst::State::Paused`], which is
    /// usually triggered by a corresponding state changes in a containing
    /// [`crate::Pipeline`].
    ///
    /// # Returns
    ///
    /// [`true`] if pending changes were committed, or [`false`] if nothing
    /// needed to be committed.
    #[doc(alias = "ges_timeline_commit")]
    fn commit(&self) -> bool;

    /// Commit all the pending changes of the clips contained in the
    /// timeline and wait for the changes to complete.
    ///
    /// See [`Self::commit()`].
    ///
    /// # Returns
    ///
    /// [`true`] if pending changes were committed, or [`false`] if nothing
    /// needed to be committed.
    #[doc(alias = "ges_timeline_commit_sync")]
    fn commit_sync(&self) -> bool;

    /// Gets [`crate::Timeline:auto-transition`] for the timeline.
    ///
    /// # Returns
    ///
    /// The auto-transition of `self_`.
    #[doc(alias = "ges_timeline_get_auto_transition")]
    #[doc(alias = "get_auto_transition")]
    fn is_auto_transition(&self) -> bool;

    /// Get the current [`crate::Timeline:duration`] of the timeline
    ///
    /// # Returns
    ///
    /// The current duration of `self`.
    #[doc(alias = "ges_timeline_get_duration")]
    #[doc(alias = "get_duration")]
    fn duration(&self) -> gst::ClockTime;

    /// Gets the element contained in the timeline with the given name.
    /// ## `name`
    /// The name of the element to find
    ///
    /// # Returns
    ///
    /// The timeline element in `self`
    /// with the given `name`, or [`None`] if it was not found.
    #[doc(alias = "ges_timeline_get_element")]
    #[doc(alias = "get_element")]
    fn element(&self, name: &str) -> Option<TimelineElement>;

    /// This method allows you to convert a timeline [`crate::gst::ClockTime`] into its
    /// corresponding [`crate::FrameNumber`] in the timeline's output.
    /// ## `timestamp`
    /// The timestamp to get the corresponding frame number of
    ///
    /// # Returns
    ///
    /// The frame number `timestamp` corresponds to.
    #[cfg(any(feature = "v1_18", feature = "dox"))]
    #[cfg_attr(feature = "dox", doc(cfg(feature = "v1_18")))]
    #[doc(alias = "ges_timeline_get_frame_at")]
    #[doc(alias = "get_frame_at")]
    fn frame_at(&self, timestamp: gst::ClockTime) -> FrameNumber;

    /// This method allows you to convert a timeline output frame number into a
    /// timeline [`crate::gst::ClockTime`]. For example, this time could be used to seek to a
    /// particular frame in the timeline's output, or as the edit position for
    /// an element within the timeline.
    /// ## `frame_number`
    /// The frame number to get the corresponding timestamp of in the
    ///  timeline coordinates
    ///
    /// # Returns
    ///
    /// The timestamp corresponding to `frame_number` in the output of `self`.
    #[cfg(any(feature = "v1_18", feature = "dox"))]
    #[cfg_attr(feature = "dox", doc(cfg(feature = "v1_18")))]
    #[doc(alias = "ges_timeline_get_frame_time")]
    #[doc(alias = "get_frame_time")]
    fn frame_time(&self, frame_number: FrameNumber) -> gst::ClockTime;

    /// Get the list of [`crate::Group`]-s present in the timeline.
    ///
    /// # Returns
    ///
    /// The list of
    /// groups that contain clips present in `self`'s layers.
    /// Must not be changed.
    #[doc(alias = "ges_timeline_get_groups")]
    #[doc(alias = "get_groups")]
    fn groups(&self) -> Vec<Group>;

    /// Retrieve the layer whose index in the timeline matches the given
    /// priority.
    /// ## `priority`
    /// The priority/index of the layer to find
    ///
    /// # Returns
    ///
    /// The layer with the given
    /// `priority`, or [`None`] if none was found.
    ///
    /// Since 1.6
    #[doc(alias = "ges_timeline_get_layer")]
    #[doc(alias = "get_layer")]
    fn layer(&self, priority: u32) -> Option<Layer>;

    /// Get the list of [`crate::Layer`]-s present in the timeline.
    ///
    /// # Returns
    ///
    /// The list of
    /// layers present in `self` sorted by priority.
    #[doc(alias = "ges_timeline_get_layers")]
    #[doc(alias = "get_layers")]
    fn layers(&self) -> Vec<Layer>;

    /// Search for the [`crate::gst::Pad`] corresponding to the given timeline's track.
    /// You can link to this pad to receive the output data of the given track.
    /// ## `track`
    /// A track
    ///
    /// # Returns
    ///
    /// The pad corresponding to `track`,
    /// or [`None`] if there is an error.
    #[doc(alias = "ges_timeline_get_pad_for_track")]
    #[doc(alias = "get_pad_for_track")]
    fn pad_for_track<P: IsA<Track>>(&self, track: &P) -> Option<gst::Pad>;

    /// Gets the [`crate::Timeline:snapping-distance`] for the timeline.
    ///
    /// # Returns
    ///
    /// The snapping distance (in nanoseconds) of `self`.
    #[doc(alias = "ges_timeline_get_snapping_distance")]
    #[doc(alias = "get_snapping_distance")]
    fn snapping_distance(&self) -> gst::ClockTime;

    /// Search for the [`crate::Track`] corresponding to the given timeline's pad.
    /// ## `pad`
    /// A pad
    ///
    /// # Returns
    ///
    /// The track corresponding to `pad`,
    /// or [`None`] if there is an error.
    #[doc(alias = "ges_timeline_get_track_for_pad")]
    #[doc(alias = "get_track_for_pad")]
    fn track_for_pad<P: IsA<gst::Pad>>(&self, pad: &P) -> Option<Track>;

    /// Get the list of [`crate::Track`]-s used by the timeline.
    ///
    /// # Returns
    ///
    /// The list of tracks
    /// used by `self`.
    #[doc(alias = "ges_timeline_get_tracks")]
    #[doc(alias = "get_tracks")]
    fn tracks(&self) -> Vec<Track>;

    /// Check whether the timeline is empty or not.
    ///
    /// # Returns
    ///
    /// [`true`] if `self` is empty.
    #[doc(alias = "ges_timeline_is_empty")]
    fn is_empty(&self) -> bool;

    /// Loads the contents of URI into the timeline.
    /// ## `uri`
    /// The URI to load from
    ///
    /// # Returns
    ///
    /// [`true`] if the timeline was loaded successfully from `uri`.
    #[doc(alias = "ges_timeline_load_from_uri")]
    fn load_from_uri(&self, uri: &str) -> Result<(), glib::Error>;

    /// Moves a layer within the timeline to the index given by
    /// `new_layer_priority`.
    /// An index of 0 corresponds to the layer with the highest priority in a
    /// timeline. If `new_layer_priority` is greater than the number of layers
    /// present in the timeline, it will become the lowest priority layer.
    /// ## `layer`
    /// A layer within `self`, whose priority should be changed
    /// ## `new_layer_priority`
    /// The new index for `layer`
    #[cfg(any(feature = "v1_16", feature = "dox"))]
    #[cfg_attr(feature = "dox", doc(cfg(feature = "v1_16")))]
    #[doc(alias = "ges_timeline_move_layer")]
    fn move_layer<P: IsA<Layer>>(
        &self,
        layer: &P,
        new_layer_priority: u32,
    ) -> Result<(), glib::error::BoolError>;

    /// Paste an element inside the timeline. `element` **must** be the return of
    /// [`crate::prelude::TimelineElementExt::copy()`] with `deep=TRUE`,
    /// and it should not be changed before pasting. `element` itself is not
    /// placed in the timeline, instead a new element is created, alike to the
    /// originally copied element. Note that the originally copied element must
    /// also lie within `self`, at both the point of copying and pasting.
    ///
    /// Pasting may fail if it would place the timeline in an unsupported
    /// configuration.
    ///
    /// After calling this function `element` should not be used. In particular,
    /// `element` can **not** be pasted again. Instead, you can copy the
    /// returned element and paste that copy (although, this is only possible
    /// if the paste was successful).
    ///
    /// See also [`crate::prelude::TimelineElementExt::paste()`].
    /// ## `element`
    /// The element to paste
    /// ## `position`
    /// The position in the timeline `element` should be pasted to,
    /// i.e. the [`crate::TimelineElement:start`] value for the pasted element.
    /// ## `layer_priority`
    /// The layer into which the element should be pasted.
    /// -1 means paste to the same layer from which `element` has been copied from
    ///
    /// # Returns
    ///
    /// The newly created element, or
    /// [`None`] if pasting fails.
    #[doc(alias = "ges_timeline_paste_element")]
    fn paste_element<P: IsA<TimelineElement>>(
        &self,
        element: &P,
        position: gst::ClockTime,
        layer_priority: i32,
    ) -> Option<TimelineElement>;

    /// Removes a layer from the timeline.
    /// ## `layer`
    /// The layer to remove
    ///
    /// # Returns
    ///
    /// [`true`] if `layer` was properly removed.
    #[doc(alias = "ges_timeline_remove_layer")]
    fn remove_layer<P: IsA<Layer>>(&self, layer: &P) -> Result<(), glib::error::BoolError>;

    /// Remove a track from the timeline.
    /// ## `track`
    /// The track to remove
    ///
    /// # Returns
    ///
    /// [`true`] if `track` was properly removed.
    #[doc(alias = "ges_timeline_remove_track")]
    fn remove_track<P: IsA<Track>>(&self, track: &P) -> Result<(), glib::error::BoolError>;

    /// Saves the timeline to the given location. If `formatter_asset` is [`None`],
    /// the method will attempt to save in the same format the timeline was
    /// loaded from, before defaulting to the formatter with highest rank.
    /// ## `uri`
    /// The location to save to
    /// ## `formatter_asset`
    /// The formatter asset to use, or [`None`]
    /// ## `overwrite`
    /// [`true`] to overwrite file if it exists
    ///
    /// # Returns
    ///
    /// [`true`] if `self` was successfully saved to `uri`.
    #[doc(alias = "ges_timeline_save_to_uri")]
    fn save_to_uri<P: IsA<Asset>>(
        &self,
        uri: &str,
        formatter_asset: Option<&P>,
        overwrite: bool,
    ) -> Result<(), glib::Error>;

    /// Sets [`crate::Timeline:auto-transition`] for the timeline. This will also set
    /// the corresponding [`crate::Layer:auto-transition`] for all of the timeline's
    /// layers to the same value. See [`crate::prelude::LayerExt::set_auto_transition()`] if you
    /// wish to set the layer's [`crate::Layer:auto-transition`] individually.
    /// ## `auto_transition`
    /// Whether transitions should be automatically added
    /// to `self`'s layers
    #[doc(alias = "ges_timeline_set_auto_transition")]
    fn set_auto_transition(&self, auto_transition: bool);

    /// Sets [`crate::Timeline:snapping-distance`] for the timeline. This new value
    /// will only effect future snappings and will not be used to snap the
    /// current element positions within the timeline.
    /// ## `snapping_distance`
    /// The snapping distance to use (in nanoseconds)
    #[doc(alias = "ges_timeline_set_snapping_distance")]
    fn set_snapping_distance(&self, snapping_distance: gst::ClockTime);

    /// This signal will be emitted once the changes initiated by
    /// [`Self::commit()`] have been executed in the backend. Use
    /// [`Self::commit_sync()`] if you do not want to have to connect
    /// to this signal.
    #[doc(alias = "commited")]
    fn connect_commited<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId;

    /// Will be emitted after the group is added to to the timeline. This can
    /// happen when grouping with `ges_container_group`, or by adding
    /// containers to a newly created group.
    ///
    /// Note that this should not be emitted whilst a timeline is being
    /// loaded from its [`crate::Project`] asset. You should connect to the
    /// project's [`crate::Project::loaded`] signal if you want to know which groups
    /// were created for the timeline.
    /// ## `group`
    /// The group that was added to `timeline`
    #[doc(alias = "group-added")]
    fn connect_group_added<F: Fn(&Self, &Group) + 'static>(&self, f: F) -> SignalHandlerId;

    //#[doc(alias = "group-removed")]
    //fn connect_group_removed<Unsupported or ignored types>(&self, f: F) -> SignalHandlerId;

    /// Will be emitted after the layer is added to the timeline.
    ///
    /// Note that this should not be emitted whilst a timeline is being
    /// loaded from its [`crate::Project`] asset. You should connect to the
    /// project's [`crate::Project::loaded`] signal if you want to know which
    /// layers were created for the timeline.
    /// ## `layer`
    /// The layer that was added to `timeline`
    #[doc(alias = "layer-added")]
    fn connect_layer_added<F: Fn(&Self, &Layer) + 'static>(&self, f: F) -> SignalHandlerId;

    /// Will be emitted after the layer is removed from the timeline.
    /// ## `layer`
    /// The layer that was removed from `timeline`
    #[doc(alias = "layer-removed")]
    fn connect_layer_removed<F: Fn(&Self, &Layer) + 'static>(&self, f: F) -> SignalHandlerId;

    /// Simplified version of [`crate::Timeline::select-tracks-for-object`] which only
    /// allows `track_element` to be added to a single [`crate::Track`].
    /// ## `clip`
    /// The clip that `track_element` is being added to
    /// ## `track_element`
    /// The element being added
    ///
    /// # Returns
    ///
    /// A track to put `track_element` into, or [`None`] if
    /// it should be discarded.
    #[cfg(any(feature = "v1_18", feature = "dox"))]
    #[cfg_attr(feature = "dox", doc(cfg(feature = "v1_18")))]
    #[doc(alias = "select-element-track")]
    fn connect_select_element_track<F: Fn(&Self, &Clip, &TrackElement) -> Track + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId;

    //#[doc(alias = "select-tracks-for-object")]
    //fn connect_select_tracks_for_object<Unsupported or ignored types>(&self, f: F) -> SignalHandlerId;

    /// Will be emitted whenever a snapping event ends. After a snap event
    /// has started (see [`crate::Timeline::snapping-started`]), it can later end
    /// because either another timeline edit has occurred (which may or may
    /// not have created a new snapping event), or because the timeline has
    /// been committed.
    /// ## `obj1`
    /// The first element that was snapping
    /// ## `obj2`
    /// The second element that was snapping
    /// ## `position`
    /// The position where the two objects were to be snapped to
    #[doc(alias = "snapping-ended")]
    fn connect_snapping_ended<F: Fn(&Self, &TrackElement, &TrackElement, u64) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId;

    /// Will be emitted whenever an element's movement invokes a snapping
    /// event during an edit (usually of one of its ancestors) because its
    /// start or end point lies within the [`crate::Timeline:snapping-distance`] of
    /// another element's start or end point.
    ///
    /// See [`crate::EditMode`] to see what can snap during an edit.
    ///
    /// Note that only up to one snapping-started signal will be emitted per
    /// element edit within a timeline.
    /// ## `obj1`
    /// The first element that is snapping
    /// ## `obj2`
    /// The second element that is snapping
    /// ## `position`
    /// The position where the two objects will snap to
    #[doc(alias = "snapping-started")]
    fn connect_snapping_started<F: Fn(&Self, &TrackElement, &TrackElement, u64) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId;

    /// Will be emitted after the track is added to the timeline.
    ///
    /// Note that this should not be emitted whilst a timeline is being
    /// loaded from its [`crate::Project`] asset. You should connect to the
    /// project's [`crate::Project::loaded`] signal if you want to know which
    /// tracks were created for the timeline.
    /// ## `track`
    /// The track that was added to `timeline`
    #[doc(alias = "track-added")]
    fn connect_track_added<F: Fn(&Self, &Track) + 'static>(&self, f: F) -> SignalHandlerId;

    /// Will be emitted after the track is removed from the timeline.
    /// ## `track`
    /// The track that was removed from `timeline`
    #[doc(alias = "track-removed")]
    fn connect_track_removed<F: Fn(&Self, &Track) + 'static>(&self, f: F) -> SignalHandlerId;

    #[doc(alias = "auto-transition")]
    fn connect_auto_transition_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId;

    #[doc(alias = "duration")]
    fn connect_duration_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId;

    #[doc(alias = "snapping-distance")]
    fn connect_snapping_distance_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId;
}

impl<O: IsA<Timeline>> TimelineExt for O {
    fn add_layer<P: IsA<Layer>>(&self, layer: &P) -> Result<(), glib::error::BoolError> {
        unsafe {
            glib::result_from_gboolean!(
                ffi::ges_timeline_add_layer(
                    self.as_ref().to_glib_none().0,
                    layer.as_ref().to_glib_none().0
                ),
                "Failed to add layer"
            )
        }
    }

    fn add_track<P: IsA<Track>>(&self, track: &P) -> Result<(), glib::error::BoolError> {
        unsafe {
            glib::result_from_gboolean!(
                ffi::ges_timeline_add_track(
                    self.as_ref().to_glib_none().0,
                    track.as_ref().to_glib_full()
                ),
                "Failed to add track"
            )
        }
    }

    fn append_layer(&self) -> Layer {
        unsafe {
            from_glib_none(ffi::ges_timeline_append_layer(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    fn commit(&self) -> bool {
        unsafe { from_glib(ffi::ges_timeline_commit(self.as_ref().to_glib_none().0)) }
    }

    fn commit_sync(&self) -> bool {
        unsafe {
            from_glib(ffi::ges_timeline_commit_sync(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    fn is_auto_transition(&self) -> bool {
        unsafe {
            from_glib(ffi::ges_timeline_get_auto_transition(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    fn duration(&self) -> gst::ClockTime {
        unsafe {
            from_glib(ffi::ges_timeline_get_duration(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    fn element(&self, name: &str) -> Option<TimelineElement> {
        unsafe {
            from_glib_full(ffi::ges_timeline_get_element(
                self.as_ref().to_glib_none().0,
                name.to_glib_none().0,
            ))
        }
    }

    #[cfg(any(feature = "v1_18", feature = "dox"))]
    #[cfg_attr(feature = "dox", doc(cfg(feature = "v1_18")))]
    fn frame_at(&self, timestamp: gst::ClockTime) -> FrameNumber {
        unsafe {
            ffi::ges_timeline_get_frame_at(self.as_ref().to_glib_none().0, timestamp.into_glib())
        }
    }

    #[cfg(any(feature = "v1_18", feature = "dox"))]
    #[cfg_attr(feature = "dox", doc(cfg(feature = "v1_18")))]
    fn frame_time(&self, frame_number: FrameNumber) -> gst::ClockTime {
        unsafe {
            from_glib(ffi::ges_timeline_get_frame_time(
                self.as_ref().to_glib_none().0,
                frame_number,
            ))
        }
    }

    fn groups(&self) -> Vec<Group> {
        unsafe {
            FromGlibPtrContainer::from_glib_none(ffi::ges_timeline_get_groups(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    fn layer(&self, priority: u32) -> Option<Layer> {
        unsafe {
            from_glib_full(ffi::ges_timeline_get_layer(
                self.as_ref().to_glib_none().0,
                priority,
            ))
        }
    }

    fn layers(&self) -> Vec<Layer> {
        unsafe {
            FromGlibPtrContainer::from_glib_full(ffi::ges_timeline_get_layers(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    fn pad_for_track<P: IsA<Track>>(&self, track: &P) -> Option<gst::Pad> {
        unsafe {
            from_glib_none(ffi::ges_timeline_get_pad_for_track(
                self.as_ref().to_glib_none().0,
                track.as_ref().to_glib_none().0,
            ))
        }
    }

    fn snapping_distance(&self) -> gst::ClockTime {
        unsafe {
            from_glib(ffi::ges_timeline_get_snapping_distance(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    fn track_for_pad<P: IsA<gst::Pad>>(&self, pad: &P) -> Option<Track> {
        unsafe {
            from_glib_none(ffi::ges_timeline_get_track_for_pad(
                self.as_ref().to_glib_none().0,
                pad.as_ref().to_glib_none().0,
            ))
        }
    }

    fn tracks(&self) -> Vec<Track> {
        unsafe {
            FromGlibPtrContainer::from_glib_full(ffi::ges_timeline_get_tracks(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    fn is_empty(&self) -> bool {
        unsafe { from_glib(ffi::ges_timeline_is_empty(self.as_ref().to_glib_none().0)) }
    }

    fn load_from_uri(&self, uri: &str) -> Result<(), glib::Error> {
        unsafe {
            let mut error = ptr::null_mut();
            let _ = ffi::ges_timeline_load_from_uri(
                self.as_ref().to_glib_none().0,
                uri.to_glib_none().0,
                &mut error,
            );
            if error.is_null() {
                Ok(())
            } else {
                Err(from_glib_full(error))
            }
        }
    }

    #[cfg(any(feature = "v1_16", feature = "dox"))]
    #[cfg_attr(feature = "dox", doc(cfg(feature = "v1_16")))]
    fn move_layer<P: IsA<Layer>>(
        &self,
        layer: &P,
        new_layer_priority: u32,
    ) -> Result<(), glib::error::BoolError> {
        unsafe {
            glib::result_from_gboolean!(
                ffi::ges_timeline_move_layer(
                    self.as_ref().to_glib_none().0,
                    layer.as_ref().to_glib_none().0,
                    new_layer_priority
                ),
                "Failed to move layer"
            )
        }
    }

    fn paste_element<P: IsA<TimelineElement>>(
        &self,
        element: &P,
        position: gst::ClockTime,
        layer_priority: i32,
    ) -> Option<TimelineElement> {
        unsafe {
            from_glib_full(ffi::ges_timeline_paste_element(
                self.as_ref().to_glib_none().0,
                element.as_ref().to_glib_none().0,
                position.into_glib(),
                layer_priority,
            ))
        }
    }

    fn remove_layer<P: IsA<Layer>>(&self, layer: &P) -> Result<(), glib::error::BoolError> {
        unsafe {
            glib::result_from_gboolean!(
                ffi::ges_timeline_remove_layer(
                    self.as_ref().to_glib_none().0,
                    layer.as_ref().to_glib_none().0
                ),
                "Failed to remove layer"
            )
        }
    }

    fn remove_track<P: IsA<Track>>(&self, track: &P) -> Result<(), glib::error::BoolError> {
        unsafe {
            glib::result_from_gboolean!(
                ffi::ges_timeline_remove_track(
                    self.as_ref().to_glib_none().0,
                    track.as_ref().to_glib_none().0
                ),
                "Failed to remove track"
            )
        }
    }

    fn save_to_uri<P: IsA<Asset>>(
        &self,
        uri: &str,
        formatter_asset: Option<&P>,
        overwrite: bool,
    ) -> Result<(), glib::Error> {
        unsafe {
            let mut error = ptr::null_mut();
            let _ = ffi::ges_timeline_save_to_uri(
                self.as_ref().to_glib_none().0,
                uri.to_glib_none().0,
                formatter_asset.map(|p| p.as_ref()).to_glib_none().0,
                overwrite.into_glib(),
                &mut error,
            );
            if error.is_null() {
                Ok(())
            } else {
                Err(from_glib_full(error))
            }
        }
    }

    fn set_auto_transition(&self, auto_transition: bool) {
        unsafe {
            ffi::ges_timeline_set_auto_transition(
                self.as_ref().to_glib_none().0,
                auto_transition.into_glib(),
            );
        }
    }

    fn set_snapping_distance(&self, snapping_distance: gst::ClockTime) {
        unsafe {
            ffi::ges_timeline_set_snapping_distance(
                self.as_ref().to_glib_none().0,
                snapping_distance.into_glib(),
            );
        }
    }

    #[doc(alias = "commited")]
    fn connect_commited<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn commited_trampoline<P, F: Fn(&P) + 'static>(
            this: *mut ffi::GESTimeline,
            f: glib::ffi::gpointer,
        ) where
            P: IsA<Timeline>,
        {
            let f: &F = &*(f as *const F);
            f(&Timeline::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"commited\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    commited_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "group-added")]
    fn connect_group_added<F: Fn(&Self, &Group) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn group_added_trampoline<P, F: Fn(&P, &Group) + 'static>(
            this: *mut ffi::GESTimeline,
            group: *mut ffi::GESGroup,
            f: glib::ffi::gpointer,
        ) where
            P: IsA<Timeline>,
        {
            let f: &F = &*(f as *const F);
            f(
                &Timeline::from_glib_borrow(this).unsafe_cast_ref(),
                &from_glib_borrow(group),
            )
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"group-added\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    group_added_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    //#[doc(alias = "group-removed")]
    //fn connect_group_removed<Unsupported or ignored types>(&self, f: F) -> SignalHandlerId {
    //    Empty ctype children: *.PtrArray TypeId { ns_id: 1, id: 54 }
    //}

    #[doc(alias = "layer-added")]
    fn connect_layer_added<F: Fn(&Self, &Layer) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn layer_added_trampoline<P, F: Fn(&P, &Layer) + 'static>(
            this: *mut ffi::GESTimeline,
            layer: *mut ffi::GESLayer,
            f: glib::ffi::gpointer,
        ) where
            P: IsA<Timeline>,
        {
            let f: &F = &*(f as *const F);
            f(
                &Timeline::from_glib_borrow(this).unsafe_cast_ref(),
                &from_glib_borrow(layer),
            )
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"layer-added\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    layer_added_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "layer-removed")]
    fn connect_layer_removed<F: Fn(&Self, &Layer) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn layer_removed_trampoline<P, F: Fn(&P, &Layer) + 'static>(
            this: *mut ffi::GESTimeline,
            layer: *mut ffi::GESLayer,
            f: glib::ffi::gpointer,
        ) where
            P: IsA<Timeline>,
        {
            let f: &F = &*(f as *const F);
            f(
                &Timeline::from_glib_borrow(this).unsafe_cast_ref(),
                &from_glib_borrow(layer),
            )
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"layer-removed\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    layer_removed_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[cfg(any(feature = "v1_18", feature = "dox"))]
    #[cfg_attr(feature = "dox", doc(cfg(feature = "v1_18")))]
    #[doc(alias = "select-element-track")]
    fn connect_select_element_track<F: Fn(&Self, &Clip, &TrackElement) -> Track + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn select_element_track_trampoline<
            P,
            F: Fn(&P, &Clip, &TrackElement) -> Track + 'static,
        >(
            this: *mut ffi::GESTimeline,
            clip: *mut ffi::GESClip,
            track_element: *mut ffi::GESTrackElement,
            f: glib::ffi::gpointer,
        ) -> *mut ffi::GESTrack
        where
            P: IsA<Timeline>,
        {
            let f: &F = &*(f as *const F);
            f(
                &Timeline::from_glib_borrow(this).unsafe_cast_ref(),
                &from_glib_borrow(clip),
                &from_glib_borrow(track_element),
            )
            .to_glib_full()
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"select-element-track\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    select_element_track_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    //#[doc(alias = "select-tracks-for-object")]
    //fn connect_select_tracks_for_object<Unsupported or ignored types>(&self, f: F) -> SignalHandlerId {
    //    Empty ctype return value *.PtrArray TypeId { ns_id: 1, id: 17 }
    //}

    #[doc(alias = "snapping-ended")]
    fn connect_snapping_ended<F: Fn(&Self, &TrackElement, &TrackElement, u64) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn snapping_ended_trampoline<
            P,
            F: Fn(&P, &TrackElement, &TrackElement, u64) + 'static,
        >(
            this: *mut ffi::GESTimeline,
            obj1: *mut ffi::GESTrackElement,
            obj2: *mut ffi::GESTrackElement,
            position: u64,
            f: glib::ffi::gpointer,
        ) where
            P: IsA<Timeline>,
        {
            let f: &F = &*(f as *const F);
            f(
                &Timeline::from_glib_borrow(this).unsafe_cast_ref(),
                &from_glib_borrow(obj1),
                &from_glib_borrow(obj2),
                position,
            )
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"snapping-ended\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    snapping_ended_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "snapping-started")]
    fn connect_snapping_started<F: Fn(&Self, &TrackElement, &TrackElement, u64) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn snapping_started_trampoline<
            P,
            F: Fn(&P, &TrackElement, &TrackElement, u64) + 'static,
        >(
            this: *mut ffi::GESTimeline,
            obj1: *mut ffi::GESTrackElement,
            obj2: *mut ffi::GESTrackElement,
            position: u64,
            f: glib::ffi::gpointer,
        ) where
            P: IsA<Timeline>,
        {
            let f: &F = &*(f as *const F);
            f(
                &Timeline::from_glib_borrow(this).unsafe_cast_ref(),
                &from_glib_borrow(obj1),
                &from_glib_borrow(obj2),
                position,
            )
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"snapping-started\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    snapping_started_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "track-added")]
    fn connect_track_added<F: Fn(&Self, &Track) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn track_added_trampoline<P, F: Fn(&P, &Track) + 'static>(
            this: *mut ffi::GESTimeline,
            track: *mut ffi::GESTrack,
            f: glib::ffi::gpointer,
        ) where
            P: IsA<Timeline>,
        {
            let f: &F = &*(f as *const F);
            f(
                &Timeline::from_glib_borrow(this).unsafe_cast_ref(),
                &from_glib_borrow(track),
            )
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"track-added\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    track_added_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "track-removed")]
    fn connect_track_removed<F: Fn(&Self, &Track) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn track_removed_trampoline<P, F: Fn(&P, &Track) + 'static>(
            this: *mut ffi::GESTimeline,
            track: *mut ffi::GESTrack,
            f: glib::ffi::gpointer,
        ) where
            P: IsA<Timeline>,
        {
            let f: &F = &*(f as *const F);
            f(
                &Timeline::from_glib_borrow(this).unsafe_cast_ref(),
                &from_glib_borrow(track),
            )
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"track-removed\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    track_removed_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "auto-transition")]
    fn connect_auto_transition_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_auto_transition_trampoline<P, F: Fn(&P) + 'static>(
            this: *mut ffi::GESTimeline,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) where
            P: IsA<Timeline>,
        {
            let f: &F = &*(f as *const F);
            f(&Timeline::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-transition\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_auto_transition_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "duration")]
    fn connect_duration_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_duration_trampoline<P, F: Fn(&P) + 'static>(
            this: *mut ffi::GESTimeline,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) where
            P: IsA<Timeline>,
        {
            let f: &F = &*(f as *const F);
            f(&Timeline::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::duration\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_duration_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "snapping-distance")]
    fn connect_snapping_distance_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_snapping_distance_trampoline<P, F: Fn(&P) + 'static>(
            this: *mut ffi::GESTimeline,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) where
            P: IsA<Timeline>,
        {
            let f: &F = &*(f as *const F);
            f(&Timeline::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::snapping-distance\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_snapping_distance_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }
}