2 * Copyright (C) 2004 Wim Taymans <wim@fluendo.com>
4 * gstoggdemux.c: ogg stream demuxer
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.
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.
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., 59 Temple Place - Suite 330,
19 * Boston, MA 02111-1307, USA.
22 #ifndef __GST_OGG_DEMUX_H__
23 #define __GST_OGG_DEMUX_H__
29 #include "gstoggstream.h"
33 #define GST_TYPE_OGG_PAD (gst_ogg_pad_get_type())
34 #define GST_OGG_PAD(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_OGG_PAD, GstOggPad))
35 #define GST_OGG_PAD_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST((klass),GST_TYPE_OGG_PAD, GstOggPad))
36 #define GST_IS_OGG_PAD(obj) (G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_OGG_PAD))
37 #define GST_IS_OGG_PAD_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass),GST_TYPE_OGG_PAD))
39 typedef struct _GstOggPad GstOggPad;
40 typedef struct _GstOggPadClass GstOggPadClass;
42 #define GST_TYPE_OGG_DEMUX (gst_ogg_demux_get_type())
43 #define GST_OGG_DEMUX(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_OGG_DEMUX, GstOggDemux))
44 #define GST_OGG_DEMUX_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST((klass),GST_TYPE_OGG_DEMUX, GstOggDemux))
45 #define GST_IS_OGG_DEMUX(obj) (G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_OGG_DEMUX))
46 #define GST_IS_OGG_DEMUX_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass),GST_TYPE_OGG_DEMUX))
48 GType gst_ogg_demux_get_type (void);
50 typedef struct _GstOggDemux GstOggDemux;
51 typedef struct _GstOggDemuxClass GstOggDemuxClass;
52 typedef struct _GstOggChain GstOggChain;
54 /* all information needed for one ogg chain (relevant for chained bitstreams) */
59 gint64 offset; /* starting offset of chain */
60 gint64 end_offset; /* end offset of chain */
61 gint64 bytes; /* number of bytes */
67 GstClockTime total_time; /* the total time of this chain, this is the MAX of
68 the totals of all streams */
69 GstClockTime begin_time; /* when this chain starts in the stream */
71 GstClockTime segment_start; /* the timestamp of the first sample, this is the MIN of
72 the start times of all streams. */
73 GstClockTime segment_stop; /* the timestamp of the last page, this is the MAX of the
77 /* different modes for the pad */
80 GST_OGG_PAD_MODE_INIT, /* we are feeding our internal decoder to get info */
81 GST_OGG_PAD_MODE_STREAMING, /* we are streaming buffers to the outside */
84 /* all information needed for one ogg stream */
87 GstPad pad; /* subclass GstPad */
92 GstOggChain *chain; /* the chain we are part of */
93 GstOggDemux *ogg; /* the ogg demuxer we are part of */
98 gint64 current_granule;
99 gint64 keyframe_granule;
101 GstClockTime start_time; /* the timestamp of the first sample */
103 gint64 first_granule; /* the granulepos of first page == first sample in next page */
104 GstClockTime first_time; /* the timestamp of the second page or granuletime of first page */
106 GstClockTime last_stop; /* last_stop when last push occured; used to detect when we
107 * need to send a newsegment update event for sparse streams */
112 GstFlowReturn last_ret; /* last return of _pad_push() */
118 struct _GstOggPadClass
120 GstPadClass parent_class;
126 * The ogg demuxer object structure.
141 gboolean need_chains;
145 GMutex *chain_lock; /* we need the lock to protect the chains */
146 GArray *chains; /* list of chains we know */
147 GstClockTime total_time;
148 gint bitrate; /* bitrate of the current chain */
150 GstOggChain *current_chain;
151 GstOggChain *building_chain;
153 /* playback start/stop positions */
155 gboolean segment_running;
159 GstEvent *newsegment; /* pending newsegment to be sent from _loop */
169 struct _GstOggDemuxClass
171 GstElementClass parent_class;
174 gboolean gst_ogg_demux_plugin_init (GstPlugin * plugin);
178 #endif /* __GST_OGG_DEMUX_H__ */