// 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

#[cfg(feature = "v1_18")]
#[cfg_attr(docsrs, doc(cfg(feature = "v1_18")))]
use crate::FrameNumber;
use crate::{ffi, Asset, MetaContainer, TrackType};
use glib::{
    prelude::*,
    signal::{connect_raw, SignalHandlerId},
    translate::*,
};
use std::boxed::Box as Box_;

glib::wrapper! {
    /// The [`UriClipAsset`][crate::UriClipAsset] is a special [`Asset`][crate::Asset] specilized in [`Clip`][crate::Clip].
    /// it is mostly used to get information about the [`TrackType`][crate::TrackType]-s the objects extracted
    /// from it can potentialy create [`TrackElement`][crate::TrackElement] for.
    ///
    /// ## Properties
    ///
    ///
    /// #### `supported-formats`
    ///  The formats supported by the asset.
    ///
    /// Readable | Writeable | Construct
    /// <details><summary><h4>Asset</h4></summary>
    ///
    ///
    /// #### `extractable-type`
    ///  The [`Extractable`][crate::Extractable] object type that can be extracted from the asset.
    ///
    /// Readable | Writeable | Construct Only
    ///
    ///
    /// #### `id`
    ///  The ID of the asset. This should be unique amongst all assets with
    /// the same [`extractable-type`][struct@crate::Asset#extractable-type]. Depending on the associated
    /// [`Extractable`][crate::Extractable] implementation, this id may convey some information
    /// about the [`glib::Object`][crate::glib::Object] that should be extracted. Note that, as such, the
    /// ID will have an expected format, and you can not choose this value
    /// arbitrarily. By default, this will be set to the type name of the
    /// [`extractable-type`][struct@crate::Asset#extractable-type], but you should check the documentation
    /// of the extractable type to see whether they differ from the
    /// default behaviour.
    ///
    /// Readable | Writeable | Construct Only
    ///
    ///
    /// #### `proxy`
    ///  The default proxy for this asset, or [`None`] if it has no proxy. A
    /// proxy will act as a substitute for the original asset when the
    /// original is requested (see [`Asset::request()`][crate::Asset::request()]).
    ///
    /// Setting this property will not usually remove the existing proxy, but
    /// will replace it as the default (see [`AssetExt::set_proxy()`][crate::prelude::AssetExt::set_proxy()]).
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `proxy-target`
    ///  The asset that this asset is a proxy for, or [`None`] if it is not a
    /// proxy for another asset.
    ///
    /// Note that even if this asset is acting as a proxy for another asset,
    /// but this asset is not the default [`proxy`][struct@crate::Asset#proxy], then `proxy`-target
    /// will *still* point to this other asset. So you should check the
    /// [`proxy`][struct@crate::Asset#proxy] property of `target`-proxy before assuming it is the
    /// current default proxy for the target.
    ///
    /// Note that the [`notify`][struct@crate::glib::Object#notify] for this property is emitted after
    /// the [`proxy`][struct@crate::Asset#proxy] [`notify`][struct@crate::glib::Object#notify] for the corresponding (if any)
    /// asset it is now the proxy of/no longer the proxy of.
    ///
    /// Readable
    /// </details>
    ///
    /// # Implements
    ///
    /// [`ClipAssetExt`][trait@crate::prelude::ClipAssetExt], [`AssetExt`][trait@crate::prelude::AssetExt], [`trait@glib::ObjectExt`], [`MetaContainerExt`][trait@crate::prelude::MetaContainerExt]
    #[doc(alias = "GESClipAsset")]
    pub struct ClipAsset(Object<ffi::GESClipAsset, ffi::GESClipAssetClass>) @extends Asset, @implements MetaContainer;

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

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

unsafe impl Send for ClipAsset {}
unsafe impl Sync for ClipAsset {}

mod sealed {
    pub trait Sealed {}
    impl<T: super::IsA<super::ClipAsset>> Sealed for T {}
}

/// Trait containing all [`struct@ClipAsset`] methods.
///
/// # Implementors
///
/// [`ClipAsset`][struct@crate::ClipAsset], [`SourceClipAsset`][struct@crate::SourceClipAsset]
pub trait ClipAssetExt: IsA<ClipAsset> + sealed::Sealed + 'static {
    /// Converts the given frame number into a timestamp, using the "natural" frame
    /// rate of the asset.
    ///
    /// You can use this to reference a specific frame in a media file and use this
    /// as, for example, the `in-point` or `max-duration` of a [`Clip`][crate::Clip].
    /// ## `frame_number`
    /// The frame number we want the internal time coordinate timestamp of
    ///
    /// # Returns
    ///
    /// The timestamp corresponding to `frame_number` in the element source, given
    /// in internal time coordinates, or `GST_CLOCK_TIME_NONE` if the clip asset does not have a
    /// natural frame rate.
    #[cfg(feature = "v1_18")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v1_18")))]
    #[doc(alias = "ges_clip_asset_get_frame_time")]
    #[doc(alias = "get_frame_time")]
    fn frame_time(&self, frame_number: FrameNumber) -> Option<gst::ClockTime> {
        unsafe {
            from_glib(ffi::ges_clip_asset_get_frame_time(
                self.as_ref().to_glib_none().0,
                frame_number,
            ))
        }
    }

    /// Result: [`true`] if `self` has a natural framerate [`false`] otherwise
    ///
    /// # Returns
    ///
    ///
    /// ## `framerate_n`
    /// The framerate numerator
    ///
    /// ## `framerate_d`
    /// The framerate denominator
    #[cfg(feature = "v1_18")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v1_18")))]
    #[doc(alias = "ges_clip_asset_get_natural_framerate")]
    #[doc(alias = "get_natural_framerate")]
    fn natural_framerate(&self) -> Option<(i32, i32)> {
        unsafe {
            let mut framerate_n = std::mem::MaybeUninit::uninit();
            let mut framerate_d = std::mem::MaybeUninit::uninit();
            let ret = from_glib(ffi::ges_clip_asset_get_natural_framerate(
                self.as_ref().to_glib_none().0,
                framerate_n.as_mut_ptr(),
                framerate_d.as_mut_ptr(),
            ));
            if ret {
                Some((framerate_n.assume_init(), framerate_d.assume_init()))
            } else {
                None
            }
        }
    }

    /// Gets track types for which objects extracted from `self` can create [`TrackElement`][crate::TrackElement]
    ///
    /// # Returns
    ///
    /// The track types on which `self` will create TrackElement when added to
    /// a layer
    #[doc(alias = "ges_clip_asset_get_supported_formats")]
    #[doc(alias = "get_supported_formats")]
    #[doc(alias = "supported-formats")]
    fn supported_formats(&self) -> TrackType {
        unsafe {
            from_glib(ffi::ges_clip_asset_get_supported_formats(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Sets track types for which objects extracted from `self` can create [`TrackElement`][crate::TrackElement]
    /// ## `supportedformats`
    /// The track types supported by the GESClipAsset
    #[doc(alias = "ges_clip_asset_set_supported_formats")]
    #[doc(alias = "supported-formats")]
    fn set_supported_formats(&self, supportedformats: TrackType) {
        unsafe {
            ffi::ges_clip_asset_set_supported_formats(
                self.as_ref().to_glib_none().0,
                supportedformats.into_glib(),
            );
        }
    }

    #[doc(alias = "supported-formats")]
    fn connect_supported_formats_notify<F: Fn(&Self) + Send + Sync + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn notify_supported_formats_trampoline<
            P: IsA<ClipAsset>,
            F: Fn(&P) + Send + Sync + 'static,
        >(
            this: *mut ffi::GESClipAsset,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(ClipAsset::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::supported-formats\0".as_ptr() as *const _,
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    notify_supported_formats_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }
}

impl<O: IsA<ClipAsset>> ClipAssetExt for O {}