Merge remote-tracking branch 'origin/0.10'
[platform/upstream/gstreamer.git] / 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., 59 Temple Place - Suite 330,
22  * Boston, MA 02111-1307, 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
91   /* flowreturn when srcpad is paused */
92   GstFlowReturn srcresult;
93   GstFlowReturn sinkresult;
94   gboolean is_eos;
95   gboolean unexpected;
96
97   /* the queue of data we're keeping our hands on */
98   GQueue queue;
99
100   GstQueue2Size cur_level;       /* currently in the queue */
101   GstQueue2Size max_level;       /* max. amount of data allowed in the queue */
102   gboolean use_buffering;
103   gboolean use_rate_estimate;
104   GstClockTime buffering_interval;
105   gint low_percent;             /* low/high watermarks for buffering */
106   gint high_percent;
107
108   /* current buffering state */
109   gboolean is_buffering;
110   gint buffering_percent;
111   guint buffering_iteration;
112
113   /* for measuring input/output rates */
114   GTimer *in_timer;
115   gboolean in_timer_started;
116   gdouble last_in_elapsed;
117   guint64 bytes_in;
118   gdouble byte_in_rate;
119   gdouble byte_in_period;
120
121   GTimer *out_timer;
122   gboolean out_timer_started;
123   gdouble last_out_elapsed;
124   guint64 bytes_out;
125   gdouble byte_out_rate;
126
127   GMutex qlock;                /* lock for queue (vs object lock) */
128   gboolean waiting_add;
129   GCond item_add;              /* signals buffers now available for reading */
130   gboolean waiting_del;
131   GCond item_del;              /* signals space now available for writing */
132
133   /* temp location stuff */
134   gchar *temp_template;
135   gboolean temp_location_set;
136   gchar *temp_location;
137   gboolean temp_remove;
138   FILE *temp_file;
139   /* list of downloaded areas and the current area */
140   GstQueue2Range *ranges;
141   GstQueue2Range *current;
142   /* we need this to send the first new segment event of the stream
143    * because we can't save it on the file */
144   gboolean segment_event_received;
145   GstEvent *starting_segment;
146   gboolean seeking;
147
148   GstEvent *stream_start_event;
149
150   guint64 ring_buffer_max_size;
151   guint8 * ring_buffer;
152 };
153
154 struct _GstQueue2Class
155 {
156   GstElementClass parent_class;
157 };
158
159 GType gst_queue2_get_type (void);
160
161 G_END_DECLS
162
163 #endif /* __GST_QUEUE2_H__ */