/* * GStreamer * Copyright (C) 2015 Matthew Waters * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Library General Public * License as published by the Free Software Foundation; either * version 2 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Library General Public License for more details. * * You should have received a copy of the GNU Library General Public * License along with this library; if not, write to the * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, * Boston, MA 02110-1301, USA. */ #ifndef _GST_GL_MEMORY_H_ #define _GST_GL_MEMORY_H_ #include #include G_BEGIN_DECLS #define GST_TYPE_GL_MEMORY_ALLOCATOR (gst_gl_memory_allocator_get_type()) GST_GL_API GType gst_gl_memory_allocator_get_type(void); #define GST_IS_GL_MEMORY_ALLOCATOR(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GST_TYPE_GL_MEMORY_ALLOCATOR)) #define GST_IS_GL_MEMORY_ALLOCATOR_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GST_TYPE_GL_MEMORY_ALLOCATOR)) #define GST_GL_MEMORY_ALLOCATOR_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GST_TYPE_GL_MEMORY_ALLOCATOR, GstGLMemoryAllocatorClass)) #define GST_GL_MEMORY_ALLOCATOR(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GST_TYPE_GL_MEMORY_ALLOCATOR, GstGLMemoryAllocator)) #define GST_GL_MEMORY_ALLOCATOR_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GST_TYPE_GL_MEMORY_ALLOCATOR, GstGLMemoryAllocatorClass)) #define GST_GL_MEMORY_ALLOCATOR_CAST(obj) ((GstGLMemoryAllocator *)(obj)) #define GST_GL_MEMORY_CAST(obj) ((GstGLMemory *) obj) /** * GST_CAPS_FEATURE_MEMORY_GL_MEMORY: * * Name of the caps feature for indicating the use of #GstGLMemory */ #define GST_CAPS_FEATURE_MEMORY_GL_MEMORY "memory:GLMemory" /** * GST_GL_MEMORY_VIDEO_EXT_FORMATS: (skip) */ #if G_BYTE_ORDER == G_LITTLE_ENDIAN #define GST_GL_MEMORY_VIDEO_EXT_FORMATS \ ", RGBA64_LE, BGR10A2_LE, RGB10A2_LE, P010_10LE, P012_LE, P016_LE, Y212_LE, Y412_LE" \ ", A444_16LE, A422_16LE, A420_16LE, A444_12LE, A422_12LE, A420_12LE, A420_10LE" \ ", A422_10LE, A444_10LE, I420_12LE, I420_10LE" #else #define GST_GL_MEMORY_VIDEO_EXT_FORMATS \ ", RGBA64_BE, P010_10BE, P012_BE, P016_BE, Y212_BE, Y412_BE" \ ", A444_16BE, A422_16BE, A420_16BE, A444_12BE, A422_12BE, A420_12BE, A420_10BE" \ ", A422_10BE, A444_10BE, I420_12BE, I420_10BE" #endif /** * GST_GL_MEMORY_VIDEO_FORMATS_STR: * * List of video formats that are supported by #GstGLMemory */ #define GST_GL_MEMORY_VIDEO_FORMATS_STR \ "{ RGBA, BGRA, RGBx, BGRx, ARGB, ABGR, xRGB, xBGR, GBRA, GBR, RGBP, BGRP, RGB, BGR, RGB16, BGR16, " \ "AYUV, VUYA, A444, A422, Y410, I420, YV12, NV12, NV21, NV16, NV61, YUY2, UYVY, Y210, Y41B, " \ "Y42B, Y444, GRAY8, GRAY16_LE, GRAY16_BE, ARGB64, A420, AV12, NV12_16L32S, NV12_4L4, RBGA, v210" \ GST_GL_MEMORY_VIDEO_EXT_FORMATS "}" /** * GstGLMemory: * @mem: the parent #GstGLBaseMemory object * @tex_id: the GL texture id for this memory * @tex_target: the GL texture target for this memory * @tex_format: the texture type * @info: the texture's #GstVideoInfo * @valign: data alignment for system memory mapping * @plane: data plane in @info * @tex_scaling: GL shader scaling parameters for @valign and/or width/height * * Represents information about a GL texture */ struct _GstGLMemory { GstGLBaseMemory mem; guint tex_id; GstGLTextureTarget tex_target; GstGLFormat tex_format; GstVideoInfo info; GstVideoAlignment valign; guint plane; gfloat tex_scaling[2]; /*< protected >*/ gboolean texture_wrapped; guint unpack_length; guint tex_width; /*< private >*/ gpointer _padding[GST_PADDING]; }; #define GST_TYPE_GL_VIDEO_ALLOCATION_PARAMS (gst_gl_video_allocation_params_get_type()) GST_GL_API GType gst_gl_video_allocation_params_get_type (void); typedef struct _GstGLVideoAllocationParams GstGLVideoAllocationParams; /** * GST_GL_ALLOCATION_PARAMS_ALLOC_FLAG_VIDEO: * * GL allocation flag indicating the allocation of 2D video frames */ #define GST_GL_ALLOCATION_PARAMS_ALLOC_FLAG_VIDEO (1 << 3) /** * GstGLVideoAllocationParams: * @parent: the parent #GstGLAllocationParams structure * @v_info: the #GstVideoInfo to allocate * @plane: the video plane index to allocate * @valign: the #GstVideoAlignment to align the system representation to (may be %NULL for the default) * @target: the #GstGLTextureTarget to allocate * @tex_format: the #GstGLFormat to allocate */ struct _GstGLVideoAllocationParams { GstGLAllocationParams parent; GstVideoInfo *v_info; guint plane; GstVideoAlignment *valign; GstGLTextureTarget target; GstGLFormat tex_format; /*< private >*/ gpointer _padding[GST_PADDING]; }; GST_GL_API gboolean gst_gl_video_allocation_params_init_full (GstGLVideoAllocationParams * params, gsize struct_size, guint alloc_flags, GstGLAllocationParamsCopyFunc copy, GstGLAllocationParamsFreeFunc free, GstGLContext * context, const GstAllocationParams * alloc_params, const GstVideoInfo * v_info, guint plane, const GstVideoAlignment * valign, GstGLTextureTarget target, GstGLFormat tex_format, gpointer wrapped_data, gpointer gl_handle, gpointer user_data, GDestroyNotify notify); GST_GL_API GstGLVideoAllocationParams * gst_gl_video_allocation_params_new (GstGLContext * context, const GstAllocationParams * alloc_params, const GstVideoInfo * v_info, guint plane, const GstVideoAlignment * valign, GstGLTextureTarget target, GstGLFormat tex_format); GST_GL_API GstGLVideoAllocationParams * gst_gl_video_allocation_params_new_wrapped_data (GstGLContext * context, const GstAllocationParams * alloc_params, const GstVideoInfo * v_info, guint plane, const GstVideoAlignment * valign, GstGLTextureTarget target, GstGLFormat tex_format, gpointer wrapped_data, gpointer user_data, GDestroyNotify notify); GST_GL_API GstGLVideoAllocationParams * gst_gl_video_allocation_params_new_wrapped_texture (GstGLContext * context, const GstAllocationParams * alloc_params, const GstVideoInfo * v_info, guint plane, const GstVideoAlignment * valign, GstGLTextureTarget target, GstGLFormat tex_format, guint tex_id, gpointer user_data, GDestroyNotify notify); GST_GL_API GstGLVideoAllocationParams * gst_gl_video_allocation_params_new_wrapped_gl_handle (GstGLContext * context, const GstAllocationParams * alloc_params, const GstVideoInfo * v_info, guint plane, const GstVideoAlignment * valign, GstGLTextureTarget target, GstGLFormat tex_format, gpointer gl_handle, gpointer user_data, GDestroyNotify notify); /* subclass usage */ GST_GL_API void gst_gl_video_allocation_params_free_data (GstGLVideoAllocationParams * params); /* subclass usage */ GST_GL_API void gst_gl_video_allocation_params_copy_data (GstGLVideoAllocationParams * src_vid, GstGLVideoAllocationParams * dest_vid); /** * GstGLMemoryAllocator * * Opaque #GstGLMemoryAllocator struct */ struct _GstGLMemoryAllocator { /*< private >*/ GstGLBaseMemoryAllocator parent; gpointer _padding[GST_PADDING]; }; /** * GstGLMemoryAllocatorClass: * @map: provide a custom map implementation * @copy: provide a custom copy implementation * @unmap: provide a custom unmap implementation */ struct _GstGLMemoryAllocatorClass { /*< private >*/ GstGLBaseMemoryAllocatorClass parent_class; /*< public >*/ GstGLBaseMemoryAllocatorMapFunction map; GstGLBaseMemoryAllocatorCopyFunction copy; GstGLBaseMemoryAllocatorUnmapFunction unmap; /*< private >*/ gpointer _padding[GST_PADDING]; }; #include /** * GST_GL_MEMORY_ALLOCATOR_NAME: * * The name of the GL memory allocator */ #define GST_GL_MEMORY_ALLOCATOR_NAME "GLMemory" /** * GST_TYPE_GL_MEMORY: * * Since: 1.20 * Deprecated: 1.22: This type has no use. */ #define GST_TYPE_GL_MEMORY (gst_gl_memory_get_type()) GST_GL_DEPRECATED GType gst_gl_memory_get_type(void); GST_GL_API void gst_gl_memory_init_once (void); GST_GL_API gboolean gst_is_gl_memory (GstMemory * mem); GST_GL_API void gst_gl_memory_init (GstGLMemory * mem, GstAllocator * allocator, GstMemory * parent, GstGLContext * context, GstGLTextureTarget target, GstGLFormat tex_format, const GstAllocationParams *params, const GstVideoInfo * info, guint plane, const GstVideoAlignment *valign, gpointer user_data, GDestroyNotify notify); GST_GL_API gboolean gst_gl_memory_copy_into (GstGLMemory *gl_mem, guint tex_id, GstGLTextureTarget target, GstGLFormat tex_format, gint width, gint height); GST_GL_API gboolean gst_gl_memory_copy_teximage (GstGLMemory * src, guint tex_id, GstGLTextureTarget out_target, GstGLFormat out_tex_format, gint out_width, gint out_height); GST_GL_API gboolean gst_gl_memory_read_pixels (GstGLMemory * gl_mem, gpointer write_pointer); GST_GL_API void gst_gl_memory_texsubimage (GstGLMemory * gl_mem, gpointer read_pointer); /* accessors */ GST_GL_API gint gst_gl_memory_get_texture_width (GstGLMemory * gl_mem); GST_GL_API gint gst_gl_memory_get_texture_height (GstGLMemory * gl_mem); GST_GL_API GstGLFormat gst_gl_memory_get_texture_format (GstGLMemory * gl_mem); GST_GL_API GstGLTextureTarget gst_gl_memory_get_texture_target (GstGLMemory * gl_mem); GST_GL_API guint gst_gl_memory_get_texture_id (GstGLMemory * gl_mem); GST_GL_API gboolean gst_gl_memory_setup_buffer (GstGLMemoryAllocator * allocator, GstBuffer * buffer, GstGLVideoAllocationParams * params, GstGLFormat *tex_formats, gpointer *wrapped_data, gsize n_wrapped_pointers); GST_GL_API GstGLMemoryAllocator * gst_gl_memory_allocator_get_default (GstGLContext *context); G_END_DECLS #endif /* _GST_GL_MEMORY_H_ */