gstelement.h 19.2 KB
Newer Older
1 2
/* GStreamer
 * Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
3
 *               2000,2004 Wim Taymans <wim@fluendo.com>
4 5
 *
 * gstelement.h: Header for GstElement
Erik Walthinsen's avatar
Erik Walthinsen committed
6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Library General Public License for more details.
 *
 * You should have received a copy of the GNU Library General Public
 * License along with this library; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
 */


#ifndef __GST_ELEMENT_H__
#define __GST_ELEMENT_H__

27
#include <gst/gstconfig.h>
28
#include <gst/gsttypes.h>
Erik Walthinsen's avatar
Erik Walthinsen committed
29 30
#include <gst/gstobject.h>
#include <gst/gstpad.h>
31
#include <gst/gstclock.h>
32
#include <gst/gstplugin.h>
33
#include <gst/gstpluginfeature.h>
Wim Taymans's avatar
Wim Taymans committed
34
#include <gst/gstindex.h>
35
#include <gst/gstiterator.h>
Benjamin Otte's avatar
Benjamin Otte committed
36
#include <gst/gsttag.h>
Erik Walthinsen's avatar
Erik Walthinsen committed
37

38 39 40
G_BEGIN_DECLS

typedef struct _GstElementDetails GstElementDetails;
41 42

/* FIXME: need translatable stuff in here (how handle in registry)? */
43 44 45
struct _GstElementDetails
{
  /*< public > */
46 47 48 49
  gchar *longname;              /* long, english name */
  gchar *klass;                 /* type of element, as hierarchy */
  gchar *description;           /* insights of one form or another */
  gchar *author;                /* who wrote this thing? */
50

51
  /*< private > */
52
  gpointer _gst_reserved[GST_PADDING];
53
};
54

55
#define GST_ELEMENT_DETAILS(longname,klass,description,author)		\
56
  { longname, klass, description, author, GST_PADDING_INIT }
57 58 59 60
#define GST_IS_ELEMENT_DETAILS(details) (					\
  (details) && ((details)->longname != NULL) && ((details)->klass != NULL)	\
  && ((details)->description != NULL) && ((details)->author != NULL))

61
#define GST_NUM_STATES 4
Erik Walthinsen's avatar
Erik Walthinsen committed
62

63 64 65
/* NOTE: this probably should be done with an #ifdef to decide 
 * whether to safe-cast or to just do the non-checking cast.
 */
66 67
#define GST_STATE(obj)			(GST_ELEMENT(obj)->current_state)
#define GST_STATE_PENDING(obj)		(GST_ELEMENT(obj)->pending_state)
68
#define GST_STATE_ERROR(obj)		(GST_ELEMENT(obj)->state_error)
69

70
/* Note: using 8 bit shift mostly "just because", it leaves us enough room to grow <g> */
71
#define GST_STATE_TRANSITION(obj)	((GST_STATE(obj)<<8) | GST_STATE_PENDING(obj))
72
#define GST_STATE_NULL_TO_READY		((GST_STATE_NULL<<8) | GST_STATE_READY)
73
#define GST_STATE_READY_TO_PAUSED	((GST_STATE_READY<<8) | GST_STATE_PAUSED)
74
#define GST_STATE_PAUSED_TO_PLAYING	((GST_STATE_PAUSED<<8) | GST_STATE_PLAYING)
75 76
#define GST_STATE_PLAYING_TO_PAUSED	((GST_STATE_PLAYING<<8) | GST_STATE_PAUSED)
#define GST_STATE_PAUSED_TO_READY	((GST_STATE_PAUSED<<8) | GST_STATE_READY)
77
#define GST_STATE_READY_TO_NULL		((GST_STATE_READY<<8) | GST_STATE_NULL)
78

79
GST_EXPORT GType _gst_element_type;
80 81 82

#define GST_TYPE_ELEMENT		(_gst_element_type)
#define GST_IS_ELEMENT(obj)		(G_TYPE_CHECK_INSTANCE_TYPE ((obj), GST_TYPE_ELEMENT))
Wim Taymans's avatar
Wim Taymans committed
83 84
#define GST_IS_ELEMENT_CLASS(klass)	(G_TYPE_CHECK_CLASS_TYPE ((klass), GST_TYPE_ELEMENT))
#define GST_ELEMENT_GET_CLASS(obj)	(G_TYPE_INSTANCE_GET_CLASS ((obj), GST_TYPE_ELEMENT, GstElementClass))
85 86
#define GST_ELEMENT(obj)		(G_TYPE_CHECK_INSTANCE_CAST ((obj), GST_TYPE_ELEMENT, GstElement))
#define GST_ELEMENT_CLASS(klass)	(G_TYPE_CHECK_CLASS_CAST ((klass), GST_TYPE_ELEMENT, GstElementClass))
87
#define GST_ELEMENT_CAST(obj)		((GstElement*)(obj))
Erik Walthinsen's avatar
Erik Walthinsen committed
88

