girs: update

Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/5829>
This commit is contained in:
Xavier Claessens 2023-12-18 16:21:09 -05:00 committed by GStreamer Marge Bot
parent 561f8b71ee
commit d4de8f4b16

View file

@ -41180,7 +41180,7 @@ a-struct, nested=[nested-struct, nested=true]
``` ```
&gt; *note*: gst_structure_to_string() won't use that syntax for backward &gt; *note*: gst_structure_to_string() won't use that syntax for backward
&gt; compatibility reason, gst_structure_serialize() has been added for &gt; compatibility reason, gst_structure_serialize_full() has been added for
&gt; that purpose.</doc> &gt; that purpose.</doc>
<source-position filename="../subprojects/gstreamer/gst/gststructure.h"/> <source-position filename="../subprojects/gstreamer/gst/gststructure.h"/>
<field name="type" writable="1"> <field name="type" writable="1">
@ -42630,7 +42630,7 @@ argument is ignored.</doc>
</parameter> </parameter>
</parameters> </parameters>
</method> </method>
<method name="serialize" c:identifier="gst_structure_serialize" version="1.20"> <method name="serialize" c:identifier="gst_structure_serialize" version="1.20" deprecated="1">
<doc xml:space="preserve" filename="../subprojects/gstreamer/gst/gststructure.c">Converts @structure to a human-readable string representation. <doc xml:space="preserve" filename="../subprojects/gstreamer/gst/gststructure.c">Converts @structure to a human-readable string representation.
This version of the caps serialization function introduces support for nested This version of the caps serialization function introduces support for nested
@ -42638,10 +42638,35 @@ structures and caps but the resulting strings won't be parsable with
GStreamer prior to 1.20 unless #GST_SERIALIZE_FLAG_BACKWARD_COMPAT is passed GStreamer prior to 1.20 unless #GST_SERIALIZE_FLAG_BACKWARD_COMPAT is passed
as @flag. as @flag.
%GST_SERIALIZE_FLAG_STRICT flags is not allowed because it would make this
function nullable which is an API break for bindings.
Use gst_structure_serialize_full() instead.
Free-function: g_free</doc> Free-function: g_free</doc>
<doc-deprecated xml:space="preserve">Use gst_structure_serialize_full() instead.</doc-deprecated>
<source-position filename="../subprojects/gstreamer/gst/gststructure.h"/> <source-position filename="../subprojects/gstreamer/gst/gststructure.h"/>
<return-value transfer-ownership="full"> <return-value transfer-ownership="full">
<doc xml:space="preserve" filename="../subprojects/gstreamer/gst/gststructure.c">a pointer to string allocated by g_malloc(). <doc xml:space="preserve" filename="../subprojects/gstreamer/gst/gststructure.c">a pointer to string allocated by g_malloc().
g_free() after usage.</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
<instance-parameter name="structure" transfer-ownership="none">
<doc xml:space="preserve" filename="../subprojects/gstreamer/gst/gststructure.c">a #GstStructure</doc>
<type name="Structure" c:type="const GstStructure*"/>
</instance-parameter>
<parameter name="flags" transfer-ownership="none">
<doc xml:space="preserve" filename="../subprojects/gstreamer/gst/gststructure.c">The flags to use to serialize structure</doc>
<type name="SerializeFlags" c:type="GstSerializeFlags"/>
</parameter>
</parameters>
</method>
<method name="serialize_full" c:identifier="gst_structure_serialize_full" version="1.24">
<doc xml:space="preserve" filename="../subprojects/gstreamer/gst/gststructure.c">Alias for gst_structure_serialize() but with nullable annotation because it
can return %NULL when %GST_SERIALIZE_FLAG_STRICT flag is set.</doc>
<source-position filename="../subprojects/gstreamer/gst/gststructure.h"/>
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gstreamer/gst/gststructure.c">a pointer to string allocated by g_malloc().
g_free() after usage.</doc> g_free() after usage.</doc>
<type name="utf8" c:type="gchar*"/> <type name="utf8" c:type="gchar*"/>
</return-value> </return-value>
@ -42845,7 +42870,7 @@ This prints the structure in human readable form.
This function will lead to unexpected results when there are nested #GstCaps This function will lead to unexpected results when there are nested #GstCaps
/ #GstStructure deeper than one level, you should user / #GstStructure deeper than one level, you should user
gst_structure_serialize() instead for those cases. gst_structure_serialize_full() instead for those cases.
Free-function: g_free</doc> Free-function: g_free</doc>
<source-position filename="../subprojects/gstreamer/gst/gststructure.h"/> <source-position filename="../subprojects/gstreamer/gst/gststructure.h"/>