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

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

glib::wrapper! {
    /// This object provides an abstraction for creating threads. The default
    /// implementation uses a regular GThreadPool to start tasks.
    ///
    /// Subclasses can be made to create custom threads.
    ///
    /// # Implements
    ///
    /// [`TaskPoolExt`][trait@crate::prelude::TaskPoolExt], [`GstObjectExt`][trait@crate::prelude::GstObjectExt], [`trait@glib::ObjectExt`], [`TaskPoolExtManual`][trait@crate::prelude::TaskPoolExtManual]
    #[doc(alias = "GstTaskPool")]
    pub struct TaskPool(Object<ffi::GstTaskPool, ffi::GstTaskPoolClass>) @extends Object;

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

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

    /// Create a new default task pool. The default task pool will use a regular
    /// GThreadPool for threads.
    ///
    /// # Returns
    ///
    /// a new [`TaskPool`][crate::TaskPool]. `gst_object_unref()` after usage.
    #[doc(alias = "gst_task_pool_new")]
    pub fn new() -> TaskPool {
        assert_initialized_main_thread!();
        unsafe { from_glib_full(ffi::gst_task_pool_new()) }
    }
}

impl Default for TaskPool {
    fn default() -> Self {
        Self::new()
    }
}

unsafe impl Send for TaskPool {}
unsafe impl Sync for TaskPool {}

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

/// Trait containing all [`struct@TaskPool`] methods.
///
/// # Implementors
///
/// [`TaskPool`][struct@crate::TaskPool]
pub trait TaskPoolExt: IsA<TaskPool> + sealed::Sealed + 'static {
    /// Wait for all tasks to be stopped. This is mainly used internally
    /// to ensure proper cleanup of internal data structures in test suites.
    ///
    /// MT safe.
    #[doc(alias = "gst_task_pool_cleanup")]
    fn cleanup(&self) {
        unsafe {
            ffi::gst_task_pool_cleanup(self.as_ref().to_glib_none().0);
        }
    }

    /// Prepare the taskpool for accepting [`TaskPoolExtManual::push()`][crate::prelude::TaskPoolExtManual::push()] operations.
    ///
    /// MT safe.
    #[doc(alias = "gst_task_pool_prepare")]
    fn prepare(&self) -> Result<(), glib::Error> {
        unsafe {
            let mut error = std::ptr::null_mut();
            let _ = ffi::gst_task_pool_prepare(self.as_ref().to_glib_none().0, &mut error);
            if error.is_null() {
                Ok(())
            } else {
                Err(from_glib_full(error))
            }
        }
    }
}

impl<O: IsA<TaskPool>> TaskPoolExt for O {}