videometa: Add documentation for GstVideoGLTextureUploadMeta

This commit is contained in:
Sebastian Dröge 2013-03-29 16:55:56 +01:00
parent f68c95ebaa
commit c5d5221cb2
2 changed files with 20 additions and 12 deletions

View file

@ -450,20 +450,17 @@ gst_video_gl_texture_upload_meta_get_info (void)
} }
/** /**
* gst_buffer_add_video_meta: * gst_buffer_add_video_gl_texture_upload_meta:
* @buffer: a #GstBuffer * @buffer: a #GstBuffer
* @flags: #GstVideoFrameFlags * @upload: the function to upload the buffer to a specific texture ID
* @format: a #GstVideoFormat * @user_data: user data for the implementor of @upload
* @width: the width * @user_data_copy: function to copy @user_data
* @height: the height * @user_data_free: function to free @user_data
* *
* Attaches GstVideoMeta metadata to @buffer with the given parameters and the * Attaches GstVideoGLTextureUploadMeta metadata to @buffer with the given
* default offsets and strides for @format and @width x @height. * parameters.
* *
* This function calculates the default offsets and strides and then calls * Returns: the #GstVideoGLTextureUploadMeta on @buffer.
* gst_buffer_add_video_meta_full() with them.
*
* Returns: the #GstVideoMeta on @buffer.
*/ */
GstVideoGLTextureUploadMeta * GstVideoGLTextureUploadMeta *
gst_buffer_add_video_gl_texture_upload_meta (GstBuffer * buffer, gst_buffer_add_video_gl_texture_upload_meta (GstBuffer * buffer,
@ -488,6 +485,16 @@ gst_buffer_add_video_gl_texture_upload_meta (GstBuffer * buffer,
return meta; return meta;
} }
/**
* gst_video_gl_texture_upload_meta_upload:
* @meta: a #GstVideoGLTextureUploadMeta
* @format: the GL format of the texture, e.g. GL_RGBA
* @texture_id: the texture ID to upload to
*
* Uploads the buffer which owns the meta to a specific texture ID.
*
* Returns: %TRUE if uploading succeeded, %FALSE otherwise.
*/
gboolean gboolean
gst_video_gl_texture_upload_meta_upload (GstVideoGLTextureUploadMeta * meta, gst_video_gl_texture_upload_meta_upload (GstVideoGLTextureUploadMeta * meta,
guint format, guint texture_id) guint format, guint texture_id)

View file

@ -150,7 +150,8 @@ typedef gboolean (*GstVideoGLTextureUpload) (GstVideoGLTextureUploadMeta *meta,
* @buffer: the buffer of this meta * @buffer: the buffer of this meta
* @upload: the function to upload the buffer to a specific texture ID * @upload: the function to upload the buffer to a specific texture ID
* @user_data: user data for the implementor of @upload * @user_data: user data for the implementor of @upload
* @destroy_notify: #GDestroyNotify for destroying @user_data * @user_data_copy: function to copy @user_data
* @user_data_free: function to free @user_data
* *
* Extra buffer metadata for uploading a buffer to an OpenGL texture * Extra buffer metadata for uploading a buffer to an OpenGL texture
* ID. The caller of gst_video_gl_texture_upload_meta_upload() must * ID. The caller of gst_video_gl_texture_upload_meta_upload() must