mirrors/gstreamer
mirrors/gstreamer
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2024-09-23 04:20:17 +00:00
Code Issues 1 Projects Releases Wiki Activity

whitespace fixes

Browse source 
Original commit message from CVS:
whitespace fixes
This commit is contained in:
Thomas Vander Stichele 2005-10-15 15:30:24 +00:00
parent e3e695a537
commit 2dd1598c56
115 changed files with 566 additions and 566 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

24
gst/base/gstadapter.c
View file

@ -22,14 +22,14 @@
* @short_description: object to splice and merge buffers to desired size * @short_description: object to splice and merge buffers to desired size
* @see_also: #GstBytestream, #GstFilePad * @see_also: #GstBytestream, #GstFilePad
* *
* This class is for elements that receive buffers in an undesired size. * This class is for elements that receive buffers in an undesired size.
* While for example raw video contains one image per buffer, the same is not * While for example raw video contains one image per buffer, the same is not
* true for a lot of other formats, especially those that come directly from * true for a lot of other formats, especially those that come directly from
* a file. So if you have undefined buffer sizes and require a specific size, * a file. So if you have undefined buffer sizes and require a specific size,
* this object is for you. * this object is for you.
* *
* The theory of operation is like this: All buffers received are put * The theory of operation is like this: All buffers received are put
* into the adapter using gst_adapter_push() and the data is then read back * into the adapter using gst_adapter_push() and the data is then read back
* in chunks of the desired size using gst_adapter_peek(). After the data is * in chunks of the desired size using gst_adapter_peek(). After the data is
* processed, it is freed using gst_adapter_flush(). An example function that * processed, it is freed using gst_adapter_flush(). An example function that
* needs to process data in 10 byte chunks could look like this: * needs to process data in 10 byte chunks could look like this:
@ -51,10 +51,10 @@
* For another example, a simple element inside GStreamer that uses GstAdapter * For another example, a simple element inside GStreamer that uses GstAdapter
* is the libvisual element. * is the libvisual element.
* *
* A last thing to note is that while GstAdapter is pretty optimized, * A last thing to note is that while GstAdapter is pretty optimized,
* merging buffers still might be an operation that requires a memcpy() * merging buffers still might be an operation that requires a memcpy()
* operation, and this operation is not the fastest. Because of this, some * operation, and this operation is not the fastest. Because of this, some
* functions like gst_adapter_available_fast() are provided to help speed up * functions like gst_adapter_available_fast() are provided to help speed up
* such cases should you want to. * such cases should you want to.
*/ */
@ -152,7 +152,7 @@ gst_adapter_clear (GstAdapter * adapter)
* @adapter: a #GstAdapter * @adapter: a #GstAdapter
* @buf: the #GstBuffer to queue into the adapter * @buf: the #GstBuffer to queue into the adapter
* *
* Adds the data from @buf to the data stored inside @adapter and takes * Adds the data from @buf to the data stored inside @adapter and takes
* ownership of the buffer. * ownership of the buffer.
*/ */
void void
@ -295,8 +295,8 @@ gst_adapter_take (GstAdapter * adapter, guint nbytes)
* gst_adapter_available: * gst_adapter_available:
* @adapter: a #GstAdapter * @adapter: a #GstAdapter
* *
* Gets the maximum amount of bytes available, that is it returns the maximum * Gets the maximum amount of bytes available, that is it returns the maximum
* value that can be supplied to gst_adapter_peek() without that function * value that can be supplied to gst_adapter_peek() without that function
* returning NULL. * returning NULL.
* *
* Returns: amount of bytes available in @adapter * Returns: amount of bytes available in @adapter

2
gst/base/gstbasesink.c
View file

@ -964,7 +964,7 @@ gst_base_sink_wait (GstBaseSink * basesink, GstClockTime time)
} }
/* perform synchronisation on a buffer /* perform synchronisation on a buffer
* *
* 1) check if we have a clock, if not, do nothing * 1) check if we have a clock, if not, do nothing
* 2) calculate the start and end time of the buffer * 2) calculate the start and end time of the buffer
* 3) create a single shot notification to wait on * 3) create a single shot notification to wait on

16
gst/base/gstbasetransform.c
View file

@ -157,8 +157,8 @@
* interested in modifying the buffers. * interested in modifying the buffers.
* </para></listitem> * </para></listitem>
* <listitem><para> * <listitem><para>
* Elements which are always in passthrough mode whenever the same caps has * Elements which are always in passthrough mode whenever the same caps has
* been negotiated on both pads can set the class variable * been negotiated on both pads can set the class variable
* passthrough_on_same_caps to have this behaviour automatically. * passthrough_on_same_caps to have this behaviour automatically.
* </para></listitem> * </para></listitem>
* </itemizedlist> * </itemizedlist>
@ -824,7 +824,7 @@ gst_base_transform_prepare_output_buf (GstBaseTransform * trans,
return ret; return ret;
} }
/* If the output buffer metadata is modifiable, copy timestamps and /* If the output buffer metadata is modifiable, copy timestamps and
* buffer flags */ * buffer flags */
if (*buf != input && GST_MINI_OBJECT_REFCOUNT_VALUE (*buf) == 1) { if (*buf != input && GST_MINI_OBJECT_REFCOUNT_VALUE (*buf) == 1) {
@ -1102,7 +1102,7 @@ gst_base_transform_handle_buffer (GstBaseTransform * trans, GstBuffer * inbuf,
*outbuf = NULL; *outbuf = NULL;
if (want_in_place) { if (want_in_place) {
/* If want_in_place is TRUE, we may need to prepare a new output buffer /* If want_in_place is TRUE, we may need to prepare a new output buffer
* Sub-classes can implement a prepare_output_buffer function as they * Sub-classes can implement a prepare_output_buffer function as they
* wish. */ * wish. */
GST_LOG_OBJECT (trans, "doing inplace transform"); GST_LOG_OBJECT (trans, "doing inplace transform");
@ -1373,9 +1373,9 @@ gst_base_transform_change_state (GstElement * element,
* @passthrough: boolean indicating passthrough mode. * @passthrough: boolean indicating passthrough mode.
* *
* Set passthrough mode for this filter by default. This is mostly * Set passthrough mode for this filter by default. This is mostly
* useful for filters that do not care about negotiation. * useful for filters that do not care about negotiation.
* *
* Always TRUE for filters which don't implement either a transform * Always TRUE for filters which don't implement either a transform
* or transform_ip method. * or transform_ip method.
* *
* MT safe. * MT safe.
@ -1432,7 +1432,7 @@ gst_base_transform_is_passthrough (GstBaseTransform * trans)
* @in_place: Boolean value indicating that we would like to operate * @in_place: Boolean value indicating that we would like to operate
* on in_place buffers. * on in_place buffers.
* *
* Determines whether a non-writable buffer will be copied before passing * Determines whether a non-writable buffer will be copied before passing
* to the transform_ip function. * to the transform_ip function.
* <itemizedlist> * <itemizedlist>
* <listitem>Always TRUE if no transform function is implemented.</listitem> * <listitem>Always TRUE if no transform function is implemented.</listitem>

8
gst/base/gstbasetransform.h
View file

@ -148,21 +148,21 @@ struct _GstBaseTransformClass {
gboolean passthrough_on_same_caps; gboolean passthrough_on_same_caps;
/* Subclasses can override this to do their own allocation of output buffers. /* Subclasses can override this to do their own allocation of output buffers.
* Elements that only do analysis can return a subbuffer or even just * Elements that only do analysis can return a subbuffer or even just
* increment the reference to the input buffer (if in passthrough mode) * increment the reference to the input buffer (if in passthrough mode)
*/ */
GstFlowReturn (*prepare_output_buffer) (GstBaseTransform * trans, GstFlowReturn (*prepare_output_buffer) (GstBaseTransform * trans,
GstBuffer *input, gint size, GstCaps *caps, GstBuffer **buf); GstBuffer *input, gint size, GstCaps *caps, GstBuffer **buf);
/*< private >*/ /*< private >*/
gpointer _gst_reserved[GST_PADDING - 2]; gpointer _gst_reserved[GST_PADDING - 2];
}; };
void gst_base_transform_set_passthrough (GstBaseTransform *trans, void gst_base_transform_set_passthrough (GstBaseTransform *trans,
gboolean passthrough); gboolean passthrough);
gboolean gst_base_transform_is_passthrough (GstBaseTransform *trans); gboolean gst_base_transform_is_passthrough (GstBaseTransform *trans);
void gst_base_transform_set_in_place (GstBaseTransform *trans, void gst_base_transform_set_in_place (GstBaseTransform *trans,
gboolean in_place); gboolean in_place);
gboolean gst_base_transform_is_in_place (GstBaseTransform *trans); gboolean gst_base_transform_is_in_place (GstBaseTransform *trans);

14
gst/base/gstcollectpads.c
View file

@ -1,7 +1,7 @@
/* GStreamer /* GStreamer
* Copyright (C) 2005 Wim Taymans <wim@fluendo.com> * Copyright (C) 2005 Wim Taymans <wim@fluendo.com>
* *
* gstcollectpads.c: * gstcollectpads.c:
* *
* This library is free software; you can redistribute it and/or * This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public * modify it under the terms of the GNU Library General Public
@ -21,7 +21,7 @@
/** /**
* SECTION:gstcollectpads * SECTION:gstcollectpads
* @short_description: manages a set of pads that operate in collect mode * @short_description: manages a set of pads that operate in collect mode
* @see_also: * @see_also:
* *
* Manages a set of pads that operate in collect mode. This means that control * Manages a set of pads that operate in collect mode. This means that control
* is given to the manager of this object when all pads have data. * is given to the manager of this object when all pads have data.
@ -40,7 +40,7 @@
* When data is queued on all pads, a callback function is called. * When data is queued on all pads, a callback function is called.
* </para></listitem> * </para></listitem>
* <listitem><para> * <listitem><para>
* Data can be dequeued from the pad with the _pop() method. * Data can be dequeued from the pad with the _pop() method.
* One can _peek() at the data with the peek function. * One can _peek() at the data with the peek function.
* </para></listitem> * </para></listitem>
* <listitem><para> * <listitem><para>
@ -127,7 +127,7 @@ gst_collectpads_finalize (GObject * object)
* gst_collectpads_new: * gst_collectpads_new:
* *
* Create a new instance of #GstCollectsPads. * Create a new instance of #GstCollectsPads.
* *
* Returns: a new #GstCollectPads, or NULL in case of an error. * Returns: a new #GstCollectPads, or NULL in case of an error.
* *
* MT safe. * MT safe.
@ -416,7 +416,7 @@ gst_collectpads_pop (GstCollectPads * pads, GstCollectData * data)
* This function should be called with @pads LOCK held, such as * This function should be called with @pads LOCK held, such as
* in the callback. * in the callback.
* *
* Returns: The maximum number of bytes queued on all pad. This function * Returns: The maximum number of bytes queued on all pad. This function
* returns 0 if a pad has no queued buffer. * returns 0 if a pad has no queued buffer.
* *
* MT safe. * MT safe.
@ -453,7 +453,7 @@ not_filled:
* gst_collectpads_read: * gst_collectpads_read:
* @pads: the collectspads to query * @pads: the collectspads to query
* @data: the data to use * @data: the data to use
* @bytes: a pointer to a byte array * @bytes: a pointer to a byte array
* @size: the number of bytes to read * @size: the number of bytes to read
* *
* Get a pointer in @bytes where @size bytes can be read from the * Get a pointer in @bytes where @size bytes can be read from the
@ -487,7 +487,7 @@ gst_collectpads_read (GstCollectPads * pads, GstCollectData * data,
* @data: the data to use * @data: the data to use
* @size: the number of bytes to flush * @size: the number of bytes to flush
* *
* Flush @size bytes from the pad @data. * Flush @size bytes from the pad @data.
* *
* This function should be called with @pads LOCK held, such as * This function should be called with @pads LOCK held, such as
* in the callback. * in the callback.

6
gst/base/gstcollectpads.h
View file

@ -1,7 +1,7 @@
/* GStreamer /* GStreamer
* Copyright (C) 2005 Wim Taymans <wim@fluendo.com> * Copyright (C) 2005 Wim Taymans <wim@fluendo.com>
* *
* gstcollectpads.h: * gstcollectpads.h:
* *
* This library is free software; you can redistribute it and/or * This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public * modify it under the terms of the GNU Library General Public
@ -111,9 +111,9 @@ GstBuffer* gst_collectpads_pop (GstCollectPads *pads, GstCollectData *data);
/* get collected bytes */ /* get collected bytes */
guint gst_collectpads_available (GstCollectPads *pads); guint gst_collectpads_available (GstCollectPads *pads);
guint gst_collectpads_read (GstCollectPads *pads, GstCollectData *data, guint gst_collectpads_read (GstCollectPads *pads, GstCollectData *data,
guint8 **bytes, guint size); guint8 **bytes, guint size);
guint gst_collectpads_flush (GstCollectPads *pads, GstCollectData *data, guint gst_collectpads_flush (GstCollectPads *pads, GstCollectData *data,
guint size); guint size);
G_END_DECLS G_END_DECLS

2
gst/base/gstpushsrc.h
View file

@ -3,7 +3,7 @@
* 2000 Wim Taymans <wtay@chello.be> * 2000 Wim Taymans <wtay@chello.be>
* 2005 Wim Taymans <wim@fluendo.com> * 2005 Wim Taymans <wim@fluendo.com>
* *
* gstpushsrc.h: * gstpushsrc.h:
* *
* This library is free software; you can redistribute it and/or * This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public * modify it under the terms of the GNU Library General Public

2
gst/base/gsttypefindhelper.c
View file

@ -2,7 +2,7 @@
* Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu> * Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
* 2000,2005 Wim Taymans <wim@fluendo.com> * 2000,2005 Wim Taymans <wim@fluendo.com>
* *
* gsttypefindhelper.c: * gsttypefindhelper.c:
* *
* This library is free software; you can redistribute it and/or * This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public * modify it under the terms of the GNU Library General Public

2
gst/base/gsttypefindhelper.h
View file

@ -2,7 +2,7 @@
* Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu> * Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
* 2000,2005 Wim Taymans <wim@fluendo.com> * 2000,2005 Wim Taymans <wim@fluendo.com>
* *
* gsttypefindhelper.h: * gsttypefindhelper.h:
* *
* This library is free software; you can redistribute it and/or * This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public * modify it under the terms of the GNU Library General Public

4
gst/elements/gstbufferstore.c
View file

@ -284,7 +284,7 @@ gst_buffer_store_clear (GstBufferStore * store)
* @store: a bufferstore * @store: a bufferstore
* @buffer: the buffer to add * @buffer: the buffer to add
* *
* Adds a buffer to the buffer store. * Adds a buffer to the buffer store.
* *
* Returns: TRUE, if the buffer was added, FALSE if an error occured. * Returns: TRUE, if the buffer was added, FALSE if an error occured.
*/ */
@ -317,7 +317,7 @@ gst_buffer_store_add_buffer (GstBufferStore * store, GstBuffer * buffer)
* data is not available inside the store, NULL is returned. You have to unref * data is not available inside the store, NULL is returned. You have to unref
* the buffer after use. * the buffer after use.
* *
* Returns: a buffer with the requested data or NULL if the data was not * Returns: a buffer with the requested data or NULL if the data was not
* available. * available.
*/ */
GstBuffer * GstBuffer *

4
gst/elements/gstcapsfilter.c
View file

@ -226,9 +226,9 @@ gst_capsfilter_transform_ip (GstBaseTransform * base, GstBuffer * buf)
/* Output buffer preparation... if the buffer has no caps, and /* Output buffer preparation... if the buffer has no caps, and
* our allowed output caps is fixed, then give the caps to the * our allowed output caps is fixed, then give the caps to the
* buffer. * buffer.
* This ensures that outgoing buffers have caps if we can, so * This ensures that outgoing buffers have caps if we can, so
* that pipelines like: * that pipelines like:
* gst-launch filesrc location=rawsamples.raw ! * gst-launch filesrc location=rawsamples.raw !
* audio/x-raw-int,width=16,depth=16,rate=48000,channels=2, * audio/x-raw-int,width=16,depth=16,rate=48000,channels=2,
* endianness=4321,signed='(boolean)'true ! alsasink * endianness=4321,signed='(boolean)'true ! alsasink
* will work. * will work.

2
gst/elements/gstfakesink.c
View file

@ -2,7 +2,7 @@
* Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu> * Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
* 2005 Wim Taymans <wim@fluendo.com> * 2005 Wim Taymans <wim@fluendo.com>
* *
* gstfakesink.c: * gstfakesink.c:
* *
* This library is free software; you can redistribute it and/or * This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public * modify it under the terms of the GNU Library General Public

2
gst/elements/gstfdsink.c
View file

@ -2,7 +2,7 @@
* Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu> * Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
* 2000 Wim Taymans <wtay@chello.be> * 2000 Wim Taymans <wtay@chello.be>
* *
* gstfdsink.c: * gstfdsink.c:
* *
* This library is free software; you can redistribute it and/or * This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public * modify it under the terms of the GNU Library General Public

2
gst/elements/gstfdsink.h
View file

@ -2,7 +2,7 @@
* Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu> * Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
* 2000 Wim Taymans <wtay@chello.be> * 2000 Wim Taymans <wtay@chello.be>
* *
* gstfdsink.h: * gstfdsink.h:
* *
* This library is free software; you can redistribute it and/or * This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public * modify it under the terms of the GNU Library General Public

2
gst/elements/gstfdsrc.c
View file

@ -3,7 +3,7 @@
* 2000 Wim Taymans <wtay@chello.be> * 2000 Wim Taymans <wtay@chello.be>
* 2005 Philippe Khalaf <burger@speedy.org> * 2005 Philippe Khalaf <burger@speedy.org>
* *
* gstfdsrc.c: * gstfdsrc.c:
* *
* This library is free software; you can redistribute it and/or * This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public * modify it under the terms of the GNU Library General Public

2
gst/elements/gstfdsrc.h
View file

@ -3,7 +3,7 @@
* 2000 Wim Taymans <wtay@chello.be> * 2000 Wim Taymans <wtay@chello.be>
* 2005 Philippe Khalaf <burger@speedy.org> * 2005 Philippe Khalaf <burger@speedy.org>
* *
* gstfdsrc.h: * gstfdsrc.h:
* *
* This library is free software; you can redistribute it and/or * This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public * modify it under the terms of the GNU Library General Public

2
gst/elements/gstfilesrc.c
View file

@ -884,7 +884,7 @@ gst_file_src_start (GstBaseSrc * basesrc)
} else } else
#endif #endif
{ {
/* If not in mmap mode, we need to check if the underlying file is /* If not in mmap mode, we need to check if the underlying file is
* seekable. */ * seekable. */
off_t res = lseek (src->fd, 0, SEEK_CUR); off_t res = lseek (src->fd, 0, SEEK_CUR);

2
gst/elements/gstidentity.c
View file

@ -3,7 +3,7 @@
* 2000 Wim Taymans <wtay@chello.be> * 2000 Wim Taymans <wtay@chello.be>
* 2005 Wim Taymans <wim@fluendo.com> * 2005 Wim Taymans <wim@fluendo.com>
* *
* gstidentity.c: * gstidentity.c:
* *
* This library is free software; you can redistribute it and/or * This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public * modify it under the terms of the GNU Library General Public

2
gst/elements/gstidentity.h
View file

@ -2,7 +2,7 @@
* Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu> * Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
* 2000 Wim Taymans <wtay@chello.be> * 2000 Wim Taymans <wtay@chello.be>
* *
* gstidentity.h: * gstidentity.h:
* *
* This library is free software; you can redistribute it and/or * This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public * modify it under the terms of the GNU Library General Public

2
gst/elements/gsttee.c
View file

@ -1,7 +1,7 @@
/* GStreamer /* GStreamer
* Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu> * Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
* 2000,2001,2002,2003,2004,2005 Wim Taymans <wim@fluendo.com> * 2000,2001,2002,2003,2004,2005 Wim Taymans <wim@fluendo.com>
* *
* *
* gsttee.c: Tee element, one in N out * gsttee.c: Tee element, one in N out
* *

2
gst/elements/gsttee.h
View file

@ -54,7 +54,7 @@ struct _GstTee {
gint pad_counter; gint pad_counter;
guint64 offset; guint64 offset;
GstActivateMode sink_mode; GstActivateMode sink_mode;
gchar *last_message; gchar *last_message;
}; };

8
gst/elements/gsttypefindelement.c
View file

@ -28,7 +28,7 @@
* 4) if a function returns a value >= ARG_MAXIMUM goto 8 * 4) if a function returns a value >= ARG_MAXIMUM goto 8
* 5) all functions with a result > ARG_MINIMUM or functions that did not get * 5) all functions with a result > ARG_MINIMUM or functions that did not get
* all requested data (where peek returned NULL) stay in list * all requested data (where peek returned NULL) stay in list
* 6) seek to requested offset of best function that still has open data * 6) seek to requested offset of best function that still has open data
* requests * requests
* 7) goto 2 * 7) goto 2
* 8) take best available result and use its caps * 8) take best available result and use its caps
@ -38,13 +38,13 @@
* 1) chain based, it will collect buffers and run the typefind function on * 1) chain based, it will collect buffers and run the typefind function on
* the buffer until something is found. * the buffer until something is found.
* 2) getrange based, it will proxy the getrange function to the sinkpad. It * 2) getrange based, it will proxy the getrange function to the sinkpad. It
* is assumed that the peer element is happy with whatever format we * is assumed that the peer element is happy with whatever format we
* eventually read. * eventually read.
* *
* When the element has no connected srcpad, and the sinkpad can operate in * When the element has no connected srcpad, and the sinkpad can operate in
* getrange based mode, the element starts its own task to figure out the * getrange based mode, the element starts its own task to figure out the
* type of the stream. * type of the stream.
* *
*/ */
#ifdef HAVE_CONFIG_H #ifdef HAVE_CONFIG_H

2
gst/elements/gsttypefindelement.h
View file

@ -56,7 +56,7 @@ struct _GstTypeFindElement {
GstBuffer * store; GstBuffer * store;
guint64 stream_length; guint64 stream_length;
gboolean stream_length_available; gboolean stream_length_available;
GList * possibilities; GList * possibilities;
}; };

20
gst/glib-compat.c
View file

@ -144,18 +144,18 @@ g_mkdir_with_parents (const gchar * pathname, int mode)
#if !GLIB_CHECK_VERSION (2, 6, 0) #if !GLIB_CHECK_VERSION (2, 6, 0)
/** /**
* g_mkdir: * g_mkdir:
* @filename: a pathname in the GLib file name encoding (UTF-8 on Windows) * @filename: a pathname in the GLib file name encoding (UTF-8 on Windows)
* @mode: permissions to use for the newly created directory * @mode: permissions to use for the newly created directory
* *
* A wrapper for the POSIX mkdir() function. The mkdir() function * A wrapper for the POSIX mkdir() function. The mkdir() function
* attempts to create a directory with the given name and permissions. * attempts to create a directory with the given name and permissions.
* *
* See the C library manual for more details about mkdir(). * See the C library manual for more details about mkdir().
* *
* Returns: 0 if the directory was successfully created, -1 if an error * Returns: 0 if the directory was successfully created, -1 if an error
* occurred * occurred
* *
* Since: 2.6 * Since: 2.6
*/ */
int int
@ -205,19 +205,19 @@ g_mkdir (const gchar * filename, int mode)
#if !GLIB_CHECK_VERSION (2, 6, 0) #if !GLIB_CHECK_VERSION (2, 6, 0)
/** /**
* g_stat: * g_stat:
* @filename: a pathname in the GLib file name encoding (UTF-8 on Windows) * @filename: a pathname in the GLib file name encoding (UTF-8 on Windows)
* @buf: a pointer to a <structname>stat</structname> struct, which * @buf: a pointer to a <structname>stat</structname> struct, which
* will be filled with the file information * will be filled with the file information
* *
* A wrapper for the POSIX stat() function. The stat() function * A wrapper for the POSIX stat() function. The stat() function
* returns information about a file. * returns information about a file.
* *
* See the C library manual for more details about stat(). * See the C library manual for more details about stat().
* *
* Returns: 0 if the information was successfully retrieved, -1 if an error * Returns: 0 if the information was successfully retrieved, -1 if an error
* occurred * occurred
* *
* Since: 2.6 * Since: 2.6
*/ */
int int

16
gst/gst.c
View file

@ -32,11 +32,11 @@
* a powerful negotiation framework. Plugins are heavily used to provide for * a powerful negotiation framework. Plugins are heavily used to provide for
* all elements, allowing one to construct plugins outside of the GST * all elements, allowing one to construct plugins outside of the GST
* library, even released binary-only if license require (please don't). * library, even released binary-only if license require (please don't).
* *
* GStreamer borrows heavily from both the <ulink * GStreamer borrows heavily from both the <ulink
* url="http://www.cse.ogi.edu/sysl/">OGI media pipeline</ulink> and * url="http://www.cse.ogi.edu/sysl/">OGI media pipeline</ulink> and
* Microsoft's DirectShow, hopefully taking the best of both and leaving the * Microsoft's DirectShow, hopefully taking the best of both and leaving the
* cruft behind. Its interface is still very fluid and thus can be changed * cruft behind. Its interface is still very fluid and thus can be changed
* to increase the sanity/noise ratio. * to increase the sanity/noise ratio.
* *
* The <application>GStreamer</application> library should be initialized with * The <application>GStreamer</application> library should be initialized with
@ -47,7 +47,7 @@
* <example> * <example>
* <title>Initializing the gstreamer library</title> * <title>Initializing the gstreamer library</title>
* <programlisting language="c"> * <programlisting language="c">
* int * int
* main (int argc, char *argv[]) * main (int argc, char *argv[])
* { * {
* // initialize the GStreamer library * // initialize the GStreamer library
@ -56,7 +56,7 @@
* } * }
* </programlisting> * </programlisting>
* </example> * </example>
* *
* It's allowed to pass two NULL pointers to gst_init() in case you don't want to * It's allowed to pass two NULL pointers to gst_init() in case you don't want to
* pass the command line args to GStreamer. * pass the command line args to GStreamer.
* *
@ -67,8 +67,8 @@
* <programlisting> * <programlisting>
* static gboolean stats = FALSE; * static gboolean stats = FALSE;
* ... * ...
* *
* int * int
* main (int argc, char *argv[]) * main (int argc, char *argv[])
* { * {
* struct poptOption options[] = { * struct poptOption options[] = {
@ -76,10 +76,10 @@
* "Show pad stats", NULL}, * "Show pad stats", NULL},
* POPT_TABLEEND * POPT_TABLEEND
* }; * };
* *
* // initialize the GStreamer library * // initialize the GStreamer library
* gst_init_with_popt_table (&amp;argc, &amp;argv, options); * gst_init_with_popt_table (&amp;argc, &amp;argv, options);
* *
* ... * ...
* } * }
* </programlisting> * </programlisting>

22
gst/gstbin.c
View file

@ -34,7 +34,7 @@
* A new GstBin is created with gst_bin_new(). Use a #GstPipeline instead if you * A new GstBin is created with gst_bin_new(). Use a #GstPipeline instead if you
* want to create a toplevel bin because a normal bin doesn't have a bus or * want to create a toplevel bin because a normal bin doesn't have a bus or
* handle clock distribution of its own. * handle clock distribution of its own.
* *
* After the bin has been created you will typically add elements to it with * After the bin has been created you will typically add elements to it with
* gst_bin_add(). You can remove elements with gst_bin_remove(). * gst_bin_add(). You can remove elements with gst_bin_remove().
* *
@ -42,16 +42,16 @@
* elements name. gst_bin_get_by_name_recurse_up() is mainly used for internal * elements name. gst_bin_get_by_name_recurse_up() is mainly used for internal
* purposes and will query the parent bins when the element is not found in the * purposes and will query the parent bins when the element is not found in the
* current bin. * current bin.
* *
* An iterator of elements in a bin can be retrieved with * An iterator of elements in a bin can be retrieved with
* gst_bin_iterate_elements(). Various other iterators exist to retrieve the * gst_bin_iterate_elements(). Various other iterators exist to retrieve the
* elements in a bin. * elements in a bin.
* *
* The "element_added" signal is fired whenever a new element is added to the * The "element_added" signal is fired whenever a new element is added to the
* bin. Likewise the "element_removed" signal is fired whenever an element is * bin. Likewise the "element_removed" signal is fired whenever an element is
* removed from the bin. * removed from the bin.
* *
* gst_object_unref() is used to destroy the bin. * gst_object_unref() is used to destroy the bin.
*/ */
#include "gst_private.h" #include "gst_private.h"
@ -1076,12 +1076,12 @@ unknown_state:
} }
/*********************************************** /***********************************************
* Topologically sorted iterator * Topologically sorted iterator
* see http://en.wikipedia.org/wiki/Topological_sorting * see http://en.wikipedia.org/wiki/Topological_sorting
* *
* For each element in the graph, an entry is kept in a HashTable * For each element in the graph, an entry is kept in a HashTable
* with its number of srcpad connections (degree). * with its number of srcpad connections (degree).
* We then change state of all elements without dependencies * We then change state of all elements without dependencies
* (degree 0) and decrement the degree of all elements connected * (degree 0) and decrement the degree of all elements connected
* on the sinkpads. When an element reaches degree 0, its state is * on the sinkpads. When an element reaches degree 0, its state is
* changed next. * changed next.
@ -1297,13 +1297,13 @@ gst_bin_sort_iterator_free (GstBinSortIterator * bit)
* sorted order. This means that the elements are returned from * sorted order. This means that the elements are returned from
* the most downstream elements (sinks) to the sources. * the most downstream elements (sinks) to the sources.
* *
* This function is used internally to perform the state changes * This function is used internally to perform the state changes
* of the bin elements. * of the bin elements.
* *
* Each element will have its refcount increased, so unref * Each element will have its refcount increased, so unref
* after use. * after use.
* *
* MT safe. * MT safe.
* *
* Returns: a #GstIterator of #GstElements. gst_iterator_free after use. * Returns: a #GstIterator of #GstElements. gst_iterator_free after use.
*/ */
@ -1625,7 +1625,7 @@ bin_bus_handler (GstBus * bus, GstMessage * message, GstBin * bin)
gst_object_unref (src); gst_object_unref (src);
/* we can lock, either the state change is sync and we can /* we can lock, either the state change is sync and we can
* recursively lock or the state change is async and we * recursively lock or the state change is async and we
* lock when the bin has done its state change. We can check which * lock when the bin has done its state change. We can check which
* case it is by looking at the CHANGING_STATE flag. */ * case it is by looking at the CHANGING_STATE flag. */
GST_STATE_LOCK (bin); GST_STATE_LOCK (bin);

