mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-07-11 09:06:05 +00:00
67874ea86d
To make the code clearer, and to facilitate future improvements, introduce a distinction between the buffering level and the buffering percentage. Buffering level: the queue's current fill level. The low/high watermarks are in this range. Buffering percentage: percentage relative to the low/high watermarks (0% = low watermark, 100% = high watermark). To that end, get_percentage() is renamed to get_buffering_level(). Also, low/high_percent are renamed to low/high_watermark to avoid confusion. mq->buffering_percent values are now normalized in the 0..100 range for buffering messages inside update_buffering(), and not just before sending the buffering message. Finally the buffering level range is parameterized by adding a new constant called MAX_BUFFERING_LEVEL. https://bugzilla.gnome.org/show_bug.cgi?id=770628
105 lines
3 KiB
C
105 lines
3 KiB
C
/* GStreamer
|
|
* Copyright (C) 2006 Edward Hervey <edward@fluendo.com>
|
|
*
|
|
* gstmultiqueue.h:
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Library General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Library General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Library General Public
|
|
* License along with this library; if not, write to the
|
|
* Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
|
|
* Boston, MA 02110-1301, USA.
|
|
*/
|
|
|
|
|
|
#ifndef __GST_MULTI_QUEUE_H__
|
|
#define __GST_MULTI_QUEUE_H__
|
|
|
|
#include <gst/gst.h>
|
|
#include <gst/base/gstdataqueue.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
#define GST_TYPE_MULTI_QUEUE \
|
|
(gst_multi_queue_get_type())
|
|
#define GST_MULTI_QUEUE(obj) \
|
|
(G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_MULTI_QUEUE,GstMultiQueue))
|
|
#define GST_MULTI_QUEUE_CLASS(klass) \
|
|
(G_TYPE_CHECK_CLASS_CAST((klass),GST_TYPE_MULTI_QUEUE,GstMultiQueueClass))
|
|
#define GST_IS_MULTI_QUEUE(obj) \
|
|
(G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_MULTI_QUEUE))
|
|
#define GST_IS_MULTI_QUEUE_CLASS(obj) \
|
|
(G_TYPE_CHECK_CLASS_TYPE((klass),GST_TYPE_MULTI_QUEUE))
|
|
|
|
typedef struct _GstMultiQueue GstMultiQueue;
|
|
typedef struct _GstMultiQueueClass GstMultiQueueClass;
|
|
|
|
typedef struct _GstMultiQueuePad GstMultiQueuePad;
|
|
typedef struct _GstMultiQueuePadClass GstMultiQueuePadClass;
|
|
|
|
/**
|
|
* GstMultiQueue:
|
|
*
|
|
* Opaque #GstMultiQueue structure.
|
|
*/
|
|
struct _GstMultiQueue {
|
|
GstElement element;
|
|
|
|
gboolean sync_by_running_time;
|
|
gboolean use_interleave;
|
|
|
|
/* number of queues */
|
|
guint nbqueues;
|
|
|
|
/* The list of individual queues */
|
|
GList *queues;
|
|
guint32 queues_cookie;
|
|
|
|
GstDataQueueSize max_size, extra_size;
|
|
gboolean use_buffering;
|
|
gint low_watermark, high_watermark;
|
|
gboolean buffering;
|
|
gint buffering_percent;
|
|
|
|
guint counter; /* incoming object counter, use atomic accesses */
|
|
guint32 highid; /* contains highest id of last outputted object */
|
|
GstClockTimeDiff high_time; /* highest start running time */
|
|
|
|
GMutex qlock; /* Global queue lock (vs object lock or individual */
|
|
/* queues lock). Protects nbqueues, queues, global */
|
|
/* GstMultiQueueSize, counter and highid */
|
|
|
|
gint numwaiting; /* number of not-linked pads waiting */
|
|
|
|
gboolean buffering_percent_changed;
|
|
GMutex buffering_post_lock; /* assures only one posted at a time */
|
|
|
|
GstClockTime interleave; /* Input interleave */
|
|
GstClockTimeDiff last_interleave_update;
|
|
|
|
GstClockTime unlinked_cache_time;
|
|
};
|
|
|
|
struct _GstMultiQueueClass {
|
|
GstElementClass parent_class;
|
|
|
|
/* signals emitted when ALL queues are either full or empty */
|
|
void (*underrun) (GstMultiQueue *queue);
|
|
void (*overrun) (GstMultiQueue *queue);
|
|
};
|
|
|
|
G_GNUC_INTERNAL GType gst_multi_queue_get_type (void);
|
|
|
|
G_END_DECLS
|
|
|
|
|
|
#endif /* __GST_MULTI_QUEUE_H__ */
|