89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105
/* convenience functions */
#ifdef G_HAVE_ISO_VARARGS
#define GST_ELEMENT_QUERY_TYPE_FUNCTION(functionname, ...) \
	GST_QUERY_TYPE_FUNCTION (GstElement*, functionname, __VA_ARGS__);
#define GST_ELEMENT_FORMATS_FUNCTION(functionname, ...)    \
	GST_FORMATS_FUNCTION (GstElement*, functionname, __VA_ARGS__);
#define GST_ELEMENT_EVENT_MASK_FUNCTION(functionname, ...) \
	GST_EVENT_MASK_FUNCTION (GstElement*, functionname, __VA_ARGS__);
#elif defined(G_HAVE_GNUC_VARARGS)
#define GST_ELEMENT_QUERY_TYPE_FUNCTION(functionname, a...) \
	GST_QUERY_TYPE_FUNCTION (GstElement*, functionname, a);
#define GST_ELEMENT_FORMATS_FUNCTION(functionname, a...)    \
	GST_FORMATS_FUNCTION (GstElement*, functionname, a);
#define GST_ELEMENT_EVENT_MASK_FUNCTION(functionname, a...) \
	GST_EVENT_MASK_FUNCTION (GstElement*, functionname, a);
#endif

106 107
typedef enum
{
Wim Taymans's avatar
Wim Taymans committed
108 109
  /* input and output pads aren't directly coupled to each other
     examples: queues, multi-output async readers, etc. */
110
  GST_ELEMENT_DECOUPLED,
111 112 113
  /* this element, for some reason, has a loop function that performs
   * an infinite loop without calls to gst_element_yield () */
  GST_ELEMENT_INFINITE_LOOP,
Wim Taymans's avatar
Wim Taymans committed
114
  /* there is a new loopfunction ready for placement */
115
  GST_ELEMENT_NEW_LOOPFUNC,
116 117
  /* if this element can handle events */
  GST_ELEMENT_EVENT_AWARE,
118

119 120 121
  /* private flags that can be used by the scheduler */
  GST_ELEMENT_SCHEDULER_PRIVATE1,
  GST_ELEMENT_SCHEDULER_PRIVATE2,
122

123 124 125
  /* ignore state changes from parent */
  GST_ELEMENT_LOCKED_STATE,

126
  /* element is in error */
127
  GST_ELEMENT_IN_ERROR,
128

129
  /* use some padding for future expansion */
130 131
  GST_ELEMENT_FLAG_LAST		= GST_OBJECT_FLAG_LAST + 16
} GstElementFlags;
132

133
#define GST_ELEMENT_IS_THREAD_SUGGESTED(obj)	(GST_FLAG_IS_SET(obj,GST_ELEMENT_THREAD_SUGGESTED))
134
#define GST_ELEMENT_IS_EVENT_AWARE(obj)		(GST_FLAG_IS_SET(obj,GST_ELEMENT_EVENT_AWARE))
135
#define GST_ELEMENT_IS_DECOUPLED(obj)		(GST_FLAG_IS_SET(obj,GST_ELEMENT_DECOUPLED))
136
#define GST_ELEMENT_IS_LOCKED_STATE(obj)        (GST_FLAG_IS_SET(obj,GST_ELEMENT_LOCKED_STATE))
137

138 139
#define GST_ELEMENT_NAME(obj)			(GST_OBJECT_NAME(obj))
#define GST_ELEMENT_PARENT(obj)			(GST_OBJECT_PARENT(obj))
Wim Taymans's avatar
Wim Taymans committed
140
#define GST_ELEMENT_SCHEDULER(obj)		(GST_ELEMENT_CAST(obj)->scheduler)
141 142
#define GST_ELEMENT_CLOCK(obj)			(GST_ELEMENT_CAST(obj)->clock)
#define GST_ELEMENT_PADS(obj)			(GST_ELEMENT_CAST(obj)->pads)
143

