gstreamer_editing_services/auto/

track.rs

// 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
#![allow(deprecated)]

use crate::{MetaContainer, Timeline, TrackElement, TrackType, ffi};
use glib::{
    object::ObjectType as _,
    prelude::*,
    signal::{SignalHandlerId, connect_raw},
    translate::*,
};
use std::boxed::Box as Box_;

glib::wrapper! {
    /// A [`Track`][crate::Track] acts an output source for a [`Timeline`][crate::Timeline]. Each one
    /// essentially provides an additional [`gst::Pad`][crate::gst::Pad] for the timeline, with
    /// [`restriction-caps`][struct@crate::Track#restriction-caps] capabilities. Internally, a track
    /// wraps an `nlecomposition` filtered by a `capsfilter`.
    ///
    /// A track will contain a number of [`TrackElement`][crate::TrackElement]-s, and its role is
    /// to select and activate these elements according to their timings when
    /// the timeline in played. For example, a track would activate a
    /// [`Source`][crate::Source] when its [`start`][struct@crate::TimelineElement#start] is reached by outputting
    /// its data for its [`duration`][struct@crate::TimelineElement#duration]. Similarly, a
    /// [`Operation`][crate::Operation] would be activated by applying its effect to the source
    /// data, starting from its [`start`][struct@crate::TimelineElement#start] time and lasting for
    /// its [`duration`][struct@crate::TimelineElement#duration].
    ///
    /// For most users, it will usually be sufficient to add newly created
    /// tracks to a timeline, but never directly add an element to a track.
    /// Whenever a [`Clip`][crate::Clip] is added to a timeline, the clip adds its
    /// elements to the timeline's tracks and assumes responsibility for
    /// updating them.
    ///
    /// ## Properties
    ///
    ///
    /// #### `caps`
    ///  The capabilities used to choose the output of the [`Track`][crate::Track]'s
    /// elements. Internally, this is used to select output streams when
    /// several may be available, by determining whether its [`gst::Pad`][crate::gst::Pad] is
    /// compatible (see `NleObject:caps` for `nlecomposition`). As such,
    /// this is used as a weaker indication of the desired output type of the
    /// track, **before** the [`restriction-caps`][struct@crate::Track#restriction-caps] is applied.
    /// Therefore, this should be set to a *generic* superset of the
    /// [`restriction-caps`][struct@crate::Track#restriction-caps], such as "video/x-raw(ANY)". In addition,
    /// it should match with the track's [`track-type`][struct@crate::Track#track-type].
    ///
    /// Note that when you set this property, the `GstCapsFeatures` of all its
    /// [`gst::Structure`][crate::gst::Structure]-s will be automatically set to `GST_CAPS_FEATURES_ANY`.
    ///
    /// Once a track has been added to a [`Timeline`][crate::Timeline], you should not change
    /// this.
    ///
    /// Default value: `GST_CAPS_ANY`.
    ///
    /// Readable | Writeable | Construct Only
    ///
    ///
    /// #### `duration`
    ///  Current duration of the track
    ///
    /// Default value: O
    ///
    /// Readable
    ///
    ///
    /// #### `id`
    ///  The `nlecomposition:id` of the underlying `nlecomposition`.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `mixing`
    ///  Whether the track should support the mixing of [`Layer`][crate::Layer] data, such
    /// as composing the video data of each layer (when part of the video
    /// data is transparent, the next layer will become visible) or adding
    /// together the audio data. As such, for audio and video tracks, you'll
    /// likely want to keep this set to [`true`].
    ///
    /// Readable | Writeable | Construct
    ///
    ///
    /// #### `restriction-caps`
    ///  The capabilities that specifies the final output format of the
    /// [`Track`][crate::Track]. For example, for a video track, it would specify the
    /// height, width, framerate and other properties of the stream.
    ///
    /// You may change this property after the track has been added to a
    /// [`Timeline`][crate::Timeline], but it must remain compatible with the track's
    /// [`caps`][struct@crate::Track#caps].
    ///
    /// Default value: `GST_CAPS_ANY`.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `track-type`
    ///  The track type of the track. This controls the type of
    /// [`TrackElement`][crate::TrackElement]-s that can be added to the track. This should
    /// match with the track's [`caps`][struct@crate::Track#caps].
    ///
    /// Once a track has been added to a [`Timeline`][crate::Timeline], you should not change
    /// this.
    ///
    /// Readable | Writeable | Construct Only
    /// <details><summary><h4>Bin</h4></summary>
    ///
    ///
    /// #### `async-handling`
    ///  If set to [`true`], the bin will handle asynchronous state changes.
    /// This should be used only if the bin subclass is modifying the state
    /// of its children on its own.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `message-forward`
    ///  Forward all children messages, even those that would normally be filtered by
    /// the bin. This can be interesting when one wants to be notified of the EOS
    /// state of individual elements, for example.
    ///
    /// The messages are converted to an ELEMENT message with the bin as the
    /// source. The structure of the message is named `GstBinForwarded` and contains
    /// a field named `message` that contains the original forwarded `GstMessage`.
    ///
    /// Readable | Writeable
    /// </details>
    /// <details><summary><h4>Object</h4></summary>
    ///
    ///
    /// #### `name`
    ///  Readable | Writeable | Construct
    ///
    ///
    /// #### `parent`
    ///  The parent of the object. Please note, that when changing the 'parent'
    /// property, we don't emit [`notify`][struct@crate::glib::Object#notify] and [`deep-notify`][struct@crate::gst::Object#deep-notify]
    /// signals due to locking issues. In some cases one can use
    /// [`element-added`][struct@crate::gst::Bin#element-added] or [`element-removed`][struct@crate::gst::Bin#element-removed] signals on the parent to
    /// achieve a similar effect.
    ///
    /// Readable | Writeable
    /// </details>
    ///
    /// ## Signals
    ///
    ///
    /// #### `commited`
    ///  This signal will be emitted once the changes initiated by
    /// [`GESTrackExt::commit()`][crate::prelude::GESTrackExt::commit()] have been executed in the backend. In particular,
    /// this will be emitted whenever the underlying `nlecomposition` has been
    /// committed (see `nlecomposition::commited`).
    ///
    ///
    ///
    ///
    /// #### `track-element-added`
    ///  Will be emitted after a track element is added to the track.
    ///
    ///
    ///
    ///
    /// #### `track-element-removed`
    ///  Will be emitted after a track element is removed from the track.
    ///
    ///
    /// <details><summary><h4>Bin</h4></summary>
    ///
    ///
    /// #### `deep-element-added`
    ///  Will be emitted after the element was added to `sub_bin`.
    ///
    ///
    ///
    ///
    /// #### `deep-element-removed`
    ///  Will be emitted after the element was removed from `sub_bin`.
    ///
    ///
    ///
    ///
    /// #### `do-latency`
    ///  Will be emitted when the bin needs to perform latency calculations. This
    /// signal is only emitted for toplevel bins or when [`async-handling`][struct@crate::gst::Bin#async-handling] is
    /// enabled.
    ///
    /// Only one signal handler is invoked. If no signals are connected, the
    /// default handler is invoked, which will query and distribute the lowest
    /// possible latency to all sinks.
    ///
    /// Connect to this signal if the default latency calculations are not
    /// sufficient, like when you need different latencies for different sinks in
    /// the same pipeline.
    ///
    ///
    ///
    ///
    /// #### `element-added`
    ///  Will be emitted after the element was added to the bin.
    ///
    ///
    ///
    ///
    /// #### `element-removed`
    ///  Will be emitted after the element was removed from the bin.
    ///
    ///
    /// </details>
    /// <details><summary><h4>Element</h4></summary>
    ///
    ///
    /// #### `no-more-pads`
    ///  This signals that the element will not generate more dynamic pads.
    /// Note that this signal will usually be emitted from the context of
    /// the streaming thread.
    ///
    ///
    ///
    ///
    /// #### `pad-added`
    ///  a new [`gst::Pad`][crate::gst::Pad] has been added to the element. Note that this signal will
    /// usually be emitted from the context of the streaming thread. Also keep in
    /// mind that if you add new elements to the pipeline in the signal handler
    /// you will need to set them to the desired target state with
    /// [`ElementExtManual::set_state()`][crate::gst::prelude::ElementExtManual::set_state()] or [`ElementExtManual::sync_state_with_parent()`][crate::gst::prelude::ElementExtManual::sync_state_with_parent()].
    ///
    ///
    ///
    ///
    /// #### `pad-removed`
    ///  a [`gst::Pad`][crate::gst::Pad] has been removed from the element
    ///
    ///
    /// </details>
    /// <details><summary><h4>Object</h4></summary>
    ///
    ///
    /// #### `deep-notify`
    ///  The deep notify signal is used to be notified of property changes. It is
    /// typically attached to the toplevel bin to receive notifications from all
    /// the elements contained in that bin.
    ///
    /// Detailed
    /// </details>
    /// <details><summary><h4>ChildProxy</h4></summary>
    ///
    ///
    /// #### `child-added`
    ///  Will be emitted after the `object` was added to the `child_proxy`.
    ///
    ///
    ///
    ///
    /// #### `child-removed`
    ///  Will be emitted after the `object` was removed from the `child_proxy`.
    ///
    ///
    /// </details>
    /// <details><summary><h4>MetaContainer</h4></summary>
    ///
    ///
    /// #### `notify-meta`
    ///  This is emitted for a meta container whenever the metadata under one
    /// of its fields changes, is set for the first time, or is removed. In
    /// the latter case, `value` will be [`None`].
    ///
    /// Detailed
    /// </details>
    ///
    /// # Implements
    ///
    /// [`GESTrackExt`][trait@crate::prelude::GESTrackExt], [`trait@gst::prelude::BinExt`], [`trait@gst::prelude::ElementExt`], [`trait@gst::prelude::GstObjectExt`], [`trait@glib::ObjectExt`], [`trait@gst::prelude::ChildProxyExt`], [`MetaContainerExt`][trait@crate::prelude::MetaContainerExt]
    #[doc(alias = "GESTrack")]
    pub struct Track(Object<ffi::GESTrack, ffi::GESTrackClass>) @extends gst::Bin, gst::Element, gst::Object, @implements gst::ChildProxy, MetaContainer;

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

impl Track {
    pub const NONE: Option<&'static Track> = None;

    /// Creates a new track with the given track-type and caps.
    ///
    /// If `type_` is [`TrackType::VIDEO`][crate::TrackType::VIDEO], and `caps` is a subset of
    /// "video/x-raw(ANY)", then a [`VideoTrack`][crate::VideoTrack] is created. This will
    /// automatically choose a gap creation method suitable for video data. You
    /// will likely want to set [`restriction-caps`][struct@crate::Track#restriction-caps] separately. You may
    /// prefer to use the [`VideoTrack::new()`][crate::VideoTrack::new()] method instead.
    ///
    /// If `type_` is [`TrackType::AUDIO`][crate::TrackType::AUDIO], and `caps` is a subset of
    /// "audio/x-raw(ANY)", then a [`AudioTrack`][crate::AudioTrack] is created. This will
    /// automatically choose a gap creation method suitable for audio data, and
    /// will set the [`restriction-caps`][struct@crate::Track#restriction-caps] to the default for
    /// [`AudioTrack`][crate::AudioTrack]. You may prefer to use the [`AudioTrack::new()`][crate::AudioTrack::new()] method
    /// instead.
    ///
    /// Otherwise, a plain [`Track`][crate::Track] is returned. You will likely want to set
    /// the [`restriction-caps`][struct@crate::Track#restriction-caps] and call
    /// `ges_track_set_create_element_for_gap_func()` on the returned track.
    /// ## `type_`
    /// The [`track-type`][struct@crate::Track#track-type] for the track
    /// ## `caps`
    /// The [`caps`][struct@crate::Track#caps] for the track
    ///
    /// # Returns
    ///
    /// A new track.
    #[doc(alias = "ges_track_new")]
    pub fn new(type_: TrackType, caps: gst::Caps) -> Track {
        assert_initialized_main_thread!();
        unsafe { from_glib_none(ffi::ges_track_new(type_.into_glib(), caps.into_glib_ptr())) }
    }
}

/// Trait containing all [`struct@Track`] methods.
///
/// # Implementors
///
/// [`AudioTrack`][struct@crate::AudioTrack], [`Track`][struct@crate::Track], [`VideoTrack`][struct@crate::VideoTrack]
pub trait GESTrackExt: IsA<Track> + 'static {
    /// See [`add_element()`][Self::add_element()], which also gives an error.
    /// ## `object`
    /// The element to add
    ///
    /// # Returns
    ///
    /// [`true`] if `object` was successfully added to `self`.
    #[doc(alias = "ges_track_add_element")]
    fn add_element(&self, object: &impl IsA<TrackElement>) -> Result<(), glib::error::BoolError> {
        unsafe {
            glib::result_from_gboolean!(
                ffi::ges_track_add_element(
                    self.as_ref().to_glib_none().0,
                    object.as_ref().to_glib_none().0
                ),
                "Failed to add element"
            )
        }
    }

    /// Adds the given track element to the track, which takes ownership of the
    /// element.
    ///
    /// Note that this can fail if it would break a configuration rule of the
    /// track's [`Timeline`][crate::Timeline].
    ///
    /// Note that a [`TrackElement`][crate::TrackElement] can only be added to one track.
    /// ## `object`
    /// The element to add
    ///
    /// # Returns
    ///
    /// [`true`] if `object` was successfully added to `self`.
    #[cfg(feature = "v1_18")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v1_18")))]
    #[doc(alias = "ges_track_add_element_full")]
    fn add_element_full(&self, object: &impl IsA<TrackElement>) -> Result<(), glib::Error> {
        unsafe {
            let mut error = std::ptr::null_mut();
            let is_ok = ffi::ges_track_add_element_full(
                self.as_ref().to_glib_none().0,
                object.as_ref().to_glib_none().0,
                &mut error,
            );
            debug_assert_eq!(is_ok == glib::ffi::GFALSE, !error.is_null());
            if error.is_null() {
                Ok(())
            } else {
                Err(from_glib_full(error))
            }
        }
    }

    /// Commits all the pending changes for the elements contained in the
    /// track.
    ///
    /// When changes are made to the timing or priority of elements within a
    /// track, they are not directly executed for the underlying
    /// `nlecomposition` and its children. This method will finally execute
    /// these changes so they are reflected in the data output of the track.
    ///
    /// Any pending changes will be executed in the backend. The
    /// [`commited`][struct@crate::Timeline#commited] signal will be emitted once this has completed.
    ///
    /// Note that [`TimelineExt::commit()`][crate::prelude::TimelineExt::commit()] will call this method on all of its
    /// tracks, so you are unlikely to need to use this directly.
    ///
    /// # Returns
    ///
    /// [`true`] if pending changes were committed, or [`false`] if nothing
    /// needed to be committed.
    #[doc(alias = "ges_track_commit")]
    fn commit(&self) -> bool {
        unsafe { from_glib(ffi::ges_track_commit(self.as_ref().to_glib_none().0)) }
    }

    /// Get the [`caps`][struct@crate::Track#caps] of the track.
    ///
    /// # Deprecated since 1.30
    ///
    /// Use [`caps_full()`][Self::caps_full()] instead for MT-safety.
    ///
    /// # Returns
    ///
    /// The caps of `self`.
    #[cfg_attr(feature = "v1_30", deprecated = "Since 1.30")]
    #[allow(deprecated)]
    #[doc(alias = "ges_track_get_caps")]
    #[doc(alias = "get_caps")]
    fn caps(&self) -> Option<gst::Caps> {
        unsafe { from_glib_none(ffi::ges_track_get_caps(self.as_ref().to_glib_none().0)) }
    }

    /// Get the [`caps`][struct@crate::Track#caps] of the track.
    ///
    /// # Returns
    ///
    /// The caps of `self`.
    #[cfg(feature = "v1_30")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v1_30")))]
    #[doc(alias = "ges_track_get_caps_full")]
    #[doc(alias = "get_caps_full")]
    fn caps_full(&self) -> Option<gst::Caps> {
        unsafe { from_glib_full(ffi::ges_track_get_caps_full(self.as_ref().to_glib_none().0)) }
    }

    /// Gets the track elements contained in the track. The returned list is
    /// sorted by the element's [`priority`][struct@crate::TimelineElement#priority] and
    /// [`start`][struct@crate::TimelineElement#start].
    ///
    /// # Returns
    ///
    /// A list of
    /// all the [`TrackElement`][crate::TrackElement]-s in `self`.
    #[doc(alias = "ges_track_get_elements")]
    #[doc(alias = "get_elements")]
    fn elements(&self) -> Vec<TrackElement> {
        unsafe {
            FromGlibPtrContainer::from_glib_full(ffi::ges_track_get_elements(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Gets the [`mixing`][struct@crate::Track#mixing] of the track.
    ///
    /// # Returns
    ///
    /// Whether `self` is mixing.
    #[doc(alias = "ges_track_get_mixing")]
    #[doc(alias = "get_mixing")]
    #[doc(alias = "mixing")]
    fn is_mixing(&self) -> bool {
        unsafe { from_glib(ffi::ges_track_get_mixing(self.as_ref().to_glib_none().0)) }
    }

    /// Gets the [`restriction-caps`][struct@crate::Track#restriction-caps] of the track.
    ///
    /// # Returns
    ///
    /// The restriction-caps of `self`.
    #[cfg(feature = "v1_18")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v1_18")))]
    #[doc(alias = "ges_track_get_restriction_caps")]
    #[doc(alias = "get_restriction_caps")]
    #[doc(alias = "restriction-caps")]
    fn restriction_caps(&self) -> Option<gst::Caps> {
        unsafe {
            from_glib_full(ffi::ges_track_get_restriction_caps(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Get the timeline this track belongs to.
    ///
    /// # Deprecated since 1.30
    ///
    /// Use [`timeline_full()`][Self::timeline_full()] instead for MT-safety.
    ///
    /// # Returns
    ///
    /// The timeline that `self` belongs to, or [`None`] if
    /// it does not belong to a timeline.
    #[cfg_attr(feature = "v1_30", deprecated = "Since 1.30")]
    #[allow(deprecated)]
    #[doc(alias = "ges_track_get_timeline")]
    #[doc(alias = "get_timeline")]
    fn timeline(&self) -> Option<Timeline> {
        unsafe { from_glib_none(ffi::ges_track_get_timeline(self.as_ref().to_glib_none().0)) }
    }

    /// Get the timeline this track belongs to.
    ///
    /// # Returns
    ///
    /// The timeline that `self` belongs to,
    /// or [`None`] if it does not belong to a timeline.
    #[cfg(feature = "v1_30")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v1_30")))]
    #[doc(alias = "ges_track_get_timeline_full")]
    #[doc(alias = "get_timeline_full")]
    fn timeline_full(&self) -> Option<Timeline> {
        unsafe {
            from_glib_full(ffi::ges_track_get_timeline_full(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// See [`remove_element_full()`][Self::remove_element_full()], which also returns an error.
    /// ## `object`
    /// The element to remove
    ///
    /// # Returns
    ///
    /// [`true`] if `object` was successfully removed from `self`.
    #[doc(alias = "ges_track_remove_element")]
    fn remove_element(
        &self,
        object: &impl IsA<TrackElement>,
    ) -> Result<(), glib::error::BoolError> {
        unsafe {
            glib::result_from_gboolean!(
                ffi::ges_track_remove_element(
                    self.as_ref().to_glib_none().0,
                    object.as_ref().to_glib_none().0
                ),
                "Failed to remove element"
            )
        }
    }

    /// Removes the given track element from the track, which revokes
    /// ownership of the element.
    /// ## `object`
    /// The element to remove
    ///
    /// # Returns
    ///
    /// [`true`] if `object` was successfully removed from `self`.
    #[cfg(feature = "v1_18")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v1_18")))]
    #[doc(alias = "ges_track_remove_element_full")]
    fn remove_element_full(&self, object: &impl IsA<TrackElement>) -> Result<(), glib::Error> {
        unsafe {
            let mut error = std::ptr::null_mut();
            let is_ok = ffi::ges_track_remove_element_full(
                self.as_ref().to_glib_none().0,
                object.as_ref().to_glib_none().0,
                &mut error,
            );
            debug_assert_eq!(is_ok == glib::ffi::GFALSE, !error.is_null());
            if error.is_null() {
                Ok(())
            } else {
                Err(from_glib_full(error))
            }
        }
    }

    //#[doc(alias = "ges_track_set_create_element_for_gap_func")]
    //fn set_create_element_for_gap_func<P: Fn() -> gst::Element + 'static>(&self, func: P) {
    //    unsafe { TODO: call ffi:ges_track_set_create_element_for_gap_func() }
    //}

    /// Sets the [`mixing`][struct@crate::Track#mixing] for the track.
    /// ## `mixing`
    /// Whether `self` should be mixing
    #[doc(alias = "ges_track_set_mixing")]
    #[doc(alias = "mixing")]
    fn set_mixing(&self, mixing: bool) {
        unsafe {
            ffi::ges_track_set_mixing(self.as_ref().to_glib_none().0, mixing.into_glib());
        }
    }

    /// Sets the [`restriction-caps`][struct@crate::Track#restriction-caps] for the track.
    ///
    /// > **NOTE**: Restriction caps are **not** taken into account when
    /// > using [`mode`][struct@crate::Pipeline#mode]=[`PipelineFlags::SMART_RENDER`][crate::PipelineFlags::SMART_RENDER].
    /// ## `caps`
    /// The new restriction-caps for `self`
    #[doc(alias = "ges_track_set_restriction_caps")]
    #[doc(alias = "restriction-caps")]
    fn set_restriction_caps(&self, caps: &gst::Caps) {
        unsafe {
            ffi::ges_track_set_restriction_caps(
                self.as_ref().to_glib_none().0,
                caps.to_glib_none().0,
            );
        }
    }

    /// Informs the track that it belongs to the given timeline. Calling this
    /// does not actually add the track to the timeline. For that, you should
    /// use [`TimelineExt::add_track()`][crate::prelude::TimelineExt::add_track()], which will also take care of informing
    /// the track that it belongs to the timeline. As such, there is no need
    /// for you to call this method.
    #[doc(alias = "ges_track_set_timeline")]
    fn set_timeline(&self, timeline: &impl IsA<Timeline>) {
        unsafe {
            ffi::ges_track_set_timeline(
                self.as_ref().to_glib_none().0,
                timeline.as_ref().to_glib_none().0,
            );
        }
    }

    /// Updates the [`restriction-caps`][struct@crate::Track#restriction-caps] of the track using the fields
    /// found in the given caps. Each of the [`gst::Structure`][crate::gst::Structure]-s in `caps` is
    /// compared against the existing structure with the same index in the
    /// current [`restriction-caps`][struct@crate::Track#restriction-caps]. If there is no corresponding
    /// existing structure at that index, then the new structure is simply
    /// copied to that index. Otherwise, any fields in the new structure are
    /// copied into the existing structure. This will replace existing values,
    /// and may introduce new ones, but any fields 'missing' in the new
    /// structure are left unchanged in the existing structure.
    ///
    /// For example, if the existing [`restriction-caps`][struct@crate::Track#restriction-caps] are
    /// "video/x-raw, width=480, height=360", and the updating caps is
    /// "video/x-raw, format=I420, width=500; video/x-bayer, width=400", then
    /// the new [`restriction-caps`][struct@crate::Track#restriction-caps] after calling this will be
    /// "video/x-raw, width=500, height=360, format=I420; video/x-bayer,
    /// width=400".
    /// ## `caps`
    /// The caps to update the restriction-caps with
    #[doc(alias = "ges_track_update_restriction_caps")]
    fn update_restriction_caps(&self, caps: &gst::Caps) {
        unsafe {
            ffi::ges_track_update_restriction_caps(
                self.as_ref().to_glib_none().0,
                caps.to_glib_none().0,
            );
        }
    }

    /// Current duration of the track
    ///
    /// Default value: O
    fn duration(&self) -> u64 {
        ObjectExt::property(self.as_ref(), "duration")
    }

    /// The `nlecomposition:id` of the underlying `nlecomposition`.
    #[cfg(feature = "v1_18")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v1_18")))]
    fn id(&self) -> Option<glib::GString> {
        ObjectExt::property(self.as_ref(), "id")
    }

    /// The `nlecomposition:id` of the underlying `nlecomposition`.
    #[cfg(feature = "v1_18")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v1_18")))]
    fn set_id(&self, id: Option<&str>) {
        ObjectExt::set_property(self.as_ref(), "id", id)
    }

    #[cfg(not(feature = "v1_18"))]
    #[cfg_attr(docsrs, doc(cfg(not(feature = "v1_18"))))]
    #[doc(alias = "restriction-caps")]
    fn restriction_caps(&self) -> Option<gst::Caps> {
        ObjectExt::property(self.as_ref(), "restriction-caps")
    }

    /// The track type of the track. This controls the type of
    /// [`TrackElement`][crate::TrackElement]-s that can be added to the track. This should
    /// match with the track's [`caps`][struct@crate::Track#caps].
    ///
    /// Once a track has been added to a [`Timeline`][crate::Timeline], you should not change
    /// this.
    #[doc(alias = "track-type")]
    fn track_type(&self) -> TrackType {
        ObjectExt::property(self.as_ref(), "track-type")
    }

    /// This signal will be emitted once the changes initiated by
    /// [`commit()`][Self::commit()] have been executed in the backend. In particular,
    /// this will be emitted whenever the underlying `nlecomposition` has been
    /// committed (see `nlecomposition::commited`).
    #[doc(alias = "commited")]
    fn connect_commited<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn commited_trampoline<P: IsA<Track>, F: Fn(&P) + 'static>(
            this: *mut ffi::GESTrack,
            f: glib::ffi::gpointer,
        ) {
            unsafe {
                let f: &F = &*(f as *const F);
                f(Track::from_glib_borrow(this).unsafe_cast_ref())
            }
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                c"commited".as_ptr(),
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    commited_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    /// Will be emitted after a track element is added to the track.
    /// ## `effect`
    /// The element that was added
    #[doc(alias = "track-element-added")]
    fn connect_track_element_added<F: Fn(&Self, &TrackElement) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn track_element_added_trampoline<
            P: IsA<Track>,
            F: Fn(&P, &TrackElement) + 'static,
        >(
            this: *mut ffi::GESTrack,
            effect: *mut ffi::GESTrackElement,
            f: glib::ffi::gpointer,
        ) {
            unsafe {
                let f: &F = &*(f as *const F);
                f(
                    Track::from_glib_borrow(this).unsafe_cast_ref(),
                    &from_glib_borrow(effect),
                )
            }
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                c"track-element-added".as_ptr(),
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    track_element_added_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    /// Will be emitted after a track element is removed from the track.
    /// ## `effect`
    /// The element that was removed
    #[doc(alias = "track-element-removed")]
    fn connect_track_element_removed<F: Fn(&Self, &TrackElement) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn track_element_removed_trampoline<
            P: IsA<Track>,
            F: Fn(&P, &TrackElement) + 'static,
        >(
            this: *mut ffi::GESTrack,
            effect: *mut ffi::GESTrackElement,
            f: glib::ffi::gpointer,
        ) {
            unsafe {
                let f: &F = &*(f as *const F);
                f(
                    Track::from_glib_borrow(this).unsafe_cast_ref(),
                    &from_glib_borrow(effect),
                )
            }
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                c"track-element-removed".as_ptr(),
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    track_element_removed_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: IsA<Track>, F: Fn(&P) + 'static>(
            this: *mut ffi::GESTrack,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            unsafe {
                let f: &F = &*(f as *const F);
                f(Track::from_glib_borrow(this).unsafe_cast_ref())
            }
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                c"notify::duration".as_ptr(),
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    notify_duration_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[cfg(feature = "v1_18")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v1_18")))]
    #[doc(alias = "id")]
    fn connect_id_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_id_trampoline<P: IsA<Track>, F: Fn(&P) + 'static>(
            this: *mut ffi::GESTrack,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            unsafe {
                let f: &F = &*(f as *const F);
                f(Track::from_glib_borrow(this).unsafe_cast_ref())
            }
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                c"notify::id".as_ptr(),
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    notify_id_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "mixing")]
    fn connect_mixing_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_mixing_trampoline<P: IsA<Track>, F: Fn(&P) + 'static>(
            this: *mut ffi::GESTrack,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            unsafe {
                let f: &F = &*(f as *const F);
                f(Track::from_glib_borrow(this).unsafe_cast_ref())
            }
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                c"notify::mixing".as_ptr(),
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    notify_mixing_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "restriction-caps")]
    fn connect_restriction_caps_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_restriction_caps_trampoline<
            P: IsA<Track>,
            F: Fn(&P) + 'static,
        >(
            this: *mut ffi::GESTrack,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            unsafe {
                let f: &F = &*(f as *const F);
                f(Track::from_glib_borrow(this).unsafe_cast_ref())
            }
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                c"notify::restriction-caps".as_ptr(),
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    notify_restriction_caps_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }
}

impl<O: IsA<Track>> GESTrackExt for O {}