plugins/elements/gstmultiqueue.h

   1 /* GStreamer
   2  * Copyright (C) 2006 Edward Hervey <edward@fluendo.com>
   3  *
   4  * gstmultiqueue.h:
   5  *
   6  * This library is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Library General Public
   8  * License as published by the Free Software Foundation; either
   9  * version 2 of the License, or (at your option) any later version.
  10  *
  11  * This library is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * Library General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Library General Public
  17  * License along with this library; if not, write to the
  18  * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
  19  * Boston, MA 02110-1301, USA.
  20  */
  21
  22
  23 #ifndef __GST_MULTI_QUEUE_H__
  24 #define __GST_MULTI_QUEUE_H__
  25
  26 #include <gst/gst.h>
  27 #include <gst/base/gstdataqueue.h>
  28
  29 G_BEGIN_DECLS
  30
  31 #define GST_TYPE_MULTI_QUEUE \
  32   (gst_multi_queue_get_type())
  33 #define GST_MULTI_QUEUE(obj) \
  34   (G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_MULTI_QUEUE,GstMultiQueue))
  35 #define GST_MULTI_QUEUE_CLASS(klass) \
  36   (G_TYPE_CHECK_CLASS_CAST((klass),GST_TYPE_MULTI_QUEUE,GstMultiQueueClass))
  37 #define GST_IS_MULTI_QUEUE(obj) \
  38   (G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_MULTI_QUEUE))
  39 #define GST_IS_MULTI_QUEUE_CLASS(obj) \
  40   (G_TYPE_CHECK_CLASS_TYPE((klass),GST_TYPE_MULTI_QUEUE))
  41
  42 typedef struct _GstMultiQueue GstMultiQueue;
  43 typedef struct _GstMultiQueueClass GstMultiQueueClass;
  44
  45 /**
  46  * GstMultiQueue:
  47  *
  48  * Opaque #GstMultiQueue structure.
  49  */
  50 struct _GstMultiQueue {
  51   GstElement element;
  52
  53   gboolean sync_by_running_time;
  54   gboolean use_interleave;
  55
  56   /* number of queues */
  57   guint nbqueues;
  58
  59   /* The list of individual queues */
  60   GList *queues;
  61   guint32 queues_cookie;
  62
  63   GstDataQueueSize  max_size, extra_size;
  64   gboolean use_buffering;
  65   gint low_percent, high_percent;
  66   gboolean buffering;
  67   gint percent;
  68
  69   guint    counter;     /* incoming object counter, use atomic accesses */
  70   guint32  highid;      /* contains highest id of last outputted object */
  71   GstClockTime high_time; /* highest start running time */
  72
  73   GMutex   qlock;       /* Global queue lock (vs object lock or individual */
  74                         /* queues lock). Protects nbqueues, queues, global */
  75                         /* GstMultiQueueSize, counter and highid */
  76
  77   gint numwaiting;      /* number of not-linked pads waiting */
  78
  79   gboolean percent_changed;
  80   GMutex buffering_post_lock; /* assures only one posted at a time */
  81
  82   GstClockTime interleave;      /* Input interleave */
  83   GstClockTime last_interleave_update;
  84 };
  85
  86 struct _GstMultiQueueClass {
  87   GstElementClass parent_class;
  88
  89   /* signals emitted when ALL queues are either full or empty */
  90   void (*underrun)      (GstMultiQueue *queue);
  91   void (*overrun)       (GstMultiQueue *queue);
  92 };
  93
  94 G_GNUC_INTERNAL GType gst_multi_queue_get_type (void);
  95
  96 G_END_DECLS
  97
  98
  99 #endif /* __GST_MULTI_QUEUE_H__ */