144 145 146 147 148 149 150 151 152 153 154 155
/**
 * GST_ELEMENT_ERROR:
 * @el: the element that throws the error
 * @domain: like CORE, LIBRARY, RESOURCE or STREAM (see #GstError)
 * @code: error code defined for that domain (see #GstError)
 * @message: the message to display (format string and args enclosed in round brackets)
 * @debug: debugging information for the message (format string and args enclosed in round brackets)
 *
 * Utility function that elements can use in case they encountered a fatal
 * data processing error. The pipeline will throw an error signal and the
 * application will be requested to stop further media processing.
 */
156 157 158 159 160 161 162 163 164 165 166
#define GST_ELEMENT_ERROR(el, domain, code, message, debug) 		\
G_STMT_START { 								\
  gchar *__msg = _gst_element_error_printf message; 			\
  gchar *__dbg = _gst_element_error_printf debug; 			\
  if (__msg) 								\
    GST_ERROR_OBJECT (el, "%s", __msg); 				\
  if (__dbg) 								\
    GST_ERROR_OBJECT (el, "%s", __dbg); 				\
  gst_element_error_full (GST_ELEMENT(el), 				\
    GST_ ## domain ## _ERROR, GST_ ## domain ## _ERROR_ ## code, 	\
    __msg, __dbg, __FILE__, GST_FUNCTION, __LINE__); 			\
167
} G_STMT_END
168

Erik Walthinsen's avatar
Erik Walthinsen committed
169
typedef struct _GstElementFactory GstElementFactory;
170
typedef struct _GstElementFactoryClass GstElementFactoryClass;
Erik Walthinsen's avatar
Erik Walthinsen committed
171

172
typedef void 		(*GstElementLoopFunction) 	(GstElement *element);
Erik Walthinsen's avatar
Erik Walthinsen committed
173

174 175 176 177 178 179 180 181 182 183 184 185
/* the state change mutexes and conds */
#define GST_STATE_GET_LOCK(elem)               (GST_ELEMENT_CAST(elem)->state_lock)
#define GST_STATE_LOCK(elem)                   g_mutex_lock(GST_STATE_GET_LOCK(elem))
#define GST_STATE_TRYLOCK(elem)                g_mutex_trylock(GST_STATE_GET_LOCK(elem))
#define GST_STATE_UNLOCK(elem)                 g_mutex_unlock(GST_STATE_GET_LOCK(elem))
#define GST_STATE_GET_COND(elem)               (GST_ELEMENT_CAST(elem)->state_cond)
#define GST_STATE_WAIT(elem)                   g_cond_wait (GST_STATE_GET_COND (elem), GST_STATE_GET_LOCK (elem))
#define GST_STATE_TIMED_WAIT(elem, timeval)    g_cond_timed_wait (GST_STATE_GET_COND (elem), GST_STATE_GET_LOCK (elem),\
		                                                timeval)
#define GST_STATE_SIGNAL(elem)                 g_cond_signal (GST_STATE_GET_COND (elem));
#define GST_STATE_BROADCAST(elem)              g_cond_broadcast (GST_STATE_GET_COND (elem));

Wim Taymans's avatar
Wim Taymans committed
186
struct _GstElement
187
{
188
  GstObject 		object;
Erik Walthinsen's avatar
Erik Walthinsen committed
189

190 191 192 193 194 195 196 197 198 199
  /*< public >*/ /* with STATE_LOCK */
  /* element state */
  GMutex               *state_lock;
  GCond                *state_cond;
  guint8                current_state;
  guint8                pending_state;
  gboolean              state_error; /* flag is set when the element has an error in the last state
                                        change. it is cleared when doing another state change. */
  /*< public >*/ /* with LOCK */
  /* scheduling */
Erik Walthinsen's avatar
Erik Walthinsen committed
200
  GstElementLoopFunction loopfunc;
Wim Taymans's avatar
Wim Taymans committed
201
  GstScheduler 	       *scheduler;
202
  /* private pointer for the scheduler */
203
  gpointer		sched_private;
Wim Taymans's avatar
Wim Taymans committed
204 205

  /* allocated clock */
206
  GstClock	       *clock;
207
  GstClockTimeDiff    	base_time; /* NULL/READY: 0 - PAUSED: current time - PLAYING: difference to clock */
208

209
  /* element pads, these lists can only be iterated while holding
210
   * the LOCK or checking the cookie after each LOCK. */
211 212 213 214 215 216 217 218 219
  guint16               numpads;
  GList                *pads;
  guint16               numsrcpads;
  GList                *srcpads;
  guint16               numsinkpads;
  GList                *sinkpads;
  guint32               pads_cookie;

  /*< private >*/
220
  gpointer _gst_reserved[GST_PADDING];
Erik Walthinsen's avatar
Erik Walthinsen committed
221 222
};

