gstreamer_editing_services/auto/

meta_container.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)]

#[cfg(feature = "v1_18")]
#[cfg_attr(docsrs, doc(cfg(feature = "v1_18")))]
use crate::MarkerList;
use crate::{MetaFlag, ffi};
use glib::{
    object::ObjectType as _,
    prelude::*,
    signal::{SignalHandlerId, connect_raw},
    translate::*,
};
use std::boxed::Box as Box_;

glib::wrapper! {
    /// A [`glib::Object`][crate::glib::Object] that implements [`MetaContainer`][crate::MetaContainer] can have metadata set on
    /// it, that is data that is unimportant to its function within GES, but
    /// may hold some useful information. In particular,
    /// [`MetaContainerExt::set_meta()`][crate::prelude::MetaContainerExt::set_meta()] can be used to store any [`glib::Value`][crate::glib::Value] under
    /// any generic field (specified by a string key). The same method can also
    /// be used to remove the field by passing [`None`]. A number of convenience
    /// methods are also provided to make it easier to set common value types.
    /// The metadata can then be read with [`MetaContainerExt::meta()`][crate::prelude::MetaContainerExt::meta()] and
    /// similar convenience methods.
    ///
    /// ## Registered Fields
    ///
    /// By default, any [`glib::Value`][crate::glib::Value] can be set for a metadata field. However, you
    /// can register some fields as static, that is they only allow values of a
    /// specific type to be set under them, using
    /// [`MetaContainerExt::register_meta()`][crate::prelude::MetaContainerExt::register_meta()] or
    /// [`MetaContainerExt::register_static_meta()`][crate::prelude::MetaContainerExt::register_static_meta()]. The set [`MetaFlag`][crate::MetaFlag] will
    /// determine whether the value can be changed, but even if it can be
    /// changed, it must be changed to a value of the same type.
    ///
    /// Internally, some GES objects will be initialized with static metadata
    /// fields. These will correspond to some standard keys, such as
    /// `GES_META_VOLUME`.
    ///
    /// ## Signals
    ///
    ///
    /// #### `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
    ///
    /// # Implements
    ///
    /// [`MetaContainerExt`][trait@crate::prelude::MetaContainerExt]
    #[doc(alias = "GESMetaContainer")]
    pub struct MetaContainer(Interface<ffi::GESMetaContainer, ffi::GESMetaContainerInterface>);

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

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

/// Trait containing all [`struct@MetaContainer`] methods.
///
/// # Implementors
///
/// [`Asset`][struct@crate::Asset], [`AudioSource`][struct@crate::AudioSource], [`AudioTestSource`][struct@crate::AudioTestSource], [`AudioTrack`][struct@crate::AudioTrack], [`AudioTransition`][struct@crate::AudioTransition], [`AudioUriSource`][struct@crate::AudioUriSource], [`BaseEffectClip`][struct@crate::BaseEffectClip], [`BaseEffect`][struct@crate::BaseEffect], [`BaseTransitionClip`][struct@crate::BaseTransitionClip], [`ClipAsset`][struct@crate::ClipAsset], [`Clip`][struct@crate::Clip], [`Container`][struct@crate::Container], [`EffectAsset`][struct@crate::EffectAsset], [`EffectClip`][struct@crate::EffectClip], [`Effect`][struct@crate::Effect], [`Group`][struct@crate::Group], [`ImageSource`][struct@crate::ImageSource], [`Layer`][struct@crate::Layer], [`Marker`][struct@crate::Marker], [`MetaContainer`][struct@crate::MetaContainer], [`MultiFileSource`][struct@crate::MultiFileSource], [`OperationClip`][struct@crate::OperationClip], [`Operation`][struct@crate::Operation], [`OverlayClip`][struct@crate::OverlayClip], [`Project`][struct@crate::Project], [`SourceClipAsset`][struct@crate::SourceClipAsset], [`SourceClip`][struct@crate::SourceClip], [`Source`][struct@crate::Source], [`TestClip`][struct@crate::TestClip], [`TextOverlayClip`][struct@crate::TextOverlayClip], [`TextOverlay`][struct@crate::TextOverlay], [`TimelineElement`][struct@crate::TimelineElement], [`Timeline`][struct@crate::Timeline], [`TitleClip`][struct@crate::TitleClip], [`TitleSource`][struct@crate::TitleSource], [`TrackElementAsset`][struct@crate::TrackElementAsset], [`TrackElement`][struct@crate::TrackElement], [`Track`][struct@crate::Track], [`TransitionClip`][struct@crate::TransitionClip], [`Transition`][struct@crate::Transition], [`UriClipAsset`][struct@crate::UriClipAsset], [`UriClip`][struct@crate::UriClip], [`UriSourceAsset`][struct@crate::UriSourceAsset], [`VideoSource`][struct@crate::VideoSource], [`VideoTestSource`][struct@crate::VideoTestSource], [`VideoTrack`][struct@crate::VideoTrack], [`VideoTransition`][struct@crate::VideoTransition], [`VideoUriSource`][struct@crate::VideoUriSource]
pub trait MetaContainerExt: IsA<MetaContainer> + 'static {
    /// Deserializes the given string, and adds and sets the found fields and
    /// their values on the container. The string should be the return of
    /// [`metas_to_string()`][Self::metas_to_string()].
    /// ## `str`
    /// A string to deserialize and add to `self`
    ///
    /// # Returns
    ///
    /// [`true`] if the fields in `str` was successfully deserialized
    /// and added to `self`.
    #[doc(alias = "ges_meta_container_add_metas_from_string")]
    fn add_metas_from_string(&self, str: &str) -> bool {
        unsafe {
            from_glib(ffi::ges_meta_container_add_metas_from_string(
                self.as_ref().to_glib_none().0,
                str.to_glib_none().0,
            ))
        }
    }

    /// Checks whether the specified field has been registered as static, and
    /// gets the registered type and flags of the field, as used in
    /// [`register_meta()`][Self::register_meta()] and
    /// [`register_static_meta()`][Self::register_static_meta()].
    /// ## `meta_item`
    /// The key for the `self` field to check
    ///
    /// # Returns
    ///
    /// [`true`] if the `meta_item` field has been registered on
    /// `self`.
    ///
    /// ## `flags`
    /// A destination to get the registered flags of
    /// the field, or [`None`] to ignore
    ///
    /// ## `type_`
    /// A destination to get the registered type of
    /// the field, or [`None`] to ignore
    #[doc(alias = "ges_meta_container_check_meta_registered")]
    fn check_meta_registered(&self, meta_item: &str) -> Option<(MetaFlag, glib::types::Type)> {
        unsafe {
            let mut flags = std::mem::MaybeUninit::uninit();
            let mut type_ = std::mem::MaybeUninit::uninit();
            let ret = from_glib(ffi::ges_meta_container_check_meta_registered(
                self.as_ref().to_glib_none().0,
                meta_item.to_glib_none().0,
                flags.as_mut_ptr(),
                type_.as_mut_ptr(),
            ));
            if ret {
                Some((
                    from_glib(flags.assume_init()),
                    from_glib(type_.assume_init()),
                ))
            } else {
                None
            }
        }
    }

    /// Calls the given function on each of the meta container's set metadata
    /// fields.
    /// ## `func`
    /// A function to call on each of
    ///  `self`'s set metadata fields
    #[doc(alias = "ges_meta_container_foreach")]
    fn foreach<P: FnMut(&MetaContainer, &str, &glib::Value)>(&self, func: P) {
        let mut func_data: P = func;
        unsafe extern "C" fn func_func<P: FnMut(&MetaContainer, &str, &glib::Value)>(
            container: *const ffi::GESMetaContainer,
            key: *const std::ffi::c_char,
            value: *const glib::gobject_ffi::GValue,
            user_data: glib::ffi::gpointer,
        ) {
            unsafe {
                let container = from_glib_borrow(container);
                let key: Borrowed<glib::GString> = from_glib_borrow(key);
                let value = from_glib_borrow(value);
                let callback = user_data as *mut P;
                (*callback)(&container, key.as_str(), &value)
            }
        }
        let func = Some(func_func::<P> as _);
        let super_callback0: &mut P = &mut func_data;
        unsafe {
            ffi::ges_meta_container_foreach(
                self.as_ref().to_glib_none().0,
                func,
                super_callback0 as *mut _ as *mut _,
            );
        }
    }

    /// Gets the current boolean value of the specified field of the meta
    /// container. If the field does not have a set value, or it is of the
    /// wrong type, the method will fail.
    /// ## `meta_item`
    /// The key for the `self` field to get
    ///
    /// # Returns
    ///
    /// [`true`] if the boolean value under `meta_item` was copied
    /// to `dest`.
    ///
    /// ## `dest`
    /// Destination into which the value under `meta_item`
    /// should be copied.
    #[doc(alias = "ges_meta_container_get_boolean")]
    #[doc(alias = "get_boolean")]
    fn boolean(&self, meta_item: &str) -> Option<bool> {
        unsafe {
            let mut dest = std::mem::MaybeUninit::uninit();
            let ret = from_glib(ffi::ges_meta_container_get_boolean(
                self.as_ref().to_glib_none().0,
                meta_item.to_glib_none().0,
                dest.as_mut_ptr(),
            ));
            if ret {
                Some(from_glib(dest.assume_init()))
            } else {
                None
            }
        }
    }

    /// Gets the current date value of the specified field of the meta
    /// container. If the field does not have a set value, or it is of the
    /// wrong type, the method will fail.
    /// ## `meta_item`
    /// The key for the `self` field to get
    ///
    /// # Returns
    ///
    /// [`true`] if the date value under `meta_item` was copied
    /// to `dest`.
    ///
    /// ## `dest`
    /// Destination into which the value under `meta_item`
    /// should be copied.
    #[doc(alias = "ges_meta_container_get_date")]
    #[doc(alias = "get_date")]
    fn date(&self, meta_item: &str) -> Option<glib::Date> {
        unsafe {
            let mut dest = std::ptr::null_mut();
            let ret = from_glib(ffi::ges_meta_container_get_date(
                self.as_ref().to_glib_none().0,
                meta_item.to_glib_none().0,
                &mut dest,
            ));
            if ret {
                Some(from_glib_full(dest))
            } else {
                None
            }
        }
    }

    /// Gets the current date time value of the specified field of the meta
    /// container. If the field does not have a set value, or it is of the
    /// wrong type, the method will fail.
    /// ## `meta_item`
    /// The key for the `self` field to get
    ///
    /// # Returns
    ///
    /// [`true`] if the date time value under `meta_item` was copied
    /// to `dest`.
    ///
    /// ## `dest`
    /// Destination into which the value under `meta_item`
    /// should be copied.
    #[doc(alias = "ges_meta_container_get_date_time")]
    #[doc(alias = "get_date_time")]
    fn date_time(&self, meta_item: &str) -> Option<gst::DateTime> {
        unsafe {
            let mut dest = std::ptr::null_mut();
            let ret = from_glib(ffi::ges_meta_container_get_date_time(
                self.as_ref().to_glib_none().0,
                meta_item.to_glib_none().0,
                &mut dest,
            ));
            if ret {
                Some(from_glib_full(dest))
            } else {
                None
            }
        }
    }

    /// Gets the current double value of the specified field of the meta
    /// container. If the field does not have a set value, or it is of the
    /// wrong type, the method will fail.
    /// ## `meta_item`
    /// The key for the `self` field to get
    ///
    /// # Returns
    ///
    /// [`true`] if the double value under `meta_item` was copied
    /// to `dest`.
    ///
    /// ## `dest`
    /// Destination into which the value under `meta_item`
    /// should be copied.
    #[doc(alias = "ges_meta_container_get_double")]
    #[doc(alias = "get_double")]
    fn double(&self, meta_item: &str) -> Option<f64> {
        unsafe {
            let mut dest = std::mem::MaybeUninit::uninit();
            let ret = from_glib(ffi::ges_meta_container_get_double(
                self.as_ref().to_glib_none().0,
                meta_item.to_glib_none().0,
                dest.as_mut_ptr(),
            ));
            if ret { Some(dest.assume_init()) } else { None }
        }
    }

    /// Gets the current float value of the specified field of the meta
    /// container. If the field does not have a set value, or it is of the
    /// wrong type, the method will fail.
    /// ## `meta_item`
    /// The key for the `self` field to get
    ///
    /// # Returns
    ///
    /// [`true`] if the float value under `meta_item` was copied
    /// to `dest`.
    ///
    /// ## `dest`
    /// Destination into which the value under `meta_item`
    /// should be copied.
    #[doc(alias = "ges_meta_container_get_float")]
    #[doc(alias = "get_float")]
    fn float(&self, meta_item: &str) -> Option<f32> {
        unsafe {
            let mut dest = std::mem::MaybeUninit::uninit();
            let ret = from_glib(ffi::ges_meta_container_get_float(
                self.as_ref().to_glib_none().0,
                meta_item.to_glib_none().0,
                dest.as_mut_ptr(),
            ));
            if ret { Some(dest.assume_init()) } else { None }
        }
    }

    /// Gets the current int value of the specified field of the meta
    /// container. If the field does not have a set value, or it is of the
    /// wrong type, the method will fail.
    /// ## `meta_item`
    /// The key for the `self` field to get
    ///
    /// # Returns
    ///
    /// [`true`] if the int value under `meta_item` was copied
    /// to `dest`.
    ///
    /// ## `dest`
    /// Destination into which the value under `meta_item`
    /// should be copied.
    #[doc(alias = "ges_meta_container_get_int")]
    #[doc(alias = "get_int")]
    fn int(&self, meta_item: &str) -> Option<i32> {
        unsafe {
            let mut dest = std::mem::MaybeUninit::uninit();
            let ret = from_glib(ffi::ges_meta_container_get_int(
                self.as_ref().to_glib_none().0,
                meta_item.to_glib_none().0,
                dest.as_mut_ptr(),
            ));
            if ret { Some(dest.assume_init()) } else { None }
        }
    }

    /// Gets the current int64 value of the specified field of the meta
    /// container. If the field does not have a set value, or it is of the
    /// wrong type, the method will fail.
    /// ## `meta_item`
    /// The key for the `self` field to get
    ///
    /// # Returns
    ///
    /// [`true`] if the int64 value under `meta_item` was copied
    /// to `dest`.
    ///
    /// ## `dest`
    /// Destination into which the value under `meta_item`
    /// should be copied.
    #[doc(alias = "ges_meta_container_get_int64")]
    #[doc(alias = "get_int64")]
    fn int64(&self, meta_item: &str) -> Option<i64> {
        unsafe {
            let mut dest = std::mem::MaybeUninit::uninit();
            let ret = from_glib(ffi::ges_meta_container_get_int64(
                self.as_ref().to_glib_none().0,
                meta_item.to_glib_none().0,
                dest.as_mut_ptr(),
            ));
            if ret { Some(dest.assume_init()) } else { None }
        }
    }

    /// Gets the current marker list value of the specified field of the meta
    /// container. If the field does not have a set value, or it is of the
    /// wrong type, the method will fail.
    /// ## `key`
    /// The key for the `self` field to get
    ///
    /// # Returns
    ///
    /// A copy of the marker list value under `key`,
    /// or [`None`] if it could not be fetched.
    #[cfg(feature = "v1_18")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v1_18")))]
    #[doc(alias = "ges_meta_container_get_marker_list")]
    #[doc(alias = "get_marker_list")]
    fn marker_list(&self, key: &str) -> Option<MarkerList> {
        unsafe {
            from_glib_full(ffi::ges_meta_container_get_marker_list(
                self.as_ref().to_glib_none().0,
                key.to_glib_none().0,
            ))
        }
    }

    /// Gets the current value of the specified field of the meta container.
    ///
    /// # Deprecated since 1.30
    ///
    /// Use [`meta_full()`][Self::meta_full()] instead for MT-safety.
    /// ## `key`
    /// The key for the `self` field to get
    ///
    /// # Returns
    ///
    /// The value under `key`, or [`None`] if `self`
    /// does not have the field set.
    #[cfg_attr(feature = "v1_30", deprecated = "Since 1.30")]
    #[allow(deprecated)]
    #[doc(alias = "ges_meta_container_get_meta")]
    #[doc(alias = "get_meta")]
    fn meta(&self, key: &str) -> Option<glib::Value> {
        unsafe {
            from_glib_none(ffi::ges_meta_container_get_meta(
                self.as_ref().to_glib_none().0,
                key.to_glib_none().0,
            ))
        }
    }

    /// Gets a copy of the current value of the specified field of the meta
    /// container. The `dest` parameter should be an uninitialized [`glib::Value`][crate::glib::Value]; the
    /// function will initialize it with the appropriate type and copy the value.
    /// The caller is responsible for calling [`glib::Value::unset()`][crate::glib::Value::unset()] on `dest` when done.
    /// ## `key`
    /// The key for the `self` field to get
    ///
    /// # Returns
    ///
    /// [`true`] if the value was successfully copied to `dest`, [`false`] if
    /// `self` does not have the field set.
    ///
    /// ## `dest`
    /// An uninitialized [`glib::Value`][crate::glib::Value] to copy the value into
    #[cfg(feature = "v1_30")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v1_30")))]
    #[doc(alias = "ges_meta_container_get_meta_full")]
    #[doc(alias = "get_meta_full")]
    fn meta_full(&self, key: &str) -> Option<glib::Value> {
        unsafe {
            let mut dest = glib::Value::uninitialized();
            let ret = from_glib(ffi::ges_meta_container_get_meta_full(
                self.as_ref().to_glib_none().0,
                key.to_glib_none().0,
                dest.to_glib_none_mut().0,
            ));
            if ret { Some(dest) } else { None }
        }
    }

    /// Gets the current string value of the specified field of the meta
    /// container. If the field does not have a set value, or it is of the
    /// wrong type, the method will fail.
    ///
    /// # Deprecated since 1.30
    ///
    /// Use [`string_full()`][Self::string_full()] instead for MT-safety.
    /// ## `meta_item`
    /// The key for the `self` field to get
    ///
    /// # Returns
    ///
    /// The string value under `meta_item`, or [`None`]
    /// if it could not be fetched.
    #[cfg_attr(feature = "v1_30", deprecated = "Since 1.30")]
    #[allow(deprecated)]
    #[doc(alias = "ges_meta_container_get_string")]
    #[doc(alias = "get_string")]
    fn string(&self, meta_item: &str) -> Option<glib::GString> {
        unsafe {
            from_glib_none(ffi::ges_meta_container_get_string(
                self.as_ref().to_glib_none().0,
                meta_item.to_glib_none().0,
            ))
        }
    }

    /// Gets a copy of the current string value of the specified field of the
    /// meta container. If the field does not have a set value, or it is of the
    /// wrong type, the method will fail.
    /// ## `meta_item`
    /// The key for the `self` field to get
    ///
    /// # Returns
    ///
    /// A copy of the string value under
    /// `meta_item`, or [`None`] if it could not be fetched. Free with `g_free()` when
    /// no longer needed.
    #[cfg(feature = "v1_30")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v1_30")))]
    #[doc(alias = "ges_meta_container_get_string_full")]
    #[doc(alias = "get_string_full")]
    fn string_full(&self, meta_item: &str) -> Option<glib::GString> {
        unsafe {
            from_glib_full(ffi::ges_meta_container_get_string_full(
                self.as_ref().to_glib_none().0,
                meta_item.to_glib_none().0,
            ))
        }
    }

    /// Gets the current uint value of the specified field of the meta
    /// container. If the field does not have a set value, or it is of the
    /// wrong type, the method will fail.
    /// ## `meta_item`
    /// The key for the `self` field to get
    ///
    /// # Returns
    ///
    /// [`true`] if the uint value under `meta_item` was copied
    /// to `dest`.
    ///
    /// ## `dest`
    /// Destination into which the value under `meta_item`
    /// should be copied.
    #[doc(alias = "ges_meta_container_get_uint")]
    #[doc(alias = "get_uint")]
    fn uint(&self, meta_item: &str) -> Option<u32> {
        unsafe {
            let mut dest = std::mem::MaybeUninit::uninit();
            let ret = from_glib(ffi::ges_meta_container_get_uint(
                self.as_ref().to_glib_none().0,
                meta_item.to_glib_none().0,
                dest.as_mut_ptr(),
            ));
            if ret { Some(dest.assume_init()) } else { None }
        }
    }

    /// Gets the current uint64 value of the specified field of the meta
    /// container. If the field does not have a set value, or it is of the
    /// wrong type, the method will fail.
    /// ## `meta_item`
    /// The key for the `self` field to get
    ///
    /// # Returns
    ///
    /// [`true`] if the uint64 value under `meta_item` was copied
    /// to `dest`.
    ///
    /// ## `dest`
    /// Destination into which the value under `meta_item`
    /// should be copied.
    #[doc(alias = "ges_meta_container_get_uint64")]
    #[doc(alias = "get_uint64")]
    fn uint64(&self, meta_item: &str) -> Option<u64> {
        unsafe {
            let mut dest = std::mem::MaybeUninit::uninit();
            let ret = from_glib(ffi::ges_meta_container_get_uint64(
                self.as_ref().to_glib_none().0,
                meta_item.to_glib_none().0,
                dest.as_mut_ptr(),
            ));
            if ret { Some(dest.assume_init()) } else { None }
        }
    }

    /// Serializes the set metadata fields of the meta container to a string.
    ///
    /// # Returns
    ///
    /// A serialized `self`.
    #[doc(alias = "ges_meta_container_metas_to_string")]
    fn metas_to_string(&self) -> glib::GString {
        unsafe {
            from_glib_full(ffi::ges_meta_container_metas_to_string(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Sets the value of the specified field of the meta container to the
    /// given value, and registers the field to only hold a value of the
    /// same type. After calling this, only values of the same type as `value`
    /// can be set for this field. The given flags can be set to make this
    /// field only readable after calling this method.
    /// ## `flags`
    /// Flags to be used for the registered field
    /// ## `meta_item`
    /// The key for the `self` field to register
    /// ## `value`
    /// The value to set for the registered field
    ///
    /// # Returns
    ///
    /// [`true`] if the `meta_item` field was successfully registered on
    /// `self` to only hold `value` types, with the given `flags`, and the
    /// field was successfully set to `value`.
    #[doc(alias = "ges_meta_container_register_meta")]
    fn register_meta(&self, flags: MetaFlag, meta_item: &str, value: &glib::Value) -> bool {
        unsafe {
            from_glib(ffi::ges_meta_container_register_meta(
                self.as_ref().to_glib_none().0,
                flags.into_glib(),
                meta_item.to_glib_none().0,
                value.to_glib_none().0,
            ))
        }
    }

    /// Sets the value of the specified field of the meta container to the
    /// given boolean value, and registers the field to only hold a boolean
    /// typed value. After calling this, only boolean values can be set for
    /// this field. The given flags can be set to make this field only
    /// readable after calling this method.
    /// ## `flags`
    /// Flags to be used for the registered field
    /// ## `meta_item`
    /// The key for the `self` field to register
    /// ## `value`
    /// The value to set for the registered field
    ///
    /// # Returns
    ///
    /// [`true`] if the `meta_item` field was successfully registered on
    /// `self` to only hold boolean typed values, with the given `flags`,
    /// and the field was successfully set to `value`.
    #[doc(alias = "ges_meta_container_register_meta_boolean")]
    fn register_meta_boolean(&self, flags: MetaFlag, meta_item: &str, value: bool) -> bool {
        unsafe {
            from_glib(ffi::ges_meta_container_register_meta_boolean(
                self.as_ref().to_glib_none().0,
                flags.into_glib(),
                meta_item.to_glib_none().0,
                value.into_glib(),
            ))
        }
    }

    /// Sets the value of the specified field of the meta container to the
    /// given date value, and registers the field to only hold a date
    /// typed value. After calling this, only date values can be set for
    /// this field. The given flags can be set to make this field only
    /// readable after calling this method.
    /// ## `flags`
    /// Flags to be used for the registered field
    /// ## `meta_item`
    /// The key for the `self` field to register
    /// ## `value`
    /// The value to set for the registered field
    ///
    /// # Returns
    ///
    /// [`true`] if the `meta_item` field was successfully registered on
    /// `self` to only hold date typed values, with the given `flags`,
    /// and the field was successfully set to `value`.
    #[doc(alias = "ges_meta_container_register_meta_date")]
    fn register_meta_date(&self, flags: MetaFlag, meta_item: &str, value: &glib::Date) -> bool {
        unsafe {
            from_glib(ffi::ges_meta_container_register_meta_date(
                self.as_ref().to_glib_none().0,
                flags.into_glib(),
                meta_item.to_glib_none().0,
                value.to_glib_none().0,
            ))
        }
    }

    /// Sets the value of the specified field of the meta container to the
    /// given date time value, and registers the field to only hold a date time
    /// typed value. After calling this, only date time values can be set for
    /// this field. The given flags can be set to make this field only
    /// readable after calling this method.
    /// ## `flags`
    /// Flags to be used for the registered field
    /// ## `meta_item`
    /// The key for the `self` field to register
    /// ## `value`
    /// The value to set for the registered field
    ///
    /// # Returns
    ///
    /// [`true`] if the `meta_item` field was successfully registered on
    /// `self` to only hold date time typed values, with the given `flags`,
    /// and the field was successfully set to `value`.
    #[doc(alias = "ges_meta_container_register_meta_date_time")]
    fn register_meta_date_time(
        &self,
        flags: MetaFlag,
        meta_item: &str,
        value: &gst::DateTime,
    ) -> bool {
        unsafe {
            from_glib(ffi::ges_meta_container_register_meta_date_time(
                self.as_ref().to_glib_none().0,
                flags.into_glib(),
                meta_item.to_glib_none().0,
                value.to_glib_none().0,
            ))
        }
    }

    /// Sets the value of the specified field of the meta container to the
    /// given double value, and registers the field to only hold a double
    /// typed value. After calling this, only double values can be set for
    /// this field. The given flags can be set to make this field only
    /// readable after calling this method.
    /// ## `flags`
    /// Flags to be used for the registered field
    /// ## `meta_item`
    /// The key for the `self` field to register
    /// ## `value`
    /// The value to set for the registered field
    ///
    /// # Returns
    ///
    /// [`true`] if the `meta_item` field was successfully registered on
    /// `self` to only hold double typed values, with the given `flags`,
    /// and the field was successfully set to `value`.
    #[doc(alias = "ges_meta_container_register_meta_double")]
    fn register_meta_double(&self, flags: MetaFlag, meta_item: &str, value: f64) -> bool {
        unsafe {
            from_glib(ffi::ges_meta_container_register_meta_double(
                self.as_ref().to_glib_none().0,
                flags.into_glib(),
                meta_item.to_glib_none().0,
                value,
            ))
        }
    }

    /// Sets the value of the specified field of the meta container to the
    /// given float value, and registers the field to only hold a float
    /// typed value. After calling this, only float values can be set for
    /// this field. The given flags can be set to make this field only
    /// readable after calling this method.
    /// ## `flags`
    /// Flags to be used for the registered field
    /// ## `meta_item`
    /// The key for the `self` field to register
    /// ## `value`
    /// The value to set for the registered field
    ///
    /// # Returns
    ///
    /// [`true`] if the `meta_item` field was successfully registered on
    /// `self` to only hold float typed values, with the given `flags`,
    /// and the field was successfully set to `value`.
    #[doc(alias = "ges_meta_container_register_meta_float")]
    fn register_meta_float(&self, flags: MetaFlag, meta_item: &str, value: f32) -> bool {
        unsafe {
            from_glib(ffi::ges_meta_container_register_meta_float(
                self.as_ref().to_glib_none().0,
                flags.into_glib(),
                meta_item.to_glib_none().0,
                value,
            ))
        }
    }

    /// Sets the value of the specified field of the meta container to the
    /// given int value, and registers the field to only hold an int
    /// typed value. After calling this, only int values can be set for
    /// this field. The given flags can be set to make this field only
    /// readable after calling this method.
    /// ## `flags`
    /// Flags to be used for the registered field
    /// ## `meta_item`
    /// The key for the `self` field to register
    /// ## `value`
    /// The value to set for the registered field
    ///
    /// # Returns
    ///
    /// [`true`] if the `meta_item` field was successfully registered on
    /// `self` to only hold int typed values, with the given `flags`,
    /// and the field was successfully set to `value`.
    #[doc(alias = "ges_meta_container_register_meta_int")]
    fn register_meta_int(&self, flags: MetaFlag, meta_item: &str, value: i32) -> bool {
        unsafe {
            from_glib(ffi::ges_meta_container_register_meta_int(
                self.as_ref().to_glib_none().0,
                flags.into_glib(),
                meta_item.to_glib_none().0,
                value,
            ))
        }
    }

    /// Sets the value of the specified field of the meta container to the
    /// given int64 value, and registers the field to only hold an int64
    /// typed value. After calling this, only int64 values can be set for
    /// this field. The given flags can be set to make this field only
    /// readable after calling this method.
    /// ## `flags`
    /// Flags to be used for the registered field
    /// ## `meta_item`
    /// The key for the `self` field to register
    /// ## `value`
    /// The value to set for the registered field
    ///
    /// # Returns
    ///
    /// [`true`] if the `meta_item` field was successfully registered on
    /// `self` to only hold int64 typed values, with the given `flags`,
    /// and the field was successfully set to `value`.
    #[doc(alias = "ges_meta_container_register_meta_int64")]
    fn register_meta_int64(&self, flags: MetaFlag, meta_item: &str, value: i64) -> bool {
        unsafe {
            from_glib(ffi::ges_meta_container_register_meta_int64(
                self.as_ref().to_glib_none().0,
                flags.into_glib(),
                meta_item.to_glib_none().0,
                value,
            ))
        }
    }

    /// Sets the value of the specified field of the meta container to the
    /// given string value, and registers the field to only hold a string
    /// typed value. After calling this, only string values can be set for
    /// this field. The given flags can be set to make this field only
    /// readable after calling this method.
    /// ## `flags`
    /// Flags to be used for the registered field
    /// ## `meta_item`
    /// The key for the `self` field to register
    /// ## `value`
    /// The value to set for the registered field
    ///
    /// # Returns
    ///
    /// [`true`] if the `meta_item` field was successfully registered on
    /// `self` to only hold string typed values, with the given `flags`,
    /// and the field was successfully set to `value`.
    #[doc(alias = "ges_meta_container_register_meta_string")]
    fn register_meta_string(&self, flags: MetaFlag, meta_item: &str, value: &str) -> bool {
        unsafe {
            from_glib(ffi::ges_meta_container_register_meta_string(
                self.as_ref().to_glib_none().0,
                flags.into_glib(),
                meta_item.to_glib_none().0,
                value.to_glib_none().0,
            ))
        }
    }

    /// Sets the value of the specified field of the meta container to the
    /// given uint value, and registers the field to only hold a uint
    /// typed value. After calling this, only uint values can be set for
    /// this field. The given flags can be set to make this field only
    /// readable after calling this method.
    /// ## `flags`
    /// Flags to be used for the registered field
    /// ## `meta_item`
    /// The key for the `self` field to register
    /// ## `value`
    /// The value to set for the registered field
    ///
    /// # Returns
    ///
    /// [`true`] if the `meta_item` field was successfully registered on
    /// `self` to only hold uint typed values, with the given `flags`,
    /// and the field was successfully set to `value`.
    #[doc(alias = "ges_meta_container_register_meta_uint")]
    fn register_meta_uint(&self, flags: MetaFlag, meta_item: &str, value: u32) -> bool {
        unsafe {
            from_glib(ffi::ges_meta_container_register_meta_uint(
                self.as_ref().to_glib_none().0,
                flags.into_glib(),
                meta_item.to_glib_none().0,
                value,
            ))
        }
    }

    /// Sets the value of the specified field of the meta container to the
    /// given uint64 value, and registers the field to only hold a uint64
    /// typed value. After calling this, only uint64 values can be set for
    /// this field. The given flags can be set to make this field only
    /// readable after calling this method.
    /// ## `flags`
    /// Flags to be used for the registered field
    /// ## `meta_item`
    /// The key for the `self` field to register
    /// ## `value`
    /// The value to set for the registered field
    ///
    /// # Returns
    ///
    /// [`true`] if the `meta_item` field was successfully registered on
    /// `self` to only hold uint64 typed values, with the given `flags`,
    /// and the field was successfully set to `value`.
    #[doc(alias = "ges_meta_container_register_meta_uint64")]
    fn register_meta_uint64(&self, flags: MetaFlag, meta_item: &str, value: u64) -> bool {
        unsafe {
            from_glib(ffi::ges_meta_container_register_meta_uint64(
                self.as_ref().to_glib_none().0,
                flags.into_glib(),
                meta_item.to_glib_none().0,
                value,
            ))
        }
    }

    /// Registers a static metadata field on the container to only hold the
    /// specified type. After calling this, setting a value under this field
    /// can only succeed if its type matches the registered type of the field.
    ///
    /// Unlike [`register_meta()`][Self::register_meta()], no (initial) value is set
    /// for this field, which means you can use this method to reserve the
    /// space to be _optionally_ set later.
    ///
    /// Note that if a value has already been set for the field being
    /// registered, then its type must match the registering type, and its
    /// value will be left in place. If the field has no set value, then
    /// you will likely want to include [`MetaFlag::WRITABLE`][crate::MetaFlag::WRITABLE] in `flags` to allow
    /// the value to be set later.
    /// ## `flags`
    /// Flags to be used for the registered field
    /// ## `meta_item`
    /// The key for the `self` field to register
    /// ## `type_`
    /// The required value type for the registered field
    ///
    /// # Returns
    ///
    /// [`true`] if the `meta_item` field was successfully registered on
    /// `self` to only hold `type_` values, with the given `flags`.
    #[cfg(feature = "v1_18")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v1_18")))]
    #[doc(alias = "ges_meta_container_register_static_meta")]
    fn register_static_meta(
        &self,
        flags: MetaFlag,
        meta_item: &str,
        type_: glib::types::Type,
    ) -> bool {
        unsafe {
            from_glib(ffi::ges_meta_container_register_static_meta(
                self.as_ref().to_glib_none().0,
                flags.into_glib(),
                meta_item.to_glib_none().0,
                type_.into_glib(),
            ))
        }
    }

    /// Sets the value of the specified field of the meta container to the
    /// given boolean value.
    /// ## `meta_item`
    /// The key for the `self` field to set
    /// ## `value`
    /// The value to set under `meta_item`
    ///
    /// # Returns
    ///
    /// [`true`] if `value` was set under `meta_item` for `self`.
    #[doc(alias = "ges_meta_container_set_boolean")]
    fn set_boolean(&self, meta_item: &str, value: bool) -> bool {
        unsafe {
            from_glib(ffi::ges_meta_container_set_boolean(
                self.as_ref().to_glib_none().0,
                meta_item.to_glib_none().0,
                value.into_glib(),
            ))
        }
    }

    /// Sets the value of the specified field of the meta container to the
    /// given date value.
    /// ## `meta_item`
    /// The key for the `self` field to set
    /// ## `value`
    /// The value to set under `meta_item`
    ///
    /// # Returns
    ///
    /// [`true`] if `value` was set under `meta_item` for `self`.
    #[doc(alias = "ges_meta_container_set_date")]
    fn set_date(&self, meta_item: &str, value: &glib::Date) -> bool {
        unsafe {
            from_glib(ffi::ges_meta_container_set_date(
                self.as_ref().to_glib_none().0,
                meta_item.to_glib_none().0,
                value.to_glib_none().0,
            ))
        }
    }

    /// Sets the value of the specified field of the meta container to the
    /// given date time value.
    /// ## `meta_item`
    /// The key for the `self` field to set
    /// ## `value`
    /// The value to set under `meta_item`
    ///
    /// # Returns
    ///
    /// [`true`] if `value` was set under `meta_item` for `self`.
    #[doc(alias = "ges_meta_container_set_date_time")]
    fn set_date_time(&self, meta_item: &str, value: &gst::DateTime) -> bool {
        unsafe {
            from_glib(ffi::ges_meta_container_set_date_time(
                self.as_ref().to_glib_none().0,
                meta_item.to_glib_none().0,
                value.to_glib_none().0,
            ))
        }
    }

    /// Sets the value of the specified field of the meta container to the
    /// given double value.
    /// ## `meta_item`
    /// The key for the `self` field to set
    /// ## `value`
    /// The value to set under `meta_item`
    ///
    /// # Returns
    ///
    /// [`true`] if `value` was set under `meta_item` for `self`.
    #[doc(alias = "ges_meta_container_set_double")]
    fn set_double(&self, meta_item: &str, value: f64) -> bool {
        unsafe {
            from_glib(ffi::ges_meta_container_set_double(
                self.as_ref().to_glib_none().0,
                meta_item.to_glib_none().0,
                value,
            ))
        }
    }

    /// Sets the value of the specified field of the meta container to the
    /// given float value.
    /// ## `meta_item`
    /// The key for the `self` field to set
    /// ## `value`
    /// The value to set under `meta_item`
    ///
    /// # Returns
    ///
    /// [`true`] if `value` was set under `meta_item` for `self`.
    #[doc(alias = "ges_meta_container_set_float")]
    fn set_float(&self, meta_item: &str, value: f32) -> bool {
        unsafe {
            from_glib(ffi::ges_meta_container_set_float(
                self.as_ref().to_glib_none().0,
                meta_item.to_glib_none().0,
                value,
            ))
        }
    }

    /// Sets the value of the specified field of the meta container to the
    /// given int value.
    /// ## `meta_item`
    /// The key for the `self` field to set
    /// ## `value`
    /// The value to set under `meta_item`
    ///
    /// # Returns
    ///
    /// [`true`] if `value` was set under `meta_item` for `self`.
    #[doc(alias = "ges_meta_container_set_int")]
    fn set_int(&self, meta_item: &str, value: i32) -> bool {
        unsafe {
            from_glib(ffi::ges_meta_container_set_int(
                self.as_ref().to_glib_none().0,
                meta_item.to_glib_none().0,
                value,
            ))
        }
    }

    /// Sets the value of the specified field of the meta container to the
    /// given int64 value.
    /// ## `meta_item`
    /// The key for the `self` field to set
    /// ## `value`
    /// The value to set under `meta_item`
    ///
    /// # Returns
    ///
    /// [`true`] if `value` was set under `meta_item` for `self`.
    #[doc(alias = "ges_meta_container_set_int64")]
    fn set_int64(&self, meta_item: &str, value: i64) -> bool {
        unsafe {
            from_glib(ffi::ges_meta_container_set_int64(
                self.as_ref().to_glib_none().0,
                meta_item.to_glib_none().0,
                value,
            ))
        }
    }

    /// Sets the value of the specified field of the meta container to the
    /// given marker list value.
    /// ## `meta_item`
    /// The key for the `self` field to set
    /// ## `list`
    /// The value to set under `meta_item`
    ///
    /// # Returns
    ///
    /// [`true`] if `value` was set under `meta_item` for `self`.
    #[cfg(feature = "v1_18")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v1_18")))]
    #[doc(alias = "ges_meta_container_set_marker_list")]
    fn set_marker_list(&self, meta_item: &str, list: &MarkerList) -> bool {
        unsafe {
            from_glib(ffi::ges_meta_container_set_marker_list(
                self.as_ref().to_glib_none().0,
                meta_item.to_glib_none().0,
                list.to_glib_none().0,
            ))
        }
    }

    /// Sets the value of the specified field of the meta container to a
    /// copy of the given value. If the given `value` is [`None`], the field
    /// given by `meta_item` is removed and [`true`] is returned.
    /// ## `meta_item`
    /// The key for the `self` field to set
    /// ## `value`
    /// The value to set under `meta_item`, or [`None`] to
    /// remove the corresponding field
    ///
    /// # Returns
    ///
    /// [`true`] if `value` was set under `meta_item` for `self`.
    #[doc(alias = "ges_meta_container_set_meta")]
    fn set_meta(&self, meta_item: &str, value: Option<&glib::Value>) -> bool {
        unsafe {
            from_glib(ffi::ges_meta_container_set_meta(
                self.as_ref().to_glib_none().0,
                meta_item.to_glib_none().0,
                value.to_glib_none().0,
            ))
        }
    }

    /// Sets the value of the specified field of the meta container to the
    /// given string value.
    /// ## `meta_item`
    /// The key for the `self` field to set
    /// ## `value`
    /// The value to set under `meta_item`
    ///
    /// # Returns
    ///
    /// [`true`] if `value` was set under `meta_item` for `self`.
    #[doc(alias = "ges_meta_container_set_string")]
    fn set_string(&self, meta_item: &str, value: &str) -> bool {
        unsafe {
            from_glib(ffi::ges_meta_container_set_string(
                self.as_ref().to_glib_none().0,
                meta_item.to_glib_none().0,
                value.to_glib_none().0,
            ))
        }
    }

    /// Sets the value of the specified field of the meta container to the
    /// given uint value.
    /// ## `meta_item`
    /// The key for the `self` field to set
    /// ## `value`
    /// The value to set under `meta_item`
    ///
    /// # Returns
    ///
    /// [`true`] if `value` was set under `meta_item` for `self`.
    #[doc(alias = "ges_meta_container_set_uint")]
    fn set_uint(&self, meta_item: &str, value: u32) -> bool {
        unsafe {
            from_glib(ffi::ges_meta_container_set_uint(
                self.as_ref().to_glib_none().0,
                meta_item.to_glib_none().0,
                value,
            ))
        }
    }

    /// Sets the value of the specified field of the meta container to the
    /// given uint64 value.
    /// ## `meta_item`
    /// The key for the `self` field to set
    /// ## `value`
    /// The value to set under `meta_item`
    ///
    /// # Returns
    ///
    /// [`true`] if `value` was set under `meta_item` for `self`.
    #[doc(alias = "ges_meta_container_set_uint64")]
    fn set_uint64(&self, meta_item: &str, value: u64) -> bool {
        unsafe {
            from_glib(ffi::ges_meta_container_set_uint64(
                self.as_ref().to_glib_none().0,
                meta_item.to_glib_none().0,
                value,
            ))
        }
    }

    /// 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`].
    /// ## `key`
    /// The key for the `container` field that changed
    /// ## `value`
    /// The new value under `key`
    #[doc(alias = "notify-meta")]
    fn connect_notify_meta<F: Fn(&Self, &str, Option<&glib::Value>) + 'static>(
        &self,
        detail: Option<&str>,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn notify_meta_trampoline<
            P: IsA<MetaContainer>,
            F: Fn(&P, &str, Option<&glib::Value>) + 'static,
        >(
            this: *mut ffi::GESMetaContainer,
            key: *mut std::ffi::c_char,
            value: *mut glib::gobject_ffi::GValue,
            f: glib::ffi::gpointer,
        ) {
            unsafe {
                let f: &F = &*(f as *const F);
                f(
                    MetaContainer::from_glib_borrow(this).unsafe_cast_ref(),
                    &glib::GString::from_glib_borrow(key),
                    Option::<glib::Value>::from_glib_borrow(value)
                        .as_ref()
                        .as_ref(),
                )
            }
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            let detailed_signal_name = detail.map(|name| format!("notify-meta::{name}\0"));
            let signal_name = detailed_signal_name.as_ref().map_or(c"notify-meta", |n| {
                std::ffi::CStr::from_bytes_with_nul_unchecked(n.as_bytes())
            });
            connect_raw(
                self.as_ptr() as *mut _,
                signal_name.as_ptr(),
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    notify_meta_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }
}

impl<O: IsA<MetaContainer>> MetaContainerExt for O {}