gstreamer 3.2.5-x64-mingw32 → 3.2.6-x64-mingw32

data/vendor/local/share/gir-1.0/GstGL-1.0.gir

@@ -44,11 +44,13 @@ synchronization metadata on buffers from the pool.</doc>
     <constant name="CAPS_FEATURE_MEMORY_GL_BUFFER"
               value="memory:GLBuffer"
               c:type="GST_CAPS_FEATURE_MEMORY_GL_BUFFER">
+      <doc xml:space="preserve">Name of the caps feature indicating the use of GL buffers</doc>
       <type name="utf8" c:type="gchar*"/>
     </constant>
     <constant name="CAPS_FEATURE_MEMORY_GL_MEMORY"
               value="memory:GLMemory"
               c:type="GST_CAPS_FEATURE_MEMORY_GL_MEMORY">
+      <doc xml:space="preserve">Name of the caps feature for indicating the use of #GstGLMemory</doc>
       <type name="utf8" c:type="gchar*"/>
     </constant>
     <bitfield name="GLAPI" c:type="GstGLAPI">
@@ -754,11 +756,16 @@ Data is uploaded or downloaded from the GPU as is necessary.</doc>
         </array>
       </field>
       <method name="alloc_data" c:identifier="gst_gl_base_memory_alloc_data">
+        <doc xml:space="preserve">Note: only intended for subclass usage to allocate the sytem memory buffer
+on demand.  If there is already a non-NULL data pointer in @gl_mem-&gt;data,
+then this function imply returns TRUE.</doc>
         <return-value transfer-ownership="none">
+          <doc xml:space="preserve">whether the system memory could be allocated</doc>
           <type name="gboolean" c:type="gboolean"/>
         </return-value>
         <parameters>
           <instance-parameter name="gl_mem" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLBaseMemory</doc>
             <type name="GLBaseMemory" c:type="GstGLBaseMemory*"/>
           </instance-parameter>
         </parameters>
@@ -1307,7 +1314,7 @@ The glcolorconvertelement provides a GStreamer element that uses
       <constructor name="new"
                    c:identifier="gst_gl_color_convert_new"
                    version="1.4">
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="full">
           <doc xml:space="preserve">a new #GstGLColorConvert object</doc>
           <type name="GLColorConvert" c:type="GstGLColorConvert*"/>
         </return-value>
@@ -1521,7 +1528,7 @@ specified and must only be activated in a single thread.</doc>
 Note: The caller is responsible for ensuring that the OpenGL context
 represented by @handle stays alive while the returned #GstGLContext is
 active.</doc>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="full">
           <doc xml:space="preserve">a #GstGLContext wrapping @handle</doc>
           <type name="GLContext" c:type="GstGLContext*"/>
         </return-value>
@@ -1808,12 +1815,15 @@ after a call to gst_gl_context_create_context().</doc>
           </parameter>
         </parameters>
       </virtual-method>
-      <virtual-method name="swap_buffers">
+      <virtual-method name="swap_buffers" invoker="swap_buffers">
+        <doc xml:space="preserve">Swap the front and back buffers on the window attached to @context.
+This will display the frame on the next refresh cycle.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
           <instance-parameter name="context" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLContext</doc>
             <type name="GLContext" c:type="GstGLContext*"/>
           </instance-parameter>
         </parameters>
@@ -1895,6 +1905,11 @@ case.</doc>
             <doc xml:space="preserve">a #GstGLContext</doc>
             <type name="GLContext" c:type="GstGLContext*"/>
           </instance-parameter>
+          <parameter name="fbo_target" transfer-ownership="none">
+            <doc xml:space="preserve">the GL value of the framebuffer target, GL_FRAMEBUFFER,
+             GL_READ_FRAMEBUFFER, GL_DRAW_FRAMEBUFFER</doc>
+            <type name="guint" c:type="guint"/>
+          </parameter>
         </parameters>
       </method>
       <method name="check_gl_version"
@@ -2153,7 +2168,11 @@ the OpenGL API and version or for an appropriate OpenGL extension.
 Note: On success, you need to cast the returned function pointer to the
 correct type to be able to call it correctly.  On 32-bit Windows, this will
 include the %GSTGLAPI identifier to use the correct calling convention.
-e.g. void (GSTGLAPI *PFN_glGetIntegerv) (GLenum name, GLint * ret)</doc>
+e.g.
+
+|[&lt;!-- language="C" --&gt;
+void (GSTGLAPI *PFN_glGetIntegerv) (GLenum name, GLint * ret)
+]|</doc>
         <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">a function pointer or %NULL</doc>
           <type name="gpointer" c:type="gpointer"/>
@@ -2253,20 +2272,37 @@ already running.</doc>
       <method name="supports_glsl_profile_version"
               c:identifier="gst_gl_context_supports_glsl_profile_version">
         <return-value transfer-ownership="none">
+          <doc xml:space="preserve">Whether @context supports the combination of @version with @profile</doc>
           <type name="gboolean" c:type="gboolean"/>
         </return-value>
         <parameters>
           <instance-parameter name="context" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLContext</doc>
             <type name="GLContext" c:type="GstGLContext*"/>
           </instance-parameter>
           <parameter name="version" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLSLVersion</doc>
             <type name="GLSLVersion" c:type="GstGLSLVersion"/>
           </parameter>
           <parameter name="profile" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLSLProfile</doc>
             <type name="GLSLProfile" c:type="GstGLSLProfile"/>
           </parameter>
         </parameters>
       </method>
+      <method name="swap_buffers" c:identifier="gst_gl_context_swap_buffers">
+        <doc xml:space="preserve">Swap the front and back buffers on the window attached to @context.
+This will display the frame on the next refresh cycle.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="context" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLContext</doc>
+            <type name="GLContext" c:type="GstGLContext*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="thread_add"
               c:identifier="gst_gl_context_thread_add"
               version="1.4">
@@ -2456,6 +2492,7 @@ MT-safe</doc>
           </return-value>
           <parameters>
             <parameter name="context" transfer-ownership="none">
+              <doc xml:space="preserve">a #GstGLContext</doc>
               <type name="GLContext" c:type="GstGLContext*"/>
             </parameter>
           </parameters>
@@ -2584,7 +2621,7 @@ platform and window system specific functionality.
 - GST_GL_PLATFORM influences the OpenGL platform to use.  Common values are
   'egl', 'glx', 'wgl' or 'cgl'.
 - GST_GL_API influences the OpenGL API requested by the OpenGL platform.
-  Common values are 'opengl' and 'gles2'.
+  Common values are 'opengl', 'opengl3' and 'gles2'.
 
 &gt; Certain window systems require a special function to be called to
 &gt; initialize threading support.  As this GStreamer GL library does not preclude
@@ -2935,6 +2972,10 @@ display's object lock held.</doc>
       <member name="viv_fb"
               value="64"
               c:identifier="GST_GL_DISPLAY_TYPE_VIV_FB">
+        <doc xml:space="preserve">Vivante Framebuffer display</doc>
+      </member>
+      <member name="gbm" value="128" c:identifier="GST_GL_DISPLAY_TYPE_GBM">
+        <doc xml:space="preserve">Mesa3D GBM display</doc>
       </member>
       <member name="any"
               value="4294967295"
@@ -2951,6 +2992,17 @@ display's object lock held.</doc>
            glib:type-struct="GLFilterClass">
       <doc xml:space="preserve">#GstGLFilter helps to implement simple OpenGL filter elements taking a
 single input and producing a single output with a #GstGLFramebuffer</doc>
+      <function name="add_rgba_pad_templates"
+                c:identifier="gst_gl_filter_add_rgba_pad_templates">
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <parameter name="klass" transfer-ownership="none">
+            <type name="GLFilterClass" c:type="GstGLFilterClass*"/>
+          </parameter>
+        </parameters>
+      </function>
       <virtual-method name="filter">
         <return-value transfer-ownership="none">
           <type name="gboolean" c:type="gboolean"/>
@@ -2970,8 +3022,7 @@ single input and producing a single output with a #GstGLFramebuffer</doc>
       <virtual-method name="filter_texture"
                       invoker="filter_texture"
                       version="1.4">
