1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108

// 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::{ffi, Object, Plugin};
use glib::{prelude::*, translate::*};

glib::wrapper! {
    /// This is a base class for anything that can be added to a [`Plugin`][crate::Plugin].
    ///
    /// This is an Abstract Base Class, you cannot instantiate it.
    ///
    /// # Implements
    ///
    /// [`PluginFeatureExt`][trait@crate::prelude::PluginFeatureExt], [`GstObjectExt`][trait@crate::prelude::GstObjectExt], [`trait@glib::ObjectExt`], [`PluginFeatureExtManual`][trait@crate::prelude::PluginFeatureExtManual]
    #[doc(alias = "GstPluginFeature")]
    pub struct PluginFeature(Object<ffi::GstPluginFeature, ffi::GstPluginFeatureClass>) @extends Object;

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

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

unsafe impl Send for PluginFeature {}
unsafe impl Sync for PluginFeature {}

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

/// Trait containing all [`struct@PluginFeature`] methods.
///
/// # Implementors
///
/// [`DeviceProviderFactory`][struct@crate::DeviceProviderFactory], [`ElementFactory`][struct@crate::ElementFactory], [`PluginFeature`][struct@crate::PluginFeature], [`TracerFactory`][struct@crate::TracerFactory], [`TypeFindFactory`][struct@crate::TypeFindFactory]
pub trait PluginFeatureExt: IsA<PluginFeature> + sealed::Sealed + 'static {
    /// Checks whether the given plugin feature is at least the required version.
    ///
    /// Note: Since version 1.24 this function no longer returns [`true`] if the
    /// version is a git development version (e.g. 1.23.0.1) and the check is
    /// for the "next" micro version, that is it will no longer return [`true`] for
    /// e.g. 1.23.0.1 if the check is for 1.23.1. It is still possible to parse
    /// the nano version from the string and do this check that way if needed.
    /// ## `min_major`
    /// minimum required major version
    /// ## `min_minor`
    /// minimum required minor version
    /// ## `min_micro`
    /// minimum required micro version
    ///
    /// # Returns
    ///
    /// [`true`] if the plugin feature has at least
    ///  the required version, otherwise [`false`].
    #[doc(alias = "gst_plugin_feature_check_version")]
    fn check_version(&self, min_major: u32, min_minor: u32, min_micro: u32) -> bool {
        unsafe {
            from_glib(ffi::gst_plugin_feature_check_version(
                self.as_ref().to_glib_none().0,
                min_major,
                min_minor,
                min_micro,
            ))
        }
    }

    /// Get the plugin that provides this feature.
    ///
    /// # Returns
    ///
    /// the plugin that provides this
    ///  feature, or [`None`]. Unref with `gst_object_unref()` when no
    ///  longer needed.
    #[doc(alias = "gst_plugin_feature_get_plugin")]
    #[doc(alias = "get_plugin")]
    fn plugin(&self) -> Option<Plugin> {
        unsafe {
            from_glib_full(ffi::gst_plugin_feature_get_plugin(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Get the name of the plugin that provides this feature.
    ///
    /// # Returns
    ///
    /// the name of the plugin that provides this
    ///  feature, or [`None`] if the feature is not associated with a
    ///  plugin.
    #[doc(alias = "gst_plugin_feature_get_plugin_name")]
    #[doc(alias = "get_plugin_name")]
    fn plugin_name(&self) -> Option<glib::GString> {
        unsafe {
            from_glib_none(ffi::gst_plugin_feature_get_plugin_name(
                self.as_ref().to_glib_none().0,
            ))
        }
    }
}

impl<O: IsA<PluginFeature>> PluginFeatureExt for O {}