diff options
Diffstat (limited to 'girs/Gst-1.0.gir')
| -rw-r--r-- | girs/Gst-1.0.gir | 4990 |
1 files changed, 2563 insertions, 2427 deletions
diff --git a/girs/Gst-1.0.gir b/girs/Gst-1.0.gir index 41b2d8c..34b7d2a 100644 --- a/girs/Gst-1.0.gir +++ b/girs/Gst-1.0.gir @@ -1545,7 +1545,7 @@ the bin does not want to accept the element.</doc> line="2684">Adds a %NULL-terminated list of elements to a bin. This function is equivalent to calling gst_bin_add() for each member of the list. The return value of each gst_bin_add() is ignored.</doc> - <source-position filename="gst/gstutils.h" line="1131"/> + <source-position filename="gst/gstutils.h" line="1134"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -1579,7 +1579,7 @@ direction within the specified bin and returns an unlinked pad if one is found, or %NULL otherwise. If a pad is found, the caller owns a reference to it and should use gst_object_unref() on the pad when it is not needed any longer.</doc> - <source-position filename="gst/gstutils.h" line="1137"/> + <source-position filename="gst/gstutils.h" line="1140"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -1988,7 +1988,7 @@ the bin does not want to remove the element.</doc> filename="gst/gstutils.c" line="2713">Remove a list of elements from a bin. This function is equivalent to calling gst_bin_remove() with each member of the list.</doc> - <source-position filename="gst/gstutils.h" line="1134"/> + <source-position filename="gst/gstutils.h" line="1137"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -2050,7 +2050,7 @@ MT safe.</doc> filename="gst/gstutils.c" line="3358">Synchronizes the state of every child of @bin with the state of @bin. See also gst_element_sync_state_with_parent().</doc> - <source-position filename="gst/gstutils.h" line="1140"/> + <source-position filename="gst/gstutils.h" line="1143"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -2274,7 +2274,7 @@ The @deep_element_added vfunc will be called when a new element has been added to any bin inside this bin, so it will also be called if a new child was added to a sub-bin of this bin. #GstBin implementations that override this message should chain up to the parent class implementation so the -element-added-deep signal is emitted on all parents.</doc> +#GstBin::deep-element-added signal is emitted on all parents.</doc> <source-position filename="gst/gstbin.h" line="193"/> <field name="parent_class"> <doc xml:space="preserve" @@ -2623,21 +2623,21 @@ for re-use. (Since: 1.6)</doc> <constructor name="new" c:identifier="gst_buffer_new"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="833">Creates a newly allocated buffer without any data. + line="836">Creates a newly allocated buffer without any data. MT safe.</doc> <source-position filename="gst/gstbuffer.h" line="289"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="840">the new #GstBuffer.</doc> + line="843">the new #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </return-value> </constructor> <constructor name="new_allocate" c:identifier="gst_buffer_new_allocate"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="855">Tries to create a newly allocated buffer with data of the given size and + line="858">Tries to create a newly allocated buffer with data of the given size and extra parameters from @allocator. If the requested amount of memory can't be allocated, %NULL will be returned. The allocated buffer memory is not cleared. @@ -2650,7 +2650,7 @@ MT safe.</doc> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="872">a new #GstBuffer, or %NULL if + line="875">a new #GstBuffer, or %NULL if the memory couldn't be allocated.</doc> <type name="Buffer" c:type="GstBuffer*"/> </return-value> @@ -2661,14 +2661,14 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="857">the #GstAllocator to use, or %NULL to use the + line="860">the #GstAllocator to use, or %NULL to use the default allocator</doc> <type name="Allocator" c:type="GstAllocator*"/> </parameter> <parameter name="size" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="859">the size in bytes of the new buffer's data.</doc> + line="862">the size in bytes of the new buffer's data.</doc> <type name="gsize" c:type="gsize"/> </parameter> <parameter name="params" @@ -2677,7 +2677,7 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="860">optional parameters</doc> + line="863">optional parameters</doc> <type name="AllocationParams" c:type="GstAllocationParams*"/> </parameter> </parameters> @@ -2685,7 +2685,7 @@ MT safe.</doc> <constructor name="new_wrapped" c:identifier="gst_buffer_new_wrapped"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1001">Creates a new buffer that wraps the given @data. The memory will be freed + line="1004">Creates a new buffer that wraps the given @data. The memory will be freed with g_free and will be marked writable. MT safe.</doc> @@ -2693,14 +2693,14 @@ MT safe.</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1011">a new #GstBuffer</doc> + line="1014">a new #GstBuffer</doc> <type name="Buffer" c:type="GstBuffer*"/> </return-value> <parameters> <parameter name="data" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1003">data to wrap</doc> + line="1006">data to wrap</doc> <array length="1" zero-terminated="0" c:type="gpointer"> <type name="guint8"/> </array> @@ -2708,7 +2708,7 @@ MT safe.</doc> <parameter name="size" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1004">allocated size of @data</doc> + line="1007">allocated size of @data</doc> <type name="gsize" c:type="gsize"/> </parameter> </parameters> @@ -2718,7 +2718,7 @@ MT safe.</doc> version="1.16"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1019">Creates a new #GstBuffer that wraps the given @bytes. The data inside + line="1022">Creates a new #GstBuffer that wraps the given @bytes. The data inside @bytes cannot be %NULL and the resulting buffer will be marked as read only. MT safe.</doc> @@ -2726,14 +2726,14 @@ MT safe.</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1028">a new #GstBuffer wrapping @bytes</doc> + line="1031">a new #GstBuffer wrapping @bytes</doc> <type name="Buffer" c:type="GstBuffer*"/> </return-value> <parameters> <parameter name="bytes" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1021">a #GBytes to wrap</doc> + line="1024">a #GBytes to wrap</doc> <type name="GLib.Bytes" c:type="GBytes*"/> </parameter> </parameters> @@ -2742,7 +2742,7 @@ MT safe.</doc> c:identifier="gst_buffer_new_wrapped_full"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="961">Allocate a new buffer that wraps the given memory. @data must point to + line="964">Allocate a new buffer that wraps the given memory. @data must point to @maxsize of memory, the wrapped buffer will have the region from @offset and @size visible. @@ -2754,20 +2754,20 @@ The prefix/padding must be filled with 0 if @flags contains <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="980">a new #GstBuffer</doc> + line="983">a new #GstBuffer</doc> <type name="Buffer" c:type="GstBuffer*"/> </return-value> <parameters> <parameter name="flags" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="963">#GstMemoryFlags</doc> + line="966">#GstMemoryFlags</doc> <type name="MemoryFlags" c:type="GstMemoryFlags"/> </parameter> <parameter name="data" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="964">data to wrap</doc> + line="967">data to wrap</doc> <array length="4" zero-terminated="0" c:type="gpointer"> <type name="guint8"/> </array> @@ -2775,19 +2775,19 @@ The prefix/padding must be filled with 0 if @flags contains <parameter name="maxsize" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="965">allocated size of @data</doc> + line="968">allocated size of @data</doc> <type name="gsize" c:type="gsize"/> </parameter> <parameter name="offset" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="966">offset in @data</doc> + line="969">offset in @data</doc> <type name="gsize" c:type="gsize"/> </parameter> <parameter name="size" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="967">size of valid data</doc> + line="970">size of valid data</doc> <type name="gsize" c:type="gsize"/> </parameter> <parameter name="user_data" @@ -2796,7 +2796,7 @@ The prefix/padding must be filled with 0 if @flags contains allow-none="1"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="968">user_data</doc> + line="971">user_data</doc> <type name="gpointer" c:type="gpointer"/> </parameter> <parameter name="notify" @@ -2807,7 +2807,7 @@ The prefix/padding must be filled with 0 if @flags contains closure="5"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="969">called with @user_data when the memory is freed</doc> + line="972">called with @user_data when the memory is freed</doc> <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/> </parameter> </parameters> @@ -2815,25 +2815,25 @@ The prefix/padding must be filled with 0 if @flags contains <method name="add_meta" c:identifier="gst_buffer_add_meta"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2268">Add metadata for @info to @buffer using the parameters in @params.</doc> + line="2271">Add metadata for @info to @buffer using the parameters in @params.</doc> <source-position filename="gst/gstbuffer.h" line="650"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2276">the metadata for the api in @info on @buffer.</doc> + line="2279">the metadata for the api in @info on @buffer.</doc> <type name="Meta" c:type="GstMeta*"/> </return-value> <parameters> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2270">a #GstBuffer</doc> + line="2273">a #GstBuffer</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="info" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2271">a #GstMetaInfo</doc> + line="2274">a #GstMetaInfo</doc> <type name="MetaInfo" c:type="const GstMetaInfo*"/> </parameter> <parameter name="params" @@ -2842,7 +2842,7 @@ The prefix/padding must be filled with 0 if @flags contains allow-none="1"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2272">params for @info</doc> + line="2275">params for @info</doc> <type name="gpointer" c:type="gpointer"/> </parameter> </parameters> @@ -2852,26 +2852,26 @@ The prefix/padding must be filled with 0 if @flags contains version="1.6"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2571">Add a #GstParentBufferMeta to @buffer that holds a reference on + line="2574">Add a #GstParentBufferMeta to @buffer that holds a reference on @ref until the buffer is freed.</doc> <source-position filename="gst/gstbuffer.h" line="745"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2579">The #GstParentBufferMeta that was added to the buffer</doc> + line="2582">The #GstParentBufferMeta that was added to the buffer</doc> <type name="ParentBufferMeta" c:type="GstParentBufferMeta*"/> </return-value> <parameters> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2573">a #GstBuffer</doc> + line="2576">a #GstBuffer</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="ref" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2574">a #GstBuffer to ref</doc> + line="2577">a #GstBuffer to ref</doc> <type name="Buffer" c:type="GstBuffer*"/> </parameter> </parameters> @@ -2913,14 +2913,14 @@ unsuccessful.</doc> version="1.14"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2702">Add a #GstReferenceTimestampMeta to @buffer that holds a @timestamp and + line="2705">Add a #GstReferenceTimestampMeta to @buffer that holds a @timestamp and optionally @duration based on a specific timestamp @reference. See the documentation of #GstReferenceTimestampMeta for details.</doc> <source-position filename="gst/gstbuffer.h" line="790"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2713">The #GstReferenceTimestampMeta that was added to the buffer</doc> + line="2716">The #GstReferenceTimestampMeta that was added to the buffer</doc> <type name="ReferenceTimestampMeta" c:type="GstReferenceTimestampMeta*"/> </return-value> @@ -2928,25 +2928,25 @@ documentation of #GstReferenceTimestampMeta for details.</doc> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2704">a #GstBuffer</doc> + line="2707">a #GstBuffer</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="reference" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2705">identifier for the timestamp reference.</doc> + line="2708">identifier for the timestamp reference.</doc> <type name="Caps" c:type="GstCaps*"/> </parameter> <parameter name="timestamp" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2706">timestamp</doc> + line="2709">timestamp</doc> <type name="ClockTime" c:type="GstClockTime"/> </parameter> <parameter name="duration" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2707">duration, or %GST_CLOCK_TIME_NONE</doc> + line="2710">duration, or %GST_CLOCK_TIME_NONE</doc> <type name="ClockTime" c:type="GstClockTime"/> </parameter> </parameters> @@ -2954,13 +2954,13 @@ documentation of #GstReferenceTimestampMeta for details.</doc> <method name="append" c:identifier="gst_buffer_append"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2149">Append all the memory from @buf2 to @buf1. The result buffer will contain a + line="2152">Append all the memory from @buf2 to @buf1. The result buffer will contain a concatenation of the memory of @buf1 and @buf2.</doc> <source-position filename="gst/gstbuffer.h" line="617"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2157">the new #GstBuffer that contains the memory + line="2160">the new #GstBuffer that contains the memory of the two source buffers.</doc> <type name="Buffer" c:type="GstBuffer*"/> </return-value> @@ -2968,13 +2968,13 @@ concatenation of the memory of @buf1 and @buf2.</doc> <instance-parameter name="buf1" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2151">the first source #GstBuffer to append.</doc> + line="2154">the first source #GstBuffer to append.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="buf2" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2152">the second source #GstBuffer to append.</doc> + line="2155">the second source #GstBuffer to append.</doc> <type name="Buffer" c:type="GstBuffer*"/> </parameter> </parameters> @@ -2982,7 +2982,7 @@ concatenation of the memory of @buf1 and @buf2.</doc> <method name="append_memory" c:identifier="gst_buffer_append_memory"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1080">Append the memory block @mem to @buffer. This function takes + line="1083">Append the memory block @mem to @buffer. This function takes ownership of @mem and thus doesn't increase its refcount. This function is identical to gst_buffer_insert_memory() with an index of -1. @@ -2995,13 +2995,13 @@ See gst_buffer_insert_memory() for more details.</doc> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1082">a #GstBuffer.</doc> + line="1085">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="mem" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1083">a #GstMemory.</doc> + line="1086">a #GstMemory.</doc> <type name="Memory" c:type="GstMemory*"/> </parameter> </parameters> @@ -3009,14 +3009,14 @@ See gst_buffer_insert_memory() for more details.</doc> <method name="append_region" c:identifier="gst_buffer_append_region"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2166">Append @size bytes at @offset from @buf2 to @buf1. The result buffer will + line="2169">Append @size bytes at @offset from @buf2 to @buf1. The result buffer will contain a concatenation of the memory of @buf1 and the requested region of @buf2.</doc> <source-position filename="gst/gstbuffer.h" line="614"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2177">the new #GstBuffer that contains the memory + line="2180">the new #GstBuffer that contains the memory of the two source buffers.</doc> <type name="Buffer" c:type="GstBuffer*"/> </return-value> @@ -3024,25 +3024,25 @@ contain a concatenation of the memory of @buf1 and the requested region of <instance-parameter name="buf1" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2168">the first source #GstBuffer to append.</doc> + line="2171">the first source #GstBuffer to append.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="buf2" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2169">the second source #GstBuffer to append.</doc> + line="2172">the second source #GstBuffer to append.</doc> <type name="Buffer" c:type="GstBuffer*"/> </parameter> <parameter name="offset" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2170">the offset in @buf2</doc> + line="2173">the offset in @buf2</doc> <type name="gssize" c:type="gssize"/> </parameter> <parameter name="size" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2171">the size or -1 of @buf2</doc> + line="2174">the size or -1 of @buf2</doc> <type name="gssize" c:type="gssize"/> </parameter> </parameters> @@ -3076,20 +3076,20 @@ to be copied to newly allocated memory.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="725">Create a copy of the given buffer. This will make a newly allocated + line="728">Create a copy of the given buffer. This will make a newly allocated copy of the data the source buffer contains.</doc> <source-position filename="gst/gstbuffer.h" line="489"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="732">a new copy of @buf.</doc> + line="735">a new copy of @buf.</doc> <type name="Buffer" c:type="GstBuffer*"/> </return-value> <parameters> <instance-parameter name="buf" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="727">a #GstBuffer.</doc> + line="730">a #GstBuffer.</doc> <type name="Buffer" c:type="const GstBuffer*"/> </instance-parameter> </parameters> @@ -3097,7 +3097,7 @@ copy of the data the source buffer contains.</doc> <method name="copy_into" c:identifier="gst_buffer_copy_into"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="516">Copies the information from @src into @dest. + line="519">Copies the information from @src into @dest. If @dest already contains memory and @flags contains GST_BUFFER_COPY_MEMORY, the memory from @src will be appended to @dest. @@ -3107,38 +3107,38 @@ the memory from @src will be appended to @dest. <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="531">%TRUE if the copying succeeded, %FALSE otherwise.</doc> + line="534">%TRUE if the copying succeeded, %FALSE otherwise.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="dest" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="518">a destination #GstBuffer</doc> + line="521">a destination #GstBuffer</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="src" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="519">a source #GstBuffer</doc> + line="522">a source #GstBuffer</doc> <type name="Buffer" c:type="GstBuffer*"/> </parameter> <parameter name="flags" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="520">flags indicating what metadata fields should be copied.</doc> + line="523">flags indicating what metadata fields should be copied.</doc> <type name="BufferCopyFlags" c:type="GstBufferCopyFlags"/> </parameter> <parameter name="offset" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="521">offset to copy from</doc> + line="524">offset to copy from</doc> <type name="gsize" c:type="gsize"/> </parameter> <parameter name="size" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="522">total size to copy. If -1, all data is copied.</doc> + line="525">total size to copy. If -1, all data is copied.</doc> <type name="gsize" c:type="gsize"/> </parameter> </parameters> @@ -3146,7 +3146,7 @@ the memory from @src will be appended to @dest. <method name="copy_region" c:identifier="gst_buffer_copy_region"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2106">Creates a sub-buffer from @parent at @offset and @size. + line="2109">Creates a sub-buffer from @parent at @offset and @size. This sub-buffer uses the actual memory space of the parent buffer. This function will copy the offset and timestamp fields when the offset is 0. If not, they will be set to #GST_CLOCK_TIME_NONE and @@ -3160,7 +3160,7 @@ MT safe.</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2126">the new #GstBuffer or %NULL if the arguments were + line="2129">the new #GstBuffer or %NULL if the arguments were invalid.</doc> <type name="Buffer" c:type="GstBuffer*"/> </return-value> @@ -3168,26 +3168,26 @@ MT safe.</doc> <instance-parameter name="parent" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2108">a #GstBuffer.</doc> + line="2111">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="flags" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2109">the #GstBufferCopyFlags</doc> + line="2112">the #GstBufferCopyFlags</doc> <type name="BufferCopyFlags" c:type="GstBufferCopyFlags"/> </parameter> <parameter name="offset" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2110">the offset into parent #GstBuffer at which the new sub-buffer + line="2113">the offset into parent #GstBuffer at which the new sub-buffer begins.</doc> <type name="gsize" c:type="gsize"/> </parameter> <parameter name="size" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2112">the size of the new #GstBuffer sub-buffer, in bytes. If -1, all + line="2115">the size of the new #GstBuffer sub-buffer, in bytes. If -1, all data is copied.</doc> <type name="gsize" c:type="gsize"/> </parameter> @@ -3196,12 +3196,12 @@ MT safe.</doc> <method name="extract" c:identifier="gst_buffer_extract"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1954">Copy @size bytes starting from @offset in @buffer to @dest.</doc> + line="1957">Copy @size bytes starting from @offset in @buffer to @dest.</doc> <source-position filename="gst/gstbuffer.h" line="360"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1964">The amount of bytes extracted. This value can be lower than @size + line="1967">The amount of bytes extracted. This value can be lower than @size when @buffer did not contain enough data.</doc> <type name="gsize" c:type="gsize"/> </return-value> @@ -3209,13 +3209,13 @@ MT safe.</doc> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1956">a #GstBuffer.</doc> + line="1959">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="offset" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1957">the offset to extract</doc> + line="1960">the offset to extract</doc> <type name="gsize" c:type="gsize"/> </parameter> <parameter name="dest" @@ -3224,7 +3224,7 @@ MT safe.</doc> transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1958"> + line="1961"> the destination address</doc> <array length="2" zero-terminated="0" c:type="gpointer"> <type name="guint8"/> @@ -3236,7 +3236,7 @@ MT safe.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1960">the size to extract</doc> + line="1963">the size to extract</doc> <type name="gsize" c:type="gsize"/> </parameter> </parameters> @@ -3246,7 +3246,7 @@ MT safe.</doc> version="1.0.10"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2536">Extracts a copy of at most @size bytes the data at @offset into + line="2539">Extracts a copy of at most @size bytes the data at @offset into newly-allocated memory. @dest must be freed using g_free() when done.</doc> <source-position filename="gst/gstbuffer.h" line="396"/> <return-value transfer-ownership="none"> @@ -3256,19 +3256,19 @@ newly-allocated memory. @dest must be freed using g_free() when done.</doc> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2538">a #GstBuffer</doc> + line="2541">a #GstBuffer</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="offset" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2539">the offset to extract</doc> + line="2542">the offset to extract</doc> <type name="gsize" c:type="gsize"/> </parameter> <parameter name="size" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2540">the size to extract</doc> + line="2543">the size to extract</doc> <type name="gsize" c:type="gsize"/> </parameter> <parameter name="dest" @@ -3277,7 +3277,7 @@ newly-allocated memory. @dest must be freed using g_free() when done.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2541">A pointer where + line="2544">A pointer where the destination array will be written. Might be %NULL if the size is 0.</doc> <array length="3" zero-terminated="0" c:type="gpointer*"> <type name="guint8"/> @@ -3289,7 +3289,7 @@ newly-allocated memory. @dest must be freed using g_free() when done.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2543">A location where the size of @dest can be written</doc> + line="2546">A location where the size of @dest can be written</doc> <type name="gsize" c:type="gsize*"/> </parameter> </parameters> @@ -3297,12 +3297,12 @@ newly-allocated memory. @dest must be freed using g_free() when done.</doc> <method name="fill" c:identifier="gst_buffer_fill"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1902">Copy @size bytes from @src to @buffer at @offset.</doc> + line="1905">Copy @size bytes from @src to @buffer at @offset.</doc> <source-position filename="gst/gstbuffer.h" line="357"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1911">The amount of bytes copied. This value can be lower than @size + line="1914">The amount of bytes copied. This value can be lower than @size when @buffer did not contain enough data.</doc> <type name="gsize" c:type="gsize"/> </return-value> @@ -3310,19 +3310,19 @@ newly-allocated memory. @dest must be freed using g_free() when done.</doc> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1904">a #GstBuffer.</doc> + line="1907">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="offset" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1905">the offset to fill</doc> + line="1908">the offset to fill</doc> <type name="gsize" c:type="gsize"/> </parameter> <parameter name="src" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1906">the source address</doc> + line="1909">the source address</doc> <array length="2" zero-terminated="0" c:type="gconstpointer"> <type name="guint8"/> </array> @@ -3330,7 +3330,7 @@ newly-allocated memory. @dest must be freed using g_free() when done.</doc> <parameter name="size" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1907">the size to fill</doc> + line="1910">the size to fill</doc> <type name="gsize" c:type="gsize"/> </parameter> </parameters> @@ -3338,7 +3338,7 @@ newly-allocated memory. @dest must be freed using g_free() when done.</doc> <method name="find_memory" c:identifier="gst_buffer_find_memory"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1356">Find the memory blocks that span @size bytes starting from @offset + line="1359">Find the memory blocks that span @size bytes starting from @offset in @buffer. When this function returns %TRUE, @idx will contain the index of the first @@ -3352,7 +3352,7 @@ for @offset. <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1376">%TRUE when @size bytes starting from @offset could be found in + line="1379">%TRUE when @size bytes starting from @offset could be found in @buffer and @idx, @length and @skip will be filled.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -3360,19 +3360,19 @@ for @offset. <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1358">a #GstBuffer.</doc> + line="1361">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="offset" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1359">an offset</doc> + line="1362">an offset</doc> <type name="gsize" c:type="gsize"/> </parameter> <parameter name="size" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1360">a size</doc> + line="1363">a size</doc> <type name="gsize" c:type="gsize"/> </parameter> <parameter name="idx" @@ -3381,7 +3381,7 @@ for @offset. transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1361">pointer to index</doc> + line="1364">pointer to index</doc> <type name="guint" c:type="guint*"/> </parameter> <parameter name="length" @@ -3390,7 +3390,7 @@ for @offset. transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1362">pointer to length</doc> + line="1365">pointer to length</doc> <type name="guint" c:type="guint*"/> </parameter> <parameter name="skip" @@ -3399,7 +3399,7 @@ for @offset. transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1363">pointer to skip</doc> + line="1366">pointer to skip</doc> <type name="gsize" c:type="gsize*"/> </parameter> </parameters> @@ -3407,7 +3407,7 @@ for @offset. <method name="foreach_meta" c:identifier="gst_buffer_foreach_meta"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2464">Call @func with @user_data for each meta in @buffer. + line="2467">Call @func with @user_data for each meta in @buffer. @func can modify the passed meta pointer or its contents. The return value of @func define if this function returns or if the remaining metadata items @@ -3416,14 +3416,14 @@ in the buffer should be skipped.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2476">%FALSE when @func returned %FALSE for one of the metadata.</doc> + line="2479">%FALSE when @func returned %FALSE for one of the metadata.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2466">a #GstBuffer</doc> + line="2469">a #GstBuffer</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="func" @@ -3432,7 +3432,7 @@ in the buffer should be skipped.</doc> closure="1"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2467">a #GstBufferForeachMetaFunc to call</doc> + line="2470">a #GstBufferForeachMetaFunc to call</doc> <type name="BufferForeachMetaFunc" c:type="GstBufferForeachMetaFunc"/> </parameter> @@ -3442,7 +3442,7 @@ in the buffer should be skipped.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2468">user data passed to @func</doc> + line="2471">user data passed to @func</doc> <type name="gpointer" c:type="gpointer"/> </parameter> </parameters> @@ -3450,13 +3450,13 @@ in the buffer should be skipped.</doc> <method name="get_all_memory" c:identifier="gst_buffer_get_all_memory"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1190">Get all the memory block in @buffer. The memory blocks will be merged + line="1193">Get all the memory block in @buffer. The memory blocks will be merged into one large #GstMemory.</doc> <source-position filename="gst/gstbuffer.h" line="339"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1197">a #GstMemory that contains the merged memory. + line="1200">a #GstMemory that contains the merged memory. Use gst_memory_unref () after usage.</doc> <type name="Memory" c:type="GstMemory*"/> </return-value> @@ -3464,7 +3464,7 @@ Use gst_memory_unref () after usage.</doc> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1192">a #GstBuffer.</doc> + line="1195">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> </parameters> @@ -3474,19 +3474,19 @@ Use gst_memory_unref () after usage.</doc> version="1.10"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="350">Get the #GstBufferFlags flags set on this buffer.</doc> + line="353">Get the #GstBufferFlags flags set on this buffer.</doc> <source-position filename="gst/gstbuffer.h" line="400"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="356">the flags set on this buffer.</doc> + line="359">the flags set on this buffer.</doc> <type name="BufferFlags" c:type="GstBufferFlags"/> </return-value> <parameters> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="352">a #GstBuffer</doc> + line="355">a #GstBuffer</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> </parameters> @@ -3494,12 +3494,12 @@ Use gst_memory_unref () after usage.</doc> <method name="get_memory" c:identifier="gst_buffer_get_memory"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1174">Get the memory block at index @idx in @buffer.</doc> + line="1177">Get the memory block at index @idx in @buffer.</doc> <source-position filename="gst/gstbuffer.h" line="336"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1181">a #GstMemory that contains the data of the + line="1184">a #GstMemory that contains the data of the memory block at @idx. Use gst_memory_unref () after usage.</doc> <type name="Memory" c:type="GstMemory*"/> </return-value> @@ -3507,13 +3507,13 @@ memory block at @idx. Use gst_memory_unref () after usage.</doc> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1176">a #GstBuffer.</doc> + line="1179">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="idx" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1177">an index</doc> + line="1180">an index</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -3522,7 +3522,7 @@ memory block at @idx. Use gst_memory_unref () after usage.</doc> c:identifier="gst_buffer_get_memory_range"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1206">Get @length memory blocks in @buffer starting at @idx. The memory blocks will + line="1209">Get @length memory blocks in @buffer starting at @idx. The memory blocks will be merged into one large #GstMemory. If @length is -1, all memory starting from @idx is merged.</doc> @@ -3530,7 +3530,7 @@ If @length is -1, all memory starting from @idx is merged.</doc> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1217">a #GstMemory that contains the merged data of @length + line="1220">a #GstMemory that contains the merged data of @length blocks starting at @idx. Use gst_memory_unref () after usage.</doc> <type name="Memory" c:type="GstMemory*"/> </return-value> @@ -3538,19 +3538,19 @@ If @length is -1, all memory starting from @idx is merged.</doc> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1208">a #GstBuffer.</doc> + line="1211">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="idx" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1209">an index</doc> + line="1212">an index</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="length" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1210">a length</doc> + line="1213">a length</doc> <type name="gint" c:type="gint"/> </parameter> </parameters> @@ -3558,7 +3558,7 @@ If @length is -1, all memory starting from @idx is merged.</doc> <method name="get_meta" c:identifier="gst_buffer_get_meta"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2212">Get the metadata for @api on buffer. When there is no such metadata, %NULL is + line="2215">Get the metadata for @api on buffer. When there is no such metadata, %NULL is returned. If multiple metadata with the given @api are attached to this buffer only the first one is returned. To handle multiple metadata with a given API use gst_buffer_iterate_meta() or gst_buffer_foreach_meta() instead @@ -3567,7 +3567,7 @@ and check the meta->info.api member for the API type.</doc> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2223">the metadata for @api on + line="2226">the metadata for @api on @buffer.</doc> <type name="Meta" c:type="GstMeta*"/> </return-value> @@ -3575,13 +3575,13 @@ and check the meta->info.api member for the API type.</doc> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2214">a #GstBuffer</doc> + line="2217">a #GstBuffer</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="api" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2215">the #GType of an API</doc> + line="2218">the #GType of an API</doc> <type name="GType" c:type="GType"/> </parameter> </parameters> @@ -3593,20 +3593,20 @@ and check the meta->info.api member for the API type.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2251">number of metas of type @api_type on @buffer.</doc> + line="2254">number of metas of type @api_type on @buffer.</doc> <type name="guint" c:type="guint"/> </return-value> <parameters> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2248">a #GstBuffer</doc> + line="2251">a #GstBuffer</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="api_type" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2249">the #GType of an API</doc> + line="2252">the #GType of an API</doc> <type name="GType" c:type="GType"/> </parameter> </parameters> @@ -3616,7 +3616,7 @@ and check the meta->info.api member for the API type.</doc> version="1.14"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2740">Find the first #GstReferenceTimestampMeta on @buffer that conforms to + line="2743">Find the first #GstReferenceTimestampMeta on @buffer that conforms to @reference. Conformance is tested by checking if the meta's reference is a subset of @reference. @@ -3625,7 +3625,7 @@ Buffers can contain multiple #GstReferenceTimestampMeta metadata items.</doc> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2751">the #GstReferenceTimestampMeta or %NULL when there + line="2754">the #GstReferenceTimestampMeta or %NULL when there is no such metadata on @buffer.</doc> <type name="ReferenceTimestampMeta" c:type="GstReferenceTimestampMeta*"/> @@ -3634,7 +3634,7 @@ is no such metadata on @buffer.</doc> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2742">a #GstBuffer</doc> + line="2745">a #GstBuffer</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="reference" @@ -3643,7 +3643,7 @@ is no such metadata on @buffer.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2743">a reference #GstCaps</doc> + line="2746">a reference #GstCaps</doc> <type name="Caps" c:type="GstCaps*"/> </parameter> </parameters> @@ -3651,19 +3651,19 @@ is no such metadata on @buffer.</doc> <method name="get_size" c:identifier="gst_buffer_get_size"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1513">Get the total size of the memory blocks in @buffer.</doc> + line="1516">Get the total size of the memory blocks in @buffer.</doc> <source-position filename="gst/gstbuffer.h" line="378"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1519">total size of the memory blocks in @buffer.</doc> + line="1522">total size of the memory blocks in @buffer.</doc> <type name="gsize" c:type="gsize"/> </return-value> <parameters> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1515">a #GstBuffer.</doc> + line="1518">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> </parameters> @@ -3671,7 +3671,7 @@ is no such metadata on @buffer.</doc> <method name="get_sizes" c:identifier="gst_buffer_get_sizes"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1491">Get the total size of the memory blocks in @b. + line="1494">Get the total size of the memory blocks in @b. When not %NULL, @offset will contain the offset of the data in the first memory block in @buffer and @maxsize will contain the sum of @@ -3682,14 +3682,14 @@ buffer memory blocks with gst_buffer_resize().</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1505">total size of the memory blocks in @buffer.</doc> + line="1508">total size of the memory blocks in @buffer.</doc> <type name="gsize" c:type="gsize"/> </return-value> <parameters> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1493">a #GstBuffer.</doc> + line="1496">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="offset" @@ -3700,7 +3700,7 @@ buffer memory blocks with gst_buffer_resize().</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1494">a pointer to the offset</doc> + line="1497">a pointer to the offset</doc> <type name="gsize" c:type="gsize*"/> </parameter> <parameter name="maxsize" @@ -3711,7 +3711,7 @@ buffer memory blocks with gst_buffer_resize().</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1495">a pointer to the maxsize</doc> + line="1498">a pointer to the maxsize</doc> <type name="gsize" c:type="gsize*"/> </parameter> </parameters> @@ -3719,7 +3719,7 @@ buffer memory blocks with gst_buffer_resize().</doc> <method name="get_sizes_range" c:identifier="gst_buffer_get_sizes_range"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1536">Get the total size of @length memory blocks stating from @idx in @buffer. + line="1539">Get the total size of @length memory blocks stating from @idx in @buffer. When not %NULL, @offset will contain the offset of the data in the memory block in @buffer at @idx and @maxsize will contain the sum of the size @@ -3731,26 +3731,26 @@ gst_buffer_resize_range().</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1553">total size of @length memory blocks starting at @idx in @buffer.</doc> + line="1556">total size of @length memory blocks starting at @idx in @buffer.</doc> <type name="gsize" c:type="gsize"/> </return-value> <parameters> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1538">a #GstBuffer.</doc> + line="1541">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="idx" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1539">an index</doc> + line="1542">an index</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="length" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1540">a length</doc> + line="1543">a length</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="offset" @@ -3761,7 +3761,7 @@ gst_buffer_resize_range().</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1541">a pointer to the offset</doc> + line="1544">a pointer to the offset</doc> <type name="gsize" c:type="gsize*"/> </parameter> <parameter name="maxsize" @@ -3772,21 +3772,35 @@ gst_buffer_resize_range().</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1542">a pointer to the maxsize</doc> + line="1545">a pointer to the maxsize</doc> <type name="gsize" c:type="gsize*"/> </parameter> </parameters> </method> - <method name="has_flags" c:identifier="gst_buffer_has_flags"> + <method name="has_flags" + c:identifier="gst_buffer_has_flags" + version="1.10"> + <doc xml:space="preserve" + filename="gst/gstbuffer.c" + line="369">Gives the status of a specific flag on a buffer.</doc> <source-position filename="gst/gstbuffer.h" line="403"/> <return-value transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst/gstbuffer.c" + line="376">%TRUE if all flags in @flags are found on @buffer.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="buffer" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst/gstbuffer.c" + line="371">a #GstBuffer</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="flags" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst/gstbuffer.c" + line="372">the #GstBufferFlags flag to check.</doc> <type name="BufferFlags" c:type="GstBufferFlags"/> </parameter> </parameters> @@ -3794,7 +3808,7 @@ gst_buffer_resize_range().</doc> <method name="insert_memory" c:identifier="gst_buffer_insert_memory"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1097">Insert the memory block @mem to @buffer at @idx. This function takes ownership + line="1100">Insert the memory block @mem to @buffer at @idx. This function takes ownership of @mem and thus doesn't increase its refcount. Only gst_buffer_get_max_memory() can be added to a buffer. If more memory is @@ -3808,19 +3822,19 @@ the new memory.</doc> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1099">a #GstBuffer.</doc> + line="1102">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="idx" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1100">the index to add the memory at, or -1 to append it to the end</doc> + line="1103">the index to add the memory at, or -1 to append it to the end</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="mem" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1101">a #GstMemory.</doc> + line="1104">a #GstMemory.</doc> <type name="Memory" c:type="GstMemory*"/> </parameter> </parameters> @@ -3830,7 +3844,7 @@ the new memory.</doc> version="1.4"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1472">Check if all memory blocks in @buffer are writable. + line="1475">Check if all memory blocks in @buffer are writable. Note that this function does not check if @buffer is writable, use gst_buffer_is_writable() to check that if needed.</doc> @@ -3838,14 +3852,14 @@ gst_buffer_is_writable() to check that if needed.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1481">%TRUE if all memory blocks in @buffer are writable</doc> + line="1484">%TRUE if all memory blocks in @buffer are writable</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1474">a #GstBuffer.</doc> + line="1477">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> </parameters> @@ -3855,7 +3869,7 @@ gst_buffer_is_writable() to check that if needed.</doc> version="1.4"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1429">Check if @length memory blocks in @buffer starting from @idx are writable. + line="1432">Check if @length memory blocks in @buffer starting from @idx are writable. @length can be -1 to check all the memory blocks after @idx. @@ -3865,26 +3879,26 @@ gst_buffer_is_writable() to check that if needed.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1442">%TRUE if the memory range is writable</doc> + line="1445">%TRUE if the memory range is writable</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1431">a #GstBuffer.</doc> + line="1434">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="idx" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1432">an index</doc> + line="1435">an index</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="length" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1433">a length should not be 0</doc> + line="1436">a length should not be 0</doc> <type name="gint" c:type="gint"/> </parameter> </parameters> @@ -3894,7 +3908,7 @@ gst_buffer_is_writable() to check that if needed.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2386">Retrieve the next #GstMeta after @current. If @state points + line="2389">Retrieve the next #GstMeta after @current. If @state points to %NULL, the first metadata is returned. @state will be updated with an opaque state pointer</doc> @@ -3902,7 +3916,7 @@ to %NULL, the first metadata is returned. <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2396">The next #GstMeta or %NULL + line="2399">The next #GstMeta or %NULL when there are no more items.</doc> <type name="Meta" c:type="GstMeta*"/> </return-value> @@ -3910,7 +3924,7 @@ when there are no more items.</doc> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2388">a #GstBuffer</doc> + line="2391">a #GstBuffer</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="state" @@ -3920,7 +3934,7 @@ when there are no more items.</doc> nullable="1"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2389">an opaque state pointer</doc> + line="2392">an opaque state pointer</doc> <type name="gpointer" c:type="gpointer*"/> </parameter> </parameters> @@ -3931,7 +3945,7 @@ when there are no more items.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2421">Retrieve the next #GstMeta of type @meta_api_type after the current one + line="2424">Retrieve the next #GstMeta of type @meta_api_type after the current one according to @state. If @state points to %NULL, the first metadata of type @meta_api_type is returned. @@ -3940,7 +3954,7 @@ type @meta_api_type is returned. <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2433">The next #GstMeta of type + line="2436">The next #GstMeta of type @meta_api_type or %NULL when there are no more items.</doc> <type name="Meta" c:type="GstMeta*"/> </return-value> @@ -3948,7 +3962,7 @@ type @meta_api_type is returned. <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2423">a #GstBuffer</doc> + line="2426">a #GstBuffer</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="state" @@ -3958,13 +3972,13 @@ type @meta_api_type is returned. nullable="1"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2424">an opaque state pointer</doc> + line="2427">an opaque state pointer</doc> <type name="gpointer" c:type="gpointer*"/> </parameter> <parameter name="meta_api_type" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2425">only return #GstMeta of this type</doc> + line="2428">only return #GstMeta of this type</doc> <type name="GType" c:type="GType"/> </parameter> </parameters> @@ -3972,7 +3986,7 @@ type @meta_api_type is returned. <method name="map" c:identifier="gst_buffer_map"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1753">This function fills @info with the #GstMapInfo of all merged memory + line="1756">This function fills @info with the #GstMapInfo of all merged memory blocks in @buffer. @flags describe the desired access of the memory. When @flags is @@ -3989,14 +4003,14 @@ usage.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1773">%TRUE if the map succeeded and @info contains valid data.</doc> + line="1776">%TRUE if the map succeeded and @info contains valid data.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1755">a #GstBuffer.</doc> + line="1758">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="info" @@ -4005,13 +4019,13 @@ usage.</doc> transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1756">info about the mapping</doc> + line="1759">info about the mapping</doc> <type name="MapInfo" c:type="GstMapInfo*"/> </parameter> <parameter name="flags" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1757">flags for the mapping</doc> + line="1760">flags for the mapping</doc> <type name="MapFlags" c:type="GstMapFlags"/> </parameter> </parameters> @@ -4019,7 +4033,7 @@ usage.</doc> <method name="map_range" c:identifier="gst_buffer_map_range"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1781">This function fills @info with the #GstMapInfo of @length merged memory blocks + line="1784">This function fills @info with the #GstMapInfo of @length merged memory blocks starting at @idx in @buffer. When @length is -1, all memory blocks starting from @idx are merged and mapped. @@ -4036,7 +4050,7 @@ The memory in @info should be unmapped with gst_buffer_unmap() after usage.</doc <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1803">%TRUE if the map succeeded and @info contains valid + line="1806">%TRUE if the map succeeded and @info contains valid data.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -4044,19 +4058,19 @@ data.</doc> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1783">a #GstBuffer.</doc> + line="1786">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="idx" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1784">an index</doc> + line="1787">an index</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="length" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1785">a length</doc> + line="1788">a length</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="info" @@ -4065,13 +4079,13 @@ data.</doc> transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1786">info about the mapping</doc> + line="1789">info about the mapping</doc> <type name="MapInfo" c:type="GstMapInfo*"/> </parameter> <parameter name="flags" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1787">flags for the mapping</doc> + line="1790">flags for the mapping</doc> <type name="MapFlags" c:type="GstMapFlags"/> </parameter> </parameters> @@ -4079,31 +4093,31 @@ data.</doc> <method name="memcmp" c:identifier="gst_buffer_memcmp"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2005">Compare @size bytes starting from @offset in @buffer with the memory in @mem.</doc> + line="2008">Compare @size bytes starting from @offset in @buffer with the memory in @mem.</doc> <source-position filename="gst/gstbuffer.h" line="363"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2014">0 if the memory is equal.</doc> + line="2017">0 if the memory is equal.</doc> <type name="gint" c:type="gint"/> </return-value> <parameters> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2007">a #GstBuffer.</doc> + line="2010">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="offset" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2008">the offset in @buffer</doc> + line="2011">the offset in @buffer</doc> <type name="gsize" c:type="gsize"/> </parameter> <parameter name="mem" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2009">the memory to compare</doc> + line="2012">the memory to compare</doc> <array length="2" zero-terminated="0" c:type="gconstpointer"> <type name="guint8"/> </array> @@ -4111,7 +4125,7 @@ data.</doc> <parameter name="size" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2010">the size to compare</doc> + line="2013">the size to compare</doc> <type name="gsize" c:type="gsize"/> </parameter> </parameters> @@ -4119,12 +4133,12 @@ data.</doc> <method name="memset" c:identifier="gst_buffer_memset"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2058">Fill @buf with @size bytes with @val starting from @offset.</doc> + line="2061">Fill @buf with @size bytes with @val starting from @offset.</doc> <source-position filename="gst/gstbuffer.h" line="366"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2067">The amount of bytes filled. This value can be lower than @size + line="2070">The amount of bytes filled. This value can be lower than @size when @buffer did not contain enough data.</doc> <type name="gsize" c:type="gsize"/> </return-value> @@ -4132,25 +4146,25 @@ data.</doc> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2060">a #GstBuffer.</doc> + line="2063">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="offset" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2061">the offset in @buffer</doc> + line="2064">the offset in @buffer</doc> <type name="gsize" c:type="gsize"/> </parameter> <parameter name="val" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2062">the value to set</doc> + line="2065">the value to set</doc> <type name="guint8" c:type="guint8"/> </parameter> <parameter name="size" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2063">the size to set</doc> + line="2066">the size to set</doc> <type name="gsize" c:type="gsize"/> </parameter> </parameters> @@ -4158,20 +4172,20 @@ data.</doc> <method name="n_memory" c:identifier="gst_buffer_n_memory"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1046">Get the amount of memory blocks that this buffer has. This amount is never + line="1049">Get the amount of memory blocks that this buffer has. This amount is never larger than what gst_buffer_get_max_memory() returns.</doc> <source-position filename="gst/gstbuffer.h" line="306"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1053">the number of memory blocks this buffer is made of.</doc> + line="1056">the number of memory blocks this buffer is made of.</doc> <type name="guint" c:type="guint"/> </return-value> <parameters> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1048">a #GstBuffer.</doc> + line="1051">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> </parameters> @@ -4179,27 +4193,27 @@ larger than what gst_buffer_get_max_memory() returns.</doc> <method name="peek_memory" c:identifier="gst_buffer_peek_memory"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1154">Get the memory block at @idx in @buffer. The memory block stays valid until + line="1157">Get the memory block at @idx in @buffer. The memory block stays valid until the memory block in @buffer is removed, replaced or merged, typically with any call that modifies the memory in @buffer.</doc> <source-position filename="gst/gstbuffer.h" line="315"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1163">the #GstMemory at @idx.</doc> + line="1166">the #GstMemory at @idx.</doc> <type name="Memory" c:type="GstMemory*"/> </return-value> <parameters> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1156">a #GstBuffer.</doc> + line="1159">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="idx" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1157">an index</doc> + line="1160">an index</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -4207,7 +4221,7 @@ any call that modifies the memory in @buffer.</doc> <method name="prepend_memory" c:identifier="gst_buffer_prepend_memory"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1063">Prepend the memory block @mem to @buffer. This function takes + line="1066">Prepend the memory block @mem to @buffer. This function takes ownership of @mem and thus doesn't increase its refcount. This function is identical to gst_buffer_insert_memory() with an index of 0. @@ -4220,13 +4234,13 @@ See gst_buffer_insert_memory() for more details.</doc> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1065">a #GstBuffer.</doc> + line="1068">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="mem" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1066">a #GstMemory.</doc> + line="1069">a #GstMemory.</doc> <type name="Memory" c:type="GstMemory*"/> </parameter> </parameters> @@ -4261,7 +4275,7 @@ of memcpy operations in a pipeline.</doc> c:identifier="gst_buffer_remove_all_memory"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1313">Remove all the memory blocks in @buffer.</doc> + line="1316">Remove all the memory blocks in @buffer.</doc> <source-position filename="gst/gstbuffer.h" line="345"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> @@ -4270,7 +4284,7 @@ of memcpy operations in a pipeline.</doc> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1315">a #GstBuffer.</doc> + line="1318">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> </parameters> @@ -4278,7 +4292,7 @@ of memcpy operations in a pipeline.</doc> <method name="remove_memory" c:identifier="gst_buffer_remove_memory"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1300">Remove the memory block in @b at index @i.</doc> + line="1303">Remove the memory block in @b at index @i.</doc> <source-position filename="gst/gstbuffer.h" line="342"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> @@ -4287,13 +4301,13 @@ of memcpy operations in a pipeline.</doc> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1302">a #GstBuffer.</doc> + line="1305">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="idx" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1303">an index</doc> + line="1306">an index</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -4302,7 +4316,7 @@ of memcpy operations in a pipeline.</doc> c:identifier="gst_buffer_remove_memory_range"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1326">Remove @length memory blocks in @buffer starting from @idx. + line="1329">Remove @length memory blocks in @buffer starting from @idx. @length can be -1, in which case all memory starting from @idx is removed.</doc> <source-position filename="gst/gstbuffer.h" line="321"/> @@ -4313,19 +4327,19 @@ of memcpy operations in a pipeline.</doc> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1328">a #GstBuffer.</doc> + line="1331">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="idx" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1329">an index</doc> + line="1332">an index</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="length" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1330">a length</doc> + line="1333">a length</doc> <type name="gint" c:type="gint"/> </parameter> </parameters> @@ -4333,12 +4347,12 @@ of memcpy operations in a pipeline.</doc> <method name="remove_meta" c:identifier="gst_buffer_remove_meta"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2332">Remove the metadata for @meta on @buffer.</doc> + line="2335">Remove the metadata for @meta on @buffer.</doc> <source-position filename="gst/gstbuffer.h" line="653"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2339">%TRUE if the metadata existed and was removed, %FALSE if no such + line="2342">%TRUE if the metadata existed and was removed, %FALSE if no such metadata was on @buffer.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -4346,13 +4360,13 @@ metadata was on @buffer.</doc> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2334">a #GstBuffer</doc> + line="2337">a #GstBuffer</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="meta" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2335">a #GstMeta</doc> + line="2338">a #GstMeta</doc> <type name="Meta" c:type="GstMeta*"/> </parameter> </parameters> @@ -4361,7 +4375,7 @@ metadata was on @buffer.</doc> c:identifier="gst_buffer_replace_all_memory"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1252">Replaces all memory in @buffer with @mem.</doc> + line="1255">Replaces all memory in @buffer with @mem.</doc> <source-position filename="gst/gstbuffer.h" line="333"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> @@ -4370,13 +4384,13 @@ metadata was on @buffer.</doc> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1254">a #GstBuffer.</doc> + line="1257">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="mem" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1255">a #GstMemory</doc> + line="1258">a #GstMemory</doc> <type name="Memory" c:type="GstMemory*"/> </parameter> </parameters> @@ -4384,7 +4398,7 @@ metadata was on @buffer.</doc> <method name="replace_memory" c:identifier="gst_buffer_replace_memory"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1238">Replaces the memory block at index @idx in @buffer with @mem.</doc> + line="1241">Replaces the memory block at index @idx in @buffer with @mem.</doc> <source-position filename="gst/gstbuffer.h" line="330"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> @@ -4393,19 +4407,19 @@ metadata was on @buffer.</doc> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1240">a #GstBuffer.</doc> + line="1243">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="idx" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1241">an index</doc> + line="1244">an index</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="mem" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1242">a #GstMemory</doc> + line="1245">a #GstMemory</doc> <type name="Memory" c:type="GstMemory*"/> </parameter> </parameters> @@ -4414,7 +4428,7 @@ metadata was on @buffer.</doc> c:identifier="gst_buffer_replace_memory_range"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1265">Replaces @length memory blocks in @buffer starting at @idx with @mem. + line="1268">Replaces @length memory blocks in @buffer starting at @idx with @mem. If @length is -1, all memory starting from @idx will be removed and replaced with @mem. @@ -4428,25 +4442,25 @@ replaced with @mem. <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1267">a #GstBuffer.</doc> + line="1270">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="idx" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1268">an index</doc> + line="1271">an index</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="length" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1269">a length should not be 0</doc> + line="1272">a length should not be 0</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="mem" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1270">a #GstMemory</doc> + line="1273">a #GstMemory</doc> <type name="Memory" c:type="GstMemory*"/> </parameter> </parameters> @@ -4454,7 +4468,7 @@ replaced with @mem. <method name="resize" c:identifier="gst_buffer_resize"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1618">Set the offset and total size of the memory blocks in @buffer.</doc> + line="1621">Set the offset and total size of the memory blocks in @buffer.</doc> <source-position filename="gst/gstbuffer.h" line="381"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> @@ -4463,19 +4477,19 @@ replaced with @mem. <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1620">a #GstBuffer.</doc> + line="1623">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="offset" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1621">the offset adjustment</doc> + line="1624">the offset adjustment</doc> <type name="gssize" c:type="gssize"/> </parameter> <parameter name="size" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1622">the new size or -1 to just adjust the offset</doc> + line="1625">the new size or -1 to just adjust the offset</doc> <type name="gssize" c:type="gssize"/> </parameter> </parameters> @@ -4483,44 +4497,44 @@ replaced with @mem. <method name="resize_range" c:identifier="gst_buffer_resize_range"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1645">Set the total size of the @length memory blocks starting at @idx in + line="1648">Set the total size of the @length memory blocks starting at @idx in @buffer</doc> <source-position filename="gst/gstbuffer.h" line="372"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1656">%TRUE if resizing succeeded, %FALSE otherwise.</doc> + line="1659">%TRUE if resizing succeeded, %FALSE otherwise.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1647">a #GstBuffer.</doc> + line="1650">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="idx" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1648">an index</doc> + line="1651">an index</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="length" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1649">a length</doc> + line="1652">a length</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="offset" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1650">the offset adjustment</doc> + line="1653">the offset adjustment</doc> <type name="gssize" c:type="gssize"/> </parameter> <parameter name="size" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1651">the new size or -1 to just adjust the offset</doc> + line="1654">the new size or -1 to just adjust the offset</doc> <type name="gssize" c:type="gssize"/> </parameter> </parameters> @@ -4530,25 +4544,25 @@ replaced with @mem. version="1.10"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="383">Sets one or more buffer flags on a buffer.</doc> + line="386">Sets one or more buffer flags on a buffer.</doc> <source-position filename="gst/gstbuffer.h" line="406"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="390">%TRUE if @flags were successfully set on buffer.</doc> + line="393">%TRUE if @flags were successfully set on buffer.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="385">a #GstBuffer</doc> + line="388">a #GstBuffer</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="flags" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="386">the #GstBufferFlags to set.</doc> + line="389">the #GstBufferFlags to set.</doc> <type name="BufferFlags" c:type="GstBufferFlags"/> </parameter> </parameters> @@ -4556,7 +4570,7 @@ replaced with @mem. <method name="set_size" c:identifier="gst_buffer_set_size"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1632">Set the total size of the memory blocks in @buffer.</doc> + line="1635">Set the total size of the memory blocks in @buffer.</doc> <source-position filename="gst/gstbuffer.h" line="384"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> @@ -4565,13 +4579,13 @@ replaced with @mem. <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1634">a #GstBuffer.</doc> + line="1637">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="size" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1635">the new size</doc> + line="1638">the new size</doc> <type name="gssize" c:type="gssize"/> </parameter> </parameters> @@ -4579,7 +4593,7 @@ replaced with @mem. <method name="unmap" c:identifier="gst_buffer_unmap"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1881">Release the memory previously mapped with gst_buffer_map().</doc> + line="1884">Release the memory previously mapped with gst_buffer_map().</doc> <source-position filename="gst/gstbuffer.h" line="393"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> @@ -4588,13 +4602,13 @@ replaced with @mem. <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1883">a #GstBuffer.</doc> + line="1886">a #GstBuffer.</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="info" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="1884">a #GstMapInfo</doc> + line="1887">a #GstMapInfo</doc> <type name="MapInfo" c:type="GstMapInfo*"/> </parameter> </parameters> @@ -4622,25 +4636,25 @@ with the associated metadata and memory will be freed.</doc> version="1.10"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="401">Clears one or more buffer flags.</doc> + line="404">Clears one or more buffer flags.</doc> <source-position filename="gst/gstbuffer.h" line="409"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="408">true if @flags is successfully cleared from buffer.</doc> + line="411">true if @flags is successfully cleared from buffer.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="403">a #GstBuffer</doc> + line="406">a #GstBuffer</doc> <type name="Buffer" c:type="GstBuffer*"/> </instance-parameter> <parameter name="flags" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="404">the #GstBufferFlags to clear</doc> + line="407">the #GstBufferFlags to clear</doc> <type name="BufferFlags" c:type="GstBufferFlags"/> </parameter> </parameters> @@ -4650,7 +4664,7 @@ with the associated metadata and memory will be freed.</doc> version="1.2"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="497">Get the maximum amount of memory blocks that a buffer can hold. This is a + line="500">Get the maximum amount of memory blocks that a buffer can hold. This is a compile time constant that can be queried with the function. When more memory blocks are added, existing memory blocks will be merged @@ -4659,7 +4673,7 @@ together to make room for the new block.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="506">the maximum amount of memory blocks that a buffer can hold.</doc> + line="509">the maximum amount of memory blocks that a buffer can hold.</doc> <type name="guint" c:type="guint"/> </return-value> </function> @@ -5796,7 +5810,7 @@ padding.</doc> <virtual-method name="acquire_buffer" invoker="acquire_buffer"> <doc xml:space="preserve" filename="gst/gstbufferpool.c" - line="1235">Acquire a buffer from @pool. @buffer should point to a memory location that + line="1247">Acquire a buffer from @pool. @buffer should point to a memory location that can hold a pointer to the new buffer. @params can be %NULL or contain optional parameters to influence the @@ -5805,7 +5819,7 @@ allocation.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbufferpool.c" - line="1247">a #GstFlowReturn such as %GST_FLOW_FLUSHING when the pool is + line="1259">a #GstFlowReturn such as %GST_FLOW_FLUSHING when the pool is inactive.</doc> <type name="FlowReturn" c:type="GstFlowReturn"/> </return-value> @@ -5813,7 +5827,7 @@ inactive.</doc> <instance-parameter name="pool" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbufferpool.c" - line="1237">a #GstBufferPool</doc> + line="1249">a #GstBufferPool</doc> <type name="BufferPool" c:type="GstBufferPool*"/> </instance-parameter> <parameter name="buffer" @@ -5822,7 +5836,7 @@ inactive.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbufferpool.c" - line="1238">a location for a #GstBuffer</doc> + line="1250">a location for a #GstBuffer</doc> <type name="Buffer" c:type="GstBuffer**"/> </parameter> <parameter name="params" @@ -5831,7 +5845,7 @@ inactive.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstbufferpool.c" - line="1239">parameters.</doc> + line="1251">parameters.</doc> <type name="BufferPoolAcquireParams" c:type="GstBufferPoolAcquireParams*"/> </parameter> @@ -5919,7 +5933,7 @@ gst_buffer_pool_config_add_option().</doc> <virtual-method name="release_buffer" invoker="release_buffer"> <doc xml:space="preserve" filename="gst/gstbufferpool.c" - line="1334">Release @buffer to @pool. @buffer should have previously been allocated from + line="1346">Release @buffer to @pool. @buffer should have previously been allocated from @pool with gst_buffer_pool_acquire_buffer(). This function is usually called automatically when the last ref on @buffer @@ -5932,13 +5946,13 @@ disappears.</doc> <instance-parameter name="pool" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbufferpool.c" - line="1336">a #GstBufferPool</doc> + line="1348">a #GstBufferPool</doc> <type name="BufferPool" c:type="GstBufferPool*"/> </instance-parameter> <parameter name="buffer" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbufferpool.c" - line="1337">a #GstBuffer</doc> + line="1349">a #GstBuffer</doc> <type name="Buffer" c:type="GstBuffer*"/> </parameter> </parameters> @@ -6024,7 +6038,7 @@ This function takes ownership of @config.</doc> c:identifier="gst_buffer_pool_acquire_buffer"> <doc xml:space="preserve" filename="gst/gstbufferpool.c" - line="1235">Acquire a buffer from @pool. @buffer should point to a memory location that + line="1247">Acquire a buffer from @pool. @buffer should point to a memory location that can hold a pointer to the new buffer. @params can be %NULL or contain optional parameters to influence the @@ -6033,7 +6047,7 @@ allocation.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbufferpool.c" - line="1247">a #GstFlowReturn such as %GST_FLOW_FLUSHING when the pool is + line="1259">a #GstFlowReturn such as %GST_FLOW_FLUSHING when the pool is inactive.</doc> <type name="FlowReturn" c:type="GstFlowReturn"/> </return-value> @@ -6041,7 +6055,7 @@ inactive.</doc> <instance-parameter name="pool" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbufferpool.c" - line="1237">a #GstBufferPool</doc> + line="1249">a #GstBufferPool</doc> <type name="BufferPool" c:type="GstBufferPool*"/> </instance-parameter> <parameter name="buffer" @@ -6050,7 +6064,7 @@ inactive.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbufferpool.c" - line="1238">a location for a #GstBuffer</doc> + line="1250">a location for a #GstBuffer</doc> <type name="Buffer" c:type="GstBuffer**"/> </parameter> <parameter name="params" @@ -6059,7 +6073,7 @@ inactive.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstbufferpool.c" - line="1239">parameters.</doc> + line="1251">parameters.</doc> <type name="BufferPoolAcquireParams" c:type="GstBufferPoolAcquireParams*"/> </parameter> @@ -6164,7 +6178,7 @@ gst_buffer_pool_set_active() call.</doc> c:identifier="gst_buffer_pool_release_buffer"> <doc xml:space="preserve" filename="gst/gstbufferpool.c" - line="1334">Release @buffer to @pool. @buffer should have previously been allocated from + line="1346">Release @buffer to @pool. @buffer should have previously been allocated from @pool with gst_buffer_pool_acquire_buffer(). This function is usually called automatically when the last ref on @buffer @@ -6177,13 +6191,13 @@ disappears.</doc> <instance-parameter name="pool" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbufferpool.c" - line="1336">a #GstBufferPool</doc> + line="1348">a #GstBufferPool</doc> <type name="BufferPool" c:type="GstBufferPool*"/> </instance-parameter> <parameter name="buffer" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbufferpool.c" - line="1337">a #GstBuffer</doc> + line="1349">a #GstBuffer</doc> <type name="Buffer" c:type="GstBuffer*"/> </parameter> </parameters> @@ -6269,7 +6283,7 @@ This function takes ownership of @config.</doc> version="1.4"> <doc xml:space="preserve" filename="gst/gstbufferpool.c" - line="1373">Enable or disable the flushing state of a @pool without freeing or + line="1385">Enable or disable the flushing state of a @pool without freeing or allocating buffers.</doc> <source-position filename="gst/gstbufferpool.h" line="207"/> <return-value transfer-ownership="none"> @@ -6279,13 +6293,13 @@ allocating buffers.</doc> <instance-parameter name="pool" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbufferpool.c" - line="1375">a #GstBufferPool</doc> + line="1387">a #GstBufferPool</doc> <type name="BufferPool" c:type="GstBufferPool*"/> </instance-parameter> <parameter name="flushing" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbufferpool.c" - line="1376">whether to start or stop flushing</doc> + line="1388">whether to start or stop flushing</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -6489,7 +6503,7 @@ return.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbufferpool.c" - line="1247">a #GstFlowReturn such as %GST_FLOW_FLUSHING when the pool is + line="1259">a #GstFlowReturn such as %GST_FLOW_FLUSHING when the pool is inactive.</doc> <type name="FlowReturn" c:type="GstFlowReturn"/> </return-value> @@ -6497,7 +6511,7 @@ inactive.</doc> <parameter name="pool" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbufferpool.c" - line="1237">a #GstBufferPool</doc> + line="1249">a #GstBufferPool</doc> <type name="BufferPool" c:type="GstBufferPool*"/> </parameter> <parameter name="buffer" @@ -6506,7 +6520,7 @@ inactive.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbufferpool.c" - line="1238">a location for a #GstBuffer</doc> + line="1250">a location for a #GstBuffer</doc> <type name="Buffer" c:type="GstBuffer**"/> </parameter> <parameter name="params" @@ -6515,7 +6529,7 @@ inactive.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstbufferpool.c" - line="1239">parameters.</doc> + line="1251">parameters.</doc> <type name="BufferPoolAcquireParams" c:type="GstBufferPoolAcquireParams*"/> </parameter> @@ -6568,13 +6582,13 @@ inactive.</doc> <parameter name="pool" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbufferpool.c" - line="1336">a #GstBufferPool</doc> + line="1348">a #GstBufferPool</doc> <type name="BufferPool" c:type="GstBufferPool*"/> </parameter> <parameter name="buffer" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstbufferpool.c" - line="1337">a #GstBuffer</doc> + line="1349">a #GstBuffer</doc> <type name="Buffer" c:type="GstBuffer*"/> </parameter> </parameters> @@ -6765,7 +6779,7 @@ from READY to NULL state.</doc> <method name="add_signal_watch" c:identifier="gst_bus_add_signal_watch"> <doc xml:space="preserve" filename="gst/gstbus.c" - line="1445">Adds a bus signal watch to the default main context with the default priority + line="1446">Adds a bus signal watch to the default main context with the default priority (%G_PRIORITY_DEFAULT). It is also possible to use a non-default main context set up using g_main_context_push_thread_default() (before one had to create a bus watch source and attach it to the desired main @@ -6787,7 +6801,7 @@ MT safe.</doc> <instance-parameter name="bus" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbus.c" - line="1447">a #GstBus on which you want to receive the "message" signal</doc> + line="1448">a #GstBus on which you want to receive the "message" signal</doc> <type name="Bus" c:type="GstBus*"/> </instance-parameter> </parameters> @@ -6796,7 +6810,7 @@ MT safe.</doc> c:identifier="gst_bus_add_signal_watch_full"> <doc xml:space="preserve" filename="gst/gstbus.c" - line="1386">Adds a bus signal watch to the default main context with the given @priority + line="1387">Adds a bus signal watch to the default main context with the given @priority (e.g. %G_PRIORITY_DEFAULT). It is also possible to use a non-default main context set up using g_main_context_push_thread_default() (before one had to create a bus watch source and attach it to the desired @@ -6821,13 +6835,13 @@ MT safe.</doc> <instance-parameter name="bus" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbus.c" - line="1388">a #GstBus on which you want to receive the "message" signal</doc> + line="1389">a #GstBus on which you want to receive the "message" signal</doc> <type name="Bus" c:type="GstBus*"/> </instance-parameter> <parameter name="priority" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbus.c" - line="1389">The priority of the watch.</doc> + line="1390">The priority of the watch.</doc> <type name="gint" c:type="gint"/> </parameter> </parameters> @@ -6968,26 +6982,26 @@ MT safe.</doc> c:identifier="gst_bus_async_signal_func"> <doc xml:space="preserve" filename="gst/gstbus.c" - line="1273">A helper #GstBusFunc that can be used to convert all asynchronous messages + line="1274">A helper #GstBusFunc that can be used to convert all asynchronous messages into signals.</doc> <source-position filename="gst/gstbus.h" line="203"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbus.c" - line="1282">%TRUE</doc> + line="1283">%TRUE</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="bus" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbus.c" - line="1275">a #GstBus</doc> + line="1276">a #GstBus</doc> <type name="Bus" c:type="GstBus*"/> </instance-parameter> <parameter name="message" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbus.c" - line="1276">the #GstMessage received</doc> + line="1277">the #GstMessage received</doc> <type name="Message" c:type="GstMessage*"/> </parameter> <parameter name="data" @@ -6996,7 +7010,7 @@ into signals.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstbus.c" - line="1277">user data</doc> + line="1278">user data</doc> <type name="gpointer" c:type="gpointer"/> </parameter> </parameters> @@ -7027,7 +7041,7 @@ message is popped off the bus and unreffed.</doc> c:identifier="gst_bus_disable_sync_message_emission"> <doc xml:space="preserve" filename="gst/gstbus.c" - line="1358">Instructs GStreamer to stop emitting the "sync-message" signal for this bus. + line="1359">Instructs GStreamer to stop emitting the "sync-message" signal for this bus. See gst_bus_enable_sync_message_emission() for more information. In the event that multiple pieces of code have called @@ -7046,7 +7060,7 @@ MT safe.</doc> <instance-parameter name="bus" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbus.c" - line="1360">a #GstBus on which you previously called + line="1361">a #GstBus on which you previously called gst_bus_enable_sync_message_emission()</doc> <type name="Bus" c:type="GstBus*"/> </instance-parameter> @@ -7056,7 +7070,7 @@ gst_bus_enable_sync_message_emission()</doc> c:identifier="gst_bus_enable_sync_message_emission"> <doc xml:space="preserve" filename="gst/gstbus.c" - line="1326">Instructs GStreamer to emit the "sync-message" signal after running the bus's + line="1327">Instructs GStreamer to emit the "sync-message" signal after running the bus's sync handler. This function is here so that code can ensure that they can synchronously receive messages without having to affect what the bin's sync handler is. @@ -7081,7 +7095,7 @@ MT safe.</doc> <instance-parameter name="bus" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbus.c" - line="1328">a #GstBus on which you want to receive the "sync-message" signal</doc> + line="1329">a #GstBus on which you want to receive the "sync-message" signal</doc> <type name="Bus" c:type="GstBus*"/> </instance-parameter> </parameters> @@ -7173,7 +7187,7 @@ MT safe.</doc> <method name="poll" c:identifier="gst_bus_poll"> <doc xml:space="preserve" filename="gst/gstbus.c" - line="1178">Poll the bus for messages. Will block while waiting for messages to come. + line="1179">Poll the bus for messages. Will block while waiting for messages to come. You can specify a maximum time to poll with the @timeout parameter. If @timeout is negative, this function will block indefinitely. @@ -7210,7 +7224,7 @@ from there.</doc> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstbus.c" - line="1220">the message that was received, + line="1221">the message that was received, or %NULL if the poll timed out. The message is taken from the bus and needs to be unreffed with gst_message_unref() after usage.</doc> @@ -7220,20 +7234,20 @@ from there.</doc> <instance-parameter name="bus" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbus.c" - line="1180">a #GstBus</doc> + line="1181">a #GstBus</doc> <type name="Bus" c:type="GstBus*"/> </instance-parameter> <parameter name="events" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbus.c" - line="1181">a mask of #GstMessageType, representing the set of message types to + line="1182">a mask of #GstMessageType, representing the set of message types to poll for (note special handling of extended message types below)</doc> <type name="MessageType" c:type="GstMessageType"/> </parameter> <parameter name="timeout" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbus.c" - line="1183">the poll timeout, as a #GstClockTime, or #GST_CLOCK_TIME_NONE to poll + line="1184">the poll timeout, as a #GstClockTime, or #GST_CLOCK_TIME_NONE to poll indefinitely.</doc> <type name="ClockTime" c:type="GstClockTime"/> </parameter> @@ -7332,7 +7346,7 @@ MT safe.</doc> c:identifier="gst_bus_remove_signal_watch"> <doc xml:space="preserve" filename="gst/gstbus.c" - line="1470">Removes a signal watch previously added with gst_bus_add_signal_watch(). + line="1471">Removes a signal watch previously added with gst_bus_add_signal_watch(). MT safe.</doc> <source-position filename="gst/gstbus.h" line="218"/> @@ -7343,7 +7357,7 @@ MT safe.</doc> <instance-parameter name="bus" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbus.c" - line="1472">a #GstBus you previously added a signal watch to</doc> + line="1473">a #GstBus you previously added a signal watch to</doc> <type name="Bus" c:type="GstBus*"/> </instance-parameter> </parameters> @@ -7453,26 +7467,26 @@ clearing an existing handler with %NULL was not thread-safe.</doc> c:identifier="gst_bus_sync_signal_handler"> <doc xml:space="preserve" filename="gst/gstbus.c" - line="1300">A helper GstBusSyncHandler that can be used to convert all synchronous + line="1301">A helper GstBusSyncHandler that can be used to convert all synchronous messages into signals.</doc> <source-position filename="gst/gstbus.h" line="206"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbus.c" - line="1309">GST_BUS_PASS</doc> + line="1310">GST_BUS_PASS</doc> <type name="BusSyncReply" c:type="GstBusSyncReply"/> </return-value> <parameters> <instance-parameter name="bus" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbus.c" - line="1302">a #GstBus</doc> + line="1303">a #GstBus</doc> <type name="Bus" c:type="GstBus*"/> </instance-parameter> <parameter name="message" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbus.c" - line="1303">the #GstMessage received</doc> + line="1304">the #GstMessage received</doc> <type name="Message" c:type="GstMessage*"/> </parameter> <parameter name="data" @@ -7481,7 +7495,7 @@ messages into signals.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstbus.c" - line="1304">user data</doc> + line="1305">user data</doc> <type name="gpointer" c:type="gpointer"/> </parameter> </parameters> @@ -8041,31 +8055,31 @@ is exactly one.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="879">Output a hexdump of @data in the given category. + line="902">Output a hexdump of @data in the given category. There is no need to finish the end of the message string with a newline character, a newline character will be added automatically.</doc> - <source-position filename="gst/gstinfo.h" line="707"/> + <source-position filename="gst/gstinfo.h" line="730"/> <parameters> <parameter name="cat"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="881">category to use</doc> + line="904">category to use</doc> </parameter> <parameter name="msg"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="882">message string to log with the data</doc> + line="905">message string to log with the data</doc> </parameter> <parameter name="data"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="883">pointer to the data to output</doc> + line="906">pointer to the data to output</doc> </parameter> <parameter name="length"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="884">length of the data to output</doc> + line="907">length of the data to output</doc> </parameter> </parameters> </function-macro> @@ -8074,37 +8088,37 @@ character, a newline character will be added automatically.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="793">Output a hexdump of @data relating to the given object in the given + line="816">Output a hexdump of @data relating to the given object in the given category. There is no need to finish the end of the message string with a newline character, a newline character will be added automatically.</doc> - <source-position filename="gst/gstinfo.h" line="705"/> + <source-position filename="gst/gstinfo.h" line="728"/> <parameters> <parameter name="cat"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="795">category to use</doc> + line="818">category to use</doc> </parameter> <parameter name="obj"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="796">the #GObject the message belongs to</doc> + line="819">the #GObject the message belongs to</doc> </parameter> <parameter name="msg"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="797">message string to log with the data</doc> + line="820">message string to log with the data</doc> </parameter> <parameter name="data"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="798">pointer to the data to output</doc> + line="821">pointer to the data to output</doc> </parameter> <parameter name="length"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="799">length of the data to output</doc> + line="822">length of the data to output</doc> </parameter> </parameters> </function-macro> @@ -8718,26 +8732,26 @@ becomes the owner of @structure.</doc> <method name="can_intersect" c:identifier="gst_caps_can_intersect"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1527">Tries intersecting @caps1 and @caps2 and reports whether the result would not + line="1528">Tries intersecting @caps1 and @caps2 and reports whether the result would not be empty</doc> <source-position filename="gst/gstcaps.h" line="547"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1535">%TRUE if intersection would be not empty</doc> + line="1536">%TRUE if intersection would be not empty</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="caps1" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1529">a #GstCaps to intersect</doc> + line="1530">a #GstCaps to intersect</doc> <type name="Caps" c:type="const GstCaps*"/> </instance-parameter> <parameter name="caps2" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1530">a #GstCaps to intersect</doc> + line="1531">a #GstCaps to intersect</doc> <type name="Caps" c:type="const GstCaps*"/> </parameter> </parameters> @@ -8745,7 +8759,7 @@ be empty</doc> <method name="copy" c:identifier="gst_caps_copy"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2663">Creates a new #GstCaps as a copy of the old @caps. The new caps will have a + line="2664">Creates a new #GstCaps as a copy of the old @caps. The new caps will have a refcount of 1, owned by the caller. The structures are copied as well. Note that this function is the semantic equivalent of a gst_caps_ref() @@ -8757,14 +8771,14 @@ When you are finished with the caps, call gst_caps_unref() on it.</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2676">the new #GstCaps</doc> + line="2677">the new #GstCaps</doc> <type name="Caps" c:type="GstCaps*"/> </return-value> <parameters> <instance-parameter name="caps" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2665">a #GstCaps.</doc> + line="2666">a #GstCaps.</doc> <type name="Caps" c:type="const GstCaps*"/> </instance-parameter> </parameters> @@ -8772,26 +8786,26 @@ When you are finished with the caps, call gst_caps_unref() on it.</doc> <method name="copy_nth" c:identifier="gst_caps_copy_nth" version="1.16"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1018">Creates a new #GstCaps and appends a copy of the nth structure + line="1019">Creates a new #GstCaps and appends a copy of the nth structure contained in @caps.</doc> <source-position filename="gst/gstcaps.h" line="487"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1026">the new #GstCaps</doc> + line="1027">the new #GstCaps</doc> <type name="Caps" c:type="GstCaps*"/> </return-value> <parameters> <instance-parameter name="caps" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1020">the #GstCaps to copy</doc> + line="1021">the #GstCaps to copy</doc> <type name="Caps" c:type="const GstCaps*"/> </instance-parameter> <parameter name="nth" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1021">the nth structure to copy</doc> + line="1022">the nth structure to copy</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -8801,7 +8815,7 @@ contained in @caps.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2604">Calls the provided function once for each structure and caps feature in the + line="2605">Calls the provided function once for each structure and caps feature in the #GstCaps. In contrast to gst_caps_foreach(), the function may modify the structure and features. In contrast to gst_caps_filter_and_map_in_place(), the structure and features are removed from the caps if %FALSE is returned @@ -8815,7 +8829,7 @@ The caps must be mutable.</doc> <instance-parameter name="caps" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2606">a #GstCaps</doc> + line="2607">a #GstCaps</doc> <type name="Caps" c:type="GstCaps*"/> </instance-parameter> <parameter name="func" @@ -8824,7 +8838,7 @@ The caps must be mutable.</doc> closure="1"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2607">a function to call for each field</doc> + line="2608">a function to call for each field</doc> <type name="CapsFilterMapFunc" c:type="GstCapsFilterMapFunc"/> </parameter> <parameter name="user_data" @@ -8833,7 +8847,7 @@ The caps must be mutable.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2608">private data</doc> + line="2609">private data</doc> <type name="gpointer" c:type="gpointer"/> </parameter> </parameters> @@ -8841,7 +8855,7 @@ The caps must be mutable.</doc> <method name="fixate" c:identifier="gst_caps_fixate"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2237">Modifies the given @caps into a representation with only fixed + line="2238">Modifies the given @caps into a representation with only fixed values. First the caps will be truncated and then the first structure will be fixated with gst_structure_fixate(). @@ -8858,14 +8872,14 @@ Calling this function with any caps is not allowed.</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2255">the fixated caps</doc> + line="2256">the fixated caps</doc> <type name="Caps" c:type="GstCaps*"/> </return-value> <parameters> <instance-parameter name="caps" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2239">a #GstCaps to fixate</doc> + line="2240">a #GstCaps to fixate</doc> <type name="Caps" c:type="GstCaps*"/> </instance-parameter> </parameters> @@ -8873,14 +8887,14 @@ Calling this function with any caps is not allowed.</doc> <method name="foreach" c:identifier="gst_caps_foreach" version="1.6"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2515">Calls the provided function once for each structure and caps feature in the + line="2516">Calls the provided function once for each structure and caps feature in the #GstCaps. The function must not modify the fields. Also see gst_caps_map_in_place() and gst_caps_filter_and_map_in_place().</doc> <source-position filename="gst/gstcaps.h" line="504"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2525">%TRUE if the supplied function returns %TRUE for each call, + line="2526">%TRUE if the supplied function returns %TRUE for each call, %FALSE otherwise.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -8888,7 +8902,7 @@ Also see gst_caps_map_in_place() and gst_caps_filter_and_map_in_place().</doc> <instance-parameter name="caps" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2517">a #GstCaps</doc> + line="2518">a #GstCaps</doc> <type name="Caps" c:type="const GstCaps*"/> </instance-parameter> <parameter name="func" @@ -8897,7 +8911,7 @@ Also see gst_caps_map_in_place() and gst_caps_filter_and_map_in_place().</doc> closure="1"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2518">a function to call for each field</doc> + line="2519">a function to call for each field</doc> <type name="CapsForeachFunc" c:type="GstCapsForeachFunc"/> </parameter> <parameter name="user_data" @@ -8906,7 +8920,7 @@ Also see gst_caps_map_in_place() and gst_caps_filter_and_map_in_place().</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2519">private data</doc> + line="2520">private data</doc> <type name="gpointer" c:type="gpointer"/> </parameter> </parameters> @@ -9016,26 +9030,26 @@ belongs to the #GstCaps.</doc> <method name="intersect" c:identifier="gst_caps_intersect"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1787">Creates a new #GstCaps that contains all the formats that are common + line="1788">Creates a new #GstCaps that contains all the formats that are common to both @caps1 and @caps2. Defaults to %GST_CAPS_INTERSECT_ZIG_ZAG mode.</doc> <source-position filename="gst/gstcaps.h" line="557"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1795">the new #GstCaps</doc> + line="1796">the new #GstCaps</doc> <type name="Caps" c:type="GstCaps*"/> </return-value> <parameters> <instance-parameter name="caps1" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1789">a #GstCaps to intersect</doc> + line="1790">a #GstCaps to intersect</doc> <type name="Caps" c:type="GstCaps*"/> </instance-parameter> <parameter name="caps2" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1790">a #GstCaps to intersect</doc> + line="1791">a #GstCaps to intersect</doc> <type name="Caps" c:type="GstCaps*"/> </parameter> </parameters> @@ -9043,33 +9057,33 @@ to both @caps1 and @caps2. Defaults to %GST_CAPS_INTERSECT_ZIG_ZAG mode.</doc> <method name="intersect_full" c:identifier="gst_caps_intersect_full"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1741">Creates a new #GstCaps that contains all the formats that are common + line="1742">Creates a new #GstCaps that contains all the formats that are common to both @caps1 and @caps2, the order is defined by the #GstCapsIntersectMode used.</doc> <source-position filename="gst/gstcaps.h" line="560"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1751">the new #GstCaps</doc> + line="1752">the new #GstCaps</doc> <type name="Caps" c:type="GstCaps*"/> </return-value> <parameters> <instance-parameter name="caps1" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1743">a #GstCaps to intersect</doc> + line="1744">a #GstCaps to intersect</doc> <type name="Caps" c:type="GstCaps*"/> </instance-parameter> <parameter name="caps2" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1744">a #GstCaps to intersect</doc> + line="1745">a #GstCaps to intersect</doc> <type name="Caps" c:type="GstCaps*"/> </parameter> <parameter name="mode" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1745">The intersection algorithm/mode to use</doc> + line="1746">The intersection algorithm/mode to use</doc> <type name="CapsIntersectMode" c:type="GstCapsIntersectMode"/> </parameter> </parameters> @@ -9078,27 +9092,27 @@ used.</doc> c:identifier="gst_caps_is_always_compatible"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1291">A given #GstCaps structure is always compatible with another if + line="1292">A given #GstCaps structure is always compatible with another if every media format that is in the first is also contained in the second. That is, @caps1 is a subset of @caps2.</doc> <source-position filename="gst/gstcaps.h" line="528"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1300">%TRUE if @caps1 is a subset of @caps2.</doc> + line="1301">%TRUE if @caps1 is a subset of @caps2.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="caps1" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1293">the #GstCaps to test</doc> + line="1294">the #GstCaps to test</doc> <type name="Caps" c:type="const GstCaps*"/> </instance-parameter> <parameter name="caps2" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1294">the #GstCaps to test</doc> + line="1295">the #GstCaps to test</doc> <type name="Caps" c:type="const GstCaps*"/> </parameter> </parameters> @@ -9106,19 +9120,19 @@ second. That is, @caps1 is a subset of @caps2.</doc> <method name="is_any" c:identifier="gst_caps_is_any"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1183">Determines if @caps represents any media format.</doc> + line="1184">Determines if @caps represents any media format.</doc> <source-position filename="gst/gstcaps.h" line="519"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1189">%TRUE if @caps represents any format.</doc> + line="1190">%TRUE if @caps represents any format.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="caps" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1185">the #GstCaps to test</doc> + line="1186">the #GstCaps to test</doc> <type name="Caps" c:type="const GstCaps*"/> </instance-parameter> </parameters> @@ -9126,19 +9140,19 @@ second. That is, @caps1 is a subset of @caps2.</doc> <method name="is_empty" c:identifier="gst_caps_is_empty"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1199">Determines if @caps represents no media formats.</doc> + line="1200">Determines if @caps represents no media formats.</doc> <source-position filename="gst/gstcaps.h" line="522"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1205">%TRUE if @caps represents no formats.</doc> + line="1206">%TRUE if @caps represents no formats.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="caps" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1201">the #GstCaps to test</doc> + line="1202">the #GstCaps to test</doc> <type name="Caps" c:type="const GstCaps*"/> </instance-parameter> </parameters> @@ -9146,25 +9160,25 @@ second. That is, @caps1 is a subset of @caps2.</doc> <method name="is_equal" c:identifier="gst_caps_is_equal"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1451">Checks if the given caps represent the same set of caps.</doc> + line="1452">Checks if the given caps represent the same set of caps.</doc> <source-position filename="gst/gstcaps.h" line="541"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1458">%TRUE if both caps are equal.</doc> + line="1459">%TRUE if both caps are equal.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="caps1" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1453">a #GstCaps</doc> + line="1454">a #GstCaps</doc> <type name="Caps" c:type="const GstCaps*"/> </instance-parameter> <parameter name="caps2" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1454">another #GstCaps</doc> + line="1455">another #GstCaps</doc> <type name="Caps" c:type="const GstCaps*"/> </parameter> </parameters> @@ -9172,26 +9186,26 @@ second. That is, @caps1 is a subset of @caps2.</doc> <method name="is_equal_fixed" c:identifier="gst_caps_is_equal_fixed"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1259">Tests if two #GstCaps are equal. This function only works on fixed + line="1260">Tests if two #GstCaps are equal. This function only works on fixed #GstCaps.</doc> <source-position filename="gst/gstcaps.h" line="544"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1267">%TRUE if the arguments represent the same format</doc> + line="1268">%TRUE if the arguments represent the same format</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="caps1" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1261">the #GstCaps to test</doc> + line="1262">the #GstCaps to test</doc> <type name="Caps" c:type="const GstCaps*"/> </instance-parameter> <parameter name="caps2" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1262">the #GstCaps to test</doc> + line="1263">the #GstCaps to test</doc> <type name="Caps" c:type="const GstCaps*"/> </parameter> </parameters> @@ -9199,21 +9213,21 @@ second. That is, @caps1 is a subset of @caps2.</doc> <method name="is_fixed" c:identifier="gst_caps_is_fixed"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1225">Fixed #GstCaps describe exactly one format, that is, they have exactly + line="1226">Fixed #GstCaps describe exactly one format, that is, they have exactly one structure, and each field in the structure describes a fixed type. Examples of non-fixed types are GST_TYPE_INT_RANGE and GST_TYPE_LIST.</doc> <source-position filename="gst/gstcaps.h" line="525"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1233">%TRUE if @caps is fixed</doc> + line="1234">%TRUE if @caps is fixed</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="caps" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1227">the #GstCaps to test</doc> + line="1228">the #GstCaps to test</doc> <type name="Caps" c:type="const GstCaps*"/> </instance-parameter> </parameters> @@ -9222,25 +9236,25 @@ Examples of non-fixed types are GST_TYPE_INT_RANGE and GST_TYPE_LIST.</doc> c:identifier="gst_caps_is_strictly_equal"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1475">Checks if the given caps are exactly the same set of caps.</doc> + line="1476">Checks if the given caps are exactly the same set of caps.</doc> <source-position filename="gst/gstcaps.h" line="550"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1482">%TRUE if both caps are strictly equal.</doc> + line="1483">%TRUE if both caps are strictly equal.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="caps1" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1477">a #GstCaps</doc> + line="1478">a #GstCaps</doc> <type name="Caps" c:type="const GstCaps*"/> </instance-parameter> <parameter name="caps2" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1478">another #GstCaps</doc> + line="1479">another #GstCaps</doc> <type name="Caps" c:type="const GstCaps*"/> </parameter> </parameters> @@ -9248,25 +9262,25 @@ Examples of non-fixed types are GST_TYPE_INT_RANGE and GST_TYPE_LIST.</doc> <method name="is_subset" c:identifier="gst_caps_is_subset"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1311">Checks if all caps represented by @subset are also represented by @superset.</doc> + line="1312">Checks if all caps represented by @subset are also represented by @superset.</doc> <source-position filename="gst/gstcaps.h" line="531"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1318">%TRUE if @subset is a subset of @superset</doc> + line="1319">%TRUE if @subset is a subset of @superset</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="subset" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1313">a #GstCaps</doc> + line="1314">a #GstCaps</doc> <type name="Caps" c:type="const GstCaps*"/> </instance-parameter> <parameter name="superset" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1314">a potentially greater #GstCaps</doc> + line="1315">a potentially greater #GstCaps</doc> <type name="Caps" c:type="const GstCaps*"/> </parameter> </parameters> @@ -9275,26 +9289,26 @@ Examples of non-fixed types are GST_TYPE_INT_RANGE and GST_TYPE_LIST.</doc> c:identifier="gst_caps_is_subset_structure"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1367">Checks if @structure is a subset of @caps. See gst_caps_is_subset() + line="1368">Checks if @structure is a subset of @caps. See gst_caps_is_subset() for more information.</doc> <source-position filename="gst/gstcaps.h" line="534"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1375">%TRUE if @structure is a subset of @caps</doc> + line="1376">%TRUE if @structure is a subset of @caps</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="caps" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1369">a #GstCaps</doc> + line="1370">a #GstCaps</doc> <type name="Caps" c:type="const GstCaps*"/> </instance-parameter> <parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1370">a potential #GstStructure subset of @caps</doc> + line="1371">a potential #GstStructure subset of @caps</doc> <type name="Structure" c:type="const GstStructure*"/> </parameter> </parameters> @@ -9304,26 +9318,26 @@ for more information.</doc> version="1.2"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1403">Checks if @structure is a subset of @caps. See gst_caps_is_subset() + line="1404">Checks if @structure is a subset of @caps. See gst_caps_is_subset() for more information.</doc> <source-position filename="gst/gstcaps.h" line="537"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1412">%TRUE if @structure is a subset of @caps</doc> + line="1413">%TRUE if @structure is a subset of @caps</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="caps" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1405">a #GstCaps</doc> + line="1406">a #GstCaps</doc> <type name="Caps" c:type="const GstCaps*"/> </instance-parameter> <parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1406">a potential #GstStructure subset of @caps</doc> + line="1407">a potential #GstStructure subset of @caps</doc> <type name="Structure" c:type="const GstStructure*"/> </parameter> <parameter name="features" @@ -9332,7 +9346,7 @@ for more information.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1407">a #GstCapsFeatures for @structure</doc> + line="1408">a #GstCapsFeatures for @structure</doc> <type name="CapsFeatures" c:type="const GstCapsFeatures*"/> </parameter> </parameters> @@ -9342,14 +9356,14 @@ for more information.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2556">Calls the provided function once for each structure and caps feature in the + line="2557">Calls the provided function once for each structure and caps feature in the #GstCaps. In contrast to gst_caps_foreach(), the function may modify but not delete the structures and features. The caps must be mutable.</doc> <source-position filename="gst/gstcaps.h" line="508"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2566">%TRUE if the supplied function returns %TRUE for each call, + line="2567">%TRUE if the supplied function returns %TRUE for each call, %FALSE otherwise.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -9357,7 +9371,7 @@ delete the structures and features. The caps must be mutable.</doc> <instance-parameter name="caps" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2558">a #GstCaps</doc> + line="2559">a #GstCaps</doc> <type name="Caps" c:type="GstCaps*"/> </instance-parameter> <parameter name="func" @@ -9366,7 +9380,7 @@ delete the structures and features. The caps must be mutable.</doc> closure="1"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2559">a function to call for each field</doc> + line="2560">a function to call for each field</doc> <type name="CapsMapFunc" c:type="GstCapsMapFunc"/> </parameter> <parameter name="user_data" @@ -9375,7 +9389,7 @@ delete the structures and features. The caps must be mutable.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2560">private data</doc> + line="2561">private data</doc> <type name="gpointer" c:type="gpointer"/> </parameter> </parameters> @@ -9475,7 +9489,7 @@ If either caps is ANY, the resulting caps will be ANY.</doc> <method name="normalize" c:identifier="gst_caps_normalize"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2000">Returns a #GstCaps that represents the same set of formats as + line="2001">Returns a #GstCaps that represents the same set of formats as @caps, but contains no lists. Each list is expanded into separate @GstStructures. @@ -9486,14 +9500,14 @@ reference to it with gst_caps_ref().</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2012">the normalized #GstCaps</doc> + line="2013">the normalized #GstCaps</doc> <type name="Caps" c:type="GstCaps*"/> </return-value> <parameters> <instance-parameter name="caps" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2002">a #GstCaps to normalize</doc> + line="2003">a #GstCaps to normalize</doc> <type name="Caps" c:type="GstCaps*"/> </instance-parameter> </parameters> @@ -9554,7 +9568,7 @@ contained in @caps.</doc> version="1.2"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="945">Sets the #GstCapsFeatures @features for the structure at @index.</doc> + line="946">Sets the #GstCapsFeatures @features for the structure at @index.</doc> <source-position filename="gst/gstcaps.h" line="476"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> @@ -9563,13 +9577,13 @@ contained in @caps.</doc> <instance-parameter name="caps" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="947">a #GstCaps</doc> + line="948">a #GstCaps</doc> <type name="Caps" c:type="GstCaps*"/> </instance-parameter> <parameter name="index" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="948">the index of the structure</doc> + line="949">the index of the structure</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="features" @@ -9578,7 +9592,7 @@ contained in @caps.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="949">the #GstCapsFeatures to set</doc> + line="950">the #GstCapsFeatures to set</doc> <type name="CapsFeatures" c:type="GstCapsFeatures*"/> </parameter> </parameters> @@ -9588,7 +9602,7 @@ contained in @caps.</doc> version="1.16"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="978">Sets the #GstCapsFeatures @features for all the structures of @caps.</doc> + line="979">Sets the #GstCapsFeatures @features for all the structures of @caps.</doc> <source-position filename="gst/gstcaps.h" line="480"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> @@ -9597,7 +9611,7 @@ contained in @caps.</doc> <instance-parameter name="caps" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="980">a #GstCaps</doc> + line="981">a #GstCaps</doc> <type name="Caps" c:type="GstCaps*"/> </instance-parameter> <parameter name="features" @@ -9606,7 +9620,7 @@ contained in @caps.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="981">the #GstCapsFeatures to set</doc> + line="982">the #GstCapsFeatures to set</doc> <type name="CapsFeatures" c:type="GstCapsFeatures*"/> </parameter> </parameters> @@ -9616,7 +9630,7 @@ contained in @caps.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1159">Sets fields in a #GstCaps. The arguments must be passed in the same + line="1160">Sets fields in a #GstCaps. The arguments must be passed in the same manner as gst_structure_set(), and be %NULL-terminated.</doc> <source-position filename="gst/gstcaps.h" line="497"/> <return-value transfer-ownership="none"> @@ -9626,19 +9640,19 @@ manner as gst_structure_set(), and be %NULL-terminated.</doc> <instance-parameter name="caps" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1161">the #GstCaps to set</doc> + line="1162">the #GstCaps to set</doc> <type name="Caps" c:type="GstCaps*"/> </instance-parameter> <parameter name="field" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1162">first field to set</doc> + line="1163">first field to set</doc> <type name="utf8" c:type="const char*"/> </parameter> <parameter name="..." transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1163">additional parameters</doc> + line="1164">additional parameters</doc> <varargs/> </parameter> </parameters> @@ -9648,7 +9662,7 @@ manner as gst_structure_set(), and be %NULL-terminated.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1121">Sets fields in a #GstCaps. The arguments must be passed in the same + line="1122">Sets fields in a #GstCaps. The arguments must be passed in the same manner as gst_structure_set(), and be %NULL-terminated.</doc> <source-position filename="gst/gstcaps.h" line="500"/> <return-value transfer-ownership="none"> @@ -9658,19 +9672,19 @@ manner as gst_structure_set(), and be %NULL-terminated.</doc> <instance-parameter name="caps" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1123">the #GstCaps to set</doc> + line="1124">the #GstCaps to set</doc> <type name="Caps" c:type="GstCaps*"/> </instance-parameter> <parameter name="field" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1124">first field to set</doc> + line="1125">first field to set</doc> <type name="utf8" c:type="const char*"/> </parameter> <parameter name="varargs" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1125">additional parameters</doc> + line="1126">additional parameters</doc> <type name="va_list" c:type="va_list"/> </parameter> </parameters> @@ -9678,7 +9692,7 @@ manner as gst_structure_set(), and be %NULL-terminated.</doc> <method name="set_value" c:identifier="gst_caps_set_value"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1094">Sets the given @field on all structures of @caps to the given @value. + line="1095">Sets the given @field on all structures of @caps to the given @value. This is a convenience function for calling gst_structure_set_value() on all structures of @caps.</doc> <source-position filename="gst/gstcaps.h" line="493"/> @@ -9689,19 +9703,19 @@ all structures of @caps.</doc> <instance-parameter name="caps" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1096">a writable caps</doc> + line="1097">a writable caps</doc> <type name="Caps" c:type="GstCaps*"/> </instance-parameter> <parameter name="field" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1097">name of the field to set</doc> + line="1098">name of the field to set</doc> <type name="utf8" c:type="const char*"/> </parameter> <parameter name="value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1098">value to set the field to</doc> + line="1099">value to set the field to</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> </parameters> @@ -9709,7 +9723,7 @@ all structures of @caps.</doc> <method name="simplify" c:identifier="gst_caps_simplify"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2158">Converts the given @caps into a representation that represents the + line="2159">Converts the given @caps into a representation that represents the same set of formats, but in a simpler form. Component structures that are identical are merged. Component structures that have values that can be merged are also merged. @@ -9723,14 +9737,14 @@ This method does not preserve the original order of @caps.</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2173">The simplified caps.</doc> + line="2174">The simplified caps.</doc> <type name="Caps" c:type="GstCaps*"/> </return-value> <parameters> <instance-parameter name="caps" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2160">a #GstCaps to simplify</doc> + line="2161">a #GstCaps to simplify</doc> <type name="Caps" c:type="GstCaps*"/> </instance-parameter> </parameters> @@ -9766,27 +9780,27 @@ contained in @caps. The caller becomes the owner of the returned structure.</doc <method name="subtract" c:identifier="gst_caps_subtract"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1866">Subtracts the @subtrahend from the @minuend. + line="1867">Subtracts the @subtrahend from the @minuend. > This function does not work reliably if optional properties for caps > are included on one caps and omitted on the other.</doc> <source-position filename="gst/gstcaps.h" line="564"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1875">the resulting caps</doc> + line="1876">the resulting caps</doc> <type name="Caps" c:type="GstCaps*"/> </return-value> <parameters> <instance-parameter name="minuend" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1868">#GstCaps to subtract from</doc> + line="1869">#GstCaps to subtract from</doc> <type name="Caps" c:type="GstCaps*"/> </instance-parameter> <parameter name="subtrahend" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1869">#GstCaps to subtract</doc> + line="1870">#GstCaps to subtract</doc> <type name="Caps" c:type="GstCaps*"/> </parameter> </parameters> @@ -9794,7 +9808,7 @@ contained in @caps. The caller becomes the owner of the returned structure.</doc <method name="to_string" c:identifier="gst_caps_to_string"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2293">Converts @caps to a string representation. This string representation + line="2294">Converts @caps to a string representation. This string representation can be converted back to a #GstCaps by gst_caps_from_string(). For debugging purposes its easier to do something like this: @@ -9809,14 +9823,14 @@ when there are nested #GstCaps / #GstStructure deeper than one level.</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2309">a newly allocated string representing @caps.</doc> + line="2310">a newly allocated string representing @caps.</doc> <type name="utf8" c:type="gchar*"/> </return-value> <parameters> <instance-parameter name="caps" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2295">a #GstCaps</doc> + line="2296">a #GstCaps</doc> <type name="Caps" c:type="const GstCaps*"/> </instance-parameter> </parameters> @@ -9824,7 +9838,7 @@ when there are nested #GstCaps / #GstStructure deeper than one level.</doc> <method name="truncate" c:identifier="gst_caps_truncate"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1053">Discard all but the first structure from @caps. Useful when + line="1054">Discard all but the first structure from @caps. Useful when fixating. This function takes ownership of @caps and will call gst_caps_make_writable() @@ -9838,14 +9852,14 @@ the same and contain no structure at all.</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1068">truncated caps</doc> + line="1069">truncated caps</doc> <type name="Caps" c:type="GstCaps*"/> </return-value> <parameters> <instance-parameter name="caps" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="1055">the #GstCaps to truncate</doc> + line="1056">the #GstCaps to truncate</doc> <type name="Caps" c:type="GstCaps*"/> </instance-parameter> </parameters> @@ -9871,7 +9885,7 @@ structures' values when the refcount reaches 0.</doc> <function name="from_string" c:identifier="gst_caps_from_string"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2475">Converts @caps from a string representation. + line="2476">Converts @caps from a string representation. The current implementation of serialization will lead to unexpected results when there are nested #GstCaps / #GstStructure deeper than one level.</doc> @@ -9879,14 +9893,14 @@ when there are nested #GstCaps / #GstStructure deeper than one level.</doc> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2484">a newly allocated #GstCaps</doc> + line="2485">a newly allocated #GstCaps</doc> <type name="Caps" c:type="GstCaps*"/> </return-value> <parameters> <parameter name="string" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2477">a string to convert to #GstCaps</doc> + line="2478">a string to convert to #GstCaps</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -14649,14 +14663,14 @@ to the filename, so that it can be used to take multiple snapshots.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="531">Defines a GstDebugCategory variable. + line="557">Defines a GstDebugCategory variable. This macro expands to nothing if debugging is disabled.</doc> - <source-position filename="gst/gstinfo.h" line="538"/> + <source-position filename="gst/gstinfo.h" line="564"/> <parameters> <parameter name="cat"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="533">the category</doc> + line="559">the category</doc> </parameter> </parameters> </function-macro> @@ -14665,14 +14679,14 @@ This macro expands to nothing if debugging is disabled.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="539">Declares a GstDebugCategory variable as extern. Use in header files. + line="565">Declares a GstDebugCategory variable as extern. Use in header files. This macro expands to nothing if debugging is disabled.</doc> - <source-position filename="gst/gstinfo.h" line="546"/> + <source-position filename="gst/gstinfo.h" line="572"/> <parameters> <parameter name="cat"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="541">the category</doc> + line="567">the category</doc> </parameter> </parameters> </function-macro> @@ -14681,7 +14695,7 @@ This macro expands to nothing if debugging is disabled.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="591">Looks up an existing #GstDebugCategory by its @name and sets @cat. If the + line="617">Looks up an existing #GstDebugCategory by its @name and sets @cat. If the category is not found, but GST_CAT_DEFAULT is defined, that is assigned to @cat. Otherwise @cat will be %NULL. @@ -14693,17 +14707,17 @@ GST_DEBUG_CATEGORY_STATIC (GST_CAT_PERFORMANCE); GST_DEBUG_CATEGORY_INIT (gst_myplugin_debug, "myplugin", 0, "nice element"); GST_DEBUG_CATEGORY_GET (GST_CAT_PERFORMANCE, "GST_PERFORMANCE"); ]|</doc> - <source-position filename="gst/gstinfo.h" line="610"/> + <source-position filename="gst/gstinfo.h" line="636"/> <parameters> <parameter name="cat"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="593">the category to initialize.</doc> + line="619">the category to initialize.</doc> </parameter> <parameter name="name"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="594">log category name</doc> + line="620">log category name</doc> </parameter> </parameters> </function-macro> @@ -14712,7 +14726,7 @@ GST_DEBUG_CATEGORY_GET (GST_CAT_PERFORMANCE, "GST_PERFORMANCE"); introspectable="0"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="557">Initializes a new #GstDebugCategory with the given properties and set to + line="583">Initializes a new #GstDebugCategory with the given properties and set to the default threshold. > This macro expands to nothing if debugging is disabled. @@ -14732,27 +14746,27 @@ the default threshold. > common prefix followed by an underscore for all your categories. GStreamer > uses the GST prefix so GStreamer categories look like "GST_STATES". Be sure > to include uppercase letters.</doc> - <source-position filename="gst/gstinfo.h" line="586"/> + <source-position filename="gst/gstinfo.h" line="612"/> <parameters> <parameter name="cat"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="559">the category to initialize.</doc> + line="585">the category to initialize.</doc> </parameter> <parameter name="name"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="560">the name of the category.</doc> + line="586">the name of the category.</doc> </parameter> <parameter name="color"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="561">the colors to use for a color representation or 0 for no color.</doc> + line="587">the colors to use for a color representation or 0 for no color.</doc> </parameter> <parameter name="description"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="562">optional description of the category.</doc> + line="588">optional description of the category.</doc> </parameter> </parameters> </function-macro> @@ -14761,14 +14775,14 @@ the default threshold. introspectable="0"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="548">Defines a static GstDebugCategory variable. + line="574">Defines a static GstDebugCategory variable. This macro expands to nothing if debugging is disabled.</doc> - <source-position filename="gst/gstinfo.h" line="555"/> + <source-position filename="gst/gstinfo.h" line="581"/> <parameters> <parameter name="cat"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="550">the category</doc> + line="576">the category</doc> </parameter> </parameters> </function-macro> @@ -14787,14 +14801,14 @@ This macro expands to nothing if debugging is disabled.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="1442">Register a pointer to a function with its name, so it can later be used by + line="1465">Register a pointer to a function with its name, so it can later be used by GST_DEBUG_FUNCPTR_NAME().</doc> - <source-position filename="gst/gstinfo.h" line="1451"/> + <source-position filename="gst/gstinfo.h" line="1474"/> <parameters> <parameter name="ptr"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="1444">pointer to the function to register</doc> + line="1467">pointer to the function to register</doc> </parameter> </parameters> </function-macro> @@ -14803,17 +14817,17 @@ GST_DEBUG_FUNCPTR_NAME().</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="1454">Retrieves the name of the function, if it was previously registered with + line="1477">Retrieves the name of the function, if it was previously registered with GST_DEBUG_FUNCPTR(). If not, it returns a description of the pointer. This macro returns a constant string which must not be modified or freed by the caller.</doc> - <source-position filename="gst/gstinfo.h" line="1464"/> + <source-position filename="gst/gstinfo.h" line="1487"/> <parameters> <parameter name="ptr"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="1456">address of the function of which to look up the name</doc> + line="1479">address of the function of which to look up the name</doc> </parameter> </parameters> </function-macro> @@ -14838,16 +14852,16 @@ statements.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="1431">Register a pointer to a function with its name, so it can later be used by + line="1454">Register a pointer to a function with its name, so it can later be used by GST_DEBUG_FUNCPTR_NAME(). Use this variant of #GST_DEBUG_FUNCPTR if you do not need to use @ptr.</doc> - <source-position filename="gst/gstinfo.h" line="1440"/> + <source-position filename="gst/gstinfo.h" line="1463"/> <parameters> <parameter name="ptr"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="1433">pointer to the function to register</doc> + line="1456">pointer to the function to register</doc> </parameter> </parameters> </function-macro> @@ -15007,7 +15021,7 @@ Use this variant of #GST_DEBUG_FUNCPTR if you do not need to use @ptr.</doc> <function-macro name="DYNAMIC_TYPE_CLASS" c:identifier="GST_DYNAMIC_TYPE_CLASS" introspectable="0"> - <source-position filename="gst/gstdynamictypefactory.h" line="42"/> + <source-position filename="gst/gstdynamictypefactory.h" line="44"/> <parameters> <parameter name="klass"> </parameter> @@ -15016,7 +15030,7 @@ Use this variant of #GST_DEBUG_FUNCPTR if you do not need to use @ptr.</doc> <function-macro name="DYNAMIC_TYPE_FACTORY" c:identifier="GST_DYNAMIC_TYPE_FACTORY" introspectable="0"> - <source-position filename="gst/gstdynamictypefactory.h" line="40"/> + <source-position filename="gst/gstdynamictypefactory.h" line="42"/> <parameters> <parameter name="obj"> </parameter> @@ -15025,7 +15039,7 @@ Use this variant of #GST_DEBUG_FUNCPTR if you do not need to use @ptr.</doc> <function-macro name="DYNAMIC_TYPE_FACTORY_CAST" c:identifier="GST_DYNAMIC_TYPE_FACTORY_CAST" introspectable="0"> - <source-position filename="gst/gstdynamictypefactory.h" line="46"/> + <source-position filename="gst/gstdynamictypefactory.h" line="48"/> <parameters> <parameter name="obj"> </parameter> @@ -15840,9 +15854,9 @@ reference count reaches zero, the structure is freed.</doc> deprecated="1"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1803">Removes and frees the category and all associated resources.</doc> + line="1857">Removes and frees the category and all associated resources.</doc> <doc-deprecated xml:space="preserve">This function can easily cause memory corruption, don't use it.</doc-deprecated> - <source-position filename="gst/gstinfo.h" line="460"/> + <source-position filename="gst/gstinfo.h" line="486"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -15850,7 +15864,7 @@ reference count reaches zero, the structure is freed.</doc> <instance-parameter name="category" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1805">#GstDebugCategory to free.</doc> + line="1859">#GstDebugCategory to free.</doc> <type name="DebugCategory" c:type="GstDebugCategory*"/> </instance-parameter> </parameters> @@ -15858,20 +15872,20 @@ reference count reaches zero, the structure is freed.</doc> <method name="get_color" c:identifier="gst_debug_category_get_color"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1887">Returns the color of a debug category used when printing output in this + line="1941">Returns the color of a debug category used when printing output in this category.</doc> - <source-position filename="gst/gstinfo.h" line="476"/> + <source-position filename="gst/gstinfo.h" line="502"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1894">the color of the category.</doc> + line="1948">the color of the category.</doc> <type name="guint" c:type="guint"/> </return-value> <parameters> <instance-parameter name="category" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1889">a #GstDebugCategory to get the color of.</doc> + line="1943">a #GstDebugCategory to get the color of.</doc> <type name="DebugCategory" c:type="GstDebugCategory*"/> </instance-parameter> </parameters> @@ -15880,19 +15894,19 @@ category.</doc> c:identifier="gst_debug_category_get_description"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1902">Returns the description of a debug category.</doc> - <source-position filename="gst/gstinfo.h" line="479"/> + line="1956">Returns the description of a debug category.</doc> + <source-position filename="gst/gstinfo.h" line="505"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1908">the description of the category.</doc> + line="1962">the description of the category.</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> <instance-parameter name="category" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1904">a #GstDebugCategory to get the description of.</doc> + line="1958">a #GstDebugCategory to get the description of.</doc> <type name="DebugCategory" c:type="GstDebugCategory*"/> </instance-parameter> </parameters> @@ -15900,19 +15914,19 @@ category.</doc> <method name="get_name" c:identifier="gst_debug_category_get_name"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1873">Returns the name of a debug category.</doc> - <source-position filename="gst/gstinfo.h" line="473"/> + line="1927">Returns the name of a debug category.</doc> + <source-position filename="gst/gstinfo.h" line="499"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1879">the name of the category.</doc> + line="1933">the name of the category.</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> <instance-parameter name="category" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1875">a #GstDebugCategory to get name of.</doc> + line="1929">a #GstDebugCategory to get name of.</doc> <type name="DebugCategory" c:type="GstDebugCategory*"/> </instance-parameter> </parameters> @@ -15921,19 +15935,19 @@ category.</doc> c:identifier="gst_debug_category_get_threshold"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1859">Returns the threshold of a #GstDebugCategory.</doc> - <source-position filename="gst/gstinfo.h" line="470"/> + line="1913">Returns the threshold of a #GstDebugCategory.</doc> + <source-position filename="gst/gstinfo.h" line="496"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1865">the #GstDebugLevel that is used as threshold.</doc> + line="1919">the #GstDebugLevel that is used as threshold.</doc> <type name="DebugLevel" c:type="GstDebugLevel"/> </return-value> <parameters> <instance-parameter name="category" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1861">a #GstDebugCategory to get threshold of.</doc> + line="1915">a #GstDebugCategory to get threshold of.</doc> <type name="DebugCategory" c:type="GstDebugCategory*"/> </instance-parameter> </parameters> @@ -15942,12 +15956,12 @@ category.</doc> c:identifier="gst_debug_category_reset_threshold"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1843">Resets the threshold of the category to the default level. Debug information + line="1897">Resets the threshold of the category to the default level. Debug information will only be output if the threshold is lower or equal to the level of the debugging message. Use this function to set the threshold back to where it was after using gst_debug_category_set_threshold().</doc> - <source-position filename="gst/gstinfo.h" line="467"/> + <source-position filename="gst/gstinfo.h" line="493"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -15955,7 +15969,7 @@ gst_debug_category_set_threshold().</doc> <instance-parameter name="category" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1845">a #GstDebugCategory to reset threshold of.</doc> + line="1899">a #GstDebugCategory to reset threshold of.</doc> <type name="DebugCategory" c:type="GstDebugCategory*"/> </instance-parameter> </parameters> @@ -15964,13 +15978,13 @@ gst_debug_category_set_threshold().</doc> c:identifier="gst_debug_category_set_threshold"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1817">Sets the threshold of the category to the given level. Debug information will + line="1871">Sets the threshold of the category to the given level. Debug information will only be output if the threshold is lower or equal to the level of the debugging message. > Do not use this function in production code, because other functions may > change the threshold of categories as side effect. It is however a nice > function to use when debugging (even from gdb).</doc> - <source-position filename="gst/gstinfo.h" line="463"/> + <source-position filename="gst/gstinfo.h" line="489"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -15978,13 +15992,13 @@ debugging message. <instance-parameter name="category" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1819">a #GstDebugCategory to set threshold of.</doc> + line="1873">a #GstDebugCategory to set threshold of.</doc> <type name="DebugCategory" c:type="GstDebugCategory*"/> </instance-parameter> <parameter name="level" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1820">the #GstDebugLevel threshold to set.</doc> + line="1874">the #GstDebugLevel threshold to set.</doc> <type name="DebugLevel" c:type="GstDebugLevel"/> </parameter> </parameters> @@ -16177,10 +16191,10 @@ debugging categories to make them stand out in debugging output.</doc> <attribute name="doc.skip" value="true"/> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="370">we define this to avoid a compiler warning regarding a cast from a function + line="396">we define this to avoid a compiler warning regarding a cast from a function pointer to a void pointer (see https://bugzilla.gnome.org/show_bug.cgi?id=309253)</doc> - <source-position filename="gst/gstinfo.h" line="376"/> + <source-position filename="gst/gstinfo.h" line="402"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -16371,43 +16385,43 @@ message is, the greater the probability that the debugging system outputs it.</d <function name="get_name" c:identifier="gst_debug_level_get_name"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1317">Get the string representation of a debugging level</doc> - <source-position filename="gst/gstinfo.h" line="411"/> + line="1371">Get the string representation of a debugging level</doc> + <source-position filename="gst/gstinfo.h" line="437"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1323">the name</doc> + line="1377">the name</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> <parameter name="level" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1319">the level to get the name for</doc> + line="1373">the level to get the name for</doc> <type name="DebugLevel" c:type="GstDebugLevel"/> </parameter> </parameters> </function> </enumeration> <record name="DebugMessage" c:type="GstDebugMessage" disguised="1"> - <source-position filename="gst/gstinfo.h" line="305"/> + <source-position filename="gst/gstinfo.h" line="331"/> <method name="get" c:identifier="gst_debug_message_get"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="587">Gets the string representation of a #GstDebugMessage. This function is used + line="588">Gets the string representation of a #GstDebugMessage. This function is used in debug handlers to extract the message.</doc> - <source-position filename="gst/gstinfo.h" line="389"/> + <source-position filename="gst/gstinfo.h" line="415"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="594">the string representation of a #GstDebugMessage.</doc> + line="595">the string representation of a #GstDebugMessage.</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> <instance-parameter name="message" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="589">a debug message</doc> + line="590">a debug message</doc> <type name="DebugMessage" c:type="GstDebugMessage*"/> </instance-parameter> </parameters> @@ -16914,12 +16928,12 @@ The basic use pattern of a device monitor is as follows: version="1.4"> <doc xml:space="preserve" filename="gst/gstdevicemonitor.c" - line="793">Create a new #GstDeviceMonitor</doc> + line="791">Create a new #GstDeviceMonitor</doc> <source-position filename="gst/gstdevicemonitor.h" line="82"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstdevicemonitor.c" - line="798">a new device monitor.</doc> + line="796">a new device monitor.</doc> <type name="DeviceMonitor" c:type="GstDeviceMonitor*"/> </return-value> </constructor> @@ -16928,7 +16942,7 @@ The basic use pattern of a device monitor is as follows: version="1.4"> <doc xml:space="preserve" filename="gst/gstdevicemonitor.c" - line="622">Adds a filter for which #GstDevice will be monitored, any device that matches + line="620">Adds a filter for which #GstDevice will be monitored, any device that matches all these classes and the #GstCaps will be returned. If this function is called multiple times to add more filters, each will be @@ -16943,7 +16957,7 @@ Filters must be added before the #GstDeviceMonitor is started.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdevicemonitor.c" - line="640">The id of the new filter or 0 if no provider matched the filter's + line="638">The id of the new filter or 0 if no provider matched the filter's classes.</doc> <type name="guint" c:type="guint"/> </return-value> @@ -16951,7 +16965,7 @@ Filters must be added before the #GstDeviceMonitor is started.</doc> <instance-parameter name="monitor" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdevicemonitor.c" - line="624">a device monitor</doc> + line="622">a device monitor</doc> <type name="DeviceMonitor" c:type="GstDeviceMonitor*"/> </instance-parameter> <parameter name="classes" @@ -16960,7 +16974,7 @@ Filters must be added before the #GstDeviceMonitor is started.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstdevicemonitor.c" - line="625">device classes to use as filter or %NULL for any class</doc> + line="623">device classes to use as filter or %NULL for any class</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="caps" @@ -16969,7 +16983,7 @@ Filters must be added before the #GstDeviceMonitor is started.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstdevicemonitor.c" - line="626">the #GstCaps to filter or %NULL for ANY</doc> + line="624">the #GstCaps to filter or %NULL for ANY</doc> <type name="Caps" c:type="GstCaps*"/> </parameter> </parameters> @@ -16979,19 +16993,19 @@ Filters must be added before the #GstDeviceMonitor is started.</doc> version="1.4"> <doc xml:space="preserve" filename="gst/gstdevicemonitor.c" - line="815">Gets the #GstBus of this #GstDeviceMonitor</doc> + line="813">Gets the #GstBus of this #GstDeviceMonitor</doc> <source-position filename="gst/gstdevicemonitor.h" line="85"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstdevicemonitor.c" - line="821">a #GstBus</doc> + line="819">a #GstBus</doc> <type name="Bus" c:type="GstBus*"/> </return-value> <parameters> <instance-parameter name="monitor" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdevicemonitor.c" - line="817">a #GstDeviceProvider</doc> + line="815">a #GstDeviceProvider</doc> <type name="DeviceMonitor" c:type="GstDeviceMonitor*"/> </instance-parameter> </parameters> @@ -17027,14 +17041,14 @@ probe the hardware if the monitor is not currently started.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gstdevicemonitor.c" - line="833">Get a list of the currently selected device provider factories. + line="831">Get a list of the currently selected device provider factories. This</doc> <source-position filename="gst/gstdevicemonitor.h" line="106"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstdevicemonitor.c" - line="841"> + line="839"> A list of device provider factory names that are currently being monitored by @monitor or %NULL when nothing is being monitored.</doc> <array c:type="gchar**"> @@ -17045,7 +17059,7 @@ This</doc> <instance-parameter name="monitor" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdevicemonitor.c" - line="835">a #GstDeviceMonitor</doc> + line="833">a #GstDeviceMonitor</doc> <type name="DeviceMonitor" c:type="GstDeviceMonitor*"/> </instance-parameter> </parameters> @@ -17055,20 +17069,20 @@ This</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gstdevicemonitor.c" - line="899">Get if @monitor is currently showing all devices, even those from hidden + line="897">Get if @monitor is currently showing all devices, even those from hidden providers.</doc> <source-position filename="gst/gstdevicemonitor.h" line="112"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdevicemonitor.c" - line="906">%TRUE when all devices will be shown.</doc> + line="904">%TRUE when all devices will be shown.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="monitor" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdevicemonitor.c" - line="901">a #GstDeviceMonitor</doc> + line="899">a #GstDeviceMonitor</doc> <type name="DeviceMonitor" c:type="GstDeviceMonitor*"/> </instance-parameter> </parameters> @@ -17078,26 +17092,26 @@ providers.</doc> version="1.4"> <doc xml:space="preserve" filename="gst/gstdevicemonitor.c" - line="726">Removes a filter from the #GstDeviceMonitor using the id that was returned + line="724">Removes a filter from the #GstDeviceMonitor using the id that was returned by gst_device_monitor_add_filter().</doc> <source-position filename="gst/gstdevicemonitor.h" line="103"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdevicemonitor.c" - line="734">%TRUE of the filter id was valid, %FALSE otherwise</doc> + line="732">%TRUE of the filter id was valid, %FALSE otherwise</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="monitor" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdevicemonitor.c" - line="728">a device monitor</doc> + line="726">a device monitor</doc> <type name="DeviceMonitor" c:type="GstDeviceMonitor*"/> </instance-parameter> <parameter name="filter_id" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdevicemonitor.c" - line="729">the id of the filter</doc> + line="727">the id of the filter</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -17107,7 +17121,7 @@ by gst_device_monitor_add_filter().</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gstdevicemonitor.c" - line="878">Set if all devices should be visible, even those devices from hidden + line="876">Set if all devices should be visible, even those devices from hidden providers. Setting @show_all to true might show some devices multiple times.</doc> <source-position filename="gst/gstdevicemonitor.h" line="109"/> <return-value transfer-ownership="none"> @@ -17117,13 +17131,13 @@ providers. Setting @show_all to true might show some devices multiple times.</do <instance-parameter name="monitor" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdevicemonitor.c" - line="880">a #GstDeviceMonitor</doc> + line="878">a #GstDeviceMonitor</doc> <type name="DeviceMonitor" c:type="GstDeviceMonitor*"/> </instance-parameter> <parameter name="show_all" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdevicemonitor.c" - line="881">show all devices</doc> + line="879">show all devices</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -17155,7 +17169,7 @@ will be emitted on the bus when the list of devices changes.</doc> <method name="stop" c:identifier="gst_device_monitor_stop" version="1.4"> <doc xml:space="preserve" filename="gst/gstdevicemonitor.c" - line="552">Stops monitoring the devices.</doc> + line="551">Stops monitoring the devices.</doc> <source-position filename="gst/gstdevicemonitor.h" line="95"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> @@ -17164,7 +17178,7 @@ will be emitted on the bus when the list of devices changes.</doc> <instance-parameter name="monitor" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdevicemonitor.c" - line="554">A #GstDeviceProvider</doc> + line="553">A #GstDeviceProvider</doc> <type name="DeviceMonitor" c:type="GstDeviceMonitor*"/> </instance-parameter> </parameters> @@ -17297,26 +17311,30 @@ from all relevant providers.</doc> <virtual-method name="start" invoker="start" version="1.4"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="425">Starts providering the devices. This will cause #GST_MESSAGE_DEVICE_ADDED + line="428">Starts providering the devices. This will cause #GST_MESSAGE_DEVICE_ADDED and #GST_MESSAGE_DEVICE_REMOVED messages to be posted on the provider's bus when devices are added or removed from the system. Since the #GstDeviceProvider is a singleton, gst_device_provider_start() may already have been called by another user of the object, gst_device_provider_stop() needs to be called the same -number of times.</doc> +number of times. + +After this function has been called, gst_device_provider_get_devices() will +return the same objects that have been received from the +#GST_MESSAGE_DEVICE_ADDED messages and will no longer probe.</doc> <source-position filename="gst/gstdeviceprovider.h" line="92"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="438">%TRUE if the device providering could be started</doc> + line="445">%TRUE if the device providering could be started</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="provider" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="427">A #GstDeviceProvider</doc> + line="430">A #GstDeviceProvider</doc> <type name="DeviceProvider" c:type="GstDeviceProvider*"/> </instance-parameter> </parameters> @@ -17324,7 +17342,7 @@ number of times.</doc> <virtual-method name="stop" invoker="stop" version="1.4"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="478">Decreases the use-count by one. If the use count reaches zero, this + line="504">Decreases the use-count by one. If the use count reaches zero, this #GstDeviceProvider will stop providering the devices. This needs to be called the same number of times that gst_device_provider_start() was called.</doc> <source-position filename="gst/gstdeviceprovider.h" line="93"/> @@ -17335,7 +17353,7 @@ called the same number of times that gst_device_provider_start() was called.</do <instance-parameter name="provider" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="480">A #GstDeviceProvider</doc> + line="506">A #GstDeviceProvider</doc> <type name="DeviceProvider" c:type="GstDeviceProvider*"/> </instance-parameter> </parameters> @@ -17357,7 +17375,7 @@ called the same number of times that gst_device_provider_start() was called.</do version="1.4"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="578">Posts a message on the provider's #GstBus to inform applications that + line="603">Posts a message on the provider's #GstBus to inform applications that a new device has been added. This is for use by subclasses. @@ -17372,13 +17390,13 @@ will be removed (see gst_object_ref_sink()).</doc> <instance-parameter name="provider" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="580">a #GstDeviceProvider</doc> + line="605">a #GstDeviceProvider</doc> <type name="DeviceProvider" c:type="GstDeviceProvider*"/> </instance-parameter> <parameter name="device" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="581">a #GstDevice that has been added</doc> + line="606">a #GstDevice that has been added</doc> <type name="Device" c:type="GstDevice*"/> </parameter> </parameters> @@ -17388,7 +17406,7 @@ will be removed (see gst_object_ref_sink()).</doc> version="1.16"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="777">This function is used when @changed_device was modified into its new form + line="802">This function is used when @changed_device was modified into its new form @device. This will post a `DEVICE_CHANGED` message on the bus to let the application know that the device was modified. #GstDevice is immutable for MT. safety purposes so this is an "atomic" way of letting the application @@ -17404,13 +17422,13 @@ know when a device was modified.</doc> <parameter name="device" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="779">the new version of @changed_device</doc> + line="804">the new version of @changed_device</doc> <type name="Device" c:type="GstDevice*"/> </parameter> <parameter name="changed_device" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="780">the old version of the device that has been updated</doc> + line="805">the old version of the device that has been updated</doc> <type name="Device" c:type="GstDevice*"/> </parameter> </parameters> @@ -17420,7 +17438,7 @@ know when a device was modified.</doc> version="1.4"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="621">Posts a message on the provider's #GstBus to inform applications that + line="646">Posts a message on the provider's #GstBus to inform applications that a device has been removed. This is for use by subclasses.</doc> @@ -17432,13 +17450,13 @@ This is for use by subclasses.</doc> <instance-parameter name="provider" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="623">a #GstDeviceProvider</doc> + line="648">a #GstDeviceProvider</doc> <type name="DeviceProvider" c:type="GstDeviceProvider*"/> </instance-parameter> <parameter name="device" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="624">a #GstDevice that has been removed</doc> + line="649">a #GstDevice that has been removed</doc> <type name="Device" c:type="GstDevice*"/> </parameter> </parameters> @@ -17448,19 +17466,19 @@ This is for use by subclasses.</doc> version="1.4"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="560">Gets the #GstBus of this #GstDeviceProvider</doc> + line="585">Gets the #GstBus of this #GstDeviceProvider</doc> <source-position filename="gst/gstdeviceprovider.h" line="119"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="566">a #GstBus</doc> + line="591">a #GstBus</doc> <type name="Bus" c:type="GstBus*"/> </return-value> <parameters> <instance-parameter name="provider" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="562">a #GstDeviceProvider</doc> + line="587">a #GstDeviceProvider</doc> <type name="DeviceProvider" c:type="GstDeviceProvider*"/> </instance-parameter> </parameters> @@ -17471,12 +17489,15 @@ This is for use by subclasses.</doc> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" line="385">Gets a list of devices that this provider understands. This may actually -probe the hardware if the provider is not currently started.</doc> +probe the hardware if the provider is not currently started. + +If the provider has been started, this will returned the same #GstDevice +objedcts that have been returned by the #GST_MESSAGE_DEVICE_ADDED messages.</doc> <source-position filename="gst/gstdeviceprovider.h" line="107"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="392">a #GList of + line="395">a #GList of #GstDevice</doc> <type name="GLib.List" c:type="GList*"> <type name="Device"/> @@ -17496,12 +17517,12 @@ probe the hardware if the provider is not currently started.</doc> version="1.4"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="518">Retrieves the factory that was used to create this device provider.</doc> + line="543">Retrieves the factory that was used to create this device provider.</doc> <source-position filename="gst/gstdeviceprovider.h" line="173"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="524">the #GstDeviceProviderFactory used for + line="549">the #GstDeviceProviderFactory used for creating this device provider. no refcounting is needed.</doc> <type name="DeviceProviderFactory" c:type="GstDeviceProviderFactory*"/> @@ -17510,7 +17531,7 @@ probe the hardware if the provider is not currently started.</doc> <instance-parameter name="provider" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="520">a #GstDeviceProvider to request the device provider factory of.</doc> + line="545">a #GstDeviceProvider to request the device provider factory of.</doc> <type name="DeviceProvider" c:type="GstDeviceProvider*"/> </instance-parameter> </parameters> @@ -17520,13 +17541,13 @@ probe the hardware if the provider is not currently started.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="657">Get the provider factory names of the #GstDeviceProvider instances that + line="682">Get the provider factory names of the #GstDeviceProvider instances that are hidden by @provider.</doc> <source-position filename="gst/gstdeviceprovider.h" line="128"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="664"> + line="689"> a list of hidden providers factory names or %NULL when nothing is hidden by @provider. Free with g_strfreev.</doc> <array c:type="gchar**"> @@ -17537,7 +17558,7 @@ are hidden by @provider.</doc> <instance-parameter name="provider" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="659">a #GstDeviceProvider</doc> + line="684">a #GstDeviceProvider</doc> <type name="DeviceProvider" c:type="GstDeviceProvider*"/> </instance-parameter> </parameters> @@ -17575,7 +17596,7 @@ are hidden by @provider.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="696">Make @provider hide the devices from the factory with @name. + line="721">Make @provider hide the devices from the factory with @name. This function is used when @provider will also provide the devices reported by provider factory @name. A monitor should stop monitoring the @@ -17588,13 +17609,13 @@ device provider with @name to avoid duplicate devices.</doc> <instance-parameter name="provider" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="698">a #GstDeviceProvider</doc> + line="723">a #GstDeviceProvider</doc> <type name="DeviceProvider" c:type="GstDeviceProvider*"/> </instance-parameter> <parameter name="name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="699">a provider factory name</doc> + line="724">a provider factory name</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -17604,26 +17625,30 @@ device provider with @name to avoid duplicate devices.</doc> version="1.4"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="425">Starts providering the devices. This will cause #GST_MESSAGE_DEVICE_ADDED + line="428">Starts providering the devices. This will cause #GST_MESSAGE_DEVICE_ADDED and #GST_MESSAGE_DEVICE_REMOVED messages to be posted on the provider's bus when devices are added or removed from the system. Since the #GstDeviceProvider is a singleton, gst_device_provider_start() may already have been called by another user of the object, gst_device_provider_stop() needs to be called the same -number of times.</doc> +number of times. + +After this function has been called, gst_device_provider_get_devices() will +return the same objects that have been received from the +#GST_MESSAGE_DEVICE_ADDED messages and will no longer probe.</doc> <source-position filename="gst/gstdeviceprovider.h" line="110"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="438">%TRUE if the device providering could be started</doc> + line="445">%TRUE if the device providering could be started</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="provider" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="427">A #GstDeviceProvider</doc> + line="430">A #GstDeviceProvider</doc> <type name="DeviceProvider" c:type="GstDeviceProvider*"/> </instance-parameter> </parameters> @@ -17633,7 +17658,7 @@ number of times.</doc> version="1.4"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="478">Decreases the use-count by one. If the use count reaches zero, this + line="504">Decreases the use-count by one. If the use count reaches zero, this #GstDeviceProvider will stop providering the devices. This needs to be called the same number of times that gst_device_provider_start() was called.</doc> <source-position filename="gst/gstdeviceprovider.h" line="113"/> @@ -17644,7 +17669,7 @@ called the same number of times that gst_device_provider_start() was called.</do <instance-parameter name="provider" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="480">A #GstDeviceProvider</doc> + line="506">A #GstDeviceProvider</doc> <type name="DeviceProvider" c:type="GstDeviceProvider*"/> </instance-parameter> </parameters> @@ -17654,7 +17679,7 @@ called the same number of times that gst_device_provider_start() was called.</do version="1.6"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="735">Make @provider unhide the devices from factory @name. + line="760">Make @provider unhide the devices from factory @name. This function is used when @provider will no longer provide the devices reported by provider factory @name. A monitor should start @@ -17668,13 +17693,13 @@ all devices again.</doc> <instance-parameter name="provider" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="737">a #GstDeviceProvider</doc> + line="762">a #GstDeviceProvider</doc> <type name="DeviceProvider" c:type="GstDeviceProvider*"/> </instance-parameter> <parameter name="name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="738">a provider factory name</doc> + line="763">a provider factory name</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -17764,14 +17789,14 @@ all devices again.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="438">%TRUE if the device providering could be started</doc> + line="445">%TRUE if the device providering could be started</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <parameter name="provider" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="427">A #GstDeviceProvider</doc> + line="430">A #GstDeviceProvider</doc> <type name="DeviceProvider" c:type="GstDeviceProvider*"/> </parameter> </parameters> @@ -17787,7 +17812,7 @@ all devices again.</doc> <parameter name="provider" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceprovider.c" - line="480">A #GstDeviceProvider</doc> + line="506">A #GstDeviceProvider</doc> <type name="DeviceProvider" c:type="GstDeviceProvider*"/> </parameter> </parameters> @@ -18051,13 +18076,13 @@ found, %NULL otherwise</doc> version="1.4"> <doc xml:space="preserve" filename="gst/gstdeviceproviderfactory.c" - line="338">Returns the device provider of the type defined by the given device + line="339">Returns the device provider of the type defined by the given device provider factory.</doc> <source-position filename="gst/gstdeviceproviderfactory.h" line="82"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstdeviceproviderfactory.c" - line="345">a #GstDeviceProvider or %NULL + line="346">a #GstDeviceProvider or %NULL if unable to create device provider</doc> <type name="DeviceProvider" c:type="GstDeviceProvider*"/> </return-value> @@ -18065,7 +18090,7 @@ if unable to create device provider</doc> <parameter name="factoryname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceproviderfactory.c" - line="340">a named factory to instantiate</doc> + line="341">a named factory to instantiate</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -18075,13 +18100,13 @@ if unable to create device provider</doc> version="1.4"> <doc xml:space="preserve" filename="gst/gstdeviceproviderfactory.c" - line="558">Get a list of factories with a rank greater or equal to @minrank. + line="559">Get a list of factories with a rank greater or equal to @minrank. The list of factories is returned by decreasing rank.</doc> <source-position filename="gst/gstdeviceproviderfactory.h" line="95"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstdeviceproviderfactory.c" - line="565"> + line="566"> a #GList of #GstDeviceProviderFactory device providers. Use gst_plugin_feature_list_free() after usage.</doc> <type name="GLib.List" c:type="GList*"> @@ -18092,7 +18117,7 @@ gst_plugin_feature_list_free() after usage.</doc> <parameter name="minrank" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceproviderfactory.c" - line="560">Minimum rank</doc> + line="561">Minimum rank</doc> <type name="Rank" c:type="GstRank"/> </parameter> </parameters> @@ -18127,21 +18152,21 @@ if the device provider couldn't be created</doc> version="1.4"> <doc xml:space="preserve" filename="gst/gstdeviceproviderfactory.c" - line="387">Get the #GType for device providers managed by this factory. The type can + line="388">Get the #GType for device providers managed by this factory. The type can only be retrieved if the device provider factory is loaded, which can be assured with gst_plugin_feature_load().</doc> <source-position filename="gst/gstdeviceproviderfactory.h" line="70"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceproviderfactory.c" - line="395">the #GType for device providers managed by this factory.</doc> + line="396">the #GType for device providers managed by this factory.</doc> <type name="GType" c:type="GType"/> </return-value> <parameters> <instance-parameter name="factory" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceproviderfactory.c" - line="389">factory to get managed #GType from</doc> + line="390">factory to get managed #GType from</doc> <type name="DeviceProviderFactory" c:type="GstDeviceProviderFactory*"/> </instance-parameter> @@ -18152,12 +18177,12 @@ assured with gst_plugin_feature_load().</doc> version="1.4"> <doc xml:space="preserve" filename="gst/gstdeviceproviderfactory.c" - line="409">Get the metadata on @factory with @key.</doc> + line="410">Get the metadata on @factory with @key.</doc> <source-position filename="gst/gstdeviceproviderfactory.h" line="73"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gstdeviceproviderfactory.c" - line="416">the metadata with @key on @factory or %NULL + line="417">the metadata with @key on @factory or %NULL when there was no metadata with the given @key.</doc> <type name="utf8" c:type="const gchar*"/> </return-value> @@ -18165,14 +18190,14 @@ when there was no metadata with the given @key.</doc> <instance-parameter name="factory" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceproviderfactory.c" - line="411">a #GstDeviceProviderFactory</doc> + line="412">a #GstDeviceProviderFactory</doc> <type name="DeviceProviderFactory" c:type="GstDeviceProviderFactory*"/> </instance-parameter> <parameter name="key" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceproviderfactory.c" - line="412">a key</doc> + line="413">a key</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -18182,12 +18207,12 @@ when there was no metadata with the given @key.</doc> version="1.4"> <doc xml:space="preserve" filename="gst/gstdeviceproviderfactory.c" - line="428">Get the available keys for the metadata on @factory.</doc> + line="429">Get the available keys for the metadata on @factory.</doc> <source-position filename="gst/gstdeviceproviderfactory.h" line="76"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstdeviceproviderfactory.c" - line="434"> + line="435"> a %NULL-terminated array of key strings, or %NULL when there is no metadata. Free with g_strfreev() when no longer needed.</doc> <array c:type="gchar**"> @@ -18198,7 +18223,7 @@ metadata. Free with g_strfreev() when no longer needed.</doc> <instance-parameter name="factory" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceproviderfactory.c" - line="430">a #GstDeviceProviderFactory</doc> + line="431">a #GstDeviceProviderFactory</doc> <type name="DeviceProviderFactory" c:type="GstDeviceProviderFactory*"/> </instance-parameter> @@ -18209,19 +18234,19 @@ metadata. Free with g_strfreev() when no longer needed.</doc> version="1.4"> <doc xml:space="preserve" filename="gst/gstdeviceproviderfactory.c" - line="517">Check if @factory matches all of the given @classes</doc> + line="518">Check if @factory matches all of the given @classes</doc> <source-position filename="gst/gstdeviceproviderfactory.h" line="92"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceproviderfactory.c" - line="525">%TRUE if @factory matches or if @classes is %NULL.</doc> + line="526">%TRUE if @factory matches or if @classes is %NULL.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="factory" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceproviderfactory.c" - line="519">a #GstDeviceProviderFactory</doc> + line="520">a #GstDeviceProviderFactory</doc> <type name="DeviceProviderFactory" c:type="GstDeviceProviderFactory*"/> </instance-parameter> @@ -18231,7 +18256,7 @@ metadata. Free with g_strfreev() when no longer needed.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstdeviceproviderfactory.c" - line="520">a "/" separate list of classes to match, only match + line="521">a "/" separate list of classes to match, only match if all classes are matched</doc> <type name="utf8" c:type="const gchar*"/> </parameter> @@ -18242,19 +18267,19 @@ metadata. Free with g_strfreev() when no longer needed.</doc> version="1.4"> <doc xml:space="preserve" filename="gst/gstdeviceproviderfactory.c" - line="466">Check if @factory matches all of the given classes</doc> + line="467">Check if @factory matches all of the given classes</doc> <source-position filename="gst/gstdeviceproviderfactory.h" line="89"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceproviderfactory.c" - line="474">%TRUE if @factory matches.</doc> + line="475">%TRUE if @factory matches.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="factory" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstdeviceproviderfactory.c" - line="468">a #GstDeviceProviderFactory</doc> + line="469">a #GstDeviceProviderFactory</doc> <type name="DeviceProviderFactory" c:type="GstDeviceProviderFactory*"/> </instance-parameter> @@ -18264,7 +18289,7 @@ metadata. Free with g_strfreev() when no longer needed.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstdeviceproviderfactory.c" - line="469">a %NULL terminated array + line="470">a %NULL terminated array of classes to match, only match if all classes are matched</doc> <array c:type="gchar**"> <type name="utf8" c:type="gchar*"/> @@ -18300,6 +18325,7 @@ metadata. Free with g_strfreev() when no longer needed.</doc> <class name="DynamicTypeFactory" c:symbol-prefix="dynamic_type_factory" c:type="GstDynamicTypeFactory" + version="1.12" parent="PluginFeature" glib:type-name="GstDynamicTypeFactory" glib:get-type="gst_dynamic_type_factory_get_type" @@ -18325,9 +18351,9 @@ plugin_init (GstPlugin * plugin) return gst_dynamic_type_register (plugin, GST_TYPE_CUSTOM_CAPS_FIELD); } ]|</doc> - <source-position filename="gst/gstdynamictypefactory.h" line="31"/> + <source-position filename="gst/gstdynamictypefactory.h" line="33"/> <function name="load" c:identifier="gst_dynamic_type_factory_load"> - <source-position filename="gst/gstdynamictypefactory.h" line="52"/> + <source-position filename="gst/gstdynamictypefactory.h" line="54"/> <return-value transfer-ownership="none"> <type name="GType" c:type="GType"/> </return-value> @@ -18342,7 +18368,7 @@ plugin_init (GstPlugin * plugin) c:type="GstDynamicTypeFactoryClass" disguised="1" glib:is-gtype-struct-for="DynamicTypeFactory"> - <source-position filename="gst/gstdynamictypefactory.h" line="31"/> + <source-position filename="gst/gstdynamictypefactory.h" line="33"/> </record> <function-macro name="ELEMENT" c:identifier="GST_ELEMENT" @@ -19489,7 +19515,7 @@ could be created</doc> <doc xml:space="preserve" filename="gst/gstutils.c" line="1304">Gets a string representing the given state change result.</doc> - <source-position filename="gst/gstutils.h" line="993"/> + <source-position filename="gst/gstutils.h" line="996"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -19511,7 +19537,7 @@ could be created</doc> <doc xml:space="preserve" filename="gst/gstutils.c" line="1276">Gets a string representing the given state.</doc> - <source-position filename="gst/gstutils.h" line="990"/> + <source-position filename="gst/gstutils.h" line="993"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -19530,7 +19556,7 @@ could be created</doc> <virtual-method name="change_state" invoker="change_state"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3009">Perform @transition on @element. + line="3022">Perform @transition on @element. This function must be called with STATE_LOCK held and is mainly used internally.</doc> @@ -19538,20 +19564,20 @@ internally.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3019">the #GstStateChangeReturn of the state transition.</doc> + line="3032">the #GstStateChangeReturn of the state transition.</doc> <type name="StateChangeReturn" c:type="GstStateChangeReturn"/> </return-value> <parameters> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3011">a #GstElement</doc> + line="3024">a #GstElement</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="transition" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3012">the requested transition</doc> + line="3025">the requested transition</doc> <type name="StateChange" c:type="GstStateChange"/> </parameter> </parameters> @@ -19559,7 +19585,7 @@ internally.</doc> <virtual-method name="get_state" invoker="get_state"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2540">Gets the state of the element. + line="2553">Gets the state of the element. For elements that performed an ASYNC state change, as reported by gst_element_set_state(), this function will block up to the @@ -19583,7 +19609,7 @@ element to playing, the preroll will complete and playback will start.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2571">%GST_STATE_CHANGE_SUCCESS if the element has no more pending state + line="2584">%GST_STATE_CHANGE_SUCCESS if the element has no more pending state and the last state change succeeded, %GST_STATE_CHANGE_ASYNC if the element is still performing a state change or %GST_STATE_CHANGE_FAILURE if the last state change failed. @@ -19595,7 +19621,7 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2542">a #GstElement to get the state of.</doc> + line="2555">a #GstElement to get the state of.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="state" @@ -19606,7 +19632,7 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2543">a pointer to #GstState to hold the state. + line="2556">a pointer to #GstState to hold the state. Can be %NULL.</doc> <type name="State" c:type="GstState*"/> </parameter> @@ -19618,14 +19644,14 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2545">a pointer to #GstState to hold the pending + line="2558">a pointer to #GstState to hold the pending state. Can be %NULL.</doc> <type name="State" c:type="GstState*"/> </parameter> <parameter name="timeout" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2547">a #GstClockTime to specify the timeout for an async + line="2560">a #GstClockTime to specify the timeout for an async state change or %GST_CLOCK_TIME_NONE for infinite timeout.</doc> <type name="ClockTime" c:type="GstClockTime"/> </parameter> @@ -19634,7 +19660,7 @@ MT safe.</doc> <virtual-method name="no_more_pads" invoker="no_more_pads"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="928">Use this function to signal that the element does not expect any more pads + line="941">Use this function to signal that the element does not expect any more pads to show up in the current pipeline. This function should be called whenever pads have been added by the element itself. Elements with #GST_PAD_SOMETIMES pad templates use this in combination with autopluggers to figure out that @@ -19651,7 +19677,7 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="930">a #GstElement</doc> + line="943">a #GstElement</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> </parameters> @@ -19687,14 +19713,14 @@ MT safe.</doc> <virtual-method name="post_message" invoker="post_message"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2083">Post a message on the element's #GstBus. This function takes ownership of the + line="2096">Post a message on the element's #GstBus. This function takes ownership of the message; if you want to access the message after this call, you should add an additional reference before calling.</doc> <source-position filename="gst/gstelement.h" line="738"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2092">%TRUE if the message was successfully posted. The function returns + line="2105">%TRUE if the message was successfully posted. The function returns %FALSE if the element did not have a bus. MT safe.</doc> @@ -19704,13 +19730,13 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2085">a #GstElement posting the message</doc> + line="2098">a #GstElement posting the message</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="message" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2086">a #GstMessage to post</doc> + line="2099">a #GstMessage to post</doc> <type name="Message" c:type="GstMessage*"/> </parameter> </parameters> @@ -19718,14 +19744,14 @@ MT safe.</doc> <virtual-method name="provide_clock" invoker="provide_clock"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="368">Get the clock provided by the given element. + line="371">Get the clock provided by the given element. > An element is only required to provide a clock in the PAUSED > state. Some elements can provide a clock in other states.</doc> <source-position filename="gst/gstelement.h" line="730"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="376">the GstClock provided by the + line="379">the GstClock provided by the element or %NULL if no clock could be provided. Unref after usage. MT safe.</doc> @@ -19735,7 +19761,7 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="370">a #GstElement to query</doc> + line="373">a #GstElement to query</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> </parameters> @@ -19743,7 +19769,7 @@ MT safe.</doc> <virtual-method name="query" invoker="query"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2008">Performs a query on the given element. + line="2021">Performs a query on the given element. For elements that don't implement a query handler, this function forwards the query to a random srcpad or to the peer of a @@ -19754,7 +19780,7 @@ Please note that some queries might need a running pipeline to work.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2021">%TRUE if the query could be performed. + line="2034">%TRUE if the query could be performed. MT safe.</doc> <type name="gboolean" c:type="gboolean"/> @@ -19763,13 +19789,13 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2010">a #GstElement to perform the query on.</doc> + line="2023">a #GstElement to perform the query on.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="query" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2011">the #GstQuery.</doc> + line="2024">the #GstQuery.</doc> <type name="Query" c:type="GstQuery*"/> </parameter> </parameters> @@ -19791,7 +19817,7 @@ MT safe.</doc> <virtual-method name="request_new_pad" invoker="request_pad"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1219">Retrieves a request pad from the element according to the provided template. + line="1232">Retrieves a request pad from the element according to the provided template. Pad templates can be looked up using gst_element_factory_get_static_pad_templates(). @@ -19800,7 +19826,7 @@ The pad should be released with gst_element_release_request_pad().</doc> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1234">requested #GstPad if found, + line="1247">requested #GstPad if found, otherwise %NULL. Release after usage.</doc> <type name="Pad" c:type="GstPad*"/> </return-value> @@ -19808,13 +19834,13 @@ The pad should be released with gst_element_release_request_pad().</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1221">a #GstElement to find a request pad of.</doc> + line="1234">a #GstElement to find a request pad of.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="templ" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1222">a #GstPadTemplate of which we want a pad of.</doc> + line="1235">a #GstPadTemplate of which we want a pad of.</doc> <type name="PadTemplate" c:type="GstPadTemplate*"/> </parameter> <parameter name="name" @@ -19823,7 +19849,7 @@ The pad should be released with gst_element_release_request_pad().</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1223">the name of the request #GstPad + line="1236">the name of the request #GstPad to retrieve. Can be %NULL.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> @@ -19833,7 +19859,7 @@ to retrieve. Can be %NULL.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1225">the caps of the pad we want to + line="1238">the caps of the pad we want to request. Can be %NULL.</doc> <type name="Caps" c:type="const GstCaps*"/> </parameter> @@ -19842,7 +19868,7 @@ request. Can be %NULL.</doc> <virtual-method name="send_event" invoker="send_event"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1902">Sends an event to an element. If the element doesn't implement an + line="1915">Sends an event to an element. If the element doesn't implement an event handler, the event will be pushed on a random linked sink pad for downstream events or a random linked source pad for upstream events. @@ -19854,7 +19880,7 @@ MT safe.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1916">%TRUE if the event was handled. Events that trigger a preroll (such + line="1929">%TRUE if the event was handled. Events that trigger a preroll (such as flushing seeks and steps) will emit %GST_MESSAGE_ASYNC_DONE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -19862,13 +19888,13 @@ as flushing seeks and steps) will emit %GST_MESSAGE_ASYNC_DONE.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1904">a #GstElement to send the event to.</doc> + line="1917">a #GstElement to send the event to.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="event" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1905">the #GstEvent to send to the element.</doc> + line="1918">the #GstEvent to send to the element.</doc> <type name="Event" c:type="GstEvent*"/> </parameter> </parameters> @@ -19876,7 +19902,7 @@ as flushing seeks and steps) will emit %GST_MESSAGE_ASYNC_DONE.</doc> <virtual-method name="set_bus" invoker="set_bus"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3435">Sets the bus of the element. Increases the refcount on the bus. + line="3448">Sets the bus of the element. Increases the refcount on the bus. For internal use only, unless you're testing elements. MT safe.</doc> @@ -19888,7 +19914,7 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3437">a #GstElement to set the bus of.</doc> + line="3450">a #GstElement to set the bus of.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="bus" @@ -19897,7 +19923,7 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3438">the #GstBus to set.</doc> + line="3451">the #GstBus to set.</doc> <type name="Bus" c:type="GstBus*"/> </parameter> </parameters> @@ -19905,14 +19931,14 @@ MT safe.</doc> <virtual-method name="set_clock" invoker="set_clock"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="410">Sets the clock for the element. This function increases the + line="413">Sets the clock for the element. This function increases the refcount on the clock. Any previously set clock on the object is unreffed.</doc> <source-position filename="gst/gstelement.h" line="731"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="419">%TRUE if the element accepted the clock. An element can refuse a + line="422">%TRUE if the element accepted the clock. An element can refuse a clock when it, for example, is not able to slave its internal clock to the @clock or when it requires a specific clock to operate. @@ -19923,7 +19949,7 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="412">a #GstElement to set the clock for.</doc> + line="415">a #GstElement to set the clock for.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="clock" @@ -19932,7 +19958,7 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="413">the #GstClock to set for the element.</doc> + line="416">the #GstClock to set for the element.</doc> <type name="Clock" c:type="GstClock*"/> </parameter> </parameters> @@ -19940,7 +19966,7 @@ MT safe.</doc> <virtual-method name="set_context" invoker="set_context"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3520">Sets the context of the element. Increases the refcount of the context. + line="3533">Sets the context of the element. Increases the refcount of the context. MT safe.</doc> <source-position filename="gst/gstelement.h" line="740"/> @@ -19951,13 +19977,13 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3522">a #GstElement to set the context of.</doc> + line="3535">a #GstElement to set the context of.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="context" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3523">the #GstContext to set.</doc> + line="3536">the #GstContext to set.</doc> <type name="Context" c:type="GstContext*"/> </parameter> </parameters> @@ -19965,7 +19991,7 @@ MT safe.</doc> <virtual-method name="set_state" invoker="set_state"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2854">Sets the state of the element. This function will try to set the + line="2867">Sets the state of the element. This function will try to set the requested state by going through all the intermediary states and calling the class's state change function for each. @@ -19982,7 +20008,7 @@ State changes to %GST_STATE_READY or %GST_STATE_NULL never return <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2873">Result of the state change using #GstStateChangeReturn. + line="2886">Result of the state change using #GstStateChangeReturn. MT safe.</doc> <type name="StateChangeReturn" c:type="GstStateChangeReturn"/> @@ -19991,13 +20017,13 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2856">a #GstElement to change state of.</doc> + line="2869">a #GstElement to change state of.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="state" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2857">the element's new #GstState.</doc> + line="2870">the element's new #GstState.</doc> <type name="State" c:type="GstState"/> </parameter> </parameters> @@ -20025,7 +20051,7 @@ MT safe.</doc> <method name="abort_state" c:identifier="gst_element_abort_state"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2595">Abort the state change of the element. This function is used + line="2608">Abort the state change of the element. This function is used by elements that do asynchronous state changes and find out something is wrong. @@ -20040,7 +20066,7 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2597">a #GstElement to abort the state of.</doc> + line="2610">a #GstElement to abort the state of.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> </parameters> @@ -20048,7 +20074,7 @@ MT safe.</doc> <method name="add_pad" c:identifier="gst_element_add_pad"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="716">Adds a pad (link point) to @element. @pad's parent will be set to @element; + line="719">Adds a pad (link point) to @element. @pad's parent will be set to @element; see gst_object_set_parent() for refcounting information. Pads are automatically activated when added in the PAUSED or PLAYING @@ -20061,7 +20087,7 @@ This function will emit the #GstElement::pad-added signal on the element.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="731">%TRUE if the pad could be added. This function can fail when + line="734">%TRUE if the pad could be added. This function can fail when a pad with the same name already existed or the pad already had another parent. @@ -20072,13 +20098,13 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="718">a #GstElement to add the pad to.</doc> + line="721">a #GstElement to add the pad to.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="pad" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="719">the #GstPad to add to the element.</doc> + line="722">the #GstPad to add to the element.</doc> <type name="Pad" c:type="GstPad*"/> </parameter> </parameters> @@ -20090,7 +20116,7 @@ MT safe.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3720">a watch id, which can be used in connection with + line="3733">a watch id, which can be used in connection with gst_element_remove_property_notify_watch() to remove the watch again.</doc> <type name="gulong" c:type="gulong"/> </return-value> @@ -20098,7 +20124,7 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3715">a #GstElement to watch (recursively) for property changes</doc> + line="3728">a #GstElement to watch (recursively) for property changes</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="property_name" @@ -20107,14 +20133,14 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3716">name of property to watch for changes, or + line="3729">name of property to watch for changes, or NULL to watch all properties</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="include_value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3718">whether to include the new property value in the message</doc> + line="3731">whether to include the new property value in the message</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -20126,7 +20152,7 @@ MT safe.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3688">a watch id, which can be used in connection with + line="3701">a watch id, which can be used in connection with gst_element_remove_property_notify_watch() to remove the watch again.</doc> <type name="gulong" c:type="gulong"/> </return-value> @@ -20134,7 +20160,7 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3683">a #GstElement to watch for property changes</doc> + line="3696">a #GstElement to watch for property changes</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="property_name" @@ -20143,14 +20169,14 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3684">name of property to watch for changes, or + line="3697">name of property to watch for changes, or NULL to watch all properties</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="include_value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3686">whether to include the new property value in the message</doc> + line="3699">whether to include the new property value in the message</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -20160,7 +20186,7 @@ MT safe.</doc> version="1.10"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3778">Calls @func from another thread and passes @user_data to it. This is to be + line="3791">Calls @func from another thread and passes @user_data to it. This is to be used for cases when a state change has to be performed from a streaming thread, directly via gst_element_set_state() or indirectly e.g. via SEEK events. @@ -20178,7 +20204,7 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3780">a #GstElement</doc> + line="3793">a #GstElement</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="func" @@ -20188,7 +20214,7 @@ MT safe.</doc> destroy="2"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3781">Function to call asynchronously from another thread</doc> + line="3794">Function to call asynchronously from another thread</doc> <type name="ElementCallAsyncFunc" c:type="GstElementCallAsyncFunc"/> </parameter> @@ -20198,7 +20224,7 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3782">Data to pass to @func</doc> + line="3795">Data to pass to @func</doc> <type name="gpointer" c:type="gpointer"/> </parameter> <parameter name="destroy_notify" @@ -20206,7 +20232,7 @@ MT safe.</doc> scope="async"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3783">GDestroyNotify for @user_data</doc> + line="3796">GDestroyNotify for @user_data</doc> <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/> </parameter> </parameters> @@ -20214,7 +20240,7 @@ MT safe.</doc> <method name="change_state" c:identifier="gst_element_change_state"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3009">Perform @transition on @element. + line="3022">Perform @transition on @element. This function must be called with STATE_LOCK held and is mainly used internally.</doc> @@ -20222,20 +20248,20 @@ internally.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3019">the #GstStateChangeReturn of the state transition.</doc> + line="3032">the #GstStateChangeReturn of the state transition.</doc> <type name="StateChangeReturn" c:type="GstStateChangeReturn"/> </return-value> <parameters> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3011">a #GstElement</doc> + line="3024">a #GstElement</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="transition" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3012">the requested transition</doc> + line="3025">the requested transition</doc> <type name="StateChange" c:type="GstStateChange"/> </parameter> </parameters> @@ -20243,7 +20269,7 @@ internally.</doc> <method name="continue_state" c:identifier="gst_element_continue_state"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2670">Commit the state change of the element and proceed to the next + line="2683">Commit the state change of the element and proceed to the next pending state if any. This function is used by elements that do asynchronous state changes. The core will normally call this method automatically when an @@ -20260,7 +20286,7 @@ This function must be called with STATE_LOCK held.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2689">The result of the commit state change. + line="2702">The result of the commit state change. MT safe.</doc> <type name="StateChangeReturn" c:type="GstStateChangeReturn"/> @@ -20269,13 +20295,13 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2672">a #GstElement to continue the state change of.</doc> + line="2685">a #GstElement to continue the state change of.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="ret" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2673">The previous state return value</doc> + line="2686">The previous state return value</doc> <type name="StateChangeReturn" c:type="GstStateChangeReturn"/> </parameter> </parameters> @@ -20287,7 +20313,7 @@ MT safe.</doc> line="881">Creates a pad for each pad template that is always available. This function is only useful during object initialization of subclasses of #GstElement.</doc> - <source-position filename="gst/gstutils.h" line="981"/> + <source-position filename="gst/gstutils.h" line="984"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -20305,7 +20331,7 @@ subclasses of #GstElement.</doc> version="1.14"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1416">Call @func with @user_data for each of @element's pads. @func will be called + line="1429">Call @func with @user_data for each of @element's pads. @func will be called exactly once for each pad that exists at the time of this call, unless one of the calls to @func returns %FALSE in which case we will stop iterating pads and return early. If new pads are added or pads are removed @@ -20315,7 +20341,7 @@ next time this function is used.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1429">%FALSE if @element had no pads or if one of the calls to @func + line="1442">%FALSE if @element had no pads or if one of the calls to @func returned %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -20323,7 +20349,7 @@ next time this function is used.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1418">a #GstElement to iterate pads of</doc> + line="1431">a #GstElement to iterate pads of</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="func" @@ -20332,7 +20358,7 @@ next time this function is used.</doc> closure="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1419">function to call for each pad</doc> + line="1432">function to call for each pad</doc> <type name="ElementForeachPadFunc" c:type="GstElementForeachPadFunc"/> </parameter> @@ -20342,7 +20368,7 @@ next time this function is used.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1420">user data passed to @func</doc> + line="1433">user data passed to @func</doc> <type name="gpointer" c:type="gpointer"/> </parameter> </parameters> @@ -20352,7 +20378,7 @@ next time this function is used.</doc> version="1.14"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1364">Call @func with @user_data for each of @element's sink pads. @func will be + line="1377">Call @func with @user_data for each of @element's sink pads. @func will be called exactly once for each sink pad that exists at the time of this call, unless one of the calls to @func returns %FALSE in which case we will stop iterating pads and return early. If new sink pads are added or sink pads @@ -20362,7 +20388,7 @@ into account until next time this function is used.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1377">%FALSE if @element had no sink pads or if one of the calls to @func + line="1390">%FALSE if @element had no sink pads or if one of the calls to @func returned %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -20370,7 +20396,7 @@ into account until next time this function is used.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1366">a #GstElement to iterate sink pads of</doc> + line="1379">a #GstElement to iterate sink pads of</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="func" @@ -20379,7 +20405,7 @@ into account until next time this function is used.</doc> closure="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1367">function to call for each sink pad</doc> + line="1380">function to call for each sink pad</doc> <type name="ElementForeachPadFunc" c:type="GstElementForeachPadFunc"/> </parameter> @@ -20389,7 +20415,7 @@ into account until next time this function is used.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1368">user data passed to @func</doc> + line="1381">user data passed to @func</doc> <type name="gpointer" c:type="gpointer"/> </parameter> </parameters> @@ -20399,7 +20425,7 @@ into account until next time this function is used.</doc> version="1.14"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1390">Call @func with @user_data for each of @element's source pads. @func will be + line="1403">Call @func with @user_data for each of @element's source pads. @func will be called exactly once for each source pad that exists at the time of this call, unless one of the calls to @func returns %FALSE in which case we will stop iterating pads and return early. If new source pads are added or source pads @@ -20409,7 +20435,7 @@ into account until next time this function is used.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1403">%FALSE if @element had no source pads or if one of the calls + line="1416">%FALSE if @element had no source pads or if one of the calls to @func returned %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -20417,7 +20443,7 @@ into account until next time this function is used.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1392">a #GstElement to iterate source pads of</doc> + line="1405">a #GstElement to iterate source pads of</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="func" @@ -20426,7 +20452,7 @@ into account until next time this function is used.</doc> closure="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1393">function to call for each source pad</doc> + line="1406">function to call for each source pad</doc> <type name="ElementForeachPadFunc" c:type="GstElementForeachPadFunc"/> </parameter> @@ -20436,7 +20462,7 @@ into account until next time this function is used.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1394">user data passed to @func</doc> + line="1407">user data passed to @func</doc> <type name="gpointer" c:type="gpointer"/> </parameter> </parameters> @@ -20444,7 +20470,7 @@ into account until next time this function is used.</doc> <method name="get_base_time" c:identifier="gst_element_get_base_time"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="499">Returns the base time of the element. The base time is the + line="502">Returns the base time of the element. The base time is the absolute time of the clock when this element was last put to PLAYING. Subtracting the base time from the clock time gives the running time of the element.</doc> @@ -20452,7 +20478,7 @@ the running time of the element.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="508">the base time of the element. + line="511">the base time of the element. MT safe.</doc> <type name="ClockTime" c:type="GstClockTime"/> @@ -20461,7 +20487,7 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="501">a #GstElement.</doc> + line="504">a #GstElement.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> </parameters> @@ -20469,13 +20495,13 @@ MT safe.</doc> <method name="get_bus" c:identifier="gst_element_get_bus"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3458">Returns the bus of the element. Note that only a #GstPipeline will provide a + line="3471">Returns the bus of the element. Note that only a #GstPipeline will provide a bus for the application.</doc> <source-position filename="gst/gstelement.h" line="875"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3465">the element's #GstBus. unref after + line="3478">the element's #GstBus. unref after usage. MT safe.</doc> @@ -20485,7 +20511,7 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3460">a #GstElement to get the bus of.</doc> + line="3473">a #GstElement to get the bus of.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> </parameters> @@ -20493,7 +20519,7 @@ MT safe.</doc> <method name="get_clock" c:identifier="gst_element_get_clock"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="444">Gets the currently configured clock of the element. This is the clock as was + line="447">Gets the currently configured clock of the element. This is the clock as was last set with gst_element_set_clock(). Elements in a pipeline will only have their clock set when the @@ -20502,7 +20528,7 @@ pipeline is in the PLAYING state.</doc> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="454">the #GstClock of the element. unref after usage. + line="457">the #GstClock of the element. unref after usage. MT safe.</doc> <type name="Clock" c:type="GstClock*"/> @@ -20511,7 +20537,7 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="446">a #GstElement to get the clock of.</doc> + line="449">a #GstElement to get the clock of.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> </parameters> @@ -20527,7 +20553,7 @@ cases. This function will first attempt to find a compatible unlinked ALWAYS pad, and if none can be found, it will request a compatible REQUEST pad by looking at the templates of @element.</doc> - <source-position filename="gst/gstutils.h" line="984"/> + <source-position filename="gst/gstutils.h" line="987"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -20566,7 +20592,7 @@ at the templates of @element.</doc> filename="gst/gstutils.c" line="914">Retrieves a pad template from @element that is compatible with @compattempl. Pads from compatible templates can be linked together.</doc> - <source-position filename="gst/gstutils.h" line="987"/> + <source-position filename="gst/gstutils.h" line="990"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -20595,27 +20621,27 @@ Pads from compatible templates can be linked together.</doc> version="1.8"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3612">Gets the context with @context_type set on the element or NULL. + line="3625">Gets the context with @context_type set on the element or NULL. MT safe.</doc> <source-position filename="gst/gstelement.h" line="886"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3621">A #GstContext or NULL</doc> + line="3634">A #GstContext or NULL</doc> <type name="Context" c:type="GstContext*"/> </return-value> <parameters> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3614">a #GstElement to get the context of.</doc> + line="3627">a #GstElement to get the context of.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="context_type" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3615">a name of a context to retrieve</doc> + line="3628">a name of a context to retrieve</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -20625,25 +20651,25 @@ MT safe.</doc> version="1.8"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3583">Gets the context with @context_type set on the element or NULL.</doc> + line="3596">Gets the context with @context_type set on the element or NULL.</doc> <source-position filename="gst/gstelement.h" line="889"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3590">A #GstContext or NULL</doc> + line="3603">A #GstContext or NULL</doc> <type name="Context" c:type="GstContext*"/> </return-value> <parameters> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3585">a #GstElement to get the context of.</doc> + line="3598">a #GstElement to get the context of.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="context_type" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3586">a name of a context to retrieve</doc> + line="3599">a name of a context to retrieve</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -20653,14 +20679,14 @@ MT safe.</doc> version="1.8"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3547">Gets the contexts set on the element. + line="3560">Gets the contexts set on the element. MT safe.</doc> <source-position filename="gst/gstelement.h" line="883"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3555">List of #GstContext</doc> + line="3568">List of #GstContext</doc> <type name="GLib.List" c:type="GList*"> <type name="Context"/> </type> @@ -20669,7 +20695,7 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3549">a #GstElement to set the context of.</doc> + line="3562">a #GstElement to set the context of.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> </parameters> @@ -20679,13 +20705,13 @@ MT safe.</doc> version="1.18"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="630">Returns the current clock time of the element, as in, the time of the + line="633">Returns the current clock time of the element, as in, the time of the element's clock, or GST_CLOCK_TIME_NONE if there is no clock.</doc> <source-position filename="gst/gstelement.h" line="867"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="637">the clock time of the element, or GST_CLOCK_TIME_NONE if there is + line="640">the clock time of the element, or GST_CLOCK_TIME_NONE if there is no clock.</doc> <type name="ClockTime" c:type="GstClockTime"/> </return-value> @@ -20693,7 +20719,7 @@ no clock.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="632">a #GstElement.</doc> + line="635">a #GstElement.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> </parameters> @@ -20703,14 +20729,14 @@ no clock.</doc> version="1.18"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="589">Returns the running time of the element. The running time is the + line="592">Returns the running time of the element. The running time is the element's clock time minus its base time. Will return GST_CLOCK_TIME_NONE if the element has no clock, or if its base time has not been set.</doc> <source-position filename="gst/gstelement.h" line="864"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="597">the running time of the element, or GST_CLOCK_TIME_NONE if the + line="600">the running time of the element, or GST_CLOCK_TIME_NONE if the element has no clock or its base time has not been set.</doc> <type name="ClockTime" c:type="GstClockTime"/> </return-value> @@ -20718,7 +20744,7 @@ element has no clock or its base time has not been set.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="591">a #GstElement.</doc> + line="594">a #GstElement.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> </parameters> @@ -20726,12 +20752,12 @@ element has no clock or its base time has not been set.</doc> <method name="get_factory" c:identifier="gst_element_get_factory"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3304">Retrieves the factory that was used to create this element.</doc> + line="3317">Retrieves the factory that was used to create this element.</doc> <source-position filename="gst/gstelement.h" line="1042"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3310">the #GstElementFactory used for creating this + line="3323">the #GstElementFactory used for creating this element or %NULL if element has not been registered (static element). no refcounting is needed.</doc> <type name="ElementFactory" c:type="GstElementFactory*"/> </return-value> @@ -20739,7 +20765,7 @@ element has no clock or its base time has not been set.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3306">a #GstElement to request the element factory of.</doc> + line="3319">a #GstElement to request the element factory of.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> </parameters> @@ -20749,25 +20775,25 @@ element has no clock or its base time has not been set.</doc> version="1.14"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1678">Get metadata with @key in @klass.</doc> + line="1691">Get metadata with @key in @klass.</doc> <source-position filename="gst/gstelement.h" line="1064"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1685">the metadata for @key.</doc> + line="1698">the metadata for @key.</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1680">class to get metadata for</doc> + line="1693">class to get metadata for</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="key" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1681">the key to get</doc> + line="1694">the key to get</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -20777,12 +20803,12 @@ element has no clock or its base time has not been set.</doc> version="1.14"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1777">Retrieves a padtemplate from @element with the given name.</doc> + line="1790">Retrieves a padtemplate from @element with the given name.</doc> <source-position filename="gst/gstelement.h" line="1059"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1784">the #GstPadTemplate with the + line="1797">the #GstPadTemplate with the given name, or %NULL if none was found. No unreferencing is necessary.</doc> <type name="PadTemplate" c:type="GstPadTemplate*"/> @@ -20791,13 +20817,13 @@ element has no clock or its base time has not been set.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1779">a #GstElement to get the pad template of.</doc> + line="1792">a #GstElement to get the pad template of.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1780">the name of the #GstPadTemplate to get.</doc> + line="1793">the name of the #GstPadTemplate to get.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -20807,13 +20833,13 @@ element has no clock or its base time has not been set.</doc> version="1.14"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1719">Retrieves a list of the pad templates associated with @element. The + line="1732">Retrieves a list of the pad templates associated with @element. The list must not be modified by the calling code.</doc> <source-position filename="gst/gstelement.h" line="1062"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1726">the #GList of + line="1739">the #GList of pad templates.</doc> <type name="GLib.List" c:type="GList*"> <type name="PadTemplate"/> @@ -20823,7 +20849,7 @@ list must not be modified by the calling code.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1721">a #GstElement to get pad templates of.</doc> + line="1734">a #GstElement to get pad templates of.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> </parameters> @@ -20832,7 +20858,7 @@ list must not be modified by the calling code.</doc> c:identifier="gst_element_get_request_pad"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1157">Retrieves a pad from the element by name (e.g. "src_\%d"). This version only + line="1170">Retrieves a pad from the element by name (e.g. "src_\%d"). This version only retrieves request pads. The pad should be released with gst_element_release_request_pad(). @@ -20843,7 +20869,7 @@ gst_element_request_pad() if the pads should have a specific name (e.g. <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1170">requested #GstPad if found, + line="1183">requested #GstPad if found, otherwise %NULL. Release after usage.</doc> <type name="Pad" c:type="GstPad*"/> </return-value> @@ -20851,13 +20877,13 @@ gst_element_request_pad() if the pads should have a specific name (e.g. <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1159">a #GstElement to find a request pad of.</doc> + line="1172">a #GstElement to find a request pad of.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1160">the name of the request #GstPad to retrieve.</doc> + line="1173">the name of the request #GstPad to retrieve.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -20865,7 +20891,7 @@ gst_element_request_pad() if the pads should have a specific name (e.g. <method name="get_start_time" c:identifier="gst_element_get_start_time"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="561">Returns the start time of the element. The start time is the + line="564">Returns the start time of the element. The start time is the running time of the clock when this element was last put to PAUSED. Usually the start_time is managed by a toplevel element such as @@ -20876,14 +20902,14 @@ MT safe.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="573">the start time of the element.</doc> + line="576">the start time of the element.</doc> <type name="ClockTime" c:type="GstClockTime"/> </return-value> <parameters> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="563">a #GstElement.</doc> + line="566">a #GstElement.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> </parameters> @@ -20891,7 +20917,7 @@ MT safe.</doc> <method name="get_state" c:identifier="gst_element_get_state"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2540">Gets the state of the element. + line="2553">Gets the state of the element. For elements that performed an ASYNC state change, as reported by gst_element_set_state(), this function will block up to the @@ -20915,7 +20941,7 @@ element to playing, the preroll will complete and playback will start.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2571">%GST_STATE_CHANGE_SUCCESS if the element has no more pending state + line="2584">%GST_STATE_CHANGE_SUCCESS if the element has no more pending state and the last state change succeeded, %GST_STATE_CHANGE_ASYNC if the element is still performing a state change or %GST_STATE_CHANGE_FAILURE if the last state change failed. @@ -20927,7 +20953,7 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2542">a #GstElement to get the state of.</doc> + line="2555">a #GstElement to get the state of.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="state" @@ -20938,7 +20964,7 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2543">a pointer to #GstState to hold the state. + line="2556">a pointer to #GstState to hold the state. Can be %NULL.</doc> <type name="State" c:type="GstState*"/> </parameter> @@ -20950,14 +20976,14 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2545">a pointer to #GstState to hold the pending + line="2558">a pointer to #GstState to hold the pending state. Can be %NULL.</doc> <type name="State" c:type="GstState*"/> </parameter> <parameter name="timeout" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2547">a #GstClockTime to specify the timeout for an async + line="2560">a #GstClockTime to specify the timeout for an async state change or %GST_CLOCK_TIME_NONE for infinite timeout.</doc> <type name="ClockTime" c:type="GstClockTime"/> </parameter> @@ -20966,13 +20992,13 @@ MT safe.</doc> <method name="get_static_pad" c:identifier="gst_element_get_static_pad"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="962">Retrieves a pad from @element by name. This version only retrieves + line="975">Retrieves a pad from @element by name. This version only retrieves already-existing (i.e. 'static') pads.</doc> <source-position filename="gst/gstelement.h" line="903"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="970">the requested #GstPad if + line="983">the requested #GstPad if found, otherwise %NULL. unref after usage. MT safe.</doc> @@ -20982,13 +21008,13 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="964">a #GstElement to find a static pad of.</doc> + line="977">a #GstElement to find a static pad of.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="965">the name of the static #GstPad to retrieve.</doc> + line="978">the name of the static #GstPad to retrieve.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -20997,7 +21023,7 @@ MT safe.</doc> c:identifier="gst_element_is_locked_state"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2289">Checks if the state of an element is locked. + line="2302">Checks if the state of an element is locked. If the state of an element is locked, state changes of the parent don't affect the element. This way you can leave currently unused elements inside bins. Just lock their @@ -21008,14 +21034,14 @@ MT safe.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2301">%TRUE, if the element's state is locked.</doc> + line="2314">%TRUE, if the element's state is locked.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2291">a #GstElement.</doc> + line="2304">a #GstElement.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> </parameters> @@ -21023,7 +21049,7 @@ MT safe.</doc> <method name="iterate_pads" c:identifier="gst_element_iterate_pads"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1262">Retrieves an iterator of @element's pads. The iterator should + line="1275">Retrieves an iterator of @element's pads. The iterator should be freed after usage. Also more specialized iterators exists such as gst_element_iterate_src_pads() or gst_element_iterate_sink_pads(). @@ -21033,7 +21059,7 @@ the pads were added to the element.</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1273">the #GstIterator of #GstPad. + line="1286">the #GstIterator of #GstPad. MT safe.</doc> <type name="Iterator" c:type="GstIterator*"/> @@ -21042,7 +21068,7 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1264">a #GstElement to iterate pads of.</doc> + line="1277">a #GstElement to iterate pads of.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> </parameters> @@ -21051,7 +21077,7 @@ MT safe.</doc> c:identifier="gst_element_iterate_sink_pads"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1306">Retrieves an iterator of @element's sink pads. + line="1319">Retrieves an iterator of @element's sink pads. The order of pads returned by the iterator will be the order in which the pads were added to the element.</doc> @@ -21059,7 +21085,7 @@ the pads were added to the element.</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1315">the #GstIterator of #GstPad. + line="1328">the #GstIterator of #GstPad. MT safe.</doc> <type name="Iterator" c:type="GstIterator*"/> @@ -21068,7 +21094,7 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1308">a #GstElement.</doc> + line="1321">a #GstElement.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> </parameters> @@ -21077,7 +21103,7 @@ MT safe.</doc> c:identifier="gst_element_iterate_src_pads"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1285">Retrieves an iterator of @element's source pads. + line="1298">Retrieves an iterator of @element's source pads. The order of pads returned by the iterator will be the order in which the pads were added to the element.</doc> @@ -21085,7 +21111,7 @@ the pads were added to the element.</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1294">the #GstIterator of #GstPad. + line="1307">the #GstIterator of #GstPad. MT safe.</doc> <type name="Iterator" c:type="GstIterator*"/> @@ -21094,7 +21120,7 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1287">a #GstElement.</doc> + line="1300">a #GstElement.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> </parameters> @@ -21110,7 +21136,7 @@ If multiple links are possible, only one is established. Make sure you have added your elements to a bin or pipeline with gst_bin_add() before trying to link them.</doc> - <source-position filename="gst/gstutils.h" line="999"/> + <source-position filename="gst/gstutils.h" line="1002"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -21143,7 +21169,7 @@ If multiple links are possible, only one is established. Make sure you have added your elements to a bin or pipeline with gst_bin_add() before trying to link them.</doc> - <source-position filename="gst/gstutils.h" line="1005"/> + <source-position filename="gst/gstutils.h" line="1008"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -21183,7 +21209,7 @@ gst_bin_add() before trying to link them.</doc> line="2235">Chain together a series of elements. Uses gst_element_link(). Make sure you have added your elements to a bin or pipeline with gst_bin_add() before trying to link them.</doc> - <source-position filename="gst/gstutils.h" line="1002"/> + <source-position filename="gst/gstutils.h" line="1005"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -21218,7 +21244,7 @@ gst_bin_add() before trying to link them.</doc> Side effect is that if one of the pads has no parent, it becomes a child of the parent of the other element. If they have different parents, the link fails.</doc> - <source-position filename="gst/gstutils.h" line="1015"/> + <source-position filename="gst/gstutils.h" line="1018"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -21268,7 +21294,7 @@ or %NULL for any pad.</doc> is that if one of the pads has no parent, it becomes a child of the parent of the other element. If they have different parents, the link fails. If @caps is not %NULL, makes sure that the caps of the link is a subset of @caps.</doc> - <source-position filename="gst/gstutils.h" line="1025"/> + <source-position filename="gst/gstutils.h" line="1028"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -21333,7 +21359,7 @@ is the same as calling gst_element_link_pads() and the recommended way of linking pads with safety checks applied. This is a convenience function for gst_pad_link_full().</doc> - <source-position filename="gst/gstutils.h" line="1018"/> + <source-position filename="gst/gstutils.h" line="1021"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -21384,7 +21410,7 @@ or %NULL for any pad.</doc> <method name="lost_state" c:identifier="gst_element_lost_state"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2776">Brings the element to the lost state. The current state of the + line="2789">Brings the element to the lost state. The current state of the element is copied to the pending state so that any call to gst_element_get_state() will return %GST_STATE_CHANGE_ASYNC. @@ -21408,7 +21434,7 @@ plugins or applications.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2778">a #GstElement the state is lost of</doc> + line="2791">a #GstElement the state is lost of</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> </parameters> @@ -21416,7 +21442,7 @@ plugins or applications.</doc> <method name="message_full" c:identifier="gst_element_message_full"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2257">Post an error, warning or info message on the bus from inside an element. + line="2270">Post an error, warning or info message on the bus from inside an element. @type must be of #GST_MESSAGE_ERROR, #GST_MESSAGE_WARNING or #GST_MESSAGE_INFO. @@ -21430,25 +21456,25 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2259">a #GstElement to send message from</doc> + line="2272">a #GstElement to send message from</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="type" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2260">the #GstMessageType</doc> + line="2273">the #GstMessageType</doc> <type name="MessageType" c:type="GstMessageType"/> </parameter> <parameter name="domain" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2261">the GStreamer GError domain this message belongs to</doc> + line="2274">the GStreamer GError domain this message belongs to</doc> <type name="GLib.Quark" c:type="GQuark"/> </parameter> <parameter name="code" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2262">the GError code belonging to the domain</doc> + line="2275">the GError code belonging to the domain</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="text" @@ -21457,7 +21483,7 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2263">an allocated text string to be used + line="2276">an allocated text string to be used as a replacement for the default message connected to code, or %NULL</doc> <type name="utf8" c:type="gchar*"/> @@ -21468,7 +21494,7 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2266">an allocated debug message to be + line="2279">an allocated debug message to be used as a replacement for the default debugging information, or %NULL</doc> <type name="utf8" c:type="gchar*"/> @@ -21476,19 +21502,19 @@ MT safe.</doc> <parameter name="file" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2269">the source code file where the error was generated</doc> + line="2282">the source code file where the error was generated</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="function" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2270">the source code function where the error was generated</doc> + line="2283">the source code function where the error was generated</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="line" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2271">the source code line where the error was generated</doc> + line="2284">the source code line where the error was generated</doc> <type name="gint" c:type="gint"/> </parameter> </parameters> @@ -21498,7 +21524,7 @@ MT safe.</doc> version="1.10"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2153">Post an error, warning or info message on the bus from inside an element. + line="2166">Post an error, warning or info message on the bus from inside an element. @type must be of #GST_MESSAGE_ERROR, #GST_MESSAGE_WARNING or #GST_MESSAGE_INFO.</doc> @@ -21510,25 +21536,25 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2155">a #GstElement to send message from</doc> + line="2168">a #GstElement to send message from</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="type" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2156">the #GstMessageType</doc> + line="2169">the #GstMessageType</doc> <type name="MessageType" c:type="GstMessageType"/> </parameter> <parameter name="domain" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2157">the GStreamer GError domain this message belongs to</doc> + line="2170">the GStreamer GError domain this message belongs to</doc> <type name="GLib.Quark" c:type="GQuark"/> </parameter> <parameter name="code" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2158">the GError code belonging to the domain</doc> + line="2171">the GError code belonging to the domain</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="text" @@ -21537,7 +21563,7 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2159">an allocated text string to be used + line="2172">an allocated text string to be used as a replacement for the default message connected to code, or %NULL</doc> <type name="utf8" c:type="gchar*"/> @@ -21548,7 +21574,7 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2162">an allocated debug message to be + line="2175">an allocated debug message to be used as a replacement for the default debugging information, or %NULL</doc> <type name="utf8" c:type="gchar*"/> @@ -21556,25 +21582,25 @@ MT safe.</doc> <parameter name="file" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2165">the source code file where the error was generated</doc> + line="2178">the source code file where the error was generated</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="function" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2166">the source code function where the error was generated</doc> + line="2179">the source code function where the error was generated</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="line" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2167">the source code line where the error was generated</doc> + line="2180">the source code line where the error was generated</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="structure" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2168">optional details structure</doc> + line="2181">optional details structure</doc> <type name="Structure" c:type="GstStructure*"/> </parameter> </parameters> @@ -21582,7 +21608,7 @@ MT safe.</doc> <method name="no_more_pads" c:identifier="gst_element_no_more_pads"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="928">Use this function to signal that the element does not expect any more pads + line="941">Use this function to signal that the element does not expect any more pads to show up in the current pipeline. This function should be called whenever pads have been added by the element itself. Elements with #GST_PAD_SOMETIMES pad templates use this in combination with autopluggers to figure out that @@ -21599,7 +21625,7 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="930">a #GstElement</doc> + line="943">a #GstElement</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> </parameters> @@ -21607,14 +21633,14 @@ MT safe.</doc> <method name="post_message" c:identifier="gst_element_post_message"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2083">Post a message on the element's #GstBus. This function takes ownership of the + line="2096">Post a message on the element's #GstBus. This function takes ownership of the message; if you want to access the message after this call, you should add an additional reference before calling.</doc> <source-position filename="gst/gstelement.h" line="968"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2092">%TRUE if the message was successfully posted. The function returns + line="2105">%TRUE if the message was successfully posted. The function returns %FALSE if the element did not have a bus. MT safe.</doc> @@ -21624,13 +21650,13 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2085">a #GstElement posting the message</doc> + line="2098">a #GstElement posting the message</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="message" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2086">a #GstMessage to post</doc> + line="2099">a #GstMessage to post</doc> <type name="Message" c:type="GstMessage*"/> </parameter> </parameters> @@ -21638,14 +21664,14 @@ MT safe.</doc> <method name="provide_clock" c:identifier="gst_element_provide_clock"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="368">Get the clock provided by the given element. + line="371">Get the clock provided by the given element. > An element is only required to provide a clock in the PAUSED > state. Some elements can provide a clock in other states.</doc> <source-position filename="gst/gstelement.h" line="843"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="376">the GstClock provided by the + line="379">the GstClock provided by the element or %NULL if no clock could be provided. Unref after usage. MT safe.</doc> @@ -21655,7 +21681,7 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="370">a #GstElement to query</doc> + line="373">a #GstElement to query</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> </parameters> @@ -21663,7 +21689,7 @@ MT safe.</doc> <method name="query" c:identifier="gst_element_query"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2008">Performs a query on the given element. + line="2021">Performs a query on the given element. For elements that don't implement a query handler, this function forwards the query to a random srcpad or to the peer of a @@ -21674,7 +21700,7 @@ Please note that some queries might need a running pipeline to work.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2021">%TRUE if the query could be performed. + line="2034">%TRUE if the query could be performed. MT safe.</doc> <type name="gboolean" c:type="gboolean"/> @@ -21683,13 +21709,13 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2010">a #GstElement to perform the query on.</doc> + line="2023">a #GstElement to perform the query on.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="query" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2011">the #GstQuery.</doc> + line="2024">the #GstQuery.</doc> <type name="Query" c:type="GstQuery*"/> </parameter> </parameters> @@ -21698,7 +21724,7 @@ MT safe.</doc> <doc xml:space="preserve" filename="gst/gstutils.c" line="2534">Queries an element to convert @src_val in @src_format to @dest_format.</doc> - <source-position filename="gst/gstutils.h" line="1057"/> + <source-position filename="gst/gstutils.h" line="1060"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -21752,7 +21778,7 @@ will receive an ASYNC_DONE message on the pipeline bus when that is the case. If the duration changes for some reason, you will get a DURATION_CHANGED message on the pipeline bus, in which case you should re-query the duration using this function.</doc> - <source-position filename="gst/gstutils.h" line="1054"/> + <source-position filename="gst/gstutils.h" line="1057"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -21797,7 +21823,7 @@ bus when that is the case. If one repeatedly calls this function one can also create a query and reuse it in gst_element_query().</doc> - <source-position filename="gst/gstutils.h" line="1051"/> + <source-position filename="gst/gstutils.h" line="1054"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -21835,7 +21861,7 @@ it in gst_element_query().</doc> c:identifier="gst_element_release_request_pad"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="332">Makes the element free the previously requested pad as obtained + line="335">Makes the element free the previously requested pad as obtained with gst_element_request_pad(). This does not unref the pad. If the pad was created by using @@ -21851,13 +21877,13 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="334">a #GstElement to release the request pad of.</doc> + line="337">a #GstElement to release the request pad of.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="pad" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="335">the #GstPad to release.</doc> + line="338">the #GstPad to release.</doc> <type name="Pad" c:type="GstPad*"/> </parameter> </parameters> @@ -21865,7 +21891,7 @@ MT safe.</doc> <method name="remove_pad" c:identifier="gst_element_remove_pad"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="828">Removes @pad from @element. @pad will be destroyed if it has not been + line="831">Removes @pad from @element. @pad will be destroyed if it has not been referenced elsewhere using gst_object_unparent(). This function is used by plugin developers and should not be used @@ -21885,7 +21911,7 @@ This function will emit the #GstElement::pad-removed signal on the element.</doc <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="850">%TRUE if the pad could be removed. Can return %FALSE if the + line="853">%TRUE if the pad could be removed. Can return %FALSE if the pad does not belong to the provided element. MT safe.</doc> @@ -21895,13 +21921,13 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="830">a #GstElement to remove pad from.</doc> + line="833">a #GstElement to remove pad from.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="pad" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="831">the #GstPad to remove from the element.</doc> + line="834">the #GstPad to remove from the element.</doc> <type name="Pad" c:type="GstPad*"/> </parameter> </parameters> @@ -21917,13 +21943,13 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3747">a #GstElement being watched for property changes</doc> + line="3760">a #GstElement being watched for property changes</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="watch_id" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3748">watch id to remove</doc> + line="3761">watch id to remove</doc> <type name="gulong" c:type="gulong"/> </parameter> </parameters> @@ -21931,7 +21957,7 @@ MT safe.</doc> <method name="request_pad" c:identifier="gst_element_request_pad"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1219">Retrieves a request pad from the element according to the provided template. + line="1232">Retrieves a request pad from the element according to the provided template. Pad templates can be looked up using gst_element_factory_get_static_pad_templates(). @@ -21940,7 +21966,7 @@ The pad should be released with gst_element_release_request_pad().</doc> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1234">requested #GstPad if found, + line="1247">requested #GstPad if found, otherwise %NULL. Release after usage.</doc> <type name="Pad" c:type="GstPad*"/> </return-value> @@ -21948,13 +21974,13 @@ The pad should be released with gst_element_release_request_pad().</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1221">a #GstElement to find a request pad of.</doc> + line="1234">a #GstElement to find a request pad of.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="templ" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1222">a #GstPadTemplate of which we want a pad of.</doc> + line="1235">a #GstPadTemplate of which we want a pad of.</doc> <type name="PadTemplate" c:type="GstPadTemplate*"/> </parameter> <parameter name="name" @@ -21963,7 +21989,7 @@ The pad should be released with gst_element_release_request_pad().</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1223">the name of the request #GstPad + line="1236">the name of the request #GstPad to retrieve. Can be %NULL.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> @@ -21973,7 +21999,7 @@ to retrieve. Can be %NULL.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1225">the caps of the pad we want to + line="1238">the caps of the pad we want to request. Can be %NULL.</doc> <type name="Caps" c:type="const GstCaps*"/> </parameter> @@ -21982,7 +22008,7 @@ request. Can be %NULL.</doc> <method name="seek" c:identifier="gst_element_seek"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1943">Sends a seek event to an element. See gst_event_new_seek() for the details of + line="1956">Sends a seek event to an element. See gst_event_new_seek() for the details of the parameters. The seek event is sent to the element using gst_element_send_event(). @@ -21991,7 +22017,7 @@ MT safe.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1960">%TRUE if the event was handled. Flushing seeks will trigger a + line="1973">%TRUE if the event was handled. Flushing seeks will trigger a preroll, which will emit %GST_MESSAGE_ASYNC_DONE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -21999,49 +22025,49 @@ preroll, which will emit %GST_MESSAGE_ASYNC_DONE.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1945">a #GstElement to send the event to.</doc> + line="1958">a #GstElement to send the event to.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="rate" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1946">The new playback rate</doc> + line="1959">The new playback rate</doc> <type name="gdouble" c:type="gdouble"/> </parameter> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1947">The format of the seek values</doc> + line="1960">The format of the seek values</doc> <type name="Format" c:type="GstFormat"/> </parameter> <parameter name="flags" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1948">The optional seek flags.</doc> + line="1961">The optional seek flags.</doc> <type name="SeekFlags" c:type="GstSeekFlags"/> </parameter> <parameter name="start_type" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1949">The type and flags for the new start position</doc> + line="1962">The type and flags for the new start position</doc> <type name="SeekType" c:type="GstSeekType"/> </parameter> <parameter name="start" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1950">The value of the new start position</doc> + line="1963">The value of the new start position</doc> <type name="gint64" c:type="gint64"/> </parameter> <parameter name="stop_type" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1951">The type and flags for the new stop position</doc> + line="1964">The type and flags for the new stop position</doc> <type name="SeekType" c:type="GstSeekType"/> </parameter> <parameter name="stop" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1952">The value of the new stop position</doc> + line="1965">The value of the new stop position</doc> <type name="gint64" c:type="gint64"/> </parameter> </parameters> @@ -22063,7 +22089,7 @@ Some elements allow for seeking in the READY state, in this case they will store the seek event and execute it when they are put to PAUSED. If the element supports seek in READY, it will always return %TRUE when it receives the event in the READY state.</doc> - <source-position filename="gst/gstutils.h" line="1029"/> + <source-position filename="gst/gstutils.h" line="1032"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -22105,7 +22131,7 @@ preroll, which will emit %GST_MESSAGE_ASYNC_DONE.</doc> <method name="send_event" c:identifier="gst_element_send_event"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1902">Sends an event to an element. If the element doesn't implement an + line="1915">Sends an event to an element. If the element doesn't implement an event handler, the event will be pushed on a random linked sink pad for downstream events or a random linked source pad for upstream events. @@ -22117,7 +22143,7 @@ MT safe.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1916">%TRUE if the event was handled. Events that trigger a preroll (such + line="1929">%TRUE if the event was handled. Events that trigger a preroll (such as flushing seeks and steps) will emit %GST_MESSAGE_ASYNC_DONE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -22125,13 +22151,13 @@ as flushing seeks and steps) will emit %GST_MESSAGE_ASYNC_DONE.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1904">a #GstElement to send the event to.</doc> + line="1917">a #GstElement to send the event to.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="event" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1905">the #GstEvent to send to the element.</doc> + line="1918">the #GstEvent to send to the element.</doc> <type name="Event" c:type="GstEvent*"/> </parameter> </parameters> @@ -22139,7 +22165,7 @@ as flushing seeks and steps) will emit %GST_MESSAGE_ASYNC_DONE.</doc> <method name="set_base_time" c:identifier="gst_element_set_base_time"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="473">Set the base time of an element. See gst_element_get_base_time(). + line="476">Set the base time of an element. See gst_element_get_base_time(). MT safe.</doc> <source-position filename="gst/gstelement.h" line="852"/> @@ -22150,13 +22176,13 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="475">a #GstElement.</doc> + line="478">a #GstElement.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="time" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="476">the base time to set.</doc> + line="479">the base time to set.</doc> <type name="ClockTime" c:type="GstClockTime"/> </parameter> </parameters> @@ -22164,7 +22190,7 @@ MT safe.</doc> <method name="set_bus" c:identifier="gst_element_set_bus"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3435">Sets the bus of the element. Increases the refcount on the bus. + line="3448">Sets the bus of the element. Increases the refcount on the bus. For internal use only, unless you're testing elements. MT safe.</doc> @@ -22176,7 +22202,7 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3437">a #GstElement to set the bus of.</doc> + line="3450">a #GstElement to set the bus of.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="bus" @@ -22185,7 +22211,7 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3438">the #GstBus to set.</doc> + line="3451">the #GstBus to set.</doc> <type name="Bus" c:type="GstBus*"/> </parameter> </parameters> @@ -22193,14 +22219,14 @@ MT safe.</doc> <method name="set_clock" c:identifier="gst_element_set_clock"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="410">Sets the clock for the element. This function increases the + line="413">Sets the clock for the element. This function increases the refcount on the clock. Any previously set clock on the object is unreffed.</doc> <source-position filename="gst/gstelement.h" line="849"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="419">%TRUE if the element accepted the clock. An element can refuse a + line="422">%TRUE if the element accepted the clock. An element can refuse a clock when it, for example, is not able to slave its internal clock to the @clock or when it requires a specific clock to operate. @@ -22211,7 +22237,7 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="412">a #GstElement to set the clock for.</doc> + line="415">a #GstElement to set the clock for.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="clock" @@ -22220,7 +22246,7 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="413">the #GstClock to set for the element.</doc> + line="416">the #GstClock to set for the element.</doc> <type name="Clock" c:type="GstClock*"/> </parameter> </parameters> @@ -22228,7 +22254,7 @@ MT safe.</doc> <method name="set_context" c:identifier="gst_element_set_context"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3520">Sets the context of the element. Increases the refcount of the context. + line="3533">Sets the context of the element. Increases the refcount of the context. MT safe.</doc> <source-position filename="gst/gstelement.h" line="880"/> @@ -22239,13 +22265,13 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3522">a #GstElement to set the context of.</doc> + line="3535">a #GstElement to set the context of.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="context" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3523">the #GstContext to set.</doc> + line="3536">the #GstContext to set.</doc> <type name="Context" c:type="GstContext*"/> </parameter> </parameters> @@ -22254,7 +22280,7 @@ MT safe.</doc> c:identifier="gst_element_set_locked_state"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2317">Locks the state of an element, so state changes of the parent don't affect + line="2330">Locks the state of an element, so state changes of the parent don't affect this element anymore. Note that this is racy if the state lock of the parent bin is not taken. @@ -22266,7 +22292,7 @@ MT safe.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2331">%TRUE if the state was changed, %FALSE if bad parameters were given + line="2344">%TRUE if the state was changed, %FALSE if bad parameters were given or the elements state-locking needed no change.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -22274,13 +22300,13 @@ or the elements state-locking needed no change.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2319">a #GstElement</doc> + line="2332">a #GstElement</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="locked_state" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2320">%TRUE to lock the element's state</doc> + line="2333">%TRUE to lock the element's state</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -22288,7 +22314,7 @@ or the elements state-locking needed no change.</doc> <method name="set_start_time" c:identifier="gst_element_set_start_time"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="526">Set the start time of an element. The start time of the element is the + line="529">Set the start time of an element. The start time of the element is the running time of the element when it last went to the PAUSED state. In READY or after a flushing seek, it is set to 0. @@ -22308,13 +22334,13 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="528">a #GstElement.</doc> + line="531">a #GstElement.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="time" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="529">the base time to set.</doc> + line="532">the base time to set.</doc> <type name="ClockTime" c:type="GstClockTime"/> </parameter> </parameters> @@ -22322,7 +22348,7 @@ MT safe.</doc> <method name="set_state" c:identifier="gst_element_set_state"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2854">Sets the state of the element. This function will try to set the + line="2867">Sets the state of the element. This function will try to set the requested state by going through all the intermediary states and calling the class's state change function for each. @@ -22339,7 +22365,7 @@ State changes to %GST_STATE_READY or %GST_STATE_NULL never return <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2873">Result of the state change using #GstStateChangeReturn. + line="2886">Result of the state change using #GstStateChangeReturn. MT safe.</doc> <type name="StateChangeReturn" c:type="GstStateChangeReturn"/> @@ -22348,13 +22374,13 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2856">a #GstElement to change state of.</doc> + line="2869">a #GstElement to change state of.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> <parameter name="state" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2857">the element's new #GstState.</doc> + line="2870">the element's new #GstState.</doc> <type name="State" c:type="GstState"/> </parameter> </parameters> @@ -22363,13 +22389,13 @@ MT safe.</doc> c:identifier="gst_element_sync_state_with_parent"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2371">Tries to change the state of the element to the same as its parent. + line="2384">Tries to change the state of the element to the same as its parent. If this function returns %FALSE, the state of element is undefined.</doc> <source-position filename="gst/gstelement.h" line="1001"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2378">%TRUE, if the element's state could be synced to the parent's state. + line="2391">%TRUE, if the element's state could be synced to the parent's state. MT safe.</doc> <type name="gboolean" c:type="gboolean"/> @@ -22378,7 +22404,7 @@ MT safe.</doc> <instance-parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2373">a #GstElement.</doc> + line="2386">a #GstElement.</doc> <type name="Element" c:type="GstElement*"/> </instance-parameter> </parameters> @@ -22391,7 +22417,7 @@ of the sink element to which they are linked. If the link has been made using gst_element_link(), it could have created an requestpad, which has to be released using gst_element_release_request_pad().</doc> - <source-position filename="gst/gstutils.h" line="1009"/> + <source-position filename="gst/gstutils.h" line="1012"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -22416,7 +22442,7 @@ requestpad, which has to be released using gst_element_release_request_pad().</d <doc xml:space="preserve" filename="gst/gstutils.c" line="2355">Unlinks a series of elements. Uses gst_element_unlink().</doc> - <source-position filename="gst/gstutils.h" line="1012"/> + <source-position filename="gst/gstutils.h" line="1015"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -22447,7 +22473,7 @@ requestpad, which has to be released using gst_element_release_request_pad().</d line="2298">Unlinks the two named pads of the source and destination elements. This is a convenience function for gst_pad_unlink().</doc> - <source-position filename="gst/gstutils.h" line="1022"/> + <source-position filename="gst/gstutils.h" line="1025"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -22624,7 +22650,7 @@ state will yield the running_time against the clock.</doc> <glib:signal name="no-more-pads" when="last"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="247">This signals that the element will not generate more dynamic pads. + line="252">This signals that the element will not generate more dynamic pads. Note that this signal will usually be emitted from the context of the streaming thread.</doc> <return-value transfer-ownership="none"> @@ -22634,7 +22660,7 @@ the streaming thread.</doc> <glib:signal name="pad-added" when="last"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="221">a new #GstPad has been added to the element. Note that this signal will + line="226">a new #GstPad has been added to the element. Note that this signal will usually be emitted from the context of the streaming thread. Also keep in mind that if you add new elements to the pipeline in the signal handler you will need to set them to the desired target state with @@ -22646,7 +22672,7 @@ gst_element_set_state() or gst_element_sync_state_with_parent().</doc> <parameter name="new_pad" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="224">the pad that has been added</doc> + line="229">the pad that has been added</doc> <type name="Pad"/> </parameter> </parameters> @@ -22654,7 +22680,7 @@ gst_element_set_state() or gst_element_sync_state_with_parent().</doc> <glib:signal name="pad-removed" when="last"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="236">a #GstPad has been removed from the element</doc> + line="241">a #GstPad has been removed from the element</doc> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -22662,7 +22688,7 @@ gst_element_set_state() or gst_element_sync_state_with_parent().</doc> <parameter name="old_pad" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="239">the pad that has been removed</doc> + line="244">the pad that has been removed</doc> <type name="Pad"/> </parameter> </parameters> @@ -22783,7 +22809,7 @@ functionality.</doc> <parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="930">a #GstElement</doc> + line="943">a #GstElement</doc> <type name="Element" c:type="GstElement*"/> </parameter> </parameters> @@ -22795,7 +22821,7 @@ functionality.</doc> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1234">requested #GstPad if found, + line="1247">requested #GstPad if found, otherwise %NULL. Release after usage.</doc> <type name="Pad" c:type="GstPad*"/> </return-value> @@ -22803,13 +22829,13 @@ functionality.</doc> <parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1221">a #GstElement to find a request pad of.</doc> + line="1234">a #GstElement to find a request pad of.</doc> <type name="Element" c:type="GstElement*"/> </parameter> <parameter name="templ" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1222">a #GstPadTemplate of which we want a pad of.</doc> + line="1235">a #GstPadTemplate of which we want a pad of.</doc> <type name="PadTemplate" c:type="GstPadTemplate*"/> </parameter> <parameter name="name" @@ -22818,7 +22844,7 @@ functionality.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1223">the name of the request #GstPad + line="1236">the name of the request #GstPad to retrieve. Can be %NULL.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> @@ -22828,7 +22854,7 @@ to retrieve. Can be %NULL.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1225">the caps of the pad we want to + line="1238">the caps of the pad we want to request. Can be %NULL.</doc> <type name="Caps" c:type="const GstCaps*"/> </parameter> @@ -22857,7 +22883,7 @@ request. Can be %NULL.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2571">%GST_STATE_CHANGE_SUCCESS if the element has no more pending state + line="2584">%GST_STATE_CHANGE_SUCCESS if the element has no more pending state and the last state change succeeded, %GST_STATE_CHANGE_ASYNC if the element is still performing a state change or %GST_STATE_CHANGE_FAILURE if the last state change failed. @@ -22869,7 +22895,7 @@ MT safe.</doc> <parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2542">a #GstElement to get the state of.</doc> + line="2555">a #GstElement to get the state of.</doc> <type name="Element" c:type="GstElement*"/> </parameter> <parameter name="state" @@ -22880,7 +22906,7 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2543">a pointer to #GstState to hold the state. + line="2556">a pointer to #GstState to hold the state. Can be %NULL.</doc> <type name="State" c:type="GstState*"/> </parameter> @@ -22892,14 +22918,14 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2545">a pointer to #GstState to hold the pending + line="2558">a pointer to #GstState to hold the pending state. Can be %NULL.</doc> <type name="State" c:type="GstState*"/> </parameter> <parameter name="timeout" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2547">a #GstClockTime to specify the timeout for an async + line="2560">a #GstClockTime to specify the timeout for an async state change or %GST_CLOCK_TIME_NONE for infinite timeout.</doc> <type name="ClockTime" c:type="GstClockTime"/> </parameter> @@ -22912,7 +22938,7 @@ MT safe.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2873">Result of the state change using #GstStateChangeReturn. + line="2886">Result of the state change using #GstStateChangeReturn. MT safe.</doc> <type name="StateChangeReturn" c:type="GstStateChangeReturn"/> @@ -22921,13 +22947,13 @@ MT safe.</doc> <parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2856">a #GstElement to change state of.</doc> + line="2869">a #GstElement to change state of.</doc> <type name="Element" c:type="GstElement*"/> </parameter> <parameter name="state" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2857">the element's new #GstState.</doc> + line="2870">the element's new #GstState.</doc> <type name="State" c:type="GstState"/> </parameter> </parameters> @@ -22939,20 +22965,20 @@ MT safe.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3019">the #GstStateChangeReturn of the state transition.</doc> + line="3032">the #GstStateChangeReturn of the state transition.</doc> <type name="StateChangeReturn" c:type="GstStateChangeReturn"/> </return-value> <parameters> <parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3011">a #GstElement</doc> + line="3024">a #GstElement</doc> <type name="Element" c:type="GstElement*"/> </parameter> <parameter name="transition" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3012">the requested transition</doc> + line="3025">the requested transition</doc> <type name="StateChange" c:type="GstStateChange"/> </parameter> </parameters> @@ -22990,7 +23016,7 @@ MT safe.</doc> <parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3437">a #GstElement to set the bus of.</doc> + line="3450">a #GstElement to set the bus of.</doc> <type name="Element" c:type="GstElement*"/> </parameter> <parameter name="bus" @@ -22999,7 +23025,7 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3438">the #GstBus to set.</doc> + line="3451">the #GstBus to set.</doc> <type name="Bus" c:type="GstBus*"/> </parameter> </parameters> @@ -23011,7 +23037,7 @@ MT safe.</doc> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="376">the GstClock provided by the + line="379">the GstClock provided by the element or %NULL if no clock could be provided. Unref after usage. MT safe.</doc> @@ -23021,7 +23047,7 @@ MT safe.</doc> <parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="370">a #GstElement to query</doc> + line="373">a #GstElement to query</doc> <type name="Element" c:type="GstElement*"/> </parameter> </parameters> @@ -23033,7 +23059,7 @@ MT safe.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="419">%TRUE if the element accepted the clock. An element can refuse a + line="422">%TRUE if the element accepted the clock. An element can refuse a clock when it, for example, is not able to slave its internal clock to the @clock or when it requires a specific clock to operate. @@ -23044,7 +23070,7 @@ MT safe.</doc> <parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="412">a #GstElement to set the clock for.</doc> + line="415">a #GstElement to set the clock for.</doc> <type name="Element" c:type="GstElement*"/> </parameter> <parameter name="clock" @@ -23053,7 +23079,7 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="413">the #GstClock to set for the element.</doc> + line="416">the #GstClock to set for the element.</doc> <type name="Clock" c:type="GstClock*"/> </parameter> </parameters> @@ -23065,7 +23091,7 @@ MT safe.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1916">%TRUE if the event was handled. Events that trigger a preroll (such + line="1929">%TRUE if the event was handled. Events that trigger a preroll (such as flushing seeks and steps) will emit %GST_MESSAGE_ASYNC_DONE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -23073,13 +23099,13 @@ as flushing seeks and steps) will emit %GST_MESSAGE_ASYNC_DONE.</doc> <parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1904">a #GstElement to send the event to.</doc> + line="1917">a #GstElement to send the event to.</doc> <type name="Element" c:type="GstElement*"/> </parameter> <parameter name="event" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1905">the #GstEvent to send to the element.</doc> + line="1918">the #GstEvent to send to the element.</doc> <type name="Event" c:type="GstEvent*"/> </parameter> </parameters> @@ -23091,7 +23117,7 @@ as flushing seeks and steps) will emit %GST_MESSAGE_ASYNC_DONE.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2021">%TRUE if the query could be performed. + line="2034">%TRUE if the query could be performed. MT safe.</doc> <type name="gboolean" c:type="gboolean"/> @@ -23100,13 +23126,13 @@ MT safe.</doc> <parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2010">a #GstElement to perform the query on.</doc> + line="2023">a #GstElement to perform the query on.</doc> <type name="Element" c:type="GstElement*"/> </parameter> <parameter name="query" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2011">the #GstQuery.</doc> + line="2024">the #GstQuery.</doc> <type name="Query" c:type="GstQuery*"/> </parameter> </parameters> @@ -23118,7 +23144,7 @@ MT safe.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2092">%TRUE if the message was successfully posted. The function returns + line="2105">%TRUE if the message was successfully posted. The function returns %FALSE if the element did not have a bus. MT safe.</doc> @@ -23128,13 +23154,13 @@ MT safe.</doc> <parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2085">a #GstElement posting the message</doc> + line="2098">a #GstElement posting the message</doc> <type name="Element" c:type="GstElement*"/> </parameter> <parameter name="message" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="2086">a #GstMessage to post</doc> + line="2099">a #GstMessage to post</doc> <type name="Message" c:type="GstMessage*"/> </parameter> </parameters> @@ -23150,13 +23176,13 @@ MT safe.</doc> <parameter name="element" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3522">a #GstElement to set the context of.</doc> + line="3535">a #GstElement to set the context of.</doc> <type name="Element" c:type="GstElement*"/> </parameter> <parameter name="context" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3523">the #GstContext to set.</doc> + line="3536">the #GstContext to set.</doc> <type name="Context" c:type="GstContext*"/> </parameter> </parameters> @@ -23171,7 +23197,7 @@ MT safe.</doc> c:identifier="gst_element_class_add_metadata"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1528">Set @key with @value as metadata in @klass.</doc> + line="1541">Set @key with @value as metadata in @klass.</doc> <source-position filename="gst/gstelement.h" line="780"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> @@ -23180,19 +23206,19 @@ MT safe.</doc> <instance-parameter name="klass" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1530">class to set metadata for</doc> + line="1543">class to set metadata for</doc> <type name="ElementClass" c:type="GstElementClass*"/> </instance-parameter> <parameter name="key" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1531">the key to set</doc> + line="1544">the key to set</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1532">the value to set</doc> + line="1545">the value to set</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -23201,7 +23227,7 @@ MT safe.</doc> c:identifier="gst_element_class_add_pad_template"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1442">Adds a padtemplate to an element class. This is mainly used in the _class_init + line="1455">Adds a padtemplate to an element class. This is mainly used in the _class_init functions of classes. If a pad template with the same name as an already existing one is added the old one is replaced by the new one. @@ -23215,13 +23241,13 @@ reference will be removed (see gst_object_ref_sink())</doc> <instance-parameter name="klass" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1444">the #GstElementClass to add the pad template to.</doc> + line="1457">the #GstElementClass to add the pad template to.</doc> <type name="ElementClass" c:type="GstElementClass*"/> </instance-parameter> <parameter name="templ" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1445">a #GstPadTemplate to add to the element class.</doc> + line="1458">a #GstPadTemplate to add to the element class.</doc> <type name="PadTemplate" c:type="GstPadTemplate*"/> </parameter> </parameters> @@ -23230,7 +23256,7 @@ reference will be removed (see gst_object_ref_sink())</doc> c:identifier="gst_element_class_add_static_metadata"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1548">Set @key with @value as metadata in @klass. + line="1561">Set @key with @value as metadata in @klass. Same as gst_element_class_add_metadata(), but @value must be a static string or an inlined string, as it will not be copied. (GStreamer plugins will @@ -23244,19 +23270,19 @@ dynamically loaded plugins.)</doc> <instance-parameter name="klass" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1550">class to set metadata for</doc> + line="1563">class to set metadata for</doc> <type name="ElementClass" c:type="GstElementClass*"/> </instance-parameter> <parameter name="key" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1551">the key to set</doc> + line="1564">the key to set</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1552">the value to set</doc> + line="1565">the value to set</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -23266,7 +23292,7 @@ dynamically loaded plugins.)</doc> version="1.8"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1486">Adds a pad template to an element class based on the static pad template + line="1499">Adds a pad template to an element class based on the static pad template @templ. This is mainly used in the _class_init functions of element implementations. If a pad template with the same name already exists, the old one is replaced by the new one.</doc> @@ -23278,13 +23304,13 @@ the old one is replaced by the new one.</doc> <instance-parameter name="klass" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1488">the #GstElementClass to add the pad template to.</doc> + line="1501">the #GstElementClass to add the pad template to.</doc> <type name="ElementClass" c:type="GstElementClass*"/> </instance-parameter> <parameter name="static_templ" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1489">#GstStaticPadTemplate to add as pad template to the element class.</doc> + line="1502">#GstStaticPadTemplate to add as pad template to the element class.</doc> <type name="StaticPadTemplate" c:type="GstStaticPadTemplate*"/> </parameter> </parameters> @@ -23294,7 +23320,7 @@ the old one is replaced by the new one.</doc> version="1.14"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1506">Adds a pad template to an element class based on the static pad template + line="1519">Adds a pad template to an element class based on the static pad template @templ. This is mainly used in the _class_init functions of element implementations. If a pad template with the same name already exists, the old one is replaced by the new one.</doc> @@ -23306,19 +23332,19 @@ the old one is replaced by the new one.</doc> <instance-parameter name="klass" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1508">the #GstElementClass to add the pad template to.</doc> + line="1521">the #GstElementClass to add the pad template to.</doc> <type name="ElementClass" c:type="GstElementClass*"/> </instance-parameter> <parameter name="static_templ" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1509">#GstStaticPadTemplate to add as pad template to the element class.</doc> + line="1522">#GstStaticPadTemplate to add as pad template to the element class.</doc> <type name="StaticPadTemplate" c:type="GstStaticPadTemplate*"/> </parameter> <parameter name="pad_type" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1510">The #GType of the pad to create</doc> + line="1523">The #GType of the pad to create</doc> <type name="GType" c:type="GType"/> </parameter> </parameters> @@ -23327,25 +23353,25 @@ the old one is replaced by the new one.</doc> c:identifier="gst_element_class_get_metadata"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1660">Get metadata with @key in @klass.</doc> + line="1673">Get metadata with @key in @klass.</doc> <source-position filename="gst/gstelement.h" line="786"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1667">the metadata for @key.</doc> + line="1680">the metadata for @key.</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> <instance-parameter name="klass" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1662">class to get metadata for</doc> + line="1675">class to get metadata for</doc> <type name="ElementClass" c:type="GstElementClass*"/> </instance-parameter> <parameter name="key" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1663">the key to get</doc> + line="1676">the key to get</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -23354,7 +23380,7 @@ the old one is replaced by the new one.</doc> c:identifier="gst_element_class_get_pad_template"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1740">Retrieves a padtemplate from @element_class with the given name. + line="1753">Retrieves a padtemplate from @element_class with the given name. > If you use this function in the #GInstanceInitFunc of an object class > that has subclasses, make sure to pass the g_class parameter of the > #GInstanceInitFunc here.</doc> @@ -23362,7 +23388,7 @@ the old one is replaced by the new one.</doc> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1750">the #GstPadTemplate with the + line="1763">the #GstPadTemplate with the given name, or %NULL if none was found. No unreferencing is necessary.</doc> <type name="PadTemplate" c:type="GstPadTemplate*"/> @@ -23371,13 +23397,13 @@ the old one is replaced by the new one.</doc> <instance-parameter name="element_class" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1742">a #GstElementClass to get the pad template of.</doc> + line="1755">a #GstElementClass to get the pad template of.</doc> <type name="ElementClass" c:type="GstElementClass*"/> </instance-parameter> <parameter name="name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1743">the name of the #GstPadTemplate to get.</doc> + line="1756">the name of the #GstPadTemplate to get.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -23386,7 +23412,7 @@ the old one is replaced by the new one.</doc> c:identifier="gst_element_class_get_pad_template_list"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1698">Retrieves a list of the pad templates associated with @element_class. The + line="1711">Retrieves a list of the pad templates associated with @element_class. The list must not be modified by the calling code. > If you use this function in the #GInstanceInitFunc of an object class > that has subclasses, make sure to pass the g_class parameter of the @@ -23395,7 +23421,7 @@ list must not be modified by the calling code. <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1708">the #GList of + line="1721">the #GList of pad templates.</doc> <type name="GLib.List" c:type="GList*"> <type name="PadTemplate"/> @@ -23405,7 +23431,7 @@ list must not be modified by the calling code. <instance-parameter name="element_class" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1700">a #GstElementClass to get pad templates of.</doc> + line="1713">a #GstElementClass to get pad templates of.</doc> <type name="ElementClass" c:type="GstElementClass*"/> </instance-parameter> </parameters> @@ -23414,7 +23440,7 @@ list must not be modified by the calling code. c:identifier="gst_element_class_set_metadata"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1576">Sets the detailed information for a #GstElementClass. + line="1589">Sets the detailed information for a #GstElementClass. > This function is for use in _class_init functions only.</doc> <source-position filename="gst/gstelement.h" line="768"/> <return-value transfer-ownership="none"> @@ -23424,19 +23450,19 @@ list must not be modified by the calling code. <instance-parameter name="klass" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1578">class to set metadata for</doc> + line="1591">class to set metadata for</doc> <type name="ElementClass" c:type="GstElementClass*"/> </instance-parameter> <parameter name="longname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1579">The long English name of the element. E.g. "File Sink"</doc> + line="1592">The long English name of the element. E.g. "File Sink"</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="classification" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1580">String describing the type of element, as an unordered list + line="1593">String describing the type of element, as an unordered list separated with slashes ('/'). See draft-klass.txt of the design docs for more details and common types. E.g: "Sink/File"</doc> <type name="utf8" c:type="const gchar*"/> @@ -23444,14 +23470,14 @@ for more details and common types. E.g: "Sink/File"</doc> <parameter name="description" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1583">Sentence describing the purpose of the element. + line="1596">Sentence describing the purpose of the element. E.g: "Write stream to a file"</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="author" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1585">Name and contact details of the author(s). Use \n to separate + line="1598">Name and contact details of the author(s). Use \n to separate multiple author metadata. E.g: "Joe Bloggs &lt;joe.blogs at foo.com&gt;"</doc> <type name="utf8" c:type="const gchar*"/> </parameter> @@ -23461,7 +23487,7 @@ multiple author metadata. E.g: "Joe Bloggs &lt;joe.blogs at foo.com&gt;" c:identifier="gst_element_class_set_static_metadata"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1609">Sets the detailed information for a #GstElementClass. + line="1622">Sets the detailed information for a #GstElementClass. > This function is for use in _class_init functions only. @@ -23477,19 +23503,19 @@ loaded, so this function can be used even from dynamically loaded plugins.)</doc <instance-parameter name="klass" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1611">class to set metadata for</doc> + line="1624">class to set metadata for</doc> <type name="ElementClass" c:type="GstElementClass*"/> </instance-parameter> <parameter name="longname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1612">The long English name of the element. E.g. "File Sink"</doc> + line="1625">The long English name of the element. E.g. "File Sink"</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="classification" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1613">String describing the type of element, as an unordered list + line="1626">String describing the type of element, as an unordered list separated with slashes ('/'). See draft-klass.txt of the design docs for more details and common types. E.g: "Sink/File"</doc> <type name="utf8" c:type="const gchar*"/> @@ -23497,14 +23523,14 @@ for more details and common types. E.g: "Sink/File"</doc> <parameter name="description" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1616">Sentence describing the purpose of the element. + line="1629">Sentence describing the purpose of the element. E.g: "Write stream to a file"</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="author" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="1618">Name and contact details of the author(s). Use \n to separate + line="1631">Name and contact details of the author(s). Use \n to separate multiple author metadata. E.g: "Joe Bloggs &lt;joe.blogs at foo.com&gt;"</doc> <type name="utf8" c:type="const gchar*"/> </parameter> @@ -23572,7 +23598,7 @@ element factory; caller is responsible for unreffing.</doc> c:identifier="gst_element_factory_list_filter"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="825">Filter out all the elementfactories in @list that can handle @caps in + line="827">Filter out all the elementfactories in @list that can handle @caps in the given direction. If @subsetonly is %TRUE, then only the elements whose pads templates @@ -23582,7 +23608,7 @@ whose pad templates caps can intersect with @caps will be returned.</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="840">a #GList of + line="842">a #GList of #GstElementFactory elements that match the given requisites. Use #gst_plugin_feature_list_free after usage.</doc> <type name="GLib.List" c:type="GList*"> @@ -23593,7 +23619,7 @@ whose pad templates caps can intersect with @caps will be returned.</doc> <parameter name="list" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="827">a #GList of + line="829">a #GList of #GstElementFactory to filter</doc> <type name="GLib.List" c:type="GList*"> <type name="ElementFactory"/> @@ -23602,19 +23628,19 @@ whose pad templates caps can intersect with @caps will be returned.</doc> <parameter name="caps" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="829">a #GstCaps</doc> + line="831">a #GstCaps</doc> <type name="Caps" c:type="const GstCaps*"/> </parameter> <parameter name="direction" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="830">a #GstPadDirection to filter on</doc> + line="832">a #GstPadDirection to filter on</doc> <type name="PadDirection" c:type="GstPadDirection"/> </parameter> <parameter name="subsetonly" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="831">whether to filter on caps subsets or not.</doc> + line="833">whether to filter on caps subsets or not.</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -23623,14 +23649,14 @@ whose pad templates caps can intersect with @caps will be returned.</doc> c:identifier="gst_element_factory_list_get_elements"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="791">Get a list of factories that match the given @type. Only elements + line="793">Get a list of factories that match the given @type. Only elements with a rank greater or equal to @minrank will be returned. The list of factories is returned by decreasing rank.</doc> <source-position filename="gst/gstelementfactory.h" line="236"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="800">a #GList of + line="802">a #GList of #GstElementFactory elements. Use gst_plugin_feature_list_free() after usage.</doc> <type name="GLib.List" c:type="GList*"> @@ -23641,14 +23667,14 @@ The list of factories is returned by decreasing rank.</doc> <parameter name="type" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="793">a #GstElementFactoryListType</doc> + line="795">a #GstElementFactoryListType</doc> <type name="ElementFactoryListType" c:type="GstElementFactoryListType"/> </parameter> <parameter name="minrank" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="794">Minimum rank</doc> + line="796">Minimum rank</doc> <type name="Rank" c:type="GstRank"/> </parameter> </parameters> @@ -23656,7 +23682,7 @@ The list of factories is returned by decreasing rank.</doc> <function name="make" c:identifier="gst_element_factory_make"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="423">Create a new element of the type defined by the given element factory. + line="425">Create a new element of the type defined by the given element factory. If name is %NULL, then the element will receive a guaranteed unique name, consisting of the element factory name and a number. If name is given, it will be given the name supplied.</doc> @@ -23664,7 +23690,7 @@ If name is given, it will be given the name supplied.</doc> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="434">new #GstElement or %NULL + line="436">new #GstElement or %NULL if unable to create element</doc> <type name="Element" c:type="GstElement*"/> </return-value> @@ -23672,7 +23698,7 @@ if unable to create element</doc> <parameter name="factoryname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="425">a named factory to instantiate</doc> + line="427">a named factory to instantiate</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="name" @@ -23681,7 +23707,7 @@ if unable to create element</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="426">name of new element, or %NULL to automatically create + line="428">name of new element, or %NULL to automatically create a unique name</doc> <type name="utf8" c:type="const gchar*"/> </parameter> @@ -23692,7 +23718,7 @@ if unable to create element</doc> <doc xml:space="preserve" filename="gst/gstutils.c" line="1430">Checks if the factory can sink all possible capabilities.</doc> - <source-position filename="gst/gstutils.h" line="1037"/> + <source-position filename="gst/gstutils.h" line="1040"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -23719,7 +23745,7 @@ if unable to create element</doc> <doc xml:space="preserve" filename="gst/gstutils.c" line="1464">Checks if the factory can sink any possible capability.</doc> - <source-position filename="gst/gstutils.h" line="1043"/> + <source-position filename="gst/gstutils.h" line="1046"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -23746,7 +23772,7 @@ if unable to create element</doc> <doc xml:space="preserve" filename="gst/gstutils.c" line="1447">Checks if the factory can src all possible capabilities.</doc> - <source-position filename="gst/gstutils.h" line="1040"/> + <source-position filename="gst/gstutils.h" line="1043"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -23773,7 +23799,7 @@ if unable to create element</doc> <doc xml:space="preserve" filename="gst/gstutils.c" line="1481">Checks if the factory can src any possible capability.</doc> - <source-position filename="gst/gstutils.h" line="1046"/> + <source-position filename="gst/gstutils.h" line="1049"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -23798,14 +23824,14 @@ if unable to create element</doc> <method name="create" c:identifier="gst_element_factory_create"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="326">Create a new element of the type defined by the given elementfactory. + line="328">Create a new element of the type defined by the given elementfactory. It will be given the name supplied, since all elements require a name as their first argument.</doc> <source-position filename="gst/gstelementfactory.h" line="84"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="336">new #GstElement or %NULL + line="338">new #GstElement or %NULL if the element couldn't be created</doc> <type name="Element" c:type="GstElement*"/> </return-value> @@ -23813,7 +23839,7 @@ their first argument.</doc> <instance-parameter name="factory" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="328">factory to instantiate</doc> + line="330">factory to instantiate</doc> <type name="ElementFactory" c:type="GstElementFactory*"/> </instance-parameter> <parameter name="name" @@ -23822,7 +23848,7 @@ their first argument.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="329">name of new element, or %NULL to automatically create + line="331">name of new element, or %NULL to automatically create a unique name</doc> <type name="utf8" c:type="const gchar*"/> </parameter> @@ -23832,14 +23858,14 @@ their first argument.</doc> c:identifier="gst_element_factory_get_element_type"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="488">Get the #GType for elements managed by this factory. The type can + line="490">Get the #GType for elements managed by this factory. The type can only be retrieved if the element factory is loaded, which can be assured with gst_plugin_feature_load().</doc> <source-position filename="gst/gstelementfactory.h" line="60"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="496">the #GType for elements managed by this factory or 0 if + line="498">the #GType for elements managed by this factory or 0 if the factory is not loaded.</doc> <type name="GType" c:type="GType"/> </return-value> @@ -23847,7 +23873,7 @@ the factory is not loaded.</doc> <instance-parameter name="factory" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="490">factory to get managed #GType from</doc> + line="492">factory to get managed #GType from</doc> <type name="ElementFactory" c:type="GstElementFactory*"/> </instance-parameter> </parameters> @@ -23856,12 +23882,12 @@ the factory is not loaded.</doc> c:identifier="gst_element_factory_get_metadata"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="507">Get the metadata on @factory with @key.</doc> + line="509">Get the metadata on @factory with @key.</doc> <source-position filename="gst/gstelementfactory.h" line="63"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="514">the metadata with @key on @factory or %NULL + line="516">the metadata with @key on @factory or %NULL when there was no metadata with the given @key.</doc> <type name="utf8" c:type="const gchar*"/> </return-value> @@ -23869,13 +23895,13 @@ when there was no metadata with the given @key.</doc> <instance-parameter name="factory" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="509">a #GstElementFactory</doc> + line="511">a #GstElementFactory</doc> <type name="ElementFactory" c:type="GstElementFactory*"/> </instance-parameter> <parameter name="key" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="510">a key</doc> + line="512">a key</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -23884,12 +23910,12 @@ when there was no metadata with the given @key.</doc> c:identifier="gst_element_factory_get_metadata_keys"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="526">Get the available keys for the metadata on @factory.</doc> + line="528">Get the available keys for the metadata on @factory.</doc> <source-position filename="gst/gstelementfactory.h" line="66"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="532"> + line="534"> a %NULL-terminated array of key strings, or %NULL when there is no metadata. Free with g_strfreev() when no longer needed.</doc> <array c:type="gchar**"> @@ -23900,7 +23926,7 @@ metadata. Free with g_strfreev() when no longer needed.</doc> <instance-parameter name="factory" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="528">a #GstElementFactory</doc> + line="530">a #GstElementFactory</doc> <type name="ElementFactory" c:type="GstElementFactory*"/> </instance-parameter> </parameters> @@ -23909,19 +23935,19 @@ metadata. Free with g_strfreev() when no longer needed.</doc> c:identifier="gst_element_factory_get_num_pad_templates"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="561">Gets the number of pad_templates in this factory.</doc> + line="563">Gets the number of pad_templates in this factory.</doc> <source-position filename="gst/gstelementfactory.h" line="69"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="567">the number of pad_templates</doc> + line="569">the number of pad_templates</doc> <type name="guint" c:type="guint"/> </return-value> <parameters> <instance-parameter name="factory" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="563">a #GstElementFactory</doc> + line="565">a #GstElementFactory</doc> <type name="ElementFactory" c:type="GstElementFactory*"/> </instance-parameter> </parameters> @@ -23930,12 +23956,12 @@ metadata. Free with g_strfreev() when no longer needed.</doc> c:identifier="gst_element_factory_get_static_pad_templates"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="598">Gets the #GList of #GstStaticPadTemplate for this factory.</doc> + line="600">Gets the #GList of #GstStaticPadTemplate for this factory.</doc> <source-position filename="gst/gstelementfactory.h" line="72"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="604">the + line="606">the static pad templates</doc> <type name="GLib.List" c:type="const GList*"> <type name="StaticPadTemplate"/> @@ -23945,7 +23971,7 @@ metadata. Free with g_strfreev() when no longer needed.</doc> <instance-parameter name="factory" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="600">a #GstElementFactory</doc> + line="602">a #GstElementFactory</doc> <type name="ElementFactory" c:type="GstElementFactory*"/> </instance-parameter> </parameters> @@ -23954,7 +23980,7 @@ metadata. Free with g_strfreev() when no longer needed.</doc> c:identifier="gst_element_factory_get_uri_protocols"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="631">Gets a %NULL-terminated array of protocols this element supports or %NULL if + line="633">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 array, as it is still owned by the element factory. Use g_strdupv() to make a copy of the protocol string array if you need to.</doc> @@ -23962,7 +23988,7 @@ make a copy of the protocol string array if you need to.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="640">the supported protocols + line="642">the supported protocols or %NULL</doc> <array c:type="const gchar* const*"> <type name="utf8"/> @@ -23972,7 +23998,7 @@ make a copy of the protocol string array if you need to.</doc> <instance-parameter name="factory" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="633">a #GstElementFactory</doc> + line="635">a #GstElementFactory</doc> <type name="ElementFactory" c:type="GstElementFactory*"/> </instance-parameter> </parameters> @@ -23981,19 +24007,19 @@ make a copy of the protocol string array if you need to.</doc> c:identifier="gst_element_factory_get_uri_type"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="615">Gets the type of URIs the element supports or #GST_URI_UNKNOWN if none.</doc> + line="617">Gets the type of URIs the element supports or #GST_URI_UNKNOWN if none.</doc> <source-position filename="gst/gstelementfactory.h" line="75"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="621">type of URIs this element supports</doc> + line="623">type of URIs this element supports</doc> <type name="URIType" c:type="GstURIType"/> </return-value> <parameters> <instance-parameter name="factory" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="617">a #GstElementFactory</doc> + line="619">a #GstElementFactory</doc> <type name="ElementFactory" c:type="GstElementFactory*"/> </instance-parameter> </parameters> @@ -24002,25 +24028,25 @@ make a copy of the protocol string array if you need to.</doc> c:identifier="gst_element_factory_has_interface"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="651">Check if @factory implements the interface with name @interfacename.</doc> + line="653">Check if @factory implements the interface with name @interfacename.</doc> <source-position filename="gst/gstelementfactory.h" line="81"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="658">%TRUE when @factory implement the interface.</doc> + line="660">%TRUE when @factory implement the interface.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="factory" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="653">a #GstElementFactory</doc> + line="655">a #GstElementFactory</doc> <type name="ElementFactory" c:type="GstElementFactory*"/> </instance-parameter> <parameter name="interfacename" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="654">an interface name</doc> + line="656">an interface name</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -24029,25 +24055,25 @@ make a copy of the protocol string array if you need to.</doc> c:identifier="gst_element_factory_list_is_type"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="685">Check if @factory is of the given types.</doc> + line="687">Check if @factory is of the given types.</doc> <source-position filename="gst/gstelementfactory.h" line="232"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="692">%TRUE if @factory is of @type.</doc> + line="694">%TRUE if @factory is of @type.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="factory" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="687">a #GstElementFactory</doc> + line="689">a #GstElementFactory</doc> <type name="ElementFactory" c:type="GstElementFactory*"/> </instance-parameter> <parameter name="type" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelementfactory.c" - line="688">a #GstElementFactoryListType</doc> + line="690">a #GstElementFactoryListType</doc> <type name="ElementFactoryListType" c:type="GstElementFactoryListType"/> </parameter> @@ -27156,7 +27182,7 @@ mask indicating which of the bits in the field are explicitly set.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="8097">Create a new sub-class of #GST_TYPE_FLAG_SET + line="8007">Create a new sub-class of #GST_TYPE_FLAG_SET which will pretty-print the human-readable flags when serializing, for easier debugging.</doc> <source-position filename="gst/gstvalue.h" line="784"/> @@ -27167,7 +27193,7 @@ when serializing, for easier debugging.</doc> <parameter name="flags_type" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="8099">a #GType of a #G_TYPE_FLAGS type.</doc> + line="8009">a #GType of a #G_TYPE_FLAGS type.</doc> <type name="GType" c:type="GType"/> </parameter> </parameters> @@ -27255,8 +27281,8 @@ element scope.</doc> <doc xml:space="preserve" filename="gst/gstpad.h" line="139">Some (fatal) error occurred. Element generating - this error should post an error message with more - details.</doc> + this error should post an error message using + GST_ELEMENT_ERROR() with more details.</doc> </member> <member name="not_supported" value="-6" @@ -27600,7 +27626,7 @@ Note that GhostPads add overhead to the data processing of a pipeline.</doc> <constructor name="new" c:identifier="gst_ghost_pad_new"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="680">Create a new ghostpad with @target as the target. The direction will be taken + line="653">Create a new ghostpad with @target as the target. The direction will be taken from the target pad. @target must be unlinked. Will ref the target.</doc> @@ -27608,7 +27634,7 @@ Will ref the target.</doc> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="690">a new #GstPad, or %NULL in + line="663">a new #GstPad, or %NULL in case of an error.</doc> <type name="Pad" c:type="GstPad*"/> </return-value> @@ -27619,13 +27645,13 @@ case of an error.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="682">the name of the new pad, or %NULL to assign a default name</doc> + line="655">the name of the new pad, or %NULL to assign a default name</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="target" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="683">the pad to ghost.</doc> + line="656">the pad to ghost.</doc> <type name="Pad" c:type="GstPad*"/> </parameter> </parameters> @@ -27634,7 +27660,7 @@ case of an error.</doc> c:identifier="gst_ghost_pad_new_from_template"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="720">Create a new ghostpad with @target as the target. The direction will be taken + line="693">Create a new ghostpad with @target as the target. The direction will be taken from the target pad. The template used on the ghostpad will be @template. Will ref the target.</doc> @@ -27642,7 +27668,7 @@ Will ref the target.</doc> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="731">a new #GstPad, or %NULL in + line="704">a new #GstPad, or %NULL in case of an error.</doc> <type name="Pad" c:type="GstPad*"/> </return-value> @@ -27653,19 +27679,19 @@ case of an error.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="722">the name of the new pad, or %NULL to assign a default name.</doc> + line="695">the name of the new pad, or %NULL to assign a default name.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="target" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="723">the pad to ghost.</doc> + line="696">the pad to ghost.</doc> <type name="Pad" c:type="GstPad*"/> </parameter> <parameter name="templ" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="724">the #GstPadTemplate to use on the ghostpad.</doc> + line="697">the #GstPadTemplate to use on the ghostpad.</doc> <type name="PadTemplate" c:type="GstPadTemplate*"/> </parameter> </parameters> @@ -27674,7 +27700,7 @@ case of an error.</doc> c:identifier="gst_ghost_pad_new_no_target"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="652">Create a new ghostpad without a target with the given direction. + line="625">Create a new ghostpad without a target with the given direction. A target can be set on the ghostpad later with the gst_ghost_pad_set_target() function. @@ -27683,7 +27709,7 @@ The created ghostpad will not have a padtemplate.</doc> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="663">a new #GstPad, or %NULL in + line="636">a new #GstPad, or %NULL in case of an error.</doc> <type name="Pad" c:type="GstPad*"/> </return-value> @@ -27694,13 +27720,13 @@ case of an error.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="654">the name of the new pad, or %NULL to assign a default name.</doc> + line="627">the name of the new pad, or %NULL to assign a default name.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="dir" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="655">the direction of the ghostpad</doc> + line="628">the direction of the ghostpad</doc> <type name="PadDirection" c:type="GstPadDirection"/> </parameter> </parameters> @@ -27709,13 +27735,13 @@ case of an error.</doc> c:identifier="gst_ghost_pad_new_no_target_from_template"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="766">Create a new ghostpad based on @templ, without setting a target. The + line="739">Create a new ghostpad based on @templ, without setting a target. The direction will be taken from the @templ.</doc> <source-position filename="gst/gstghostpad.h" line="127"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="774">a new #GstPad, or %NULL in + line="747">a new #GstPad, or %NULL in case of an error.</doc> <type name="Pad" c:type="GstPad*"/> </return-value> @@ -27726,13 +27752,13 @@ case of an error.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="768">the name of the new pad, or %NULL to assign a default name</doc> + line="741">the name of the new pad, or %NULL to assign a default name</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="templ" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="769">the #GstPadTemplate to create the ghostpad from.</doc> + line="742">the #GstPadTemplate to create the ghostpad from.</doc> <type name="PadTemplate" c:type="GstPadTemplate*"/> </parameter> </parameters> @@ -27741,19 +27767,19 @@ case of an error.</doc> c:identifier="gst_ghost_pad_activate_mode_default"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="422">Invoke the default activate mode function of a ghost pad.</doc> + line="413">Invoke the default activate mode function of a ghost pad.</doc> <source-position filename="gst/gstghostpad.h" line="139"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="431">%TRUE if the operation was successful.</doc> + line="422">%TRUE if the operation was successful.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <parameter name="pad" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="424">the #GstPad to activate or deactivate.</doc> + line="415">the #GstPad to activate or deactivate.</doc> <type name="Pad" c:type="GstPad*"/> </parameter> <parameter name="parent" @@ -27762,19 +27788,19 @@ case of an error.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="425">the parent of @pad or %NULL</doc> + line="416">the parent of @pad or %NULL</doc> <type name="Object" c:type="GstObject*"/> </parameter> <parameter name="mode" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="426">the requested activation mode</doc> + line="417">the requested activation mode</doc> <type name="PadMode" c:type="GstPadMode"/> </parameter> <parameter name="active" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="427">whether the pad should be active or not.</doc> + line="418">whether the pad should be active or not.</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -27783,20 +27809,20 @@ case of an error.</doc> c:identifier="gst_ghost_pad_internal_activate_mode_default"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="331">Invoke the default activate mode function of a proxy pad that is + line="322">Invoke the default activate mode function of a proxy pad that is owned by a ghost pad.</doc> <source-position filename="gst/gstghostpad.h" line="142"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="341">%TRUE if the operation was successful.</doc> + line="332">%TRUE if the operation was successful.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <parameter name="pad" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="333">the #GstPad to activate or deactivate.</doc> + line="324">the #GstPad to activate or deactivate.</doc> <type name="Pad" c:type="GstPad*"/> </parameter> <parameter name="parent" @@ -27805,44 +27831,48 @@ owned by a ghost pad.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="334">the parent of @pad or %NULL</doc> + line="325">the parent of @pad or %NULL</doc> <type name="Object" c:type="GstObject*"/> </parameter> <parameter name="mode" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="335">the requested activation mode</doc> + line="326">the requested activation mode</doc> <type name="PadMode" c:type="GstPadMode"/> </parameter> <parameter name="active" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="336">whether the pad should be active or not.</doc> + line="327">whether the pad should be active or not.</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> </function> - <method name="construct" c:identifier="gst_ghost_pad_construct"> + <method name="construct" + c:identifier="gst_ghost_pad_construct" + deprecated="1"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="519">Finish initialization of a newly allocated ghost pad. + line="577">Finish initialization of a newly allocated ghost pad. This function is most useful in language bindings and when subclassing #GstGhostPad; plugin and application developers normally will not call this function. Call this function directly after a call to g_object_new (GST_TYPE_GHOST_PAD, "direction", @dir, ..., NULL).</doc> + <doc-deprecated xml:space="preserve">This function is deprecated since 1.18 and does nothing +anymore.</doc-deprecated> <source-position filename="gst/gstghostpad.h" line="136"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="530">%TRUE if the construction succeeds, %FALSE otherwise.</doc> + line="591">%TRUE if the construction succeeds, %FALSE otherwise.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="gpad" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="521">the newly allocated ghost pad</doc> + line="579">the newly allocated ghost pad</doc> <type name="GhostPad" c:type="GstGhostPad*"/> </instance-parameter> </parameters> @@ -27850,12 +27880,12 @@ function. Call this function directly after a call to g_object_new <method name="get_target" c:identifier="gst_ghost_pad_get_target"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="791">Get the target pad of @gpad. Unref target pad after usage.</doc> + line="764">Get the target pad of @gpad. Unref target pad after usage.</doc> <source-position filename="gst/gstghostpad.h" line="130"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="797">the target #GstPad, can be + line="770">the target #GstPad, can be %NULL if the ghostpad has no target set. Unref target pad after usage.</doc> <type name="Pad" c:type="GstPad*"/> @@ -27864,7 +27894,7 @@ usage.</doc> <instance-parameter name="gpad" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="793">the #GstGhostPad</doc> + line="766">the #GstGhostPad</doc> <type name="GhostPad" c:type="GstGhostPad*"/> </instance-parameter> </parameters> @@ -27872,14 +27902,14 @@ usage.</doc> <method name="set_target" c:identifier="gst_ghost_pad_set_target"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="815">Set the new target of the ghostpad @gpad. Any existing target + line="788">Set the new target of the ghostpad @gpad. Any existing target is unlinked and links to the new target are established. if @newtarget is %NULL the target will be cleared.</doc> <source-position filename="gst/gstghostpad.h" line="133"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="824">%TRUE if the new target could be set. This function + line="797">%TRUE if the new target could be set. This function can return %FALSE when the internal pads could not be linked.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -27887,7 +27917,7 @@ is unlinked and links to the new target are established. if @newtarget is <instance-parameter name="gpad" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="817">the #GstGhostPad</doc> + line="790">the #GstGhostPad</doc> <type name="GhostPad" c:type="GstGhostPad*"/> </instance-parameter> <parameter name="newtarget" @@ -27896,7 +27926,7 @@ is unlinked and links to the new target are established. if @newtarget is allow-none="1"> <doc xml:space="preserve" filename="gst/gstghostpad.c" - line="818">the new pad target</doc> + line="791">the new pad target</doc> <type name="Pad" c:type="GstPad*"/> </parameter> </parameters> @@ -28175,7 +28205,7 @@ is unlinked and links to the new target are established. if @newtarget is <function-macro name="IS_DYNAMIC_TYPE_FACTORY" c:identifier="GST_IS_DYNAMIC_TYPE_FACTORY" introspectable="0"> - <source-position filename="gst/gstdynamictypefactory.h" line="44"/> + <source-position filename="gst/gstdynamictypefactory.h" line="46"/> <parameters> <parameter name="obj"> </parameter> @@ -28184,7 +28214,7 @@ is unlinked and links to the new target are established. if @newtarget is <function-macro name="IS_DYNAMIC_TYPE_FACTORY_CLASS" c:identifier="GST_IS_DYNAMIC_TYPE_FACTORY_CLASS" introspectable="0"> - <source-position filename="gst/gstdynamictypefactory.h" line="45"/> + <source-position filename="gst/gstdynamictypefactory.h" line="47"/> <parameters> <parameter name="klass"> </parameter> @@ -28328,7 +28358,7 @@ is unlinked and links to the new target are established. if @newtarget is <function-macro name="IS_PARAM_SPEC_ARRAY_LIST" c:identifier="GST_IS_PARAM_SPEC_ARRAY_LIST" introspectable="0"> - <source-position filename="gst/gstparamspecs.h" line="115"/> + <source-position filename="gst/gstparamspecs.h" line="117"/> <parameters> <parameter name="pspec"> </parameter> @@ -28625,7 +28655,7 @@ is unlinked and links to the new target are established. if @newtarget is <function-macro name="IS_TRACER_RECORD" c:identifier="GST_IS_TRACER_RECORD" introspectable="0"> - <source-position filename="gst/gsttracerrecord.h" line="40"/> + <source-position filename="gst/gsttracerrecord.h" line="42"/> <parameters> <parameter name="obj"> </parameter> @@ -28634,7 +28664,7 @@ is unlinked and links to the new target are established. if @newtarget is <function-macro name="IS_TRACER_RECORD_CLASS" c:identifier="GST_IS_TRACER_RECORD_CLASS" introspectable="0"> - <source-position filename="gst/gsttracerrecord.h" line="41"/> + <source-position filename="gst/gsttracerrecord.h" line="43"/> <parameters> <parameter name="klass"> </parameter> @@ -29804,10 +29834,10 @@ deciding where to go while developing code.</doc> <callback name="LogFunction" c:type="GstLogFunction"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="307">Function prototype for a logging function that can be registered with + line="333">Function prototype for a logging function that can be registered with gst_debug_add_log_function(). Use G_GNUC_NO_INSTRUMENT on that function.</doc> - <source-position filename="gst/gstinfo.h" line="322"/> + <source-position filename="gst/gstinfo.h" line="348"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -29815,43 +29845,43 @@ Use G_GNUC_NO_INSTRUMENT on that function.</doc> <parameter name="category" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="309">a #GstDebugCategory</doc> + line="335">a #GstDebugCategory</doc> <type name="DebugCategory" c:type="GstDebugCategory*"/> </parameter> <parameter name="level" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="310">a #GstDebugLevel</doc> + line="336">a #GstDebugLevel</doc> <type name="DebugLevel" c:type="GstDebugLevel"/> </parameter> <parameter name="file" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="311">file name</doc> + line="337">file name</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="function" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="312">function name</doc> + line="338">function name</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="line" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="313">line number</doc> + line="339">line number</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="object" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="314">a #GObject</doc> + line="340">a #GObject</doc> <type name="GObject.Object" c:type="GObject*"/> </parameter> <parameter name="message" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="315">the message</doc> + line="341">the message</doc> <type name="DebugMessage" c:type="GstDebugMessage*"/> </parameter> <parameter name="user_data" @@ -29861,7 +29891,7 @@ Use G_GNUC_NO_INSTRUMENT on that function.</doc> closure="7"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="316">user data for the log function</doc> + line="342">user data for the log function</doc> <type name="gpointer" c:type="gpointer"/> </parameter> </parameters> @@ -29913,26 +29943,26 @@ guint32 fourcc = GST_MAKE_FOURCC ('M', 'J', 'P', 'G'); introspectable="0"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="1042">Output a hexdump of @data. + line="1065">Output a hexdump of @data. There is no need to finish the end of the message string with a newline character, a newline character will be added automatically.</doc> - <source-position filename="gst/gstinfo.h" line="711"/> + <source-position filename="gst/gstinfo.h" line="734"/> <parameters> <parameter name="msg"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="1044">message string to log with the data</doc> + line="1067">message string to log with the data</doc> </parameter> <parameter name="data"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="1045">pointer to the data to output</doc> + line="1068">pointer to the data to output</doc> </parameter> <parameter name="length"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="1046">length of the data to output</doc> + line="1069">length of the data to output</doc> </parameter> </parameters> </function-macro> @@ -29941,31 +29971,31 @@ character, a newline character will be added automatically.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="965">Output a logging message belonging to the given object in the default category. + line="988">Output a logging message belonging to the given object in the default category. There is no need to finish the end of the message string with a newline character, a newline character will be added automatically.</doc> - <source-position filename="gst/gstinfo.h" line="709"/> + <source-position filename="gst/gstinfo.h" line="732"/> <parameters> <parameter name="obj"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="967">the #GObject the message belongs to</doc> + line="990">the #GObject the message belongs to</doc> </parameter> <parameter name="msg"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="968">message string to log with the data</doc> + line="991">message string to log with the data</doc> </parameter> <parameter name="data"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="969">pointer to the data to output</doc> + line="992">pointer to the data to output</doc> </parameter> <parameter name="length"> <doc xml:space="preserve" filename="gst/gstinfo.h" - line="970">length of the data to output</doc> + line="993">length of the data to output</doc> </parameter> </parameters> </function-macro> @@ -36061,13 +36091,13 @@ buffers.</doc> version="1.16"> <doc xml:space="preserve" filename="gst/gstmeta.c" - line="253">Meta sequence number compare function. Can be used as #GCompareFunc + line="254">Meta sequence number compare function. Can be used as #GCompareFunc or a #GCompareDataFunc.</doc> <source-position filename="gst/gstmeta.h" line="229"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstmeta.c" - line="261">a negative number if @meta1 comes before @meta2, 0 if both metas + line="262">a negative number if @meta1 comes before @meta2, 0 if both metas have an equal sequence number, or a positive integer if @meta1 comes after @meta2.</doc> <type name="gint" c:type="gint"/> @@ -36076,13 +36106,13 @@ or a #GCompareDataFunc.</doc> <instance-parameter name="meta1" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstmeta.c" - line="255">a #GstMeta</doc> + line="256">a #GstMeta</doc> <type name="Meta" c:type="const GstMeta*"/> </instance-parameter> <parameter name="meta2" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstmeta.c" - line="256">a #GstMeta</doc> + line="257">a #GstMeta</doc> <type name="Meta" c:type="const GstMeta*"/> </parameter> </parameters> @@ -36092,7 +36122,7 @@ or a #GCompareDataFunc.</doc> version="1.16"> <doc xml:space="preserve" filename="gst/gstmeta.c" - line="231">Gets seqnum for this meta.</doc> + line="232">Gets seqnum for this meta.</doc> <source-position filename="gst/gstmeta.h" line="226"/> <return-value transfer-ownership="none"> <type name="guint64" c:type="guint64"/> @@ -36101,7 +36131,7 @@ or a #GCompareDataFunc.</doc> <instance-parameter name="meta" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstmeta.c" - line="233">a #GstMeta</doc> + line="234">a #GstMeta</doc> <type name="Meta" c:type="const GstMeta*"/> </instance-parameter> </parameters> @@ -36187,13 +36217,13 @@ or a #GCompareDataFunc.</doc> <function name="get_info" c:identifier="gst_meta_get_info"> <doc xml:space="preserve" filename="gst/gstmeta.c" - line="207">Lookup a previously registered meta info structure by its implementation name + line="208">Lookup a previously registered meta info structure by its implementation name @impl.</doc> <source-position filename="gst/gstmeta.h" line="220"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gstmeta.c" - line="214">a #GstMetaInfo with @impl, or + line="215">a #GstMetaInfo with @impl, or %NULL when no such metainfo exists.</doc> <type name="MetaInfo" c:type="const GstMetaInfo*"/> </return-value> @@ -36201,7 +36231,7 @@ or a #GCompareDataFunc.</doc> <parameter name="impl" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstmeta.c" - line="209">the name</doc> + line="210">the name</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -37774,7 +37804,7 @@ Either @newobj and the value pointed to by @oldobj may be %NULL.</doc> c:identifier="gst_object_add_control_binding"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1240">Attach the #GstControlBinding to the object. If there already was a + line="1239">Attach the #GstControlBinding to the object. If there already was a #GstControlBinding for this property it will be replaced. The object's reference count will be incremented, and any floating @@ -37783,7 +37813,7 @@ reference will be removed (see gst_object_ref_sink())</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1251">%FALSE if the given @binding has not been setup for this object or + line="1250">%FALSE if the given @binding has not been setup for this object or has been setup for a non suitable property, %TRUE otherwise.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -37791,13 +37821,13 @@ has been setup for a non suitable property, %TRUE otherwise.</doc> <instance-parameter name="object" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1242">the controller object</doc> + line="1241">the controller object</doc> <type name="Object" c:type="GstObject*"/> </instance-parameter> <parameter name="binding" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1243">the #GstControlBinding that should be used</doc> + line="1242">the #GstControlBinding that should be used</doc> <type name="ControlBinding" c:type="GstControlBinding*"/> </parameter> </parameters> @@ -37809,7 +37839,7 @@ has been setup for a non suitable property, %TRUE otherwise.</doc> and the optional debug string.. The default handler will simply print the error string using g_print.</doc> - <source-position filename="gst/gstutils.h" line="974"/> + <source-position filename="gst/gstutils.h" line="977"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -37841,13 +37871,13 @@ The default handler will simply print the error string using g_print.</doc> c:identifier="gst_object_get_control_binding"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1277">Gets the corresponding #GstControlBinding for the property. This should be + line="1276">Gets the corresponding #GstControlBinding for the property. This should be unreferenced again after use.</doc> <source-position filename="gst/gstobject.h" line="305"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1285">the #GstControlBinding for + line="1284">the #GstControlBinding for @property_name or %NULL if the property is not controlled.</doc> <type name="ControlBinding" c:type="GstControlBinding*"/> </return-value> @@ -37855,13 +37885,13 @@ unreferenced again after use.</doc> <instance-parameter name="object" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1279">the object</doc> + line="1278">the object</doc> <type name="Object" c:type="GstObject*"/> </instance-parameter> <parameter name="property_name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1280">name of the property</doc> + line="1279">name of the property</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -37870,7 +37900,7 @@ unreferenced again after use.</doc> c:identifier="gst_object_get_control_rate"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1456">Obtain the control-rate for this @object. Audio processing #GstElement + line="1455">Obtain the control-rate for this @object. Audio processing #GstElement objects will use this rate to sub-divide their processing loop and call gst_object_sync_values() in between. The length of the processing segment should be up to @control-rate nanoseconds. @@ -37884,14 +37914,14 @@ The control-rate is not expected to change if the element is in <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1471">the control rate in nanoseconds</doc> + line="1470">the control rate in nanoseconds</doc> <type name="ClockTime" c:type="GstClockTime"/> </return-value> <parameters> <instance-parameter name="object" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1458">the object that has controlled properties</doc> + line="1457">the object that has controlled properties</doc> <type name="Object" c:type="GstObject*"/> </instance-parameter> </parameters> @@ -37900,7 +37930,7 @@ The control-rate is not expected to change if the element is in c:identifier="gst_object_get_g_value_array"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1414">Gets a number of #GValues for the given controlled property starting at the + line="1413">Gets a number of #GValues for the given controlled property starting at the requested time. The array @values need to hold enough space for @n_values of #GValue. @@ -37910,44 +37940,44 @@ curve or apply a control curve sample by sample.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1430">%TRUE if the given array could be filled, %FALSE otherwise</doc> + line="1429">%TRUE if the given array could be filled, %FALSE otherwise</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="object" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1416">the object that has controlled properties</doc> + line="1415">the object that has controlled properties</doc> <type name="Object" c:type="GstObject*"/> </instance-parameter> <parameter name="property_name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1417">the name of the property to get</doc> + line="1416">the name of the property to get</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="timestamp" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1418">the time that should be processed</doc> + line="1417">the time that should be processed</doc> <type name="ClockTime" c:type="GstClockTime"/> </parameter> <parameter name="interval" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1419">the time spacing between subsequent values</doc> + line="1418">the time spacing between subsequent values</doc> <type name="ClockTime" c:type="GstClockTime"/> </parameter> <parameter name="n_values" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1420">the number of values</doc> + line="1419">the number of values</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="values" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1421">array to put control-values in</doc> + line="1420">array to put control-values in</doc> <array length="3" zero-terminated="0" c:type="GValue*"> <type name="GObject.Value" c:type="GValue"/> </array> @@ -38036,12 +38066,12 @@ MT safe. Grabs and releases the #GstObject's LOCK for all objects <method name="get_value" c:identifier="gst_object_get_value"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1338">Gets the value for the given controlled property at the requested time.</doc> + line="1337">Gets the value for the given controlled property at the requested time.</doc> <source-position filename="gst/gstobject.h" line="311"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1346">the GValue of the property at the given time, + line="1345">the GValue of the property at the given time, or %NULL if the property isn't controlled.</doc> <type name="GObject.Value" c:type="GValue*"/> </return-value> @@ -38049,19 +38079,19 @@ or %NULL if the property isn't controlled.</doc> <instance-parameter name="object" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1340">the object that has controlled properties</doc> + line="1339">the object that has controlled properties</doc> <type name="Object" c:type="GstObject*"/> </instance-parameter> <parameter name="property_name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1341">the name of the property to get</doc> + line="1340">the name of the property to get</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="timestamp" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1342">the time the control-change should be read from</doc> + line="1341">the time the control-change should be read from</doc> <type name="ClockTime" c:type="GstClockTime"/> </parameter> </parameters> @@ -38071,7 +38101,7 @@ or %NULL if the property isn't controlled.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1369">Gets a number of values for the given controlled property starting at the + line="1368">Gets a number of values for the given controlled property starting at the requested time. The array @values need to hold enough space for @n_values of the same type as the objects property's type. @@ -38085,38 +38115,38 @@ better suites for bindings.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1389">%TRUE if the given array could be filled, %FALSE otherwise</doc> + line="1388">%TRUE if the given array could be filled, %FALSE otherwise</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="object" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1371">the object that has controlled properties</doc> + line="1370">the object that has controlled properties</doc> <type name="Object" c:type="GstObject*"/> </instance-parameter> <parameter name="property_name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1372">the name of the property to get</doc> + line="1371">the name of the property to get</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="timestamp" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1373">the time that should be processed</doc> + line="1372">the time that should be processed</doc> <type name="ClockTime" c:type="GstClockTime"/> </parameter> <parameter name="interval" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1374">the time spacing between subsequent values</doc> + line="1373">the time spacing between subsequent values</doc> <type name="ClockTime" c:type="GstClockTime"/> </parameter> <parameter name="n_values" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1375">the number of values</doc> + line="1374">the number of values</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="values" @@ -38125,7 +38155,7 @@ better suites for bindings.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1376">array to put control-values in</doc> + line="1375">array to put control-values in</doc> <type name="gpointer" c:type="gpointer"/> </parameter> </parameters> @@ -38134,19 +38164,19 @@ better suites for bindings.</doc> c:identifier="gst_object_has_active_control_bindings"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1164">Check if the @object has active controlled properties.</doc> + line="1163">Check if the @object has active controlled properties.</doc> <source-position filename="gst/gstobject.h" line="290"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1170">%TRUE if the object has active controlled properties</doc> + line="1169">%TRUE if the object has active controlled properties</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="object" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1166">the object that has controlled properties</doc> + line="1165">the object that has controlled properties</doc> <type name="Object" c:type="GstObject*"/> </instance-parameter> </parameters> @@ -38274,26 +38304,26 @@ constructs like : c:identifier="gst_object_remove_control_binding"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1305">Removes the corresponding #GstControlBinding. If it was the + line="1304">Removes the corresponding #GstControlBinding. If it was the last ref of the binding, it will be disposed.</doc> <source-position filename="gst/gstobject.h" line="308"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1313">%TRUE if the binding could be removed.</doc> + line="1312">%TRUE if the binding could be removed.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="object" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1307">the object</doc> + line="1306">the object</doc> <type name="Object" c:type="GstObject*"/> </instance-parameter> <parameter name="binding" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1308">the binding</doc> + line="1307">the binding</doc> <type name="ControlBinding" c:type="GstControlBinding*"/> </parameter> </parameters> @@ -38302,7 +38332,7 @@ last ref of the binding, it will be disposed.</doc> c:identifier="gst_object_set_control_binding_disabled"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1212">This function is used to disable the control bindings on a property for + line="1211">This function is used to disable the control bindings on a property for some time, i.e. gst_object_sync_values() will do nothing for the property.</doc> <source-position filename="gst/gstobject.h" line="296"/> @@ -38313,19 +38343,19 @@ property.</doc> <instance-parameter name="object" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1214">the object that has controlled properties</doc> + line="1213">the object that has controlled properties</doc> <type name="Object" c:type="GstObject*"/> </instance-parameter> <parameter name="property_name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1215">property to disable</doc> + line="1214">property to disable</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="disabled" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1216">boolean that specifies whether to disable the controller + line="1215">boolean that specifies whether to disable the controller or not.</doc> <type name="gboolean" c:type="gboolean"/> </parameter> @@ -38335,7 +38365,7 @@ or not.</doc> c:identifier="gst_object_set_control_bindings_disabled"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1188">This function is used to disable all controlled properties of the @object for + line="1187">This function is used to disable all controlled properties of the @object for some time, i.e. gst_object_sync_values() will do nothing.</doc> <source-position filename="gst/gstobject.h" line="293"/> <return-value transfer-ownership="none"> @@ -38345,13 +38375,13 @@ some time, i.e. gst_object_sync_values() will do nothing.</doc> <instance-parameter name="object" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1190">the object that has controlled properties</doc> + line="1189">the object that has controlled properties</doc> <type name="Object" c:type="GstObject*"/> </instance-parameter> <parameter name="disabled" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1191">boolean that specifies whether to disable the controller + line="1190">boolean that specifies whether to disable the controller or not.</doc> <type name="gboolean" c:type="gboolean"/> </parameter> @@ -38361,7 +38391,7 @@ or not.</doc> c:identifier="gst_object_set_control_rate"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1481">Change the control-rate for this @object. Audio processing #GstElement + line="1480">Change the control-rate for this @object. Audio processing #GstElement objects will use this rate to sub-divide their processing loop and call gst_object_sync_values() in between. The length of the processing segment should be up to @control-rate nanoseconds. @@ -38376,13 +38406,13 @@ The control-rate should not change if the element is in %GST_STATE_PAUSED or <instance-parameter name="object" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1483">the object that has controlled properties</doc> + line="1482">the object that has controlled properties</doc> <type name="Object" c:type="GstObject*"/> </instance-parameter> <parameter name="control_rate" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstobject.c" - line="1484">the new control-rate in nanoseconds.</doc> + line="1483">the new control-rate in nanoseconds.</doc> <type name="ClockTime" c:type="GstClockTime"/> </parameter> </parameters> @@ -39924,7 +39954,7 @@ they can be changed when the element is in the READY or lower state.</doc> <function-macro name="PARAM_SPEC_ARRAY_LIST" c:identifier="GST_PARAM_SPEC_ARRAY_LIST" introspectable="0"> - <source-position filename="gst/gstparamspecs.h" line="116"/> + <source-position filename="gst/gstparamspecs.h" line="118"/> <parameters> <parameter name="pspec"> </parameter> @@ -40741,7 +40771,7 @@ stream-id manually instead. Since stream IDs are sorted alphabetically, any numbers in the stream ID should be printed with a fixed number of characters, preceded by 0's, such as by using the format \%03u instead of \%u.</doc> - <source-position filename="gst/gstutils.h" line="1114"/> + <source-position filename="gst/gstutils.h" line="1117"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -40790,7 +40820,7 @@ doing an URI query on the element and in the worst case just uses a random number. Source elements that don't implement the URI handler interface should ideally generate a unique, deterministic stream-id manually instead.</doc> - <source-position filename="gst/gstutils.h" line="1117"/> + <source-position filename="gst/gstutils.h" line="1120"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -40845,7 +40875,7 @@ doing an URI query on the element and in the worst case just uses a random number. Source elements that don't implement the URI handler interface should ideally generate a unique, deterministic stream-id manually instead.</doc> - <source-position filename="gst/gstutils.h" line="1120"/> + <source-position filename="gst/gstutils.h" line="1123"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -41152,7 +41182,7 @@ Unref after usage.</doc> filename="gst/gstutils.c" line="2631">Gets the parent of @pad, cast to a #GstElement. If a @pad has no parent or its parent is not an element, return %NULL.</doc> - <source-position filename="gst/gstutils.h" line="1066"/> + <source-position filename="gst/gstutils.h" line="1069"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -41334,7 +41364,7 @@ set yet, i.e. the pad has not received a stream-start event yet. This is a convenience wrapper around gst_pad_get_sticky_event() and gst_event_parse_stream().</doc> - <source-position filename="gst/gstutils.h" line="1126"/> + <source-position filename="gst/gstutils.h" line="1129"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -41364,7 +41394,7 @@ gst_event_parse_stream_start(). The returned stream-id string should be treated as an opaque string, its contents should not be interpreted.</doc> - <source-position filename="gst/gstutils.h" line="1123"/> + <source-position filename="gst/gstutils.h" line="1126"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -41663,7 +41693,7 @@ This is a convenience function to save having to create and add intermediate If @src or @sink pads don't have parent elements or do not share a common ancestor, the link will fail.</doc> - <source-position filename="gst/gstutils.h" line="1092"/> + <source-position filename="gst/gstutils.h" line="1095"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -41701,7 +41731,7 @@ ancestor, the link will fail. Calling gst_pad_link_maybe_ghosting_full() with @flags == %GST_PAD_LINK_CHECK_DEFAULT is the recommended way of linking pads with safety checks applied.</doc> - <source-position filename="gst/gstutils.h" line="1095"/> + <source-position filename="gst/gstutils.h" line="1098"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -41828,7 +41858,7 @@ if @pad has no peer.</doc> filename="gst/gstutils.c" line="3198">Check if the peer of @pad accepts @caps. If @pad has no peer, this function returns %TRUE.</doc> - <source-position filename="gst/gstutils.h" line="1111"/> + <source-position filename="gst/gstutils.h" line="1114"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -41861,7 +41891,7 @@ upstream could produce in the order preferred by upstream. When called on sinkpads @filter contains the caps accepted by downstream in the preferred order. @filter might be %NULL but if it is not %NULL the returned caps will be a subset of @filter.</doc> - <source-position filename="gst/gstutils.h" line="1108"/> + <source-position filename="gst/gstutils.h" line="1111"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -41894,7 +41924,7 @@ when @filter is %NULL, ANY caps.</doc> filename="gst/gstutils.c" line="3036">Queries the peer pad of a given sink pad to convert @src_val in @src_format to @dest_format.</doc> - <source-position filename="gst/gstutils.h" line="1105"/> + <source-position filename="gst/gstutils.h" line="1108"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -41943,7 +41973,7 @@ to @dest_format.</doc> <doc xml:space="preserve" filename="gst/gstutils.c" line="2967">Queries the peer pad of a given sink pad for the total stream duration.</doc> - <source-position filename="gst/gstutils.h" line="1102"/> + <source-position filename="gst/gstutils.h" line="1105"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -41983,7 +42013,7 @@ to @dest_format.</doc> <doc xml:space="preserve" filename="gst/gstutils.c" line="2904">Queries the peer of a given sink pad for the stream position.</doc> - <source-position filename="gst/gstutils.h" line="1099"/> + <source-position filename="gst/gstutils.h" line="1102"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -42028,7 +42058,7 @@ returns the intersection of the results. This function is useful as a default accept caps query function for an element that can handle any stream format, but requires caps that are acceptable for all opposite pads.</doc> - <source-position filename="gst/gstutils.h" line="1071"/> + <source-position filename="gst/gstutils.h" line="1074"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -42059,7 +42089,7 @@ the intersection of the results. This function is useful as a default caps query function for an element that can handle any stream format, but requires all its pads to have the same caps. Two such elements are tee and adder.</doc> - <source-position filename="gst/gstutils.h" line="1074"/> + <source-position filename="gst/gstutils.h" line="1077"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -42302,7 +42332,7 @@ Please also note that some queries might need a running pipeline to work.</doc> <doc xml:space="preserve" filename="gst/gstutils.c" line="3167">Check if the given pad accepts the caps.</doc> - <source-position filename="gst/gstutils.h" line="1089"/> + <source-position filename="gst/gstutils.h" line="1092"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -42342,7 +42372,7 @@ if it is not %NULL the returned caps will be a subset of @filter. Note that this function does not return writable #GstCaps, use gst_caps_make_writable() before modifying the caps.</doc> - <source-position filename="gst/gstutils.h" line="1086"/> + <source-position filename="gst/gstutils.h" line="1089"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -42371,7 +42401,7 @@ gst_caps_make_writable() before modifying the caps.</doc> <doc xml:space="preserve" filename="gst/gstutils.c" line="3000">Queries a pad to convert @src_val in @src_format to @dest_format.</doc> - <source-position filename="gst/gstutils.h" line="1083"/> + <source-position filename="gst/gstutils.h" line="1086"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -42457,7 +42487,7 @@ Multi-sinkpad elements should implement custom query handlers.</doc> <doc xml:space="preserve" filename="gst/gstutils.c" line="2936">Queries a pad for the total stream duration.</doc> - <source-position filename="gst/gstutils.h" line="1080"/> + <source-position filename="gst/gstutils.h" line="1083"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -42495,7 +42525,7 @@ Multi-sinkpad elements should implement custom query handlers.</doc> <doc xml:space="preserve" filename="gst/gstutils.c" line="2874">Queries a pad for the stream position.</doc> - <source-position filename="gst/gstutils.h" line="1077"/> + <source-position filename="gst/gstutils.h" line="1080"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -43373,7 +43403,7 @@ or in case the pad is not negotiated, the padtemplate caps. The negotiated caps are the caps of the last CAPS event that passed on the pad. Use this function on a pad that, once it negotiated to a CAPS, cannot be renegotiated to something else.</doc> - <source-position filename="gst/gstutils.h" line="1063"/> + <source-position filename="gst/gstutils.h" line="1066"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -45146,7 +45176,7 @@ and with the given arguments.</doc> <virtual-method name="pad_created" invoker="pad_created"> <doc xml:space="preserve" filename="gst/gstpadtemplate.c" - line="527">Emit the pad-created signal for this template when created by this pad.</doc> + line="529">Emit the pad-created signal for this template when created by this pad.</doc> <source-position filename="gst/gstpadtemplate.h" line="153"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> @@ -45155,13 +45185,13 @@ and with the given arguments.</doc> <instance-parameter name="templ" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstpadtemplate.c" - line="529">a #GstPadTemplate that has been created</doc> + line="531">a #GstPadTemplate that has been created</doc> <type name="PadTemplate" c:type="GstPadTemplate*"/> </instance-parameter> <parameter name="pad" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstpadtemplate.c" - line="530">the #GstPad that created it</doc> + line="532">the #GstPad that created it</doc> <type name="Pad" c:type="GstPad*"/> </parameter> </parameters> @@ -45192,12 +45222,12 @@ Unref after usage.</doc> version="1.18"> <doc xml:space="preserve" filename="gst/gstpadtemplate.c" - line="505">See gst_pad_template_set_documentation_caps().</doc> + line="507">See gst_pad_template_set_documentation_caps().</doc> <source-position filename="gst/gstpadtemplate.h" line="236"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstpadtemplate.c" - line="511">The caps to document. For convenience, this will return + line="513">The caps to document. For convenience, this will return gst_pad_template_get_caps() when no documentation caps were set.</doc> <type name="Caps" c:type="GstCaps*"/> </return-value> @@ -45205,7 +45235,7 @@ Unref after usage.</doc> <instance-parameter name="templ" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstpadtemplate.c" - line="507">the pad template to get documented capabilities on</doc> + line="509">the pad template to get documented capabilities on</doc> <type name="PadTemplate" c:type="GstPadTemplate*"/> </instance-parameter> </parameters> @@ -45213,7 +45243,7 @@ Unref after usage.</doc> <method name="pad_created" c:identifier="gst_pad_template_pad_created"> <doc xml:space="preserve" filename="gst/gstpadtemplate.c" - line="527">Emit the pad-created signal for this template when created by this pad.</doc> + line="529">Emit the pad-created signal for this template when created by this pad.</doc> <source-position filename="gst/gstpadtemplate.h" line="239"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> @@ -45222,13 +45252,13 @@ Unref after usage.</doc> <instance-parameter name="templ" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstpadtemplate.c" - line="529">a #GstPadTemplate that has been created</doc> + line="531">a #GstPadTemplate that has been created</doc> <type name="PadTemplate" c:type="GstPadTemplate*"/> </instance-parameter> <parameter name="pad" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstpadtemplate.c" - line="530">the #GstPad that created it</doc> + line="532">the #GstPad that created it</doc> <type name="Pad" c:type="GstPad*"/> </parameter> </parameters> @@ -45253,7 +45283,7 @@ expose "stable" caps to the reader.</doc> line="485">the pad template to set documented capabilities on</doc> <type name="PadTemplate" c:type="GstPadTemplate*"/> </instance-parameter> - <parameter name="caps" transfer-ownership="none"> + <parameter name="caps" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstpadtemplate.c" line="486">the documented capabilities</doc> @@ -45373,13 +45403,13 @@ expose "stable" caps to the reader.</doc> <parameter name="templ" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstpadtemplate.c" - line="529">a #GstPadTemplate that has been created</doc> + line="531">a #GstPadTemplate that has been created</doc> <type name="PadTemplate" c:type="GstPadTemplate*"/> </parameter> <parameter name="pad" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstpadtemplate.c" - line="530">the #GstPad that created it</doc> + line="532">the #GstPad that created it</doc> <type name="Pad" c:type="GstPad*"/> </parameter> </parameters> @@ -45440,13 +45470,14 @@ pad functions cannot be called from within the callback.</doc> </callback> <class name="ParamArray" c:symbol-prefix="param_spec_array" + version="1.12" parent="GObject.ParamSpec" glib:type-name="GstParamArray" glib:get-type="gst_param_spec_array_get_type" glib:fundamental="1"> <doc xml:space="preserve" filename="gst/gstparamspecs.h" - line="96">A fundamental type that describes a #GParamSpec for arrays of + line="107">A fundamental type that describes a #GParamSpec for arrays of values</doc> </class> <class name="ParamFraction" @@ -45457,73 +45488,73 @@ values</doc> glib:fundamental="1"> <doc xml:space="preserve" filename="gst/gstparamspecs.h" - line="107">A fundamental type that describes a #GParamSpec for fractional + line="96">A fundamental type that describes a #GParamSpec for fractional properties</doc> </class> <record name="ParamSpecArray" c:type="GstParamSpecArray"> <doc xml:space="preserve" filename="gst/gstparamspecs.h" - line="154">A GParamSpec derived structure for arrays of values.</doc> - <source-position filename="gst/gstparamspecs.h" line="165"/> + line="156">A GParamSpec derived structure for arrays of values.</doc> + <source-position filename="gst/gstparamspecs.h" line="167"/> <field name="parent_instance" writable="1"> <doc xml:space="preserve" filename="gst/gstparamspecs.h" - line="156">super class</doc> + line="158">super class</doc> <type name="GObject.ParamSpec" c:type="GParamSpec"/> </field> <field name="element_spec" writable="1"> <doc xml:space="preserve" filename="gst/gstparamspecs.h" - line="157">the #GParamSpec of the type of values in the array</doc> + line="159">the #GParamSpec of the type of values in the array</doc> <type name="GObject.ParamSpec" c:type="GParamSpec*"/> </field> </record> <record name="ParamSpecFraction" c:type="GstParamSpecFraction"> <doc xml:space="preserve" filename="gst/gstparamspecs.h" - line="133">A GParamSpec derived structure that contains the meta data for fractional + line="135">A GParamSpec derived structure that contains the meta data for fractional properties.</doc> - <source-position filename="gst/gstparamspecs.h" line="152"/> + <source-position filename="gst/gstparamspecs.h" line="154"/> <field name="parent_instance" writable="1"> <doc xml:space="preserve" filename="gst/gstparamspecs.h" - line="135">super class</doc> + line="137">super class</doc> <type name="GObject.ParamSpec" c:type="GParamSpec"/> </field> <field name="min_num" writable="1"> <doc xml:space="preserve" filename="gst/gstparamspecs.h" - line="136">minimal numerator</doc> + line="138">minimal numerator</doc> <type name="gint" c:type="gint"/> </field> <field name="min_den" writable="1"> <doc xml:space="preserve" filename="gst/gstparamspecs.h" - line="137">minimal denominator</doc> + line="139">minimal denominator</doc> <type name="gint" c:type="gint"/> </field> <field name="max_num" writable="1"> <doc xml:space="preserve" filename="gst/gstparamspecs.h" - line="138">maximal numerator</doc> + line="140">maximal numerator</doc> <type name="gint" c:type="gint"/> </field> <field name="max_den" writable="1"> <doc xml:space="preserve" filename="gst/gstparamspecs.h" - line="139">maximal denominator</doc> + line="141">maximal denominator</doc> <type name="gint" c:type="gint"/> </field> <field name="def_num" writable="1"> <doc xml:space="preserve" filename="gst/gstparamspecs.h" - line="140">default numerator</doc> + line="142">default numerator</doc> <type name="gint" c:type="gint"/> </field> <field name="def_den" writable="1"> <doc xml:space="preserve" filename="gst/gstparamspecs.h" - line="141">default denominator</doc> + line="143">default denominator</doc> <type name="gint" c:type="gint"/> </field> </record> @@ -45556,12 +45587,12 @@ for re-use.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2672">Get the global #GstMetaInfo describing the #GstParentBufferMeta meta.</doc> + line="2675">Get the global #GstMetaInfo describing the #GstParentBufferMeta meta.</doc> <source-position filename="gst/gstbuffer.h" line="739"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2677">The #GstMetaInfo</doc> + line="2680">The #GstMetaInfo</doc> <type name="MetaInfo" c:type="const GstMetaInfo*"/> </return-value> </function> @@ -45591,7 +45622,9 @@ Free-function: gst_parse_context_free</doc> <type name="ParseContext" c:type="GstParseContext*"/> </return-value> </constructor> - <method name="copy" c:identifier="gst_parse_context_copy"> + <method name="copy" + c:identifier="gst_parse_context_copy" + version="1.12.1"> <doc xml:space="preserve" filename="gst/gstparse.c" line="96">Copies the @context.</doc> @@ -45614,7 +45647,7 @@ Free-function: gst_parse_context_free</doc> <method name="free" c:identifier="gst_parse_context_free"> <doc xml:space="preserve" filename="gst/gstparse.c" - line="124">Frees a parse context previously allocated with gst_parse_context_new().</doc> + line="126">Frees a parse context previously allocated with gst_parse_context_new().</doc> <source-position filename="gst/gstparse.h" line="109"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> @@ -45623,7 +45656,7 @@ Free-function: gst_parse_context_free</doc> <instance-parameter name="context" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstparse.c" - line="126">a #GstParseContext</doc> + line="128">a #GstParseContext</doc> <type name="ParseContext" c:type="GstParseContext*"/> </instance-parameter> </parameters> @@ -45632,14 +45665,14 @@ Free-function: gst_parse_context_free</doc> c:identifier="gst_parse_context_get_missing_elements"> <doc xml:space="preserve" filename="gst/gstparse.c" - line="142">Retrieve missing elements from a previous run of gst_parse_launch_full() + line="144">Retrieve missing elements from a previous run of gst_parse_launch_full() or gst_parse_launchv_full(). Will only return results if an error code of %GST_PARSE_ERROR_NO_SUCH_ELEMENT was returned.</doc> <source-position filename="gst/gstparse.h" line="106"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstparse.c" - line="150">a + line="152">a %NULL-terminated array of element factory name strings of missing elements. Free with g_strfreev() when no longer needed.</doc> <array c:type="gchar**"> @@ -45650,7 +45683,7 @@ of %GST_PARSE_ERROR_NO_SUCH_ELEMENT was returned.</doc> <instance-parameter name="context" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstparse.c" - line="144">a #GstParseContext</doc> + line="146">a #GstParseContext</doc> <type name="ParseContext" c:type="GstParseContext*"/> </instance-parameter> </parameters> @@ -47020,7 +47053,7 @@ The cache is flushed every time the registry is rebuilt.</doc> glib:nick="members"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="1173">Ignore enum members when generating + line="1176">Ignore enum members when generating the plugins cache. This is useful if the members of the enum are generated dynamically, in order not to expose incorrect documentation to the end user.</doc> </member> @@ -53273,13 +53306,13 @@ gst_query_type_get_flags() function.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="954">Rounds an integer value down to the next multiple of 128.</doc> - <source-position filename="gst/gstutils.h" line="961"/> + line="957">Rounds an integer value down to the next multiple of 128.</doc> + <source-position filename="gst/gstutils.h" line="964"/> <parameters> <parameter name="num"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="956">integer value to round down</doc> + line="959">integer value to round down</doc> </parameter> </parameters> </function-macro> @@ -53288,13 +53321,13 @@ gst_query_type_get_flags() function.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="933">Rounds an integer value down to the next multiple of 16.</doc> - <source-position filename="gst/gstutils.h" line="939"/> + line="936">Rounds an integer value down to the next multiple of 16.</doc> + <source-position filename="gst/gstutils.h" line="942"/> <parameters> <parameter name="num"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="935">integer value to round down</doc> + line="938">integer value to round down</doc> </parameter> </parameters> </function-macro> @@ -53303,13 +53336,13 @@ gst_query_type_get_flags() function.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="912">Rounds an integer value down to the next multiple of 2.</doc> - <source-position filename="gst/gstutils.h" line="918"/> + line="915">Rounds an integer value down to the next multiple of 2.</doc> + <source-position filename="gst/gstutils.h" line="921"/> <parameters> <parameter name="num"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="914">integer value to round down</doc> + line="917">integer value to round down</doc> </parameter> </parameters> </function-macro> @@ -53318,13 +53351,13 @@ gst_query_type_get_flags() function.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="940">Rounds an integer value down to the next multiple of 32.</doc> - <source-position filename="gst/gstutils.h" line="946"/> + line="943">Rounds an integer value down to the next multiple of 32.</doc> + <source-position filename="gst/gstutils.h" line="949"/> <parameters> <parameter name="num"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="942">integer value to round down</doc> + line="945">integer value to round down</doc> </parameter> </parameters> </function-macro> @@ -53333,13 +53366,13 @@ gst_query_type_get_flags() function.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="919">Rounds an integer value down to the next multiple of 4.</doc> - <source-position filename="gst/gstutils.h" line="925"/> + line="922">Rounds an integer value down to the next multiple of 4.</doc> + <source-position filename="gst/gstutils.h" line="928"/> <parameters> <parameter name="num"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="921">integer value to round down</doc> + line="924">integer value to round down</doc> </parameter> </parameters> </function-macro> @@ -53348,13 +53381,13 @@ gst_query_type_get_flags() function.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="947">Rounds an integer value down to the next multiple of 64.</doc> - <source-position filename="gst/gstutils.h" line="953"/> + line="950">Rounds an integer value down to the next multiple of 64.</doc> + <source-position filename="gst/gstutils.h" line="956"/> <parameters> <parameter name="num"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="949">integer value to round down</doc> + line="952">integer value to round down</doc> </parameter> </parameters> </function-macro> @@ -53363,13 +53396,13 @@ gst_query_type_get_flags() function.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="926">Rounds an integer value down to the next multiple of 8.</doc> - <source-position filename="gst/gstutils.h" line="932"/> + line="929">Rounds an integer value down to the next multiple of 8.</doc> + <source-position filename="gst/gstutils.h" line="935"/> <parameters> <parameter name="num"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="928">integer value to round down</doc> + line="931">integer value to round down</doc> </parameter> </parameters> </function-macro> @@ -53378,19 +53411,19 @@ gst_query_type_get_flags() function.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="962">Rounds an integer value down to the next multiple of @align. @align MUST be a + line="965">Rounds an integer value down to the next multiple of @align. @align MUST be a power of two.</doc> - <source-position filename="gst/gstutils.h" line="970"/> + <source-position filename="gst/gstutils.h" line="973"/> <parameters> <parameter name="num"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="964">integrer value to round down</doc> + line="967">integrer value to round down</doc> </parameter> <parameter name="align"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="965">a power of two to round down to</doc> + line="968">a power of two to round down to</doc> </parameter> </parameters> </function-macro> @@ -53400,13 +53433,13 @@ power of two.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="893">Rounds an integer value up to the next multiple of 128.</doc> - <source-position filename="gst/gstutils.h" line="900"/> + line="896">Rounds an integer value up to the next multiple of 128.</doc> + <source-position filename="gst/gstutils.h" line="903"/> <parameters> <parameter name="num"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="895">integer value to round up</doc> + line="898">integer value to round up</doc> </parameter> </parameters> </function-macro> @@ -53415,13 +53448,13 @@ power of two.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="872">Rounds an integer value up to the next multiple of 16.</doc> - <source-position filename="gst/gstutils.h" line="878"/> + line="875">Rounds an integer value up to the next multiple of 16.</doc> + <source-position filename="gst/gstutils.h" line="881"/> <parameters> <parameter name="num"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="874">integer value to round up</doc> + line="877">integer value to round up</doc> </parameter> </parameters> </function-macro> @@ -53430,13 +53463,13 @@ power of two.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="851">Rounds an integer value up to the next multiple of 2.</doc> - <source-position filename="gst/gstutils.h" line="857"/> + line="854">Rounds an integer value up to the next multiple of 2.</doc> + <source-position filename="gst/gstutils.h" line="860"/> <parameters> <parameter name="num"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="853">integer value to round up</doc> + line="856">integer value to round up</doc> </parameter> </parameters> </function-macro> @@ -53445,13 +53478,13 @@ power of two.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="879">Rounds an integer value up to the next multiple of 32.</doc> - <source-position filename="gst/gstutils.h" line="885"/> + line="882">Rounds an integer value up to the next multiple of 32.</doc> + <source-position filename="gst/gstutils.h" line="888"/> <parameters> <parameter name="num"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="881">integer value to round up</doc> + line="884">integer value to round up</doc> </parameter> </parameters> </function-macro> @@ -53460,13 +53493,13 @@ power of two.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="858">Rounds an integer value up to the next multiple of 4.</doc> - <source-position filename="gst/gstutils.h" line="864"/> + line="861">Rounds an integer value up to the next multiple of 4.</doc> + <source-position filename="gst/gstutils.h" line="867"/> <parameters> <parameter name="num"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="860">integer value to round up</doc> + line="863">integer value to round up</doc> </parameter> </parameters> </function-macro> @@ -53475,13 +53508,13 @@ power of two.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="886">Rounds an integer value up to the next multiple of 64.</doc> - <source-position filename="gst/gstutils.h" line="892"/> + line="889">Rounds an integer value up to the next multiple of 64.</doc> + <source-position filename="gst/gstutils.h" line="895"/> <parameters> <parameter name="num"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="888">integer value to round up</doc> + line="891">integer value to round up</doc> </parameter> </parameters> </function-macro> @@ -53490,13 +53523,13 @@ power of two.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="865">Rounds an integer value up to the next multiple of 8.</doc> - <source-position filename="gst/gstutils.h" line="871"/> + line="868">Rounds an integer value up to the next multiple of 8.</doc> + <source-position filename="gst/gstutils.h" line="874"/> <parameters> <parameter name="num"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="867">integer value to round up</doc> + line="870">integer value to round up</doc> </parameter> </parameters> </function-macro> @@ -53505,19 +53538,19 @@ power of two.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="901">Rounds an integer value up to the next multiple of @align. @align MUST be a + line="904">Rounds an integer value up to the next multiple of @align. @align MUST be a power of two.</doc> - <source-position filename="gst/gstutils.h" line="909"/> + <source-position filename="gst/gstutils.h" line="912"/> <parameters> <parameter name="num"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="903">integrer value to round up</doc> + line="906">integrer value to round up</doc> </parameter> <parameter name="align"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="904">a power of two to round up to</doc> + line="907">a power of two to round up to</doc> </parameter> </parameters> </function-macro> @@ -53612,12 +53645,12 @@ port=123" for timestamps based on a specific NTP server.</doc> version="1.14"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2844">Get the global #GstMetaInfo describing the #GstReferenceTimestampMeta meta.</doc> + line="2847">Get the global #GstMetaInfo describing the #GstReferenceTimestampMeta meta.</doc> <source-position filename="gst/gstbuffer.h" line="784"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2849">The #GstMetaInfo</doc> + line="2852">The #GstMetaInfo</doc> <type name="MetaInfo" c:type="const GstMetaInfo*"/> </return-value> </function> @@ -53694,7 +53727,7 @@ removed at the end of initialization.</doc> c:identifier="gst_registry_fork_is_enabled"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1783">By default GStreamer will perform scanning and rebuilding of the + line="1796">By default GStreamer will perform scanning and rebuilding of the registry file using a helper child process. Applications might want to disable this behaviour with the @@ -53704,7 +53737,7 @@ are scanned (and loaded) into the application process.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1793">%TRUE if GStreamer will use the child helper process when + line="1806">%TRUE if GStreamer will use the child helper process when rebuilding the registry.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -53713,7 +53746,7 @@ rebuilding the registry.</doc> c:identifier="gst_registry_fork_set_enabled"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1802">Applications might want to disable/enable spawning of a child helper process + line="1815">Applications might want to disable/enable spawning of a child helper process when rebuilding the registry. See gst_registry_fork_is_enabled() for more information.</doc> <source-position filename="gst/gst.h" line="131"/> @@ -53724,7 +53757,7 @@ information.</doc> <parameter name="enabled" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1804">whether rebuilding the registry can use a temporary child helper process.</doc> + line="1817">whether rebuilding the registry can use a temporary child helper process.</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -53732,21 +53765,21 @@ information.</doc> <function name="get" c:identifier="gst_registry_get"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="309">Retrieves the singleton plugin registry. The caller does not own a + line="322">Retrieves the singleton plugin registry. The caller does not own a reference on the registry, as it is alive as long as GStreamer is initialized.</doc> <source-position filename="gst/gstregistry.h" line="64"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="316">the #GstRegistry.</doc> + line="329">the #GstRegistry.</doc> <type name="Registry" c:type="GstRegistry*"/> </return-value> </function> <method name="add_feature" c:identifier="gst_registry_add_feature"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="539">Add the feature to the registry. The feature-added signal will be emitted. + line="552">Add the feature to the registry. The feature-added signal will be emitted. @feature's reference count will be incremented, and any floating reference will be removed (see gst_object_ref_sink())</doc> @@ -53754,7 +53787,7 @@ reference will be removed (see gst_object_ref_sink())</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="549">%TRUE on success. + line="562">%TRUE on success. MT safe.</doc> <type name="gboolean" c:type="gboolean"/> @@ -53763,13 +53796,13 @@ MT safe.</doc> <instance-parameter name="registry" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="541">the registry to add the plugin to</doc> + line="554">the registry to add the plugin to</doc> <type name="Registry" c:type="GstRegistry*"/> </instance-parameter> <parameter name="feature" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="542">the feature to add</doc> + line="555">the feature to add</doc> <type name="PluginFeature" c:type="GstPluginFeature*"/> </parameter> </parameters> @@ -53777,7 +53810,7 @@ MT safe.</doc> <method name="add_plugin" c:identifier="gst_registry_add_plugin"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="405">Add the plugin to the registry. The plugin-added signal will be emitted. + line="418">Add the plugin to the registry. The plugin-added signal will be emitted. @plugin's reference count will be incremented, and any floating reference will be removed (see gst_object_ref_sink())</doc> @@ -53785,7 +53818,7 @@ reference will be removed (see gst_object_ref_sink())</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="415">%TRUE on success. + line="428">%TRUE on success. MT safe.</doc> <type name="gboolean" c:type="gboolean"/> @@ -53794,13 +53827,13 @@ MT safe.</doc> <instance-parameter name="registry" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="407">the registry to add the plugin to</doc> + line="420">the registry to add the plugin to</doc> <type name="Registry" c:type="GstRegistry*"/> </instance-parameter> <parameter name="plugin" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="408">the plugin to add</doc> + line="421">the plugin to add</doc> <type name="Plugin" c:type="GstPlugin*"/> </parameter> </parameters> @@ -53809,14 +53842,14 @@ MT safe.</doc> c:identifier="gst_registry_check_feature_version"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1467">Checks whether a plugin feature by the given name exists in + line="1480">Checks whether a plugin feature by the given name exists in @registry and whether its version is at least the version required.</doc> <source-position filename="gst/gstregistry.h" line="121"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1479">%TRUE if the feature could be found and the version is + line="1492">%TRUE if the feature could be found and the version is the same as the required version or newer, and %FALSE otherwise.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -53824,31 +53857,31 @@ the same as the required version or newer, and %FALSE otherwise.</doc> <instance-parameter name="registry" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1469">a #GstRegistry</doc> + line="1482">a #GstRegistry</doc> <type name="Registry" c:type="GstRegistry*"/> </instance-parameter> <parameter name="feature_name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1470">the name of the feature (e.g. "oggdemux")</doc> + line="1483">the name of the feature (e.g. "oggdemux")</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="min_major" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1471">the minimum major version number</doc> + line="1484">the minimum major version number</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="min_minor" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1472">the minimum minor version number</doc> + line="1485">the minimum minor version number</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="min_micro" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1473">the minimum micro version number</doc> + line="1486">the minimum micro version number</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -53856,7 +53889,7 @@ the same as the required version or newer, and %FALSE otherwise.</doc> <method name="feature_filter" c:identifier="gst_registry_feature_filter"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="806">Runs a filter against all features of the plugins in the registry + line="819">Runs a filter against all features of the plugins in the registry and returns a GList with the results. If the first flag is set, only the first match is returned (as a list with a single object).</doc> @@ -53864,7 +53897,7 @@ returned (as a list with a single object).</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="818">a #GList of + line="831">a #GList of #GstPluginFeature. Use gst_plugin_feature_list_free() after usage. MT safe.</doc> @@ -53876,7 +53909,7 @@ MT safe.</doc> <instance-parameter name="registry" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="808">registry to query</doc> + line="821">registry to query</doc> <type name="Registry" c:type="GstRegistry*"/> </instance-parameter> <parameter name="filter" @@ -53885,13 +53918,13 @@ MT safe.</doc> closure="2"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="809">the filter to use</doc> + line="822">the filter to use</doc> <type name="PluginFeatureFilter" c:type="GstPluginFeatureFilter"/> </parameter> <parameter name="first" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="810">only return first match</doc> + line="823">only return first match</doc> <type name="gboolean" c:type="gboolean"/> </parameter> <parameter name="user_data" @@ -53900,7 +53933,7 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="811">user data passed to the filter function</doc> + line="824">user data passed to the filter function</doc> <type name="gpointer" c:type="gpointer"/> </parameter> </parameters> @@ -53908,12 +53941,12 @@ MT safe.</doc> <method name="find_feature" c:identifier="gst_registry_find_feature"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="896">Find the pluginfeature with the given name and type in the registry.</doc> + line="909">Find the pluginfeature with the given name and type in the registry.</doc> <source-position filename="gst/gstregistry.h" line="112"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="904">the pluginfeature with the + line="917">the pluginfeature with the given name and type or %NULL if the plugin was not found. gst_object_unref() after usage. @@ -53924,19 +53957,19 @@ MT safe.</doc> <instance-parameter name="registry" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="898">the registry to search</doc> + line="911">the registry to search</doc> <type name="Registry" c:type="GstRegistry*"/> </instance-parameter> <parameter name="name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="899">the pluginfeature name to find</doc> + line="912">the pluginfeature name to find</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="type" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="900">the pluginfeature type to find</doc> + line="913">the pluginfeature type to find</doc> <type name="GType" c:type="GType"/> </parameter> </parameters> @@ -53944,13 +53977,13 @@ MT safe.</doc> <method name="find_plugin" c:identifier="gst_registry_find_plugin"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="861">Find the plugin with the given name in the registry. + line="874">Find the plugin with the given name in the registry. The plugin will be reffed; caller is responsible for unreffing.</doc> <source-position filename="gst/gstregistry.h" line="109"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="869">the plugin with the given name + line="882">the plugin with the given name or %NULL if the plugin was not found. gst_object_unref() after usage. @@ -53961,13 +53994,13 @@ MT safe.</doc> <instance-parameter name="registry" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="863">the registry to search</doc> + line="876">the registry to search</doc> <type name="Registry" c:type="GstRegistry*"/> </instance-parameter> <parameter name="name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="864">the plugin name to find</doc> + line="877">the plugin name to find</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -53976,12 +54009,12 @@ MT safe.</doc> c:identifier="gst_registry_get_feature_list"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="929">Retrieves a #GList of #GstPluginFeature of @type.</doc> + line="942">Retrieves a #GList of #GstPluginFeature of @type.</doc> <source-position filename="gst/gstregistry.h" line="100"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="936">a #GList of + line="949">a #GList of #GstPluginFeature of @type. Use gst_plugin_feature_list_free() after use MT safe.</doc> @@ -53993,13 +54026,13 @@ MT safe.</doc> <instance-parameter name="registry" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="931">a #GstRegistry</doc> + line="944">a #GstRegistry</doc> <type name="Registry" c:type="GstRegistry*"/> </instance-parameter> <parameter name="type" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="932">a #GType.</doc> + line="945">a #GType.</doc> <type name="GType" c:type="GType"/> </parameter> </parameters> @@ -54008,12 +54041,12 @@ MT safe.</doc> c:identifier="gst_registry_get_feature_list_by_plugin"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1411">Retrieves a #GList of features of the plugin with name @name.</doc> + line="1424">Retrieves a #GList of features of the plugin with name @name.</doc> <source-position filename="gst/gstregistry.h" line="103"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1418">a #GList of + line="1431">a #GList of #GstPluginFeature. Use gst_plugin_feature_list_free() after usage.</doc> <type name="GLib.List" c:type="GList*"> <type name="PluginFeature"/> @@ -54023,13 +54056,13 @@ MT safe.</doc> <instance-parameter name="registry" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1413">a #GstRegistry.</doc> + line="1426">a #GstRegistry.</doc> <type name="Registry" c:type="GstRegistry*"/> </instance-parameter> <parameter name="name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1414">a plugin name.</doc> + line="1427">a plugin name.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -54038,20 +54071,20 @@ MT safe.</doc> c:identifier="gst_registry_get_feature_list_cookie"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1875">Returns the registry's feature list cookie. This changes + line="1888">Returns the registry's feature list cookie. This changes every time a feature is added or removed from the registry.</doc> <source-position filename="gst/gstregistry.h" line="106"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1882">the feature list cookie.</doc> + line="1895">the feature list cookie.</doc> <type name="guint32" c:type="guint32"/> </return-value> <parameters> <instance-parameter name="registry" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1877">the registry</doc> + line="1890">the registry</doc> <type name="Registry" c:type="GstRegistry*"/> </instance-parameter> </parameters> @@ -54060,13 +54093,13 @@ every time a feature is added or removed from the registry.</doc> c:identifier="gst_registry_get_plugin_list"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="965">Get a copy of all plugins registered in the given registry. The refcount + line="978">Get a copy of all plugins registered in the given registry. The refcount of each element in the list in incremented.</doc> <source-position filename="gst/gstregistry.h" line="87"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="972">a #GList of #GstPlugin. + line="985">a #GList of #GstPlugin. Use gst_plugin_list_free() after usage. MT safe.</doc> @@ -54078,7 +54111,7 @@ MT safe.</doc> <instance-parameter name="registry" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="967">the registry to search</doc> + line="980">the registry to search</doc> <type name="Registry" c:type="GstRegistry*"/> </instance-parameter> </parameters> @@ -54086,13 +54119,13 @@ MT safe.</doc> <method name="lookup" c:identifier="gst_registry_lookup"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1050">Look up a plugin in the given registry with the given filename. + line="1063">Look up a plugin in the given registry with the given filename. If found, plugin is reffed.</doc> <source-position filename="gst/gstregistry.h" line="115"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1058">the #GstPlugin if found, or + line="1071">the #GstPlugin if found, or %NULL if not. gst_object_unref() after usage.</doc> <type name="Plugin" c:type="GstPlugin*"/> </return-value> @@ -54100,13 +54133,13 @@ If found, plugin is reffed.</doc> <instance-parameter name="registry" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1052">the registry to look up in</doc> + line="1065">the registry to look up in</doc> <type name="Registry" c:type="GstRegistry*"/> </instance-parameter> <parameter name="filename" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1053">the name of the file to look up</doc> + line="1066">the name of the file to look up</doc> <type name="utf8" c:type="const char*"/> </parameter> </parameters> @@ -54114,12 +54147,12 @@ If found, plugin is reffed.</doc> <method name="lookup_feature" c:identifier="gst_registry_lookup_feature"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1001">Find a #GstPluginFeature with @name in @registry.</doc> + line="1014">Find a #GstPluginFeature with @name in @registry.</doc> <source-position filename="gst/gstregistry.h" line="118"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1008">a #GstPluginFeature with its refcount incremented, + line="1021">a #GstPluginFeature with its refcount incremented, use gst_object_unref() after usage. MT safe.</doc> @@ -54129,13 +54162,13 @@ MT safe.</doc> <instance-parameter name="registry" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1003">a #GstRegistry</doc> + line="1016">a #GstRegistry</doc> <type name="Registry" c:type="GstRegistry*"/> </instance-parameter> <parameter name="name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1004">a #GstPluginFeature name</doc> + line="1017">a #GstPluginFeature name</doc> <type name="utf8" c:type="const char*"/> </parameter> </parameters> @@ -54143,7 +54176,7 @@ MT safe.</doc> <method name="plugin_filter" c:identifier="gst_registry_plugin_filter"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="628">Runs a filter against all plugins in the registry and returns a #GList with + line="641">Runs a filter against all plugins in the registry and returns a #GList with the results. If the first flag is set, only the first match is returned (as a list with a single object). Every plugin is reffed; use gst_plugin_list_free() after use, which @@ -54152,7 +54185,7 @@ will unref again.</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="641">a #GList of #GstPlugin. + line="654">a #GList of #GstPlugin. Use gst_plugin_list_free() after usage. MT safe.</doc> @@ -54164,7 +54197,7 @@ MT safe.</doc> <instance-parameter name="registry" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="630">registry to query</doc> + line="643">registry to query</doc> <type name="Registry" c:type="GstRegistry*"/> </instance-parameter> <parameter name="filter" @@ -54173,13 +54206,13 @@ MT safe.</doc> closure="2"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="631">the filter to use</doc> + line="644">the filter to use</doc> <type name="PluginFilter" c:type="GstPluginFilter"/> </parameter> <parameter name="first" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="632">only return first match</doc> + line="645">only return first match</doc> <type name="gboolean" c:type="gboolean"/> </parameter> <parameter name="user_data" @@ -54188,7 +54221,7 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="633">user data passed to the filter function</doc> + line="646">user data passed to the filter function</doc> <type name="gpointer" c:type="gpointer"/> </parameter> </parameters> @@ -54196,7 +54229,7 @@ MT safe.</doc> <method name="remove_feature" c:identifier="gst_registry_remove_feature"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="601">Remove the feature from the registry. + line="614">Remove the feature from the registry. MT safe.</doc> <source-position filename="gst/gstregistry.h" line="84"/> @@ -54207,13 +54240,13 @@ MT safe.</doc> <instance-parameter name="registry" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="603">the registry to remove the feature from</doc> + line="616">the registry to remove the feature from</doc> <type name="Registry" c:type="GstRegistry*"/> </instance-parameter> <parameter name="feature" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="604">the feature to remove</doc> + line="617">the feature to remove</doc> <type name="PluginFeature" c:type="GstPluginFeature*"/> </parameter> </parameters> @@ -54221,7 +54254,7 @@ MT safe.</doc> <method name="remove_plugin" c:identifier="gst_registry_remove_plugin"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="511">Remove the plugin from the registry. + line="524">Remove the plugin from the registry. MT safe.</doc> <source-position filename="gst/gstregistry.h" line="78"/> @@ -54232,13 +54265,13 @@ MT safe.</doc> <instance-parameter name="registry" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="513">the registry to remove the plugin from</doc> + line="526">the registry to remove the plugin from</doc> <type name="Registry" c:type="GstRegistry*"/> </instance-parameter> <parameter name="plugin" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="514">the plugin to remove</doc> + line="527">the plugin to remove</doc> <type name="Plugin" c:type="GstPlugin*"/> </parameter> </parameters> @@ -54246,26 +54279,26 @@ MT safe.</doc> <method name="scan_path" c:identifier="gst_registry_scan_path"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1375">Scan the given path for plugins to add to the registry. The syntax of the + line="1388">Scan the given path for plugins to add to the registry. The syntax of the path is specific to the registry.</doc> <source-position filename="gst/gstregistry.h" line="67"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1383">%TRUE if registry changed</doc> + line="1396">%TRUE if registry changed</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="registry" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1377">the registry to add found plugins to</doc> + line="1390">the registry to add found plugins to</doc> <type name="Registry" c:type="GstRegistry*"/> </instance-parameter> <parameter name="path" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1378">the path to scan</doc> + line="1391">the path to scan</doc> <type name="filename" c:type="const gchar*"/> </parameter> </parameters> @@ -54279,7 +54312,7 @@ path is specific to the registry.</doc> <glib:signal name="feature-added" when="last"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="220">Signals that a feature has been added to the registry (possibly + line="233">Signals that a feature has been added to the registry (possibly replacing a previously-added one by the same name)</doc> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> @@ -54288,7 +54321,7 @@ replacing a previously-added one by the same name)</doc> <parameter name="feature" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="223">the feature that has been added</doc> + line="236">the feature that has been added</doc> <type name="PluginFeature"/> </parameter> </parameters> @@ -54296,7 +54329,7 @@ replacing a previously-added one by the same name)</doc> <glib:signal name="plugin-added" when="last"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="208">Signals that a plugin has been added to the registry (possibly + line="221">Signals that a plugin has been added to the registry (possibly replacing a previously-added one by the same name)</doc> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> @@ -54305,7 +54338,7 @@ replacing a previously-added one by the same name)</doc> <parameter name="plugin" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="211">the plugin that has been added</doc> + line="224">the plugin that has been added</doc> <type name="Plugin"/> </parameter> </parameters> @@ -54823,6 +54856,21 @@ static GstStaticPadTemplate my_src_template = * GST_STATIC_PAD_TEMPLATE("src" </parameter> </parameters> </function-macro> + <constant name="STIMEP_FORMAT" + value="paS" + c:type="GST_STIMEP_FORMAT" + version="1.18" + introspectable="0"> + <doc xml:space="preserve" + filename="gst/gstinfo.h" + line="318">printf format type used to debug GStreamer signed time value pointers. You +can use this in combination with GStreamer's debug logging system as well as +the functions gst_info_vasprintf(), gst_info_strdup_vprintf() and +gst_info_strdup_printf() to pretty-print signed time (pointers to +#GstClockTimeDiff or #gint64).</doc> + <source-position filename="gst/gstinfo.h" line="329"/> + <type name="utf8" c:type="gchar*"/> + </constant> <function-macro name="STIME_ARGS" c:identifier="GST_STIME_ARGS" version="1.6" @@ -55426,14 +55474,14 @@ sample will be freed.</doc> c:type="GstSearchMode"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="1157">The different search modes.</doc> + line="1160">The different search modes.</doc> <member name="exact" value="0" c:identifier="GST_SEARCH_MODE_EXACT" glib:nick="exact"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="1159">Only search for exact matches.</doc> + line="1162">Only search for exact matches.</doc> </member> <member name="before" value="1" @@ -55441,7 +55489,7 @@ sample will be freed.</doc> glib:nick="before"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="1160">Search for an exact match or the element just before.</doc> + line="1163">Search for an exact match or the element just before.</doc> </member> <member name="after" value="2" @@ -55449,7 +55497,7 @@ sample will be freed.</doc> glib:nick="after"> <doc xml:space="preserve" filename="gst/gstutils.h" - line="1161">Search for an exact match or the element just after.</doc> + line="1164">Search for an exact match or the element just after.</doc> </member> </enumeration> <bitfield name="SeekFlags" @@ -56958,7 +57006,7 @@ they should make sure to go back to real 'PAUSED' state (prerolling for example) <doc xml:space="preserve" filename="gst/gstutils.c" line="1331">Gets a string representing the given state transition.</doc> - <source-position filename="gst/gstutils.h" line="996"/> + <source-position filename="gst/gstutils.h" line="999"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -57231,19 +57279,19 @@ a new one will be automatically generated</doc> version="1.10"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="443">Retrieve the caps for @stream, if any</doc> + line="445">Retrieve the caps for @stream, if any</doc> <source-position filename="gst/gststreams.h" line="150"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="449">The #GstCaps for @stream</doc> + line="451">The #GstCaps for @stream</doc> <type name="Caps" c:type="GstCaps*"/> </return-value> <parameters> <instance-parameter name="stream" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="445">a #GstStream</doc> + line="447">a #GstStream</doc> <type name="Stream" c:type="GstStream*"/> </instance-parameter> </parameters> @@ -57253,19 +57301,19 @@ a new one will be automatically generated</doc> version="1.10"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="290">Retrieve the current stream flags for @stream</doc> + line="292">Retrieve the current stream flags for @stream</doc> <source-position filename="gst/gststreams.h" line="132"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="296">The #GstStreamFlags for @stream</doc> + line="298">The #GstStreamFlags for @stream</doc> <type name="StreamFlags" c:type="GstStreamFlags"/> </return-value> <parameters> <instance-parameter name="stream" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="292">a #GstStream</doc> + line="294">a #GstStream</doc> <type name="Stream" c:type="GstStream*"/> </instance-parameter> </parameters> @@ -57275,12 +57323,12 @@ a new one will be automatically generated</doc> version="1.10"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="249">Returns the stream ID of @stream.</doc> + line="251">Returns the stream ID of @stream.</doc> <source-position filename="gst/gststreams.h" line="126"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="255">the stream ID of @stream. Only valid + line="257">the stream ID of @stream. Only valid during the lifetime of @stream.</doc> <type name="utf8" c:type="const gchar*"/> </return-value> @@ -57288,7 +57336,7 @@ during the lifetime of @stream.</doc> <instance-parameter name="stream" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="251">a #GstStream</doc> + line="253">a #GstStream</doc> <type name="Stream" c:type="GstStream*"/> </instance-parameter> </parameters> @@ -57298,19 +57346,19 @@ during the lifetime of @stream.</doc> version="1.10"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="336">Retrieve the stream type for @stream</doc> + line="338">Retrieve the stream type for @stream</doc> <source-position filename="gst/gststreams.h" line="138"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="342">The #GstStreamType for @stream</doc> + line="344">The #GstStreamType for @stream</doc> <type name="StreamType" c:type="GstStreamType"/> </return-value> <parameters> <instance-parameter name="stream" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="338">a #GstStream</doc> + line="340">a #GstStream</doc> <type name="Stream" c:type="GstStream*"/> </instance-parameter> </parameters> @@ -57320,19 +57368,19 @@ during the lifetime of @stream.</doc> version="1.10"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="389">Retrieve the tags for @stream, if any</doc> + line="391">Retrieve the tags for @stream, if any</doc> <source-position filename="gst/gststreams.h" line="144"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="395">The #GstTagList for @stream</doc> + line="397">The #GstTagList for @stream</doc> <type name="TagList" c:type="GstTagList*"/> </return-value> <parameters> <instance-parameter name="stream" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="391">a #GstStream</doc> + line="393">a #GstStream</doc> <type name="Stream" c:type="GstStream*"/> </instance-parameter> </parameters> @@ -57342,7 +57390,7 @@ during the lifetime of @stream.</doc> version="1.10"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="414">Set the caps for the #GstStream</doc> + line="416">Set the caps for the #GstStream</doc> <source-position filename="gst/gststreams.h" line="147"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> @@ -57351,7 +57399,7 @@ during the lifetime of @stream.</doc> <instance-parameter name="stream" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="416">a #GstStream</doc> + line="418">a #GstStream</doc> <type name="Stream" c:type="GstStream*"/> </instance-parameter> <parameter name="caps" @@ -57360,7 +57408,7 @@ during the lifetime of @stream.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="417">a #GstCaps</doc> + line="419">a #GstCaps</doc> <type name="Caps" c:type="GstCaps*"/> </parameter> </parameters> @@ -57370,7 +57418,7 @@ during the lifetime of @stream.</doc> version="1.10"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="268">Set the @flags for the @stream.</doc> + line="270">Set the @flags for the @stream.</doc> <source-position filename="gst/gststreams.h" line="129"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> @@ -57379,13 +57427,13 @@ during the lifetime of @stream.</doc> <instance-parameter name="stream" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="270">a #GstStream</doc> + line="272">a #GstStream</doc> <type name="Stream" c:type="GstStream*"/> </instance-parameter> <parameter name="flags" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="271">the flags to set on @stream</doc> + line="273">the flags to set on @stream</doc> <type name="StreamFlags" c:type="GstStreamFlags"/> </parameter> </parameters> @@ -57395,7 +57443,7 @@ during the lifetime of @stream.</doc> version="1.10"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="314">Set the stream type of @stream</doc> + line="316">Set the stream type of @stream</doc> <source-position filename="gst/gststreams.h" line="135"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> @@ -57404,13 +57452,13 @@ during the lifetime of @stream.</doc> <instance-parameter name="stream" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="316">a #GstStream</doc> + line="318">a #GstStream</doc> <type name="Stream" c:type="GstStream*"/> </instance-parameter> <parameter name="stream_type" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="317">the type to set on @stream</doc> + line="319">the type to set on @stream</doc> <type name="StreamType" c:type="GstStreamType"/> </parameter> </parameters> @@ -57420,7 +57468,7 @@ during the lifetime of @stream.</doc> version="1.10"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="360">Set the tags for the #GstStream</doc> + line="362">Set the tags for the #GstStream</doc> <source-position filename="gst/gststreams.h" line="141"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> @@ -57429,7 +57477,7 @@ during the lifetime of @stream.</doc> <instance-parameter name="stream" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="362">a #GstStream</doc> + line="364">a #GstStream</doc> <type name="Stream" c:type="GstStream*"/> </instance-parameter> <parameter name="tags" @@ -57438,7 +57486,7 @@ during the lifetime of @stream.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="363">a #GstTagList</doc> + line="365">a #GstTagList</doc> <type name="TagList" c:type="GstTagList*"/> </parameter> </parameters> @@ -58080,19 +58128,19 @@ whether a stream is of a certain type.</doc> version="1.10"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="538">Get a descriptive string for a given #GstStreamType</doc> + line="540">Get a descriptive string for a given #GstStreamType</doc> <source-position filename="gst/gststreams.h" line="153"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="544">A string describing the stream type</doc> + line="546">A string describing the stream type</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> <parameter name="stype" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="540">a #GstStreamType</doc> + line="542">a #GstStreamType</doc> <type name="StreamType" c:type="GstStreamType"/> </parameter> </parameters> @@ -58199,15 +58247,11 @@ They also allow for nested structure, such as: a-struct, nested=(GstStructure)"nested-struct, nested=true" ``` -Since 1.18, nested structures and caps can be specified using brackets -(`[` and `]`), for example: - -``` -a-struct, nested=[nested-struct, nested=true] -``` - -> *note*: For backward compatility reason, the serialization functions won't -> use that synthax.</doc> +> *Note*: Be aware that the current #GstCaps / #GstStructure serialization +> into string has limited support for nested #GstCaps / #GstStructure fields. +> It can only support one level of nesting. Using more levels will lead to +> unexpected behavior when using serialization features, such as +> gst_caps_to_string() or gst_value_serialize() and their counterparts.</doc> <source-position filename="gst/gststructure.h" line="101"/> <field name="type" writable="1"> <doc xml:space="preserve" @@ -58221,7 +58265,7 @@ a-struct, nested=[nested-struct, nested=true] <constructor name="from_string" c:identifier="gst_structure_from_string"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2325">Creates a #GstStructure from a string representation. + line="2312">Creates a #GstStructure from a string representation. If end is not %NULL, a pointer to the place inside the given string where parsing ended will be returned. @@ -58230,7 +58274,7 @@ Free-function: gst_structure_free</doc> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2336">a new #GstStructure or %NULL + line="2323">a new #GstStructure or %NULL when the string could not be parsed. Free with gst_structure_free() after use.</doc> <type name="Structure" c:type="GstStructure*"/> @@ -58239,7 +58283,7 @@ Free-function: gst_structure_free</doc> <parameter name="string" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2327">a string representation of a #GstStructure.</doc> + line="2314">a string representation of a #GstStructure.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="end" @@ -58251,7 +58295,7 @@ Free-function: gst_structure_free</doc> skip="1"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2328">pointer to store the end of the string in.</doc> + line="2315">pointer to store the end of the string in.</doc> <type name="utf8" c:type="gchar**"/> </parameter> </parameters> @@ -58261,7 +58305,7 @@ Free-function: gst_structure_free</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="368">Creates a new #GstStructure with the given name. Parses the + line="366">Creates a new #GstStructure with the given name. Parses the list of variable arguments and sets fields to the values listed. Variable arguments should be passed as field name, field type, and value. Last variable argument should be %NULL. @@ -58271,26 +58315,26 @@ Free-function: gst_structure_free</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="381">a new #GstStructure</doc> + line="379">a new #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </return-value> <parameters> <parameter name="name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="370">name of new structure</doc> + line="368">name of new structure</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="firstfield" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="371">name of first field to set</doc> + line="369">name of first field to set</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="..." transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="372">additional arguments</doc> + line="370">additional arguments</doc> <varargs/> </parameter> </parameters> @@ -58298,7 +58342,7 @@ Free-function: gst_structure_free</doc> <constructor name="new_empty" c:identifier="gst_structure_new_empty"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="348">Creates a new, empty #GstStructure with the given @name. + line="346">Creates a new, empty #GstStructure with the given @name. See gst_structure_set_name() for constraints on the @name parameter. @@ -58307,14 +58351,14 @@ Free-function: gst_structure_free</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="358">a new, empty #GstStructure</doc> + line="356">a new, empty #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </return-value> <parameters> <parameter name="name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="350">name of new structure</doc> + line="348">name of new structure</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -58324,7 +58368,7 @@ Free-function: gst_structure_free</doc> version="1.2"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2300">Creates a #GstStructure from a string representation. + line="2287">Creates a #GstStructure from a string representation. If end is not %NULL, a pointer to the place inside the given string where parsing ended will be returned. @@ -58336,7 +58380,7 @@ Free-function: gst_structure_free</doc> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2313">a new #GstStructure or %NULL + line="2300">a new #GstStructure or %NULL when the string could not be parsed. Free with gst_structure_free() after use.</doc> <type name="Structure" c:type="GstStructure*"/> @@ -58345,7 +58389,7 @@ Free-function: gst_structure_free</doc> <parameter name="string" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2302">a string representation of a #GstStructure</doc> + line="2289">a string representation of a #GstStructure</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -58355,7 +58399,7 @@ Free-function: gst_structure_free</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="947">Creates a new #GstStructure with the given name as a GQuark, followed by + line="945">Creates a new #GstStructure with the given name as a GQuark, followed by fieldname quark, GType, argument(s) "triplets" in the same format as gst_structure_id_set(). Basically a convenience wrapper around gst_structure_new_id_empty() and gst_structure_id_set(). @@ -58367,26 +58411,26 @@ Free-function: gst_structure_free</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="962">a new #GstStructure</doc> + line="960">a new #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </return-value> <parameters> <parameter name="name_quark" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="949">name of new structure</doc> + line="947">name of new structure</doc> <type name="GLib.Quark" c:type="GQuark"/> </parameter> <parameter name="field_quark" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="950">the GQuark for the name of the field to set</doc> + line="948">the GQuark for the name of the field to set</doc> <type name="GLib.Quark" c:type="GQuark"/> </parameter> <parameter name="..." transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="951">variable arguments</doc> + line="949">variable arguments</doc> <varargs/> </parameter> </parameters> @@ -58395,21 +58439,21 @@ Free-function: gst_structure_free</doc> c:identifier="gst_structure_new_id_empty"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="296">Creates a new, empty #GstStructure with the given name as a GQuark. + line="292">Creates a new, empty #GstStructure with the given name as a GQuark. Free-function: gst_structure_free</doc> <source-position filename="gst/gststructure.h" line="110"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="304">a new, empty #GstStructure</doc> + line="300">a new, empty #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </return-value> <parameters> <parameter name="quark" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="298">name of new structure</doc> + line="294">name of new structure</doc> <type name="GLib.Quark" c:type="GQuark"/> </parameter> </parameters> @@ -58419,7 +58463,7 @@ Free-function: gst_structure_free</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="396">Creates a new #GstStructure with the given @name. Structure fields + line="394">Creates a new #GstStructure with the given @name. Structure fields are set according to the varargs in a manner similar to gst_structure_new(). @@ -58430,26 +58474,26 @@ Free-function: gst_structure_free</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="410">a new #GstStructure</doc> + line="408">a new #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </return-value> <parameters> <parameter name="name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="398">name of new structure</doc> + line="396">name of new structure</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="firstfield" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="399">name of first field to set</doc> + line="397">name of first field to set</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="varargs" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="400">variable argument list</doc> + line="398">variable argument list</doc> <type name="va_list" c:type="va_list"/> </parameter> </parameters> @@ -58457,26 +58501,26 @@ Free-function: gst_structure_free</doc> <method name="can_intersect" c:identifier="gst_structure_can_intersect"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3167">Tries intersecting @struct1 and @struct2 and reports whether the result + line="3154">Tries intersecting @struct1 and @struct2 and reports whether the result would not be empty.</doc> <source-position filename="gst/gststructure.h" line="371"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3175">%TRUE if intersection would not be empty</doc> + line="3162">%TRUE if intersection would not be empty</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="struct1" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3169">a #GstStructure</doc> + line="3156">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="struct2" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3170">a #GstStructure</doc> + line="3157">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </parameter> </parameters> @@ -58484,21 +58528,21 @@ would not be empty.</doc> <method name="copy" c:identifier="gst_structure_copy"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="479">Duplicates a #GstStructure and all its fields and values. + line="477">Duplicates a #GstStructure and all its fields and values. Free-function: gst_structure_free</doc> <source-position filename="gst/gststructure.h" line="128"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="487">a new #GstStructure.</doc> + line="485">a new #GstStructure.</doc> <type name="Structure" c:type="GstStructure*"/> </return-value> <parameters> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="481">a #GstStructure to duplicate</doc> + line="479">a #GstStructure to duplicate</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> </parameters> @@ -58508,7 +58552,7 @@ Free-function: gst_structure_free</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1408">Calls the provided function once for each field in the #GstStructure. In + line="1406">Calls the provided function once for each field in the #GstStructure. In contrast to gst_structure_foreach(), the function may modify the fields. In contrast to gst_structure_map_in_place(), the field is removed from the structure if %FALSE is returned from the function. @@ -58521,7 +58565,7 @@ The structure must be mutable.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1410">a #GstStructure</doc> + line="1408">a #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </instance-parameter> <parameter name="func" @@ -58530,7 +58574,7 @@ The structure must be mutable.</doc> closure="1"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1411">a function to call for each field</doc> + line="1409">a function to call for each field</doc> <type name="StructureFilterMapFunc" c:type="GstStructureFilterMapFunc"/> </parameter> @@ -58540,7 +58584,7 @@ The structure must be mutable.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1412">private data</doc> + line="1410">private data</doc> <type name="gpointer" c:type="gpointer"/> </parameter> </parameters> @@ -58548,7 +58592,7 @@ The structure must be mutable.</doc> <method name="fixate" c:identifier="gst_structure_fixate"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3256">Fixate all values in @structure using gst_value_fixate(). + line="3243">Fixate all values in @structure using gst_value_fixate(). @structure will be modified in-place and should be writable.</doc> <source-position filename="gst/gststructure.h" line="362"/> <return-value transfer-ownership="none"> @@ -58558,7 +58602,7 @@ The structure must be mutable.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3258">a #GstStructure</doc> + line="3245">a #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </instance-parameter> </parameters> @@ -58566,25 +58610,25 @@ The structure must be mutable.</doc> <method name="fixate_field" c:identifier="gst_structure_fixate_field"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2753">Fixates a #GstStructure by changing the given field with its fixated value.</doc> + line="2740">Fixates a #GstStructure by changing the given field with its fixated value.</doc> <source-position filename="gst/gststructure.h" line="359"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2760">%TRUE if the structure field could be fixated</doc> + line="2747">%TRUE if the structure field could be fixated</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2755">a #GstStructure</doc> + line="2742">a #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </instance-parameter> <parameter name="field_name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2756">a field in @structure</doc> + line="2743">a field in @structure</doc> <type name="utf8" c:type="const char*"/> </parameter> </parameters> @@ -58593,32 +58637,32 @@ The structure must be mutable.</doc> c:identifier="gst_structure_fixate_field_boolean"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2541">Fixates a #GstStructure by changing the given @field_name field to the given + line="2528">Fixates a #GstStructure by changing the given @field_name field to the given @target boolean if that field is not fixed yet.</doc> <source-position filename="gst/gststructure.h" line="346"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2550">%TRUE if the structure could be fixated</doc> + line="2537">%TRUE if the structure could be fixated</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2543">a #GstStructure</doc> + line="2530">a #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </instance-parameter> <parameter name="field_name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2544">a field in @structure</doc> + line="2531">a field in @structure</doc> <type name="utf8" c:type="const char*"/> </parameter> <parameter name="target" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2545">the target value of the fixation</doc> + line="2532">the target value of the fixation</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -58627,32 +58671,32 @@ The structure must be mutable.</doc> c:identifier="gst_structure_fixate_field_nearest_double"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2476">Fixates a #GstStructure by changing the given field to the nearest + line="2463">Fixates a #GstStructure by changing the given field to the nearest double to @target that is a subset of the existing field.</doc> <source-position filename="gst/gststructure.h" line="342"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2485">%TRUE if the structure could be fixated</doc> + line="2472">%TRUE if the structure could be fixated</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2478">a #GstStructure</doc> + line="2465">a #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </instance-parameter> <parameter name="field_name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2479">a field in @structure</doc> + line="2466">a field in @structure</doc> <type name="utf8" c:type="const char*"/> </parameter> <parameter name="target" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2480">the target value of the fixation</doc> + line="2467">the target value of the fixation</doc> <type name="gdouble" c:type="double"/> </parameter> </parameters> @@ -58661,39 +58705,39 @@ double to @target that is a subset of the existing field.</doc> c:identifier="gst_structure_fixate_field_nearest_fraction"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2647">Fixates a #GstStructure by changing the given field to the nearest + line="2634">Fixates a #GstStructure by changing the given field to the nearest fraction to @target_numerator/@target_denominator that is a subset of the existing field.</doc> <source-position filename="gst/gststructure.h" line="354"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2658">%TRUE if the structure could be fixated</doc> + line="2645">%TRUE if the structure could be fixated</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2649">a #GstStructure</doc> + line="2636">a #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </instance-parameter> <parameter name="field_name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2650">a field in @structure</doc> + line="2637">a field in @structure</doc> <type name="utf8" c:type="const char*"/> </parameter> <parameter name="target_numerator" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2651">The numerator of the target value of the fixation</doc> + line="2638">The numerator of the target value of the fixation</doc> <type name="gint" c:type="const gint"/> </parameter> <parameter name="target_denominator" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2652">The denominator of the target value of the fixation</doc> + line="2639">The denominator of the target value of the fixation</doc> <type name="gint" c:type="const gint"/> </parameter> </parameters> @@ -58702,32 +58746,32 @@ of the existing field.</doc> c:identifier="gst_structure_fixate_field_nearest_int"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2406">Fixates a #GstStructure by changing the given field to the nearest + line="2393">Fixates a #GstStructure by changing the given field to the nearest integer to @target that is a subset of the existing field.</doc> <source-position filename="gst/gststructure.h" line="338"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2415">%TRUE if the structure could be fixated</doc> + line="2402">%TRUE if the structure could be fixated</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2408">a #GstStructure</doc> + line="2395">a #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </instance-parameter> <parameter name="field_name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2409">a field in @structure</doc> + line="2396">a field in @structure</doc> <type name="utf8" c:type="const char*"/> </parameter> <parameter name="target" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2410">the target value of the fixation</doc> + line="2397">the target value of the fixation</doc> <type name="gint" c:type="int"/> </parameter> </parameters> @@ -58736,32 +58780,32 @@ integer to @target that is a subset of the existing field.</doc> c:identifier="gst_structure_fixate_field_string"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2594">Fixates a #GstStructure by changing the given @field_name field to the given + line="2581">Fixates a #GstStructure by changing the given @field_name field to the given @target string if that field is not fixed yet.</doc> <source-position filename="gst/gststructure.h" line="350"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2603">%TRUE if the structure could be fixated</doc> + line="2590">%TRUE if the structure could be fixated</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2596">a #GstStructure</doc> + line="2583">a #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </instance-parameter> <parameter name="field_name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2597">a field in @structure</doc> + line="2584">a field in @structure</doc> <type name="utf8" c:type="const char*"/> </parameter> <parameter name="target" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2598">the target value of the fixation</doc> + line="2585">the target value of the fixation</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -58769,14 +58813,14 @@ integer to @target that is a subset of the existing field.</doc> <method name="foreach" c:identifier="gst_structure_foreach"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1334">Calls the provided function once for each field in the #GstStructure. The + line="1332">Calls the provided function once for each field in the #GstStructure. The function must not modify the fields. Also see gst_structure_map_in_place() and gst_structure_filter_and_map_in_place().</doc> <source-position filename="gst/gststructure.h" line="235"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1344">%TRUE if the supplied function returns %TRUE For each of the fields, + line="1342">%TRUE if the supplied function returns %TRUE For each of the fields, %FALSE otherwise.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -58784,7 +58828,7 @@ and gst_structure_filter_and_map_in_place().</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1336">a #GstStructure</doc> + line="1334">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="func" @@ -58793,7 +58837,7 @@ and gst_structure_filter_and_map_in_place().</doc> closure="1"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1337">a function to call for each field</doc> + line="1335">a function to call for each field</doc> <type name="StructureForeachFunc" c:type="GstStructureForeachFunc"/> </parameter> @@ -58803,7 +58847,7 @@ and gst_structure_filter_and_map_in_place().</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1338">private data</doc> + line="1336">private data</doc> <type name="gpointer" c:type="gpointer"/> </parameter> </parameters> @@ -58811,7 +58855,7 @@ and gst_structure_filter_and_map_in_place().</doc> <method name="free" c:identifier="gst_structure_free"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="516">Frees a #GstStructure and all its fields and values. The structure must not + line="514">Frees a #GstStructure and all its fields and values. The structure must not have a parent when this function is called.</doc> <source-position filename="gst/gststructure.h" line="134"/> <return-value transfer-ownership="none"> @@ -58821,7 +58865,7 @@ have a parent when this function is called.</doc> <instance-parameter name="structure" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="518">the #GstStructure to free</doc> + line="516">the #GstStructure to free</doc> <type name="Structure" c:type="GstStructure*"/> </instance-parameter> </parameters> @@ -58829,7 +58873,7 @@ have a parent when this function is called.</doc> <method name="get" c:identifier="gst_structure_get" introspectable="0"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2937">Parses the variable arguments and reads fields from @structure accordingly. + line="2924">Parses the variable arguments and reads fields from @structure accordingly. Variable arguments should be in the form field name, field type (as a GType), pointer(s) to a variable(s) to hold the return value(s). The last variable argument should be %NULL. @@ -58842,7 +58886,7 @@ release with either g_free() or the suitable function for the boxed type.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2953">%FALSE if there was a problem reading any of the fields (e.g. + line="2940">%FALSE if there was a problem reading any of the fields (e.g. because the field requested did not exist, or was of a type other than the type specified), otherwise %TRUE.</doc> <type name="gboolean" c:type="gboolean"/> @@ -58851,27 +58895,29 @@ release with either g_free() or the suitable function for the boxed type.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2939">a #GstStructure</doc> + line="2926">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="first_fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2940">the name of the first field to read</doc> + line="2927">the name of the first field to read</doc> <type name="utf8" c:type="const char*"/> </parameter> <parameter name="..." transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2941">variable arguments</doc> + line="2928">variable arguments</doc> <varargs/> </parameter> </parameters> </method> - <method name="get_array" c:identifier="gst_structure_get_array"> + <method name="get_array" + c:identifier="gst_structure_get_array" + version="1.12"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3298">This is useful in language bindings where unknown #GValue types are not + line="3285">This is useful in language bindings where unknown #GValue types are not supported. This function will convert the %GST_TYPE_ARRAY into a newly allocated #GValueArray and return it through @array. Be aware that this is slower then getting the #GValue directly.</doc> @@ -58879,7 +58925,7 @@ slower then getting the #GValue directly.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3309">%TRUE if the value could be set correctly. If there was no field + line="3296">%TRUE if the value could be set correctly. If there was no field with @fieldname or the existing field did not contain a %GST_TYPE_ARRAY, this function returns %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> @@ -58888,13 +58934,13 @@ this function returns %FALSE.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3300">a #GstStructure</doc> + line="3287">a #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3301">the name of a field</doc> + line="3288">the name of a field</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="array" @@ -58903,7 +58949,7 @@ this function returns %FALSE.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3302">a pointer to a #GValueArray</doc> + line="3289">a pointer to a #GValueArray</doc> <type name="GObject.ValueArray" c:type="GValueArray**"/> </parameter> </parameters> @@ -58911,14 +58957,14 @@ this function returns %FALSE.</doc> <method name="get_boolean" c:identifier="gst_structure_get_boolean"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1543">Sets the boolean pointed to by @value corresponding to the value of the + line="1541">Sets the boolean pointed to by @value corresponding to the value of the given field. Caller is responsible for making sure the field exists and has the correct type.</doc> <source-position filename="gst/gststructure.h" line="270"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1553">%TRUE if the value could be set correctly. If there was no field + line="1551">%TRUE if the value could be set correctly. If there was no field with @fieldname or the existing field did not contain a boolean, this function returns %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> @@ -58927,13 +58973,13 @@ function returns %FALSE.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1545">a #GstStructure</doc> + line="1543">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1546">the name of a field</doc> + line="1544">the name of a field</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="value" @@ -58942,7 +58988,7 @@ function returns %FALSE.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1547">a pointer to a #gboolean to set</doc> + line="1545">a pointer to a #gboolean to set</doc> <type name="gboolean" c:type="gboolean*"/> </parameter> </parameters> @@ -58951,14 +58997,14 @@ function returns %FALSE.</doc> c:identifier="gst_structure_get_clock_time"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1798">Sets the clock time pointed to by @value corresponding to the clock time + line="1796">Sets the clock time pointed to by @value corresponding to the clock time of the given field. Caller is responsible for making sure the field exists and has the correct type.</doc> <source-position filename="gst/gststructure.h" line="302"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1808">%TRUE if the value could be set correctly. If there was no field + line="1806">%TRUE if the value could be set correctly. If there was no field with @fieldname or the existing field did not contain a #GstClockTime, this function returns %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> @@ -58967,13 +59013,13 @@ function returns %FALSE.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1800">a #GstStructure</doc> + line="1798">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1801">the name of a field</doc> + line="1799">the name of a field</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="value" @@ -58982,7 +59028,7 @@ function returns %FALSE.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1802">a pointer to a #GstClockTime to set</doc> + line="1800">a pointer to a #GstClockTime to set</doc> <type name="ClockTime" c:type="GstClockTime*"/> </parameter> </parameters> @@ -58990,7 +59036,7 @@ function returns %FALSE.</doc> <method name="get_date" c:identifier="gst_structure_get_date"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1716">Sets the date pointed to by @value corresponding to the date of the + line="1714">Sets the date pointed to by @value corresponding to the date of the given field. Caller is responsible for making sure the field exists and has the correct type. @@ -59002,7 +59048,7 @@ copy of the string).</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1731">%TRUE if the value could be set correctly. If there was no field + line="1729">%TRUE if the value could be set correctly. If there was no field with @fieldname or the existing field did not contain a data, this function returns %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> @@ -59011,13 +59057,13 @@ returns %FALSE.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1718">a #GstStructure</doc> + line="1716">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1719">the name of a field</doc> + line="1717">the name of a field</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="value" @@ -59026,7 +59072,7 @@ returns %FALSE.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1720">a pointer to a #GDate to set</doc> + line="1718">a pointer to a #GDate to set</doc> <type name="GLib.Date" c:type="GDate**"/> </parameter> </parameters> @@ -59034,7 +59080,7 @@ returns %FALSE.</doc> <method name="get_date_time" c:identifier="gst_structure_get_date_time"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1756">Sets the datetime pointed to by @value corresponding to the datetime of the + line="1754">Sets the datetime pointed to by @value corresponding to the datetime of the given field. Caller is responsible for making sure the field exists and has the correct type. @@ -59046,7 +59092,7 @@ which doesn't return a copy of the string).</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1771">%TRUE if the value could be set correctly. If there was no field + line="1769">%TRUE if the value could be set correctly. If there was no field with @fieldname or the existing field did not contain a data, this function returns %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> @@ -59055,13 +59101,13 @@ returns %FALSE.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1758">a #GstStructure</doc> + line="1756">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1759">the name of a field</doc> + line="1757">the name of a field</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="value" @@ -59070,7 +59116,7 @@ returns %FALSE.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1760">a pointer to a #GstDateTime to set</doc> + line="1758">a pointer to a #GstDateTime to set</doc> <type name="DateTime" c:type="GstDateTime**"/> </parameter> </parameters> @@ -59078,14 +59124,14 @@ returns %FALSE.</doc> <method name="get_double" c:identifier="gst_structure_get_double"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1819">Sets the double pointed to by @value corresponding to the value of the + line="1817">Sets the double pointed to by @value corresponding to the value of the given field. Caller is responsible for making sure the field exists and has the correct type.</doc> <source-position filename="gst/gststructure.h" line="290"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1829">%TRUE if the value could be set correctly. If there was no field + line="1827">%TRUE if the value could be set correctly. If there was no field with @fieldname or the existing field did not contain a double, this function returns %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> @@ -59094,13 +59140,13 @@ function returns %FALSE.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1821">a #GstStructure</doc> + line="1819">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1822">the name of a field</doc> + line="1820">the name of a field</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="value" @@ -59109,7 +59155,7 @@ function returns %FALSE.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1823">a pointer to a gdouble to set</doc> + line="1821">a pointer to a gdouble to set</doc> <type name="gdouble" c:type="gdouble*"/> </parameter> </parameters> @@ -59117,14 +59163,14 @@ function returns %FALSE.</doc> <method name="get_enum" c:identifier="gst_structure_get_enum"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1885">Sets the int pointed to by @value corresponding to the value of the + line="1883">Sets the int pointed to by @value corresponding to the value of the given field. Caller is responsible for making sure the field exists, has the correct type and that the enumtype is correct.</doc> <source-position filename="gst/gststructure.h" line="309"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1896">%TRUE if the value could be set correctly. If there was no field + line="1894">%TRUE if the value could be set correctly. If there was no field with @fieldname or the existing field did not contain an enum of the given type, this function returns %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> @@ -59133,19 +59179,19 @@ type, this function returns %FALSE.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1887">a #GstStructure</doc> + line="1885">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1888">the name of a field</doc> + line="1886">the name of a field</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="enumtype" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1889">the enum type of a field</doc> + line="1887">the enum type of a field</doc> <type name="GType" c:type="GType"/> </parameter> <parameter name="value" @@ -59154,7 +59200,7 @@ type, this function returns %FALSE.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1890">a pointer to an int to set</doc> + line="1888">a pointer to an int to set</doc> <type name="gint" c:type="gint*"/> </parameter> </parameters> @@ -59163,27 +59209,27 @@ type, this function returns %FALSE.</doc> c:identifier="gst_structure_get_field_type"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1269">Finds the field with the given name, and returns the type of the + line="1267">Finds the field with the given name, and returns the type of the value it contains. If the field is not found, G_TYPE_INVALID is returned.</doc> <source-position filename="gst/gststructure.h" line="232"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1278">the #GValue of the field</doc> + line="1276">the #GValue of the field</doc> <type name="GType" c:type="GType"/> </return-value> <parameters> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1271">a #GstStructure</doc> + line="1269">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1272">the name of the field</doc> + line="1270">the name of the field</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -59193,13 +59239,13 @@ returned.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1960">Read the GstFlagSet flags and mask out of the structure into the + line="1958">Read the GstFlagSet flags and mask out of the structure into the provided pointers.</doc> <source-position filename="gst/gststructure.h" line="319"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1970">%TRUE if the values could be set correctly. If there was no field + line="1968">%TRUE if the values could be set correctly. If there was no field with @fieldname or the existing field did not contain a GstFlagSet, this function returns %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> @@ -59208,13 +59254,13 @@ function returns %FALSE.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1962">a #GstStructure</doc> + line="1960">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1963">the name of a field</doc> + line="1961">the name of a field</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="value_flags" @@ -59225,7 +59271,7 @@ function returns %FALSE.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1964">a pointer to a guint for the flags field</doc> + line="1962">a pointer to a guint for the flags field</doc> <type name="guint" c:type="guint*"/> </parameter> <parameter name="value_mask" @@ -59236,7 +59282,7 @@ function returns %FALSE.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1965">a pointer to a guint for the mask field</doc> + line="1963">a pointer to a guint for the mask field</doc> <type name="guint" c:type="guint*"/> </parameter> </parameters> @@ -59244,14 +59290,14 @@ function returns %FALSE.</doc> <method name="get_fraction" c:identifier="gst_structure_get_fraction"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1923">Sets the integers pointed to by @value_numerator and @value_denominator + line="1921">Sets the integers pointed to by @value_numerator and @value_denominator corresponding to the value of the given field. Caller is responsible for making sure the field exists and has the correct type.</doc> <source-position filename="gst/gststructure.h" line="314"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1934">%TRUE if the values could be set correctly. If there was no field + line="1932">%TRUE if the values could be set correctly. If there was no field with @fieldname or the existing field did not contain a GstFraction, this function returns %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> @@ -59260,13 +59306,13 @@ function returns %FALSE.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1925">a #GstStructure</doc> + line="1923">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1926">the name of a field</doc> + line="1924">the name of a field</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="value_numerator" @@ -59275,7 +59321,7 @@ function returns %FALSE.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1927">a pointer to an int to set</doc> + line="1925">a pointer to an int to set</doc> <type name="gint" c:type="gint*"/> </parameter> <parameter name="value_denominator" @@ -59284,7 +59330,7 @@ function returns %FALSE.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1928">a pointer to an int to set</doc> + line="1926">a pointer to an int to set</doc> <type name="gint" c:type="gint*"/> </parameter> </parameters> @@ -59292,14 +59338,14 @@ function returns %FALSE.</doc> <method name="get_int" c:identifier="gst_structure_get_int"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1576">Sets the int pointed to by @value corresponding to the value of the + line="1574">Sets the int pointed to by @value corresponding to the value of the given field. Caller is responsible for making sure the field exists and has the correct type.</doc> <source-position filename="gst/gststructure.h" line="274"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1586">%TRUE if the value could be set correctly. If there was no field + line="1584">%TRUE if the value could be set correctly. If there was no field with @fieldname or the existing field did not contain an int, this function returns %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> @@ -59308,13 +59354,13 @@ returns %FALSE.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1578">a #GstStructure</doc> + line="1576">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1579">the name of a field</doc> + line="1577">the name of a field</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="value" @@ -59323,7 +59369,7 @@ returns %FALSE.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1580">a pointer to an int to set</doc> + line="1578">a pointer to an int to set</doc> <type name="gint" c:type="gint*"/> </parameter> </parameters> @@ -59333,14 +59379,14 @@ returns %FALSE.</doc> version="1.4"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1644">Sets the #gint64 pointed to by @value corresponding to the value of the + line="1642">Sets the #gint64 pointed to by @value corresponding to the value of the given field. Caller is responsible for making sure the field exists and has the correct type.</doc> <source-position filename="gst/gststructure.h" line="282"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1654">%TRUE if the value could be set correctly. If there was no field + line="1652">%TRUE if the value could be set correctly. If there was no field with @fieldname or the existing field did not contain a #gint64, this function returns %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> @@ -59349,13 +59395,13 @@ returns %FALSE.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1646">a #GstStructure</doc> + line="1644">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1647">the name of a field</doc> + line="1645">the name of a field</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="value" @@ -59364,7 +59410,7 @@ returns %FALSE.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1648">a pointer to a #gint64 to set</doc> + line="1646">a pointer to a #gint64 to set</doc> <type name="gint64" c:type="gint64*"/> </parameter> </parameters> @@ -59374,7 +59420,7 @@ returns %FALSE.</doc> version="1.12"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3321">This is useful in language bindings where unknown #GValue types are not + line="3310">This is useful in language bindings where unknown #GValue types are not supported. This function will convert the %GST_TYPE_LIST into a newly allocated GValueArray and return it through @array. Be aware that this is slower then getting the #GValue directly.</doc> @@ -59382,7 +59428,7 @@ slower then getting the #GValue directly.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3332">%TRUE if the value could be set correctly. If there was no field + line="3321">%TRUE if the value could be set correctly. If there was no field with @fieldname or the existing field did not contain a %GST_TYPE_LIST, this function returns %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> @@ -59391,13 +59437,13 @@ function returns %FALSE.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3323">a #GstStructure</doc> + line="3312">a #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3324">the name of a field</doc> + line="3313">the name of a field</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="array" @@ -59406,7 +59452,7 @@ function returns %FALSE.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3325">a pointer to a #GValueArray</doc> + line="3314">a pointer to a #GValueArray</doc> <type name="GObject.ValueArray" c:type="GValueArray**"/> </parameter> </parameters> @@ -59414,19 +59460,19 @@ function returns %FALSE.</doc> <method name="get_name" c:identifier="gst_structure_get_name"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="616">Get the name of @structure as a string.</doc> + line="614">Get the name of @structure as a string.</doc> <source-position filename="gst/gststructure.h" line="144"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="622">the name of the structure.</doc> + line="620">the name of the structure.</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="618">a #GstStructure</doc> + line="616">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> </parameters> @@ -59434,19 +59480,19 @@ function returns %FALSE.</doc> <method name="get_name_id" c:identifier="gst_structure_get_name_id"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="657">Get the name of @structure as a GQuark.</doc> + line="655">Get the name of @structure as a GQuark.</doc> <source-position filename="gst/gststructure.h" line="147"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="663">the quark representing the name of the structure.</doc> + line="661">the quark representing the name of the structure.</doc> <type name="GLib.Quark" c:type="GQuark"/> </return-value> <parameters> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="659">a #GstStructure</doc> + line="657">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> </parameters> @@ -59454,7 +59500,7 @@ function returns %FALSE.</doc> <method name="get_string" c:identifier="gst_structure_get_string"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1853">Finds the field corresponding to @fieldname, and returns the string + line="1851">Finds the field corresponding to @fieldname, and returns the string contained in the field's value. Caller is responsible for making sure the field exists and has the correct type. @@ -59464,7 +59510,7 @@ call to a gst_structure_*() function with the given structure.</doc> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1865">a pointer to the string or %NULL when the + line="1863">a pointer to the string or %NULL when the field did not exist or did not contain a string.</doc> <type name="utf8" c:type="const gchar*"/> </return-value> @@ -59472,13 +59518,13 @@ field did not exist or did not contain a string.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1855">a #GstStructure</doc> + line="1853">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1856">the name of a field</doc> + line="1854">the name of a field</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -59486,14 +59532,14 @@ field did not exist or did not contain a string.</doc> <method name="get_uint" c:identifier="gst_structure_get_uint"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1610">Sets the uint pointed to by @value corresponding to the value of the + line="1608">Sets the uint pointed to by @value corresponding to the value of the given field. Caller is responsible for making sure the field exists and has the correct type.</doc> <source-position filename="gst/gststructure.h" line="278"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1620">%TRUE if the value could be set correctly. If there was no field + line="1618">%TRUE if the value could be set correctly. If there was no field with @fieldname or the existing field did not contain a uint, this function returns %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> @@ -59502,13 +59548,13 @@ returns %FALSE.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1612">a #GstStructure</doc> + line="1610">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1613">the name of a field</doc> + line="1611">the name of a field</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="value" @@ -59517,7 +59563,7 @@ returns %FALSE.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1614">a pointer to a uint to set</doc> + line="1612">a pointer to a uint to set</doc> <type name="guint" c:type="guint*"/> </parameter> </parameters> @@ -59527,14 +59573,14 @@ returns %FALSE.</doc> version="1.4"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1680">Sets the #guint64 pointed to by @value corresponding to the value of the + line="1678">Sets the #guint64 pointed to by @value corresponding to the value of the given field. Caller is responsible for making sure the field exists and has the correct type.</doc> <source-position filename="gst/gststructure.h" line="286"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1690">%TRUE if the value could be set correctly. If there was no field + line="1688">%TRUE if the value could be set correctly. If there was no field with @fieldname or the existing field did not contain a #guint64, this function returns %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> @@ -59543,13 +59589,13 @@ returns %FALSE.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1682">a #GstStructure</doc> + line="1680">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1683">the name of a field</doc> + line="1681">the name of a field</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="value" @@ -59558,7 +59604,7 @@ returns %FALSE.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1684">a pointer to a #guint64 to set</doc> + line="1682">a pointer to a #guint64 to set</doc> <type name="guint64" c:type="guint64*"/> </parameter> </parameters> @@ -59568,33 +59614,33 @@ returns %FALSE.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2802">Parses the variable arguments and reads fields from @structure accordingly. + line="2789">Parses the variable arguments and reads fields from @structure accordingly. valist-variant of gst_structure_get(). Look at the documentation of gst_structure_get() for more details.</doc> <source-position filename="gst/gststructure.h" line="196"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2812">%TRUE, or %FALSE if there was a problem reading any of the fields</doc> + line="2799">%TRUE, or %FALSE if there was a problem reading any of the fields</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2804">a #GstStructure</doc> + line="2791">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="first_fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2805">the name of the first field to read</doc> + line="2792">the name of the first field to read</doc> <type name="utf8" c:type="const char*"/> </parameter> <parameter name="args" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2806">variable arguments</doc> + line="2793">variable arguments</doc> <type name="va_list" c:type="va_list"/> </parameter> </parameters> @@ -59602,12 +59648,12 @@ gst_structure_get() for more details.</doc> <method name="get_value" c:identifier="gst_structure_get_value"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1111">Get the value of the field with name @fieldname.</doc> + line="1109">Get the value of the field with name @fieldname.</doc> <source-position filename="gst/gststructure.h" line="215"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1118">the #GValue corresponding to the field with the given + line="1116">the #GValue corresponding to the field with the given name.</doc> <type name="GObject.Value" c:type="const GValue*"/> </return-value> @@ -59615,13 +59661,13 @@ name.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1113">a #GstStructure</doc> + line="1111">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1114">the name of the field to get</doc> + line="1112">the name of the field to get</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -59629,25 +59675,25 @@ name.</doc> <method name="has_field" c:identifier="gst_structure_has_field"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1474">Check if @structure contains a field named @fieldname.</doc> + line="1472">Check if @structure contains a field named @fieldname.</doc> <source-position filename="gst/gststructure.h" line="260"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1481">%TRUE if the structure contains a field with the given name</doc> + line="1479">%TRUE if the structure contains a field with the given name</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1476">a #GstStructure</doc> + line="1474">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1477">the name of a field</doc> + line="1475">the name of a field</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -59656,31 +59702,31 @@ name.</doc> c:identifier="gst_structure_has_field_typed"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1520">Check if @structure contains a field named @fieldname and with GType @type.</doc> + line="1518">Check if @structure contains a field named @fieldname and with GType @type.</doc> <source-position filename="gst/gststructure.h" line="263"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1528">%TRUE if the structure contains a field with the given name and type</doc> + line="1526">%TRUE if the structure contains a field with the given name and type</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1522">a #GstStructure</doc> + line="1520">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1523">the name of a field</doc> + line="1521">the name of a field</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="type" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1524">the type of a value</doc> + line="1522">the type of a value</doc> <type name="GType" c:type="GType"/> </parameter> </parameters> @@ -59688,25 +59734,25 @@ name.</doc> <method name="has_name" c:identifier="gst_structure_has_name"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="632">Checks if the structure has the given name</doc> + line="630">Checks if the structure has the given name</doc> <source-position filename="gst/gststructure.h" line="150"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="639">%TRUE if @name matches the name of the structure.</doc> + line="637">%TRUE if @name matches the name of the structure.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="634">a #GstStructure</doc> + line="632">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="635">structure name to check for</doc> + line="633">structure name to check for</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -59716,7 +59762,7 @@ name.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2974">Parses the variable arguments and reads fields from @structure accordingly. + line="2961">Parses the variable arguments and reads fields from @structure accordingly. Variable arguments should be in the form field id quark, field type (as a GType), pointer(s) to a variable(s) to hold the return value(s). The last variable argument should be %NULL (technically it should be a @@ -59735,7 +59781,7 @@ release with either g_free() or the suitable function for the boxed type.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2996">%FALSE if there was a problem reading any of the fields (e.g. + line="2983">%FALSE if there was a problem reading any of the fields (e.g. because the field requested did not exist, or was of a type other than the type specified), otherwise %TRUE.</doc> <type name="gboolean" c:type="gboolean"/> @@ -59744,19 +59790,19 @@ release with either g_free() or the suitable function for the boxed type.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2976">a #GstStructure</doc> + line="2963">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="first_field_id" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2977">the quark of the first field to read</doc> + line="2964">the quark of the first field to read</doc> <type name="GLib.Quark" c:type="GQuark"/> </parameter> <parameter name="..." transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2978">variable arguments</doc> + line="2965">variable arguments</doc> <varargs/> </parameter> </parameters> @@ -59766,33 +59812,33 @@ release with either g_free() or the suitable function for the boxed type.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2869">Parses the variable arguments and reads fields from @structure accordingly. + line="2856">Parses the variable arguments and reads fields from @structure accordingly. valist-variant of gst_structure_id_get(). Look at the documentation of gst_structure_id_get() for more details.</doc> <source-position filename="gst/gststructure.h" line="204"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2879">%TRUE, or %FALSE if there was a problem reading any of the fields</doc> + line="2866">%TRUE, or %FALSE if there was a problem reading any of the fields</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2871">a #GstStructure</doc> + line="2858">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="first_field_id" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2872">the quark of the first field to read</doc> + line="2859">the quark of the first field to read</doc> <type name="GLib.Quark" c:type="GQuark"/> </parameter> <parameter name="args" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2873">variable arguments</doc> + line="2860">variable arguments</doc> <type name="va_list" c:type="va_list"/> </parameter> </parameters> @@ -59800,12 +59846,12 @@ gst_structure_id_get() for more details.</doc> <method name="id_get_value" c:identifier="gst_structure_id_get_value"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1137">Get the value of the field with GQuark @field.</doc> + line="1135">Get the value of the field with GQuark @field.</doc> <source-position filename="gst/gststructure.h" line="212"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1144">the #GValue corresponding to the field with the given + line="1142">the #GValue corresponding to the field with the given name identifier.</doc> <type name="GObject.Value" c:type="const GValue*"/> </return-value> @@ -59813,13 +59859,13 @@ name identifier.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1139">a #GstStructure</doc> + line="1137">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="field" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1140">the #GQuark of the field to get</doc> + line="1138">the #GQuark of the field to get</doc> <type name="GLib.Quark" c:type="GQuark"/> </parameter> </parameters> @@ -59827,25 +59873,25 @@ name identifier.</doc> <method name="id_has_field" c:identifier="gst_structure_id_has_field"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1452">Check if @structure contains a field named @field.</doc> + line="1450">Check if @structure contains a field named @field.</doc> <source-position filename="gst/gststructure.h" line="253"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1459">%TRUE if the structure contains a field with the given name</doc> + line="1457">%TRUE if the structure contains a field with the given name</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1454">a #GstStructure</doc> + line="1452">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="field" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1455">#GQuark of the field name</doc> + line="1453">#GQuark of the field name</doc> <type name="GLib.Quark" c:type="GQuark"/> </parameter> </parameters> @@ -59854,31 +59900,31 @@ name identifier.</doc> c:identifier="gst_structure_id_has_field_typed"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1494">Check if @structure contains a field named @field and with GType @type.</doc> + line="1492">Check if @structure contains a field named @field and with GType @type.</doc> <source-position filename="gst/gststructure.h" line="256"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1502">%TRUE if the structure contains a field with the given name and type</doc> + line="1500">%TRUE if the structure contains a field with the given name and type</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1496">a #GstStructure</doc> + line="1494">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="field" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1497">#GQuark of the field name</doc> + line="1495">#GQuark of the field name</doc> <type name="GLib.Quark" c:type="GQuark"/> </parameter> <parameter name="type" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1498">the type of a value</doc> + line="1496">the type of a value</doc> <type name="GType" c:type="GType"/> </parameter> </parameters> @@ -59888,7 +59934,7 @@ name identifier.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="905">Identical to gst_structure_set, except that field names are + line="903">Identical to gst_structure_set, except that field names are passed using the GQuark for the field name. This allows more efficient setting of the structure if the caller already knows the associated quark values. @@ -59901,19 +59947,19 @@ The last variable argument must be %NULL.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="907">a #GstStructure</doc> + line="905">a #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="908">the GQuark for the name of the field to set</doc> + line="906">the GQuark for the name of the field to set</doc> <type name="GLib.Quark" c:type="GQuark"/> </parameter> <parameter name="..." transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="909">variable arguments</doc> + line="907">variable arguments</doc> <varargs/> </parameter> </parameters> @@ -59923,7 +59969,7 @@ The last variable argument must be %NULL.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="929">va_list form of gst_structure_id_set().</doc> + line="927">va_list form of gst_structure_id_set().</doc> <source-position filename="gst/gststructure.h" line="192"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> @@ -59932,19 +59978,19 @@ The last variable argument must be %NULL.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="931">a #GstStructure</doc> + line="929">a #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="932">the name of the field to set</doc> + line="930">the name of the field to set</doc> <type name="GLib.Quark" c:type="GQuark"/> </parameter> <parameter name="varargs" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="933">variable arguments</doc> + line="931">variable arguments</doc> <type name="va_list" c:type="va_list"/> </parameter> </parameters> @@ -59952,7 +59998,7 @@ The last variable argument must be %NULL.</doc> <method name="id_set_value" c:identifier="gst_structure_id_set_value"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="704">Sets the field with the given GQuark @field to @value. If the field + line="702">Sets the field with the given GQuark @field to @value. If the field does not exist, it is created. If the field exists, the previous value is replaced and freed.</doc> <source-position filename="gst/gststructure.h" line="156"/> @@ -59963,19 +60009,19 @@ value is replaced and freed.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="706">a #GstStructure</doc> + line="704">a #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </instance-parameter> <parameter name="field" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="707">a #GQuark representing a field</doc> + line="705">a #GQuark representing a field</doc> <type name="GLib.Quark" c:type="GQuark"/> </parameter> <parameter name="value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="708">the new value of the field</doc> + line="706">the new value of the field</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> </parameters> @@ -59983,7 +60029,7 @@ value is replaced and freed.</doc> <method name="id_take_value" c:identifier="gst_structure_id_take_value"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="768">Sets the field with the given GQuark @field to @value. If the field + line="766">Sets the field with the given GQuark @field to @value. If the field does not exist, it is created. If the field exists, the previous value is replaced and freed.</doc> <source-position filename="gst/gststructure.h" line="172"/> @@ -59994,19 +60040,19 @@ value is replaced and freed.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="770">a #GstStructure</doc> + line="768">a #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </instance-parameter> <parameter name="field" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="771">a #GQuark representing a field</doc> + line="769">a #GQuark representing a field</doc> <type name="GLib.Quark" c:type="GQuark"/> </parameter> <parameter name="value" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="772">the new value of the field</doc> + line="770">the new value of the field</doc> <type name="GObject.Value" c:type="GValue*"/> </parameter> </parameters> @@ -60014,25 +60060,25 @@ value is replaced and freed.</doc> <method name="intersect" c:identifier="gst_structure_intersect"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3063">Intersects @struct1 and @struct2 and returns the intersection.</doc> + line="3050">Intersects @struct1 and @struct2 and returns the intersection.</doc> <source-position filename="gst/gststructure.h" line="374"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3070">Intersection of @struct1 and @struct2</doc> + line="3057">Intersection of @struct1 and @struct2</doc> <type name="Structure" c:type="GstStructure*"/> </return-value> <parameters> <instance-parameter name="struct1" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3065">a #GstStructure</doc> + line="3052">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="struct2" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3066">a #GstStructure</doc> + line="3053">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </parameter> </parameters> @@ -60040,25 +60086,25 @@ value is replaced and freed.</doc> <method name="is_equal" c:identifier="gst_structure_is_equal"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3033">Tests if the two #GstStructure are equal.</doc> + line="3020">Tests if the two #GstStructure are equal.</doc> <source-position filename="gst/gststructure.h" line="365"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3040">%TRUE if the two structures have the same name and field.</doc> + line="3027">%TRUE if the two structures have the same name and field.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="structure1" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3035">a #GstStructure.</doc> + line="3022">a #GstStructure.</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="structure2" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3036">a #GstStructure.</doc> + line="3023">a #GstStructure.</doc> <type name="Structure" c:type="const GstStructure*"/> </parameter> </parameters> @@ -60066,27 +60112,27 @@ value is replaced and freed.</doc> <method name="is_subset" c:identifier="gst_structure_is_subset"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3193">Checks if @subset is a subset of @superset, i.e. has the same + line="3180">Checks if @subset is a subset of @superset, i.e. has the same structure name and for all fields that are existing in @superset, @subset has a value that is a subset of the value in @superset.</doc> <source-position filename="gst/gststructure.h" line="368"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3202">%TRUE if @subset is a subset of @superset</doc> + line="3189">%TRUE if @subset is a subset of @superset</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="subset" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3195">a #GstStructure</doc> + line="3182">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="superset" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3196">a potentially greater #GstStructure</doc> + line="3183">a potentially greater #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </parameter> </parameters> @@ -60094,14 +60140,14 @@ structure name and for all fields that are existing in @superset, <method name="map_in_place" c:identifier="gst_structure_map_in_place"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1371">Calls the provided function once for each field in the #GstStructure. In + line="1369">Calls the provided function once for each field in the #GstStructure. In contrast to gst_structure_foreach(), the function may modify but not delete the fields. The structure must be mutable.</doc> <source-position filename="gst/gststructure.h" line="239"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1381">%TRUE if the supplied function returns %TRUE For each of the fields, + line="1379">%TRUE if the supplied function returns %TRUE For each of the fields, %FALSE otherwise.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -60109,7 +60155,7 @@ fields. The structure must be mutable.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1373">a #GstStructure</doc> + line="1371">a #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </instance-parameter> <parameter name="func" @@ -60118,7 +60164,7 @@ fields. The structure must be mutable.</doc> closure="1"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1374">a function to call for each field</doc> + line="1372">a function to call for each field</doc> <type name="StructureMapFunc" c:type="GstStructureMapFunc"/> </parameter> <parameter name="user_data" @@ -60127,7 +60173,7 @@ fields. The structure must be mutable.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1375">private data</doc> + line="1373">private data</doc> <type name="gpointer" c:type="gpointer"/> </parameter> </parameters> @@ -60135,19 +60181,19 @@ fields. The structure must be mutable.</doc> <method name="n_fields" c:identifier="gst_structure_n_fields"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1296">Get the number of fields in the structure.</doc> + line="1294">Get the number of fields in the structure.</doc> <source-position filename="gst/gststructure.h" line="247"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1302">the number of fields in the structure</doc> + line="1300">the number of fields in the structure</doc> <type name="gint" c:type="gint"/> </return-value> <parameters> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1298">a #GstStructure</doc> + line="1296">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> </parameters> @@ -60156,25 +60202,25 @@ fields. The structure must be mutable.</doc> c:identifier="gst_structure_nth_field_name"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1312">Get the name of the given field number, counting from 0 onwards.</doc> + line="1310">Get the name of the given field number, counting from 0 onwards.</doc> <source-position filename="gst/gststructure.h" line="250"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1319">the name of the given field number</doc> + line="1317">the name of the given field number</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1314">a #GstStructure</doc> + line="1312">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> <parameter name="index" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1315">the index to get the name of</doc> + line="1313">the index to get the name of</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -60183,7 +60229,7 @@ fields. The structure must be mutable.</doc> c:identifier="gst_structure_remove_all_fields"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1244">Removes all fields in a GstStructure.</doc> + line="1242">Removes all fields in a GstStructure.</doc> <source-position filename="gst/gststructure.h" line="229"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> @@ -60192,7 +60238,7 @@ fields. The structure must be mutable.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1246">a #GstStructure</doc> + line="1244">a #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </instance-parameter> </parameters> @@ -60200,7 +60246,7 @@ fields. The structure must be mutable.</doc> <method name="remove_field" c:identifier="gst_structure_remove_field"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1161">Removes the field with the given name. If the field with the given + line="1159">Removes the field with the given name. If the field with the given name does not exist, the structure is unchanged.</doc> <source-position filename="gst/gststructure.h" line="218"/> <return-value transfer-ownership="none"> @@ -60210,13 +60256,13 @@ name does not exist, the structure is unchanged.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1163">a #GstStructure</doc> + line="1161">a #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1164">the name of the field to remove</doc> + line="1162">the name of the field to remove</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -60226,7 +60272,7 @@ name does not exist, the structure is unchanged.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1196">Removes the fields with the given names. If a field does not exist, the + line="1194">Removes the fields with the given names. If a field does not exist, the argument is ignored.</doc> <source-position filename="gst/gststructure.h" line="221"/> <return-value transfer-ownership="none"> @@ -60236,19 +60282,19 @@ argument is ignored.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1198">a #GstStructure</doc> + line="1196">a #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1199">the name of the field to remove</doc> + line="1197">the name of the field to remove</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="..." transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1200">%NULL-terminated list of more fieldnames to remove</doc> + line="1198">%NULL-terminated list of more fieldnames to remove</doc> <varargs/> </parameter> </parameters> @@ -60258,7 +60304,7 @@ argument is ignored.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1220">va_list form of gst_structure_remove_fields().</doc> + line="1218">va_list form of gst_structure_remove_fields().</doc> <source-position filename="gst/gststructure.h" line="225"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> @@ -60267,19 +60313,19 @@ argument is ignored.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1222">a #GstStructure</doc> + line="1220">a #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1223">the name of the field to remove</doc> + line="1221">the name of the field to remove</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="varargs" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="1224">%NULL-terminated list of more fieldnames to remove</doc> + line="1222">%NULL-terminated list of more fieldnames to remove</doc> <type name="va_list" c:type="va_list"/> </parameter> </parameters> @@ -60287,7 +60333,7 @@ argument is ignored.</doc> <method name="set" c:identifier="gst_structure_set" introspectable="0"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="838">Parses the variable arguments and sets fields accordingly. Fields that + line="836">Parses the variable arguments and sets fields accordingly. Fields that weren't already part of the structure are added as needed. Variable arguments should be in the form field name, field type (as a GType), value(s). The last variable argument should be %NULL.</doc> @@ -60299,19 +60345,19 @@ Variable arguments should be in the form field name, field type <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="840">a #GstStructure</doc> + line="838">a #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="841">the name of the field to set</doc> + line="839">the name of the field to set</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="..." transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="842">variable arguments</doc> + line="840">variable arguments</doc> <varargs/> </parameter> </parameters> @@ -60321,7 +60367,7 @@ Variable arguments should be in the form field name, field type version="1.12"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3373">This is useful in language bindings where unknown GValue types are not + line="3362">This is useful in language bindings where unknown GValue types are not supported. This function will convert a @array to %GST_TYPE_ARRAY and set the field specified by @fieldname. Be aware that this is slower then using %GST_TYPE_ARRAY in a #GValue directly.</doc> @@ -60333,19 +60379,19 @@ the field specified by @fieldname. Be aware that this is slower then using <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3375">a #GstStructure</doc> + line="3364">a #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3376">the name of a field</doc> + line="3365">the name of a field</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="array" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3377">a pointer to a #GValueArray</doc> + line="3366">a pointer to a #GValueArray</doc> <type name="GObject.ValueArray" c:type="const GValueArray*"/> </parameter> </parameters> @@ -60355,7 +60401,7 @@ the field specified by @fieldname. Be aware that this is slower then using version="1.12"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3393">This is useful in language bindings where unknown GValue types are not + line="3382">This is useful in language bindings where unknown GValue types are not supported. This function will convert a @array to %GST_TYPE_LIST and set the field specified by @fieldname. Be aware that this is slower then using %GST_TYPE_LIST in a #GValue directly.</doc> @@ -60367,19 +60413,19 @@ the field specified by @fieldname. Be aware that this is slower then using <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3395">a #GstStructure</doc> + line="3384">a #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3396">the name of a field</doc> + line="3385">the name of a field</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="array" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="3397">a pointer to a #GValueArray</doc> + line="3386">a pointer to a #GValueArray</doc> <type name="GObject.ValueArray" c:type="const GValueArray*"/> </parameter> </parameters> @@ -60387,7 +60433,7 @@ the field specified by @fieldname. Be aware that this is slower then using <method name="set_name" c:identifier="gst_structure_set_name"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="673">Sets the name of the structure to the given @name. The string + line="671">Sets the name of the structure to the given @name. The string provided is copied before being used. It must not be empty, start with a letter and can be followed by letters, numbers and any of "/-_.:".</doc> <source-position filename="gst/gststructure.h" line="153"/> @@ -60398,13 +60444,13 @@ letter and can be followed by letters, numbers and any of "/-_.:".</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="675">a #GstStructure</doc> + line="673">a #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </instance-parameter> <parameter name="name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="676">the new name of the structure</doc> + line="674">the new name of the structure</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -60413,7 +60459,7 @@ letter and can be followed by letters, numbers and any of "/-_.:".</doc> c:identifier="gst_structure_set_parent_refcount"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="443">Sets the parent_refcount field of #GstStructure. This field is used to + line="441">Sets the parent_refcount field of #GstStructure. This field is used to determine whether a structure is mutable or not. This function should only be called by code implementing parent objects of #GstStructure, as described in the MT Refcounting section of the design documents.</doc> @@ -60421,20 +60467,20 @@ the MT Refcounting section of the design documents.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="453">%TRUE if the parent refcount could be set.</doc> + line="451">%TRUE if the parent refcount could be set.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="445">a #GstStructure</doc> + line="443">a #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </instance-parameter> <parameter name="refcount" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="446">a pointer to the parent's refcount</doc> + line="444">a pointer to the parent's refcount</doc> <type name="gint" c:type="gint*"/> </parameter> </parameters> @@ -60444,7 +60490,7 @@ the MT Refcounting section of the design documents.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="862">va_list form of gst_structure_set().</doc> + line="860">va_list form of gst_structure_set().</doc> <source-position filename="gst/gststructure.h" line="184"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> @@ -60453,19 +60499,19 @@ the MT Refcounting section of the design documents.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="864">a #GstStructure</doc> + line="862">a #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="865">the name of the field to set</doc> + line="863">the name of the field to set</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="varargs" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="866">variable arguments</doc> + line="864">variable arguments</doc> <type name="va_list" c:type="va_list"/> </parameter> </parameters> @@ -60473,7 +60519,7 @@ the MT Refcounting section of the design documents.</doc> <method name="set_value" c:identifier="gst_structure_set_value"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="726">Sets the field with the given name @field to @value. If the field + line="724">Sets the field with the given name @field to @value. If the field does not exist, it is created. If the field exists, the previous value is replaced and freed.</doc> <source-position filename="gst/gststructure.h" line="160"/> @@ -60484,19 +60530,19 @@ value is replaced and freed.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="728">a #GstStructure</doc> + line="726">a #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="729">the name of the field to set</doc> + line="727">the name of the field to set</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="730">the new value of the field</doc> + line="728">the new value of the field</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> </parameters> @@ -60504,7 +60550,7 @@ value is replaced and freed.</doc> <method name="take_value" c:identifier="gst_structure_take_value"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="789">Sets the field with the given name @field to @value. If the field + line="787">Sets the field with the given name @field to @value. If the field does not exist, it is created. If the field exists, the previous value is replaced and freed. The function will take ownership of @value.</doc> <source-position filename="gst/gststructure.h" line="176"/> @@ -60515,19 +60561,19 @@ value is replaced and freed. The function will take ownership of @value.</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="791">a #GstStructure</doc> + line="789">a #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="792">the name of the field to set</doc> + line="790">the name of the field to set</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="value" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="793">the new value of the field</doc> + line="791">the new value of the field</doc> <type name="GObject.Value" c:type="GValue*"/> </parameter> </parameters> @@ -60535,7 +60581,7 @@ value is replaced and freed. The function will take ownership of @value.</doc> <method name="to_string" c:identifier="gst_structure_to_string"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2132">Converts @structure to a human-readable string representation. + line="2130">Converts @structure to a human-readable string representation. For debugging purposes its easier to do something like this: |[<!-- language="C" --> @@ -60551,7 +60597,7 @@ Free-function: g_free</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2149">a pointer to string allocated by g_malloc(). + line="2147">a pointer to string allocated by g_malloc(). g_free() after usage.</doc> <type name="utf8" c:type="gchar*"/> </return-value> @@ -60559,7 +60605,7 @@ Free-function: g_free</doc> <instance-parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="2134">a #GstStructure</doc> + line="2132">a #GstStructure</doc> <type name="Structure" c:type="const GstStructure*"/> </instance-parameter> </parameters> @@ -60567,7 +60613,7 @@ Free-function: g_free</doc> <function name="take" c:identifier="gst_structure_take" version="1.18"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="575">Atomically modifies a pointer to point to a new structure. + line="573">Atomically modifies a pointer to point to a new structure. The #GstStructure @oldstr_ptr is pointing to is freed and @newstr is taken ownership over. @@ -60579,7 +60625,7 @@ It is a programming error if both @newstr and the value pointed to by <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="590">%TRUE if @newstr was different from @oldstr_ptr</doc> + line="588">%TRUE if @newstr was different from @oldstr_ptr</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> @@ -60591,7 +60637,7 @@ It is a programming error if both @newstr and the value pointed to by allow-none="1"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="577">pointer to a place of + line="575">pointer to a place of a #GstStructure to take</doc> <type name="Structure" c:type="GstStructure**"/> </parameter> @@ -60601,7 +60647,7 @@ It is a programming error if both @newstr and the value pointed to by allow-none="1"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="579">a new #GstStructure</doc> + line="577">a new #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </parameter> </parameters> @@ -60768,14 +60814,14 @@ wait operations.</doc> <function name="obtain" c:identifier="gst_system_clock_obtain"> <doc xml:space="preserve" filename="gst/gstsystemclock.c" - line="607">Get a handle to the default system clock. The refcount of the + line="602">Get a handle to the default system clock. The refcount of the clock will be increased so you need to unref the clock after usage.</doc> <source-position filename="gst/gstsystemclock.h" line="88"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstsystemclock.c" - line="614">the default clock. + line="609">the default clock. MT safe.</doc> <type name="Clock" c:type="GstClock*"/> @@ -60786,7 +60832,7 @@ MT safe.</doc> version="1.4"> <doc xml:space="preserve" filename="gst/gstsystemclock.c" - line="568">Sets the default system clock that can be obtained with + line="563">Sets the default system clock that can be obtained with gst_system_clock_obtain(). This is mostly used for testing and debugging purposes when you @@ -60805,7 +60851,7 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstsystemclock.c" - line="570">a #GstClock</doc> + line="565">a #GstClock</doc> <type name="Clock" c:type="GstClock*"/> </parameter> </parameters> @@ -60846,10 +60892,10 @@ MT safe.</doc> <constant name="TAG_ALBUM" value="album" c:type="GST_TAG_ALBUM"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="593">album containing this data (string) + line="575">album containing this data (string) The album name as it should be displayed, e.g. 'The Jazz Guitar'</doc> - <source-position filename="gst/gsttaglist.h" line="600"/> + <source-position filename="gst/gsttaglist.h" line="582"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_ALBUM_ARTIST" @@ -60857,8 +60903,8 @@ The album name as it should be displayed, e.g. 'The Jazz Guitar'</doc> c:type="GST_TAG_ALBUM_ARTIST"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="609">The artist of the entire album, as it should be displayed.</doc> - <source-position filename="gst/gsttaglist.h" line="614"/> + line="591">The artist of the entire album, as it should be displayed.</doc> + <source-position filename="gst/gsttaglist.h" line="596"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_ALBUM_ARTIST_SORTNAME" @@ -60866,8 +60912,8 @@ The album name as it should be displayed, e.g. 'The Jazz Guitar'</doc> c:type="GST_TAG_ALBUM_ARTIST_SORTNAME"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="615">The artist of the entire album, as it should be sorted.</doc> - <source-position filename="gst/gsttaglist.h" line="620"/> + line="597">The artist of the entire album, as it should be sorted.</doc> + <source-position filename="gst/gsttaglist.h" line="602"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_ALBUM_GAIN" @@ -60875,8 +60921,8 @@ The album name as it should be displayed, e.g. 'The Jazz Guitar'</doc> c:type="GST_TAG_ALBUM_GAIN"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="871">album gain in db (double)</doc> - <source-position filename="gst/gsttaglist.h" line="876"/> + line="853">album gain in db (double)</doc> + <source-position filename="gst/gsttaglist.h" line="858"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_ALBUM_PEAK" @@ -60884,8 +60930,8 @@ The album name as it should be displayed, e.g. 'The Jazz Guitar'</doc> c:type="GST_TAG_ALBUM_PEAK"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="877">peak of the album (double)</doc> - <source-position filename="gst/gsttaglist.h" line="882"/> + line="859">peak of the album (double)</doc> + <source-position filename="gst/gsttaglist.h" line="864"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_ALBUM_SORTNAME" @@ -60893,10 +60939,10 @@ The album name as it should be displayed, e.g. 'The Jazz Guitar'</doc> c:type="GST_TAG_ALBUM_SORTNAME"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="601">album containing this data, as used for sorting (string) + line="583">album containing this data, as used for sorting (string) The album name as it should be sorted, e.g. 'Jazz Guitar, The'</doc> - <source-position filename="gst/gsttaglist.h" line="608"/> + <source-position filename="gst/gsttaglist.h" line="590"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_ALBUM_VOLUME_COUNT" @@ -60904,8 +60950,8 @@ The album name as it should be sorted, e.g. 'Jazz Guitar, The'</doc> c:type="GST_TAG_ALBUM_VOLUME_COUNT"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="690">count of discs inside collection this disc belongs to (unsigned integer)</doc> - <source-position filename="gst/gsttaglist.h" line="695"/> + line="672">count of discs inside collection this disc belongs to (unsigned integer)</doc> + <source-position filename="gst/gsttaglist.h" line="677"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_ALBUM_VOLUME_NUMBER" @@ -60913,8 +60959,8 @@ The album name as it should be sorted, e.g. 'Jazz Guitar, The'</doc> c:type="GST_TAG_ALBUM_VOLUME_NUMBER"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="684">disc number inside a collection (unsigned integer)</doc> - <source-position filename="gst/gsttaglist.h" line="689"/> + line="666">disc number inside a collection (unsigned integer)</doc> + <source-position filename="gst/gsttaglist.h" line="671"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_APPLICATION_DATA" @@ -60922,11 +60968,11 @@ The album name as it should be sorted, e.g. 'Jazz Guitar, The'</doc> c:type="GST_TAG_APPLICATION_DATA"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="1106">Arbitrary application data (sample) + line="1088">Arbitrary application data (sample) Some formats allow applications to add their own arbitrary data into files. This data is application dependent.</doc> - <source-position filename="gst/gsttaglist.h" line="1114"/> + <source-position filename="gst/gsttaglist.h" line="1096"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_APPLICATION_NAME" @@ -60934,18 +60980,18 @@ into files. This data is application dependent.</doc> c:type="GST_TAG_APPLICATION_NAME"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="1100">Name of the application used to create the media (string)</doc> - <source-position filename="gst/gsttaglist.h" line="1105"/> + line="1082">Name of the application used to create the media (string)</doc> + <source-position filename="gst/gsttaglist.h" line="1087"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_ARTIST" value="artist" c:type="GST_TAG_ARTIST"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="575">person(s) responsible for the recording (string) + line="557">person(s) responsible for the recording (string) The artist name as it should be displayed, e.g. 'Jimi Hendrix' or 'The Guitar Heroes'</doc> - <source-position filename="gst/gsttaglist.h" line="583"/> + <source-position filename="gst/gsttaglist.h" line="565"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_ARTIST_SORTNAME" @@ -60953,11 +60999,11 @@ The artist name as it should be displayed, e.g. 'Jimi Hendrix' or c:type="GST_TAG_ARTIST_SORTNAME"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="584">person(s) responsible for the recording, as used for sorting (string) + line="566">person(s) responsible for the recording, as used for sorting (string) The artist name as it should be sorted, e.g. 'Hendrix, Jimi' or 'Guitar Heroes, The'</doc> - <source-position filename="gst/gsttaglist.h" line="592"/> + <source-position filename="gst/gsttaglist.h" line="574"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_ATTACHMENT" @@ -60965,10 +61011,10 @@ The artist name as it should be sorted, e.g. 'Hendrix, Jimi' or c:type="GST_TAG_ATTACHMENT"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="923">generic file attachment (sample) (sample taglist should specify the content + line="905">generic file attachment (sample) (sample taglist should specify the content type and if possible set "filename" to the file name of the attachment)</doc> - <source-position filename="gst/gsttaglist.h" line="930"/> + <source-position filename="gst/gsttaglist.h" line="912"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_AUDIO_CODEC" @@ -60976,8 +61022,8 @@ attachment)</doc> c:type="GST_TAG_AUDIO_CODEC"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="798">codec the audio data is stored in (string)</doc> - <source-position filename="gst/gsttaglist.h" line="803"/> + line="780">codec the audio data is stored in (string)</doc> + <source-position filename="gst/gsttaglist.h" line="785"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_BEATS_PER_MINUTE" @@ -60985,36 +61031,36 @@ attachment)</doc> c:type="GST_TAG_BEATS_PER_MINUTE"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="932">number of beats per minute in audio (double)</doc> - <source-position filename="gst/gsttaglist.h" line="937"/> + line="914">number of beats per minute in audio (double)</doc> + <source-position filename="gst/gsttaglist.h" line="919"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_BITRATE" value="bitrate" c:type="GST_TAG_BITRATE"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="816">exact or average bitrate in bits/s (unsigned integer)</doc> - <source-position filename="gst/gsttaglist.h" line="821"/> + line="798">exact or average bitrate in bits/s (unsigned integer)</doc> + <source-position filename="gst/gsttaglist.h" line="803"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_CODEC" value="codec" c:type="GST_TAG_CODEC"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="786">codec the data is stored in (string)</doc> - <source-position filename="gst/gsttaglist.h" line="791"/> + line="768">codec the data is stored in (string)</doc> + <source-position filename="gst/gsttaglist.h" line="773"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_COMMENT" value="comment" c:type="GST_TAG_COMMENT"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="653">free text commenting the data (string)</doc> - <source-position filename="gst/gsttaglist.h" line="658"/> + line="635">free text commenting the data (string)</doc> + <source-position filename="gst/gsttaglist.h" line="640"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_COMPOSER" value="composer" c:type="GST_TAG_COMPOSER"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="621">person(s) who composed the recording (string)</doc> - <source-position filename="gst/gsttaglist.h" line="626"/> + line="603">person(s) who composed the recording (string)</doc> + <source-position filename="gst/gsttaglist.h" line="608"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_COMPOSER_SORTNAME" @@ -61022,8 +61068,8 @@ attachment)</doc> c:type="GST_TAG_COMPOSER_SORTNAME"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="1067">The composer's name, used for sorting (string)</doc> - <source-position filename="gst/gsttaglist.h" line="1072"/> + line="1049">The composer's name, used for sorting (string)</doc> + <source-position filename="gst/gsttaglist.h" line="1054"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_CONDUCTOR" @@ -61032,15 +61078,15 @@ attachment)</doc> version="1.8"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="627">conductor/performer refinement (string)</doc> - <source-position filename="gst/gsttaglist.h" line="634"/> + line="609">conductor/performer refinement (string)</doc> + <source-position filename="gst/gsttaglist.h" line="616"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_CONTACT" value="contact" c:type="GST_TAG_CONTACT"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="756">contact information (string)</doc> - <source-position filename="gst/gsttaglist.h" line="761"/> + line="738">contact information (string)</doc> + <source-position filename="gst/gsttaglist.h" line="743"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_CONTAINER_FORMAT" @@ -61048,8 +61094,8 @@ attachment)</doc> c:type="GST_TAG_CONTAINER_FORMAT"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="810">container format the data is stored in (string)</doc> - <source-position filename="gst/gsttaglist.h" line="815"/> + line="792">container format the data is stored in (string)</doc> + <source-position filename="gst/gsttaglist.h" line="797"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_COPYRIGHT" @@ -61057,8 +61103,8 @@ attachment)</doc> c:type="GST_TAG_COPYRIGHT"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="733">copyright notice of the data (string)</doc> - <source-position filename="gst/gsttaglist.h" line="738"/> + line="715">copyright notice of the data (string)</doc> + <source-position filename="gst/gsttaglist.h" line="720"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_COPYRIGHT_URI" @@ -61066,22 +61112,22 @@ attachment)</doc> c:type="GST_TAG_COPYRIGHT_URI"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="739">URI to location where copyright details can be found (string)</doc> - <source-position filename="gst/gsttaglist.h" line="744"/> + line="721">URI to location where copyright details can be found (string)</doc> + <source-position filename="gst/gsttaglist.h" line="726"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_DATE" value="date" c:type="GST_TAG_DATE"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="635">date the data was created (#GDate structure)</doc> - <source-position filename="gst/gsttaglist.h" line="640"/> + line="617">date the data was created (#GDate structure)</doc> + <source-position filename="gst/gsttaglist.h" line="622"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_DATE_TIME" value="datetime" c:type="GST_TAG_DATE_TIME"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="641">date and time the data was created (#GstDateTime structure)</doc> - <source-position filename="gst/gsttaglist.h" line="646"/> + line="623">date and time the data was created (#GstDateTime structure)</doc> + <source-position filename="gst/gsttaglist.h" line="628"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_DESCRIPTION" @@ -61089,8 +61135,8 @@ attachment)</doc> c:type="GST_TAG_DESCRIPTION"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="709">short text describing the content of the data (string)</doc> - <source-position filename="gst/gsttaglist.h" line="714"/> + line="691">short text describing the content of the data (string)</doc> + <source-position filename="gst/gsttaglist.h" line="696"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_DEVICE_MANUFACTURER" @@ -61098,8 +61144,8 @@ attachment)</doc> c:type="GST_TAG_DEVICE_MANUFACTURER"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="1088">Manufacturer of the device used to create the media (string)</doc> - <source-position filename="gst/gsttaglist.h" line="1093"/> + line="1070">Manufacturer of the device used to create the media (string)</doc> + <source-position filename="gst/gsttaglist.h" line="1075"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_DEVICE_MODEL" @@ -61107,15 +61153,15 @@ attachment)</doc> c:type="GST_TAG_DEVICE_MODEL"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="1094">Model of the device used to create the media (string)</doc> - <source-position filename="gst/gsttaglist.h" line="1099"/> + line="1076">Model of the device used to create the media (string)</doc> + <source-position filename="gst/gsttaglist.h" line="1081"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_DURATION" value="duration" c:type="GST_TAG_DURATION"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="780">length in GStreamer time units (nanoseconds) (unsigned 64-bit integer)</doc> - <source-position filename="gst/gsttaglist.h" line="785"/> + line="762">length in GStreamer time units (nanoseconds) (unsigned 64-bit integer)</doc> + <source-position filename="gst/gsttaglist.h" line="767"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_ENCODED_BY" @@ -61123,20 +61169,20 @@ attachment)</doc> c:type="GST_TAG_ENCODED_BY"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="745">name of the person or organisation that encoded the file. May contain a + line="727">name of the person or organisation that encoded the file. May contain a copyright message if the person or organisation also holds the copyright (string) Note: do not use this field to describe the encoding application. Use #GST_TAG_APPLICATION_NAME or #GST_TAG_COMMENT for that.</doc> - <source-position filename="gst/gsttaglist.h" line="755"/> + <source-position filename="gst/gsttaglist.h" line="737"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_ENCODER" value="encoder" c:type="GST_TAG_ENCODER"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="847">encoder used to encode this stream (string)</doc> - <source-position filename="gst/gsttaglist.h" line="852"/> + line="829">encoder used to encode this stream (string)</doc> + <source-position filename="gst/gsttaglist.h" line="834"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_ENCODER_VERSION" @@ -61144,8 +61190,8 @@ Note: do not use this field to describe the encoding application. Use c:type="GST_TAG_ENCODER_VERSION"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="853">version of the encoder used to encode this stream (unsigned integer)</doc> - <source-position filename="gst/gsttaglist.h" line="858"/> + line="835">version of the encoder used to encode this stream (unsigned integer)</doc> + <source-position filename="gst/gsttaglist.h" line="840"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_EXTENDED_COMMENT" @@ -61153,7 +61199,7 @@ Note: do not use this field to describe the encoding application. Use c:type="GST_TAG_EXTENDED_COMMENT"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="659">key/value text commenting the data (string) + line="641">key/value text commenting the data (string) Must be in the form of 'key=comment' or 'key[lc]=comment' where 'lc' is an ISO-639 @@ -61161,7 +61207,7 @@ language code. This tag is used for unknown Vorbis comment tags, unknown APE tags and certain ID3v2 comment fields.</doc> - <source-position filename="gst/gsttaglist.h" line="671"/> + <source-position filename="gst/gsttaglist.h" line="653"/> <type name="utf8" c:type="gchar*"/> </constant> <function-macro name="TAG_FLAG_IS_VALID" @@ -61176,8 +61222,8 @@ unknown APE tags and certain ID3v2 comment fields.</doc> <constant name="TAG_GENRE" value="genre" c:type="GST_TAG_GENRE"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="647">genre this data belongs to (string)</doc> - <source-position filename="gst/gsttaglist.h" line="652"/> + line="629">genre this data belongs to (string)</doc> + <source-position filename="gst/gsttaglist.h" line="634"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_GEO_LOCATION_CAPTURE_DIRECTION" @@ -61185,12 +61231,12 @@ unknown APE tags and certain ID3v2 comment fields.</doc> c:type="GST_TAG_GEO_LOCATION_CAPTURE_DIRECTION"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="1027">Indicates the direction the device is pointing to when capturing + line="1009">Indicates the direction the device is pointing to when capturing a media. It is represented as degrees in floating point representation, 0 means the geographic north, and increases clockwise (double from 0 to 360) See also #GST_TAG_GEO_LOCATION_MOVEMENT_DIRECTION</doc> - <source-position filename="gst/gsttaglist.h" line="1036"/> + <source-position filename="gst/gsttaglist.h" line="1018"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_GEO_LOCATION_CITY" @@ -61198,8 +61244,8 @@ See also #GST_TAG_GEO_LOCATION_MOVEMENT_DIRECTION</doc> c:type="GST_TAG_GEO_LOCATION_CITY"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="985">The city (english name) where the media has been produced (string).</doc> - <source-position filename="gst/gsttaglist.h" line="990"/> + line="967">The city (english name) where the media has been produced (string).</doc> + <source-position filename="gst/gsttaglist.h" line="972"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_GEO_LOCATION_COUNTRY" @@ -61207,8 +61253,8 @@ See also #GST_TAG_GEO_LOCATION_MOVEMENT_DIRECTION</doc> c:type="GST_TAG_GEO_LOCATION_COUNTRY"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="979">The country (english name) where the media has been produced (string).</doc> - <source-position filename="gst/gsttaglist.h" line="984"/> + line="961">The country (english name) where the media has been produced (string).</doc> + <source-position filename="gst/gsttaglist.h" line="966"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_GEO_LOCATION_ELEVATION" @@ -61216,9 +61262,9 @@ See also #GST_TAG_GEO_LOCATION_MOVEMENT_DIRECTION</doc> c:type="GST_TAG_GEO_LOCATION_ELEVATION"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="972">geo elevation of where the media has been recorded or produced in meters + line="954">geo elevation of where the media has been recorded or produced in meters according to WGS84 (zero is average sea level) (double).</doc> - <source-position filename="gst/gsttaglist.h" line="978"/> + <source-position filename="gst/gsttaglist.h" line="960"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_GEO_LOCATION_HORIZONTAL_ERROR" @@ -61226,9 +61272,9 @@ according to WGS84 (zero is average sea level) (double).</doc> c:type="GST_TAG_GEO_LOCATION_HORIZONTAL_ERROR"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="1001">Represents the expected error on the horizontal positioning in + line="983">Represents the expected error on the horizontal positioning in meters (double).</doc> - <source-position filename="gst/gsttaglist.h" line="1007"/> + <source-position filename="gst/gsttaglist.h" line="989"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_GEO_LOCATION_LATITUDE" @@ -61236,10 +61282,10 @@ meters (double).</doc> c:type="GST_TAG_GEO_LOCATION_LATITUDE"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="954">geo latitude location of where the media has been recorded or produced in + line="936">geo latitude location of where the media has been recorded or produced in degrees according to WGS84 (zero at the equator, negative values for southern latitudes) (double).</doc> - <source-position filename="gst/gsttaglist.h" line="961"/> + <source-position filename="gst/gsttaglist.h" line="943"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_GEO_LOCATION_LONGITUDE" @@ -61247,10 +61293,10 @@ latitudes) (double).</doc> c:type="GST_TAG_GEO_LOCATION_LONGITUDE"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="963">geo longitude location of where the media has been recorded or produced in + line="945">geo longitude location of where the media has been recorded or produced in degrees according to WGS84 (zero at the prime meridian in Greenwich/UK, negative values for western longitudes). (double).</doc> - <source-position filename="gst/gsttaglist.h" line="970"/> + <source-position filename="gst/gsttaglist.h" line="952"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_GEO_LOCATION_MOVEMENT_DIRECTION" @@ -61258,12 +61304,12 @@ negative values for western longitudes). (double).</doc> c:type="GST_TAG_GEO_LOCATION_MOVEMENT_DIRECTION"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="1017">Indicates the movement direction of the device performing the capture + line="999">Indicates the movement direction of the device performing the capture of a media. It is represented as degrees in floating point representation, 0 means the geographic north, and increases clockwise (double from 0 to 360) See also #GST_TAG_GEO_LOCATION_CAPTURE_DIRECTION</doc> - <source-position filename="gst/gsttaglist.h" line="1026"/> + <source-position filename="gst/gsttaglist.h" line="1008"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_GEO_LOCATION_MOVEMENT_SPEED" @@ -61271,11 +61317,11 @@ See also #GST_TAG_GEO_LOCATION_CAPTURE_DIRECTION</doc> c:type="GST_TAG_GEO_LOCATION_MOVEMENT_SPEED"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="1008">Speed of the capturing device when performing the capture. + line="990">Speed of the capturing device when performing the capture. Represented in m/s. (double) See also #GST_TAG_GEO_LOCATION_MOVEMENT_DIRECTION</doc> - <source-position filename="gst/gsttaglist.h" line="1016"/> + <source-position filename="gst/gsttaglist.h" line="998"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_GEO_LOCATION_NAME" @@ -61283,9 +61329,9 @@ See also #GST_TAG_GEO_LOCATION_MOVEMENT_DIRECTION</doc> c:type="GST_TAG_GEO_LOCATION_NAME"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="946">human readable descriptive location of where the media has been recorded or + line="928">human readable descriptive location of where the media has been recorded or produced. (string).</doc> - <source-position filename="gst/gsttaglist.h" line="952"/> + <source-position filename="gst/gsttaglist.h" line="934"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_GEO_LOCATION_SUBLOCATION" @@ -61293,35 +61339,35 @@ produced. (string).</doc> c:type="GST_TAG_GEO_LOCATION_SUBLOCATION"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="991">A location 'smaller' than GST_TAG_GEO_LOCATION_CITY that specifies better + line="973">A location 'smaller' than GST_TAG_GEO_LOCATION_CITY that specifies better where the media has been produced. (e.g. the neighborhood) (string). This tag has been added as this is how it is handled/named in XMP's Iptc4xmpcore schema.</doc> - <source-position filename="gst/gsttaglist.h" line="1000"/> + <source-position filename="gst/gsttaglist.h" line="982"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_GROUPING" value="grouping" c:type="GST_TAG_GROUPING"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="1073">Groups together media that are related and spans multiple tracks. An + line="1055">Groups together media that are related and spans multiple tracks. An example are multiple pieces of a concerto. (string)</doc> - <source-position filename="gst/gsttaglist.h" line="1079"/> + <source-position filename="gst/gsttaglist.h" line="1061"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_HOMEPAGE" value="homepage" c:type="GST_TAG_HOMEPAGE"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="703">Homepage for this media (i.e. artist or movie homepage) (string)</doc> - <source-position filename="gst/gsttaglist.h" line="708"/> + line="685">Homepage for this media (i.e. artist or movie homepage) (string)</doc> + <source-position filename="gst/gsttaglist.h" line="690"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_IMAGE" value="image" c:type="GST_TAG_IMAGE"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="908">image (sample) (sample taglist should specify the content type and preferably + line="890">image (sample) (sample taglist should specify the content type and preferably also set "image-type" field as `GstTagImageType`)</doc> - <source-position filename="gst/gsttaglist.h" line="914"/> + <source-position filename="gst/gsttaglist.h" line="896"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_IMAGE_ORIENTATION" @@ -61329,7 +61375,7 @@ also set "image-type" field as `GstTagImageType`)</doc> c:type="GST_TAG_IMAGE_ORIENTATION"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="1115">Represents the 'Orientation' tag from EXIF. Defines how the image + line="1097">Represents the 'Orientation' tag from EXIF. Defines how the image should be rotated and mirrored for display. (string) This tag has a predefined set of allowed values: @@ -61348,7 +61394,7 @@ yield the same result. Rotations indicated by the values are in clockwise direction and 'flip' means an horizontal mirroring.</doc> - <source-position filename="gst/gsttaglist.h" line="1138"/> + <source-position filename="gst/gsttaglist.h" line="1120"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_INTERPRETED_BY" @@ -61357,23 +61403,23 @@ Rotations indicated by the values are in clockwise direction and version="1.2"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="1147">Information about the people behind a remix and similar + line="1129">Information about the people behind a remix and similar interpretations of another existing piece (string)</doc> - <source-position filename="gst/gsttaglist.h" line="1155"/> + <source-position filename="gst/gsttaglist.h" line="1137"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_ISRC" value="isrc" c:type="GST_TAG_ISRC"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="721">International Standard Recording Code - see http://www.ifpi.org/isrc/ (string)</doc> - <source-position filename="gst/gsttaglist.h" line="726"/> + line="703">International Standard Recording Code - see http://www.ifpi.org/isrc/ (string)</doc> + <source-position filename="gst/gsttaglist.h" line="708"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_KEYWORDS" value="keywords" c:type="GST_TAG_KEYWORDS"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="939">comma separated keywords describing the content (string).</doc> - <source-position filename="gst/gsttaglist.h" line="944"/> + line="921">comma separated keywords describing the content (string).</doc> + <source-position filename="gst/gsttaglist.h" line="926"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_LANGUAGE_CODE" @@ -61381,11 +61427,11 @@ interpretations of another existing piece (string)</doc> c:type="GST_TAG_LANGUAGE_CODE"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="889">ISO-639-2 or ISO-639-1 code for the language the content is in (string) + line="871">ISO-639-2 or ISO-639-1 code for the language the content is in (string) There is utility API in libgsttag in gst-plugins-base to obtain a translated language name from the language code: `gst_tag_get_language_name()`</doc> - <source-position filename="gst/gsttaglist.h" line="897"/> + <source-position filename="gst/gsttaglist.h" line="879"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_LANGUAGE_NAME" @@ -61393,19 +61439,19 @@ language name from the language code: `gst_tag_get_language_name()`</doc> c:type="GST_TAG_LANGUAGE_NAME"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="898">Name of the language the content is in (string) + line="880">Name of the language the content is in (string) Free-form name of the language the content is in, if a language code is not available. This tag should not be set in addition to a language code. It is undefined what language or locale the language name is in.</doc> - <source-position filename="gst/gsttaglist.h" line="907"/> + <source-position filename="gst/gsttaglist.h" line="889"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_LICENSE" value="license" c:type="GST_TAG_LICENSE"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="762">license of data (string)</doc> - <source-position filename="gst/gsttaglist.h" line="767"/> + line="744">license of data (string)</doc> + <source-position filename="gst/gsttaglist.h" line="749"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_LICENSE_URI" @@ -61413,8 +61459,8 @@ code. It is undefined what language or locale the language name is in.</doc> c:type="GST_TAG_LICENSE_URI"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="768">URI to location where license details can be found (string)</doc> - <source-position filename="gst/gsttaglist.h" line="773"/> + line="750">URI to location where license details can be found (string)</doc> + <source-position filename="gst/gsttaglist.h" line="755"/> <type name="utf8" c:type="gchar*"/> </constant> <function-macro name="TAG_LIST" @@ -61429,16 +61475,16 @@ code. It is undefined what language or locale the language name is in.</doc> <constant name="TAG_LOCATION" value="location" c:type="GST_TAG_LOCATION"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="696">Origin of media as a URI (location, where the original of the file or stream + line="678">Origin of media as a URI (location, where the original of the file or stream is hosted) (string)</doc> - <source-position filename="gst/gsttaglist.h" line="702"/> + <source-position filename="gst/gsttaglist.h" line="684"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_LYRICS" value="lyrics" c:type="GST_TAG_LYRICS"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="1061">The lyrics of the media (string)</doc> - <source-position filename="gst/gsttaglist.h" line="1066"/> + line="1043">The lyrics of the media (string)</doc> + <source-position filename="gst/gsttaglist.h" line="1048"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_MAXIMUM_BITRATE" @@ -61446,8 +61492,8 @@ is hosted) (string)</doc> c:type="GST_TAG_MAXIMUM_BITRATE"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="835">maximum bitrate in bits/s (unsigned integer)</doc> - <source-position filename="gst/gsttaglist.h" line="840"/> + line="817">maximum bitrate in bits/s (unsigned integer)</doc> + <source-position filename="gst/gsttaglist.h" line="822"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_MIDI_BASE_NOTE" @@ -61456,10 +61502,10 @@ is hosted) (string)</doc> version="1.4"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="1156">[Midi note number](http://en.wikipedia.org/wiki/Note#Note_designation_in_accordance_with_octave_name) + line="1138">[Midi note number](http://en.wikipedia.org/wiki/Note#Note_designation_in_accordance_with_octave_name) of the audio track. This is useful for sample instruments and in particular for multi-samples.</doc> - <source-position filename="gst/gsttaglist.h" line="1165"/> + <source-position filename="gst/gsttaglist.h" line="1147"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_MINIMUM_BITRATE" @@ -61467,8 +61513,8 @@ for multi-samples.</doc> c:type="GST_TAG_MINIMUM_BITRATE"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="829">minimum bitrate in bits/s (unsigned integer)</doc> - <source-position filename="gst/gsttaglist.h" line="834"/> + line="811">minimum bitrate in bits/s (unsigned integer)</doc> + <source-position filename="gst/gsttaglist.h" line="816"/> <type name="utf8" c:type="gchar*"/> </constant> <function-macro name="TAG_MODE_IS_VALID" @@ -61485,9 +61531,9 @@ for multi-samples.</doc> c:type="GST_TAG_NOMINAL_BITRATE"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="822">nominal bitrate in bits/s (unsigned integer). The actual bitrate might be + line="804">nominal bitrate in bits/s (unsigned integer). The actual bitrate might be different from this target bitrate.</doc> - <source-position filename="gst/gsttaglist.h" line="828"/> + <source-position filename="gst/gsttaglist.h" line="810"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_ORGANIZATION" @@ -61495,8 +61541,8 @@ different from this target bitrate.</doc> c:type="GST_TAG_ORGANIZATION"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="727">organization (string)</doc> - <source-position filename="gst/gsttaglist.h" line="732"/> + line="709">organization (string)</doc> + <source-position filename="gst/gsttaglist.h" line="714"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_PERFORMER" @@ -61504,8 +61550,8 @@ different from this target bitrate.</doc> c:type="GST_TAG_PERFORMER"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="774">person(s) performing (string)</doc> - <source-position filename="gst/gsttaglist.h" line="779"/> + line="756">person(s) performing (string)</doc> + <source-position filename="gst/gsttaglist.h" line="761"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_PREVIEW_IMAGE" @@ -61513,9 +61559,9 @@ different from this target bitrate.</doc> c:type="GST_TAG_PREVIEW_IMAGE"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="915">image that is meant for preview purposes, e.g. small icon-sized version + line="897">image that is meant for preview purposes, e.g. small icon-sized version (sample) (sample taglist should specify the content type)</doc> - <source-position filename="gst/gsttaglist.h" line="921"/> + <source-position filename="gst/gsttaglist.h" line="903"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_PRIVATE_DATA" @@ -61524,7 +61570,7 @@ different from this target bitrate.</doc> version="1.8"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="1166">Any private data that may be contained in tags (sample). + line="1148">Any private data that may be contained in tags (sample). It is represented by #GstSample in which #GstBuffer contains the binary data and the sample's info #GstStructure may contain any @@ -61534,7 +61580,7 @@ Private frames in ID3v2 tags ('PRIV' frames) will be represented using this tag, in which case the GstStructure will be named "ID3PrivateFrame" and contain a field named "owner" of type string which contains the owner-identification string from the tag.</doc> - <source-position filename="gst/gsttaglist.h" line="1182"/> + <source-position filename="gst/gsttaglist.h" line="1164"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_PUBLISHER" @@ -61543,8 +61589,8 @@ which contains the owner-identification string from the tag.</doc> version="1.2"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="1139">Name of the label or publisher (string)</doc> - <source-position filename="gst/gsttaglist.h" line="1146"/> + line="1121">Name of the label or publisher (string)</doc> + <source-position filename="gst/gsttaglist.h" line="1128"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_REFERENCE_LEVEL" @@ -61552,15 +61598,15 @@ which contains the owner-identification string from the tag.</doc> c:type="GST_TAG_REFERENCE_LEVEL"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="883">reference level of track and album gain values (double)</doc> - <source-position filename="gst/gsttaglist.h" line="888"/> + line="865">reference level of track and album gain values (double)</doc> + <source-position filename="gst/gsttaglist.h" line="870"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_SERIAL" value="serial" c:type="GST_TAG_SERIAL"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="841">serial number of track (unsigned integer)</doc> - <source-position filename="gst/gsttaglist.h" line="846"/> + line="823">serial number of track (unsigned integer)</doc> + <source-position filename="gst/gsttaglist.h" line="828"/> <type name="utf8" c:type="gchar*"/> </constant> <function-macro name="TAG_SETTER" @@ -61586,8 +61632,8 @@ which contains the owner-identification string from the tag.</doc> c:type="GST_TAG_SHOW_EPISODE_NUMBER"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="1049">Number of the episode within a season/show (unsigned integer)</doc> - <source-position filename="gst/gsttaglist.h" line="1054"/> + line="1031">Number of the episode within a season/show (unsigned integer)</doc> + <source-position filename="gst/gsttaglist.h" line="1036"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_SHOW_NAME" @@ -61595,8 +61641,8 @@ which contains the owner-identification string from the tag.</doc> c:type="GST_TAG_SHOW_NAME"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="1037">Name of the show, used for displaying (string)</doc> - <source-position filename="gst/gsttaglist.h" line="1042"/> + line="1019">Name of the show, used for displaying (string)</doc> + <source-position filename="gst/gsttaglist.h" line="1024"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_SHOW_SEASON_NUMBER" @@ -61604,8 +61650,8 @@ which contains the owner-identification string from the tag.</doc> c:type="GST_TAG_SHOW_SEASON_NUMBER"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="1055">Number of the season of a show/series (unsigned integer)</doc> - <source-position filename="gst/gsttaglist.h" line="1060"/> + line="1037">Number of the season of a show/series (unsigned integer)</doc> + <source-position filename="gst/gsttaglist.h" line="1042"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_SHOW_SORTNAME" @@ -61613,8 +61659,8 @@ which contains the owner-identification string from the tag.</doc> c:type="GST_TAG_SHOW_SORTNAME"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="1043">Name of the show, used for sorting (string)</doc> - <source-position filename="gst/gsttaglist.h" line="1048"/> + line="1025">Name of the show, used for sorting (string)</doc> + <source-position filename="gst/gsttaglist.h" line="1030"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_SUBTITLE_CODEC" @@ -61622,17 +61668,17 @@ which contains the owner-identification string from the tag.</doc> c:type="GST_TAG_SUBTITLE_CODEC"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="804">codec/format the subtitle data is stored in (string)</doc> - <source-position filename="gst/gsttaglist.h" line="809"/> + line="786">codec/format the subtitle data is stored in (string)</doc> + <source-position filename="gst/gsttaglist.h" line="791"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_TITLE" value="title" c:type="GST_TAG_TITLE"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="559">commonly used title (string) + line="541">commonly used title (string) The title as it should be displayed, e.g. 'The Doll House'</doc> - <source-position filename="gst/gsttaglist.h" line="566"/> + <source-position filename="gst/gsttaglist.h" line="548"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_TITLE_SORTNAME" @@ -61640,10 +61686,10 @@ The title as it should be displayed, e.g. 'The Doll House'</doc> c:type="GST_TAG_TITLE_SORTNAME"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="567">commonly used title, as used for sorting (string) + line="549">commonly used title, as used for sorting (string) The title as it should be sorted, e.g. 'Doll House, The'</doc> - <source-position filename="gst/gsttaglist.h" line="574"/> + <source-position filename="gst/gsttaglist.h" line="556"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_TRACK_COUNT" @@ -61651,8 +61697,8 @@ The title as it should be sorted, e.g. 'Doll House, The'</doc> c:type="GST_TAG_TRACK_COUNT"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="678">count of tracks inside collection this track belongs to (unsigned integer)</doc> - <source-position filename="gst/gsttaglist.h" line="683"/> + line="660">count of tracks inside collection this track belongs to (unsigned integer)</doc> + <source-position filename="gst/gsttaglist.h" line="665"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_TRACK_GAIN" @@ -61660,8 +61706,8 @@ The title as it should be sorted, e.g. 'Doll House, The'</doc> c:type="GST_TAG_TRACK_GAIN"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="859">track gain in db (double)</doc> - <source-position filename="gst/gsttaglist.h" line="864"/> + line="841">track gain in db (double)</doc> + <source-position filename="gst/gsttaglist.h" line="846"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_TRACK_NUMBER" @@ -61669,8 +61715,8 @@ The title as it should be sorted, e.g. 'Doll House, The'</doc> c:type="GST_TAG_TRACK_NUMBER"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="672">track number inside a collection (unsigned integer)</doc> - <source-position filename="gst/gsttaglist.h" line="677"/> + line="654">track number inside a collection (unsigned integer)</doc> + <source-position filename="gst/gsttaglist.h" line="659"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_TRACK_PEAK" @@ -61678,8 +61724,8 @@ The title as it should be sorted, e.g. 'Doll House, The'</doc> c:type="GST_TAG_TRACK_PEAK"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="865">peak of the track (double)</doc> - <source-position filename="gst/gsttaglist.h" line="870"/> + line="847">peak of the track (double)</doc> + <source-position filename="gst/gsttaglist.h" line="852"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_USER_RATING" @@ -61687,17 +61733,17 @@ The title as it should be sorted, e.g. 'Doll House, The'</doc> c:type="GST_TAG_USER_RATING"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="1080">Rating attributed by a person (likely the application user). + line="1062">Rating attributed by a person (likely the application user). The higher the value, the more the user likes this media (unsigned int from 0 to 100)</doc> - <source-position filename="gst/gsttaglist.h" line="1087"/> + <source-position filename="gst/gsttaglist.h" line="1069"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_VERSION" value="version" c:type="GST_TAG_VERSION"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="715">version of this data (string)</doc> - <source-position filename="gst/gsttaglist.h" line="720"/> + line="697">version of this data (string)</doc> + <source-position filename="gst/gsttaglist.h" line="702"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="TAG_VIDEO_CODEC" @@ -61705,8 +61751,8 @@ The higher the value, the more the user likes this media c:type="GST_TAG_VIDEO_CODEC"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="792">codec the video data is stored in (string)</doc> - <source-position filename="gst/gsttaglist.h" line="797"/> + line="774">codec the video data is stored in (string)</doc> + <source-position filename="gst/gsttaglist.h" line="779"/> <type name="utf8" c:type="gchar*"/> </constant> <function-macro name="TASK" c:identifier="GST_TASK" introspectable="0"> @@ -61869,6 +61915,21 @@ The higher the value, the more the user likes this media </parameter> </parameters> </function-macro> + <constant name="TIMEP_FORMAT" + value="paT" + c:type="GST_TIMEP_FORMAT" + version="1.18" + introspectable="0"> + <doc xml:space="preserve" + filename="gst/gstinfo.h" + line="305">printf format type used to debug GStreamer ClockTime pointers. You can use +this in combination with GStreamer's debug logging system as well as the +functions gst_info_vasprintf(), gst_info_strdup_vprintf() and +gst_info_strdup_printf() to pretty-print #GstClockTime pointers. This can +only be used on pointers to GstClockTime values.</doc> + <source-position filename="gst/gstinfo.h" line="316"/> + <type name="utf8" c:type="gchar*"/> + </constant> <function-macro name="TIMESPEC_TO_TIME" c:identifier="GST_TIMESPEC_TO_TIME" introspectable="0"> @@ -62168,7 +62229,7 @@ returned by gst_toc_entry_set_loop() to indicate infinite looping.</doc> <function-macro name="TRACER_RECORD" c:identifier="GST_TRACER_RECORD" introspectable="0"> - <source-position filename="gst/gsttracerrecord.h" line="38"/> + <source-position filename="gst/gsttracerrecord.h" line="40"/> <parameters> <parameter name="obj"> </parameter> @@ -62177,7 +62238,7 @@ returned by gst_toc_entry_set_loop() to indicate infinite looping.</doc> <function-macro name="TRACER_RECORD_CAST" c:identifier="GST_TRACER_RECORD_CAST" introspectable="0"> - <source-position filename="gst/gsttracerrecord.h" line="43"/> + <source-position filename="gst/gsttracerrecord.h" line="45"/> <parameters> <parameter name="obj"> </parameter> @@ -62186,7 +62247,7 @@ returned by gst_toc_entry_set_loop() to indicate infinite looping.</doc> <function-macro name="TRACER_RECORD_CLASS" c:identifier="GST_TRACER_RECORD_CLASS" introspectable="0"> - <source-position filename="gst/gsttracerrecord.h" line="39"/> + <source-position filename="gst/gsttracerrecord.h" line="41"/> <parameters> <parameter name="klass"> </parameter> @@ -62195,7 +62256,7 @@ returned by gst_toc_entry_set_loop() to indicate infinite looping.</doc> <function-macro name="TRACER_RECORD_GET_CLASS" c:identifier="GST_TRACER_RECORD_GET_CLASS" introspectable="0"> - <source-position filename="gst/gsttracerrecord.h" line="42"/> + <source-position filename="gst/gsttracerrecord.h" line="44"/> <parameters> <parameter name="obj"> </parameter> @@ -62612,10 +62673,10 @@ Free-function: gst_tag_list_unref</doc> </parameter> </parameters> </method> - <method name="copy" c:identifier="gst_tag_list_copy" introspectable="0"> + <method name="copy" c:identifier="gst_tag_list_copy"> <doc xml:space="preserve" - filename="gst/gsttaglist.h" - line="456">Creates a new #GstTagList as a copy of the old @taglist. The new taglist + filename="gst/gsttaglist.c" + line="2066">Creates a new #GstTagList as a copy of the old @taglist. The new taglist will have a refcount of 1, owned by the caller, and will be writable as a result. @@ -62624,18 +62685,18 @@ followed by a gst_tag_list_make_writable(). If you only want to hold on to a reference to the data, you should use gst_tag_list_ref(). When you are finished with the taglist, call gst_tag_list_unref() on it.</doc> - <source-position filename="gst/gsttaglist.h" line="472"/> + <source-position filename="gst/gsttaglist.h" line="457"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" - filename="gst/gsttaglist.h" - line="470">the new #GstTagList</doc> + filename="gst/gsttaglist.c" + line="2080">the new #GstTagList</doc> <type name="TagList" c:type="GstTagList*"/> </return-value> <parameters> <instance-parameter name="taglist" transfer-ownership="none"> <doc xml:space="preserve" - filename="gst/gsttaglist.h" - line="458">a #GstTagList.</doc> + filename="gst/gsttaglist.c" + line="2068">a #GstTagList.</doc> <type name="TagList" c:type="const GstTagList*"/> </instance-parameter> </parameters> @@ -64693,7 +64754,7 @@ no effect on the thread name.</doc> <constructor name="new" c:identifier="gst_task_new"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="388">Create a new Task that will repeatedly call the provided @func + line="395">Create a new Task that will repeatedly call the provided @func with @user_data as a parameter. Typically the task will run in a new thread. @@ -64710,7 +64771,7 @@ gst_task_set_lock() function. This lock will always be acquired while <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="408">A new #GstTask. + line="415">A new #GstTask. MT safe.</doc> <type name="Task" c:type="GstTask*"/> @@ -64723,7 +64784,7 @@ MT safe.</doc> destroy="2"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="390">The #GstTaskFunction to use</doc> + line="397">The #GstTaskFunction to use</doc> <type name="TaskFunction" c:type="GstTaskFunction"/> </parameter> <parameter name="user_data" @@ -64732,13 +64793,13 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="391">User data to pass to @func</doc> + line="398">User data to pass to @func</doc> <type name="gpointer" c:type="gpointer"/> </parameter> <parameter name="notify" transfer-ownership="none" scope="async"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="392">the function to call when @user_data is no longer needed.</doc> + line="399">the function to call when @user_data is no longer needed.</doc> <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/> </parameter> </parameters> @@ -64758,7 +64819,7 @@ MT safe.</doc> <method name="get_pool" c:identifier="gst_task_get_pool"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="467">Get the #GstTaskPool that this task will use for its streaming + line="474">Get the #GstTaskPool that this task will use for its streaming threads. MT safe.</doc> @@ -64766,7 +64827,7 @@ MT safe.</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="476">the #GstTaskPool used by @task. gst_object_unref() + line="483">the #GstTaskPool used by @task. gst_object_unref() after usage.</doc> <type name="TaskPool" c:type="GstTaskPool*"/> </return-value> @@ -64774,7 +64835,7 @@ after usage.</doc> <instance-parameter name="task" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="469">a #GstTask</doc> + line="476">a #GstTask</doc> <type name="Task" c:type="GstTask*"/> </instance-parameter> </parameters> @@ -64782,12 +64843,12 @@ after usage.</doc> <method name="get_state" c:identifier="gst_task_get_state"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="605">Get the current state of the task.</doc> + line="612">Get the current state of the task.</doc> <source-position filename="gst/gsttask.h" line="196"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="611">The #GstTaskState of the task + line="618">The #GstTaskState of the task MT safe.</doc> <type name="TaskState" c:type="GstTaskState"/> @@ -64796,7 +64857,7 @@ MT safe.</doc> <instance-parameter name="task" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="607">The #GstTask to query</doc> + line="614">The #GstTask to query</doc> <type name="Task" c:type="GstTask*"/> </instance-parameter> </parameters> @@ -64804,7 +64865,7 @@ MT safe.</doc> <method name="join" c:identifier="gst_task_join"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="815">Joins @task. After this call, it is safe to unref the task + line="822">Joins @task. After this call, it is safe to unref the task and clean up the lock set with gst_task_set_lock(). The task will automatically be stopped with this call. @@ -64816,7 +64877,7 @@ g_warning.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="828">%TRUE if the task could be joined. + line="835">%TRUE if the task could be joined. MT safe.</doc> <type name="gboolean" c:type="gboolean"/> @@ -64825,7 +64886,7 @@ MT safe.</doc> <instance-parameter name="task" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="817">The #GstTask to join</doc> + line="824">The #GstTask to join</doc> <type name="Task" c:type="GstTask*"/> </instance-parameter> </parameters> @@ -64833,7 +64894,7 @@ MT safe.</doc> <method name="pause" c:identifier="gst_task_pause"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="770">Pauses @task. This method can also be called on a task in the + line="777">Pauses @task. This method can also be called on a task in the stopped state, in which case a thread will be started and will remain in the paused state. This function does not wait for the task to complete the paused state.</doc> @@ -64841,7 +64902,7 @@ the paused state.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="779">%TRUE if the task could be paused. + line="786">%TRUE if the task could be paused. MT safe.</doc> <type name="gboolean" c:type="gboolean"/> @@ -64850,7 +64911,7 @@ MT safe.</doc> <instance-parameter name="task" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="772">The #GstTask to pause</doc> + line="779">The #GstTask to pause</doc> <type name="Task" c:type="GstTask*"/> </instance-parameter> </parameters> @@ -64858,13 +64919,13 @@ MT safe.</doc> <method name="resume" c:identifier="gst_task_resume" version="1.18"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="789">Resume @task in case it was paused. If the task was stopped, it will + line="796">Resume @task in case it was paused. If the task was stopped, it will remain in that state and this function will return %FALSE.</doc> <source-position filename="gst/gsttask.h" line="211"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="796">%TRUE if the task could be resumed. + line="803">%TRUE if the task could be resumed. MT safe.</doc> <type name="gboolean" c:type="gboolean"/> @@ -64873,7 +64934,7 @@ MT safe.</doc> <instance-parameter name="task" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="791">The #GstTask to resume</doc> + line="798">The #GstTask to resume</doc> <type name="Task" c:type="GstTask*"/> </instance-parameter> </parameters> @@ -64882,7 +64943,7 @@ MT safe.</doc> c:identifier="gst_task_set_enter_callback"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="529">Call @enter_func when the task function of @task is entered. @user_data will + line="536">Call @enter_func when the task function of @task is entered. @user_data will be passed to @enter_func and @notify will be called when @user_data is no longer referenced.</doc> <source-position filename="gst/gsttask.h" line="186"/> @@ -64893,7 +64954,7 @@ longer referenced.</doc> <instance-parameter name="task" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="531">The #GstTask to use</doc> + line="538">The #GstTask to use</doc> <type name="Task" c:type="GstTask*"/> </instance-parameter> <parameter name="enter_func" @@ -64903,7 +64964,7 @@ longer referenced.</doc> destroy="2"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="532">a #GstTaskThreadFunc</doc> + line="539">a #GstTaskThreadFunc</doc> <type name="TaskThreadFunc" c:type="GstTaskThreadFunc"/> </parameter> <parameter name="user_data" @@ -64912,13 +64973,13 @@ longer referenced.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="533">user data passed to @enter_func</doc> + line="540">user data passed to @enter_func</doc> <type name="gpointer" c:type="gpointer"/> </parameter> <parameter name="notify" transfer-ownership="none" scope="async"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="534">called when @user_data is no longer referenced</doc> + line="541">called when @user_data is no longer referenced</doc> <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/> </parameter> </parameters> @@ -64927,7 +64988,7 @@ longer referenced.</doc> c:identifier="gst_task_set_leave_callback"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="567">Call @leave_func when the task function of @task is left. @user_data will + line="574">Call @leave_func when the task function of @task is left. @user_data will be passed to @leave_func and @notify will be called when @user_data is no longer referenced.</doc> <source-position filename="gst/gsttask.h" line="191"/> @@ -64938,7 +64999,7 @@ longer referenced.</doc> <instance-parameter name="task" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="569">The #GstTask to use</doc> + line="576">The #GstTask to use</doc> <type name="Task" c:type="GstTask*"/> </instance-parameter> <parameter name="leave_func" @@ -64948,7 +65009,7 @@ longer referenced.</doc> destroy="2"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="570">a #GstTaskThreadFunc</doc> + line="577">a #GstTaskThreadFunc</doc> <type name="TaskThreadFunc" c:type="GstTaskThreadFunc"/> </parameter> <parameter name="user_data" @@ -64957,13 +65018,13 @@ longer referenced.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="571">user data passed to @leave_func</doc> + line="578">user data passed to @leave_func</doc> <type name="gpointer" c:type="gpointer"/> </parameter> <parameter name="notify" transfer-ownership="none" scope="async"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="572">called when @user_data is no longer referenced</doc> + line="579">called when @user_data is no longer referenced</doc> <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/> </parameter> </parameters> @@ -64971,7 +65032,7 @@ longer referenced.</doc> <method name="set_lock" c:identifier="gst_task_set_lock"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="432">Set the mutex used by the task. The mutex will be acquired before + line="439">Set the mutex used by the task. The mutex will be acquired before calling the #GstTaskFunction. This function has to be called before calling gst_task_pause() or @@ -64986,13 +65047,13 @@ MT safe.</doc> <instance-parameter name="task" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="434">The #GstTask to use</doc> + line="441">The #GstTask to use</doc> <type name="Task" c:type="GstTask*"/> </instance-parameter> <parameter name="mutex" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="435">The #GRecMutex to use</doc> + line="442">The #GRecMutex to use</doc> <type name="GLib.RecMutex" c:type="GRecMutex*"/> </parameter> </parameters> @@ -65000,7 +65061,7 @@ MT safe.</doc> <method name="set_pool" c:identifier="gst_task_set_pool"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="496">Set @pool as the new GstTaskPool for @task. Any new streaming threads that + line="503">Set @pool as the new GstTaskPool for @task. Any new streaming threads that will be created by @task will now use @pool. MT safe.</doc> @@ -65012,13 +65073,13 @@ MT safe.</doc> <instance-parameter name="task" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="498">a #GstTask</doc> + line="505">a #GstTask</doc> <type name="Task" c:type="GstTask*"/> </instance-parameter> <parameter name="pool" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="499">a #GstTaskPool</doc> + line="506">a #GstTaskPool</doc> <type name="TaskPool" c:type="GstTaskPool*"/> </parameter> </parameters> @@ -65026,7 +65087,7 @@ MT safe.</doc> <method name="set_state" c:identifier="gst_task_set_state"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="706">Sets the state of @task to @state. + line="713">Sets the state of @task to @state. The @task must have a lock associated with it using gst_task_set_lock() when going to GST_TASK_STARTED or GST_TASK_PAUSED or @@ -65037,20 +65098,20 @@ MT safe.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="719">%TRUE if the state could be changed.</doc> + line="726">%TRUE if the state could be changed.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="task" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="708">a #GstTask</doc> + line="715">a #GstTask</doc> <type name="Task" c:type="GstTask*"/> </instance-parameter> <parameter name="state" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="709">the new task state</doc> + line="716">the new task state</doc> <type name="TaskState" c:type="GstTaskState"/> </parameter> </parameters> @@ -65058,13 +65119,13 @@ MT safe.</doc> <method name="start" c:identifier="gst_task_start"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="735">Starts @task. The @task must have a lock associated with it using + line="742">Starts @task. The @task must have a lock associated with it using gst_task_set_lock() or this function will return %FALSE.</doc> <source-position filename="gst/gsttask.h" line="202"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="742">%TRUE if the task could be started. + line="749">%TRUE if the task could be started. MT safe.</doc> <type name="gboolean" c:type="gboolean"/> @@ -65073,7 +65134,7 @@ MT safe.</doc> <instance-parameter name="task" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="737">The #GstTask to start</doc> + line="744">The #GstTask to start</doc> <type name="Task" c:type="GstTask*"/> </instance-parameter> </parameters> @@ -65081,14 +65142,14 @@ MT safe.</doc> <method name="stop" c:identifier="gst_task_stop"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="752">Stops @task. This method merely schedules the task to stop and + line="759">Stops @task. This method merely schedules the task to stop and will not wait for the task to have completely stopped. Use gst_task_join() to stop and wait for completion.</doc> <source-position filename="gst/gsttask.h" line="205"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="760">%TRUE if the task could be stopped. + line="767">%TRUE if the task could be stopped. MT safe.</doc> <type name="gboolean" c:type="gboolean"/> @@ -65097,7 +65158,7 @@ MT safe.</doc> <instance-parameter name="task" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsttask.c" - line="754">The #GstTask to stop</doc> + line="761">The #GstTask to stop</doc> <type name="Task" c:type="GstTask*"/> </instance-parameter> </parameters> @@ -66639,13 +66700,13 @@ contextual data, which they must not modify.</doc> <function name="register" c:identifier="gst_tracer_register"> <doc xml:space="preserve" filename="gst/gsttracer.c" - line="133">Create a new tracer-factory capable of instantiating objects of the + line="131">Create a new tracer-factory capable of instantiating objects of the @type and add the factory to @plugin.</doc> - <source-position filename="gst/gsttracer.h" line="75"/> + <source-position filename="gst/gsttracer.h" line="73"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsttracer.c" - line="142">%TRUE, if the registering succeeded, %FALSE on error</doc> + line="140">%TRUE, if the registering succeeded, %FALSE on error</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> @@ -66655,19 +66716,19 @@ contextual data, which they must not modify.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsttracer.c" - line="135">A #GstPlugin, or %NULL for a static typefind function</doc> + line="133">A #GstPlugin, or %NULL for a static typefind function</doc> <type name="Plugin" c:type="GstPlugin*"/> </parameter> <parameter name="name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsttracer.c" - line="136">The name for registering</doc> + line="134">The name for registering</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="type" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsttracer.c" - line="137">GType of tracer to register</doc> + line="135">GType of tracer to register</doc> <type name="GType" c:type="GType"/> </parameter> </parameters> @@ -66739,7 +66800,8 @@ Free-function: gst_plugin_feature_list_free</doc> </return-value> </function> <method name="get_tracer_type" - c:identifier="gst_tracer_factory_get_tracer_type"> + c:identifier="gst_tracer_factory_get_tracer_type" + version="1.14"> <doc xml:space="preserve" filename="gst/gsttracerfactory.c" line="81">Get the #GType for elements managed by this factory. The type can @@ -66784,13 +66846,14 @@ the factory is not loaded.</doc> filename="gst/gsttracerrecord.c" line="22">Tracing modules will create instances of this class to announce the data they will log and create a log formatter.</doc> - <source-position filename="gst/gsttracerrecord.h" line="35"/> + <source-position filename="gst/gsttracerrecord.h" line="37"/> <constructor name="new" c:identifier="gst_tracer_record_new" + version="1.8" introspectable="0"> <doc xml:space="preserve" filename="gst/gsttracerrecord.c" - line="155">Create a new tracer record. The record instance can be used to efficiently + line="153">Create a new tracer record. The record instance can be used to efficiently log entries using gst_tracer_record_log(). The @name without the ".class" suffix will be used for the log records. @@ -66812,32 +66875,33 @@ handle that right now. <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gsttracerrecord.c" - line="181">a new #GstTracerRecord</doc> + line="179">a new #GstTracerRecord</doc> <type name="TracerRecord" c:type="GstTracerRecord*"/> </return-value> <parameters> <parameter name="name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsttracerrecord.c" - line="157">name of new record, must end on ".class".</doc> + line="155">name of new record, must end on ".class".</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="firstfield" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsttracerrecord.c" - line="158">name of first field to set</doc> + line="156">name of first field to set</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="..." transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsttracerrecord.c" - line="159">additional arguments</doc> + line="157">additional arguments</doc> <varargs/> </parameter> </parameters> </constructor> <method name="log" c:identifier="gst_tracer_record_log" + version="1.8" introspectable="0"> <doc xml:space="preserve" filename="gst/gsttracerrecord.c" @@ -66871,7 +66935,7 @@ the category "GST_TRACER". c:type="GstTracerRecordClass" disguised="1" glib:is-gtype-struct-for="TracerRecord"> - <source-position filename="gst/gsttracerrecord.h" line="35"/> + <source-position filename="gst/gsttracerrecord.h" line="37"/> </record> <bitfield name="TracerValueFlags" glib:type-name="GstTracerValueFlags" @@ -66879,7 +66943,7 @@ the category "GST_TRACER". c:type="GstTracerValueFlags"> <doc xml:space="preserve" filename="gst/gsttracerrecord.h" - line="73">Flag that describe the value. These flags help applications processing the + line="75">Flag that describe the value. These flags help applications processing the logs to understand the values.</doc> <member name="none" value="0" @@ -66887,7 +66951,7 @@ logs to understand the values.</doc> glib:nick="none"> <doc xml:space="preserve" filename="gst/gsttracerrecord.h" - line="75">no flags</doc> + line="77">no flags</doc> </member> <member name="optional" value="1" @@ -66895,7 +66959,7 @@ logs to understand the values.</doc> glib:nick="optional"> <doc xml:space="preserve" filename="gst/gsttracerrecord.h" - line="76">the value is optional. When using this flag + line="78">the value is optional. When using this flag one need to have an additional boolean arg before this value in the var-args list passed to gst_tracer_record_log().</doc> </member> @@ -66905,7 +66969,7 @@ logs to understand the values.</doc> glib:nick="aggregated"> <doc xml:space="preserve" filename="gst/gsttracerrecord.h" - line="79">the value is a combined figure, since the + line="81">the value is a combined figure, since the start of tracing. Examples are averages or timestamps.</doc> </member> </bitfield> @@ -66916,7 +66980,7 @@ logs to understand the values.</doc> c:type="GstTracerValueScope"> <doc xml:space="preserve" filename="gst/gsttracerrecord.h" - line="50">Tracing record will contain fields that contain a measured value or extra + line="52">Tracing record will contain fields that contain a measured value or extra meta-data. One such meta data are values that tell where a measurement was taken. This enumerating declares to which scope such a meta data field relates to. If it is e.g. %GST_TRACER_VALUE_SCOPE_PAD, then each of the log @@ -66927,7 +66991,7 @@ events may contain values for different #GstPads.</doc> glib:nick="process"> <doc xml:space="preserve" filename="gst/gsttracerrecord.h" - line="52">the value is related to the process</doc> + line="54">the value is related to the process</doc> </member> <member name="thread" value="1" @@ -66935,7 +66999,7 @@ events may contain values for different #GstPads.</doc> glib:nick="thread"> <doc xml:space="preserve" filename="gst/gsttracerrecord.h" - line="53">the value is related to a thread</doc> + line="55">the value is related to a thread</doc> </member> <member name="element" value="2" @@ -66943,7 +67007,7 @@ events may contain values for different #GstPads.</doc> glib:nick="element"> <doc xml:space="preserve" filename="gst/gsttracerrecord.h" - line="54">the value is related to an #GstElement</doc> + line="56">the value is related to an #GstElement</doc> </member> <member name="pad" value="3" @@ -66951,7 +67015,7 @@ events may contain values for different #GstPads.</doc> glib:nick="pad"> <doc xml:space="preserve" filename="gst/gsttracerrecord.h" - line="55">the value is related to a #GstPad</doc> + line="57">the value is related to a #GstPad</doc> </member> </enumeration> <record name="TypeFind" c:type="GstTypeFind"> @@ -68024,13 +68088,13 @@ escaped except where indicated.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2428">Append a path onto the end of the path in the URI. The path is not + line="2470">Append a path onto the end of the path in the URI. The path is not normalized, call #gst_uri_normalize() to normalize the path.</doc> - <source-position filename="gst/gsturi.h" line="308"/> + <source-position filename="gst/gsturi.h" line="311"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2436">%TRUE if the path was appended successfully.</doc> + line="2478">%TRUE if the path was appended successfully.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> @@ -68040,13 +68104,13 @@ normalized, call #gst_uri_normalize() to normalize the path.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2430">The #GstUri to modify.</doc> + line="2472">The #GstUri to modify.</doc> <type name="Uri" c:type="GstUri*"/> </instance-parameter> <parameter name="relative_path" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2431">Relative path to append to the end of the current path.</doc> + line="2473">Relative path to append to the end of the current path.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -68056,12 +68120,12 @@ normalized, call #gst_uri_normalize() to normalize the path.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2466">Append a single path segment onto the end of the URI path.</doc> - <source-position filename="gst/gsturi.h" line="311"/> + line="2508">Append a single path segment onto the end of the URI path.</doc> + <source-position filename="gst/gsturi.h" line="314"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2473">%TRUE if the path was appended successfully.</doc> + line="2515">%TRUE if the path was appended successfully.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> @@ -68071,13 +68135,13 @@ normalized, call #gst_uri_normalize() to normalize the path.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2468">The #GstUri to modify.</doc> + line="2510">The #GstUri to modify.</doc> <type name="Uri" c:type="GstUri*"/> </instance-parameter> <parameter name="path_segment" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2469">The path segment string to append to the URI path.</doc> + line="2511">The path segment string to append to the URI path.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -68085,26 +68149,26 @@ normalized, call #gst_uri_normalize() to normalize the path.</doc> <method name="equal" c:identifier="gst_uri_equal" version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1656">Compares two #GstUri objects to see if they represent the same normalized + line="1698">Compares two #GstUri objects to see if they represent the same normalized URI.</doc> - <source-position filename="gst/gsturi.h" line="242"/> + <source-position filename="gst/gsturi.h" line="245"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1664">%TRUE if the normalized versions of the two URI's would be equal.</doc> + line="1706">%TRUE if the normalized versions of the two URI's would be equal.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="first" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1658">First #GstUri to compare.</doc> + line="1700">First #GstUri to compare.</doc> <type name="Uri" c:type="const GstUri*"/> </instance-parameter> <parameter name="second" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1659">Second #GstUri to compare.</doc> + line="1701">Second #GstUri to compare.</doc> <type name="Uri" c:type="const GstUri*"/> </parameter> </parameters> @@ -68114,12 +68178,12 @@ URI.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1630">Like gst_uri_from_string() but also joins with a base URI.</doc> - <source-position filename="gst/gsturi.h" line="239"/> + line="1672">Like gst_uri_from_string() but also joins with a base URI.</doc> + <source-position filename="gst/gsturi.h" line="242"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1637">A new #GstUri object.</doc> + line="1679">A new #GstUri object.</doc> <type name="Uri" c:type="GstUri*"/> </return-value> <parameters> @@ -68129,13 +68193,13 @@ URI.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1632">The base URI to join the new URI with.</doc> + line="1674">The base URI to join the new URI with.</doc> <type name="Uri" c:type="GstUri*"/> </instance-parameter> <parameter name="uri" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1633">The URI string to parse.</doc> + line="1675">The URI string to parse.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -68145,13 +68209,13 @@ URI.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2763">Get the fragment name from the URI or %NULL if it doesn't exist. + line="2805">Get the fragment name from the URI or %NULL if it doesn't exist. If @uri is %NULL then returns %NULL.</doc> - <source-position filename="gst/gsturi.h" line="343"/> + <source-position filename="gst/gsturi.h" line="346"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2770">The host name from the #GstUri object or %NULL.</doc> + line="2812">The host name from the #GstUri object or %NULL.</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> @@ -68161,7 +68225,7 @@ If @uri is %NULL then returns %NULL.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2765">This #GstUri object.</doc> + line="2807">This #GstUri object.</doc> <type name="Uri" c:type="const GstUri*"/> </instance-parameter> </parameters> @@ -68169,13 +68233,13 @@ If @uri is %NULL then returns %NULL.</doc> <method name="get_host" c:identifier="gst_uri_get_host" version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2161">Get the host name from the URI or %NULL if it doesn't exist. + line="2203">Get the host name from the URI or %NULL if it doesn't exist. If @uri is %NULL then returns %NULL.</doc> - <source-position filename="gst/gsturi.h" line="278"/> + <source-position filename="gst/gsturi.h" line="281"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2168">The host name from the #GstUri object or %NULL.</doc> + line="2210">The host name from the #GstUri object or %NULL.</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> @@ -68185,7 +68249,7 @@ If @uri is %NULL then returns %NULL.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2163">This #GstUri object.</doc> + line="2205">This #GstUri object.</doc> <type name="Uri" c:type="const GstUri*"/> </instance-parameter> </parameters> @@ -68195,7 +68259,7 @@ If @uri is %NULL then returns %NULL.</doc> version="1.12"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2805">Get the media fragment table from the URI, as defined by "Media Fragments URI 1.0". + line="2847">Get the media fragment table from the URI, as defined by "Media Fragments URI 1.0". Hash table returned by this API is a list of "key-value" pairs, and the each pair is generated by splitting "URI fragment" per "&" sub-delims, then "key" and "value" are split by "=" sub-delims. The "key" returned by this API may @@ -68206,11 +68270,11 @@ with #g_hash_table_unref() when it is no longer required. Modifying this hash table does not affect the fragment in the URI. See more about Media Fragments URI 1.0 (W3C) at https://www.w3.org/TR/media-frags/</doc> - <source-position filename="gst/gsturi.h" line="349"/> + <source-position filename="gst/gsturi.h" line="352"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2821">The + line="2863">The fragment hash table from the URI.</doc> <type name="GLib.HashTable" c:type="GHashTable*"> <type name="utf8"/> @@ -68224,7 +68288,7 @@ See more about Media Fragments URI 1.0 (W3C) at https://www.w3.org/TR/media-frag allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2807">The #GstUri to get the fragment table from.</doc> + line="2849">The #GstUri to get the fragment table from.</doc> <type name="Uri" c:type="const GstUri*"/> </instance-parameter> </parameters> @@ -68232,12 +68296,12 @@ See more about Media Fragments URI 1.0 (W3C) at https://www.w3.org/TR/media-frag <method name="get_path" c:identifier="gst_uri_get_path" version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2244">Extract the path string from the URI object.</doc> - <source-position filename="gst/gsturi.h" line="290"/> + line="2286">Extract the path string from the URI object.</doc> + <source-position filename="gst/gsturi.h" line="293"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2250">The path from the URI. Once finished + line="2292">The path from the URI. Once finished with the string should be g_free()'d.</doc> <type name="utf8" c:type="gchar*"/> </return-value> @@ -68245,7 +68309,7 @@ See more about Media Fragments URI 1.0 (W3C) at https://www.w3.org/TR/media-frag <instance-parameter name="uri" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2246">The #GstUri to get the path from.</doc> + line="2288">The #GstUri to get the path from.</doc> <type name="Uri" c:type="const GstUri*"/> </instance-parameter> </parameters> @@ -68255,12 +68319,12 @@ See more about Media Fragments URI 1.0 (W3C) at https://www.w3.org/TR/media-frag version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2372">Get a list of path segments from the URI.</doc> - <source-position filename="gst/gsturi.h" line="302"/> + line="2414">Get a list of path segments from the URI.</doc> + <source-position filename="gst/gsturi.h" line="305"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2378">A #GList of path segment + line="2420">A #GList of path segment strings or %NULL if no path segments are available. Free the list when no longer needed with g_list_free_full(list, g_free).</doc> <type name="GLib.List" c:type="GList*"> @@ -68274,7 +68338,7 @@ See more about Media Fragments URI 1.0 (W3C) at https://www.w3.org/TR/media-frag allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2374">The #GstUri to get the path from.</doc> + line="2416">The #GstUri to get the path from.</doc> <type name="Uri" c:type="const GstUri*"/> </instance-parameter> </parameters> @@ -68284,12 +68348,12 @@ See more about Media Fragments URI 1.0 (W3C) at https://www.w3.org/TR/media-frag version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2307">Extract the path string from the URI object as a percent encoded URI path.</doc> - <source-position filename="gst/gsturi.h" line="296"/> + line="2349">Extract the path string from the URI object as a percent encoded URI path.</doc> + <source-position filename="gst/gsturi.h" line="299"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2313">The path from the URI. Once finished + line="2355">The path from the URI. Once finished with the string should be g_free()'d.</doc> <type name="utf8" c:type="gchar*"/> </return-value> @@ -68297,7 +68361,7 @@ See more about Media Fragments URI 1.0 (W3C) at https://www.w3.org/TR/media-frag <instance-parameter name="uri" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2309">The #GstUri to get the path from.</doc> + line="2351">The #GstUri to get the path from.</doc> <type name="Uri" c:type="const GstUri*"/> </instance-parameter> </parameters> @@ -68305,13 +68369,13 @@ See more about Media Fragments URI 1.0 (W3C) at https://www.w3.org/TR/media-frag <method name="get_port" c:identifier="gst_uri_get_port" version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2203">Get the port number from the URI or %GST_URI_NO_PORT if it doesn't exist. + line="2245">Get the port number from the URI or %GST_URI_NO_PORT if it doesn't exist. If @uri is %NULL then returns %GST_URI_NO_PORT.</doc> - <source-position filename="gst/gsturi.h" line="284"/> + <source-position filename="gst/gsturi.h" line="287"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2210">The port number from the #GstUri object or %GST_URI_NO_PORT.</doc> + line="2252">The port number from the #GstUri object or %GST_URI_NO_PORT.</doc> <type name="guint" c:type="guint"/> </return-value> <parameters> @@ -68321,7 +68385,7 @@ If @uri is %NULL then returns %GST_URI_NO_PORT.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2205">This #GstUri object.</doc> + line="2247">This #GstUri object.</doc> <type name="Uri" c:type="const GstUri*"/> </instance-parameter> </parameters> @@ -68331,12 +68395,12 @@ If @uri is %NULL then returns %GST_URI_NO_PORT.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2740">Get a list of the query keys from the URI.</doc> - <source-position filename="gst/gsturi.h" line="340"/> + line="2782">Get a list of the query keys from the URI.</doc> + <source-position filename="gst/gsturi.h" line="343"/> <return-value transfer-ownership="container"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2746">A list of keys from + line="2788">A list of keys from the URI query. Free the list with g_list_free().</doc> <type name="GLib.List" c:type="GList*"> <type name="utf8"/> @@ -68349,7 +68413,7 @@ If @uri is %NULL then returns %GST_URI_NO_PORT.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2742">The #GstUri to examine.</doc> + line="2784">The #GstUri to examine.</doc> <type name="Uri" c:type="const GstUri*"/> </instance-parameter> </parameters> @@ -68359,12 +68423,12 @@ If @uri is %NULL then returns %GST_URI_NO_PORT.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2494">Get a percent encoded URI query string from the @uri.</doc> - <source-position filename="gst/gsturi.h" line="314"/> + line="2536">Get a percent encoded URI query string from the @uri.</doc> + <source-position filename="gst/gsturi.h" line="317"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2500">A percent encoded query string. Use + line="2542">A percent encoded query string. Use g_free() when no longer needed.</doc> <type name="utf8" c:type="gchar*"/> </return-value> @@ -68375,7 +68439,7 @@ If @uri is %NULL then returns %GST_URI_NO_PORT.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2496">The #GstUri to get the query string from.</doc> + line="2538">The #GstUri to get the query string from.</doc> <type name="Uri" c:type="const GstUri*"/> </instance-parameter> </parameters> @@ -68385,17 +68449,17 @@ If @uri is %NULL then returns %GST_URI_NO_PORT.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2565">Get the query table from the URI. Keys and values in the table are freed + line="2607">Get the query table from the URI. Keys and values in the table are freed with g_free when they are deleted. A value may be %NULL to indicate that the key should appear in the query string in the URI, but does not have a value. Free the returned #GHashTable with #g_hash_table_unref() when it is no longer required. Modifying this hash table will modify the query in the URI.</doc> - <source-position filename="gst/gsturi.h" line="320"/> + <source-position filename="gst/gsturi.h" line="323"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2576">The query + line="2618">The query hash table from the URI.</doc> <type name="GLib.HashTable" c:type="GHashTable*"> <type name="utf8"/> @@ -68409,7 +68473,7 @@ URI.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2567">The #GstUri to get the query table from.</doc> + line="2609">The #GstUri to get the query table from.</doc> <type name="Uri" c:type="const GstUri*"/> </instance-parameter> </parameters> @@ -68419,16 +68483,16 @@ URI.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2713">Get the value associated with the @query_key key. Will return %NULL if the + line="2755">Get the value associated with the @query_key key. Will return %NULL if the key has no value or if the key does not exist in the URI query table. Because %NULL is returned for both missing keys and keys with no value, you should use gst_uri_query_has_key() to determine if a key is present in the URI query.</doc> - <source-position filename="gst/gsturi.h" line="336"/> + <source-position filename="gst/gsturi.h" line="339"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2724">The value for the given key, or %NULL if not found.</doc> + line="2766">The value for the given key, or %NULL if not found.</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> @@ -68438,13 +68502,13 @@ query.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2715">The #GstUri to examine.</doc> + line="2757">The #GstUri to examine.</doc> <type name="Uri" c:type="const GstUri*"/> </instance-parameter> <parameter name="query_key" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2716">The key to lookup.</doc> + line="2758">The key to lookup.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -68452,13 +68516,13 @@ query.</doc> <method name="get_scheme" c:identifier="gst_uri_get_scheme"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2079">Get the scheme name from the URI or %NULL if it doesn't exist. + line="2121">Get the scheme name from the URI or %NULL if it doesn't exist. If @uri is %NULL then returns %NULL.</doc> - <source-position filename="gst/gsturi.h" line="266"/> + <source-position filename="gst/gsturi.h" line="269"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2086">The scheme from the #GstUri object or %NULL.</doc> + line="2128">The scheme from the #GstUri object or %NULL.</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> @@ -68468,7 +68532,7 @@ If @uri is %NULL then returns %NULL.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2081">This #GstUri object.</doc> + line="2123">This #GstUri object.</doc> <type name="Uri" c:type="const GstUri*"/> </instance-parameter> </parameters> @@ -68478,13 +68542,13 @@ If @uri is %NULL then returns %NULL.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2119">Get the userinfo (usually in the form "username:password") from the URI + line="2161">Get the userinfo (usually in the form "username:password") from the URI or %NULL if it doesn't exist. If @uri is %NULL then returns %NULL.</doc> - <source-position filename="gst/gsturi.h" line="272"/> + <source-position filename="gst/gsturi.h" line="275"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2126">The userinfo from the #GstUri object or %NULL.</doc> + line="2168">The userinfo from the #GstUri object or %NULL.</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> @@ -68494,7 +68558,7 @@ or %NULL if it doesn't exist. If @uri is %NULL then returns %NULL.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2121">This #GstUri object.</doc> + line="2163">This #GstUri object.</doc> <type name="Uri" c:type="const GstUri*"/> </instance-parameter> </parameters> @@ -68504,20 +68568,20 @@ or %NULL if it doesn't exist. If @uri is %NULL then returns %NULL.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2004">Tests the @uri to see if it is normalized. A %NULL @uri is considered to be + line="2046">Tests the @uri to see if it is normalized. A %NULL @uri is considered to be normalized.</doc> - <source-position filename="gst/gsturi.h" line="260"/> + <source-position filename="gst/gsturi.h" line="263"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2011">TRUE if the URI is normalized or is %NULL.</doc> + line="2053">TRUE if the URI is normalized or is %NULL.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="uri" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2006">The #GstUri to test to see if it is normalized.</doc> + line="2048">The #GstUri to test to see if it is normalized.</doc> <type name="Uri" c:type="const GstUri*"/> </instance-parameter> </parameters> @@ -68527,25 +68591,25 @@ normalized.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1884">Check if it is safe to write to this #GstUri. + line="1926">Check if it is safe to write to this #GstUri. Check if the refcount of @uri is exactly 1, meaning that no other reference exists to the #GstUri and that the #GstUri is therefore writable. Modification of a #GstUri should only be done after verifying that it is writable.</doc> - <source-position filename="gst/gsturi.h" line="251"/> + <source-position filename="gst/gsturi.h" line="254"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1896">%TRUE if it is safe to write to the object.</doc> + line="1938">%TRUE if it is safe to write to the object.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="uri" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1886">The #GstUri object to test.</doc> + line="1928">The #GstUri object to test.</doc> <type name="Uri" c:type="const GstUri*"/> </instance-parameter> </parameters> @@ -68553,14 +68617,14 @@ writable.</doc> <method name="join" c:identifier="gst_uri_join" version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1767">Join a reference URI onto a base URI using the method from RFC 3986. + line="1809">Join a reference URI onto a base URI using the method from RFC 3986. If either URI is %NULL then the other URI will be returned with the ref count increased.</doc> - <source-position filename="gst/gsturi.h" line="245"/> + <source-position filename="gst/gsturi.h" line="248"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1777">A #GstUri which represents the base + line="1819">A #GstUri which represents the base with the reference URI joined on.</doc> <type name="Uri" c:type="GstUri*"/> </return-value> @@ -68571,7 +68635,7 @@ increased.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1769">The base URI to join another to.</doc> + line="1811">The base URI to join another to.</doc> <type name="Uri" c:type="GstUri*"/> </instance-parameter> <parameter name="ref_uri" @@ -68580,7 +68644,7 @@ increased.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1770">The reference URI to join onto the + line="1812">The reference URI to join onto the base URI.</doc> <type name="Uri" c:type="GstUri*"/> </parameter> @@ -68591,24 +68655,24 @@ increased.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1907">Make the #GstUri writable. + line="1949">Make the #GstUri writable. Checks if @uri is writable, and if so the original object is returned. If not, then a writable copy is made and returned. This gives away the reference to @uri and returns a reference to the new #GstUri. If @uri is %NULL then %NULL is returned.</doc> - <source-position filename="gst/gsturi.h" line="254"/> + <source-position filename="gst/gsturi.h" line="257"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1918">A writable version of @uri.</doc> + line="1960">A writable version of @uri.</doc> <type name="Uri" c:type="GstUri*"/> </return-value> <parameters> <instance-parameter name="uri" transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1909">The #GstUri object to make writable.</doc> + line="1951">The #GstUri object to make writable.</doc> <type name="Uri" c:type="GstUri*"/> </instance-parameter> </parameters> @@ -68704,24 +68768,24 @@ If @uri is %NULL then %NULL is returned.</doc> <method name="normalize" c:identifier="gst_uri_normalize" version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2051">Normalization will remove extra path segments ("." and "..") from the URI. It + line="2093">Normalization will remove extra path segments ("." and "..") from the URI. It will also convert the scheme and host name to lower case and any percent-encoded values to uppercase. The #GstUri object must be writable. Check with gst_uri_is_writable() or use gst_uri_make_writable() first.</doc> - <source-position filename="gst/gsturi.h" line="263"/> + <source-position filename="gst/gsturi.h" line="266"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2062">TRUE if the URI was modified.</doc> + line="2104">TRUE if the URI was modified.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="uri" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2053">The #GstUri to normalize.</doc> + line="2095">The #GstUri to normalize.</doc> <type name="Uri" c:type="GstUri*"/> </instance-parameter> </parameters> @@ -68731,12 +68795,12 @@ gst_uri_make_writable() first.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2690">Check if there is a query table entry for the @query_key key.</doc> - <source-position filename="gst/gsturi.h" line="332"/> + line="2732">Check if there is a query table entry for the @query_key key.</doc> + <source-position filename="gst/gsturi.h" line="335"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2697">%TRUE if @query_key exists in the URI query table.</doc> + line="2739">%TRUE if @query_key exists in the URI query table.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> @@ -68746,13 +68810,13 @@ gst_uri_make_writable() first.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2692">The #GstUri to examine.</doc> + line="2734">The #GstUri to examine.</doc> <type name="Uri" c:type="const GstUri*"/> </instance-parameter> <parameter name="query_key" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2693">The key to lookup.</doc> + line="2735">The key to lookup.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -68762,12 +68826,12 @@ gst_uri_make_writable() first.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2659">Remove an entry from the query table by key.</doc> - <source-position filename="gst/gsturi.h" line="329"/> + line="2701">Remove an entry from the query table by key.</doc> + <source-position filename="gst/gsturi.h" line="332"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2666">%TRUE if the key existed in the table and was removed.</doc> + line="2708">%TRUE if the key existed in the table and was removed.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> @@ -68777,13 +68841,13 @@ gst_uri_make_writable() first.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2661">The #GstUri to modify.</doc> + line="2703">The #GstUri to modify.</doc> <type name="Uri" c:type="GstUri*"/> </instance-parameter> <parameter name="query_key" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2662">The key to remove.</doc> + line="2704">The key to remove.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -68793,13 +68857,13 @@ gst_uri_make_writable() first.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2781">Sets the fragment string in the URI. Use a value of %NULL in @fragment to + line="2823">Sets the fragment string in the URI. Use a value of %NULL in @fragment to unset the fragment string.</doc> - <source-position filename="gst/gsturi.h" line="346"/> + <source-position filename="gst/gsturi.h" line="349"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2789">%TRUE if the fragment was set/unset successfully.</doc> + line="2831">%TRUE if the fragment was set/unset successfully.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> @@ -68809,7 +68873,7 @@ unset the fragment string.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2783">The #GstUri to modify.</doc> + line="2825">The #GstUri to modify.</doc> <type name="Uri" c:type="GstUri*"/> </instance-parameter> <parameter name="fragment" @@ -68818,7 +68882,7 @@ unset the fragment string.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2784">The fragment string to set.</doc> + line="2826">The fragment string to set.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -68826,12 +68890,12 @@ unset the fragment string.</doc> <method name="set_host" c:identifier="gst_uri_set_host" version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2179">Set or unset the host for the URI.</doc> - <source-position filename="gst/gsturi.h" line="281"/> + line="2221">Set or unset the host for the URI.</doc> + <source-position filename="gst/gsturi.h" line="284"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2186">%TRUE if the host was set/unset successfully.</doc> + line="2228">%TRUE if the host was set/unset successfully.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> @@ -68841,13 +68905,13 @@ unset the fragment string.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2181">The #GstUri to modify.</doc> + line="2223">The #GstUri to modify.</doc> <type name="Uri" c:type="GstUri*"/> </instance-parameter> <parameter name="host" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2182">The new host string to set or %NULL to unset.</doc> + line="2224">The new host string to set or %NULL to unset.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -68855,12 +68919,12 @@ unset the fragment string.</doc> <method name="set_path" c:identifier="gst_uri_set_path" version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2282">Sets or unsets the path in the URI.</doc> - <source-position filename="gst/gsturi.h" line="293"/> + line="2324">Sets or unsets the path in the URI.</doc> + <source-position filename="gst/gsturi.h" line="296"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2290">%TRUE if the path was set successfully.</doc> + line="2332">%TRUE if the path was set successfully.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> @@ -68870,13 +68934,13 @@ unset the fragment string.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2284">The #GstUri to modify.</doc> + line="2326">The #GstUri to modify.</doc> <type name="Uri" c:type="GstUri*"/> </instance-parameter> <parameter name="path" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2285">The new path to set with path segments separated by '/', or use %NULL + line="2327">The new path to set with path segments separated by '/', or use %NULL to unset the path.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> @@ -68887,12 +68951,12 @@ unset the fragment string.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2398">Replace the path segments list in the URI.</doc> - <source-position filename="gst/gsturi.h" line="305"/> + line="2440">Replace the path segments list in the URI.</doc> + <source-position filename="gst/gsturi.h" line="308"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2406">%TRUE if the path segments were set successfully.</doc> + line="2448">%TRUE if the path segments were set successfully.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> @@ -68902,7 +68966,7 @@ unset the fragment string.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2400">The #GstUri to modify.</doc> + line="2442">The #GstUri to modify.</doc> <type name="Uri" c:type="GstUri*"/> </instance-parameter> <parameter name="path_segments" @@ -68911,7 +68975,7 @@ unset the fragment string.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2401">The new + line="2443">The new path list to set.</doc> <type name="GLib.List" c:type="GList*"> <type name="utf8"/> @@ -68924,12 +68988,12 @@ unset the fragment string.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2348">Sets or unsets the path in the URI.</doc> - <source-position filename="gst/gsturi.h" line="299"/> + line="2390">Sets or unsets the path in the URI.</doc> + <source-position filename="gst/gsturi.h" line="302"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2356">%TRUE if the path was set successfully.</doc> + line="2398">%TRUE if the path was set successfully.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> @@ -68939,13 +69003,13 @@ unset the fragment string.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2350">The #GstUri to modify.</doc> + line="2392">The #GstUri to modify.</doc> <type name="Uri" c:type="GstUri*"/> </instance-parameter> <parameter name="path" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2351">The new percent encoded path to set with path segments separated by + line="2393">The new percent encoded path to set with path segments separated by '/', or use %NULL to unset the path.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> @@ -68954,12 +69018,12 @@ unset the fragment string.</doc> <method name="set_port" c:identifier="gst_uri_set_port" version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2221">Set or unset the port number for the URI.</doc> - <source-position filename="gst/gsturi.h" line="287"/> + line="2263">Set or unset the port number for the URI.</doc> + <source-position filename="gst/gsturi.h" line="290"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2228">%TRUE if the port number was set/unset successfully.</doc> + line="2270">%TRUE if the port number was set/unset successfully.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> @@ -68969,13 +69033,13 @@ unset the fragment string.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2223">The #GstUri to modify.</doc> + line="2265">The #GstUri to modify.</doc> <type name="Uri" c:type="GstUri*"/> </instance-parameter> <parameter name="port" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2224">The new port number to set or %GST_URI_NO_PORT to unset.</doc> + line="2266">The new port number to set or %GST_URI_NO_PORT to unset.</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -68985,12 +69049,12 @@ unset the fragment string.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2538">Sets or unsets the query table in the URI.</doc> - <source-position filename="gst/gsturi.h" line="317"/> + line="2580">Sets or unsets the query table in the URI.</doc> + <source-position filename="gst/gsturi.h" line="320"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2546">%TRUE if the query table was set successfully.</doc> + line="2588">%TRUE if the query table was set successfully.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> @@ -69000,13 +69064,13 @@ unset the fragment string.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2540">The #GstUri to modify.</doc> + line="2582">The #GstUri to modify.</doc> <type name="Uri" c:type="GstUri*"/> </instance-parameter> <parameter name="query" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2541">The new percent encoded query string to use to populate the query + line="2583">The new percent encoded query string to use to populate the query table, or use %NULL to unset the query table.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> @@ -69017,14 +69081,14 @@ unset the fragment string.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2593">Set the query table to use in the URI. The old table is unreferenced and a + line="2635">Set the query table to use in the URI. The old table is unreferenced and a reference to the new one is used instead. A value if %NULL for @query_table will remove the query string from the URI.</doc> - <source-position filename="gst/gsturi.h" line="323"/> + <source-position filename="gst/gsturi.h" line="326"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2603">%TRUE if the new table was successfully used for the query table.</doc> + line="2645">%TRUE if the new table was successfully used for the query table.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> @@ -69034,7 +69098,7 @@ will remove the query string from the URI.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2595">The #GstUri to modify.</doc> + line="2637">The #GstUri to modify.</doc> <type name="Uri" c:type="GstUri*"/> </instance-parameter> <parameter name="query_table" @@ -69043,7 +69107,7 @@ will remove the query string from the URI.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2596">The new + line="2638">The new query table to use.</doc> <type name="GLib.HashTable" c:type="GHashTable*"> <type name="utf8"/> @@ -69057,14 +69121,14 @@ will remove the query string from the URI.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2627">This inserts or replaces a key in the query table. A @query_value of %NULL + line="2669">This inserts or replaces a key in the query table. A @query_value of %NULL indicates that the key has no associated value, but will still be present in the query string.</doc> - <source-position filename="gst/gsturi.h" line="326"/> + <source-position filename="gst/gsturi.h" line="329"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2637">%TRUE if the query table was successfully updated.</doc> + line="2679">%TRUE if the query table was successfully updated.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> @@ -69074,13 +69138,13 @@ the query string.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2629">The #GstUri to modify.</doc> + line="2671">The #GstUri to modify.</doc> <type name="Uri" c:type="GstUri*"/> </instance-parameter> <parameter name="query_key" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2630">The key for the query entry.</doc> + line="2672">The key for the query entry.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="query_value" @@ -69089,7 +69153,7 @@ the query string.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2631">The value for the key.</doc> + line="2673">The value for the key.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -69099,12 +69163,12 @@ the query string.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2095">Set or unset the scheme for the URI.</doc> - <source-position filename="gst/gsturi.h" line="269"/> + line="2137">Set or unset the scheme for the URI.</doc> + <source-position filename="gst/gsturi.h" line="272"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2102">%TRUE if the scheme was set/unset successfully.</doc> + line="2144">%TRUE if the scheme was set/unset successfully.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> @@ -69114,13 +69178,13 @@ the query string.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2097">The #GstUri to modify.</doc> + line="2139">The #GstUri to modify.</doc> <type name="Uri" c:type="GstUri*"/> </instance-parameter> <parameter name="scheme" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2098">The new scheme to set or %NULL to unset the scheme.</doc> + line="2140">The new scheme to set or %NULL to unset the scheme.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -69130,12 +69194,12 @@ the query string.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2137">Set or unset the user information for the URI.</doc> - <source-position filename="gst/gsturi.h" line="275"/> + line="2179">Set or unset the user information for the URI.</doc> + <source-position filename="gst/gsturi.h" line="278"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2144">%TRUE if the user information was set/unset successfully.</doc> + line="2186">%TRUE if the user information was set/unset successfully.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> @@ -69145,13 +69209,13 @@ the query string.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2139">The #GstUri to modify.</doc> + line="2181">The #GstUri to modify.</doc> <type name="Uri" c:type="GstUri*"/> </instance-parameter> <parameter name="userinfo" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="2140">The new user-information string to set or %NULL to unset.</doc> + line="2182">The new user-information string to set or %NULL to unset.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -69159,23 +69223,23 @@ the query string.</doc> <method name="to_string" c:identifier="gst_uri_to_string" version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1930">Convert the URI to a string. + line="1972">Convert the URI to a string. Returns the URI as held in this object as a #gchar* nul-terminated string. The caller should g_free() the string once they are finished with it. The string is put together as described in RFC 3986.</doc> - <source-position filename="gst/gsturi.h" line="257"/> + <source-position filename="gst/gsturi.h" line="260"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1940">The string version of the URI.</doc> + line="1982">The string version of the URI.</doc> <type name="utf8" c:type="gchar*"/> </return-value> <parameters> <instance-parameter name="uri" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1932">This #GstUri to convert to a string.</doc> + line="1974">This #GstUri to convert to a string.</doc> <type name="Uri" c:type="const GstUri*"/> </instance-parameter> </parameters> @@ -69217,20 +69281,54 @@ Free-function: g_free</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1500">Parses a URI string into a new #GstUri object. Will return NULL if the URI + line="1627">Parses a URI string into a new #GstUri object. Will return NULL if the URI cannot be parsed.</doc> <source-position filename="gst/gsturi.h" line="236"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1507">A new #GstUri object, or NULL.</doc> + line="1634">A new #GstUri object, or NULL.</doc> + <type name="Uri" c:type="GstUri*"/> + </return-value> + <parameters> + <parameter name="uri" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst/gsturi.c" + line="1629">The URI string to parse.</doc> + <type name="utf8" c:type="const gchar*"/> + </parameter> + </parameters> + </function> + <function name="from_string_escaped" + c:identifier="gst_uri_from_string_escaped" + version="1.18"> + <doc xml:space="preserve" + filename="gst/gsturi.c" + line="1644">Parses a URI string into a new #GstUri object. Will return NULL if the URI +cannot be parsed. This is identical to gst_uri_from_string() except that +the userinfo and fragment components of the URI will not be unescaped while +parsing. + +Use this when you need to extract a username and password from the userinfo +such as https://user:password@example.com since either may contain +a URI-escaped ':' character. gst_uri_from_string() will unescape the entire +userinfo component, which will make it impossible to know which ':' +delineates the username and password. + +The same applies to the fragment component of the URI, such as +https://example.com/path#fragment which may contain a URI-escaped '#'.</doc> + <source-position filename="gst/gsturi.h" line="239"/> + <return-value transfer-ownership="full" nullable="1"> + <doc xml:space="preserve" + filename="gst/gsturi.c" + line="1662">A new #GstUri object, or NULL.</doc> <type name="Uri" c:type="GstUri*"/> </return-value> <parameters> <parameter name="uri" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1502">The URI string to parse.</doc> + line="1646">The URI string to parse.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -69335,13 +69433,13 @@ scheme followed by ":" and maybe a string identifying the location.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1856">This is a convenience function to join two URI strings and return the result. + line="1898">This is a convenience function to join two URI strings and return the result. The returned string should be g_free()'d after use.</doc> - <source-position filename="gst/gsturi.h" line="248"/> + <source-position filename="gst/gsturi.h" line="251"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1864">A string representing the percent-encoded join of + line="1906">A string representing the percent-encoded join of the two URIs.</doc> <type name="utf8" c:type="gchar*"/> </return-value> @@ -69349,13 +69447,13 @@ The returned string should be g_free()'d after use.</doc> <parameter name="base_uri" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1858">The percent-encoded base URI.</doc> + line="1900">The percent-encoded base URI.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="ref_uri" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1859">The percent-encoded reference URI to join to the @base_uri.</doc> + line="1901">The percent-encoded reference URI to join to the @base_uri.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -69687,7 +69785,7 @@ determine a order for the two provided values.</doc> <source-position filename="gst/gstversion.h" line="63"/> <type name="gint" c:type="gint"/> </constant> - <constant name="VERSION_MINOR" value="17" c:type="GST_VERSION_MINOR"> + <constant name="VERSION_MINOR" value="18" c:type="GST_VERSION_MINOR"> <doc xml:space="preserve" filename="gst/gstversion.h" line="52">The minor version of GStreamer at compile time:</doc> @@ -70379,7 +70477,7 @@ Free-function: g_free</doc> version="1.2"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="497">Get the maximum amount of memory blocks that a buffer can hold. This is a + line="500">Get the maximum amount of memory blocks that a buffer can hold. This is a compile time constant that can be queried with the function. When more memory blocks are added, existing memory blocks will be merged @@ -70388,7 +70486,7 @@ together to make room for the new block.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="506">the maximum amount of memory blocks that a buffer can hold.</doc> + line="509">the maximum amount of memory blocks that a buffer can hold.</doc> <type name="guint" c:type="guint"/> </return-value> </function> @@ -70593,7 +70691,7 @@ amount of memory allocated as @xy, i.e. 2*n*sizeof(GstClockTime). > between them. It will not calculate the exact results if the differences > between neighbouring values are too small due to not being able to > represent sub-integer values during the calculations.</doc> - <source-position filename="gst/gstutils.h" line="1213"/> + <source-position filename="gst/gstutils.h" line="1216"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -70698,7 +70796,7 @@ Free-function: gst_caps_features_free</doc> moved-to="Caps.from_string"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2475">Converts @caps from a string representation. + line="2476">Converts @caps from a string representation. The current implementation of serialization will lead to unexpected results when there are nested #GstCaps / #GstStructure deeper than one level.</doc> @@ -70706,14 +70804,14 @@ when there are nested #GstCaps / #GstStructure deeper than one level.</doc> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2484">a newly allocated #GstCaps</doc> + line="2485">a newly allocated #GstCaps</doc> <type name="Caps" c:type="GstCaps*"/> </return-value> <parameters> <parameter name="string" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstcaps.c" - line="2477">a string to convert to #GstCaps</doc> + line="2478">a string to convert to #GstCaps</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -70906,7 +71004,7 @@ pointer casts.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="551">Clears a reference to a #GstStructure. + line="549">Clears a reference to a #GstStructure. @structure_ptr must not be %NULL. @@ -70924,7 +71022,7 @@ pointer casts.</doc> <parameter name="structure_ptr" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="553">a pointer to a #GstStructure reference</doc> + line="551">a pointer to a #GstStructure reference</doc> <type name="Structure" c:type="GstStructure**"/> </parameter> </parameters> @@ -70973,9 +71071,9 @@ returned.</doc> c:identifier="gst_debug_add_log_function"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1353">Adds the logging function to the list of logging functions. + line="1407">Adds the logging function to the list of logging functions. Be sure to use #G_GNUC_NO_INSTRUMENT on that function, it is needed.</doc> - <source-position filename="gst/gstinfo.h" line="414"/> + <source-position filename="gst/gstinfo.h" line="440"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -70987,7 +71085,7 @@ Be sure to use #G_GNUC_NO_INSTRUMENT on that function, it is needed.</doc> destroy="2"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1355">the function to use</doc> + line="1409">the function to use</doc> <type name="LogFunction" c:type="GstLogFunction"/> </parameter> <parameter name="user_data" @@ -70996,13 +71094,13 @@ Be sure to use #G_GNUC_NO_INSTRUMENT on that function, it is needed.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1356">user data</doc> + line="1410">user data</doc> <type name="gpointer" c:type="gpointer"/> </parameter> <parameter name="notify" transfer-ownership="none" scope="async"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1357">called when @user_data is not used anymore</doc> + line="1411">called when @user_data is not used anymore</doc> <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/> </parameter> </parameters> @@ -71012,14 +71110,14 @@ Be sure to use #G_GNUC_NO_INSTRUMENT on that function, it is needed.</doc> version="1.14"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="3272">Adds a memory ringbuffer based debug logger that stores up to + line="3404">Adds a memory ringbuffer based debug logger that stores up to @max_size_per_thread bytes of logs per thread and times out threads after @thread_timeout seconds of inactivity. Logs can be fetched with gst_debug_ring_buffer_logger_get_logs() and the logger can be removed again with gst_debug_remove_ring_buffer_logger(). Only one logger at a time is possible.</doc> - <source-position filename="gst/gstinfo.h" line="1771"/> + <source-position filename="gst/gstinfo.h" line="1794"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -71027,13 +71125,13 @@ Only one logger at a time is possible.</doc> <parameter name="max_size_per_thread" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="3274">Maximum size of log per thread in bytes</doc> + line="3406">Maximum size of log per thread in bytes</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="thread_timeout" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="3275">Timeout for threads in seconds</doc> + line="3407">Timeout for threads in seconds</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -71139,14 +71237,14 @@ to the filename, so that it can be used to take multiple snapshots.</doc> c:identifier="gst_debug_construct_term_color"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="977">Constructs a string that can be used for getting the desired color in color + line="988">Constructs a string that can be used for getting the desired color in color terminals. You need to free the string after use.</doc> - <source-position filename="gst/gstinfo.h" line="486"/> + <source-position filename="gst/gstinfo.h" line="512"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="985">a string containing the color + line="996">a string containing the color definition</doc> <type name="utf8" c:type="gchar*"/> </return-value> @@ -71154,7 +71252,7 @@ You need to free the string after use.</doc> <parameter name="colorinfo" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="979">the color info</doc> + line="990">the color info</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -71163,23 +71261,23 @@ You need to free the string after use.</doc> c:identifier="gst_debug_construct_win_color"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1013">Constructs an integer that can be used for getting the desired color in + line="1024">Constructs an integer that can be used for getting the desired color in windows' terminals (cmd.exe). As there is no mean to underline, we simply ignore this attribute. This function returns 0 on non-windows machines.</doc> - <source-position filename="gst/gstinfo.h" line="489"/> + <source-position filename="gst/gstinfo.h" line="515"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1023">an integer containing the color definition</doc> + line="1034">an integer containing the color definition</doc> <type name="gint" c:type="gint"/> </return-value> <parameters> <parameter name="colorinfo" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1015">the color info</doc> + line="1026">the color info</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -71188,14 +71286,14 @@ This function returns 0 on non-windows machines.</doc> c:identifier="gst_debug_get_all_categories"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1916">Returns a snapshot of a all categories that are currently in use . This list + line="1970">Returns a snapshot of a all categories that are currently in use . This list may change anytime. The caller has to free the list after use.</doc> - <source-position filename="gst/gstinfo.h" line="482"/> + <source-position filename="gst/gstinfo.h" line="508"/> <return-value transfer-ownership="container"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1923">the list of + line="1977">the list of debug categories</doc> <type name="GLib.SList" c:type="GSList*"> <type name="DebugCategory"/> @@ -71207,12 +71305,12 @@ The caller has to free the list after use.</doc> version="1.2"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1576">Changes the coloring mode for debug output.</doc> - <source-position filename="gst/gstinfo.h" line="442"/> + line="1630">Changes the coloring mode for debug output.</doc> + <source-position filename="gst/gstinfo.h" line="468"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1581">see @GstDebugColorMode for possible values.</doc> + line="1635">see @GstDebugColorMode for possible values.</doc> <type name="DebugColorMode" c:type="GstDebugColorMode"/> </return-value> </function> @@ -71220,23 +71318,23 @@ The caller has to free the list after use.</doc> c:identifier="gst_debug_get_default_threshold"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1640">Returns the default threshold that is used for new categories.</doc> - <source-position filename="gst/gstinfo.h" line="448"/> + line="1694">Returns the default threshold that is used for new categories.</doc> + <source-position filename="gst/gstinfo.h" line="474"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1645">the default threshold level</doc> + line="1699">the default threshold level</doc> <type name="DebugLevel" c:type="GstDebugLevel"/> </return-value> </function> <function name="debug_get_stack_trace" c:identifier="gst_debug_get_stack_trace" version="1.12"> - <source-position filename="gst/gstinfo.h" line="1768"/> + <source-position filename="gst/gstinfo.h" line="1791"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="3004">a stack trace, if libunwind or glibc backtrace are + line="3136">a stack trace, if libunwind or glibc backtrace are present, else %NULL.</doc> <type name="utf8" c:type="gchar*"/> </return-value> @@ -71244,7 +71342,7 @@ present, else %NULL.</doc> <parameter name="flags" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="3001">A set of #GstStackTraceFlags to determine how the stack trace should + line="3133">A set of #GstStackTraceFlags to determine how the stack trace should look like. Pass #GST_STACK_TRACE_SHOW_NONE to retrieve a minimal backtrace.</doc> <type name="StackTraceFlags" c:type="GstStackTraceFlags"/> </parameter> @@ -71253,24 +71351,24 @@ look like. Pass #GST_STACK_TRACE_SHOW_NONE to retrieve a minimal backtrace.</doc <function name="debug_is_active" c:identifier="gst_debug_is_active"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1611">Checks if debugging output is activated.</doc> - <source-position filename="gst/gstinfo.h" line="427"/> + line="1665">Checks if debugging output is activated.</doc> + <source-position filename="gst/gstinfo.h" line="453"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1616">%TRUE, if debugging is activated</doc> + line="1670">%TRUE, if debugging is activated</doc> <type name="gboolean" c:type="gboolean"/> </return-value> </function> <function name="debug_is_colored" c:identifier="gst_debug_is_colored"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1562">Checks if the debugging output should be colored.</doc> - <source-position filename="gst/gstinfo.h" line="439"/> + line="1616">Checks if the debugging output should be colored.</doc> + <source-position filename="gst/gstinfo.h" line="465"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1567">%TRUE, if the debug output should be colored.</doc> + line="1621">%TRUE, if the debug output should be colored.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> </function> @@ -71279,19 +71377,19 @@ look like. Pass #GST_STACK_TRACE_SHOW_NONE to retrieve a minimal backtrace.</doc moved-to="DebugLevel.get_name"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1317">Get the string representation of a debugging level</doc> - <source-position filename="gst/gstinfo.h" line="411"/> + line="1371">Get the string representation of a debugging level</doc> + <source-position filename="gst/gstinfo.h" line="437"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1323">the name</doc> + line="1377">the name</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> <parameter name="level" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1319">the level to get the name for</doc> + line="1373">the level to get the name for</doc> <type name="DebugLevel" c:type="GstDebugLevel"/> </parameter> </parameters> @@ -71299,8 +71397,8 @@ look like. Pass #GST_STACK_TRACE_SHOW_NONE to retrieve a minimal backtrace.</doc <function name="debug_log" c:identifier="gst_debug_log" introspectable="0"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="490">Logs the given message using the currently registered debugging handlers.</doc> - <source-position filename="gst/gstinfo.h" line="332"/> + line="491">Logs the given message using the currently registered debugging handlers.</doc> + <source-position filename="gst/gstinfo.h" line="358"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -71308,31 +71406,31 @@ look like. Pass #GST_STACK_TRACE_SHOW_NONE to retrieve a minimal backtrace.</doc <parameter name="category" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="492">category to log</doc> + line="493">category to log</doc> <type name="DebugCategory" c:type="GstDebugCategory*"/> </parameter> <parameter name="level" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="493">level of the message is in</doc> + line="494">level of the message is in</doc> <type name="DebugLevel" c:type="GstDebugLevel"/> </parameter> <parameter name="file" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="494">the file that emitted the message, usually the __FILE__ identifier</doc> + line="495">the file that emitted the message, usually the __FILE__ identifier</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="function" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="495">the function that emitted the message</doc> + line="496">the function that emitted the message</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="line" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="496">the line from that the message was emitted, usually __LINE__</doc> + line="497">the line from that the message was emitted, usually __LINE__</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="object" @@ -71341,20 +71439,20 @@ look like. Pass #GST_STACK_TRACE_SHOW_NONE to retrieve a minimal backtrace.</doc allow-none="1"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="497">the object this message relates to, + line="498">the object this message relates to, or %NULL if none</doc> <type name="GObject.Object" c:type="GObject*"/> </parameter> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="499">a printf style format string</doc> + line="500">a printf style format string</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="..." transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="500">optional arguments for the format</doc> + line="501">optional arguments for the format</doc> <varargs/> </parameter> </parameters> @@ -71362,7 +71460,7 @@ look like. Pass #GST_STACK_TRACE_SHOW_NONE to retrieve a minimal backtrace.</doc <function name="debug_log_default" c:identifier="gst_debug_log_default"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1202">The default logging handler used by GStreamer. Logging functions get called + line="1250">The default logging handler used by GStreamer. Logging functions get called whenever a macro like GST_DEBUG or similar is used. By default this function is setup to output the message and additional info to stderr (or the log file specified via the GST_DEBUG_FILE environment variable) as received via @@ -71371,7 +71469,7 @@ specified via the GST_DEBUG_FILE environment variable) as received via You can add other handlers by using gst_debug_add_log_function(). And you can remove this handler by calling gst_debug_remove_log_function(gst_debug_log_default);</doc> - <source-position filename="gst/gstinfo.h" line="401"/> + <source-position filename="gst/gstinfo.h" line="427"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -71379,31 +71477,31 @@ gst_debug_remove_log_function(gst_debug_log_default);</doc> <parameter name="category" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1204">category to log</doc> + line="1252">category to log</doc> <type name="DebugCategory" c:type="GstDebugCategory*"/> </parameter> <parameter name="level" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1205">level of the message</doc> + line="1253">level of the message</doc> <type name="DebugLevel" c:type="GstDebugLevel"/> </parameter> <parameter name="file" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1206">the file that emitted the message, usually the __FILE__ identifier</doc> + line="1254">the file that emitted the message, usually the __FILE__ identifier</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="function" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1207">the function that emitted the message</doc> + line="1255">the function that emitted the message</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="line" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1208">the line from that the message was emitted, usually __LINE__</doc> + line="1256">the line from that the message was emitted, usually __LINE__</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="object" @@ -71412,14 +71510,14 @@ gst_debug_remove_log_function(gst_debug_log_default);</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1210">the object this message relates to, + line="1258">the object this message relates to, or %NULL if none</doc> <type name="GObject.Object" c:type="GObject*"/> </parameter> <parameter name="message" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1209">the actual message</doc> + line="1257">the actual message</doc> <type name="DebugMessage" c:type="GstDebugMessage*"/> </parameter> <parameter name="user_data" @@ -71428,7 +71526,7 @@ gst_debug_remove_log_function(gst_debug_log_default);</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1212">the FILE* to log to</doc> + line="1260">the FILE* to log to</doc> <type name="gpointer" c:type="gpointer"/> </parameter> </parameters> @@ -71438,12 +71536,12 @@ gst_debug_remove_log_function(gst_debug_log_default);</doc> version="1.18"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1161">Returns the string representation for the specified debug log message + line="1172">Returns the string representation for the specified debug log message formatted in the same way as gst_debug_log_default() (the default handler), without color. The purpose is to make it easy for custom log output handlers to get a log output that is identical to what the default handler would write out.</doc> - <source-position filename="gst/gstinfo.h" line="392"/> + <source-position filename="gst/gstinfo.h" line="418"/> <return-value transfer-ownership="full"> <type name="utf8" c:type="gchar*"/> </return-value> @@ -71451,31 +71549,31 @@ would write out.</doc> <parameter name="category" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1163">category to log</doc> + line="1174">category to log</doc> <type name="DebugCategory" c:type="GstDebugCategory*"/> </parameter> <parameter name="level" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1164">level of the message</doc> + line="1175">level of the message</doc> <type name="DebugLevel" c:type="GstDebugLevel"/> </parameter> <parameter name="file" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1165">the file that emitted the message, usually the __FILE__ identifier</doc> + line="1176">the file that emitted the message, usually the __FILE__ identifier</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="function" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1166">the function that emitted the message</doc> + line="1177">the function that emitted the message</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="line" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1167">the line from that the message was emitted, usually __LINE__</doc> + line="1178">the line from that the message was emitted, usually __LINE__</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="object" @@ -71484,14 +71582,14 @@ would write out.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1168">the object this message relates to, + line="1179">the object this message relates to, or %NULL if none</doc> <type name="GObject.Object" c:type="GObject*"/> </parameter> <parameter name="message" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1170">the actual message</doc> + line="1181">the actual message</doc> <type name="DebugMessage" c:type="GstDebugMessage*"/> </parameter> </parameters> @@ -71501,8 +71599,8 @@ would write out.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="540">Logs the given message using the currently registered debugging handlers.</doc> - <source-position filename="gst/gstinfo.h" line="341"/> + line="541">Logs the given message using the currently registered debugging handlers.</doc> + <source-position filename="gst/gstinfo.h" line="367"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -71510,31 +71608,31 @@ would write out.</doc> <parameter name="category" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="542">category to log</doc> + line="543">category to log</doc> <type name="DebugCategory" c:type="GstDebugCategory*"/> </parameter> <parameter name="level" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="543">level of the message is in</doc> + line="544">level of the message is in</doc> <type name="DebugLevel" c:type="GstDebugLevel"/> </parameter> <parameter name="file" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="544">the file that emitted the message, usually the __FILE__ identifier</doc> + line="545">the file that emitted the message, usually the __FILE__ identifier</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="function" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="545">the function that emitted the message</doc> + line="546">the function that emitted the message</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="line" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="546">the line from that the message was emitted, usually __LINE__</doc> + line="547">the line from that the message was emitted, usually __LINE__</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="object" @@ -71543,20 +71641,20 @@ would write out.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="547">the object this message relates to, + line="548">the object this message relates to, or %NULL if none</doc> <type name="GObject.Object" c:type="GObject*"/> </parameter> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="549">a printf style format string</doc> + line="550">a printf style format string</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="args" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="550">optional arguments for the format</doc> + line="551">optional arguments for the format</doc> <type name="va_list" c:type="va_list"/> </parameter> </parameters> @@ -71565,9 +71663,9 @@ would write out.</doc> c:identifier="gst_debug_print_stack_trace"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="3034">If libunwind, glibc backtrace or DbgHelp are present + line="3166">If libunwind, glibc backtrace or DbgHelp are present a stack trace is printed.</doc> - <source-position filename="gst/gstinfo.h" line="1765"/> + <source-position filename="gst/gstinfo.h" line="1788"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -71576,12 +71674,12 @@ a stack trace is printed.</doc> c:identifier="gst_debug_remove_log_function"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1445">Removes all registered instances of the given logging functions.</doc> - <source-position filename="gst/gstinfo.h" line="418"/> + line="1499">Removes all registered instances of the given logging functions.</doc> + <source-position filename="gst/gstinfo.h" line="444"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1452">How many instances of the function were removed</doc> + line="1506">How many instances of the function were removed</doc> <type name="guint" c:type="guint"/> </return-value> <parameters> @@ -71592,7 +71690,7 @@ a stack trace is printed.</doc> scope="call"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1447">the log function to remove, or %NULL to + line="1501">the log function to remove, or %NULL to remove the default log function</doc> <type name="LogFunction" c:type="GstLogFunction"/> </parameter> @@ -71602,12 +71700,12 @@ a stack trace is printed.</doc> c:identifier="gst_debug_remove_log_function_by_data"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1481">Removes all registered instances of log functions with the given user data.</doc> - <source-position filename="gst/gstinfo.h" line="421"/> + line="1535">Removes all registered instances of log functions with the given user data.</doc> + <source-position filename="gst/gstinfo.h" line="447"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1487">How many instances of the function were removed</doc> + line="1541">How many instances of the function were removed</doc> <type name="guint" c:type="guint"/> </return-value> <parameters> @@ -71617,7 +71715,7 @@ a stack trace is printed.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1483">user data of the log function to remove</doc> + line="1537">user data of the log function to remove</doc> <type name="gpointer" c:type="gpointer"/> </parameter> </parameters> @@ -71627,9 +71725,9 @@ a stack trace is printed.</doc> version="1.14"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="3313">Removes any previously added ring buffer logger with + line="3445">Removes any previously added ring buffer logger with gst_debug_add_ring_buffer_logger().</doc> - <source-position filename="gst/gstinfo.h" line="1773"/> + <source-position filename="gst/gstinfo.h" line="1796"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -71639,13 +71737,13 @@ gst_debug_add_ring_buffer_logger().</doc> version="1.14"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="3206">Fetches the current logs per thread from the ring buffer logger. See + line="3338">Fetches the current logs per thread from the ring buffer logger. See gst_debug_add_ring_buffer_logger() for details.</doc> - <source-position filename="gst/gstinfo.h" line="1775"/> + <source-position filename="gst/gstinfo.h" line="1798"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="3212">NULL-terminated array of + line="3344">NULL-terminated array of strings with the debug output per thread</doc> <array c:type="gchar**"> <type name="utf8"/> @@ -71655,12 +71753,12 @@ strings with the debug output per thread</doc> <function name="debug_set_active" c:identifier="gst_debug_set_active"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1591">If activated, debugging messages are sent to the debugging + line="1645">If activated, debugging messages are sent to the debugging handlers. It makes sense to deactivate it for speed issues. > This function is not threadsafe. It makes sense to only call it during initialization.</doc> - <source-position filename="gst/gstinfo.h" line="424"/> + <source-position filename="gst/gstinfo.h" line="450"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -71668,7 +71766,7 @@ during initialization.</doc> <parameter name="active" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1593">Whether to use debugging output or not</doc> + line="1647">Whether to use debugging output or not</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -71678,10 +71776,10 @@ during initialization.</doc> version="1.2"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1524">Changes the coloring mode for debug output. + line="1578">Changes the coloring mode for debug output. This function may be called before gst_init().</doc> - <source-position filename="gst/gstinfo.h" line="433"/> + <source-position filename="gst/gstinfo.h" line="459"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -71689,7 +71787,7 @@ This function may be called before gst_init().</doc> <parameter name="mode" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1526">The coloring mode for debug output. See @GstDebugColorMode.</doc> + line="1580">The coloring mode for debug output. See @GstDebugColorMode.</doc> <type name="DebugColorMode" c:type="GstDebugColorMode"/> </parameter> </parameters> @@ -71699,10 +71797,10 @@ This function may be called before gst_init().</doc> version="1.2"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1540">Changes the coloring mode for debug output. + line="1594">Changes the coloring mode for debug output. This function may be called before gst_init().</doc> - <source-position filename="gst/gstinfo.h" line="436"/> + <source-position filename="gst/gstinfo.h" line="462"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -71710,7 +71808,7 @@ This function may be called before gst_init().</doc> <parameter name="mode" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1542">The coloring mode for debug output. One of the following: + line="1596">The coloring mode for debug output. One of the following: "on", "auto", "off", "disable", "unix".</doc> <type name="utf8" c:type="const gchar*"/> </parameter> @@ -71719,12 +71817,12 @@ This function may be called before gst_init().</doc> <function name="debug_set_colored" c:identifier="gst_debug_set_colored"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1506">Sets or unsets the use of coloured debugging output. + line="1560">Sets or unsets the use of coloured debugging output. Same as gst_debug_set_color_mode () with the argument being being GST_DEBUG_COLOR_MODE_ON or GST_DEBUG_COLOR_MODE_OFF. This function may be called before gst_init().</doc> - <source-position filename="gst/gstinfo.h" line="430"/> + <source-position filename="gst/gstinfo.h" line="456"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -71732,7 +71830,7 @@ This function may be called before gst_init().</doc> <parameter name="colored" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1508">Whether to use colored output or not</doc> + line="1562">Whether to use colored output or not</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -71741,11 +71839,11 @@ This function may be called before gst_init().</doc> c:identifier="gst_debug_set_default_threshold"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1624">Sets the default threshold to the given level and updates all categories to + line="1678">Sets the default threshold to the given level and updates all categories to use this threshold. This function may be called before gst_init().</doc> - <source-position filename="gst/gstinfo.h" line="445"/> + <source-position filename="gst/gstinfo.h" line="471"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -71753,7 +71851,7 @@ This function may be called before gst_init().</doc> <parameter name="level" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1626">level to set</doc> + line="1680">level to set</doc> <type name="DebugLevel" c:type="GstDebugLevel"/> </parameter> </parameters> @@ -71762,9 +71860,9 @@ This function may be called before gst_init().</doc> c:identifier="gst_debug_set_threshold_for_name"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1703">Sets all categories which match the given glob style pattern to the given + line="1757">Sets all categories which match the given glob style pattern to the given level.</doc> - <source-position filename="gst/gstinfo.h" line="451"/> + <source-position filename="gst/gstinfo.h" line="477"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -71772,13 +71870,13 @@ level.</doc> <parameter name="name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1705">name of the categories to set</doc> + line="1759">name of the categories to set</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="level" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1706">level to set them to</doc> + line="1760">level to set them to</doc> <type name="DebugLevel" c:type="GstDebugLevel"/> </parameter> </parameters> @@ -71788,11 +71886,11 @@ level.</doc> version="1.2"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="2022">Sets the debug logging wanted in the same form as with the GST_DEBUG + line="2076">Sets the debug logging wanted in the same form as with the GST_DEBUG environment variable. You can use wildcards such as '*', but note that the order matters when you use wild cards, e.g. "foosrc:6,*src:3,*:2" sets everything to log level 2.</doc> - <source-position filename="gst/gstinfo.h" line="454"/> + <source-position filename="gst/gstinfo.h" line="480"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -71800,14 +71898,14 @@ everything to log level 2.</doc> <parameter name="list" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="2024">comma-separated list of "category:level" pairs to be used + line="2078">comma-separated list of "category:level" pairs to be used as debug logging levels</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="reset" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="2026">%TRUE to clear all previously-set debug levels before setting + line="2080">%TRUE to clear all previously-set debug levels before setting new thresholds %FALSE if adding the threshold described by @list to the one already set.</doc> <type name="gboolean" c:type="gboolean"/> @@ -71818,8 +71916,8 @@ everything to log level 2.</doc> c:identifier="gst_debug_unset_threshold_for_name"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1731">Resets all categories with the given name back to the default level.</doc> - <source-position filename="gst/gstinfo.h" line="457"/> + line="1785">Resets all categories with the given name back to the default level.</doc> + <source-position filename="gst/gstinfo.h" line="483"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -71827,7 +71925,7 @@ everything to log level 2.</doc> <parameter name="name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="1733">name of the categories to set</doc> + line="1787">name of the categories to set</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -71849,11 +71947,12 @@ After this call GStreamer (including this method) should not be used anymore.</d </return-value> </function> <function name="dynamic_type_register" - c:identifier="gst_dynamic_type_register"> + c:identifier="gst_dynamic_type_register" + version="1.12"> <doc xml:space="preserve" filename="gst/gstdynamictypefactory.c" line="144">Registers a new #GstDynamicTypeFactory in the registry</doc> - <source-position filename="gst/gstdynamictypefactory.h" line="55"/> + <source-position filename="gst/gstdynamictypefactory.h" line="57"/> <return-value transfer-ownership="none"> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -72537,30 +72636,30 @@ parent process.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="2563">Allocates, fills and returns a 0-terminated string from the printf style + line="2617">Allocates, fills and returns a 0-terminated string from the printf style @format string and corresponding arguments. See gst_info_vasprintf() for when this function is required. Free with g_free().</doc> - <source-position filename="gst/gstinfo.h" line="499"/> + <source-position filename="gst/gstinfo.h" line="525"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="2575">a newly allocated null terminated string or %NULL on any error</doc> + line="2629">a newly allocated null terminated string or %NULL on any error</doc> <type name="utf8" c:type="gchar*"/> </return-value> <parameters> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="2565">a printf style format string</doc> + line="2619">a printf style format string</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="..." transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="2566">the printf arguments for @format</doc> + line="2620">the printf arguments for @format</doc> <varargs/> </parameter> </parameters> @@ -72571,30 +72670,30 @@ Free with g_free().</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="2536">Allocates, fills and returns a null terminated string from the printf style + line="2590">Allocates, fills and returns a null terminated string from the printf style @format string and @args. See gst_info_vasprintf() for when this function is required. Free with g_free().</doc> - <source-position filename="gst/gstinfo.h" line="496"/> + <source-position filename="gst/gstinfo.h" line="522"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="2548">a newly allocated null terminated string or %NULL on any error</doc> + line="2602">a newly allocated null terminated string or %NULL on any error</doc> <type name="utf8" c:type="gchar*"/> </return-value> <parameters> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="2538">a printf style format string</doc> + line="2592">a printf style format string</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="args" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="2539">the va_list of printf arguments for @format</doc> + line="2593">the va_list of printf arguments for @format</doc> <type name="va_list" c:type="va_list"/> </parameter> </parameters> @@ -72605,7 +72704,7 @@ Free with g_free().</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="2507">Allocates and fills a string large enough (including the terminating null + line="2561">Allocates and fills a string large enough (including the terminating null byte) to hold the specified printf style @format and @args. This function deals with the GStreamer specific printf specifiers @@ -72614,11 +72713,11 @@ in your @format string, you do not need to use this function and can use alternatives such as g_vasprintf(). Free @result with g_free().</doc> - <source-position filename="gst/gstinfo.h" line="492"/> + <source-position filename="gst/gstinfo.h" line="518"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="2523">the length of the string allocated into @result or -1 on any error</doc> + line="2577">the length of the string allocated into @result or -1 on any error</doc> <type name="gint" c:type="gint"/> </return-value> <parameters> @@ -72628,19 +72727,19 @@ Free @result with g_free().</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="2509">the resulting string</doc> + line="2563">the resulting string</doc> <type name="utf8" c:type="gchar**"/> </parameter> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="2510">a printf style format string</doc> + line="2564">a printf style format string</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="args" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="2511">the va_list of printf arguments for @format</doc> + line="2565">the va_list of printf arguments for @format</doc> <type name="va_list" c:type="va_list"/> </parameter> </parameters> @@ -72807,10 +72906,11 @@ or gst_init_check().</doc> </function> <function name="make_element_message_details" c:identifier="gst_make_element_message_details" + version="1.10" introspectable="0"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3824">Create a #GstStructure to be used with #gst_element_message_full_with_details</doc> + line="3843">Create a #GstStructure to be used with #gst_element_message_full_with_details</doc> <source-position filename="gst/gstelement.h" line="351"/> <return-value transfer-ownership="full"> <type name="Structure" c:type="GstStructure*"/> @@ -72819,13 +72919,13 @@ or gst_init_check().</doc> <parameter name="name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3826">Name of the first field to set</doc> + line="3845">Name of the first field to set</doc> <type name="utf8" c:type="const char*"/> </parameter> <parameter name="..." transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstelement.c" - line="3827">variable arguments in the same form as #GstStructure</doc> + line="3846">variable arguments in the same form as #GstStructure</doc> <varargs/> </parameter> </parameters> @@ -73102,13 +73202,13 @@ Either @new_message or the #GstMessage pointed to by @old_message may be %NULL.< moved-to="Meta.get_info"> <doc xml:space="preserve" filename="gst/gstmeta.c" - line="207">Lookup a previously registered meta info structure by its implementation name + line="208">Lookup a previously registered meta info structure by its implementation name @impl.</doc> <source-position filename="gst/gstmeta.h" line="220"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gstmeta.c" - line="214">a #GstMetaInfo with @impl, or + line="215">a #GstMetaInfo with @impl, or %NULL when no such metainfo exists.</doc> <type name="MetaInfo" c:type="const GstMetaInfo*"/> </return-value> @@ -73116,7 +73216,7 @@ Either @new_message or the #GstMessage pointed to by @old_message may be %NULL.< <parameter name="impl" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstmeta.c" - line="209">the name</doc> + line="210">the name</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -73602,7 +73702,7 @@ for the user_data and notify.</doc> that want to expose properties of GstArray type. This function is typically * used in connection with g_object_class_install_property() in a GObjects's instance_init function.</doc> - <source-position filename="gst/gstparamspecs.h" line="179"/> + <source-position filename="gst/gstparamspecs.h" line="181"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gstparamspecs.c" @@ -73650,7 +73750,7 @@ GObjects's instance_init function.</doc> that want to expose properties of fraction type. This function is typically used in connection with g_object_class_install_property() in a GObjects's instance_init function.</doc> - <source-position filename="gst/gstparamspecs.h" line="171"/> + <source-position filename="gst/gstparamspecs.h" line="173"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstparamspecs.c" @@ -73734,12 +73834,12 @@ instance_init function.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2672">Get the global #GstMetaInfo describing the #GstParentBufferMeta meta.</doc> + line="2675">Get the global #GstMetaInfo describing the #GstParentBufferMeta meta.</doc> <source-position filename="gst/gstbuffer.h" line="739"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2677">The #GstMetaInfo</doc> + line="2680">The #GstMetaInfo</doc> <type name="MetaInfo" c:type="const GstMetaInfo*"/> </return-value> </function> @@ -73757,7 +73857,7 @@ one ghost pad for each direction will be created; if you expect multiple unlinked source pads or multiple unlinked sink pads and want them all ghosted, you will have to create the ghost pads yourself).</doc> - <source-position filename="gst/gstutils.h" line="1145"/> + <source-position filename="gst/gstutils.h" line="1148"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -73795,13 +73895,13 @@ one ghost pad for each direction will be created; if you expect multiple unlinked source pads or multiple unlinked sink pads and want them all ghosted, you will have to create the ghost pads yourself).</doc> - <source-position filename="gst/gstutils.h" line="1149"/> + <source-position filename="gst/gstutils.h" line="1152"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gstutils.c" line="3441">a newly-created element, which is guaranteed to be a bin unless - GST_FLAG_NO_SINGLE_ELEMENT_BINS was passed, or %NULL if an error + #GST_PARSE_FLAG_NO_SINGLE_ELEMENT_BINS was passed, or %NULL if an error occurred.</doc> <type name="Element" c:type="GstElement*"/> </return-value> @@ -73853,7 +73953,7 @@ yourself).</doc> <function name="parse_launch" c:identifier="gst_parse_launch" throws="1"> <doc xml:space="preserve" filename="gst/gstparse.c" - line="284">Create a new pipeline based on command line syntax. + line="286">Create a new pipeline based on command line syntax. Please note that you might get a return value that is not %NULL even though the @error is set. In this case there was a recoverable parsing error and you can try to play the pipeline. @@ -73864,7 +73964,7 @@ use gst_parse_bin_from_description().</doc> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gstparse.c" - line="297">a new element on success, %NULL on + line="299">a new element on success, %NULL on failure. If more than one toplevel element is specified by the @pipeline_description, all elements are put into a #GstPipeline, which than is returned.</doc> @@ -73874,7 +73974,7 @@ use gst_parse_bin_from_description().</doc> <parameter name="pipeline_description" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstparse.c" - line="286">the command line describing the pipeline</doc> + line="288">the command line describing the pipeline</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -73884,7 +73984,7 @@ use gst_parse_bin_from_description().</doc> throws="1"> <doc xml:space="preserve" filename="gst/gstparse.c" - line="309">Create a new pipeline based on command line syntax. + line="311">Create a new pipeline based on command line syntax. Please note that you might get a return value that is not %NULL even though the @error is set. In this case there was a recoverable parsing error and you can try to play the pipeline. @@ -73895,7 +73995,7 @@ use gst_parse_bin_from_description_full().</doc> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gstparse.c" - line="325">a new element on success, %NULL on + line="327">a new element on success, %NULL on failure. If more than one toplevel element is specified by the @pipeline_description, all elements are put into a #GstPipeline, which then is returned (unless the GST_PARSE_FLAG_PLACE_IN_BIN flag is set, in @@ -73906,7 +74006,7 @@ use gst_parse_bin_from_description_full().</doc> <parameter name="pipeline_description" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstparse.c" - line="311">the command line describing the pipeline</doc> + line="313">the command line describing the pipeline</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="context" @@ -73915,14 +74015,14 @@ use gst_parse_bin_from_description_full().</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstparse.c" - line="312">a parse context allocated with + line="314">a parse context allocated with gst_parse_context_new(), or %NULL</doc> <type name="ParseContext" c:type="GstParseContext*"/> </parameter> <parameter name="flags" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstparse.c" - line="314">parsing options, or #GST_PARSE_FLAG_NONE</doc> + line="316">parsing options, or #GST_PARSE_FLAG_NONE</doc> <type name="ParseFlags" c:type="GstParseFlags"/> </parameter> </parameters> @@ -73930,14 +74030,14 @@ use gst_parse_bin_from_description_full().</doc> <function name="parse_launchv" c:identifier="gst_parse_launchv" throws="1"> <doc xml:space="preserve" filename="gst/gstparse.c" - line="210">Create a new element based on command line syntax. + line="212">Create a new element based on command line syntax. @error will contain an error message if an erroneous pipeline is specified. An error does not mean that the pipeline could not be constructed.</doc> <source-position filename="gst/gstparse.h" line="121"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gstparse.c" - line="219">a new element on success and %NULL + line="221">a new element on success and %NULL on failure.</doc> <type name="Element" c:type="GstElement*"/> </return-value> @@ -73945,7 +74045,7 @@ on failure.</doc> <parameter name="argv" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstparse.c" - line="212">null-terminated array of arguments</doc> + line="214">null-terminated array of arguments</doc> <array c:type="const gchar**"> <type name="utf8" c:type="gchar*"/> </array> @@ -73957,14 +74057,14 @@ on failure.</doc> throws="1"> <doc xml:space="preserve" filename="gst/gstparse.c" - line="228">Create a new element based on command line syntax. + line="230">Create a new element based on command line syntax. @error will contain an error message if an erroneous pipeline is specified. An error does not mean that the pipeline could not be constructed.</doc> <source-position filename="gst/gstparse.h" line="129"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gstparse.c" - line="240">a new element on success; on + line="242">a new element on success; on failure, either %NULL or a partially-constructed bin or element will be returned and @error will be set (unless you passed #GST_PARSE_FLAG_FATAL_ERRORS in @flags, then %NULL will always be returned @@ -73975,7 +74075,7 @@ An error does not mean that the pipeline could not be constructed.</doc> <parameter name="argv" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstparse.c" - line="230">null-terminated array of arguments</doc> + line="232">null-terminated array of arguments</doc> <array c:type="const gchar**"> <type name="utf8" c:type="gchar*"/> </array> @@ -73986,14 +74086,14 @@ An error does not mean that the pipeline could not be constructed.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstparse.c" - line="231">a parse context allocated with + line="233">a parse context allocated with gst_parse_context_new(), or %NULL</doc> <type name="ParseContext" c:type="GstParseContext*"/> </parameter> <parameter name="flags" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstparse.c" - line="233">parsing options, or #GST_PARSE_FLAG_NONE</doc> + line="235">parsing options, or #GST_PARSE_FLAG_NONE</doc> <type name="ParseFlags" c:type="GstParseFlags"/> </parameter> </parameters> @@ -74143,7 +74243,7 @@ system presets.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="2592">Outputs a formatted message via the GLib print handler. The default print + line="2646">Outputs a formatted message via the GLib print handler. The default print handler simply outputs the message to stdout. This function will not append a new-line character at the end, unlike @@ -74156,7 +74256,7 @@ printf specifiers that are supported by GStreamer's debug logging system, such as #GST_PTR_FORMAT and #GST_SEGMENT_FORMAT. This function is primarily for printing debug output.</doc> - <source-position filename="gst/gstinfo.h" line="502"/> + <source-position filename="gst/gstinfo.h" line="528"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -74164,13 +74264,13 @@ This function is primarily for printing debug output.</doc> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="2594">a printf style format string</doc> + line="2648">a printf style format string</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="..." transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="2595">the printf arguments for @format</doc> + line="2649">the printf arguments for @format</doc> <varargs/> </parameter> </parameters> @@ -74181,7 +74281,7 @@ This function is primarily for printing debug output.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="2678">Outputs a formatted message via the GLib error message handler. The default + line="2732">Outputs a formatted message via the GLib error message handler. The default handler simply outputs the message to stderr. This function will not append a new-line character at the end, unlike @@ -74194,7 +74294,7 @@ printf specifiers that are supported by GStreamer's debug logging system, such as #GST_PTR_FORMAT and #GST_SEGMENT_FORMAT. This function is primarily for printing debug output.</doc> - <source-position filename="gst/gstinfo.h" line="508"/> + <source-position filename="gst/gstinfo.h" line="534"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -74202,13 +74302,13 @@ This function is primarily for printing debug output.</doc> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="2680">a printf style format string</doc> + line="2734">a printf style format string</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="..." transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="2681">the printf arguments for @format</doc> + line="2735">the printf arguments for @format</doc> <varargs/> </parameter> </parameters> @@ -74219,7 +74319,7 @@ This function is primarily for printing debug output.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="2721">Outputs a formatted message via the GLib error message handler. The default + line="2775">Outputs a formatted message via the GLib error message handler. The default handler simply outputs the message to stderr. This function will append a new-line character at the end, unlike @@ -74232,7 +74332,7 @@ printf specifiers that are supported by GStreamer's debug logging system, such as #GST_PTR_FORMAT and #GST_SEGMENT_FORMAT. This function is primarily for printing debug output.</doc> - <source-position filename="gst/gstinfo.h" line="511"/> + <source-position filename="gst/gstinfo.h" line="537"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -74240,13 +74340,13 @@ This function is primarily for printing debug output.</doc> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="2723">a printf style format string</doc> + line="2777">a printf style format string</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="..." transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="2724">the printf arguments for @format</doc> + line="2778">the printf arguments for @format</doc> <varargs/> </parameter> </parameters> @@ -74257,7 +74357,7 @@ This function is primarily for printing debug output.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="2635">Outputs a formatted message via the GLib print handler. The default print + line="2689">Outputs a formatted message via the GLib print handler. The default print handler simply outputs the message to stdout. This function will append a new-line character at the end, unlike @@ -74270,7 +74370,7 @@ printf specifiers that are supported by GStreamer's debug logging system, such as #GST_PTR_FORMAT and #GST_SEGMENT_FORMAT. This function is primarily for printing debug output.</doc> - <source-position filename="gst/gstinfo.h" line="505"/> + <source-position filename="gst/gstinfo.h" line="531"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -74278,13 +74378,13 @@ This function is primarily for printing debug output.</doc> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="2637">a printf style format string</doc> + line="2691">a printf style format string</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="..." transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstinfo.c" - line="2638">the printf arguments for @format</doc> + line="2692">the printf arguments for @format</doc> <varargs/> </parameter> </parameters> @@ -74522,12 +74622,12 @@ Either @new_query or the #GstQuery pointed to by @old_query may be %NULL.</doc> version="1.14"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2844">Get the global #GstMetaInfo describing the #GstReferenceTimestampMeta meta.</doc> + line="2847">Get the global #GstMetaInfo describing the #GstReferenceTimestampMeta meta.</doc> <source-position filename="gst/gstbuffer.h" line="784"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstbuffer.c" - line="2849">The #GstMetaInfo</doc> + line="2852">The #GstMetaInfo</doc> <type name="MetaInfo" c:type="const GstMetaInfo*"/> </return-value> </function> @@ -74630,7 +74730,7 @@ the GStreamer core. See gst_segtrap_is_enabled() for more information.</doc> <doc xml:space="preserve" filename="gst/gstutils.c" line="1331">Gets a string representing the given state transition.</doc> - <source-position filename="gst/gstutils.h" line="996"/> + <source-position filename="gst/gstutils.h" line="999"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -74677,19 +74777,19 @@ the GStreamer core. See gst_segtrap_is_enabled() for more information.</doc> version="1.10"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="538">Get a descriptive string for a given #GstStreamType</doc> + line="540">Get a descriptive string for a given #GstStreamType</doc> <source-position filename="gst/gststreams.h" line="153"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="544">A string describing the stream type</doc> + line="546">A string describing the stream type</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> <parameter name="stype" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststreams.c" - line="540">a #GstStreamType</doc> + line="542">a #GstStreamType</doc> <type name="StreamType" c:type="GstStreamType"/> </parameter> </parameters> @@ -74700,7 +74800,7 @@ the GStreamer core. See gst_segtrap_is_enabled() for more information.</doc> version="1.18"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="575">Atomically modifies a pointer to point to a new structure. + line="573">Atomically modifies a pointer to point to a new structure. The #GstStructure @oldstr_ptr is pointing to is freed and @newstr is taken ownership over. @@ -74712,7 +74812,7 @@ It is a programming error if both @newstr and the value pointed to by <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="590">%TRUE if @newstr was different from @oldstr_ptr</doc> + line="588">%TRUE if @newstr was different from @oldstr_ptr</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> @@ -74724,7 +74824,7 @@ It is a programming error if both @newstr and the value pointed to by allow-none="1"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="577">pointer to a place of + line="575">pointer to a place of a #GstStructure to take</doc> <type name="Structure" c:type="GstStructure**"/> </parameter> @@ -74734,7 +74834,7 @@ It is a programming error if both @newstr and the value pointed to by allow-none="1"> <doc xml:space="preserve" filename="gst/gststructure.c" - line="579">a new #GstStructure</doc> + line="577">a new #GstStructure</doc> <type name="Structure" c:type="GstStructure*"/> </parameter> </parameters> @@ -74918,14 +75018,14 @@ You must g_value_unset() the value after use.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="527">Tests if you can safely modify @taglist. It is only safe to modify taglist + line="509">Tests if you can safely modify @taglist. It is only safe to modify taglist when there is only one owner of the taglist - ie, the refcount is 1.</doc> - <source-position filename="gst/gsttaglist.h" line="534"/> + <source-position filename="gst/gsttaglist.h" line="516"/> <parameters> <parameter name="taglist"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="529">a #GstTagList</doc> + line="511">a #GstTagList</doc> </parameter> </parameters> </function-macro> @@ -74934,7 +75034,7 @@ when there is only one owner of the taglist - ie, the refcount is 1.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="536">Returns a writable copy of @taglist. + line="518">Returns a writable copy of @taglist. If there is only one reference count on @taglist, the caller must be the owner, and so this function will return the taglist object unchanged. If on @@ -74946,12 +75046,12 @@ reference to the returned object. In short, this function unrefs the taglist in the argument and refs the taglist that it returns. Don't access the argument after calling this function. See also: gst_tag_list_ref().</doc> - <source-position filename="gst/gsttaglist.h" line="556"/> + <source-position filename="gst/gsttaglist.h" line="538"/> <parameters> <parameter name="taglist"> <doc xml:space="preserve" filename="gst/gsttaglist.h" - line="538">a #GstTagList</doc> + line="520">a #GstTagList</doc> </parameter> </parameters> </function-macro> @@ -75256,7 +75356,7 @@ even from dynamically loaded plugins.)</doc> filename="gst/gsttracerutils.c" line="199">Get a list of all active tracer objects owned by the tracing framework for the entirety of the run-time of the process or till gst_deinit() is called.</doc> - <source-position filename="gst/gsttracer.h" line="78"/> + <source-position filename="gst/gsttracer.h" line="76"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gsttracerutils.c" @@ -75268,12 +75368,13 @@ the entirety of the run-time of the process or till gst_deinit() is called.</doc </return-value> </function> <function name="tracing_register_hook" - c:identifier="gst_tracing_register_hook"> + c:identifier="gst_tracing_register_hook" + version="1.8"> <doc xml:space="preserve" filename="gst/gsttracerutils.c" - line="183">Register @func to be called when the trace hook @detail is getting invoked. + line="181">Register @func to be called when the trace hook @detail is getting invoked. Use %NULL for @detail to register to all hooks.</doc> - <source-position filename="gst/gsttracer.h" line="69"/> + <source-position filename="gst/gsttracer.h" line="67"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -75281,19 +75382,19 @@ Use %NULL for @detail to register to all hooks.</doc> <parameter name="tracer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsttracerutils.c" - line="185">the tracer</doc> + line="183">the tracer</doc> <type name="Tracer" c:type="GstTracer*"/> </parameter> <parameter name="detail" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsttracerutils.c" - line="186">the detailed hook</doc> + line="184">the detailed hook</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="func" transfer-ownership="none" scope="async"> <doc xml:space="preserve" filename="gst/gsttracerutils.c" - line="187">the callback</doc> + line="185">the callback</doc> <type name="GObject.Callback" c:type="GCallback"/> </parameter> </parameters> @@ -75395,7 +75496,7 @@ This function is typically called during an element's plugin initialization.</do filename="gst/gstutils.c" line="4547">Checks if @type is plugin API. See gst_type_mark_as_plugin_api() for details.</doc> - <source-position filename="gst/gstutils.h" line="1223"/> + <source-position filename="gst/gstutils.h" line="1226"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -75436,7 +75537,7 @@ documented via that library instead. By marking a type as plugin API it will be included in the documentation of the plugin that defines it.</doc> - <source-position filename="gst/gstutils.h" line="1220"/> + <source-position filename="gst/gstutils.h" line="1223"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -75458,7 +75559,7 @@ the plugin that defines it.</doc> <function name="update_registry" c:identifier="gst_update_registry"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1816">Forces GStreamer to re-scan its plugin paths and update the default + line="1829">Forces GStreamer to re-scan its plugin paths and update the default plugin registry. Applications will almost never need to call this function, it is only @@ -75478,7 +75579,7 @@ Note that this function may block for a significant amount of time.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstregistry.c" - line="1836">%TRUE if the registry has been updated successfully (does not + line="1849">%TRUE if the registry has been updated successfully (does not imply that there were changes), otherwise %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -75530,20 +75631,55 @@ Free-function: g_free</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1500">Parses a URI string into a new #GstUri object. Will return NULL if the URI + line="1627">Parses a URI string into a new #GstUri object. Will return NULL if the URI cannot be parsed.</doc> <source-position filename="gst/gsturi.h" line="236"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1507">A new #GstUri object, or NULL.</doc> + line="1634">A new #GstUri object, or NULL.</doc> + <type name="Uri" c:type="GstUri*"/> + </return-value> + <parameters> + <parameter name="uri" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst/gsturi.c" + line="1629">The URI string to parse.</doc> + <type name="utf8" c:type="const gchar*"/> + </parameter> + </parameters> + </function> + <function name="uri_from_string_escaped" + c:identifier="gst_uri_from_string_escaped" + moved-to="Uri.from_string_escaped" + version="1.18"> + <doc xml:space="preserve" + filename="gst/gsturi.c" + line="1644">Parses a URI string into a new #GstUri object. Will return NULL if the URI +cannot be parsed. This is identical to gst_uri_from_string() except that +the userinfo and fragment components of the URI will not be unescaped while +parsing. + +Use this when you need to extract a username and password from the userinfo +such as https://user:password@example.com since either may contain +a URI-escaped ':' character. gst_uri_from_string() will unescape the entire +userinfo component, which will make it impossible to know which ':' +delineates the username and password. + +The same applies to the fragment component of the URI, such as +https://example.com/path#fragment which may contain a URI-escaped '#'.</doc> + <source-position filename="gst/gsturi.h" line="239"/> + <return-value transfer-ownership="full" nullable="1"> + <doc xml:space="preserve" + filename="gst/gsturi.c" + line="1662">A new #GstUri object, or NULL.</doc> <type name="Uri" c:type="GstUri*"/> </return-value> <parameters> <parameter name="uri" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1502">The URI string to parse.</doc> + line="1646">The URI string to parse.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -75657,13 +75793,13 @@ scheme followed by ":" and maybe a string identifying the location.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1856">This is a convenience function to join two URI strings and return the result. + line="1898">This is a convenience function to join two URI strings and return the result. The returned string should be g_free()'d after use.</doc> - <source-position filename="gst/gsturi.h" line="248"/> + <source-position filename="gst/gsturi.h" line="251"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1864">A string representing the percent-encoded join of + line="1906">A string representing the percent-encoded join of the two URIs.</doc> <type name="utf8" c:type="gchar*"/> </return-value> @@ -75671,13 +75807,13 @@ The returned string should be g_free()'d after use.</doc> <parameter name="base_uri" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1858">The percent-encoded base URI.</doc> + line="1900">The percent-encoded base URI.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="ref_uri" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gsturi.c" - line="1859">The percent-encoded reference URI to join to the @base_uri.</doc> + line="1901">The percent-encoded reference URI to join to the @base_uri.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -75747,7 +75883,7 @@ As @search_data is always passed as second argument to @search_func it's not required that @search_data has the same type as the array elements. The complexity of this search function is O(log (num_elements)).</doc> - <source-position filename="gst/gstutils.h" line="1184"/> + <source-position filename="gst/gstutils.h" line="1187"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -75818,7 +75954,7 @@ element or %NULL if nothing was found</doc> filename="gst/gstutils.c" line="3695">Transforms a #gdouble to a fraction and simplifies the result.</doc> - <source-position filename="gst/gstutils.h" line="1201"/> + <source-position filename="gst/gstutils.h" line="1204"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -75898,7 +76034,7 @@ the result.</doc> filename="gst/gstutils.c" line="3853">Adds the fractions @a_n/@a_d and @b_n/@b_d and stores the result in @res_n and @res_d.</doc> - <source-position filename="gst/gstutils.h" line="1207"/> + <source-position filename="gst/gstutils.h" line="1210"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -75956,7 +76092,7 @@ the result in @res_n and @res_d.</doc> filename="gst/gstutils.c" line="3918">Compares the fractions @a_n/@a_d and @b_n/@b_d and returns -1 if a < b, 0 if a = b and 1 if a > b.</doc> - <source-position filename="gst/gstutils.h" line="1210"/> + <source-position filename="gst/gstutils.h" line="1213"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -75996,7 +76132,7 @@ the result in @res_n and @res_d.</doc> filename="gst/gstutils.c" line="3789">Multiplies the fractions @a_n/@a_d and @b_n/@b_d and stores the result in @res_n and @res_d.</doc> - <source-position filename="gst/gstutils.h" line="1204"/> + <source-position filename="gst/gstutils.h" line="1207"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -76053,7 +76189,7 @@ the result in @res_n and @res_d.</doc> <doc xml:space="preserve" filename="gst/gstutils.c" line="3669">Transforms a fraction to a #gdouble.</doc> - <source-position filename="gst/gstutils.h" line="1198"/> + <source-position filename="gst/gstutils.h" line="1201"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -76140,7 +76276,7 @@ properties which are otherwise not an accessible type.</doc> filename="gst/gstutils.c" line="3509">Get a timestamp as GstClockTime to be used for interval measurements. The timestamp should not be interpreted in any other way.</doc> - <source-position filename="gst/gstutils.h" line="1155"/> + <source-position filename="gst/gstutils.h" line="1158"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -76154,7 +76290,7 @@ The timestamp should not be interpreted in any other way.</doc> filename="gst/gstutils.c" line="3622">Calculates the greatest common divisor of @a and @b.</doc> - <source-position filename="gst/gstutils.h" line="1192"/> + <source-position filename="gst/gstutils.h" line="1195"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -76182,7 +76318,7 @@ and @b.</doc> filename="gst/gstutils.c" line="3645">Calculates the greatest common divisor of @a and @b.</doc> - <source-position filename="gst/gstutils.h" line="1195"/> + <source-position filename="gst/gstutils.h" line="1198"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstutils.c" @@ -76637,25 +76773,25 @@ gst_util_uint64_scale_int_round(), gst_util_uint64_scale_int_ceil().</doc> <function name="value_can_compare" c:identifier="gst_value_can_compare"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="5798">Determines if @value1 and @value2 can be compared.</doc> + line="5708">Determines if @value1 and @value2 can be compared.</doc> <source-position filename="gst/gstvalue.h" line="736"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="5805">%TRUE if the values can be compared</doc> + line="5715">%TRUE if the values can be compared</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <parameter name="value1" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="5800">a value to compare</doc> + line="5710">a value to compare</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> <parameter name="value2" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="5801">another value to compare</doc> + line="5711">another value to compare</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> </parameters> @@ -76664,27 +76800,27 @@ gst_util_uint64_scale_int_round(), gst_util_uint64_scale_int_ceil().</doc> c:identifier="gst_value_can_intersect"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6080">Determines if intersecting two values will produce a valid result. + line="5990">Determines if intersecting two values will produce a valid result. Two values will produce a valid intersection if they have the same type.</doc> <source-position filename="gst/gstvalue.h" line="759"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6089">%TRUE if the values can intersect</doc> + line="5999">%TRUE if the values can intersect</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <parameter name="value1" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6082">a value to intersect</doc> + line="5992">a value to intersect</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> <parameter name="value2" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6083">another value to intersect</doc> + line="5993">another value to intersect</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> </parameters> @@ -76692,25 +76828,25 @@ type.</doc> <function name="value_can_subtract" c:identifier="gst_value_can_subtract"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6320">Checks if it's possible to subtract @subtrahend from @minuend.</doc> + line="6230">Checks if it's possible to subtract @subtrahend from @minuend.</doc> <source-position filename="gst/gstvalue.h" line="769"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6327">%TRUE if a subtraction is possible</doc> + line="6237">%TRUE if a subtraction is possible</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <parameter name="minuend" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6322">the value to subtract from</doc> + line="6232">the value to subtract from</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> <parameter name="subtrahend" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6323">the value to subtract</doc> + line="6233">the value to subtract</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> </parameters> @@ -76718,7 +76854,7 @@ type.</doc> <function name="value_can_union" c:identifier="gst_value_can_union"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="5973">Determines if @value1 and @value2 can be non-trivially unioned. + line="5883">Determines if @value1 and @value2 can be non-trivially unioned. Any two values can be trivially unioned by adding both of them to a GstValueList. However, certain types have the possibility to be unioned in a simpler way. For example, an integer range @@ -76729,7 +76865,7 @@ be unioned, this function returns %TRUE.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="5986">%TRUE if there is a function allowing the two values to + line="5896">%TRUE if there is a function allowing the two values to be unioned.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -76737,13 +76873,13 @@ be unioned.</doc> <parameter name="value1" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="5975">a value to union</doc> + line="5885">a value to union</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> <parameter name="value2" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="5976">another value to union</doc> + line="5886">another value to union</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> </parameters> @@ -76751,7 +76887,7 @@ be unioned.</doc> <function name="value_compare" c:identifier="gst_value_compare"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="5892">Compares @value1 and @value2. If @value1 and @value2 cannot be + line="5802">Compares @value1 and @value2. If @value1 and @value2 cannot be compared, the function returns GST_VALUE_UNORDERED. Otherwise, if @value1 is greater than @value2, GST_VALUE_GREATER_THAN is returned. If @value1 is less than @value2, GST_VALUE_LESS_THAN is returned. @@ -76760,20 +76896,20 @@ If the values are equal, GST_VALUE_EQUAL is returned.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="5903">comparison result</doc> + line="5813">comparison result</doc> <type name="gint" c:type="gint"/> </return-value> <parameters> <parameter name="value1" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="5894">a value to compare</doc> + line="5804">a value to compare</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> <parameter name="value2" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="5895">another value to compare</doc> + line="5805">another value to compare</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> </parameters> @@ -76781,13 +76917,13 @@ If the values are equal, GST_VALUE_EQUAL is returned.</doc> <function name="value_deserialize" c:identifier="gst_value_deserialize"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6506">Tries to deserialize a string into the type specified by the given GValue. + line="6416">Tries to deserialize a string into the type specified by the given GValue. If the operation succeeds, %TRUE is returned, %FALSE otherwise.</doc> <source-position filename="gst/gstvalue.h" line="538"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6515">%TRUE on success</doc> + line="6425">%TRUE on success</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> @@ -76797,14 +76933,14 @@ If the operation succeeds, %TRUE is returned, %FALSE otherwise.</doc> transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6508">#GValue to fill with contents of + line="6418">#GValue to fill with contents of deserialization</doc> <type name="GObject.Value" c:type="GValue*"/> </parameter> <parameter name="src" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6510">string to deserialize</doc> + line="6420">string to deserialize</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -76812,7 +76948,7 @@ If the operation succeeds, %TRUE is returned, %FALSE otherwise.</doc> <function name="value_fixate" c:identifier="gst_value_fixate"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6602">Fixate @src into a new value @dest. + line="6512">Fixate @src into a new value @dest. For ranges, the first element is taken. For lists and arrays, the first item is fixated and returned. If @src is already fixed, this function returns %FALSE.</doc> @@ -76820,20 +76956,20 @@ If @src is already fixed, this function returns %FALSE.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6612">%TRUE if @dest contains a fixated version of @src.</doc> + line="6522">%TRUE if @dest contains a fixated version of @src.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <parameter name="dest" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6604">the #GValue destination</doc> + line="6514">the #GValue destination</doc> <type name="GObject.Value" c:type="GValue*"/> </parameter> <parameter name="src" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6605">the #GValue to fixate</doc> + line="6515">the #GValue to fixate</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> </parameters> @@ -76842,32 +76978,32 @@ If @src is already fixed, this function returns %FALSE.</doc> c:identifier="gst_value_fraction_multiply"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6828">Multiplies the two #GValue items containing a #GST_TYPE_FRACTION and sets + line="6738">Multiplies the two #GValue items containing a #GST_TYPE_FRACTION and sets @product to the product of the two fractions.</doc> <source-position filename="gst/gstvalue.h" line="685"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6837">%FALSE in case of an error (like integer overflow), %TRUE otherwise.</doc> + line="6747">%FALSE in case of an error (like integer overflow), %TRUE otherwise.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <parameter name="product" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6830">a GValue initialized to #GST_TYPE_FRACTION</doc> + line="6740">a GValue initialized to #GST_TYPE_FRACTION</doc> <type name="GObject.Value" c:type="GValue*"/> </parameter> <parameter name="factor1" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6831">a GValue initialized to #GST_TYPE_FRACTION</doc> + line="6741">a GValue initialized to #GST_TYPE_FRACTION</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> <parameter name="factor2" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6832">a GValue initialized to #GST_TYPE_FRACTION</doc> + line="6742">a GValue initialized to #GST_TYPE_FRACTION</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> </parameters> @@ -76876,31 +77012,31 @@ If @src is already fixed, this function returns %FALSE.</doc> c:identifier="gst_value_fraction_subtract"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6863">Subtracts the @subtrahend from the @minuend and sets @dest to the result.</doc> + line="6773">Subtracts the @subtrahend from the @minuend and sets @dest to the result.</doc> <source-position filename="gst/gstvalue.h" line="689"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6871">%FALSE in case of an error (like integer overflow), %TRUE otherwise.</doc> + line="6781">%FALSE in case of an error (like integer overflow), %TRUE otherwise.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <parameter name="dest" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6865">a GValue initialized to #GST_TYPE_FRACTION</doc> + line="6775">a GValue initialized to #GST_TYPE_FRACTION</doc> <type name="GObject.Value" c:type="GValue*"/> </parameter> <parameter name="minuend" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6866">a GValue initialized to #GST_TYPE_FRACTION</doc> + line="6776">a GValue initialized to #GST_TYPE_FRACTION</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> <parameter name="subtrahend" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6867">a GValue initialized to #GST_TYPE_FRACTION</doc> + line="6777">a GValue initialized to #GST_TYPE_FRACTION</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> </parameters> @@ -76908,19 +77044,19 @@ If @src is already fixed, this function returns %FALSE.</doc> <function name="value_get_bitmask" c:identifier="gst_value_get_bitmask"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="7239">Gets the bitmask specified by @value.</doc> + line="7149">Gets the bitmask specified by @value.</doc> <source-position filename="gst/gstvalue.h" line="714"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="7245">the bitmask.</doc> + line="7155">the bitmask.</doc> <type name="guint64" c:type="guint64"/> </return-value> <parameters> <parameter name="value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="7241">a GValue initialized to #GST_TYPE_BITMASK</doc> + line="7151">a GValue initialized to #GST_TYPE_BITMASK</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> </parameters> @@ -76968,19 +77104,19 @@ before getting rid of the @value.</doc> c:identifier="gst_value_get_caps_features"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="3010">Gets the contents of @value.</doc> + line="2920">Gets the contents of @value.</doc> <source-position filename="gst/gstvalue.h" line="666"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="3016">the contents of @value</doc> + line="2926">the contents of @value</doc> <type name="CapsFeatures" c:type="const GstCapsFeatures*"/> </return-value> <parameters> <parameter name="value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="3012">a GValue initialized to GST_TYPE_CAPS_FEATURES</doc> + line="2922">a GValue initialized to GST_TYPE_CAPS_FEATURES</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> </parameters> @@ -77032,19 +77168,19 @@ before getting rid of the @value.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="7398">Retrieve the flags field of a GstFlagSet @value.</doc> + line="7308">Retrieve the flags field of a GstFlagSet @value.</doc> <source-position filename="gst/gstvalue.h" line="725"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="7404">the flags field of the flagset instance.</doc> + line="7314">the flags field of the flagset instance.</doc> <type name="guint" c:type="guint"/> </return-value> <parameters> <parameter name="value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="7400">a GValue initialized to #GST_TYPE_FLAG_SET</doc> + line="7310">a GValue initialized to #GST_TYPE_FLAG_SET</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> </parameters> @@ -77054,19 +77190,19 @@ before getting rid of the @value.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="7416">Retrieve the mask field of a GstFlagSet @value.</doc> + line="7326">Retrieve the mask field of a GstFlagSet @value.</doc> <source-position filename="gst/gstvalue.h" line="728"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="7422">the mask field of the flagset instance.</doc> + line="7332">the mask field of the flagset instance.</doc> <type name="guint" c:type="guint"/> </return-value> <parameters> <parameter name="value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="7418">a GValue initialized to #GST_TYPE_FLAG_SET</doc> + line="7328">a GValue initialized to #GST_TYPE_FLAG_SET</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> </parameters> @@ -77075,19 +77211,19 @@ before getting rid of the @value.</doc> c:identifier="gst_value_get_fraction_denominator"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6812">Gets the denominator of the fraction specified by @value.</doc> + line="6722">Gets the denominator of the fraction specified by @value.</doc> <source-position filename="gst/gstvalue.h" line="682"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6818">the denominator of the fraction.</doc> + line="6728">the denominator of the fraction.</doc> <type name="gint" c:type="gint"/> </return-value> <parameters> <parameter name="value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6814">a GValue initialized to #GST_TYPE_FRACTION</doc> + line="6724">a GValue initialized to #GST_TYPE_FRACTION</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> </parameters> @@ -77096,19 +77232,19 @@ before getting rid of the @value.</doc> c:identifier="gst_value_get_fraction_numerator"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6796">Gets the numerator of the fraction specified by @value.</doc> + line="6706">Gets the numerator of the fraction specified by @value.</doc> <source-position filename="gst/gstvalue.h" line="679"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6802">the numerator of the fraction.</doc> + line="6712">the numerator of the fraction.</doc> <type name="gint" c:type="gint"/> </return-value> <parameters> <parameter name="value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6798">a GValue initialized to #GST_TYPE_FRACTION</doc> + line="6708">a GValue initialized to #GST_TYPE_FRACTION</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> </parameters> @@ -77302,19 +77438,19 @@ a reference to @v.</doc> c:identifier="gst_value_get_structure"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="2922">Gets the contents of @value.</doc> + line="2832">Gets the contents of @value.</doc> <source-position filename="gst/gstvalue.h" line="656"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="2928">the contents of @value</doc> + line="2838">the contents of @value</doc> <type name="Structure" c:type="const GstStructure*"/> </return-value> <parameters> <parameter name="value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="2924">a GValue initialized to GST_TYPE_STRUCTURE</doc> + line="2834">a GValue initialized to GST_TYPE_STRUCTURE</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> </parameters> @@ -77323,7 +77459,7 @@ a reference to @v.</doc> c:identifier="gst_value_init_and_copy"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6411">Initialises the target value to be of the same type as source and then copies + line="6321">Initialises the target value to be of the same type as source and then copies the contents from source to target.</doc> <source-position filename="gst/gstvalue.h" line="532"/> <return-value transfer-ownership="none"> @@ -77336,13 +77472,13 @@ the contents from source to target.</doc> transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6413">the target value</doc> + line="6323">the target value</doc> <type name="GObject.Value" c:type="GValue*"/> </parameter> <parameter name="src" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6414">the source value</doc> + line="6324">the source value</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> </parameters> @@ -77350,7 +77486,7 @@ the contents from source to target.</doc> <function name="value_intersect" c:identifier="gst_value_intersect"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6139">Calculates the intersection of two values. If the values have + line="6049">Calculates the intersection of two values. If the values have a non-empty intersection, the value representing the intersection is placed in @dest, unless %NULL. If the intersection is non-empty, @dest is not modified.</doc> @@ -77358,7 +77494,7 @@ is placed in @dest, unless %NULL. If the intersection is non-empty, <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6153">%TRUE if the intersection is non-empty</doc> + line="6063">%TRUE if the intersection is non-empty</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> @@ -77370,7 +77506,7 @@ is placed in @dest, unless %NULL. If the intersection is non-empty, allow-none="1"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6141"> + line="6051"> a uninitialized #GValue that will hold the calculated intersection value. May be %NULL if the resulting set if not needed.</doc> @@ -77379,13 +77515,13 @@ is placed in @dest, unless %NULL. If the intersection is non-empty, <parameter name="value1" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6145">a value to intersect</doc> + line="6055">a value to intersect</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> <parameter name="value2" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6146">another value to intersect</doc> + line="6056">another value to intersect</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> </parameters> @@ -77393,7 +77529,7 @@ is placed in @dest, unless %NULL. If the intersection is non-empty, <function name="value_is_fixed" c:identifier="gst_value_is_fixed"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6554">Tests if the given GValue, if available in a GstStructure (or any other + line="6464">Tests if the given GValue, if available in a GstStructure (or any other container) contains a "fixed" (which means: one value) or an "unfixed" (which means: multiple possible values, such as data lists or data ranges) value.</doc> @@ -77401,14 +77537,14 @@ ranges) value.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6563">true if the value is "fixed".</doc> + line="6473">true if the value is "fixed".</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <parameter name="value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6556">the #GValue to check</doc> + line="6466">the #GValue to check</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> </parameters> @@ -77416,25 +77552,25 @@ ranges) value.</doc> <function name="value_is_subset" c:identifier="gst_value_is_subset"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="4391">Check that @value1 is a subset of @value2.</doc> + line="4301">Check that @value1 is a subset of @value2.</doc> <source-position filename="gst/gstvalue.h" line="739"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="4398">%TRUE is @value1 is a subset of @value2</doc> + line="4308">%TRUE is @value1 is a subset of @value2</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <parameter name="value1" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="4393">a #GValue</doc> + line="4303">a #GValue</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> <parameter name="value2" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="4394">a #GValue</doc> + line="4304">a #GValue</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> </parameters> @@ -77442,7 +77578,7 @@ ranges) value.</doc> <function name="value_register" c:identifier="gst_value_register"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6386">Registers functions to perform calculations on #GValue items of a given + line="6296">Registers functions to perform calculations on #GValue items of a given type. Each type can only be added once.</doc> <source-position filename="gst/gstvalue.h" line="529"/> <return-value transfer-ownership="none"> @@ -77452,7 +77588,7 @@ type. Each type can only be added once.</doc> <parameter name="table" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6388">structure containing functions to register</doc> + line="6298">structure containing functions to register</doc> <type name="ValueTable" c:type="const GstValueTable*"/> </parameter> </parameters> @@ -77460,7 +77596,7 @@ type. Each type can only be added once.</doc> <function name="value_serialize" c:identifier="gst_value_serialize"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6454">tries to transform the given @value into a string representation that allows + line="6364">tries to transform the given @value into a string representation that allows getting back this string later on using gst_value_deserialize(). Free-function: g_free</doc> @@ -77468,7 +77604,7 @@ Free-function: g_free</doc> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6463">the serialization for @value + line="6373">the serialization for @value or %NULL if none exists</doc> <type name="utf8" c:type="gchar*"/> </return-value> @@ -77476,7 +77612,7 @@ or %NULL if none exists</doc> <parameter name="value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6456">a #GValue to serialize</doc> + line="6366">a #GValue to serialize</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> </parameters> @@ -77484,7 +77620,7 @@ or %NULL if none exists</doc> <function name="value_set_bitmask" c:identifier="gst_value_set_bitmask"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="7224">Sets @value to the bitmask specified by @bitmask.</doc> + line="7134">Sets @value to the bitmask specified by @bitmask.</doc> <source-position filename="gst/gstvalue.h" line="717"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> @@ -77493,13 +77629,13 @@ or %NULL if none exists</doc> <parameter name="value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="7226">a GValue initialized to #GST_TYPE_BITMASK</doc> + line="7136">a GValue initialized to #GST_TYPE_BITMASK</doc> <type name="GObject.Value" c:type="GValue*"/> </parameter> <parameter name="bitmask" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="7227">the bitmask</doc> + line="7137">the bitmask</doc> <type name="guint64" c:type="guint64"/> </parameter> </parameters> @@ -77552,7 +77688,7 @@ provided @caps will be taken by the @value.</doc> c:identifier="gst_value_set_caps_features"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="2993">Sets the contents of @value to @features.</doc> + line="2903">Sets the contents of @value to @features.</doc> <source-position filename="gst/gstvalue.h" line="669"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> @@ -77561,13 +77697,13 @@ provided @caps will be taken by the @value.</doc> <parameter name="value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="2995">a GValue initialized to GST_TYPE_CAPS_FEATURES</doc> + line="2905">a GValue initialized to GST_TYPE_CAPS_FEATURES</doc> <type name="GObject.Value" c:type="GValue*"/> </parameter> <parameter name="features" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="2996">the features to set the value to</doc> + line="2906">the features to set the value to</doc> <type name="CapsFeatures" c:type="const GstCapsFeatures*"/> </parameter> </parameters> @@ -77607,7 +77743,7 @@ provided @caps will be taken by the @value.</doc> version="1.6"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="7376">Sets @value to the flags and mask values provided in @flags and @mask. + line="7286">Sets @value to the flags and mask values provided in @flags and @mask. The @flags value indicates the values of flags, the @mask represents which bits in the flag value have been set, and which are "don't care"</doc> <source-position filename="gst/gstvalue.h" line="722"/> @@ -77618,19 +77754,19 @@ which bits in the flag value have been set, and which are "don't care"</doc> <parameter name="value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="7378">a GValue initialized to %GST_TYPE_FLAG_SET</doc> + line="7288">a GValue initialized to %GST_TYPE_FLAG_SET</doc> <type name="GObject.Value" c:type="GValue*"/> </parameter> <parameter name="flags" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="7379">The value of the flags set or unset</doc> + line="7289">The value of the flags set or unset</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="mask" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="7380">The mask indicate which flags bits must match for comparisons</doc> + line="7290">The mask indicate which flags bits must match for comparisons</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -77638,7 +77774,7 @@ which bits in the flag value have been set, and which are "don't care"</doc> <function name="value_set_fraction" c:identifier="gst_value_set_fraction"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6757">Sets @value to the fraction specified by @numerator over @denominator. + line="6667">Sets @value to the fraction specified by @numerator over @denominator. The fraction gets reduced to the smallest numerator and denominator, and if necessary the sign is moved to the numerator.</doc> <source-position filename="gst/gstvalue.h" line="675"/> @@ -77649,19 +77785,19 @@ and if necessary the sign is moved to the numerator.</doc> <parameter name="value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6759">a GValue initialized to #GST_TYPE_FRACTION</doc> + line="6669">a GValue initialized to #GST_TYPE_FRACTION</doc> <type name="GObject.Value" c:type="GValue*"/> </parameter> <parameter name="numerator" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6760">the numerator of the fraction</doc> + line="6670">the numerator of the fraction</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="denominator" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6761">the denominator of the fraction</doc> + line="6671">the denominator of the fraction</doc> <type name="gint" c:type="gint"/> </parameter> </parameters> @@ -77895,7 +78031,7 @@ and @numerator_end/@denominator_end.</doc> c:identifier="gst_value_set_structure"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="2905">Sets the contents of @value to @structure.</doc> + line="2815">Sets the contents of @value to @structure.</doc> <source-position filename="gst/gstvalue.h" line="659"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> @@ -77904,13 +78040,13 @@ and @numerator_end/@denominator_end.</doc> <parameter name="value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="2907">a GValue initialized to GST_TYPE_STRUCTURE</doc> + line="2817">a GValue initialized to GST_TYPE_STRUCTURE</doc> <type name="GObject.Value" c:type="GValue*"/> </parameter> <parameter name="structure" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="2908">the structure to set the value to</doc> + line="2818">the structure to set the value to</doc> <type name="Structure" c:type="const GstStructure*"/> </parameter> </parameters> @@ -77918,13 +78054,13 @@ and @numerator_end/@denominator_end.</doc> <function name="value_subtract" c:identifier="gst_value_subtract"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6255">Subtracts @subtrahend from @minuend and stores the result in @dest. + line="6165">Subtracts @subtrahend from @minuend and stores the result in @dest. Note that this means subtraction as in sets, not as in mathematics.</doc> <source-position filename="gst/gstvalue.h" line="765"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6267">%TRUE if the subtraction is not empty</doc> + line="6177">%TRUE if the subtraction is not empty</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> @@ -77936,7 +78072,7 @@ Note that this means subtraction as in sets, not as in mathematics.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6257">the destination value + line="6167">the destination value for the result if the subtraction is not empty. May be %NULL, in which case the resulting set will not be computed, which can give a fair speedup.</doc> @@ -77945,13 +78081,13 @@ Note that this means subtraction as in sets, not as in mathematics.</doc> <parameter name="minuend" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6261">the value to subtract from</doc> + line="6171">the value to subtract from</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> <parameter name="subtrahend" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6262">the value to subtract</doc> + line="6172">the value to subtract</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> </parameters> @@ -77999,12 +78135,12 @@ Note that this means subtraction as in sets, not as in mathematics.</doc> <function name="value_union" c:identifier="gst_value_union"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6013">Creates a GValue corresponding to the union of @value1 and @value2.</doc> + line="5923">Creates a GValue corresponding to the union of @value1 and @value2.</doc> <source-position filename="gst/gstvalue.h" line="745"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6021">%TRUE if the union succeeded.</doc> + line="5931">%TRUE if the union succeeded.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> @@ -78014,19 +78150,19 @@ Note that this means subtraction as in sets, not as in mathematics.</doc> transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6015">the destination value</doc> + line="5925">the destination value</doc> <type name="GObject.Value" c:type="GValue*"/> </parameter> <parameter name="value1" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6016">a value to union</doc> + line="5926">a value to union</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> <parameter name="value2" transfer-ownership="none"> <doc xml:space="preserve" filename="gst/gstvalue.c" - line="6017">another value to union</doc> + line="5927">another value to union</doc> <type name="GObject.Value" c:type="const GValue*"/> </parameter> </parameters> |