-        <doc xml:space="preserve">Perform automatic upload if needed, call filter_texture vfunc and then an
-automatic download if needed.</doc>
+        <doc xml:space="preserve">Calls filter_texture vfunc with correctly mapped #GstGLMemorys</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">whether the transformation succeeded</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -3054,8 +3105,7 @@ any shaders, viewport state, etc must be setup by the caller.</doc>
       <method name="filter_texture"
               c:identifier="gst_gl_filter_filter_texture"
               version="1.4">
-        <doc xml:space="preserve">Perform automatic upload if needed, call filter_texture vfunc and then an
-automatic download if needed.</doc>
+        <doc xml:space="preserve">Calls filter_texture vfunc with correctly mapped #GstGLMemorys</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">whether the transformation succeeded</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -3152,6 +3202,14 @@ See also: gst_gl_filter_render_to_target()</doc>
         <doc xml:space="preserve">the video info for output buffers</doc>
         <type name="GstVideo.VideoInfo" c:type="GstVideoInfo"/>
       </field>
+      <field name="in_texture_target">
+        <doc xml:space="preserve">The texture target of the input buffers (usually 2D)</doc>
+        <type name="GLTextureTarget" c:type="GstGLTextureTarget"/>
+      </field>
+      <field name="out_texture_target">
+        <doc xml:space="preserve">The texture target of the output buffers (usually 2D)</doc>
+        <type name="GLTextureTarget" c:type="GstGLTextureTarget"/>
+      </field>
       <field name="out_caps">
         <doc xml:space="preserve">the output #GstCaps</doc>
         <type name="Gst.Caps" c:type="GstCaps*"/>
@@ -3175,26 +3233,20 @@ See also: gst_gl_filter_render_to_target()</doc>
       <field name="valid_attributes" readable="0" private="1">
         <type name="gboolean" c:type="gboolean"/>
       </field>
-      <field name="vao" introspectable="0" readable="0" private="1">
-        <type c:type="GLuint"/>
+      <field name="vao" readable="0" private="1">
+        <type name="guint" c:type="guint"/>
       </field>
-      <field name="vbo_indices" introspectable="0" readable="0" private="1">
-        <type c:type="GLuint"/>
+      <field name="vbo_indices" readable="0" private="1">
+        <type name="guint" c:type="guint"/>
       </field>
-      <field name="vertex_buffer" introspectable="0" readable="0" private="1">
-        <type c:type="GLuint"/>
+      <field name="vertex_buffer" readable="0" private="1">
+        <type name="guint" c:type="guint"/>
       </field>
-      <field name="draw_attr_position_loc"
-             introspectable="0"
-             readable="0"
-             private="1">
-        <type c:type="GLint"/>
+      <field name="draw_attr_position_loc" readable="0" private="1">
+        <type name="gint" c:type="gint"/>
       </field>
-      <field name="draw_attr_texture_loc"
-             introspectable="0"
-             readable="0"
-             private="1">
-        <type c:type="GLint"/>
+      <field name="draw_attr_texture_loc" readable="0" private="1">
+        <type name="gint" c:type="gint"/>
       </field>
       <field name="_padding" readable="0" private="1">
         <array zero-terminated="0" c:type="gpointer" fixed-size="4">
@@ -3332,38 +3384,58 @@ See also: gst_gl_filter_render_to_target()</doc>
     </callback>
     <enumeration name="GLFormat" c:type="GstGLFormat">
       <member name="luminance" value="6409" c:identifier="GST_GL_LUMINANCE">
+        <doc xml:space="preserve">Single component replicated across R, G, and B textures
+                   components</doc>
       </member>
       <member name="alpha" value="6406" c:identifier="GST_GL_ALPHA">
+        <doc xml:space="preserve">Single component stored in the A texture component</doc>
       </member>
       <member name="luminance_alpha"
               value="6410"
               c:identifier="GST_GL_LUMINANCE_ALPHA">
+        <doc xml:space="preserve">Combination of #GST_GL_LUMINANCE and #GST_GL_ALPHA</doc>
       </member>
       <member name="red" value="6403" c:identifier="GST_GL_RED">
+        <doc xml:space="preserve">Single component stored in the R texture component</doc>
       </member>
       <member name="r8" value="33321" c:identifier="GST_GL_R8">
+        <doc xml:space="preserve">Single 8-bit component stored in the R texture component</doc>
       </member>
       <member name="rg" value="33319" c:identifier="GST_GL_RG">
+        <doc xml:space="preserve">Two components stored in the R and G texture components</doc>
       </member>
       <member name="rg8" value="33323" c:identifier="GST_GL_RG8">
+        <doc xml:space="preserve">Two 8-bit components stored in the R and G texture components</doc>
       </member>
       <member name="rgb" value="6407" c:identifier="GST_GL_RGB">
+        <doc xml:space="preserve">Three components stored in the R, G, and B texture components</doc>
       </member>
       <member name="rgb8" value="32849" c:identifier="GST_GL_RGB8">
+        <doc xml:space="preserve">Three 8-bit components stored in the R, G, and B
+              texture components</doc>
       </member>
       <member name="rgb565" value="36194" c:identifier="GST_GL_RGB565">
+        <doc xml:space="preserve">Three components of bit depth 5, 6 and 5 stored in the R, G,
+                and B texture components respectively.</doc>
       </member>
       <member name="rgba" value="6408" c:identifier="GST_GL_RGBA">
+        <doc xml:space="preserve">Four components stored in the R, G, B, and A texture
+              components respectively.</doc>
       </member>
       <member name="rgba8" value="32856" c:identifier="GST_GL_RGBA8">
+        <doc xml:space="preserve">Four 8-bit components stored in the R, G, B, and A texture
+               components respectively.</doc>
       </member>
       <member name="depth_component16"
               value="33189"
               c:identifier="GST_GL_DEPTH_COMPONENT16">
+        <doc xml:space="preserve">A single 16-bit component for depth information.</doc>
       </member>
       <member name="depth24_stencil8"
               value="35056"
               c:identifier="GST_GL_DEPTH24_STENCIL8">
+        <doc xml:space="preserve">A 24-bit component for depth information and
+                          a 8-bit component for stencil informat.</doc>
       </member>
     </enumeration>
     <class name="GLFramebuffer"
@@ -3386,7 +3458,7 @@ between multiple OpenGL contexts.</doc>
       <constructor name="new"
                    c:identifier="gst_gl_framebuffer_new"
                    version="1.10">
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="full">
           <doc xml:space="preserve">a new #GstGLFramebuffer</doc>
           <type name="GLFramebuffer" c:type="GstGLFramebuffer*"/>
         </return-value>
@@ -8032,27 +8104,38 @@ is specified by @tex_format, @width and @height.</doc>
           </parameter>
         </parameters>
       </method>
-      <method name="copy_teximage" c:identifier="gst_gl_memory_copy_teximage">
+      <method name="copy_teximage"
+              c:identifier="gst_gl_memory_copy_teximage"
+              version="1.8">
+        <doc xml:space="preserve">Copies the texture in #GstGLMemory into the texture specified by @tex_id,
+@out_target, @out_tex_format, @out_width and @out_height.</doc>
         <return-value transfer-ownership="none">
+          <doc xml:space="preserve">whether the copy succeeded.</doc>
           <type name="gboolean" c:type="gboolean"/>
         </return-value>
         <parameters>
           <instance-parameter name="src" transfer-ownership="none">
+            <doc xml:space="preserve">the source #GstGLMemory</doc>
             <type name="GLMemory" c:type="GstGLMemory*"/>
           </instance-parameter>
           <parameter name="tex_id" transfer-ownership="none">
+            <doc xml:space="preserve">the destination texture id</doc>
             <type name="guint" c:type="guint"/>
           </parameter>
           <parameter name="out_target" transfer-ownership="none">
+            <doc xml:space="preserve">the destination #GstGLTextureTarget</doc>
             <type name="GLTextureTarget" c:type="GstGLTextureTarget"/>
           </parameter>
           <parameter name="out_tex_format" transfer-ownership="none">
