[Bug 792265] New: appsrc: uncertainty moment in the documentation

[GStreamer (GNOME Bugzilla)]

https://bugzilla.gnome.org/show_bug.cgi?id=792265

            Bug ID: 792265
           Summary: appsrc: uncertainty moment in the documentation
    Classification: Platform
           Product: GStreamer
           Version: unspecified
                OS: All
            Status: NEW
          Severity: minor
          Priority: Normal
         Component: gst-plugins-base
          Assignee: gstreamer-bugs at lists.freedesktop.org
          Reporter: alenuke at yandex.ru
        QA Contact: gstreamer-bugs at lists.freedesktop.org
     GNOME version: ---

About the ownership of the buffer, when pushing it to appsrc.

https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base-libs/html/gst-plugins-base-libs-appsrc.html#gst-app-src-push-buffer

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.

-- 
You are receiving this mail because:
You are the QA Contact for the bug.
You are the assignee for the bug.