mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-09-08 13:18:52 +00:00
Except for gst/gl/gstglfuncs.h It is up to the client app to include these headers. It is coherent with the fact that gstreamer-gl.pc does not require any egl.pc/gles.pc. I.e. it is the responsability of the app to search these headers within its build setup. For example gstreamer-vaapi includes explicitly EGL/egl.h and search for it in its configure.ac. For example with this patch, if an app includes the headers gst/gl/egl/gstglcontext_egl.h gst/gl/egl/gstgldisplay_egl.h gst/gl/egl/gstglmemoryegl.h it will *no longer* automatically include EGL/egl.h and GLES2/gl2.h. Which is good because the app might want to use the gstgl api only without the need to bother about gl headers. Also added a test: cd tests/check && make libs/gstglheaders.check https://bugzilla.gnome.org/show_bug.cgi?id=784779
476 lines
14 KiB
C
476 lines
14 KiB
C
/*
|
|
* GStreamer
|
|
* Copyright (C) 2015 Matthew Waters <matthew@centricular.com>
|
|
*
|
|
* 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.
|
|
*/
|
|
|
|
#ifdef HAVE_CONFIG_H
|
|
#include "config.h"
|
|
#endif
|
|
|
|
#include <string.h>
|
|
|
|
#include "gstglrenderbuffer.h"
|
|
|
|
#include "gstglcontext.h"
|
|
#include "gstglfuncs.h"
|
|
#include "gstglmemory.h"
|
|
|
|
/**
|
|
* SECTION:gstglrenderbuffer
|
|
* @title: GstGLRenderBuffer
|
|
* @short_description: memory subclass for GL renderbuffer objects
|
|
* @see_also: #GstMemory, #GstAllocator
|
|
*
|
|
* GstGLRenderbuffer is a #GstGLBaseMemory subclass providing support for
|
|
* OpenGL renderbuffers.
|
|
*
|
|
* #GstGLRenderbuffer is created or wrapped through gst_gl_base_memory_alloc()
|
|
* with #GstGLRenderbufferAllocationParams.
|
|
*
|
|
* Since: 1.10
|
|
*/
|
|
|
|
#define USING_OPENGL(context) (gst_gl_context_check_gl_version (context, GST_GL_API_OPENGL, 1, 0))
|
|
#define USING_OPENGL3(context) (gst_gl_context_check_gl_version (context, GST_GL_API_OPENGL3, 3, 1))
|
|
#define USING_GLES(context) (gst_gl_context_check_gl_version (context, GST_GL_API_GLES, 1, 0))
|
|
#define USING_GLES2(context) (gst_gl_context_check_gl_version (context, GST_GL_API_GLES2, 2, 0))
|
|
#define USING_GLES3(context) (gst_gl_context_check_gl_version (context, GST_GL_API_GLES2, 3, 0))
|
|
|
|
static GstAllocator *_gl_renderbuffer_allocator;
|
|
|
|
GST_DEBUG_CATEGORY_STATIC (GST_CAT_GL_RENDERBUFFER);
|
|
#define GST_CAT_DEFAULT GST_CAT_GL_RENDERBUFFER
|
|
|
|
G_DEFINE_TYPE (GstGLRenderbufferAllocator, gst_gl_renderbuffer_allocator,
|
|
GST_TYPE_GL_BASE_MEMORY_ALLOCATOR);
|
|
|
|
static guint
|
|
_new_renderbuffer (GstGLContext * context, guint format, guint width,
|
|
guint height)
|
|
{
|
|
const GstGLFuncs *gl = context->gl_vtable;
|
|
guint rbo_id;
|
|
|
|
gl->GenRenderbuffers (1, &rbo_id);
|
|
gl->BindRenderbuffer (GL_RENDERBUFFER, rbo_id);
|
|
|
|
gl->RenderbufferStorage (GL_RENDERBUFFER, format, width, height);
|
|
|
|
gl->BindRenderbuffer (GL_RENDERBUFFER, 0);
|
|
|
|
return rbo_id;
|
|
}
|
|
|
|
static gboolean
|
|
_gl_rbo_create (GstGLRenderbuffer * gl_mem, GError ** error)
|
|
{
|
|
if (!gl_mem->renderbuffer_wrapped) {
|
|
GstGLContext *context = gl_mem->mem.context;
|
|
GLenum internal_format;
|
|
GLenum tex_format;
|
|
GLenum renderbuffer_type;
|
|
|
|
tex_format = gl_mem->renderbuffer_format;
|
|
renderbuffer_type = GL_UNSIGNED_BYTE;
|
|
if (gl_mem->renderbuffer_format == GST_GL_RGB565) {
|
|
tex_format = GST_GL_RGB;
|
|
renderbuffer_type = GL_UNSIGNED_SHORT_5_6_5;
|
|
}
|
|
|
|
internal_format =
|
|
gst_gl_sized_gl_format_from_gl_format_type (context, tex_format,
|
|
renderbuffer_type);
|
|
|
|
gl_mem->renderbuffer_id =
|
|
_new_renderbuffer (context, internal_format,
|
|
gst_gl_renderbuffer_get_width (gl_mem),
|
|
gst_gl_renderbuffer_get_height (gl_mem));
|
|
|
|
GST_CAT_TRACE (GST_CAT_GL_RENDERBUFFER, "Generating renderbuffer id:%u "
|
|
"format:%u dimensions:%ux%u", gl_mem->renderbuffer_id, internal_format,
|
|
gst_gl_renderbuffer_get_width (gl_mem),
|
|
gst_gl_renderbuffer_get_height (gl_mem));
|
|
}
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
static void
|
|
gst_gl_renderbuffer_init (GstGLRenderbuffer * mem, GstAllocator * allocator,
|
|
GstMemory * parent, GstGLContext * context,
|
|
GstGLFormat renderbuffer_format, GstAllocationParams * params,
|
|
guint width, guint height, gpointer user_data, GDestroyNotify notify)
|
|
{
|
|
gsize size;
|
|
guint tex_type;
|
|
|
|
tex_type = GL_UNSIGNED_BYTE;
|
|
if (renderbuffer_format == GST_GL_RGB565)
|
|
tex_type = GL_UNSIGNED_SHORT_5_6_5;
|
|
size =
|
|
gst_gl_format_type_n_bytes (renderbuffer_format,
|
|
tex_type) * width * height;
|
|
|
|
mem->renderbuffer_format = renderbuffer_format;
|
|
mem->width = width;
|
|
mem->height = height;
|
|
|
|
gst_gl_base_memory_init ((GstGLBaseMemory *) mem, allocator, parent, context,
|
|
params, size, user_data, notify);
|
|
|
|
GST_CAT_DEBUG (GST_CAT_GL_RENDERBUFFER, "new GL renderbuffer context:%"
|
|
GST_PTR_FORMAT " memory:%p format:%u dimensions:%ux%u ", context, mem,
|
|
mem->renderbuffer_format, gst_gl_renderbuffer_get_width (mem),
|
|
gst_gl_renderbuffer_get_height (mem));
|
|
}
|
|
|
|
static gpointer
|
|
_gl_rbo_map (GstGLRenderbuffer * gl_mem, GstMapInfo * info, gsize maxsize)
|
|
{
|
|
GST_CAT_WARNING (GST_CAT_GL_RENDERBUFFER, "Renderbuffer's cannot be mapped");
|
|
|
|
return NULL;
|
|
}
|
|
|
|
static void
|
|
_gl_rbo_unmap (GstGLRenderbuffer * gl_mem, GstMapInfo * info)
|
|
{
|
|
}
|
|
|
|
static GstMemory *
|
|
_gl_rbo_copy (GstGLRenderbuffer * src, gssize offset, gssize size)
|
|
{
|
|
GST_CAT_WARNING (GST_CAT_GL_RENDERBUFFER, "Renderbuffer's cannot be copied");
|
|
|
|
return NULL;
|
|
}
|
|
|
|
static GstMemory *
|
|
_gl_rbo_alloc (GstAllocator * allocator, gsize size,
|
|
GstAllocationParams * params)
|
|
{
|
|
g_warning ("Use gst_gl_base_memory_alloc to allocate from this allocator");
|
|
|
|
return NULL;
|
|
}
|
|
|
|
static void
|
|
_gl_rbo_destroy (GstGLRenderbuffer * gl_mem)
|
|
{
|
|
const GstGLFuncs *gl = gl_mem->mem.context->gl_vtable;
|
|
|
|
if (gl_mem->renderbuffer_id && !gl_mem->renderbuffer_wrapped)
|
|
gl->DeleteRenderbuffers (1, &gl_mem->renderbuffer_id);
|
|
}
|
|
|
|
static GstGLRenderbuffer *
|
|
_default_gl_rbo_alloc (GstGLRenderbufferAllocator * allocator,
|
|
GstGLRenderbufferAllocationParams * params)
|
|
{
|
|
guint alloc_flags = params->parent.alloc_flags;
|
|
GstGLRenderbuffer *mem;
|
|
|
|
g_return_val_if_fail ((alloc_flags &
|
|
GST_GL_ALLOCATION_PARAMS_ALLOC_FLAG_WRAP_SYSMEM) == 0, NULL);
|
|
|
|
mem = g_new0 (GstGLRenderbuffer, 1);
|
|
|
|
if (alloc_flags & GST_GL_ALLOCATION_PARAMS_ALLOC_FLAG_WRAP_GPU_HANDLE) {
|
|
mem->renderbuffer_id = GPOINTER_TO_UINT (params->parent.gl_handle);
|
|
mem->renderbuffer_wrapped = TRUE;
|
|
}
|
|
|
|
gst_gl_renderbuffer_init (mem, GST_ALLOCATOR_CAST (allocator), NULL,
|
|
params->parent.context, params->renderbuffer_format,
|
|
params->parent.alloc_params, params->width, params->height,
|
|
params->parent.user_data, params->parent.notify);
|
|
|
|
return mem;
|
|
}
|
|
|
|
static void
|
|
gst_gl_renderbuffer_allocator_class_init (GstGLRenderbufferAllocatorClass *
|
|
klass)
|
|
{
|
|
GstGLBaseMemoryAllocatorClass *gl_base;
|
|
GstAllocatorClass *allocator_class;
|
|
|
|
gl_base = (GstGLBaseMemoryAllocatorClass *) klass;
|
|
allocator_class = (GstAllocatorClass *) klass;
|
|
|
|
gl_base->alloc =
|
|
(GstGLBaseMemoryAllocatorAllocFunction) _default_gl_rbo_alloc;
|
|
gl_base->create = (GstGLBaseMemoryAllocatorCreateFunction) _gl_rbo_create;
|
|
gl_base->destroy = (GstGLBaseMemoryAllocatorDestroyFunction) _gl_rbo_destroy;
|
|
|
|
allocator_class->alloc = _gl_rbo_alloc;
|
|
}
|
|
|
|
static void
|
|
gst_gl_renderbuffer_allocator_init (GstGLRenderbufferAllocator * allocator)
|
|
{
|
|
GstAllocator *alloc = GST_ALLOCATOR_CAST (allocator);
|
|
|
|
alloc->mem_type = GST_GL_RENDERBUFFER_ALLOCATOR_NAME;
|
|
|
|
alloc->mem_map_full = (GstMemoryMapFullFunction) _gl_rbo_map;
|
|
alloc->mem_unmap_full = (GstMemoryUnmapFullFunction) _gl_rbo_unmap;
|
|
alloc->mem_copy = (GstMemoryCopyFunction) _gl_rbo_copy;
|
|
|
|
GST_OBJECT_FLAG_SET (allocator, GST_ALLOCATOR_FLAG_CUSTOM_ALLOC);
|
|
}
|
|
|
|
/**
|
|
* gst_gl_renderbuffer_get_width:
|
|
* @gl_mem: a #GstGLRenderbuffer
|
|
*
|
|
* Returns: the configured width of @gl_mem
|
|
*
|
|
* Since: 1.10
|
|
*/
|
|
gint
|
|
gst_gl_renderbuffer_get_width (GstGLRenderbuffer * gl_mem)
|
|
{
|
|
g_return_val_if_fail (gst_is_gl_renderbuffer ((GstMemory *) gl_mem), 0);
|
|
|
|
return gl_mem->width;
|
|
}
|
|
|
|
/**
|
|
* gst_gl_renderbuffer_get_height:
|
|
* @gl_mem: a #GstGLRenderbuffer
|
|
*
|
|
* Returns: the configured height of @gl_mem
|
|
*
|
|
* Since: 1.10
|
|
*/
|
|
gint
|
|
gst_gl_renderbuffer_get_height (GstGLRenderbuffer * gl_mem)
|
|
{
|
|
g_return_val_if_fail (gst_is_gl_renderbuffer ((GstMemory *) gl_mem), 0);
|
|
|
|
return gl_mem->height;
|
|
}
|
|
|
|
/**
|
|
* gst_gl_renderbuffer_get_format:
|
|
* @gl_mem: a #GstGLRenderbuffer
|
|
*
|
|
* Returns: the #GstGLFormat of @gl_mem
|
|
*
|
|
* Since: 1.12
|
|
*/
|
|
GstGLFormat
|
|
gst_gl_renderbuffer_get_format (GstGLRenderbuffer * gl_mem)
|
|
{
|
|
g_return_val_if_fail (gst_is_gl_renderbuffer ((GstMemory *) gl_mem), 0);
|
|
|
|
return gl_mem->renderbuffer_format;
|
|
}
|
|
|
|
/**
|
|
* gst_gl_renderbuffer_get_id:
|
|
* @gl_mem: a #GstGLRenderbuffer
|
|
*
|
|
* Returns: the OpenGL renderbuffer handle of @gl_mem
|
|
*
|
|
* Since: 1.10
|
|
*/
|
|
guint
|
|
gst_gl_renderbuffer_get_id (GstGLRenderbuffer * gl_mem)
|
|
{
|
|
g_return_val_if_fail (gst_is_gl_renderbuffer ((GstMemory *) gl_mem), 0);
|
|
|
|
return gl_mem->renderbuffer_id;
|
|
}
|
|
|
|
/**
|
|
* gst_gl_renderbuffer_init_once:
|
|
*
|
|
* Initializes the GL Base Texture allocator. It is safe to call this function
|
|
* multiple times. This must be called before any other GstGLRenderbuffer operation.
|
|
*
|
|
* Since: 1.10
|
|
*/
|
|
void
|
|
gst_gl_renderbuffer_init_once (void)
|
|
{
|
|
static volatile gsize _init = 0;
|
|
|
|
if (g_once_init_enter (&_init)) {
|
|
gst_gl_base_memory_init_once ();
|
|
|
|
GST_DEBUG_CATEGORY_INIT (GST_CAT_GL_RENDERBUFFER, "glrenderbuffermemory", 0,
|
|
"OpenGL Renderbuffer memory");
|
|
|
|
_gl_renderbuffer_allocator =
|
|
g_object_new (GST_TYPE_GL_RENDERBUFFER_ALLOCATOR, NULL);
|
|
gst_object_ref_sink (_gl_renderbuffer_allocator);
|
|
GST_OBJECT_FLAG_SET (_gl_renderbuffer_allocator,
|
|
GST_OBJECT_FLAG_MAY_BE_LEAKED);
|
|
|
|
gst_allocator_register (GST_GL_RENDERBUFFER_ALLOCATOR_NAME,
|
|
_gl_renderbuffer_allocator);
|
|
|
|
g_once_init_leave (&_init, 1);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* gst_is_gl_renderbuffer:
|
|
* @mem:a #GstMemory
|
|
*
|
|
* Returns: whether the memory at @mem is a #GstGLRenderbuffer
|
|
*
|
|
* Since: 1.10
|
|
*/
|
|
gboolean
|
|
gst_is_gl_renderbuffer (GstMemory * mem)
|
|
{
|
|
return mem != NULL && mem->allocator != NULL
|
|
&& g_type_is_a (G_OBJECT_TYPE (mem->allocator),
|
|
GST_TYPE_GL_RENDERBUFFER_ALLOCATOR);
|
|
}
|
|
|
|
G_DEFINE_BOXED_TYPE (GstGLRenderbufferAllocationParams,
|
|
gst_gl_renderbuffer_allocation_params,
|
|
(GBoxedCopyFunc) gst_gl_allocation_params_copy,
|
|
(GBoxedFreeFunc) gst_gl_allocation_params_free);
|
|
|
|
static void
|
|
_gst_gl_rb_alloc_params_free_data (GstGLRenderbufferAllocationParams * params)
|
|
{
|
|
gst_gl_allocation_params_free_data (¶ms->parent);
|
|
}
|
|
|
|
static void
|
|
_gst_gl_rb_alloc_params_copy_data (GstGLRenderbufferAllocationParams * src_vid,
|
|
GstGLRenderbufferAllocationParams * dest_vid)
|
|
{
|
|
GstGLAllocationParams *src = (GstGLAllocationParams *) src_vid;
|
|
GstGLAllocationParams *dest = (GstGLAllocationParams *) dest_vid;
|
|
|
|
gst_gl_allocation_params_copy_data (src, dest);
|
|
|
|
dest_vid->renderbuffer_format = src_vid->renderbuffer_format;
|
|
dest_vid->width = src_vid->width;
|
|
dest_vid->height = src_vid->height;
|
|
}
|
|
|
|
static gboolean
|
|
_gst_gl_renderbuffer_allocation_params_init_full
|
|
(GstGLRenderbufferAllocationParams * params, gsize struct_size,
|
|
guint alloc_flags, GstGLAllocationParamsCopyFunc copy,
|
|
GstGLAllocationParamsFreeFunc free, GstGLContext * context,
|
|
GstAllocationParams * alloc_params, guint width, guint height,
|
|
GstGLFormat renderbuffer_format, gpointer wrapped_data,
|
|
gpointer gl_handle, gpointer user_data, GDestroyNotify notify)
|
|
{
|
|
g_return_val_if_fail (params != NULL, FALSE);
|
|
g_return_val_if_fail (copy != NULL, FALSE);
|
|
g_return_val_if_fail (free != NULL, FALSE);
|
|
g_return_val_if_fail (GST_IS_GL_CONTEXT (context), FALSE);
|
|
|
|
memset (params, 0, sizeof (*params));
|
|
|
|
if (!gst_gl_allocation_params_init ((GstGLAllocationParams *) params,
|
|
struct_size, alloc_flags, copy, free, context, 0, alloc_params,
|
|
wrapped_data, gl_handle, user_data, notify))
|
|
return FALSE;
|
|
|
|
params->renderbuffer_format = renderbuffer_format;
|
|
params->width = width;
|
|
params->height = height;
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
/**
|
|
* gst_gl_renderbuffer_allocation_params_new:
|
|
* @context: a #GstGLContext
|
|
* @alloc_params: (allow-none): the #GstAllocationParams for sysmem mappings of the texture
|
|
* @width: the width of the renderbuffer
|
|
* @height: the height of the renderbuffer
|
|
* @renderbuffer_format: the #GstGLFormat for the created textures
|
|
*
|
|
* Returns: a new #GstGLRenderbufferAllocationParams for allocating #GstGLRenderbuffer's
|
|
*
|
|
* Since: 1.10
|
|
*/
|
|
GstGLRenderbufferAllocationParams *
|
|
gst_gl_renderbuffer_allocation_params_new (GstGLContext * context,
|
|
GstAllocationParams * alloc_params, GstGLFormat renderbuffer_format,
|
|
guint width, guint height)
|
|
{
|
|
GstGLRenderbufferAllocationParams *params =
|
|
g_new0 (GstGLRenderbufferAllocationParams, 1);
|
|
|
|
if (!_gst_gl_renderbuffer_allocation_params_init_full (params,
|
|
sizeof (GstGLRenderbufferAllocationParams),
|
|
GST_GL_ALLOCATION_PARAMS_ALLOC_FLAG_ALLOC |
|
|
GST_GL_ALLOCATION_PARAMS_ALLOC_FLAG_VIDEO,
|
|
(GstGLAllocationParamsCopyFunc) _gst_gl_rb_alloc_params_copy_data,
|
|
(GstGLAllocationParamsFreeFunc) _gst_gl_rb_alloc_params_free_data,
|
|
context, alloc_params, width, height, renderbuffer_format, NULL, 0,
|
|
NULL, NULL)) {
|
|
g_free (params);
|
|
return NULL;
|
|
}
|
|
|
|
return params;
|
|
}
|
|
|
|
/**
|
|
* gst_gl_renderbuffer_allocation_params_new_wrapped:
|
|
* @context: a #GstGLContext
|
|
* @alloc_params: (allow-none): the #GstAllocationParams for @tex_id
|
|
* @width: the width of the renderbuffer
|
|
* @height: the height of the renderbuffer
|
|
* @renderbuffer_format: the #GstGLFormat for @tex_id
|
|
* @gl_handle: the GL handle to wrap
|
|
* @user_data: (allow-none): user data to call @notify with
|
|
* @notify: (allow-none): a #GDestroyNotify
|
|
*
|
|
* Returns: a new #GstGLRenderbufferAllocationParams for wrapping @gl_handle as a
|
|
* renderbuffer
|
|
*
|
|
* Since: 1.10
|
|
*/
|
|
GstGLRenderbufferAllocationParams *
|
|
gst_gl_renderbuffer_allocation_params_new_wrapped (GstGLContext * context,
|
|
GstAllocationParams * alloc_params, GstGLFormat renderbuffer_format,
|
|
guint width, guint height, gpointer gl_handle, gpointer user_data,
|
|
GDestroyNotify notify)
|
|
{
|
|
GstGLRenderbufferAllocationParams *params =
|
|
g_new0 (GstGLRenderbufferAllocationParams, 1);
|
|
|
|
if (!_gst_gl_renderbuffer_allocation_params_init_full (params,
|
|
sizeof (GstGLRenderbufferAllocationParams),
|
|
GST_GL_ALLOCATION_PARAMS_ALLOC_FLAG_WRAP_GPU_HANDLE |
|
|
GST_GL_ALLOCATION_PARAMS_ALLOC_FLAG_VIDEO,
|
|
(GstGLAllocationParamsCopyFunc) _gst_gl_rb_alloc_params_copy_data,
|
|
(GstGLAllocationParamsFreeFunc) _gst_gl_rb_alloc_params_free_data,
|
|
context, alloc_params, width, height, renderbuffer_format, NULL,
|
|
gl_handle, user_data, notify)) {
|
|
g_free (params);
|
|
return NULL;
|
|
}
|
|
|
|
return params;
|
|
}
|