34
gst/gstbuffer.c
View file

@ -28,10 +28,10 @@
* provides all the state necessary to define a region of memory as part of a * provides all the state necessary to define a region of memory as part of a
* stream. Sub-buffers are also supported, allowing a smaller region of a * stream. Sub-buffers are also supported, allowing a smaller region of a
* buffer to become its own buffer, with mechanisms in place to ensure that * buffer to become its own buffer, with mechanisms in place to ensure that
* neither memory space goes away. * neither memory space goes away.
* *
* Buffers are usually created with gst_buffer_new(). After a buffer has been * Buffers are usually created with gst_buffer_new(). After a buffer has been
* created one will typically allocate memory for it and set the size of the * created one will typically allocate memory for it and set the size of the
* buffer data. The following example creates a buffer that can hold a given * buffer data. The following example creates a buffer that can hold a given
* video frame with a given width, height and bits per plane. * video frame with a given width, height and bits per plane.
* <example> * <example>
@ -39,11 +39,11 @@
* <programlisting> * <programlisting>
* GstBuffer *buffer; * GstBuffer *buffer;
* gint size, width, height, bpp; * gint size, width, height, bpp;
* *
* ... * ...
* *
* size = width * height * bpp; * size = width * height * bpp;
* *
* buffer = gst_buffer_new (); * buffer = gst_buffer_new ();
* GST_BUFFER_SIZE (buffer) = size; * GST_BUFFER_SIZE (buffer) = size;
* GST_BUFFER_MALLOCDATA (buffer) = g_alloc (size); * GST_BUFFER_MALLOCDATA (buffer) = g_alloc (size);
@ -51,10 +51,10 @@
* ... * ...
* </programlisting> * </programlisting>
* </example> * </example>
* *
* Alternatively, use gst_buffer_new_and_alloc() * Alternatively, use gst_buffer_new_and_alloc()
* to create a buffer with preallocated data of a given size. * to create a buffer with preallocated data of a given size.
* *
* If an element knows what pad you will push the buffer out on, it should use * If an element knows what pad you will push the buffer out on, it should use
* gst_pad_alloc_buffer() instead to create a buffer. This allows downstream * gst_pad_alloc_buffer() instead to create a buffer. This allows downstream
* elements to provide special buffers to write in, like hardware buffers. * elements to provide special buffers to write in, like hardware buffers.
@ -63,28 +63,28 @@
* in the buffer. Attach caps to the buffer with gst_buffer_set_caps(); this * in the buffer. Attach caps to the buffer with gst_buffer_set_caps(); this
* is typically done before pushing out a buffer using gst_pad_push() so that * is typically done before pushing out a buffer using gst_pad_push() so that
* the downstream element knows the type of the buffer. * the downstream element knows the type of the buffer.
* *
* gst_buffer_ref() is used to increase the refcount of a buffer. This must be * gst_buffer_ref() is used to increase the refcount of a buffer. This must be
* done when you want to keep a handle to the buffer after pushing it to the * done when you want to keep a handle to the buffer after pushing it to the
* next element. * next element.
* *
* To efficiently create a smaller buffer out of an existing one, you can * To efficiently create a smaller buffer out of an existing one, you can
* use gst_buffer_create_sub(). * use gst_buffer_create_sub().
* *
* If the plug-in wants to modify the buffer in-place, it should first obtain * If the plug-in wants to modify the buffer in-place, it should first obtain
* a buffer that is safe to modify by using gst_buffer_make_writable(). This * a buffer that is safe to modify by using gst_buffer_make_writable(). This
* function is optimized so that a copy will only be made when it is necessary. * function is optimized so that a copy will only be made when it is necessary.
* *
* Several flags of the buffer can be set and unset with the GST_BUFFER_FLAG_SET() * Several flags of the buffer can be set and unset with the GST_BUFFER_FLAG_SET()
* and GST_BUFFER_FLAG_UNSET() macros. Use GST_BUFFER_FLAG_IS_SET() to test it * and GST_BUFFER_FLAG_UNSET() macros. Use GST_BUFFER_FLAG_IS_SET() to test it
* a certain #GstBufferFlag is set. * a certain #GstBufferFlag is set.
* *
* Buffers can be efficiently merged into a larger buffer with gst_buffer_merge() * Buffers can be efficiently merged into a larger buffer with gst_buffer_merge()
* and gst_buffer_span() if the gst_buffer_is_span_fast() function returns TRUE. * and gst_buffer_span() if the gst_buffer_is_span_fast() function returns TRUE.
* *
* An element should either unref the buffer or push it out on a src pad * An element should either unref the buffer or push it out on a src pad
* using gst_pad_push() (see #GstPad). * using gst_pad_push() (see #GstPad).
* *
* Buffers usually are freed by unreffing them with gst_buffer_unref(). When * Buffers usually are freed by unreffing them with gst_buffer_unref(). When
* the refcount drops to 0, the buffer memory will be freed again. * the refcount drops to 0, the buffer memory will be freed again.
* *

26
gst/gstbus.c
View file

@ -25,22 +25,22 @@
* *
* The #GstBus is an object responsible for delivering #GstMessages in * The #GstBus is an object responsible for delivering #GstMessages in
* a first-in first-out way from the streaming threads to the application. * a first-in first-out way from the streaming threads to the application.
* *
* Since the application typically only wants to deal with delivery of these * Since the application typically only wants to deal with delivery of these
* messages from one thread, the GstBus will marshall the messages between * messages from one thread, the GstBus will marshall the messages between
* different threads. This is important since the actual streaming of media * different threads. This is important since the actual streaming of media
* is done in another thread than the application. * is done in another thread than the application.
* *
* The GstBus provides support for #GSource based notifications. This makes it * The GstBus provides support for #GSource based notifications. This makes it
* possible to handle the delivery in the glib mainloop. * possible to handle the delivery in the glib mainloop.
* *
* The #GSource callback function gst_bus_async_signal_func() can be used to * The #GSource callback function gst_bus_async_signal_func() can be used to
* convert all bus messages into signal emissions. * convert all bus messages into signal emissions.
* *
* A message is posted on the bus with the gst_bus_post() method. With the * A message is posted on the bus with the gst_bus_post() method. With the
* gst_bus_peek() and _pop() methods one can look at or retrieve a previously * gst_bus_peek() and _pop() methods one can look at or retrieve a previously
* posted message. * posted message.
* *
* The bus can be polled with the gst_bus_poll() method. This methods blocks * The bus can be polled with the gst_bus_poll() method. This methods blocks
* up to the specified timeout value until one of the specified messages types * up to the specified timeout value until one of the specified messages types
* is posted on the bus. The application can then _pop() the messages from the * is posted on the bus. The application can then _pop() the messages from the
@ -48,8 +48,8 @@
* Alternatively the application can register an asynchronous bus function using * Alternatively the application can register an asynchronous bus function using
* gst_bus_add_watch_full() or gst_bus_add_watch(). This function will receive * gst_bus_add_watch_full() or gst_bus_add_watch(). This function will receive
* messages a short while after they have been posted. * messages a short while after they have been posted.
* *
* It is also possible to get messages from the bus without any thread * It is also possible to get messages from the bus without any thread
* marshalling with the gst_bus_set_sync_handler() method. This makes it * marshalling with the gst_bus_set_sync_handler() method. This makes it
* possible to react to a message in the same thread that posted the * possible to react to a message in the same thread that posted the
* message on the bus. This should only be used if the application is able * message on the bus. This should only be used if the application is able
@ -477,7 +477,7 @@ gst_bus_pop (GstBus * bus)
* gst_bus_peek: * gst_bus_peek:
* @bus: a #GstBus * @bus: a #GstBus
* *
* Peek the message on the top of the bus' queue. The message will remain * Peek the message on the top of the bus' queue. The message will remain
* on the bus' message queue. A reference is returned, and needs to be unreffed * on the bus' message queue. A reference is returned, and needs to be unreffed
* by the caller. * by the caller.
* *
@ -618,7 +618,7 @@ static GSourceFuncs gst_bus_source_funcs = {
* @bus: a #GstBus to create the watch for * @bus: a #GstBus to create the watch for
* *
* Create watch for this bus. The GSource will be dispatched whenever * Create watch for this bus. The GSource will be dispatched whenever
* a message is on the bus. After the GSource is dispatched, the * a message is on the bus. After the GSource is dispatched, the
* message is popped off the bus and unreffed. * message is popped off the bus and unreffed.
* *
* Returns: A #GSource that can be added to a mainloop. * Returns: A #GSource that can be added to a mainloop.
@ -646,10 +646,10 @@ gst_bus_create_watch (GstBus * bus)
* @user_data: user data passed to @func. * @user_data: user data passed to @func.
* @notify: the function to call when the source is removed. * @notify: the function to call when the source is removed.
* *
* Adds a bus watch to the default main context with the given priority. * Adds a bus watch to the default main context with the given priority.
* If the func returns FALSE, the source will be removed. * If the func returns FALSE, the source will be removed.
* *
* When the func is called, the message belongs to the caller; if you want to * When the func is called, the message belongs to the caller; if you want to
* keep a copy of it, call gst_message_ref() before leaving the func. * keep a copy of it, call gst_message_ref() before leaving the func.
* *
* The watch can be removed using #g_source_remove(). * The watch can be removed using #g_source_remove().
@ -778,7 +778,7 @@ poll_destroy_timeout (GstBusPollData * poll_data)
* *
* This function will enter the default mainloop while polling. * This function will enter the default mainloop while polling.
* *
* Returns: The message that was received, or NULL if the poll timed out. * Returns: The message that was received, or NULL if the poll timed out.
* The message is taken from the bus and needs to be unreffed after usage. * The message is taken from the bus and needs to be unreffed after usage.
*/ */
GstMessage * GstMessage *
@ -827,7 +827,7 @@ gst_bus_poll (GstBus * bus, GstMessageType events, GstClockTimeDiff timeout)
* @message: the message received * @message: the message received
* @data: user data * @data: user data
* *
* A helper GstBusFunc that can be used to convert all asynchronous messages * A helper GstBusFunc that can be used to convert all asynchronous messages
* into signals. * into signals.
* *
* Returns: TRUE * Returns: TRUE

12
gst/gstbus.h
View file

@ -87,14 +87,14 @@ typedef GstBusSyncReply (*GstBusSyncHandler) (GstBus * bus, GstMessage * messag
* @message: the #GstMessage * @message: the #GstMessage
* @data: user data that has been given, when registering the handler * @data: user data that has been given, when registering the handler
* *
* Specifies the type of function passed to #gst_bus_add_watch() or * Specifies the type of function passed to #gst_bus_add_watch() or
* #gst_bus_add_watch_full(), which is called from the mainloop when a message * #gst_bus_add_watch_full(), which is called from the mainloop when a message
* is available on the bus. * is available on the bus.
* *
* The message passed to the function will be unreffed after execution of this * The message passed to the function will be unreffed after execution of this
* function so it should not be freed in the function. * function so it should not be freed in the function.
* *
* Returns: %FALSE if the event source should be removed. * Returns: %FALSE if the event source should be removed.
*/ */
typedef gboolean (*GstBusFunc) (GstBus * bus, GstMessage * message, gpointer data); typedef gboolean (*GstBusFunc) (GstBus * bus, GstMessage * message, gpointer data);
@ -146,11 +146,11 @@ void gst_bus_set_sync_handler (GstBus * bus, GstBusSyncHandler func,
GSource * gst_bus_create_watch (GstBus * bus); GSource * gst_bus_create_watch (GstBus * bus);
guint gst_bus_add_watch_full (GstBus * bus, guint gst_bus_add_watch_full (GstBus * bus,
gint priority, gint priority,
GstBusFunc func, GstBusFunc func,
gpointer user_data, gpointer user_data,
GDestroyNotify notify); GDestroyNotify notify);
guint gst_bus_add_watch (GstBus * bus, guint gst_bus_add_watch (GstBus * bus,
GstBusFunc func, GstBusFunc func,
gpointer user_data); gpointer user_data);
/* polling the bus */ /* polling the bus */

46
gst/gstcaps.c
View file

@ -328,7 +328,7 @@ gst_caps_ref (GstCaps * caps)
* gst_caps_unref: * gst_caps_unref:
* @caps: the #GstCaps to unref * @caps: the #GstCaps to unref
* *
* Unref a #GstCaps and and free all its structures and the * Unref a #GstCaps and and free all its structures and the
* structures' values when the refcount reaches 0. * structures' values when the refcount reaches 0.
*/ */
void void
@ -356,7 +356,7 @@ gst_caps_unref (GstCaps * caps)
* Converts a #GstStaticCaps to a #GstCaps. * Converts a #GstStaticCaps to a #GstCaps.
* *
* Returns: A pointer to the #GstCaps. Unref after usage. Since the * Returns: A pointer to the #GstCaps. Unref after usage. Since the
* core holds an additional ref to the returned caps, * core holds an additional ref to the returned caps,
* use gst_caps_make_writable() on the returned caps to modify it. * use gst_caps_make_writable() on the returned caps to modify it.
*/ */
GstCaps * GstCaps *
@ -471,7 +471,7 @@ gst_caps_append_structure (GstCaps * caps, GstStructure * structure)
* @caps: the #GstCaps to remove from * @caps: the #GstCaps to remove from
* @idx: Index of the structure to remove * @idx: Index of the structure to remove
* *
* removes the stucture with the given index from the list of structures * removes the stucture with the given index from the list of structures
* contained in @caps. * contained in @caps.
*/ */
void void
@ -525,7 +525,7 @@ gst_caps_get_size (const GstCaps * caps)
* @caps: a #GstCaps * @caps: a #GstCaps
* @index: the index of the structure * @index: the index of the structure
* *
* Finds the structure in @caps that has the index @index, and * Finds the structure in @caps that has the index @index, and
* returns it. * returns it.
* *
* WARNING: This function takes a const GstCaps *, but returns a * WARNING: This function takes a const GstCaps *, but returns a
@ -545,15 +545,15 @@ gst_caps_get_structure (const GstCaps * caps, guint index)
return g_ptr_array_index (caps->structs, index); return g_ptr_array_index (caps->structs, index);
} }
/** /**
* gst_caps_copy_nth: * gst_caps_copy_nth:
* @caps: the @GstCaps to copy * @caps: the @GstCaps to copy
* @nth: the nth structure to copy * @nth: the nth structure to copy
* *
* Creates a new @GstCaps and appends a copy of the nth structure * Creates a new @GstCaps and appends a copy of the nth structure
* contained in @caps. * contained in @caps.
* *
* Returns: the new @GstCaps * Returns: the new @GstCaps
*/ */
GstCaps * GstCaps *
gst_caps_copy_nth (const GstCaps * caps, guint nth) gst_caps_copy_nth (const GstCaps * caps, guint nth)
@ -574,10 +574,10 @@ gst_caps_copy_nth (const GstCaps * caps, guint nth)
return newcaps; return newcaps;
} }
/** /**
* gst_caps_truncate: * gst_caps_truncate:
* @caps: the @GstCaps to truncate * @caps: the @GstCaps to truncate
* *
* Destructively discard all but the first structure from @caps. Useful when * Destructively discard all but the first structure from @caps. Useful when
* fixating. @caps must be writable. * fixating. @caps must be writable.
*/ */
@ -974,8 +974,8 @@ gst_caps_intersect (const GstCaps * caps1, const GstCaps * caps2)
dest = gst_caps_new_empty (); dest = gst_caps_new_empty ();
/* run zigzag on top line then right line, this preserves the caps order /* run zigzag on top line then right line, this preserves the caps order
* much better than a simple loop. * much better than a simple loop.
* *
* This algorithm zigzags over the caps structures as demonstrated in * This algorithm zigzags over the caps structures as demonstrated in
* the folowing matrix: * the folowing matrix:
* *
@ -984,10 +984,10 @@ gst_caps_intersect (const GstCaps * caps1, const GstCaps * caps2)
* | 1 2 4 7 * | 1 2 4 7
* caps2 | 3 5 8 10 * caps2 | 3 5 8 10
* | 6 9 11 12 * | 6 9 11 12
* *
* First we iterate over the caps1 structures (top line) intersecting * First we iterate over the caps1 structures (top line) intersecting
* the structures diagonally down, then we iterate over the caps2 * the structures diagonally down, then we iterate over the caps2
* structures. * structures.
*/ */
for (i = 0; i < caps1->structs->len + caps2->structs->len - 1; i++) { for (i = 0; i < caps1->structs->len + caps2->structs->len - 1; i++) {
/* caps1 index goes from 0 to caps1->structs->len-1 */ /* caps1 index goes from 0 to caps1->structs->len-1 */
@ -1246,7 +1246,7 @@ gst_caps_compare_structures (gconstpointer one, gconstpointer two)
const GstStructure *struct1 = *((const GstStructure **) one); const GstStructure *struct1 = *((const GstStructure **) one);
const GstStructure *struct2 = *((const GstStructure **) two); const GstStructure *struct2 = *((const GstStructure **) two);
/* FIXME: this orders aphabetically, but ordering the quarks might be faster /* FIXME: this orders aphabetically, but ordering the quarks might be faster
So what's the best way? */ So what's the best way? */
ret = strcmp (gst_structure_get_name (struct1), ret = strcmp (gst_structure_get_name (struct1),
gst_structure_get_name (struct2)); gst_structure_get_name (struct2));
@ -1391,9 +1391,9 @@ gst_caps_switch_structures (GstCaps * caps, GstStructure * old,
* gst_caps_do_simplify: * gst_caps_do_simplify:
* @caps: a #GstCaps to simplify * @caps: a #GstCaps to simplify
* *
* Modifies the given @caps inplace into a representation that represents the * Modifies the given @caps inplace into a representation that represents the
* same set of formats, but in a simpler form. Component structures that are * same set of formats, but in a simpler form. Component structures that are
* identical are merged. Component structures that have values that can be * identical are merged. Component structures that have values that can be
* merged are also merged. * merged are also merged.
* *
* Returns: TRUE, if the caps could be simplified * Returns: TRUE, if the caps could be simplified

10
gst/gstchildproxy.c
View file

@ -59,7 +59,7 @@ static guint signals[LAST_SIGNAL] = { 0 };
* *
* Looks up a child element by the given name. * Looks up a child element by the given name.
* *
* Implementors can use #GstObject together with gst_object_get_name() * Implementors can use #GstObject together with gst_object_get_name()
* *
* Returns: the child object or %NULL if not found. Unref after usage. * Returns: the child object or %NULL if not found. Unref after usage.
* *
@ -151,7 +151,7 @@ gst_child_proxy_get_children_count (GstChildProxy * parent)
* *
* Looks up which object and #GParamSpec would be effected by the given @name. * Looks up which object and #GParamSpec would be effected by the given @name.
* *
* Returns: TRUE if @target and @pspec could be found. FALSE otherwise. In that * Returns: TRUE if @target and @pspec could be found. FALSE otherwise. In that
* case the values for @pspec and @target are not modified. Unref @target after * case the values for @pspec and @target are not modified. Unref @target after
* usage. * usage.
* *
@ -213,7 +213,7 @@ gst_child_proxy_lookup (GstObject * object, const gchar * name,
* gst_child_proxy_get_property: * gst_child_proxy_get_property:
* @object: object to query * @object: object to query
* @name: name of the property * @name: name of the property
* @value: an uninitialized #GValue that should take the result. * @value: an uninitialized #GValue that should take the result.
* *
* Gets a single property using the GstChildProxy mechanism. * Gets a single property using the GstChildProxy mechanism.
* You are responsible for for freeing it by calling g_value_unset() * You are responsible for for freeing it by calling g_value_unset()
@ -401,7 +401,7 @@ gst_child_proxy_set (GstObject * object, const gchar * first_property_name, ...)
* gst_child_proxy_child_added: * gst_child_proxy_child_added:
* @object: the parent object * @object: the parent object
* @child: the newly added child * @child: the newly added child
* *
* Emits the "child-added" signal. * Emits the "child-added" signal.
*/ */
void void
@ -414,7 +414,7 @@ gst_child_proxy_child_added (GstObject * object, GstObject * child)
* gst_child_proxy_child_removed: * gst_child_proxy_child_removed:
* @object: the parent object * @object: the parent object
* @child: the newly added child * @child: the newly added child
* *
* Emits the "child-removed" signal. * Emits the "child-removed" signal.
*/ */
void void

4
gst/gstclock.c
View file

@ -327,7 +327,7 @@ unscheduled:
/** /**
* gst_clock_id_wait_async: * gst_clock_id_wait_async:
* @id: a #GstClockID to wait on * @id: a #GstClockID to wait on
* @func: The callback function * @func: The callback function
* @user_data: User data passed in the calback * @user_data: User data passed in the calback
* *
* Register a callback on the given clockid with the given * Register a callback on the given clockid with the given
@ -623,7 +623,7 @@ gst_clock_get_time (GstClock * clock)
* *
* Adjusts the current time of the clock with the adjust value. * Adjusts the current time of the clock with the adjust value.
* A positive value moves the clock forwards and a backwards value * A positive value moves the clock forwards and a backwards value
* moves it backwards. Note that _get_time() always returns * moves it backwards. Note that _get_time() always returns
* increasing values so when you move the clock backwards, _get_time() * increasing values so when you move the clock backwards, _get_time()
* will report the previous value until the clock catches up. * will report the previous value until the clock catches up.
* *

66
gst/gstelement.c
View file

@ -27,47 +27,47 @@
* GstElement is the base class needed to construct an element that can be * GstElement is the base class needed to construct an element that can be
* used in a GStreamer pipeline. As such, it is not a functional entity, and * used in a GStreamer pipeline. As such, it is not a functional entity, and
* cannot do anything when placed in a pipeline. * cannot do anything when placed in a pipeline.
* *
* The name of a GstElement can be get with gst_element_get_name() and set with * The name of a GstElement can be get with gst_element_get_name() and set with
* gst_element_set_name(). For speed, GST_ELEMENT_NAME() can be used in the * gst_element_set_name(). For speed, GST_ELEMENT_NAME() can be used in the
* core when using the appropriate locking. Do not use this in plug-ins or * core when using the appropriate locking. Do not use this in plug-ins or
* applications in order to retain ABI compatibility. * applications in order to retain ABI compatibility.
* *
* All elements have pads (of the type #GstPad). These pads link to pads on * All elements have pads (of the type #GstPad). These pads link to pads on
* other elements. Buffers flow between these linked pads. * other elements. Buffers flow between these linked pads.
* A GstElement has a GList of #GstPad structures for all their input (or sink) * A GstElement has a GList of #GstPad structures for all their input (or sink)
* and output (or source) pads. * and output (or source) pads.
* Core and plug-in writers can add and remove pads with gst_element_add_pad() * Core and plug-in writers can add and remove pads with gst_element_add_pad()
* and gst_element_remove_pad(). * and gst_element_remove_pad().
* *
* A pad of an element can be retrieved by name with gst_element_get_pad(). * A pad of an element can be retrieved by name with gst_element_get_pad().
* An iterator of all pads can be retrieved with gst_element_iterate_pads(). * An iterator of all pads can be retrieved with gst_element_iterate_pads().
* *
* Elements can be linked through their pads. * Elements can be linked through their pads.
* If the link is straightforward, use the gst_element_link() * If the link is straightforward, use the gst_element_link()
* convenience function to link two elements, or gst_element_link_many() * convenience function to link two elements, or gst_element_link_many()
* for more elements in a row. * for more elements in a row.
* Use gst_element_link_filtered() to link two elements constrained by * Use gst_element_link_filtered() to link two elements constrained by
* a specified set of #GstCaps. * a specified set of #GstCaps.
* For finer control, use gst_element_link_pads() and * For finer control, use gst_element_link_pads() and
* gst_element_link_pads_filtered() to specify the pads to link on * gst_element_link_pads_filtered() to specify the pads to link on
* each element by name. * each element by name.
* *
* Each element has a state (see #GstState). You can get and set the state * Each element has a state (see #GstState). You can get and set the state
* of an element with gst_element_get_state() and gst_element_set_state(). * of an element with gst_element_get_state() and gst_element_set_state().
* To get a string representation of a #GstState, use * To get a string representation of a #GstState, use
* gst_element_state_get_name(). * gst_element_state_get_name().
* *
* You can get and set a #GstClock on an element using gst_element_get_clock() * You can get and set a #GstClock on an element using gst_element_get_clock()
* and gst_element_set_clock(). * and gst_element_set_clock().
* Some elements can provide a clock for the pipeline if * Some elements can provide a clock for the pipeline if
* gst_element_provides_clock() returns TRUE. With the gst_element_provide_clock() * gst_element_provides_clock() returns TRUE. With the gst_element_provide_clock()
* method one can retrieve the clock provided by such an element. * method one can retrieve the clock provided by such an element.
* Not all elements require a clock to operate correctly. If * Not all elements require a clock to operate correctly. If
* gst_element_requires_clock() returns TRUE, a clock should be set on the element * gst_element_requires_clock() returns TRUE, a clock should be set on the element
* with gst_element_set_clock(). * with gst_element_set_clock().
* *
* Note that clock slection and distribution is normally handled by the toplevel * Note that clock slection and distribution is normally handled by the toplevel
* #GstPipeline so the clock functions are only to be used in very specific situations. * #GstPipeline so the clock functions are only to be used in very specific situations.
*/ */
@ -557,7 +557,7 @@ gst_element_get_index (GstElement * element)
* *
* Pads are not automatically activated so elements should perform the needed * Pads are not automatically activated so elements should perform the needed
* steps to activate the pad in case this pad is added in the PAUSED or PLAYING * steps to activate the pad in case this pad is added in the PAUSED or PLAYING
* state. * state.
* *
* The pad and the element should be unlocked when calling this function. * The pad and the element should be unlocked when calling this function.
* *
@ -971,7 +971,7 @@ gst_element_iterate_pads (GstElement * element)
* gst_element_iterate_src_pads: * gst_element_iterate_src_pads:
* @element: a #GstElement. * @element: a #GstElement.
* *
* Retrieves an iterator of @element's source pads. * Retrieves an iterator of @element's source pads.
* *
* Returns: the #GstIterator of #GstPad. Unref each pad after use. * Returns: the #GstIterator of #GstPad. Unref each pad after use.
* *
@ -989,7 +989,7 @@ gst_element_iterate_src_pads (GstElement * element)
* gst_element_iterate_sink_pads: * gst_element_iterate_sink_pads:
* @element: a #GstElement. * @element: a #GstElement.
* *
* Retrieves an iterator of @element's sink pads. * Retrieves an iterator of @element's sink pads.
* *
* Returns: the #GstIterator of #GstPad. Unref each pad after use. * Returns: the #GstIterator of #GstPad. Unref each pad after use.
* *
@ -1691,21 +1691,21 @@ done:
* @timeout: a #GstClockTime to specify the timeout for an async * @timeout: a #GstClockTime to specify the timeout for an async
* state change or GST_CLOCK_TIME_NONE for infinite timeout. * state change or GST_CLOCK_TIME_NONE for infinite timeout.
* *
* Gets the state of the element. * Gets the state of the element.
* *
* For elements that performed an ASYNC state change, as reported by * For elements that performed an ASYNC state change, as reported by
* #gst_element_set_state(), this function will block up to the * #gst_element_set_state(), this function will block up to the
* specified timeout value for the state change to complete. * specified timeout value for the state change to complete.
* If the element completes the state change or goes into * If the element completes the state change or goes into
* an error, this function returns immediatly with a return value of * an error, this function returns immediatly with a return value of
* GST_STATE_CHANGE_SUCCESS or GST_STATE_CHANGE_FAILURE respectively. * GST_STATE_CHANGE_SUCCESS or GST_STATE_CHANGE_FAILURE respectively.
* *
* For elements that did not return ASYNC, this function returns the * For elements that did not return ASYNC, this function returns the
* current and pending state immediatly. * current and pending state immediatly.
* *
* Returns: GST_STATE_CHANGE_SUCCESS if the element has no more pending state and * Returns: GST_STATE_CHANGE_SUCCESS if the element has no more pending state and
* the last state change succeeded, GST_STATE_CHANGE_ASYNC * the last state change succeeded, GST_STATE_CHANGE_ASYNC
* if the element is still performing a state change or * if the element is still performing a state change or
* GST_STATE_CHANGE_FAILURE if the last state change failed. * GST_STATE_CHANGE_FAILURE if the last state change failed.
* *
* MT safe. * MT safe.
@ -1770,7 +1770,7 @@ gst_element_abort_state (GstElement * element)
* *
* Commit the state change of the element. This function is used * Commit the state change of the element. This function is used
* by elements that do asynchronous state changes. * by elements that do asynchronous state changes.
* The core will normally call this method automatically when an * The core will normally call this method automatically when an
* element returned SUCCESS from the state change function. * element returned SUCCESS from the state change function.
* Elements that return ASYNC from the change_state function should * Elements that return ASYNC from the change_state function should
* eventually call this method from the streaming thread to signal * eventually call this method from the streaming thread to signal
@ -2070,14 +2070,14 @@ gst_element_change_state (GstElement * element, GstStateChange transition)
case GST_STATE_CHANGE_SUCCESS: case GST_STATE_CHANGE_SUCCESS:
GST_CAT_INFO_OBJECT (GST_CAT_STATES, element, GST_CAT_INFO_OBJECT (GST_CAT_STATES, element,
"element changed state SUCCESS"); "element changed state SUCCESS");
/* we can commit the state now which will proceeed to /* we can commit the state now which will proceeed to
* the next state */ * the next state */
ret = gst_element_commit_state (element); ret = gst_element_commit_state (element);
break; break;
case GST_STATE_CHANGE_NO_PREROLL: case GST_STATE_CHANGE_NO_PREROLL:
GST_CAT_INFO_OBJECT (GST_CAT_STATES, element, GST_CAT_INFO_OBJECT (GST_CAT_STATES, element,
"element changed state NO_PREROLL"); "element changed state NO_PREROLL");
/* we can commit the state now which will proceeed to /* we can commit the state now which will proceeed to
* the next state */ * the next state */
gst_element_commit_state (element); gst_element_commit_state (element);
ret = GST_STATE_CHANGE_NO_PREROLL; ret = GST_STATE_CHANGE_NO_PREROLL;
@ -2247,7 +2247,7 @@ was_ok:
* *
* Retrieves the factory that was used to create this element. * Retrieves the factory that was used to create this element.
* *
* Returns: the #GstElementFactory used for creating this element. * Returns: the #GstElementFactory used for creating this element.
* no refcounting is needed. * no refcounting is needed.
*/ */
GstElementFactory * GstElementFactory *

40
gst/gstelementfactory.c
View file

@ -27,40 +27,40 @@
* *
* GstElementFactory is used to create instances of elements. A GstElementfactory * GstElementFactory is used to create instances of elements. A GstElementfactory
* can be added to a #GstPlugin as it is also a #GstPluginFeature. * can be added to a #GstPlugin as it is also a #GstPluginFeature.
* *
* Use gst_element_factory_new() to create a new factory which can be added to a * Use gst_element_factory_new() to create a new factory which can be added to a
* plugin with gst_plugin_add_feature(). * plugin with gst_plugin_add_feature().
* *
* gst_element_factory_add_pad_template() is used to add a padtemplate to the factory. * gst_element_factory_add_pad_template() is used to add a padtemplate to the factory.
* This function will enable the application to query for elementfactories that handle * This function will enable the application to query for elementfactories that handle
* a specific media type. * a specific media type.
* *
* Use the gst_element_factory_find() and gst_element_factory_create() functions * Use the gst_element_factory_find() and gst_element_factory_create() functions
* to create element instances or use gst_element_factory_make() as a convenient * to create element instances or use gst_element_factory_make() as a convenient
* shortcut. * shortcut.
* *
* The following code example shows you how to create a GstFileSrc element. * The following code example shows you how to create a GstFileSrc element.
* *
* <example> * <example>
* <title>Using an element factory</title> * <title>Using an element factory</title>
* <programlisting language="c"> * <programlisting language="c">
* #include &lt;gst/gst.h&gt; * #include &lt;gst/gst.h&gt;
* *
* GstElement *src; * GstElement *src;
* GstElementFactory *srcfactory; * GstElementFactory *srcfactory;
* *
* gst_init(&amp;argc,&amp;argv); * gst_init(&amp;argc,&amp;argv);
* *
* srcfactory = gst_element_factory_find("filesrc"); * srcfactory = gst_element_factory_find("filesrc");
* g_return_if_fail(srcfactory != NULL); * g_return_if_fail(srcfactory != NULL);
* *
* src = gst_element_factory_create(srcfactory,"src"); * src = gst_element_factory_create(srcfactory,"src");
* g_return_if_fail(src != NULL); * g_return_if_fail(src != NULL);
* ... * ...
* </programlisting> * </programlisting>
* </example> * </example>
* *
* An elementfactory can be assigned a rank with gst_element_factory_set_rank() * An elementfactory can be assigned a rank with gst_element_factory_set_rank()
* so that the autopluggers can select a plugin more appropriatly * so that the autopluggers can select a plugin more appropriatly
*/ */
@ -457,7 +457,7 @@ __gst_element_factory_add_static_pad_template (GstElementFactory * factory,
/** /**
* gst_element_factory_get_element_type: * gst_element_factory_get_element_type:
* @factory: factory to get managed #GType from * @factory: factory to get managed #GType from
* *
* Get the #GType for elements managed by this factory * Get the #GType for elements managed by this factory
* *
* Returns: the #GType for elements managed by this factory * Returns: the #GType for elements managed by this factory
@ -473,7 +473,7 @@ gst_element_factory_get_element_type (GstElementFactory * factory)
/** /**
* gst_element_factory_get_longname: * gst_element_factory_get_longname:
* @factory: a #GstElementFactory * @factory: a #GstElementFactory
* *
* Gets the longname for this factory * Gets the longname for this factory
* *
* Returns: the longname * Returns: the longname
@ -489,7 +489,7 @@ gst_element_factory_get_longname (GstElementFactory * factory)
/** /**
* gst_element_factory_get_klass: * gst_element_factory_get_klass:
* @factory: a #GstElementFactory * @factory: a #GstElementFactory
* *
* Gets the class for this factory. * Gets the class for this factory.
* *
* Returns: the class * Returns: the class
@ -505,7 +505,7 @@ gst_element_factory_get_klass (GstElementFactory * factory)
/** /**
* gst_element_factory_get_description: * gst_element_factory_get_description:
* @factory: a #GstElementFactory * @factory: a #GstElementFactory
* *
* Gets the description for this factory. * Gets the description for this factory.
* *
* Returns: the description * Returns: the description
@ -521,7 +521,7 @@ gst_element_factory_get_description (GstElementFactory * factory)
/** /**
* gst_element_factory_get_author: * gst_element_factory_get_author:
* @factory: a #GstElementFactory * @factory: a #GstElementFactory
* *
* Gets the author for this factory. * Gets the author for this factory.
* *
* Returns: the author * Returns: the author
@ -537,7 +537,7 @@ gst_element_factory_get_author (GstElementFactory * factory)
/** /**
* gst_element_factory_get_num_pad_templates: * gst_element_factory_get_num_pad_templates:
* @factory: a #GstElementFactory * @factory: a #GstElementFactory
* *
* Gets the number of pad_templates in this factory. * Gets the number of pad_templates in this factory.
* *
* Returns: the number of pad_templates * Returns: the number of pad_templates
@ -573,7 +573,7 @@ __gst_element_factory_add_interface (GstElementFactory * elementfactory,
/** /**
* gst_element_factory_get_static_pad_templates: * gst_element_factory_get_static_pad_templates:
* @factory: a #GstElementFactory * @factory: a #GstElementFactory
* *
* Gets the #GList of padtemplates for this factory. * Gets the #GList of padtemplates for this factory.
* *
* Returns: the padtemplates * Returns: the padtemplates
@ -589,7 +589,7 @@ gst_element_factory_get_static_pad_templates (GstElementFactory * factory)
/** /**
* gst_element_factory_get_uri_type: * gst_element_factory_get_uri_type:
* @factory: a #GstElementFactory * @factory: a #GstElementFactory
* *
* Gets the type of URIs the element supports or GST_URI_UNKNOWN if none. * Gets the type of URIs the element supports or GST_URI_UNKNOWN if none.
* *
* Returns: type of URIs this element supports * Returns: type of URIs this element supports
@ -605,7 +605,7 @@ gst_element_factory_get_uri_type (GstElementFactory * factory)
/** /**
* gst_element_factory_get_uri_protocols: * gst_element_factory_get_uri_protocols:
* @factory: a #GstElementFactory * @factory: a #GstElementFactory
* *
* Gets a NULL-terminated array of protocols this element supports or NULL, if * Gets a NULL-terminated array of protocols this element supports or NULL, if
* no protocols are supported. You may not change the contents of the returned * no protocols are supported. You may not change the contents of the returned
* array as it is still ownt by the element factory. Use g_strdupv() if you want to. * array as it is still ownt by the element factory. Use g_strdupv() if you want to.

6
gst/gstelementfactory.h
View file

@ -105,7 +105,7 @@ struct _GstElementFactory {
/* URI interface stuff */ /* URI interface stuff */
guint uri_type; guint uri_type;
gchar ** uri_protocols; gchar ** uri_protocols;
GList * interfaces; /* interfaces this element implements */ GList * interfaces; /* interfaces this element implements */
gpointer _gst_reserved[GST_PADDING]; gpointer _gst_reserved[GST_PADDING];
@ -128,8 +128,8 @@ G_CONST_RETURN gchar * gst_element_factory_get_description (GstElementFactory
G_CONST_RETURN gchar * gst_element_factory_get_author (GstElementFactory *factory); G_CONST_RETURN gchar * gst_element_factory_get_author (GstElementFactory *factory);
guint gst_element_factory_get_num_pad_templates (GstElementFactory *factory); guint gst_element_factory_get_num_pad_templates (GstElementFactory *factory);
G_CONST_RETURN GList * gst_element_factory_get_static_pad_templates (GstElementFactory *factory); G_CONST_RETURN GList * gst_element_factory_get_static_pad_templates (GstElementFactory *factory);
gint gst_element_factory_get_uri_type (GstElementFactory *factory); gint gst_element_factory_get_uri_type (GstElementFactory *factory);
gchar ** gst_element_factory_get_uri_protocols (GstElementFactory *factory); gchar ** gst_element_factory_get_uri_protocols (GstElementFactory *factory);
GstElement* gst_element_factory_create (GstElementFactory *factory, GstElement* gst_element_factory_create (GstElementFactory *factory,
const gchar *name); const gchar *name);

2
gst/gstevent.c
View file

@ -92,7 +92,7 @@ static GstEventQuarks event_quarks[] = {
* *
* Get a printable name for the given event type. Do not modify or free. * Get a printable name for the given event type. Do not modify or free.
* *
* Returns: a reference to the static name of the event. * Returns: a reference to the static name of the event.
*/ */
const gchar * const gchar *
gst_event_type_get_name (GstEventType type) gst_event_type_get_name (GstEventType type)

8
gst/gstevent.h
View file

@ -262,8 +262,8 @@ GstEvent * gst_event_new_eos (void);
GstEvent* gst_event_new_newsegment (gboolean update, gdouble rate, GstFormat format, GstEvent* gst_event_new_newsegment (gboolean update, gdouble rate, GstFormat format,
gint64 start_value, gint64 stop_value, gint64 start_value, gint64 stop_value,
gint64 stream_time); gint64 stream_time);
void gst_event_parse_newsegment (GstEvent *event, gboolean *update, gdouble *rate, void gst_event_parse_newsegment (GstEvent *event, gboolean *update, gdouble *rate,
GstFormat *format, gint64 *start_value, gint64 *stop_value, GstFormat *format, gint64 *start_value, gint64 *stop_value,
gint64 *stream_time); gint64 *stream_time);
/* tag event */ /* tag event */
GstEvent* gst_event_new_tag (GstTagList *taglist); GstEvent* gst_event_new_tag (GstTagList *taglist);
@ -274,9 +274,9 @@ void gst_event_parse_tag (GstEvent *event, GstTagList **taglist);
GstEvent * gst_event_new_filler (void); GstEvent * gst_event_new_filler (void);
/* buffer */ /* buffer */
GstEvent * gst_event_new_buffersize (GstFormat format, gint64 minsize, gint64 maxsize, GstEvent * gst_event_new_buffersize (GstFormat format, gint64 minsize, gint64 maxsize,
gboolean async); gboolean async);
void gst_event_parse_buffersize (GstEvent *event, GstFormat *format, gint64 *minsize, void gst_event_parse_buffersize (GstEvent *event, GstFormat *format, gint64 *minsize,
gint64 *maxsize, gboolean *async); gint64 *maxsize, gboolean *async);
/* QOS events */ /* QOS events */

4
gst/gstformat.c
View file

@ -118,7 +118,7 @@ gst_format_register (const gchar * nick, const gchar * description)
* gst_format_get_by_nick: * gst_format_get_by_nick:
* @nick: The nick of the format * @nick: The nick of the format
* *
* Return the format registered with the given nick. * Return the format registered with the given nick.
* *
* Returns: The format with @nick or GST_FORMAT_UNDEFINED * Returns: The format with @nick or GST_FORMAT_UNDEFINED
* if the format was not registered. * if the format was not registered.
@ -190,7 +190,7 @@ gst_format_get_details (GstFormat format)
/** /**
* gst_format_iterate_definitions: * gst_format_iterate_definitions:
* *
* Iterate all the registered formats. The format definition is read * Iterate all the registered formats. The format definition is read
* only. * only.
* *
* Returns: A GstIterator of #GstFormatDefinition. * Returns: A GstIterator of #GstFormatDefinition.

6
gst/gstformat.h
View file

@ -76,7 +76,7 @@ typedef struct _GstFormatDefinition GstFormatDefinition;
* *
* A format definition * A format definition
*/ */
struct _GstFormatDefinition struct _GstFormatDefinition
{ {
GstFormat value; GstFormat value;
gchar *nick; gchar *nick;
@ -86,7 +86,7 @@ struct _GstFormatDefinition
void _gst_format_initialize (void); void _gst_format_initialize (void);
/* register a new format */ /* register a new format */
GstFormat gst_format_register (const gchar *nick, GstFormat gst_format_register (const gchar *nick,
const gchar *description); const gchar *description);
GstFormat gst_format_get_by_nick (const gchar *nick); GstFormat gst_format_get_by_nick (const gchar *nick);
@ -94,7 +94,7 @@ GstFormat gst_format_get_by_nick (const gchar *nick);
gboolean gst_formats_contains (const GstFormat *formats, GstFormat format); gboolean gst_formats_contains (const GstFormat *formats, GstFormat format);
/* query for format details */ /* query for format details */
G_CONST_RETURN GstFormatDefinition* G_CONST_RETURN GstFormatDefinition*
gst_format_get_details (GstFormat format); gst_format_get_details (GstFormat format);
GstIterator* gst_format_iterate_definitions (void); GstIterator* gst_format_iterate_definitions (void);

2
gst/gstghostpad.c
View file

@ -737,7 +737,7 @@ gst_ghost_pad_dispose (GObject * object)
* @dir: the direction of the ghostpad * @dir: the direction of the ghostpad
* *
* Create a new ghostpad without a target with the given direction. * Create a new ghostpad without a target with the given direction.
* A target can be set on the ghostpad later with the * A target can be set on the ghostpad later with the
* #gst_ghost_pad_set_target() function. * #gst_ghost_pad_set_target() function.
* *
* The created ghostpad will not have a padtemplate. * The created ghostpad will not have a padtemplate.

10
gst/gstindex.c
View file

@ -554,9 +554,9 @@ gst_index_gtype_resolver (GstIndex * index, GstObject * writer,
* *
* Before entries can be added to the index, a writer * Before entries can be added to the index, a writer
* should obtain a unique id. The methods to add new entries * should obtain a unique id. The methods to add new entries
* to the index require this id as an argument. * to the index require this id as an argument.
* *
* The application can implement a custom function to map the writer object * The application can implement a custom function to map the writer object
* to a string. That string will be used to register or look up an id * to a string. That string will be used to register or look up an id
* in the index. * in the index.
* *
@ -681,7 +681,7 @@ gst_index_add_associationv (GstIndex * index, gint id, GstAssocFlags flags,
* @id: the id of the index writer * @id: the id of the index writer
* @flags: optinal flags for this entry * @flags: optinal flags for this entry
* @format: the format of the value * @format: the format of the value
* @value: the value * @value: the value
* @...: other format/value pairs or 0 to end the list * @...: other format/value pairs or 0 to end the list
* *
* Associate given format/value pairs with each other. * Associate given format/value pairs with each other.
@ -744,7 +744,7 @@ gst_index_add_association (GstIndex * index, gint id, GstAssocFlags flags,
* @object: a pointer to the object to add * @object: a pointer to the object to add
* *
* Add the given object to the index with the given key. * Add the given object to the index with the given key.
* *
* Returns: a pointer to the newly added entry in the index. * Returns: a pointer to the newly added entry in the index.
*/ */
GstIndexEntry * GstIndexEntry *
@ -841,7 +841,7 @@ gst_index_get_assoc_entry_full (GstIndex * index, gint id,
* *
* Gets alternative formats associated with the indexentry. * Gets alternative formats associated with the indexentry.
* *
* Returns: TRUE if there was a value associated with the given * Returns: TRUE if there was a value associated with the given
* format. * format.
*/ */
gboolean gboolean

36
gst/gstindex.h
View file

@ -49,7 +49,7 @@ typedef struct _GstIndexClass GstIndexClass;
* @GST_INDEX_UNKNOWN: accuracy is not known * @GST_INDEX_UNKNOWN: accuracy is not known
* @GST_INDEX_CERTAIN: accuracy is perfect * @GST_INDEX_CERTAIN: accuracy is perfect
* @GST_INDEX_FUZZY: accuracy is fuzzy * @GST_INDEX_FUZZY: accuracy is fuzzy
* *
* The certainty of a group in the index. * The certainty of a group in the index.
*/ */
typedef enum { typedef enum {
@ -64,7 +64,7 @@ typedef enum {
* @GST_INDEX_ENTRY_ASSOCIATION: This entry is an association between formats * @GST_INDEX_ENTRY_ASSOCIATION: This entry is an association between formats
* @GST_INDEX_ENTRY_OBJECT: An object * @GST_INDEX_ENTRY_OBJECT: An object
* @GST_INDEX_ENTRY_FORMAT: A format definition * @GST_INDEX_ENTRY_FORMAT: A format definition
* *
* The different types of entries in the index. * The different types of entries in the index.
*/ */
typedef enum { typedef enum {
@ -79,7 +79,7 @@ typedef enum {
* @GST_INDEX_LOOKUP_EXACT: There has to be an exact indexentry with the given format/value * @GST_INDEX_LOOKUP_EXACT: There has to be an exact indexentry with the given format/value
* @GST_INDEX_LOOKUP_BEFORE: The exact entry or the one before it * @GST_INDEX_LOOKUP_BEFORE: The exact entry or the one before it
* @GST_INDEX_LOOKUP_AFTER: The exact entry or the one after it * @GST_INDEX_LOOKUP_AFTER: The exact entry or the one after it
* *
* Specify the method to find an index entry in the index. * Specify the method to find an index entry in the index.
*/ */
typedef enum { typedef enum {
@ -203,7 +203,7 @@ struct _GstIndexEntry {
} id; } id;
struct { struct {
gint nassocs; gint nassocs;
GstIndexAssociation GstIndexAssociation
*assocs; *assocs;
GstAssocFlags flags; GstAssocFlags flags;
} assoc; } assoc;
@ -251,7 +251,7 @@ struct _GstIndexGroup {
* to the index, %FALSE otherwise. * to the index, %FALSE otherwise.
* *
*/ */
typedef gboolean (*GstIndexFilter) (GstIndex *index, typedef gboolean (*GstIndexFilter) (GstIndex *index,
GstIndexEntry *entry); GstIndexEntry *entry);
/** /**
* GstIndexResolverMethod: * GstIndexResolverMethod:
@ -278,8 +278,8 @@ typedef enum {
* *
* Returns: %TRUE if an id could be assigned to the writer. * Returns: %TRUE if an id could be assigned to the writer.
*/ */
typedef gboolean (*GstIndexResolver) (GstIndex *index, typedef gboolean (*GstIndexResolver) (GstIndex *index,
GstObject *writer, GstObject *writer,
gchar **writer_string, gchar **writer_string,
gpointer user_data); gpointer user_data);
@ -292,8 +292,8 @@ typedef gboolean (*GstIndexResolver) (GstIndex *index,
* Flags for this index * Flags for this index
*/ */
typedef enum { typedef enum {
GST_INDEX_WRITABLE = (GST_OBJECT_FLAG_LAST << 0), GST_INDEX_WRITABLE = (GST_OBJECT_FLAG_LAST << 0),
GST_INDEX_READABLE = (GST_OBJECT_FLAG_LAST << 1), GST_INDEX_READABLE = (GST_OBJECT_FLAG_LAST << 1),
GST_INDEX_FLAG_LAST = (GST_OBJECT_FLAG_LAST << 8) GST_INDEX_FLAG_LAST = (GST_OBJECT_FLAG_LAST << 8)
} GstIndexFlags; } GstIndexFlags;
@ -344,11 +344,11 @@ struct _GstIndexClass {
/* abstract methods */ /* abstract methods */
void (*add_entry) (GstIndex *index, GstIndexEntry *entry); void (*add_entry) (GstIndex *index, GstIndexEntry *entry);
GstIndexEntry* (*get_assoc_entry) (GstIndex *index, gint id, GstIndexEntry* (*get_assoc_entry) (GstIndex *index, gint id,
GstIndexLookupMethod method, GstAssocFlags flags, GstIndexLookupMethod method, GstAssocFlags flags,
GstFormat format, gint64 value, GstFormat format, gint64 value,
GCompareDataFunc func, GCompareDataFunc func,
gpointer user_data); gpointer user_data);
/* signals */ /* signals */
void (*entry_added) (GstIndex *index, GstIndexEntry *entry); void (*entry_added) (GstIndex *index, GstIndexEntry *entry);
@ -363,29 +363,29 @@ gint gst_index_get_group (GstIndex *index);
gint gst_index_new_group (GstIndex *index); gint gst_index_new_group (GstIndex *index);
gboolean gst_index_set_group (GstIndex *index, gint groupnum); gboolean gst_index_set_group (GstIndex *index, gint groupnum);
void gst_index_set_certainty (GstIndex *index, void gst_index_set_certainty (GstIndex *index,
GstIndexCertainty certainty); GstIndexCertainty certainty);
GstIndexCertainty gst_index_get_certainty (GstIndex *index); GstIndexCertainty gst_index_get_certainty (GstIndex *index);
void gst_index_set_filter (GstIndex *index, void gst_index_set_filter (GstIndex *index,
GstIndexFilter filter, gpointer user_data); GstIndexFilter filter, gpointer user_data);
void gst_index_set_resolver (GstIndex *index, void gst_index_set_resolver (GstIndex *index,
GstIndexResolver resolver, gpointer user_data); GstIndexResolver resolver, gpointer user_data);
gboolean gst_index_get_writer_id (GstIndex *index, GstObject *writer, gint *id); gboolean gst_index_get_writer_id (GstIndex *index, GstObject *writer, gint *id);
GstIndexEntry* gst_index_add_format (GstIndex *index, gint id, GstFormat format); GstIndexEntry* gst_index_add_format (GstIndex *index, gint id, GstFormat format);
GstIndexEntry* gst_index_add_association (GstIndex *index, gint id, GstAssocFlags flags, GstIndexEntry* gst_index_add_association (GstIndex *index, gint id, GstAssocFlags flags,
GstFormat format, gint64 value, ...); GstFormat format, gint64 value, ...);
GstIndexEntry* gst_index_add_object (GstIndex *index, gint id, gchar *key, GstIndexEntry* gst_index_add_object (GstIndex *index, gint id, gchar *key,
GType type, gpointer object); GType type, gpointer object);
GstIndexEntry* gst_index_add_id (GstIndex *index, gint id, GstIndexEntry* gst_index_add_id (GstIndex *index, gint id,
gchar *description); gchar *description);
GstIndexEntry* gst_index_get_assoc_entry (GstIndex *index, gint id, GstIndexEntry* gst_index_get_assoc_entry (GstIndex *index, gint id,
GstIndexLookupMethod method, GstAssocFlags flags, GstIndexLookupMethod method, GstAssocFlags flags,
GstFormat format, gint64 value); GstFormat format, gint64 value);
GstIndexEntry* gst_index_get_assoc_entry_full (GstIndex *index, gint id, GstIndexEntry* gst_index_get_assoc_entry_full (GstIndex *index, gint id,
GstIndexLookupMethod method, GstAssocFlags flags, GstIndexLookupMethod method, GstAssocFlags flags,
GstFormat format, gint64 value, GstFormat format, gint64 value,
GCompareDataFunc func, GCompareDataFunc func,

4
gst/gstindexfactory.c
View file

@ -171,7 +171,7 @@ gst_index_factory_find (const gchar * name)
* gst_index_factory_create: * gst_index_factory_create:
* @factory: the factory used to create the instance * @factory: the factory used to create the instance
* *
* Create a new #GstIndex instance from the * Create a new #GstIndex instance from the
* given indexfactory. * given indexfactory.
* *
* Returns: A new #GstIndex instance. * Returns: A new #GstIndex instance.
@ -201,7 +201,7 @@ gst_index_factory_create (GstIndexFactory * factory)
* gst_index_factory_make: * gst_index_factory_make:
* @name: the name of the factory used to create the instance * @name: the name of the factory used to create the instance
* *
* Create a new #GstIndex instance from the * Create a new #GstIndex instance from the
* indexfactory with the given name. * indexfactory with the given name.
* *
* Returns: A new #GstIndex instance. * Returns: A new #GstIndex instance.

6
gst/gstindexfactory.h
View file

@ -47,7 +47,7 @@ typedef struct _GstIndexFactoryClass GstIndexFactoryClass;
*/ */
struct _GstIndexFactory { struct _GstIndexFactory {
GstPluginFeature feature; GstPluginFeature feature;
gchar *longdesc; /* long description of the index (well, don't overdo it..) */ gchar *longdesc; /* long description of the index (well, don't overdo it..) */
GType type; /* unique GType of the index */ GType type; /* unique GType of the index */
@ -55,14 +55,14 @@ struct _GstIndexFactory {
}; };
struct _GstIndexFactoryClass { struct _GstIndexFactoryClass {
GstPluginFeatureClass parent; GstPluginFeatureClass parent;
gpointer _gst_reserved[GST_PADDING]; gpointer _gst_reserved[GST_PADDING];
}; };
GType gst_index_factory_get_type (void); GType gst_index_factory_get_type (void);
GstIndexFactory* gst_index_factory_new (const gchar *name, GstIndexFactory* gst_index_factory_new (const gchar *name,
const gchar *longdesc, GType type); const gchar *longdesc, GType type);
void gst_index_factory_destroy (GstIndexFactory *factory); void gst_index_factory_destroy (GstIndexFactory *factory);

66
gst/gstinfo.c
View file

@ -28,14 +28,14 @@
* *
* GStreamer's debugging subsystem is an easy way to get information about what * GStreamer's debugging subsystem is an easy way to get information about what
* the application is doing. * the application is doing.
* It is not meant for programming errors. Use GLib methods (g_warning and * It is not meant for programming errors. Use GLib methods (g_warning and
* friends) for that. * friends) for that.
* *
* The debugging subsystem works only after GStreamer has been initialized * The debugging subsystem works only after GStreamer has been initialized
* - for example by calling gst_init(). * - for example by calling gst_init().
* *
* The debugging subsystem is used to log informational messages while the * The debugging subsystem is used to log informational messages while the
* application runs. * application runs.
* Each messages has some properties attached to it. Among these properties * Each messages has some properties attached to it. Among these properties
* are the debugging category, the severity (called "level" here) and an * are the debugging category, the severity (called "level" here) and an
* optional * optional
@ -43,10 +43,10 @@
* debugging handlers, which then handle the messages. GStreamer attaches a * debugging handlers, which then handle the messages. GStreamer attaches a
* default handler on startup, which outputs requested messages to stderr. * default handler on startup, which outputs requested messages to stderr.
* *
* Messages are output by using shortcut macros like #GST_DEBUG, * Messages are output by using shortcut macros like #GST_DEBUG,
* #GST_CAT_ERROR_OBJECT or similar. These all expand to calling gst_debug_log() * #GST_CAT_ERROR_OBJECT or similar. These all expand to calling gst_debug_log()
* with the right parameters. * with the right parameters.
* The only thing a developer will probably want to do is define his own * The only thing a developer will probably want to do is define his own
* categories. This is easily done with 3 lines. At the top of your code, * categories. This is easily done with 3 lines. At the top of your code,
* declare * declare
* the variables and set the default category. * the variables and set the default category.
@ -64,7 +64,7 @@
* </programlisting> * </programlisting>
* </informalexample> * </informalexample>
* Initialization must be done before the category is used first. * Initialization must be done before the category is used first.
* Plugins do this * Plugins do this
* in their plugin_init function, libraries and applications should do that * in their plugin_init function, libraries and applications should do that
* during their initialization. * during their initialization.
* *
@ -79,11 +79,11 @@
* subsystem was compiled out, #GST_DISABLE_GST_DEBUG is defined in * subsystem was compiled out, #GST_DISABLE_GST_DEBUG is defined in
* &lt;gst/gst.h&gt;, * &lt;gst/gst.h&gt;,
* so you can check that before doing your trick. * so you can check that before doing your trick.
* Disabling the debugging subsystem will give you a slight (read: unnoticable) * Disabling the debugging subsystem will give you a slight (read: unnoticable)
* speed increase and will reduce the size of your compiled code. The GStreamer * speed increase and will reduce the size of your compiled code. The GStreamer
* library itself becomes around 10% smaller. * library itself becomes around 10% smaller.
* *
* Please note that there are naming conventions for the names of debugging * Please note that there are naming conventions for the names of debugging
* categories. These are explained at GST_DEBUG_CATEGORY_INIT(). * categories. These are explained at GST_DEBUG_CATEGORY_INIT().
*/ */
@ -260,7 +260,7 @@ __gst_in_valgrind (void)
/** /**
* _gst_debug_init: * _gst_debug_init:
* *
* Initializes the debugging system. * Initializes the debugging system.
* Normally you don't want to call this, because gst_init does it for you. * Normally you don't want to call this, because gst_init does it for you.
*/ */
@ -366,7 +366,7 @@ _gst_debug_init (void)
* @object: the object this message relates to or NULL if none * @object: the object this message relates to or NULL if none
* @format: a printf style format string * @format: a printf style format string
* @...: optional arguments for the format * @...: optional arguments for the format
* *
* Logs the given message using the currently registered debugging handlers. * Logs the given message using the currently registered debugging handlers.
*/ */
void void
@ -392,7 +392,7 @@ gst_debug_log (GstDebugCategory * category, GstDebugLevel level,
* @object: the object this message relates to or NULL if none * @object: the object this message relates to or NULL if none
* @format: a printf style format string * @format: a printf style format string
* @args: optional arguments for the format * @args: optional arguments for the format
* *
* Logs the given message using the currently registered debugging handlers. * Logs the given message using the currently registered debugging handlers.
*/ */
void void
@ -492,11 +492,11 @@ gst_debug_print_object (gpointer ptr)
/** /**
* gst_debug_construct_term_color: * gst_debug_construct_term_color:
* @colorinfo: the color info * @colorinfo: the color info
* *
* Constructs a string that can be used for getting the desired color in color * Constructs a string that can be used for getting the desired color in color
* terminals. * terminals.
* You need to free the string after use. * You need to free the string after use.
* *
* Returns: a string containing the color definition * Returns: a string containing the color definition
*/ */
gchar * gchar *
@ -537,11 +537,11 @@ gst_debug_construct_term_color (guint colorinfo)
* @message: the actual message * @message: the actual message
* @object: the object this message relates to or NULL if none * @object: the object this message relates to or NULL if none
* @unused: an unused variable, reserved for some user_data. * @unused: an unused variable, reserved for some user_data.
* *
* The default logging handler used by GStreamer. Logging functions get called * The default logging handler used by GStreamer. Logging functions get called
* whenever a macro like GST_DEBUG or similar is used. This function outputs the * whenever a macro like GST_DEBUG or similar is used. This function outputs the
* message and additional info using the glib error handler. * message and additional info using the glib error handler.
* You can add other handlers by using #gst_debug_add_log_function. * You can add other handlers by using #gst_debug_add_log_function.
* And you can remove this handler by calling * And you can remove this handler by calling
* gst_debug_remove_log_function (gst_debug_log_default); * gst_debug_remove_log_function (gst_debug_log_default);
*/ */
@ -603,9 +603,9 @@ gst_debug_log_default (GstDebugCategory * category, GstDebugLevel level,
/** /**
* gst_debug_level_get_name: * gst_debug_level_get_name:
* @level: the level to get the name for * @level: the level to get the name for
* *
* Get the string trepresentation of a debugging level * Get the string trepresentation of a debugging level
* *
* Returns: the name * Returns: the name
*/ */
const gchar * const gchar *
@ -634,7 +634,7 @@ gst_debug_level_get_name (GstDebugLevel level)
* gst_debug_add_log_function: * gst_debug_add_log_function:
* @func: the function to use * @func: the function to use
* @data: user data * @data: user data
* *
* Adds the logging function to the list of logging functions. * Adds the logging function to the list of logging functions.
* Be sure to use G_GNUC_NO_INSTRUMENT on that function, it is needed. * Be sure to use G_GNUC_NO_INSTRUMENT on that function, it is needed.
*/ */
@ -652,7 +652,7 @@ gst_debug_add_log_function (GstLogFunction func, gpointer data)
/* FIXME: we leak the old list here - other threads might access it right now /* FIXME: we leak the old list here - other threads might access it right now
* in gst_debug_logv. Another solution is to lock the mutex in gst_debug_logv, * in gst_debug_logv. Another solution is to lock the mutex in gst_debug_logv,
* but that is waaay costly. * but that is waaay costly.
* It'd probably be clever to use some kind of RCU here, but I don't know * It'd probably be clever to use some kind of RCU here, but I don't know
* anything about that. * anything about that.
*/ */
g_static_mutex_lock (&__log_func_mutex); g_static_mutex_lock (&__log_func_mutex);
@ -708,9 +708,9 @@ gst_debug_remove_with_compare_func (GCompareFunc func, gpointer data)
/** /**
* gst_debug_remove_log_function: * gst_debug_remove_log_function:
* @func: the log function to remove * @func: the log function to remove
* *
* Removes all registrered instances of the given logging functions. * Removes all registrered instances of the given logging functions.
* *
* Returns: How many instances of the function were removed * Returns: How many instances of the function were removed
*/ */
guint guint
@ -732,9 +732,9 @@ gst_debug_remove_log_function (GstLogFunction func)
/** /**
* gst_debug_remove_log_function_by_data: * gst_debug_remove_log_function_by_data:
* @data: user data of the log function to remove * @data: user data of the log function to remove
* *
* Removes all registrered instances of log functions with the given user data. * Removes all registrered instances of log functions with the given user data.
* *
* Returns: How many instances of the function were removed * Returns: How many instances of the function were removed
*/ */
guint guint
@ -755,7 +755,7 @@ gst_debug_remove_log_function_by_data (gpointer data)
/** /**
* gst_debug_set_colored: * gst_debug_set_colored:
* @colored: Whether to use colored output or not * @colored: Whether to use colored output or not
* *
* Sets or unsets the use of coloured debugging output. * Sets or unsets the use of coloured debugging output.
*/ */
void void
@ -766,9 +766,9 @@ gst_debug_set_colored (gboolean colored)
/** /**
* gst_debug_is_colored: * gst_debug_is_colored:
* *
* Checks if the debugging output should be colored. * Checks if the debugging output should be colored.
* *
* Returns: TRUE, if the debug output should be colored. * Returns: TRUE, if the debug output should be colored.
*/ */
gboolean gboolean
@ -780,7 +780,7 @@ gst_debug_is_colored (void)
/** /**
* gst_debug_set_active: * gst_debug_set_active:
* @active: Whether to use debugging output or not * @active: Whether to use debugging output or not
* *
* If activated, debugging messages are sent to the debugging * If activated, debugging messages are sent to the debugging
* handlers. * handlers.
* It makes sense to deactivate it for speed issues. * It makes sense to deactivate it for speed issues.
@ -795,9 +795,9 @@ gst_debug_set_active (gboolean active)
/** /**
* gst_debug_is_active: * gst_debug_is_active:
* *
* Checks if debugging output is activated. * Checks if debugging output is activated.
* *
* Returns: TRUE, if debugging is activated * Returns: TRUE, if debugging is activated
*/ */
gboolean gboolean
@ -809,7 +809,7 @@ gst_debug_is_active (void)
/** /**
* gst_debug_set_default_threshold: * gst_debug_set_default_threshold:
* @level: level to set * @level: level to set
* *
* Sets the default threshold to the given level and updates all categories to * Sets the default threshold to the given level and updates all categories to
* use this threshold. * use this threshold.
*/ */
@ -822,9 +822,9 @@ gst_debug_set_default_threshold (GstDebugLevel level)
/** /**
* gst_debug_get_default_threshold: * gst_debug_get_default_threshold:
* *
* Returns the default threshold that is used for new categories. * Returns the default threshold that is used for new categories.
* *
* Returns: the default threshold level * Returns: the default threshold level
*/ */
GstDebugLevel GstDebugLevel
@ -1256,7 +1256,7 @@ __cyg_profile_func_exit (void *this_fn, void *call_site)
* gst_debug_print_stack_trace: * gst_debug_print_stack_trace:
* *
* If GST_ENABLE_FUNC_INSTRUMENTATION is defined a stacktracke is available for * If GST_ENABLE_FUNC_INSTRUMENTATION is defined a stacktracke is available for
* gstreamer code, which can be printed with this function. * gstreamer code, which can be printed with this function.
*/ */
void void
gst_debug_print_stack_trace (void) gst_debug_print_stack_trace (void)

22
gst/gstinfo.h
View file

@ -34,30 +34,30 @@ G_BEGIN_DECLS
* GstDebugLevel: * GstDebugLevel:
* @GST_LEVEL_NONE: No debugging level specified or desired. Used to deactivate * @GST_LEVEL_NONE: No debugging level specified or desired. Used to deactivate
* debugging output. * debugging output.
* @GST_LEVEL_ERROR: Error messages are to be used only when an error occured * @GST_LEVEL_ERROR: Error messages are to be used only when an error occured
* that stops the application from keeping working correctly. * that stops the application from keeping working correctly.
* An examples is gst_element_error, which outputs a message with this priority. * An examples is gst_element_error, which outputs a message with this priority.
* It does not mean that the application is terminating as with g_errror. * It does not mean that the application is terminating as with g_errror.
* @GST_LEVEL_WARNING: Warning messages are to inform about abnormal behaviour * @GST_LEVEL_WARNING: Warning messages are to inform about abnormal behaviour
* that could lead to problems or weird behaviour later on. An example of this * that could lead to problems or weird behaviour later on. An example of this
* would be clocking issues ("your computer is pretty slow") or broken input * would be clocking issues ("your computer is pretty slow") or broken input
* data ("Can't synchronize to stream.") * data ("Can't synchronize to stream.")
* @GST_LEVEL_INFO: Informational messages should be used to keep the developer * @GST_LEVEL_INFO: Informational messages should be used to keep the developer
* updated about what is happening. * updated about what is happening.
* Examples where this should be used are when a typefind function has * Examples where this should be used are when a typefind function has
* successfully determined the type of the stream or when an mp3 plugin detects * successfully determined the type of the stream or when an mp3 plugin detects
* the format to be used. ("This file has mono sound.") * the format to be used. ("This file has mono sound.")
* @GST_LEVEL_DEBUG: Debugging messages should be used when something common * @GST_LEVEL_DEBUG: Debugging messages should be used when something common
* happens that is not the expected default behavior. * happens that is not the expected default behavior.
* An example would be notifications about state changes or receiving/sending of * An example would be notifications about state changes or receiving/sending of
* events. * events.
* @GST_LEVEL_LOG: Log messages are messages that are very common but might be * @GST_LEVEL_LOG: Log messages are messages that are very common but might be
* useful to know. As a rule of thumb a pipeline that is iterating as expected * useful to know. As a rule of thumb a pipeline that is iterating as expected
* should never output anzthing else but LOG messages. * should never output anzthing else but LOG messages.
* Examples for this are referencing/dereferencing of objects or cothread switches. * Examples for this are referencing/dereferencing of objects or cothread switches.
* @GST_LEVEL_COUNT: The number of defined debugging levels. * @GST_LEVEL_COUNT: The number of defined debugging levels.
* *
* The level defines the importance of a debugging message. The more important a * The level defines the importance of a debugging message. The more important a
* message is, the greater the probability that the debugging system outputs it. * message is, the greater the probability that the debugging system outputs it.
*/ */
typedef enum { typedef enum {
@ -114,7 +114,7 @@ typedef enum {
* @GST_DEBUG_BG_WHITE: Use white as background color. * @GST_DEBUG_BG_WHITE: Use white as background color.
* @GST_DEBUG_BOLD: Make the output bold. * @GST_DEBUG_BOLD: Make the output bold.
* @GST_DEBUG_UNDERLINE: Underline the output. * @GST_DEBUG_UNDERLINE: Underline the output.
* *
* These are some terminal style flags you can use when creating your * These are some terminal style flags you can use when creating your
* debugging categories to make them stand out in debugging output. * debugging categories to make them stand out in debugging output.
*/ */
@ -515,7 +515,7 @@ GST_CAT_LEVEL_LOG (GstDebugCategory * cat, GstDebugLevel level,
* @obj: the #GObject the message belongs to * @obj: the #GObject the message belongs to
* @...: printf-style message to output * @...: printf-style message to output
* *
* Output an informational message belonging to the given object in the default * Output an informational message belonging to the given object in the default
* category. * category.
*/ */
/** /**
@ -523,7 +523,7 @@ GST_CAT_LEVEL_LOG (GstDebugCategory * cat, GstDebugLevel level,
* @obj: the #GObject the message belongs to * @obj: the #GObject the message belongs to
* @...: printf-style message to output * @...: printf-style message to output
* *
* Output a debugging message belonging to the given object in the default * Output a debugging message belonging to the given object in the default
* category. * category.
*/ */
/** /**
@ -534,7 +534,7 @@ GST_CAT_LEVEL_LOG (GstDebugCategory * cat, GstDebugLevel level,
* Output a logging message belonging to the given object in the default category. * Output a logging message belonging to the given object in the default category.
*/ */
/** /**
* GST_ERROR: * GST_ERROR:
* @...: printf-style message to output * @...: printf-style message to output

2
gst/gstinterface.c
View file

@ -1,5 +1,5 @@
/* GStreamer /* GStreamer
* *
* Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu> * Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
* 2000 Wim Taymans <wtay@chello.be> * 2000 Wim Taymans <wtay@chello.be>
* *

10
gst/gstiterator.c
View file

@ -199,7 +199,7 @@ gst_iterator_pop (GstIterator * it)
* @elem: pointer to hold next element * @elem: pointer to hold next element
* *
* Get the next item from the iterator. * Get the next item from the iterator.
* *
* Returns: The result of the iteration. * Returns: The result of the iteration.
* *
* MT safe. * MT safe.
@ -263,7 +263,7 @@ done:
* *
* Resync the iterator. this function is mostly called * Resync the iterator. this function is mostly called
* after #gst_iterator_next() returned #GST_ITERATOR_RESYNC. * after #gst_iterator_next() returned #GST_ITERATOR_RESYNC.
* *
* MT safe. * MT safe.
*/ */
void void
@ -310,7 +310,7 @@ gst_iterator_free (GstIterator * it)
* *
* This function is mainly used by objects implementing the iterator * This function is mainly used by objects implementing the iterator
* next function to recurse into substructures. * next function to recurse into substructures.
* *
* MT safe. * MT safe.
*/ */
void void
@ -400,7 +400,7 @@ filter_free (GstIteratorFilter * it)
* When this iterator is freed, @it will also be freed. * When this iterator is freed, @it will also be freed.
* *
* Returns: a new #GstIterator. * Returns: a new #GstIterator.
* *
* MT safe. * MT safe.
*/ */
GstIterator * GstIterator *
@ -449,7 +449,7 @@ gst_iterator_filter (GstIterator * it, GCompareFunc func, gpointer user_data)
* The iterator will not be freed. * The iterator will not be freed.
* *
* Returns: A #GstIteratorResult, as described above. * Returns: A #GstIteratorResult, as described above.
* *
* MT safe. * MT safe.
*/ */
GstIteratorResult GstIteratorResult

2
gst/gstmacros.h
View file

@ -41,7 +41,7 @@ G_BEGIN_DECLS
# define GST_INLINE_FUNC extern __inline # define GST_INLINE_FUNC extern __inline
# define GST_CAN_INLINE 1 # define GST_CAN_INLINE 1
#else #else
# define GST_INLINE_FUNC extern # define GST_INLINE_FUNC extern
# undef GST_CAN_INLINE # undef GST_CAN_INLINE
#endif #endif

2
gst/gstmemchunk.c
View file

@ -115,7 +115,7 @@ populate (GstMemChunk * mem_chunk)
* @type: the allocation strategy to use * @type: the allocation strategy to use
* *
* Creates a new memchunk that will allocate atom_sized memchunks. * Creates a new memchunk that will allocate atom_sized memchunks.
* The initial area is set to area_size and will grow automatically * The initial area is set to area_size and will grow automatically
* when it is too small (with a small overhead when that happens) * when it is too small (with a small overhead when that happens)
* *
* Returns: a new #GstMemChunk * Returns: a new #GstMemChunk

16
gst/gstmessage.c
View file

@ -23,13 +23,13 @@
* @short_description: Lightweight objects to signal the application of pipeline events * @short_description: Lightweight objects to signal the application of pipeline events
* @see_also: #GstBus,#GstMiniObject * @see_also: #GstBus,#GstMiniObject
* *
* Messages are implemented as a subclass of #GstMiniObject with a generic * Messages are implemented as a subclass of #GstMiniObject with a generic
* #GstStructure as the content. This allows for writing custom messages without * #GstStructure as the content. This allows for writing custom messages without
* requiring an API change while allowing a wide range of different types * requiring an API change while allowing a wide range of different types
* of messages. * of messages.
* *
* Messages are posted by objects in the pipeline and are passed to the * Messages are posted by objects in the pipeline and are passed to the
* application using the #GstBus. * application using the #GstBus.
*/ */
#include <string.h> /* memcpy */ #include <string.h> /* memcpy */
@ -99,7 +99,7 @@ static GstMessageQuarks message_quarks[] = {
* *
* Get a printable name for the given message type. Do not modify or free. * Get a printable name for the given message type. Do not modify or free.
* *
* Returns: a reference to the static name of the message. * Returns: a reference to the static name of the message.
*/ */
const gchar * const gchar *
gst_message_type_get_name (GstMessageType type) gst_message_type_get_name (GstMessageType type)
@ -311,7 +311,7 @@ gst_message_new_eos (GstObject * src)
* *
* Create a new error message. The message will copy @error and * Create a new error message. The message will copy @error and
* @debug. This message is posted by element when a fatal event * @debug. This message is posted by element when a fatal event
* occured. The pipeline will probably (partially) stop. * occured. The pipeline will probably (partially) stop.
* *
* Returns: The new error message. * Returns: The new error message.
* *
@ -414,11 +414,11 @@ gst_message_new_state_changed (GstObject * src,
* @clock: The clock it provides * @clock: The clock it provides
* @ready: TRUE if the sender can provide a clock * @ready: TRUE if the sender can provide a clock
* *
* Create a clock provide message. This message is posted whenever an * Create a clock provide message. This message is posted whenever an
* element is ready to provide a clock or lost its ability to provide * element is ready to provide a clock or lost its ability to provide
* a clock (maybe because it paused or became EOS). * a clock (maybe because it paused or became EOS).
* *
* This message is mainly used internally to manage the clock * This message is mainly used internally to manage the clock
* selection. * selection.
* *
* Returns: The new provide clock message. * Returns: The new provide clock message.
@ -590,7 +590,7 @@ gst_message_new_element (GstObject * src, GstStructure * structure)
* Access the structure of the message. * Access the structure of the message.
* *
* Returns: The structure of the message. The structure is still * Returns: The structure of the message. The structure is still
* owned by the message, which means that you should not free it and * owned by the message, which means that you should not free it and
* that the pointer becomes invalid when you free the message. * that the pointer becomes invalid when you free the message.
* *
* MT safe. * MT safe.

2
gst/gstmessage.h
View file

@ -122,7 +122,7 @@ struct _GstMessage
GstObject *src; GstObject *src;
GstStructure *structure; GstStructure *structure;
/*< private > */ /*< private > */
gpointer _gst_reserved[GST_PADDING]; gpointer _gst_reserved[GST_PADDING];
}; };

4
gst/gstminiobject.c
View file

@ -192,7 +192,7 @@ gst_mini_object_copy (const GstMiniObject * mini_object)
* if the reference count is one and the GST_MINI_OBJECT_FLAG_READONLY * if the reference count is one and the GST_MINI_OBJECT_FLAG_READONLY
* flag is not set. Modification of a mini-object should only be * flag is not set. Modification of a mini-object should only be
* done after verifying that it is writable. * done after verifying that it is writable.
* *
* MT safe * MT safe
* *
* Returns: TRUE if the object is writable. * Returns: TRUE if the object is writable.
@ -243,7 +243,7 @@ gst_mini_object_ref (GstMiniObject * mini_object)
{ {
g_return_val_if_fail (mini_object != NULL, NULL); g_return_val_if_fail (mini_object != NULL, NULL);
/* we cannot assert that the refcount > 0 since a bufferalloc /* we cannot assert that the refcount > 0 since a bufferalloc
* function might resurect an object * function might resurect an object
g_return_val_if_fail (mini_object->refcount > 0, NULL); g_return_val_if_fail (mini_object->refcount > 0, NULL);
*/ */

18
gst/gstobject.c
View file

@ -43,7 +43,7 @@
* reference can be removed by anyone at any time, by calling gst_object_sink(). * reference can be removed by anyone at any time, by calling gst_object_sink().
* gst_object_sink() does nothing if an object is already sunk (has no floating * gst_object_sink() does nothing if an object is already sunk (has no floating
* reference). * reference).
* *
* When you add a GstElement to its parent container, the parent container will do * When you add a GstElement to its parent container, the parent container will do
* this: * this:
* <informalexample> * <informalexample>
@ -69,7 +69,7 @@
* Another effect of this is, that calling gst_object_unref() on a bin object, will * Another effect of this is, that calling gst_object_unref() on a bin object, will
* also destoy all the GstElement objects in it. The same is true for calling * also destoy all the GstElement objects in it. The same is true for calling
* gst_bin_remove(). * gst_bin_remove().
* *
* In contrast to GObject instances GstObject add a name property. The functions * In contrast to GObject instances GstObject add a name property. The functions
* gst_object_set_name() and gst_object_get_name() are used to set/get the name * gst_object_set_name() and gst_object_get_name() are used to set/get the name
* of the object. * of the object.
@ -552,9 +552,9 @@ gst_object_finalize (GObject * object)
* signals being emitted by the object itself, as well as in each parent * signals being emitted by the object itself, as well as in each parent
* object. This is so that an application can connect a listener to the * object. This is so that an application can connect a listener to the
* top-level bin to catch property-change notifications for all contained * top-level bin to catch property-change notifications for all contained
* elements. * elements.
* *
* This function is not MT safe in glib so we need to lock it with a * This function is not MT safe in glib so we need to lock it with a
* classwide mutex. * classwide mutex.
* *
* MT safe. * MT safe.
@ -618,7 +618,7 @@ gst_object_dispatch_properties_changed (GObject * object,
GST_CLASS_UNLOCK (klass); GST_CLASS_UNLOCK (klass);
} }
/** /**
* gst_object_default_deep_notify: * gst_object_default_deep_notify:
* @object: the #GObject that signalled the notify. * @object: the #GObject that signalled the notify.
* @orig: a #GstObject that initiated the notify. * @orig: a #GstObject that initiated the notify.
@ -626,9 +626,9 @@ gst_object_dispatch_properties_changed (GObject * object,
* @excluded_props: a set of user-specified properties to exclude or * @excluded_props: a set of user-specified properties to exclude or
* NULL to show all changes. * NULL to show all changes.
* *
* A default deep_notify signal callback for an element. The user data * A default deep_notify signal callback for an element. The user data
* should contain a pointer to an array of strings that should be excluded * should contain a pointer to an array of strings that should be excluded
* from the notify. The default handler will print the new value of the property * from the notify. The default handler will print the new value of the property
* using g_print. * using g_print.
* *
* MT safe. This function grabs and releases the object's LOCK or getting the * MT safe. This function grabs and releases the object's LOCK or getting the
@ -1127,7 +1127,7 @@ gst_object_get_property (GObject * object, guint prop_id,
* the object hierarchy. Only useful (or used) for debugging. * the object hierarchy. Only useful (or used) for debugging.
* *
* Returns: a string describing the path of the object. You must * Returns: a string describing the path of the object. You must
* g_free() the string after usage. * g_free() the string after usage.
* *
* MT safe. Grabs and releases the object's LOCK for all objects * MT safe. Grabs and releases the object's LOCK for all objects
* in the hierarchy. * in the hierarchy.

8
gst/gstobject.h
View file

@ -69,14 +69,14 @@ typedef enum
* GST_OBJECT_REFCOUNT: * GST_OBJECT_REFCOUNT:
* @obj: Object get the refcount for. * @obj: Object get the refcount for.
* *
* Get access to the reference count field of the object. * Get access to the reference count field of the object.
*/ */
#define GST_OBJECT_REFCOUNT(obj) (((GObject*)(obj))->ref_count) #define GST_OBJECT_REFCOUNT(obj) (((GObject*)(obj))->ref_count)
/** /**
* GST_OBJECT_REFCOUNT_VALUE: * GST_OBJECT_REFCOUNT_VALUE:
* @obj: Object get the refcount value for. * @obj: Object get the refcount value for.
* *
* Get the reference count value of the object. * Get the reference count value of the object.
*/ */
#define GST_OBJECT_REFCOUNT_VALUE(obj) GST_OBJECT_REFCOUNT(obj) #define GST_OBJECT_REFCOUNT_VALUE(obj) GST_OBJECT_REFCOUNT(obj)
#else #else
@ -86,7 +86,7 @@ typedef enum
/* we do a GST_OBJECT_CAST to avoid type checking, better call these /* we do a GST_OBJECT_CAST to avoid type checking, better call these
* function with a valid object! */ * function with a valid object! */
/** /**
* GST_LOCK: * GST_LOCK:
* @obj: Object to lock. * @obj: Object to lock.
@ -257,7 +257,7 @@ GstObject* gst_object_get_parent (GstObject *object);
void gst_object_unparent (GstObject *object); void gst_object_unparent (GstObject *object);
gboolean gst_object_has_ancestor (GstObject *object, GstObject *ancestor); gboolean gst_object_has_ancestor (GstObject *object, GstObject *ancestor);
void gst_object_default_deep_notify (GObject *object, GstObject *orig, void gst_object_default_deep_notify (GObject *object, GstObject *orig,
GParamSpec *pspec, gchar **excluded_props); GParamSpec *pspec, gchar **excluded_props);
/* refcounting + life cycle */ /* refcounting + life cycle */

68
gst/gstpad.c
View file

@ -24,21 +24,21 @@
* @short_description: Object contained by elements that allows links to other elements * @short_description: Object contained by elements that allows links to other elements
* @see_also: #GstPadTemplate, #GstElement, #GstEvent * @see_also: #GstPadTemplate, #GstElement, #GstEvent
* *
* A #GstElement is linked to other elements via "pads", which are extremely * A #GstElement is linked to other elements via "pads", which are extremely
* light-weight generic link points. * light-weight generic link points.
* After two pads are retrieved from an element with gst_element_get_pad(), * After two pads are retrieved from an element with gst_element_get_pad(),
* the pads can be link with gst_pad_link(). (For quick links, * the pads can be link with gst_pad_link(). (For quick links,
* you can also use gst_element_link(), which will make the obvious * you can also use gst_element_link(), which will make the obvious
* link for you if it's straightforward.) * link for you if it's straightforward.)
* *
* Pads are typically created from a #GstPadTemplate with * Pads are typically created from a #GstPadTemplate with
* gst_pad_new_from_template(). * gst_pad_new_from_template().
* *
* Pads have #GstCaps attached to it to describe the media type they are capable * Pads have #GstCaps attached to it to describe the media type they are capable
* of dealing with. * of dealing with.
* gst_pad_get_caps() and gst_pad_try_set_caps() are used to manipulate the caps * gst_pad_get_caps() and gst_pad_try_set_caps() are used to manipulate the caps
* of the pads. * of the pads.
* Pads created from a pad template cannot set capabilities that are * Pads created from a pad template cannot set capabilities that are
* incompatible with the pad template capabilities. * incompatible with the pad template capabilities.
* *
* Pads without pad templates can be created with gst_pad_new(), * Pads without pad templates can be created with gst_pad_new(),
@ -47,11 +47,11 @@
* *
* gst_pad_get_parent() will retrieve the #GstElement that owns the pad. * gst_pad_get_parent() will retrieve the #GstElement that owns the pad.
* *
* A #GstElement creating a pad will typically use the various * A #GstElement creating a pad will typically use the various
* gst_pad_set_*_function() calls to register callbacks for various events * gst_pad_set_*_function() calls to register callbacks for various events
* on the pads. * on the pads.
* *
* GstElements will use gst_pad_push() and gst_pad_pull() to push out * GstElements will use gst_pad_push() and gst_pad_pull() to push out
* or pull in a buffer. * or pull in a buffer.
* gst_pad_select() and gst_pad_selectv() are used by plugins to wait for the * gst_pad_select() and gst_pad_selectv() are used by plugins to wait for the
* first incoming buffer or event on any of the given set of pads. * first incoming buffer or event on any of the given set of pads.
@ -454,7 +454,7 @@ gst_pad_get_property (GObject * object, guint prop_id,
* @direction: the #GstPadDirection of the pad. * @direction: the #GstPadDirection of the pad.
* *
* Creates a new pad with the given name in the given direction. * Creates a new pad with the given name in the given direction.
* If name is NULL, a guaranteed unique name (across all pads) * If name is NULL, a guaranteed unique name (across all pads)
* will be assigned. * will be assigned.
* This function makes a copy of the name so you can safely free the name. * This function makes a copy of the name so you can safely free the name.
* *
@ -475,7 +475,7 @@ gst_pad_new (const gchar * name, GstPadDirection direction)
* @name: the name of the element * @name: the name of the element
* *
* Creates a new pad with the given name from the given template. * Creates a new pad with the given name from the given template.
* If name is NULL, a guaranteed unique name (across all pads) * If name is NULL, a guaranteed unique name (across all pads)
* will be assigned. * will be assigned.
* This function makes a copy of the name so you can safely free the name. * This function makes a copy of the name so you can safely free the name.
* *
@ -495,7 +495,7 @@ gst_pad_new_from_template (GstPadTemplate * templ, const gchar * name)
* @pad: a #GstPad to get the direction of. * @pad: a #GstPad to get the direction of.
* *
* Gets the direction of the pad. The direction of the pad is * Gets the direction of the pad. The direction of the pad is
* decided at construction time so this function does not take * decided at construction time so this function does not take
* the LOCK. * the LOCK.
* *
* Returns: the #GstPadDirection of the pad. * Returns: the #GstPadDirection of the pad.
@ -912,7 +912,7 @@ had_right_state:
* callback. * callback.
* *
* Returns: TRUE if the pad could be blocked. This function can fail * Returns: TRUE if the pad could be blocked. This function can fail
* wrong parameters were passed or the pad was already in the * wrong parameters were passed or the pad was already in the
* requested state. * requested state.
* *
* MT safe. * MT safe.
@ -925,7 +925,7 @@ gst_pad_set_blocked (GstPad * pad, gboolean blocked)
/** /**
* gst_pad_is_blocked: * gst_pad_is_blocked:
* @pad: the #GstPad to query * @pad: the #GstPad to query
* *
* Checks if the pad is blocked or not. This function returns the * Checks if the pad is blocked or not. This function returns the
* last requested state of the pad. It is not certain that the pad * last requested state of the pad. It is not certain that the pad
@ -1204,14 +1204,14 @@ gst_pad_set_internal_link_function (GstPad * pad, GstPadIntLinkFunction intlink)
* gst_pad_set_link_function: * gst_pad_set_link_function:
* @pad: a #GstPad. * @pad: a #GstPad.
* @link: the #GstPadLinkFunction to set. * @link: the #GstPadLinkFunction to set.
* *
* Sets the given link function for the pad. It will be called when the pad is * Sets the given link function for the pad. It will be called when the pad is
* linked or relinked with caps. The caps passed to the link function is * linked or relinked with caps. The caps passed to the link function is
* the caps for the connnection. It can contain a non fixed caps. * the caps for the connnection. It can contain a non fixed caps.
* *
* The return value GST_PAD_LINK_OK should be used when the connection can be * The return value GST_PAD_LINK_OK should be used when the connection can be
* made. * made.
* *
* The return value GST_PAD_LINK_REFUSED should be used when the connection * The return value GST_PAD_LINK_REFUSED should be used when the connection
* cannot be made for some reason. * cannot be made for some reason.
*/ */
@ -1247,7 +1247,7 @@ gst_pad_set_unlink_function (GstPad * pad, GstPadUnlinkFunction unlink)
* gst_pad_set_getcaps_function: * gst_pad_set_getcaps_function:
* @pad: a #GstPad. * @pad: a #GstPad.
* @getcaps: the #GstPadGetCapsFunction to set. * @getcaps: the #GstPadGetCapsFunction to set.
* *
* Sets the given getcaps function for the pad. @getcaps should return the * Sets the given getcaps function for the pad. @getcaps should return the
* allowable caps for a pad in the context of the element's state, its link to * allowable caps for a pad in the context of the element's state, its link to
* other elements, and the devices or files it has opened. These caps must be a * other elements, and the devices or files it has opened. These caps must be a
@ -1257,14 +1257,14 @@ gst_pad_set_unlink_function (GstPad * pad, GstPadUnlinkFunction unlink)
* but this is discouraged. * but this is discouraged.
* *
* You do not need to call this function if @pad's allowed caps are always the * You do not need to call this function if @pad's allowed caps are always the
* same as the pad template caps. This can only be true if the padtemplate * same as the pad template caps. This can only be true if the padtemplate
* has fixed simple caps. * has fixed simple caps.
* *
* For most filters, the caps returned by @getcaps is directly affected by the * For most filters, the caps returned by @getcaps is directly affected by the
* allowed caps on other pads. For demuxers and decoders, the caps returned by * allowed caps on other pads. For demuxers and decoders, the caps returned by
* the srcpad's getcaps function is directly related to the stream data. Again, * the srcpad's getcaps function is directly related to the stream data. Again,
* @getcaps should return the most specific caps it reasonably can, since this * @getcaps should return the most specific caps it reasonably can, since this
* helps with autoplugging. * helps with autoplugging.
* *
* Note that the return value from @getcaps is owned by the caller, so the caller * Note that the return value from @getcaps is owned by the caller, so the caller
* should unref the caps after usage. * should unref the caps after usage.
@ -1409,7 +1409,7 @@ gst_pad_unlink (GstPad * srcpad, GstPad * sinkpad)
GST_UNLOCK (sinkpad); GST_UNLOCK (sinkpad);
GST_UNLOCK (srcpad); GST_UNLOCK (srcpad);
/* fire off a signal to each of the pads telling them /* fire off a signal to each of the pads telling them
* that they've been unlinked */ * that they've been unlinked */
g_signal_emit (G_OBJECT (srcpad), gst_pad_signals[PAD_UNLINKED], 0, sinkpad); g_signal_emit (G_OBJECT (srcpad), gst_pad_signals[PAD_UNLINKED], 0, sinkpad);
g_signal_emit (G_OBJECT (sinkpad), gst_pad_signals[PAD_UNLINKED], 0, srcpad); g_signal_emit (G_OBJECT (sinkpad), gst_pad_signals[PAD_UNLINKED], 0, srcpad);
@ -1872,7 +1872,7 @@ was_dispatching:
* *
* Gets the capabilities of the peer connected to this pad. * Gets the capabilities of the peer connected to this pad.
* *
* Returns: the #GstCaps of the peer pad. This function returns a new caps, so use * Returns: the #GstCaps of the peer pad. This function returns a new caps, so use
* gst_caps_unref to get rid of it. this function returns NULL if there is no * gst_caps_unref to get rid of it. this function returns NULL if there is no
* peer pad or when this function is called recursively from a getcaps function. * peer pad or when this function is called recursively from a getcaps function.
*/ */
@ -2704,9 +2704,9 @@ gst_pad_event_default (GstPad * pad, GstEvent * event)
* @dispatch: the #GstDispatcherFunction to call. * @dispatch: the #GstDispatcherFunction to call.
* @data: gpointer user data passed to the dispatcher function. * @data: gpointer user data passed to the dispatcher function.
* *
* Invokes the given dispatcher function on all pads that are * Invokes the given dispatcher function on all pads that are
* internally linked to the given pad. * internally linked to the given pad.
* The GstPadDispatcherFunction should return TRUE when no further pads * The GstPadDispatcherFunction should return TRUE when no further pads
* need to be processed. * need to be processed.
* *
* Returns: TRUE if one of the dispatcher functions returned TRUE. * Returns: TRUE if one of the dispatcher functions returned TRUE.
@ -2932,8 +2932,8 @@ gst_ghost_pad_save_thyself (GstPad * pad, xmlNodePtr parent)
#endif /* 0 */ #endif /* 0 */
#endif /* GST_DISABLE_LOADSAVE */ #endif /* GST_DISABLE_LOADSAVE */
/* /*
* should be called with pad lock held * should be called with pad lock held
* *
* MT safe. * MT safe.
*/ */
@ -3205,7 +3205,7 @@ not_linked:
* *
* Checks if a #gst_pad_pull_range() can be performed on the peer * Checks if a #gst_pad_pull_range() can be performed on the peer
* source pad. This function is used by plugins that want to check * source pad. This function is used by plugins that want to check
* if they can use random access on the peer source pad. * if they can use random access on the peer source pad.
* *
* The peer sourcepad can implement a custom #GstPadCheckGetRangeFunction * The peer sourcepad can implement a custom #GstPadCheckGetRangeFunction
* if it needs to perform some logic to determine if pull_range is * if it needs to perform some logic to determine if pull_range is
@ -3272,7 +3272,7 @@ not_connected:
* @size: The length of the buffer * @size: The length of the buffer
* @buffer: a pointer to hold the #GstBuffer. * @buffer: a pointer to hold the #GstBuffer.
* *
* Calls the getrange function of @pad. * Calls the getrange function of @pad.
* *
* Returns: a #GstFlowReturn from the pad. * Returns: a #GstFlowReturn from the pad.
* *
@ -3585,7 +3585,7 @@ dropping:
* @pad: the #GstPad to set the private data of. * @pad: the #GstPad to set the private data of.
* @priv: The private data to attach to the pad. * @priv: The private data to attach to the pad.
* *
* Set the given private data gpointer on the pad. * Set the given private data gpointer on the pad.
* This function can only be used by the element that owns the pad. * This function can only be used by the element that owns the pad.
*/ */
void void
@ -3619,7 +3619,7 @@ gst_pad_get_element_private (GstPad * pad)
* dataflow. This function will automatically acauire the STREAM_LOCK of * dataflow. This function will automatically acauire the STREAM_LOCK of
* the pad before calling @func. * the pad before calling @func.
* *
* Returns: a TRUE if the task could be started. * Returns: a TRUE if the task could be started.
*/ */
gboolean gboolean
gst_pad_start_task (GstPad * pad, GstTaskFunction func, gpointer data) gst_pad_start_task (GstPad * pad, GstTaskFunction func, gpointer data)
@ -3646,7 +3646,7 @@ gst_pad_start_task (GstPad * pad, GstTaskFunction func, gpointer data)
* gst_pad_pause_task: * gst_pad_pause_task:
* @pad: the #GstPad to pause the task of * @pad: the #GstPad to pause the task of
* *
* Pause the task of @pad. This function will also make sure that the * Pause the task of @pad. This function will also make sure that the
* function executed by the task will effectively stop. * function executed by the task will effectively stop.
* *
* Returns: a TRUE if the task could be paused or FALSE when the pad * Returns: a TRUE if the task could be paused or FALSE when the pad
@ -3684,7 +3684,7 @@ no_task:
* gst_pad_stop_task: * gst_pad_stop_task:
* @pad: the #GstPad to stop the task of * @pad: the #GstPad to stop the task of
* *
* Stop the task of @pad. This function will also make sure that the * Stop the task of @pad. This function will also make sure that the
* function executed by the task will effectively stop if not called * function executed by the task will effectively stop if not called
* from the GstTaskFunction. * from the GstTaskFunction.
* *

6
gst/gstpad.h
View file

@ -144,7 +144,7 @@ typedef gboolean (*GstPadActivateModeFunction) (GstPad *pad, gboolean active);
* GstPadChainFunction: * GstPadChainFunction:
* @pad: the #GstPad that performed the chain. * @pad: the #GstPad that performed the chain.
* @buffer: the #GstBuffer that is chained. * @buffer: the #GstBuffer that is chained.
* *
* A function that will be called when chaining buffers. * A function that will be called when chaining buffers.
* *
* Returns: GST_FLOW_OK for success * Returns: GST_FLOW_OK for success
@ -201,7 +201,7 @@ typedef const GstQueryType* (*GstPadQueryTypeFunction) (GstPad *pad);
* @query: the #GstQuery object to execute * @query: the #GstQuery object to execute
* *
* The signature of the query function. * The signature of the query function.
* *
* Returns: TRUE if the query could be performed. * Returns: TRUE if the query could be performed.
*/ */
typedef gboolean (*GstPadQueryFunction) (GstPad *pad, GstQuery *query); typedef gboolean (*GstPadQueryFunction) (GstPad *pad, GstQuery *query);
@ -251,7 +251,7 @@ typedef GstFlowReturn (*GstPadBufferAllocFunction) (GstPad *pad, guint64 offset
* @pad: the #GstPad that is dispatched. * @pad: the #GstPad that is dispatched.
* @data: the gpointer to optional user data. * @data: the gpointer to optional user data.
* *
* A dispatcher function is called for all internally linked pads, see * A dispatcher function is called for all internally linked pads, see
* gst_pad_dispatcher(). * gst_pad_dispatcher().
* *
* Returns: TRUE if the dispatching procedure has to be stopped. * Returns: TRUE if the dispatching procedure has to be stopped.

30
gst/gstpadtemplate.c
View file

@ -25,17 +25,17 @@
* @see_also: #GstPad, #GstElementFactory * @see_also: #GstPad, #GstElementFactory
* *
* Padtemplates describe the possible media types a pad or an elementfactory can * Padtemplates describe the possible media types a pad or an elementfactory can
* handle. * handle.
* *
* Pad and PadTemplates have #GstCaps attached to it to describe the media type they * Pad and PadTemplates have #GstCaps attached to it to describe the media type they
* are capable of dealing with. gst_pad_template_get_caps() is used to get the * are capable of dealing with. gst_pad_template_get_caps() is used to get the
* caps of a padtemplate. It's not possible to modify the caps of a padtemplate after * caps of a padtemplate. It's not possible to modify the caps of a padtemplate after
* creation. * creation.
* *
* Padtemplates can be created with gst_pad_template_new() or with the convenient * Padtemplates can be created with gst_pad_template_new() or with the convenient
* GST_PAD_TEMPLATE_FACTORY() macro. A padtemplate can be used to create a pad or * GST_PAD_TEMPLATE_FACTORY() macro. A padtemplate can be used to create a pad or
* to add to an elementfactory. * to add to an elementfactory.
* *
* The following code example shows the code to create a pad from a padtemplate. * The following code example shows the code to create a pad from a padtemplate.
* <example> * <example>
* <title>Create a pad from a padtemplate</title> * <title>Create a pad from a padtemplate</title>
@ -50,18 +50,18 @@
* "channels = (int) [ 1, 6 ]" * "channels = (int) [ 1, 6 ]"
* ) * )
* ) * )
* *
* void * void
* my_method (void) * my_method (void)
* { * {
* GstPad *pad; * GstPad *pad;
* *
* pad = gst_pad_new_from_template (GST_PAD_TEMPLATE_GET (my_template_factory), "sink"); * pad = gst_pad_new_from_template (GST_PAD_TEMPLATE_GET (my_template_factory), "sink");
* ... * ...
* } * }
* </programlisting> * </programlisting>
* </example> * </example>
* *
* The following example shows you how to add the padtemplate to an elementfactory: * The following example shows you how to add the padtemplate to an elementfactory:
* <informalexample> * <informalexample>
* <programlisting> * <programlisting>
@ -69,14 +69,14 @@
* my_factory_init (GstPlugin *plugin) * my_factory_init (GstPlugin *plugin)
* { * {
* GstElementFactory *factory; * GstElementFactory *factory;
* *
* factory = gst_element_factory_new ("my_factory", GST_TYPE_MYFACTORY, &amp;gst_myfactory_details); * factory = gst_element_factory_new ("my_factory", GST_TYPE_MYFACTORY, &amp;gst_myfactory_details);
* g_return_val_if_fail (factory != NULL, FALSE); * g_return_val_if_fail (factory != NULL, FALSE);
* *
* gst_element_factory_add_pad_template (factory, GST_PAD_TEMPLATE_GET (my_template_factory)); * gst_element_factory_add_pad_template (factory, GST_PAD_TEMPLATE_GET (my_template_factory));
* *
* gst_plugin_add_feature (plugin, GST_PLUGIN_FEATURE (factory)); * gst_plugin_add_feature (plugin, GST_PLUGIN_FEATURE (factory));
* *
* return TRUE; * return TRUE;
* } * }
* </programlisting> * </programlisting>
@ -294,7 +294,7 @@ gst_pad_template_new (const gchar * name_template,
* *
* Gets the capabilities of the static pad template. * Gets the capabilities of the static pad template.
* *
* Returns: the #GstCaps of the static pad template. If you need to keep a * Returns: the #GstCaps of the static pad template. If you need to keep a
* reference to the caps, take a ref (see gst_caps_ref ()). * reference to the caps, take a ref (see gst_caps_ref ()).
*/ */
GstCaps * GstCaps *

2
gst/gstpadtemplate.h
View file

@ -50,7 +50,7 @@ typedef struct _GstStaticPadTemplate GstStaticPadTemplate;
* GstPadPresence: * GstPadPresence:
* @GST_PAD_ALWAYS: the pad is always available * @GST_PAD_ALWAYS: the pad is always available
* @GST_PAD_SOMETIMES: the pad will become available depending on the media stream * @GST_PAD_SOMETIMES: the pad will become available depending on the media stream
* @GST_PAD_REQUEST: the pad is only available on request with * @GST_PAD_REQUEST: the pad is only available on request with
* gst_element_request_pad_by_name() or gst_element_request_compatible_pad(). * gst_element_request_pad_by_name() or gst_element_request_compatible_pad().
* *
* Indicates when this pad will become available. * Indicates when this pad will become available.

2
gst/gstpipeline.c
View file

@ -35,7 +35,7 @@
* pipeline is properly PAUSED and resumed as well as update the new stream time * pipeline is properly PAUSED and resumed as well as update the new stream time
* after the seek. * after the seek.
* *
* gst_pipeline_new() is used to create a pipeline. when you are done with * gst_pipeline_new() is used to create a pipeline. when you are done with
* the pipeline, use gst_object_unref() to free its resources including all * the pipeline, use gst_object_unref() to free its resources including all
* added #GstElement objects (if not otherwiese referenced). * added #GstElement objects (if not otherwiese referenced).
*/ */

20
gst/gstplugin.c
View file

@ -38,9 +38,9 @@
* *
* Use gst_plugin_find_feature() and gst_plugin_get_feature_list() to find features in a plugin. * Use gst_plugin_find_feature() and gst_plugin_get_feature_list() to find features in a plugin.
* *
* Usually plugins are always automaticlly loaded so you don't need to call gst_plugin_load() explicitly * Usually plugins are always automaticlly loaded so you don't need to call gst_plugin_load() explicitly
* to bring it into memory. There are options to statically link plugins to an app or even * to bring it into memory. There are options to statically link plugins to an app or even
* use GStreamer without a plugin repository in which case gst_plugin_load() can be needed * use GStreamer without a plugin repository in which case gst_plugin_load() can be needed
* to bring the plugin into memory. * to bring the plugin into memory.
*/ */
@ -82,8 +82,8 @@ static gboolean _gst_plugin_fault_handler_is_setup = FALSE;
#endif #endif
/* list of valid licenses. /* list of valid licenses.
* One of these must be specified or the plugin won't be loaded * One of these must be specified or the plugin won't be loaded
* Contact gstreamer-devel@lists.sourceforge.net if your license should be * Contact gstreamer-devel@lists.sourceforge.net if your license should be
* added. * added.
* *
* GPL: http://www.gnu.org/copyleft/gpl.html * GPL: http://www.gnu.org/copyleft/gpl.html
@ -155,7 +155,7 @@ gst_plugin_error_quark (void)
} }
/* this function can be called in the GCC constructor extension, before /* this function can be called in the GCC constructor extension, before
* the _gst_plugin_initialize() was called. In that case, we store the * the _gst_plugin_initialize() was called. In that case, we store the
* plugin description in a list to initialize it when we open the main * plugin description in a list to initialize it when we open the main
* module later on. * module later on.
* When the main module is known, we can register the plugin right away. * When the main module is known, we can register the plugin right away.
@ -192,7 +192,7 @@ _gst_plugin_initialize (void)
NULL); NULL);
} }
/* this function could be extended to check if the plugin license matches the /* this function could be extended to check if the plugin license matches the
* applications license (would require the app to register its license somehow). * applications license (would require the app to register its license somehow).
* We'll wait for someone who's interested in it to code it :) * We'll wait for someone who's interested in it to code it :)
*/ */
@ -632,10 +632,10 @@ gst_plugin_get_origin (GstPlugin * plugin)
* gst_plugin_get_module: * gst_plugin_get_module:
* @plugin: plugin to query * @plugin: plugin to query
* *
* Gets the #GModule of the plugin. If the plugin isn't loaded yet, NULL is * Gets the #GModule of the plugin. If the plugin isn't loaded yet, NULL is
* returned. * returned.
* *
* Returns: module belonging to the plugin or NULL if the plugin isn't * Returns: module belonging to the plugin or NULL if the plugin isn't
* loaded yet. * loaded yet.
*/ */
GModule * GModule *
@ -882,11 +882,11 @@ gst_plugin_load_by_name (const gchar * name)
* *
* Loads @plugin. Note that the *return value* is the loaded plugin; @plugin is * Loads @plugin. Note that the *return value* is the loaded plugin; @plugin is
* untouched. The normal use pattern of this function goes like this: * untouched. The normal use pattern of this function goes like this:
* *
* <programlisting> * <programlisting>
* GstPlugin *loaded_plugin; * GstPlugin *loaded_plugin;
* loaded_plugin = gst_plugin_load (plugin); * loaded_plugin = gst_plugin_load (plugin);
* *
* // presumably, we're no longer interested in the potentially-unloaded plugin * // presumably, we're no longer interested in the potentially-unloaded plugin
* gst_object_unref (plugin); * gst_object_unref (plugin);
* plugin = loaded_plugin; * plugin = loaded_plugin;

4
gst/gstplugin.h
View file

@ -82,7 +82,7 @@ typedef enum
* plugin_desc struct. * plugin_desc struct.
* This function will be called by the loader at startup. * This function will be called by the loader at startup.
* *
* Returns: %TRUE if plugin initialised successfully * Returns: %TRUE if plugin initialised successfully
*/ */
typedef gboolean (*GstPluginInitFunc) (GstPlugin *plugin); typedef gboolean (*GstPluginInitFunc) (GstPlugin *plugin);
@ -99,7 +99,7 @@ typedef gboolean (*GstPluginInitFunc) (GstPlugin *plugin);
* @package: shipped package plugin belongs to * @package: shipped package plugin belongs to
* @origin: URL to provider of plugin * @origin: URL to provider of plugin
* @_gst_reserved: private, for later expansion * @_gst_reserved: private, for later expansion
* *
* *
* A plugins should export a variable of this type called plugin_desc. This plugin * A plugins should export a variable of this type called plugin_desc. This plugin
* loaded will use this variable to initialize the plugin. * loaded will use this variable to initialize the plugin.

2
gst/gstpluginfeature.c
View file

@ -147,7 +147,7 @@ gst_plugin_feature_type_name_filter (GstPluginFeature * feature,
* @name: the name to set * @name: the name to set
* *
* Sets the name of a plugin feature. The name uniquely identifies a feature * Sets the name of a plugin feature. The name uniquely identifies a feature
* within all features of the same type. Renaming a plugin feature is not * within all features of the same type. Renaming a plugin feature is not
* allowed. A copy is made of the name so you should free the supplied @name * allowed. A copy is made of the name so you should free the supplied @name
* after calling this function. * after calling this function.
*/ */

4
gst/gstquery.c
View file

@ -26,7 +26,7 @@
* @see_also: #GstPad, #GstElement * @see_also: #GstPad, #GstElement
* *
* GstQuery functions are used to register a new query types to the gstreamer * GstQuery functions are used to register a new query types to the gstreamer
* core. * core.
* Query types can be used to perform queries on pads and elements. * Query types can be used to perform queries on pads and elements.
* *
* Query answer can be parsed using gst_query_parse_xxx() helpers. * Query answer can be parsed using gst_query_parse_xxx() helpers.
@ -212,7 +212,7 @@ gst_query_type_register (const gchar * nick, const gchar * description)
* gst_query_type_get_by_nick: * gst_query_type_get_by_nick:
* @nick: The nick of the query * @nick: The nick of the query
* *
* Return the query registered with the given nick. * Return the query registered with the given nick.
* *
* Returns: The query with @nick or GST_QUERY_NONE * Returns: The query with @nick or GST_QUERY_NONE
* if the query was not registered. * if the query was not registered.

8
gst/gstquery.h
View file

@ -103,14 +103,14 @@ struct _GstQuery
GstQueryType type; GstQueryType type;
GstStructure *structure; GstStructure *structure;
/*< private > */ /*< private > */
gpointer _gst_reserved[GST_PADDING]; gpointer _gst_reserved[GST_PADDING];
}; };
struct _GstQueryClass { struct _GstQueryClass {
GstMiniObjectClass mini_object_class; GstMiniObjectClass mini_object_class;
/*< private > */ /*< private > */
gpointer _gst_reserved[GST_PADDING]; gpointer _gst_reserved[GST_PADDING];
}; };
@ -119,7 +119,7 @@ void _gst_query_initialize (void);
GType gst_query_get_type (void); GType gst_query_get_type (void);
/* register a new query */ /* register a new query */
GstQueryType gst_query_type_register (const gchar *nick, GstQueryType gst_query_type_register (const gchar *nick,
const gchar *description); const gchar *description);
GstQueryType gst_query_type_get_by_nick (const gchar *nick); GstQueryType gst_query_type_get_by_nick (const gchar *nick);
@ -129,7 +129,7 @@ gboolean gst_query_types_contains (const GstQueryType *types,
/* query for query details */ /* query for query details */
G_CONST_RETURN GstQueryTypeDefinition* G_CONST_RETURN GstQueryTypeDefinition*
gst_query_type_get_details (GstQueryType type); gst_query_type_get_details (GstQueryType type);
GstIterator* gst_query_type_iterate_definitions (void); GstIterator* gst_query_type_iterate_definitions (void);

8
gst/gstqueue.c
View file

@ -28,11 +28,11 @@
* Data is queued till max_level buffers have been stored. Any subsequent * Data is queued till max_level buffers have been stored. Any subsequent
* buffers sent to this filter will block until free space becomes available in * buffers sent to this filter will block until free space becomes available in
* the buffer. The queue is typically used in conjunction with a thread. * the buffer. The queue is typically used in conjunction with a thread.
* *
* You can query how many buffers are queued with the level argument. * You can query how many buffers are queued with the level argument.
* *
* The default queue length is set to 100. * The default queue length is set to 100.
* *
* The queue blocks by default. * The queue blocks by default.
*/ */
@ -776,7 +776,7 @@ restart:
g_thread_self ()); g_thread_self ());
g_cond_wait (queue->item_add, queue->qlock); g_cond_wait (queue->item_add, queue->qlock);
/* we released the lock in the g_cond above so we might be /* we released the lock in the g_cond above so we might be
* flushing now */ * flushing now */
if (queue->srcresult != GST_FLOW_OK) if (queue->srcresult != GST_FLOW_OK)
goto out_flushing; goto out_flushing;

2
gst/gstqueue.h
View file

@ -2,7 +2,7 @@
* Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu> * Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
* 2000 Wim Taymans <wtay@chello.be> * 2000 Wim Taymans <wtay@chello.be>
* *
* gstqueue.h: * gstqueue.h:
* *
* This library is free software; you can redistribute it and/or * This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public * modify it under the terms of the GNU Library General Public

10
gst/gstregistry.h
View file

@ -79,12 +79,12 @@ gboolean gst_registry_add_feature (GstRegistry * registry,
void gst_registry_remove_feature (GstRegistry * registry, GstPluginFeature * feature); void gst_registry_remove_feature (GstRegistry * registry, GstPluginFeature * feature);
GList* gst_registry_get_plugin_list (GstRegistry *registry); GList* gst_registry_get_plugin_list (GstRegistry *registry);
GList* gst_registry_plugin_filter (GstRegistry *registry, GList* gst_registry_plugin_filter (GstRegistry *registry,
GstPluginFilter filter, GstPluginFilter filter,
gboolean first, gboolean first,
gpointer user_data); gpointer user_data);
GList* gst_registry_feature_filter (GstRegistry *registry, GList* gst_registry_feature_filter (GstRegistry *registry,
GstPluginFeatureFilter filter, GstPluginFeatureFilter filter,
gboolean first, gboolean first,
gpointer user_data); gpointer user_data);
GList * gst_registry_get_feature_list (GstRegistry *registry, GList * gst_registry_get_feature_list (GstRegistry *registry,

4
gst/gstregistryxml.c
View file

@ -140,7 +140,7 @@ gst_registry_xml_get_perms_func (GstRegistry * registry)
/* if the dir does not exist, make it. if that can't be done, flags = 0x0. /* if the dir does not exist, make it. if that can't be done, flags = 0x0.
if the file can be appended to, it's writable. if it can then be read, if the file can be appended to, it's writable. if it can then be read,
it's readable. it's readable.
After that check if it exists. */ After that check if it exists. */
if (make_dir (registry->location) != TRUE) { if (make_dir (registry->location) != TRUE) {
@ -832,7 +832,7 @@ G_STMT_START{ \
static gboolean static gboolean
gst_registry_xml_save_caps (GstRegistry * registry, const GstCaps * caps) gst_registry_xml_save_caps (GstRegistry * registry, const GstCaps * caps)
{ {
/* we copy the caps here so we can simplify them before saving. This is a lot /* we copy the caps here so we can simplify them before saving. This is a lot
* faster when loading them later on */ * faster when loading them later on */
char *s; char *s;
GstCaps *copy = gst_caps_copy (caps); GstCaps *copy = gst_caps_copy (caps);

12
gst/gststructure.c
View file

@ -242,7 +242,7 @@ gst_structure_copy (const GstStructure * structure)
} }
/** /**
* gst_structure_free: * gst_structure_free:
* @structure: the #GstStructure to free * @structure: the #GstStructure to free
* *
* Frees a #GstStructure and all its fields and values. The structure must not * Frees a #GstStructure and all its fields and values. The structure must not
@ -546,7 +546,7 @@ gst_structure_get_value (const GstStructure * structure,
* *
* Accessor function. * Accessor function.
* *
* Returns: the #GValue corresponding to the field with the given name * Returns: the #GValue corresponding to the field with the given name
* identifier. * identifier.
*/ */
const GValue * const GValue *
@ -652,7 +652,7 @@ gst_structure_remove_fields_valist (GstStructure * structure,
* gst_structure_remove_all_fields: * gst_structure_remove_all_fields:
* @structure: a #GstStructure * @structure: a #GstStructure
* *
* Removes all fields in a GstStructure. * Removes all fields in a GstStructure.
*/ */
void void
gst_structure_remove_all_fields (GstStructure * structure) gst_structure_remove_all_fields (GstStructure * structure)
@ -1256,7 +1256,7 @@ gst_structure_value_get_generic_type (GValue * val)
* @structure: a #GstStructure * @structure: a #GstStructure
* *
* Converts @structure to a human-readable representation. * Converts @structure to a human-readable representation.
* *
* Returns: a pointer to string allocated by g_malloc() * Returns: a pointer to string allocated by g_malloc()
*/ */
gchar * gchar *
@ -1294,11 +1294,11 @@ gst_structure_to_string (const GstStructure * structure)
} }
/* /*
* r will still point to the string. if end == next, the string will not be * r will still point to the string. if end == next, the string will not be
* null-terminated. In all other cases it will be. * null-terminated. In all other cases it will be.
* end = pointer to char behind end of string, next = pointer to start of * end = pointer to char behind end of string, next = pointer to start of
* unread data. * unread data.
* THIS FUNCTION MODIFIES THE STRING AND DETECTS INSIDE A NONTERMINATED STRING * THIS FUNCTION MODIFIES THE STRING AND DETECTS INSIDE A NONTERMINATED STRING
*/ */
static gboolean static gboolean
gst_structure_parse_string (gchar * s, gchar ** end, gchar ** next) gst_structure_parse_string (gchar * s, gchar ** end, gchar ** next)

4
gst/gststructure.h
View file

@ -94,10 +94,10 @@ G_CONST_RETURN GValue * gst_structure_get_value (const GstStructure
const gchar *fieldname); const gchar *fieldname);
void gst_structure_remove_field (GstStructure *structure, void gst_structure_remove_field (GstStructure *structure,
const gchar *fieldname); const gchar *fieldname);
void gst_structure_remove_fields (GstStructure *structure, void gst_structure_remove_fields (GstStructure *structure,
const gchar *fieldname, const gchar *fieldname,
...); ...);
void gst_structure_remove_fields_valist (GstStructure *structure, void gst_structure_remove_fields_valist (GstStructure *structure,
const gchar *fieldname, const gchar *fieldname,
va_list varargs); va_list varargs);
void gst_structure_remove_all_fields (GstStructure *structure); void gst_structure_remove_all_fields (GstStructure *structure);

10
gst/gstsystemclock.c
View file

@ -210,13 +210,13 @@ gst_system_clock_obtain (void)
return clock; return clock;
} }
/* this thread reads the sorted clock entries from the queue. /* this thread reads the sorted clock entries from the queue.
* *
* It waits on each of them and fires the callback when the timeout occurs. * It waits on each of them and fires the callback when the timeout occurs.
* *
* When an entry in the queue was canceled, it is simply skipped. * When an entry in the queue was canceled, it is simply skipped.
* *
* When waiting for an entry, it can become canceled, in that case we don't * When waiting for an entry, it can become canceled, in that case we don't
* call the callback but move to the next item in the queue. * call the callback but move to the next item in the queue.
* *
* MT safe. * MT safe.
@ -286,7 +286,7 @@ gst_system_clock_async_thread (GstClock * clock)
} }
case GST_CLOCK_BUSY: case GST_CLOCK_BUSY:
/* somebody unlocked the entry but is was not canceled, This means that /* somebody unlocked the entry but is was not canceled, This means that
* either a new entry was added in front of the queue or some other entry * either a new entry was added in front of the queue or some other entry
* was canceled. Whatever it is, pick the head entry of the list and * was canceled. Whatever it is, pick the head entry of the list and
* continue waiting. */ * continue waiting. */
GST_CAT_DEBUG (GST_CAT_CLOCK, "async entry %p needs restart", entry); GST_CAT_DEBUG (GST_CAT_CLOCK, "async entry %p needs restart", entry);
@ -409,7 +409,7 @@ gst_system_clock_id_wait (GstClock * clock, GstClockEntry * entry)
/* Add an entry to the list of pending async waits. The entry is inserted /* Add an entry to the list of pending async waits. The entry is inserted
* in sorted order. If we inserted the entry at the head of the list, we * in sorted order. If we inserted the entry at the head of the list, we
* need to signal the thread as it might either be waiting on it or waiting * need to signal the thread as it might either be waiting on it or waiting
* for a new entry. * for a new entry.
* *
* MT safe. * MT safe.
*/ */
@ -438,7 +438,7 @@ gst_system_clock_id_wait_async (GstClock * clock, GstClockEntry * entry)
} }
/* unschedule an entry. This will set the state of the entry to GST_CLOCK_UNSCHEDULED /* unschedule an entry. This will set the state of the entry to GST_CLOCK_UNSCHEDULED
* and will signal any thread waiting for entries to recheck their entry. * and will signal any thread waiting for entries to recheck their entry.
* We cannot really decide if the signal is needed or not because the entry * We cannot really decide if the signal is needed or not because the entry
* could be waited on in async or sync mode. * could be waited on in async or sync mode.
* *

2
gst/gsttaglist.c
View file

@ -568,7 +568,7 @@ gst_tag_list_copy (const GstTagList * list)
* @list1: first list to merge * @list1: first list to merge
* @list2: second list to merge * @list2: second list to merge
* @mode: the mode to use * @mode: the mode to use
* *
* Merges the two given lists into a new list. If one of the lists is NULL, a * Merges the two given lists into a new list. If one of the lists is NULL, a
* copy of the other is returned. If both lists are NULL, NULL is returned. * copy of the other is returned. If both lists are NULL, NULL is returned.
* *

10
gst/gsttagsetter.c
View file

@ -136,7 +136,7 @@ gst_tag_setter_merge (GstTagSetter * setter, const GstTagList * list,
* @tag: tag to set * @tag: tag to set
* @...: more tag / value pairs to set * @...: more tag / value pairs to set
* *
* Adds the given tag / value pairs on the setter using the given merge mode. * Adds the given tag / value pairs on the setter using the given merge mode.
* The list must be terminated with NULL. * The list must be terminated with NULL.
*/ */
void void
@ -160,7 +160,7 @@ gst_tag_setter_add (GstTagSetter * setter, GstTagMergeMode mode,
* @tag: tag to set * @tag: tag to set
* @...: more tag / GValue pairs to set * @...: more tag / GValue pairs to set
* *
* Adds the given tag / GValue pairs on the setter using the given merge mode. * Adds the given tag / GValue pairs on the setter using the given merge mode.
* The list must be terminated with NULL. * The list must be terminated with NULL.
*/ */
void void
@ -184,7 +184,7 @@ gst_tag_setter_add_values (GstTagSetter * setter, GstTagMergeMode mode,
* @tag: tag to set * @tag: tag to set
* @var_args: tag / value pairs to set * @var_args: tag / value pairs to set
* *
* Adds the given tag / value pairs on the setter using the given merge mode. * Adds the given tag / value pairs on the setter using the given merge mode.
* The list must be terminated with NULL. * The list must be terminated with NULL.
*/ */
void void
@ -210,7 +210,7 @@ gst_tag_setter_add_valist (GstTagSetter * setter, GstTagMergeMode mode,
* @tag: tag to set * @tag: tag to set
* @var_args: tag / GValue pairs to set * @var_args: tag / GValue pairs to set
* *
* Adds the given tag / GValue pairs on the setter using the given merge mode. * Adds the given tag / GValue pairs on the setter using the given merge mode.
* The list must be terminated with NULL. * The list must be terminated with NULL.
*/ */
void void
@ -269,7 +269,7 @@ gst_tag_setter_set_merge_mode (GstTagSetter * setter, GstTagMergeMode mode)
* gst_tag_setter_get_merge_mode: * gst_tag_setter_get_merge_mode:
* @setter: a #GstTagSetter * @setter: a #GstTagSetter
* *
* Queries the mode by which tags inside the setter are overwritten by tags * Queries the mode by which tags inside the setter are overwritten by tags
* from events * from events
* *
* Returns: the merge mode used inside the element. * Returns: the merge mode used inside the element.

4
gst/gsttrace.c
View file

@ -406,8 +406,8 @@ gst_alloc_trace_print (const GstAllocTrace * trace)
/** /**
* gst_alloc_trace_set_flags: * gst_alloc_trace_set_flags:
* @trace: the GstAllocTrace * @trace: the GstAllocTrace
* @flags: flags to set * @flags: flags to set
* *
* Enable the given features on the given GstAllocTrace object. * Enable the given features on the given GstAllocTrace object.
*/ */

12
gst/gsttrace.h
View file

@ -63,7 +63,7 @@ void gst_trace_text_flush (GstTrace *trace);
#define gst_trace_get_remaining(trace) ((trace)->bufsize - (trace)->bufoffset) #define gst_trace_get_remaining(trace) ((trace)->bufsize - (trace)->bufoffset)
void gst_trace_set_default (GstTrace *trace); void gst_trace_set_default (GstTrace *trace);
void _gst_trace_add_entry (GstTrace *trace, guint32 seq, void _gst_trace_add_entry (GstTrace *trace, guint32 seq,
guint32 data, gchar *msg); guint32 data, gchar *msg);
void gst_trace_read_tsc (gint64 *dst); void gst_trace_read_tsc (gint64 *dst);
@ -171,7 +171,7 @@ extern gint _gst_trace_on;
#else /* GST_DISABLE_TRACE */ #else /* GST_DISABLE_TRACE */
#if defined _GNUC_ && _GNUC_ >= 3 #if defined _GNUC_ && _GNUC_ >= 3
#pragma GCC poison gst_trace_new #pragma GCC poison gst_trace_new
#pragma GCC poison gst_trace_destroy #pragma GCC poison gst_trace_destroy
#pragma GCC poison gst_trace_flush #pragma GCC poison gst_trace_flush
#pragma GCC poison gst_trace_text_flush #pragma GCC poison gst_trace_text_flush
@ -185,16 +185,16 @@ extern gint _gst_trace_on;
#endif #endif
#define gst_alloc_trace_register(name) #define gst_alloc_trace_register(name)
#define gst_alloc_trace_new(trace, mem) #define gst_alloc_trace_new(trace, mem)
#define gst_alloc_trace_free(trace, mem) #define gst_alloc_trace_free(trace, mem)
#define gst_alloc_trace_available() (FALSE) #define gst_alloc_trace_available() (FALSE)
#define gst_alloc_trace_list() (NULL) #define gst_alloc_trace_list() (NULL)
#define _gst_alloc_trace_register(name) (NULL) #define _gst_alloc_trace_register(name) (NULL)
#define gst_alloc_trace_print_all() #define gst_alloc_trace_print_all()
#define gst_alloc_trace_set_flags_all(flags) #define gst_alloc_trace_set_flags_all(flags)
#define gst_alloc_trace_get(name) (NULL) #define gst_alloc_trace_get(name) (NULL)
#define gst_alloc_trace_print(trace) #define gst_alloc_trace_print(trace)
#define gst_alloc_trace_set_flags(trace,flags) #define gst_alloc_trace_set_flags(trace,flags)

10
gst/gsttypefind.c
View file

@ -41,10 +41,10 @@ GST_DEBUG_CATEGORY_EXTERN (gst_type_find_debug);
* @func: the function to use for typefinding * @func: the function to use for typefinding
* @extensions: optional extensions that could belong to this type * @extensions: optional extensions that could belong to this type
* @possible_caps: optionally the caps that could be returned when typefinding succeeds * @possible_caps: optionally the caps that could be returned when typefinding succeeds
* @data: optional user data. This user data must be available until the plugin * @data: optional user data. This user data must be available until the plugin
* is unloaded. * is unloaded.
* *
* Registers a new typefind function to be used for typefinding. After * Registers a new typefind function to be used for typefinding. After
* registering this function will be available for typefinding. * registering this function will be available for typefinding.
* This function is typically called during an element's plugin initialization. * This function is typically called during an element's plugin initialization.
* *
@ -93,9 +93,9 @@ gst_type_find_register (GstPlugin * plugin, const gchar * name, guint rank,
* @offset: the offset * @offset: the offset
* @size: the number of bytes to return * @size: the number of bytes to return
* *
* Returns size bytes of the stream to identify beginning at offset. If offset * Returns size bytes of the stream to identify beginning at offset. If offset
* is a positive number, the offset is relative to the beginning of the stream, * is a positive number, the offset is relative to the beginning of the stream,
* if offset is a negative number the offset is relative to the end of the * if offset is a negative number the offset is relative to the end of the
* stream. The returned memory is valid until the typefinding function returns * stream. The returned memory is valid until the typefinding function returns
* and must not be freed. * and must not be freed.
* If NULL is returned, that data is not available. * If NULL is returned, that data is not available.
@ -138,7 +138,7 @@ gst_type_find_suggest (GstTypeFind * find, guint probability,
* @find: the find object the function was called with * @find: the find object the function was called with
* *
* Get the length of the data stream. * Get the length of the data stream.
* *
* Returns: the length of the data stream or 0 if it is not available. * Returns: the length of the data stream or 0 if it is not available.
*/ */
guint64 guint64

8
gst/gsttypefind.h
View file

@ -54,9 +54,9 @@ struct _GstTypeFind {
void (* suggest) (gpointer data, void (* suggest) (gpointer data,
guint probability, guint probability,
const GstCaps * caps); const GstCaps * caps);
gpointer data; gpointer data;
/* optional */ /* optional */
guint64 (* get_length) (gpointer data); guint64 (* get_length) (gpointer data);
@ -75,12 +75,12 @@ guint64 gst_type_find_get_length (GstTypeFind * find);
/* registration interface */ /* registration interface */
gboolean gst_type_find_register (GstPlugin * plugin, gboolean gst_type_find_register (GstPlugin * plugin,
const gchar * name, const gchar * name,
guint rank, guint rank,
GstTypeFindFunction func, GstTypeFindFunction func,
gchar ** extensions, gchar ** extensions,
const GstCaps * possible_caps, const GstCaps * possible_caps,
gpointer data); gpointer data);
G_END_DECLS G_END_DECLS

12
gst/gsttypefindfactory.c
View file

@ -22,7 +22,7 @@
* SECTION:gsttypefindfactory * SECTION:gsttypefindfactory
* @short_description: Information about registered typefind functions * @short_description: Information about registered typefind functions
* *
* These functions allow querying informations about registered typefind * These functions allow querying informations about registered typefind
* functions. How to create and register these functions is described in * functions. How to create and register these functions is described in
* the section <link linkend="gstreamer-Writing-typefind-functions"> * the section <link linkend="gstreamer-Writing-typefind-functions">
* "Writing typefind functions"</link>. * "Writing typefind functions"</link>.
@ -60,7 +60,7 @@
* GList *walk, *type_list; * GList *walk, *type_list;
* MyTypeFind find = {data, size, 0, NULL}; * MyTypeFind find = {data, size, 0, NULL};
* GstTypeFind gst_find = {my_peek, my_suggest, &amp;find, }; * GstTypeFind gst_find = {my_peek, my_suggest, &amp;find, };
* *
* walk = type_list = gst_type_find_factory_get_list (); * walk = type_list = gst_type_find_factory_get_list ();
* while (walk) { * while (walk) {
* GstTypeFindFactory *factory = GST_TYPE_FIND_FACTORY (walk->data); * GstTypeFindFactory *factory = GST_TYPE_FIND_FACTORY (walk->data);
@ -160,7 +160,7 @@ gst_type_find_factory_dispose (GObject * object)
* *
* Gets the list of all registered typefind factories. You must free the * Gets the list of all registered typefind factories. You must free the
* list using g_list_free. * list using g_list_free.
* *
* Returns: the list of all registered typefind factories * Returns: the list of all registered typefind factories
*/ */
GList * GList *
@ -173,7 +173,7 @@ gst_type_find_factory_get_list (void)
/** /**
* gst_type_find_factory_get_caps: * gst_type_find_factory_get_caps:
* @factory: a factory * @factory: a factory
* *
* Gets the caps associated with a typefind factory. * Gets the caps associated with a typefind factory.
* *
* Returns: the #GstCaps associated with this factory * Returns: the #GstCaps associated with this factory
@ -189,7 +189,7 @@ gst_type_find_factory_get_caps (GstTypeFindFactory * factory)
/** /**
* gst_type_find_factory_get_extensions: * gst_type_find_factory_get_extensions:
* @factory: a factory * @factory: a factory
* *
* Gets the extensions associated with a typefind factory. The returned * Gets the extensions associated with a typefind factory. The returned
* array should not be changed. If you need to change stuff in it, you should * array should not be changed. If you need to change stuff in it, you should
* copy it using g_stdupv(). This function may return NULL to indicate * copy it using g_stdupv(). This function may return NULL to indicate
@ -210,7 +210,7 @@ gst_type_find_factory_get_extensions (GstTypeFindFactory * factory)
* @factory: a factory * @factory: a factory
* @find: a properly setup #GstTypeFind entry. The get_data and suggest_type * @find: a properly setup #GstTypeFind entry. The get_data and suggest_type
* members must be set. * members must be set.
* *
* Calls the typefinding function associated with this factory. * Calls the typefinding function associated with this factory.
*/ */
void void

10
gst/gsttypefindfactory.h
View file

@ -51,23 +51,23 @@ struct _GstTypeFindFactory {
GstTypeFindFunction function; GstTypeFindFunction function;
gchar ** extensions; gchar ** extensions;
GstCaps * caps; /* FIXME: not yet saved in registry */ GstCaps * caps; /* FIXME: not yet saved in registry */
gpointer user_data; gpointer user_data;
gpointer _gst_reserved[GST_PADDING]; gpointer _gst_reserved[GST_PADDING];
}; };
struct _GstTypeFindFactoryClass { struct _GstTypeFindFactoryClass {
GstPluginFeatureClass parent; GstPluginFeatureClass parent;
/* <private> */ /* <private> */
gpointer _gst_reserved[GST_PADDING]; gpointer _gst_reserved[GST_PADDING];
}; };
/* typefinding interface */ /* typefinding interface */
GType gst_type_find_factory_get_type (void); GType gst_type_find_factory_get_type (void);
GList * gst_type_find_factory_get_list (void); GList * gst_type_find_factory_get_list (void);
gchar ** gst_type_find_factory_get_extensions (GstTypeFindFactory *factory); gchar ** gst_type_find_factory_get_extensions (GstTypeFindFactory *factory);

16
gst/gsturi.c
View file

@ -183,7 +183,7 @@ escape_string_internal (const gchar * string, UnsafeCharacterSet mask)
* escape_string: * escape_string:
* @string: string to be escaped * @string: string to be escaped
* *
* Escapes @string, replacing any and all special characters * Escapes @string, replacing any and all special characters
* with equivalent escape sequences. * with equivalent escape sequences.
* *
* Return value: a newly allocated string equivalent to @string * Return value: a newly allocated string equivalent to @string
@ -229,11 +229,11 @@ unescape_character (const char *scanner)
* considered "illegal", '\0' is automatically in this list. * considered "illegal", '\0' is automatically in this list.
* *
* Decodes escaped characters (i.e. PERCENTxx sequences) in @escaped_string. * Decodes escaped characters (i.e. PERCENTxx sequences) in @escaped_string.
* Characters are encoded in PERCENTxy form, where xy is the ASCII hex code * Characters are encoded in PERCENTxy form, where xy is the ASCII hex code
* for character 16x+y. * for character 16x+y.
* *
* Return value: a newly allocated string with the unescaped equivalents, * Return value: a newly allocated string with the unescaped equivalents,
* or %NULL if @escaped_string contained one of the characters * or %NULL if @escaped_string contained one of the characters
* in @illegal_characters. * in @illegal_characters.
**/ **/
static char * static char *
@ -360,7 +360,7 @@ gst_uri_get_protocol (const gchar * uri)
* @uri: URI to get the location from * @uri: URI to get the location from
* *
* Extracts the location out of a given valid URI. So the protocol and "://" * Extracts the location out of a given valid URI. So the protocol and "://"
* are stripped from the URI. The returned string must be freed using * are stripped from the URI. The returned string must be freed using
* g_free(). * g_free().
* *
* Returns: The location for this URI. * Returns: The location for this URI.
@ -457,8 +457,8 @@ sort_by_rank (gconstpointer a, gconstpointer b)
* @uri: URI to create element for * @uri: URI to create element for
* @elementname: optional name of created element * @elementname: optional name of created element
* *
* Creates an element for handling the given URI. * Creates an element for handling the given URI.
* *
* Returns: a new element or NULL if none could be created * Returns: a new element or NULL if none could be created
*/ */
GstElement * GstElement *

4
gst/gstutils.c
View file

@ -1695,7 +1695,7 @@ gst_pad_can_link (GstPad * srcpad, GstPad * sinkpad)
* gst_pad_use_fixed_caps: * gst_pad_use_fixed_caps:
* @pad: the pad to use * @pad: the pad to use
* *
* A helper function you can use that sets the * A helper function you can use that sets the
* @gst_pad_get_fixed_caps_func as the gstcaps function for the * @gst_pad_get_fixed_caps_func as the gstcaps function for the
* pad. This way the function will always return the negotiated caps * pad. This way the function will always return the negotiated caps
* or in case the pad is not negotiated, the padtemplate caps. * or in case the pad is not negotiated, the padtemplate caps.
@ -2306,7 +2306,7 @@ gst_pad_query_position (GstPad * pad, GstFormat * format, gint64 * cur,
* @pad: a #GstPad to invoke the convert query on. * @pad: a #GstPad to invoke the convert query on.
* @src_format: a #GstFormat to convert from. * @src_format: a #GstFormat to convert from.
* @src_val: a value to convert. * @src_val: a value to convert.
* @dest_format: a pointer to the #GstFormat to convert to. * @dest_format: a pointer to the #GstFormat to convert to.
* @dest_val: a pointer to the result. * @dest_val: a pointer to the result.
* *
* Queries a pad to convert @src_val in @src_format to @dest_format. * Queries a pad to convert @src_val in @src_format to @dest_format.

2
gst/gstutils.h
View file

@ -56,7 +56,7 @@ void gst_print_element_args (GString *buf, gint indent, GstElement *element);
* @type_as_function: the prefix for the functions * @type_as_function: the prefix for the functions
* @parent_type: the parent type struct name * @parent_type: the parent type struct name
* @parent_type_macro: the parent type macro * @parent_type_macro: the parent type macro
* @additional_initializations: function pointer in the form of * @additional_initializations: function pointer in the form of
* void additional_initializations (GType type) that can be used for * void additional_initializations (GType type) that can be used for
* initializing interfaces and the like * initializing interfaces and the like
* *

8
gst/gstvalue.c
View file

@ -1355,7 +1355,7 @@ gst_string_wrap (const char *s)
return d; return d;
} }
/* /*
* This function takes a string delimited with double quotes (") * This function takes a string delimited with double quotes (")
* and unescapes any \xxx octal numbers. * and unescapes any \xxx octal numbers.
* *
@ -1825,7 +1825,7 @@ gst_value_subtract_int_int_range (GValue * dest, const GValue * minuend,
return FALSE; return FALSE;
} }
/* creates a new int range based on input values. /* creates a new int range based on input values.
*/ */
static gboolean static gboolean
gst_value_create_new_range (GValue * dest, int min1, int max1, int min2, gst_value_create_new_range (GValue * dest, int min1, int max1, int min2,
@ -2445,7 +2445,7 @@ gst_value_can_subtract (const GValue * minuend, const GValue * subtrahend)
* @subtrahend_type: type of the subtrahend * @subtrahend_type: type of the subtrahend
* @func: function to use * @func: function to use
* *
* Registers @func as a function capable of subtracting the values of * Registers @func as a function capable of subtracting the values of
* @subtrahend_type from values of @minuend_type. * @subtrahend_type from values of @minuend_type.
*/ */
void void
@ -3314,7 +3314,7 @@ _gst_value_initialize (void)
/* Not using G_TYPE_DATE here on purpose, even if we could /* Not using G_TYPE_DATE here on purpose, even if we could
* if GLIB_CHECK_VERSION(2,8,0) was true: we don't want the * if GLIB_CHECK_VERSION(2,8,0) was true: we don't want the
* serialised strings to have different type strings depending * serialised strings to have different type strings depending
* on what version is used, so FIXME in 0.11 when we * on what version is used, so FIXME in 0.11 when we
* require GLib-2.8 */ * require GLib-2.8 */
gst_type_date = g_boxed_type_register_static ("GstDate", gst_type_date = g_boxed_type_register_static ("GstDate",
(GBoxedCopyFunc) gst_date_copy, (GBoxedFreeFunc) g_date_free); (GBoxedCopyFunc) gst_date_copy, (GBoxedFreeFunc) g_date_free);

10
gst/gstvalue.h
View file

@ -257,7 +257,7 @@ G_BEGIN_DECLS
/** /**
* GstValueCompareFunc: * GstValueCompareFunc:
* @value1: first value for comparission * @value1: first value for comparission
* @value2: second value for comparission * @value2: second value for comparission
* *
* Used together with gst_value_compare() to compare #GValues. * Used together with gst_value_compare() to compare #GValues.
* *
@ -266,20 +266,20 @@ G_BEGIN_DECLS
*/ */
typedef int (* GstValueCompareFunc) (const GValue *value1, typedef int (* GstValueCompareFunc) (const GValue *value1,
const GValue *value2); const GValue *value2);
typedef char * (* GstValueSerializeFunc) (const GValue *value1); typedef char * (* GstValueSerializeFunc) (const GValue *value1);
typedef gboolean (* GstValueDeserializeFunc) (GValue *dest, typedef gboolean (* GstValueDeserializeFunc) (GValue *dest,
const char *s); const char *s);
typedef int (* GstValueUnionFunc) (GValue *dest, typedef int (* GstValueUnionFunc) (GValue *dest,
const GValue *value1, const GValue *value1,
const GValue *value2); const GValue *value2);
typedef int (* GstValueIntersectFunc) (GValue *dest, typedef int (* GstValueIntersectFunc) (GValue *dest,
const GValue *value1, const GValue *value1,
const GValue *value2); const GValue *value2);
typedef int (* GstValueSubtractFunc) (GValue *dest, typedef int (* GstValueSubtractFunc) (GValue *dest,
const GValue *minuend, const GValue *minuend,
const GValue *subtrahend); const GValue *subtrahend);

12
gst/indexers/gstfileindex.c
View file

@ -42,12 +42,12 @@
* Object model: * Object model:
* *
* We build an index to each entry for each id. * We build an index to each entry for each id.
* *
* *
* fileindex * fileindex
* -----------------------------... * -----------------------------...
* ! ! * ! !
* id1 id2 * id1 id2
* ! * !
* GArray * GArray
* *
@ -829,11 +829,11 @@ show_entry (GstIndexEntry *entry)
{ {
switch (entry->type) { switch (entry->type) {
case GST_INDEX_ENTRY_ID: case GST_INDEX_ENTRY_ID:
g_print ("id %d describes writer %s\n", entry->id, g_print ("id %d describes writer %s\n", entry->id,
GST_INDEX_ID_DESCRIPTION (entry)); GST_INDEX_ID_DESCRIPTION (entry));
break; break;
case GST_INDEX_ENTRY_FORMAT: case GST_INDEX_ENTRY_FORMAT:
g_print ("%d: registered format %d for %s\n", entry->id, g_print ("%d: registered format %d for %s\n", entry->id,
GST_INDEX_FORMAT_FORMAT (entry), GST_INDEX_FORMAT_FORMAT (entry),
GST_INDEX_FORMAT_KEY (entry)); GST_INDEX_FORMAT_KEY (entry));
break; break;
@ -843,7 +843,7 @@ show_entry (GstIndexEntry *entry)
g_print ("%d: %08x ", entry->id, GST_INDEX_ASSOC_FLAGS (entry)); g_print ("%d: %08x ", entry->id, GST_INDEX_ASSOC_FLAGS (entry));
for (i = 0; i < GST_INDEX_NASSOCS (entry); i++) { for (i = 0; i < GST_INDEX_NASSOCS (entry); i++) {
g_print ("%d %lld ", GST_INDEX_ASSOC_FORMAT (entry, i), g_print ("%d %lld ", GST_INDEX_ASSOC_FORMAT (entry, i),
GST_INDEX_ASSOC_VALUE (entry, i)); GST_INDEX_ASSOC_VALUE (entry, i));
} }
g_print ("\n"); g_print ("\n");

12
gst/indexers/gstmemindex.c
View file

@ -35,12 +35,12 @@
* *
* All entries are simply added to a GList first. Then we build * All entries are simply added to a GList first. Then we build
* an index to each entry for each id/format * an index to each entry for each id/format
* *
* *
* memindex * memindex
* -----------------------------... * -----------------------------...
* ! ! * ! !
* id1 id2 * id1 id2
* ------------ * ------------
* ! ! * ! !
* format1 format2 * format1 format2
@ -54,8 +54,8 @@
* The MemIndexId keeps a MemIndexFormatIndex for each format the * The MemIndexId keeps a MemIndexFormatIndex for each format the
* specific writer wants indexed. * specific writer wants indexed.
* *
* The MemIndexFormatIndex keeps all the values of the particular * The MemIndexFormatIndex keeps all the values of the particular
* format in a GTree, The values of the GTree point back to the entry. * format in a GTree, The values of the GTree point back to the entry.
* *
* Finding a value for an id/format requires locating the correct GTree, * Finding a value for an id/format requires locating the correct GTree,
* then do a lookup in the Tree to get the required value. * then do a lookup in the Tree to get the required value.
@ -359,7 +359,7 @@ gst_mem_index_get_assoc_entry (GstIndex * index, gint id,
data.index = format_index; data.index = format_index;
data.exact = (method == GST_INDEX_LOOKUP_EXACT); data.exact = (method == GST_INDEX_LOOKUP_EXACT);
/* setup data for low/high checks if we are not looking /* setup data for low/high checks if we are not looking
* for an exact match */ * for an exact match */
if (!data.exact) { if (!data.exact) {
data.low_diff = G_MININT64; data.low_diff = G_MININT64;

10
gst/parse/types.h
View file

@ -30,8 +30,8 @@ struct _graph_t {
}; };
/* /*
* Memory checking. Should probably be done with gsttrace stuff, but that * Memory checking. Should probably be done with gsttrace stuff, but that
* doesn't really work. * doesn't really work.
* This is not safe from reentrance issues, but that doesn't matter as long as * This is not safe from reentrance issues, but that doesn't matter as long as
* we lock a mutex before parsing anyway. * we lock a mutex before parsing anyway.
@ -66,11 +66,11 @@ static inline void
gst_parse_unescape (gchar *str) gst_parse_unescape (gchar *str)
{ {
gchar *walk; gchar *walk;
g_return_if_fail (str != NULL); g_return_if_fail (str != NULL);
walk = str; walk = str;
while (*walk) { while (*walk) {
if (*walk == '\\') if (*walk == '\\')
walk++; walk++;

24
libs/gst/base/gstadapter.c
View file

@ -22,14 +22,14 @@
* @short_description: object to splice and merge buffers to desired size * @short_description: object to splice and merge buffers to desired size
* @see_also: #GstBytestream, #GstFilePad * @see_also: #GstBytestream, #GstFilePad
* *
* This class is for elements that receive buffers in an undesired size. * This class is for elements that receive buffers in an undesired size.
* While for example raw video contains one image per buffer, the same is not * While for example raw video contains one image per buffer, the same is not
* true for a lot of other formats, especially those that come directly from * true for a lot of other formats, especially those that come directly from
* a file. So if you have undefined buffer sizes and require a specific size, * a file. So if you have undefined buffer sizes and require a specific size,
* this object is for you. * this object is for you.
* *
* The theory of operation is like this: All buffers received are put * The theory of operation is like this: All buffers received are put
* into the adapter using gst_adapter_push() and the data is then read back * into the adapter using gst_adapter_push() and the data is then read back
* in chunks of the desired size using gst_adapter_peek(). After the data is * in chunks of the desired size using gst_adapter_peek(). After the data is
* processed, it is freed using gst_adapter_flush(). An example function that * processed, it is freed using gst_adapter_flush(). An example function that
* needs to process data in 10 byte chunks could look like this: * needs to process data in 10 byte chunks could look like this:
@ -51,10 +51,10 @@
* For another example, a simple element inside GStreamer that uses GstAdapter * For another example, a simple element inside GStreamer that uses GstAdapter
* is the libvisual element. * is the libvisual element.
* *
* A last thing to note is that while GstAdapter is pretty optimized, * A last thing to note is that while GstAdapter is pretty optimized,
* merging buffers still might be an operation that requires a memcpy() * merging buffers still might be an operation that requires a memcpy()
* operation, and this operation is not the fastest. Because of this, some * operation, and this operation is not the fastest. Because of this, some
* functions like gst_adapter_available_fast() are provided to help speed up * functions like gst_adapter_available_fast() are provided to help speed up
* such cases should you want to. * such cases should you want to.
*/ */
@ -152,7 +152,7 @@ gst_adapter_clear (GstAdapter * adapter)
* @adapter: a #GstAdapter * @adapter: a #GstAdapter
* @buf: the #GstBuffer to queue into the adapter * @buf: the #GstBuffer to queue into the adapter
* *
* Adds the data from @buf to the data stored inside @adapter and takes * Adds the data from @buf to the data stored inside @adapter and takes
* ownership of the buffer. * ownership of the buffer.
*/ */
void void
@ -295,8 +295,8 @@ gst_adapter_take (GstAdapter * adapter, guint nbytes)
* gst_adapter_available: * gst_adapter_available:
* @adapter: a #GstAdapter * @adapter: a #GstAdapter
* *
* Gets the maximum amount of bytes available, that is it returns the maximum * Gets the maximum amount of bytes available, that is it returns the maximum
* value that can be supplied to gst_adapter_peek() without that function * value that can be supplied to gst_adapter_peek() without that function
* returning NULL. * returning NULL.
* *
* Returns: amount of bytes available in @adapter * Returns: amount of bytes available in @adapter

2
libs/gst/base/gstbasesink.c
View file

@ -964,7 +964,7 @@ gst_base_sink_wait (GstBaseSink * basesink, GstClockTime time)
} }
/* perform synchronisation on a buffer /* perform synchronisation on a buffer
* *
* 1) check if we have a clock, if not, do nothing * 1) check if we have a clock, if not, do nothing
* 2) calculate the start and end time of the buffer * 2) calculate the start and end time of the buffer
* 3) create a single shot notification to wait on * 3) create a single shot notification to wait on

16
libs/gst/base/gstbasetransform.c
View file

@ -157,8 +157,8 @@
* interested in modifying the buffers. * interested in modifying the buffers.
* </para></listitem> * </para></listitem>
* <listitem><para> * <listitem><para>
* Elements which are always in passthrough mode whenever the same caps has * Elements which are always in passthrough mode whenever the same caps has
* been negotiated on both pads can set the class variable * been negotiated on both pads can set the class variable
* passthrough_on_same_caps to have this behaviour automatically. * passthrough_on_same_caps to have this behaviour automatically.
* </para></listitem> * </para></listitem>
* </itemizedlist> * </itemizedlist>
@ -824,7 +824,7 @@ gst_base_transform_prepare_output_buf (GstBaseTransform * trans,
return ret; return ret;
} }
/* If the output buffer metadata is modifiable, copy timestamps and /* If the output buffer metadata is modifiable, copy timestamps and
* buffer flags */ * buffer flags */
if (*buf != input && GST_MINI_OBJECT_REFCOUNT_VALUE (*buf) == 1) { if (*buf != input && GST_MINI_OBJECT_REFCOUNT_VALUE (*buf) == 1) {
@ -1102,7 +1102,7 @@ gst_base_transform_handle_buffer (GstBaseTransform * trans, GstBuffer * inbuf,
*outbuf = NULL; *outbuf = NULL;
if (want_in_place) { if (want_in_place) {
/* If want_in_place is TRUE, we may need to prepare a new output buffer /* If want_in_place is TRUE, we may need to prepare a new output buffer
* Sub-classes can implement a prepare_output_buffer function as they * Sub-classes can implement a prepare_output_buffer function as they
* wish. */ * wish. */
GST_LOG_OBJECT (trans, "doing inplace transform"); GST_LOG_OBJECT (trans, "doing inplace transform");
@ -1373,9 +1373,9 @@ gst_base_transform_change_state (GstElement * element,
* @passthrough: boolean indicating passthrough mode. * @passthrough: boolean indicating passthrough mode.
* *
* Set passthrough mode for this filter by default. This is mostly * Set passthrough mode for this filter by default. This is mostly
* useful for filters that do not care about negotiation. * useful for filters that do not care about negotiation.
* *
* Always TRUE for filters which don't implement either a transform * Always TRUE for filters which don't implement either a transform
* or transform_ip method. * or transform_ip method.
* *
* MT safe. * MT safe.
@ -1432,7 +1432,7 @@ gst_base_transform_is_passthrough (GstBaseTransform * trans)
* @in_place: Boolean value indicating that we would like to operate * @in_place: Boolean value indicating that we would like to operate
* on in_place buffers. * on in_place buffers.
* *
* Determines whether a non-writable buffer will be copied before passing * Determines whether a non-writable buffer will be copied before passing
* to the transform_ip function. * to the transform_ip function.
* <itemizedlist> * <itemizedlist>
* <listitem>Always TRUE if no transform function is implemented.</listitem> * <listitem>Always TRUE if no transform function is implemented.</listitem>

8
libs/gst/base/gstbasetransform.h
View file

@ -148,21 +148,21 @@ struct _GstBaseTransformClass {
gboolean passthrough_on_same_caps; gboolean passthrough_on_same_caps;
/* Subclasses can override this to do their own allocation of output buffers. /* Subclasses can override this to do their own allocation of output buffers.
* Elements that only do analysis can return a subbuffer or even just * Elements that only do analysis can return a subbuffer or even just
* increment the reference to the input buffer (if in passthrough mode) * increment the reference to the input buffer (if in passthrough mode)
*/ */
GstFlowReturn (*prepare_output_buffer) (GstBaseTransform * trans, GstFlowReturn (*prepare_output_buffer) (GstBaseTransform * trans,
GstBuffer *input, gint size, GstCaps *caps, GstBuffer **buf); GstBuffer *input, gint size, GstCaps *caps, GstBuffer **buf);
/*< private >*/ /*< private >*/
gpointer _gst_reserved[GST_PADDING - 2]; gpointer _gst_reserved[GST_PADDING - 2];
}; };
void gst_base_transform_set_passthrough (GstBaseTransform *trans, void gst_base_transform_set_passthrough (GstBaseTransform *trans,
gboolean passthrough); gboolean passthrough);
gboolean gst_base_transform_is_passthrough (GstBaseTransform *trans); gboolean gst_base_transform_is_passthrough (GstBaseTransform *trans);
void gst_base_transform_set_in_place (GstBaseTransform *trans, void gst_base_transform_set_in_place (GstBaseTransform *trans,
gboolean in_place); gboolean in_place);
gboolean gst_base_transform_is_in_place (GstBaseTransform *trans); gboolean gst_base_transform_is_in_place (GstBaseTransform *trans);

14
libs/gst/base/gstcollectpads.c
View file

@ -1,7 +1,7 @@
/* GStreamer /* GStreamer
* Copyright (C) 2005 Wim Taymans <wim@fluendo.com> * Copyright (C) 2005 Wim Taymans <wim@fluendo.com>
* *
* gstcollectpads.c: * gstcollectpads.c:
* *
* This library is free software; you can redistribute it and/or * This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public * modify it under the terms of the GNU Library General Public
@ -21,7 +21,7 @@
/** /**
* SECTION:gstcollectpads * SECTION:gstcollectpads
* @short_description: manages a set of pads that operate in collect mode * @short_description: manages a set of pads that operate in collect mode
* @see_also: * @see_also:
* *
* Manages a set of pads that operate in collect mode. This means that control * Manages a set of pads that operate in collect mode. This means that control
* is given to the manager of this object when all pads have data. * is given to the manager of this object when all pads have data.
@ -40,7 +40,7 @@
* When data is queued on all pads, a callback function is called. * When data is queued on all pads, a callback function is called.
* </para></listitem> * </para></listitem>
* <listitem><para> * <listitem><para>
* Data can be dequeued from the pad with the _pop() method. * Data can be dequeued from the pad with the _pop() method.
* One can _peek() at the data with the peek function. * One can _peek() at the data with the peek function.
* </para></listitem> * </para></listitem>
* <listitem><para> * <listitem><para>
@ -127,7 +127,7 @@ gst_collectpads_finalize (GObject * object)
* gst_collectpads_new: * gst_collectpads_new:
* *
* Create a new instance of #GstCollectsPads. * Create a new instance of #GstCollectsPads.
* *
* Returns: a new #GstCollectPads, or NULL in case of an error. * Returns: a new #GstCollectPads, or NULL in case of an error.
* *
* MT safe. * MT safe.
@ -416,7 +416,7 @@ gst_collectpads_pop (GstCollectPads * pads, GstCollectData * data)
* This function should be called with @pads LOCK held, such as * This function should be called with @pads LOCK held, such as
* in the callback. * in the callback.
* *
* Returns: The maximum number of bytes queued on all pad. This function * Returns: The maximum number of bytes queued on all pad. This function
* returns 0 if a pad has no queued buffer. * returns 0 if a pad has no queued buffer.
* *
* MT safe. * MT safe.
@ -453,7 +453,7 @@ not_filled:
* gst_collectpads_read: * gst_collectpads_read:
* @pads: the collectspads to query * @pads: the collectspads to query
* @data: the data to use * @data: the data to use
* @bytes: a pointer to a byte array * @bytes: a pointer to a byte array
* @size: the number of bytes to read * @size: the number of bytes to read
* *
* Get a pointer in @bytes where @size bytes can be read from the * Get a pointer in @bytes where @size bytes can be read from the
@ -487,7 +487,7 @@ gst_collectpads_read (GstCollectPads * pads, GstCollectData * data,
* @data: the data to use * @data: the data to use
* @size: the number of bytes to flush * @size: the number of bytes to flush
* *
* Flush @size bytes from the pad @data. * Flush @size bytes from the pad @data.
* *
* This function should be called with @pads LOCK held, such as * This function should be called with @pads LOCK held, such as
* in the callback. * in the callback.

6
libs/gst/base/gstcollectpads.h
View file

@ -1,7 +1,7 @@
/* GStreamer /* GStreamer
* Copyright (C) 2005 Wim Taymans <wim@fluendo.com> * Copyright (C) 2005 Wim Taymans <wim@fluendo.com>
* *
* gstcollectpads.h: * gstcollectpads.h:
* *
* This library is free software; you can redistribute it and/or * This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public * modify it under the terms of the GNU Library General Public
@ -111,9 +111,9 @@ GstBuffer* gst_collectpads_pop (GstCollectPads *pads, GstCollectData *data);
/* get collected bytes */ /* get collected bytes */
guint gst_collectpads_available (GstCollectPads *pads); guint gst_collectpads_available (GstCollectPads *pads);
guint gst_collectpads_read (GstCollectPads *pads, GstCollectData *data, guint gst_collectpads_read (GstCollectPads *pads, GstCollectData *data,
guint8 **bytes, guint size); guint8 **bytes, guint size);
guint gst_collectpads_flush (GstCollectPads *pads, GstCollectData *data, guint gst_collectpads_flush (GstCollectPads *pads, GstCollectData *data,
guint size); guint size);
G_END_DECLS G_END_DECLS

2
libs/gst/base/gstpushsrc.h
View file

@ -3,7 +3,7 @@
* 2000 Wim Taymans <wtay@chello.be> * 2000 Wim Taymans <wtay@chello.be>
* 2005 Wim Taymans <wim@fluendo.com> * 2005 Wim Taymans <wim@fluendo.com>
* *
* gstpushsrc.h: * gstpushsrc.h:
* *
* This library is free software; you can redistribute it and/or * This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public * modify it under the terms of the GNU Library General Public

2
libs/gst/base/gsttypefindhelper.c
View file

@ -2,7 +2,7 @@
* Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu> * Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
* 2000,2005 Wim Taymans <wim@fluendo.com> * 2000,2005 Wim Taymans <wim@fluendo.com>
* *
* gsttypefindhelper.c: * gsttypefindhelper.c:
* *
* This library is free software; you can redistribute it and/or * This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public * modify it under the terms of the GNU Library General Public

2
libs/gst/base/gsttypefindhelper.h
View file

@ -2,7 +2,7 @@
* Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu> * Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
* 2000,2005 Wim Taymans <wim@fluendo.com> * 2000,2005 Wim Taymans <wim@fluendo.com>
* *
* gsttypefindhelper.h: * gsttypefindhelper.h:
* *
* This library is free software; you can redistribute it and/or * This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public * modify it under the terms of the GNU Library General Public

4
plugins/elements/gstbufferstore.c
View file

@ -284,7 +284,7 @@ gst_buffer_store_clear (GstBufferStore * store)
* @store: a bufferstore * @store: a bufferstore
* @buffer: the buffer to add * @buffer: the buffer to add
* *
* Adds a buffer to the buffer store. * Adds a buffer to the buffer store.
* *
* Returns: TRUE, if the buffer was added, FALSE if an error occured. * Returns: TRUE, if the buffer was added, FALSE if an error occured.
*/ */
@ -317,7 +317,7 @@ gst_buffer_store_add_buffer (GstBufferStore * store, GstBuffer * buffer)
* data is not available inside the store, NULL is returned. You have to unref * data is not available inside the store, NULL is returned. You have to unref
* the buffer after use. * the buffer after use.
* *
* Returns: a buffer with the requested data or NULL if the data was not * Returns: a buffer with the requested data or NULL if the data was not
* available. * available.
*/ */
GstBuffer * GstBuffer *

4
plugins/elements/gstcapsfilter.c
View file

@ -226,9 +226,9 @@ gst_capsfilter_transform_ip (GstBaseTransform * base, GstBuffer * buf)
/* Output buffer preparation... if the buffer has no caps, and /* Output buffer preparation... if the buffer has no caps, and
* our allowed output caps is fixed, then give the caps to the * our allowed output caps is fixed, then give the caps to the
* buffer. * buffer.
* This ensures that outgoing buffers have caps if we can, so * This ensures that outgoing buffers have caps if we can, so
* that pipelines like: * that pipelines like:
* gst-launch filesrc location=rawsamples.raw ! * gst-launch filesrc location=rawsamples.raw !
* audio/x-raw-int,width=16,depth=16,rate=48000,channels=2, * audio/x-raw-int,width=16,depth=16,rate=48000,channels=2,
* endianness=4321,signed='(boolean)'true ! alsasink * endianness=4321,signed='(boolean)'true ! alsasink
* will work. * will work.

2
plugins/elements/gstfakesink.c
View file

@ -2,7 +2,7 @@
* Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu> * Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
* 2005 Wim Taymans <wim@fluendo.com> * 2005 Wim Taymans <wim@fluendo.com>
* *
* gstfakesink.c: * gstfakesink.c:
* *
* This library is free software; you can redistribute it and/or * This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public * modify it under the terms of the GNU Library General Public

Some files were not shown because too many files have changed in this diff Show more