plugins/elements/gstqueue2.h

   1 /* GStreamer
   2  * Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
   3  *                    2003 Colin Walters <cwalters@gnome.org>
   4  *                    2000,2005,2007 Wim Taymans <wim.taymans@gmail.com>
   5  *                    2007 Thiago Sousa Santos <thiagoss@lcc.ufcg.edu.br>
   6  *
   7  * gstqueue2.h:
   8  *
   9  * This library is free software; you can redistribute it and/or
  10  * modify it under the terms of the GNU Library General Public
  11  * License as published by the Free Software Foundation; either
  12  * version 2 of the License, or (at your option) any later version.
  13  *
  14  * This library is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  17  * Library General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU Library General Public
  20  * License along with this library; if not, write to the
  21  * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
  22  * Boston, MA 02110-1301, USA.
  23  */
  24 #ifndef __GST_QUEUE2_H__
  25 #define __GST_QUEUE2_H__
  26
  27 #include <gst/gst.h>
  28 #include <stdio.h>
  29
  30 G_BEGIN_DECLS
  31
  32 #define GST_TYPE_QUEUE2 \
  33   (gst_queue2_get_type())
  34 #define GST_QUEUE2(obj) \
  35   (G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_QUEUE2,GstQueue2))
  36 #define GST_QUEUE2_CLASS(klass) \
  37   (G_TYPE_CHECK_CLASS_CAST((klass),GST_TYPE_QUEUE2,GstQueue2Class))
  38 #define GST_IS_QUEUE2(obj) \
  39   (G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_QUEUE2))
  40 #define GST_IS_QUEUE2_CLASS(klass) \
  41   (G_TYPE_CHECK_CLASS_TYPE((klass),GST_TYPE_QUEUE2))
  42 #define GST_QUEUE2_CAST(obj) \
  43   ((GstQueue2 *)(obj))
  44
  45 typedef struct _GstQueue2 GstQueue2;
  46 typedef struct _GstQueue2Size GstQueue2Size;
  47 typedef struct _GstQueue2Class GstQueue2Class;
  48 typedef struct _GstQueue2Range GstQueue2Range;
  49
  50 /* used to keep track of sizes (current and max) */
  51 struct _GstQueue2Size
  52 {
  53   guint buffers;
  54   guint bytes;
  55   guint64 time;
  56   guint64 rate_time;
  57 };
  58
  59 struct _GstQueue2Range
  60 {
  61   GstQueue2Range *next;
  62
  63   guint64 offset;          /* offset of range start in source */
  64   guint64 rb_offset;       /* offset of range start in ring buffer */
  65   guint64 writing_pos;     /* writing position in source */
  66   guint64 rb_writing_pos;  /* writing position in ring buffer */
  67   guint64 reading_pos;     /* reading position in source */
  68   guint64 max_reading_pos; /* latest requested offset in source */
  69 };
  70
  71 struct _GstQueue2
  72 {
  73   GstElement element;
  74
  75   /*< private > */
  76   GstPad *sinkpad;
  77   GstPad *srcpad;
  78
  79   /* upstream size in bytes (if downstream is operating in pull mode) */
  80   guint64 upstream_size;
  81
  82   /* segments to keep track of timestamps */
  83   GstSegment sink_segment;
  84   GstSegment src_segment;
  85
  86   /* Position of src/sink */
  87   GstClockTime sinktime, srctime;
  88   /* TRUE if either position needs to be recalculated */
  89   gboolean sink_tainted, src_tainted;
  90   /* Bitrates taken from tags */
  91   guint sink_tags_bitrate;
  92   guint src_tags_bitrate;
  93
  94   /* flowreturn when srcpad is paused */
  95   GstFlowReturn srcresult;
  96   GstFlowReturn sinkresult;
  97   gboolean is_eos;
  98   gboolean unexpected;
  99
 100   /* the queue of data we're keeping our hands on */
 101   GQueue queue;
 102
 103   GCond query_handled;
 104   gboolean last_query; /* result of last serialized query */
 105
 106   GstQueue2Size cur_level;       /* currently in the queue */
 107   GstQueue2Size max_level;       /* max. amount of data allowed in the queue */
 108   gboolean use_buffering;
 109   gboolean use_tags_bitrate;
 110   gboolean use_rate_estimate;
 111   GstClockTime buffering_interval;
 112
 113   /* low/high watermarks for buffering */
 114   gint low_watermark;
 115   gint high_watermark;
 116
 117   /* current buffering state */
 118   gboolean is_buffering;
 119   gint buffering_percent;
 120
 121   /* for measuring input/output rates */
 122   GTimer *in_timer;
 123   gboolean in_timer_started;
 124   gdouble last_update_in_rates_elapsed;
 125   gdouble last_in_elapsed;
 126   guint64 bytes_in;
 127   gdouble byte_in_rate;
 128   gdouble byte_in_period;
 129
 130   GTimer *out_timer;
 131   gboolean out_timer_started;
 132   gdouble last_out_elapsed;
 133   guint64 bytes_out;
 134   gdouble byte_out_rate;
 135
 136   GMutex qlock;                /* lock for queue (vs object lock) */
 137   gboolean waiting_add;
 138   GCond item_add;              /* signals buffers now available for reading */
 139   gboolean waiting_del;
 140   GCond item_del;              /* signals space now available for writing */
 141
 142   /* temp location stuff */
 143   gchar *temp_template;
 144   gboolean temp_location_set;
 145   gchar *temp_location;
 146   gboolean temp_remove;
 147   FILE *temp_file;
 148   /* list of downloaded areas and the current area */
 149   GstQueue2Range *ranges;
 150   GstQueue2Range *current;
 151   /* we need this to send the first new segment event of the stream
 152    * because we can't save it on the file */
 153   gboolean segment_event_received;
 154   GstEvent *starting_segment;
 155   gboolean seeking;
 156
 157   GstEvent *stream_start_event;
 158
 159   guint64 ring_buffer_max_size;
 160   guint8 * ring_buffer;
 161
 162   volatile gint downstream_may_block;
 163
 164   GstBufferingMode mode;
 165   gint64 buffering_left;
 166   gint avg_in;
 167   gint avg_out;
 168   gboolean percent_changed;
 169   GMutex buffering_post_lock; /* assures only one posted at a time */
 170 };
 171
 172 struct _GstQueue2Class
 173 {
 174   GstElementClass parent_class;
 175 };
 176
 177 G_GNUC_INTERNAL GType gst_queue2_get_type (void);
 178
 179 G_END_DECLS
 180
 181 #endif /* __GST_QUEUE2_H__ */