223 224
struct _GstElementClass
{
225
  GstObjectClass         parent_class;
Erik Walthinsen's avatar
Erik Walthinsen committed
226

227
  /*< public >*/
228
  /* the element details */
229
  GstElementDetails 	 details;
230 231

  /* factory that the element was created from */
232
  GstElementFactory	*elementfactory;
233

234
  /* templates for our pads */
235 236 237
  GList                 *padtemplates;
  gint                   numpadtemplates;
  guint32                pad_templ_cookie;
238

Erik Walthinsen's avatar
Erik Walthinsen committed
239
  /* signal callbacks */
240 241 242
  void (*state_change)	(GstElement *element, GstElementState old, GstElementState state);
  void (*new_pad)	(GstElement *element, GstPad *pad);
  void (*pad_removed)	(GstElement *element, GstPad *pad);
243
  void (*no_more_pads)	(GstElement *element);
244 245 246
  void (*error)		(GstElement *element, GstElement *source, GError *error, gchar *debug);
  void (*eos)		(GstElement *element);
  void (*found_tag)	(GstElement *element, GstElement *source, const GstTagList *tag_list);
247

248
  /*< protected >*/
Wim Taymans's avatar
Wim Taymans committed
249
  /* vtable */
250 251

  /* request/release pads */
252 253
  GstPad*		(*request_new_pad)	(GstElement *element, GstPadTemplate *templ, const gchar* name);
  void			(*release_pad)		(GstElement *element, GstPad *pad);
254

255 256 257 258 259 260 261 262
  /* state changes */
  GstElementStateReturn (*change_state)		(GstElement *element);
  GstElementStateReturn	(*set_state)		(GstElement *element, GstElementState state);

  /* scheduling */
  gboolean		(*release_locks)	(GstElement *element);
  void			(*set_scheduler)	(GstElement *element, GstScheduler *scheduler);

263
  /* set/get clocks */
264 265
  GstClock*		(*get_clock)		(GstElement *element);
  void			(*set_clock)		(GstElement *element, GstClock *clock);
266

Wim Taymans's avatar
Wim Taymans committed
267
  /* index */
268 269
  GstIndex*		(*get_index)		(GstElement *element);
  void			(*set_index)		(GstElement *element, GstIndex *index);
Wim Taymans's avatar
Wim Taymans committed
270

271 272 273 274 275 276 277 278 279 280
  /* query/convert/events functions */
  const GstEventMask*   (*get_event_masks)     	(GstElement *element);
  gboolean		(*send_event)		(GstElement *element, GstEvent *event);
  const GstFormat*      (*get_formats)        	(GstElement *element);
  gboolean              (*convert)        	(GstElement *element,
		                                 GstFormat  src_format,  gint64  src_value,
						 GstFormat *dest_format, gint64 *dest_value);
  const GstQueryType* 	(*get_query_types)    	(GstElement *element);
  gboolean		(*query)		(GstElement *element, GstQueryType type,
		  				 GstFormat *format, gint64 *value);
Wim Taymans's avatar
Wim Taymans committed
281

282 283
  /*< private >*/
  gpointer _gst_reserved[GST_PADDING];
Erik Walthinsen's avatar
Erik Walthinsen committed
284 285
};

286
/* element class pad templates */
287
void			gst_element_class_add_pad_template	(GstElementClass *klass, GstPadTemplate *templ);
288 289
GstPadTemplate*		gst_element_class_get_pad_template	(GstElementClass *element_class, const gchar *name);
GList*                  gst_element_class_get_pad_template_list (GstElementClass *element_class);
290 291
void			gst_element_class_set_details		(GstElementClass *klass,
								 const GstElementDetails *details);
292

293 294
/* element instance */
GType			gst_element_get_type		(void);
Erik Walthinsen's avatar
Erik Walthinsen committed
295

296
/* basic name and parentage stuff from GstObject */
Thomas Vander Stichele's avatar
Thomas Vander Stichele committed
297
#define			gst_element_get_name(elem)	gst_object_get_name(GST_OBJECT(elem))
Thomas Vander Stichele's avatar
oops  
Thomas Vander Stichele committed
298
#define			gst_element_set_name(elem,name)	gst_object_set_name(GST_OBJECT(elem),name)
Thomas Vander Stichele's avatar
Thomas Vander Stichele committed
299
#define			gst_element_get_parent(elem)	gst_object_get_parent(GST_OBJECT(elem))
Thomas Vander Stichele's avatar
oops  
Thomas Vander Stichele committed
300
#define			gst_element_set_parent(elem,parent)	gst_object_set_parent(GST_OBJECT(elem),parent)
Thomas Vander Stichele's avatar
Thomas Vander Stichele committed
301