+            <doc xml:space="preserve">the destination #GstGLFormat</doc>
             <type name="GLFormat" c:type="GstGLFormat"/>
           </parameter>
-          <parameter name="width" transfer-ownership="none">
+          <parameter name="out_width" transfer-ownership="none">
+            <doc xml:space="preserve">the destination width</doc>
             <type name="gint" c:type="gint"/>
           </parameter>
-          <parameter name="height" transfer-ownership="none">
+          <parameter name="out_height" transfer-ownership="none">
+            <doc xml:space="preserve">the destination height</doc>
             <type name="gint" c:type="gint"/>
           </parameter>
         </parameters>
@@ -8258,7 +8341,8 @@ multiple times.  This must be called before any other GstGLMemory operation.</do
       </function>
       <function name="setup_buffer"
                 c:identifier="gst_gl_memory_setup_buffer"
-                version="1.8">
+                version="1.8"
+                introspectable="0">
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">whether the buffer was correctly setup</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -8281,15 +8365,18 @@ multiple times.  This must be called before any other GstGLMemory operation.</do
                      transfer-ownership="none"
                      nullable="1"
                      allow-none="1">
-            <doc xml:space="preserve">a list of #GstGLFormat's to allocate with.</doc>
-            <type name="GLFormat" c:type="GstGLFormat*"/>
-          </parameter>
-          <parameter name="wrapped_data"
-                     transfer-ownership="none"
-                     nullable="1"
-                     allow-none="1">
-            <doc xml:space="preserve">a list of wrapped data pointers</doc>
-            <type name="gpointer" c:type="gpointer*"/>
+            <doc xml:space="preserve">
+    a list of #GstGLFormat's to allocate with.</doc>
+            <array length="5" zero-terminated="0" c:type="GstGLFormat*">
+              <type name="GLFormat" c:type="GstGLFormat"/>
+            </array>
+          </parameter>
+          <parameter name="wrapped_data" transfer-ownership="none">
+            <doc xml:space="preserve">
+    a list of wrapped data pointers</doc>
+            <array length="5" zero-terminated="0" c:type="gpointer*">
+              <type name="gpointer"/>
+            </array>
           </parameter>
           <parameter name="n_wrapped_pointers" transfer-ownership="none">
             <doc xml:space="preserve">the number of elements in @tex_formats and @wrapped_data</doc>
@@ -8587,17 +8674,11 @@ mappings between texture formats.</doc>
       <field name="shader" readable="0" private="1">
         <type name="GLShader" c:type="GstGLShader*"/>
       </field>
-      <field name="position_attrib"
-             introspectable="0"
-             readable="0"
-             private="1">
-        <type c:type="GLint"/>
+      <field name="position_attrib" readable="0" private="1">
+        <type name="gint" c:type="gint"/>
       </field>
-      <field name="texcoord_attrib"
-             introspectable="0"
-             readable="0"
-             private="1">
-        <type c:type="GLint"/>
+      <field name="texcoord_attrib" readable="0" private="1">
+        <type name="gint" c:type="gint"/>
       </field>
       <field name="_padding" readable="0" private="1">
         <array zero-terminated="0" c:type="gpointer" fixed-size="4">
@@ -9110,7 +9191,7 @@ multiple times.  This must be called before any other GstGLRenderbuffer operatio
            glib:type-struct="GLSLStageClass">
       <doc xml:space="preserve">#GstGLSLStage holds and represents a single OpenGL shader stage.</doc>
       <constructor name="new" c:identifier="gst_glsl_stage_new" version="1.8">
-        <return-value transfer-ownership="full">
+        <return-value transfer-ownership="none">
           <doc xml:space="preserve">a new #GstGLSLStage of the specified @type</doc>
           <type name="GLSLStage" c:type="GstGLSLStage*"/>
         </return-value>
@@ -9150,7 +9231,7 @@ multiple times.  This must be called before any other GstGLRenderbuffer operatio
       <constructor name="new_with_string"
                    c:identifier="gst_glsl_stage_new_with_string"
                    version="1.8">
-        <return-value transfer-ownership="full">
+        <return-value transfer-ownership="none">
           <doc xml:space="preserve">a new #GstGLSLStage of the specified @type</doc>
           <type name="GLSLStage" c:type="GstGLSLStage*"/>
         </return-value>
@@ -9180,7 +9261,7 @@ multiple times.  This must be called before any other GstGLRenderbuffer operatio
       <constructor name="new_with_strings"
                    c:identifier="gst_glsl_stage_new_with_strings"
                    version="1.8">
-        <return-value transfer-ownership="full">
+        <return-value transfer-ownership="none">
           <doc xml:space="preserve">a new #GstGLSLStage of the specified @type</doc>
           <type name="GLSLStage" c:type="GstGLSLStage*"/>
         </return-value>
@@ -9206,8 +9287,11 @@ multiple times.  This must be called before any other GstGLRenderbuffer operatio
             <type name="gint" c:type="gint"/>
           </parameter>
           <parameter name="str" transfer-ownership="none">
-            <doc xml:space="preserve">an array of strings concatted together to produce a shader</doc>
-            <type name="utf8" c:type="const gchar**"/>
+            <doc xml:space="preserve">
+    an array of strings concatted together to produce a shader</doc>
+            <array length="4" zero-terminated="0" c:type="gchar**">
+              <type name="utf8" c:type="gchar*"/>
+            </array>
           </parameter>
         </parameters>
       </constructor>
@@ -9308,7 +9392,9 @@ multiple times.  This must be called before any other GstGLRenderbuffer operatio
           </parameter>
           <parameter name="str" transfer-ownership="none">
             <doc xml:space="preserve">a GLSL shader string</doc>
-            <type name="utf8" c:type="const gchar**"/>
+            <array length="2" zero-terminated="0" c:type="gchar**">
+              <type name="utf8" c:type="gchar*"/>
+            </array>
           </parameter>
         </parameters>
       </method>
@@ -9531,34 +9617,44 @@ Note: must be called in the GL thread</doc>
       </method>
       <method name="bind_attribute_location"
               c:identifier="gst_gl_shader_bind_attribute_location">
+        <doc xml:space="preserve">Bind attribute @name to the specified location @index using
+glBindAttributeLocation().</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
           <instance-parameter name="shader" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLShader</doc>
             <type name="GLShader" c:type="GstGLShader*"/>
           </instance-parameter>
           <parameter name="index" transfer-ownership="none">
+            <doc xml:space="preserve">attribute index to set</doc>
             <type name="guint" c:type="guint"/>
           </parameter>
           <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">name of the attribute</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
         </parameters>
       </method>
       <method name="bind_frag_data_location"
               c:identifier="gst_gl_shader_bind_frag_data_location">
+        <doc xml:space="preserve">Bind attribute @name to the specified location @index using
+glBindFragDataLocation().</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
           <instance-parameter name="shader" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLShader</doc>
             <type name="GLShader" c:type="GstGLShader*"/>
           </instance-parameter>
           <parameter name="index" transfer-ownership="none">
+            <doc xml:space="preserve">attribute index to set</doc>
             <type name="guint" c:type="guint"/>
           </parameter>
           <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">name of the attribute</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
         </parameters>
@@ -9628,13 +9724,16 @@ Note: must be called in the GL thread</doc>
       <method name="get_attribute_location"
               c:identifier="gst_gl_shader_get_attribute_location">
         <return-value transfer-ownership="none">
+          <doc xml:space="preserve">the attribute index for @name in @shader or -1 on failure</doc>
           <type name="gint" c:type="gint"/>
         </return-value>
         <parameters>
           <instance-parameter name="shader" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLShader</doc>
             <type name="GLShader" c:type="GstGLShader*"/>
           </instance-parameter>
           <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">name of the attribute</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
         </parameters>
@@ -9720,539 +9819,693 @@ Note: must be called in the GL thread</doc>
       </method>
       <method name="set_uniform_1f"
               c:identifier="gst_gl_shader_set_uniform_1f">
