* gst_gl_allocation_params_copy:
* @src: the #GstGLAllocationParams to initialize
*
- * Returns: a copy of the #GstGLAllocationParams specified by @src or %NULL on
- * failure
+ * Returns: (transfer full): a copy of the #GstGLAllocationParams specified by
+ * @src or %NULL on failure
*
* Since: 1.8
*/
* gst_gl_context_get_window:
* @context: a #GstGLContext
*
- * Returns: the currently set window
+ * Returns: (transfer full) (nullable): the currently set window
*
* Since: 1.4
*/
/**
* gst_gl_context_thread_add:
* @context: a #GstGLContext
- * @func: a #GstGLContextThreadFunc
+ * @func: (scope call): a #GstGLContextThreadFunc
* @data: (closure): user data to call @func with
*
* Execute @func in the OpenGL thread of @context with @data
*
* See also gst_gl_context_activate().
*
- * Returns: the #GstGLContext active in the current thread or %NULL
+ * Returns: (transfer none): the #GstGLContext active in the current thread or %NULL
*
* Since: 1.6
*/
/**
* GstGLDisplay::create-context:
* @object: the #GstGLDisplay
- * @context: other context to share resources with.
+ * @context: (transfer none): other context to share resources with.
*
* Overrides the @GstGLContext creation mechanism.
* It can be called in any thread and it is emitted with
* display's object lock held.
*
- * Returns: the new context.
+ * Returns: (transfer full): the new context.
*/
gst_gl_display_signals[CREATE_CONTEXT] =
g_signal_new ("create-context", G_TYPE_FROM_CLASS (klass),
/**
* gst_gl_display_create_context:
* @display: a #GstGLDisplay
- * @other_context: other #GstGLContext to share resources with.
- * @p_context: resulting #GstGLContext
- * @error: resulting #GError
+ * @other_context: (transfer none): other #GstGLContext to share resources with.
+ * @p_context: (transfer full) (out): resulting #GstGLContext
+ * @error: (allow-none): resulting #GError
*
* It requires the display's object lock to be held.
*
g_return_val_if_fail (display != NULL, FALSE);
g_return_val_if_fail (p_context != NULL, FALSE);
- g_return_val_if_fail (error != NULL, FALSE);
- g_return_val_if_fail (*error == NULL, FALSE);
+ g_return_val_if_fail (error == NULL || *error != NULL, FALSE);
g_signal_emit (display, gst_gl_display_signals[CREATE_CONTEXT], 0,
other_context, &context);
* @filter: a #GstGLFilter
* @input: the input texture
* @output: the output texture
- * @func: the function to transform @input into @output. called with @data
- * @data: the data associated with @func
+ * @func: (scope call): the function to transform @input into @output. called with @data
+ * @data: (allow-none): the data associated with @func
*
* Transforms @input into @output using @func on through FBO.
*
* gst_gl_framebuffer_draw_to_texture:
* @fb: a #GstGLFramebuffer
* @mem: the #GstGLMemory to draw to
- * @func: the function to run
+ * @func: (scope call): the function to run
* @user_data: data to pass to @func
*
* Perform the steps necessary to have the output of a glDraw* command in
* gst_gl_memory_allocator_get_default:
* @context: a #GstGLContext
*
- * Returns: the default #GstGLMemoryAllocator supported by @context
+ * Returns: (transfer full): the default #GstGLMemoryAllocator supported by
+ * @context
*
* Since: 1.8
*/
* @upload: a #GstGLUpload
* @in_caps: (transfer full) (allow-none) (out): the input #GstCaps
* @out_caps: (transfer full) (allow-none) (out): the output #GstCaps
- *
- * Returns: (transfer none): The #GstCaps set by gst_gl_upload_set_caps()
*/
void
gst_gl_upload_get_caps (GstGLUpload * upload, GstCaps ** in_caps,
* @window: a #GstGLWindow
* @callback: (scope async): function to invoke
* @data: (closure): data to invoke @callback with
- * @destroy: (destroy): called when @data is not needed anymore
+ * @destroy: called when @data is not needed anymore
*
* Invoke @callback with @data on the window thread. The callback may not
* have been executed when this function returns.
* @window: a #GstGLWindow
* @callback: (scope notified): function to invoke
* @data: (closure): data to invoke @callback with
- * @destroy_notify: (destroy): called when @data is not needed any more
+ * @destroy_notify: called when @data is not needed any more
*
* Sets the draw callback called everytime gst_gl_window_draw() is called
*
* @window: a #GstGLWindow
* @callback: (scope notified): function to invoke
* @data: (closure): data to invoke @callback with
- * @destroy_notify: (destroy): called when @data is not needed any more
+ * @destroy_notify: called when @data is not needed any more
*
* Sets the resize callback called everytime a resize of the window occurs.
*
* @window: a #GstGLWindow
* @callback: (scope notified): function to invoke
* @data: (closure): data to invoke @callback with
- * @destroy_notify: (destroy): called when @data is not needed any more
+ * @destroy_notify: called when @data is not needed any more
*
* Sets the callback called when the window is about to close.
*