diff options
| author | Olivier Crête <olivier.crete@collabora.com> | 2020-10-16 16:12:36 -0400 |
|---|---|---|
| committer | Olivier Crête <olivier.crete@collabora.com> | 2020-10-16 16:21:17 -0400 |
| commit | dbae3e3ff04f3589b01f670d52bc749e36e465dc (patch) | |
| tree | 7e1a614add80581645606fa11689bea21d3a8486 /girs | |
| parent | 9d7f360da7e3e0b3cf16adef83778d358aa35da7 (diff) | |
| download | gstreamer-dbae3e3ff04f3589b01f670d52bc749e36e465dc.tar.gz | |
Update bindings to 1.18
Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer-sharp/-/merge_requests/25>
Diffstat (limited to 'girs')
| -rw-r--r-- | girs/Gst-1.0.gir | 4990 | ||||
| -rw-r--r-- | girs/GstApp-1.0.gir | 349 | ||||
| -rw-r--r-- | girs/GstAudio-1.0.gir | 674 | ||||
| -rw-r--r-- | girs/GstBase-1.0.gir | 819 | ||||
| -rw-r--r-- | girs/GstController-1.0.gir | 20 | ||||
| -rw-r--r-- | girs/GstPbutils-1.0.gir | 506 | ||||
| -rw-r--r-- | girs/GstRtp-1.0.gir | 867 | ||||
| -rw-r--r-- | girs/GstRtsp-1.0.gir | 22 | ||||
| -rw-r--r-- | girs/GstSdp-1.0.gir | 8 | ||||
| -rw-r--r-- | girs/GstTag-1.0.gir | 18 | ||||
| -rw-r--r-- | girs/GstVideo-1.0.gir | 1649 | ||||
| -rw-r--r-- | girs/GstWebRTC-1.0.gir | 84 |
12 files changed, 5376 insertions, 4630 deletions
diff --git a/girs/Gst-1.0.gir b/girs/Gst-1.0.gir index 41b2d8c732..34b7d2a49f 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> diff --git a/girs/GstApp-1.0.gir b/girs/GstApp-1.0.gir index b8c04eb4f8..840dbc2d65 100644 --- a/girs/GstApp-1.0.gir +++ b/girs/GstApp-1.0.gir @@ -1322,13 +1322,13 @@ occurs or the state of the appsrc has gone through READY.</doc> <virtual-method name="end_of_stream" invoker="end_of_stream"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="2075">Indicates to the appsrc element that the last buffer queued in the + line="2181">Indicates to the appsrc element that the last buffer queued in the element is the last buffer of the stream.</doc> <source-position filename="gst-libs/gst/app/gstappsrc.h" line="113"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="2082">#GST_FLOW_OK when the EOS was successfully queued. + line="2188">#GST_FLOW_OK when the EOS was successfully queued. #GST_FLOW_FLUSHING when @appsrc is not PAUSED or PLAYING.</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> @@ -1336,7 +1336,7 @@ element is the last buffer of the stream.</doc> <instance-parameter name="appsrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="2077">a #GstAppSrc</doc> + line="2183">a #GstAppSrc</doc> <type name="AppSrc" c:type="GstAppSrc*"/> </instance-parameter> </parameters> @@ -1369,7 +1369,7 @@ element is the last buffer of the stream.</doc> <virtual-method name="push_buffer" invoker="push_buffer"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1975">Adds a buffer to the queue of buffers that the appsrc element will + line="2081">Adds a buffer to the queue of buffers that the appsrc element will push to its source pad. This function takes ownership of the buffer. When the block property is TRUE, this function can block until free @@ -1378,7 +1378,7 @@ space becomes available in the queue.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1986">#GST_FLOW_OK when the buffer was successfully queued. + line="2092">#GST_FLOW_OK when the buffer was successfully queued. #GST_FLOW_FLUSHING when @appsrc is not PAUSED or PLAYING. #GST_FLOW_EOS when EOS occurred.</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> @@ -1387,13 +1387,13 @@ space becomes available in the queue.</doc> <instance-parameter name="appsrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1977">a #GstAppSrc</doc> + line="2083">a #GstAppSrc</doc> <type name="AppSrc" c:type="GstAppSrc*"/> </instance-parameter> <parameter name="buffer" transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1978">a #GstBuffer to push</doc> + line="2084">a #GstBuffer to push</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </parameter> </parameters> @@ -1403,7 +1403,7 @@ space becomes available in the queue.</doc> version="1.14"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1996">Adds a buffer list to the queue of buffers and buffer lists that the + line="2102">Adds a buffer list to the queue of buffers and buffer lists that the appsrc element will push to its source pad. This function takes ownership of @buffer_list. @@ -1413,7 +1413,7 @@ space becomes available in the queue.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="2008">#GST_FLOW_OK when the buffer list was successfully queued. + line="2114">#GST_FLOW_OK when the buffer list was successfully queued. #GST_FLOW_FLUSHING when @appsrc is not PAUSED or PLAYING. #GST_FLOW_EOS when EOS occurred.</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> @@ -1422,13 +1422,13 @@ space becomes available in the queue.</doc> <instance-parameter name="appsrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1998">a #GstAppSrc</doc> + line="2104">a #GstAppSrc</doc> <type name="AppSrc" c:type="GstAppSrc*"/> </instance-parameter> <parameter name="buffer_list" transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1999">a #GstBufferList to push</doc> + line="2105">a #GstBufferList to push</doc> <type name="Gst.BufferList" c:type="GstBufferList*"/> </parameter> </parameters> @@ -1436,7 +1436,7 @@ space becomes available in the queue.</doc> <virtual-method name="push_sample" invoker="push_sample" version="1.6"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="2020">Extract a buffer from the provided sample and adds it to the queue of + line="2126">Extract a buffer from the provided sample and adds it to the queue of buffers that the appsrc element will push to its source pad. Any previous caps that were set on appsrc will be replaced by the caps associated with the sample if not equal. @@ -1450,7 +1450,7 @@ space becomes available in the queue.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="2037">#GST_FLOW_OK when the buffer was successfully queued. + line="2143">#GST_FLOW_OK when the buffer was successfully queued. #GST_FLOW_FLUSHING when @appsrc is not PAUSED or PLAYING. #GST_FLOW_EOS when EOS occurred.</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> @@ -1459,13 +1459,13 @@ space becomes available in the queue.</doc> <instance-parameter name="appsrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="2022">a #GstAppSrc</doc> + line="2128">a #GstAppSrc</doc> <type name="AppSrc" c:type="GstAppSrc*"/> </instance-parameter> <parameter name="sample" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="2023">a #GstSample from which buffer and caps may be + line="2129">a #GstSample from which buffer and caps may be extracted</doc> <type name="Gst.Sample" c:type="GstSample*"/> </parameter> @@ -1488,13 +1488,13 @@ extracted</doc> <method name="end_of_stream" c:identifier="gst_app_src_end_of_stream"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="2075">Indicates to the appsrc element that the last buffer queued in the + line="2181">Indicates to the appsrc element that the last buffer queued in the element is the last buffer of the stream.</doc> <source-position filename="gst-libs/gst/app/gstappsrc.h" line="176"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="2082">#GST_FLOW_OK when the EOS was successfully queued. + line="2188">#GST_FLOW_OK when the EOS was successfully queued. #GST_FLOW_FLUSHING when @appsrc is not PAUSED or PLAYING.</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> @@ -1502,7 +1502,7 @@ element is the last buffer of the stream.</doc> <instance-parameter name="appsrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="2077">a #GstAppSrc</doc> + line="2183">a #GstAppSrc</doc> <type name="AppSrc" c:type="GstAppSrc*"/> </instance-parameter> </parameters> @@ -1510,19 +1510,19 @@ element is the last buffer of the stream.</doc> <method name="get_caps" c:identifier="gst_app_src_get_caps"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1397">Get the configured caps on @appsrc.</doc> + line="1470">Get the configured caps on @appsrc.</doc> <source-position filename="gst-libs/gst/app/gstappsrc.h" line="128"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1403">the #GstCaps produced by the source. gst_caps_unref() after usage.</doc> + line="1476">the #GstCaps produced by the source. gst_caps_unref() after usage.</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </return-value> <parameters> <instance-parameter name="appsrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1399">a #GstAppSrc</doc> + line="1472">a #GstAppSrc</doc> <type name="AppSrc" c:type="GstAppSrc*"/> </instance-parameter> </parameters> @@ -1532,19 +1532,19 @@ element is the last buffer of the stream.</doc> version="1.2"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1634">Get the number of currently queued bytes inside @appsrc.</doc> + line="1707">Get the number of currently queued bytes inside @appsrc.</doc> <source-position filename="gst-libs/gst/app/gstappsrc.h" line="155"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1640">The number of currently queued bytes.</doc> + line="1713">The number of currently queued bytes.</doc> <type name="guint64" c:type="guint64"/> </return-value> <parameters> <instance-parameter name="appsrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1636">a #GstAppSrc</doc> + line="1709">a #GstAppSrc</doc> <type name="AppSrc" c:type="GstAppSrc*"/> </instance-parameter> </parameters> @@ -1554,20 +1554,20 @@ element is the last buffer of the stream.</doc> version="1.10"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1498">Get the duration of the stream in nanoseconds. A value of GST_CLOCK_TIME_NONE means that the duration is + line="1571">Get the duration of the stream in nanoseconds. A value of GST_CLOCK_TIME_NONE means that the duration is not known.</doc> <source-position filename="gst-libs/gst/app/gstappsrc.h" line="140"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1505">the duration of the stream previously set with gst_app_src_set_duration();</doc> + line="1578">the duration of the stream previously set with gst_app_src_set_duration();</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </return-value> <parameters> <instance-parameter name="appsrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1500">a #GstAppSrc</doc> + line="1573">a #GstAppSrc</doc> <type name="AppSrc" c:type="GstAppSrc*"/> </instance-parameter> </parameters> @@ -1576,12 +1576,12 @@ not known.</doc> c:identifier="gst_app_src_get_emit_signals"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1751">Check if appsrc will emit the "new-preroll" and "new-buffer" signals.</doc> + line="1824">Check if appsrc will emit the "new-preroll" and "new-buffer" signals.</doc> <source-position filename="gst-libs/gst/app/gstappsrc.h" line="167"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1757">%TRUE if @appsrc is emitting the "new-preroll" and "new-buffer" + line="1830">%TRUE if @appsrc is emitting the "new-preroll" and "new-buffer" signals.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -1589,7 +1589,7 @@ signals.</doc> <instance-parameter name="appsrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1753">a #GstAppSrc</doc> + line="1826">a #GstAppSrc</doc> <type name="AppSrc" c:type="GstAppSrc*"/> </instance-parameter> </parameters> @@ -1597,7 +1597,7 @@ signals.</doc> <method name="get_latency" c:identifier="gst_app_src_get_latency"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1703">Retrieve the min and max latencies in @min and @max respectively.</doc> + line="1776">Retrieve the min and max latencies in @min and @max respectively.</doc> <source-position filename="gst-libs/gst/app/gstappsrc.h" line="161"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> @@ -1606,7 +1606,7 @@ signals.</doc> <instance-parameter name="appsrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1705">a #GstAppSrc</doc> + line="1778">a #GstAppSrc</doc> <type name="AppSrc" c:type="GstAppSrc*"/> </instance-parameter> <parameter name="min" @@ -1615,7 +1615,7 @@ signals.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1706">the min latency</doc> + line="1779">the min latency</doc> <type name="guint64" c:type="guint64*"/> </parameter> <parameter name="max" @@ -1624,7 +1624,7 @@ signals.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1707">the max latency</doc> + line="1780">the max latency</doc> <type name="guint64" c:type="guint64*"/> </parameter> </parameters> @@ -1632,19 +1632,19 @@ signals.</doc> <method name="get_max_bytes" c:identifier="gst_app_src_get_max_bytes"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1608">Get the maximum amount of bytes that can be queued in @appsrc.</doc> + line="1681">Get the maximum amount of bytes that can be queued in @appsrc.</doc> <source-position filename="gst-libs/gst/app/gstappsrc.h" line="152"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1614">The maximum amount of bytes that can be queued.</doc> + line="1687">The maximum amount of bytes that can be queued.</doc> <type name="guint64" c:type="guint64"/> </return-value> <parameters> <instance-parameter name="appsrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1610">a #GstAppSrc</doc> + line="1683">a #GstAppSrc</doc> <type name="AppSrc" c:type="GstAppSrc*"/> </instance-parameter> </parameters> @@ -1652,20 +1652,20 @@ signals.</doc> <method name="get_size" c:identifier="gst_app_src_get_size"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1445">Get the size of the stream in bytes. A value of -1 means that the size is + line="1518">Get the size of the stream in bytes. A value of -1 means that the size is not known.</doc> <source-position filename="gst-libs/gst/app/gstappsrc.h" line="134"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1452">the size of the stream previously set with gst_app_src_set_size();</doc> + line="1525">the size of the stream previously set with gst_app_src_set_size();</doc> <type name="gint64" c:type="gint64"/> </return-value> <parameters> <instance-parameter name="appsrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1447">a #GstAppSrc</doc> + line="1520">a #GstAppSrc</doc> <type name="AppSrc" c:type="GstAppSrc*"/> </instance-parameter> </parameters> @@ -1674,20 +1674,20 @@ not known.</doc> c:identifier="gst_app_src_get_stream_type"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1553">Get the stream type. Control the stream type of @appsrc + line="1626">Get the stream type. Control the stream type of @appsrc with gst_app_src_set_stream_type().</doc> <source-position filename="gst-libs/gst/app/gstappsrc.h" line="146"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1560">the stream type.</doc> + line="1633">the stream type.</doc> <type name="AppStreamType" c:type="GstAppStreamType"/> </return-value> <parameters> <instance-parameter name="appsrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1555">a #GstAppSrc</doc> + line="1628">a #GstAppSrc</doc> <type name="AppSrc" c:type="GstAppSrc*"/> </instance-parameter> </parameters> @@ -1695,7 +1695,7 @@ with gst_app_src_set_stream_type().</doc> <method name="push_buffer" c:identifier="gst_app_src_push_buffer"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1975">Adds a buffer to the queue of buffers that the appsrc element will + line="2081">Adds a buffer to the queue of buffers that the appsrc element will push to its source pad. This function takes ownership of the buffer. When the block property is TRUE, this function can block until free @@ -1704,7 +1704,7 @@ space becomes available in the queue.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1986">#GST_FLOW_OK when the buffer was successfully queued. + line="2092">#GST_FLOW_OK when the buffer was successfully queued. #GST_FLOW_FLUSHING when @appsrc is not PAUSED or PLAYING. #GST_FLOW_EOS when EOS occurred.</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> @@ -1713,13 +1713,13 @@ space becomes available in the queue.</doc> <instance-parameter name="appsrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1977">a #GstAppSrc</doc> + line="2083">a #GstAppSrc</doc> <type name="AppSrc" c:type="GstAppSrc*"/> </instance-parameter> <parameter name="buffer" transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1978">a #GstBuffer to push</doc> + line="2084">a #GstBuffer to push</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </parameter> </parameters> @@ -1729,7 +1729,7 @@ space becomes available in the queue.</doc> version="1.14"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1996">Adds a buffer list to the queue of buffers and buffer lists that the + line="2102">Adds a buffer list to the queue of buffers and buffer lists that the appsrc element will push to its source pad. This function takes ownership of @buffer_list. @@ -1739,7 +1739,7 @@ space becomes available in the queue.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="2008">#GST_FLOW_OK when the buffer list was successfully queued. + line="2114">#GST_FLOW_OK when the buffer list was successfully queued. #GST_FLOW_FLUSHING when @appsrc is not PAUSED or PLAYING. #GST_FLOW_EOS when EOS occurred.</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> @@ -1748,13 +1748,13 @@ space becomes available in the queue.</doc> <instance-parameter name="appsrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1998">a #GstAppSrc</doc> + line="2104">a #GstAppSrc</doc> <type name="AppSrc" c:type="GstAppSrc*"/> </instance-parameter> <parameter name="buffer_list" transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1999">a #GstBufferList to push</doc> + line="2105">a #GstBufferList to push</doc> <type name="Gst.BufferList" c:type="GstBufferList*"/> </parameter> </parameters> @@ -1764,7 +1764,7 @@ space becomes available in the queue.</doc> version="1.6"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="2020">Extract a buffer from the provided sample and adds it to the queue of + line="2126">Extract a buffer from the provided sample and adds it to the queue of buffers that the appsrc element will push to its source pad. Any previous caps that were set on appsrc will be replaced by the caps associated with the sample if not equal. @@ -1778,7 +1778,7 @@ space becomes available in the queue.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="2037">#GST_FLOW_OK when the buffer was successfully queued. + line="2143">#GST_FLOW_OK when the buffer was successfully queued. #GST_FLOW_FLUSHING when @appsrc is not PAUSED or PLAYING. #GST_FLOW_EOS when EOS occurred.</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> @@ -1787,13 +1787,13 @@ space becomes available in the queue.</doc> <instance-parameter name="appsrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="2022">a #GstAppSrc</doc> + line="2128">a #GstAppSrc</doc> <type name="AppSrc" c:type="GstAppSrc*"/> </instance-parameter> <parameter name="sample" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="2023">a #GstSample from which buffer and caps may be + line="2129">a #GstSample from which buffer and caps may be extracted</doc> <type name="Gst.Sample" c:type="GstSample*"/> </parameter> @@ -1804,7 +1804,7 @@ extracted</doc> introspectable="0"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="2116">Set callbacks which will be executed when data is needed, enough data has + line="2222">Set callbacks which will be executed when data is needed, enough data has been collected or when a seek should be performed. This is an alternative to using the signals, it has lower overhead and is thus less expensive, but also less flexible. @@ -1822,13 +1822,13 @@ way.</doc> <instance-parameter name="appsrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="2118">a #GstAppSrc</doc> + line="2224">a #GstAppSrc</doc> <type name="AppSrc" c:type="GstAppSrc*"/> </instance-parameter> <parameter name="callbacks" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="2119">the callbacks</doc> + line="2225">the callbacks</doc> <type name="AppSrcCallbacks" c:type="GstAppSrcCallbacks*"/> </parameter> <parameter name="user_data" @@ -1837,13 +1837,13 @@ way.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="2120">a user_data argument for the callbacks</doc> + line="2226">a user_data argument for the callbacks</doc> <type name="gpointer" c:type="gpointer"/> </parameter> <parameter name="notify" transfer-ownership="none" scope="async"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="2121">a destroy notify function</doc> + line="2227">a destroy notify function</doc> <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/> </parameter> </parameters> @@ -1851,7 +1851,7 @@ way.</doc> <method name="set_caps" c:identifier="gst_app_src_set_caps"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1350">Set the capabilities on the appsrc element. This function takes + line="1420">Set the capabilities on the appsrc element. This function takes a copy of the caps structure. After calling this method, the source will only produce caps that match @caps. @caps must be fixed and the caps on the buffers must match the caps or left NULL.</doc> @@ -1863,13 +1863,13 @@ buffers must match the caps or left NULL.</doc> <instance-parameter name="appsrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1352">a #GstAppSrc</doc> + line="1422">a #GstAppSrc</doc> <type name="AppSrc" c:type="GstAppSrc*"/> </instance-parameter> <parameter name="caps" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1353">caps to set</doc> + line="1423">caps to set</doc> <type name="Gst.Caps" c:type="const GstCaps*"/> </parameter> </parameters> @@ -1879,7 +1879,7 @@ buffers must match the caps or left NULL.</doc> version="1.10"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1472">Set the duration of the stream in nanoseconds. A value of GST_CLOCK_TIME_NONE means that the duration is + line="1545">Set the duration of the stream in nanoseconds. A value of GST_CLOCK_TIME_NONE means that the duration is not known.</doc> <source-position filename="gst-libs/gst/app/gstappsrc.h" line="137"/> <return-value transfer-ownership="none"> @@ -1889,13 +1889,13 @@ not known.</doc> <instance-parameter name="appsrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1474">a #GstAppSrc</doc> + line="1547">a #GstAppSrc</doc> <type name="AppSrc" c:type="GstAppSrc*"/> </instance-parameter> <parameter name="duration" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1475">the duration to set</doc> + line="1548">the duration to set</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </parameter> </parameters> @@ -1904,7 +1904,7 @@ not known.</doc> c:identifier="gst_app_src_set_emit_signals"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1728">Make appsrc emit the "new-preroll" and "new-buffer" signals. This option is + line="1801">Make appsrc emit the "new-preroll" and "new-buffer" signals. This option is by default disabled because signal emission is expensive and unneeded when the application prefers to operate in pull mode.</doc> <source-position filename="gst-libs/gst/app/gstappsrc.h" line="164"/> @@ -1915,13 +1915,13 @@ the application prefers to operate in pull mode.</doc> <instance-parameter name="appsrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1730">a #GstAppSrc</doc> + line="1803">a #GstAppSrc</doc> <type name="AppSrc" c:type="GstAppSrc*"/> </instance-parameter> <parameter name="emit" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1731">the new state</doc> + line="1804">the new state</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -1929,7 +1929,7 @@ the application prefers to operate in pull mode.</doc> <method name="set_latency" c:identifier="gst_app_src_set_latency"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1688">Configure the @min and @max latency in @src. If @min is set to -1, the + line="1761">Configure the @min and @max latency in @src. If @min is set to -1, the default latency calculations for pseudo-live sources will be used.</doc> <source-position filename="gst-libs/gst/app/gstappsrc.h" line="158"/> <return-value transfer-ownership="none"> @@ -1939,19 +1939,19 @@ default latency calculations for pseudo-live sources will be used.</doc> <instance-parameter name="appsrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1690">a #GstAppSrc</doc> + line="1763">a #GstAppSrc</doc> <type name="AppSrc" c:type="GstAppSrc*"/> </instance-parameter> <parameter name="min" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1691">the min latency</doc> + line="1764">the min latency</doc> <type name="guint64" c:type="guint64"/> </parameter> <parameter name="max" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1692">the max latency</doc> + line="1765">the max latency</doc> <type name="guint64" c:type="guint64"/> </parameter> </parameters> @@ -1959,7 +1959,7 @@ default latency calculations for pseudo-live sources will be used.</doc> <method name="set_max_bytes" c:identifier="gst_app_src_set_max_bytes"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1580">Set the maximum amount of bytes that can be queued in @appsrc. + line="1653">Set the maximum amount of bytes that can be queued in @appsrc. After the maximum amount of bytes are queued, @appsrc will emit the "enough-data" signal.</doc> <source-position filename="gst-libs/gst/app/gstappsrc.h" line="149"/> @@ -1970,13 +1970,13 @@ After the maximum amount of bytes are queued, @appsrc will emit the <instance-parameter name="appsrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1582">a #GstAppSrc</doc> + line="1655">a #GstAppSrc</doc> <type name="AppSrc" c:type="GstAppSrc*"/> </instance-parameter> <parameter name="max" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1583">the maximum number of bytes to queue</doc> + line="1656">the maximum number of bytes to queue</doc> <type name="guint64" c:type="guint64"/> </parameter> </parameters> @@ -1984,7 +1984,7 @@ After the maximum amount of bytes are queued, @appsrc will emit the <method name="set_size" c:identifier="gst_app_src_set_size"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1422">Set the size of the stream in bytes. A value of -1 means that the size is + line="1495">Set the size of the stream in bytes. A value of -1 means that the size is not known.</doc> <source-position filename="gst-libs/gst/app/gstappsrc.h" line="131"/> <return-value transfer-ownership="none"> @@ -1994,13 +1994,13 @@ not known.</doc> <instance-parameter name="appsrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1424">a #GstAppSrc</doc> + line="1497">a #GstAppSrc</doc> <type name="AppSrc" c:type="GstAppSrc*"/> </instance-parameter> <parameter name="size" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1425">the size to set</doc> + line="1498">the size to set</doc> <type name="gint64" c:type="gint64"/> </parameter> </parameters> @@ -2009,7 +2009,7 @@ not known.</doc> c:identifier="gst_app_src_set_stream_type"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1528">Set the stream type on @appsrc. For seekable streams, the "seek" signal must + line="1601">Set the stream type on @appsrc. For seekable streams, the "seek" signal must be connected to. A stream_type stream</doc> @@ -2021,54 +2021,125 @@ A stream_type stream</doc> <instance-parameter name="appsrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1530">a #GstAppSrc</doc> + line="1603">a #GstAppSrc</doc> <type name="AppSrc" c:type="GstAppSrc*"/> </instance-parameter> <parameter name="type" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1531">the new state</doc> + line="1604">the new state</doc> <type name="AppStreamType" c:type="GstAppStreamType"/> </parameter> </parameters> </method> <property name="block" writable="1" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/app/gstappsrc.c" + line="350">When max-bytes are queued and after the enough-data signal has been emitted, +block any further push-buffer calls until the amount of queued bytes drops +below the max-bytes limit.</doc> <type name="gboolean" c:type="gboolean"/> </property> <property name="caps" writable="1" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/app/gstappsrc.c" + line="296">The GstCaps that will negotiated downstream and will be put +on outgoing buffers.</doc> <type name="Gst.Caps"/> </property> - <property name="current-level-bytes" transfer-ownership="none"> + <property name="current-level-bytes" + version="1.2" + transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/app/gstappsrc.c" + line="420">The number of currently queued bytes inside appsrc.</doc> <type name="guint64" c:type="guint64"/> </property> - <property name="duration" writable="1" transfer-ownership="none"> + <property name="duration" + version="1.10" + writable="1" + transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/app/gstappsrc.c" + line="433">The total duration in nanoseconds of the data stream. If the total duration is known, it +is recommended to configure it with this property.</doc> <type name="guint64" c:type="guint64"/> </property> <property name="emit-signals" writable="1" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/app/gstappsrc.c" + line="395">Make appsrc emit the "need-data", "enough-data" and "seek-data" signals. +This option is by default enabled for backwards compatibility reasons but +can disabled when needed because signal emission is expensive.</doc> <type name="gboolean" c:type="gboolean"/> </property> <property name="format" writable="1" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/app/gstappsrc.c" + line="306">The format to use for segment events. When the source is producing +timestamped buffers this property should be set to GST_FORMAT_TIME.</doc> <type name="Gst.Format"/> </property> + <property name="handle-segment-change" + version="1.18" + writable="1" + transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/app/gstappsrc.c" + line="447">When enabled, appsrc will check GstSegment in GstSample which was +pushed via gst_app_src_push_sample() or "push-sample" signal action. +If a GstSegment is changed, corresponding segment event will be followed +by next data flow. + +FIXME: currently only GST_FORMAT_TIME format is supported and therefore +GstAppSrc::format should be time. However, possibly #GstAppSrc can support +other formats.</doc> + <type name="gboolean" c:type="gboolean"/> + </property> <property name="is-live" writable="1" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/app/gstappsrc.c" + line="362">Instruct the source to behave like a live source. This includes that it +will only push out buffers in the PLAYING state.</doc> <type name="gboolean" c:type="gboolean"/> </property> <property name="max-bytes" writable="1" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/app/gstappsrc.c" + line="338">The maximum amount of bytes that can be queued internally. +After the maximum amount of bytes are queued, appsrc will emit the +"enough-data" signal.</doc> <type name="guint64" c:type="guint64"/> </property> <property name="max-latency" writable="1" transfer-ownership="none"> <type name="gint64" c:type="gint64"/> </property> <property name="min-latency" writable="1" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/app/gstappsrc.c" + line="372">The minimum latency of the source. A value of -1 will use the default +latency calculations of #GstBaseSrc.</doc> <type name="gint64" c:type="gint64"/> </property> <property name="min-percent" writable="1" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/app/gstappsrc.c" + line="408">Make appsrc emit the "need-data" signal when the amount of bytes in the +queue drops below this percentage of max-bytes.</doc> <type name="guint" c:type="guint"/> </property> <property name="size" writable="1" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/app/gstappsrc.c" + line="316">The total size in bytes of the data stream. If the total size is known, it +is recommended to configure it with this property.</doc> <type name="gint64" c:type="gint64"/> </property> <property name="stream-type" writable="1" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/app/gstappsrc.c" + line="327">The type of stream that this source is producing. For seekable streams the +application should connect to the seek-data signal.</doc> <type name="AppStreamType"/> </property> <field name="basesrc"> @@ -2083,135 +2154,61 @@ A stream_type stream</doc> </array> </field> <glib:signal name="end-of-stream" when="last" action="1"> - <doc xml:space="preserve" - filename="gst-libs/gst/app/gstappsrc.c" - line="555">Notify @appsrc that no more buffer are available.</doc> <return-value transfer-ownership="none"> <type name="Gst.FlowReturn"/> </return-value> </glib:signal> <glib:signal name="enough-data" when="last"> - <doc xml:space="preserve" - filename="gst-libs/gst/app/gstappsrc.c" - line="460">Signal that the source has enough data. It is recommended that the -application stops calling push-buffer until the need-data signal is -emitted again to avoid excessive buffer queueing.</doc> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> </glib:signal> <glib:signal name="need-data" when="last"> - <doc xml:space="preserve" - filename="gst-libs/gst/app/gstappsrc.c" - line="441">Signal that the source needs more data. In the callback or from another -thread you should call push-buffer or end-of-stream. - -@length is just a hint and when it is set to -1, any number of bytes can be -pushed into @appsrc. - -You can call push-buffer multiple times until the enough-data signal is -fired.</doc> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> <parameters> - <parameter name="length" transfer-ownership="none"> - <doc xml:space="preserve" - filename="gst-libs/gst/app/gstappsrc.c" - line="444">the amount of bytes needed.</doc> + <parameter name="object" transfer-ownership="none"> <type name="guint" c:type="guint"/> </parameter> </parameters> </glib:signal> <glib:signal name="push-buffer" when="last" action="1"> - <doc xml:space="preserve" - filename="gst-libs/gst/app/gstappsrc.c" - line="489">Adds a buffer to the queue of buffers that the appsrc element will -push to its source pad. This function does not take ownership of the -buffer so the buffer needs to be unreffed after calling this function. - -When the block property is TRUE, this function can block until free space -becomes available in the queue.</doc> <return-value transfer-ownership="none"> <type name="Gst.FlowReturn"/> </return-value> <parameters> - <parameter name="buffer" transfer-ownership="none"> - <doc xml:space="preserve" - filename="gst-libs/gst/app/gstappsrc.c" - line="492">a buffer to push</doc> + <parameter name="object" transfer-ownership="none"> <type name="Gst.Buffer"/> </parameter> </parameters> </glib:signal> - <glib:signal name="push-buffer-list" - when="last" - action="1" - version="1.14"> - <doc xml:space="preserve" - filename="gst-libs/gst/app/gstappsrc.c" - line="507">Adds a buffer list to the queue of buffers and buffer lists that the -appsrc element will push to its source pad. This function does not take -ownership of the buffer list so the buffer list needs to be unreffed -after calling this function. - -When the block property is TRUE, this function can block until free space -becomes available in the queue.</doc> + <glib:signal name="push-buffer-list" when="last" action="1"> <return-value transfer-ownership="none"> <type name="Gst.FlowReturn"/> </return-value> <parameters> - <parameter name="buffer_list" transfer-ownership="none"> - <doc xml:space="preserve" - filename="gst-libs/gst/app/gstappsrc.c" - line="510">a buffer list to push</doc> + <parameter name="object" transfer-ownership="none"> <type name="Gst.BufferList"/> </parameter> </parameters> </glib:signal> - <glib:signal name="push-sample" when="last" action="1" version="1.6"> - <doc xml:space="preserve" - filename="gst-libs/gst/app/gstappsrc.c" - line="528">Extract a buffer from the provided sample and adds the extracted buffer -to the queue of buffers that the appsrc element will -push to its source pad. This function set the appsrc caps based on the caps -in the sample and reset the caps if they change. -Only the caps and the buffer of the provided sample are used and not -for example the segment in the sample. -This function does not take ownership of the -sample so the sample needs to be unreffed after calling this function. - -When the block property is TRUE, this function can block until free space -becomes available in the queue.</doc> + <glib:signal name="push-sample" when="last" action="1"> <return-value transfer-ownership="none"> <type name="Gst.FlowReturn"/> </return-value> <parameters> - <parameter name="sample" transfer-ownership="none"> - <doc xml:space="preserve" - filename="gst-libs/gst/app/gstappsrc.c" - line="531">a sample from which extract buffer to push</doc> + <parameter name="object" transfer-ownership="none"> <type name="Gst.Sample"/> </parameter> </parameters> </glib:signal> <glib:signal name="seek-data" when="last"> - <doc xml:space="preserve" - filename="gst-libs/gst/app/gstappsrc.c" - line="473">Seek to the given offset. The next push-buffer should produce buffers from -the new @offset. -This callback is only called for seekable stream types.</doc> <return-value transfer-ownership="none"> - <doc xml:space="preserve" - filename="gst-libs/gst/app/gstappsrc.c" - line="482">%TRUE if the seek succeeded.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> - <parameter name="offset" transfer-ownership="none"> - <doc xml:space="preserve" - filename="gst-libs/gst/app/gstappsrc.c" - line="476">the offset to seek to</doc> + <parameter name="object" transfer-ownership="none"> <type name="guint64" c:type="guint64"/> </parameter> </parameters> @@ -2355,7 +2352,7 @@ gst_app_src_set_callbacks().</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1986">#GST_FLOW_OK when the buffer was successfully queued. + line="2092">#GST_FLOW_OK when the buffer was successfully queued. #GST_FLOW_FLUSHING when @appsrc is not PAUSED or PLAYING. #GST_FLOW_EOS when EOS occurred.</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> @@ -2364,13 +2361,13 @@ gst_app_src_set_callbacks().</doc> <parameter name="appsrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1977">a #GstAppSrc</doc> + line="2083">a #GstAppSrc</doc> <type name="AppSrc" c:type="GstAppSrc*"/> </parameter> <parameter name="buffer" transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1978">a #GstBuffer to push</doc> + line="2084">a #GstBuffer to push</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </parameter> </parameters> @@ -2382,7 +2379,7 @@ gst_app_src_set_callbacks().</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="2082">#GST_FLOW_OK when the EOS was successfully queued. + line="2188">#GST_FLOW_OK when the EOS was successfully queued. #GST_FLOW_FLUSHING when @appsrc is not PAUSED or PLAYING.</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> @@ -2390,7 +2387,7 @@ gst_app_src_set_callbacks().</doc> <parameter name="appsrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="2077">a #GstAppSrc</doc> + line="2183">a #GstAppSrc</doc> <type name="AppSrc" c:type="GstAppSrc*"/> </parameter> </parameters> @@ -2402,7 +2399,7 @@ gst_app_src_set_callbacks().</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="2037">#GST_FLOW_OK when the buffer was successfully queued. + line="2143">#GST_FLOW_OK when the buffer was successfully queued. #GST_FLOW_FLUSHING when @appsrc is not PAUSED or PLAYING. #GST_FLOW_EOS when EOS occurred.</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> @@ -2411,13 +2408,13 @@ gst_app_src_set_callbacks().</doc> <parameter name="appsrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="2022">a #GstAppSrc</doc> + line="2128">a #GstAppSrc</doc> <type name="AppSrc" c:type="GstAppSrc*"/> </parameter> <parameter name="sample" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="2023">a #GstSample from which buffer and caps may be + line="2129">a #GstSample from which buffer and caps may be extracted</doc> <type name="Gst.Sample" c:type="GstSample*"/> </parameter> @@ -2430,7 +2427,7 @@ extracted</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="2008">#GST_FLOW_OK when the buffer list was successfully queued. + line="2114">#GST_FLOW_OK when the buffer list was successfully queued. #GST_FLOW_FLUSHING when @appsrc is not PAUSED or PLAYING. #GST_FLOW_EOS when EOS occurred.</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> @@ -2439,13 +2436,13 @@ extracted</doc> <parameter name="appsrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1998">a #GstAppSrc</doc> + line="2104">a #GstAppSrc</doc> <type name="AppSrc" c:type="GstAppSrc*"/> </parameter> <parameter name="buffer_list" transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/app/gstappsrc.c" - line="1999">a #GstBufferList to push</doc> + line="2105">a #GstBufferList to push</doc> <type name="Gst.BufferList" c:type="GstBufferList*"/> </parameter> </parameters> diff --git a/girs/GstAudio-1.0.gir b/girs/GstAudio-1.0.gir index 6a11bf0228..9571f47709 100644 --- a/girs/GstAudio-1.0.gir +++ b/girs/GstAudio-1.0.gir @@ -473,11 +473,11 @@ and/or use gtk-doc annotations. --> c:type="GST_AUDIO_CONVERTER_OPT_DITHER_METHOD"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-converter.h" - line="42">#GstAudioDitherMethod, The dither method to use when + line="49">#GstAudioDitherMethod, The dither method to use when changing bit depth. Default is #GST_AUDIO_DITHER_NONE.</doc> <source-position filename="gst-libs/gst/audio/audio-converter.h" - line="49"/> + line="56"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="AUDIO_CONVERTER_OPT_MIX_MATRIX" @@ -485,7 +485,7 @@ Default is #GST_AUDIO_DITHER_NONE.</doc> c:type="GST_AUDIO_CONVERTER_OPT_MIX_MATRIX"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-converter.h" - line="69">#GST_TYPE_LIST, The channel mapping matrix. + line="76">#GST_TYPE_LIST, The channel mapping matrix. The matrix coefficients must be between -1 and 1: the number of rows is equal to the number of output channels and the number of columns is equal to the @@ -513,7 +513,7 @@ g_object_set_property (G_OBJECT (audiomixmatrix), "matrix", &v); g_value_unset (&v); ]|</doc> <source-position filename="gst-libs/gst/audio/audio-converter.h" - line="100"/> + line="107"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="AUDIO_CONVERTER_OPT_NOISE_SHAPING_METHOD" @@ -521,11 +521,11 @@ g_value_unset (&v); c:type="GST_AUDIO_CONVERTER_OPT_NOISE_SHAPING_METHOD"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-converter.h" - line="51">#GstAudioNoiseShapingMethod, The noise shaping method to use + line="58">#GstAudioNoiseShapingMethod, The noise shaping method to use to mask noise from quantization errors. Default is #GST_AUDIO_NOISE_SHAPING_NONE.</doc> <source-position filename="gst-libs/gst/audio/audio-converter.h" - line="58"/> + line="65"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="AUDIO_CONVERTER_OPT_QUANTIZATION" @@ -533,11 +533,11 @@ Default is #GST_AUDIO_NOISE_SHAPING_NONE.</doc> c:type="GST_AUDIO_CONVERTER_OPT_QUANTIZATION"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-converter.h" - line="60">#G_TYPE_UINT, The quantization amount. Components will be + line="67">#G_TYPE_UINT, The quantization amount. Components will be quantized to multiples of this value. Default is 1</doc> <source-position filename="gst-libs/gst/audio/audio-converter.h" - line="67"/> + line="74"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="AUDIO_CONVERTER_OPT_RESAMPLER_METHOD" @@ -545,11 +545,11 @@ Default is 1</doc> c:type="GST_AUDIO_CONVERTER_OPT_RESAMPLER_METHOD"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-converter.h" - line="33">#GstAudioResamplerMethod, The resampler method to use when + line="40">#GstAudioResamplerMethod, The resampler method to use when changing sample rates. Default is #GST_AUDIO_RESAMPLER_METHOD_BLACKMAN_NUTTALL.</doc> <source-position filename="gst-libs/gst/audio/audio-converter.h" - line="40"/> + line="47"/> <type name="utf8" c:type="gchar*"/> </constant> <function-macro name="AUDIO_DECODER" @@ -1389,7 +1389,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:type="GST_AUDIO_RESAMPLER_OPT_CUBIC_B"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.h" - line="51">G_TYPE_DOUBLE, B parameter of the cubic filter. + line="58">G_TYPE_DOUBLE, B parameter of the cubic filter. Values between 0.0 and 2.0 are accepted. 1.0 is the default. Below are some values of popular filters: @@ -1398,7 +1398,7 @@ Hermite 0.0 0.0 Spline 1.0 0.0 Catmull-Rom 0.0 1/2</doc> <source-position filename="gst-libs/gst/audio/audio-resampler.h" - line="63"/> + line="70"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="AUDIO_RESAMPLER_OPT_CUBIC_C" @@ -1406,12 +1406,12 @@ Catmull-Rom 0.0 1/2</doc> c:type="GST_AUDIO_RESAMPLER_OPT_CUBIC_C"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.h" - line="64">G_TYPE_DOUBLE, C parameter of the cubic filter. + line="71">G_TYPE_DOUBLE, C parameter of the cubic filter. Values between 0.0 and 2.0 are accepted. 0.0 is the default. See #GST_AUDIO_RESAMPLER_OPT_CUBIC_B for some more common values</doc> <source-position filename="gst-libs/gst/audio/audio-resampler.h" - line="72"/> + line="79"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="AUDIO_RESAMPLER_OPT_CUTOFF" @@ -1419,9 +1419,9 @@ See #GST_AUDIO_RESAMPLER_OPT_CUBIC_B for some more common values</doc> c:type="GST_AUDIO_RESAMPLER_OPT_CUTOFF"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.h" - line="30">G_TYPE_DOUBLE, Cutoff parameter for the filter. 0.940 is the default.</doc> + line="37">G_TYPE_DOUBLE, Cutoff parameter for the filter. 0.940 is the default.</doc> <source-position filename="gst-libs/gst/audio/audio-resampler.h" - line="35"/> + line="42"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="AUDIO_RESAMPLER_OPT_FILTER_INTERPOLATION" @@ -1429,11 +1429,11 @@ See #GST_AUDIO_RESAMPLER_OPT_CUBIC_B for some more common values</doc> c:type="GST_AUDIO_RESAMPLER_OPT_FILTER_INTERPOLATION"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.h" - line="131">GST_TYPE_AUDIO_RESAMPLER_INTERPOLATION: how the filter coefficients should be + line="142">GST_TYPE_AUDIO_RESAMPLER_INTERPOLATION: how the filter coefficients should be interpolated. GST_AUDIO_RESAMPLER_FILTER_INTERPOLATION_CUBIC is default.</doc> <source-position filename="gst-libs/gst/audio/audio-resampler.h" - line="138"/> + line="149"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="AUDIO_RESAMPLER_OPT_FILTER_MODE" @@ -1441,11 +1441,11 @@ GST_AUDIO_RESAMPLER_FILTER_INTERPOLATION_CUBIC is default.</doc> c:type="GST_AUDIO_RESAMPLER_OPT_FILTER_MODE"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.h" - line="99">GST_TYPE_AUDIO_RESAMPLER_FILTER_MODE: how the filter tables should be + line="108">GST_TYPE_AUDIO_RESAMPLER_FILTER_MODE: how the filter tables should be constructed. GST_AUDIO_RESAMPLER_FILTER_MODE_AUTO is the default.</doc> <source-position filename="gst-libs/gst/audio/audio-resampler.h" - line="106"/> + line="115"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="AUDIO_RESAMPLER_OPT_FILTER_MODE_THRESHOLD" @@ -1453,11 +1453,11 @@ GST_AUDIO_RESAMPLER_FILTER_MODE_AUTO is the default.</doc> c:type="GST_AUDIO_RESAMPLER_OPT_FILTER_MODE_THRESHOLD"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.h" - line="107">G_TYPE_UINT: the amount of memory to use for full filter tables before + line="116">G_TYPE_UINT: the amount of memory to use for full filter tables before switching to interpolated filter tables. 1048576 is the default.</doc> <source-position filename="gst-libs/gst/audio/audio-resampler.h" - line="114"/> + line="123"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="AUDIO_RESAMPLER_OPT_FILTER_OVERSAMPLE" @@ -1465,10 +1465,10 @@ switching to interpolated filter tables. c:type="GST_AUDIO_RESAMPLER_OPT_FILTER_OVERSAMPLE"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.h" - line="139">G_TYPE_UINT, oversampling to use when interpolating filters + line="150">G_TYPE_UINT, oversampling to use when interpolating filters 8 is the default.</doc> <source-position filename="gst-libs/gst/audio/audio-resampler.h" - line="145"/> + line="156"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="AUDIO_RESAMPLER_OPT_MAX_PHASE_ERROR" @@ -1476,11 +1476,11 @@ switching to interpolated filter tables. c:type="GST_AUDIO_RESAMPLER_OPT_MAX_PHASE_ERROR"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.h" - line="147">G_TYPE_DOUBLE: The maximum allowed phase error when switching sample + line="158">G_TYPE_DOUBLE: The maximum allowed phase error when switching sample rates. 0.1 is the default.</doc> <source-position filename="gst-libs/gst/audio/audio-resampler.h" - line="154"/> + line="165"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="AUDIO_RESAMPLER_OPT_N_TAPS" @@ -1488,10 +1488,10 @@ rates. c:type="GST_AUDIO_RESAMPLER_OPT_N_TAPS"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.h" - line="74">G_TYPE_INT: the number of taps to use for the filter. + line="81">G_TYPE_INT: the number of taps to use for the filter. 0 is the default and selects the taps automatically.</doc> <source-position filename="gst-libs/gst/audio/audio-resampler.h" - line="80"/> + line="87"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="AUDIO_RESAMPLER_OPT_STOP_ATTENUATION" @@ -1499,10 +1499,10 @@ rates. c:type="GST_AUDIO_RESAMPLER_OPT_STOP_ATTENUATION"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.h" - line="36">G_TYPE_DOUBLE, stopband attenuation in decibels. The attenuation + line="43">G_TYPE_DOUBLE, stopband attenuation in decibels. The attenuation after the stopband for the kaiser window. 85 dB is the default.</doc> <source-position filename="gst-libs/gst/audio/audio-resampler.h" - line="42"/> + line="49"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="AUDIO_RESAMPLER_OPT_TRANSITION_BANDWIDTH" @@ -1510,31 +1510,31 @@ after the stopband for the kaiser window. 85 dB is the default.</doc> c:type="GST_AUDIO_RESAMPLER_OPT_TRANSITION_BANDWIDTH"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.h" - line="43">G_TYPE_DOUBLE, transition bandwidth. The width of the + line="50">G_TYPE_DOUBLE, transition bandwidth. The width of the transition band for the kaiser window. 0.087 is the default.</doc> <source-position filename="gst-libs/gst/audio/audio-resampler.h" - line="49"/> + line="56"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="AUDIO_RESAMPLER_QUALITY_DEFAULT" value="4" c:type="GST_AUDIO_RESAMPLER_QUALITY_DEFAULT"> <source-position filename="gst-libs/gst/audio/audio-resampler.h" - line="202"/> + line="215"/> <type name="gint" c:type="gint"/> </constant> <constant name="AUDIO_RESAMPLER_QUALITY_MAX" value="10" c:type="GST_AUDIO_RESAMPLER_QUALITY_MAX"> <source-position filename="gst-libs/gst/audio/audio-resampler.h" - line="201"/> + line="214"/> <type name="gint" c:type="gint"/> </constant> <constant name="AUDIO_RESAMPLER_QUALITY_MIN" value="0" c:type="GST_AUDIO_RESAMPLER_QUALITY_MIN"> <source-position filename="gst-libs/gst/audio/audio-resampler.h" - line="200"/> + line="213"/> <type name="gint" c:type="gint"/> </constant> <function-macro name="AUDIO_RING_BUFFER" @@ -1711,7 +1711,21 @@ caps. A notable exception for now is the sample rate, sink pads must have the same sample rate as either the downstream requirement, or the first configured pad, or a combination of both (when -downstream specifies a range or a set of acceptable rates).</doc> +downstream specifies a range or a set of acceptable rates). + +The #GstAggregator::samples-selected signal is provided with some +additional information about the output buffer: +- "offset" G_TYPE_UINT64 Offset in samples since segment start + for the position that is next to be filled in the output buffer. +- "frames" G_TYPE_UINT Number of frames per output buffer. + +In addition the gst_aggregator_peek_next_sample() function returns +additional information in the info #GstStructure of the returned sample: +- "output-offset" G_TYPE_UINT64 Sample offset in output segment relative to + the output segment's start where the current position of this input + buffer would be placed +- "position" G_TYPE_UINT current position in the input buffer in samples +- "size" G_TYPE_UINT size of the input buffer in samples</doc> <source-position filename="gst-libs/gst/audio/gstaudioaggregator.h" line="212"/> <virtual-method name="aggregate_one_buffer"> @@ -1797,7 +1811,7 @@ downstream specifies a range or a set of acceptable rates).</doc> transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioaggregator.c" - line="575">Output block size in nanoseconds, expressed as a fraction.</doc> + line="596">Output block size in nanoseconds, expressed as a fraction.</doc> <type name="Gst.Fraction"/> </property> <field name="parent"> @@ -4508,6 +4522,7 @@ be used.</doc> </callback> <record name="AudioConverter" c:type="GstAudioConverter" + version="1.8" glib:type-name="GstAudioConverter" glib:get-type="gst_audio_converter_get_type" c:symbol-prefix="audio_converter"> @@ -4522,7 +4537,7 @@ The object can perform conversion of: * audio channels and channel layout</doc> <source-position filename="gst-libs/gst/audio/audio-converter.h" - line="31"/> + line="38"/> <constructor name="new" c:identifier="gst_audio_converter_new"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-converter.c" @@ -4532,7 +4547,7 @@ audio formats. @config contains extra configuration options, see `GST_AUDIO_CONVERTER_OPT_*` parameters for details about the options and values.</doc> <source-position filename="gst-libs/gst/audio/audio-converter.h" - line="119"/> + line="126"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-converter.c" @@ -4578,7 +4593,7 @@ parameters for details about the options and values.</doc> perform allocation of the output buffer based on the result from gst_audio_converter_get_out_frames().</doc> <source-position filename="gst-libs/gst/audio/audio-converter.h" - line="166"/> + line="173"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-converter.c" @@ -4640,7 +4655,7 @@ gst_audio_converter_get_out_frames().</doc> filename="gst-libs/gst/audio/audio-converter.c" line="1447">Free a previously allocated @convert instance.</doc> <source-position filename="gst-libs/gst/audio/audio-converter.h" - line="128"/> + line="135"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -4658,7 +4673,7 @@ gst_audio_converter_get_out_frames().</doc> filename="gst-libs/gst/audio/audio-converter.c" line="375">Get the current configuration of @convert.</doc> <source-position filename="gst-libs/gst/audio/audio-converter.h" - line="139"/> + line="146"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-converter.c" @@ -4705,7 +4720,7 @@ gst_audio_converter_get_out_frames().</doc> line="1501">Calculate how many input frames are currently needed by @convert to produce @out_frames of output frames.</doc> <source-position filename="gst-libs/gst/audio/audio-converter.h" - line="147"/> + line="154"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-converter.c" @@ -4734,7 +4749,7 @@ gst_audio_converter_get_out_frames().</doc> line="1521">Get the maximum number of input frames that the converter would need before producing output.</doc> <source-position filename="gst-libs/gst/audio/audio-converter.h" - line="151"/> + line="158"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-converter.c" @@ -4758,7 +4773,7 @@ frames.</doc> line="1481">Calculate how many output frames can be produced when @in_frames input frames are given to @convert.</doc> <source-position filename="gst-libs/gst/audio/audio-converter.h" - line="143"/> + line="150"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-converter.c" @@ -4785,14 +4800,14 @@ frames are given to @convert.</doc> version="1.16"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-converter.c" - line="1653">Returns whether the audio converter will operate in passthrough mode. + line="1655">Returns whether the audio converter will operate in passthrough mode. The return value would be typically input to gst_base_transform_set_passthrough()</doc> <source-position filename="gst-libs/gst/audio/audio-converter.h" - line="163"/> + line="170"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-converter.c" - line="1659">%TRUE when no conversion will actually occur.</doc> + line="1661">%TRUE when no conversion will actually occur.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> @@ -4807,7 +4822,7 @@ The return value would be typically input to gst_base_transform_set_passthrough( line="1540">Reset @convert to the state it was when it was first created, clearing any history it might currently have.</doc> <source-position filename="gst-libs/gst/audio/audio-converter.h" - line="131"/> + line="138"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -4840,7 +4855,7 @@ input. Use gst_audio_converter_get_out_frames() and gst_audio_converter_get_in_frames() to make sure @in_frames and @out_frames are matching and @in and @out point to enough memory.</doc> <source-position filename="gst-libs/gst/audio/audio-converter.h" - line="154"/> + line="161"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-converter.c" @@ -4893,13 +4908,14 @@ are matching and @in and @out point to enough memory.</doc> </parameters> </method> <method name="supports_inplace" - c:identifier="gst_audio_converter_supports_inplace"> + c:identifier="gst_audio_converter_supports_inplace" + version="1.12"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-converter.c" line="1638">Returns whether the audio converter can perform the conversion in-place. The return value would be typically input to gst_base_transform_set_in_place()</doc> <source-position filename="gst-libs/gst/audio/audio-converter.h" - line="160"/> + line="167"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-converter.c" @@ -4934,7 +4950,7 @@ then be retrieved and refined with gst_audio_converter_get_config(). Look at the `GST_AUDIO_CONVERTER_OPT_*` fields to check valid configuration option and values.</doc> <source-position filename="gst-libs/gst/audio/audio-converter.h" - line="134"/> + line="141"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-converter.c" @@ -4978,14 +4994,14 @@ option and values.</doc> c:type="GstAudioConverterFlags"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-converter.h" - line="102">Extra flags passed to gst_audio_converter_new() and gst_audio_converter_samples().</doc> + line="109">Extra flags passed to gst_audio_converter_new() and gst_audio_converter_samples().</doc> <member name="none" value="0" c:identifier="GST_AUDIO_CONVERTER_FLAG_NONE" glib:nick="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-converter.h" - line="104">no flag</doc> + line="111">no flag</doc> </member> <member name="in_writable" value="1" @@ -4993,7 +5009,7 @@ option and values.</doc> glib:nick="in-writable"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-converter.h" - line="105">the input sample arrays are writable and can be + line="112">the input sample arrays are writable and can be used as temporary storage during conversion.</doc> </member> <member name="variable_rate" @@ -5002,7 +5018,7 @@ option and values.</doc> glib:nick="variable-rate"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-converter.h" - line="107">allow arbitrary rate updates with + line="114">allow arbitrary rate updates with gst_audio_converter_update_config().</doc> </member> </bitfield> @@ -5182,7 +5198,7 @@ Things that subclass need to take care of: <virtual-method name="negotiate" invoker="negotiate"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="737">Negotiate with downstream elements to currently configured #GstAudioInfo. + line="759">Negotiate with downstream elements to currently configured #GstAudioInfo. Unmark GST_PAD_FLAG_NEED_RECONFIGURE in any case. But mark it again if negotiate fails.</doc> <source-position filename="gst-libs/gst/audio/gstaudiodecoder.h" @@ -5190,14 +5206,14 @@ negotiate fails.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="745">%TRUE if the negotiation succeeded, else %FALSE.</doc> + line="767">%TRUE if the negotiation succeeded, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="739">a #GstAudioDecoder</doc> + line="761">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> </parameters> @@ -5389,27 +5405,27 @@ negotiate fails.</doc> c:identifier="gst_audio_decoder_allocate_output_buffer"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3705">Helper function that allocates a buffer to hold an audio frame + line="3742">Helper function that allocates a buffer to hold an audio frame for @dec's current output format.</doc> <source-position filename="gst-libs/gst/audio/gstaudiodecoder.h" line="344"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3713">allocated buffer</doc> + line="3750">allocated buffer</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </return-value> <parameters> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3707">a #GstAudioDecoder</doc> + line="3744">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> <parameter name="size" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3708">size of the buffer</doc> + line="3745">size of the buffer</doc> <type name="gsize" c:type="gsize"/> </parameter> </parameters> @@ -5418,7 +5434,7 @@ for @dec's current output format.</doc> c:identifier="gst_audio_decoder_finish_frame"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="1273">Collects decoded data and pushes it downstream. + line="1304">Collects decoded data and pushes it downstream. @buf may be NULL in which case the indicated number of frames are discarded and considered to have produced no output @@ -5433,14 +5449,14 @@ invalidated by a call to this function.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="1290">a #GstFlowReturn that should be escalated to caller (of caller)</doc> + line="1321">a #GstFlowReturn that should be escalated to caller (of caller)</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> <parameters> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="1275">a #GstAudioDecoder</doc> + line="1306">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> <parameter name="buf" @@ -5449,13 +5465,13 @@ invalidated by a call to this function.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="1276">decoded data</doc> + line="1307">decoded data</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </parameter> <parameter name="frames" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="1277">number of decoded frames represented by decoded data</doc> + line="1308">number of decoded frames represented by decoded data</doc> <type name="gint" c:type="gint"/> </parameter> </parameters> @@ -5465,7 +5481,7 @@ invalidated by a call to this function.</doc> version="1.16"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="1239">Collects decoded data and pushes it downstream. This function may be called + line="1270">Collects decoded data and pushes it downstream. This function may be called multiple times for a given input frame. @buf may be NULL in which case it is assumed that the current input frame is @@ -5483,14 +5499,14 @@ invalidated by a call to this function.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="1258">a #GstFlowReturn that should be escalated to caller (of caller)</doc> + line="1289">a #GstFlowReturn that should be escalated to caller (of caller)</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> <parameters> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="1241">a #GstAudioDecoder</doc> + line="1272">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> <parameter name="buf" @@ -5499,7 +5515,7 @@ invalidated by a call to this function.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="1242">decoded data</doc> + line="1273">decoded data</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </parameter> </parameters> @@ -5508,7 +5524,7 @@ invalidated by a call to this function.</doc> c:identifier="gst_audio_decoder_get_allocator"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3756">Lets #GstAudioDecoder sub-classes to know the memory @allocator + line="3793">Lets #GstAudioDecoder sub-classes to know the memory @allocator used by the base class and its @params. Unref the @allocator after use it.</doc> @@ -5521,7 +5537,7 @@ Unref the @allocator after use it.</doc> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3758">a #GstAudioDecoder</doc> + line="3795">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> <parameter name="allocator" @@ -5532,7 +5548,7 @@ Unref the @allocator after use it.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3759">the #GstAllocator + line="3796">the #GstAllocator used</doc> <type name="Gst.Allocator" c:type="GstAllocator**"/> </parameter> @@ -5544,7 +5560,7 @@ used</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3761">the + line="3798">the #GstAllocationParams of @allocator</doc> <type name="Gst.AllocationParams" c:type="GstAllocationParams*"/> </parameter> @@ -5557,14 +5573,14 @@ used</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3236">a #GstAudioInfo describing the input audio format</doc> + line="3273">a #GstAudioInfo describing the input audio format</doc> <type name="AudioInfo" c:type="GstAudioInfo*"/> </return-value> <parameters> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3234">a #GstAudioDecoder</doc> + line="3271">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> </parameters> @@ -5575,14 +5591,14 @@ used</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3308">currently configured decoder delay</doc> + line="3345">currently configured decoder delay</doc> <type name="gint" c:type="gint"/> </return-value> <parameters> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3306">a #GstAudioDecoder</doc> + line="3343">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> </parameters> @@ -5591,13 +5607,13 @@ used</doc> c:identifier="gst_audio_decoder_get_drainable"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3594">Queries decoder drain handling.</doc> + line="3631">Queries decoder drain handling.</doc> <source-position filename="gst-libs/gst/audio/gstaudiodecoder.h" line="423"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3600">TRUE if drainable handling is enabled. + line="3637">TRUE if drainable handling is enabled. MT safe.</doc> <type name="gboolean" c:type="gboolean"/> @@ -5606,7 +5622,7 @@ MT safe.</doc> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3596">a #GstAudioDecoder</doc> + line="3633">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> </parameters> @@ -5618,14 +5634,14 @@ MT safe.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3294">currently configured byte to time conversion setting</doc> + line="3331">currently configured byte to time conversion setting</doc> <type name="gint" c:type="gint"/> </return-value> <parameters> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3292">a #GstAudioDecoder</doc> + line="3329">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> </parameters> @@ -5633,7 +5649,7 @@ MT safe.</doc> <method name="get_latency" c:identifier="gst_audio_decoder_get_latency"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3376">Sets the variables pointed to by @min and @max to the currently configured + line="3413">Sets the variables pointed to by @min and @max to the currently configured latency.</doc> <source-position filename="gst-libs/gst/audio/gstaudiodecoder.h" line="382"/> @@ -5644,7 +5660,7 @@ latency.</doc> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3378">a #GstAudioDecoder</doc> + line="3415">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> <parameter name="min" @@ -5655,7 +5671,7 @@ latency.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3379">a pointer to storage to hold minimum latency</doc> + line="3416">a pointer to storage to hold minimum latency</doc> <type name="Gst.ClockTime" c:type="GstClockTime*"/> </parameter> <parameter name="max" @@ -5666,7 +5682,7 @@ latency.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3380">a pointer to storage to hold maximum latency</doc> + line="3417">a pointer to storage to hold maximum latency</doc> <type name="Gst.ClockTime" c:type="GstClockTime*"/> </parameter> </parameters> @@ -5678,14 +5694,14 @@ latency.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3340">currently configured decoder tolerated error count.</doc> + line="3377">currently configured decoder tolerated error count.</doc> <type name="gint" c:type="gint"/> </return-value> <parameters> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3338">a #GstAudioDecoder</doc> + line="3375">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> </parameters> @@ -5694,13 +5710,13 @@ latency.</doc> c:identifier="gst_audio_decoder_get_min_latency"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3505">Queries decoder's latency aggregation.</doc> + line="3542">Queries decoder's latency aggregation.</doc> <source-position filename="gst-libs/gst/audio/gstaudiodecoder.h" line="409"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3511">aggregation latency. + line="3548">aggregation latency. MT safe.</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> @@ -5709,7 +5725,7 @@ MT safe.</doc> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3507">a #GstAudioDecoder</doc> + line="3544">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> </parameters> @@ -5718,13 +5734,13 @@ MT safe.</doc> c:identifier="gst_audio_decoder_get_needs_format"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3642">Queries decoder required format handling.</doc> + line="3679">Queries decoder required format handling.</doc> <source-position filename="gst-libs/gst/audio/gstaudiodecoder.h" line="430"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3648">TRUE if required format handling is enabled. + line="3685">TRUE if required format handling is enabled. MT safe.</doc> <type name="gboolean" c:type="gboolean"/> @@ -5733,7 +5749,7 @@ MT safe.</doc> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3644">a #GstAudioDecoder</doc> + line="3681">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> </parameters> @@ -5742,7 +5758,7 @@ MT safe.</doc> c:identifier="gst_audio_decoder_get_parse_state"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3399">Return current parsing (sync and eos) state.</doc> + line="3436">Return current parsing (sync and eos) state.</doc> <source-position filename="gst-libs/gst/audio/gstaudiodecoder.h" line="387"/> <return-value transfer-ownership="none"> @@ -5752,7 +5768,7 @@ MT safe.</doc> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3401">a #GstAudioDecoder</doc> + line="3438">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> <parameter name="sync" @@ -5763,7 +5779,7 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3402">a pointer to a variable to hold the current sync state</doc> + line="3439">a pointer to a variable to hold the current sync state</doc> <type name="gboolean" c:type="gboolean*"/> </parameter> <parameter name="eos" @@ -5774,7 +5790,7 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3403">a pointer to a variable to hold the current eos state</doc> + line="3440">a pointer to a variable to hold the current eos state</doc> <type name="gboolean" c:type="gboolean*"/> </parameter> </parameters> @@ -5782,13 +5798,13 @@ MT safe.</doc> <method name="get_plc" c:identifier="gst_audio_decoder_get_plc"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3462">Queries decoder packet loss concealment handling.</doc> + line="3499">Queries decoder packet loss concealment handling.</doc> <source-position filename="gst-libs/gst/audio/gstaudiodecoder.h" line="402"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3468">TRUE if packet loss concealment is enabled. + line="3505">TRUE if packet loss concealment is enabled. MT safe.</doc> <type name="gboolean" c:type="gboolean"/> @@ -5797,7 +5813,7 @@ MT safe.</doc> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3464">a #GstAudioDecoder</doc> + line="3501">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> </parameters> @@ -5809,14 +5825,14 @@ MT safe.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3265">currently configured plc handling</doc> + line="3302">currently configured plc handling</doc> <type name="gint" c:type="gint"/> </return-value> <parameters> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3263">a #GstAudioDecoder</doc> + line="3300">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> </parameters> @@ -5825,13 +5841,13 @@ MT safe.</doc> c:identifier="gst_audio_decoder_get_tolerance"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3548">Queries current audio jitter tolerance threshold.</doc> + line="3585">Queries current audio jitter tolerance threshold.</doc> <source-position filename="gst-libs/gst/audio/gstaudiodecoder.h" line="416"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3554">decoder audio jitter tolerance threshold. + line="3591">decoder audio jitter tolerance threshold. MT safe.</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> @@ -5840,7 +5856,7 @@ MT safe.</doc> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3550">a #GstAudioDecoder</doc> + line="3587">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> </parameters> @@ -5848,7 +5864,7 @@ MT safe.</doc> <method name="merge_tags" c:identifier="gst_audio_decoder_merge_tags"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3666">Sets the audio decoder tags and how they should be merged with any + line="3703">Sets the audio decoder tags and how they should be merged with any upstream stream tags. This will override any tags previously-set with gst_audio_decoder_merge_tags(). @@ -5863,7 +5879,7 @@ not required to use this and can still do tag handling on its own.</doc> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3668">a #GstAudioDecoder</doc> + line="3705">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> <parameter name="tags" @@ -5872,13 +5888,13 @@ not required to use this and can still do tag handling on its own.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3669">a #GstTagList to merge, or NULL</doc> + line="3706">a #GstTagList to merge, or NULL</doc> <type name="Gst.TagList" c:type="const GstTagList*"/> </parameter> <parameter name="mode" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3670">the #GstTagMergeMode to use, usually #GST_TAG_MERGE_REPLACE</doc> + line="3707">the #GstTagMergeMode to use, usually #GST_TAG_MERGE_REPLACE</doc> <type name="Gst.TagMergeMode" c:type="GstTagMergeMode"/> </parameter> </parameters> @@ -5886,7 +5902,7 @@ not required to use this and can still do tag handling on its own.</doc> <method name="negotiate" c:identifier="gst_audio_decoder_negotiate"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="737">Negotiate with downstream elements to currently configured #GstAudioInfo. + line="759">Negotiate with downstream elements to currently configured #GstAudioInfo. Unmark GST_PAD_FLAG_NEED_RECONFIGURE in any case. But mark it again if negotiate fails.</doc> <source-position filename="gst-libs/gst/audio/gstaudiodecoder.h" @@ -5894,14 +5910,14 @@ negotiate fails.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="745">%TRUE if the negotiation succeeded, else %FALSE.</doc> + line="767">%TRUE if the negotiation succeeded, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="739">a #GstAudioDecoder</doc> + line="761">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> </parameters> @@ -5911,7 +5927,7 @@ negotiate fails.</doc> version="1.6"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="2730">Returns caps that express @caps (or sink template caps if @caps == NULL) + line="2761">Returns caps that express @caps (or sink template caps if @caps == NULL) restricted to rate/channels/... combinations supported by downstream elements.</doc> <source-position filename="gst-libs/gst/audio/gstaudiodecoder.h" @@ -5919,14 +5935,14 @@ elements.</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="2740">a #GstCaps owned by caller</doc> + line="2771">a #GstCaps owned by caller</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="2732">a #GstAudioDecoder</doc> + line="2763">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> <parameter name="caps" @@ -5935,7 +5951,7 @@ elements.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="2733">initial caps</doc> + line="2764">initial caps</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> <parameter name="filter" @@ -5944,7 +5960,7 @@ elements.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="2734">filter caps</doc> + line="2765">filter caps</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> </parameters> @@ -5954,7 +5970,7 @@ elements.</doc> version="1.10"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3419">Sets a caps in allocation query which are different from the set + line="3456">Sets a caps in allocation query which are different from the set pad's caps. Use this function before calling gst_audio_decoder_negotiate(). Setting to %NULL the allocation query will use the caps from the pad.</doc> @@ -5967,7 +5983,7 @@ query will use the caps from the pad.</doc> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3421">a #GstAudioDecoder</doc> + line="3458">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> <parameter name="allocation_caps" @@ -5976,7 +5992,7 @@ query will use the caps from the pad.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3422">a #GstCaps or %NULL</doc> + line="3459">a #GstCaps or %NULL</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> </parameters> @@ -5985,7 +6001,7 @@ query will use the caps from the pad.</doc> c:identifier="gst_audio_decoder_set_drainable"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3572">Configures decoder drain handling. If drainable, subclass might + line="3609">Configures decoder drain handling. If drainable, subclass might be handed a NULL buffer to have it return any leftover decoded data. Otherwise, it is not considered so capable and will only ever be passed real data. @@ -6000,13 +6016,13 @@ MT safe.</doc> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3574">a #GstAudioDecoder</doc> + line="3611">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> <parameter name="enabled" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3575">new state</doc> + line="3612">new state</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -6015,7 +6031,7 @@ MT safe.</doc> c:identifier="gst_audio_decoder_set_estimate_rate"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3275">Allows baseclass to perform byte to time estimated conversion.</doc> + line="3312">Allows baseclass to perform byte to time estimated conversion.</doc> <source-position filename="gst-libs/gst/audio/gstaudiodecoder.h" line="360"/> <return-value transfer-ownership="none"> @@ -6025,13 +6041,13 @@ MT safe.</doc> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3277">a #GstAudioDecoder</doc> + line="3314">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> <parameter name="enabled" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3278">whether to enable byte to time conversion</doc> + line="3315">whether to enable byte to time conversion</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -6039,7 +6055,7 @@ MT safe.</doc> <method name="set_latency" c:identifier="gst_audio_decoder_set_latency"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3350">Sets decoder latency.</doc> + line="3387">Sets decoder latency.</doc> <source-position filename="gst-libs/gst/audio/gstaudiodecoder.h" line="377"/> <return-value transfer-ownership="none"> @@ -6049,19 +6065,19 @@ MT safe.</doc> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3352">a #GstAudioDecoder</doc> + line="3389">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> <parameter name="min" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3353">minimum latency</doc> + line="3390">minimum latency</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </parameter> <parameter name="max" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3354">maximum latency</doc> + line="3391">maximum latency</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </parameter> </parameters> @@ -6070,7 +6086,7 @@ MT safe.</doc> c:identifier="gst_audio_decoder_set_max_errors"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3318">Sets numbers of tolerated decoder errors, where a tolerated one is then only + line="3355">Sets numbers of tolerated decoder errors, where a tolerated one is then only warned about, but more than tolerated will lead to fatal error. You can set -1 for never returning fatal errors. Default is set to GST_AUDIO_DECODER_MAX_ERRORS.</doc> @@ -6083,13 +6099,13 @@ GST_AUDIO_DECODER_MAX_ERRORS.</doc> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3320">a #GstAudioDecoder</doc> + line="3357">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> <parameter name="num" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3321">max tolerated errors</doc> + line="3358">max tolerated errors</doc> <type name="gint" c:type="gint"/> </parameter> </parameters> @@ -6098,7 +6114,7 @@ GST_AUDIO_DECODER_MAX_ERRORS.</doc> c:identifier="gst_audio_decoder_set_min_latency"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3486">Sets decoder minimum aggregation latency. + line="3523">Sets decoder minimum aggregation latency. MT safe.</doc> <source-position filename="gst-libs/gst/audio/gstaudiodecoder.h" @@ -6110,13 +6126,13 @@ MT safe.</doc> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3488">a #GstAudioDecoder</doc> + line="3525">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> <parameter name="num" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3489">new minimum latency</doc> + line="3526">new minimum latency</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </parameter> </parameters> @@ -6125,7 +6141,7 @@ MT safe.</doc> c:identifier="gst_audio_decoder_set_needs_format"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3618">Configures decoder format needs. If enabled, subclass needs to be + line="3655">Configures decoder format needs. If enabled, subclass needs to be negotiated with format caps before it can process any data. It will then never be handed any data before it has been configured. Otherwise, it might be handed data without having been configured and @@ -6142,13 +6158,13 @@ MT safe.</doc> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3620">a #GstAudioDecoder</doc> + line="3657">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> <parameter name="enabled" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3621">new state</doc> + line="3658">new state</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -6158,7 +6174,7 @@ MT safe.</doc> version="1.16"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="802">Configure output caps on the srcpad of @dec. Similar to + line="824">Configure output caps on the srcpad of @dec. Similar to gst_audio_decoder_set_output_format(), but allows subclasses to specify output caps that can't be expressed via #GstAudioInfo e.g. caps that have caps features.</doc> @@ -6167,20 +6183,20 @@ caps features.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="812">%TRUE on success.</doc> + line="834">%TRUE on success.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="804">a #GstAudioDecoder</doc> + line="826">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> <parameter name="caps" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="805">(fixed) #GstCaps</doc> + line="827">(fixed) #GstCaps</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> </parameters> @@ -6189,26 +6205,26 @@ caps features.</doc> c:identifier="gst_audio_decoder_set_output_format"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="769">Configure output info on the srcpad of @dec.</doc> + line="791">Configure output info on the srcpad of @dec.</doc> <source-position filename="gst-libs/gst/audio/gstaudiodecoder.h" line="321"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="776">%TRUE on success.</doc> + line="798">%TRUE on success.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="771">a #GstAudioDecoder</doc> + line="793">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> <parameter name="info" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="772">#GstAudioInfo</doc> + line="794">#GstAudioInfo</doc> <type name="AudioInfo" c:type="const GstAudioInfo*"/> </parameter> </parameters> @@ -6216,7 +6232,7 @@ caps features.</doc> <method name="set_plc" c:identifier="gst_audio_decoder_set_plc"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3440">Enable or disable decoder packet loss concealment, provided subclass + line="3477">Enable or disable decoder packet loss concealment, provided subclass and codec are capable and allow handling plc. MT safe.</doc> @@ -6229,13 +6245,13 @@ MT safe.</doc> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3442">a #GstAudioDecoder</doc> + line="3479">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> <parameter name="enabled" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3443">new state</doc> + line="3480">new state</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -6244,7 +6260,7 @@ MT safe.</doc> c:identifier="gst_audio_decoder_set_plc_aware"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3246">Indicates whether or not subclass handles packet loss concealment (plc).</doc> + line="3283">Indicates whether or not subclass handles packet loss concealment (plc).</doc> <source-position filename="gst-libs/gst/audio/gstaudiodecoder.h" line="353"/> <return-value transfer-ownership="none"> @@ -6254,13 +6270,13 @@ MT safe.</doc> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3248">a #GstAudioDecoder</doc> + line="3285">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> <parameter name="plc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3249">new plc state</doc> + line="3286">new plc state</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -6269,7 +6285,7 @@ MT safe.</doc> c:identifier="gst_audio_decoder_set_tolerance"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3529">Configures decoder audio jitter tolerance threshold. + line="3566">Configures decoder audio jitter tolerance threshold. MT safe.</doc> <source-position filename="gst-libs/gst/audio/gstaudiodecoder.h" @@ -6281,13 +6297,13 @@ MT safe.</doc> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3531">a #GstAudioDecoder</doc> + line="3568">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> <parameter name="tolerance" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3532">new tolerance</doc> + line="3569">new tolerance</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </parameter> </parameters> @@ -6297,7 +6313,7 @@ MT safe.</doc> version="1.6"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3783">Lets #GstAudioDecoder sub-classes decide if they want the sink pad + line="3820">Lets #GstAudioDecoder sub-classes decide if they want the sink pad to use the default pad query handler to reply to accept-caps queries. By setting this to true it is possible to further customize the default @@ -6312,17 +6328,27 @@ handler with %GST_PAD_SET_ACCEPT_INTERSECT and <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3785">a #GstAudioDecoder</doc> + line="3822">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </instance-parameter> <parameter name="use" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="3786">if the default pad accept-caps query handling should be used</doc> + line="3823">if the default pad accept-caps query handling should be used</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> </method> + <property name="max-errors" + version="1.18" + writable="1" + transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/audio/gstaudiodecoder.c" + line="417">Maximum number of tolerated consecutive decode errors. See +gst_audio_decoder_set_max_errors() for more details.</doc> + <type name="gint" c:type="gint"/> + </property> <property name="min-latency" writable="1" transfer-ownership="none"> <type name="gint64" c:type="gint64"/> </property> @@ -6563,14 +6589,14 @@ overridden.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="745">%TRUE if the negotiation succeeded, else %FALSE.</doc> + line="767">%TRUE if the negotiation succeeded, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiodecoder.c" - line="739">a #GstAudioDecoder</doc> + line="761">a #GstAudioDecoder</doc> <type name="AudioDecoder" c:type="GstAudioDecoder*"/> </parameter> </parameters> @@ -6969,7 +6995,7 @@ Things that subclass need to take care of: <virtual-method name="negotiate" invoker="negotiate"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2804">Negotiate with downstream elements to currently configured #GstCaps. + line="2819">Negotiate with downstream elements to currently configured #GstCaps. Unmark GST_PAD_FLAG_NEED_RECONFIGURE in any case. But mark it again if negotiate fails.</doc> <source-position filename="gst-libs/gst/audio/gstaudioencoder.h" @@ -6977,14 +7003,14 @@ negotiate fails.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2812">%TRUE if the negotiation succeeded, else %FALSE.</doc> + line="2827">%TRUE if the negotiation succeeded, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2806">a #GstAudioEncoder</doc> + line="2821">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> </parameters> @@ -7155,27 +7181,27 @@ negotiate fails.</doc> c:identifier="gst_audio_encoder_allocate_output_buffer"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2882">Helper function that allocates a buffer to hold an encoded audio frame + line="2897">Helper function that allocates a buffer to hold an encoded audio frame for @enc's current output format.</doc> <source-position filename="gst-libs/gst/audio/gstaudioencoder.h" line="271"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2890">allocated buffer</doc> + line="2905">allocated buffer</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </return-value> <parameters> <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2884">a #GstAudioEncoder</doc> + line="2899">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> <parameter name="size" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2885">size of the buffer</doc> + line="2900">size of the buffer</doc> <type name="gsize" c:type="gsize"/> </parameter> </parameters> @@ -7184,7 +7210,7 @@ for @enc's current output format.</doc> c:identifier="gst_audio_encoder_finish_frame"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="717">Collects encoded data and pushes encoded data downstream. + line="732">Collects encoded data and pushes encoded data downstream. Source pad caps must be set when this is called. If @samples < 0, then best estimate is all samples provided to encoder @@ -7199,14 +7225,14 @@ may be invalidated by a call to this function.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="734">a #GstFlowReturn that should be escalated to caller (of caller)</doc> + line="749">a #GstFlowReturn that should be escalated to caller (of caller)</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> <parameters> <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="719">a #GstAudioEncoder</doc> + line="734">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> <parameter name="buffer" @@ -7215,13 +7241,13 @@ may be invalidated by a call to this function.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="720">encoded data</doc> + line="735">encoded data</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </parameter> <parameter name="samples" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="721">number of samples (per channel) represented by encoded data</doc> + line="736">number of samples (per channel) represented by encoded data</doc> <type name="gint" c:type="gint"/> </parameter> </parameters> @@ -7230,7 +7256,7 @@ may be invalidated by a call to this function.</doc> c:identifier="gst_audio_encoder_get_allocator"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2933">Lets #GstAudioEncoder sub-classes to know the memory @allocator + line="2948">Lets #GstAudioEncoder sub-classes to know the memory @allocator used by the base class and its @params. Unref the @allocator after use it.</doc> @@ -7243,7 +7269,7 @@ Unref the @allocator after use it.</doc> <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2935">a #GstAudioEncoder</doc> + line="2950">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> <parameter name="allocator" @@ -7254,7 +7280,7 @@ Unref the @allocator after use it.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2936">the #GstAllocator + line="2951">the #GstAllocator used</doc> <type name="Gst.Allocator" c:type="GstAllocator**"/> </parameter> @@ -7266,7 +7292,7 @@ used</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2938">the + line="2953">the #GstAllocationParams of @allocator</doc> <type name="Gst.AllocationParams" c:type="GstAllocationParams*"/> </parameter> @@ -7279,14 +7305,14 @@ used</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2138">a #GstAudioInfo describing the input audio format</doc> + line="2153">a #GstAudioInfo describing the input audio format</doc> <type name="AudioInfo" c:type="GstAudioInfo*"/> </return-value> <parameters> <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2136">a #GstAudioEncoder</doc> + line="2151">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> </parameters> @@ -7295,13 +7321,13 @@ used</doc> c:identifier="gst_audio_encoder_get_drainable"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2632">Queries encoder drain handling.</doc> + line="2647">Queries encoder drain handling.</doc> <source-position filename="gst-libs/gst/audio/gstaudioencoder.h" line="363"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2638">TRUE if drainable handling is enabled. + line="2653">TRUE if drainable handling is enabled. MT safe.</doc> <type name="gboolean" c:type="gboolean"/> @@ -7310,7 +7336,7 @@ MT safe.</doc> <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2634">a #GstAudioEncoder</doc> + line="2649">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> </parameters> @@ -7322,14 +7348,14 @@ MT safe.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2246">currently configured maximum handled frames</doc> + line="2261">currently configured maximum handled frames</doc> <type name="gint" c:type="gint"/> </return-value> <parameters> <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2244">a #GstAudioEncoder</doc> + line="2259">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> </parameters> @@ -7341,14 +7367,14 @@ MT safe.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2212">currently maximum requested samples per frame</doc> + line="2227">currently maximum requested samples per frame</doc> <type name="gint" c:type="gint"/> </return-value> <parameters> <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2210">a #GstAudioEncoder</doc> + line="2225">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> </parameters> @@ -7360,14 +7386,14 @@ MT safe.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2175">currently minimum requested samples per frame</doc> + line="2190">currently minimum requested samples per frame</doc> <type name="gint" c:type="gint"/> </return-value> <parameters> <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2173">a #GstAudioEncoder</doc> + line="2188">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> </parameters> @@ -7376,13 +7402,13 @@ MT safe.</doc> c:identifier="gst_audio_encoder_get_hard_min"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2586">Queries encoder hard minimum handling.</doc> + line="2601">Queries encoder hard minimum handling.</doc> <source-position filename="gst-libs/gst/audio/gstaudioencoder.h" line="356"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2592">TRUE if hard minimum handling is enabled. + line="2607">TRUE if hard minimum handling is enabled. MT safe.</doc> <type name="gboolean" c:type="gboolean"/> @@ -7391,7 +7417,7 @@ MT safe.</doc> <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2588">a #GstAudioEncoder</doc> + line="2603">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> </parameters> @@ -7412,7 +7438,7 @@ MT safe.</doc> <method name="get_latency" c:identifier="gst_audio_encoder_get_latency"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2318">Sets the variables pointed to by @min and @max to the currently configured + line="2333">Sets the variables pointed to by @min and @max to the currently configured latency.</doc> <source-position filename="gst-libs/gst/audio/gstaudioencoder.h" line="304"/> @@ -7423,7 +7449,7 @@ latency.</doc> <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2320">a #GstAudioEncoder</doc> + line="2335">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> <parameter name="min" @@ -7434,7 +7460,7 @@ latency.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2321">a pointer to storage to hold minimum latency</doc> + line="2336">a pointer to storage to hold minimum latency</doc> <type name="Gst.ClockTime" c:type="GstClockTime*"/> </parameter> <parameter name="max" @@ -7445,7 +7471,7 @@ latency.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2322">a pointer to storage to hold maximum latency</doc> + line="2337">a pointer to storage to hold maximum latency</doc> <type name="Gst.ClockTime" c:type="GstClockTime*"/> </parameter> </parameters> @@ -7457,14 +7483,14 @@ latency.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2279">currently configured encoder lookahead</doc> + line="2294">currently configured encoder lookahead</doc> <type name="gint" c:type="gint"/> </return-value> <parameters> <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2277">a #GstAudioEncoder</doc> + line="2292">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> </parameters> @@ -7473,13 +7499,13 @@ latency.</doc> c:identifier="gst_audio_encoder_get_mark_granule"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2404">Queries if the encoder will handle granule marking.</doc> + line="2419">Queries if the encoder will handle granule marking.</doc> <source-position filename="gst-libs/gst/audio/gstaudioencoder.h" line="328"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2410">TRUE if granule marking is enabled. + line="2425">TRUE if granule marking is enabled. MT safe.</doc> <type name="gboolean" c:type="gboolean"/> @@ -7488,7 +7514,7 @@ MT safe.</doc> <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2406">a #GstAudioEncoder</doc> + line="2421">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> </parameters> @@ -7497,13 +7523,13 @@ MT safe.</doc> c:identifier="gst_audio_encoder_get_perfect_timestamp"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2450">Queries encoder perfect timestamp behaviour.</doc> + line="2465">Queries encoder perfect timestamp behaviour.</doc> <source-position filename="gst-libs/gst/audio/gstaudioencoder.h" line="335"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2456">TRUE if perfect timestamp setting enabled. + line="2471">TRUE if perfect timestamp setting enabled. MT safe.</doc> <type name="gboolean" c:type="gboolean"/> @@ -7512,7 +7538,7 @@ MT safe.</doc> <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2452">a #GstAudioEncoder</doc> + line="2467">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> </parameters> @@ -7521,13 +7547,13 @@ MT safe.</doc> c:identifier="gst_audio_encoder_get_tolerance"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2540">Queries current audio jitter tolerance threshold.</doc> + line="2555">Queries current audio jitter tolerance threshold.</doc> <source-position filename="gst-libs/gst/audio/gstaudioencoder.h" line="349"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2546">encoder audio jitter tolerance threshold. + line="2561">encoder audio jitter tolerance threshold. MT safe.</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> @@ -7536,7 +7562,7 @@ MT safe.</doc> <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2542">a #GstAudioEncoder</doc> + line="2557">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> </parameters> @@ -7544,7 +7570,7 @@ MT safe.</doc> <method name="merge_tags" c:identifier="gst_audio_encoder_merge_tags"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2656">Sets the audio encoder tags and how they should be merged with any + line="2671">Sets the audio encoder tags and how they should be merged with any upstream stream tags. This will override any tags previously-set with gst_audio_encoder_merge_tags(). @@ -7561,7 +7587,7 @@ MT safe.</doc> <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2658">a #GstAudioEncoder</doc> + line="2673">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> <parameter name="tags" @@ -7570,14 +7596,14 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2659">a #GstTagList to merge, or NULL to unset + line="2674">a #GstTagList to merge, or NULL to unset previously-set tags</doc> <type name="Gst.TagList" c:type="const GstTagList*"/> </parameter> <parameter name="mode" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2661">the #GstTagMergeMode to use, usually #GST_TAG_MERGE_REPLACE</doc> + line="2676">the #GstTagMergeMode to use, usually #GST_TAG_MERGE_REPLACE</doc> <type name="Gst.TagMergeMode" c:type="GstTagMergeMode"/> </parameter> </parameters> @@ -7585,7 +7611,7 @@ MT safe.</doc> <method name="negotiate" c:identifier="gst_audio_encoder_negotiate"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2804">Negotiate with downstream elements to currently configured #GstCaps. + line="2819">Negotiate with downstream elements to currently configured #GstCaps. Unmark GST_PAD_FLAG_NEED_RECONFIGURE in any case. But mark it again if negotiate fails.</doc> <source-position filename="gst-libs/gst/audio/gstaudioencoder.h" @@ -7593,14 +7619,14 @@ negotiate fails.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2812">%TRUE if the negotiation succeeded, else %FALSE.</doc> + line="2827">%TRUE if the negotiation succeeded, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2806">a #GstAudioEncoder</doc> + line="2821">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> </parameters> @@ -7609,7 +7635,7 @@ negotiate fails.</doc> c:identifier="gst_audio_encoder_proxy_getcaps"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="1482">Returns caps that express @caps (or sink template caps if @caps == NULL) + line="1497">Returns caps that express @caps (or sink template caps if @caps == NULL) restricted to channel/rate combinations supported by downstream elements (e.g. muxers).</doc> <source-position filename="gst-libs/gst/audio/gstaudioencoder.h" @@ -7617,14 +7643,14 @@ restricted to channel/rate combinations supported by downstream elements <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="1492">a #GstCaps owned by caller</doc> + line="1507">a #GstCaps owned by caller</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </return-value> <parameters> <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="1484">a #GstAudioEncoder</doc> + line="1499">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> <parameter name="caps" @@ -7633,7 +7659,7 @@ restricted to channel/rate combinations supported by downstream elements allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="1485">initial caps</doc> + line="1500">initial caps</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> <parameter name="filter" @@ -7642,7 +7668,7 @@ restricted to channel/rate combinations supported by downstream elements allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="1486">filter caps</doc> + line="1501">filter caps</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> </parameters> @@ -7652,7 +7678,7 @@ restricted to channel/rate combinations supported by downstream elements version="1.10"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2362">Sets a caps in allocation query which are different from the set + line="2377">Sets a caps in allocation query which are different from the set pad's caps. Use this function before calling gst_audio_encoder_negotiate(). Setting to %NULL the allocation query will use the caps from the pad.</doc> @@ -7665,7 +7691,7 @@ query will use the caps from the pad.</doc> <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2364">a #GstAudioEncoder</doc> + line="2379">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> <parameter name="allocation_caps" @@ -7674,7 +7700,7 @@ query will use the caps from the pad.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2365">a #GstCaps or %NULL</doc> + line="2380">a #GstCaps or %NULL</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> </parameters> @@ -7683,7 +7709,7 @@ query will use the caps from the pad.</doc> c:identifier="gst_audio_encoder_set_drainable"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2610">Configures encoder drain handling. If drainable, subclass might + line="2625">Configures encoder drain handling. If drainable, subclass might be handed a NULL buffer to have it return any leftover encoded data. Otherwise, it is not considered so capable and will only ever be passed real data. @@ -7698,13 +7724,13 @@ MT safe.</doc> <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2612">a #GstAudioEncoder</doc> + line="2627">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> <parameter name="enabled" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2613">new state</doc> + line="2628">new state</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -7713,7 +7739,7 @@ MT safe.</doc> c:identifier="gst_audio_encoder_set_frame_max"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2222">Sets max number of frames accepted at once (assumed minimally 1). + line="2237">Sets max number of frames accepted at once (assumed minimally 1). Requires @frame_samples_min and @frame_samples_max to be the equal. Note: This value will be reset to 0 every time before @@ -7727,13 +7753,13 @@ Note: This value will be reset to 0 every time before <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2224">a #GstAudioEncoder</doc> + line="2239">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> <parameter name="num" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2225">number of frames</doc> + line="2240">number of frames</doc> <type name="gint" c:type="gint"/> </parameter> </parameters> @@ -7742,7 +7768,7 @@ Note: This value will be reset to 0 every time before c:identifier="gst_audio_encoder_set_frame_samples_max"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2185">Sets number of samples (per channel) subclass needs to be handed, + line="2200">Sets number of samples (per channel) subclass needs to be handed, at most or will be handed all available if 0. If an exact number of samples is required, gst_audio_encoder_set_frame_samples_min() @@ -7759,13 +7785,13 @@ Note: This value will be reset to 0 every time before <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2187">a #GstAudioEncoder</doc> + line="2202">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> <parameter name="num" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2188">number of samples per frame</doc> + line="2203">number of samples per frame</doc> <type name="gint" c:type="gint"/> </parameter> </parameters> @@ -7774,7 +7800,7 @@ Note: This value will be reset to 0 every time before c:identifier="gst_audio_encoder_set_frame_samples_min"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2148">Sets number of samples (per channel) subclass needs to be handed, + line="2163">Sets number of samples (per channel) subclass needs to be handed, at least or will be handed all available if 0. If an exact number of samples is required, gst_audio_encoder_set_frame_samples_max() @@ -7791,13 +7817,13 @@ Note: This value will be reset to 0 every time before <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2150">a #GstAudioEncoder</doc> + line="2165">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> <parameter name="num" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2151">number of samples per frame</doc> + line="2166">number of samples per frame</doc> <type name="gint" c:type="gint"/> </parameter> </parameters> @@ -7806,7 +7832,7 @@ Note: This value will be reset to 0 every time before c:identifier="gst_audio_encoder_set_hard_min"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2564">Configures encoder hard minimum handling. If enabled, subclass + line="2579">Configures encoder hard minimum handling. If enabled, subclass will never be handed less samples than it configured, which otherwise might occur near end-of-data handling. Instead, the leftover samples will simply be discarded. @@ -7821,13 +7847,13 @@ MT safe.</doc> <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2566">a #GstAudioEncoder</doc> + line="2581">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> <parameter name="enabled" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2567">new state</doc> + line="2582">new state</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -7851,7 +7877,7 @@ MT safe.</doc> <method name="set_headers" c:identifier="gst_audio_encoder_set_headers"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2341">Set the codec headers to be sent downstream whenever requested.</doc> + line="2356">Set the codec headers to be sent downstream whenever requested.</doc> <source-position filename="gst-libs/gst/audio/gstaudioencoder.h" line="314"/> <return-value transfer-ownership="none"> @@ -7861,13 +7887,13 @@ MT safe.</doc> <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2343">a #GstAudioEncoder</doc> + line="2358">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> <parameter name="headers" transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2344">a list of + line="2359">a list of #GstBuffer containing the codec header</doc> <type name="GLib.List" c:type="GList*"> <type name="Gst.Buffer"/> @@ -7878,7 +7904,7 @@ MT safe.</doc> <method name="set_latency" c:identifier="gst_audio_encoder_set_latency"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2289">Sets encoder latency.</doc> + line="2304">Sets encoder latency.</doc> <source-position filename="gst-libs/gst/audio/gstaudioencoder.h" line="309"/> <return-value transfer-ownership="none"> @@ -7888,19 +7914,19 @@ MT safe.</doc> <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2291">a #GstAudioEncoder</doc> + line="2306">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> <parameter name="min" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2292">minimum latency</doc> + line="2307">minimum latency</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </parameter> <parameter name="max" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2293">maximum latency</doc> + line="2308">maximum latency</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </parameter> </parameters> @@ -7909,7 +7935,7 @@ MT safe.</doc> c:identifier="gst_audio_encoder_set_lookahead"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2256">Sets encoder lookahead (in units of input rate samples) + line="2271">Sets encoder lookahead (in units of input rate samples) Note: This value will be reset to 0 every time before #GstAudioEncoderClass.set_format() is called.</doc> @@ -7922,13 +7948,13 @@ Note: This value will be reset to 0 every time before <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2258">a #GstAudioEncoder</doc> + line="2273">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> <parameter name="num" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2259">lookahead</doc> + line="2274">lookahead</doc> <type name="gint" c:type="gint"/> </parameter> </parameters> @@ -7937,7 +7963,7 @@ Note: This value will be reset to 0 every time before c:identifier="gst_audio_encoder_set_mark_granule"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2383">Enable or disable encoder granule handling. + line="2398">Enable or disable encoder granule handling. MT safe.</doc> <source-position filename="gst-libs/gst/audio/gstaudioencoder.h" @@ -7949,13 +7975,13 @@ MT safe.</doc> <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2385">a #GstAudioEncoder</doc> + line="2400">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> <parameter name="enabled" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2386">new state</doc> + line="2401">new state</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -7964,26 +7990,26 @@ MT safe.</doc> c:identifier="gst_audio_encoder_set_output_format"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2836">Configure output caps on the srcpad of @enc.</doc> + line="2851">Configure output caps on the srcpad of @enc.</doc> <source-position filename="gst-libs/gst/audio/gstaudioencoder.h" line="264"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2843">%TRUE on success.</doc> + line="2858">%TRUE on success.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2838">a #GstAudioEncoder</doc> + line="2853">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> <parameter name="caps" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2839">#GstCaps</doc> + line="2854">#GstCaps</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> </parameters> @@ -7992,7 +8018,7 @@ MT safe.</doc> c:identifier="gst_audio_encoder_set_perfect_timestamp"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2428">Enable or disable encoder perfect output timestamp preference. + line="2443">Enable or disable encoder perfect output timestamp preference. MT safe.</doc> <source-position filename="gst-libs/gst/audio/gstaudioencoder.h" @@ -8004,13 +8030,13 @@ MT safe.</doc> <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2430">a #GstAudioEncoder</doc> + line="2445">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> <parameter name="enabled" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2431">new state</doc> + line="2446">new state</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -8019,7 +8045,7 @@ MT safe.</doc> c:identifier="gst_audio_encoder_set_tolerance"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2519">Configures encoder audio jitter tolerance threshold. + line="2534">Configures encoder audio jitter tolerance threshold. MT safe.</doc> <source-position filename="gst-libs/gst/audio/gstaudioencoder.h" @@ -8031,13 +8057,13 @@ MT safe.</doc> <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2521">a #GstAudioEncoder</doc> + line="2536">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </instance-parameter> <parameter name="tolerance" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2522">new tolerance</doc> + line="2537">new tolerance</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </parameter> </parameters> @@ -8277,14 +8303,14 @@ needed. At minimum @set_format and @handle_frame needs to be overridden.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2812">%TRUE if the negotiation succeeded, else %FALSE.</doc> + line="2827">%TRUE if the negotiation succeeded, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudioencoder.c" - line="2806">a #GstAudioEncoder</doc> + line="2821">a #GstAudioEncoder</doc> <type name="AudioEncoder" c:type="GstAudioEncoder*"/> </parameter> </parameters> @@ -8488,7 +8514,7 @@ function.</doc> c:identifier="gst_audio_filter_class_add_pad_templates"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiofilter.c" - line="206">Convenience function to add pad templates to this element class, with + line="211">Convenience function to add pad templates to this element class, with @allowed_caps as the caps that can be handled. This function is usually used from within a GObject class_init function.</doc> @@ -8501,13 +8527,13 @@ This function is usually used from within a GObject class_init function.</doc> <instance-parameter name="klass" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiofilter.c" - line="208">an #GstAudioFilterClass</doc> + line="213">an #GstAudioFilterClass</doc> <type name="AudioFilterClass" c:type="GstAudioFilterClass*"/> </instance-parameter> <parameter name="allowed_caps" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/gstaudiofilter.c" - line="209">what formats the filter can handle, as #GstCaps</doc> + line="214">what formats the filter can handle, as #GstCaps</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> </parameters> @@ -9915,21 +9941,22 @@ the @dither and @ns parameters.</doc> line="71">samples are non-interleaved</doc> </member> </bitfield> - <record name="AudioResampler" c:type="GstAudioResampler" disguised="1"> + <record name="AudioResampler" + c:type="GstAudioResampler" + disguised="1" + version="1.10"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.c" line="43">#GstAudioResampler is a structure which holds the information required to perform various kinds of resampling filtering.</doc> <source-position filename="gst-libs/gst/audio/audio-resampler.h" - line="28"/> - <method name="free" - c:identifier="gst_audio_resampler_free" - version="1.6"> + line="35"/> + <method name="free" c:identifier="gst_audio_resampler_free"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.c" line="1620">Free a previously allocated #GstAudioResampler @resampler.</doc> <source-position filename="gst-libs/gst/audio/audio-resampler.h" - line="218"/> + line="231"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -9946,14 +9973,14 @@ required to perform various kinds of resampling filtering.</doc> c:identifier="gst_audio_resampler_get_in_frames"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.c" - line="1682">Get the number of input frames that would currently be needed + line="1680">Get the number of input frames that would currently be needed to produce @out_frames from @resampler.</doc> <source-position filename="gst-libs/gst/audio/audio-resampler.h" - line="233"/> + line="246"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.c" - line="1690">The number of input frames needed for producing + line="1688">The number of input frames needed for producing @out_frames of data from @resampler.</doc> <type name="gsize" c:type="gsize"/> </return-value> @@ -9961,13 +9988,13 @@ to produce @out_frames from @resampler.</doc> <instance-parameter name="resampler" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.c" - line="1684">a #GstAudioResampler</doc> + line="1682">a #GstAudioResampler</doc> <type name="AudioResampler" c:type="GstAudioResampler*"/> </instance-parameter> <parameter name="out_frames" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.c" - line="1685">number of input frames</doc> + line="1683">number of input frames</doc> <type name="gsize" c:type="gsize"/> </parameter> </parameters> @@ -9976,14 +10003,14 @@ to produce @out_frames from @resampler.</doc> c:identifier="gst_audio_resampler_get_max_latency"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.c" - line="1709">Get the maximum number of input samples that the resampler would + line="1707">Get the maximum number of input samples that the resampler would need before producing output.</doc> <source-position filename="gst-libs/gst/audio/audio-resampler.h" - line="237"/> + line="250"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.c" - line="1716">the latency of @resampler as expressed in the number of + line="1714">the latency of @resampler as expressed in the number of frames.</doc> <type name="gsize" c:type="gsize"/> </return-value> @@ -9991,7 +10018,7 @@ frames.</doc> <instance-parameter name="resampler" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.c" - line="1711">a #GstAudioResampler</doc> + line="1709">a #GstAudioResampler</doc> <type name="AudioResampler" c:type="GstAudioResampler*"/> </instance-parameter> </parameters> @@ -10000,14 +10027,14 @@ frames.</doc> c:identifier="gst_audio_resampler_get_out_frames"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.c" - line="1643">Get the number of output frames that would be currently available when + line="1641">Get the number of output frames that would be currently available when @in_frames are given to @resampler.</doc> <source-position filename="gst-libs/gst/audio/audio-resampler.h" - line="229"/> + line="242"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.c" - line="1651">The number of frames that would be available after giving + line="1649">The number of frames that would be available after giving @in_frames as input to @resampler.</doc> <type name="gsize" c:type="gsize"/> </return-value> @@ -10015,13 +10042,13 @@ frames.</doc> <instance-parameter name="resampler" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.c" - line="1645">a #GstAudioResampler</doc> + line="1643">a #GstAudioResampler</doc> <type name="AudioResampler" c:type="GstAudioResampler*"/> </instance-parameter> <parameter name="in_frames" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.c" - line="1646">number of input frames</doc> + line="1644">number of input frames</doc> <type name="gsize" c:type="gsize"/> </parameter> </parameters> @@ -10029,7 +10056,7 @@ frames.</doc> <method name="resample" c:identifier="gst_audio_resampler_resample"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.c" - line="1727">Perform resampling on @in_frames frames in @in and write @out_frames to @out. + line="1725">Perform resampling on @in_frames frames in @in and write @out_frames to @out. In case the samples are interleaved, @in and @out must point to an array with a single element pointing to a block of interleaved samples. @@ -10045,7 +10072,7 @@ input. Use gst_audio_resampler_get_out_frames() and gst_audio_resampler_get_in_frames() to make sure @in_frames and @out_frames are matching and @in and @out point to enough memory.</doc> <source-position filename="gst-libs/gst/audio/audio-resampler.h" - line="240"/> + line="253"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -10053,7 +10080,7 @@ are matching and @in and @out point to enough memory.</doc> <instance-parameter name="resampler" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.c" - line="1729">a #GstAudioResampler</doc> + line="1727">a #GstAudioResampler</doc> <type name="AudioResampler" c:type="GstAudioResampler*"/> </instance-parameter> <parameter name="in" @@ -10062,13 +10089,13 @@ are matching and @in and @out point to enough memory.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.c" - line="1730">input samples</doc> + line="1728">input samples</doc> <type name="gpointer" c:type="gpointer*"/> </parameter> <parameter name="in_frames" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.c" - line="1731">number of input frames</doc> + line="1729">number of input frames</doc> <type name="gsize" c:type="gsize"/> </parameter> <parameter name="out" @@ -10077,13 +10104,13 @@ are matching and @in and @out point to enough memory.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.c" - line="1732">output samples</doc> + line="1730">output samples</doc> <type name="gpointer" c:type="gpointer*"/> </parameter> <parameter name="out_frames" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.c" - line="1733">number of output frames</doc> + line="1731">number of output frames</doc> <type name="gsize" c:type="gsize"/> </parameter> </parameters> @@ -10094,7 +10121,7 @@ are matching and @in and @out point to enough memory.</doc> line="1462">Reset @resampler to the state it was when it was first created, discarding all sample history.</doc> <source-position filename="gst-libs/gst/audio/audio-resampler.h" - line="221"/> + line="234"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -10117,7 +10144,7 @@ When @in_rate or @out_rate is 0, its value is unchanged. When @options is %NULL, the previously configured options are reused.</doc> <source-position filename="gst-libs/gst/audio/audio-resampler.h" - line="224"/> + line="237"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.c" @@ -10156,7 +10183,7 @@ When @options is %NULL, the previously configured options are reused.</doc> filename="gst-libs/gst/audio/audio-resampler.c" line="1333">Make a new resampler.</doc> <source-position filename="gst-libs/gst/audio/audio-resampler.h" - line="211"/> + line="224"/> <return-value transfer-ownership="full" skip="1"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.c" @@ -10217,7 +10244,7 @@ When @options is %NULL, the previously configured options are reused.</doc> line="1269">Set the parameters for resampling from @in_rate to @out_rate using @method for @quality in @options.</doc> <source-position filename="gst-libs/gst/audio/audio-resampler.h" - line="205"/> + line="218"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -10257,19 +10284,20 @@ for @quality in @options.</doc> </function> </record> <enumeration name="AudioResamplerFilterInterpolation" + version="1.10" glib:type-name="GstAudioResamplerFilterInterpolation" glib:get-type="gst_audio_resampler_filter_interpolation_get_type" c:type="GstAudioResamplerFilterInterpolation"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.h" - line="116">The different filter interpolation methods.</doc> + line="125">The different filter interpolation methods.</doc> <member name="none" value="0" c:identifier="GST_AUDIO_RESAMPLER_FILTER_INTERPOLATION_NONE" glib:nick="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.h" - line="118">no interpolation</doc> + line="127">no interpolation</doc> </member> <member name="linear" value="1" @@ -10277,7 +10305,7 @@ for @quality in @options.</doc> glib:nick="linear"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.h" - line="119">linear interpolation of the + line="128">linear interpolation of the filter coefficients.</doc> </member> <member name="cubic" @@ -10286,24 +10314,25 @@ for @quality in @options.</doc> glib:nick="cubic"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.h" - line="121">cubic interpolation of the + line="130">cubic interpolation of the filter coefficients.</doc> </member> </enumeration> <enumeration name="AudioResamplerFilterMode" + version="1.10" glib:type-name="GstAudioResamplerFilterMode" glib:get-type="gst_audio_resampler_filter_mode_get_type" c:type="GstAudioResamplerFilterMode"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.h" - line="82">Select for the filter tables should be set up.</doc> + line="89">Select for the filter tables should be set up.</doc> <member name="interpolated" value="0" c:identifier="GST_AUDIO_RESAMPLER_FILTER_MODE_INTERPOLATED" glib:nick="interpolated"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.h" - line="84">Use interpolated filter tables. This + line="91">Use interpolated filter tables. This uses less memory but more CPU and is slightly less accurate but it allows for more efficient variable rate resampling with gst_audio_resampler_update().</doc> </member> @@ -10313,7 +10342,7 @@ for @quality in @options.</doc> glib:nick="full"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.h" - line="87">Use full filter table. This uses more memory + line="94">Use full filter table. This uses more memory but less CPU.</doc> </member> <member name="auto" @@ -10322,24 +10351,25 @@ for @quality in @options.</doc> glib:nick="auto"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.h" - line="89">Automatically choose between interpolated + line="96">Automatically choose between interpolated and full filter tables.</doc> </member> </enumeration> <bitfield name="AudioResamplerFlags" + version="1.10" glib:type-name="GstAudioResamplerFlags" glib:get-type="gst_audio_resampler_flags_get_type" c:type="GstAudioResamplerFlags"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.h" - line="178">Different resampler flags.</doc> + line="189">Different resampler flags.</doc> <member name="none" value="0" c:identifier="GST_AUDIO_RESAMPLER_FLAG_NONE" glib:nick="none"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.h" - line="180">no flags</doc> + line="191">no flags</doc> </member> <member name="non_interleaved_in" value="1" @@ -10347,7 +10377,7 @@ for @quality in @options.</doc> glib:nick="non-interleaved-in"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.h" - line="181">input samples are non-interleaved. + line="192">input samples are non-interleaved. an array of blocks of samples, one for each channel, should be passed to the resample function.</doc> </member> @@ -10357,7 +10387,7 @@ for @quality in @options.</doc> glib:nick="non-interleaved-out"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.h" - line="184">output samples are non-interleaved. + line="195">output samples are non-interleaved. an array of blocks of samples, one for each channel, should be passed to the resample function.</doc> </member> @@ -10367,26 +10397,26 @@ for @quality in @options.</doc> glib:nick="variable-rate"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.h" - line="187">optimize for dynamic updates of the sample + line="198">optimize for dynamic updates of the sample rates with gst_audio_resampler_update(). This will select an interpolating filter when #GST_AUDIO_RESAMPLER_FILTER_MODE_AUTO is configured.</doc> </member> </bitfield> <enumeration name="AudioResamplerMethod" - version="1.6" + version="1.10" glib:type-name="GstAudioResamplerMethod" glib:get-type="gst_audio_resampler_method_get_type" c:type="GstAudioResamplerMethod"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.h" - line="156">Different subsampling and upsampling methods</doc> + line="167">Different subsampling and upsampling methods</doc> <member name="nearest" value="0" c:identifier="GST_AUDIO_RESAMPLER_METHOD_NEAREST" glib:nick="nearest"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.h" - line="158">Duplicates the samples when + line="169">Duplicates the samples when upsampling and drops when downsampling</doc> </member> <member name="linear" @@ -10395,7 +10425,7 @@ for @quality in @options.</doc> glib:nick="linear"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.h" - line="160">Uses linear interpolation to reconstruct + line="171">Uses linear interpolation to reconstruct missing samples and averaging to downsample</doc> </member> <member name="cubic" @@ -10404,7 +10434,7 @@ for @quality in @options.</doc> glib:nick="cubic"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.h" - line="162">Uses cubic interpolation</doc> + line="173">Uses cubic interpolation</doc> </member> <member name="blackman_nuttall" value="3" @@ -10412,7 +10442,7 @@ for @quality in @options.</doc> glib:nick="blackman-nuttall"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.h" - line="163">Uses Blackman-Nuttall windowed sinc interpolation</doc> + line="174">Uses Blackman-Nuttall windowed sinc interpolation</doc> </member> <member name="kaiser" value="4" @@ -10420,7 +10450,7 @@ for @quality in @options.</doc> glib:nick="kaiser"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.h" - line="164">Uses Kaiser windowed sinc interpolation</doc> + line="175">Uses Kaiser windowed sinc interpolation</doc> </member> </enumeration> <class name="AudioRingBuffer" @@ -15075,7 +15105,7 @@ Note: this function assumes the audio data is in interleaved layout</doc> filename="gst-libs/gst/audio/audio-resampler.c" line="1333">Make a new resampler.</doc> <source-position filename="gst-libs/gst/audio/audio-resampler.h" - line="211"/> + line="224"/> <return-value transfer-ownership="full" skip="1"> <doc xml:space="preserve" filename="gst-libs/gst/audio/audio-resampler.c" @@ -15136,7 +15166,7 @@ Note: this function assumes the audio data is in interleaved layout</doc> line="1269">Set the parameters for resampling from @in_rate to @out_rate using @method for @quality in @options.</doc> <source-position filename="gst-libs/gst/audio/audio-resampler.h" - line="205"/> + line="218"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> diff --git a/girs/GstBase-1.0.gir b/girs/GstBase-1.0.gir index 0e5b7782e1..c096c2c4ee 100644 --- a/girs/GstBase-1.0.gir +++ b/girs/GstBase-1.0.gir @@ -122,13 +122,13 @@ and/or use gtk-doc annotations. --> introspectable="0"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.h" - line="341">Convenience macro to access the source pad of #GstAggregator</doc> - <source-position filename="libs/gst/base/gstaggregator.h" line="349"/> + line="361">Convenience macro to access the source pad of #GstAggregator</doc> + <source-position filename="libs/gst/base/gstaggregator.h" line="369"/> <parameters> <parameter name="agg"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.h" - line="343">a #GstAggregator</doc> + line="363">a #GstAggregator</doc> </parameter> </parameters> </function-macro> @@ -406,13 +406,28 @@ the value of the @size argument an empty #GBytes structure may be returned.</doc </parameters> </method> <method name="distance_from_discont" - c:identifier="gst_adapter_distance_from_discont"> + c:identifier="gst_adapter_distance_from_discont" + version="1.10"> + <doc xml:space="preserve" + filename="libs/gst/base/gstadapter.c" + line="1367">Get the distance in bytes since the last buffer with the +%GST_BUFFER_FLAG_DISCONT flag. + +The distance will be reset to 0 for all buffers with +%GST_BUFFER_FLAG_DISCONT on them, and then calculated for all other +following buffers based on their size.</doc> <source-position filename="libs/gst/base/gstadapter.h" line="136"/> <return-value transfer-ownership="none"> + <doc xml:space="preserve" + filename="libs/gst/base/gstadapter.c" + line="1380">The offset. Can be %GST_BUFFER_OFFSET_NONE.</doc> <type name="guint64" c:type="guint64"/> </return-value> <parameters> <instance-parameter name="adapter" transfer-ownership="none"> + <doc xml:space="preserve" + filename="libs/gst/base/gstadapter.c" + line="1369">a #GstAdapter</doc> <type name="Adapter" c:type="GstAdapter*"/> </instance-parameter> </parameters> @@ -1334,16 +1349,35 @@ Control is given to the subclass when all pads have data. * When data is queued on all pads, the aggregate vmethod is called. * One can peek at the data on any given GstAggregatorPad with the - gst_aggregator_pad_peek_buffer () method, and remove it from the pad + gst_aggregator_pad_peek_buffer() method, and remove it from the pad with the gst_aggregator_pad_pop_buffer () method. When a buffer has been taken with pop_buffer (), a new buffer can be queued on that pad. + * When gst_aggregator_pad_peek_buffer() or gst_aggregator_pad_has_buffer() + are called, a reference is taken to the returned buffer, which stays + valid until either: + + - gst_aggregator_pad_pop_buffer() is called, in which case the caller + is guaranteed that the buffer they receive is the same as the peeked + buffer. + - gst_aggregator_pad_drop_buffer() is called, in which case the caller + is guaranteed that the dropped buffer is the one that was peeked. + - the subclass implementation of #GstAggregatorClass.aggregate returns. + + Subsequent calls to gst_aggregator_pad_peek_buffer() or + gst_aggregator_pad_has_buffer() return / check the same buffer that was + returned / checked, until one of the conditions listed above is met. + + Subclasses are only allowed to call these methods from the aggregate + thread. + * If the subclass wishes to push a buffer downstream in its aggregate implementation, it should do so through the - gst_aggregator_finish_buffer () method. This method will take care + gst_aggregator_finish_buffer() method. This method will take care of sending and ordering mandatory events such as stream start, caps - and segment. + and segment. Buffer lists can also be pushed out with + gst_aggregator_finish_buffer_list(). * Same goes for EOS events, which should not be pushed directly by the subclass, it should instead return GST_FLOW_EOS in its aggregate @@ -1359,7 +1393,7 @@ Control is given to the subclass when all pads have data. See gst_element_class_add_static_pad_template_with_gtype(). This class used to live in gst-plugins-bad and was moved to core.</doc> - <source-position filename="libs/gst/base/gstaggregator.h" line="335"/> + <source-position filename="libs/gst/base/gstaggregator.h" line="355"/> <virtual-method name="aggregate"> <source-position filename="libs/gst/base/gstaggregator.h" line="291"/> <return-value transfer-ownership="none"> @@ -1428,7 +1462,7 @@ This class used to live in gst-plugins-bad and was moved to core.</doc> <virtual-method name="finish_buffer" invoker="finish_buffer"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="620">This method will push the provided output buffer downstream. If needed, + line="677">This method will push the provided output buffer downstream. If needed, mandatory events such as stream-start, caps, and segment events will be sent before pushing the buffer.</doc> <source-position filename="libs/gst/base/gstaggregator.h" line="268"/> @@ -1439,17 +1473,44 @@ sent before pushing the buffer.</doc> <instance-parameter name="aggregator" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="622">The #GstAggregator</doc> + line="679">The #GstAggregator</doc> <type name="Aggregator" c:type="GstAggregator*"/> </instance-parameter> <parameter name="buffer" transfer-ownership="full"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="623">the #GstBuffer to push.</doc> + line="680">the #GstBuffer to push.</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </parameter> </parameters> </virtual-method> + <virtual-method name="finish_buffer_list" + invoker="finish_buffer_list" + version="1.18"> + <doc xml:space="preserve" + filename="libs/gst/base/gstaggregator.c" + line="716">This method will push the provided output buffer list downstream. If needed, +mandatory events such as stream-start, caps, and segment events will be +sent before pushing the buffer.</doc> + <source-position filename="libs/gst/base/gstaggregator.h" line="341"/> + <return-value transfer-ownership="none"> + <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> + </return-value> + <parameters> + <instance-parameter name="aggregator" transfer-ownership="none"> + <doc xml:space="preserve" + filename="libs/gst/base/gstaggregator.c" + line="718">The #GstAggregator</doc> + <type name="Aggregator" c:type="GstAggregator*"/> + </instance-parameter> + <parameter name="bufferlist" transfer-ownership="full"> + <doc xml:space="preserve" + filename="libs/gst/base/gstaggregator.c" + line="719">the #GstBufferList to push.</doc> + <type name="Gst.BufferList" c:type="GstBufferList*"/> + </parameter> + </parameters> + </virtual-method> <virtual-method name="fixate_src_caps"> <source-position filename="libs/gst/base/gstaggregator.h" line="312"/> <return-value transfer-ownership="full"> @@ -1489,21 +1550,21 @@ sent before pushing the buffer.</doc> <virtual-method name="negotiate" invoker="negotiate" version="1.18"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="1165">Negotiates src pad caps with downstream elements. + line="1281">Negotiates src pad caps with downstream elements. Unmarks GST_PAD_FLAG_NEED_RECONFIGURE in any case. But marks it again if #GstAggregatorClass.negotiate() fails.</doc> <source-position filename="libs/gst/base/gstaggregator.h" line="323"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="1173">%TRUE if the negotiation succeeded, else %FALSE.</doc> + line="1289">%TRUE if the negotiation succeeded, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="self" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="1167">a #GstAggregator</doc> + line="1283">a #GstAggregator</doc> <type name="Aggregator" c:type="GstAggregator*"/> </instance-parameter> </parameters> @@ -1522,6 +1583,34 @@ if #GstAggregatorClass.negotiate() fails.</doc> </parameter> </parameters> </virtual-method> + <virtual-method name="peek_next_sample" + invoker="peek_next_sample" + version="1.18"> + <doc xml:space="preserve" + filename="libs/gst/base/gstaggregator.c" + line="319">Use this function to determine what input buffers will be aggregated +to produce the next output buffer. This should only be called from +a #GstAggregator::samples-selected handler, and can be used to precisely +control aggregating parameters for a given set of input samples.</doc> + <source-position filename="libs/gst/base/gstaggregator.h" line="350"/> + <return-value transfer-ownership="full"> + <doc xml:space="preserve" + filename="libs/gst/base/gstaggregator.c" + line="327">The sample that is about to be aggregated. It may hold a #GstBuffer + or a #GstBufferList. The contents of its info structure is subclass-dependent, + and documented on a subclass basis. The buffers held by the sample are + not writable.</doc> + <type name="Gst.Sample" c:type="GstSample*"/> + </return-value> + <parameters> + <instance-parameter name="aggregator" transfer-ownership="none"> + <type name="Aggregator" c:type="GstAggregator*"/> + </instance-parameter> + <parameter name="aggregator_pad" transfer-ownership="none"> + <type name="AggregatorPad" c:type="GstAggregatorPad*"/> + </parameter> + </parameters> + </virtual-method> <virtual-method name="propose_allocation"> <source-position filename="libs/gst/base/gstaggregator.h" line="318"/> <return-value transfer-ownership="none"> @@ -1702,10 +1791,10 @@ if #GstAggregatorClass.negotiate() fails.</doc> <method name="finish_buffer" c:identifier="gst_aggregator_finish_buffer"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="620">This method will push the provided output buffer downstream. If needed, + line="677">This method will push the provided output buffer downstream. If needed, mandatory events such as stream-start, caps, and segment events will be sent before pushing the buffer.</doc> - <source-position filename="libs/gst/base/gstaggregator.h" line="356"/> + <source-position filename="libs/gst/base/gstaggregator.h" line="376"/> <return-value transfer-ownership="none"> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> @@ -1713,25 +1802,52 @@ sent before pushing the buffer.</doc> <instance-parameter name="aggregator" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="622">The #GstAggregator</doc> + line="679">The #GstAggregator</doc> <type name="Aggregator" c:type="GstAggregator*"/> </instance-parameter> <parameter name="buffer" transfer-ownership="full"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="623">the #GstBuffer to push.</doc> + line="680">the #GstBuffer to push.</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </parameter> </parameters> </method> + <method name="finish_buffer_list" + c:identifier="gst_aggregator_finish_buffer_list" + version="1.18"> + <doc xml:space="preserve" + filename="libs/gst/base/gstaggregator.c" + line="716">This method will push the provided output buffer list downstream. If needed, +mandatory events such as stream-start, caps, and segment events will be +sent before pushing the buffer.</doc> + <source-position filename="libs/gst/base/gstaggregator.h" line="380"/> + <return-value transfer-ownership="none"> + <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> + </return-value> + <parameters> + <instance-parameter name="aggregator" transfer-ownership="none"> + <doc xml:space="preserve" + filename="libs/gst/base/gstaggregator.c" + line="718">The #GstAggregator</doc> + <type name="Aggregator" c:type="GstAggregator*"/> + </instance-parameter> + <parameter name="bufferlist" transfer-ownership="full"> + <doc xml:space="preserve" + filename="libs/gst/base/gstaggregator.c" + line="719">the #GstBufferList to push.</doc> + <type name="Gst.BufferList" c:type="GstBufferList*"/> + </parameter> + </parameters> + </method> <method name="get_allocator" c:identifier="gst_aggregator_get_allocator"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="3398">Lets #GstAggregator sub-classes get the memory @allocator + line="3619">Lets #GstAggregator sub-classes get the memory @allocator acquired by the base class and its @params. Unref the @allocator after use it.</doc> - <source-position filename="libs/gst/base/gstaggregator.h" line="381"/> + <source-position filename="libs/gst/base/gstaggregator.h" line="405"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -1739,7 +1855,7 @@ Unref the @allocator after use it.</doc> <instance-parameter name="self" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="3400">a #GstAggregator</doc> + line="3621">a #GstAggregator</doc> <type name="Aggregator" c:type="GstAggregator*"/> </instance-parameter> <parameter name="allocator" @@ -1750,7 +1866,7 @@ Unref the @allocator after use it.</doc> allow-none="1"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="3401">the #GstAllocator + line="3622">the #GstAllocator used</doc> <type name="Gst.Allocator" c:type="GstAllocator**"/> </parameter> @@ -1762,7 +1878,7 @@ used</doc> allow-none="1"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="3403">the + line="3624">the #GstAllocationParams of @allocator</doc> <type name="Gst.AllocationParams" c:type="GstAllocationParams*"/> </parameter> @@ -1770,11 +1886,11 @@ used</doc> </method> <method name="get_buffer_pool" c:identifier="gst_aggregator_get_buffer_pool"> - <source-position filename="libs/gst/base/gstaggregator.h" line="378"/> + <source-position filename="libs/gst/base/gstaggregator.h" line="402"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="3379">the instance of the #GstBufferPool used + line="3600">the instance of the #GstBufferPool used by @trans; free it after use it</doc> <type name="Gst.BufferPool" c:type="GstBufferPool*"/> </return-value> @@ -1782,7 +1898,7 @@ by @trans; free it after use it</doc> <instance-parameter name="self" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="3377">a #GstAggregator</doc> + line="3598">a #GstAggregator</doc> <type name="Aggregator" c:type="GstAggregator*"/> </instance-parameter> </parameters> @@ -1790,23 +1906,23 @@ by @trans; free it after use it</doc> <method name="get_latency" c:identifier="gst_aggregator_get_latency"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="1994">Retrieves the latency values reported by @self in response to the latency + line="2137">Retrieves the latency values reported by @self in response to the latency query, or %GST_CLOCK_TIME_NONE if there is not live source connected and the element will not wait for the clock. Typically only called by subclasses.</doc> - <source-position filename="libs/gst/base/gstaggregator.h" line="375"/> + <source-position filename="libs/gst/base/gstaggregator.h" line="399"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="2004">The latency or %GST_CLOCK_TIME_NONE if the element does not sync</doc> + line="2147">The latency or %GST_CLOCK_TIME_NONE if the element does not sync</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </return-value> <parameters> <instance-parameter name="self" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="1996">a #GstAggregator</doc> + line="2139">a #GstAggregator</doc> <type name="Aggregator" c:type="GstAggregator*"/> </instance-parameter> </parameters> @@ -1816,32 +1932,113 @@ Typically only called by subclasses.</doc> version="1.18"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="1165">Negotiates src pad caps with downstream elements. + line="1281">Negotiates src pad caps with downstream elements. Unmarks GST_PAD_FLAG_NEED_RECONFIGURE in any case. But marks it again if #GstAggregatorClass.negotiate() fails.</doc> - <source-position filename="libs/gst/base/gstaggregator.h" line="364"/> + <source-position filename="libs/gst/base/gstaggregator.h" line="388"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="1173">%TRUE if the negotiation succeeded, else %FALSE.</doc> + line="1289">%TRUE if the negotiation succeeded, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="self" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="1167">a #GstAggregator</doc> + line="1283">a #GstAggregator</doc> <type name="Aggregator" c:type="GstAggregator*"/> </instance-parameter> </parameters> </method> + <method name="peek_next_sample" + c:identifier="gst_aggregator_peek_next_sample" + version="1.18"> + <doc xml:space="preserve" + filename="libs/gst/base/gstaggregator.c" + line="319">Use this function to determine what input buffers will be aggregated +to produce the next output buffer. This should only be called from +a #GstAggregator::samples-selected handler, and can be used to precisely +control aggregating parameters for a given set of input samples.</doc> + <source-position filename="libs/gst/base/gstaggregator.h" line="417"/> + <return-value transfer-ownership="full"> + <doc xml:space="preserve" + filename="libs/gst/base/gstaggregator.c" + line="327">The sample that is about to be aggregated. It may hold a #GstBuffer + or a #GstBufferList. The contents of its info structure is subclass-dependent, + and documented on a subclass basis. The buffers held by the sample are + not writable.</doc> + <type name="Gst.Sample" c:type="GstSample*"/> + </return-value> + <parameters> + <instance-parameter name="self" transfer-ownership="none"> + <type name="Aggregator" c:type="GstAggregator*"/> + </instance-parameter> + <parameter name="pad" transfer-ownership="none"> + <type name="AggregatorPad" c:type="GstAggregatorPad*"/> + </parameter> + </parameters> + </method> + <method name="selected_samples" + c:identifier="gst_aggregator_selected_samples" + version="1.18"> + <doc xml:space="preserve" + filename="libs/gst/base/gstaggregator.c" + line="3713">Subclasses should call this when they have prepared the +buffers they will aggregate for each of their sink pads, but +before using any of the properties of the pads that govern +*how* aggregation should be performed, for example z-index +for video aggregators. + +If gst_aggregator_update_segment() is used by the subclass, +it MUST be called before gst_aggregator_selected_samples(). + +This function MUST only be called from the #GstAggregatorClass::aggregate() +function.</doc> + <source-position filename="libs/gst/base/gstaggregator.h" line="421"/> + <return-value transfer-ownership="none"> + <type name="none" c:type="void"/> + </return-value> + <parameters> + <instance-parameter name="self" transfer-ownership="none"> + <type name="Aggregator" c:type="GstAggregator*"/> + </instance-parameter> + <parameter name="pts" transfer-ownership="none"> + <doc xml:space="preserve" + filename="libs/gst/base/gstaggregator.c" + line="3715">The presentation timestamp of the next output buffer</doc> + <type name="Gst.ClockTime" c:type="GstClockTime"/> + </parameter> + <parameter name="dts" transfer-ownership="none"> + <doc xml:space="preserve" + filename="libs/gst/base/gstaggregator.c" + line="3716">The decoding timestamp of the next output buffer</doc> + <type name="Gst.ClockTime" c:type="GstClockTime"/> + </parameter> + <parameter name="duration" transfer-ownership="none"> + <doc xml:space="preserve" + filename="libs/gst/base/gstaggregator.c" + line="3717">The duration of the next output buffer</doc> + <type name="Gst.ClockTime" c:type="GstClockTime"/> + </parameter> + <parameter name="info" + transfer-ownership="none" + nullable="1" + allow-none="1"> + <doc xml:space="preserve" + filename="libs/gst/base/gstaggregator.c" + line="3718">a #GstStructure containing additional information</doc> + <type name="Gst.Structure" c:type="GstStructure*"/> + </parameter> + </parameters> + </method> <method name="set_latency" c:identifier="gst_aggregator_set_latency"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="3335">Lets #GstAggregator sub-classes tell the baseclass what their internal + line="3556">Lets #GstAggregator sub-classes tell the baseclass what their internal latency is. Will also post a LATENCY message on the bus so the pipeline can reconfigure its global latency.</doc> - <source-position filename="libs/gst/base/gstaggregator.h" line="367"/> + <source-position filename="libs/gst/base/gstaggregator.h" line="391"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -1849,19 +2046,19 @@ can reconfigure its global latency.</doc> <instance-parameter name="self" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="3337">a #GstAggregator</doc> + line="3558">a #GstAggregator</doc> <type name="Aggregator" c:type="GstAggregator*"/> </instance-parameter> <parameter name="min_latency" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="3338">minimum latency</doc> + line="3559">minimum latency</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </parameter> <parameter name="max_latency" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="3339">maximum latency</doc> + line="3560">maximum latency</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </parameter> </parameters> @@ -1869,8 +2066,8 @@ can reconfigure its global latency.</doc> <method name="set_src_caps" c:identifier="gst_aggregator_set_src_caps"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="585">Sets the caps to be used on the src pad.</doc> - <source-position filename="libs/gst/base/gstaggregator.h" line="360"/> + line="642">Sets the caps to be used on the src pad.</doc> + <source-position filename="libs/gst/base/gstaggregator.h" line="384"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -1878,13 +2075,13 @@ can reconfigure its global latency.</doc> <instance-parameter name="self" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="587">The #GstAggregator</doc> + line="644">The #GstAggregator</doc> <type name="Aggregator" c:type="GstAggregator*"/> </instance-parameter> <parameter name="caps" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="588">The #GstCaps to set on the src pad.</doc> + line="645">The #GstCaps to set on the src pad.</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> </parameters> @@ -1894,24 +2091,24 @@ can reconfigure its global latency.</doc> version="1.16"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="3425">This is a simple #GstAggregatorClass.get_next_time() implementation that + line="3646">This is a simple #GstAggregatorClass.get_next_time() implementation that just looks at the #GstSegment on the srcpad of the aggregator and bases the next time on the running time there. This is the desired behaviour in most cases where you have a live source and you have a dead line based aggregator subclass.</doc> - <source-position filename="libs/gst/base/gstaggregator.h" line="386"/> + <source-position filename="libs/gst/base/gstaggregator.h" line="410"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="3436">The running time based on the position</doc> + line="3657">The running time based on the position</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </return-value> <parameters> <instance-parameter name="self" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="3427">A #GstAggregator</doc> + line="3648">A #GstAggregator</doc> <type name="Aggregator" c:type="GstAggregator*"/> </instance-parameter> </parameters> @@ -1921,10 +2118,13 @@ and you have a dead line based aggregator subclass.</doc> version="1.18"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="3462">Subclasses should use this to update the segment on their + line="3683">Subclasses should use this to update the segment on their source pad, instead of directly pushing new segment events -downstream.</doc> - <source-position filename="libs/gst/base/gstaggregator.h" line="389"/> +downstream. + +Subclasses MUST call this before gst_aggregator_selected_samples(), +if it is used at all.</doc> + <source-position filename="libs/gst/base/gstaggregator.h" line="413"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -1937,6 +2137,15 @@ downstream.</doc> </parameter> </parameters> </method> + <property name="emit-signals" + version="1.18" + writable="1" + transfer-ownership="none"> + <doc xml:space="preserve" + filename="libs/gst/base/gstaggregator.c" + line="2780">Enables the emission of signals such as #GstAggregator::samples-selected</doc> + <type name="gboolean" c:type="gboolean"/> + </property> <property name="latency" writable="1" transfer-ownership="none"> <type name="guint64" c:type="guint64"/> </property> @@ -1946,7 +2155,7 @@ downstream.</doc> transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="2596">Force minimum upstream latency (in nanoseconds). When sources with a + line="2746">Force minimum upstream latency (in nanoseconds). When sources with a higher latency are expected to be plugged in dynamically after the aggregator has started playing, this allows overriding the minimum latency reported by the initial source(s). This is only taken into @@ -1978,6 +2187,51 @@ account when larger than the actually reported minimum latency.</doc> <type name="gpointer" c:type="gpointer"/> </array> </field> + <glib:signal name="samples-selected" when="first" version="1.18"> + <doc xml:space="preserve" + filename="libs/gst/base/gstaggregator.c" + line="2792">Signals that the #GstAggregator subclass has selected the next set +of input samples it will aggregate. Handlers may call +gst_aggregator_peek_next_sample() at that point.</doc> + <return-value transfer-ownership="none"> + <type name="none" c:type="void"/> + </return-value> + <parameters> + <parameter name="segment" transfer-ownership="none"> + <doc xml:space="preserve" + filename="libs/gst/base/gstaggregator.c" + line="2795">The #GstSegment the next output buffer is part of</doc> + <type name="Gst.Segment"/> + </parameter> + <parameter name="pts" transfer-ownership="none"> + <doc xml:space="preserve" + filename="libs/gst/base/gstaggregator.c" + line="2796">The presentation timestamp of the next output buffer</doc> + <type name="guint64" c:type="guint64"/> + </parameter> + <parameter name="dts" transfer-ownership="none"> + <doc xml:space="preserve" + filename="libs/gst/base/gstaggregator.c" + line="2797">The decoding timestamp of the next output buffer</doc> + <type name="guint64" c:type="guint64"/> + </parameter> + <parameter name="duration" transfer-ownership="none"> + <doc xml:space="preserve" + filename="libs/gst/base/gstaggregator.c" + line="2798">The duration of the next output buffer</doc> + <type name="guint64" c:type="guint64"/> + </parameter> + <parameter name="info" + transfer-ownership="none" + nullable="1" + allow-none="1"> + <doc xml:space="preserve" + filename="libs/gst/base/gstaggregator.c" + line="2799">a #GstStructure containing additional information</doc> + <type name="Gst.Structure"/> + </parameter> + </parameters> + </glib:signal> </class> <record name="AggregatorClass" c:type="GstAggregatorClass" @@ -1994,7 +2248,7 @@ It will also take care of event ordering (stream-start, segment, eos). Basically, a simple implementation will override @aggregate, and call _finish_buffer from inside that function.</doc> - <source-position filename="libs/gst/base/gstaggregator.h" line="335"/> + <source-position filename="libs/gst/base/gstaggregator.h" line="355"/> <field name="parent_class"> <type name="Gst.ElementClass" c:type="GstElementClass"/> </field> @@ -2043,13 +2297,13 @@ _finish_buffer from inside that function.</doc> <parameter name="aggregator" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="622">The #GstAggregator</doc> + line="679">The #GstAggregator</doc> <type name="Aggregator" c:type="GstAggregator*"/> </parameter> <parameter name="buffer" transfer-ownership="full"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="623">the #GstBuffer to push.</doc> + line="680">the #GstBuffer to push.</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </parameter> </parameters> @@ -2337,14 +2591,14 @@ _finish_buffer from inside that function.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="1173">%TRUE if the negotiation succeeded, else %FALSE.</doc> + line="1289">%TRUE if the negotiation succeeded, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <parameter name="self" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="1167">a #GstAggregator</doc> + line="1283">a #GstAggregator</doc> <type name="Aggregator" c:type="GstAggregator*"/> </parameter> </parameters> @@ -2390,8 +2644,54 @@ _finish_buffer from inside that function.</doc> </parameters> </callback> </field> + <field name="finish_buffer_list"> + <callback name="finish_buffer_list"> + <source-position filename="libs/gst/base/gstaggregator.h" + line="341"/> + <return-value transfer-ownership="none"> + <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> + </return-value> + <parameters> + <parameter name="aggregator" transfer-ownership="none"> + <doc xml:space="preserve" + filename="libs/gst/base/gstaggregator.c" + line="718">The #GstAggregator</doc> + <type name="Aggregator" c:type="GstAggregator*"/> + </parameter> + <parameter name="bufferlist" transfer-ownership="full"> + <doc xml:space="preserve" + filename="libs/gst/base/gstaggregator.c" + line="719">the #GstBufferList to push.</doc> + <type name="Gst.BufferList" c:type="GstBufferList*"/> + </parameter> + </parameters> + </callback> + </field> + <field name="peek_next_sample"> + <callback name="peek_next_sample"> + <source-position filename="libs/gst/base/gstaggregator.h" + line="350"/> + <return-value transfer-ownership="full"> + <doc xml:space="preserve" + filename="libs/gst/base/gstaggregator.c" + line="327">The sample that is about to be aggregated. It may hold a #GstBuffer + or a #GstBufferList. The contents of its info structure is subclass-dependent, + and documented on a subclass basis. The buffers held by the sample are + not writable.</doc> + <type name="Gst.Sample" c:type="GstSample*"/> + </return-value> + <parameters> + <parameter name="aggregator" transfer-ownership="none"> + <type name="Aggregator" c:type="GstAggregator*"/> + </parameter> + <parameter name="aggregator_pad" transfer-ownership="none"> + <type name="AggregatorPad" c:type="GstAggregatorPad*"/> + </parameter> + </parameters> + </callback> + </field> <field name="_gst_reserved" readable="0" private="1"> - <array zero-terminated="0" fixed-size="17"> + <array zero-terminated="0" fixed-size="15"> <type name="gpointer" c:type="gpointer"/> </array> </field> @@ -2406,7 +2706,7 @@ _finish_buffer from inside that function.</doc> glib:type-struct="AggregatorPadClass"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="73">Pads managed by a #GstAggregator subclass. + line="92">Pads managed by a #GstAggregator subclass. This class used to live in gst-plugins-bad and was moved to core.</doc> <source-position filename="libs/gst/base/gstaggregator.h" line="100"/> @@ -2444,19 +2744,19 @@ This class used to live in gst-plugins-bad and was moved to core.</doc> <method name="drop_buffer" c:identifier="gst_aggregator_pad_drop_buffer"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="3201">Drop the buffer currently queued in @pad.</doc> + line="3410">Drop the buffer currently queued in @pad.</doc> <source-position filename="libs/gst/base/gstaggregator.h" line="116"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="3207">TRUE if there was a buffer queued in @pad, or FALSE if not.</doc> + line="3416">TRUE if there was a buffer queued in @pad, or FALSE if not.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="pad" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="3203">the pad where to drop any pending buffer</doc> + line="3412">the pad where to drop any pending buffer</doc> <type name="AggregatorPad" c:type="GstAggregatorPad*"/> </instance-parameter> </parameters> @@ -2466,21 +2766,21 @@ This class used to live in gst-plugins-bad and was moved to core.</doc> version="1.14.1"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="3255">This checks if a pad has a buffer available that will be returned by + line="3469">This checks if a pad has a buffer available that will be returned by a call to gst_aggregator_pad_peek_buffer() or gst_aggregator_pad_pop_buffer().</doc> <source-position filename="libs/gst/base/gstaggregator.h" line="119"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="3263">%TRUE if the pad has a buffer available as the next thing.</doc> + line="3477">%TRUE if the pad has a buffer available as the next thing.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="pad" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="3257">the pad to check the buffer on</doc> + line="3471">the pad to check the buffer on</doc> <type name="AggregatorPad" c:type="GstAggregatorPad*"/> </instance-parameter> </parameters> @@ -2490,14 +2790,14 @@ gst_aggregator_pad_pop_buffer().</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="3284">%TRUE if the pad is EOS, otherwise %FALSE.</doc> + line="3505">%TRUE if the pad is EOS, otherwise %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="pad" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="3282">an aggregator pad</doc> + line="3503">an aggregator pad</doc> <type name="AggregatorPad" c:type="GstAggregatorPad*"/> </instance-parameter> </parameters> @@ -2507,7 +2807,7 @@ gst_aggregator_pad_pop_buffer().</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="3227">A reference to the buffer in @pad or + line="3436">A reference to the buffer in @pad or NULL if no buffer was queued. You should unref the buffer after usage.</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> @@ -2516,7 +2816,7 @@ usage.</doc> <instance-parameter name="pad" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="3225">the pad to get buffer from</doc> + line="3434">the pad to get buffer from</doc> <type name="AggregatorPad" c:type="GstAggregatorPad*"/> </instance-parameter> </parameters> @@ -2524,12 +2824,12 @@ usage.</doc> <method name="pop_buffer" c:identifier="gst_aggregator_pad_pop_buffer"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="3165">Steal the ref to the buffer currently queued in @pad.</doc> + line="3352">Steal the ref to the buffer currently queued in @pad.</doc> <source-position filename="libs/gst/base/gstaggregator.h" line="110"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="3171">The buffer in @pad or NULL if no buffer was + line="3358">The buffer in @pad or NULL if no buffer was queued. You should unref the buffer after usage.</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </return-value> @@ -2537,7 +2837,7 @@ usage.</doc> <instance-parameter name="pad" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="3167">the pad to get buffer from</doc> + line="3354">the pad to get buffer from</doc> <type name="AggregatorPad" c:type="GstAggregatorPad*"/> </instance-parameter> </parameters> @@ -2548,7 +2848,7 @@ usage.</doc> transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.c" - line="3078">Enables the emission of signals such as #GstAggregatorPad::buffer-consumed</doc> + line="3263">Enables the emission of signals such as #GstAggregatorPad::buffer-consumed</doc> <type name="gboolean" c:type="gboolean"/> </property> <field name="parent"> @@ -2639,7 +2939,7 @@ usage.</doc> <source-position filename="libs/gst/base/gstaggregator.h" line="34"/> </record> <enumeration name="AggregatorStartTimeSelection" - version="1.14" + version="1.18" glib:type-name="GstAggregatorStartTimeSelection" glib:get-type="gst_aggregator_start_time_selection_get_type" c:type="GstAggregatorStartTimeSelection"> @@ -2649,7 +2949,7 @@ usage.</doc> glib:nick="zero"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.h" - line="394">Start at running time 0.</doc> + line="429">Start at running time 0.</doc> </member> <member name="first" value="1" @@ -2657,7 +2957,7 @@ usage.</doc> glib:nick="first"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.h" - line="395">Start at the running time of + line="430">Start at the running time of the first buffer that is received.</doc> </member> <member name="set" @@ -2666,7 +2966,7 @@ the first buffer that is received.</doc> glib:nick="set"> <doc xml:space="preserve" filename="libs/gst/base/gstaggregator.h" - line="397">Start at the running time + line="432">Start at the running time selected by the `start-time` property.</doc> </member> </enumeration> @@ -3490,7 +3790,7 @@ Things that subclass need to take care of: c:identifier="gst_base_parse_add_index_entry"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="1971">Adds an entry to the index associating @offset to @ts. It is recommended + line="1972">Adds an entry to the index associating @offset to @ts. It is recommended to only add keyframe entries. @force allows to bypass checks, such as whether the stream is (upstream) seekable, another entry is already "close" to the new entry, etc.</doc> @@ -3498,38 +3798,38 @@ to the new entry, etc.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="1984">#gboolean indicating whether entry was added</doc> + line="1985">#gboolean indicating whether entry was added</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="parse" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="1973">#GstBaseParse.</doc> + line="1974">#GstBaseParse.</doc> <type name="BaseParse" c:type="GstBaseParse*"/> </instance-parameter> <parameter name="offset" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="1974">offset of entry</doc> + line="1975">offset of entry</doc> <type name="guint64" c:type="guint64"/> </parameter> <parameter name="ts" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="1975">timestamp associated with offset</doc> + line="1976">timestamp associated with offset</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </parameter> <parameter name="key" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="1976">whether entry refers to keyframe</doc> + line="1977">whether entry refers to keyframe</doc> <type name="gboolean" c:type="gboolean"/> </parameter> <parameter name="force" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="1977">add entry disregarding sanity checks</doc> + line="1978">add entry disregarding sanity checks</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -3538,37 +3838,37 @@ to the new entry, etc.</doc> c:identifier="gst_base_parse_convert_default"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="1733">Default implementation of #GstBaseParseClass.convert().</doc> + line="1734">Default implementation of #GstBaseParseClass.convert().</doc> <source-position filename="libs/gst/base/gstbaseparse.h" line="345"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="1743">%TRUE if conversion was successful.</doc> + line="1744">%TRUE if conversion was successful.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="parse" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="1735">#GstBaseParse.</doc> + line="1736">#GstBaseParse.</doc> <type name="BaseParse" c:type="GstBaseParse*"/> </instance-parameter> <parameter name="src_format" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="1736">#GstFormat describing the source format.</doc> + line="1737">#GstFormat describing the source format.</doc> <type name="Gst.Format" c:type="GstFormat"/> </parameter> <parameter name="src_value" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="1737">Source value to be converted.</doc> + line="1738">Source value to be converted.</doc> <type name="gint64" c:type="gint64"/> </parameter> <parameter name="dest_format" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="1738">#GstFormat defining the converted format.</doc> + line="1739">#GstFormat defining the converted format.</doc> <type name="Gst.Format" c:type="GstFormat"/> </parameter> <parameter name="dest_value" @@ -3577,7 +3877,7 @@ to the new entry, etc.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="1739">Pointer where the conversion result will be put.</doc> + line="1740">Pointer where the conversion result will be put.</doc> <type name="gint64" c:type="gint64*"/> </parameter> </parameters> @@ -3585,7 +3885,7 @@ to the new entry, etc.</doc> <method name="drain" c:identifier="gst_base_parse_drain" version="1.12"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="2789">Drains the adapter until it is empty. It decreases the min_frame_size to + line="2753">Drains the adapter until it is empty. It decreases the min_frame_size to match the current adapter size and calls chain method until the adapter is emptied or chain returns with error.</doc> <source-position filename="libs/gst/base/gstbaseparse.h" line="320"/> @@ -3596,7 +3896,7 @@ is emptied or chain returns with error.</doc> <instance-parameter name="parse" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="2791">a #GstBaseParse</doc> + line="2755">a #GstBaseParse</doc> <type name="BaseParse" c:type="GstBaseParse*"/> </instance-parameter> </parameters> @@ -3604,7 +3904,7 @@ is emptied or chain returns with error.</doc> <method name="finish_frame" c:identifier="gst_base_parse_finish_frame"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="2693">Collects parsed data and pushes this downstream. + line="2657">Collects parsed data and pushes this downstream. Source pad caps must be set when this is called. If @frame's out_buffer is set, that will be used as subsequent frame data. @@ -3619,26 +3919,26 @@ caller retains ownership of @frame.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="2711">a #GstFlowReturn that should be escalated to caller (of caller)</doc> + line="2675">a #GstFlowReturn that should be escalated to caller (of caller)</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> <parameters> <instance-parameter name="parse" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="2695">a #GstBaseParse</doc> + line="2659">a #GstBaseParse</doc> <type name="BaseParse" c:type="GstBaseParse*"/> </instance-parameter> <parameter name="frame" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="2696">a #GstBaseParseFrame</doc> + line="2660">a #GstBaseParseFrame</doc> <type name="BaseParseFrame" c:type="GstBaseParseFrame*"/> </parameter> <parameter name="size" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="2697">consumed input data represented by frame</doc> + line="2661">consumed input data represented by frame</doc> <type name="gint" c:type="gint"/> </parameter> </parameters> @@ -3648,7 +3948,7 @@ caller retains ownership of @frame.</doc> version="1.6"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="5019">Sets the parser subclass's tags and how they should be merged with any + line="4989">Sets the parser subclass's tags and how they should be merged with any upstream stream tags. This will override any tags previously-set with gst_base_parse_merge_tags(). @@ -3662,7 +3962,7 @@ not required to use this and can still do tag handling on its own.</doc> <instance-parameter name="parse" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="5021">a #GstBaseParse</doc> + line="4991">a #GstBaseParse</doc> <type name="BaseParse" c:type="GstBaseParse*"/> </instance-parameter> <parameter name="tags" @@ -3671,14 +3971,14 @@ not required to use this and can still do tag handling on its own.</doc> allow-none="1"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="5022">a #GstTagList to merge, or NULL to unset + line="4992">a #GstTagList to merge, or NULL to unset previously-set tags</doc> <type name="Gst.TagList" c:type="GstTagList*"/> </parameter> <parameter name="mode" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="5024">the #GstTagMergeMode to use, usually #GST_TAG_MERGE_REPLACE</doc> + line="4994">the #GstTagMergeMode to use, usually #GST_TAG_MERGE_REPLACE</doc> <type name="Gst.TagMergeMode" c:type="GstTagMergeMode"/> </parameter> </parameters> @@ -3686,7 +3986,7 @@ not required to use this and can still do tag handling on its own.</doc> <method name="push_frame" c:identifier="gst_base_parse_push_frame"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="2442">Pushes the frame's buffer downstream, sends any pending events and + line="2443">Pushes the frame's buffer downstream, sends any pending events and does some timestamp and segment handling. Takes ownership of frame's buffer, though caller retains ownership of @frame. @@ -3695,20 +3995,20 @@ This must be called with sinkpad STREAM_LOCK held.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="2453">#GstFlowReturn</doc> + line="2454">#GstFlowReturn</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> <parameters> <instance-parameter name="parse" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="2444">#GstBaseParse.</doc> + line="2445">#GstBaseParse.</doc> <type name="BaseParse" c:type="GstBaseParse*"/> </instance-parameter> <parameter name="frame" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="2445">a #GstBaseParseFrame</doc> + line="2446">a #GstBaseParseFrame</doc> <type name="BaseParseFrame" c:type="GstBaseParseFrame*"/> </parameter> </parameters> @@ -3717,7 +4017,7 @@ This must be called with sinkpad STREAM_LOCK held.</doc> c:identifier="gst_base_parse_set_average_bitrate"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="3910">Optionally sets the average bitrate detected in media (if non-zero), + line="3879">Optionally sets the average bitrate detected in media (if non-zero), e.g. based on metadata, as it will be posted to the application. By default, announced average bitrate is estimated. The average bitrate @@ -3732,13 +4032,13 @@ a seek position, if there's no index and the format is syncable <instance-parameter name="parse" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="3912">#GstBaseParse.</doc> + line="3881">#GstBaseParse.</doc> <type name="BaseParse" c:type="GstBaseParse*"/> </instance-parameter> <parameter name="bitrate" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="3913">average bitrate in bits/second</doc> + line="3882">average bitrate in bits/second</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -3746,7 +4046,7 @@ a seek position, if there's no index and the format is syncable <method name="set_duration" c:identifier="gst_base_parse_set_duration"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="3859">Sets the duration of the currently playing media. Subclass can use this + line="3828">Sets the duration of the currently playing media. Subclass can use this when it is able to determine duration and/or notices a change in the media duration. Alternatively, if @interval is non-zero (default), then stream duration is determined based on estimated bitrate, and updated every @interval @@ -3759,25 +4059,25 @@ frames.</doc> <instance-parameter name="parse" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="3861">#GstBaseParse.</doc> + line="3830">#GstBaseParse.</doc> <type name="BaseParse" c:type="GstBaseParse*"/> </instance-parameter> <parameter name="fmt" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="3862">#GstFormat.</doc> + line="3831">#GstFormat.</doc> <type name="Gst.Format" c:type="GstFormat"/> </parameter> <parameter name="duration" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="3863">duration value.</doc> + line="3832">duration value.</doc> <type name="gint64" c:type="gint64"/> </parameter> <parameter name="interval" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="3864">how often to update the duration estimate based on bitrate, or 0.</doc> + line="3833">how often to update the duration estimate based on bitrate, or 0.</doc> <type name="gint" c:type="gint"/> </parameter> </parameters> @@ -3786,7 +4086,7 @@ frames.</doc> c:identifier="gst_base_parse_set_frame_rate"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="3948">If frames per second is configured, parser can take care of buffer duration + line="3917">If frames per second is configured, parser can take care of buffer duration and timestamping. When performing segment clipping, or seeking to a specific location, a corresponding decoder might need an initial @lead_in and a following @lead_out number of frames to ensure the desired segment is @@ -3799,31 +4099,31 @@ entirely filled upon decoding.</doc> <instance-parameter name="parse" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="3950">the #GstBaseParse to set</doc> + line="3919">the #GstBaseParse to set</doc> <type name="BaseParse" c:type="GstBaseParse*"/> </instance-parameter> <parameter name="fps_num" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="3951">frames per second (numerator).</doc> + line="3920">frames per second (numerator).</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="fps_den" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="3952">frames per second (denominator).</doc> + line="3921">frames per second (denominator).</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="lead_in" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="3953">frames needed before a segment for subsequent decode</doc> + line="3922">frames needed before a segment for subsequent decode</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="lead_out" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="3954">frames needed after a segment</doc> + line="3923">frames needed after a segment</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -3832,7 +4132,7 @@ entirely filled upon decoding.</doc> c:identifier="gst_base_parse_set_has_timing_info"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="4005">Set if frames carry timing information which the subclass can (generally) + line="3974">Set if frames carry timing information which the subclass can (generally) parse and provide. In particular, intrinsic (rather than estimated) time can be obtained following a seek.</doc> <source-position filename="libs/gst/base/gstbaseparse.h" line="317"/> @@ -3843,13 +4143,13 @@ can be obtained following a seek.</doc> <instance-parameter name="parse" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="4007">a #GstBaseParse</doc> + line="3976">a #GstBaseParse</doc> <type name="BaseParse" c:type="GstBaseParse*"/> </instance-parameter> <parameter name="has_timing" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="4008">whether frames carry timing information</doc> + line="3977">whether frames carry timing information</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -3857,7 +4157,7 @@ can be obtained following a seek.</doc> <method name="set_infer_ts" c:identifier="gst_base_parse_set_infer_ts"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="4076">By default, the base class might try to infer PTS from DTS and vice + line="4045">By default, the base class might try to infer PTS from DTS and vice versa. While this is generally correct for audio data, it may not be otherwise. Sub-classes implementing such formats should disable timestamp inferring.</doc> @@ -3869,13 +4169,13 @@ timestamp inferring.</doc> <instance-parameter name="parse" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="4078">a #GstBaseParse</doc> + line="4047">a #GstBaseParse</doc> <type name="BaseParse" c:type="GstBaseParse*"/> </instance-parameter> <parameter name="infer_ts" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="4079">%TRUE if parser should infer DTS/PTS from each other</doc> + line="4048">%TRUE if parser should infer DTS/PTS from each other</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -3883,7 +4183,7 @@ timestamp inferring.</doc> <method name="set_latency" c:identifier="gst_base_parse_set_latency"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="4093">Sets the minimum and maximum (which may likely be equal) latency introduced + line="4062">Sets the minimum and maximum (which may likely be equal) latency introduced by the parsing process. If there is such a latency, which depends on the particular parsing of the format, it typically corresponds to 1 frame duration.</doc> <source-position filename="libs/gst/base/gstbaseparse.h" line="341"/> @@ -3894,19 +4194,19 @@ particular parsing of the format, it typically corresponds to 1 frame duration.< <instance-parameter name="parse" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="4095">a #GstBaseParse</doc> + line="4064">a #GstBaseParse</doc> <type name="BaseParse" c:type="GstBaseParse*"/> </instance-parameter> <parameter name="min_latency" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="4096">minimum parse latency</doc> + line="4065">minimum parse latency</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </parameter> <parameter name="max_latency" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="4097">maximum parse latency</doc> + line="4066">maximum parse latency</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </parameter> </parameters> @@ -3915,7 +4215,7 @@ particular parsing of the format, it typically corresponds to 1 frame duration.< c:identifier="gst_base_parse_set_min_frame_size"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="3930">Subclass can use this function to tell the base class that it needs to + line="3899">Subclass can use this function to tell the base class that it needs to be given buffers of at least @min_size bytes.</doc> <source-position filename="libs/gst/base/gstbaseparse.h" line="314"/> <return-value transfer-ownership="none"> @@ -3925,13 +4225,13 @@ be given buffers of at least @min_size bytes.</doc> <instance-parameter name="parse" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="3932">#GstBaseParse.</doc> + line="3901">#GstBaseParse.</doc> <type name="BaseParse" c:type="GstBaseParse*"/> </instance-parameter> <parameter name="min_size" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="3933">Minimum size in bytes of the data that this base class should + line="3902">Minimum size in bytes of the data that this base class should give to subclass.</doc> <type name="guint" c:type="guint"/> </parameter> @@ -3941,7 +4241,7 @@ be given buffers of at least @min_size bytes.</doc> c:identifier="gst_base_parse_set_passthrough"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="4037">Set if the nature of the format or configuration does not allow (much) + line="4006">Set if the nature of the format or configuration does not allow (much) parsing, and the parser should operate in passthrough mode (which only applies when operating in push mode). That is, incoming buffers are pushed through unmodified, i.e. no #GstBaseParseClass.handle_frame() @@ -3956,13 +4256,13 @@ passthrough semantics in #GstBaseParseClass.pre_push_frame().</doc> <instance-parameter name="parse" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="4039">a #GstBaseParse</doc> + line="4008">a #GstBaseParse</doc> <type name="BaseParse" c:type="GstBaseParse*"/> </instance-parameter> <parameter name="passthrough" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="4040">%TRUE if parser should run in passthrough mode</doc> + line="4009">%TRUE if parser should run in passthrough mode</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -3971,7 +4271,7 @@ passthrough semantics in #GstBaseParseClass.pre_push_frame().</doc> c:identifier="gst_base_parse_set_pts_interpolation"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="4057">By default, the base class will guess PTS timestamps using a simple + line="4026">By default, the base class will guess PTS timestamps using a simple interpolation (previous timestamp + duration), which is incorrect for data streams with reordering, where PTS can go backward. Sub-classes implementing such formats should disable PTS interpolation.</doc> @@ -3983,13 +4283,13 @@ implementing such formats should disable PTS interpolation.</doc> <instance-parameter name="parse" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="4059">a #GstBaseParse</doc> + line="4028">a #GstBaseParse</doc> <type name="BaseParse" c:type="GstBaseParse*"/> </instance-parameter> <parameter name="pts_interpolate" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="4060">%TRUE if parser should interpolate PTS timestamps</doc> + line="4029">%TRUE if parser should interpolate PTS timestamps</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -3997,7 +4297,7 @@ implementing such formats should disable PTS interpolation.</doc> <method name="set_syncable" c:identifier="gst_base_parse_set_syncable"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="4021">Set if frame starts can be identified. This is set by default and + line="3990">Set if frame starts can be identified. This is set by default and determines whether seeking based on bitrate averages is possible for a format/stream.</doc> <source-position filename="libs/gst/base/gstbaseparse.h" line="323"/> @@ -4008,13 +4308,13 @@ is possible for a format/stream.</doc> <instance-parameter name="parse" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="4023">a #GstBaseParse</doc> + line="3992">a #GstBaseParse</doc> <type name="BaseParse" c:type="GstBaseParse*"/> </instance-parameter> <parameter name="syncable" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="4024">set if frame starts can be identified</doc> + line="3993">set if frame starts can be identified</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -4024,7 +4324,7 @@ is possible for a format/stream.</doc> version="1.2"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="4979">This function should only be called from a @handle_frame implementation. + line="4949">This function should only be called from a @handle_frame implementation. #GstBaseParse creates initial timestamps for frames by using the last timestamp seen in the stream before the frame starts. In certain @@ -4040,13 +4340,13 @@ into the frame data that the picture starts.</doc> <instance-parameter name="parse" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="4981">a #GstBaseParse</doc> + line="4951">a #GstBaseParse</doc> <type name="BaseParse" c:type="GstBaseParse*"/> </instance-parameter> <parameter name="offset" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="4982">offset into current buffer</doc> + line="4952">offset into current buffer</doc> <type name="gsize" c:type="gsize"/> </parameter> </parameters> @@ -4379,14 +4679,14 @@ of each frame's processing, i.e. parsing virtual method invocation sequence.</do <constructor name="new" c:identifier="gst_base_parse_frame_new"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="748">Allocates a new #GstBaseParseFrame. This function is mainly for bindings, + line="749">Allocates a new #GstBaseParseFrame. This function is mainly for bindings, elements written in C should usually allocate the frame on the stack and then use gst_base_parse_frame_init() to initialise it.</doc> <source-position filename="libs/gst/base/gstbaseparse.h" line="287"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="760">a newly-allocated #GstBaseParseFrame. Free with + line="761">a newly-allocated #GstBaseParseFrame. Free with gst_base_parse_frame_free() when no longer needed.</doc> <type name="BaseParseFrame" c:type="GstBaseParseFrame*"/> </return-value> @@ -4394,26 +4694,28 @@ then use gst_base_parse_frame_init() to initialise it.</doc> <parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="750">a #GstBuffer</doc> + line="751">a #GstBuffer</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </parameter> <parameter name="flags" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="751">the flags</doc> + line="752">the flags</doc> <type name="BaseParseFrameFlags" c:type="GstBaseParseFrameFlags"/> </parameter> <parameter name="overhead" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="752">number of bytes in this frame which should be counted as + line="753">number of bytes in this frame which should be counted as metadata overhead, ie. not used to calculate the average bitrate. Set to -1 to mark the entire frame as metadata. If in doubt, set to 0.</doc> <type name="gint" c:type="gint"/> </parameter> </parameters> </constructor> - <method name="copy" c:identifier="gst_base_parse_frame_copy"> + <method name="copy" + c:identifier="gst_base_parse_frame_copy" + version="1.12.1"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" line="680">Copies a #GstBaseParseFrame.</doc> @@ -4436,7 +4738,7 @@ then use gst_base_parse_frame_init() to initialise it.</doc> <method name="free" c:identifier="gst_base_parse_frame_free"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="703">Frees the provided @frame.</doc> + line="704">Frees the provided @frame.</doc> <source-position filename="libs/gst/base/gstbaseparse.h" line="296"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> @@ -4445,7 +4747,7 @@ then use gst_base_parse_frame_init() to initialise it.</doc> <instance-parameter name="frame" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="705">A #GstBaseParseFrame</doc> + line="706">A #GstBaseParseFrame</doc> <type name="BaseParseFrame" c:type="GstBaseParseFrame*"/> </instance-parameter> </parameters> @@ -4453,7 +4755,7 @@ then use gst_base_parse_frame_init() to initialise it.</doc> <method name="init" c:identifier="gst_base_parse_frame_init"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="730">Sets a #GstBaseParseFrame to initial state. Currently this means + line="731">Sets a #GstBaseParseFrame to initial state. Currently this means all public fields are zero-ed and a private flag is set to make sure gst_base_parse_frame_free() only frees the contents but not the actual frame. Use this function to initialise a #GstBaseParseFrame @@ -4466,7 +4768,7 @@ allocated on the stack.</doc> <instance-parameter name="frame" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbaseparse.c" - line="732">#GstBaseParseFrame.</doc> + line="733">#GstBaseParseFrame.</doc> <type name="BaseParseFrame" c:type="GstBaseParseFrame*"/> </instance-parameter> </parameters> @@ -6599,7 +6901,7 @@ out. The base class will sync on the clock using these times.</doc> <virtual-method name="negotiate" invoker="negotiate" version="1.18"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="3402">Negotiates src pad caps with downstream elements. + line="3459">Negotiates src pad caps with downstream elements. Unmarks GST_PAD_FLAG_NEED_RECONFIGURE in any case. But marks it again if #GstBaseSrcClass.negotiate() fails. @@ -6610,14 +6912,14 @@ buffer is allocated.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="3414">%TRUE if the negotiation succeeded, else %FALSE.</doc> + line="3471">%TRUE if the negotiation succeeded, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="src" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="3404">base source instance</doc> + line="3461">base source instance</doc> <type name="BaseSrc" c:type="GstBaseSrc*"/> </instance-parameter> </parameters> @@ -6656,25 +6958,25 @@ buffer is allocated.</doc> <virtual-method name="set_caps" invoker="set_caps"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="924">Set new caps on the basesrc source pad.</doc> + line="981">Set new caps on the basesrc source pad.</doc> <source-position filename="libs/gst/base/gstbasesrc.h" line="189"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="931">%TRUE if the caps could be set</doc> + line="988">%TRUE if the caps could be set</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="src" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="926">a #GstBaseSrc</doc> + line="983">a #GstBaseSrc</doc> <type name="BaseSrc" c:type="GstBaseSrc*"/> </instance-parameter> <parameter name="caps" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="927">a #GstCaps</doc> + line="984">a #GstCaps</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> </parameters> @@ -6726,11 +7028,11 @@ buffer is allocated.</doc> <method name="get_allocator" c:identifier="gst_base_src_get_allocator"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="4018">Lets #GstBaseSrc sub-classes to know the memory @allocator + line="4075">Lets #GstBaseSrc sub-classes to know the memory @allocator used by the base class and its @params. Unref the @allocator after usage.</doc> - <source-position filename="libs/gst/base/gstbasesrc.h" line="318"/> + <source-position filename="libs/gst/base/gstbasesrc.h" line="322"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -6738,7 +7040,7 @@ Unref the @allocator after usage.</doc> <instance-parameter name="src" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="4020">a #GstBaseSrc</doc> + line="4077">a #GstBaseSrc</doc> <type name="BaseSrc" c:type="GstBaseSrc*"/> </instance-parameter> <parameter name="allocator" @@ -6749,7 +7051,7 @@ Unref the @allocator after usage.</doc> allow-none="1"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="4021">the #GstAllocator + line="4078">the #GstAllocator used</doc> <type name="Gst.Allocator" c:type="GstAllocator**"/> </parameter> @@ -6761,7 +7063,7 @@ used</doc> allow-none="1"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="4023">the + line="4080">the #GstAllocationParams of @allocator</doc> <type name="Gst.AllocationParams" c:type="GstAllocationParams*"/> </parameter> @@ -6789,11 +7091,11 @@ used</doc> </method> <method name="get_buffer_pool" c:identifier="gst_base_src_get_buffer_pool"> - <source-position filename="libs/gst/base/gstbasesrc.h" line="315"/> + <source-position filename="libs/gst/base/gstbasesrc.h" line="319"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="4000">the instance of the #GstBufferPool used + line="4057">the instance of the #GstBufferPool used by the src; unref it after usage.</doc> <type name="Gst.BufferPool" c:type="GstBufferPool*"/> </return-value> @@ -6801,7 +7103,7 @@ by the src; unref it after usage.</doc> <instance-parameter name="src" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="3998">a #GstBaseSrc</doc> + line="4055">a #GstBaseSrc</doc> <type name="BaseSrc" c:type="GstBaseSrc*"/> </instance-parameter> </parameters> @@ -6872,7 +7174,7 @@ by the src; unref it after usage.</doc> version="1.18"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="3402">Negotiates src pad caps with downstream elements. + line="3459">Negotiates src pad caps with downstream elements. Unmarks GST_PAD_FLAG_NEED_RECONFIGURE in any case. But marks it again if #GstBaseSrcClass.negotiate() fails. @@ -6883,20 +7185,22 @@ buffer is allocated.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="3414">%TRUE if the negotiation succeeded, else %FALSE.</doc> + line="3471">%TRUE if the negotiation succeeded, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="src" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="3404">base source instance</doc> + line="3461">base source instance</doc> <type name="BaseSrc" c:type="GstBaseSrc*"/> </instance-parameter> </parameters> </method> <method name="new_seamless_segment" - c:identifier="gst_base_src_new_seamless_segment"> + c:identifier="gst_base_src_new_seamless_segment" + deprecated="1" + deprecated-version="1.18"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" line="851">Prepare a new seamless segment for emission downstream. This function must @@ -6905,6 +7209,7 @@ as the stream-lock needs to be held. The format for the new segment will be the current format of the source, as configured with gst_base_src_set_format()</doc> + <doc-deprecated xml:space="preserve">Use gst_base_src_new_segment()</doc-deprecated> <source-position filename="libs/gst/base/gstbasesrc.h" line="309"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" @@ -6939,6 +7244,42 @@ configured with gst_base_src_set_format()</doc> </parameter> </parameters> </method> + <method name="new_segment" + c:identifier="gst_base_src_new_segment" + version="1.18"> + <doc xml:space="preserve" + filename="libs/gst/base/gstbasesrc.c" + line="901">Prepare a new segment for emission downstream. This function must +only be called by derived sub-classes, and only from the #GstBaseSrcClass::create function, +as the stream-lock needs to be held. + +The format for the @segment must be identical with the current format +of the source, as configured with gst_base_src_set_format(). + +The format of @src must not be %GST_FORMAT_UNDEFINED and the format +should be configured via gst_base_src_set_format() before calling this method.</doc> + <source-position filename="libs/gst/base/gstbasesrc.h" line="312"/> + <return-value transfer-ownership="none"> + <doc xml:space="preserve" + filename="libs/gst/base/gstbasesrc.c" + line="916">%TRUE if preparation of new segment succeeded.</doc> + <type name="gboolean" c:type="gboolean"/> + </return-value> + <parameters> + <instance-parameter name="src" transfer-ownership="none"> + <doc xml:space="preserve" + filename="libs/gst/base/gstbasesrc.c" + line="903">a #GstBaseSrc</doc> + <type name="BaseSrc" c:type="GstBaseSrc*"/> + </instance-parameter> + <parameter name="segment" transfer-ownership="none"> + <doc xml:space="preserve" + filename="libs/gst/base/gstbasesrc.c" + line="904">a pointer to a #GstSegment</doc> + <type name="Gst.Segment" c:type="const GstSegment*"/> + </parameter> + </parameters> + </method> <method name="query_latency" c:identifier="gst_base_src_query_latency"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" @@ -7084,25 +7425,25 @@ returns %GST_FLOW_EOS.</doc> <method name="set_caps" c:identifier="gst_base_src_set_caps"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="924">Set new caps on the basesrc source pad.</doc> - <source-position filename="libs/gst/base/gstbasesrc.h" line="312"/> + line="981">Set new caps on the basesrc source pad.</doc> + <source-position filename="libs/gst/base/gstbasesrc.h" line="316"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="931">%TRUE if the caps could be set</doc> + line="988">%TRUE if the caps could be set</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="src" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="926">a #GstBaseSrc</doc> + line="983">a #GstBaseSrc</doc> <type name="BaseSrc" c:type="GstBaseSrc*"/> </instance-parameter> <parameter name="caps" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="927">a #GstCaps</doc> + line="984">a #GstCaps</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> </parameters> @@ -7221,7 +7562,7 @@ be GST_STATE_CHANGE_NO_PREROLL.</doc> <method name="start_complete" c:identifier="gst_base_src_start_complete"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="3506">Complete an asynchronous start operation. When the subclass overrides the + line="3563">Complete an asynchronous start operation. When the subclass overrides the start method, it should call gst_base_src_start_complete() when the start operation completes either from the same thread or from an asynchronous helper thread.</doc> @@ -7233,13 +7574,13 @@ helper thread.</doc> <instance-parameter name="basesrc" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="3508">base source instance</doc> + line="3565">base source instance</doc> <type name="BaseSrc" c:type="GstBaseSrc*"/> </instance-parameter> <parameter name="ret" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="3509">a #GstFlowReturn</doc> + line="3566">a #GstFlowReturn</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </parameter> </parameters> @@ -7247,19 +7588,19 @@ helper thread.</doc> <method name="start_wait" c:identifier="gst_base_src_start_wait"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="3646">Wait until the start operation completes.</doc> + line="3703">Wait until the start operation completes.</doc> <source-position filename="libs/gst/base/gstbasesrc.h" line="290"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="3652">a #GstFlowReturn.</doc> + line="3709">a #GstFlowReturn.</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> <parameters> <instance-parameter name="basesrc" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="3648">base source instance</doc> + line="3705">base source instance</doc> <type name="BaseSrc" c:type="GstBaseSrc*"/> </instance-parameter> </parameters> @@ -7269,7 +7610,7 @@ helper thread.</doc> version="1.14"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="4047">Subclasses can call this from their create virtual method implementation + line="4104">Subclasses can call this from their create virtual method implementation to submit a buffer list to be pushed out later. This is useful in cases where the create function wants to produce multiple buffers to be pushed out in one go in form of a #GstBufferList, which can reduce overhead @@ -7285,7 +7626,7 @@ function the behaviour is undefined. Subclasses must only call this function once per create function call and subclasses must only call this function when the source operates in push mode.</doc> - <source-position filename="libs/gst/base/gstbasesrc.h" line="323"/> + <source-position filename="libs/gst/base/gstbasesrc.h" line="327"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -7293,13 +7634,13 @@ mode.</doc> <instance-parameter name="src" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="4049">a #GstBaseSrc</doc> + line="4106">a #GstBaseSrc</doc> <type name="BaseSrc" c:type="GstBaseSrc*"/> </instance-parameter> <parameter name="buffer_list" transfer-ownership="full"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="4050">a #GstBufferList</doc> + line="4107">a #GstBufferList</doc> <type name="Gst.BufferList" c:type="GstBufferList*"/> </parameter> </parameters> @@ -7444,14 +7785,14 @@ buffers.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="3414">%TRUE if the negotiation succeeded, else %FALSE.</doc> + line="3471">%TRUE if the negotiation succeeded, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <parameter name="src" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="3404">base source instance</doc> + line="3461">base source instance</doc> <type name="BaseSrc" c:type="GstBaseSrc*"/> </parameter> </parameters> @@ -7479,20 +7820,20 @@ buffers.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="931">%TRUE if the caps could be set</doc> + line="988">%TRUE if the caps could be set</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <parameter name="src" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="926">a #GstBaseSrc</doc> + line="983">a #GstBaseSrc</doc> <type name="BaseSrc" c:type="GstBaseSrc*"/> </parameter> <parameter name="caps" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasesrc.c" - line="927">a #GstCaps</doc> + line="984">a #GstCaps</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> </parameters> @@ -8313,7 +8654,7 @@ It provides for: c:identifier="gst_base_transform_get_allocator"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2859">Lets #GstBaseTransform sub-classes know the memory @allocator + line="2864">Lets #GstBaseTransform sub-classes know the memory @allocator used by the base class and its @params. Unref the @allocator after use.</doc> @@ -8326,7 +8667,7 @@ Unref the @allocator after use.</doc> <instance-parameter name="trans" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2861">a #GstBaseTransform</doc> + line="2866">a #GstBaseTransform</doc> <type name="BaseTransform" c:type="GstBaseTransform*"/> </instance-parameter> <parameter name="allocator" @@ -8337,7 +8678,7 @@ Unref the @allocator after use.</doc> allow-none="1"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2862">the #GstAllocator + line="2867">the #GstAllocator used</doc> <type name="Gst.Allocator" c:type="GstAllocator**"/> </parameter> @@ -8349,7 +8690,7 @@ used</doc> allow-none="1"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2864">the + line="2869">the #GstAllocationParams of @allocator</doc> <type name="Gst.AllocationParams" c:type="GstAllocationParams*"/> </parameter> @@ -8362,7 +8703,7 @@ used</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2845">the instance of the #GstBufferPool used + line="2850">the instance of the #GstBufferPool used by @trans; free it after use</doc> <type name="Gst.BufferPool" c:type="GstBufferPool*"/> </return-value> @@ -8370,7 +8711,7 @@ by @trans; free it after use</doc> <instance-parameter name="trans" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2843">a #GstBaseTransform</doc> + line="2848">a #GstBaseTransform</doc> <type name="BaseTransform" c:type="GstBaseTransform*"/> </instance-parameter> </parameters> @@ -8378,13 +8719,13 @@ by @trans; free it after use</doc> <method name="is_in_place" c:identifier="gst_base_transform_is_in_place"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2651">See if @trans is configured as a in_place transform.</doc> + line="2656">See if @trans is configured as a in_place transform.</doc> <source-position filename="libs/gst/base/gstbasetransform.h" line="317"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2657">%TRUE if the transform is configured in in_place mode. + line="2662">%TRUE if the transform is configured in in_place mode. MT safe.</doc> <type name="gboolean" c:type="gboolean"/> @@ -8393,7 +8734,7 @@ MT safe.</doc> <instance-parameter name="trans" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2653">the #GstBaseTransform to query</doc> + line="2658">the #GstBaseTransform to query</doc> <type name="BaseTransform" c:type="GstBaseTransform*"/> </instance-parameter> </parameters> @@ -8402,13 +8743,13 @@ MT safe.</doc> c:identifier="gst_base_transform_is_passthrough"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2587">See if @trans is configured as a passthrough transform.</doc> + line="2592">See if @trans is configured as a passthrough transform.</doc> <source-position filename="libs/gst/base/gstbasetransform.h" line="311"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2593">%TRUE if the transform is configured in passthrough mode. + line="2598">%TRUE if the transform is configured in passthrough mode. MT safe.</doc> <type name="gboolean" c:type="gboolean"/> @@ -8417,7 +8758,7 @@ MT safe.</doc> <instance-parameter name="trans" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2589">the #GstBaseTransform to query</doc> + line="2594">the #GstBaseTransform to query</doc> <type name="BaseTransform" c:type="GstBaseTransform*"/> </instance-parameter> </parameters> @@ -8426,13 +8767,13 @@ MT safe.</doc> c:identifier="gst_base_transform_is_qos_enabled"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2726">Queries if the transform will handle QoS.</doc> + line="2731">Queries if the transform will handle QoS.</doc> <source-position filename="libs/gst/base/gstbasetransform.h" line="328"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2732">%TRUE if QoS is enabled. + line="2737">%TRUE if QoS is enabled. MT safe.</doc> <type name="gboolean" c:type="gboolean"/> @@ -8441,7 +8782,7 @@ MT safe.</doc> <instance-parameter name="trans" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2728">a #GstBaseTransform</doc> + line="2733">a #GstBaseTransform</doc> <type name="BaseTransform" c:type="GstBaseTransform*"/> </instance-parameter> </parameters> @@ -8451,7 +8792,7 @@ MT safe.</doc> version="1.18"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="1442">Negotiates src pad caps with downstream elements if the source pad is + line="1447">Negotiates src pad caps with downstream elements if the source pad is marked as needing reconfiguring. Unmarks GST_PAD_FLAG_NEED_RECONFIGURE in any case. But marks it again if negotiation fails. @@ -8470,14 +8811,14 @@ implementation.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="1461">%TRUE if the negotiation succeeded, else %FALSE.</doc> + line="1466">%TRUE if the negotiation succeeded, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="trans" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="1444">the #GstBaseTransform to set</doc> + line="1449">the #GstBaseTransform to set</doc> <type name="BaseTransform" c:type="GstBaseTransform*"/> </instance-parameter> </parameters> @@ -8486,7 +8827,7 @@ implementation.</doc> c:identifier="gst_base_transform_reconfigure_sink"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2806">Instructs @trans to request renegotiation upstream. This function is + line="2811">Instructs @trans to request renegotiation upstream. This function is typically called after properties on the transform were set that influence the input format.</doc> <source-position filename="libs/gst/base/gstbasetransform.h" @@ -8498,7 +8839,7 @@ influence the input format.</doc> <instance-parameter name="trans" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2808">a #GstBaseTransform</doc> + line="2813">a #GstBaseTransform</doc> <type name="BaseTransform" c:type="GstBaseTransform*"/> </instance-parameter> </parameters> @@ -8507,7 +8848,7 @@ influence the input format.</doc> c:identifier="gst_base_transform_reconfigure_src"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2825">Instructs @trans to renegotiate a new downstream transform on the next + line="2830">Instructs @trans to renegotiate a new downstream transform on the next buffer. This function is typically called after properties on the transform were set that influence the output format.</doc> <source-position filename="libs/gst/base/gstbasetransform.h" @@ -8519,7 +8860,7 @@ were set that influence the output format.</doc> <instance-parameter name="trans" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2827">a #GstBaseTransform</doc> + line="2832">a #GstBaseTransform</doc> <type name="BaseTransform" c:type="GstBaseTransform*"/> </instance-parameter> </parameters> @@ -8528,7 +8869,7 @@ were set that influence the output format.</doc> c:identifier="gst_base_transform_set_gap_aware"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2750">If @gap_aware is %FALSE (the default), output buffers will have the + line="2755">If @gap_aware is %FALSE (the default), output buffers will have the %GST_BUFFER_FLAG_GAP flag unset. If set to %TRUE, the element must handle output buffers with this flag set @@ -8545,13 +8886,13 @@ MT safe.</doc> <instance-parameter name="trans" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2752">a #GstBaseTransform</doc> + line="2757">a #GstBaseTransform</doc> <type name="BaseTransform" c:type="GstBaseTransform*"/> </instance-parameter> <parameter name="gap_aware" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2753">New state</doc> + line="2758">New state</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -8560,7 +8901,7 @@ MT safe.</doc> c:identifier="gst_base_transform_set_in_place"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2611">Determines whether a non-writable buffer will be copied before passing + line="2616">Determines whether a non-writable buffer will be copied before passing to the transform_ip function. * Always %TRUE if no transform function is implemented. @@ -8576,13 +8917,13 @@ MT safe.</doc> <instance-parameter name="trans" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2613">the #GstBaseTransform to modify</doc> + line="2618">the #GstBaseTransform to modify</doc> <type name="BaseTransform" c:type="GstBaseTransform*"/> </instance-parameter> <parameter name="in_place" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2614">Boolean value indicating that we would like to operate + line="2619">Boolean value indicating that we would like to operate on in_place buffers.</doc> <type name="gboolean" c:type="gboolean"/> </parameter> @@ -8592,7 +8933,7 @@ on in_place buffers.</doc> c:identifier="gst_base_transform_set_passthrough"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2551">Set passthrough mode for this filter by default. This is mostly + line="2556">Set passthrough mode for this filter by default. This is mostly useful for filters that do not care about negotiation. Always %TRUE for filters which don't implement either a transform @@ -8608,13 +8949,13 @@ MT safe.</doc> <instance-parameter name="trans" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2553">the #GstBaseTransform to set</doc> + line="2558">the #GstBaseTransform to set</doc> <type name="BaseTransform" c:type="GstBaseTransform*"/> </instance-parameter> <parameter name="passthrough" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2554">boolean indicating passthrough mode.</doc> + line="2559">boolean indicating passthrough mode.</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -8624,7 +8965,7 @@ MT safe.</doc> version="1.0.1"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2775">If @prefer_passthrough is %TRUE (the default), @trans will check and + line="2780">If @prefer_passthrough is %TRUE (the default), @trans will check and prefer passthrough caps from the list of caps returned by the transform_caps vmethod. @@ -8644,13 +8985,13 @@ MT safe.</doc> <instance-parameter name="trans" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2777">a #GstBaseTransform</doc> + line="2782">a #GstBaseTransform</doc> <type name="BaseTransform" c:type="GstBaseTransform*"/> </instance-parameter> <parameter name="prefer_passthrough" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2778">New state</doc> + line="2783">New state</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -8659,7 +9000,7 @@ MT safe.</doc> c:identifier="gst_base_transform_set_qos_enabled"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2705">Enable or disable QoS handling in the transform. + line="2710">Enable or disable QoS handling in the transform. MT safe.</doc> <source-position filename="libs/gst/base/gstbasetransform.h" @@ -8671,13 +9012,13 @@ MT safe.</doc> <instance-parameter name="trans" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2707">a #GstBaseTransform</doc> + line="2712">a #GstBaseTransform</doc> <type name="BaseTransform" c:type="GstBaseTransform*"/> </instance-parameter> <parameter name="enabled" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2708">new state</doc> + line="2713">new state</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -8685,7 +9026,7 @@ MT safe.</doc> <method name="update_qos" c:identifier="gst_base_transform_update_qos"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2675">Set the QoS parameters in the transform. This function is called internally + line="2680">Set the QoS parameters in the transform. This function is called internally when a QOS event is received but subclasses can provide custom information when needed. @@ -8699,25 +9040,25 @@ MT safe.</doc> <instance-parameter name="trans" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2677">a #GstBaseTransform</doc> + line="2682">a #GstBaseTransform</doc> <type name="BaseTransform" c:type="GstBaseTransform*"/> </instance-parameter> <parameter name="proportion" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2678">the proportion</doc> + line="2683">the proportion</doc> <type name="gdouble" c:type="gdouble"/> </parameter> <parameter name="diff" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2679">the diff against the clock</doc> + line="2684">the diff against the clock</doc> <type name="Gst.ClockTimeDiff" c:type="GstClockTimeDiff"/> </parameter> <parameter name="timestamp" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2680">the timestamp of the buffer generating the QoS expressed in + line="2685">the timestamp of the buffer generating the QoS expressed in running_time.</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </parameter> @@ -8728,7 +9069,7 @@ running_time.</doc> version="1.6"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2886">Updates the srcpad caps and sends the caps downstream. This function + line="2891">Updates the srcpad caps and sends the caps downstream. This function can be used by subclasses when they have already negotiated their caps but found a change in them (or computed new information). This way, they can notify downstream about that change without losing any @@ -8738,20 +9079,20 @@ buffer.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2898">%TRUE if the caps could be sent downstream %FALSE otherwise</doc> + line="2903">%TRUE if the caps could be sent downstream %FALSE otherwise</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="trans" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2888">a #GstBaseTransform</doc> + line="2893">a #GstBaseTransform</doc> <type name="BaseTransform" c:type="GstBaseTransform*"/> </instance-parameter> <parameter name="updated_caps" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/base/gstbasetransform.c" - line="2889">An updated version of the srcpad caps to be pushed + line="2894">An updated version of the srcpad caps to be pushed downstream</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> diff --git a/girs/GstController-1.0.gir b/girs/GstController-1.0.gir index 6e1c0c8528..47704d79dd 100644 --- a/girs/GstController-1.0.gir +++ b/girs/GstController-1.0.gir @@ -330,7 +330,7 @@ transformations.</doc> <constructor name="new" c:identifier="gst_direct_control_binding_new"> <doc xml:space="preserve" filename="libs/gst/controller/gstdirectcontrolbinding.c" - line="511">Create a new control-binding that attaches the #GstControlSource to the + line="512">Create a new control-binding that attaches the #GstControlSource to the #GObject property. It will map the control source range [0.0 ... 1.0] to the full target property range, and clip all values outside this range.</doc> <source-position filename="libs/gst/controller/gstdirectcontrolbinding.h" @@ -338,26 +338,26 @@ the full target property range, and clip all values outside this range.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/controller/gstdirectcontrolbinding.c" - line="521">the new #GstDirectControlBinding</doc> + line="522">the new #GstDirectControlBinding</doc> <type name="Gst.ControlBinding" c:type="GstControlBinding*"/> </return-value> <parameters> <parameter name="object" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/controller/gstdirectcontrolbinding.c" - line="513">the object of the property</doc> + line="514">the object of the property</doc> <type name="Gst.Object" c:type="GstObject*"/> </parameter> <parameter name="property_name" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/controller/gstdirectcontrolbinding.c" - line="514">the property-name to attach the control source</doc> + line="515">the property-name to attach the control source</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="cs" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/controller/gstdirectcontrolbinding.c" - line="515">the control source</doc> + line="516">the control source</doc> <type name="Gst.ControlSource" c:type="GstControlSource*"/> </parameter> </parameters> @@ -367,7 +367,7 @@ the full target property range, and clip all values outside this range.</doc> version="1.6"> <doc xml:space="preserve" filename="libs/gst/controller/gstdirectcontrolbinding.c" - line="531">Create a new control-binding that attaches the #GstControlSource to the + line="532">Create a new control-binding that attaches the #GstControlSource to the #GObject property. It will directly map the control source values to the target property range without any transformations.</doc> <source-position filename="libs/gst/controller/gstdirectcontrolbinding.h" @@ -375,26 +375,26 @@ target property range without any transformations.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/controller/gstdirectcontrolbinding.c" - line="541">the new #GstDirectControlBinding</doc> + line="542">the new #GstDirectControlBinding</doc> <type name="Gst.ControlBinding" c:type="GstControlBinding*"/> </return-value> <parameters> <parameter name="object" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/controller/gstdirectcontrolbinding.c" - line="533">the object of the property</doc> + line="534">the object of the property</doc> <type name="Gst.Object" c:type="GstObject*"/> </parameter> <parameter name="property_name" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/controller/gstdirectcontrolbinding.c" - line="534">the property-name to attach the control source</doc> + line="535">the property-name to attach the control source</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="cs" transfer-ownership="none"> <doc xml:space="preserve" filename="libs/gst/controller/gstdirectcontrolbinding.c" - line="535">the control source</doc> + line="536">the control source</doc> <type name="Gst.ControlSource" c:type="GstControlSource*"/> </parameter> </parameters> diff --git a/girs/GstPbutils-1.0.gir b/girs/GstPbutils-1.0.gir index 1db863dfbb..b486dccb04 100644 --- a/girs/GstPbutils-1.0.gir +++ b/girs/GstPbutils-1.0.gir @@ -2202,7 +2202,7 @@ storage.</doc> <constructor name="new" c:identifier="gst_encoding_audio_profile_new"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1182">Creates a new #GstEncodingAudioProfile + line="1181">Creates a new #GstEncodingAudioProfile All provided allocatable arguments will be internally copied, so can be safely freed/unreferenced after calling this method.</doc> @@ -2211,14 +2211,14 @@ safely freed/unreferenced after calling this method.</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1196">the newly created #GstEncodingAudioProfile.</doc> + line="1195">the newly created #GstEncodingAudioProfile.</doc> <type name="EncodingAudioProfile" c:type="GstEncodingAudioProfile*"/> </return-value> <parameters> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1184">the #GstCaps</doc> + line="1183">the #GstCaps</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> <parameter name="preset" @@ -2227,7 +2227,7 @@ safely freed/unreferenced after calling this method.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1185">the preset(s) to use on the encoder, can be %NULL</doc> + line="1184">the preset(s) to use on the encoder, can be %NULL</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="restriction" @@ -2236,14 +2236,14 @@ safely freed/unreferenced after calling this method.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1186">the #GstCaps used to restrict the input to the encoder, can be + line="1185">the #GstCaps used to restrict the input to the encoder, can be NULL. See gst_encoding_profile_get_restriction() for more details.</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> <parameter name="presence" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1188">the number of time this stream must be used. 0 means any number of + line="1187">the number of time this stream must be used. 0 means any number of times (including never)</doc> <type name="guint" c:type="guint"/> </parameter> @@ -2273,13 +2273,13 @@ NULL. See gst_encoding_profile_get_restriction() for more details.</doc> c:identifier="gst_encoding_container_profile_new"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1128">Creates a new #GstEncodingContainerProfile.</doc> + line="1127">Creates a new #GstEncodingContainerProfile.</doc> <source-position filename="gst-libs/gst/pbutils/encoding-profile.h" line="229"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1138">The newly created #GstEncodingContainerProfile.</doc> + line="1137">The newly created #GstEncodingContainerProfile.</doc> <type name="EncodingContainerProfile" c:type="GstEncodingContainerProfile*"/> </return-value> @@ -2290,7 +2290,7 @@ NULL. See gst_encoding_profile_get_restriction() for more details.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1130">The name of the container profile, can be %NULL</doc> + line="1129">The name of the container profile, can be %NULL</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="description" @@ -2299,14 +2299,14 @@ NULL. See gst_encoding_profile_get_restriction() for more details.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1131">The description of the container profile, + line="1130">The description of the container profile, can be %NULL</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1133">The format to use for this profile</doc> + line="1132">The format to use for this profile</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> <parameter name="preset" @@ -2315,7 +2315,7 @@ NULL. See gst_encoding_profile_get_restriction() for more details.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1134">The preset to use for this profile.</doc> + line="1133">The preset to use for this profile.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -2324,7 +2324,7 @@ NULL. See gst_encoding_profile_get_restriction() for more details.</doc> c:identifier="gst_encoding_container_profile_add_profile"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1069">Add a #GstEncodingProfile to the list of profiles handled by @container. + line="1075">Add a #GstEncodingProfile to the list of profiles handled by @container. No copy of @profile will be made, if you wish to use it elsewhere after this method you should increment its reference count.</doc> @@ -2333,21 +2333,21 @@ method you should increment its reference count.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1079">%TRUE if the @stream was properly added, else %FALSE.</doc> + line="1085">%TRUE if the @stream was properly added, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="container" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1071">the #GstEncodingContainerProfile to use</doc> + line="1077">the #GstEncodingContainerProfile to use</doc> <type name="EncodingContainerProfile" c:type="GstEncodingContainerProfile*"/> </instance-parameter> <parameter name="profile" transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1072">the #GstEncodingProfile to add.</doc> + line="1078">the #GstEncodingProfile to add.</doc> <type name="EncodingProfile" c:type="GstEncodingProfile*"/> </parameter> </parameters> @@ -2356,14 +2356,14 @@ method you should increment its reference count.</doc> c:identifier="gst_encoding_container_profile_contains_profile"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1047">Checks if @container contains a #GstEncodingProfile identical to + line="1053">Checks if @container contains a #GstEncodingProfile identical to @profile.</doc> <source-position filename="gst-libs/gst/pbutils/encoding-profile.h" line="221"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1055">%TRUE if @container contains a #GstEncodingProfile identical + line="1061">%TRUE if @container contains a #GstEncodingProfile identical to @profile, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -2371,14 +2371,14 @@ to @profile, else %FALSE.</doc> <instance-parameter name="container" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1049">a #GstEncodingContainerProfile</doc> + line="1055">a #GstEncodingContainerProfile</doc> <type name="EncodingContainerProfile" c:type="GstEncodingContainerProfile*"/> </instance-parameter> <parameter name="profile" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1050">a #GstEncodingProfile</doc> + line="1056">a #GstEncodingProfile</doc> <type name="EncodingProfile" c:type="GstEncodingProfile*"/> </parameter> </parameters> @@ -2390,7 +2390,7 @@ to @profile, else %FALSE.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="842"> + line="845"> the list of contained #GstEncodingProfile.</doc> <type name="GLib.List" c:type="const GList*"> <type name="EncodingProfile"/> @@ -2400,7 +2400,7 @@ the list of contained #GstEncodingProfile.</doc> <instance-parameter name="profile" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="840">a #GstEncodingContainerProfile</doc> + line="843">a #GstEncodingContainerProfile</doc> <type name="EncodingContainerProfile" c:type="GstEncodingContainerProfile*"/> </instance-parameter> @@ -2430,20 +2430,20 @@ information like name, description, format and preset.</doc> <function name="find" c:identifier="gst_encoding_profile_find"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1444">Find the #GstEncodingProfile with the specified name and category.</doc> + line="1443">Find the #GstEncodingProfile with the specified name and category.</doc> <source-position filename="gst-libs/gst/pbutils/encoding-profile.h" line="204"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1453">The matching #GstEncodingProfile or %NULL.</doc> + line="1452">The matching #GstEncodingProfile or %NULL.</doc> <type name="EncodingProfile" c:type="GstEncodingProfile*"/> </return-value> <parameters> <parameter name="targetname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1446">The name of the target</doc> + line="1445">The name of the target</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="profilename" @@ -2452,7 +2452,7 @@ information like name, description, format and preset.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1447">The name of the profile, if %NULL + line="1446">The name of the profile, if %NULL provided, it will default to the encoding profile called `default`.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> @@ -2462,7 +2462,7 @@ provided, it will default to the encoding profile called `default`.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1449">The target category. Can be %NULL</doc> + line="1448">The target category. Can be %NULL</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -2471,7 +2471,7 @@ provided, it will default to the encoding profile called `default`.</doc> c:identifier="gst_encoding_profile_from_discoverer"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="2026">Creates a #GstEncodingProfile matching the formats from the given + line="2055">Creates a #GstEncodingProfile matching the formats from the given #GstDiscovererInfo. Streams other than audio or video (eg, subtitles), are currently ignored.</doc> <source-position filename="gst-libs/gst/pbutils/encoding-profile.h" @@ -2479,14 +2479,14 @@ subtitles), are currently ignored.</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="2034">The new #GstEncodingProfile or %NULL.</doc> + line="2063">The new #GstEncodingProfile or %NULL.</doc> <type name="EncodingProfile" c:type="GstEncodingProfile*"/> </return-value> <parameters> <parameter name="info" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="2028">The #GstDiscovererInfo to read from</doc> + line="2057">The #GstDiscovererInfo to read from</doc> <type name="DiscovererInfo" c:type="GstDiscovererInfo*"/> </parameter> </parameters> @@ -2496,20 +2496,20 @@ subtitles), are currently ignored.</doc> version="1.12"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="2083">Makes a deep copy of @self</doc> + line="2096">Makes a deep copy of @self</doc> <source-position filename="gst-libs/gst/pbutils/encoding-profile.h" line="267"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="2089">The copy of @self</doc> + line="2102">The copy of @self</doc> <type name="EncodingProfile" c:type="GstEncodingProfile*"/> </return-value> <parameters> <instance-parameter name="self" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="2085">The #GstEncodingProfile to copy</doc> + line="2098">The #GstEncodingProfile to copy</doc> <type name="EncodingProfile" c:type="GstEncodingProfile*"/> </instance-parameter> </parameters> @@ -2560,14 +2560,14 @@ later during the encoding.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1343">a suitable file extension for @profile, or NULL.</doc> + line="1342">a suitable file extension for @profile, or NULL.</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> <instance-parameter name="profile" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1341">a #GstEncodingProfile</doc> + line="1340">a #GstEncodingProfile</doc> <type name="EncodingProfile" c:type="GstEncodingProfile*"/> </instance-parameter> </parameters> @@ -2595,13 +2595,13 @@ in the profile. Unref after usage.</doc> c:identifier="gst_encoding_profile_get_input_caps"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1227">Computes the full output caps that this @profile will be able to consume.</doc> + line="1226">Computes the full output caps that this @profile will be able to consume.</doc> <source-position filename="gst-libs/gst/pbutils/encoding-profile.h" line="195"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1233">The full caps the given @profile can consume. Call + line="1232">The full caps the given @profile can consume. Call gst_caps_unref() when you are done with the caps.</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </return-value> @@ -2609,7 +2609,7 @@ gst_caps_unref() when you are done with the caps.</doc> <instance-parameter name="profile" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1229">a #GstEncodingProfile</doc> + line="1228">a #GstEncodingProfile</doc> <type name="EncodingProfile" c:type="GstEncodingProfile*"/> </instance-parameter> </parameters> @@ -2743,14 +2743,14 @@ and segments will be eat so as to appear as one segment.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1287">the human-readable name of the type of @profile.</doc> + line="1286">the human-readable name of the type of @profile.</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> <instance-parameter name="profile" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1285">a #GstEncodingProfile</doc> + line="1284">a #GstEncodingProfile</doc> <type name="EncodingProfile" c:type="GstEncodingProfile*"/> </instance-parameter> </parameters> @@ -2770,26 +2770,26 @@ and segments will be eat so as to appear as one segment.</doc> <method name="is_equal" c:identifier="gst_encoding_profile_is_equal"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1208">Checks whether the two #GstEncodingProfile are equal</doc> + line="1207">Checks whether the two #GstEncodingProfile are equal</doc> <source-position filename="gst-libs/gst/pbutils/encoding-profile.h" line="191"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1215">%TRUE if @a and @b are equal, else %FALSE.</doc> + line="1214">%TRUE if @a and @b are equal, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="a" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1210">a #GstEncodingProfile</doc> + line="1209">a #GstEncodingProfile</doc> <type name="EncodingProfile" c:type="GstEncodingProfile*"/> </instance-parameter> <parameter name="b" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1211">a #GstEncodingProfile</doc> + line="1210">a #GstEncodingProfile</doc> <type name="EncodingProfile" c:type="GstEncodingProfile*"/> </parameter> </parameters> @@ -2855,7 +2855,7 @@ during the encoding</doc> version="1.6"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="737">Set whether the profile should be used or not.</doc> + line="740">Set whether the profile should be used or not.</doc> <source-position filename="gst-libs/gst/pbutils/encoding-profile.h" line="212"/> <return-value transfer-ownership="none"> @@ -2865,13 +2865,13 @@ during the encoding</doc> <instance-parameter name="profile" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="739">a #GstEncodingProfile</doc> + line="742">a #GstEncodingProfile</doc> <type name="EncodingProfile" c:type="GstEncodingProfile*"/> </instance-parameter> <parameter name="enabled" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="740">%FALSE to disable @profile, %TRUE to enable it</doc> + line="743">%FALSE to disable @profile, %TRUE to enable it</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -2932,7 +2932,7 @@ internally.</doc> c:identifier="gst_encoding_profile_set_presence"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="721">Set the number of time the profile is used in its parent + line="724">Set the number of time the profile is used in its parent container profile. If 0, it is not a mandatory stream</doc> <source-position filename="gst-libs/gst/pbutils/encoding-profile.h" line="176"/> @@ -2943,13 +2943,13 @@ container profile. If 0, it is not a mandatory stream</doc> <instance-parameter name="profile" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="723">a #GstEncodingProfile</doc> + line="726">a #GstEncodingProfile</doc> <type name="EncodingProfile" c:type="GstEncodingProfile*"/> </instance-parameter> <parameter name="presence" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="724">the number of time the profile can be used</doc> + line="727">the number of time the profile can be used</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -2957,7 +2957,7 @@ container profile. If 0, it is not a mandatory stream</doc> <method name="set_preset" c:identifier="gst_encoding_profile_set_preset"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="685">Sets the name of the #GstElement that implements the #GstPreset interface + line="688">Sets the name of the #GstElement that implements the #GstPreset interface to use for the profile. This is the name that has been set when saving the preset.</doc> <source-position filename="gst-libs/gst/pbutils/encoding-profile.h" @@ -2969,7 +2969,7 @@ This is the name that has been set when saving the preset.</doc> <instance-parameter name="profile" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="687">a #GstEncodingProfile</doc> + line="690">a #GstEncodingProfile</doc> <type name="EncodingProfile" c:type="GstEncodingProfile*"/> </instance-parameter> <parameter name="preset" @@ -2978,7 +2978,7 @@ This is the name that has been set when saving the preset.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="688">the element preset to use</doc> + line="691">the element preset to use</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -2987,7 +2987,7 @@ This is the name that has been set when saving the preset.</doc> c:identifier="gst_encoding_profile_set_preset_name"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="704">Sets the name of the #GstPreset's factory to be used in the profile.</doc> + line="707">Sets the name of the #GstPreset's factory to be used in the profile.</doc> <source-position filename="gst-libs/gst/pbutils/encoding-profile.h" line="180"/> <return-value transfer-ownership="none"> @@ -2997,7 +2997,7 @@ This is the name that has been set when saving the preset.</doc> <instance-parameter name="profile" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="706">a #GstEncodingProfile</doc> + line="709">a #GstEncodingProfile</doc> <type name="EncodingProfile" c:type="GstEncodingProfile*"/> </instance-parameter> <parameter name="preset_name" @@ -3006,7 +3006,7 @@ This is the name that has been set when saving the preset.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="707">The name of the preset to use in this @profile.</doc> + line="710">The name of the preset to use in this @profile.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -3015,7 +3015,7 @@ This is the name that has been set when saving the preset.</doc> c:identifier="gst_encoding_profile_set_restriction"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="755">Set the restriction #GstCaps to apply before the encoder + line="758">Set the restriction #GstCaps to apply before the encoder that will be used in the profile. See gst_encoding_profile_get_restriction() for more about restrictions. Does not apply to #GstEncodingContainerProfile.</doc> <source-position filename="gst-libs/gst/pbutils/encoding-profile.h" @@ -3027,7 +3027,7 @@ for more about restrictions. Does not apply to #GstEncodingContainerProfile.</do <instance-parameter name="profile" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="757">a #GstEncodingProfile</doc> + line="760">a #GstEncodingProfile</doc> <type name="EncodingProfile" c:type="GstEncodingProfile*"/> </instance-parameter> <parameter name="restriction" @@ -3036,7 +3036,7 @@ for more about restrictions. Does not apply to #GstEncodingContainerProfile.</do allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="758">the restriction to apply</doc> + line="761">the restriction to apply</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> </parameters> @@ -3046,8 +3046,11 @@ for more about restrictions. Does not apply to #GstEncodingContainerProfile.</do version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="665">If using a single segment, buffers will be retimestamped -and segments will be eat so as to appear as one segment.</doc> + line="665">If using a single segment, buffers will be retimestamped and segments will be +eat so as to appear as one segment. + +> *NOTE*: Single segment is not property supported when using +> #encodebin:avoid-reencoding</doc> <source-position filename="gst-libs/gst/pbutils/encoding-profile.h" line="159"/> <return-value transfer-ownership="none"> @@ -3063,8 +3066,8 @@ and segments will be eat so as to appear as one segment.</doc> <parameter name="single_segment" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="668">#TRUE if the stream represented by @profile should use a single -segment before the encoder #FALSE otherwise.</doc> + line="668">#TRUE if the stream represented by @profile should use a +single segment before the encoder, #FALSE otherwise.</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -3095,7 +3098,7 @@ When being stored/loaded, targets come from a specific category, like <constructor name="new" c:identifier="gst_encoding_target_new"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="253">Creates a new #GstEncodingTarget. + line="270">Creates a new #GstEncodingTarget. The name and category can only consist of lowercase ASCII letters for the first character, followed by either lowercase ASCII letters, digits or @@ -3110,7 +3113,7 @@ needed.</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="274">The newly created #GstEncodingTarget or %NULL if + line="291">The newly created #GstEncodingTarget or %NULL if there was an error.</doc> <type name="EncodingTarget" c:type="GstEncodingTarget*"/> </return-value> @@ -3118,27 +3121,27 @@ there was an error.</doc> <parameter name="name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="255">The name of the target.</doc> + line="272">The name of the target.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="category" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="256">The name of the category to which this @target + line="273">The name of the category to which this @target belongs. For example: #GST_ENCODING_CATEGORY_DEVICE.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="description" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="258">A description of #GstEncodingTarget in the + line="275">A description of #GstEncodingTarget in the current locale.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="profiles" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="260">A #GList of + line="277">A #GList of #GstEncodingProfile.</doc> <type name="GLib.List" c:type="const GList*"> <type name="EncodingProfile"/> @@ -3149,24 +3152,24 @@ current locale.</doc> <function name="load" c:identifier="gst_encoding_target_load" throws="1"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="858">Searches for the #GstEncodingTarget with the given name, loads it + line="875">Searches for the #GstEncodingTarget with the given name, loads it and returns it. If the category name is specified only targets from that category will be searched for.</doc> <source-position filename="gst-libs/gst/pbutils/encoding-target.h" - line="160"/> + line="163"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="873">The #GstEncodingTarget if available, else %NULL.</doc> + line="890">The #GstEncodingTarget if available, else %NULL.</doc> <type name="EncodingTarget" c:type="GstEncodingTarget*"/> </return-value> <parameters> <parameter name="name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="860">the name of the #GstEncodingTarget to load (automatically + line="877">the name of the #GstEncodingTarget to load (automatically converted to lower case internally as capital letters are not valid for target names).</doc> <type name="utf8" c:type="const gchar*"/> @@ -3177,7 +3180,7 @@ valid for target names).</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="863">the name of the target category, like + line="880">the name of the target category, like #GST_ENCODING_CATEGORY_DEVICE. Can be %NULL</doc> <type name="utf8" c:type="const gchar*"/> </parameter> @@ -3188,13 +3191,13 @@ valid for target names).</doc> throws="1"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="758">Opens the provided file and returns the contained #GstEncodingTarget.</doc> + line="775">Opens the provided file and returns the contained #GstEncodingTarget.</doc> <source-position filename="gst-libs/gst/pbutils/encoding-target.h" - line="165"/> + line="168"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="765">The #GstEncodingTarget contained in the file, else + line="782">The #GstEncodingTarget contained in the file, else %NULL</doc> <type name="EncodingTarget" c:type="GstEncodingTarget*"/> </return-value> @@ -3202,7 +3205,7 @@ valid for target names).</doc> <parameter name="filepath" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="760">The file location to load the #GstEncodingTarget from</doc> + line="777">The file location to load the #GstEncodingTarget from</doc> <type name="filename" c:type="const gchar*"/> </parameter> </parameters> @@ -3211,31 +3214,31 @@ valid for target names).</doc> c:identifier="gst_encoding_target_add_profile"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="322">Adds the given @profile to the @target. Each added profile must have + line="339">Adds the given @profile to the @target. Each added profile must have a unique name within the profile. The @target will steal a reference to the @profile. If you wish to use the profile after calling this method, you should increase its reference count.</doc> <source-position filename="gst-libs/gst/pbutils/encoding-target.h" - line="147"/> + line="150"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="334">%TRUE if the profile was added, else %FALSE.</doc> + line="351">%TRUE if the profile was added, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="target" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="324">the #GstEncodingTarget to add a profile to</doc> + line="341">the #GstEncodingTarget to add a profile to</doc> <type name="EncodingTarget" c:type="GstEncodingTarget*"/> </instance-parameter> <parameter name="profile" transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="325">the #GstEncodingProfile to add</doc> + line="342">the #GstEncodingProfile to add</doc> <type name="EncodingProfile" c:type="GstEncodingProfile*"/> </parameter> </parameters> @@ -3247,7 +3250,7 @@ count.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="153">The category of the @target. For example: + line="155">The category of the @target. For example: #GST_ENCODING_CATEGORY_DEVICE.</doc> <type name="utf8" c:type="const gchar*"/> </return-value> @@ -3255,7 +3258,7 @@ count.</doc> <instance-parameter name="target" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="151">a #GstEncodingTarget</doc> + line="153">a #GstEncodingTarget</doc> <type name="EncodingTarget" c:type="GstEncodingTarget*"/> </instance-parameter> </parameters> @@ -3267,14 +3270,14 @@ count.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="166">The description of the @target.</doc> + line="168">The description of the @target.</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> <instance-parameter name="target" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="164">a #GstEncodingTarget</doc> + line="166">a #GstEncodingTarget</doc> <type name="EncodingTarget" c:type="GstEncodingTarget*"/> </instance-parameter> </parameters> @@ -3285,14 +3288,34 @@ count.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="141">The name of the @target.</doc> + line="143">The name of the @target.</doc> + <type name="utf8" c:type="const gchar*"/> + </return-value> + <parameters> + <instance-parameter name="target" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/pbutils/encoding-target.c" + line="141">a #GstEncodingTarget</doc> + <type name="EncodingTarget" c:type="GstEncodingTarget*"/> + </instance-parameter> + </parameters> + </method> + <method name="get_path" + c:identifier="gst_encoding_target_get_path" + version="1.18"> + <source-position filename="gst-libs/gst/pbutils/encoding-target.h" + line="140"/> + <return-value transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/pbutils/encoding-target.c" + line="180">The path to the @target file.</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> <instance-parameter name="target" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="139">a #GstEncodingTarget</doc> + line="178">a #GstEncodingTarget</doc> <type name="EncodingTarget" c:type="GstEncodingTarget*"/> </instance-parameter> </parameters> @@ -3300,24 +3323,24 @@ count.</doc> <method name="get_profile" c:identifier="gst_encoding_target_get_profile"> <source-position filename="gst-libs/gst/pbutils/encoding-target.h" - line="143"/> + line="146"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="192">The matching #GstEncodingProfile, or %NULL.</doc> + line="209">The matching #GstEncodingProfile, or %NULL.</doc> <type name="EncodingProfile" c:type="GstEncodingProfile*"/> </return-value> <parameters> <instance-parameter name="target" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="189">a #GstEncodingTarget</doc> + line="206">a #GstEncodingTarget</doc> <type name="EncodingTarget" c:type="GstEncodingTarget*"/> </instance-parameter> <parameter name="name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="190">the name of the profile to retrieve</doc> + line="207">the name of the profile to retrieve</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -3325,11 +3348,11 @@ count.</doc> <method name="get_profiles" c:identifier="gst_encoding_target_get_profiles"> <source-position filename="gst-libs/gst/pbutils/encoding-target.h" - line="140"/> + line="143"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="178">A list of + line="195">A list of #GstEncodingProfile(s) this @target handles.</doc> <type name="GLib.List" c:type="const GList*"> <type name="EncodingProfile"/> @@ -3339,7 +3362,7 @@ count.</doc> <instance-parameter name="target" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="176">a #GstEncodingTarget</doc> + line="193">a #GstEncodingTarget</doc> <type name="EncodingTarget" c:type="GstEncodingTarget*"/> </instance-parameter> </parameters> @@ -3347,20 +3370,20 @@ count.</doc> <method name="save" c:identifier="gst_encoding_target_save" throws="1"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="1042">Saves the @target to a default user-local directory.</doc> + line="1061">Saves the @target to a default user-local directory.</doc> <source-position filename="gst-libs/gst/pbutils/encoding-target.h" - line="151"/> + line="154"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="1049">%TRUE if the target was correctly saved, else %FALSE.</doc> + line="1068">%TRUE if the target was correctly saved, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="target" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="1044">a #GstEncodingTarget</doc> + line="1063">a #GstEncodingTarget</doc> <type name="EncodingTarget" c:type="GstEncodingTarget*"/> </instance-parameter> </parameters> @@ -3370,26 +3393,26 @@ count.</doc> throws="1"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="974">Saves the @target to the provided file location.</doc> + line="991">Saves the @target to the provided file location.</doc> <source-position filename="gst-libs/gst/pbutils/encoding-target.h" - line="155"/> + line="158"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="982">%TRUE if the target was correctly saved, else %FALSE.</doc> + line="999">%TRUE if the target was correctly saved, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="target" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="976">a #GstEncodingTarget</doc> + line="993">a #GstEncodingTarget</doc> <type name="EncodingTarget" c:type="GstEncodingTarget*"/> </instance-parameter> <parameter name="filepath" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="977">the location to store the @target at.</doc> + line="994">the location to store the @target at.</doc> <type name="filename" c:type="const gchar*"/> </parameter> </parameters> @@ -3410,7 +3433,7 @@ count.</doc> <constructor name="new" c:identifier="gst_encoding_video_profile_new"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1151">Creates a new #GstEncodingVideoProfile + line="1150">Creates a new #GstEncodingVideoProfile All provided allocatable arguments will be internally copied, so can be safely freed/unreferenced after calling this method. @@ -3425,14 +3448,14 @@ gst_encoding_video_profile_set_variableframerate() documentation.</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1171">the newly created #GstEncodingVideoProfile.</doc> + line="1170">the newly created #GstEncodingVideoProfile.</doc> <type name="EncodingVideoProfile" c:type="GstEncodingVideoProfile*"/> </return-value> <parameters> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1153">the #GstCaps</doc> + line="1152">the #GstCaps</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> <parameter name="preset" @@ -3441,7 +3464,7 @@ gst_encoding_video_profile_set_variableframerate() documentation.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1154">the preset(s) to use on the encoder, can be %NULL</doc> + line="1153">the preset(s) to use on the encoder, can be %NULL</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="restriction" @@ -3450,14 +3473,14 @@ gst_encoding_video_profile_set_variableframerate() documentation.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1155">the #GstCaps used to restrict the input to the encoder, can be + line="1154">the #GstCaps used to restrict the input to the encoder, can be NULL. See gst_encoding_profile_get_restriction() for more details.</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> <parameter name="presence" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="1157">the number of time this stream must be used. 0 means any number of + line="1156">the number of time this stream must be used. 0 means any number of times (including never)</doc> <type name="guint" c:type="guint"/> </parameter> @@ -3467,13 +3490,13 @@ NULL. See gst_encoding_profile_get_restriction() for more details.</doc> c:identifier="gst_encoding_video_profile_get_pass"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="895">Get the pass number if this is part of a multi-pass profile.</doc> + line="898">Get the pass number if this is part of a multi-pass profile.</doc> <source-position filename="gst-libs/gst/pbutils/encoding-profile.h" line="250"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="901">The pass number. Starts at 1 for multi-pass. 0 if this is + line="904">The pass number. Starts at 1 for multi-pass. 0 if this is not a multi-pass profile</doc> <type name="guint" c:type="guint"/> </return-value> @@ -3481,7 +3504,7 @@ not a multi-pass profile</doc> <instance-parameter name="prof" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="897">a #GstEncodingVideoProfile</doc> + line="900">a #GstEncodingVideoProfile</doc> <type name="EncodingVideoProfile" c:type="GstEncodingVideoProfile*"/> </instance-parameter> @@ -3489,19 +3512,23 @@ not a multi-pass profile</doc> </method> <method name="get_variableframerate" c:identifier="gst_encoding_video_profile_get_variableframerate"> + <doc xml:space="preserve" + filename="gst-libs/gst/pbutils/encoding-profile.c" + line="915">> *NOTE*: Fixed framerate won't be enforced when #encodebin:avoid-reencoding +> is set.</doc> <source-position filename="gst-libs/gst/pbutils/encoding-profile.h" line="253"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="916">Whether non-constant video framerate is allowed for encoding.</doc> + line="922">Whether non-constant video framerate is allowed for encoding.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="prof" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="914">a #GstEncodingVideoProfile</doc> + line="917">a #GstEncodingVideoProfile</doc> <type name="EncodingVideoProfile" c:type="GstEncodingVideoProfile*"/> </instance-parameter> @@ -3511,7 +3538,7 @@ not a multi-pass profile</doc> c:identifier="gst_encoding_video_profile_set_pass"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="927">Sets the pass number of this video profile. The first pass profile should have + line="933">Sets the pass number of this video profile. The first pass profile should have this value set to 1. If this video profile isn't part of a multi-pass profile, you may set it to 0 (the default value).</doc> <source-position filename="gst-libs/gst/pbutils/encoding-profile.h" @@ -3523,14 +3550,14 @@ you may set it to 0 (the default value).</doc> <instance-parameter name="prof" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="929">a #GstEncodingVideoProfile</doc> + line="935">a #GstEncodingVideoProfile</doc> <type name="EncodingVideoProfile" c:type="GstEncodingVideoProfile*"/> </instance-parameter> <parameter name="pass" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="930">the pass number for this profile</doc> + line="936">the pass number for this profile</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -3539,7 +3566,7 @@ you may set it to 0 (the default value).</doc> c:identifier="gst_encoding_video_profile_set_variableframerate"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="944">If set to %TRUE, then the incoming stream will be allowed to have non-constant + line="950">If set to %TRUE, then the incoming stream will be allowed to have non-constant framerate. If set to %FALSE (default value), then the incoming stream will be normalized by dropping/duplicating frames in order to produce a constance framerate.</doc> @@ -3552,14 +3579,14 @@ constance framerate.</doc> <instance-parameter name="prof" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="946">a #GstEncodingVideoProfile</doc> + line="952">a #GstEncodingVideoProfile</doc> <type name="EncodingVideoProfile" c:type="GstEncodingVideoProfile*"/> </instance-parameter> <parameter name="variableframerate" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-profile.c" - line="947">a boolean</doc> + line="953">a boolean</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -3748,15 +3775,26 @@ gst_install_plugins_context_free() when no longer needed</doc> c:type="GstInstallPluginsContext*"/> </return-value> </constructor> - <method name="copy" c:identifier="gst_install_plugins_context_copy"> + <method name="copy" + c:identifier="gst_install_plugins_context_copy" + version="1.12.1"> + <doc xml:space="preserve" + filename="gst-libs/gst/pbutils/install-plugins.c" + line="446">Copies a #GstInstallPluginsContext.</doc> <source-position filename="gst-libs/gst/pbutils/install-plugins.h" line="105"/> <return-value transfer-ownership="full"> + <doc xml:space="preserve" + filename="gst-libs/gst/pbutils/install-plugins.c" + line="452">A copy of @ctx</doc> <type name="InstallPluginsContext" c:type="GstInstallPluginsContext*"/> </return-value> <parameters> <instance-parameter name="ctx" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/pbutils/install-plugins.c" + line="448">a #GstInstallPluginsContext</doc> <type name="InstallPluginsContext" c:type="GstInstallPluginsContext*"/> </instance-parameter> @@ -4086,7 +4124,7 @@ program and to what extent the requested plugins could be installed.</doc> c:identifier="gst_install_plugins_return_get_name"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/install-plugins.c" - line="698">Convenience function to return the descriptive string associated + line="708">Convenience function to return the descriptive string associated with a status code. This function returns English strings and should not be used for user messages. It is here only to assist in debugging.</doc> @@ -4095,14 +4133,14 @@ in debugging.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/install-plugins.c" - line="707">a descriptive string for the status code in @ret</doc> + line="717">a descriptive string for the status code in @ret</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> <parameter name="ret" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/install-plugins.c" - line="700">the return status code</doc> + line="710">the return status code</doc> <type name="InstallPluginsReturn" c:type="GstInstallPluginsReturn"/> </parameter> @@ -4140,7 +4178,7 @@ in debugging.</doc> <type name="gint" c:type="gint"/> </constant> <constant name="PLUGINS_BASE_VERSION_MINOR" - value="17" + value="18" c:type="GST_PLUGINS_BASE_VERSION_MINOR"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/gstpluginsbaseversion.h" @@ -4400,7 +4438,7 @@ rate.</doc> c:identifier="gst_codec_utils_h264_caps_set_level_and_profile"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="772">Sets the level and profile in @caps if it can be determined from @sps. See + line="782">Sets the level and profile in @caps if it can be determined from @sps. See gst_codec_utils_h264_get_level() and gst_codec_utils_h264_get_profile() for more details on the parameters.</doc> <source-position filename="gst-libs/gst/pbutils/codec-utils.h" @@ -4408,20 +4446,20 @@ for more details on the parameters.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="782">%TRUE if the level and profile could be set, %FALSE otherwise.</doc> + line="792">%TRUE if the level and profile could be set, %FALSE otherwise.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <parameter name="caps" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="774">the #GstCaps to which the level and profile are to be added</doc> + line="784">the #GstCaps to which the level and profile are to be added</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> <parameter name="sps" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="775">Pointer to the sequence parameter set for the stream.</doc> + line="785">Pointer to the sequence parameter set for the stream.</doc> <array length="2" zero-terminated="0" c:type="const guint8*"> <type name="guint8" c:type="guint8"/> </array> @@ -4429,7 +4467,7 @@ for more details on the parameters.</doc> <parameter name="len" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="776">Length of the data available in @sps.</doc> + line="786">Length of the data available in @sps.</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -4470,20 +4508,20 @@ same format as for gst_codec_utils_h264_get_profile().</doc> c:identifier="gst_codec_utils_h264_get_level_idc"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="720">Transform a level string from the caps into the level_idc</doc> + line="724">Transform a level string from the caps into the level_idc</doc> <source-position filename="gst-libs/gst/pbutils/codec-utils.h" line="64"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="726">the level_idc or 0 if the level is unknown</doc> + line="730">the level_idc or 0 if the level is unknown</doc> <type name="guint8" c:type="guint8"/> </return-value> <parameters> <parameter name="level" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="722">A level string from caps</doc> + line="726">A level string from caps</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -4536,7 +4574,7 @@ byte. version="1.4"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1416">Sets the level, tier and profile in @caps if it can be determined from + line="1426">Sets the level, tier and profile in @caps if it can be determined from @profile_tier_level. See gst_codec_utils_h265_get_level(), gst_codec_utils_h265_get_tier() and gst_codec_utils_h265_get_profile() for more details on the parameters.</doc> @@ -4545,20 +4583,20 @@ for more details on the parameters.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1428">%TRUE if the level, tier, profile could be set, %FALSE otherwise.</doc> + line="1438">%TRUE if the level, tier, profile could be set, %FALSE otherwise.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <parameter name="caps" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1418">the #GstCaps to which the level, tier and profile are to be added</doc> + line="1428">the #GstCaps to which the level, tier and profile are to be added</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> <parameter name="profile_tier_level" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1419">Pointer to the profile_tier_level + line="1429">Pointer to the profile_tier_level struct</doc> <array length="2" zero-terminated="0" c:type="const guint8*"> <type name="guint8" c:type="guint8"/> @@ -4567,7 +4605,7 @@ for more details on the parameters.</doc> <parameter name="len" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1421">Length of the data available in @profile_tier_level.</doc> + line="1431">Length of the data available in @profile_tier_level.</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -4577,7 +4615,7 @@ for more details on the parameters.</doc> version="1.4"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1313">Converts the level indication (general_level_idc) in the stream's + line="1323">Converts the level indication (general_level_idc) in the stream's profile_tier_level structure into a string. The profiel_tier_level is expected to have the same format as for gst_codec_utils_h264_get_profile().</doc> <source-position filename="gst-libs/gst/pbutils/codec-utils.h" @@ -4585,14 +4623,14 @@ expected to have the same format as for gst_codec_utils_h264_get_profile().</doc <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1323">The level as a const string, or %NULL if there is an error.</doc> + line="1333">The level as a const string, or %NULL if there is an error.</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> <parameter name="profile_tier_level" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1315">Pointer to the profile_tier_level + line="1325">Pointer to the profile_tier_level for the stream</doc> <array length="1" zero-terminated="0" c:type="const guint8*"> <type name="guint8" c:type="guint8"/> @@ -4601,7 +4639,7 @@ expected to have the same format as for gst_codec_utils_h264_get_profile().</doc <parameter name="len" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1317">Length of the data available in @profile_tier_level.</doc> + line="1327">Length of the data available in @profile_tier_level.</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -4611,20 +4649,20 @@ expected to have the same format as for gst_codec_utils_h264_get_profile().</doc version="1.4"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1370">Transform a level string from the caps into the level_idc</doc> + line="1380">Transform a level string from the caps into the level_idc</doc> <source-position filename="gst-libs/gst/pbutils/codec-utils.h" line="86"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1376">the level_idc or 0 if the level is unknown</doc> + line="1386">the level_idc or 0 if the level is unknown</doc> <type name="guint8" c:type="guint8"/> </return-value> <parameters> <parameter name="level" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1372">A level string from caps</doc> + line="1382">A level string from caps</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -4634,7 +4672,7 @@ expected to have the same format as for gst_codec_utils_h264_get_profile().</doc version="1.4"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1097">Converts the profile indication (general_profile_idc) in the stream's + line="1107">Converts the profile indication (general_profile_idc) in the stream's profile_level_tier structure into a string. The profile_tier_level is expected to have the following format, as defined in the H.265 specification. The profile_tier_level is viewed as a bitstream here, @@ -4655,14 +4693,14 @@ with bit 0 being the most significant bit of the first byte. <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1120">The profile as a const string, or %NULL if there is an error.</doc> + line="1130">The profile as a const string, or %NULL if there is an error.</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> <parameter name="profile_tier_level" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1099">Pointer to the profile_tier_level + line="1109">Pointer to the profile_tier_level structure for the stream.</doc> <array length="1" zero-terminated="0" c:type="const guint8*"> <type name="guint8" c:type="guint8"/> @@ -4671,7 +4709,7 @@ with bit 0 being the most significant bit of the first byte. <parameter name="len" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1101">Length of the data available in @profile_tier_level</doc> + line="1111">Length of the data available in @profile_tier_level</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -4681,7 +4719,7 @@ with bit 0 being the most significant bit of the first byte. version="1.4"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1276">Converts the tier indication (general_tier_flag) in the stream's + line="1286">Converts the tier indication (general_tier_flag) in the stream's profile_tier_level structure into a string. The profile_tier_level is expected to have the same format as for gst_codec_utils_h264_get_profile().</doc> <source-position filename="gst-libs/gst/pbutils/codec-utils.h" @@ -4689,14 +4727,14 @@ is expected to have the same format as for gst_codec_utils_h264_get_profile().</ <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1286">The tier as a const string, or %NULL if there is an error.</doc> + line="1296">The tier as a const string, or %NULL if there is an error.</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> <parameter name="profile_tier_level" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1278">Pointer to the profile_tier_level + line="1288">Pointer to the profile_tier_level for the stream.</doc> <array length="1" zero-terminated="0" c:type="const guint8*"> <type name="guint8" c:type="guint8"/> @@ -4705,7 +4743,7 @@ is expected to have the same format as for gst_codec_utils_h264_get_profile().</ <parameter name="len" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1280">Length of the data available in @profile_tier_level.</doc> + line="1290">Length of the data available in @profile_tier_level.</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -4714,7 +4752,7 @@ is expected to have the same format as for gst_codec_utils_h264_get_profile().</ c:identifier="gst_codec_utils_mpeg4video_caps_set_level_and_profile"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1627">Sets the level and profile in @caps if it can be determined from + line="1637">Sets the level and profile in @caps if it can be determined from @vis_obj_seq. See gst_codec_utils_mpeg4video_get_level() and gst_codec_utils_mpeg4video_get_profile() for more details on the parameters.</doc> @@ -4723,20 +4761,20 @@ parameters.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1639">%TRUE if the level and profile could be set, %FALSE otherwise.</doc> + line="1649">%TRUE if the level and profile could be set, %FALSE otherwise.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <parameter name="caps" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1629">the #GstCaps to which the level and profile are to be added</doc> + line="1639">the #GstCaps to which the level and profile are to be added</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> <parameter name="vis_obj_seq" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1630">Pointer to the visual object + line="1640">Pointer to the visual object sequence for the stream.</doc> <array length="2" zero-terminated="0" c:type="const guint8*"> <type name="guint8" c:type="guint8"/> @@ -4745,7 +4783,7 @@ parameters.</doc> <parameter name="len" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1632">Length of the data available in @sps.</doc> + line="1642">Length of the data available in @sps.</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -4754,7 +4792,7 @@ parameters.</doc> c:identifier="gst_codec_utils_mpeg4video_get_level"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1535">Converts the level indication in the stream's visual object sequence into + line="1545">Converts the level indication in the stream's visual object sequence into a string. @vis_obj_seq is expected to be the data following the visual object sequence start code. Only the first byte (profile_and_level_indication) is used.</doc> @@ -4763,14 +4801,14 @@ object sequence start code. Only the first byte <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1546">The level as a const string, or NULL if there is an error.</doc> + line="1556">The level as a const string, or NULL if there is an error.</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> <parameter name="vis_obj_seq" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1537">Pointer to the visual object + line="1547">Pointer to the visual object sequence for the stream.</doc> <array length="1" zero-terminated="0" c:type="const guint8*"> <type name="guint8" c:type="guint8"/> @@ -4779,7 +4817,7 @@ object sequence start code. Only the first byte <parameter name="len" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1539">Length of the data available in @sps.</doc> + line="1549">Length of the data available in @sps.</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -4788,7 +4826,7 @@ object sequence start code. Only the first byte c:identifier="gst_codec_utils_mpeg4video_get_profile"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1462">Converts the profile indication in the stream's visual object sequence into + line="1472">Converts the profile indication in the stream's visual object sequence into a string. @vis_obj_seq is expected to be the data following the visual object sequence start code. Only the first byte (profile_and_level_indication) is used.</doc> @@ -4797,14 +4835,14 @@ object sequence start code. Only the first byte <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1473">The profile as a const string, or NULL if there is an error.</doc> + line="1483">The profile as a const string, or NULL if there is an error.</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> <parameter name="vis_obj_seq" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1464">Pointer to the visual object + line="1474">Pointer to the visual object sequence for the stream.</doc> <array length="1" zero-terminated="0" c:type="const guint8*"> <type name="guint8" c:type="guint8"/> @@ -4813,7 +4851,7 @@ object sequence start code. Only the first byte <parameter name="len" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1466">Length of the data available in @sps.</doc> + line="1476">Length of the data available in @sps.</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -4823,13 +4861,13 @@ object sequence start code. Only the first byte version="1.8"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1784">Creates Opus caps from the given parameters.</doc> + line="1794">Creates Opus caps from the given parameters.</doc> <source-position filename="gst-libs/gst/pbutils/codec-utils.h" line="117"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1795">The #GstCaps, or %NULL if the parameters would lead to + line="1805">The #GstCaps, or %NULL if the parameters would lead to invalid Opus caps.</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </return-value> @@ -4837,31 +4875,31 @@ invalid Opus caps.</doc> <parameter name="rate" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1786">the sample rate</doc> + line="1796">the sample rate</doc> <type name="guint32" c:type="guint32"/> </parameter> <parameter name="channels" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1787">the number of channels</doc> + line="1797">the number of channels</doc> <type name="guint8" c:type="guint8"/> </parameter> <parameter name="channel_mapping_family" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1788">the channel mapping family</doc> + line="1798">the channel mapping family</doc> <type name="guint8" c:type="guint8"/> </parameter> <parameter name="stream_count" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1789">the number of independent streams</doc> + line="1799">the number of independent streams</doc> <type name="guint8" c:type="guint8"/> </parameter> <parameter name="coupled_count" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1790">the number of stereo streams</doc> + line="1800">the number of stereo streams</doc> <type name="guint8" c:type="guint8"/> </parameter> <parameter name="channel_mapping" @@ -4870,7 +4908,7 @@ invalid Opus caps.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1791">the mapping between the streams</doc> + line="1801">the mapping between the streams</doc> <array zero-terminated="0" c:type="const guint8*"> <type name="guint8" c:type="guint8"/> </array> @@ -4882,21 +4920,21 @@ invalid Opus caps.</doc> version="1.8"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1953">Creates Opus caps from the given OpusHead @header and comment header + line="1963">Creates Opus caps from the given OpusHead @header and comment header @comments.</doc> <source-position filename="gst-libs/gst/pbutils/codec-utils.h" line="125"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1961">The #GstCaps.</doc> + line="1971">The #GstCaps.</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </return-value> <parameters> <parameter name="header" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1955">OpusHead header</doc> + line="1965">OpusHead header</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </parameter> <parameter name="comments" @@ -4905,7 +4943,7 @@ invalid Opus caps.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1956">Comment header or NULL</doc> + line="1966">Comment header or NULL</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </parameter> </parameters> @@ -4915,44 +4953,44 @@ invalid Opus caps.</doc> version="1.8"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="2008">Creates OpusHead header from the given parameters.</doc> + line="2018">Creates OpusHead header from the given parameters.</doc> <source-position filename="gst-libs/gst/pbutils/codec-utils.h" line="128"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="2021">The #GstBuffer containing the OpusHead.</doc> + line="2031">The #GstBuffer containing the OpusHead.</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </return-value> <parameters> <parameter name="rate" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="2010">the sample rate</doc> + line="2020">the sample rate</doc> <type name="guint32" c:type="guint32"/> </parameter> <parameter name="channels" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="2011">the number of channels</doc> + line="2021">the number of channels</doc> <type name="guint8" c:type="guint8"/> </parameter> <parameter name="channel_mapping_family" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="2012">the channel mapping family</doc> + line="2022">the channel mapping family</doc> <type name="guint8" c:type="guint8"/> </parameter> <parameter name="stream_count" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="2013">the number of independent streams</doc> + line="2023">the number of independent streams</doc> <type name="guint8" c:type="guint8"/> </parameter> <parameter name="coupled_count" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="2014">the number of stereo streams</doc> + line="2024">the number of stereo streams</doc> <type name="guint8" c:type="guint8"/> </parameter> <parameter name="channel_mapping" @@ -4961,7 +4999,7 @@ invalid Opus caps.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="2015">the mapping between the streams</doc> + line="2025">the mapping between the streams</doc> <array zero-terminated="0" c:type="const guint8*"> <type name="guint8" c:type="guint8"/> </array> @@ -4969,13 +5007,13 @@ invalid Opus caps.</doc> <parameter name="pre_skip" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="2016">Pre-skip in 48kHz samples or 0</doc> + line="2026">Pre-skip in 48kHz samples or 0</doc> <type name="guint16" c:type="guint16"/> </parameter> <parameter name="output_gain" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="2017">Output gain or 0</doc> + line="2027">Output gain or 0</doc> <type name="gint16" c:type="gint16"/> </parameter> </parameters> @@ -4985,20 +5023,20 @@ invalid Opus caps.</doc> version="1.8"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1667">Parses Opus caps and fills the different fields with defaults if possible.</doc> + line="1677">Parses Opus caps and fills the different fields with defaults if possible.</doc> <source-position filename="gst-libs/gst/pbutils/codec-utils.h" line="108"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1679">%TRUE if parsing was successful, %FALSE otherwise.</doc> + line="1689">%TRUE if parsing was successful, %FALSE otherwise.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <parameter name="caps" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1669">the #GstCaps to parse the data from</doc> + line="1679">the #GstCaps to parse the data from</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> <parameter name="rate" @@ -5007,7 +5045,7 @@ invalid Opus caps.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1670">the sample rate</doc> + line="1680">the sample rate</doc> <type name="guint32" c:type="guint32*"/> </parameter> <parameter name="channels" @@ -5016,7 +5054,7 @@ invalid Opus caps.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1671">the number of channels</doc> + line="1681">the number of channels</doc> <type name="guint8" c:type="guint8*"/> </parameter> <parameter name="channel_mapping_family" @@ -5025,7 +5063,7 @@ invalid Opus caps.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1672">the channel mapping family</doc> + line="1682">the channel mapping family</doc> <type name="guint8" c:type="guint8*"/> </parameter> <parameter name="stream_count" @@ -5034,7 +5072,7 @@ invalid Opus caps.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1673">the number of independent streams</doc> + line="1683">the number of independent streams</doc> <type name="guint8" c:type="guint8*"/> </parameter> <parameter name="coupled_count" @@ -5043,7 +5081,7 @@ invalid Opus caps.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1674">the number of stereo streams</doc> + line="1684">the number of stereo streams</doc> <type name="guint8" c:type="guint8*"/> </parameter> <parameter name="channel_mapping" @@ -5052,7 +5090,7 @@ invalid Opus caps.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="1675">the mapping between the streams</doc> + line="1685">the mapping between the streams</doc> <array zero-terminated="0" c:type="guint8*" fixed-size="256"> <type name="guint8" c:type="guint8"/> </array> @@ -5064,20 +5102,20 @@ invalid Opus caps.</doc> version="1.8"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="2089">Parses the OpusHead header.</doc> + line="2099">Parses the OpusHead header.</doc> <source-position filename="gst-libs/gst/pbutils/codec-utils.h" line="138"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="2103">%TRUE if parsing was successful, %FALSE otherwise.</doc> + line="2113">%TRUE if parsing was successful, %FALSE otherwise.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <parameter name="header" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="2091">the OpusHead #GstBuffer</doc> + line="2101">the OpusHead #GstBuffer</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </parameter> <parameter name="rate" @@ -5086,7 +5124,7 @@ invalid Opus caps.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="2092">the sample rate</doc> + line="2102">the sample rate</doc> <type name="guint32" c:type="guint32*"/> </parameter> <parameter name="channels" @@ -5095,7 +5133,7 @@ invalid Opus caps.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="2093">the number of channels</doc> + line="2103">the number of channels</doc> <type name="guint8" c:type="guint8*"/> </parameter> <parameter name="channel_mapping_family" @@ -5104,7 +5142,7 @@ invalid Opus caps.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="2094">the channel mapping family</doc> + line="2104">the channel mapping family</doc> <type name="guint8" c:type="guint8*"/> </parameter> <parameter name="stream_count" @@ -5113,7 +5151,7 @@ invalid Opus caps.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="2095">the number of independent streams</doc> + line="2105">the number of independent streams</doc> <type name="guint8" c:type="guint8*"/> </parameter> <parameter name="coupled_count" @@ -5122,7 +5160,7 @@ invalid Opus caps.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="2096">the number of stereo streams</doc> + line="2106">the number of stereo streams</doc> <type name="guint8" c:type="guint8*"/> </parameter> <parameter name="channel_mapping" @@ -5131,7 +5169,7 @@ invalid Opus caps.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="2097">the mapping between the streams</doc> + line="2107">the mapping between the streams</doc> <array zero-terminated="0" c:type="guint8*" fixed-size="256"> <type name="guint8" c:type="guint8"/> </array> @@ -5142,7 +5180,7 @@ invalid Opus caps.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="2098">Pre-skip in 48kHz samples or 0</doc> + line="2108">Pre-skip in 48kHz samples or 0</doc> <type name="guint16" c:type="guint16*"/> </parameter> <parameter name="output_gain" @@ -5151,7 +5189,7 @@ invalid Opus caps.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/codec-utils.c" - line="2099">Output gain or 0</doc> + line="2109">Output gain or 0</doc> <type name="gint16" c:type="gint16*"/> </parameter> </parameters> @@ -5224,14 +5262,14 @@ invalid Opus caps.</doc> c:identifier="gst_encoding_list_all_targets"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="1241">List all available #GstEncodingTarget for the specified category, or all categories + line="1260">List all available #GstEncodingTarget for the specified category, or all categories if @categoryname is %NULL.</doc> <source-position filename="gst-libs/gst/pbutils/encoding-target.h" - line="172"/> + line="175"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="1249">The list of #GstEncodingTarget</doc> + line="1268">The list of #GstEncodingTarget</doc> <type name="GLib.List" c:type="GList*"> <type name="EncodingTarget"/> </type> @@ -5243,7 +5281,7 @@ if @categoryname is %NULL.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="1243">The category, for ex: #GST_ENCODING_CATEGORY_DEVICE. + line="1262">The category, for ex: #GST_ENCODING_CATEGORY_DEVICE. Can be %NULL.</doc> <type name="utf8" c:type="const gchar*"/> </parameter> @@ -5253,13 +5291,13 @@ Can be %NULL.</doc> c:identifier="gst_encoding_list_available_categories"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="1108">Lists all #GstEncodingTarget categories present on disk.</doc> + line="1127">Lists all #GstEncodingTarget categories present on disk.</doc> <source-position filename="gst-libs/gst/pbutils/encoding-target.h" - line="169"/> + line="172"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/encoding-target.c" - line="1113">A list + line="1132">A list of #GstEncodingTarget categories.</doc> <type name="GLib.List" c:type="GList*"> <type name="utf8"/> @@ -5334,7 +5372,7 @@ of #GstEncodingTarget categories.</doc> c:identifier="gst_install_plugins_async"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/install-plugins.c" - line="600">Requests plugin installation without blocking. Once the plugins have been + line="610">Requests plugin installation without blocking. Once the plugins have been installed or installation has failed, @func will be called with the result of the installation and your provided @user_data pointer. @@ -5355,14 +5393,14 @@ installed but no suitable video decoder and no suitable audio decoder).</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/install-plugins.c" - line="625">result code whether an external installer could be started</doc> + line="635">result code whether an external installer could be started</doc> <type name="InstallPluginsReturn" c:type="GstInstallPluginsReturn"/> </return-value> <parameters> <parameter name="details" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/install-plugins.c" - line="602">NULL-terminated array + line="612">NULL-terminated array of installer string details (see below)</doc> <array c:type="const gchar* const*"> <type name="utf8" c:type="gchar*"/> @@ -5374,7 +5412,7 @@ installed but no suitable video decoder and no suitable audio decoder).</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/install-plugins.c" - line="604">a #GstInstallPluginsContext, or NULL</doc> + line="614">a #GstInstallPluginsContext, or NULL</doc> <type name="InstallPluginsContext" c:type="GstInstallPluginsContext*"/> </parameter> @@ -5384,7 +5422,7 @@ installed but no suitable video decoder and no suitable audio decoder).</doc> closure="3"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/install-plugins.c" - line="605">the function to call when the installer program returns</doc> + line="615">the function to call when the installer program returns</doc> <type name="InstallPluginsResultFunc" c:type="GstInstallPluginsResultFunc"/> </parameter> @@ -5394,7 +5432,7 @@ installed but no suitable video decoder and no suitable audio decoder).</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/install-plugins.c" - line="606">the user data to pass to @func when called, or NULL</doc> + line="616">the user data to pass to @func when called, or NULL</doc> <type name="gpointer" c:type="gpointer"/> </parameter> </parameters> @@ -5403,14 +5441,14 @@ installed but no suitable video decoder and no suitable audio decoder).</doc> c:identifier="gst_install_plugins_installation_in_progress"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/install-plugins.c" - line="741">Checks whether plugin installation (initiated by this application only) + line="751">Checks whether plugin installation (initiated by this application only) is currently in progress.</doc> <source-position filename="gst-libs/gst/pbutils/install-plugins.h" line="154"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/install-plugins.c" - line="747">TRUE if plugin installation is in progress, otherwise FALSE</doc> + line="757">TRUE if plugin installation is in progress, otherwise FALSE</doc> <type name="gboolean" c:type="gboolean"/> </return-value> </function> @@ -5419,7 +5457,7 @@ is currently in progress.</doc> moved-to="InstallPluginsReturn.get_name"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/install-plugins.c" - line="698">Convenience function to return the descriptive string associated + line="708">Convenience function to return the descriptive string associated with a status code. This function returns English strings and should not be used for user messages. It is here only to assist in debugging.</doc> @@ -5428,14 +5466,14 @@ in debugging.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/install-plugins.c" - line="707">a descriptive string for the status code in @ret</doc> + line="717">a descriptive string for the status code in @ret</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> <parameter name="ret" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/install-plugins.c" - line="700">the return status code</doc> + line="710">the return status code</doc> <type name="InstallPluginsReturn" c:type="GstInstallPluginsReturn"/> </parameter> </parameters> @@ -5444,7 +5482,7 @@ in debugging.</doc> c:identifier="gst_install_plugins_supported"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/install-plugins.c" - line="755">Checks whether plugin installation is likely to be supported by the + line="765">Checks whether plugin installation is likely to be supported by the current environment. This currently only checks whether the helper script that is to be provided by the distribution or operating system vendor exists.</doc> @@ -5453,7 +5491,7 @@ exists.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/install-plugins.c" - line="763">TRUE if plugin installation is likely to be supported.</doc> + line="773">TRUE if plugin installation is likely to be supported.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> </function> @@ -5461,7 +5499,7 @@ exists.</doc> c:identifier="gst_install_plugins_sync"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/install-plugins.c" - line="659">Requests plugin installation and block until the plugins have been + line="669">Requests plugin installation and block until the plugins have been installed or installation has failed. This function should almost never be used, it only exists for cases where @@ -5474,14 +5512,14 @@ gst_install_plugins_async() instead of this function.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/install-plugins.c" - line="674">the result of the installation.</doc> + line="684">the result of the installation.</doc> <type name="InstallPluginsReturn" c:type="GstInstallPluginsReturn"/> </return-value> <parameters> <parameter name="details" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/install-plugins.c" - line="661">NULL-terminated array + line="671">NULL-terminated array of installer string details</doc> <array c:type="const gchar* const*"> <type name="utf8" c:type="gchar*"/> @@ -5493,7 +5531,7 @@ gst_install_plugins_async() instead of this function.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/pbutils/install-plugins.c" - line="663">a #GstInstallPluginsContext, or NULL</doc> + line="673">a #GstInstallPluginsContext, or NULL</doc> <type name="InstallPluginsContext" c:type="GstInstallPluginsContext*"/> </parameter> diff --git a/girs/GstRtp-1.0.gir b/girs/GstRtp-1.0.gir index f6f004ca3b..bc4da95969 100644 --- a/girs/GstRtp-1.0.gir +++ b/girs/GstRtp-1.0.gir @@ -596,10 +596,11 @@ The size of the structure is made public to allow stack allocations.</doc> <type name="guint" c:type="guint"/> </field> <method name="add_profile_specific_ext" - c:identifier="gst_rtcp_packet_add_profile_specific_ext"> + c:identifier="gst_rtcp_packet_add_profile_specific_ext" + version="1.10"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1060">Add profile-specific extension @data to @packet. If @packet already + line="1068">Add profile-specific extension @data to @packet. If @packet already contains profile-specific extension @data will be appended to the existing extension.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" @@ -607,20 +608,20 @@ extension.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1070">%TRUE if the profile specific extension data was added.</doc> + line="1078">%TRUE if the profile specific extension data was added.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1062">a valid SR or RR #GstRTCPPacket</doc> + line="1070">a valid SR or RR #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="data" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1063">profile-specific data</doc> + line="1071">profile-specific data</doc> <array length="1" zero-terminated="0" c:type="const guint8*"> <type name="guint8" c:type="guint8"/> </array> @@ -628,7 +629,7 @@ extension.</doc> <parameter name="len" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1064">length of the profile-specific data in bytes</doc> + line="1072">length of the profile-specific data in bytes</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -636,13 +637,13 @@ extension.</doc> <method name="add_rb" c:identifier="gst_rtcp_packet_add_rb"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="943">Add a new report block to @packet with the given values.</doc> + line="951">Add a new report block to @packet with the given values.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="353"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="956">%TRUE if the packet was created. This function can return %FALSE if + line="964">%TRUE if the packet was created. This function can return %FALSE if the max MTU is exceeded or the number of report blocks is greater than #GST_RTCP_MAX_RB_COUNT.</doc> <type name="gboolean" c:type="gboolean"/> @@ -651,49 +652,49 @@ the max MTU is exceeded or the number of report blocks is greater than <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="945">a valid SR or RR #GstRTCPPacket</doc> + line="953">a valid SR or RR #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="ssrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="946">data source being reported</doc> + line="954">data source being reported</doc> <type name="guint32" c:type="guint32"/> </parameter> <parameter name="fractionlost" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="947">fraction lost since last SR/RR</doc> + line="955">fraction lost since last SR/RR</doc> <type name="guint8" c:type="guint8"/> </parameter> <parameter name="packetslost" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="948">the cumululative number of packets lost</doc> + line="956">the cumululative number of packets lost</doc> <type name="gint32" c:type="gint32"/> </parameter> <parameter name="exthighestseq" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="949">the extended last sequence number received</doc> + line="957">the extended last sequence number received</doc> <type name="guint32" c:type="guint32"/> </parameter> <parameter name="jitter" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="950">the interarrival jitter</doc> + line="958">the interarrival jitter</doc> <type name="guint32" c:type="guint32"/> </parameter> <parameter name="lsr" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="951">the last SR packet from this source</doc> + line="959">the last SR packet from this source</doc> <type name="guint32" c:type="guint32"/> </parameter> <parameter name="dlsr" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="952">the delay since last SR packet</doc> + line="960">the delay since last SR packet</doc> <type name="guint32" c:type="guint32"/> </parameter> </parameters> @@ -703,20 +704,20 @@ the max MTU is exceeded or the number of report blocks is greater than version="1.10"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2531">Get the application-dependent data attached to a RTPFB or PSFB @packet.</doc> + line="2547">Get the application-dependent data attached to a RTPFB or PSFB @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="468"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2537">A pointer to the data</doc> + line="2553">A pointer to the data</doc> <type name="guint8" c:type="guint8*"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2533">a valid APP #GstRTCPPacket</doc> + line="2549">a valid APP #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -726,21 +727,21 @@ the max MTU is exceeded or the number of report blocks is greater than version="1.10"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2470">Get the length of the application-dependent data attached to an APP + line="2486">Get the length of the application-dependent data attached to an APP @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="462"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2477">The length of data in 32-bit words.</doc> + line="2493">The length of data in 32-bit words.</doc> <type name="guint16" c:type="guint16"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2472">a valid APP #GstRTCPPacket</doc> + line="2488">a valid APP #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -750,20 +751,20 @@ the max MTU is exceeded or the number of report blocks is greater than version="1.10"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2449">Get the name field of the APP @packet.</doc> + line="2465">Get the name field of the APP @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="459"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2455">The 4-byte name field, not zero-terminated.</doc> + line="2471">The 4-byte name field, not zero-terminated.</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2451">a valid APP #GstRTCPPacket</doc> + line="2467">a valid APP #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -773,20 +774,20 @@ the max MTU is exceeded or the number of report blocks is greater than version="1.10"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2401">Get the SSRC/CSRC field of the APP @packet.</doc> + line="2417">Get the SSRC/CSRC field of the APP @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="453"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2407">The SSRC/CSRC.</doc> + line="2423">The SSRC/CSRC.</doc> <type name="guint32" c:type="guint32"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2403">a valid APP #GstRTCPPacket</doc> + line="2419">a valid APP #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -796,20 +797,20 @@ the max MTU is exceeded or the number of report blocks is greater than version="1.10"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2353">Get the subtype field of the APP @packet.</doc> + line="2369">Get the subtype field of the APP @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="447"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2359">The subtype.</doc> + line="2375">The subtype.</doc> <type name="guint8" c:type="guint8"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2355">a valid APP #GstRTCPPacket</doc> + line="2371">a valid APP #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -819,14 +820,14 @@ the max MTU is exceeded or the number of report blocks is greater than version="1.10"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2496">Set the length of the application-dependent data attached to an APP + line="2512">Set the length of the application-dependent data attached to an APP @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="465"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2504">%TRUE if there was enough space in the packet to add this much + line="2520">%TRUE if there was enough space in the packet to add this much data.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -834,13 +835,13 @@ data.</doc> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2498">a valid APP #GstRTCPPacket</doc> + line="2514">a valid APP #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="wordlen" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2499">Length of the data in 32-bit words</doc> + line="2515">Length of the data in 32-bit words</doc> <type name="guint16" c:type="guint16"/> </parameter> </parameters> @@ -850,7 +851,7 @@ data.</doc> version="1.10"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2426">Set the name field of the APP @packet.</doc> + line="2442">Set the name field of the APP @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="456"/> <return-value transfer-ownership="none"> @@ -860,13 +861,13 @@ data.</doc> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2428">a valid APP #GstRTCPPacket</doc> + line="2444">a valid APP #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2429">4-byte ASCII name</doc> + line="2445">4-byte ASCII name</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -876,7 +877,7 @@ data.</doc> version="1.10"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2378">Set the SSRC/CSRC field of the APP @packet.</doc> + line="2394">Set the SSRC/CSRC field of the APP @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="450"/> <return-value transfer-ownership="none"> @@ -886,13 +887,13 @@ data.</doc> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2380">a valid APP #GstRTCPPacket</doc> + line="2396">a valid APP #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="ssrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2381">SSRC/CSRC of the packet</doc> + line="2397">SSRC/CSRC of the packet</doc> <type name="guint32" c:type="guint32"/> </parameter> </parameters> @@ -902,7 +903,7 @@ data.</doc> version="1.10"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2330">Set the subtype field of the APP @packet.</doc> + line="2346">Set the subtype field of the APP @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="444"/> <return-value transfer-ownership="none"> @@ -912,13 +913,13 @@ data.</doc> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2332">a valid APP #GstRTCPPacket</doc> + line="2348">a valid APP #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="subtype" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2333">subtype of the packet</doc> + line="2349">subtype of the packet</doc> <type name="guint8" c:type="guint8"/> </parameter> </parameters> @@ -926,13 +927,13 @@ data.</doc> <method name="bye_add_ssrc" c:identifier="gst_rtcp_packet_bye_add_ssrc"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1701">Add @ssrc to the BYE @packet.</doc> + line="1717">Add @ssrc to the BYE @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="427"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1708">%TRUE if the ssrc was added. This function can return %FALSE if + line="1724">%TRUE if the ssrc was added. This function can return %FALSE if the max MTU is exceeded or the number of sources blocks is greater than #GST_RTCP_MAX_BYE_SSRC_COUNT.</doc> <type name="gboolean" c:type="gboolean"/> @@ -941,13 +942,13 @@ the max MTU is exceeded or the number of sources blocks is greater than <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1703">a valid BYE #GstRTCPPacket</doc> + line="1719">a valid BYE #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="ssrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1704">an SSRC to add</doc> + line="1720">an SSRC to add</doc> <type name="guint32" c:type="guint32"/> </parameter> </parameters> @@ -956,13 +957,13 @@ the max MTU is exceeded or the number of sources blocks is greater than c:identifier="gst_rtcp_packet_bye_add_ssrcs"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1761">Adds @len SSRCs in @ssrc to BYE @packet.</doc> + line="1777">Adds @len SSRCs in @ssrc to BYE @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="430"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1769">%TRUE if the all the SSRCs were added. This function can return %FALSE if + line="1785">%TRUE if the all the SSRCs were added. This function can return %FALSE if the max MTU is exceeded or the number of sources blocks is greater than #GST_RTCP_MAX_BYE_SSRC_COUNT.</doc> <type name="gboolean" c:type="gboolean"/> @@ -971,13 +972,13 @@ the max MTU is exceeded or the number of sources blocks is greater than <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1763">a valid BYE #GstRTCPPacket</doc> + line="1779">a valid BYE #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="ssrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1764">an array of SSRCs to add</doc> + line="1780">an array of SSRCs to add</doc> <array length="1" zero-terminated="0" c:type="guint32*"> <type name="guint32" c:type="guint32"/> </array> @@ -985,7 +986,7 @@ the max MTU is exceeded or the number of sources blocks is greater than <parameter name="len" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1765">number of elements in @ssrc</doc> + line="1781">number of elements in @ssrc</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -994,26 +995,26 @@ the max MTU is exceeded or the number of sources blocks is greater than c:identifier="gst_rtcp_packet_bye_get_nth_ssrc"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1657">Get the @nth SSRC of the BYE @packet.</doc> + line="1673">Get the @nth SSRC of the BYE @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="424"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1664">The @nth SSRC of @packet.</doc> + line="1680">The @nth SSRC of @packet.</doc> <type name="guint32" c:type="guint32"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1659">a valid BYE #GstRTCPPacket</doc> + line="1675">a valid BYE #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="nth" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1660">the nth SSRC to get</doc> + line="1676">the nth SSRC to get</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -1022,13 +1023,13 @@ the max MTU is exceeded or the number of sources blocks is greater than c:identifier="gst_rtcp_packet_bye_get_reason"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1845">Get the reason in @packet.</doc> + line="1861">Get the reason in @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="436"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1851">The reason for the BYE @packet or NULL if the packet did not contain + line="1867">The reason for the BYE @packet or NULL if the packet did not contain a reason string. The string must be freed with g_free() after usage.</doc> <type name="utf8" c:type="gchar*"/> </return-value> @@ -1036,7 +1037,7 @@ a reason string. The string must be freed with g_free() after usage.</doc> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1847">a valid BYE #GstRTCPPacket</doc> + line="1863">a valid BYE #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -1045,13 +1046,13 @@ a reason string. The string must be freed with g_free() after usage.</doc> c:identifier="gst_rtcp_packet_bye_get_reason_len"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1816">Get the length of the reason string.</doc> + line="1832">Get the length of the reason string.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="433"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1822">The length of the reason string or 0 when there is no reason string + line="1838">The length of the reason string or 0 when there is no reason string present.</doc> <type name="guint8" c:type="guint8"/> </return-value> @@ -1059,7 +1060,7 @@ present.</doc> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1818">a valid BYE #GstRTCPPacket</doc> + line="1834">a valid BYE #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -1068,20 +1069,20 @@ present.</doc> c:identifier="gst_rtcp_packet_bye_get_ssrc_count"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1640">Get the number of SSRC fields in @packet.</doc> + line="1656">Get the number of SSRC fields in @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="421"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1646">The number of SSRC fields in @packet.</doc> + line="1662">The number of SSRC fields in @packet.</doc> <type name="guint" c:type="guint"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1642">a valid BYE #GstRTCPPacket</doc> + line="1658">a valid BYE #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -1090,49 +1091,50 @@ present.</doc> c:identifier="gst_rtcp_packet_bye_set_reason"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1887">Set the reason string to @reason in @packet.</doc> + line="1903">Set the reason string to @reason in @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="439"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1894">TRUE if the string could be set.</doc> + line="1910">TRUE if the string could be set.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1889">a valid BYE #GstRTCPPacket</doc> + line="1905">a valid BYE #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="reason" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1890">a reason string</doc> + line="1906">a reason string</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> </method> <method name="copy_profile_specific_ext" - c:identifier="gst_rtcp_packet_copy_profile_specific_ext"> + c:identifier="gst_rtcp_packet_copy_profile_specific_ext" + version="1.10"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1170">The profile-specific extension data is copied into a new allocated + line="1184">The profile-specific extension data is copied into a new allocated memory area @data. This must be freed with g_free() after usage.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="378"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1179">%TRUE if there was valid data.</doc> + line="1193">%TRUE if there was valid data.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1172">a valid SR or RR #GstRTCPPacket</doc> + line="1186">a valid SR or RR #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="data" @@ -1141,7 +1143,7 @@ memory area @data. This must be freed with g_free() after usage.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1173">result profile-specific data</doc> + line="1187">result profile-specific data</doc> <array length="1" zero-terminated="0" c:type="guint8**"> <type name="guint8" c:type="guint8*"/> </array> @@ -1152,7 +1154,7 @@ memory area @data. This must be freed with g_free() after usage.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1174">length of the profile-specific extension data</doc> + line="1188">length of the profile-specific extension data</doc> <type name="guint" c:type="guint*"/> </parameter> </parameters> @@ -1160,20 +1162,20 @@ memory area @data. This must be freed with g_free() after usage.</doc> <method name="fb_get_fci" c:identifier="gst_rtcp_packet_fb_get_fci"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2303">Get the Feedback Control Information attached to a RTPFB or PSFB @packet.</doc> + line="2319">Get the Feedback Control Information attached to a RTPFB or PSFB @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="497"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2309">a pointer to the FCI</doc> + line="2325">a pointer to the FCI</doc> <type name="guint8" c:type="guint8*"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2305">a valid RTPFB or PSFB #GstRTCPPacket</doc> + line="2321">a valid RTPFB or PSFB #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -1182,21 +1184,21 @@ memory area @data. This must be freed with g_free() after usage.</doc> c:identifier="gst_rtcp_packet_fb_get_fci_length"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2245">Get the length of the Feedback Control Information attached to a + line="2261">Get the length of the Feedback Control Information attached to a RTPFB or PSFB @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="491"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2252">The length of the FCI in 32-bit words.</doc> + line="2268">The length of the FCI in 32-bit words.</doc> <type name="guint16" c:type="guint16"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2247">a valid RTPFB or PSFB #GstRTCPPacket</doc> + line="2263">a valid RTPFB or PSFB #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -1205,20 +1207,20 @@ RTPFB or PSFB @packet.</doc> c:identifier="gst_rtcp_packet_fb_get_media_ssrc"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2007">Get the media SSRC field of the RTPFB or PSFB @packet.</doc> + line="2023">Get the media SSRC field of the RTPFB or PSFB @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="479"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2013">the media SSRC.</doc> + line="2029">the media SSRC.</doc> <type name="guint32" c:type="guint32"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2009">a valid RTPFB or PSFB #GstRTCPPacket</doc> + line="2025">a valid RTPFB or PSFB #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -1227,20 +1229,20 @@ RTPFB or PSFB @packet.</doc> c:identifier="gst_rtcp_packet_fb_get_sender_ssrc"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1953">Get the sender SSRC field of the RTPFB or PSFB @packet.</doc> + line="1969">Get the sender SSRC field of the RTPFB or PSFB @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="473"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1959">the sender SSRC.</doc> + line="1975">the sender SSRC.</doc> <type name="guint32" c:type="guint32"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1955">a valid RTPFB or PSFB #GstRTCPPacket</doc> + line="1971">a valid RTPFB or PSFB #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -1248,20 +1250,20 @@ RTPFB or PSFB @packet.</doc> <method name="fb_get_type" c:identifier="gst_rtcp_packet_fb_get_type"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2061">Get the feedback message type of the FB @packet.</doc> + line="2077">Get the feedback message type of the FB @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="485"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2067">The feedback message type.</doc> + line="2083">The feedback message type.</doc> <type name="RTCPFBType" c:type="GstRTCPFBType"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2063">a valid RTPFB or PSFB #GstRTCPPacket</doc> + line="2079">a valid RTPFB or PSFB #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -1270,27 +1272,27 @@ RTPFB or PSFB @packet.</doc> c:identifier="gst_rtcp_packet_fb_set_fci_length"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2270">Set the length of the Feedback Control Information attached to a + line="2286">Set the length of the Feedback Control Information attached to a RTPFB or PSFB @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="494"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2278">%TRUE if there was enough space in the packet to add this much FCI</doc> + line="2294">%TRUE if there was enough space in the packet to add this much FCI</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2272">a valid RTPFB or PSFB #GstRTCPPacket</doc> + line="2288">a valid RTPFB or PSFB #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="wordlen" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2273">Length of the FCI in 32-bit words</doc> + line="2289">Length of the FCI in 32-bit words</doc> <type name="guint16" c:type="guint16"/> </parameter> </parameters> @@ -1299,7 +1301,7 @@ RTPFB or PSFB @packet.</doc> c:identifier="gst_rtcp_packet_fb_set_media_ssrc"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2036">Set the media SSRC field of the RTPFB or PSFB @packet.</doc> + line="2052">Set the media SSRC field of the RTPFB or PSFB @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="482"/> <return-value transfer-ownership="none"> @@ -1309,13 +1311,13 @@ RTPFB or PSFB @packet.</doc> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2038">a valid RTPFB or PSFB #GstRTCPPacket</doc> + line="2054">a valid RTPFB or PSFB #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="ssrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2039">a media SSRC</doc> + line="2055">a media SSRC</doc> <type name="guint32" c:type="guint32"/> </parameter> </parameters> @@ -1324,7 +1326,7 @@ RTPFB or PSFB @packet.</doc> c:identifier="gst_rtcp_packet_fb_set_sender_ssrc"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1982">Set the sender SSRC field of the RTPFB or PSFB @packet.</doc> + line="1998">Set the sender SSRC field of the RTPFB or PSFB @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="476"/> <return-value transfer-ownership="none"> @@ -1334,13 +1336,13 @@ RTPFB or PSFB @packet.</doc> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1984">a valid RTPFB or PSFB #GstRTCPPacket</doc> + line="2000">a valid RTPFB or PSFB #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="ssrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1985">a sender SSRC</doc> + line="2001">a sender SSRC</doc> <type name="guint32" c:type="guint32"/> </parameter> </parameters> @@ -1348,7 +1350,7 @@ RTPFB or PSFB @packet.</doc> <method name="fb_set_type" c:identifier="gst_rtcp_packet_fb_set_type"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2079">Set the feedback message type of the FB @packet.</doc> + line="2095">Set the feedback message type of the FB @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="488"/> <return-value transfer-ownership="none"> @@ -1358,13 +1360,13 @@ RTPFB or PSFB @packet.</doc> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2081">a valid RTPFB or PSFB #GstRTCPPacket</doc> + line="2097">a valid RTPFB or PSFB #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="type" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2082">the #GstRTCPFBType to set</doc> + line="2098">the #GstRTCPFBType to set</doc> <type name="RTCPFBType" c:type="GstRTCPFBType"/> </parameter> </parameters> @@ -1372,13 +1374,13 @@ RTPFB or PSFB @packet.</doc> <method name="get_count" c:identifier="gst_rtcp_packet_get_count"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="672">Get the count field in @packet.</doc> + line="680">Get the count field in @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="312"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="678">The count field in @packet or -1 if @packet does not point to a + line="686">The count field in @packet or -1 if @packet does not point to a valid packet.</doc> <type name="guint8" c:type="guint8"/> </return-value> @@ -1386,7 +1388,7 @@ valid packet.</doc> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="674">a valid #GstRTCPPacket</doc> + line="682">a valid #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -1394,21 +1396,21 @@ valid packet.</doc> <method name="get_length" c:identifier="gst_rtcp_packet_get_length"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="690">Get the length field of @packet. This is the length of the packet in + line="698">Get the length field of @packet. This is the length of the packet in 32-bit words minus one.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="318"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="697">The length field of @packet.</doc> + line="705">The length field of @packet.</doc> <type name="guint16" c:type="guint16"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="692">a valid #GstRTCPPacket</doc> + line="700">a valid #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -1416,39 +1418,40 @@ valid packet.</doc> <method name="get_padding" c:identifier="gst_rtcp_packet_get_padding"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="638">Get the packet padding of the packet pointed to by @packet.</doc> + line="646">Get the packet padding of the packet pointed to by @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="309"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="644">If the packet has the padding bit set.</doc> + line="652">If the packet has the padding bit set.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="640">a valid #GstRTCPPacket</doc> + line="648">a valid #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> </method> <method name="get_profile_specific_ext" - c:identifier="gst_rtcp_packet_get_profile_specific_ext"> + c:identifier="gst_rtcp_packet_get_profile_specific_ext" + version="1.10"> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="374"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1140">%TRUE if there was valid data.</doc> + line="1152">%TRUE if there was valid data.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1136">a valid SR or RR #GstRTCPPacket</doc> + line="1148">a valid SR or RR #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="data" @@ -1457,7 +1460,7 @@ valid packet.</doc> transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1137">result profile-specific data</doc> + line="1149">result profile-specific data</doc> <array length="1" zero-terminated="0" c:type="guint8**"> <type name="guint8" c:type="guint8*"/> </array> @@ -1468,19 +1471,20 @@ valid packet.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1138">result length of the profile-specific data</doc> + line="1150">result length of the profile-specific data</doc> <type name="guint" c:type="guint*"/> </parameter> </parameters> </method> <method name="get_profile_specific_ext_length" - c:identifier="gst_rtcp_packet_get_profile_specific_ext_length"> + c:identifier="gst_rtcp_packet_get_profile_specific_ext_length" + version="1.10"> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="371"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1109">The number of 32-bit words containing profile-specific extension + line="1119">The number of 32-bit words containing profile-specific extension data from @packet.</doc> <type name="guint16" c:type="guint16"/> </return-value> @@ -1488,7 +1492,7 @@ valid packet.</doc> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1107">a valid SR or RR #GstRTCPPacket</doc> + line="1117">a valid SR or RR #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -1496,7 +1500,7 @@ valid packet.</doc> <method name="get_rb" c:identifier="gst_rtcp_packet_get_rb"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="860">Parse the values of the @nth report block in @packet and store the result in + line="868">Parse the values of the @nth report block in @packet and store the result in the values.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="347"/> @@ -1507,13 +1511,13 @@ the values.</doc> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="862">a valid SR or RR #GstRTCPPacket</doc> + line="870">a valid SR or RR #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="nth" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="863">the nth report block in @packet</doc> + line="871">the nth report block in @packet</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="ssrc" @@ -1522,7 +1526,7 @@ the values.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="864">result for data source being reported</doc> + line="872">result for data source being reported</doc> <type name="guint32" c:type="guint32*"/> </parameter> <parameter name="fractionlost" @@ -1531,7 +1535,7 @@ the values.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="865">result for fraction lost since last SR/RR</doc> + line="873">result for fraction lost since last SR/RR</doc> <type name="guint8" c:type="guint8*"/> </parameter> <parameter name="packetslost" @@ -1540,7 +1544,7 @@ the values.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="866">result for the cumululative number of packets lost</doc> + line="874">result for the cumululative number of packets lost</doc> <type name="gint32" c:type="gint32*"/> </parameter> <parameter name="exthighestseq" @@ -1549,7 +1553,7 @@ the values.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="867">result for the extended last sequence number received</doc> + line="875">result for the extended last sequence number received</doc> <type name="guint32" c:type="guint32*"/> </parameter> <parameter name="jitter" @@ -1558,7 +1562,7 @@ the values.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="868">result for the interarrival jitter</doc> + line="876">result for the interarrival jitter</doc> <type name="guint32" c:type="guint32*"/> </parameter> <parameter name="lsr" @@ -1567,7 +1571,7 @@ the values.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="869">result for the last SR packet from this source</doc> + line="877">result for the last SR packet from this source</doc> <type name="guint32" c:type="guint32*"/> </parameter> <parameter name="dlsr" @@ -1576,7 +1580,7 @@ the values.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="870">result for the delay since last SR packet</doc> + line="878">result for the delay since last SR packet</doc> <type name="guint32" c:type="guint32*"/> </parameter> </parameters> @@ -1584,20 +1588,20 @@ the values.</doc> <method name="get_rb_count" c:identifier="gst_rtcp_packet_get_rb_count"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="840">Get the number of report blocks in @packet.</doc> + line="848">Get the number of report blocks in @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="344"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="846">The number of report blocks in @packet.</doc> + line="854">The number of report blocks in @packet.</doc> <type name="guint" c:type="guint"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="842">a valid SR or RR #GstRTCPPacket</doc> + line="850">a valid SR or RR #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -1605,13 +1609,13 @@ the values.</doc> <method name="get_type" c:identifier="gst_rtcp_packet_get_type"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="655">Get the packet type of the packet pointed to by @packet.</doc> + line="663">Get the packet type of the packet pointed to by @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="315"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="661">The packet type or GST_RTCP_TYPE_INVALID when @packet is not + line="669">The packet type or GST_RTCP_TYPE_INVALID when @packet is not pointing to a valid packet.</doc> <type name="RTCPType" c:type="GstRTCPType"/> </return-value> @@ -1619,7 +1623,7 @@ pointing to a valid packet.</doc> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="657">a valid #GstRTCPPacket</doc> + line="665">a valid #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -1650,13 +1654,13 @@ function.</doc> <method name="remove" c:identifier="gst_rtcp_packet_remove"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="601">Removes the packet pointed to by @packet and moves pointer to the next one</doc> + line="609">Removes the packet pointed to by @packet and moves pointer to the next one</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="304"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="607">TRUE if @packet is pointing to a valid packet after calling this + line="615">TRUE if @packet is pointing to a valid packet after calling this function.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -1664,7 +1668,7 @@ function.</doc> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="603">a #GstRTCPPacket</doc> + line="611">a #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -1672,20 +1676,20 @@ function.</doc> <method name="rr_get_ssrc" c:identifier="gst_rtcp_packet_rr_get_ssrc"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="788">Get the ssrc field of the RR @packet.</doc> + line="796">Get the ssrc field of the RR @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="335"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="794">the ssrc.</doc> + line="802">the ssrc.</doc> <type name="guint32" c:type="guint32"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="790">a valid RR #GstRTCPPacket</doc> + line="798">a valid RR #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -1693,7 +1697,7 @@ function.</doc> <method name="rr_set_ssrc" c:identifier="gst_rtcp_packet_rr_set_ssrc"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="816">Set the ssrc field of the RR @packet.</doc> + line="824">Set the ssrc field of the RR @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="338"/> <return-value transfer-ownership="none"> @@ -1703,13 +1707,13 @@ function.</doc> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="818">a valid RR #GstRTCPPacket</doc> + line="826">a valid RR #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="ssrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="819">the SSRC to set</doc> + line="827">the SSRC to set</doc> <type name="guint32" c:type="guint32"/> </parameter> </parameters> @@ -1718,13 +1722,13 @@ function.</doc> c:identifier="gst_rtcp_packet_sdes_add_entry"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1575">Add a new SDES entry to the current item in @packet.</doc> + line="1591">Add a new SDES entry to the current item in @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="415"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1584">%TRUE if the item could be added, %FALSE if the MTU has been + line="1600">%TRUE if the item could be added, %FALSE if the MTU has been reached.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -1732,25 +1736,25 @@ reached.</doc> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1577">a valid SDES #GstRTCPPacket</doc> + line="1593">a valid SDES #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="type" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1578">the #GstRTCPSDESType of the SDES entry</doc> + line="1594">the #GstRTCPSDESType of the SDES entry</doc> <type name="RTCPSDESType" c:type="GstRTCPSDESType"/> </parameter> <parameter name="len" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1579">the data length</doc> + line="1595">the data length</doc> <type name="guint8" c:type="guint8"/> </parameter> <parameter name="data" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1580">the data</doc> + line="1596">the data</doc> <array length="1" zero-terminated="0" c:type="const guint8*"> <type name="guint8" c:type="guint8"/> </array> @@ -1761,13 +1765,13 @@ reached.</doc> c:identifier="gst_rtcp_packet_sdes_add_item"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1504">Add a new SDES item for @ssrc to @packet.</doc> + line="1520">Add a new SDES item for @ssrc to @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="412"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1511">%TRUE if the item could be added, %FALSE if the maximum amount of + line="1527">%TRUE if the item could be added, %FALSE if the maximum amount of items has been exceeded for the SDES packet or the MTU has been reached.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -1775,13 +1779,13 @@ items has been exceeded for the SDES packet or the MTU has been reached.</doc> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1506">a valid SDES #GstRTCPPacket</doc> + line="1522">a valid SDES #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="ssrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1507">the SSRC of the new item to add</doc> + line="1523">the SSRC of the new item to add</doc> <type name="guint32" c:type="guint32"/> </parameter> </parameters> @@ -1790,27 +1794,27 @@ items has been exceeded for the SDES packet or the MTU has been reached.</doc> c:identifier="gst_rtcp_packet_sdes_copy_entry"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1469">This function is like gst_rtcp_packet_sdes_get_entry() but it returns a + line="1485">This function is like gst_rtcp_packet_sdes_get_entry() but it returns a null-terminated copy of the data instead. use g_free() after usage.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="407"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1479">%TRUE if there was valid data.</doc> + line="1495">%TRUE if there was valid data.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1471">a valid SDES #GstRTCPPacket</doc> + line="1487">a valid SDES #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="type" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1472">result of the entry type</doc> + line="1488">result of the entry type</doc> <type name="RTCPSDESType" c:type="GstRTCPSDESType*"/> </parameter> <parameter name="len" @@ -1819,7 +1823,7 @@ null-terminated copy of the data instead. use g_free() after usage.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1473">result length of the entry data</doc> + line="1489">result length of the entry data</doc> <type name="guint8" c:type="guint8*"/> </parameter> <parameter name="data" @@ -1828,7 +1832,7 @@ null-terminated copy of the data instead. use g_free() after usage.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1474">result entry data</doc> + line="1490">result entry data</doc> <array length="1" zero-terminated="0" c:type="guint8**"> <type name="guint8" c:type="guint8*"/> </array> @@ -1839,20 +1843,20 @@ null-terminated copy of the data instead. use g_free() after usage.</doc> c:identifier="gst_rtcp_packet_sdes_first_entry"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1334">Move to the first SDES entry in the current item.</doc> + line="1350">Move to the first SDES entry in the current item.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="396"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1340">%TRUE if there was a first entry.</doc> + line="1356">%TRUE if there was a first entry.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1336">a valid SDES #GstRTCPPacket</doc> + line="1352">a valid SDES #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -1861,20 +1865,20 @@ null-terminated copy of the data instead. use g_free() after usage.</doc> c:identifier="gst_rtcp_packet_sdes_first_item"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1227">Move to the first SDES item in @packet.</doc> + line="1243">Move to the first SDES item in @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="387"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1233">TRUE if there was a first item.</doc> + line="1249">TRUE if there was a first item.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1229">a valid SDES #GstRTCPPacket</doc> + line="1245">a valid SDES #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -1883,7 +1887,7 @@ null-terminated copy of the data instead. use g_free() after usage.</doc> c:identifier="gst_rtcp_packet_sdes_get_entry"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1419">Get the data of the current SDES item entry. @type (when not NULL) will + line="1435">Get the data of the current SDES item entry. @type (when not NULL) will contain the type of the entry. @data (when not NULL) will point to @len bytes. @@ -1895,20 +1899,20 @@ gst_rtcp_packet_sdes_copy_entry() to get a null-terminated copy of the entry.</d <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1434">%TRUE if there was valid data.</doc> + line="1450">%TRUE if there was valid data.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1421">a valid SDES #GstRTCPPacket</doc> + line="1437">a valid SDES #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="type" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1422">result of the entry type</doc> + line="1438">result of the entry type</doc> <type name="RTCPSDESType" c:type="GstRTCPSDESType*"/> </parameter> <parameter name="len" @@ -1917,7 +1921,7 @@ gst_rtcp_packet_sdes_copy_entry() to get a null-terminated copy of the entry.</d transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1423">result length of the entry data</doc> + line="1439">result length of the entry data</doc> <type name="guint8" c:type="guint8*"/> </parameter> <parameter name="data" @@ -1926,7 +1930,7 @@ gst_rtcp_packet_sdes_copy_entry() to get a null-terminated copy of the entry.</d transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1424">result entry data</doc> + line="1440">result entry data</doc> <array length="1" zero-terminated="0" c:type="guint8**"> <type name="guint8" c:type="guint8*"/> </array> @@ -1937,20 +1941,20 @@ gst_rtcp_packet_sdes_copy_entry() to get a null-terminated copy of the entry.</d c:identifier="gst_rtcp_packet_sdes_get_item_count"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1210">Get the number of items in the SDES packet @packet.</doc> + line="1226">Get the number of items in the SDES packet @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="384"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1216">The number of items in @packet.</doc> + line="1232">The number of items in @packet.</doc> <type name="guint" c:type="guint"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1212">a valid SDES #GstRTCPPacket</doc> + line="1228">a valid SDES #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -1959,20 +1963,20 @@ gst_rtcp_packet_sdes_copy_entry() to get a null-terminated copy of the entry.</d c:identifier="gst_rtcp_packet_sdes_get_ssrc"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1304">Get the SSRC of the current SDES item.</doc> + line="1320">Get the SSRC of the current SDES item.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="393"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1310">the SSRC of the current item.</doc> + line="1326">the SSRC of the current item.</doc> <type name="guint32" c:type="guint32"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1306">a valid SDES #GstRTCPPacket</doc> + line="1322">a valid SDES #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -1981,20 +1985,20 @@ gst_rtcp_packet_sdes_copy_entry() to get a null-terminated copy of the entry.</d c:identifier="gst_rtcp_packet_sdes_next_entry"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1374">Move to the next SDES entry in the current item.</doc> + line="1390">Move to the next SDES entry in the current item.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="399"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1380">%TRUE if there was a next entry.</doc> + line="1396">%TRUE if there was a next entry.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1376">a valid SDES #GstRTCPPacket</doc> + line="1392">a valid SDES #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -2003,20 +2007,20 @@ gst_rtcp_packet_sdes_copy_entry() to get a null-terminated copy of the entry.</d c:identifier="gst_rtcp_packet_sdes_next_item"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1251">Move to the next SDES item in @packet.</doc> + line="1267">Move to the next SDES item in @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="390"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1257">TRUE if there was a next item.</doc> + line="1273">TRUE if there was a next item.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1253">a valid SDES #GstRTCPPacket</doc> + line="1269">a valid SDES #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -2024,7 +2028,7 @@ gst_rtcp_packet_sdes_copy_entry() to get a null-terminated copy of the entry.</d <method name="set_rb" c:identifier="gst_rtcp_packet_set_rb"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1029">Set the @nth new report block in @packet with the given values. + line="1037">Set the @nth new report block in @packet with the given values. Note: Not implemented.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" @@ -2036,55 +2040,55 @@ Note: Not implemented.</doc> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1031">a valid SR or RR #GstRTCPPacket</doc> + line="1039">a valid SR or RR #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="nth" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1032">the nth report block to set</doc> + line="1040">the nth report block to set</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="ssrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1033">data source being reported</doc> + line="1041">data source being reported</doc> <type name="guint32" c:type="guint32"/> </parameter> <parameter name="fractionlost" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1034">fraction lost since last SR/RR</doc> + line="1042">fraction lost since last SR/RR</doc> <type name="guint8" c:type="guint8"/> </parameter> <parameter name="packetslost" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1035">the cumululative number of packets lost</doc> + line="1043">the cumululative number of packets lost</doc> <type name="gint32" c:type="gint32"/> </parameter> <parameter name="exthighestseq" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1036">the extended last sequence number received</doc> + line="1044">the extended last sequence number received</doc> <type name="guint32" c:type="guint32"/> </parameter> <parameter name="jitter" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1037">the interarrival jitter</doc> + line="1045">the interarrival jitter</doc> <type name="guint32" c:type="guint32"/> </parameter> <parameter name="lsr" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1038">the last SR packet from this source</doc> + line="1046">the last SR packet from this source</doc> <type name="guint32" c:type="guint32"/> </parameter> <parameter name="dlsr" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="1039">the delay since last SR packet</doc> + line="1047">the delay since last SR packet</doc> <type name="guint32" c:type="guint32"/> </parameter> </parameters> @@ -2093,7 +2097,7 @@ Note: Not implemented.</doc> c:identifier="gst_rtcp_packet_sr_get_sender_info"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="708">Parse the SR sender info and store the values.</doc> + line="716">Parse the SR sender info and store the values.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="324"/> <return-value transfer-ownership="none"> @@ -2103,7 +2107,7 @@ Note: Not implemented.</doc> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="710">a valid SR #GstRTCPPacket</doc> + line="718">a valid SR #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="ssrc" @@ -2112,7 +2116,7 @@ Note: Not implemented.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="711">result SSRC</doc> + line="719">result SSRC</doc> <type name="guint32" c:type="guint32*"/> </parameter> <parameter name="ntptime" @@ -2121,7 +2125,7 @@ Note: Not implemented.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="712">result NTP time</doc> + line="720">result NTP time</doc> <type name="guint64" c:type="guint64*"/> </parameter> <parameter name="rtptime" @@ -2130,7 +2134,7 @@ Note: Not implemented.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="713">result RTP time</doc> + line="721">result RTP time</doc> <type name="guint32" c:type="guint32*"/> </parameter> <parameter name="packet_count" @@ -2139,7 +2143,7 @@ Note: Not implemented.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="714">result packet count</doc> + line="722">result packet count</doc> <type name="guint32" c:type="guint32*"/> </parameter> <parameter name="octet_count" @@ -2148,7 +2152,7 @@ Note: Not implemented.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="715">result octet count</doc> + line="723">result octet count</doc> <type name="guint32" c:type="guint32*"/> </parameter> </parameters> @@ -2157,7 +2161,7 @@ Note: Not implemented.</doc> c:identifier="gst_rtcp_packet_sr_set_sender_info"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="751">Set the given values in the SR packet @packet.</doc> + line="759">Set the given values in the SR packet @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="329"/> <return-value transfer-ownership="none"> @@ -2167,37 +2171,37 @@ Note: Not implemented.</doc> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="753">a valid SR #GstRTCPPacket</doc> + line="761">a valid SR #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="ssrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="754">the SSRC</doc> + line="762">the SSRC</doc> <type name="guint32" c:type="guint32"/> </parameter> <parameter name="ntptime" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="755">the NTP time</doc> + line="763">the NTP time</doc> <type name="guint64" c:type="guint64"/> </parameter> <parameter name="rtptime" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="756">the RTP time</doc> + line="764">the RTP time</doc> <type name="guint32" c:type="guint32"/> </parameter> <parameter name="packet_count" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="757">the packet count</doc> + line="765">the packet count</doc> <type name="guint32" c:type="guint32"/> </parameter> <parameter name="octet_count" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="758">the octet count</doc> + line="766">the octet count</doc> <type name="guint32" c:type="guint32"/> </parameter> </parameters> @@ -2207,20 +2211,20 @@ Note: Not implemented.</doc> version="1.16"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2589">Move to the first extended report block in XR @packet.</doc> + line="2605">Move to the first extended report block in XR @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="519"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2595">TRUE if there was a first extended report block.</doc> + line="2611">TRUE if there was a first extended report block.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2591">a valid XR #GstRTCPPacket</doc> + line="2607">a valid XR #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -2233,7 +2237,7 @@ Note: Not implemented.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2723">The number of 32-bit words containing type-specific block + line="2739">The number of 32-bit words containing type-specific block data from @packet.</doc> <type name="guint16" c:type="guint16"/> </return-value> @@ -2241,7 +2245,7 @@ Note: Not implemented.</doc> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2721">a valid XR #GstRTCPPacket</doc> + line="2737">a valid XR #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -2251,20 +2255,20 @@ Note: Not implemented.</doc> version="1.16"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2666">Get the extended report block type of the XR @packet.</doc> + line="2682">Get the extended report block type of the XR @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="525"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2672">The extended report block type.</doc> + line="2688">The extended report block type.</doc> <type name="RTCPXRType" c:type="GstRTCPXRType"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2668">a valid XR #GstRTCPPacket</doc> + line="2684">a valid XR #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -2274,44 +2278,44 @@ Note: Not implemented.</doc> version="1.16"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2972">Parse the extended report block for DLRR report block type.</doc> + line="2988">Parse the extended report block for DLRR report block type.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="553"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2982">%TRUE if the report block is correctly parsed.</doc> + line="2998">%TRUE if the report block is correctly parsed.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2974">a valid XR #GstRTCPPacket which has DLRR Report Block.</doc> + line="2990">a valid XR #GstRTCPPacket which has DLRR Report Block.</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="nth" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2975">the index of sub-block to retrieve.</doc> + line="2991">the index of sub-block to retrieve.</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="ssrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2976">the SSRC of the receiver.</doc> + line="2992">the SSRC of the receiver.</doc> <type name="guint32" c:type="guint32*"/> </parameter> <parameter name="last_rr" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2977">the last receiver reference timestamp of @ssrc.</doc> + line="2993">the last receiver reference timestamp of @ssrc.</doc> <type name="guint32" c:type="guint32*"/> </parameter> <parameter name="delay" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2978">the delay since @last_rr.</doc> + line="2994">the delay since @last_rr.</doc> <type name="guint32" c:type="guint32*"/> </parameter> </parameters> @@ -2321,32 +2325,32 @@ Note: Not implemented.</doc> version="1.16"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2899">Retrieve the packet receipt time of @seq which ranges in [begin_seq, end_seq).</doc> + line="2915">Retrieve the packet receipt time of @seq which ranges in [begin_seq, end_seq).</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="546"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2907">%TRUE if the report block returns the receipt time correctly.</doc> + line="2923">%TRUE if the report block returns the receipt time correctly.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2901">a valid XR #GstRTCPPacket which has the Packet Recept Times Report Block.</doc> + line="2917">a valid XR #GstRTCPPacket which has the Packet Recept Times Report Block.</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="seq" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2902">the sequence to retrieve the time.</doc> + line="2918">the sequence to retrieve the time.</doc> <type name="guint16" c:type="guint16"/> </parameter> <parameter name="receipt_time" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2903">the packet receipt time of @seq.</doc> + line="2919">the packet receipt time of @seq.</doc> <type name="guint32" c:type="guint32*"/> </parameter> </parameters> @@ -2356,44 +2360,44 @@ Note: Not implemented.</doc> version="1.16"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2847">Parse the Packet Recept Times Report Block from a XR @packet</doc> + line="2863">Parse the Packet Recept Times Report Block from a XR @packet</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="541"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2857">%TRUE if the report block is correctly parsed.</doc> + line="2873">%TRUE if the report block is correctly parsed.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2849">a valid XR #GstRTCPPacket which has a Packet Receipt Times Report Block</doc> + line="2865">a valid XR #GstRTCPPacket which has a Packet Receipt Times Report Block</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="ssrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2850">the SSRC of the RTP data packet source being reported upon by this report block.</doc> + line="2866">the SSRC of the RTP data packet source being reported upon by this report block.</doc> <type name="guint32" c:type="guint32*"/> </parameter> <parameter name="thinning" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2851">the amount of thinning performed on the sequence number space.</doc> + line="2867">the amount of thinning performed on the sequence number space.</doc> <type name="guint8" c:type="guint8*"/> </parameter> <parameter name="begin_seq" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2852">the first sequence number that this block reports on.</doc> + line="2868">the first sequence number that this block reports on.</doc> <type name="guint16" c:type="guint16*"/> </parameter> <parameter name="end_seq" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2853">the last sequence number that this block reports on plus one.</doc> + line="2869">the last sequence number that this block reports on plus one.</doc> <type name="guint16" c:type="guint16*"/> </parameter> </parameters> @@ -2403,50 +2407,50 @@ Note: Not implemented.</doc> version="1.16"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2748">Parse the extended report block for Loss RLE and Duplicated LRE block type.</doc> + line="2764">Parse the extended report block for Loss RLE and Duplicated LRE block type.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="531"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2759">%TRUE if the report block is correctly parsed.</doc> + line="2775">%TRUE if the report block is correctly parsed.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2750">a valid XR #GstRTCPPacket which is Loss RLE or Duplicate RLE report.</doc> + line="2766">a valid XR #GstRTCPPacket which is Loss RLE or Duplicate RLE report.</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="ssrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2751">the SSRC of the RTP data packet source being reported upon by this report block.</doc> + line="2767">the SSRC of the RTP data packet source being reported upon by this report block.</doc> <type name="guint32" c:type="guint32*"/> </parameter> <parameter name="thinning" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2752">the amount of thinning performed on the sequence number space.</doc> + line="2768">the amount of thinning performed on the sequence number space.</doc> <type name="guint8" c:type="guint8*"/> </parameter> <parameter name="begin_seq" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2753">the first sequence number that this block reports on.</doc> + line="2769">the first sequence number that this block reports on.</doc> <type name="guint16" c:type="guint16*"/> </parameter> <parameter name="end_seq" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2754">the last sequence number that this block reports on plus one.</doc> + line="2770">the last sequence number that this block reports on plus one.</doc> <type name="guint16" c:type="guint16*"/> </parameter> <parameter name="chunk_count" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2755">the number of chunks calculated by block length.</doc> + line="2771">the number of chunks calculated by block length.</doc> <type name="guint32" c:type="guint32*"/> </parameter> </parameters> @@ -2456,32 +2460,32 @@ Note: Not implemented.</doc> version="1.16"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2806">Retrieve actual chunk data.</doc> + line="2822">Retrieve actual chunk data.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="537"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2814">%TRUE if the report block returns chunk correctly.</doc> + line="2830">%TRUE if the report block returns chunk correctly.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2808">a valid XR #GstRTCPPacket which is Loss RLE or Duplicate RLE report.</doc> + line="2824">a valid XR #GstRTCPPacket which is Loss RLE or Duplicate RLE report.</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="nth" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2809">the index of chunk to retrieve.</doc> + line="2825">the index of chunk to retrieve.</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="chunk" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2810">the @nth chunk.</doc> + line="2826">the @nth chunk.</doc> <type name="guint16" c:type="guint16*"/> </parameter> </parameters> @@ -2494,20 +2498,20 @@ Note: Not implemented.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2945">%TRUE if the report block returns the reference time correctly.</doc> + line="2961">%TRUE if the report block returns the reference time correctly.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2942">a valid XR #GstRTCPPacket which has the Receiver Reference Time.</doc> + line="2958">a valid XR #GstRTCPPacket which has the Receiver Reference Time.</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="timestamp" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2943">NTP timestamp</doc> + line="2959">NTP timestamp</doc> <type name="guint64" c:type="guint64*"/> </parameter> </parameters> @@ -2517,20 +2521,20 @@ Note: Not implemented.</doc> version="1.16"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2559">Get the ssrc field of the XR @packet.</doc> + line="2575">Get the ssrc field of the XR @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="516"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2565">the ssrc.</doc> + line="2581">the ssrc.</doc> <type name="guint32" c:type="guint32"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2561">a valid XR #GstRTCPPacket</doc> + line="2577">a valid XR #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -2540,38 +2544,38 @@ Note: Not implemented.</doc> version="1.16"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3022">Extract a basic information from static summary report block of XR @packet.</doc> + line="3038">Extract a basic information from static summary report block of XR @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="558"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3031">%TRUE if the report block is correctly parsed.</doc> + line="3047">%TRUE if the report block is correctly parsed.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3024">a valid XR #GstRTCPPacket which has Statics Summary Report Block.</doc> + line="3040">a valid XR #GstRTCPPacket which has Statics Summary Report Block.</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="ssrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3025">the SSRC of the source.</doc> + line="3041">the SSRC of the source.</doc> <type name="guint32" c:type="guint32*"/> </parameter> <parameter name="begin_seq" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3026">the first sequence number that this block reports on.</doc> + line="3042">the first sequence number that this block reports on.</doc> <type name="guint16" c:type="guint16*"/> </parameter> <parameter name="end_seq" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3027">the last sequence number that this block reports on plus one.</doc> + line="3043">the last sequence number that this block reports on plus one.</doc> <type name="guint16" c:type="guint16*"/> </parameter> </parameters> @@ -2581,45 +2585,45 @@ Note: Not implemented.</doc> version="1.16"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3118">Extract jitter information from the statistics summary. If the jitter flag in + line="3134">Extract jitter information from the statistics summary. If the jitter flag in a block header is set as zero, all of jitters will be zero.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="566"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3129">%TRUE if the report block is correctly parsed.</doc> + line="3145">%TRUE if the report block is correctly parsed.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3120">a valid XR #GstRTCPPacket which has Statics Summary Report Block.</doc> + line="3136">a valid XR #GstRTCPPacket which has Statics Summary Report Block.</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="min_jitter" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3121">the minimum relative transit time between two sequences.</doc> + line="3137">the minimum relative transit time between two sequences.</doc> <type name="guint32" c:type="guint32*"/> </parameter> <parameter name="max_jitter" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3122">the maximum relative transit time between two sequences.</doc> + line="3138">the maximum relative transit time between two sequences.</doc> <type name="guint32" c:type="guint32*"/> </parameter> <parameter name="mean_jitter" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3123">the mean relative transit time between two sequences.</doc> + line="3139">the mean relative transit time between two sequences.</doc> <type name="guint32" c:type="guint32*"/> </parameter> <parameter name="dev_jitter" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3124">the standard deviation of the relative transit time between two sequences.</doc> + line="3140">the standard deviation of the relative transit time between two sequences.</doc> <type name="guint32" c:type="guint32*"/> </parameter> </parameters> @@ -2629,33 +2633,33 @@ a block header is set as zero, all of jitters will be zero.</doc> version="1.16"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3068">Get the number of lost or duplicate packets. If the flag in a block header + line="3084">Get the number of lost or duplicate packets. If the flag in a block header is set as zero, @lost_packets or @dup_packets will be zero.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="562"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3077">%TRUE if the report block is correctly parsed.</doc> + line="3093">%TRUE if the report block is correctly parsed.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3070">a valid XR #GstRTCPPacket which has Statics Summary Report Block.</doc> + line="3086">a valid XR #GstRTCPPacket which has Statics Summary Report Block.</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="lost_packets" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3071">the number of lost packets between begin_seq and end_seq.</doc> + line="3087">the number of lost packets between begin_seq and end_seq.</doc> <type name="guint32" c:type="guint32*"/> </parameter> <parameter name="dup_packets" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3072">the number of duplicate packets between begin_seq and end_seq.</doc> + line="3088">the number of duplicate packets between begin_seq and end_seq.</doc> <type name="guint32" c:type="guint32*"/> </parameter> </parameters> @@ -2665,50 +2669,50 @@ is set as zero, @lost_packets or @dup_packets will be zero.</doc> version="1.16"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3185">Extract the value of ttl for ipv4, or hop limit for ipv6.</doc> + line="3201">Extract the value of ttl for ipv4, or hop limit for ipv6.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="571"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3196">%TRUE if the report block is correctly parsed.</doc> + line="3212">%TRUE if the report block is correctly parsed.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3187">a valid XR #GstRTCPPacket which has Statics Summary Report Block.</doc> + line="3203">a valid XR #GstRTCPPacket which has Statics Summary Report Block.</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="is_ipv4" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3188">the flag to indicate that the return values are ipv4 ttl or ipv6 hop limits.</doc> + line="3204">the flag to indicate that the return values are ipv4 ttl or ipv6 hop limits.</doc> <type name="gboolean" c:type="gboolean*"/> </parameter> <parameter name="min_ttl" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3189">the minimum TTL or Hop Limit value of data packets between two sequences.</doc> + line="3205">the minimum TTL or Hop Limit value of data packets between two sequences.</doc> <type name="guint8" c:type="guint8*"/> </parameter> <parameter name="max_ttl" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3190">the maximum TTL or Hop Limit value of data packets between two sequences.</doc> + line="3206">the maximum TTL or Hop Limit value of data packets between two sequences.</doc> <type name="guint8" c:type="guint8*"/> </parameter> <parameter name="mean_ttl" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3191">the mean TTL or Hop Limit value of data packets between two sequences.</doc> + line="3207">the mean TTL or Hop Limit value of data packets between two sequences.</doc> <type name="guint8" c:type="guint8*"/> </parameter> <parameter name="dev_ttl" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3192">the standard deviation of the TTL or Hop Limit value of data packets between two sequences.</doc> + line="3208">the standard deviation of the TTL or Hop Limit value of data packets between two sequences.</doc> <type name="guint8" c:type="guint8*"/> </parameter> </parameters> @@ -2721,38 +2725,38 @@ is set as zero, @lost_packets or @dup_packets will be zero.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3320">%TRUE if the report block is correctly parsed.</doc> + line="3336">%TRUE if the report block is correctly parsed.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3314">a valid XR #GstRTCPPacket which has VoIP Metrics Report Block.</doc> + line="3330">a valid XR #GstRTCPPacket which has VoIP Metrics Report Block.</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="burst_density" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3315">the fraction of RTP data packets within burst periods.</doc> + line="3331">the fraction of RTP data packets within burst periods.</doc> <type name="guint8" c:type="guint8*"/> </parameter> <parameter name="gap_density" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3316">the fraction of RTP data packets within inter-burst gaps.</doc> + line="3332">the fraction of RTP data packets within inter-burst gaps.</doc> <type name="guint8" c:type="guint8*"/> </parameter> <parameter name="burst_duration" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3317">the mean duration(ms) of the burst periods.</doc> + line="3333">the mean duration(ms) of the burst periods.</doc> <type name="guint16" c:type="guint16*"/> </parameter> <parameter name="gap_duration" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3318">the mean duration(ms) of the gap periods.</doc> + line="3334">the mean duration(ms) of the gap periods.</doc> <type name="guint16" c:type="guint16*"/> </parameter> </parameters> @@ -2765,26 +2769,26 @@ is set as zero, @lost_packets or @dup_packets will be zero.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3496">%TRUE if the report block is correctly parsed.</doc> + line="3512">%TRUE if the report block is correctly parsed.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3492">a valid XR #GstRTCPPacket which has VoIP Metrics Report Block.</doc> + line="3508">a valid XR #GstRTCPPacket which has VoIP Metrics Report Block.</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="gmin" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3493">the gap threshold.</doc> + line="3509">the gap threshold.</doc> <type name="guint8" c:type="guint8*"/> </parameter> <parameter name="rx_config" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3494">the receiver configuration byte.</doc> + line="3510">the receiver configuration byte.</doc> <type name="guint8" c:type="guint8*"/> </parameter> </parameters> @@ -2797,26 +2801,26 @@ is set as zero, @lost_packets or @dup_packets will be zero.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3366">%TRUE if the report block is correctly parsed.</doc> + line="3382">%TRUE if the report block is correctly parsed.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3362">a valid XR #GstRTCPPacket which has VoIP Metrics Report Block.</doc> + line="3378">a valid XR #GstRTCPPacket which has VoIP Metrics Report Block.</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="roundtrip_delay" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3363">the most recently calculated round trip time between RTP interfaces(ms)</doc> + line="3379">the most recently calculated round trip time between RTP interfaces(ms)</doc> <type name="guint16" c:type="guint16*"/> </parameter> <parameter name="end_system_delay" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3364">the most recently estimated end system delay(ms)</doc> + line="3380">the most recently estimated end system delay(ms)</doc> <type name="guint16" c:type="guint16*"/> </parameter> </parameters> @@ -2829,32 +2833,32 @@ is set as zero, @lost_packets or @dup_packets will be zero.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3532">%TRUE if the report block is correctly parsed.</doc> + line="3548">%TRUE if the report block is correctly parsed.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3527">a valid XR #GstRTCPPacket which has VoIP Metrics Report Block.</doc> + line="3543">a valid XR #GstRTCPPacket which has VoIP Metrics Report Block.</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="jb_nominal" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3528">the current nominal jitter buffer delay(ms)</doc> + line="3544">the current nominal jitter buffer delay(ms)</doc> <type name="guint16" c:type="guint16*"/> </parameter> <parameter name="jb_maximum" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3529">the current maximum jitter buffer delay(ms)</doc> + line="3545">the current maximum jitter buffer delay(ms)</doc> <type name="guint16" c:type="guint16*"/> </parameter> <parameter name="jb_abs_max" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3530">the absolute maximum delay(ms)</doc> + line="3546">the absolute maximum delay(ms)</doc> <type name="guint16" c:type="guint16*"/> </parameter> </parameters> @@ -2867,20 +2871,20 @@ is set as zero, @lost_packets or @dup_packets will be zero.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3247">%TRUE if the report block is correctly parsed.</doc> + line="3263">%TRUE if the report block is correctly parsed.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3244">a valid XR #GstRTCPPacket which has VoIP Metrics Report Block.</doc> + line="3260">a valid XR #GstRTCPPacket which has VoIP Metrics Report Block.</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="ssrc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3245">the SSRC of source</doc> + line="3261">the SSRC of source</doc> <type name="guint32" c:type="guint32*"/> </parameter> </parameters> @@ -2893,26 +2897,26 @@ is set as zero, @lost_packets or @dup_packets will be zero.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3281">%TRUE if the report block is correctly parsed.</doc> + line="3297">%TRUE if the report block is correctly parsed.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3277">a valid XR #GstRTCPPacket which has VoIP Metrics Report Block.</doc> + line="3293">a valid XR #GstRTCPPacket which has VoIP Metrics Report Block.</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="loss_rate" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3278">the fraction of RTP data packets from the source lost.</doc> + line="3294">the fraction of RTP data packets from the source lost.</doc> <type name="guint8" c:type="guint8*"/> </parameter> <parameter name="discard_rate" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3279">the fraction of RTP data packets from the source that have been discarded.</doc> + line="3295">the fraction of RTP data packets from the source that have been discarded.</doc> <type name="guint8" c:type="guint8*"/> </parameter> </parameters> @@ -2925,38 +2929,38 @@ is set as zero, @lost_packets or @dup_packets will be zero.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3452">%TRUE if the report block is correctly parsed.</doc> + line="3468">%TRUE if the report block is correctly parsed.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3446">a valid XR #GstRTCPPacket which has VoIP Metrics Report Block.</doc> + line="3462">a valid XR #GstRTCPPacket which has VoIP Metrics Report Block.</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="r_factor" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3447">the R factor is a voice quality metric describing the segment of the call.</doc> + line="3463">the R factor is a voice quality metric describing the segment of the call.</doc> <type name="guint8" c:type="guint8*"/> </parameter> <parameter name="ext_r_factor" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3448">the external R factor is a voice quality metric.</doc> + line="3464">the external R factor is a voice quality metric.</doc> <type name="guint8" c:type="guint8*"/> </parameter> <parameter name="mos_lq" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3449">the estimated mean opinion score for listening quality.</doc> + line="3465">the estimated mean opinion score for listening quality.</doc> <type name="guint8" c:type="guint8*"/> </parameter> <parameter name="mos_cq" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3450">the estimated mean opinion score for conversational quality.</doc> + line="3466">the estimated mean opinion score for conversational quality.</doc> <type name="guint8" c:type="guint8*"/> </parameter> </parameters> @@ -2969,38 +2973,38 @@ is set as zero, @lost_packets or @dup_packets will be zero.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3406">%TRUE if the report block is correctly parsed.</doc> + line="3422">%TRUE if the report block is correctly parsed.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3400">a valid XR #GstRTCPPacket which has VoIP Metrics Report Block.</doc> + line="3416">a valid XR #GstRTCPPacket which has VoIP Metrics Report Block.</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> <parameter name="signal_level" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3401">the ratio of the signal level to a 0 dBm reference.</doc> + line="3417">the ratio of the signal level to a 0 dBm reference.</doc> <type name="guint8" c:type="guint8*"/> </parameter> <parameter name="noise_level" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3402">the ratio of the silent period background noise level to a 0 dBm reference.</doc> + line="3418">the ratio of the silent period background noise level to a 0 dBm reference.</doc> <type name="guint8" c:type="guint8*"/> </parameter> <parameter name="rerl" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3403">the residual echo return loss value.</doc> + line="3419">the residual echo return loss value.</doc> <type name="guint8" c:type="guint8*"/> </parameter> <parameter name="gmin" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="3404">the gap threshold.</doc> + line="3420">the gap threshold.</doc> <type name="guint8" c:type="guint8*"/> </parameter> </parameters> @@ -3010,20 +3014,20 @@ is set as zero, @lost_packets or @dup_packets will be zero.</doc> version="1.16"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2628">Move to the next extended report block in XR @packet.</doc> + line="2644">Move to the next extended report block in XR @packet.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="522"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2634">TRUE if there was a next extended report block.</doc> + line="2650">TRUE if there was a next extended report block.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="packet" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2630">a valid XR #GstRTCPPacket</doc> + line="2646">a valid XR #GstRTCPPacket</doc> <type name="RTCPPacket" c:type="GstRTCPPacket*"/> </instance-parameter> </parameters> @@ -3383,7 +3387,7 @@ specific to GstRTPBaseAudioPayload.</doc> <method name="flush" c:identifier="gst_rtp_base_audio_payload_flush"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.c" - line="562">Create an RTP buffer and store @payload_len bytes of the adapter as the + line="567">Create an RTP buffer and store @payload_len bytes of the adapter as the payload. Set the timestamp on the new buffer to @timestamp before pushing the buffer downstream. @@ -3394,7 +3398,7 @@ If @payload_len is -1, all pending bytes will be flushed. If @timestamp is <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.c" - line="575">a #GstFlowReturn</doc> + line="580">a #GstFlowReturn</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> <parameters> @@ -3402,19 +3406,19 @@ If @payload_len is -1, all pending bytes will be flushed. If @timestamp is transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.c" - line="564">a #GstRTPBasePayload</doc> + line="569">a #GstRTPBasePayload</doc> <type name="RTPBaseAudioPayload" c:type="GstRTPBaseAudioPayload*"/> </instance-parameter> <parameter name="payload_len" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.c" - line="565">length of payload</doc> + line="570">length of payload</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="timestamp" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.c" - line="566">a #GstClockTime</doc> + line="571">a #GstClockTime</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </parameter> </parameters> @@ -3423,13 +3427,13 @@ If @payload_len is -1, all pending bytes will be flushed. If @timestamp is c:identifier="gst_rtp_base_audio_payload_get_adapter"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.c" - line="1001">Gets the internal adapter used by the depayloader.</doc> + line="1006">Gets the internal adapter used by the depayloader.</doc> <source-position filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.h" line="107"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.c" - line="1007">a #GstAdapter.</doc> + line="1012">a #GstAdapter.</doc> <type name="GstBase.Adapter" c:type="GstAdapter*"/> </return-value> <parameters> @@ -3437,7 +3441,7 @@ If @payload_len is -1, all pending bytes will be flushed. If @timestamp is transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.c" - line="1003">a #GstRTPBaseAudioPayload</doc> + line="1008">a #GstRTPBaseAudioPayload</doc> <type name="RTPBaseAudioPayload" c:type="GstRTPBaseAudioPayload*"/> </instance-parameter> </parameters> @@ -3445,7 +3449,7 @@ If @payload_len is -1, all pending bytes will be flushed. If @timestamp is <method name="push" c:identifier="gst_rtp_base_audio_payload_push"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.c" - line="428">Create an RTP buffer and store @payload_len bytes of @data as the + line="434">Create an RTP buffer and store @payload_len bytes of @data as the payload. Set the timestamp on the new buffer to @timestamp before pushing the buffer downstream.</doc> <source-position filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.h" @@ -3453,7 +3457,7 @@ the buffer downstream.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.c" - line="439">a #GstFlowReturn</doc> + line="445">a #GstFlowReturn</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> <parameters> @@ -3461,13 +3465,13 @@ the buffer downstream.</doc> transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.c" - line="430">a #GstRTPBasePayload</doc> + line="436">a #GstRTPBasePayload</doc> <type name="RTPBaseAudioPayload" c:type="GstRTPBaseAudioPayload*"/> </instance-parameter> <parameter name="data" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.c" - line="431">data to set as payload</doc> + line="437">data to set as payload</doc> <array length="1" zero-terminated="0" c:type="const guint8*"> <type name="guint8" c:type="guint8"/> </array> @@ -3475,13 +3479,13 @@ the buffer downstream.</doc> <parameter name="payload_len" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.c" - line="432">length of payload</doc> + line="438">length of payload</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="timestamp" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.c" - line="433">a #GstClockTime</doc> + line="439">a #GstClockTime</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </parameter> </parameters> @@ -3490,7 +3494,7 @@ the buffer downstream.</doc> c:identifier="gst_rtp_base_audio_payload_set_frame_based"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.c" - line="260">Tells #GstRTPBaseAudioPayload that the child element is for a frame based + line="266">Tells #GstRTPBaseAudioPayload that the child element is for a frame based audio codec</doc> <source-position filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.h" line="85"/> @@ -3502,7 +3506,7 @@ audio codec</doc> transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.c" - line="262">a pointer to the element.</doc> + line="268">a pointer to the element.</doc> <type name="RTPBaseAudioPayload" c:type="GstRTPBaseAudioPayload*"/> </instance-parameter> </parameters> @@ -3511,7 +3515,7 @@ audio codec</doc> c:identifier="gst_rtp_base_audio_payload_set_frame_options"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.c" - line="308">Sets the options for frame based audio codecs.</doc> + line="314">Sets the options for frame based audio codecs.</doc> <source-position filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.h" line="88"/> <return-value transfer-ownership="none"> @@ -3522,19 +3526,19 @@ audio codec</doc> transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.c" - line="310">a pointer to the element.</doc> + line="316">a pointer to the element.</doc> <type name="RTPBaseAudioPayload" c:type="GstRTPBaseAudioPayload*"/> </instance-parameter> <parameter name="frame_duration" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.c" - line="311">The duraction of an audio frame in milliseconds.</doc> + line="317">The duraction of an audio frame in milliseconds.</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="frame_size" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.c" - line="312">The size of an audio frame in bytes.</doc> + line="318">The size of an audio frame in bytes.</doc> <type name="gint" c:type="gint"/> </parameter> </parameters> @@ -3543,7 +3547,7 @@ audio codec</doc> c:identifier="gst_rtp_base_audio_payload_set_sample_based"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.c" - line="284">Tells #GstRTPBaseAudioPayload that the child element is for a sample based + line="290">Tells #GstRTPBaseAudioPayload that the child element is for a sample based audio codec</doc> <source-position filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.h" line="94"/> @@ -3555,7 +3559,7 @@ audio codec</doc> transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.c" - line="286">a pointer to the element.</doc> + line="292">a pointer to the element.</doc> <type name="RTPBaseAudioPayload" c:type="GstRTPBaseAudioPayload*"/> </instance-parameter> </parameters> @@ -3564,7 +3568,7 @@ audio codec</doc> c:identifier="gst_rtp_base_audio_payload_set_sample_options"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.c" - line="338">Sets the options for sample based audio codecs.</doc> + line="344">Sets the options for sample based audio codecs.</doc> <source-position filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.h" line="97"/> <return-value transfer-ownership="none"> @@ -3575,13 +3579,13 @@ audio codec</doc> transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.c" - line="340">a pointer to the element.</doc> + line="346">a pointer to the element.</doc> <type name="RTPBaseAudioPayload" c:type="GstRTPBaseAudioPayload*"/> </instance-parameter> <parameter name="sample_size" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.c" - line="341">Size per sample in bytes.</doc> + line="347">Size per sample in bytes.</doc> <type name="gint" c:type="gint"/> </parameter> </parameters> @@ -3590,7 +3594,7 @@ audio codec</doc> c:identifier="gst_rtp_base_audio_payload_set_samplebits_options"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.c" - line="356">Sets the options for sample based audio codecs.</doc> + line="362">Sets the options for sample based audio codecs.</doc> <source-position filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.h" line="101"/> <return-value transfer-ownership="none"> @@ -3601,13 +3605,13 @@ audio codec</doc> transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.c" - line="358">a pointer to the element.</doc> + line="364">a pointer to the element.</doc> <type name="RTPBaseAudioPayload" c:type="GstRTPBaseAudioPayload*"/> </instance-parameter> <parameter name="sample_size" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbaseaudiopayload.c" - line="359">Size per sample in bits.</doc> + line="365">Size per sample in bits.</doc> <type name="gint" c:type="gint"/> </parameter> </parameters> @@ -3759,20 +3763,20 @@ audio codec</doc> version="1.16"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasedepayload.c" - line="1154">Queries whether #GstRTPSourceMeta will be added to depayloaded buffers.</doc> + line="1152">Queries whether #GstRTPSourceMeta will be added to depayloaded buffers.</doc> <source-position filename="gst-libs/gst/rtp/gstrtpbasedepayload.h" line="124"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasedepayload.c" - line="1160">%TRUE if source-info is enabled.</doc> + line="1158">%TRUE if source-info is enabled.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="depayload" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasedepayload.c" - line="1156">a #GstRTPBaseDepayload</doc> + line="1154">a #GstRTPBaseDepayload</doc> <type name="RTPBaseDepayload" c:type="GstRTPBaseDepayload*"/> </instance-parameter> </parameters> @@ -3780,7 +3784,7 @@ audio codec</doc> <method name="push" c:identifier="gst_rtp_base_depayload_push"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasedepayload.c" - line="899">Push @out_buf to the peer of @filter. This function takes ownership of + line="897">Push @out_buf to the peer of @filter. This function takes ownership of @out_buf. This function will by default apply the last incoming timestamp on @@ -3790,20 +3794,20 @@ the outgoing buffer when it didn't have a timestamp already.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasedepayload.c" - line="910">a #GstFlowReturn.</doc> + line="908">a #GstFlowReturn.</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> <parameters> <instance-parameter name="filter" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasedepayload.c" - line="901">a #GstRTPBaseDepayload</doc> + line="899">a #GstRTPBaseDepayload</doc> <type name="RTPBaseDepayload" c:type="GstRTPBaseDepayload*"/> </instance-parameter> <parameter name="out_buf" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasedepayload.c" - line="902">a #GstBuffer</doc> + line="900">a #GstBuffer</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </parameter> </parameters> @@ -3811,27 +3815,27 @@ the outgoing buffer when it didn't have a timestamp already.</doc> <method name="push_list" c:identifier="gst_rtp_base_depayload_push_list"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasedepayload.c" - line="930">Push @out_list to the peer of @filter. This function takes ownership of + line="928">Push @out_list to the peer of @filter. This function takes ownership of @out_list.</doc> <source-position filename="gst-libs/gst/rtp/gstrtpbasedepayload.h" line="121"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasedepayload.c" - line="938">a #GstFlowReturn.</doc> + line="936">a #GstFlowReturn.</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> <parameters> <instance-parameter name="filter" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasedepayload.c" - line="932">a #GstRTPBaseDepayload</doc> + line="930">a #GstRTPBaseDepayload</doc> <type name="RTPBaseDepayload" c:type="GstRTPBaseDepayload*"/> </instance-parameter> <parameter name="out_list" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasedepayload.c" - line="933">a #GstBufferList</doc> + line="931">a #GstBufferList</doc> <type name="Gst.BufferList" c:type="GstBufferList*"/> </parameter> </parameters> @@ -3841,7 +3845,7 @@ the outgoing buffer when it didn't have a timestamp already.</doc> version="1.16"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasedepayload.c" - line="1138">Enable or disable adding #GstRTPSourceMeta to depayloaded buffers.</doc> + line="1136">Enable or disable adding #GstRTPSourceMeta to depayloaded buffers.</doc> <source-position filename="gst-libs/gst/rtp/gstrtpbasedepayload.h" line="127"/> <return-value transfer-ownership="none"> @@ -3851,13 +3855,13 @@ the outgoing buffer when it didn't have a timestamp already.</doc> <instance-parameter name="depayload" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasedepayload.c" - line="1140">a #GstRTPBaseDepayload</doc> + line="1138">a #GstRTPBaseDepayload</doc> <type name="RTPBaseDepayload" c:type="GstRTPBaseDepayload*"/> </instance-parameter> <parameter name="enable" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasedepayload.c" - line="1141">whether to add meta about RTP sources to buffer</doc> + line="1139">whether to add meta about RTP sources to buffer</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -4157,7 +4161,7 @@ the last processed buffer and current state of the stream being depayloaded: version="1.16"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="1506">Allocate a new #GstBuffer with enough data to hold an RTP packet with + line="1528">Allocate a new #GstBuffer with enough data to hold an RTP packet with minimum @csrc_count CSRCs, a payload length of @payload_len and padding of @pad_len. If @payload has #GstRTPBasePayload:source-info %TRUE additional CSRCs may be allocated and filled with RTP source information.</doc> @@ -4166,7 +4170,7 @@ CSRCs may be allocated and filled with RTP source information.</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="1518">A newly allocated buffer that can hold an RTP packet with given + line="1540">A newly allocated buffer that can hold an RTP packet with given parameters.</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </return-value> @@ -4174,25 +4178,25 @@ parameters.</doc> <instance-parameter name="payload" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="1508">a #GstRTPBasePayload</doc> + line="1530">a #GstRTPBasePayload</doc> <type name="RTPBasePayload" c:type="GstRTPBasePayload*"/> </instance-parameter> <parameter name="payload_len" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="1509">the length of the payload</doc> + line="1531">the length of the payload</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="pad_len" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="1510">the amount of padding</doc> + line="1532">the amount of padding</doc> <type name="guint8" c:type="guint8"/> </parameter> <parameter name="csrc_count" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="1511">the minimum number of CSRC entries</doc> + line="1533">the minimum number of CSRC entries</doc> <type name="guint8" c:type="guint8"/> </parameter> </parameters> @@ -4202,7 +4206,7 @@ parameters.</doc> version="1.16"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="1824">Count the total number of RTP sources found in the meta of @buffer, which + line="1846">Count the total number of RTP sources found in the meta of @buffer, which will be automically added by gst_rtp_base_payload_allocate_output_buffer(). If #GstRTPBasePayload:source-info is %FALSE the count will be 0.</doc> <source-position filename="gst-libs/gst/rtp/gstrtpbasepayload.h" @@ -4210,20 +4214,20 @@ If #GstRTPBasePayload:source-info is %FALSE the count will be 0.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="1833">The number of sources.</doc> + line="1855">The number of sources.</doc> <type name="guint" c:type="guint"/> </return-value> <parameters> <instance-parameter name="payload" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="1826">a #GstRTPBasePayload</doc> + line="1848">a #GstRTPBasePayload</doc> <type name="RTPBasePayload" c:type="GstRTPBasePayload*"/> </instance-parameter> <parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="1827">a #GstBuffer, typically the buffer to payload</doc> + line="1849">a #GstBuffer, typically the buffer to payload</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </parameter> </parameters> @@ -4231,14 +4235,14 @@ If #GstRTPBasePayload:source-info is %FALSE the count will be 0.</doc> <method name="is_filled" c:identifier="gst_rtp_base_payload_is_filled"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="1187">Check if the packet with @size and @duration would exceed the configured + line="1208">Check if the packet with @size and @duration would exceed the configured maximum size.</doc> <source-position filename="gst-libs/gst/rtp/gstrtpbasepayload.h" line="164"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="1196">%TRUE if the packet of @size and @duration would exceed the + line="1217">%TRUE if the packet of @size and @duration would exceed the configured MTU or max_ptime.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -4246,19 +4250,19 @@ configured MTU or max_ptime.</doc> <instance-parameter name="payload" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="1189">a #GstRTPBasePayload</doc> + line="1210">a #GstRTPBasePayload</doc> <type name="RTPBasePayload" c:type="GstRTPBasePayload*"/> </instance-parameter> <parameter name="size" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="1190">the size of the packet</doc> + line="1211">the size of the packet</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="duration" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="1191">the duration of the packet</doc> + line="1212">the duration of the packet</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </parameter> </parameters> @@ -4268,21 +4272,21 @@ configured MTU or max_ptime.</doc> version="1.16"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="1806">Queries whether the payloader will add contributing sources (CSRCs) to the + line="1828">Queries whether the payloader will add contributing sources (CSRCs) to the RTP header from #GstRTPSourceMeta.</doc> <source-position filename="gst-libs/gst/rtp/gstrtpbasepayload.h" line="185"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="1813">%TRUE if source-info is enabled.</doc> + line="1835">%TRUE if source-info is enabled.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="payload" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="1808">a #GstRTPBasePayload</doc> + line="1830">a #GstRTPBasePayload</doc> <type name="RTPBasePayload" c:type="GstRTPBasePayload*"/> </instance-parameter> </parameters> @@ -4290,7 +4294,7 @@ RTP header from #GstRTPSourceMeta.</doc> <method name="push" c:identifier="gst_rtp_base_payload_push"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="1473">Push @buffer to the peer element of the payloader. The SSRC, payload type, + line="1495">Push @buffer to the peer element of the payloader. The SSRC, payload type, seqnum and timestamp of the RTP buffer will be updated first. This function takes ownership of @buffer.</doc> @@ -4299,20 +4303,20 @@ This function takes ownership of @buffer.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="1483">a #GstFlowReturn.</doc> + line="1505">a #GstFlowReturn.</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> <parameters> <instance-parameter name="payload" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="1475">a #GstRTPBasePayload</doc> + line="1497">a #GstRTPBasePayload</doc> <type name="RTPBasePayload" c:type="GstRTPBasePayload*"/> </instance-parameter> <parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="1476">a #GstBuffer</doc> + line="1498">a #GstBuffer</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </parameter> </parameters> @@ -4320,7 +4324,7 @@ This function takes ownership of @buffer.</doc> <method name="push_list" c:identifier="gst_rtp_base_payload_push_list"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="1439">Push @list to the peer element of the payloader. The SSRC, payload type, + line="1461">Push @list to the peer element of the payloader. The SSRC, payload type, seqnum and timestamp of the RTP buffer will be updated first. This function takes ownership of @list.</doc> @@ -4329,20 +4333,20 @@ This function takes ownership of @list.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="1449">a #GstFlowReturn.</doc> + line="1471">a #GstFlowReturn.</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> <parameters> <instance-parameter name="payload" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="1441">a #GstRTPBasePayload</doc> + line="1463">a #GstRTPBasePayload</doc> <type name="RTPBasePayload" c:type="GstRTPBasePayload*"/> </instance-parameter> <parameter name="list" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="1442">a #GstBufferList</doc> + line="1464">a #GstBufferList</doc> <type name="Gst.BufferList" c:type="GstBufferList*"/> </parameter> </parameters> @@ -4351,7 +4355,7 @@ This function takes ownership of @list.</doc> c:identifier="gst_rtp_base_payload_set_options"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="779">Set the rtp options of the payloader. These options will be set in the caps + line="800">Set the rtp options of the payloader. These options will be set in the caps of the payloader. Subclasses must call this method before calling gst_rtp_base_payload_push() or gst_rtp_base_payload_set_outcaps().</doc> <source-position filename="gst-libs/gst/rtp/gstrtpbasepayload.h" @@ -4363,31 +4367,31 @@ gst_rtp_base_payload_push() or gst_rtp_base_payload_set_outcaps().</doc> <instance-parameter name="payload" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="781">a #GstRTPBasePayload</doc> + line="802">a #GstRTPBasePayload</doc> <type name="RTPBasePayload" c:type="GstRTPBasePayload*"/> </instance-parameter> <parameter name="media" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="782">the media type (typically "audio" or "video")</doc> + line="803">the media type (typically "audio" or "video")</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="dynamic" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="783">if the payload type is dynamic</doc> + line="804">if the payload type is dynamic</doc> <type name="gboolean" c:type="gboolean"/> </parameter> <parameter name="encoding_name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="784">the encoding name</doc> + line="805">the encoding name</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="clock_rate" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="785">the clock rate of the media</doc> + line="806">the clock rate of the media</doc> <type name="guint32" c:type="guint32"/> </parameter> </parameters> @@ -4397,7 +4401,7 @@ gst_rtp_base_payload_push() or gst_rtp_base_payload_set_outcaps().</doc> introspectable="0"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="831">Configure the output caps with the optional parameters. + line="852">Configure the output caps with the optional parameters. Variable arguments should be in the form field name, field type (as a GType), value(s). The last variable argument should be NULL.</doc> @@ -4406,26 +4410,26 @@ Variable arguments should be in the form field name, field type <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="842">%TRUE if the caps could be set.</doc> + line="863">%TRUE if the caps could be set.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="payload" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="833">a #GstRTPBasePayload</doc> + line="854">a #GstRTPBasePayload</doc> <type name="RTPBasePayload" c:type="GstRTPBasePayload*"/> </instance-parameter> <parameter name="fieldname" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="834">the first field name or %NULL</doc> + line="855">the first field name or %NULL</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="..." transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="835">field values</doc> + line="856">field values</doc> <varargs/> </parameter> </parameters> @@ -4435,7 +4439,7 @@ Variable arguments should be in the form field name, field type version="1.16"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="1789">Enable or disable adding contributing sources to RTP packets from + line="1811">Enable or disable adding contributing sources to RTP packets from #GstRTPSourceMeta.</doc> <source-position filename="gst-libs/gst/rtp/gstrtpbasepayload.h" line="181"/> @@ -4446,13 +4450,13 @@ Variable arguments should be in the form field name, field type <instance-parameter name="payload" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="1791">a #GstRTPBasePayload</doc> + line="1813">a #GstRTPBasePayload</doc> <type name="RTPBasePayload" c:type="GstRTPBasePayload*"/> </instance-parameter> <parameter name="enable" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="1792">whether to add contributing sources to RTP packets</doc> + line="1814">whether to add contributing sources to RTP packets</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -4463,7 +4467,7 @@ Variable arguments should be in the form field name, field type <property name="min-ptime" writable="1" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="242">Minimum duration of the packet data in ns (can't go above MTU)</doc> + line="247">Minimum duration of the packet data in ns (can't go above MTU)</doc> <type name="gint64" c:type="gint64"/> </property> <property name="mtu" writable="1" transfer-ownership="none"> @@ -4475,14 +4479,14 @@ Variable arguments should be in the form field name, field type transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="331">Make the payloader timestamp packets according to the Rate-Control=no + line="336">Make the payloader timestamp packets according to the Rate-Control=no behaviour specified in the ONVIF replay spec.</doc> <type name="gboolean" c:type="gboolean"/> </property> <property name="perfect-rtptime" writable="1" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="262">Try to use the offset fields to generate perfect RTP timestamps. When this + line="267">Try to use the offset fields to generate perfect RTP timestamps. When this option is disabled, RTP timestamps are generated from GST_BUFFER_PTS of each payloaded buffer. The PTSes of buffers may not necessarily increment with the amount of data in each input buffer, consider e.g. the case where @@ -4505,7 +4509,7 @@ timestamps for audio streams.</doc> <property name="ptime-multiple" writable="1" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="285">Force buffers to be multiples of this duration in ns (0 disables)</doc> + line="290">Force buffers to be multiples of this duration in ns (0 disables)</doc> <type name="gint64" c:type="gint64"/> </property> <property name="scale-rtptime" @@ -4514,7 +4518,7 @@ timestamps for audio streams.</doc> transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="367">Make the RTP packets' timestamps be scaled with the segment's rate + line="377">Make the RTP packets' timestamps be scaled with the segment's rate (corresponding to RTSP speed parameter). Disabling this property means the timestamps will not be affected by the set delivery speed (RTSP speed). @@ -4536,7 +4540,7 @@ server has this property disabled.</doc> transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="318">Enable writing the CSRC field in allocated RTP header based on RTP source + line="323">Enable writing the CSRC field in allocated RTP header based on RTP source information found in the input buffer's #GstRTPSourceMeta.</doc> <type name="gboolean" c:type="gboolean"/> </property> @@ -4546,7 +4550,7 @@ information found in the input buffer's #GstRTPSourceMeta.</doc> <property name="stats" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="296">Various payloader statistics retrieved atomically (and are therefore + line="301">Various payloader statistics retrieved atomically (and are therefore synchroized with each other), these can be used e.g. to generate an RTP-Info header. This property return a GstStructure named application/x-rtp-payload-stats containing the following fields relating to @@ -4568,21 +4572,6 @@ the last processed buffer and current state of the stream being payloaded: <property name="timestamp-offset" writable="1" transfer-ownership="none"> <type name="guint" c:type="guint"/> </property> - <property name="twcc-ext-id" - version="1.18" - writable="1" - transfer-ownership="none"> - <doc xml:space="preserve" - filename="gst-libs/gst/rtp/gstrtpbasepayload.c" - line="346">The RTP header-extension ID used for tagging buffers with Transport-Wide -Congestion Control sequence-numbers. - -To use this across multiple bundled streams (transport wide), the -GstRTPFunnel can mux TWCC sequence-numbers together. - -This is experimental, as it is still a draft and not yet a standard.</doc> - <type name="guint" c:type="guint"/> - </property> <field name="element"> <type name="Gst.Element" c:type="GstElement"/> </field> @@ -7723,7 +7712,7 @@ gst_rtcp_buffer_validate_reduced().</doc> <function name="rtcp_ntp_to_unix" c:identifier="gst_rtcp_ntp_to_unix"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2103">Converts an NTP time to UNIX nanoseconds. @ntptime can typically be + line="2119">Converts an NTP time to UNIX nanoseconds. @ntptime can typically be the NTP time of an SR RTCP message and contains, in the upper 32 bits, the number of seconds since 1900 and, in the lower 32 bits, the fractional seconds. The resulting value will be the number of nanoseconds since 1970.</doc> @@ -7731,14 +7720,14 @@ seconds. The resulting value will be the number of nanoseconds since 1970.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2112">the UNIX time for @ntptime in nanoseconds.</doc> + line="2128">the UNIX time for @ntptime in nanoseconds.</doc> <type name="guint64" c:type="guint64"/> </return-value> <parameters> <parameter name="ntptime" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2105">an NTP timestamp</doc> + line="2121">an NTP timestamp</doc> <type name="guint64" c:type="guint64"/> </parameter> </parameters> @@ -7747,13 +7736,13 @@ seconds. The resulting value will be the number of nanoseconds since 1970.</doc> c:identifier="gst_rtcp_sdes_name_to_type"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2205">Convert @name into a @GstRTCPSDESType. @name is typically a key in a + line="2221">Convert @name into a @GstRTCPSDESType. @name is typically a key in a #GstStructure containing SDES items.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="511"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2212">the #GstRTCPSDESType for @name or #GST_RTCP_SDES_PRIV when @name + line="2228">the #GstRTCPSDESType for @name or #GST_RTCP_SDES_PRIV when @name is a private sdes item.</doc> <type name="RTCPSDESType" c:type="GstRTCPSDESType"/> </return-value> @@ -7761,7 +7750,7 @@ is a private sdes item.</doc> <parameter name="name" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2207">a SDES name</doc> + line="2223">a SDES name</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -7770,20 +7759,20 @@ is a private sdes item.</doc> c:identifier="gst_rtcp_sdes_type_to_name"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2159">Converts @type to the string equivalent. The string is typically used as a + line="2175">Converts @type to the string equivalent. The string is typically used as a key in a #GstStructure containing SDES items.</doc> <source-position filename="gst-libs/gst/rtp/gstrtcpbuffer.h" line="508"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2166">the string equivalent of @type</doc> + line="2182">the string equivalent of @type</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> <parameter name="type" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2161">a #GstRTCPSDESType</doc> + line="2177">a #GstRTCPSDESType</doc> <type name="RTCPSDESType" c:type="GstRTCPSDESType"/> </parameter> </parameters> @@ -7791,7 +7780,7 @@ key in a #GstStructure containing SDES items.</doc> <function name="rtcp_unix_to_ntp" c:identifier="gst_rtcp_unix_to_ntp"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2130">Converts a UNIX timestamp in nanoseconds to an NTP time. The caller should + line="2146">Converts a UNIX timestamp in nanoseconds to an NTP time. The caller should pass a value with nanoseconds since 1970. The NTP time will, in the upper 32 bits, contain the number of seconds since 1900 and, in the lower 32 bits, the fractional seconds. The resulting value can be used as an ntptime @@ -7800,14 +7789,14 @@ for constructing SR RTCP packets.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2140">the NTP time for @unixtime.</doc> + line="2156">the NTP time for @unixtime.</doc> <type name="guint64" c:type="guint64"/> </return-value> <parameters> <parameter name="unixtime" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtp/gstrtcpbuffer.c" - line="2132">an UNIX timestamp in nanoseconds</doc> + line="2148">an UNIX timestamp in nanoseconds</doc> <type name="guint64" c:type="guint64"/> </parameter> </parameters> diff --git a/girs/GstRtsp-1.0.gir b/girs/GstRtsp-1.0.gir index 3724bc12fc..ccad01a614 100644 --- a/girs/GstRtsp-1.0.gir +++ b/girs/GstRtsp-1.0.gir @@ -29,6 +29,7 @@ and/or use gtk-doc annotations. --> </function-macro> <record name="RTSPAuthCredential" c:type="GstRTSPAuthCredential" + version="1.12" glib:type-name="GstRTSPAuthCredential" glib:get-type="gst_rtsp_auth_credential_get_type" c:symbol-prefix="rtsp_auth_credential"> @@ -36,7 +37,7 @@ and/or use gtk-doc annotations. --> filename="gst-libs/gst/rtsp/gstrtspmessage.h" line="284">RTSP Authentication credentials</doc> <source-position filename="gst-libs/gst/rtsp/gstrtspmessage.h" - line="301"/> + line="303"/> <field name="scheme" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/rtsp/gstrtspmessage.h" @@ -90,29 +91,30 @@ and/or use gtk-doc annotations. --> </enumeration> <record name="RTSPAuthParam" c:type="GstRTSPAuthParam" + version="1.12" glib:type-name="GstRTSPAuthParam" glib:get-type="gst_rtsp_auth_param_get_type" c:symbol-prefix="rtsp_auth_param"> <doc xml:space="preserve" filename="gst-libs/gst/rtsp/gstrtspmessage.h" - line="303">RTSP Authentication parameter</doc> + line="305">RTSP Authentication parameter</doc> <source-position filename="gst-libs/gst/rtsp/gstrtspmessage.h" - line="313"/> + line="317"/> <field name="name" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/rtsp/gstrtspmessage.h" - line="305">The name of the parameter</doc> + line="307">The name of the parameter</doc> <type name="utf8" c:type="gchar*"/> </field> <field name="value" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/rtsp/gstrtspmessage.h" - line="306">The value of the parameter</doc> + line="308">The value of the parameter</doc> <type name="utf8" c:type="gchar*"/> </field> <method name="copy" c:identifier="gst_rtsp_auth_param_copy"> <source-position filename="gst-libs/gst/rtsp/gstrtspmessage.h" - line="316"/> + line="320"/> <return-value transfer-ownership="full"> <type name="RTSPAuthParam" c:type="GstRTSPAuthParam*"/> </return-value> @@ -124,7 +126,7 @@ and/or use gtk-doc annotations. --> </method> <method name="free" c:identifier="gst_rtsp_auth_param_free"> <source-position filename="gst-libs/gst/rtsp/gstrtspmessage.h" - line="318"/> + line="322"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -3190,7 +3192,7 @@ for transmission.</doc> filename="gst-libs/gst/rtsp/gstrtspmessage.c" line="1193">Dump the contents of @msg to stdout.</doc> <source-position filename="gst-libs/gst/rtsp/gstrtspmessage.h" - line="339"/> + line="343"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/rtsp/gstrtspmessage.c" @@ -3586,7 +3588,7 @@ response message.</doc> filename="gst-libs/gst/rtsp/gstrtspmessage.c" line="1441">Parses the credentials given in a WWW-Authenticate or Authorization header.</doc> <source-position filename="gst-libs/gst/rtsp/gstrtspmessage.h" - line="321"/> + line="325"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/rtsp/gstrtspmessage.c" @@ -6641,7 +6643,7 @@ not equal #GST_RTSP_OK.</doc> line="1543">Free a %NULL-terminated array of credentials returned from gst_rtsp_message_parse_auth_credentials().</doc> <source-position filename="gst-libs/gst/rtsp/gstrtspmessage.h" - line="324"/> + line="328"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> diff --git a/girs/GstSdp-1.0.gir b/girs/GstSdp-1.0.gir index 6a1d4b7d29..b6ee5847fa 100644 --- a/girs/GstSdp-1.0.gir +++ b/girs/GstSdp-1.0.gir @@ -5943,7 +5943,7 @@ stack and initialized with gst_sdp_message_init().</doc> <parameter name="text" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/sdp/gstsdpmessage.c" - line="242">A dynamically allocated string representing the SDP description</doc> + line="241">A dynamically allocated string representing the SDP description</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="msg" @@ -5952,7 +5952,7 @@ stack and initialized with gst_sdp_message_init().</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/sdp/gstsdpmessage.c" - line="241">pointer to new #GstSDPMessage</doc> + line="242">pointer to new #GstSDPMessage</doc> <type name="SDPMessage" c:type="GstSDPMessage**"/> </parameter> </parameters> @@ -6522,7 +6522,7 @@ a=extmap:(id)[/direction] (extensionname) (extensionattributes)</doc> <parameter name="text" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/sdp/gstsdpmessage.c" - line="242">A dynamically allocated string representing the SDP description</doc> + line="241">A dynamically allocated string representing the SDP description</doc> <type name="utf8" c:type="const gchar*"/> </parameter> <parameter name="msg" @@ -6531,7 +6531,7 @@ a=extmap:(id)[/direction] (extensionname) (extensionattributes)</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/sdp/gstsdpmessage.c" - line="241">pointer to new #GstSDPMessage</doc> + line="242">pointer to new #GstSDPMessage</doc> <type name="SDPMessage" c:type="GstSDPMessage**"/> </parameter> </parameters> diff --git a/girs/GstTag-1.0.gir b/girs/GstTag-1.0.gir index 79b4270238..01321ebdf7 100644 --- a/girs/GstTag-1.0.gir +++ b/girs/GstTag-1.0.gir @@ -1407,7 +1407,7 @@ the schema wasn't in the list</doc> c:identifier="gst_tag_check_language_code"> <doc xml:space="preserve" filename="gst-libs/gst/tag/lang.c" - line="482">Check if a given string contains a known ISO 639 language code. + line="486">Check if a given string contains a known ISO 639 language code. This is useful in situations where it's not clear whether a given string is a language code (which should be put into a #GST_TAG_LANGUAGE_CODE @@ -1417,7 +1417,7 @@ tag) or a free-form language name descriptor (which should be put into a <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/tag/lang.c" - line="493">TRUE if the two- or three-letter language code in @lang_code + line="497">TRUE if the two- or three-letter language code in @lang_code is a valid ISO-639 language code.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -1425,7 +1425,7 @@ tag) or a free-form language name descriptor (which should be put into a <parameter name="lang_code" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/tag/lang.c" - line="484">ISO-639 language code (e.g. "deu" or "ger" or "de")</doc> + line="488">ISO-639 language code (e.g. "deu" or "ger" or "de")</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -1612,7 +1612,7 @@ Language codes are case-sensitive and expected to be lower case.</doc> c:identifier="gst_tag_get_language_code_iso_639_2B"> <doc xml:space="preserve" filename="gst-libs/gst/tag/lang.c" - line="448">Returns three-letter ISO-639-2 "bibliographic" language code given a + line="452">Returns three-letter ISO-639-2 "bibliographic" language code given a two-letter ISO-639-1 language code or a three-letter ISO-639-2 language code (both are accepted for convenience). @@ -1625,7 +1625,7 @@ Language codes are case-sensitive and expected to be lower case.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/tag/lang.c" - line="462">three-letter ISO-639-2 language code string that maps to @lang_code, + line="466">three-letter ISO-639-2 language code string that maps to @lang_code, or NULL if no mapping is known. The returned string must not be modified or freed.</doc> <type name="utf8" c:type="const gchar*"/> @@ -1634,7 +1634,7 @@ Language codes are case-sensitive and expected to be lower case.</doc> <parameter name="lang_code" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/tag/lang.c" - line="450">ISO-639 language code (e.g. "deu" or "ger" or "de")</doc> + line="454">ISO-639 language code (e.g. "deu" or "ger" or "de")</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -1643,7 +1643,7 @@ Language codes are case-sensitive and expected to be lower case.</doc> c:identifier="gst_tag_get_language_code_iso_639_2T"> <doc xml:space="preserve" filename="gst-libs/gst/tag/lang.c" - line="414">Returns three-letter ISO-639-2 "terminological" language code given a + line="418">Returns three-letter ISO-639-2 "terminological" language code given a two-letter ISO-639-1 language code or a three-letter ISO-639-2 language code (both are accepted for convenience). @@ -1656,7 +1656,7 @@ Language codes are case-sensitive and expected to be lower case.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/tag/lang.c" - line="428">three-letter ISO-639-2 language code string that maps to @lang_code, + line="432">three-letter ISO-639-2 language code string that maps to @lang_code, or NULL if no mapping is known. The returned string must not be modified or freed.</doc> <type name="utf8" c:type="const gchar*"/> @@ -1665,7 +1665,7 @@ Language codes are case-sensitive and expected to be lower case.</doc> <parameter name="lang_code" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/tag/lang.c" - line="416">ISO-639 language code (e.g. "deu" or "ger" or "de")</doc> + line="420">ISO-639 language code (e.g. "deu" or "ger" or "de")</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> diff --git a/girs/GstVideo-1.0.gir b/girs/GstVideo-1.0.gir index bc0825f80e..3373b95ccd 100644 --- a/girs/GstVideo-1.0.gir +++ b/girs/GstVideo-1.0.gir @@ -2615,14 +2615,14 @@ by any element in the pipeline (Since: 1.6)</doc> introspectable="0"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="629">Generic caps string for video, for use in pad templates.</doc> + line="648">Generic caps string for video, for use in pad templates.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="616"/> + line="635"/> <parameters> <parameter name="format"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="631">string format that describes the pixel layout, as string + line="650">string format that describes the pixel layout, as string (e.g. "I420", "RGB", "YV12", "YUY2", "AYUV", etc.)</doc> </parameter> </parameters> @@ -2633,20 +2633,20 @@ by any element in the pipeline (Since: 1.6)</doc> introspectable="0"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="643">Generic caps string for video, for use in pad templates.</doc> + line="662">Generic caps string for video, for use in pad templates.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="634"/> + line="653"/> <parameters> <parameter name="features"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="647">Requires caps features as a string, e.g. + line="666">Requires caps features as a string, e.g. "memory:SystemMemory".</doc> </parameter> <parameter name="format"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="645">string format that describes the pixel layout, as string + line="664">string format that describes the pixel layout, as string (e.g. "I420", "RGB", "YV12", "YUY2", "AYUV", etc.)</doc> </parameter> </parameters> @@ -2896,96 +2896,96 @@ detect such a synchronization point.</doc> <constant name="VIDEO_COLORIMETRY_BT2020" value="bt2020" c:type="GST_VIDEO_COLORIMETRY_BT2020"> - <source-position filename="gst-libs/gst/video/video-color.h" line="220"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="244"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="VIDEO_COLORIMETRY_BT2020_10" value="bt2020-10" c:type="GST_VIDEO_COLORIMETRY_BT2020_10"> - <source-position filename="gst-libs/gst/video/video-color.h" line="221"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="245"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="VIDEO_COLORIMETRY_BT2100_HLG" value="bt2100-hlg" c:type="GST_VIDEO_COLORIMETRY_BT2100_HLG"> - <source-position filename="gst-libs/gst/video/video-color.h" line="223"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="247"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="VIDEO_COLORIMETRY_BT2100_PQ" value="bt2100-pq" c:type="GST_VIDEO_COLORIMETRY_BT2100_PQ"> - <source-position filename="gst-libs/gst/video/video-color.h" line="222"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="246"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="VIDEO_COLORIMETRY_BT601" value="bt601" c:type="GST_VIDEO_COLORIMETRY_BT601"> - <source-position filename="gst-libs/gst/video/video-color.h" line="216"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="240"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="VIDEO_COLORIMETRY_BT709" value="bt709" c:type="GST_VIDEO_COLORIMETRY_BT709"> - <source-position filename="gst-libs/gst/video/video-color.h" line="217"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="241"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="VIDEO_COLORIMETRY_SMPTE240M" value="smpte240m" c:type="GST_VIDEO_COLORIMETRY_SMPTE240M"> - <source-position filename="gst-libs/gst/video/video-color.h" line="218"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="242"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="VIDEO_COLORIMETRY_SRGB" value="sRGB" c:type="GST_VIDEO_COLORIMETRY_SRGB"> - <source-position filename="gst-libs/gst/video/video-color.h" line="219"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="243"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="VIDEO_COMP_A" value="3" c:type="GST_VIDEO_COMP_A"> <source-position filename="gst-libs/gst/video/video-format.h" - line="290"/> + line="309"/> <type name="gint" c:type="gint"/> </constant> <constant name="VIDEO_COMP_B" value="2" c:type="GST_VIDEO_COMP_B"> <source-position filename="gst-libs/gst/video/video-format.h" - line="287"/> + line="306"/> <type name="gint" c:type="gint"/> </constant> <constant name="VIDEO_COMP_G" value="1" c:type="GST_VIDEO_COMP_G"> <source-position filename="gst-libs/gst/video/video-format.h" - line="286"/> + line="305"/> <type name="gint" c:type="gint"/> </constant> <constant name="VIDEO_COMP_INDEX" value="0" c:type="GST_VIDEO_COMP_INDEX"> <source-position filename="gst-libs/gst/video/video-format.h" - line="293"/> + line="312"/> <type name="gint" c:type="gint"/> </constant> <constant name="VIDEO_COMP_PALETTE" value="1" c:type="GST_VIDEO_COMP_PALETTE"> <source-position filename="gst-libs/gst/video/video-format.h" - line="294"/> + line="313"/> <type name="gint" c:type="gint"/> </constant> <constant name="VIDEO_COMP_R" value="0" c:type="GST_VIDEO_COMP_R"> <source-position filename="gst-libs/gst/video/video-format.h" - line="285"/> + line="304"/> <type name="gint" c:type="gint"/> </constant> <constant name="VIDEO_COMP_U" value="1" c:type="GST_VIDEO_COMP_U"> <source-position filename="gst-libs/gst/video/video-format.h" - line="281"/> + line="300"/> <type name="gint" c:type="gint"/> </constant> <constant name="VIDEO_COMP_V" value="2" c:type="GST_VIDEO_COMP_V"> <source-position filename="gst-libs/gst/video/video-format.h" - line="282"/> + line="301"/> <type name="gint" c:type="gint"/> </constant> <constant name="VIDEO_COMP_Y" value="0" c:type="GST_VIDEO_COMP_Y"> <source-position filename="gst-libs/gst/video/video-format.h" - line="280"/> + line="299"/> <type name="gint" c:type="gint"/> </constant> <constant name="VIDEO_CONVERTER_OPT_ALPHA_MODE" @@ -3678,11 +3678,11 @@ return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK).</do </parameters> </function-macro> <constant name="VIDEO_FORMATS_ALL" - value="{ AYUV64, ARGB64, GBRA_12BE, GBRA_12LE, Y412_BE, Y412_LE, A444_10BE, GBRA_10BE, A444_10LE, GBRA_10LE, A422_10BE, A422_10LE, A420_10BE, A420_10LE, Y410, RGB10A2_LE, BGR10A2_LE, GBRA, ABGR, VUYA, BGRA, AYUV, ARGB, RGBA, A420, Y444_16BE, Y444_16LE, v216, P016_BE, P016_LE, Y444_12BE, GBR_12BE, Y444_12LE, GBR_12LE, I422_12BE, I422_12LE, Y212_BE, Y212_LE, I420_12BE, I420_12LE, P012_BE, P012_LE, Y444_10BE, GBR_10BE, Y444_10LE, GBR_10LE, r210, I422_10BE, I422_10LE, NV16_10LE32, Y210, v210, UYVP, I420_10BE, I420_10LE, P010_10BE, P010_10LE, NV12_10LE32, NV12_10LE40, Y444, GBR, NV24, xBGR, BGRx, xRGB, RGBx, BGR, IYU2, v308, RGB, Y42B, NV61, NV16, VYUY, UYVY, YVYU, YUY2, I420, YV12, NV21, NV12, NV12_64Z32, Y41B, IYU1, YVU9, YUV9, RGB16, BGR16, RGB15, BGR15, RGB8P, GRAY16_BE, GRAY16_LE, GRAY10_LE32, GRAY8 }" + value="{ AYUV64, ARGB64, GBRA_12BE, GBRA_12LE, Y412_BE, Y412_LE, A444_10BE, GBRA_10BE, A444_10LE, GBRA_10LE, A422_10BE, A422_10LE, A420_10BE, A420_10LE, Y410, RGB10A2_LE, BGR10A2_LE, GBRA, ABGR, VUYA, BGRA, AYUV, ARGB, RGBA, A420, Y444_16BE, Y444_16LE, v216, P016_BE, P016_LE, Y444_12BE, GBR_12BE, Y444_12LE, GBR_12LE, I422_12BE, I422_12LE, Y212_BE, Y212_LE, I420_12BE, I420_12LE, P012_BE, P012_LE, Y444_10BE, GBR_10BE, Y444_10LE, GBR_10LE, r210, I422_10BE, I422_10LE, NV16_10LE32, Y210, v210, UYVP, I420_10BE, I420_10LE, P010_10BE, P010_10LE, NV12_10LE32, NV12_10LE40, Y444, GBR, NV24, xBGR, BGRx, xRGB, RGBx, BGR, IYU2, v308, RGB, Y42B, NV61, NV16, VYUY, UYVY, YVYU, YUY2, I420, YV12, NV21, NV12, NV12_64Z32, NV12_4L4, NV12_32L32, Y41B, IYU1, YVU9, YUV9, RGB16, BGR16, RGB15, BGR15, RGB8P, GRAY16_BE, GRAY16_LE, GRAY10_LE32, GRAY8 }" c:type="GST_VIDEO_FORMATS_ALL"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="581">List of all video formats, for use in template caps strings. + line="600">List of all video formats, for use in template caps strings. Formats are sorted by decreasing "quality", using these criteria by priority: - number of components @@ -3698,14 +3698,14 @@ Formats are sorted by decreasing "quality", using these criteria by priority: - prefer I420 over YV12 - format name</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="601"/> + line="620"/> <type name="utf8" c:type="gchar*"/> </constant> <function-macro name="VIDEO_FORMAT_INFO_BITS" c:identifier="GST_VIDEO_FORMAT_INFO_BITS" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="469"/> + line="488"/> <parameters> <parameter name="info"> </parameter> @@ -3715,7 +3715,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:identifier="GST_VIDEO_FORMAT_INFO_DATA" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="520"/> + line="539"/> <parameters> <parameter name="info"> </parameter> @@ -3729,7 +3729,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:identifier="GST_VIDEO_FORMAT_INFO_DEPTH" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="472"/> + line="491"/> <parameters> <parameter name="info"> </parameter> @@ -3741,7 +3741,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:identifier="GST_VIDEO_FORMAT_INFO_FLAGS" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="458"/> + line="477"/> <parameters> <parameter name="info"> </parameter> @@ -3751,7 +3751,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:identifier="GST_VIDEO_FORMAT_INFO_FORMAT" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="456"/> + line="475"/> <parameters> <parameter name="info"> </parameter> @@ -3761,7 +3761,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:identifier="GST_VIDEO_FORMAT_INFO_HAS_ALPHA" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="463"/> + line="482"/> <parameters> <parameter name="info"> </parameter> @@ -3771,7 +3771,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:identifier="GST_VIDEO_FORMAT_INFO_HAS_PALETTE" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="465"/> + line="484"/> <parameters> <parameter name="info"> </parameter> @@ -3781,7 +3781,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:identifier="GST_VIDEO_FORMAT_INFO_H_SUB" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="512"/> + line="531"/> <parameters> <parameter name="info"> </parameter> @@ -3793,7 +3793,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:identifier="GST_VIDEO_FORMAT_INFO_IS_COMPLEX" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="466"/> + line="485"/> <parameters> <parameter name="info"> </parameter> @@ -3803,7 +3803,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:identifier="GST_VIDEO_FORMAT_INFO_IS_GRAY" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="462"/> + line="481"/> <parameters> <parameter name="info"> </parameter> @@ -3813,7 +3813,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:identifier="GST_VIDEO_FORMAT_INFO_IS_LE" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="464"/> + line="483"/> <parameters> <parameter name="info"> </parameter> @@ -3823,7 +3823,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:identifier="GST_VIDEO_FORMAT_INFO_IS_RGB" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="461"/> + line="480"/> <parameters> <parameter name="info"> </parameter> @@ -3833,7 +3833,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:identifier="GST_VIDEO_FORMAT_INFO_IS_TILED" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="467"/> + line="486"/> <parameters> <parameter name="info"> </parameter> @@ -3843,7 +3843,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:identifier="GST_VIDEO_FORMAT_INFO_IS_YUV" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="460"/> + line="479"/> <parameters> <parameter name="info"> </parameter> @@ -3853,7 +3853,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:identifier="GST_VIDEO_FORMAT_INFO_NAME" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="457"/> + line="476"/> <parameters> <parameter name="info"> </parameter> @@ -3863,7 +3863,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:identifier="GST_VIDEO_FORMAT_INFO_N_COMPONENTS" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="470"/> + line="489"/> <parameters> <parameter name="info"> </parameter> @@ -3874,7 +3874,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: introspectable="0"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="488">Number of planes. This is the number of planes the pixel layout is + line="507">Number of planes. This is the number of planes the pixel layout is organized in in memory. The number of planes can be less than the number of components (e.g. Y,U,V,A or R, G, B, A) when multiple components are packed into one plane. @@ -3882,12 +3882,12 @@ components are packed into one plane. Examples: RGB/RGBx/RGBA: 1 plane, 3/3/4 components; I420: 3 planes, 3 components; NV21/NV12: 2 planes, 3 components.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="500"/> + line="519"/> <parameters> <parameter name="info"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="490">a #GstVideoFormatInfo</doc> + line="509">a #GstVideoFormatInfo</doc> </parameter> </parameters> </function-macro> @@ -3895,7 +3895,7 @@ I420: 3 planes, 3 components; NV21/NV12: 2 planes, 3 components.</doc> c:identifier="GST_VIDEO_FORMAT_INFO_OFFSET" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="534"/> + line="553"/> <parameters> <parameter name="info"> </parameter> @@ -3910,20 +3910,20 @@ I420: 3 planes, 3 components; NV21/NV12: 2 planes, 3 components.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="501">Plane number where the given component can be found. A plane may + line="520">Plane number where the given component can be found. A plane may contain data for multiple components.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="509"/> + line="528"/> <parameters> <parameter name="info"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="503">a #GstVideoFormatInfo</doc> + line="522">a #GstVideoFormatInfo</doc> </parameter> <parameter name="c"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="504">the component index</doc> + line="523">the component index</doc> </parameter> </parameters> </function-macro> @@ -3931,7 +3931,7 @@ contain data for multiple components.</doc> c:identifier="GST_VIDEO_FORMAT_INFO_POFFSET" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="510"/> + line="529"/> <parameters> <parameter name="info"> </parameter> @@ -3944,7 +3944,7 @@ contain data for multiple components.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="473">pixel stride for the given component. This is the amount of bytes to the + line="492">pixel stride for the given component. This is the amount of bytes to the pixel immediately to the right, so basically bytes from one pixel to the next. When bits < 8, the stride is expressed in bits. @@ -3953,17 +3953,17 @@ would be 4 bytes for RGBx or ARGB, and 8 bytes for ARGB64 or AYUV64. For planar formats such as I420 the pixel stride is usually 1. For YUY2 it would be 2 bytes.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="487"/> + line="506"/> <parameters> <parameter name="info"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="475">a #GstVideoFormatInfo</doc> + line="494">a #GstVideoFormatInfo</doc> </parameter> <parameter name="c"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="476">the component index</doc> + line="495">the component index</doc> </parameter> </parameters> </function-macro> @@ -3971,7 +3971,7 @@ YUY2 it would be 2 bytes.</doc> c:identifier="GST_VIDEO_FORMAT_INFO_SCALE_HEIGHT" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="518"/> + line="537"/> <parameters> <parameter name="info"> </parameter> @@ -3985,7 +3985,7 @@ YUY2 it would be 2 bytes.</doc> c:identifier="GST_VIDEO_FORMAT_INFO_SCALE_WIDTH" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="517"/> + line="536"/> <parameters> <parameter name="info"> </parameter> @@ -3999,7 +3999,7 @@ YUY2 it would be 2 bytes.</doc> c:identifier="GST_VIDEO_FORMAT_INFO_SHIFT" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="471"/> + line="490"/> <parameters> <parameter name="info"> </parameter> @@ -4012,27 +4012,27 @@ YUY2 it would be 2 bytes.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="522">Row stride in bytes, that is number of bytes from the first pixel component + line="541">Row stride in bytes, that is number of bytes from the first pixel component of a row to the first pixel component in the next row. This might include some row padding (memory not actually used for anything, to make sure the beginning of the next row is aligned in a particular way).</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="533"/> + line="552"/> <parameters> <parameter name="info"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="524">a #GstVideoFormatInfo</doc> + line="543">a #GstVideoFormatInfo</doc> </parameter> <parameter name="strides"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="525">an array of strides</doc> + line="544">an array of strides</doc> </parameter> <parameter name="comp"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="526">the component index</doc> + line="545">the component index</doc> </parameter> </parameters> </function-macro> @@ -4040,7 +4040,7 @@ beginning of the next row is aligned in a particular way).</doc> c:identifier="GST_VIDEO_FORMAT_INFO_TILE_HS" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="539"/> + line="558"/> <parameters> <parameter name="info"> </parameter> @@ -4050,7 +4050,7 @@ beginning of the next row is aligned in a particular way).</doc> c:identifier="GST_VIDEO_FORMAT_INFO_TILE_MODE" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="537"/> + line="556"/> <parameters> <parameter name="info"> </parameter> @@ -4060,7 +4060,7 @@ beginning of the next row is aligned in a particular way).</doc> c:identifier="GST_VIDEO_FORMAT_INFO_TILE_WS" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="538"/> + line="557"/> <parameters> <parameter name="info"> </parameter> @@ -4070,7 +4070,7 @@ beginning of the next row is aligned in a particular way).</doc> c:identifier="GST_VIDEO_FORMAT_INFO_W_SUB" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="511"/> + line="530"/> <parameters> <parameter name="info"> </parameter> @@ -4082,7 +4082,7 @@ beginning of the next row is aligned in a particular way).</doc> value="(fraction) [ 0, max ]" c:type="GST_VIDEO_FPS_RANGE"> <source-position filename="gst-libs/gst/video/video-format.h" - line="571"/> + line="590"/> <type name="utf8" c:type="gchar*"/> </constant> <function-macro name="VIDEO_FRAME_COMP_DATA" @@ -4768,12 +4768,12 @@ It is not valid to use this macro with a TILED format.</doc> value="4" c:type="GST_VIDEO_MAX_COMPONENTS"> <source-position filename="gst-libs/gst/video/video-format.h" - line="239"/> + line="258"/> <type name="gint" c:type="gint"/> </constant> <constant name="VIDEO_MAX_PLANES" value="4" c:type="GST_VIDEO_MAX_PLANES"> <source-position filename="gst-libs/gst/video/video-format.h" - line="238"/> + line="257"/> <type name="gint" c:type="gint"/> </constant> <function-macro name="VIDEO_META_TRANSFORM_IS_SCALE" @@ -4790,7 +4790,7 @@ It is not valid to use this macro with a TILED format.</doc> c:identifier="GST_VIDEO_NE" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="574"/> + line="593"/> <parameters> <parameter name="s"> </parameter> @@ -4800,7 +4800,7 @@ It is not valid to use this macro with a TILED format.</doc> c:identifier="GST_VIDEO_OE" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="575"/> + line="594"/> <parameters> <parameter name="s"> </parameter> @@ -5058,14 +5058,14 @@ quatization errors.</doc> value="(int) [ 1, max ]" c:type="GST_VIDEO_SIZE_RANGE"> <source-position filename="gst-libs/gst/video/video-format.h" - line="570"/> + line="589"/> <type name="utf8" c:type="gchar*"/> </constant> <function-macro name="VIDEO_SUB_SCALE" c:identifier="GST_VIDEO_SUB_SCALE" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="515"/> + line="534"/> <parameters> <parameter name="scale"> </parameter> @@ -5751,7 +5751,7 @@ See #GstVideoAggregator for more details.</doc> c:identifier="gst_video_aggregator_convert_pad_update_conversion_info"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoaggregator.c" - line="667">Requests the pad to check and update the converter before the next usage to + line="686">Requests the pad to check and update the converter before the next usage to update for any changes that have happened.</doc> <source-position filename="gst-libs/gst/video/gstvideoaggregator.h" line="168"/> @@ -5762,7 +5762,7 @@ update for any changes that have happened.</doc> <instance-parameter name="pad" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoaggregator.c" - line="669">a #GstVideoAggregatorPad</doc> + line="688">a #GstVideoAggregatorPad</doc> <type name="VideoAggregatorConvertPad" c:type="GstVideoAggregatorConvertPad*"/> </instance-parameter> @@ -5892,7 +5892,7 @@ update for any changes that have happened.</doc> c:identifier="gst_video_aggregator_pad_get_current_buffer"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoaggregator.c" - line="303">Returns the currently queued buffer that is going to be used + line="321">Returns the currently queued buffer that is going to be used for the current output frame. This must only be called from the #GstVideoAggregatorClass::aggregate_frames virtual method, @@ -5905,14 +5905,14 @@ returns.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoaggregator.c" - line="316">The currently queued buffer</doc> + line="334">The currently queued buffer</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </return-value> <parameters> <instance-parameter name="pad" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoaggregator.c" - line="305">a #GstVideoAggregatorPad</doc> + line="323">a #GstVideoAggregatorPad</doc> <type name="VideoAggregatorPad" c:type="GstVideoAggregatorPad*"/> </instance-parameter> </parameters> @@ -5921,7 +5921,7 @@ returns.</doc> c:identifier="gst_video_aggregator_pad_get_prepared_frame"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoaggregator.c" - line="326">Returns the currently prepared video frame that has to be aggregated into + line="344">Returns the currently prepared video frame that has to be aggregated into the current output frame. This must only be called from the #GstVideoAggregatorClass::aggregate_frames virtual method, @@ -5934,14 +5934,14 @@ returns.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoaggregator.c" - line="339">The currently prepared video frame</doc> + line="357">The currently prepared video frame</doc> <type name="VideoFrame" c:type="GstVideoFrame*"/> </return-value> <parameters> <instance-parameter name="pad" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoaggregator.c" - line="328">a #GstVideoAggregatorPad</doc> + line="346">a #GstVideoAggregatorPad</doc> <type name="VideoAggregatorPad" c:type="GstVideoAggregatorPad*"/> </instance-parameter> </parameters> @@ -5950,7 +5950,7 @@ returns.</doc> c:identifier="gst_video_aggregator_pad_has_current_buffer"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoaggregator.c" - line="283">Checks if the pad currently has a buffer queued that is going to be used + line="301">Checks if the pad currently has a buffer queued that is going to be used for the current output frame. This must only be called from the #GstVideoAggregatorClass::aggregate_frames virtual method, @@ -5960,14 +5960,14 @@ or from the #GstVideoAggregatorPadClass::prepare_frame virtual method of the agg <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoaggregator.c" - line="293">%TRUE if the pad has currently a buffer queued</doc> + line="311">%TRUE if the pad has currently a buffer queued</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="pad" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoaggregator.c" - line="285">a #GstVideoAggregatorPad</doc> + line="303">a #GstVideoAggregatorPad</doc> <type name="VideoAggregatorPad" c:type="GstVideoAggregatorPad*"/> </instance-parameter> </parameters> @@ -5976,7 +5976,7 @@ or from the #GstVideoAggregatorPadClass::prepare_frame virtual method of the agg c:identifier="gst_video_aggregator_pad_set_needs_alpha"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoaggregator.c" - line="349">Allows selecting that this pad requires an output format with alpha</doc> + line="367">Allows selecting that this pad requires an output format with alpha</doc> <source-position filename="gst-libs/gst/video/gstvideoaggregator.h" line="113"/> <return-value transfer-ownership="none"> @@ -5986,13 +5986,13 @@ or from the #GstVideoAggregatorPadClass::prepare_frame virtual method of the agg <instance-parameter name="pad" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoaggregator.c" - line="351">a #GstVideoAggregatorPad</doc> + line="369">a #GstVideoAggregatorPad</doc> <type name="VideoAggregatorPad" c:type="GstVideoAggregatorPad*"/> </instance-parameter> <parameter name="needs_alpha" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoaggregator.c" - line="352">%TRUE if this pad requires alpha output</doc> + line="370">%TRUE if this pad requires alpha output</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -6352,7 +6352,7 @@ the parity check bits).</doc> <record name="VideoBarMeta" c:type="GstVideoBarMeta" version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="270">Bar data should be included in video user data + line="268">Bar data should be included in video user data whenever the rectangular picture area containing useful information does not extend to the full height or width of the coded frame and AFD alone is insufficient to describe the extent of the image. @@ -6364,29 +6364,29 @@ For more details, see: https://www.atsc.org/wp-content/uploads/2015/03/a_53-Part-4-2009.pdf and SMPTE ST2016-1</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="306"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="304"/> <field name="meta" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="272">parent #GstMeta</doc> + line="270">parent #GstMeta</doc> <type name="Gst.Meta" c:type="GstMeta"/> </field> <field name="field" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="273">0 for progressive or field 1 and 1 for field 2</doc> + line="271">0 for progressive or field 1 and 1 for field 2</doc> <type name="guint8" c:type="guint8"/> </field> <field name="is_letterbox" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="274">if true then bar data specifies letterbox, otherwise pillarbox</doc> + line="272">if true then bar data specifies letterbox, otherwise pillarbox</doc> <type name="gboolean" c:type="gboolean"/> </field> <field name="bar_data1" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="275">If @is_letterbox is true, then the value specifies the + line="273">If @is_letterbox is true, then the value specifies the last line of a horizontal letterbox bar area at top of reconstructed frame. Otherwise, it specifies the last horizontal luminance sample of a vertical pillarbox bar area at the left side of the reconstructed frame</doc> @@ -6395,14 +6395,14 @@ and SMPTE ST2016-1</doc> <field name="bar_data2" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="279">If @is_letterbox is true, then the value specifies the + line="277">If @is_letterbox is true, then the value specifies the first line of a horizontal letterbox bar area at bottom of reconstructed frame. Otherwise, it specifies the first horizontal luminance sample of a vertical pillarbox bar area at the right side of the reconstructed frame.</doc> <type name="guint" c:type="guint"/> </field> <function name="get_info" c:identifier="gst_video_bar_meta_get_info"> - <source-position filename="gst-libs/gst/video/video-anc.h" line="311"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="309"/> <return-value transfer-ownership="none"> <type name="Gst.MetaInfo" c:type="const GstMetaInfo*"/> </return-value> @@ -6580,24 +6580,24 @@ supports all the video bufferpool options.</doc> version="1.16"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="387">Extra buffer metadata providing Closed Caption.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="404"/> + line="375">Extra buffer metadata providing Closed Caption.</doc> + <source-position filename="gst-libs/gst/video/video-anc.h" line="392"/> <field name="meta" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="389">parent #GstMeta</doc> + line="377">parent #GstMeta</doc> <type name="Gst.Meta" c:type="GstMeta"/> </field> <field name="caption_type" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="390">The type of Closed Caption contained in the meta.</doc> + line="378">The type of Closed Caption contained in the meta.</doc> <type name="VideoCaptionType" c:type="GstVideoCaptionType"/> </field> <field name="data" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="391">The Closed Caption data.</doc> + line="379">The Closed Caption data.</doc> <array length="3" zero-terminated="0" c:type="guint8*"> <type name="guint8" c:type="guint8"/> </array> @@ -6605,11 +6605,11 @@ supports all the video bufferpool options.</doc> <field name="size" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="392">The size in bytes of @data</doc> + line="380">The size in bytes of @data</doc> <type name="gsize" c:type="gsize"/> </field> <function name="get_info" c:identifier="gst_video_caption_meta_get_info"> - <source-position filename="gst-libs/gst/video/video-anc.h" line="411"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="399"/> <return-value transfer-ownership="none"> <type name="Gst.MetaInfo" c:type="const GstMetaInfo*"/> </return-value> @@ -6622,14 +6622,14 @@ supports all the video bufferpool options.</doc> c:type="GstVideoCaptionType"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="342">The various known types of Closed Caption (CC).</doc> + line="330">The various known types of Closed Caption (CC).</doc> <member name="unknown" value="0" c:identifier="GST_VIDEO_CAPTION_TYPE_UNKNOWN" glib:nick="unknown"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="344">Unknown type of CC</doc> + line="332">Unknown type of CC</doc> </member> <member name="cea608_raw" value="1" @@ -6637,7 +6637,7 @@ supports all the video bufferpool options.</doc> glib:nick="cea608-raw"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="345">CEA-608 as byte pairs. Note that + line="333">CEA-608 as byte pairs. Note that this format is not recommended since is does not specify to which field the caption comes from and therefore assumes it comes from the first field (and that there is no information @@ -6651,7 +6651,7 @@ supports all the video bufferpool options.</doc> glib:nick="cea608-s334-1a"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="352">CEA-608 as byte triplets as defined + line="340">CEA-608 as byte triplets as defined in SMPTE S334-1 Annex A. The second and third byte of the byte triplet is the raw CEA608 data, the first byte is a bitfield: The top/7th bit is 0 for the second field, 1 for the first field, bit 6 and 5 are 0 and @@ -6666,7 +6666,7 @@ supports all the video bufferpool options.</doc> glib:nick="cea708-raw"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="360">CEA-708 as cc_data byte triplets. They + line="348">CEA-708 as cc_data byte triplets. They can also contain 608-in-708 and the first byte of each triplet has to be inspected for detecting the type.</doc> </member> @@ -6676,7 +6676,7 @@ supports all the video bufferpool options.</doc> glib:nick="cea708-cdp"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="363">CEA-708 (and optionally CEA-608) in + line="351">CEA-708 (and optionally CEA-608) in a CDP (Caption Distribution Packet) defined by SMPTE S-334-2. Contains the whole CDP (starting with 0x9669).</doc> </member> @@ -6687,7 +6687,7 @@ supports all the video bufferpool options.</doc> filename="gst-libs/gst/video/video-anc.c" line="1051">Parses fixed Closed Caption #GstCaps and returns the corresponding caption type, or %GST_VIDEO_CAPTION_TYPE_UNKNOWN.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="381"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="369"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" @@ -6709,7 +6709,7 @@ type, or %GST_VIDEO_CAPTION_TYPE_UNKNOWN.</doc> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" line="1091">Creates new caps corresponding to @type.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="385"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="373"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" @@ -7412,7 +7412,8 @@ non-linear RGB (R'G'B')</doc> glib:nick="rgb"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="48">identity matrix</doc> + line="48">identity matrix. Order of coefficients is +actually GBR, also IEC 61966-2-1 (sRGB)</doc> </member> <member name="fcc" value="2" @@ -7420,7 +7421,7 @@ non-linear RGB (R'G'B')</doc> glib:nick="fcc"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="49">FCC color matrix</doc> + line="50">FCC Title 47 Code of Federal Regulations 73.682 (a)(20)</doc> </member> <member name="bt709" value="3" @@ -7428,7 +7429,8 @@ non-linear RGB (R'G'B')</doc> glib:nick="bt709"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="50">ITU-R BT.709 color matrix</doc> + line="51">ITU-R BT.709 color matrix, also ITU-R BT1361 +/ IEC 61966-2-4 xvYCC709 / SMPTE RP177 Annex B</doc> </member> <member name="bt601" value="4" @@ -7436,7 +7438,7 @@ non-linear RGB (R'G'B')</doc> glib:nick="bt601"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="51">ITU-R BT.601 color matrix</doc> + line="53">ITU-R BT.601 color matrix, also SMPTE170M / ITU-R BT1358 525 / ITU-R BT1700 NTSC</doc> </member> <member name="smpte240m" value="5" @@ -7444,7 +7446,7 @@ non-linear RGB (R'G'B')</doc> glib:nick="smpte240m"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="52">SMPTE 240M color matrix</doc> + line="54">SMPTE 240M color matrix</doc> </member> <member name="bt2020" value="6" @@ -7452,31 +7454,31 @@ non-linear RGB (R'G'B')</doc> glib:nick="bt2020"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="53">ITU-R BT.2020 color matrix. Since: 1.6</doc> + line="55">ITU-R BT.2020 color matrix. Since: 1.6</doc> </member> <function name="from_iso" c:identifier="gst_video_color_matrix_from_iso" version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="765">Converts the @value to the #GstVideoColorMatrix + line="769">Converts the @value to the #GstVideoColorMatrix The matrix coefficients (MatrixCoefficients) value is defined by "ISO/IEC 23001-8 Section 7.3 Table 4" and "ITU-T H.273 Table 4". "H.264 Table E-5" and "H.265 Table E.5" share the identical values.</doc> <source-position filename="gst-libs/gst/video/video-color.h" - line="260"/> + line="284"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="775">the matched #GstVideoColorMatrix</doc> + line="779">the matched #GstVideoColorMatrix</doc> <type name="VideoColorMatrix" c:type="GstVideoColorMatrix"/> </return-value> <parameters> <parameter name="value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="767">a ITU-T H.273 matrix coefficients value</doc> + line="771">a ITU-T H.273 matrix coefficients value</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -7511,7 +7513,7 @@ and the other way around: B' = Y' + Cb*2*(1-Kb) ]|</doc> <source-position filename="gst-libs/gst/video/video-color.h" - line="69"/> + line="71"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" @@ -7551,23 +7553,23 @@ and the other way around: version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="634">Converts #GstVideoColorMatrix to the "matrix coefficients" + line="636">Converts #GstVideoColorMatrix to the "matrix coefficients" (MatrixCoefficients) value defined by "ISO/IEC 23001-8 Section 7.3 Table 4" and "ITU-T H.273 Table 4". "H.264 Table E-5" and "H.265 Table E.5" share the identical values.</doc> <source-position filename="gst-libs/gst/video/video-color.h" - line="251"/> + line="275"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="643">The value of ISO/IEC 23001-8 matrix coefficients.</doc> + line="645">The value of ISO/IEC 23001-8 matrix coefficients.</doc> <type name="guint" c:type="guint"/> </return-value> <parameters> <parameter name="matrix" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="636">a #GstVideoColorMatrix</doc> + line="638">a #GstVideoColorMatrix</doc> <type name="VideoColorMatrix" c:type="GstVideoColorMatrix"/> </parameter> </parameters> @@ -7579,7 +7581,7 @@ and "ITU-T H.273 Table 4". c:type="GstVideoColorPrimaries"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="132">The color primaries define the how to transform linear RGB values to and from + line="147">The color primaries define the how to transform linear RGB values to and from the CIE XYZ colorspace.</doc> <member name="unknown" value="0" @@ -7587,7 +7589,7 @@ the CIE XYZ colorspace.</doc> glib:nick="unknown"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="134">unknown color primaries</doc> + line="149">unknown color primaries</doc> </member> <member name="bt709" value="1" @@ -7595,7 +7597,8 @@ the CIE XYZ colorspace.</doc> glib:nick="bt709"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="135">BT709 primaries</doc> + line="150">BT709 primaries, also ITU-R BT1361 / IEC +61966-2-4 / SMPTE RP177 Annex B</doc> </member> <member name="bt470m" value="2" @@ -7603,7 +7606,8 @@ the CIE XYZ colorspace.</doc> glib:nick="bt470m"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="136">BT470M primaries</doc> + line="152">BT470M primaries, also FCC Title 47 Code +of Federal Regulations 73.682 (a)(20)</doc> </member> <member name="bt470bg" value="3" @@ -7611,7 +7615,8 @@ the CIE XYZ colorspace.</doc> glib:nick="bt470bg"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="137">BT470BG primaries</doc> + line="154">BT470BG primaries, also ITU-R BT601-6 +625 / ITU-R BT1358 625 / ITU-R BT1700 625 PAL & SECAM</doc> </member> <member name="smpte170m" value="4" @@ -7619,7 +7624,8 @@ the CIE XYZ colorspace.</doc> glib:nick="smpte170m"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="138">SMPTE170M primaries</doc> + line="156">SMPTE170M primaries, also ITU-R +BT601-6 525 / ITU-R BT1358 525 / ITU-R BT1700 NTSC</doc> </member> <member name="smpte240m" value="5" @@ -7627,7 +7633,7 @@ the CIE XYZ colorspace.</doc> glib:nick="smpte240m"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="139">SMPTE240M primaries</doc> + line="158">SMPTE240M primaries</doc> </member> <member name="film" value="6" @@ -7635,7 +7641,8 @@ the CIE XYZ colorspace.</doc> glib:nick="film"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="140">Generic film</doc> + line="159">Generic film (colour filters using +Illuminant C)</doc> </member> <member name="bt2020" value="7" @@ -7643,7 +7650,7 @@ the CIE XYZ colorspace.</doc> glib:nick="bt2020"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="141">BT2020 primaries. Since: 1.6</doc> + line="161">ITU-R BT2020 primaries. Since: 1.6</doc> </member> <member name="adobergb" value="8" @@ -7651,7 +7658,7 @@ the CIE XYZ colorspace.</doc> glib:nick="adobergb"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="142">Adobe RGB primaries. Since: 1.8</doc> + line="162">Adobe RGB primaries. Since: 1.8</doc> </member> <member name="smptest428" value="9" @@ -7659,7 +7666,8 @@ the CIE XYZ colorspace.</doc> glib:nick="smptest428"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="143">SMPTE ST 428 primaries. Since: 1.16</doc> + line="163">SMPTE ST 428 primaries (CIE 1931 +XYZ). Since: 1.16</doc> </member> <member name="smpterp431" value="10" @@ -7667,7 +7675,8 @@ the CIE XYZ colorspace.</doc> glib:nick="smpterp431"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="144">SMPTE RP 431 primaries. Since: 1.16</doc> + line="165">SMPTE RP 431 primaries (ST 431-2 +(2011) / DCI P3). Since: 1.16</doc> </member> <member name="smpteeg432" value="11" @@ -7675,7 +7684,8 @@ the CIE XYZ colorspace.</doc> glib:nick="smpteeg432"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="145">SMPTE EG 432 primaries. Since: 1.16</doc> + line="167">SMPTE EG 432 primaries (ST 432-1 +(2010) / P3 D65). Since: 1.16</doc> </member> <member name="ebu3213" value="12" @@ -7683,30 +7693,31 @@ the CIE XYZ colorspace.</doc> glib:nick="ebu3213"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="146">EBU 3213 primaries. Since: 1.16</doc> + line="169">EBU 3213 primaries (JEDEC P22 +phosphors). Since: 1.16</doc> </member> <function name="from_iso" c:identifier="gst_video_color_primaries_from_iso" version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="851">Converts the @value to the #GstVideoColorPrimaries + line="856">Converts the @value to the #GstVideoColorPrimaries The colour primaries (ColourPrimaries) value is defined by "ISO/IEC 23001-8 Section 7.1 Table 2" and "ITU-T H.273 Table 2". "H.264 Table E-3" and "H.265 Table E.3" share the identical values.</doc> <source-position filename="gst-libs/gst/video/video-color.h" - line="266"/> + line="290"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="860">the matched #GstVideoColorPrimaries</doc> + line="865">the matched #GstVideoColorPrimaries</doc> <type name="VideoColorPrimaries" c:type="GstVideoColorPrimaries"/> </return-value> <parameters> <parameter name="value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="853">a ITU-T H.273 colour primaries value</doc> + line="858">a ITU-T H.273 colour primaries value</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -7718,7 +7729,7 @@ defined by "ISO/IEC 23001-8 Section 7.1 Table 2" and "ITU-T H.273 Table 2". filename="gst-libs/gst/video/video-color.c" line="303">Get information about the chromaticity coordinates of @primaries.</doc> <source-position filename="gst-libs/gst/video/video-color.h" - line="195"/> + line="219"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" @@ -7740,23 +7751,23 @@ defined by "ISO/IEC 23001-8 Section 7.1 Table 2" and "ITU-T H.273 Table 2". version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="719">Converts #GstVideoColorPrimaries to the "colour primaries" (ColourPrimaries) + line="723">Converts #GstVideoColorPrimaries to the "colour primaries" (ColourPrimaries) value defined by "ISO/IEC 23001-8 Section 7.1 Table 2" and "ITU-T H.273 Table 2". "H.264 Table E-3" and "H.265 Table E.3" share the identical values.</doc> <source-position filename="gst-libs/gst/video/video-color.h" - line="257"/> + line="281"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="728">The value of ISO/IEC 23001-8 colour primaries.</doc> + line="732">The value of ISO/IEC 23001-8 colour primaries.</doc> <type name="guint" c:type="guint"/> </return-value> <parameters> <parameter name="primaries" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="721">a #GstVideoColorPrimaries</doc> + line="725">a #GstVideoColorPrimaries</doc> <type name="VideoColorPrimaries" c:type="GstVideoColorPrimaries"/> </parameter> </parameters> @@ -7767,62 +7778,62 @@ and "ITU-T H.273 Table 2". version="1.6"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="167">Structure describing the chromaticity coordinates of an RGB system. These + line="191">Structure describing the chromaticity coordinates of an RGB system. These values can be used to construct a matrix to transform RGB to and from the XYZ colorspace.</doc> - <source-position filename="gst-libs/gst/video/video-color.h" line="191"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="215"/> <field name="primaries" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="169">a #GstVideoColorPrimaries</doc> + line="193">a #GstVideoColorPrimaries</doc> <type name="VideoColorPrimaries" c:type="GstVideoColorPrimaries"/> </field> <field name="Wx" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="170">reference white x coordinate</doc> + line="194">reference white x coordinate</doc> <type name="gdouble" c:type="gdouble"/> </field> <field name="Wy" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="171">reference white y coordinate</doc> + line="195">reference white y coordinate</doc> <type name="gdouble" c:type="gdouble"/> </field> <field name="Rx" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="172">red x coordinate</doc> + line="196">red x coordinate</doc> <type name="gdouble" c:type="gdouble"/> </field> <field name="Ry" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="173">red y coordinate</doc> + line="197">red y coordinate</doc> <type name="gdouble" c:type="gdouble"/> </field> <field name="Gx" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="174">green x coordinate</doc> + line="198">green x coordinate</doc> <type name="gdouble" c:type="gdouble"/> </field> <field name="Gy" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="175">green y coordinate</doc> + line="199">green y coordinate</doc> <type name="gdouble" c:type="gdouble"/> </field> <field name="Bx" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="176">blue x coordinate</doc> + line="200">blue x coordinate</doc> <type name="gdouble" c:type="gdouble"/> </field> <field name="By" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="177">blue y coordinate</doc> + line="201">blue y coordinate</doc> <type name="gdouble" c:type="gdouble"/> </field> </record> @@ -7870,7 +7881,7 @@ The reverse operation (c[i] * scale[i]) + offset[i] can be used to convert the component values in range [0.0 .. 1.0] back to their representation in @info and @range.</doc> <source-position filename="gst-libs/gst/video/video-color.h" - line="240"/> + line="264"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -7915,32 +7926,32 @@ the component values in range [0.0 .. 1.0] back to their representation in <record name="VideoColorimetry" c:type="GstVideoColorimetry"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="197">Structure describing the color info.</doc> - <source-position filename="gst-libs/gst/video/video-color.h" line="213"/> + line="221">Structure describing the color info.</doc> + <source-position filename="gst-libs/gst/video/video-color.h" line="237"/> <field name="range" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="199">the color range. This is the valid range for the samples. + line="223">the color range. This is the valid range for the samples. It is used to convert the samples to Y'PbPr values.</doc> <type name="VideoColorRange" c:type="GstVideoColorRange"/> </field> <field name="matrix" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="201">the color matrix. Used to convert between Y'PbPr and + line="225">the color matrix. Used to convert between Y'PbPr and non-linear RGB (R'G'B')</doc> <type name="VideoColorMatrix" c:type="GstVideoColorMatrix"/> </field> <field name="transfer" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="203">the transfer function. used to convert between R'G'B' and RGB</doc> + line="227">the transfer function. used to convert between R'G'B' and RGB</doc> <type name="VideoTransferFunction" c:type="GstVideoTransferFunction"/> </field> <field name="primaries" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="204">color primaries. used to convert between R'G'B' and CIE XYZ</doc> + line="228">color primaries. used to convert between R'G'B' and CIE XYZ</doc> <type name="VideoColorPrimaries" c:type="GstVideoColorPrimaries"/> </field> <method name="from_string" @@ -7950,7 +7961,7 @@ the component values in range [0.0 .. 1.0] back to their representation in line="102">Parse the colorimetry string and update @cinfo with the parsed values.</doc> <source-position filename="gst-libs/gst/video/video-color.h" - line="229"/> + line="253"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" @@ -7979,7 +7990,7 @@ values.</doc> filename="gst-libs/gst/video/video-color.c" line="251">Compare the 2 colorimetry sets for equality</doc> <source-position filename="gst-libs/gst/video/video-color.h" - line="235"/> + line="259"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" @@ -8007,7 +8018,7 @@ values.</doc> line="165">Check if the colorimetry information in @info matches that of the string @color.</doc> <source-position filename="gst-libs/gst/video/video-color.h" - line="226"/> + line="250"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" @@ -8035,7 +8046,7 @@ information in @info.</doc> filename="gst-libs/gst/video/video-color.c" line="139">Make a string representation of @cinfo.</doc> <source-position filename="gst-libs/gst/video/video-color.h" - line="232"/> + line="256"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" @@ -8639,7 +8650,7 @@ The bare minimum that a functional subclass needs to implement is: <virtual-method name="negotiate" invoker="negotiate"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4041">Negotiate with downstream elements to currently configured #GstVideoCodecState. + line="4100">Negotiate with downstream elements to currently configured #GstVideoCodecState. Unmark GST_PAD_FLAG_NEED_RECONFIGURE in any case. But mark it again if negotiate fails.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" @@ -8647,14 +8658,14 @@ negotiate fails.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4049">%TRUE if the negotiation succeeded, else %FALSE.</doc> + line="4108">%TRUE if the negotiation succeeded, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4043">a #GstVideoDecoder</doc> + line="4102">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> </parameters> @@ -8843,7 +8854,7 @@ negotiate fails.</doc> c:identifier="gst_video_decoder_add_to_frame"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3322">Removes next @n_bytes of input data and adds it to currently parsed frame.</doc> + line="3364">Removes next @n_bytes of input data and adds it to currently parsed frame.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" line="410"/> <return-value transfer-ownership="none"> @@ -8853,13 +8864,13 @@ negotiate fails.</doc> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3324">a #GstVideoDecoder</doc> + line="3366">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="n_bytes" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3325">the number of bytes to add</doc> + line="3367">the number of bytes to add</doc> <type name="gint" c:type="int"/> </parameter> </parameters> @@ -8868,7 +8879,7 @@ negotiate fails.</doc> c:identifier="gst_video_decoder_allocate_output_buffer"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4073">Helper function that allocates a buffer to hold a video frame for @decoder's + line="4132">Helper function that allocates a buffer to hold a video frame for @decoder's current #GstVideoCodecState. You should use gst_video_decoder_allocate_output_frame() instead of this @@ -8878,7 +8889,7 @@ function, if possible at all.</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4083">allocated buffer, or NULL if no buffer could be + line="4142">allocated buffer, or NULL if no buffer could be allocated (e.g. when downstream is flushing or shutting down)</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </return-value> @@ -8886,7 +8897,7 @@ function, if possible at all.</doc> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4075">a #GstVideoDecoder</doc> + line="4134">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> </parameters> @@ -8895,7 +8906,7 @@ function, if possible at all.</doc> c:identifier="gst_video_decoder_allocate_output_frame"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4139">Helper function that allocates a buffer to hold a video frame for @decoder's + line="4198">Helper function that allocates a buffer to hold a video frame for @decoder's current #GstVideoCodecState. Subclass should already have configured video state and set src pad caps. @@ -8906,20 +8917,20 @@ keep references to the frame, not the buffer.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4151">%GST_FLOW_OK if an output buffer could be allocated</doc> + line="4210">%GST_FLOW_OK if an output buffer could be allocated</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4141">a #GstVideoDecoder</doc> + line="4200">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="frame" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4142">a #GstVideoCodecFrame</doc> + line="4201">a #GstVideoCodecFrame</doc> <type name="VideoCodecFrame" c:type="GstVideoCodecFrame*"/> </parameter> </parameters> @@ -8929,33 +8940,33 @@ keep references to the frame, not the buffer.</doc> version="1.12"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4161">Same as #gst_video_decoder_allocate_output_frame except it allows passing + line="4220">Same as #gst_video_decoder_allocate_output_frame except it allows passing #GstBufferPoolAcquireParams to the sub call gst_buffer_pool_acquire_buffer.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" line="423"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4170">%GST_FLOW_OK if an output buffer could be allocated</doc> + line="4229">%GST_FLOW_OK if an output buffer could be allocated</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4163">a #GstVideoDecoder</doc> + line="4222">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="frame" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4164">a #GstVideoCodecFrame</doc> + line="4223">a #GstVideoCodecFrame</doc> <type name="VideoCodecFrame" c:type="GstVideoCodecFrame*"/> </parameter> <parameter name="params" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4165">a #GstBufferPoolAcquireParams</doc> + line="4224">a #GstBufferPoolAcquireParams</doc> <type name="Gst.BufferPoolAcquireParams" c:type="GstBufferPoolAcquireParams*"/> </parameter> @@ -8964,7 +8975,7 @@ keep references to the frame, not the buffer.</doc> <method name="drop_frame" c:identifier="gst_video_decoder_drop_frame"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="2966">Similar to gst_video_decoder_finish_frame(), but drops @frame in any + line="2998">Similar to gst_video_decoder_finish_frame(), but drops @frame in any case and posts a QoS message with the frame's details on the bus. In any case, the frame is considered finished and released.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" @@ -8972,20 +8983,20 @@ In any case, the frame is considered finished and released.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="2975">a #GstFlowReturn, usually GST_FLOW_OK.</doc> + line="3007">a #GstFlowReturn, usually GST_FLOW_OK.</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> <parameters> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="2968">a #GstVideoDecoder</doc> + line="3000">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="frame" transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="2969">the #GstVideoCodecFrame to drop</doc> + line="3001">the #GstVideoCodecFrame to drop</doc> <type name="VideoCodecFrame" c:type="GstVideoCodecFrame*"/> </parameter> </parameters> @@ -8994,7 +9005,7 @@ In any case, the frame is considered finished and released.</doc> c:identifier="gst_video_decoder_finish_frame"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3055">@frame should have a valid decoded data buffer, whose metadata fields + line="3097">@frame should have a valid decoded data buffer, whose metadata fields are then appropriately set according to frame data and pushed downstream. If no output data is provided, @frame is considered skipped. In any case, the frame is considered finished and released. @@ -9007,20 +9018,20 @@ of the buffer.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3069">a #GstFlowReturn resulting from sending data downstream</doc> + line="3111">a #GstFlowReturn resulting from sending data downstream</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3057">a #GstVideoDecoder</doc> + line="3099">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="frame" transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3058">a decoded #GstVideoCodecFrame</doc> + line="3100">a decoded #GstVideoCodecFrame</doc> <type name="VideoCodecFrame" c:type="GstVideoCodecFrame*"/> </parameter> </parameters> @@ -9029,7 +9040,7 @@ of the buffer.</doc> c:identifier="gst_video_decoder_get_allocator"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4550">Lets #GstVideoDecoder sub-classes to know the memory @allocator + line="4609">Lets #GstVideoDecoder sub-classes to know the memory @allocator used by the base class and its @params. Unref the @allocator after use it.</doc> @@ -9042,7 +9053,7 @@ Unref the @allocator after use it.</doc> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4552">a #GstVideoDecoder</doc> + line="4611">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="allocator" @@ -9053,7 +9064,7 @@ Unref the @allocator after use it.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4553">the #GstAllocator + line="4612">the #GstAllocator used</doc> <type name="Gst.Allocator" c:type="GstAllocator**"/> </parameter> @@ -9065,7 +9076,7 @@ used</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4555">the + line="4614">the #GstAllocationParams of @allocator</doc> <type name="Gst.AllocationParams" c:type="GstAllocationParams*"/> </parameter> @@ -9078,7 +9089,7 @@ used</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4536">the instance of the #GstBufferPool used + line="4595">the instance of the #GstBufferPool used by the decoder; free it after use it</doc> <type name="Gst.BufferPool" c:type="GstBufferPool*"/> </return-value> @@ -9086,7 +9097,7 @@ by the decoder; free it after use it</doc> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4534">a #GstVideoDecoder</doc> + line="4593">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> </parameters> @@ -9098,14 +9109,14 @@ by the decoder; free it after use it</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4431">currently configured byte to time conversion setting</doc> + line="4490">currently configured byte to time conversion setting</doc> <type name="gint" c:type="gint"/> </return-value> <parameters> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4429">a #GstVideoDecoder</doc> + line="4488">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> </parameters> @@ -9113,26 +9124,26 @@ by the decoder; free it after use it</doc> <method name="get_frame" c:identifier="gst_video_decoder_get_frame"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3667">Get a pending unfinished #GstVideoCodecFrame</doc> + line="3726">Get a pending unfinished #GstVideoCodecFrame</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" line="398"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3674">pending unfinished #GstVideoCodecFrame identified by @frame_number.</doc> + line="3733">pending unfinished #GstVideoCodecFrame identified by @frame_number.</doc> <type name="VideoCodecFrame" c:type="GstVideoCodecFrame*"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3669">a #GstVideoDecoder</doc> + line="3728">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="frame_number" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3670">system_frame_number of a frame</doc> + line="3729">system_frame_number of a frame</doc> <type name="gint" c:type="int"/> </parameter> </parameters> @@ -9140,13 +9151,13 @@ by the decoder; free it after use it</doc> <method name="get_frames" c:identifier="gst_video_decoder_get_frames"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3698">Get all pending unfinished #GstVideoCodecFrame</doc> + line="3757">Get all pending unfinished #GstVideoCodecFrame</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" line="405"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3704">pending unfinished #GstVideoCodecFrame.</doc> + line="3763">pending unfinished #GstVideoCodecFrame.</doc> <type name="GLib.List" c:type="GList*"> <type name="VideoCodecFrame"/> </type> @@ -9155,7 +9166,7 @@ by the decoder; free it after use it</doc> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3700">a #GstVideoDecoder</doc> + line="3759">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> </parameters> @@ -9163,7 +9174,7 @@ by the decoder; free it after use it</doc> <method name="get_latency" c:identifier="gst_video_decoder_get_latency"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4467">Query the configured decoder latency. Results will be returned via + line="4526">Query the configured decoder latency. Results will be returned via @min_latency and @max_latency.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" line="383"/> @@ -9174,7 +9185,7 @@ by the decoder; free it after use it</doc> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4469">a #GstVideoDecoder</doc> + line="4528">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="min_latency" @@ -9185,7 +9196,7 @@ by the decoder; free it after use it</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4470">address of variable in which to store the + line="4529">address of variable in which to store the configured minimum latency, or %NULL</doc> <type name="Gst.ClockTime" c:type="GstClockTime*"/> </parameter> @@ -9197,7 +9208,7 @@ by the decoder; free it after use it</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4472">address of variable in which to store the + line="4531">address of variable in which to store the configured mximum latency, or %NULL</doc> <type name="Gst.ClockTime" c:type="GstClockTime*"/> </parameter> @@ -9207,7 +9218,7 @@ by the decoder; free it after use it</doc> c:identifier="gst_video_decoder_get_max_decode_time"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4221">Determines maximum possible decoding time for @frame that will + line="4280">Determines maximum possible decoding time for @frame that will allow it to decode and arrive in time (as determined by QoS events). In particular, a negative result means decoding in time is no longer possible and should therefore occur as soon/skippy as possible.</doc> @@ -9216,20 +9227,20 @@ and should therefore occur as soon/skippy as possible.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4231">max decoding time.</doc> + line="4290">max decoding time.</doc> <type name="Gst.ClockTimeDiff" c:type="GstClockTimeDiff"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4223">a #GstVideoDecoder</doc> + line="4282">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="frame" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4224">a #GstVideoCodecFrame</doc> + line="4283">a #GstVideoCodecFrame</doc> <type name="VideoCodecFrame" c:type="GstVideoCodecFrame*"/> </parameter> </parameters> @@ -9241,14 +9252,14 @@ and should therefore occur as soon/skippy as possible.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4328">currently configured decoder tolerated error count.</doc> + line="4387">currently configured decoder tolerated error count.</doc> <type name="gint" c:type="gint"/> </return-value> <parameters> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4326">a #GstVideoDecoder</doc> + line="4385">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> </parameters> @@ -9258,20 +9269,20 @@ and should therefore occur as soon/skippy as possible.</doc> version="1.4"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4360">Queries decoder required format handling.</doc> + line="4419">Queries decoder required format handling.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" line="375"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4366">%TRUE if required format handling is enabled.</doc> + line="4425">%TRUE if required format handling is enabled.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4362">a #GstVideoDecoder</doc> + line="4421">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> </parameters> @@ -9280,20 +9291,20 @@ and should therefore occur as soon/skippy as possible.</doc> c:identifier="gst_video_decoder_get_oldest_frame"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3646">Get the oldest pending unfinished #GstVideoCodecFrame</doc> + line="3705">Get the oldest pending unfinished #GstVideoCodecFrame</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" line="402"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3652">oldest pending unfinished #GstVideoCodecFrame.</doc> + line="3711">oldest pending unfinished #GstVideoCodecFrame.</doc> <type name="VideoCodecFrame" c:type="GstVideoCodecFrame*"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3648">a #GstVideoDecoder</doc> + line="3707">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> </parameters> @@ -9302,20 +9313,20 @@ and should therefore occur as soon/skippy as possible.</doc> c:identifier="gst_video_decoder_get_output_state"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3535">Get the #GstVideoCodecState currently describing the output stream.</doc> + line="3577">Get the #GstVideoCodecState currently describing the output stream.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" line="442"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3541">#GstVideoCodecState describing format of video data.</doc> + line="3583">#GstVideoCodecState describing format of video data.</doc> <type name="VideoCodecState" c:type="GstVideoCodecState*"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3537">a #GstVideoDecoder</doc> + line="3579">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> </parameters> @@ -9324,21 +9335,21 @@ and should therefore occur as soon/skippy as possible.</doc> c:identifier="gst_video_decoder_get_packetized"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4397">Queries whether input data is considered packetized or not by the + line="4456">Queries whether input data is considered packetized or not by the base class.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" line="354"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4404">TRUE if input data is considered packetized.</doc> + line="4463">TRUE if input data is considered packetized.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4399">a #GstVideoDecoder</doc> + line="4458">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> </parameters> @@ -9348,21 +9359,21 @@ base class.</doc> version="1.4"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3351">Returns the number of bytes previously added to the current frame + line="3393">Returns the number of bytes previously added to the current frame by calling gst_video_decoder_add_to_frame().</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" line="417"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3358">The number of bytes pending for the current frame</doc> + line="3400">The number of bytes pending for the current frame</doc> <type name="gsize" c:type="gsize"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3353">a #GstVideoDecoder</doc> + line="3395">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> </parameters> @@ -9375,14 +9386,14 @@ by calling gst_video_decoder_add_to_frame().</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4263">The current QoS proportion.</doc> + line="4322">The current QoS proportion.</doc> <type name="gdouble" c:type="gdouble"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4260">a #GstVideoDecoder + line="4319">a #GstVideoDecoder current QoS proportion, or %NULL</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> @@ -9391,21 +9402,21 @@ by calling gst_video_decoder_add_to_frame().</doc> <method name="have_frame" c:identifier="gst_video_decoder_have_frame"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3401">Gathers all data collected for currently parsed frame, gathers corresponding + line="3443">Gathers all data collected for currently parsed frame, gathers corresponding metadata and passes it along for further processing, i.e. @handle_frame.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" line="414"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3408">a #GstFlowReturn</doc> + line="3450">a #GstFlowReturn</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3403">a #GstVideoDecoder</doc> + line="3445">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> </parameters> @@ -9413,7 +9424,7 @@ metadata and passes it along for further processing, i.e. @handle_frame.</doc> <method name="merge_tags" c:identifier="gst_video_decoder_merge_tags"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4490">Sets the audio decoder tags and how they should be merged with any + line="4549">Sets the audio decoder tags and how they should be merged with any upstream stream tags. This will override any tags previously-set with gst_audio_decoder_merge_tags(). @@ -9430,7 +9441,7 @@ MT safe.</doc> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4492">a #GstVideoDecoder</doc> + line="4551">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="tags" @@ -9439,14 +9450,14 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4493">a #GstTagList to merge, or NULL to unset + line="4552">a #GstTagList to merge, or NULL to unset previously-set tags</doc> <type name="Gst.TagList" c:type="const GstTagList*"/> </parameter> <parameter name="mode" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4495">the #GstTagMergeMode to use, usually #GST_TAG_MERGE_REPLACE</doc> + line="4554">the #GstTagMergeMode to use, usually #GST_TAG_MERGE_REPLACE</doc> <type name="Gst.TagMergeMode" c:type="GstTagMergeMode"/> </parameter> </parameters> @@ -9454,7 +9465,7 @@ MT safe.</doc> <method name="negotiate" c:identifier="gst_video_decoder_negotiate"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4041">Negotiate with downstream elements to currently configured #GstVideoCodecState. + line="4100">Negotiate with downstream elements to currently configured #GstVideoCodecState. Unmark GST_PAD_FLAG_NEED_RECONFIGURE in any case. But mark it again if negotiate fails.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" @@ -9462,14 +9473,14 @@ negotiate fails.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4049">%TRUE if the negotiation succeeded, else %FALSE.</doc> + line="4108">%TRUE if the negotiation succeeded, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4043">a #GstVideoDecoder</doc> + line="4102">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> </parameters> @@ -9479,7 +9490,7 @@ negotiate fails.</doc> version="1.6"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="1817">Returns caps that express @caps (or sink template caps if @caps == NULL) + line="1849">Returns caps that express @caps (or sink template caps if @caps == NULL) restricted to resolution/format/... combinations supported by downstream elements.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" @@ -9487,14 +9498,14 @@ elements.</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="1827">a #GstCaps owned by caller</doc> + line="1859">a #GstCaps owned by caller</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="1819">a #GstVideoDecoder</doc> + line="1851">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="caps" @@ -9503,7 +9514,7 @@ elements.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="1820">initial caps</doc> + line="1852">initial caps</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> <parameter name="filter" @@ -9512,7 +9523,7 @@ elements.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="1821">filter caps</doc> + line="1853">filter caps</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> </parameters> @@ -9522,7 +9533,7 @@ elements.</doc> version="1.2.2"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="2899">Similar to gst_video_decoder_drop_frame(), but simply releases @frame + line="2931">Similar to gst_video_decoder_drop_frame(), but simply releases @frame without any processing other than removing it from list of pending frames, after which it is considered finished and released.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" @@ -9534,13 +9545,13 @@ after which it is considered finished and released.</doc> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="2901">a #GstVideoDecoder</doc> + line="2933">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="frame" transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="2902">the #GstVideoCodecFrame to release</doc> + line="2934">the #GstVideoCodecFrame to release</doc> <type name="VideoCodecFrame" c:type="GstVideoCodecFrame*"/> </parameter> </parameters> @@ -9549,7 +9560,7 @@ after which it is considered finished and released.</doc> c:identifier="gst_video_decoder_set_estimate_rate"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4412">Allows baseclass to perform byte to time estimated conversion.</doc> + line="4471">Allows baseclass to perform byte to time estimated conversion.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" line="357"/> <return-value transfer-ownership="none"> @@ -9559,13 +9570,13 @@ after which it is considered finished and released.</doc> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4414">a #GstVideoDecoder</doc> + line="4473">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="enabled" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4415">whether to enable byte to time conversion</doc> + line="4474">whether to enable byte to time conversion</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -9575,45 +9586,42 @@ after which it is considered finished and released.</doc> version="1.16."> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3590">Same as #gst_video_decoder_set_output_state() but also allows you to also set + line="3679">Same as #gst_video_decoder_set_output_state() but also allows you to also set the interlacing mode.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" line="437"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3602">the newly configured output state.</doc> + line="3691">the newly configured output state.</doc> <type name="VideoCodecState" c:type="GstVideoCodecState*"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3592">a #GstVideoDecoder</doc> + line="3681">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="fmt" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3593">a #GstVideoFormat</doc> + line="3682">a #GstVideoFormat</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </parameter> <parameter name="mode" transfer-ownership="none"> - <doc xml:space="preserve" - filename="gst-libs/gst/video/gstvideodecoder.c" - line="3596">A #GstVideoInterlaceMode</doc> <type name="VideoInterlaceMode" c:type="GstVideoInterlaceMode"/> </parameter> <parameter name="width" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3594">The width in pixels</doc> + line="3683">The width in pixels</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="height" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3595">The height in pixels</doc> + line="3684">The height in pixels</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="reference" @@ -9622,7 +9630,7 @@ the interlacing mode.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3597">An optional reference #GstVideoCodecState</doc> + line="3686">An optional reference #GstVideoCodecState</doc> <type name="VideoCodecState" c:type="GstVideoCodecState*"/> </parameter> </parameters> @@ -9630,7 +9638,7 @@ the interlacing mode.</doc> <method name="set_latency" c:identifier="gst_video_decoder_set_latency"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4441">Lets #GstVideoDecoder sub-classes tell the baseclass what the decoder + line="4500">Lets #GstVideoDecoder sub-classes tell the baseclass what the decoder latency is. Will also post a LATENCY message on the bus so the pipeline can reconfigure its global latency.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" @@ -9642,19 +9650,19 @@ can reconfigure its global latency.</doc> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4443">a #GstVideoDecoder</doc> + line="4502">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="min_latency" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4444">minimum latency</doc> + line="4503">minimum latency</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </parameter> <parameter name="max_latency" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4445">maximum latency</doc> + line="4504">maximum latency</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </parameter> </parameters> @@ -9663,7 +9671,7 @@ can reconfigure its global latency.</doc> c:identifier="gst_video_decoder_set_max_errors"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4304">Sets numbers of tolerated decoder errors, where a tolerated one is then only + line="4363">Sets numbers of tolerated decoder errors, where a tolerated one is then only warned about, but more than tolerated will lead to fatal error. You can set -1 for never returning fatal errors. Default is set to GST_VIDEO_DECODER_MAX_ERRORS. @@ -9678,13 +9686,13 @@ The '-1' option was added in 1.4</doc> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4306">a #GstVideoDecoder</doc> + line="4365">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="num" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4307">max tolerated errors</doc> + line="4366">max tolerated errors</doc> <type name="gint" c:type="gint"/> </parameter> </parameters> @@ -9694,7 +9702,7 @@ The '-1' option was added in 1.4</doc> version="1.4"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4338">Configures decoder format needs. If enabled, subclass needs to be + line="4397">Configures decoder format needs. If enabled, subclass needs to be negotiated with format caps before it can process any data. It will then never be handed any data before it has been configured. Otherwise, it might be handed data without having been configured and @@ -9709,13 +9717,13 @@ or based on the input data.</doc> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4340">a #GstVideoDecoder</doc> + line="4399">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="enabled" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4341">new state</doc> + line="4400">new state</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -9724,7 +9732,7 @@ or based on the input data.</doc> c:identifier="gst_video_decoder_set_output_state"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3556">Creates a new #GstVideoCodecState with the specified @fmt, @width and @height + line="3645">Creates a new #GstVideoCodecState with the specified @fmt, @width and @height as the output state for the decoder. Any previously set output state on @decoder will be replaced by the newly created one. @@ -9743,32 +9751,32 @@ from the next call to #gst_video_decoder_finish_frame().</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3579">the newly configured output state.</doc> + line="3668">the newly configured output state.</doc> <type name="VideoCodecState" c:type="GstVideoCodecState*"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3558">a #GstVideoDecoder</doc> + line="3647">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="fmt" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3559">a #GstVideoFormat</doc> + line="3648">a #GstVideoFormat</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </parameter> <parameter name="width" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3560">The width in pixels</doc> + line="3649">The width in pixels</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="height" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3561">The height in pixels</doc> + line="3650">The height in pixels</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="reference" @@ -9777,7 +9785,7 @@ from the next call to #gst_video_decoder_finish_frame().</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3562">An optional reference #GstVideoCodecState</doc> + line="3651">An optional reference #GstVideoCodecState</doc> <type name="VideoCodecState" c:type="GstVideoCodecState*"/> </parameter> </parameters> @@ -9786,7 +9794,7 @@ from the next call to #gst_video_decoder_finish_frame().</doc> c:identifier="gst_video_decoder_set_packetized"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4382">Allows baseclass to consider input data as packetized or not. If the + line="4441">Allows baseclass to consider input data as packetized or not. If the input is packetized, then the @parse method will not be called.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" line="350"/> @@ -9797,13 +9805,13 @@ input is packetized, then the @parse method will not be called.</doc> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4384">a #GstVideoDecoder</doc> + line="4443">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="packetized" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4385">whether the input data should be considered as packetized.</doc> + line="4444">whether the input data should be considered as packetized.</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -9813,7 +9821,7 @@ input is packetized, then the @parse method will not be called.</doc> version="1.6"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4577">Lets #GstVideoDecoder sub-classes decide if they want the sink pad + line="4636">Lets #GstVideoDecoder sub-classes decide if they want the sink pad to use the default pad query handler to reply to accept-caps queries. By setting this to true it is possible to further customize the default @@ -9828,24 +9836,34 @@ handler with %GST_PAD_SET_ACCEPT_INTERSECT and <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4579">a #GstVideoDecoder</doc> + line="4638">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="use" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4580">if the default pad accept-caps query handling should be used</doc> + line="4639">if the default pad accept-caps query handling should be used</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> </method> + <property name="max-errors" + version="1.18" + writable="1" + transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/gstvideodecoder.c" + line="583">Maximum number of tolerated consecutive decode errors. See +gst_video_decoder_set_max_errors() for more details.</doc> + <type name="gint" c:type="gint"/> + </property> <property name="qos" version="1.18" writable="1" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="562">If set to %TRUE the decoder will handle QoS events received + line="568">If set to %TRUE the decoder will handle QoS events received from downstream elements. This includes dropping output frames which are detected as late using the metrics reported by those events.</doc> @@ -10077,14 +10095,14 @@ and likely as well. If non-packetized input is supported or expected, <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4049">%TRUE if the negotiation succeeded, else %FALSE.</doc> + line="4108">%TRUE if the negotiation succeeded, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4043">a #GstVideoDecoder</doc> + line="4102">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </parameter> </parameters> @@ -10631,7 +10649,7 @@ pipeline to catch up.</doc> <virtual-method name="negotiate" invoker="negotiate"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="1986">Negotiate with downstream elements to currently configured #GstVideoCodecState. + line="1992">Negotiate with downstream elements to currently configured #GstVideoCodecState. Unmark GST_PAD_FLAG_NEED_RECONFIGURE in any case. But mark it again if negotiate fails.</doc> <source-position filename="gst-libs/gst/video/gstvideoencoder.h" @@ -10639,14 +10657,14 @@ negotiate fails.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="1994">%TRUE if the negotiation succeeded, else %FALSE.</doc> + line="2000">%TRUE if the negotiation succeeded, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="1988">a #GstVideoEncoder</doc> + line="1994">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> </parameters> @@ -10829,27 +10847,27 @@ negotiate fails.</doc> c:identifier="gst_video_encoder_allocate_output_buffer"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2019">Helper function that allocates a buffer to hold an encoded video frame + line="2025">Helper function that allocates a buffer to hold an encoded video frame for @encoder's current #GstVideoCodecState.</doc> <source-position filename="gst-libs/gst/video/gstvideoencoder.h" line="327"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2027">allocated buffer</doc> + line="2033">allocated buffer</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </return-value> <parameters> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2021">a #GstVideoEncoder</doc> + line="2027">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="size" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2022">size of the buffer</doc> + line="2028">size of the buffer</doc> <type name="gsize" c:type="gsize"/> </parameter> </parameters> @@ -10858,7 +10876,7 @@ for @encoder's current #GstVideoCodecState.</doc> c:identifier="gst_video_encoder_allocate_output_frame"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2070">Helper function that allocates a buffer to hold an encoded video frame for @encoder's + line="2076">Helper function that allocates a buffer to hold an encoded video frame for @encoder's current #GstVideoCodecState. Subclass should already have configured video state and set src pad caps. @@ -10869,26 +10887,26 @@ keep references to the frame, not the buffer.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2083">%GST_FLOW_OK if an output buffer could be allocated</doc> + line="2089">%GST_FLOW_OK if an output buffer could be allocated</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> <parameters> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2072">a #GstVideoEncoder</doc> + line="2078">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="frame" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2073">a #GstVideoCodecFrame</doc> + line="2079">a #GstVideoCodecFrame</doc> <type name="VideoCodecFrame" c:type="GstVideoCodecFrame*"/> </parameter> <parameter name="size" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2074">size of the buffer</doc> + line="2080">size of the buffer</doc> <type name="gsize" c:type="gsize"/> </parameter> </parameters> @@ -10897,7 +10915,7 @@ keep references to the frame, not the buffer.</doc> c:identifier="gst_video_encoder_finish_frame"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2459">@frame must have a valid encoded data buffer, whose metadata fields + line="2475">@frame must have a valid encoded data buffer, whose metadata fields are then appropriately set according to frame data or no buffer at all if the frame should be dropped. It is subsequently pushed downstream or provided to @pre_push. @@ -10911,20 +10929,20 @@ of the buffer.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2474">a #GstFlowReturn resulting from sending data downstream</doc> + line="2490">a #GstFlowReturn resulting from sending data downstream</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> <parameters> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2461">a #GstVideoEncoder</doc> + line="2477">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="frame" transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2462">an encoded #GstVideoCodecFrame</doc> + line="2478">an encoded #GstVideoCodecFrame</doc> <type name="VideoCodecFrame" c:type="GstVideoCodecFrame*"/> </parameter> </parameters> @@ -10934,7 +10952,7 @@ of the buffer.</doc> version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2611">If multiple subframes are produced for one input frame then use this method + line="2627">If multiple subframes are produced for one input frame then use this method for each subframe, except for the last one. Before calling this function, you need to fill frame->output_buffer with the encoded buffer to push. @@ -10948,20 +10966,20 @@ will be pushed downstream.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2626">a #GstFlowReturn resulting from pushing the buffer downstream.</doc> + line="2642">a #GstFlowReturn resulting from pushing the buffer downstream.</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> <parameters> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2613">a #GstVideoEncoder</doc> + line="2629">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="frame" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2614">a #GstVideoCodecFrame being encoded</doc> + line="2630">a #GstVideoCodecFrame being encoded</doc> <type name="VideoCodecFrame" c:type="GstVideoCodecFrame*"/> </parameter> </parameters> @@ -10970,7 +10988,7 @@ will be pushed downstream.</doc> c:identifier="gst_video_encoder_get_allocator"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2980">Lets #GstVideoEncoder sub-classes to know the memory @allocator + line="2996">Lets #GstVideoEncoder sub-classes to know the memory @allocator used by the base class and its @params. Unref the @allocator after use it.</doc> @@ -10983,7 +11001,7 @@ Unref the @allocator after use it.</doc> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2982">a #GstVideoEncoder</doc> + line="2998">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="allocator" @@ -10994,7 +11012,7 @@ Unref the @allocator after use it.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2983">the #GstAllocator + line="2999">the #GstAllocator used</doc> <type name="Gst.Allocator" c:type="GstAllocator**"/> </parameter> @@ -11006,7 +11024,7 @@ used</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2985">the + line="3001">the #GstAllocationParams of @allocator</doc> <type name="Gst.AllocationParams" c:type="GstAllocationParams*"/> </parameter> @@ -11015,26 +11033,26 @@ used</doc> <method name="get_frame" c:identifier="gst_video_encoder_get_frame"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2884">Get a pending unfinished #GstVideoCodecFrame</doc> + line="2900">Get a pending unfinished #GstVideoCodecFrame</doc> <source-position filename="gst-libs/gst/video/gstvideoencoder.h" line="317"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2891">pending unfinished #GstVideoCodecFrame identified by @frame_number.</doc> + line="2907">pending unfinished #GstVideoCodecFrame identified by @frame_number.</doc> <type name="VideoCodecFrame" c:type="GstVideoCodecFrame*"/> </return-value> <parameters> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2886">a #GstVideoEncoder</doc> + line="2902">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="frame_number" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2887">system_frame_number of a frame</doc> + line="2903">system_frame_number of a frame</doc> <type name="gint" c:type="int"/> </parameter> </parameters> @@ -11042,13 +11060,13 @@ used</doc> <method name="get_frames" c:identifier="gst_video_encoder_get_frames"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2915">Get all pending unfinished #GstVideoCodecFrame</doc> + line="2931">Get all pending unfinished #GstVideoCodecFrame</doc> <source-position filename="gst-libs/gst/video/gstvideoencoder.h" line="324"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2921">pending unfinished #GstVideoCodecFrame.</doc> + line="2937">pending unfinished #GstVideoCodecFrame.</doc> <type name="GLib.List" c:type="GList*"> <type name="VideoCodecFrame"/> </type> @@ -11057,7 +11075,7 @@ used</doc> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2917">a #GstVideoEncoder</doc> + line="2933">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> </parameters> @@ -11065,7 +11083,7 @@ used</doc> <method name="get_latency" c:identifier="gst_video_encoder_get_latency"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2840">Query the configured encoding latency. Results will be returned via + line="2856">Query the configured encoding latency. Results will be returned via @min_latency and @max_latency.</doc> <source-position filename="gst-libs/gst/video/gstvideoencoder.h" line="354"/> @@ -11076,7 +11094,7 @@ used</doc> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2842">a #GstVideoEncoder</doc> + line="2858">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="min_latency" @@ -11087,7 +11105,7 @@ used</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2843">address of variable in which to store the + line="2859">address of variable in which to store the configured minimum latency, or %NULL</doc> <type name="Gst.ClockTime" c:type="GstClockTime*"/> </parameter> @@ -11099,7 +11117,7 @@ used</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2845">address of variable in which to store the + line="2861">address of variable in which to store the configured maximum latency, or %NULL</doc> <type name="Gst.ClockTime" c:type="GstClockTime*"/> </parameter> @@ -11110,7 +11128,7 @@ used</doc> version="1.14"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3027">Determines maximum possible encoding time for @frame that will + line="3043">Determines maximum possible encoding time for @frame that will allow it to encode and arrive in time (as determined by QoS events). In particular, a negative result means encoding in time is no longer possible and should therefore occur as soon/skippy as possible. @@ -11122,20 +11140,20 @@ If no QoS events have been received from downstream, or if <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3040">max decoding time.</doc> + line="3056">max decoding time.</doc> <type name="Gst.ClockTimeDiff" c:type="GstClockTimeDiff"/> </return-value> <parameters> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3029">a #GstVideoEncoder</doc> + line="3045">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="frame" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3030">a #GstVideoCodecFrame</doc> + line="3046">a #GstVideoCodecFrame</doc> <type name="VideoCodecFrame" c:type="GstVideoCodecFrame*"/> </parameter> </parameters> @@ -11145,21 +11163,21 @@ If no QoS events have been received from downstream, or if version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3131">Returns the minimum force-keyunit interval, see gst_video_encoder_set_min_force_key_unit_interval() + line="3147">Returns the minimum force-keyunit interval, see gst_video_encoder_set_min_force_key_unit_interval() for more details.</doc> <source-position filename="gst-libs/gst/video/gstvideoencoder.h" line="388"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3138">the minimum force-keyunit interval</doc> + line="3154">the minimum force-keyunit interval</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </return-value> <parameters> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3133">the encoder</doc> + line="3149">the encoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> </parameters> @@ -11168,20 +11186,20 @@ for more details.</doc> c:identifier="gst_video_encoder_get_oldest_frame"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2863">Get the oldest unfinished pending #GstVideoCodecFrame</doc> + line="2879">Get the oldest unfinished pending #GstVideoCodecFrame</doc> <source-position filename="gst-libs/gst/video/gstvideoencoder.h" line="321"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2869">oldest unfinished pending #GstVideoCodecFrame</doc> + line="2885">oldest unfinished pending #GstVideoCodecFrame</doc> <type name="VideoCodecFrame" c:type="GstVideoCodecFrame*"/> </return-value> <parameters> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2865">a #GstVideoEncoder</doc> + line="2881">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> </parameters> @@ -11190,20 +11208,20 @@ for more details.</doc> c:identifier="gst_video_encoder_get_output_state"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2737">Get the current #GstVideoCodecState</doc> + line="2753">Get the current #GstVideoCodecState</doc> <source-position filename="gst-libs/gst/video/gstvideoencoder.h" line="306"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2743">#GstVideoCodecState describing format of video data.</doc> + line="2759">#GstVideoCodecState describing format of video data.</doc> <type name="VideoCodecState" c:type="GstVideoCodecState*"/> </return-value> <parameters> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2739">a #GstVideoEncoder</doc> + line="2755">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> </parameters> @@ -11213,21 +11231,21 @@ for more details.</doc> version="1.14"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3087">Checks if @encoder is currently configured to handle Quality-of-Service + line="3103">Checks if @encoder is currently configured to handle Quality-of-Service events from downstream.</doc> <source-position filename="gst-libs/gst/video/gstvideoencoder.h" line="379"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3094">%TRUE if the encoder is configured to perform Quality-of-Service.</doc> + line="3110">%TRUE if the encoder is configured to perform Quality-of-Service.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3089">the encoder</doc> + line="3105">the encoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> </parameters> @@ -11235,7 +11253,7 @@ events from downstream.</doc> <method name="merge_tags" c:identifier="gst_video_encoder_merge_tags"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2937">Sets the video encoder tags and how they should be merged with any + line="2953">Sets the video encoder tags and how they should be merged with any upstream stream tags. This will override any tags previously-set with gst_video_encoder_merge_tags(). @@ -11252,7 +11270,7 @@ MT safe.</doc> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2939">a #GstVideoEncoder</doc> + line="2955">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="tags" @@ -11261,14 +11279,14 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2940">a #GstTagList to merge, or NULL to unset + line="2956">a #GstTagList to merge, or NULL to unset previously-set tags</doc> <type name="Gst.TagList" c:type="const GstTagList*"/> </parameter> <parameter name="mode" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2942">the #GstTagMergeMode to use, usually #GST_TAG_MERGE_REPLACE</doc> + line="2958">the #GstTagMergeMode to use, usually #GST_TAG_MERGE_REPLACE</doc> <type name="Gst.TagMergeMode" c:type="GstTagMergeMode"/> </parameter> </parameters> @@ -11276,7 +11294,7 @@ MT safe.</doc> <method name="negotiate" c:identifier="gst_video_encoder_negotiate"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="1986">Negotiate with downstream elements to currently configured #GstVideoCodecState. + line="1992">Negotiate with downstream elements to currently configured #GstVideoCodecState. Unmark GST_PAD_FLAG_NEED_RECONFIGURE in any case. But mark it again if negotiate fails.</doc> <source-position filename="gst-libs/gst/video/gstvideoencoder.h" @@ -11284,14 +11302,14 @@ negotiate fails.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="1994">%TRUE if the negotiation succeeded, else %FALSE.</doc> + line="2000">%TRUE if the negotiation succeeded, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="1988">a #GstVideoEncoder</doc> + line="1994">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> </parameters> @@ -11300,7 +11318,7 @@ negotiate fails.</doc> c:identifier="gst_video_encoder_proxy_getcaps"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="769">Returns caps that express @caps (or sink template caps if @caps == NULL) + line="775">Returns caps that express @caps (or sink template caps if @caps == NULL) restricted to resolution/format/... combinations supported by downstream elements (e.g. muxers).</doc> <source-position filename="gst-libs/gst/video/gstvideoencoder.h" @@ -11308,14 +11326,14 @@ elements (e.g. muxers).</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="779">a #GstCaps owned by caller</doc> + line="785">a #GstCaps owned by caller</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </return-value> <parameters> <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="771">a #GstVideoEncoder</doc> + line="777">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="caps" @@ -11324,7 +11342,7 @@ elements (e.g. muxers).</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="772">initial caps</doc> + line="778">initial caps</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> <parameter name="filter" @@ -11333,7 +11351,7 @@ elements (e.g. muxers).</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="773">filter caps</doc> + line="779">filter caps</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> </parameters> @@ -11341,7 +11359,7 @@ elements (e.g. muxers).</doc> <method name="set_headers" c:identifier="gst_video_encoder_set_headers"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="609">Set the codec headers to be sent downstream whenever requested.</doc> + line="615">Set the codec headers to be sent downstream whenever requested.</doc> <source-position filename="gst-libs/gst/video/gstvideoencoder.h" line="359"/> <return-value transfer-ownership="none"> @@ -11351,13 +11369,13 @@ elements (e.g. muxers).</doc> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="611">a #GstVideoEncoder</doc> + line="617">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="headers" transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="612">a list of #GstBuffer containing the codec header</doc> + line="618">a list of #GstBuffer containing the codec header</doc> <type name="GLib.List" c:type="GList*"> <type name="Gst.Buffer"/> </type> @@ -11367,7 +11385,7 @@ elements (e.g. muxers).</doc> <method name="set_latency" c:identifier="gst_video_encoder_set_latency"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2816">Informs baseclass of encoding latency.</doc> + line="2832">Informs baseclass of encoding latency.</doc> <source-position filename="gst-libs/gst/video/gstvideoencoder.h" line="349"/> <return-value transfer-ownership="none"> @@ -11377,19 +11395,19 @@ elements (e.g. muxers).</doc> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2818">a #GstVideoEncoder</doc> + line="2834">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="min_latency" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2819">minimum latency</doc> + line="2835">minimum latency</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </parameter> <parameter name="max_latency" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2820">maximum latency</doc> + line="2836">maximum latency</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </parameter> </parameters> @@ -11399,7 +11417,7 @@ elements (e.g. muxers).</doc> version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3109">Sets the minimum interval for requesting keyframes based on force-keyunit + line="3125">Sets the minimum interval for requesting keyframes based on force-keyunit events. Setting this to 0 will allow to handle every event, setting this to %GST_CLOCK_TIME_NONE causes force-keyunit events to be ignored.</doc> <source-position filename="gst-libs/gst/video/gstvideoencoder.h" @@ -11411,13 +11429,13 @@ events. Setting this to 0 will allow to handle every event, setting this to <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3111">the encoder</doc> + line="3127">the encoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="interval" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3112">minimum interval</doc> + line="3128">minimum interval</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </parameter> </parameters> @@ -11427,7 +11445,7 @@ events. Setting this to 0 will allow to handle every event, setting this to version="1.6"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3007">Request minimal value for PTS passed to handle_frame. + line="3023">Request minimal value for PTS passed to handle_frame. For streams with reordered frames this can be used to ensure that there is enough time to accommodate first DTS, which may be less than first PTS</doc> @@ -11440,13 +11458,13 @@ is enough time to accommodate first DTS, which may be less than first PTS</doc> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3009">a #GstVideoEncoder</doc> + line="3025">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="min_pts" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3010">minimal PTS that will be passed to handle_frame</doc> + line="3026">minimal PTS that will be passed to handle_frame</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </parameter> </parameters> @@ -11455,7 +11473,7 @@ is enough time to accommodate first DTS, which may be less than first PTS</doc> c:identifier="gst_video_encoder_set_output_state"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2757">Creates a new #GstVideoCodecState with the specified caps as the output state + line="2773">Creates a new #GstVideoCodecState with the specified caps as the output state for the encoder. Any previously set output state on @encoder will be replaced by the newly created one. @@ -11478,20 +11496,20 @@ from the next call to #gst_video_encoder_finish_frame().</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2782">the newly configured output state.</doc> + line="2798">the newly configured output state.</doc> <type name="VideoCodecState" c:type="GstVideoCodecState*"/> </return-value> <parameters> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2759">a #GstVideoEncoder</doc> + line="2775">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="caps" transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2760">the #GstCaps to use for the output</doc> + line="2776">the #GstCaps to use for the output</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> <parameter name="reference" @@ -11500,7 +11518,7 @@ from the next call to #gst_video_encoder_finish_frame().</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2761">An optional reference @GstVideoCodecState</doc> + line="2777">An optional reference @GstVideoCodecState</doc> <type name="VideoCodecState" c:type="GstVideoCodecState*"/> </parameter> </parameters> @@ -11510,7 +11528,7 @@ from the next call to #gst_video_encoder_finish_frame().</doc> version="1.14"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3071">Configures @encoder to handle Quality-of-Service events from downstream.</doc> + line="3087">Configures @encoder to handle Quality-of-Service events from downstream.</doc> <source-position filename="gst-libs/gst/video/gstvideoencoder.h" line="376"/> <return-value transfer-ownership="none"> @@ -11520,13 +11538,13 @@ from the next call to #gst_video_encoder_finish_frame().</doc> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3073">the encoder</doc> + line="3089">the encoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="enabled" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3074">the new qos value.</doc> + line="3090">the new qos value.</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -11537,7 +11555,7 @@ from the next call to #gst_video_encoder_finish_frame().</doc> transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="406">Minimum interval between force-keyunit requests in nanoseconds. See + line="410">Minimum interval between force-keyunit requests in nanoseconds. See gst_video_encoder_set_min_force_key_unit_interval() for more details.</doc> <type name="guint64" c:type="guint64"/> </property> @@ -11780,14 +11798,14 @@ and @get_caps are likely needed as well.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="1994">%TRUE if the negotiation succeeded, else %FALSE.</doc> + line="2000">%TRUE if the negotiation succeeded, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="1988">a #GstVideoEncoder</doc> + line="1994">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </parameter> </parameters> @@ -12990,25 +13008,41 @@ for details about the layout and packing of these formats in memory.</doc> filename="gst-libs/gst/video/video-format.h" line="131">packed 4:4:4:4 YUV, 12 bits per channel(U-Y-V-A...) (Since: 1.18)</doc> </member> + <member name="nv12_4l4" + value="97" + c:identifier="GST_VIDEO_FORMAT_NV12_4L4" + glib:nick="nv12-4l4"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-format.h" + line="132">NV12 with 4x4 tiles in linear order (Since: 1.18)</doc> + </member> + <member name="nv12_32l32" + value="98" + c:identifier="GST_VIDEO_FORMAT_NV12_32L32" + glib:nick="nv12-32l32"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-format.h" + line="133">NV12 with 32x32 tiles in linear order (Since: 1.18)</doc> + </member> <function name="from_fourcc" c:identifier="gst_video_format_from_fourcc"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6804">Converts a FOURCC value into the corresponding #GstVideoFormat. + line="6815">Converts a FOURCC value into the corresponding #GstVideoFormat. If the FOURCC cannot be represented by #GstVideoFormat, #GST_VIDEO_FORMAT_UNKNOWN is returned.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="552"/> + line="571"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6812">the #GstVideoFormat describing the FOURCC value</doc> + line="6823">the #GstVideoFormat describing the FOURCC value</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </return-value> <parameters> <parameter name="fourcc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6806">a FOURCC value representing raw YUV video</doc> + line="6817">a FOURCC value representing raw YUV video</doc> <type name="guint32" c:type="guint32"/> </parameter> </parameters> @@ -13016,13 +13050,13 @@ If the FOURCC cannot be represented by #GstVideoFormat, <function name="from_masks" c:identifier="gst_video_format_from_masks"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6730">Find the #GstVideoFormat for the given parameters.</doc> + line="6741">Find the #GstVideoFormat for the given parameters.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="547"/> + line="566"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6743">a #GstVideoFormat or GST_VIDEO_FORMAT_UNKNOWN when the parameters to + line="6754">a #GstVideoFormat or GST_VIDEO_FORMAT_UNKNOWN when the parameters to not specify a known format.</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </return-value> @@ -13030,44 +13064,44 @@ not specify a known format.</doc> <parameter name="depth" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6732">the amount of bits used for a pixel</doc> + line="6743">the amount of bits used for a pixel</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="bpp" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6733">the amount of bits used to store a pixel. This value is bigger than + line="6744">the amount of bits used to store a pixel. This value is bigger than @depth</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="endianness" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6735">the endianness of the masks, #G_LITTLE_ENDIAN or #G_BIG_ENDIAN</doc> + line="6746">the endianness of the masks, #G_LITTLE_ENDIAN or #G_BIG_ENDIAN</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="red_mask" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6736">the red mask</doc> + line="6747">the red mask</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="green_mask" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6737">the green mask</doc> + line="6748">the green mask</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="blue_mask" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6738">the blue mask</doc> + line="6749">the blue mask</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="alpha_mask" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6739">the alpha mask, or 0 if no alpha mask</doc> + line="6750">the alpha mask, or 0 if no alpha mask</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -13075,13 +13109,13 @@ not specify a known format.</doc> <function name="from_string" c:identifier="gst_video_format_from_string"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6896">Convert the @format string to its #GstVideoFormat.</doc> + line="6907">Convert the @format string to its #GstVideoFormat.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="555"/> + line="574"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6902">the #GstVideoFormat for @format or GST_VIDEO_FORMAT_UNKNOWN when the + line="6913">the #GstVideoFormat for @format or GST_VIDEO_FORMAT_UNKNOWN when the string is not a known format.</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </return-value> @@ -13089,7 +13123,7 @@ string is not a known format.</doc> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6898">a format string</doc> + line="6909">a format string</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -13097,20 +13131,20 @@ string is not a known format.</doc> <function name="get_info" c:identifier="gst_video_format_get_info"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6961">Get the #GstVideoFormatInfo for @format</doc> + line="6972">Get the #GstVideoFormatInfo for @format</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="565"/> + line="584"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6967">The #GstVideoFormatInfo for @format.</doc> + line="6978">The #GstVideoFormatInfo for @format.</doc> <type name="VideoFormatInfo" c:type="const GstVideoFormatInfo*"/> </return-value> <parameters> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6963">a #GstVideoFormat</doc> + line="6974">a #GstVideoFormat</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </parameter> </parameters> @@ -13120,14 +13154,14 @@ string is not a known format.</doc> version="1.2"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6977">Get the default palette of @format. This the palette used in the pack + line="6988">Get the default palette of @format. This the palette used in the pack function for paletted formats.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="568"/> + line="587"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6985">the default palette of @format or %NULL when + line="6996">the default palette of @format or %NULL when @format does not have a palette.</doc> <type name="gpointer" c:type="gconstpointer"/> </return-value> @@ -13135,7 +13169,7 @@ function for paletted formats.</doc> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6979">a #GstVideoFormat</doc> + line="6990">a #GstVideoFormat</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </parameter> <parameter name="size" @@ -13144,7 +13178,7 @@ function for paletted formats.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6980">size of the palette in bytes</doc> + line="6991">size of the palette in bytes</doc> <type name="gsize" c:type="gsize*"/> </parameter> </parameters> @@ -13152,22 +13186,22 @@ function for paletted formats.</doc> <function name="to_fourcc" c:identifier="gst_video_format_to_fourcc"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6920">Converts a #GstVideoFormat value into the corresponding FOURCC. Only + line="6931">Converts a #GstVideoFormat value into the corresponding FOURCC. Only a few YUV formats have corresponding FOURCC values. If @format has no corresponding FOURCC value, 0 is returned.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="558"/> + line="577"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6928">the FOURCC corresponding to @format</doc> + line="6939">the FOURCC corresponding to @format</doc> <type name="guint32" c:type="guint32"/> </return-value> <parameters> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6922">a #GstVideoFormat video format</doc> + line="6933">a #GstVideoFormat video format</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </parameter> </parameters> @@ -13175,21 +13209,21 @@ no corresponding FOURCC value, 0 is returned.</doc> <function name="to_string" c:identifier="gst_video_format_to_string"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6941">Returns a string containing a descriptive name for + line="6952">Returns a string containing a descriptive name for the #GstVideoFormat if there is one, or NULL otherwise.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="561"/> + line="580"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6948">the name corresponding to @format</doc> + line="6959">the name corresponding to @format</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6943">a #GstVideoFormat video format</doc> + line="6954">a #GstVideoFormat video format</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </parameter> </parameters> @@ -13201,14 +13235,14 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> c:type="GstVideoFormatFlags"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="243">The different video flags that a format info can have.</doc> + line="262">The different video flags that a format info can have.</doc> <member name="yuv" value="1" c:identifier="GST_VIDEO_FORMAT_FLAG_YUV" glib:nick="yuv"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="245">The video format is YUV, components are numbered + line="264">The video format is YUV, components are numbered 0=Y, 1=U, 2=V.</doc> </member> <member name="rgb" @@ -13217,7 +13251,7 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> glib:nick="rgb"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="247">The video format is RGB, components are numbered + line="266">The video format is RGB, components are numbered 0=R, 1=G, 2=B.</doc> </member> <member name="gray" @@ -13226,7 +13260,7 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> glib:nick="gray"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="249">The video is gray, there is one gray component + line="268">The video is gray, there is one gray component with index 0.</doc> </member> <member name="alpha" @@ -13235,7 +13269,7 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> glib:nick="alpha"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="251">The video format has an alpha components with + line="270">The video format has an alpha components with the number 3.</doc> </member> <member name="le" @@ -13244,7 +13278,7 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> glib:nick="le"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="253">The video format has data stored in little + line="272">The video format has data stored in little endianness.</doc> </member> <member name="palette" @@ -13253,7 +13287,7 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> glib:nick="palette"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="255">The video format has a palette. The palette + line="274">The video format has a palette. The palette is stored in the second plane and indexes are stored in the first plane.</doc> </member> <member name="complex" @@ -13262,7 +13296,7 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> glib:nick="complex"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="257">The video format has a complex layout that + line="276">The video format has a complex layout that can't be described with the usual information in the #GstVideoFormatInfo.</doc> </member> <member name="unpack" @@ -13271,7 +13305,7 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> glib:nick="unpack"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="259">This format can be used in a + line="278">This format can be used in a #GstVideoFormatUnpack and #GstVideoFormatPack function.</doc> </member> <member name="tiled" @@ -13280,44 +13314,44 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> glib:nick="tiled"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="261">The format is tiled, there is tiling information + line="280">The format is tiled, there is tiling information in the last plane.</doc> </member> </bitfield> <record name="VideoFormatInfo" c:type="GstVideoFormatInfo"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="389">Information for a video format.</doc> + line="408">Information for a video format.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="454"/> + line="473"/> <field name="format" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="391">#GstVideoFormat</doc> + line="410">#GstVideoFormat</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </field> <field name="name" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="392">string representation of the format</doc> + line="411">string representation of the format</doc> <type name="utf8" c:type="const gchar*"/> </field> <field name="description" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="393">use readable description of the format</doc> + line="412">use readable description of the format</doc> <type name="utf8" c:type="const gchar*"/> </field> <field name="flags" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="394">#GstVideoFormatFlags</doc> + line="413">#GstVideoFormatFlags</doc> <type name="VideoFormatFlags" c:type="GstVideoFormatFlags"/> </field> <field name="bits" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="395">The number of bits used to pack data items. This can be less than 8 + line="414">The number of bits used to pack data items. This can be less than 8 when multiple pixels are stored in a byte. for values > 8 multiple bytes should be read according to the endianness flag before applying the shift and mask.</doc> @@ -13326,13 +13360,13 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> <field name="n_components" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="399">the number of components in the video format.</doc> + line="418">the number of components in the video format.</doc> <type name="guint" c:type="guint"/> </field> <field name="shift" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="400">the number of bits to shift away to get the component data</doc> + line="419">the number of bits to shift away to get the component data</doc> <array zero-terminated="0" fixed-size="4"> <type name="guint" c:type="guint"/> </array> @@ -13340,7 +13374,7 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> <field name="depth" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="401">the depth in bits for each component</doc> + line="420">the depth in bits for each component</doc> <array zero-terminated="0" fixed-size="4"> <type name="guint" c:type="guint"/> </array> @@ -13348,7 +13382,7 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> <field name="pixel_stride" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="402">the pixel stride of each component. This is the amount of + line="421">the pixel stride of each component. This is the amount of bytes to the pixel immediately to the right. When bits < 8, the stride is expressed in bits. For 24-bit RGB, this would be 3 bytes, for example, while it would be 4 bytes for RGBx or ARGB.</doc> @@ -13359,7 +13393,7 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> <field name="n_planes" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="406">the number of planes for this format. The number of planes can be + line="425">the number of planes for this format. The number of planes can be less than the amount of components when multiple components are packed into one plane.</doc> <type name="guint" c:type="guint"/> @@ -13367,7 +13401,7 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> <field name="plane" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="409">the plane number where a component can be found</doc> + line="428">the plane number where a component can be found</doc> <array zero-terminated="0" fixed-size="4"> <type name="guint" c:type="guint"/> </array> @@ -13375,7 +13409,7 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> <field name="poffset" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="410">the offset in the plane where the first pixel of the components + line="429">the offset in the plane where the first pixel of the components can be found.</doc> <array zero-terminated="0" fixed-size="4"> <type name="guint" c:type="guint"/> @@ -13384,7 +13418,7 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> <field name="w_sub" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="412">subsampling factor of the width for the component. Use + line="431">subsampling factor of the width for the component. Use GST_VIDEO_SUB_SCALE to scale a width.</doc> <array zero-terminated="0" fixed-size="4"> <type name="guint" c:type="guint"/> @@ -13393,7 +13427,7 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> <field name="h_sub" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="414">subsampling factor of the height for the component. Use + line="433">subsampling factor of the height for the component. Use GST_VIDEO_SUB_SCALE to scale a height.</doc> <array zero-terminated="0" fixed-size="4"> <type name="guint" c:type="guint"/> @@ -13402,44 +13436,44 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> <field name="unpack_format" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="416">the format of the unpacked pixels. This format must have the + line="435">the format of the unpacked pixels. This format must have the #GST_VIDEO_FORMAT_FLAG_UNPACK flag set.</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </field> <field name="unpack_func" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="418">an unpack function for this format</doc> + line="437">an unpack function for this format</doc> <type name="VideoFormatUnpack" c:type="GstVideoFormatUnpack"/> </field> <field name="pack_lines" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="419">the amount of lines that will be packed</doc> + line="438">the amount of lines that will be packed</doc> <type name="gint" c:type="gint"/> </field> <field name="pack_func" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="420">an pack function for this format</doc> + line="439">an pack function for this format</doc> <type name="VideoFormatPack" c:type="GstVideoFormatPack"/> </field> <field name="tile_mode" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="421">The tiling mode</doc> + line="440">The tiling mode</doc> <type name="VideoTileMode" c:type="GstVideoTileMode"/> </field> <field name="tile_ws" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="422">The width of a tile, in bytes, represented as a shift</doc> + line="441">The width of a tile, in bytes, represented as a shift</doc> <type name="guint" c:type="guint"/> </field> <field name="tile_hs" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="423">The height of a tile, in bytes, represented as a shift</doc> + line="442">The height of a tile, in bytes, represented as a shift</doc> <type name="guint" c:type="guint"/> </field> <field name="_gst_reserved" readable="0" private="1"> @@ -13452,11 +13486,11 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7005">Fill @components with the number of all the components packed in plane @p + line="7016">Fill @components with the number of all the components packed in plane @p for the format @info. A value of -1 in @components indicates that no more components are packed in the plane.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="542"/> + line="561"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -13464,13 +13498,13 @@ components are packed in the plane.</doc> <instance-parameter name="info" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7007">#GstVideoFormatInfo</doc> + line="7018">#GstVideoFormatInfo</doc> <type name="VideoFormatInfo" c:type="const GstVideoFormatInfo*"/> </instance-parameter> <parameter name="plane" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7008">a plane number</doc> + line="7019">a plane number</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="components" @@ -13479,7 +13513,7 @@ components are packed in the plane.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7009">array used to store component numbers</doc> + line="7020">array used to store component numbers</doc> <type name="gint" c:type="gint*"/> </parameter> </parameters> @@ -13488,7 +13522,7 @@ components are packed in the plane.</doc> <callback name="VideoFormatPack" c:type="GstVideoFormatPack"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="349">Packs @width pixels from @src to the given planes and strides in the + line="368">Packs @width pixels from @src to the given planes and strides in the format @info. The pixels from source have each component interleaved and will be packed into the planes in @data. @@ -13505,7 +13539,7 @@ pack pixels starting from an unaligned position. For tiled images this means that packing should start from a tile coordinate. For subsampled formats this means that a complete pixel needs to be packed.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="381"/> + line="400"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -13513,13 +13547,13 @@ formats this means that a complete pixel needs to be packed.</doc> <parameter name="info" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="351">a #GstVideoFormatInfo</doc> + line="370">a #GstVideoFormatInfo</doc> <type name="VideoFormatInfo" c:type="const GstVideoFormatInfo*"/> </parameter> <parameter name="flags" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="352">flags to control the packing</doc> + line="371">flags to control the packing</doc> <type name="VideoPackFlags" c:type="GstVideoPackFlags"/> </parameter> <parameter name="src" @@ -13528,13 +13562,13 @@ formats this means that a complete pixel needs to be packed.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="353">a source array</doc> + line="372">a source array</doc> <type name="gpointer" c:type="const gpointer"/> </parameter> <parameter name="sstride" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="354">the source array stride</doc> + line="373">the source array stride</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="data" @@ -13543,31 +13577,31 @@ formats this means that a complete pixel needs to be packed.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="355">pointers to the destination data planes</doc> + line="374">pointers to the destination data planes</doc> <type name="gpointer" c:type="gpointer*"/> </parameter> <parameter name="stride" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="356">strides of the destination planes</doc> + line="375">strides of the destination planes</doc> <type name="gint" c:type="const gint*"/> </parameter> <parameter name="chroma_site" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="357">the chroma siting of the target when subsampled (not used)</doc> + line="376">the chroma siting of the target when subsampled (not used)</doc> <type name="VideoChromaSite" c:type="GstVideoChromaSite"/> </parameter> <parameter name="y" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="358">the y position in the image to pack to</doc> + line="377">the y position in the image to pack to</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="width" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="359">the amount of pixels to pack.</doc> + line="378">the amount of pixels to pack.</doc> <type name="gint" c:type="gint"/> </parameter> </parameters> @@ -13575,7 +13609,7 @@ formats this means that a complete pixel needs to be packed.</doc> <callback name="VideoFormatUnpack" c:type="GstVideoFormatUnpack"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="319">Unpacks @width pixels from the given planes and strides containing data of + line="338">Unpacks @width pixels from the given planes and strides containing data of format @info. The pixels will be unpacked into @dest with each component interleaved as per @info's unpack_format, which will usually be one of #GST_VIDEO_FORMAT_ARGB, #GST_VIDEO_FORMAT_AYUV, #GST_VIDEO_FORMAT_ARGB64 or @@ -13589,7 +13623,7 @@ For subsampled formats, the components will be duplicated in the destination array. Reconstruction of the missing components can be performed in a separate step after unpacking.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="344"/> + line="363"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -13597,13 +13631,13 @@ separate step after unpacking.</doc> <parameter name="info" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="321">a #GstVideoFormatInfo</doc> + line="340">a #GstVideoFormatInfo</doc> <type name="VideoFormatInfo" c:type="const GstVideoFormatInfo*"/> </parameter> <parameter name="flags" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="322">flags to control the unpacking</doc> + line="341">flags to control the unpacking</doc> <type name="VideoPackFlags" c:type="GstVideoPackFlags"/> </parameter> <parameter name="dest" @@ -13612,7 +13646,7 @@ separate step after unpacking.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="323">a destination array</doc> + line="342">a destination array</doc> <type name="gpointer" c:type="gpointer"/> </parameter> <parameter name="data" @@ -13621,31 +13655,31 @@ separate step after unpacking.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="324">pointers to the data planes</doc> + line="343">pointers to the data planes</doc> <type name="gpointer" c:type="const gpointer*"/> </parameter> <parameter name="stride" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="325">strides of the planes</doc> + line="344">strides of the planes</doc> <type name="gint" c:type="const gint*"/> </parameter> <parameter name="x" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="326">the x position in the image to start from</doc> + line="345">the x position in the image to start from</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="y" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="327">the y position in the image to start from</doc> + line="346">the y position in the image to start from</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="width" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="328">the amount of pixels to unpack.</doc> + line="347">the amount of pixels to unpack.</doc> <type name="gint" c:type="gint"/> </parameter> </parameters> @@ -13710,13 +13744,16 @@ separate step after unpacking.</doc> <method name="copy" c:identifier="gst_video_frame_copy"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-frame.c" - line="394">Copy the contents from @src to @dest.</doc> + line="394">Copy the contents from @src to @dest. + +Note: Since: 1.18, @dest dimensions are allowed to be +smaller than @src dimensions.</doc> <source-position filename="gst-libs/gst/video/video-frame.h" line="108"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-frame.c" - line="401">TRUE if the contents could be copied.</doc> + line="404">TRUE if the contents could be copied.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> @@ -14410,7 +14447,7 @@ gst_video_info_init().</doc> <method name="align" c:identifier="gst_video_info_align"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1413">Adjust the offset and stride fields in @info so that the padding and + line="1432">Adjust the offset and stride fields in @info so that the padding and stride alignment in @align is respected. Extra padding will be added to the right side when stride alignment padding @@ -14420,7 +14457,7 @@ is required and @align will be updated with the new padding values.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1424">%FALSE if alignment could not be applied, e.g. because the + line="1443">%FALSE if alignment could not be applied, e.g. because the size of a frame can't be represented as a 32 bit integer (Since: 1.12)</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -14428,13 +14465,13 @@ is required and @align will be updated with the new padding values.</doc> <instance-parameter name="info" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1415">a #GstVideoInfo</doc> + line="1434">a #GstVideoInfo</doc> <type name="VideoInfo" c:type="GstVideoInfo*"/> </instance-parameter> <parameter name="align" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1416">alignment parameters</doc> + line="1435">alignment parameters</doc> <type name="VideoAlignment" c:type="GstVideoAlignment*"/> </parameter> </parameters> @@ -14444,7 +14481,7 @@ is required and @align will be updated with the new padding values.</doc> version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1293">This variant of gst_video_info_align() provides the updated size, in bytes, + line="1312">This variant of gst_video_info_align() provides the updated size, in bytes, of each video plane after the alignment, including all horizontal and vertical paddings. @@ -14455,7 +14492,7 @@ ones used to hold a single field, not the full frame.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1306">%FALSE if alignment could not be applied, e.g. because the + line="1325">%FALSE if alignment could not be applied, e.g. because the size of a frame can't be represented as a 32 bit integer</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -14463,13 +14500,13 @@ ones used to hold a single field, not the full frame.</doc> <instance-parameter name="info" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1295">a #GstVideoInfo</doc> + line="1314">a #GstVideoInfo</doc> <type name="VideoInfo" c:type="GstVideoInfo*"/> </instance-parameter> <parameter name="align" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1296">alignment parameters</doc> + line="1315">alignment parameters</doc> <type name="VideoAlignment" c:type="GstVideoAlignment*"/> </parameter> <parameter name="plane_size" @@ -14480,7 +14517,7 @@ ones used to hold a single field, not the full frame.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1297">array used to store the plane sizes</doc> + line="1316">array used to store the plane sizes</doc> <type name="gsize" c:type="gsize*"/> </parameter> </parameters> @@ -14488,7 +14525,7 @@ ones used to hold a single field, not the full frame.</doc> <method name="convert" c:identifier="gst_video_info_convert"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1167">Converts among various #GstFormat types. This function handles + line="1186">Converts among various #GstFormat types. This function handles GST_FORMAT_BYTES, GST_FORMAT_TIME, and GST_FORMAT_DEFAULT. For raw video, GST_FORMAT_DEFAULT corresponds to video frames. This function can be used to handle pad queries of the type GST_QUERY_CONVERT.</doc> @@ -14497,32 +14534,32 @@ function can be used to handle pad queries of the type GST_QUERY_CONVERT.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1180">TRUE if the conversion was successful.</doc> + line="1199">TRUE if the conversion was successful.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="info" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1169">a #GstVideoInfo</doc> + line="1188">a #GstVideoInfo</doc> <type name="VideoInfo" c:type="GstVideoInfo*"/> </instance-parameter> <parameter name="src_format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1170">#GstFormat of the @src_value</doc> + line="1189">#GstFormat of the @src_value</doc> <type name="Gst.Format" c:type="GstFormat"/> </parameter> <parameter name="src_value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1171">value to convert</doc> + line="1190">value to convert</doc> <type name="gint64" c:type="gint64"/> </parameter> <parameter name="dest_format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1172">#GstFormat of the @dest_value</doc> + line="1191">#GstFormat of the @dest_value</doc> <type name="Gst.Format" c:type="GstFormat"/> </parameter> <parameter name="dest_value" @@ -14531,7 +14568,7 @@ function can be used to handle pad queries of the type GST_QUERY_CONVERT.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1173">pointer to destination value</doc> + line="1192">pointer to destination value</doc> <type name="gint64" c:type="gint64*"/> </parameter> </parameters> @@ -14820,7 +14857,7 @@ mode of the stream.</doc> line="68">1 field is stored in one buffer, @GST_VIDEO_BUFFER_FLAG_TF or @GST_VIDEO_BUFFER_FLAG_BF indicates if the buffer is carrying the top or bottom field, respectively. The top and - bottom buffers are expected to alternate in the pipeline, with this mode + bottom buffers must alternate in the pipeline, with this mode (Since: 1.16).</doc> </member> <function name="from_string" @@ -18341,14 +18378,14 @@ gst_video_overlay_composition_copy().</doc> c:type="GstVideoPackFlags"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="298">The different flags that can be used when packing and unpacking.</doc> + line="317">The different flags that can be used when packing and unpacking.</doc> <member name="none" value="0" c:identifier="GST_VIDEO_PACK_FLAG_NONE" glib:nick="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="300">No flag</doc> + line="319">No flag</doc> </member> <member name="truncate_range" value="1" @@ -18356,7 +18393,7 @@ gst_video_overlay_composition_copy().</doc> glib:nick="truncate-range"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="301">When the source has a smaller depth + line="320">When the source has a smaller depth than the target format, set the least significant bits of the target to 0. This is likely slightly faster but less accurate. When this flag is not specified, the most significant bits of the source are duplicated @@ -18368,7 +18405,7 @@ gst_video_overlay_composition_copy().</doc> glib:nick="interlaced"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="306">The source is interlaced. The unpacked + line="325">The source is interlaced. The unpacked format will be interlaced as well with each line containing information from alternating fields. (Since: 1.2)</doc> </member> @@ -18443,7 +18480,7 @@ gst_video_overlay_composition_copy().</doc> filename="gst-libs/gst/video/gstvideometa.h" line="304">Extra buffer metadata describing an image region of interest</doc> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="331"/> + line="332"/> <field name="meta" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideometa.h" @@ -18495,7 +18532,8 @@ gst_video_overlay_composition_copy().</doc> <field name="params" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideometa.h" - line="314">list of #GstStructure containing element-specific params for downstream, see gst_video_region_of_interest_meta_add_params(). (Since: 1.14)</doc> + line="314">list of #GstStructure containing element-specific params for downstream, + see gst_video_region_of_interest_meta_add_param(). (Since: 1.14)</doc> <type name="GLib.List" c:type="GList*"> <type name="gpointer" c:type="gpointer"/> </type> @@ -18515,7 +18553,7 @@ QP offsets this encoder should use when encoding the region described in @meta. Multiple parameters can be defined for the same meta so different encoders can be supported by cross platform applications).</doc> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="362"/> + line="363"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -18545,7 +18583,7 @@ or %NULL if there is none.</doc> <doc-version xml:space="preserve"> See also: gst_video_region_of_interest_meta_add_param()</doc-version> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="366"/> + line="367"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideometa.c" @@ -18571,7 +18609,7 @@ See also: gst_video_region_of_interest_meta_add_param()</doc-version> <function name="get_info" c:identifier="gst_video_region_of_interest_meta_get_info"> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="337"/> + line="338"/> <return-value transfer-ownership="none"> <type name="Gst.MetaInfo" c:type="const GstMetaInfo*"/> </return-value> @@ -19362,6 +19400,14 @@ frames will only be rendered in PLAYING state.</doc> in memory in Z or flipped Z order. In case of odd rows, the last row of blocks is arranged in linear order.</doc> </member> + <member name="linear" + value="131072" + c:identifier="GST_VIDEO_TILE_MODE_LINEAR" + glib:nick="linear"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-tile.h" + line="115">Tiles are in row order. (Since: 1.18)</doc> + </member> </enumeration> <enumeration name="VideoTileType" glib:type-name="GstVideoTileType" @@ -20413,28 +20459,28 @@ Will not necessarily correspond to a real timecode (e.g. 00:00:10;00)</doc> version="1.10"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideometa.h" - line="369">Extra buffer metadata describing the GstVideoTimeCode of the frame. + line="370">Extra buffer metadata describing the GstVideoTimeCode of the frame. Each frame is assumed to have its own timecode, i.e. they are not automatically incremented/interpolated.</doc> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="385"/> + line="386"/> <field name="meta" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideometa.h" - line="371">parent #GstMeta</doc> + line="372">parent #GstMeta</doc> <type name="Gst.Meta" c:type="GstMeta"/> </field> <field name="tc" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideometa.h" - line="372">the GstVideoTimeCode to attach</doc> + line="373">the GstVideoTimeCode to attach</doc> <type name="VideoTimeCode" c:type="GstVideoTimeCode"/> </field> <function name="get_info" c:identifier="gst_video_time_code_meta_get_info"> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="392"/> + line="393"/> <return-value transfer-ownership="none"> <type name="Gst.MetaInfo" c:type="const GstMetaInfo*"/> </return-value> @@ -20446,7 +20492,7 @@ automatically incremented/interpolated.</doc> c:type="GstVideoTransferFunction"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="71">The video transfer function defines the formula for converting between + line="73">The video transfer function defines the formula for converting between non-linear RGB (R'G'B') and linear RGB</doc> <member name="unknown" value="0" @@ -20454,7 +20500,7 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="unknown"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="73">unknown transfer function</doc> + line="75">unknown transfer function</doc> </member> <member name="gamma10" value="1" @@ -20462,7 +20508,7 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="gamma10"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="74">linear RGB, gamma 1.0 curve</doc> + line="76">linear RGB, gamma 1.0 curve</doc> </member> <member name="gamma18" value="2" @@ -20470,7 +20516,7 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="gamma18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="75">Gamma 1.8 curve</doc> + line="77">Gamma 1.8 curve</doc> </member> <member name="gamma20" value="3" @@ -20478,7 +20524,7 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="gamma20"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="76">Gamma 2.0 curve</doc> + line="78">Gamma 2.0 curve</doc> </member> <member name="gamma22" value="4" @@ -20486,7 +20532,7 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="gamma22"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="77">Gamma 2.2 curve</doc> + line="79">Gamma 2.2 curve</doc> </member> <member name="bt709" value="5" @@ -20494,8 +20540,9 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="bt709"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="78">Gamma 2.2 curve with a linear segment in the lower - range</doc> + line="80">Gamma 2.2 curve with a linear segment in the lower + range, also ITU-R BT470M / ITU-R BT1700 625 PAL & + SECAM / ITU-R BT1361</doc> </member> <member name="smpte240m" value="6" @@ -20503,7 +20550,7 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="smpte240m"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="80">Gamma 2.2 curve with a linear segment in the + line="83">Gamma 2.2 curve with a linear segment in the lower range</doc> </member> <member name="srgb" @@ -20512,8 +20559,8 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="srgb"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="82">Gamma 2.4 curve with a linear segment in the lower - range</doc> + line="85">Gamma 2.4 curve with a linear segment in the lower + range. IEC 61966-2-1 (sRGB or sYCC)</doc> </member> <member name="gamma28" value="8" @@ -20521,7 +20568,7 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="gamma28"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="84">Gamma 2.8 curve</doc> + line="87">Gamma 2.8 curve, also ITU-R BT470BG</doc> </member> <member name="log100" value="9" @@ -20529,7 +20576,7 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="log100"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="85">Logarithmic transfer characteristic + line="88">Logarithmic transfer characteristic 100:1 range</doc> </member> <member name="log316" @@ -20538,8 +20585,8 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="log316"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="87">Logarithmic transfer characteristic - 316.22777:1 range</doc> + line="90">Logarithmic transfer characteristic + 316.22777:1 range (100 * sqrt(10) : 1)</doc> </member> <member name="bt2020_12" value="11" @@ -20547,7 +20594,7 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="bt2020-12"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="89">Gamma 2.2 curve with a linear segment in the lower + line="92">Gamma 2.2 curve with a linear segment in the lower range. Used for BT.2020 with 12 bits per component. Since: 1.6</doc> </member> @@ -20557,7 +20604,7 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="adobergb"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="92">Gamma 2.19921875. Since: 1.8</doc> + line="95">Gamma 2.19921875. Since: 1.8</doc> </member> <member name="bt2020_10" value="13" @@ -20565,9 +20612,9 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="bt2020-10"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="93">Rec. ITU-R BT.2020-2 with 10 bits per component. + line="96">Rec. ITU-R BT.2020-2 with 10 bits per component. (functionally the same as the values - GST_VIDEO_TRANSFER_BT709 and GST_VIDEO_TRANSFER_BT2020_12). + GST_VIDEO_TRANSFER_BT709 and GST_VIDEO_TRANSFER_BT601). Since: 1.18</doc> </member> <member name="smpte2084" @@ -20576,7 +20623,7 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="smpte2084"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="97">SMPTE ST 2084 for 10, 12, 14, and 16-bit systems. + line="100">SMPTE ST 2084 for 10, 12, 14, and 16-bit systems. Known as perceptual quantization (PQ) Since: 1.18</doc> </member> @@ -20586,10 +20633,123 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="arib-std-b67"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="100">Association of Radio Industries and Businesses (ARIB) + line="103">Association of Radio Industries and Businesses (ARIB) STD-B67 and Rec. ITU-R BT.2100-1 hybrid loggamma (HLG) system Since: 1.18</doc> </member> + <member name="bt601" + value="16" + c:identifier="GST_VIDEO_TRANSFER_BT601" + glib:nick="bt601"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.h" + line="106">also known as SMPTE170M / ITU-R BT1358 525 or 625 / ITU-R BT1700 NTSC + Functionally the same as the values + GST_VIDEO_TRANSFER_BT709, and GST_VIDEO_TRANSFER_BT2020_10. + Since: 1.18</doc> + </member> + <function name="from_iso" + c:identifier="gst_video_transfer_function_from_iso" + version="1.18"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="806">Converts the @value to the #GstVideoTransferFunction +The transfer characteristics (TransferCharacteristics) value is +defined by "ISO/IEC 23001-8 Section 7.2 Table 3" +and "ITU-T H.273 Table 3". +"H.264 Table E-4" and "H.265 Table E.4" share the identical values.</doc> + <source-position filename="gst-libs/gst/video/video-color.h" + line="287"/> + <return-value transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="816">the matched #GstVideoTransferFunction</doc> + <type name="VideoTransferFunction" + c:type="GstVideoTransferFunction"/> + </return-value> + <parameters> + <parameter name="value" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="808">a ITU-T H.273 transfer characteristics value</doc> + <type name="guint" c:type="guint"/> + </parameter> + </parameters> + </function> + <function name="is_equivalent" + c:identifier="gst_video_transfer_function_is_equivalent" + version="1.18"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="920">Returns whether @from_func and @to_func are equivalent. There are cases +(e.g. BT601, BT709, and BT2020_10) where several functions are functionally +identical. In these cases, when doing conversion, we should consider them +as equivalent. Also, BT2020_12 is the same as the aforementioned three for +less than 12 bits per pixel.</doc> + <source-position filename="gst-libs/gst/video/video-color.h" + line="293"/> + <return-value transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="933">TRUE if @from_func and @to_func can be considered equivalent.</doc> + <type name="gboolean" c:type="gboolean"/> + </return-value> + <parameters> + <parameter name="from_func" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="922">#GstVideoTransferFunction to convert from</doc> + <type name="VideoTransferFunction" + c:type="GstVideoTransferFunction"/> + </parameter> + <parameter name="from_bpp" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="923">bits per pixel to convert from</doc> + <type name="guint" c:type="guint"/> + </parameter> + <parameter name="to_func" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="924">#GstVideoTransferFunction to convert into</doc> + <type name="VideoTransferFunction" + c:type="GstVideoTransferFunction"/> + </parameter> + <parameter name="to_bpp" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="925">bits per pixel to convert into</doc> + <type name="guint" c:type="guint"/> + </parameter> + </parameters> + </function> + <function name="to_iso" + c:identifier="gst_video_transfer_function_to_iso" + version="1.18"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="671">Converts #GstVideoTransferFunction to the "transfer characteristics" +(TransferCharacteristics) value defined by "ISO/IEC 23001-8 Section 7.2 Table 3" +and "ITU-T H.273 Table 3". +"H.264 Table E-4" and "H.265 Table E.4" share the identical values.</doc> + <source-position filename="gst-libs/gst/video/video-color.h" + line="278"/> + <return-value transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="680">The value of ISO/IEC 23001-8 transfer characteristics.</doc> + <type name="guint" c:type="guint"/> + </return-value> + <parameters> + <parameter name="func" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="673">a #GstVideoTransferFunction</doc> + <type name="VideoTransferFunction" + c:type="GstVideoTransferFunction"/> + </parameter> + </parameters> + </function> </enumeration> <record name="VideoVBIEncoder" c:type="GstVideoVBIEncoder" @@ -20599,16 +20759,16 @@ non-linear RGB (R'G'B') and linear RGB</doc> c:symbol-prefix="video_vbi_encoder"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="480">An encoder for writing ancillary data to the + line="468">An encoder for writing ancillary data to the Vertical Blanking Interval lines of component signals.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="489"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="477"/> <constructor name="new" c:identifier="gst_video_vbi_encoder_new" version="1.16"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" line="612">Create a new #GstVideoVBIEncoder for the specified @format and @pixel_width.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="495"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="483"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" @@ -20640,7 +20800,7 @@ is not supported.</doc> Note that the contents of the data are always read as 8bit data (i.e. do not contain the parity check bits).</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="504"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="492"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" @@ -20692,7 +20852,7 @@ the parity check bits).</doc> </parameters> </method> <method name="copy" c:identifier="gst_video_vbi_encoder_copy"> - <source-position filename="gst-libs/gst/video/video-anc.h" line="498"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="486"/> <return-value transfer-ownership="full"> <type name="VideoVBIEncoder" c:type="GstVideoVBIEncoder*"/> </return-value> @@ -20708,7 +20868,7 @@ the parity check bits).</doc> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" line="595">Frees the @encoder.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="501"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="489"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -20723,7 +20883,7 @@ the parity check bits).</doc> </method> <method name="write_line" c:identifier="gst_video_vbi_encoder_write_line"> - <source-position filename="gst-libs/gst/video/video-anc.h" line="512"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="500"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -20745,16 +20905,16 @@ the parity check bits).</doc> c:symbol-prefix="video_vbi_parser"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="434">A parser for detecting and extracting @GstVideoAncillary data from + line="422">A parser for detecting and extracting @GstVideoAncillary data from Vertical Blanking Interval lines of component signals.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="443"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="431"/> <constructor name="new" c:identifier="gst_video_vbi_parser_new" version="1.16"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" line="331">Create a new #GstVideoVBIParser for the specified @format and @pixel_width.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="469"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="457"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" @@ -20784,7 +20944,7 @@ is not supported.</doc> filename="gst-libs/gst/video/video-anc.c" line="534">Provide a new line of data to the @parser. Call gst_video_vbi_parser_get_ancillary() to get the Ancillary data that might be present on that line.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="478"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="466"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -20806,7 +20966,7 @@ to get the Ancillary data that might be present on that line.</doc> </parameters> </method> <method name="copy" c:identifier="gst_video_vbi_parser_copy"> - <source-position filename="gst-libs/gst/video/video-anc.h" line="472"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="460"/> <return-value transfer-ownership="full"> <type name="VideoVBIParser" c:type="GstVideoVBIParser*"/> </return-value> @@ -20822,7 +20982,7 @@ to get the Ancillary data that might be present on that line.</doc> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" line="385">Frees the @parser.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="475"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="463"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -20841,7 +21001,7 @@ to get the Ancillary data that might be present on that line.</doc> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" line="305">Parse the line provided previously by gst_video_vbi_parser_add_line().</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="465"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="453"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" @@ -20876,14 +21036,14 @@ data.</doc> c:type="GstVideoVBIParserResult"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="448">Return values for #GstVideoVBIParser</doc> + line="436">Return values for #GstVideoVBIParser</doc> <member name="done" value="0" c:identifier="GST_VIDEO_VBI_PARSER_RESULT_DONE" glib:nick="done"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="450">No line were provided, or no more Ancillary data was found.</doc> + line="438">No line were provided, or no more Ancillary data was found.</doc> </member> <member name="ok" value="1" @@ -20891,7 +21051,7 @@ data.</doc> glib:nick="ok"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="451">A #GstVideoAncillary was found.</doc> + line="439">A #GstVideoAncillary was found.</doc> </member> <member name="error" value="2" @@ -20899,7 +21059,7 @@ data.</doc> glib:nick="error"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="452">An error occurred</doc> + line="440">An error occurred</doc> </member> </enumeration> <function name="buffer_add_video_afd_meta" @@ -20907,38 +21067,38 @@ data.</doc> version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" - line="1182">Attaches #GstVideoAFDMeta metadata to @buffer with the given + line="1229">Attaches #GstVideoAFDMeta metadata to @buffer with the given parameters.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="267"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="265"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" - line="1192">the #GstVideoAFDMeta on @buffer.</doc> + line="1239">the #GstVideoAFDMeta on @buffer.</doc> <type name="VideoAFDMeta" c:type="GstVideoAFDMeta*"/> </return-value> <parameters> <parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" - line="1184">a #GstBuffer</doc> + line="1231">a #GstBuffer</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </parameter> <parameter name="field" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" - line="1185">0 for progressive or field 1 and 1 for field 2</doc> + line="1232">0 for progressive or field 1 and 1 for field 2</doc> <type name="guint8" c:type="guint8"/> </parameter> <parameter name="spec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" - line="1186">#GstVideoAFDSpec that applies to AFD value</doc> + line="1233">#GstVideoAFDSpec that applies to AFD value</doc> <type name="VideoAFDSpec" c:type="GstVideoAFDSpec"/> </parameter> <parameter name="afd" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" - line="1187">#GstVideoAFDValue AFD enumeration</doc> + line="1234">#GstVideoAFDValue AFD enumeration</doc> <type name="VideoAFDValue" c:type="GstVideoAFDValue"/> </parameter> </parameters> @@ -20973,13 +21133,13 @@ the given parameters.</doc> version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" - line="1276">Attaches #GstVideoBarMeta metadata to @buffer with the given + line="1339">Attaches #GstVideoBarMeta metadata to @buffer with the given parameters.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="338"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="326"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" - line="1293">the #GstVideoBarMeta on @buffer. + line="1356">the #GstVideoBarMeta on @buffer. See Table 6.11 Bar Data Syntax @@ -20990,25 +21150,25 @@ https://www.atsc.org/wp-content/uploads/2015/03/a_53-Part-4-2009.pdf</doc> <parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" - line="1278">a #GstBuffer</doc> + line="1341">a #GstBuffer</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </parameter> <parameter name="field" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" - line="1279">0 for progressive or field 1 and 1 for field 2</doc> + line="1342">0 for progressive or field 1 and 1 for field 2</doc> <type name="guint8" c:type="guint8"/> </parameter> <parameter name="is_letterbox" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" - line="1280">if true then bar data specifies letterbox, otherwise pillarbox</doc> + line="1343">if true then bar data specifies letterbox, otherwise pillarbox</doc> <type name="gboolean" c:type="gboolean"/> </parameter> <parameter name="bar_data1" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" - line="1281">If @is_letterbox is true, then the value specifies the + line="1344">If @is_letterbox is true, then the value specifies the last line of a horizontal letterbox bar area at top of reconstructed frame. Otherwise, it specifies the last horizontal luminance sample of a vertical pillarbox bar area at the left side of the reconstructed frame</doc> @@ -21017,7 +21177,7 @@ https://www.atsc.org/wp-content/uploads/2015/03/a_53-Part-4-2009.pdf</doc> <parameter name="bar_data2" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" - line="1285">If @is_letterbox is true, then the value specifies the + line="1348">If @is_letterbox is true, then the value specifies the first line of a horizontal letterbox bar area at bottom of reconstructed frame. Otherwise, it specifies the first horizontal luminance sample of a vertical pillarbox bar area at the right side of the reconstructed frame.</doc> @@ -21032,7 +21192,7 @@ https://www.atsc.org/wp-content/uploads/2015/03/a_53-Part-4-2009.pdf</doc> filename="gst-libs/gst/video/video-anc.c" line="1004">Attaches #GstVideoCaptionMeta metadata to @buffer with the given parameters.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="429"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="417"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" @@ -21315,7 +21475,7 @@ of @comp.</doc> line="948">Attaches #GstVideoRegionOfInterestMeta metadata to @buffer with the given parameters.</doc> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="347"/> + line="348"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideometa.c" @@ -21369,7 +21529,7 @@ parameters.</doc> line="970">Attaches #GstVideoRegionOfInterestMeta metadata to @buffer with the given parameters.</doc> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="355"/> + line="356"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideometa.c" @@ -21424,7 +21584,7 @@ parameters.</doc> line="1140">Attaches #GstVideoTimeCodeMeta metadata to @buffer with the given parameters.</doc> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="399"/> + line="400"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideometa.c" @@ -21455,7 +21615,7 @@ parameters.</doc> line="1165">Attaches #GstVideoTimeCodeMeta metadata to @buffer with the given parameters.</doc> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="404"/> + line="405"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideometa.c" @@ -21533,8 +21693,9 @@ parameters.</doc> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" line="248">Gets the #GstVideoAFDMeta that might be present on @b. + Note: there may be two #GstVideoAFDMeta structs for interlaced video.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="263"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="261"/> <parameters> <parameter name="b"> <doc xml:space="preserve" @@ -21557,12 +21718,15 @@ Note: there may be two #GstVideoAFDMeta structs for interlaced video.</doc> c:identifier="gst_buffer_get_video_bar_meta" version="1.18" introspectable="0"> - <source-position filename="gst-libs/gst/video/video-anc.h" line="314"/> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-anc.h" + line="311">Gets the #GstVideoBarMeta that might be present on @b.</doc> + <source-position filename="gst-libs/gst/video/video-anc.h" line="322"/> <parameters> <parameter name="b"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="319">A #GstBuffer</doc> + line="313">A #GstBuffer</doc> </parameter> </parameters> </function-macro> @@ -21572,13 +21736,13 @@ Note: there may be two #GstVideoAFDMeta structs for interlaced video.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="414">Gets the #GstVideoCaptionMeta that might be present on @b.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="425"/> + line="402">Gets the #GstVideoCaptionMeta that might be present on @b.</doc> + <source-position filename="gst-libs/gst/video/video-anc.h" line="413"/> <parameters> <parameter name="b"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="416">A #GstBuffer</doc> + line="404">A #GstBuffer</doc> </parameter> </parameters> </function-macro> @@ -21684,7 +21848,7 @@ on @buffer.</doc> c:identifier="gst_buffer_get_video_region_of_interest_meta" introspectable="0"> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="340"/> + line="341"/> <parameters> <parameter name="b"> </parameter> @@ -21699,7 +21863,7 @@ on @buffer.</doc> Buffers can contain multiple #GstVideoRegionOfInterestMeta metadata items if multiple regions of interests are marked on a frame.</doc> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="343"/> + line="344"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideometa.c" @@ -21727,7 +21891,7 @@ no such metadata on @buffer.</doc> c:identifier="gst_buffer_get_video_time_code_meta" introspectable="0"> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="395"/> + line="396"/> <parameters> <parameter name="b"> </parameter> @@ -22627,7 +22791,7 @@ of commands passed must be equal to @n_commands.</doc> </function> <function name="video_bar_meta_api_get_type" c:identifier="gst_video_bar_meta_api_get_type"> - <source-position filename="gst-libs/gst/video/video-anc.h" line="308"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="306"/> <return-value transfer-ownership="none"> <type name="GType" c:type="GType"/> </return-value> @@ -22635,7 +22799,7 @@ of commands passed must be equal to @n_commands.</doc> <function name="video_bar_meta_get_info" c:identifier="gst_video_bar_meta_get_info" moved-to="VideoBarMeta.get_info"> - <source-position filename="gst-libs/gst/video/video-anc.h" line="311"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="309"/> <return-value transfer-ownership="none"> <type name="Gst.MetaInfo" c:type="const GstMetaInfo*"/> </return-value> @@ -22816,7 +22980,7 @@ The return value is FALSE in the case of integer overflow or other error.</doc> </function> <function name="video_caption_meta_api_get_type" c:identifier="gst_video_caption_meta_api_get_type"> - <source-position filename="gst-libs/gst/video/video-anc.h" line="407"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="395"/> <return-value transfer-ownership="none"> <type name="GType" c:type="GType"/> </return-value> @@ -22824,7 +22988,7 @@ The return value is FALSE in the case of integer overflow or other error.</doc> <function name="video_caption_meta_get_info" c:identifier="gst_video_caption_meta_get_info" moved-to="VideoCaptionMeta.get_info"> - <source-position filename="gst-libs/gst/video/video-anc.h" line="411"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="399"/> <return-value transfer-ownership="none"> <type name="Gst.MetaInfo" c:type="const GstMetaInfo*"/> </return-value> @@ -22837,7 +23001,7 @@ The return value is FALSE in the case of integer overflow or other error.</doc> filename="gst-libs/gst/video/video-anc.c" line="1051">Parses fixed Closed Caption #GstCaps and returns the corresponding caption type, or %GST_VIDEO_CAPTION_TYPE_UNKNOWN.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="381"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="369"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" @@ -22860,7 +23024,7 @@ type, or %GST_VIDEO_CAPTION_TYPE_UNKNOWN.</doc> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" line="1091">Creates new caps corresponding to @type.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="385"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="373"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" @@ -23015,23 +23179,23 @@ performed.</doc> version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="765">Converts the @value to the #GstVideoColorMatrix + line="769">Converts the @value to the #GstVideoColorMatrix The matrix coefficients (MatrixCoefficients) value is defined by "ISO/IEC 23001-8 Section 7.3 Table 4" and "ITU-T H.273 Table 4". "H.264 Table E-5" and "H.265 Table E.5" share the identical values.</doc> - <source-position filename="gst-libs/gst/video/video-color.h" line="260"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="284"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="775">the matched #GstVideoColorMatrix</doc> + line="779">the matched #GstVideoColorMatrix</doc> <type name="VideoColorMatrix" c:type="GstVideoColorMatrix"/> </return-value> <parameters> <parameter name="value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="767">a ITU-T H.273 matrix coefficients value</doc> + line="771">a ITU-T H.273 matrix coefficients value</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -23066,7 +23230,7 @@ and the other way around: G' = Y' - Cb*2*(1-Kb)*Kb/(1-Kr-Kb) - Cr*2*(1-Kr)*Kr/(1-Kr-Kb) B' = Y' + Cb*2*(1-Kb) ]|</doc> - <source-position filename="gst-libs/gst/video/video-color.h" line="69"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="71"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" @@ -23107,22 +23271,22 @@ and the other way around: version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="634">Converts #GstVideoColorMatrix to the "matrix coefficients" + line="636">Converts #GstVideoColorMatrix to the "matrix coefficients" (MatrixCoefficients) value defined by "ISO/IEC 23001-8 Section 7.3 Table 4" and "ITU-T H.273 Table 4". "H.264 Table E-5" and "H.265 Table E.5" share the identical values.</doc> - <source-position filename="gst-libs/gst/video/video-color.h" line="251"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="275"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="643">The value of ISO/IEC 23001-8 matrix coefficients.</doc> + line="645">The value of ISO/IEC 23001-8 matrix coefficients.</doc> <type name="guint" c:type="guint"/> </return-value> <parameters> <parameter name="matrix" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="636">a #GstVideoColorMatrix</doc> + line="638">a #GstVideoColorMatrix</doc> <type name="VideoColorMatrix" c:type="GstVideoColorMatrix"/> </parameter> </parameters> @@ -23133,22 +23297,22 @@ and "ITU-T H.273 Table 4". version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="851">Converts the @value to the #GstVideoColorPrimaries + line="856">Converts the @value to the #GstVideoColorPrimaries The colour primaries (ColourPrimaries) value is defined by "ISO/IEC 23001-8 Section 7.1 Table 2" and "ITU-T H.273 Table 2". "H.264 Table E-3" and "H.265 Table E.3" share the identical values.</doc> - <source-position filename="gst-libs/gst/video/video-color.h" line="266"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="290"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="860">the matched #GstVideoColorPrimaries</doc> + line="865">the matched #GstVideoColorPrimaries</doc> <type name="VideoColorPrimaries" c:type="GstVideoColorPrimaries"/> </return-value> <parameters> <parameter name="value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="853">a ITU-T H.273 colour primaries value</doc> + line="858">a ITU-T H.273 colour primaries value</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -23160,7 +23324,7 @@ defined by "ISO/IEC 23001-8 Section 7.1 Table 2" and "ITU-T H.273 Table 2". <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" line="303">Get information about the chromaticity coordinates of @primaries.</doc> - <source-position filename="gst-libs/gst/video/video-color.h" line="195"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="219"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" @@ -23183,22 +23347,22 @@ defined by "ISO/IEC 23001-8 Section 7.1 Table 2" and "ITU-T H.273 Table 2". version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="719">Converts #GstVideoColorPrimaries to the "colour primaries" (ColourPrimaries) + line="723">Converts #GstVideoColorPrimaries to the "colour primaries" (ColourPrimaries) value defined by "ISO/IEC 23001-8 Section 7.1 Table 2" and "ITU-T H.273 Table 2". "H.264 Table E-3" and "H.265 Table E.3" share the identical values.</doc> - <source-position filename="gst-libs/gst/video/video-color.h" line="257"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="281"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="728">The value of ISO/IEC 23001-8 colour primaries.</doc> + line="732">The value of ISO/IEC 23001-8 colour primaries.</doc> <type name="guint" c:type="guint"/> </return-value> <parameters> <parameter name="primaries" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="721">a #GstVideoColorPrimaries</doc> + line="725">a #GstVideoColorPrimaries</doc> <type name="VideoColorPrimaries" c:type="GstVideoColorPrimaries"/> </parameter> </parameters> @@ -23215,7 +23379,7 @@ range [0.0 .. 1.0]. The reverse operation (c[i] * scale[i]) + offset[i] can be used to convert the component values in range [0.0 .. 1.0] back to their representation in @info and @range.</doc> - <source-position filename="gst-libs/gst/video/video-color.h" line="240"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="264"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -23261,7 +23425,7 @@ the component values in range [0.0 .. 1.0] back to their representation in version="1.6"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="513">Convert @val to its gamma decoded value. This is the inverse operation of + line="514">Convert @val to its gamma decoded value. This is the inverse operation of @gst_video_color_transfer_encode(). For a non-linear value L' in the range [0..1], conversion to the linear @@ -23273,25 +23437,25 @@ L is in general performed with a power function like: Depending on @func, different formulas might be applied. Some formulas encode a linear segment in the lower range.</doc> - <source-position filename="gst-libs/gst/video/video-color.h" line="130"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="145"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="531">the gamme decoded value of @val</doc> + line="532">the gamma decoded value of @val</doc> <type name="gdouble" c:type="gdouble"/> </return-value> <parameters> <parameter name="func" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="515">a #GstVideoTransferFunction</doc> + line="516">a #GstVideoTransferFunction</doc> <type name="VideoTransferFunction" c:type="GstVideoTransferFunction"/> </parameter> <parameter name="val" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="516">a value</doc> + line="517">a value</doc> <type name="gdouble" c:type="gdouble"/> </parameter> </parameters> @@ -23312,11 +23476,11 @@ For a linear value L in the range [0..1], conversion to the non-linear Depending on @func, different formulas might be applied. Some formulas encode a linear segment in the lower range.</doc> - <source-position filename="gst-libs/gst/video/video-color.h" line="127"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="142"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="414">the gamme encoded value of @val</doc> + line="414">the gamma encoded value of @val</doc> <type name="gdouble" c:type="gdouble"/> </return-value> <parameters> @@ -23335,58 +23499,6 @@ encode a linear segment in the lower range.</doc> </parameter> </parameters> </function> - <function name="video_color_transfer_from_iso" - c:identifier="gst_video_color_transfer_from_iso" - version="1.18"> - <doc xml:space="preserve" - filename="gst-libs/gst/video/video-color.c" - line="802">Converts the @value to the #GstVideoTransferFunction -The transfer characteristics (TransferCharacteristics) value is -defined by "ISO/IEC 23001-8 Section 7.2 Table 3" -and "ITU-T H.273 Table 3". -"H.264 Table E-4" and "H.265 Table E.4" share the identical values.</doc> - <source-position filename="gst-libs/gst/video/video-color.h" line="263"/> - <return-value transfer-ownership="none"> - <doc xml:space="preserve" - filename="gst-libs/gst/video/video-color.c" - line="812">the matched #GstVideoTransferFunction</doc> - <type name="VideoTransferFunction" c:type="GstVideoTransferFunction"/> - </return-value> - <parameters> - <parameter name="value" transfer-ownership="none"> - <doc xml:space="preserve" - filename="gst-libs/gst/video/video-color.c" - line="804">a ITU-T H.273 transfer characteristics value</doc> - <type name="guint" c:type="guint"/> - </parameter> - </parameters> - </function> - <function name="video_color_transfer_to_iso" - c:identifier="gst_video_color_transfer_to_iso" - version="1.18"> - <doc xml:space="preserve" - filename="gst-libs/gst/video/video-color.c" - line="669">Converts #GstVideoTransferFunction to the "transfer characteristics" -(TransferCharacteristics) value defined by "ISO/IEC 23001-8 Section 7.2 Table 3" -and "ITU-T H.273 Table 3". -"H.264 Table E-4" and "H.265 Table E.4" share the identical values.</doc> - <source-position filename="gst-libs/gst/video/video-color.h" line="254"/> - <return-value transfer-ownership="none"> - <doc xml:space="preserve" - filename="gst-libs/gst/video/video-color.c" - line="678">The value of ISO/IEC 23001-8 transfer characteristics.</doc> - <type name="guint" c:type="guint"/> - </return-value> - <parameters> - <parameter name="func" transfer-ownership="none"> - <doc xml:space="preserve" - filename="gst-libs/gst/video/video-color.c" - line="671">a #GstVideoTransferFunction</doc> - <type name="VideoTransferFunction" - c:type="GstVideoTransferFunction"/> - </parameter> - </parameters> - </function> <function name="video_convert_sample" c:identifier="gst_video_convert_sample" throws="1"> @@ -23960,22 +24072,22 @@ Create an upstream force key unit event using gst_video_event_new_upstream_forc moved-to="VideoFormat.from_fourcc"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6804">Converts a FOURCC value into the corresponding #GstVideoFormat. + line="6815">Converts a FOURCC value into the corresponding #GstVideoFormat. If the FOURCC cannot be represented by #GstVideoFormat, #GST_VIDEO_FORMAT_UNKNOWN is returned.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="552"/> + line="571"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6812">the #GstVideoFormat describing the FOURCC value</doc> + line="6823">the #GstVideoFormat describing the FOURCC value</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </return-value> <parameters> <parameter name="fourcc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6806">a FOURCC value representing raw YUV video</doc> + line="6817">a FOURCC value representing raw YUV video</doc> <type name="guint32" c:type="guint32"/> </parameter> </parameters> @@ -23985,13 +24097,13 @@ If the FOURCC cannot be represented by #GstVideoFormat, moved-to="VideoFormat.from_masks"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6730">Find the #GstVideoFormat for the given parameters.</doc> + line="6741">Find the #GstVideoFormat for the given parameters.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="547"/> + line="566"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6743">a #GstVideoFormat or GST_VIDEO_FORMAT_UNKNOWN when the parameters to + line="6754">a #GstVideoFormat or GST_VIDEO_FORMAT_UNKNOWN when the parameters to not specify a known format.</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </return-value> @@ -23999,44 +24111,44 @@ not specify a known format.</doc> <parameter name="depth" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6732">the amount of bits used for a pixel</doc> + line="6743">the amount of bits used for a pixel</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="bpp" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6733">the amount of bits used to store a pixel. This value is bigger than + line="6744">the amount of bits used to store a pixel. This value is bigger than @depth</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="endianness" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6735">the endianness of the masks, #G_LITTLE_ENDIAN or #G_BIG_ENDIAN</doc> + line="6746">the endianness of the masks, #G_LITTLE_ENDIAN or #G_BIG_ENDIAN</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="red_mask" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6736">the red mask</doc> + line="6747">the red mask</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="green_mask" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6737">the green mask</doc> + line="6748">the green mask</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="blue_mask" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6738">the blue mask</doc> + line="6749">the blue mask</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="alpha_mask" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6739">the alpha mask, or 0 if no alpha mask</doc> + line="6750">the alpha mask, or 0 if no alpha mask</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -24046,13 +24158,13 @@ not specify a known format.</doc> moved-to="VideoFormat.from_string"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6896">Convert the @format string to its #GstVideoFormat.</doc> + line="6907">Convert the @format string to its #GstVideoFormat.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="555"/> + line="574"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6902">the #GstVideoFormat for @format or GST_VIDEO_FORMAT_UNKNOWN when the + line="6913">the #GstVideoFormat for @format or GST_VIDEO_FORMAT_UNKNOWN when the string is not a known format.</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </return-value> @@ -24060,7 +24172,7 @@ string is not a known format.</doc> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6898">a format string</doc> + line="6909">a format string</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -24070,20 +24182,20 @@ string is not a known format.</doc> moved-to="VideoFormat.get_info"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6961">Get the #GstVideoFormatInfo for @format</doc> + line="6972">Get the #GstVideoFormatInfo for @format</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="565"/> + line="584"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6967">The #GstVideoFormatInfo for @format.</doc> + line="6978">The #GstVideoFormatInfo for @format.</doc> <type name="VideoFormatInfo" c:type="const GstVideoFormatInfo*"/> </return-value> <parameters> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6963">a #GstVideoFormat</doc> + line="6974">a #GstVideoFormat</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </parameter> </parameters> @@ -24094,14 +24206,14 @@ string is not a known format.</doc> version="1.2"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6977">Get the default palette of @format. This the palette used in the pack + line="6988">Get the default palette of @format. This the palette used in the pack function for paletted formats.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="568"/> + line="587"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6985">the default palette of @format or %NULL when + line="6996">the default palette of @format or %NULL when @format does not have a palette.</doc> <type name="gpointer" c:type="gconstpointer"/> </return-value> @@ -24109,7 +24221,7 @@ function for paletted formats.</doc> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6979">a #GstVideoFormat</doc> + line="6990">a #GstVideoFormat</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </parameter> <parameter name="size" @@ -24118,7 +24230,7 @@ function for paletted formats.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6980">size of the palette in bytes</doc> + line="6991">size of the palette in bytes</doc> <type name="gsize" c:type="gsize*"/> </parameter> </parameters> @@ -24128,22 +24240,22 @@ function for paletted formats.</doc> moved-to="VideoFormat.to_fourcc"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6920">Converts a #GstVideoFormat value into the corresponding FOURCC. Only + line="6931">Converts a #GstVideoFormat value into the corresponding FOURCC. Only a few YUV formats have corresponding FOURCC values. If @format has no corresponding FOURCC value, 0 is returned.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="558"/> + line="577"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6928">the FOURCC corresponding to @format</doc> + line="6939">the FOURCC corresponding to @format</doc> <type name="guint32" c:type="guint32"/> </return-value> <parameters> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6922">a #GstVideoFormat video format</doc> + line="6933">a #GstVideoFormat video format</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </parameter> </parameters> @@ -24153,21 +24265,21 @@ no corresponding FOURCC value, 0 is returned.</doc> moved-to="VideoFormat.to_string"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6941">Returns a string containing a descriptive name for + line="6952">Returns a string containing a descriptive name for the #GstVideoFormat if there is one, or NULL otherwise.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="561"/> + line="580"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6948">the name corresponding to @format</doc> + line="6959">the name corresponding to @format</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6943">a #GstVideoFormat video format</doc> + line="6954">a #GstVideoFormat video format</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </parameter> </parameters> @@ -24177,13 +24289,13 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7073">Return all the raw video formats supported by GStreamer.</doc> + line="7084">Return all the raw video formats supported by GStreamer.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="627"/> + line="646"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7079">an array of #GstVideoFormat</doc> + line="7090">an array of #GstVideoFormat</doc> <array length="0" zero-terminated="0" c:type="const GstVideoFormat*"> <type name="VideoFormat" c:type="GstVideoFormat"/> </array> @@ -24195,7 +24307,7 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7075">the number of elements in the returned array</doc> + line="7086">the number of elements in the returned array</doc> <type name="guint" c:type="guint*"/> </parameter> </parameters> @@ -24322,15 +24434,15 @@ recognised, and %FALSE otherwise.</doc> version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7097">Return a generic raw video caps for formats defined in @formats. + line="7108">Return a generic raw video caps for formats defined in @formats. If @formats is %NULL returns a caps for all the supported raw video formats, see gst_video_formats_raw().</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="662"/> + line="681"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7106">a video @GstCaps</doc> + line="7117">a video @GstCaps</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </return-value> <parameters> @@ -24340,7 +24452,7 @@ see gst_video_formats_raw().</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7099">an array of raw #GstVideoFormat, or %NULL</doc> + line="7110">an array of raw #GstVideoFormat, or %NULL</doc> <array length="1" zero-terminated="0" c:type="const GstVideoFormat*"> <type name="VideoFormat" c:type="GstVideoFormat"/> </array> @@ -24348,7 +24460,7 @@ see gst_video_formats_raw().</doc> <parameter name="len" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7100">the size of @formats</doc> + line="7111">the size of @formats</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -24358,16 +24470,16 @@ see gst_video_formats_raw().</doc> version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7115">Return a generic raw video caps for formats defined in @formats with features + line="7126">Return a generic raw video caps for formats defined in @formats with features @features. If @formats is %NULL returns a caps for all the supported video formats, see gst_video_formats_raw().</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="665"/> + line="684"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7126">a video @GstCaps</doc> + line="7137">a video @GstCaps</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </return-value> <parameters> @@ -24377,7 +24489,7 @@ see gst_video_formats_raw().</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7117">an array of raw #GstVideoFormat, or %NULL</doc> + line="7128">an array of raw #GstVideoFormat, or %NULL</doc> <array length="1" zero-terminated="0" c:type="const GstVideoFormat*"> <type name="VideoFormat" c:type="GstVideoFormat"/> </array> @@ -24385,7 +24497,7 @@ see gst_video_formats_raw().</doc> <parameter name="len" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7118">the size of @formats</doc> + line="7129">the size of @formats</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="features" @@ -24394,7 +24506,7 @@ see gst_video_formats_raw().</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7119">the #GstCapsFeatures to set on the caps</doc> + line="7130">the #GstCapsFeatures to set on the caps</doc> <type name="Gst.CapsFeatures" c:type="GstCapsFeatures*"/> </parameter> </parameters> @@ -24773,7 +24885,7 @@ gst_video_overlay_set_render_rectangle().</doc> <function name="video_region_of_interest_meta_api_get_type" c:identifier="gst_video_region_of_interest_meta_api_get_type"> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="334"/> + line="335"/> <return-value transfer-ownership="none"> <type name="GType" c:type="GType"/> </return-value> @@ -24782,7 +24894,7 @@ gst_video_overlay_set_render_rectangle().</doc> c:identifier="gst_video_region_of_interest_meta_get_info" moved-to="VideoRegionOfInterestMeta.get_info"> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="337"/> + line="338"/> <return-value transfer-ownership="none"> <type name="Gst.MetaInfo" c:type="const GstMetaInfo*"/> </return-value> @@ -24857,7 +24969,7 @@ on the @method and @in_size/@out_size.</doc> image of @x_tiles by @y_tiles. Use this method when @mode is of type %GST_VIDEO_TILE_TYPE_INDEXED.</doc> - <source-position filename="gst-libs/gst/video/video-tile.h" line="125"/> + <source-position filename="gst-libs/gst/video/video-tile.h" line="134"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-tile.c" @@ -24901,7 +25013,7 @@ Use this method when @mode is of type %GST_VIDEO_TILE_TYPE_INDEXED.</doc> <function name="video_time_code_meta_api_get_type" c:identifier="gst_video_time_code_meta_api_get_type"> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="388"/> + line="389"/> <return-value transfer-ownership="none"> <type name="GType" c:type="GType"/> </return-value> @@ -24910,10 +25022,111 @@ Use this method when @mode is of type %GST_VIDEO_TILE_TYPE_INDEXED.</doc> c:identifier="gst_video_time_code_meta_get_info" moved-to="VideoTimeCodeMeta.get_info"> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="392"/> + line="393"/> <return-value transfer-ownership="none"> <type name="Gst.MetaInfo" c:type="const GstMetaInfo*"/> </return-value> </function> + <function name="video_transfer_function_from_iso" + c:identifier="gst_video_transfer_function_from_iso" + moved-to="VideoTransferFunction.from_iso" + version="1.18"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="806">Converts the @value to the #GstVideoTransferFunction +The transfer characteristics (TransferCharacteristics) value is +defined by "ISO/IEC 23001-8 Section 7.2 Table 3" +and "ITU-T H.273 Table 3". +"H.264 Table E-4" and "H.265 Table E.4" share the identical values.</doc> + <source-position filename="gst-libs/gst/video/video-color.h" line="287"/> + <return-value transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="816">the matched #GstVideoTransferFunction</doc> + <type name="VideoTransferFunction" c:type="GstVideoTransferFunction"/> + </return-value> + <parameters> + <parameter name="value" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="808">a ITU-T H.273 transfer characteristics value</doc> + <type name="guint" c:type="guint"/> + </parameter> + </parameters> + </function> + <function name="video_transfer_function_is_equivalent" + c:identifier="gst_video_transfer_function_is_equivalent" + moved-to="VideoTransferFunction.is_equivalent" + version="1.18"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="920">Returns whether @from_func and @to_func are equivalent. There are cases +(e.g. BT601, BT709, and BT2020_10) where several functions are functionally +identical. In these cases, when doing conversion, we should consider them +as equivalent. Also, BT2020_12 is the same as the aforementioned three for +less than 12 bits per pixel.</doc> + <source-position filename="gst-libs/gst/video/video-color.h" line="293"/> + <return-value transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="933">TRUE if @from_func and @to_func can be considered equivalent.</doc> + <type name="gboolean" c:type="gboolean"/> + </return-value> + <parameters> + <parameter name="from_func" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="922">#GstVideoTransferFunction to convert from</doc> + <type name="VideoTransferFunction" + c:type="GstVideoTransferFunction"/> + </parameter> + <parameter name="from_bpp" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="923">bits per pixel to convert from</doc> + <type name="guint" c:type="guint"/> + </parameter> + <parameter name="to_func" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="924">#GstVideoTransferFunction to convert into</doc> + <type name="VideoTransferFunction" + c:type="GstVideoTransferFunction"/> + </parameter> + <parameter name="to_bpp" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="925">bits per pixel to convert into</doc> + <type name="guint" c:type="guint"/> + </parameter> + </parameters> + </function> + <function name="video_transfer_function_to_iso" + c:identifier="gst_video_transfer_function_to_iso" + moved-to="VideoTransferFunction.to_iso" + version="1.18"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="671">Converts #GstVideoTransferFunction to the "transfer characteristics" +(TransferCharacteristics) value defined by "ISO/IEC 23001-8 Section 7.2 Table 3" +and "ITU-T H.273 Table 3". +"H.264 Table E-4" and "H.265 Table E.4" share the identical values.</doc> + <source-position filename="gst-libs/gst/video/video-color.h" line="278"/> + <return-value transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="680">The value of ISO/IEC 23001-8 transfer characteristics.</doc> + <type name="guint" c:type="guint"/> + </return-value> + <parameters> + <parameter name="func" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="673">a #GstVideoTransferFunction</doc> + <type name="VideoTransferFunction" + c:type="GstVideoTransferFunction"/> + </parameter> + </parameters> + </function> </namespace> </repository> diff --git a/girs/GstWebRTC-1.0.gir b/girs/GstWebRTC-1.0.gir index 08d03f6f60..e75778b623 100644 --- a/girs/GstWebRTC-1.0.gir +++ b/girs/GstWebRTC-1.0.gir @@ -559,7 +559,7 @@ for more information.</doc> <virtual-method name="close" invoker="close"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="542">Close the @channel.</doc> + line="544">Close the @channel.</doc> <source-position filename="gst-libs/gst/webrtc/datachannel.h" line="79"/> <return-value transfer-ownership="none"> @@ -569,7 +569,7 @@ for more information.</doc> <instance-parameter name="channel" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="544">a #GstWebRTCDataChannel</doc> + line="546">a #GstWebRTCDataChannel</doc> <type name="WebRTCDataChannel" c:type="GstWebRTCDataChannel*"/> </instance-parameter> </parameters> @@ -577,7 +577,7 @@ for more information.</doc> <virtual-method name="send_data" invoker="send_data"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="504">Send @data as a data message over @channel.</doc> + line="506">Send @data as a data message over @channel.</doc> <source-position filename="gst-libs/gst/webrtc/datachannel.h" line="77"/> <return-value transfer-ownership="none"> @@ -587,7 +587,7 @@ for more information.</doc> <instance-parameter name="channel" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="506">a #GstWebRTCDataChannel</doc> + line="508">a #GstWebRTCDataChannel</doc> <type name="WebRTCDataChannel" c:type="GstWebRTCDataChannel*"/> </instance-parameter> <parameter name="data" @@ -596,7 +596,7 @@ for more information.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="507">a #GBytes or %NULL</doc> + line="509">a #GBytes or %NULL</doc> <type name="GLib.Bytes" c:type="GBytes*"/> </parameter> </parameters> @@ -604,7 +604,7 @@ for more information.</doc> <virtual-method name="send_string" invoker="send_string"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="523">Send @str as a string message over @channel.</doc> + line="525">Send @str as a string message over @channel.</doc> <source-position filename="gst-libs/gst/webrtc/datachannel.h" line="78"/> <return-value transfer-ownership="none"> @@ -614,7 +614,7 @@ for more information.</doc> <instance-parameter name="channel" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="525">a #GstWebRTCDataChannel</doc> + line="527">a #GstWebRTCDataChannel</doc> <type name="WebRTCDataChannel" c:type="GstWebRTCDataChannel*"/> </instance-parameter> <parameter name="str" @@ -623,7 +623,7 @@ for more information.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="526">a string or %NULL</doc> + line="528">a string or %NULL</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -631,7 +631,7 @@ for more information.</doc> <method name="close" c:identifier="gst_webrtc_data_channel_close"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="542">Close the @channel.</doc> + line="544">Close the @channel.</doc> <source-position filename="gst-libs/gst/webrtc/datachannel.h" line="109"/> <return-value transfer-ownership="none"> @@ -641,7 +641,7 @@ for more information.</doc> <instance-parameter name="channel" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="544">a #GstWebRTCDataChannel</doc> + line="546">a #GstWebRTCDataChannel</doc> <type name="WebRTCDataChannel" c:type="GstWebRTCDataChannel*"/> </instance-parameter> </parameters> @@ -650,7 +650,7 @@ for more information.</doc> c:identifier="gst_webrtc_data_channel_on_buffered_amount_low"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="488">Signal that the data channel reached a low buffered amount. Should only be used by subclasses.</doc> + line="490">Signal that the data channel reached a low buffered amount. Should only be used by subclasses.</doc> <source-position filename="gst-libs/gst/webrtc/datachannel.h" line="100"/> <return-value transfer-ownership="none"> @@ -660,7 +660,7 @@ for more information.</doc> <instance-parameter name="channel" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="490">a #GstWebRTCDataChannel</doc> + line="492">a #GstWebRTCDataChannel</doc> <type name="WebRTCDataChannel" c:type="GstWebRTCDataChannel*"/> </instance-parameter> </parameters> @@ -668,7 +668,7 @@ for more information.</doc> <method name="on_close" c:identifier="gst_webrtc_data_channel_on_close"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="403">Signal that the data channel was closed. Should only be used by subclasses.</doc> + line="405">Signal that the data channel was closed. Should only be used by subclasses.</doc> <source-position filename="gst-libs/gst/webrtc/datachannel.h" line="88"/> <return-value transfer-ownership="none"> @@ -678,7 +678,7 @@ for more information.</doc> <instance-parameter name="channel" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="405">a #GstWebRTCDataChannel</doc> + line="407">a #GstWebRTCDataChannel</doc> <type name="WebRTCDataChannel" c:type="GstWebRTCDataChannel*"/> </instance-parameter> </parameters> @@ -686,7 +686,7 @@ for more information.</doc> <method name="on_error" c:identifier="gst_webrtc_data_channel_on_error"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="432">Signal that the data channel had an error. Should only be used by subclasses.</doc> + line="434">Signal that the data channel had an error. Should only be used by subclasses.</doc> <source-position filename="gst-libs/gst/webrtc/datachannel.h" line="91"/> <return-value transfer-ownership="none"> @@ -696,13 +696,13 @@ for more information.</doc> <instance-parameter name="channel" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="434">a #GstWebRTCDataChannel</doc> + line="436">a #GstWebRTCDataChannel</doc> <type name="WebRTCDataChannel" c:type="GstWebRTCDataChannel*"/> </instance-parameter> <parameter name="error" transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="435">a #GError</doc> + line="437">a #GError</doc> <type name="GLib.Error" c:type="GError*"/> </parameter> </parameters> @@ -711,7 +711,7 @@ for more information.</doc> c:identifier="gst_webrtc_data_channel_on_message_data"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="452">Signal that the data channel received a data message. Should only be used by subclasses.</doc> + line="454">Signal that the data channel received a data message. Should only be used by subclasses.</doc> <source-position filename="gst-libs/gst/webrtc/datachannel.h" line="94"/> <return-value transfer-ownership="none"> @@ -721,7 +721,7 @@ for more information.</doc> <instance-parameter name="channel" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="454">a #GstWebRTCDataChannel</doc> + line="456">a #GstWebRTCDataChannel</doc> <type name="WebRTCDataChannel" c:type="GstWebRTCDataChannel*"/> </instance-parameter> <parameter name="data" @@ -730,7 +730,7 @@ for more information.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="455">a #GBytes or %NULL</doc> + line="457">a #GBytes or %NULL</doc> <type name="GLib.Bytes" c:type="GBytes*"/> </parameter> </parameters> @@ -739,7 +739,7 @@ for more information.</doc> c:identifier="gst_webrtc_data_channel_on_message_string"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="470">Signal that the data channel received a string message. Should only be used by subclasses.</doc> + line="472">Signal that the data channel received a string message. Should only be used by subclasses.</doc> <source-position filename="gst-libs/gst/webrtc/datachannel.h" line="97"/> <return-value transfer-ownership="none"> @@ -749,7 +749,7 @@ for more information.</doc> <instance-parameter name="channel" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="472">a #GstWebRTCDataChannel</doc> + line="474">a #GstWebRTCDataChannel</doc> <type name="WebRTCDataChannel" c:type="GstWebRTCDataChannel*"/> </instance-parameter> <parameter name="str" @@ -758,7 +758,7 @@ for more information.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="473">a string or %NULL</doc> + line="475">a string or %NULL</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -766,7 +766,7 @@ for more information.</doc> <method name="on_open" c:identifier="gst_webrtc_data_channel_on_open"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="369">Signal that the data channel was opened. Should only be used by subclasses.</doc> + line="371">Signal that the data channel was opened. Should only be used by subclasses.</doc> <source-position filename="gst-libs/gst/webrtc/datachannel.h" line="85"/> <return-value transfer-ownership="none"> @@ -776,7 +776,7 @@ for more information.</doc> <instance-parameter name="channel" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="371">a #GstWebRTCDataChannel</doc> + line="373">a #GstWebRTCDataChannel</doc> <type name="WebRTCDataChannel" c:type="GstWebRTCDataChannel*"/> </instance-parameter> </parameters> @@ -785,7 +785,7 @@ for more information.</doc> c:identifier="gst_webrtc_data_channel_send_data"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="504">Send @data as a data message over @channel.</doc> + line="506">Send @data as a data message over @channel.</doc> <source-position filename="gst-libs/gst/webrtc/datachannel.h" line="103"/> <return-value transfer-ownership="none"> @@ -795,7 +795,7 @@ for more information.</doc> <instance-parameter name="channel" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="506">a #GstWebRTCDataChannel</doc> + line="508">a #GstWebRTCDataChannel</doc> <type name="WebRTCDataChannel" c:type="GstWebRTCDataChannel*"/> </instance-parameter> <parameter name="data" @@ -804,7 +804,7 @@ for more information.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="507">a #GBytes or %NULL</doc> + line="509">a #GBytes or %NULL</doc> <type name="GLib.Bytes" c:type="GBytes*"/> </parameter> </parameters> @@ -813,7 +813,7 @@ for more information.</doc> c:identifier="gst_webrtc_data_channel_send_string"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="523">Send @str as a string message over @channel.</doc> + line="525">Send @str as a string message over @channel.</doc> <source-position filename="gst-libs/gst/webrtc/datachannel.h" line="106"/> <return-value transfer-ownership="none"> @@ -823,7 +823,7 @@ for more information.</doc> <instance-parameter name="channel" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="525">a #GstWebRTCDataChannel</doc> + line="527">a #GstWebRTCDataChannel</doc> <type name="WebRTCDataChannel" c:type="GstWebRTCDataChannel*"/> </instance-parameter> <parameter name="str" @@ -832,7 +832,7 @@ for more information.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="526">a string or %NULL</doc> + line="528">a string or %NULL</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -944,7 +944,7 @@ for more information.</doc> <glib:signal name="close" when="last" action="1"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="350">Close the data channel</doc> + line="352">Close the data channel</doc> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -967,7 +967,7 @@ for more information.</doc> <parameter name="error" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="296">the #GError thrown</doc> + line="298">the #GError thrown</doc> <type name="GLib.Error"/> </parameter> </parameters> @@ -983,7 +983,7 @@ for more information.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="305">a #GBytes of the data received</doc> + line="307">a #GBytes of the data received</doc> <type name="GLib.Bytes"/> </parameter> </parameters> @@ -999,7 +999,7 @@ for more information.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="314">the data received as a string</doc> + line="316">the data received as a string</doc> <type name="utf8" c:type="gchar*"/> </parameter> </parameters> @@ -1020,7 +1020,7 @@ for more information.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="331">a #GBytes with the data</doc> + line="333">a #GBytes with the data</doc> <type name="GLib.Bytes"/> </parameter> </parameters> @@ -1036,7 +1036,7 @@ for more information.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="342">the data to send as a string</doc> + line="344">the data to send as a string</doc> <type name="utf8" c:type="gchar*"/> </parameter> </parameters> @@ -1061,7 +1061,7 @@ for more information.</doc> <parameter name="channel" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="506">a #GstWebRTCDataChannel</doc> + line="508">a #GstWebRTCDataChannel</doc> <type name="WebRTCDataChannel" c:type="GstWebRTCDataChannel*"/> </parameter> <parameter name="data" @@ -1070,7 +1070,7 @@ for more information.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="507">a #GBytes or %NULL</doc> + line="509">a #GBytes or %NULL</doc> <type name="GLib.Bytes" c:type="GBytes*"/> </parameter> </parameters> @@ -1087,7 +1087,7 @@ for more information.</doc> <parameter name="channel" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="525">a #GstWebRTCDataChannel</doc> + line="527">a #GstWebRTCDataChannel</doc> <type name="WebRTCDataChannel" c:type="GstWebRTCDataChannel*"/> </parameter> <parameter name="str" @@ -1096,7 +1096,7 @@ for more information.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="526">a string or %NULL</doc> + line="528">a string or %NULL</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -1113,7 +1113,7 @@ for more information.</doc> <parameter name="channel" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/webrtc/datachannel.c" - line="544">a #GstWebRTCDataChannel</doc> + line="546">a #GstWebRTCDataChannel</doc> <type name="WebRTCDataChannel" c:type="GstWebRTCDataChannel*"/> </parameter> </parameters> |