Skip to main content

gstreamer_base/subclass/
push_src.rs

1// Take a look at the license at the top of the repository in the LICENSE file.
2
3use std::ptr;
4
5use glib::{prelude::*, subclass::prelude::*, translate::*};
6use gst::{prelude::*, subclass::prelude::*};
7
8use super::base_src::{BaseSrcImpl, CreateSuccess};
9use crate::{PushSrc, ffi, prelude::*};
10
11pub trait PushSrcImpl: BaseSrcImpl + ObjectSubclass<Type: IsA<PushSrc>> {
12    /// Ask the subclass to fill the buffer with data.
13    fn fill(&self, buffer: &mut gst::BufferRef) -> Result<gst::FlowSuccess, gst::FlowError> {
14        PushSrcImplExt::parent_fill(self, buffer)
15    }
16
17    /// Allocate memory for a buffer.
18    ///
19    /// # Returns
20    ///
21    fn alloc(&self) -> Result<gst::Buffer, gst::FlowError> {
22        PushSrcImplExt::parent_alloc(self)
23    }
24
25    /// Ask the subclass to create a buffer, the default implementation will call alloc if
26    /// no allocated `buf` is provided and then call fill.
27    ///
28    /// # Returns
29    ///
30    fn create(&self, buffer: Option<&mut gst::BufferRef>) -> Result<CreateSuccess, gst::FlowError> {
31        PushSrcImplExt::parent_create(self, buffer)
32    }
33}
34
35pub trait PushSrcImplExt: PushSrcImpl {
36    fn parent_fill(&self, buffer: &mut gst::BufferRef) -> Result<gst::FlowSuccess, gst::FlowError> {
37        unsafe {
38            let data = Self::type_data();
39            let parent_class = data.as_ref().parent_class() as *mut ffi::GstPushSrcClass;
40            (*parent_class)
41                .fill
42                .map(|f| {
43                    try_from_glib(f(
44                        self.obj().unsafe_cast_ref::<PushSrc>().to_glib_none().0,
45                        buffer.as_mut_ptr(),
46                    ))
47                })
48                .unwrap_or(Err(gst::FlowError::NotSupported))
49        }
50    }
51
52    fn parent_alloc(&self) -> Result<gst::Buffer, gst::FlowError> {
53        unsafe {
54            let data = Self::type_data();
55            let parent_class = data.as_ref().parent_class() as *mut ffi::GstPushSrcClass;
56            (*parent_class)
57                .alloc
58                .map(|f| {
59                    let mut buffer_ptr: *mut gst::ffi::GstBuffer = ptr::null_mut();
60
61                    // FIXME: Wrong signature in -sys bindings
62                    // https://gitlab.freedesktop.org/gstreamer/gstreamer-rs-sys/issues/3
63                    let buffer_ref = &mut buffer_ptr as *mut _ as *mut gst::ffi::GstBuffer;
64
65                    gst::FlowSuccess::try_from_glib(f(
66                        self.obj().unsafe_cast_ref::<PushSrc>().to_glib_none().0,
67                        buffer_ref,
68                    ))
69                    .map(|_| from_glib_full(buffer_ref))
70                })
71                .unwrap_or(Err(gst::FlowError::NotSupported))
72        }
73    }
74
75    fn parent_create(
76        &self,
77        mut buffer: Option<&mut gst::BufferRef>,
78    ) -> Result<CreateSuccess, gst::FlowError> {
79        unsafe {
80            let data = Self::type_data();
81            let parent_class = data.as_ref().parent_class() as *mut ffi::GstPushSrcClass;
82            (*parent_class)
83                .create
84                .map(|f| {
85                    let instance = self.obj();
86                    let instance = instance.unsafe_cast_ref::<PushSrc>();
87                    let orig_buffer_ptr = buffer
88                        .as_mut()
89                        .map(|b| b.as_mut_ptr())
90                        .unwrap_or(ptr::null_mut());
91                    let mut buffer_ptr = orig_buffer_ptr;
92
93                    // FIXME: Wrong signature in -sys bindings
94                    // https://gitlab.freedesktop.org/gstreamer/gstreamer-rs-sys/issues/3
95                    let buffer_ref = &mut buffer_ptr as *mut _ as *mut gst::ffi::GstBuffer;
96                    let instance_data = self.instance_data::<super::base_src::InstanceData>(crate::BaseSrc::static_type()).unwrap();
97
98                    if let Err(err) = gst::FlowSuccess::try_from_glib(
99                        f(
100                            instance.to_glib_none().0,
101                            buffer_ref,
102                        )
103                    ) {
104                        *instance_data.pending_buffer_list.borrow_mut() = None;
105                        return Err(err);
106                    }
107
108                    let pending_buffer_list = instance_data.pending_buffer_list.borrow_mut().take();
109                    if pending_buffer_list.is_some() &&
110                        (buffer.is_some() || instance.src_pad().mode() == gst::PadMode::Pull) {
111                        panic!("Buffer lists can only be returned in push mode");
112                    }
113
114                    let pending_buffer_list = instance_data.pending_buffer_list.borrow_mut().take();
115                    if buffer_ptr.is_null() && pending_buffer_list.is_none() {
116                        gst::error!(
117                            gst::CAT_RUST,
118                            obj = instance,
119                            "No buffer and no buffer list returned"
120                        );
121                        return Err(gst::FlowError::Error);
122                    }
123
124                    if !buffer_ptr.is_null() && pending_buffer_list.is_some() {
125                        gst::error!(
126                            gst::CAT_RUST,
127                            obj = instance,
128                            "Both buffer and buffer list returned"
129                        );
130                        return Err(gst::FlowError::Error);
131                    }
132
133                    if let Some(passed_buffer) = buffer {
134                        if buffer_ptr != orig_buffer_ptr {
135                            let new_buffer = gst::Buffer::from_glib_full(buffer_ptr);
136
137                            gst::debug!(
138                                gst::CAT_PERFORMANCE,
139                                obj = instance,
140                                "Returned new buffer from parent create function, copying into passed buffer"
141                            );
142
143                            let mut map = match passed_buffer.map_writable() {
144                                Ok(map) => map,
145                                Err(_) => {
146                                    gst::error!(
147                                        gst::CAT_RUST,
148                                        obj = instance,
149                                        "Failed to map passed buffer writable"
150                                    );
151                                    return Err(gst::FlowError::Error);
152                                }
153                            };
154
155                            let copied_size = new_buffer.copy_to_slice(0, &mut map);
156                            drop(map);
157
158                            if let Err(copied_size) = copied_size {
159                                passed_buffer.set_size(copied_size);
160                            }
161
162                            match new_buffer.copy_into(passed_buffer, gst::BUFFER_COPY_METADATA, ..) {
163                                Ok(_) => Ok(CreateSuccess::FilledBuffer),
164                                Err(_) => {
165                                    gst::error!(
166                                        gst::CAT_RUST,
167                                        obj = instance,
168                                        "Failed to copy buffer metadata"
169                                    );
170
171                                    Err(gst::FlowError::Error)
172                                }
173                            }
174                        } else {
175                            Ok(CreateSuccess::FilledBuffer)
176                        }
177                    } else if let Some(buffer_list) = pending_buffer_list {
178                        Ok(CreateSuccess::NewBufferList(buffer_list))
179                    } else {
180                        Ok(CreateSuccess::NewBuffer(from_glib_full(buffer_ptr)))
181                    }
182                })
183                .unwrap_or(Err(gst::FlowError::NotSupported))
184        }
185    }
186}
187
188impl<T: PushSrcImpl> PushSrcImplExt for T {}
189
190unsafe impl<T: PushSrcImpl> IsSubclassable<T> for PushSrc {
191    fn class_init(klass: &mut glib::Class<Self>) {
192        Self::parent_class_init::<T>(klass);
193        let klass = klass.as_mut();
194        klass.fill = Some(push_src_fill::<T>);
195        klass.alloc = Some(push_src_alloc::<T>);
196        klass.create = Some(push_src_create::<T>);
197    }
198}
199
200unsafe extern "C" fn push_src_fill<T: PushSrcImpl>(
201    ptr: *mut ffi::GstPushSrc,
202    buffer: *mut gst::ffi::GstBuffer,
203) -> gst::ffi::GstFlowReturn {
204    unsafe {
205        let instance = &*(ptr as *mut T::Instance);
206        let imp = instance.imp();
207        let buffer = gst::BufferRef::from_mut_ptr(buffer);
208
209        gst::element_panic_to_error!(imp, gst::FlowReturn::Error, {
210            PushSrcImpl::fill(imp, buffer).into()
211        })
212        .into_glib()
213    }
214}
215
216unsafe extern "C" fn push_src_alloc<T: PushSrcImpl>(
217    ptr: *mut ffi::GstPushSrc,
218    buffer_ptr: *mut gst::ffi::GstBuffer,
219) -> gst::ffi::GstFlowReturn {
220    unsafe {
221        let instance = &*(ptr as *mut T::Instance);
222        let imp = instance.imp();
223        // FIXME: Wrong signature in -sys bindings
224        // https://gitlab.freedesktop.org/gstreamer/gstreamer-rs-sys/issues/3
225        let buffer_ptr = buffer_ptr as *mut *mut gst::ffi::GstBuffer;
226
227        gst::element_panic_to_error!(imp, gst::FlowReturn::Error, {
228            match PushSrcImpl::alloc(imp) {
229                Ok(buffer) => {
230                    *buffer_ptr = buffer.into_glib_ptr();
231                    gst::FlowReturn::Ok
232                }
233                Err(err) => gst::FlowReturn::from(err),
234            }
235        })
236        .into_glib()
237    }
238}
239
240#[allow(clippy::needless_option_as_deref)]
241unsafe extern "C" fn push_src_create<T: PushSrcImpl>(
242    ptr: *mut ffi::GstPushSrc,
243    buffer_ptr: *mut gst::ffi::GstBuffer,
244) -> gst::ffi::GstFlowReturn {
245    unsafe {
246        let instance = &*(ptr as *mut T::Instance);
247        let imp = instance.imp();
248        // FIXME: Wrong signature in -sys bindings
249        // https://gitlab.freedesktop.org/gstreamer/gstreamer-rs-sys/issues/3
250        let buffer_ptr = buffer_ptr as *mut *mut gst::ffi::GstBuffer;
251
252        let mut buffer = if (*buffer_ptr).is_null() {
253            None
254        } else {
255            Some(gst::BufferRef::from_mut_ptr(*buffer_ptr))
256        };
257
258        let instance_data = imp
259            .instance_data::<super::base_src::InstanceData>(crate::BaseSrc::static_type())
260            .unwrap();
261
262        gst::element_panic_to_error!(imp, gst::FlowReturn::Error, {
263            match PushSrcImpl::create(imp, buffer.as_deref_mut()) {
264                Ok(CreateSuccess::NewBuffer(new_buffer)) => {
265                    // Clear any pending buffer list
266                    *instance_data.pending_buffer_list.borrow_mut() = None;
267
268                    if let Some(passed_buffer) = buffer {
269                        if passed_buffer.as_ptr() != new_buffer.as_ptr() {
270                            gst::debug!(
271                            gst::CAT_PERFORMANCE,
272                            imp = imp,
273                            "Returned new buffer from create function, copying into passed buffer"
274                        );
275
276                            let mut map = match passed_buffer.map_writable() {
277                                Ok(map) => map,
278                                Err(_) => {
279                                    gst::error!(
280                                        gst::CAT_RUST,
281                                        imp = imp,
282                                        "Failed to map passed buffer writable"
283                                    );
284                                    return gst::FlowReturn::Error;
285                                }
286                            };
287
288                            let copied_size = new_buffer.copy_to_slice(0, &mut map);
289                            drop(map);
290
291                            if let Err(copied_size) = copied_size {
292                                passed_buffer.set_size(copied_size);
293                            }
294
295                            match new_buffer.copy_into(passed_buffer, gst::BUFFER_COPY_METADATA, ..)
296                            {
297                                Ok(_) => gst::FlowReturn::Ok,
298                                Err(_) => {
299                                    gst::error!(
300                                        gst::CAT_RUST,
301                                        imp = imp,
302                                        "Failed to copy buffer metadata"
303                                    );
304
305                                    gst::FlowReturn::Error
306                                }
307                            }
308                        } else {
309                            gst::FlowReturn::Ok
310                        }
311                    } else {
312                        *buffer_ptr = new_buffer.into_glib_ptr();
313                        gst::FlowReturn::Ok
314                    }
315                }
316                Ok(CreateSuccess::NewBufferList(new_buffer_list)) => {
317                    if buffer.is_some()
318                        || imp.obj().unsafe_cast_ref::<PushSrc>().src_pad().mode()
319                            == gst::PadMode::Pull
320                    {
321                        panic!("Buffer lists can only be returned in push mode");
322                    }
323
324                    *buffer_ptr = ptr::null_mut();
325
326                    // Store it in the instance data so that in the end base_src_create() can
327                    // submit it.
328                    *instance_data.pending_buffer_list.borrow_mut() = Some(new_buffer_list);
329
330                    gst::FlowReturn::Ok
331                }
332                Ok(CreateSuccess::FilledBuffer) => {
333                    // Clear any pending buffer list
334                    *instance_data.pending_buffer_list.borrow_mut() = None;
335
336                    gst::FlowReturn::Ok
337                }
338                Err(err) => gst::FlowReturn::from(err),
339            }
340        })
341        .into_glib()
342    }
343}