+        <doc xml:space="preserve">Perform glUniform1f() for @name on @shader</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
           <instance-parameter name="shader" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLShader</doc>
             <type name="GLShader" c:type="GstGLShader*"/>
           </instance-parameter>
           <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">name of the uniform</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="value" transfer-ownership="none">
+            <doc xml:space="preserve">value to set</doc>
             <type name="gfloat" c:type="gfloat"/>
           </parameter>
         </parameters>
       </method>
       <method name="set_uniform_1fv"
               c:identifier="gst_gl_shader_set_uniform_1fv">
+        <doc xml:space="preserve">Perform glUniform1fv() for @name on @shader</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
           <instance-parameter name="shader" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLShader</doc>
             <type name="GLShader" c:type="GstGLShader*"/>
           </instance-parameter>
           <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">name of the uniform</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="count" transfer-ownership="none">
+            <doc xml:space="preserve">number of values to set</doc>
             <type name="guint" c:type="guint"/>
           </parameter>
           <parameter name="value" transfer-ownership="none">
-            <type name="gfloat" c:type="gfloat*"/>
+            <doc xml:space="preserve">values to set</doc>
+            <array length="1" zero-terminated="0" c:type="gfloat*">
+              <type name="gfloat" c:type="gfloat"/>
+            </array>
           </parameter>
         </parameters>
       </method>
       <method name="set_uniform_1i"
               c:identifier="gst_gl_shader_set_uniform_1i">
+        <doc xml:space="preserve">Perform glUniform1i() for @name on @shader</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
           <instance-parameter name="shader" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLShader</doc>
             <type name="GLShader" c:type="GstGLShader*"/>
           </instance-parameter>
           <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">name of the uniform</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="value" transfer-ownership="none">
+            <doc xml:space="preserve">value to set</doc>
             <type name="gint" c:type="gint"/>
           </parameter>
         </parameters>
       </method>
       <method name="set_uniform_1iv"
               c:identifier="gst_gl_shader_set_uniform_1iv">
+        <doc xml:space="preserve">Perform glUniform1iv() for @name on @shader</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
           <instance-parameter name="shader" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLShader</doc>
             <type name="GLShader" c:type="GstGLShader*"/>
           </instance-parameter>
           <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">name of the uniform</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="count" transfer-ownership="none">
+            <doc xml:space="preserve">number of values to set</doc>
             <type name="guint" c:type="guint"/>
           </parameter>
           <parameter name="value" transfer-ownership="none">
-            <type name="gint" c:type="gint*"/>
+            <doc xml:space="preserve">values to set</doc>
+            <array length="1" zero-terminated="0" c:type="gint*">
+              <type name="gint" c:type="gint"/>
+            </array>
           </parameter>
         </parameters>
       </method>
       <method name="set_uniform_2f"
               c:identifier="gst_gl_shader_set_uniform_2f">
+        <doc xml:space="preserve">Perform glUniform2f() for @name on @shader</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
           <instance-parameter name="shader" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLShader</doc>
             <type name="GLShader" c:type="GstGLShader*"/>
           </instance-parameter>
           <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">name of the uniform</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="v0" transfer-ownership="none">
+            <doc xml:space="preserve">first value to set</doc>
             <type name="gfloat" c:type="gfloat"/>
           </parameter>
           <parameter name="v1" transfer-ownership="none">
+            <doc xml:space="preserve">second value to set</doc>
             <type name="gfloat" c:type="gfloat"/>
           </parameter>
         </parameters>
       </method>
       <method name="set_uniform_2fv"
               c:identifier="gst_gl_shader_set_uniform_2fv">
+        <doc xml:space="preserve">Perform glUniform2fv() for @name on @shader</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
           <instance-parameter name="shader" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLShader</doc>
             <type name="GLShader" c:type="GstGLShader*"/>
           </instance-parameter>
           <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">name of the uniform</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="count" transfer-ownership="none">
+            <doc xml:space="preserve">number of values to set</doc>
             <type name="guint" c:type="guint"/>
           </parameter>
           <parameter name="value" transfer-ownership="none">
-            <type name="gfloat" c:type="gfloat*"/>
+            <doc xml:space="preserve">values to set</doc>
+            <array length="1" zero-terminated="0" c:type="gfloat*">
+              <type name="gfloat" c:type="gfloat"/>
+            </array>
           </parameter>
         </parameters>
       </method>
       <method name="set_uniform_2i"
               c:identifier="gst_gl_shader_set_uniform_2i">
+        <doc xml:space="preserve">Perform glUniform2i() for @name on @shader</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
           <instance-parameter name="shader" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLShader</doc>
             <type name="GLShader" c:type="GstGLShader*"/>
           </instance-parameter>
           <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">name of the uniform</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="v0" transfer-ownership="none">
+            <doc xml:space="preserve">first value to set</doc>
             <type name="gint" c:type="gint"/>
           </parameter>
           <parameter name="v1" transfer-ownership="none">
+            <doc xml:space="preserve">second value to set</doc>
             <type name="gint" c:type="gint"/>
           </parameter>
         </parameters>
       </method>
       <method name="set_uniform_2iv"
               c:identifier="gst_gl_shader_set_uniform_2iv">
+        <doc xml:space="preserve">Perform glUniform2iv() for @name on @shader</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
           <instance-parameter name="shader" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLShader</doc>
             <type name="GLShader" c:type="GstGLShader*"/>
           </instance-parameter>
           <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">name of the uniform</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="count" transfer-ownership="none">
+            <doc xml:space="preserve">number of values to set</doc>
             <type name="guint" c:type="guint"/>
           </parameter>
           <parameter name="value" transfer-ownership="none">
-            <type name="gint" c:type="gint*"/>
+            <doc xml:space="preserve">values to set</doc>
+            <array length="1" zero-terminated="0" c:type="gint*">
+              <type name="gint" c:type="gint"/>
+            </array>
           </parameter>
         </parameters>
       </method>
       <method name="set_uniform_3f"
               c:identifier="gst_gl_shader_set_uniform_3f">
+        <doc xml:space="preserve">Perform glUniform3f() for @name on @shader</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
           <instance-parameter name="shader" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLShader</doc>
             <type name="GLShader" c:type="GstGLShader*"/>
           </instance-parameter>
           <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">name of the uniform</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="v0" transfer-ownership="none">
+            <doc xml:space="preserve">first value to set</doc>
             <type name="gfloat" c:type="gfloat"/>
           </parameter>
           <parameter name="v1" transfer-ownership="none">
+            <doc xml:space="preserve">second value to set</doc>
             <type name="gfloat" c:type="gfloat"/>
           </parameter>
           <parameter name="v2" transfer-ownership="none">
+            <doc xml:space="preserve">third value to set</doc>
             <type name="gfloat" c:type="gfloat"/>
           </parameter>
         </parameters>
       </method>
       <method name="set_uniform_3fv"
               c:identifier="gst_gl_shader_set_uniform_3fv">
+        <doc xml:space="preserve">Perform glUniform3fv() for @name on @shader</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
           <instance-parameter name="shader" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLShader</doc>
             <type name="GLShader" c:type="GstGLShader*"/>
           </instance-parameter>
           <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">name of the uniform</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="count" transfer-ownership="none">
+            <doc xml:space="preserve">number of values to set</doc>
             <type name="guint" c:type="guint"/>
           </parameter>
           <parameter name="value" transfer-ownership="none">
-            <type name="gfloat" c:type="gfloat*"/>
+            <doc xml:space="preserve">values to set</doc>
+            <array length="1" zero-terminated="0" c:type="gfloat*">
+              <type name="gfloat" c:type="gfloat"/>
+            </array>
           </parameter>
         </parameters>
       </method>
       <method name="set_uniform_3i"
               c:identifier="gst_gl_shader_set_uniform_3i">
+        <doc xml:space="preserve">Perform glUniform3i() for @name on @shader</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
           <instance-parameter name="shader" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLShader</doc>
             <type name="GLShader" c:type="GstGLShader*"/>
           </instance-parameter>
           <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">name of the uniform</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="v0" transfer-ownership="none">
