2 * Copyright (C) 2009 Edward Hervey <edward.hervey@collabora.co.uk>
3 * 2009 Nokia Corporation
5 * This library is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Library General Public
7 * License as published by the Free Software Foundation; either
8 * version 2 of the License, or (at your option) any later version.
10 * This library is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Library General Public License for more details.
15 * You should have received a copy of the GNU Library General Public
16 * License along with this library; if not, write to the
17 * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
18 * Boston, MA 02110-1301, USA.
21 #ifndef _GST_DISCOVERER_H_
22 #define _GST_DISCOVERER_H_
28 #define GST_TYPE_DISCOVERER_STREAM_INFO \
29 (gst_discoverer_stream_info_get_type ())
30 #define GST_DISCOVERER_STREAM_INFO(obj) \
31 (G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_DISCOVERER_STREAM_INFO, GstDiscovererStreamInfo))
32 #define GST_IS_DISCOVERER_STREAM_INFO(obj) \
33 (G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_DISCOVERER_STREAM_INFO))
34 typedef struct _GstDiscovererStreamInfo GstDiscovererStreamInfo;
35 typedef GObjectClass GstDiscovererStreamInfoClass;
36 GType gst_discoverer_stream_info_get_type (void);
39 * GstDiscovererStreamInfo:
41 * Base structure for information concerning a media stream. Depending on the
42 * stream type, one can find more media-specific information in
43 * #GstDiscovererAudioInfo, #GstDiscovererVideoInfo, and
44 * #GstDiscovererContainerInfo.
46 * The #GstDiscovererStreamInfo represents the topology of the stream. Siblings
47 * can be iterated over with gst_discoverer_stream_info_get_next() and
48 * gst_discoverer_stream_info_get_previous(). Children (sub-streams) of a
49 * stream can be accessed using the #GstDiscovererContainerInfo API.
51 * As a simple example, if you run #GstDiscoverer on an AVI file with one audio
52 * and one video stream, you will get a #GstDiscovererContainerInfo
53 * corresponding to the AVI container, which in turn will have a
54 * #GstDiscovererAudioInfo sub-stream and a #GstDiscovererVideoInfo sub-stream
55 * for the audio and video streams respectively.
57 #define gst_discoverer_stream_info_ref(info) ((GstDiscovererStreamInfo*) g_object_ref((GObject*) info))
58 #define gst_discoverer_stream_info_unref(info) (g_object_unref((GObject*) info))
60 GstDiscovererStreamInfo* gst_discoverer_stream_info_get_previous(GstDiscovererStreamInfo* info);
61 GstDiscovererStreamInfo* gst_discoverer_stream_info_get_next(GstDiscovererStreamInfo* info);
62 GstCaps* gst_discoverer_stream_info_get_caps(GstDiscovererStreamInfo* info);
63 const GstTagList* gst_discoverer_stream_info_get_tags(GstDiscovererStreamInfo* info);
64 const GstToc* gst_discoverer_stream_info_get_toc(GstDiscovererStreamInfo* info);
65 const gchar* gst_discoverer_stream_info_get_stream_id(GstDiscovererStreamInfo* info);
66 const GstStructure* gst_discoverer_stream_info_get_misc(GstDiscovererStreamInfo* info);
67 const gchar * gst_discoverer_stream_info_get_stream_type_nick(GstDiscovererStreamInfo* info);
70 * GstDiscovererContainerInfo:
72 * #GstDiscovererStreamInfo specific to container streams.
74 #define GST_TYPE_DISCOVERER_CONTAINER_INFO \
75 (gst_discoverer_container_info_get_type ())
76 #define GST_DISCOVERER_CONTAINER_INFO(obj) \
77 (G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_DISCOVERER_CONTAINER_INFO, GstDiscovererContainerInfo))
78 #define GST_IS_DISCOVERER_CONTAINER_INFO(obj) \
79 (G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_DISCOVERER_CONTAINER_INFO))
80 typedef struct _GstDiscovererContainerInfo GstDiscovererContainerInfo;
81 typedef GObjectClass GstDiscovererContainerInfoClass;
83 GType gst_discoverer_container_info_get_type (void);
85 GList *gst_discoverer_container_info_get_streams(GstDiscovererContainerInfo *info);
89 * GstDiscovererAudioInfo:
91 * #GstDiscovererStreamInfo specific to audio streams.
93 #define GST_TYPE_DISCOVERER_AUDIO_INFO \
94 (gst_discoverer_audio_info_get_type ())
95 #define GST_DISCOVERER_AUDIO_INFO(obj) \
96 (G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_DISCOVERER_AUDIO_INFO, GstDiscovererAudioInfo))
97 #define GST_IS_DISCOVERER_AUDIO_INFO(obj) \
98 (G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_DISCOVERER_AUDIO_INFO))
99 typedef struct _GstDiscovererAudioInfo GstDiscovererAudioInfo;
100 typedef GObjectClass GstDiscovererAudioInfoClass;
102 GType gst_discoverer_audio_info_get_type (void);
104 guint gst_discoverer_audio_info_get_channels(const GstDiscovererAudioInfo* info);
105 guint gst_discoverer_audio_info_get_sample_rate(const GstDiscovererAudioInfo* info);
106 guint gst_discoverer_audio_info_get_depth(const GstDiscovererAudioInfo* info);
107 guint gst_discoverer_audio_info_get_bitrate(const GstDiscovererAudioInfo* info);
108 guint gst_discoverer_audio_info_get_max_bitrate(const GstDiscovererAudioInfo* info);
109 const gchar * gst_discoverer_audio_info_get_language(const GstDiscovererAudioInfo* info);
112 * GstDiscovererVideoInfo:
114 * #GstDiscovererStreamInfo specific to video streams (this includes images).
116 #define GST_TYPE_DISCOVERER_VIDEO_INFO \
117 (gst_discoverer_video_info_get_type ())
118 #define GST_DISCOVERER_VIDEO_INFO(obj) \
119 (G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_DISCOVERER_VIDEO_INFO, GstDiscovererVideoInfo))
120 #define GST_IS_DISCOVERER_VIDEO_INFO(obj) \
121 (G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_DISCOVERER_VIDEO_INFO))
122 typedef struct _GstDiscovererVideoInfo GstDiscovererVideoInfo;
123 typedef GObjectClass GstDiscovererVideoInfoClass;
124 GType gst_discoverer_video_info_get_type (void);
126 guint gst_discoverer_video_info_get_width(const GstDiscovererVideoInfo* info);
127 guint gst_discoverer_video_info_get_height(const GstDiscovererVideoInfo* info);
128 guint gst_discoverer_video_info_get_depth(const GstDiscovererVideoInfo* info);
129 guint gst_discoverer_video_info_get_framerate_num(const GstDiscovererVideoInfo* info);
130 guint gst_discoverer_video_info_get_framerate_denom(const GstDiscovererVideoInfo* info);
131 guint gst_discoverer_video_info_get_par_num(const GstDiscovererVideoInfo* info);
132 guint gst_discoverer_video_info_get_par_denom(const GstDiscovererVideoInfo* info);
133 gboolean gst_discoverer_video_info_is_interlaced(const GstDiscovererVideoInfo* info);
134 guint gst_discoverer_video_info_get_bitrate(const GstDiscovererVideoInfo* info);
135 guint gst_discoverer_video_info_get_max_bitrate(const GstDiscovererVideoInfo* info);
136 gboolean gst_discoverer_video_info_is_image(const GstDiscovererVideoInfo* info);
139 * GstDiscovererSubtitleInfo:
141 * #GstDiscovererStreamInfo specific to subtitle streams (this includes text and
144 #define GST_TYPE_DISCOVERER_SUBTITLE_INFO \
145 (gst_discoverer_subtitle_info_get_type ())
146 #define GST_DISCOVERER_SUBTITLE_INFO(obj) \
147 (G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_DISCOVERER_SUBTITLE_INFO, GstDiscovererSubtitleInfo))
148 #define GST_IS_DISCOVERER_SUBTITLE_INFO(obj) \
149 (G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_DISCOVERER_SUBTITLE_INFO))
150 typedef struct _GstDiscovererSubtitleInfo GstDiscovererSubtitleInfo;
151 typedef GObjectClass GstDiscovererSubtitleInfoClass;
152 GType gst_discoverer_subtitle_info_get_type (void);
154 const gchar * gst_discoverer_subtitle_info_get_language(const GstDiscovererSubtitleInfo* info);
157 * GstDiscovererResult:
158 * @GST_DISCOVERER_OK: The discovery was successful
159 * @GST_DISCOVERER_URI_INVALID: the URI is invalid
160 * @GST_DISCOVERER_ERROR: an error happened and the GError is set
161 * @GST_DISCOVERER_TIMEOUT: the discovery timed-out
162 * @GST_DISCOVERER_BUSY: the discoverer was already discovering a file
163 * @GST_DISCOVERER_MISSING_PLUGINS: Some plugins are missing for full discovery
165 * Result values for the discovery process.
168 GST_DISCOVERER_OK = 0,
169 GST_DISCOVERER_URI_INVALID = 1,
170 GST_DISCOVERER_ERROR = 2,
171 GST_DISCOVERER_TIMEOUT = 3,
172 GST_DISCOVERER_BUSY = 4,
173 GST_DISCOVERER_MISSING_PLUGINS = 5
174 } GstDiscovererResult;
180 * Structure containing the information of a URI analyzed by #GstDiscoverer.
182 typedef struct _GstDiscovererInfo GstDiscovererInfo;
184 #define GST_TYPE_DISCOVERER_INFO \
185 (gst_discoverer_info_get_type ())
186 #define GST_DISCOVERER_INFO(obj) \
187 (G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_DISCOVERER_INFO, GstDiscovererInfo))
188 #define GST_IS_DISCOVERER_INFO(obj) \
189 (G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_DISCOVERER_INFO))
190 typedef GObjectClass GstDiscovererInfoClass;
191 GType gst_discoverer_info_get_type (void);
193 #define gst_discoverer_info_unref(info) (g_object_unref((GObject*)info))
194 #define gst_discoverer_info_ref(info) (g_object_ref((Gbject*)info))
196 GstDiscovererInfo* gst_discoverer_info_copy (GstDiscovererInfo * ptr);
198 const gchar* gst_discoverer_info_get_uri(const GstDiscovererInfo* info);
199 GstDiscovererResult gst_discoverer_info_get_result(const GstDiscovererInfo* info);
200 GstDiscovererStreamInfo* gst_discoverer_info_get_stream_info(GstDiscovererInfo* info);
201 GList* gst_discoverer_info_get_stream_list(GstDiscovererInfo* info);
202 GstClockTime gst_discoverer_info_get_duration(const GstDiscovererInfo* info);
203 gboolean gst_discoverer_info_get_seekable(const GstDiscovererInfo* info);
204 const GstStructure* gst_discoverer_info_get_misc(const GstDiscovererInfo* info);
205 const GstTagList* gst_discoverer_info_get_tags(const GstDiscovererInfo* info);
206 const GstToc* gst_discoverer_info_get_toc(const GstDiscovererInfo* info);
208 GList * gst_discoverer_info_get_streams (GstDiscovererInfo *info,
210 GList * gst_discoverer_info_get_audio_streams (GstDiscovererInfo *info);
211 GList * gst_discoverer_info_get_video_streams (GstDiscovererInfo *info);
212 GList * gst_discoverer_info_get_subtitle_streams (GstDiscovererInfo *info);
213 GList * gst_discoverer_info_get_container_streams (GstDiscovererInfo *info);
215 void gst_discoverer_stream_info_list_free (GList *infos);
217 #define GST_TYPE_DISCOVERER \
218 (gst_discoverer_get_type())
219 #define GST_DISCOVERER(obj) \
220 (G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_DISCOVERER,GstDiscoverer))
221 #define GST_DISCOVERER_CLASS(klass) \
222 (G_TYPE_CHECK_CLASS_CAST((klass),GST_TYPE_DISCOVERER,GstDiscovererClass))
223 #define GST_IS_DISCOVERER(obj) \
224 (G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_DISCOVERER))
225 #define GST_IS_DISCOVERER_CLASS(klass) \
226 (G_TYPE_CHECK_CLASS_TYPE((klass),GST_TYPE_DISCOVERER))
228 typedef struct _GstDiscoverer GstDiscoverer;
229 typedef struct _GstDiscovererClass GstDiscovererClass;
230 typedef struct _GstDiscovererPrivate GstDiscovererPrivate;
235 * The #GstDiscoverer structure.
237 struct _GstDiscoverer {
241 GstDiscovererPrivate *priv;
243 gpointer _reserved[GST_PADDING];
246 struct _GstDiscovererClass {
247 GObjectClass parentclass;
250 void (*finished) (GstDiscoverer *discoverer);
251 void (*starting) (GstDiscoverer *discoverer);
252 void (*discovered) (GstDiscoverer *discoverer,
253 GstDiscovererInfo *info,
255 void (*source_setup) (GstDiscoverer *discoverer,
258 gpointer _reserved[GST_PADDING];
261 GType gst_discoverer_get_type (void);
262 GstDiscoverer *gst_discoverer_new (GstClockTime timeout, GError **err);
264 /* Asynchronous API */
265 void gst_discoverer_start (GstDiscoverer *discoverer);
266 void gst_discoverer_stop (GstDiscoverer *discoverer);
267 gboolean gst_discoverer_discover_uri_async (GstDiscoverer *discoverer,
270 /* Synchronous API */
272 gst_discoverer_discover_uri (GstDiscoverer * discoverer,
278 #endif /* _GST_DISCOVERER_H */