1 /* GStreamer Matroska muxer/demuxer
2  * (c) 2003 Ronald Bultje <rbultje@ronald.bitfreak.net>
3  * (c) 2011 Debarshi Ray <rishi@gnu.org>
4  *
5  * matroska-demux.h: matroska file/stream demuxer definition
6  *
7  * This library is free software; you can redistribute it and/or
8  * modify it under the terms of the GNU Library General Public
9  * License as published by the Free Software Foundation; either
10  * version 2 of the License, or (at your option) any later version.
11  *
12  * This library is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
15  * Library General Public License for more details.
16  *
17  * You should have received a copy of the GNU Library General Public
18  * License along with this library; if not, write to the
19  * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
20  * Boston, MA 02110-1301, USA.
21  */
22 
23 #ifndef __GST_MATROSKA_DEMUX_H__
24 #define __GST_MATROSKA_DEMUX_H__
25 
26 #include <gst/gst.h>
27 #include <gst/base/gstflowcombiner.h>
28 
29 #include "ebml-read.h"
30 #include "matroska-ids.h"
31 #include "matroska-read-common.h"
32 
33 G_BEGIN_DECLS
34 
35 #define GST_TYPE_MATROSKA_DEMUX \
36   (gst_matroska_demux_get_type ())
37 #define GST_MATROSKA_DEMUX(obj) \
38   (G_TYPE_CHECK_INSTANCE_CAST ((obj), GST_TYPE_MATROSKA_DEMUX, GstMatroskaDemux))
39 #define GST_MATROSKA_DEMUX_CLASS(klass) \
40   (G_TYPE_CHECK_CLASS_CAST ((klass), GST_TYPE_MATROSKA_DEMUX, GstMatroskaDemuxClass))
41 #define GST_IS_MATROSKA_DEMUX(obj) \
42   (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GST_TYPE_MATROSKA_DEMUX))
43 #define GST_IS_MATROSKA_DEMUX_CLASS(klass) \
44   (G_TYPE_CHECK_CLASS_TYPE ((klass), GST_TYPE_MATROSKA_DEMUX))
45 
46 typedef struct _GstMatroskaDemux {
47   GstElement              parent;
48 
49   /* < private > */
50 
51   GstMatroskaReadCommon    common;
52 
53   /* pads */
54   GstClock                *clock;
55   gboolean                 have_nonintraonly_v_streams;
56   guint                    num_v_streams;
57   guint                    num_a_streams;
58   guint                    num_t_streams;
59 
60   guint                    group_id;
61   gboolean                 have_group_id;
62 
63   GstFlowCombiner         *flowcombiner;
64 
65   /* state */
66   gboolean                 streaming;
67   guint64                  seek_block;
68   gboolean                 seek_first;
69 
70   /* did we parse cues/tracks/segmentinfo already? */
71   gboolean                 tracks_parsed;
72   GList                   *seek_parsed;
73 
74   /* cluster positions (optional) */
75   GArray                  *clusters;
76 
77   /* keeping track of playback position */
78   GstClockTime             last_stop_end;
79   GstClockTime             stream_start_time;
80 
81   /* Stop time for reverse playback */
82   GstClockTime             to_time;
83   GstEvent                *new_segment;
84 
85   /* some state saving */
86   GstClockTime             cluster_time;
87   guint64                  cluster_offset;
88   guint64                  cluster_prevsize;       /* 0 if unknown */
89   guint64                  first_cluster_offset;
90   guint64                  next_cluster_offset;
91   GstClockTime             requested_seek_time;
92   guint64                  seek_offset;
93 
94   /* alternative duration; optionally obtained from last cluster */
95   guint64                  last_cluster_offset;
96   GstClockTime             stream_last_time;
97 
98   /* index stuff */
99   gboolean                 seekable;
100   gboolean                 building_index;
101   guint64                  index_offset;
102   GstEvent                *seek_event;
103   GstEvent                *deferred_seek_event;
104   GstPad                  *deferred_seek_pad;
105   gboolean                 need_segment;
106   guint32                  segment_seqnum;
107 
108   /* reverse playback */
109   GArray                  *seek_index;
110   gint                     seek_entry;
111 
112   gboolean                 seen_cluster_prevsize;  /* We track this because the
113                                                     * first cluster won't have
114                                                     * this set, so we can't just
115                                                     * check cluster_prevsize to
116                                                     * determine if it's there
117                                                     * or not. We assume if one
118                                                     * cluster has it, all but
119                                                     * the first will have it. */
120 
121   guint                    max_backtrack_distance; /* in seconds (0 = don't backtrack) */
122 
123   /* gap handling */
124   guint64                  max_gap_time;
125 
126   /* for non-finalized files, with invalid segment duration */
127   gboolean                 invalid_duration;
128 
129   /* Cached upstream length (default G_MAXUINT64) */
130   guint64	           cached_length;
131 } GstMatroskaDemux;
132 
133 typedef struct _GstMatroskaDemuxClass {
134   GstElementClass parent;
135 } GstMatroskaDemuxClass;
136 
137 gboolean gst_matroska_demux_plugin_init (GstPlugin *plugin);
138 
139 G_END_DECLS
140 
141 #endif /* __GST_MATROSKA_DEMUX_H__ */
142