+            <doc xml:space="preserve">first value to set</doc>
             <type name="gint" c:type="gint"/>
           </parameter>
           <parameter name="v1" transfer-ownership="none">
+            <doc xml:space="preserve">second value to set</doc>
             <type name="gint" c:type="gint"/>
           </parameter>
           <parameter name="v2" transfer-ownership="none">
+            <doc xml:space="preserve">third value to set</doc>
             <type name="gint" c:type="gint"/>
           </parameter>
         </parameters>
       </method>
       <method name="set_uniform_3iv"
               c:identifier="gst_gl_shader_set_uniform_3iv">
+        <doc xml:space="preserve">Perform glUniform3iv() for @name on @shader</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
           <instance-parameter name="shader" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLShader</doc>
             <type name="GLShader" c:type="GstGLShader*"/>
           </instance-parameter>
           <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">name of the uniform</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="count" transfer-ownership="none">
+            <doc xml:space="preserve">number of values to set</doc>
             <type name="guint" c:type="guint"/>
           </parameter>
           <parameter name="value" transfer-ownership="none">
-            <type name="gint" c:type="gint*"/>
+            <doc xml:space="preserve">values to set</doc>
+            <array length="1" zero-terminated="0" c:type="gint*">
+              <type name="gint" c:type="gint"/>
+            </array>
           </parameter>
         </parameters>
       </method>
       <method name="set_uniform_4f"
               c:identifier="gst_gl_shader_set_uniform_4f">
+        <doc xml:space="preserve">Perform glUniform4f() for @name on @shader</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
           <instance-parameter name="shader" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLShader</doc>
             <type name="GLShader" c:type="GstGLShader*"/>
           </instance-parameter>
           <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">name of the uniform</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="v0" transfer-ownership="none">
+            <doc xml:space="preserve">first value to set</doc>
             <type name="gfloat" c:type="gfloat"/>
           </parameter>
           <parameter name="v1" transfer-ownership="none">
+            <doc xml:space="preserve">second value to set</doc>
             <type name="gfloat" c:type="gfloat"/>
           </parameter>
           <parameter name="v2" transfer-ownership="none">
+            <doc xml:space="preserve">third value to set</doc>
             <type name="gfloat" c:type="gfloat"/>
           </parameter>
           <parameter name="v3" transfer-ownership="none">
+            <doc xml:space="preserve">fourth value to set</doc>
             <type name="gfloat" c:type="gfloat"/>
           </parameter>
         </parameters>
       </method>
       <method name="set_uniform_4fv"
               c:identifier="gst_gl_shader_set_uniform_4fv">
+        <doc xml:space="preserve">Perform glUniform4fv() for @name on @shader</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
           <instance-parameter name="shader" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLShader</doc>
             <type name="GLShader" c:type="GstGLShader*"/>
           </instance-parameter>
           <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">name of the uniform</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="count" transfer-ownership="none">
+            <doc xml:space="preserve">number of values to set</doc>
             <type name="guint" c:type="guint"/>
           </parameter>
           <parameter name="value" transfer-ownership="none">
-            <type name="gfloat" c:type="gfloat*"/>
+            <doc xml:space="preserve">values to set</doc>
+            <array length="1" zero-terminated="0" c:type="gfloat*">
+              <type name="gfloat" c:type="gfloat"/>
+            </array>
           </parameter>
         </parameters>
       </method>
       <method name="set_uniform_4i"
               c:identifier="gst_gl_shader_set_uniform_4i">
+        <doc xml:space="preserve">Perform glUniform4i() for @name on @shader</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
           <instance-parameter name="shader" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLShader</doc>
             <type name="GLShader" c:type="GstGLShader*"/>
           </instance-parameter>
           <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">name of the uniform</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="v0" transfer-ownership="none">
+            <doc xml:space="preserve">first value to set</doc>
             <type name="gint" c:type="gint"/>
           </parameter>
           <parameter name="v1" transfer-ownership="none">
+            <doc xml:space="preserve">second value to set</doc>
             <type name="gint" c:type="gint"/>
           </parameter>
           <parameter name="v2" transfer-ownership="none">
+            <doc xml:space="preserve">third value to set</doc>
             <type name="gint" c:type="gint"/>
           </parameter>
           <parameter name="v3" transfer-ownership="none">
+            <doc xml:space="preserve">fourth value to set</doc>
             <type name="gint" c:type="gint"/>
           </parameter>
         </parameters>
       </method>
       <method name="set_uniform_4iv"
               c:identifier="gst_gl_shader_set_uniform_4iv">
+        <doc xml:space="preserve">Perform glUniform4iv() for @name on @shader</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
           <instance-parameter name="shader" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLShader</doc>
             <type name="GLShader" c:type="GstGLShader*"/>
           </instance-parameter>
           <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">name of the uniform</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="count" transfer-ownership="none">
+            <doc xml:space="preserve">number of values to set</doc>
             <type name="guint" c:type="guint"/>
           </parameter>
           <parameter name="value" transfer-ownership="none">
-            <type name="gint" c:type="gint*"/>
+            <doc xml:space="preserve">values to set</doc>
+            <array length="1" zero-terminated="0" c:type="gint*">
+              <type name="gint" c:type="gint"/>
+            </array>
           </parameter>
         </parameters>
       </method>
       <method name="set_uniform_matrix_2fv"
               c:identifier="gst_gl_shader_set_uniform_matrix_2fv">
+        <doc xml:space="preserve">Perform glUniformMatrix2fv() for @name on @shader</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
           <instance-parameter name="shader" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLShader</doc>
             <type name="GLShader" c:type="GstGLShader*"/>
           </instance-parameter>
           <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">name of the uniform</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="count" transfer-ownership="none">
+            <doc xml:space="preserve">number of 2x2 matrices to set</doc>
             <type name="gint" c:type="gint"/>
           </parameter>
           <parameter name="transpose" transfer-ownership="none">
+            <doc xml:space="preserve">transpose the matrix</doc>
             <type name="gboolean" c:type="gboolean"/>
           </parameter>
           <parameter name="value" transfer-ownership="none">
+            <doc xml:space="preserve">matrix to set</doc>
             <type name="gfloat" c:type="const gfloat*"/>
           </parameter>
         </parameters>
       </method>
       <method name="set_uniform_matrix_2x3fv"
               c:identifier="gst_gl_shader_set_uniform_matrix_2x3fv">
+        <doc xml:space="preserve">Perform glUniformMatrix2x3fv() for @name on @shader</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
           <instance-parameter name="shader" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLShader</doc>
             <type name="GLShader" c:type="GstGLShader*"/>
           </instance-parameter>
           <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">name of the uniform</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="count" transfer-ownership="none">
+            <doc xml:space="preserve">number of 2x3 matrices to set</doc>
             <type name="gint" c:type="gint"/>
           </parameter>
           <parameter name="transpose" transfer-ownership="none">
+            <doc xml:space="preserve">transpose the matrix</doc>
             <type name="gboolean" c:type="gboolean"/>
           </parameter>
           <parameter name="value" transfer-ownership="none">
+            <doc xml:space="preserve">values to set</doc>
             <type name="gfloat" c:type="const gfloat*"/>
           </parameter>
         </parameters>
       </method>
       <method name="set_uniform_matrix_2x4fv"
               c:identifier="gst_gl_shader_set_uniform_matrix_2x4fv">
+        <doc xml:space="preserve">Perform glUniformMatrix2x4fv() for @name on @shader</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
           <instance-parameter name="shader" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLShader</doc>
             <type name="GLShader" c:type="GstGLShader*"/>
           </instance-parameter>
           <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">name of the uniform</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="count" transfer-ownership="none">
+            <doc xml:space="preserve">number of 2x4 matrices to set</doc>
             <type name="gint" c:type="gint"/>
           </parameter>
           <parameter name="transpose" transfer-ownership="none">
+            <doc xml:space="preserve">transpose the matrix</doc>
             <type name="gboolean" c:type="gboolean"/>
           </parameter>
           <parameter name="value" transfer-ownership="none">
