gir-files: Import from preliminary gstreamer-base 1.18.4 at 7b1fc3ea

gir-files/GstApp-1.0.gir

@@ -1583,61 +1583,106 @@ application should connect to the seek-data signal.</doc>
         </array>
       </field>
       <glib:signal name="end-of-stream" when="last" action="1">
+        <doc xml:space="preserve">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">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">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="object" transfer-ownership="none">
+          <parameter name="length" transfer-ownership="none">
+            <doc xml:space="preserve">the amount of bytes needed.</doc>
             <type name="guint" c:type="guint"/>
           </parameter>
         </parameters>
       </glib:signal>
       <glib:signal name="push-buffer" when="last" action="1">
+        <doc xml:space="preserve">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="object" transfer-ownership="none">
+          <parameter name="buffer" transfer-ownership="none">
+            <doc xml:space="preserve">a buffer to push</doc>
             <type name="Gst.Buffer"/>
           </parameter>
         </parameters>
       </glib:signal>
-      <glib:signal name="push-buffer-list" when="last" action="1">
+      <glib:signal name="push-buffer-list" when="last" action="1" version="1.14">
+        <doc xml:space="preserve">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>
         <return-value transfer-ownership="none">
           <type name="Gst.FlowReturn"/>
         </return-value>
         <parameters>
-          <parameter name="object" transfer-ownership="none">
+          <parameter name="buffer_list" transfer-ownership="none">
+            <doc xml:space="preserve">a buffer list to push</doc>
             <type name="Gst.BufferList"/>
           </parameter>
         </parameters>
       </glib:signal>
-      <glib:signal name="push-sample" when="last" action="1">
+      <glib:signal name="push-sample" when="last" action="1" version="1.6">
+        <doc xml:space="preserve">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>
         <return-value transfer-ownership="none">
           <type name="Gst.FlowReturn"/>
         </return-value>
         <parameters>
-          <parameter name="object" transfer-ownership="none">
+          <parameter name="sample" transfer-ownership="none">
+            <doc xml:space="preserve">a sample from which extract buffer to push</doc>
             <type name="Gst.Sample"/>
           </parameter>
         </parameters>
       </glib:signal>
       <glib:signal name="seek-data" when="last">
+        <doc xml:space="preserve">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">%TRUE if the seek succeeded.</doc>
           <type name="gboolean" c:type="gboolean"/>
         </return-value>
         <parameters>
-          <parameter name="object" transfer-ownership="none">
+          <parameter name="offset" transfer-ownership="none">
+            <doc xml:space="preserve">the offset to seek to</doc>
             <type name="guint64" c:type="guint64"/>
           </parameter>
         </parameters>

gir-files/GstGL-1.0.gir

@@ -3555,7 +3555,13 @@ OpenGL textures.
 #GstGLMemory is created or wrapped through gst_gl_base_memory_alloc()
 with #GstGLVideoAllocationParams.
 
-Data is uploaded or downloaded from the GPU as is necessary.</doc>
+Data is uploaded or downloaded from the GPU as is necessary.
+
+The #GstCaps that is used for #GstGLMemory based buffers should contain
+the %GST_CAPS_FEATURE_MEMORY_GL_MEMORY as a #GstCapsFeatures and should
+contain a 'texture-target' field with one of the #GstGLTextureTarget values
+as a string, i.e. some combination of 'texture-target=(string){2D,
+rectangle, external-oes}'.</doc>
       <field name="mem" writable="1">
         <doc xml:space="preserve">the parent #GstGLBaseMemory object</doc>
         <type name="GLBaseMemory" c:type="GstGLBaseMemory"/>
@@ -6275,17 +6281,24 @@ the sync point are now visible.</doc>
       </function>
     </record>
     <enumeration name="GLTextureTarget" version="1.8" glib:type-name="GstGLTextureTarget" glib:get-type="gst_gl_texture_target_get_type" c:type="GstGLTextureTarget">