302
/* clocking */
303 304 305 306 307 308 309 310 311
gboolean		gst_element_requires_clock	(GstElement *element);
gboolean		gst_element_provides_clock	(GstElement *element);
GstClock*		gst_element_get_clock 		(GstElement *element);
void			gst_element_set_clock 		(GstElement *element, GstClock *clock);
GstClockReturn		gst_element_clock_wait 		(GstElement *element, 
							 GstClockID id, GstClockTimeDiff *jitter);
GstClockTime		gst_element_get_time		(GstElement *element);
gboolean		gst_element_wait		(GstElement *element, GstClockTime timestamp);
void			gst_element_set_time		(GstElement *element, GstClockTime time);
312 313
void			gst_element_set_time_delay	(GstElement *element, GstClockTime time, GstClockTime delay);

314
void			gst_element_adjust_time		(GstElement *element, GstClockTimeDiff diff);
315 316

/* indexes */
317 318 319 320
gboolean		gst_element_is_indexable	(GstElement *element);
void			gst_element_set_index		(GstElement *element, GstIndex *index);
GstIndex*		gst_element_get_index		(GstElement *element);

321 322 323
/* scheduling */
void			gst_element_set_loop_function	(GstElement *element,
							 GstElementLoopFunction loop);
324 325 326 327 328
gboolean		gst_element_release_locks	(GstElement *element);
void			gst_element_yield		(GstElement *element);
gboolean		gst_element_interrupt		(GstElement *element);
void			gst_element_set_scheduler	(GstElement *element, GstScheduler *sched);
GstScheduler*		gst_element_get_scheduler	(GstElement *element);
329
GstBin*			gst_element_get_managing_bin	(GstElement *element);
330

331
/* pad management */
332 333
gboolean		gst_element_add_pad		(GstElement *element, GstPad *pad);
gboolean		gst_element_remove_pad		(GstElement *element, GstPad *pad);
334
GstPad *		gst_element_add_ghost_pad	(GstElement *element, GstPad *pad, const gchar *name);
335
void			gst_element_no_more_pads	(GstElement *element);
336 337 338 339 340 341

GstPad*			gst_element_get_pad		(GstElement *element, const gchar *name);
GstPad*			gst_element_get_static_pad	(GstElement *element, const gchar *name);
GstPad*			gst_element_get_request_pad	(GstElement *element, const gchar *name);
void			gst_element_release_request_pad	(GstElement *element, GstPad *pad);

342
GstIterator *		gst_element_iterate_pads 	(GstElement * element);
343

344
/* event/query/format stuff */
345 346 347 348 349 350 351 352 353 354 355 356 357 358 359
G_CONST_RETURN GstEventMask*
			gst_element_get_event_masks	(GstElement *element);
gboolean		gst_element_send_event		(GstElement *element, GstEvent *event);
gboolean		gst_element_seek		(GstElement *element, GstSeekType seek_type,
							 guint64 offset);
G_CONST_RETURN GstQueryType*
			gst_element_get_query_types	(GstElement *element);
gboolean		gst_element_query		(GstElement *element, GstQueryType type,
			                                 GstFormat *format, gint64 *value);
G_CONST_RETURN GstFormat*
			gst_element_get_formats		(GstElement *element);
gboolean		gst_element_convert		(GstElement *element, 
		 					 GstFormat  src_format,  gint64  src_value,
							 GstFormat *dest_format, gint64 *dest_value);

360
/* error handling */
361 362 363 364
gchar *			_gst_element_error_printf	(const gchar *format, ...);
void			gst_element_error_full		(GstElement *element, GQuark domain, gint code, 
							 gchar *message, gchar *debug, 
							 const gchar *file, const gchar *function, gint line);
365 366 367 368
void 			gst_element_default_error	(GObject *object, GstObject *orig, GError *error, gchar *debug);
#define 		gst_element_default_deep_notify gst_object_default_deep_notify

/* state management */
369
gboolean		gst_element_is_locked_state	(GstElement *element);
370
gboolean		gst_element_set_locked_state	(GstElement *element, gboolean locked_state);
371 372 373 374 375 376 377
gboolean		gst_element_sync_state_with_parent (GstElement *element);