+            <doc xml:space="preserve">values to set</doc>
             <type name="gfloat" c:type="const gfloat*"/>
           </parameter>
         </parameters>
       </method>
       <method name="set_uniform_matrix_3fv"
               c:identifier="gst_gl_shader_set_uniform_matrix_3fv">
+        <doc xml:space="preserve">Perform glUniformMatrix3fv() for @name on @shader</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
           <instance-parameter name="shader" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLShader</doc>
             <type name="GLShader" c:type="GstGLShader*"/>
           </instance-parameter>
           <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">name of the uniform</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="count" transfer-ownership="none">
+            <doc xml:space="preserve">number of 3x3 matrices to set</doc>
             <type name="gint" c:type="gint"/>
           </parameter>
           <parameter name="transpose" transfer-ownership="none">
+            <doc xml:space="preserve">transpose the matrix</doc>
             <type name="gboolean" c:type="gboolean"/>
           </parameter>
           <parameter name="value" transfer-ownership="none">
+            <doc xml:space="preserve">values to set</doc>
             <type name="gfloat" c:type="const gfloat*"/>
           </parameter>
         </parameters>
       </method>
       <method name="set_uniform_matrix_3x2fv"
               c:identifier="gst_gl_shader_set_uniform_matrix_3x2fv">
+        <doc xml:space="preserve">Perform glUniformMatrix3x2fv() for @name on @shader</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
           <instance-parameter name="shader" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLShader</doc>
             <type name="GLShader" c:type="GstGLShader*"/>
           </instance-parameter>
           <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">name of the uniform</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="count" transfer-ownership="none">
+            <doc xml:space="preserve">number of 3x2 matrices to set</doc>
             <type name="gint" c:type="gint"/>
           </parameter>
           <parameter name="transpose" transfer-ownership="none">
+            <doc xml:space="preserve">transpose the matrix</doc>
             <type name="gboolean" c:type="gboolean"/>
           </parameter>
           <parameter name="value" transfer-ownership="none">
+            <doc xml:space="preserve">values to set</doc>
             <type name="gfloat" c:type="const gfloat*"/>
           </parameter>
         </parameters>
       </method>
       <method name="set_uniform_matrix_3x4fv"
               c:identifier="gst_gl_shader_set_uniform_matrix_3x4fv">
+        <doc xml:space="preserve">Perform glUniformMatrix3x4fv() for @name on @shader</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
           <instance-parameter name="shader" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLShader</doc>
             <type name="GLShader" c:type="GstGLShader*"/>
           </instance-parameter>
           <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">name of the uniform</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="count" transfer-ownership="none">
+            <doc xml:space="preserve">number of 3x4 matrices to set</doc>
             <type name="gint" c:type="gint"/>
           </parameter>
           <parameter name="transpose" transfer-ownership="none">
+            <doc xml:space="preserve">transpose the matrix</doc>
             <type name="gboolean" c:type="gboolean"/>
           </parameter>
           <parameter name="value" transfer-ownership="none">
+            <doc xml:space="preserve">values to set</doc>
             <type name="gfloat" c:type="const gfloat*"/>
           </parameter>
         </parameters>
       </method>
       <method name="set_uniform_matrix_4fv"
               c:identifier="gst_gl_shader_set_uniform_matrix_4fv">
+        <doc xml:space="preserve">Perform glUniformMatrix4fv() for @name on @shader</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
           <instance-parameter name="shader" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLShader</doc>
             <type name="GLShader" c:type="GstGLShader*"/>
           </instance-parameter>
           <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">name of the uniform</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="count" transfer-ownership="none">
+            <doc xml:space="preserve">number of 4x4 matrices to set</doc>
             <type name="gint" c:type="gint"/>
           </parameter>
           <parameter name="transpose" transfer-ownership="none">
+            <doc xml:space="preserve">transpose the matrix</doc>
             <type name="gboolean" c:type="gboolean"/>
           </parameter>
           <parameter name="value" transfer-ownership="none">
+            <doc xml:space="preserve">values to set</doc>
             <type name="gfloat" c:type="const gfloat*"/>
           </parameter>
         </parameters>
       </method>
       <method name="set_uniform_matrix_4x2fv"
               c:identifier="gst_gl_shader_set_uniform_matrix_4x2fv">
+        <doc xml:space="preserve">Perform glUniformMatrix4x2fv() for @name on @shader</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
           <instance-parameter name="shader" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLShader</doc>
             <type name="GLShader" c:type="GstGLShader*"/>
           </instance-parameter>
           <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">name of the uniform</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="count" transfer-ownership="none">
+            <doc xml:space="preserve">number of 4x2 matrices to set</doc>
             <type name="gint" c:type="gint"/>
           </parameter>
           <parameter name="transpose" transfer-ownership="none">
+            <doc xml:space="preserve">transpose the matrix</doc>
             <type name="gboolean" c:type="gboolean"/>
           </parameter>
           <parameter name="value" transfer-ownership="none">
+            <doc xml:space="preserve">values to set</doc>
             <type name="gfloat" c:type="const gfloat*"/>
           </parameter>
         </parameters>
       </method>
       <method name="set_uniform_matrix_4x3fv"
               c:identifier="gst_gl_shader_set_uniform_matrix_4x3fv">
+        <doc xml:space="preserve">Perform glUniformMatrix4x3fv() for @name on @shader</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
           <instance-parameter name="shader" transfer-ownership="none">
+            <doc xml:space="preserve">a #GstGLShader</doc>
             <type name="GLShader" c:type="GstGLShader*"/>
           </instance-parameter>
           <parameter name="name" transfer-ownership="none">
+            <doc xml:space="preserve">name of the uniform</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="count" transfer-ownership="none">
+            <doc xml:space="preserve">number of 4x3 matrices to set</doc>
             <type name="gint" c:type="gint"/>
           </parameter>
           <parameter name="transpose" transfer-ownership="none">
+            <doc xml:space="preserve">transpose the matrix</doc>
             <type name="gboolean" c:type="gboolean"/>
           </parameter>
           <parameter name="value" transfer-ownership="none">
+            <doc xml:space="preserve">values to set</doc>
             <type name="gfloat" c:type="const gfloat*"/>
           </parameter>
         </parameters>
@@ -10567,7 +10820,7 @@ the sync point are now visible.</doc>
 
 A #GstGLUpload can be created with gst_gl_upload_new()</doc>
       <constructor name="new" c:identifier="gst_gl_upload_new">
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="full">
           <doc xml:space="preserve">a new #GstGLUpload object</doc>
           <type name="GLUpload" c:type="GstGLUpload*"/>
         </return-value>
@@ -10630,7 +10883,10 @@ gst_gl_upload_set_caps() creating a new #GstBuffer in @outbuf_ptr.</doc>
             <doc xml:space="preserve">input #GstBuffer</doc>
             <type name="Gst.Buffer" c:type="GstBuffer*"/>
           </parameter>
-          <parameter name="outbuf_ptr" transfer-ownership="none">
+          <parameter name="outbuf_ptr"
+                     direction="out"
+                     caller-allocates="0"
+                     transfer-ownership="full">
             <doc xml:space="preserve">resulting #GstBuffer</doc>
             <type name="Gst.Buffer" c:type="GstBuffer**"/>
           </parameter>
@@ -10762,6 +11018,7 @@ gst_gl_upload_set_caps() creating a new #GstBuffer in @outbuf_ptr.</doc>
       <member name="reconfigure"
               value="-3"
               c:identifier="GST_GL_UPLOAD_RECONFIGURE">
+        <doc xml:space="preserve">This element requires a reconfiguration.</doc>
       </member>
     </enumeration>
     <record name="GLVideoAllocationParams"
@@ -10790,6 +11047,7 @@ gst_gl_upload_set_caps() creating a new #GstBuffer in @outbuf_ptr.</doc>
         <type name="GLTextureTarget" c:type="GstGLTextureTarget"/>
       </field>
       <field name="tex_format" writable="1">
+        <doc xml:space="preserve">the #GstGLFormat to allocate</doc>
         <type name="GLFormat" c:type="GstGLFormat"/>
       </field>
       <field name="_padding" readable="0" private="1">