+      <doc xml:space="preserve">The OpenGL texture target that an OpenGL texture can be bound to.  The
+gst_gl_value_set_texture_target_from_mask(),
+gst_gl_value_get_texture_target_mask(), and
+gst_gl_value_set_texture_target() functions can be used for handling texture
+targets with #GValue's when e.g. dealing with #GstCaps.</doc>
       <member name="none" value="0" c:identifier="GST_GL_TEXTURE_TARGET_NONE" glib:nick="none">
         <doc xml:space="preserve">no texture target</doc>
       </member>
       <member name="2d" value="1" c:identifier="GST_GL_TEXTURE_TARGET_2D" glib:nick="2d">
-        <doc xml:space="preserve">2D texture target</doc>
+        <doc xml:space="preserve">2D texture target (`GL_TEXTURE_2D`)</doc>
       </member>
       <member name="rectangle" value="2" c:identifier="GST_GL_TEXTURE_TARGET_RECTANGLE" glib:nick="rectangle">
-        <doc xml:space="preserve">rectangle texture target</doc>
+        <doc xml:space="preserve">rectangle texture target
+    (`GL_TEXTURE_RECTANGLE`)</doc>
       </member>
       <member name="external_oes" value="3" c:identifier="GST_GL_TEXTURE_TARGET_EXTERNAL_OES" glib:nick="external-oes">
-        <doc xml:space="preserve">external oes texture target</doc>
+        <doc xml:space="preserve">external oes texture target
+    (`GL_TEXTURE_EXTERNAL_OES`)</doc>
       </member>
       <function name="from_gl" c:identifier="gst_gl_texture_target_from_gl">
         <return-value transfer-ownership="none">
@@ -9735,7 +9748,8 @@ multiple times.  This must be called before any other GstGLRenderbuffer operatio
     <function name="gl_value_get_texture_target_mask" c:identifier="gst_gl_value_get_texture_target_mask">
       <doc xml:space="preserve">See gst_gl_value_set_texture_target_from_mask() for what entails a mask</doc>
       <return-value transfer-ownership="none">
-        <doc xml:space="preserve">the mask of #GstGLTextureTarget's in @value</doc>
+        <doc xml:space="preserve">the mask of #GstGLTextureTarget's in @value or
+    %GST_GL_TEXTURE_TARGET_NONE on failure</doc>
         <type name="GLTextureTarget" c:type="GstGLTextureTarget"/>
       </return-value>
       <parameters>

gir-files/GstPbutils-1.0.gir

@@ -2568,7 +2568,7 @@ in debugging.</doc>
       <doc xml:space="preserve">The major version of GStreamer's gst-plugins-base libraries at compile time.</doc>
       <type name="gint" c:type="gint"/>
     </constant>
-    <constant name="PLUGINS_BASE_VERSION_MICRO" value="2" c:type="GST_PLUGINS_BASE_VERSION_MICRO">
+    <constant name="PLUGINS_BASE_VERSION_MICRO" value="3" c:type="GST_PLUGINS_BASE_VERSION_MICRO">
       <doc xml:space="preserve">The micro version of GStreamer's gst-plugins-base libraries at compile time.</doc>
       <type name="gint" c:type="gint"/>
     </constant>
@@ -2576,7 +2576,7 @@ in debugging.</doc>
       <doc xml:space="preserve">The minor version of GStreamer's gst-plugins-base libraries at compile time.</doc>
       <type name="gint" c:type="gint"/>
     </constant>
-    <constant name="PLUGINS_BASE_VERSION_NANO" value="0" c:type="GST_PLUGINS_BASE_VERSION_NANO">
+    <constant name="PLUGINS_BASE_VERSION_NANO" value="1" c:type="GST_PLUGINS_BASE_VERSION_NANO">
       <doc xml:space="preserve">The nano version of GStreamer's gst-plugins-base libraries at compile time.
 Actual releases have 0, GIT versions have 1, prerelease versions have 2-...</doc>
       <type name="gint" c:type="gint"/>

gir-files/GstVideo-1.0.gir

@@ -9203,7 +9203,7 @@ mode.</doc>
         <parameters>
           <instance-parameter name="info" transfer-ownership="none">
             <doc xml:space="preserve">a #GstVideoInfo</doc>
-            <type name="VideoInfo" c:type="GstVideoInfo*"/>
+            <type name="VideoInfo" c:type="const GstVideoInfo*"/>
           </instance-parameter>
         </parameters>
       </method>