plugins/elements/gstqueue.c: Correct docs of queue, add more detail and crosslink it more.

Original commit message from CVS:
* plugins/elements/gstqueue.c: (queue_leaky_get_type):
Correct docs of queue, add more detail and crosslink it more.
This commit is contained in:
Stefan Kost 2006-12-18 16:01:32 +00:00
parent 4c3c22418f
commit cf19a12eb5
2 changed files with 20 additions and 9 deletions

View file

@ -1,3 +1,8 @@
2006-12-18 Stefan Kost <ensonic@users.sf.net>
* plugins/elements/gstqueue.c: (queue_leaky_get_type):
Correct docs of queue, add more detail and crosslink it more.
2006-12-16 Tim-Philipp Müller <tim at centricular dot net>
* plugins/elements/gstidentity.c: (gst_identity_check_perfect):

View file

@ -26,16 +26,21 @@
* SECTION:element-queue
* @short_description: Simple asynchronous data queue.
*
* Data is queued till max_level buffers have been stored. Any subsequent
* buffers sent to this filter will block until free space becomes available in
* the buffer. The queue will create a new thread on the source pad to
* decouple the processing on sink and source pad.
* Data is queued till the amount of buffers specified by
* #GstQueue:max-size-buffers have been stored. Any subsequent buffers sent to
* this filter will block until free space becomes available in the buffer.
* The queue will create a new thread on the source pad to decouple the
* processing on sink and source pad.
*
* You can query how many buffers are queued with the level argument.
* You can query how many buffers are queued by reading the
* #GstQueue:current-level-buffers property.
*
* The default queue length is set to 100.
* The default queue length is set to 100 buffers.
*
* The queue blocks by default.
* As said earlier, the queue blocks by default. Alternatively one can set the
* #GstQueue:leaky property to specify that it should leak new or old
* buffers. Two signals - #GstQueue::overrun and #GstQueue::underrun inform
* about this.
*/
#include "gst/gst_private.h"
@ -176,8 +181,9 @@ queue_leaky_get_type (void)
static GType queue_leaky_type = 0;
static const GEnumValue queue_leaky[] = {
{GST_QUEUE_NO_LEAK, "Not Leaky", "no"},
{GST_QUEUE_LEAK_UPSTREAM, "Leaky on Upstream", "upstream"},
{GST_QUEUE_LEAK_DOWNSTREAM, "Leaky on Downstream", "downstream"},
{GST_QUEUE_LEAK_UPSTREAM, "Leaky on upstream (new buffers)", "upstream"},
{GST_QUEUE_LEAK_DOWNSTREAM, "Leaky on downstream (old buffers)",
"downstream"},
{0, NULL, NULL},
};