GstElementState         gst_element_get_state           (GstElement *element);
GstElementStateReturn	gst_element_set_state		(GstElement *element, GstElementState state);

void 			gst_element_wait_state_change 	(GstElement *element);

Wim Taymans's avatar
Wim Taymans committed
378 379
void			gst_element_set_eos		(GstElement *element);

380 381
/* factory management */
GstElementFactory*	gst_element_get_factory		(GstElement *element);
382

Wim Taymans's avatar
Wim Taymans committed
383

384 385 386 387
/* misc */
void			gst_element_found_tags		(GstElement *element, const GstTagList *tag_list);
void			gst_element_found_tags_for_pad	(GstElement *element, GstPad *pad, GstClockTime timestamp, 
							 GstTagList *list);
Wim Taymans's avatar
Wim Taymans committed
388
/*
389 390 391 392
 *
 * factories stuff
 *
 **/
393

394 395
#define GST_TYPE_ELEMENT_FACTORY 		(gst_element_factory_get_type())
#define GST_ELEMENT_FACTORY(obj)  		(G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_ELEMENT_FACTORY,\
396
						 GstElementFactory))
397
#define GST_ELEMENT_FACTORY_CLASS(klass) 	(G_TYPE_CHECK_CLASS_CAST((klass),GST_TYPE_ELEMENT_FACTORY,\
398
						 GstElementFactoryClass))
399 400
#define GST_IS_ELEMENT_FACTORY(obj) 		(G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_ELEMENT_FACTORY))
#define GST_IS_ELEMENT_FACTORY_CLASS(klass) 	(G_TYPE_CHECK_CLASS_TYPE((klass),GST_TYPE_ELEMENT_FACTORY))
401

402 403
struct _GstElementFactory {
  GstPluginFeature	parent;
404

405
  GType			type;			/* unique GType of element or 0 if not loaded */
406

407
  GstElementDetails	details;
Joshua N. Pritikin's avatar
Joshua N. Pritikin committed
408

409 410
  GList *		padtemplates;
  guint			numpadtemplates;
411

Benjamin Otte's avatar
Benjamin Otte committed
412
  /* URI interface stuff */
413 414 415 416
  guint			uri_type;
  gchar **		uri_protocols;
  
  GList *		interfaces;		/* interfaces this element implements */
Benjamin Otte's avatar
Benjamin Otte committed
417

418
  gpointer _gst_reserved[GST_PADDING];
419 420
};

421
struct _GstElementFactoryClass {
422
  GstPluginFeatureClass parent_class;
423

424
  gpointer _gst_reserved[GST_PADDING];
425 426
};

427 428 429
GType 			gst_element_factory_get_type 		(void);

gboolean		gst_element_register			(GstPlugin *plugin,
430
								 const gchar *name,
431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457
								 guint rank,
								 GType type);

GstElementFactory *	gst_element_factory_find		(const gchar *name);
GType			gst_element_factory_get_element_type	(GstElementFactory *factory);
G_CONST_RETURN gchar *	gst_element_factory_get_longname	(GstElementFactory *factory);
G_CONST_RETURN gchar *	gst_element_factory_get_klass		(GstElementFactory *factory);
G_CONST_RETURN gchar *	gst_element_factory_get_description  	(GstElementFactory *factory);
G_CONST_RETURN gchar *	gst_element_factory_get_author		(GstElementFactory *factory);
guint			gst_element_factory_get_num_pad_templates (GstElementFactory *factory);
G_CONST_RETURN GList *	gst_element_factory_get_pad_templates	(GstElementFactory *factory);
guint			gst_element_factory_get_uri_type	(GstElementFactory *factory);		
gchar **		gst_element_factory_get_uri_protocols	(GstElementFactory *factory);		

GstElement*		gst_element_factory_create		(GstElementFactory *factory,
								 const gchar *name);
GstElement*		gst_element_factory_make		(const gchar *factoryname, const gchar *name);

gboolean		gst_element_factory_can_src_caps	(GstElementFactory *factory,
								 const GstCaps *caps);
gboolean		gst_element_factory_can_sink_caps	(GstElementFactory *factory,
								 const GstCaps *caps);

void			__gst_element_factory_add_pad_template	(GstElementFactory *elementfactory,
								 GstPadTemplate *templ);
void			__gst_element_factory_add_interface	(GstElementFactory *elementfactory,
								 const gchar *interfacename);
458

459
G_END_DECLS
460

461
#endif /* __GST_ELEMENT_H__ */