@@ -11194,7 +11452,7 @@ usage only to chain up at the end of a subclass free function.</doc>
       <constructor name="new"
                    c:identifier="gst_gl_view_convert_new"
                    version="1.6">
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="full">
           <doc xml:space="preserve">a new #GstGLViewConvert</doc>
           <type name="GLViewConvert" c:type="GstGLViewConvert*"/>
         </return-value>
@@ -12627,31 +12885,39 @@ require this to be called with a valid handle before drawing can commence.</doc>
     <constant name="GL_ALLOCATION_PARAMS_ALLOC_FLAG_ALLOC"
               value="1"
               c:type="GST_GL_ALLOCATION_PARAMS_ALLOC_FLAG_ALLOC">
+      <doc xml:space="preserve">GL Allocation flag indicating that the implementation should allocate the
+necessary resources.</doc>
       <type name="gint" c:type="gint"/>
     </constant>
     <constant name="GL_ALLOCATION_PARAMS_ALLOC_FLAG_BUFFER"
               value="16"
               c:type="GST_GL_ALLOCATION_PARAMS_ALLOC_FLAG_BUFFER">
+      <doc xml:space="preserve">GL allocation flag indicating the allocation of a GL buffer.</doc>
       <type name="gint" c:type="gint"/>
     </constant>
     <constant name="GL_ALLOCATION_PARAMS_ALLOC_FLAG_USER"
               value="65536"
               c:type="GST_GL_ALLOCATION_PARAMS_ALLOC_FLAG_USER">
+      <doc xml:space="preserve">Values &gt;= than #GST_GL_ALLOCATION_PARAMS_ALLOC_FLAG_USER can be used for
+user-defined purposes.</doc>
       <type name="gint" c:type="gint"/>
     </constant>
     <constant name="GL_ALLOCATION_PARAMS_ALLOC_FLAG_VIDEO"
               value="8"
               c:type="GST_GL_ALLOCATION_PARAMS_ALLOC_FLAG_VIDEO">
+      <doc xml:space="preserve">GL allocation flag indicating the allocation of 2D video frames</doc>
       <type name="gint" c:type="gint"/>
     </constant>
     <constant name="GL_ALLOCATION_PARAMS_ALLOC_FLAG_WRAP_GPU_HANDLE"
               value="4"
               c:type="GST_GL_ALLOCATION_PARAMS_ALLOC_FLAG_WRAP_GPU_HANDLE">
+      <doc xml:space="preserve">GL Allocation flag for using the provided GPU handle as storage.</doc>
       <type name="gint" c:type="gint"/>
     </constant>
     <constant name="GL_ALLOCATION_PARAMS_ALLOC_FLAG_WRAP_SYSMEM"
               value="2"
               c:type="GST_GL_ALLOCATION_PARAMS_ALLOC_FLAG_WRAP_SYSMEM">
+      <doc xml:space="preserve">GL Allocation flag for using the provided system memory data as storage.</doc>
       <type name="gint" c:type="gint"/>
     </constant>
     <constant name="GL_API_GLES1_NAME"
@@ -12731,6 +12997,7 @@ require this to be called with a valid handle before drawing can commence.</doc>
     <constant name="GL_DISPLAY_CONTEXT_TYPE"
               value="gst.gl.GLDisplay"
               c:type="GST_GL_DISPLAY_CONTEXT_TYPE">
+      <doc xml:space="preserve">The name used in #GstContext queries for requesting a #GstGLDisplay</doc>
       <type name="utf8" c:type="gchar*"/>
     </constant>
     <constant name="GL_MEMORY_ALLOCATOR_NAME"
@@ -12742,11 +13009,13 @@ require this to be called with a valid handle before drawing can commence.</doc>
     <constant name="GL_MEMORY_PBO_ALLOCATOR_NAME"
               value="GLMemoryPBO"
               c:type="GST_GL_MEMORY_PBO_ALLOCATOR_NAME">
+      <doc xml:space="preserve">The name of the GL Memory PBO allocator</doc>
       <type name="utf8" c:type="gchar*"/>
     </constant>
     <constant name="GL_MEMORY_VIDEO_FORMATS_STR"
               value="{ RGBA, BGRA, RGBx, BGRx, ARGB, ABGR, xRGB, xBGR, RGB, BGR, RGB16, BGR16, AYUV, I420, YV12, NV12, NV21, YUY2, UYVY, Y41B, Y42B, Y444, GRAY8, GRAY16_LE, GRAY16_BE }"
               c:type="GST_GL_MEMORY_VIDEO_FORMATS_STR">
+      <doc xml:space="preserve">List of video formats that are supported by #GstGLMemory</doc>
       <type name="utf8" c:type="gchar*"/>
     </constant>
     <constant name="GL_RENDERBUFFER_ALLOCATOR_NAME"
@@ -12866,7 +13135,10 @@ you are writing to OpenGL. Conversely, combining #GST_MAP_GL with
           <doc xml:space="preserve">a #GstContext</doc>
           <type name="Gst.Context" c:type="GstContext*"/>
         </parameter>
-        <parameter name="display" transfer-ownership="full">
+        <parameter name="display"
+                   direction="out"
+                   caller-allocates="0"
+                   transfer-ownership="full">
           <doc xml:space="preserve">resulting #GstGLDisplay</doc>
           <type name="GLDisplay" c:type="GstGLDisplay**"/>
         </parameter>
@@ -12988,6 +13260,20 @@ multiple times.  This must be called before any other #GstGLBuffer operation.</d
         </parameter>
       </parameters>
     </function>
+    <function name="gl_element_propagate_display_context"
+              c:identifier="gst_gl_element_propagate_display_context">
+      <return-value transfer-ownership="none">
+        <type name="none" c:type="void"/>
+      </return-value>
+      <parameters>
+        <parameter name="element" transfer-ownership="none">
+          <type name="Gst.Element" c:type="GstElement*"/>
+        </parameter>
+        <parameter name="display" transfer-ownership="none">
+          <type name="GLDisplay" c:type="GstGLDisplay*"/>
+        </parameter>
+      </parameters>
+    </function>
     <function name="gl_ensure_element_data"
               c:identifier="gst_gl_ensure_element_data">
       <doc xml:space="preserve">Perform the steps necessary for retrieving a #GstGLDisplay and (optionally)
@@ -13231,48 +13517,6 @@ multiple times.  This must be called before any other GstGLMemory operation.</do
         <type name="none" c:type="void"/>
       </return-value>
     </function>
-    <function name="gl_memory_setup_buffer"
-              c:identifier="gst_gl_memory_setup_buffer"
-              moved-to="GLMemory.setup_buffer"
-              version="1.8">
-      <return-value transfer-ownership="none">
-        <doc xml:space="preserve">whether the buffer was correctly setup</doc>
-        <type name="gboolean" c:type="gboolean"/>
-      </return-value>
-      <parameters>
-        <parameter name="allocator" transfer-ownership="none">
-          <doc xml:space="preserve">the @GstGLMemoryAllocator to allocate from</doc>
-          <type name="GLMemoryAllocator" c:type="GstGLMemoryAllocator*"/>
-        </parameter>
-        <parameter name="buffer" transfer-ownership="none">
-          <doc xml:space="preserve">a #GstBuffer to setup</doc>
-          <type name="Gst.Buffer" c:type="GstBuffer*"/>
-        </parameter>
-        <parameter name="params" transfer-ownership="none">
-          <doc xml:space="preserve">the #GstGLVideoAllocationParams to allocate with</doc>
-          <type name="GLVideoAllocationParams"
-                c:type="GstGLVideoAllocationParams*"/>
-        </parameter>
-        <parameter name="tex_formats"
-                   transfer-ownership="none"
-                   nullable="1"
-                   allow-none="1">
-          <doc xml:space="preserve">a list of #GstGLFormat's to allocate with.</doc>
-          <type name="GLFormat" c:type="GstGLFormat*"/>
-        </parameter>
-        <parameter name="wrapped_data"
-                   transfer-ownership="none"
-                   nullable="1"
-                   allow-none="1">
-          <doc xml:space="preserve">a list of wrapped data pointers</doc>
-          <type name="gpointer" c:type="gpointer*"/>
-        </parameter>
-        <parameter name="n_wrapped_pointers" transfer-ownership="none">
-          <doc xml:space="preserve">the number of elements in @tex_formats and @wrapped_data</doc>
-          <type name="gsize" c:type="gsize"/>
-        </parameter>
-      </parameters>
-    </function>
     <function name="gl_platform_from_string"
               c:identifier="gst_gl_platform_from_string">
       <return-value transfer-ownership="none">
@@ -13515,16 +13759,20 @@ multiple times.  This must be called before any other GstGLRenderbuffer operatio
     <function name="gl_version_to_glsl_version"
               c:identifier="gst_gl_version_to_glsl_version">
       <return-value transfer-ownership="none">
+        <doc xml:space="preserve">The minimum supported #GstGLSLVersion available for @gl_api, @maj and @min</doc>
         <type name="GLSLVersion" c:type="GstGLSLVersion"/>
       </return-value>
       <parameters>
         <parameter name="gl_api" transfer-ownership="none">
+          <doc xml:space="preserve">the #GstGLAPI</doc>
           <type name="GLAPI" c:type="GstGLAPI"/>
         </parameter>
         <parameter name="maj" transfer-ownership="none">
+          <doc xml:space="preserve">the major GL version</doc>
           <type name="gint" c:type="gint"/>
         </parameter>
         <parameter name="min" transfer-ownership="none">
+          <doc xml:space="preserve">the minor GL version</doc>
           <type name="gint" c:type="gint"/>
         </parameter>
       </parameters>
@@ -13537,38 +13785,54 @@ multiple times.  This must be called before any other GstGLRenderbuffer operatio
     <function name="glsl_profile_from_string"
               c:identifier="gst_glsl_profile_from_string">
       <return-value transfer-ownership="none">
+        <doc xml:space="preserve">the #GstGLSLProfile of @string or %GST_GLSL_PROFILE_NONE on error</doc>
         <type name="GLSLProfile" c:type="GstGLSLProfile"/>
       </return-value>
       <parameters>
         <parameter name="string" transfer-ownership="none">
+          <doc xml:space="preserve">a GLSL version string</doc>
           <type name="utf8" c:type="const gchar*"/>
         </parameter>
       </parameters>
     </function>
     <function name="glsl_profile_to_string"
               c:identifier="gst_glsl_profile_to_string">
-      <return-value transfer-ownership="none">
+      <return-value transfer-ownership="none" nullable="1">
+        <doc xml:space="preserve">the name for @profile or %NULL on error</doc>
         <type name="utf8" c:type="const gchar*"/>
       </return-value>
       <parameters>
         <parameter name="profile" transfer-ownership="none">
+          <doc xml:space="preserve">a #GstGLSLProfile</doc>
           <type name="GLSLProfile" c:type="GstGLSLProfile"/>
         </parameter>
       </parameters>
     </function>
     <function name="glsl_string_get_version_profile"
               c:identifier="gst_glsl_string_get_version_profile">
+      <doc xml:space="preserve">Note: this function first searches the first 1 kilobytes for a #version
+preprocessor directive and then executes gst_glsl_version_profile_from_string().</doc>
       <return-value transfer-ownership="none">
+        <doc xml:space="preserve">TRUE if a valid #version string was found, FALSE otherwise</doc>
         <type name="gboolean" c:type="gboolean"/>
       </return-value>
       <parameters>
         <parameter name="s" transfer-ownership="none">
+          <doc xml:space="preserve">string to search for a valid #version string</doc>
           <type name="utf8" c:type="const gchar*"/>
         </parameter>
-        <parameter name="version" transfer-ownership="none">
+        <parameter name="version"
+                   direction="out"
+                   caller-allocates="0"
+                   transfer-ownership="full">
+          <doc xml:space="preserve">resulting #GstGLSLVersion</doc>
           <type name="GLSLVersion" c:type="GstGLSLVersion*"/>
         </parameter>
-        <parameter name="profile" transfer-ownership="none">
+        <parameter name="profile"
+                   direction="out"
+                   caller-allocates="0"
+                   transfer-ownership="full">
+          <doc xml:space="preserve">resulting #GstGLSLProfile</doc>
           <type name="GLSLProfile" c:type="GstGLSLProfile*"/>
         </parameter>
       </parameters>
@@ -13576,27 +13840,41 @@ multiple times.  This must be called before any other GstGLRenderbuffer operatio
     <function name="glsl_version_from_string"
               c:identifier="gst_glsl_version_from_string">
       <return-value transfer-ownership="none">
+        <doc xml:space="preserve">the #GstGLSLVersion of @string or %GST_GLSL_VERSION_NONE on error</doc>
         <type name="GLSLVersion" c:type="GstGLSLVersion"/>
       </return-value>
       <parameters>
         <parameter name="string" transfer-ownership="none">
+          <doc xml:space="preserve">a GLSL version string</doc>
           <type name="utf8" c:type="const gchar*"/>
         </parameter>
       </parameters>
     </function>
     <function name="glsl_version_profile_from_string"
               c:identifier="gst_glsl_version_profile_from_string">
+      <doc xml:space="preserve">Note: this function expects either a #version GLSL preprocesser directive
+or a valid GLSL version and/or profile.</doc>
       <return-value transfer-ownership="none">
+        <doc xml:space="preserve">TRUE if a valid #version string was found, FALSE otherwise</doc>
         <type name="gboolean" c:type="gboolean"/>
       </return-value>
       <parameters>
         <parameter name="string" transfer-ownership="none">
+          <doc xml:space="preserve">a valid GLSL #version string</doc>
           <type name="utf8" c:type="const gchar*"/>
         </parameter>
-        <parameter name="version" transfer-ownership="none">
+        <parameter name="version_ret"
+                   direction="out"
+                   caller-allocates="0"
+                   transfer-ownership="full">
+          <doc xml:space="preserve">resulting #GstGLSLVersion</doc>
           <type name="GLSLVersion" c:type="GstGLSLVersion*"/>
         </parameter>
-        <parameter name="profile" transfer-ownership="none">
+        <parameter name="profile_ret"
+                   direction="out"
+                   caller-allocates="0"
+                   transfer-ownership="full">
+          <doc xml:space="preserve">resulting #GstGLSLVersion</doc>
           <type name="GLSLProfile" c:type="GstGLSLProfile*"/>
         </parameter>
       </parameters>
@@ -13604,24 +13882,29 @@ multiple times.  This must be called before any other GstGLRenderbuffer operatio
     <function name="glsl_version_profile_to_string"
               c:identifier="gst_glsl_version_profile_to_string">
       <return-value transfer-ownership="full">
+        <doc xml:space="preserve">the combined GLSL #version string for @version and @profile</doc>
         <type name="utf8" c:type="gchar*"/>
       </return-value>
       <parameters>
         <parameter name="version" transfer-ownership="none">
+          <doc xml:space="preserve">a #GstGLSLVersion</doc>
           <type name="GLSLVersion" c:type="GstGLSLVersion"/>
         </parameter>
         <parameter name="profile" transfer-ownership="none">
+          <doc xml:space="preserve">a #GstGLSLVersion</doc>
           <type name="GLSLProfile" c:type="GstGLSLProfile"/>
         </parameter>
       </parameters>
     </function>
     <function name="glsl_version_to_string"
               c:identifier="gst_glsl_version_to_string">
-      <return-value transfer-ownership="none">
+      <return-value transfer-ownership="none" nullable="1">
+        <doc xml:space="preserve">the name of @version or %NULL on error</doc>
         <type name="utf8" c:type="const gchar*"/>
       </return-value>
       <parameters>
         <parameter name="version" transfer-ownership="none">
+          <doc xml:space="preserve">a #GstGLSLVersion</doc>
           <type name="GLSLVersion" c:type="GstGLSLVersion"/>
         </parameter>
       </parameters>