some more docs cleanup

Original commit message from CVS:
some more docs cleanup
parent 67fcf372
......@@ -4,6 +4,10 @@
# <SECTION>
# <FILE>gstxxx</FILE>
# <TITLE>GstXxx</TITLE>
# typedefs
# macros
# constructor
# methods
# <SUBSECTION Standard>
# <SUBSECTION Private>
# </SECTION>
......@@ -18,10 +22,6 @@ gst_init_check
gst_init_with_popt_table
gst_init_check_with_popt_table
gst_init_get_popt_table
gst_use_threads
gst_has_threads
gst_main
gst_main_quit
<SUBSECTION Private>
#GstPoptOption
</SECTION>
......@@ -31,22 +31,24 @@ gst_main_quit
<TITLE>GstBin</TITLE>
GstBin
GstBinFlags
gst_bin_new
gst_bin_add
gst_bin_add_many
gst_bin_remove
gst_bin_remove_many
gst_bin_get_by_name
gst_bin_get_by_name_recurse_up
gst_bin_get_list
gst_bin_get_by_interface
gst_bin_get_all_by_interface
gst_bin_iterate
gst_bin_use_clock
gst_bin_get_clock
gst_bin_auto_clock
gst_bin_sync_children_state
gst_bin_child_state_change
gst_bin_iterate_elements
gst_bin_iterate_recurse
gst_bin_iterate_sinks
gst_bin_iterate_all_by_interface
<SUBSECTION>
gst_bin_add_many
gst_bin_remove_many
<SUBSECTION Standard>
GstBinClass
GST_BIN
......@@ -56,15 +58,18 @@ GST_BIN_CLASS
GST_IS_BIN_CLASS
GST_BIN_GET_CLASS
GST_TYPE_BIN_FLAGS
<SUBSECTION Private>
gst_bin_get_type
gst_bin_flags_get_type
</SECTION>
<SECTION>
<FILE>gstbuffer</FILE>
<TITLE>GstBuffer</TITLE>
GstBuffer
gst_buffer_new
gst_buffer_new_and_alloc
......@@ -77,42 +82,37 @@ GST_BUFFER_FLAG_UNSET
gst_buffer_set_data
GST_BUFFER_DATA
GST_BUFFER_SIZE
GST_BUFFER_MAXSIZE
GST_BUFFER_TIMESTAMP
GST_BUFFER_DURATION
GST_BUFFER_OFFSET
GST_BUFFER_OFFSET_END
gst_buffer_ref
gst_buffer_ref_by_count
gst_buffer_unref
gst_buffer_stamp
gst_buffer_copy
gst_buffer_is_writable
gst_buffer_copy_on_write
gst_buffer_make_writable
gst_buffer_replace
gst_buffer_get_caps
gst_buffer_set_caps
gst_buffer_create_sub
gst_buffer_join
gst_buffer_merge
gst_buffer_span
gst_buffer_is_span_fast
gst_buffer_default_free
gst_buffer_default_copy
gst_buffer_span
GST_BUFFER_TRACE_NAME
GST_BUFFER_REFCOUNT
GST_BUFFER_REFCOUNT_VALUE
GST_BUFFER_COPY_FUNC
GST_BUFFER_FREE_FUNC
GST_BUFFER_FREE_DATA_FUNC
GstBufferFreeDataFunc
GST_BUFFER_PRIVATE
GST_BUFFER_OFFSET_NONE
GST_BUFFER_MAXSIZE_NONE
GST_BUFFER_DURATION_IS_VALID
GST_BUFFER_TIMESTAMP_IS_VALID
GST_BUFFER_OFFSET_IS_VALID
GST_BUFFER_OFFSET_END_IS_VALID
GST_BUFFER_MAXSIZE_IS_VALID
<SUBSECTION>
gst_buffer_stamp
gst_buffer_join
gst_buffer_merge
<SUBSECTION Standard>
GST_BUFFER
......@@ -127,6 +127,9 @@ gst_buffer_flag_get_type
<SECTION>
<FILE>gstcaps</FILE>
<TITLE>GstCaps</TITLE>
GstCaps
GstStaticCaps
GST_CAPS_FLAGS_ANY
GST_CAPS_ANY
GST_CAPS_NONE
......@@ -136,44 +139,34 @@ GST_CAPS_IS_SIMPLE
gst_caps_is_simple
GST_DEBUG_CAPS
GST_STATIC_CAPS
GstCaps
GstStaticCaps
gst_caps_new_empty
gst_caps_new_any
gst_caps_new_simple
gst_caps_new_full
gst_caps_new_full_valist
gst_caps_copy
gst_caps_free
gst_static_caps_get
gst_caps_append
gst_caps_append_structure
gst_caps_split_one
gst_caps_get_size
gst_caps_get_structure
gst_caps_copy_1
gst_caps_set_simple
gst_caps_set_simple_valist
gst_caps_is_any
gst_caps_is_empty
gst_caps_is_chained
gst_caps_is_fixed
gst_caps_is_equal
gst_caps_is_equal_fixed
gst_caps_is_always_compatible
gst_caps_is_subset
gst_caps_intersect
gst_caps_union
gst_caps_normalize
gst_caps_simplify
gst_caps_do_simplify
gst_caps_save_thyself
gst_caps_load_thyself
gst_caps_replace
gst_caps_to_string
gst_caps_from_string
gst_caps_structure_fixate_field_nearest_int
gst_caps_structure_fixate_field_nearest_double
gst_caps_subtract
<SUBSECTION Standard>
GST_CAPS
......@@ -1423,6 +1416,8 @@ gst_structure_get_double
gst_structure_get_string
gst_structure_to_string
gst_structure_from_string
gst_caps_structure_fixate_field_nearest_int
gst_caps_structure_fixate_field_nearest_double
<SUBSECTION Standard>
GST_STRUCTURE
GST_IS_STRUCTURE
......
......@@ -106,57 +106,74 @@ Will be emmited if an element was removed from this bin.
@Returns:
<!-- ##### FUNCTION gst_bin_add_many ##### -->
<!-- ##### FUNCTION gst_bin_remove ##### -->
<para>
</para>
@bin:
@element_1:
@Varargs:
@element:
@Returns:
<!-- ##### FUNCTION gst_bin_remove ##### -->
<!-- ##### FUNCTION gst_bin_get_by_name ##### -->
<para>
</para>
@bin:
@element:
@name:
@Returns:
<!-- ##### FUNCTION gst_bin_remove_many ##### -->
<!-- ##### FUNCTION gst_bin_get_by_name_recurse_up ##### -->
<para>
</para>
@bin:
@element_1:
@Varargs:
@name:
@Returns:
<!-- ##### FUNCTION gst_bin_get_by_name ##### -->
<!-- ##### FUNCTION gst_bin_get_by_interface ##### -->
<para>
</para>
@bin:
@name:
@interface:
@Returns:
<!-- ##### FUNCTION gst_bin_get_by_name_recurse_up ##### -->
<!-- ##### FUNCTION gst_bin_iterate_elements ##### -->
<para>
</para>
@bin:
@name:
@Returns:
<!-- ##### FUNCTION gst_bin_get_by_interface ##### -->
<!-- ##### FUNCTION gst_bin_iterate_recurse ##### -->
<para>
</para>
@bin:
@Returns:
<!-- ##### FUNCTION gst_bin_iterate_sinks ##### -->
<para>
</para>
@bin:
@Returns:
<!-- ##### FUNCTION gst_bin_iterate_all_by_interface ##### -->
<para>
</para>
......@@ -166,3 +183,23 @@ Will be emmited if an element was removed from this bin.
@Returns:
<!-- ##### FUNCTION gst_bin_add_many ##### -->
<para>
</para>
@bin:
@element_1:
@Varargs:
<!-- ##### FUNCTION gst_bin_remove_many ##### -->
<para>
</para>
@bin:
@element_1:
@Varargs:
......@@ -241,15 +241,6 @@ will be freed.
@buf: a #GstBuffer to unref.
<!-- ##### FUNCTION gst_buffer_stamp ##### -->
<para>
</para>
@dest:
@src:
<!-- ##### MACRO gst_buffer_copy ##### -->
<para>
Copies the given buffer using the copy function of the parent GstData structure.
......@@ -267,46 +258,49 @@ Tests if you can safely write data into a buffer's data array.
@buf: a #GstBuffer to check
<!-- ##### FUNCTION gst_buffer_create_sub ##### -->
<!-- ##### MACRO gst_buffer_make_writable ##### -->
<para>
</para>
@parent:
@offset:
@size:
@Returns:
@buf:
<!-- ##### FUNCTION gst_buffer_join ##### -->
<!-- ##### MACRO gst_buffer_replace ##### -->
<para>
</para>
@buf1:
@buf2:
@Returns:
@obuf:
@nbuf:
<!-- ##### FUNCTION gst_buffer_merge ##### -->
<!-- ##### FUNCTION gst_buffer_get_caps ##### -->
<para>
</para>
@buf1:
@buf2:
@buffer:
@Returns:
<!-- ##### FUNCTION gst_buffer_span ##### -->
<!-- ##### FUNCTION gst_buffer_set_caps ##### -->
<para>
</para>
@buf1:
@buffer:
@caps:
<!-- ##### FUNCTION gst_buffer_create_sub ##### -->
<para>
</para>
@parent:
@offset:
@buf2:
@len:
@size:
@Returns:
......@@ -320,21 +314,26 @@ Tests if you can safely write data into a buffer's data array.
@Returns:
<!-- ##### MACRO GST_BUFFER_TRACE_NAME ##### -->
<!-- ##### FUNCTION gst_buffer_span ##### -->
<para>
The name used for tracing memory allocations
</para>
@buf1:
@offset:
@buf2:
@len:
@Returns:
<!-- ##### MACRO GST_BUFFER_OFFSET_NONE ##### -->
<!-- ##### MACRO GST_BUFFER_TRACE_NAME ##### -->
<para>
The name used for tracing memory allocations
</para>
<!-- ##### MACRO GST_BUFFER_MAXSIZE_NONE ##### -->
<!-- ##### MACRO GST_BUFFER_OFFSET_NONE ##### -->
<para>
</para>
......@@ -373,11 +372,32 @@ Tests if the timestamp is known.
@buffer:
<!-- ##### MACRO GST_BUFFER_MAXSIZE_IS_VALID ##### -->
<!-- ##### FUNCTION gst_buffer_stamp ##### -->
<para>
</para>
@buffer:
@dest:
@src:
<!-- ##### FUNCTION gst_buffer_join ##### -->
<para>
</para>
@buf1:
@buf2:
@Returns:
<!-- ##### FUNCTION gst_buffer_merge ##### -->
<para>
</para>
@buf1:
@buf2:
@Returns:
......@@ -14,6 +14,24 @@ Structure describing sets of media formats
</para>
<!-- ##### STRUCT GstCaps ##### -->
<para>
</para>
@type:
@refcount:
@flags:
@structs:
<!-- ##### STRUCT GstStaticCaps ##### -->
<para>
</para>
@caps:
@string:
<!-- ##### MACRO GST_CAPS_FLAGS_ANY ##### -->
<para>
Flags that this caps has no specific content, but can contain anything.
......@@ -91,24 +109,6 @@ templates.
@Returns: a new #GstCaps instance
<!-- ##### STRUCT GstCaps ##### -->
<para>
</para>
@type:
@refcount:
@flags:
@structs:
<!-- ##### STRUCT GstStaticCaps ##### -->
<para>
</para>
@caps:
@string:
<!-- ##### FUNCTION gst_caps_new_empty ##### -->
<para>
......@@ -376,28 +376,6 @@ templates.
@Returns:
<!-- ##### FUNCTION gst_caps_structure_fixate_field_nearest_int ##### -->
<para>
</para>
@structure:
@field_name:
@target:
@Returns:
<!-- ##### FUNCTION gst_caps_structure_fixate_field_nearest_double ##### -->
<para>
</para>
@structure:
@field_name:
@target:
@Returns:
<!-- ##### FUNCTION gst_caps_subtract ##### -->
<para>
......
......@@ -368,3 +368,25 @@ Generic structure containing fields of names and values
@Returns:
<!-- ##### FUNCTION gst_caps_structure_fixate_field_nearest_int ##### -->
<para>
</para>
@structure:
@field_name:
@target:
@Returns:
<!-- ##### FUNCTION gst_caps_structure_fixate_field_nearest_double ##### -->
<para>
</para>
@structure:
@field_name:
@target:
@Returns:
......@@ -72,13 +72,13 @@ typedef enum {
#define GST_BIN_CHILDREN_COOKIE(bin) (GST_BIN_CAST(bin)->children_cookie);
struct _GstBin {
GstElement element;
GstElement element;
/*< public >*/ /* with LOCK */
/* our children, subclass are supposed to update these
* fields to reflect their state with _iterate_*() */
gint numchildren;
GList *children;
gint numchildren;
GList *children;
guint32 children_cookie;
/*< private >*/
......@@ -118,7 +118,7 @@ GstElement* gst_bin_get_by_interface (GstBin *bin, GType interface);
GstIterator* gst_bin_iterate_elements (GstBin *bin);
GstIterator* gst_bin_iterate_recurse (GstBin *bin);
GstIterator* gst_bin_iterate_sinks (GstBin *bin);
GstIterator* gst_bin_iterate_sinks (GstBin *bin);
GstIterator* gst_bin_iterate_all_by_interface (GstBin *bin, GType interface);
G_END_DECLS
......
......@@ -58,13 +58,11 @@ typedef struct _GstBufferClass GstBufferClass;
#define GST_BUFFER_MALLOCDATA(buf) (GST_BUFFER(buf)->malloc_data)
#define GST_BUFFER_OFFSET_NONE ((guint64)-1)
#define GST_BUFFER_MAXSIZE_NONE ((guint)0)
#define GST_BUFFER_DURATION_IS_VALID(buffer) (GST_CLOCK_TIME_IS_VALID (GST_BUFFER_DURATION (buffer)))
#define GST_BUFFER_TIMESTAMP_IS_VALID(buffer) (GST_CLOCK_TIME_IS_VALID (GST_BUFFER_TIMESTAMP (buffer)))
#define GST_BUFFER_OFFSET_IS_VALID(buffer) (GST_BUFFER_OFFSET (buffer) != GST_BUFFER_OFFSET_NONE)
#define GST_BUFFER_OFFSET_END_IS_VALID(buffer) (GST_BUFFER_OFFSET_END (buffer) != GST_BUFFER_OFFSET_NONE)
#define GST_BUFFER_MAXSIZE_IS_VALID(buffer) (GST_BUFFER_MAXSIZE (buffer) != GST_BUFFER_MAXSIZE_NONE)
/**
* GstBufferFlag:
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment