queue2: add the buffering percent in BUFFERING query
[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;
64   guint64 writing_pos;
65   guint64 reading_pos;
66   guint64 max_reading_pos;
67 };
68
69 struct _GstQueue2
70 {
71   GstElement element;
72
73   /*< private > */
74   GstPad *sinkpad;
75   GstPad *srcpad;
76
77   /* segments to keep track of timestamps */
78   GstSegment sink_segment;
79   GstSegment src_segment;
80
81   /* flowreturn when srcpad is paused */
82   GstFlowReturn srcresult;
83   GstFlowReturn sinkresult;
84   gboolean is_eos;
85   gboolean unexpected;
86
87   /* the queue of data we're keeping our hands on */
88   GQueue *queue;
89
90   GstQueue2Size cur_level;       /* currently in the queue */
91   GstQueue2Size max_level;       /* max. amount of data allowed in the queue */
92   gboolean use_buffering;
93   gboolean use_rate_estimate;
94   GstClockTime buffering_interval;
95   gint low_percent;             /* low/high watermarks for buffering */
96   gint high_percent;
97
98   /* current buffering state */
99   gboolean is_buffering;
100   gint buffering_percent;
101   guint buffering_iteration;
102
103   /* for measuring input/output rates */
104   GTimer *in_timer;
105   gboolean in_timer_started;
106   gdouble last_in_elapsed;
107   guint64 bytes_in;
108   gdouble byte_in_rate;
109
110   GTimer *out_timer;
111   gboolean out_timer_started;
112   gdouble last_out_elapsed;
113   guint64 bytes_out;
114   gdouble byte_out_rate;
115
116   GMutex *qlock;                /* lock for queue (vs object lock) */
117   gboolean waiting_add;
118   GCond *item_add;              /* signals buffers now available for reading */
119   gboolean waiting_del;
120   GCond *item_del;              /* signals space now available for writing */
121
122   /* temp location stuff */
123   gchar *temp_template;
124   gboolean temp_location_set;
125   gchar *temp_location;
126   gboolean temp_remove;
127   FILE *temp_file;
128   /* list of downloaded areas and the current area */
129   GstQueue2Range *ranges;
130   GstQueue2Range *current;
131   /* we need this to send the first new segment event of the stream
132    * because we can't save it on the file */
133   gboolean segment_event_received;
134   GstEvent *starting_segment;
135 };
136
137 struct _GstQueue2Class
138 {
139   GstElementClass parent_class;
140 };
141
142 GType gst_queue2_get_type (void);
143
144 G_END_DECLS
145
146 #endif /* __GST_QUEUE2_H__ */