appsrc: uncertainty moment in the documentation
Submitted by Aleksandr Slobodeniuk
Link to original bug (#792265)
Description
About the ownership of the buffer, when pushing it to appsrc.
Function takes ownership, but signal doesn't.
It was tricky, because I didn't find the documentation for signal in the web.
But in appsrc's code it exists:
/**
* GstAppSrc::push-buffer:
* @appsrc: the appsrc
* @buffer: a buffer to push
*
* Adds a buffer to the queue of buffers that the appsrc element will
* push to its source pad. This function does not take ownership of the
* buffer so the buffer needs to be unreffed after calling this function.
*
And the web-page only says:
The main way of handing data to the appsrc element is by calling the gst_app_src_push_buffer() method or by emitting the push-buffer action signal.
But gst_app_src_push_buffer
is not a signal handler for "push-buffer", that's what's tricky.