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
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124

// Take a look at the license at the top of the repository in the LICENSE file.

use std::ffi::CStr;

use glib::{prelude::*, translate::*};

use crate::{ffi, DeviceProvider, Plugin, Rank};

impl DeviceProvider {
    /// Create a new device providerfactory capable of instantiating objects of the
    /// `type_` and add the factory to `plugin`.
    /// ## `plugin`
    /// [`Plugin`][crate::Plugin] to register the device provider with, or [`None`] for
    ///  a static device provider.
    /// ## `name`
    /// name of device providers of this type
    /// ## `rank`
    /// rank of device provider (higher rank means more importance when autoplugging)
    /// ## `type_`
    /// GType of device provider to register
    ///
    /// # Returns
    ///
    /// [`true`], if the registering succeeded, [`false`] on error
    #[doc(alias = "gst_device_provider_register")]
    pub fn register(
        plugin: Option<&Plugin>,
        name: &str,
        rank: Rank,
        type_: glib::types::Type,
    ) -> Result<(), glib::error::BoolError> {
        skip_assert_initialized!();
        unsafe {
            glib::result_from_gboolean!(
                ffi::gst_device_provider_register(
                    plugin.to_glib_none().0,
                    name.to_glib_none().0,
                    rank.into_glib() as u32,
                    type_.into_glib()
                ),
                "Failed to register device provider factory"
            )
        }
    }
}

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

pub trait DeviceProviderExtManual: sealed::Sealed + IsA<DeviceProvider> + 'static {
    /// Get metadata with `key` in `self`.
    /// ## `key`
    /// the key to get
    ///
    /// # Returns
    ///
    /// the metadata for `key`.
    #[doc(alias = "get_metadata")]
    #[doc(alias = "gst_device_provider_class_get_metadata")]
    fn metadata<'a>(&self, key: &str) -> Option<&'a str> {
        unsafe {
            self.unsafe_cast_ref::<DeviceProvider>()
                .class()
                .metadata(key)
        }
    }

    /// Gets a list of devices that this provider understands. This may actually
    /// probe the hardware if the provider is not currently started.
    ///
    /// If the provider has been started, this will returned the same [`Device`][crate::Device]
    /// objedcts that have been returned by the `GST_MESSAGE_DEVICE_ADDED` messages.
    ///
    /// # Returns
    ///
    /// a `GList` of
    ///  [`Device`][crate::Device]
    #[doc(alias = "gst_device_provider_get_devices")]
    #[doc(alias = "get_devices")]
    fn devices(&self) -> glib::List<crate::Device> {
        unsafe {
            FromGlibPtrContainer::from_glib_full(ffi::gst_device_provider_get_devices(
                self.as_ref().to_glib_none().0,
            ))
        }
    }
}

impl<O: IsA<DeviceProvider>> DeviceProviderExtManual for O {}

pub unsafe trait DeviceProviderClassExt {
    /// Get metadata with `key` in `self`.
    /// ## `key`
    /// the key to get
    ///
    /// # Returns
    ///
    /// the metadata for `key`.
    #[doc(alias = "get_metadata")]
    #[doc(alias = "gst_device_provider_class_get_metadata")]
    fn metadata<'a>(&self, key: &str) -> Option<&'a str> {
        unsafe {
            let klass = self as *const _ as *const ffi::GstDeviceProviderClass;

            let ptr = ffi::gst_device_provider_class_get_metadata(
                mut_override(klass),
                key.to_glib_none().0,
            );

            if ptr.is_null() {
                None
            } else {
                Some(CStr::from_ptr(ptr).to_str().unwrap())
            }
        }
    }
}

unsafe impl<T: IsA<DeviceProvider> + glib::object::IsClass> DeviceProviderClassExt
    for glib::object::Class<T>
{
}