allocators: move GstPhysMemoryAllocator abstraction from -bad to -base

This can be used in a generic way as common interface by all platforms
that, in one way or another, pass around physical memory addresses.

This is used by the gl lib and seems useful enough, so might just as
well move it next to the other allocators.

https://bugzilla.gnome.org/show_bug.cgi?id=779067
This commit is contained in:
Sebastian Dröge 2017-02-17 19:26:41 +02:00 committed by Tim-Philipp Müller
parent cdbb261d9c
commit 1aec533d21
4 changed files with 135 additions and 0 deletions

View file

@ -5,12 +5,14 @@ libgstallocators_@GST_API_VERSION@_includedir = $(includedir)/gstreamer-@GST_API
libgstallocators_@GST_API_VERSION@_include_HEADERS = \
allocators.h \
gstfdmemory.h \
gstphysmemory.h \
gstdmabuf.h
noinst_HEADERS =
libgstallocators_@GST_API_VERSION@_la_SOURCES = \
gstfdmemory.c \
gstphysmemory.c \
gstdmabuf.c
libgstallocators_@GST_API_VERSION@_la_LIBADD = $(GST_LIBS) $(LIBM)

View file

@ -24,6 +24,7 @@
#include <gst/allocators/gstdmabuf.h>
#include <gst/allocators/gstfdmemory.h>
#include <gst/allocators/gstphysmemory.h>
#endif /* __GST_ALLOCATORS_H__ */

View file

@ -0,0 +1,69 @@
/* GStreamer
* Copyright (C) 2017 Sebastian Dröge <sebastian@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., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
#ifdef HAVE_CONFIG_H
#include "config.h"
#endif
#include "gstphysmemory.h"
G_DEFINE_INTERFACE (GstPhysMemoryAllocator, gst_phys_memory_allocator,
GST_TYPE_ALLOCATOR);
static void
gst_phys_memory_allocator_default_init (GstPhysMemoryAllocatorInterface * iface)
{
}
/**
* gst_is_phys_memory:
* @mem: a #GstMemory
*
* Returns: whether the memory at @mem is backed by physical memory
*
* Since: 1.14
*/
gboolean
gst_is_phys_memory (GstMemory * mem)
{
return mem != NULL && mem->allocator != NULL
&& g_type_is_a (G_OBJECT_TYPE (mem->allocator),
GST_TYPE_PHYS_MEMORY_ALLOCATOR);
}
/**
* gst_phys_memory_get_phys_addr:
* @mem: a #GstMemory
*
* Returns: Physical memory address that is backing @mem, or 0 if none
*
* Since: 1.14
*/
guintptr
gst_phys_memory_get_phys_addr (GstMemory * mem)
{
GstPhysMemoryAllocatorInterface *iface;
g_return_val_if_fail (gst_is_phys_memory (mem), 0);
iface = GST_PHYS_MEMORY_ALLOCATOR_GET_INTERFACE (mem->allocator);
g_return_val_if_fail (iface->get_phys_addr != NULL, 0);
return iface->get_phys_addr ((GstPhysMemoryAllocator *) mem->allocator, mem);
}

View file

@ -0,0 +1,63 @@
/* GStreamer
* Copyright (C) 2017 Sebastian Dröge <sebastian@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., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
#ifndef __GST_PHYS_MEMORY_H__
#define __GST_PHYS_MEMORY_H__
#include <gst/gst.h>
G_BEGIN_DECLS
typedef struct _GstPhysMemoryAllocator GstPhysMemoryAllocator;
typedef struct _GstPhysMemoryAllocatorInterface GstPhysMemoryAllocatorInterface;
#define GST_TYPE_PHYS_MEMORY_ALLOCATOR (gst_phys_memory_allocator_get_type())
#define GST_IS_PHYS_MEMORY_ALLOCATOR(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GST_TYPE_PHYS_MEMORY_ALLOCATOR))
#define GST_IS_PHYS_MEMORY_ALLOCATOR_INTERFACE(iface) (G_TYPE_CHECK_INTERFACE_TYPE ((iface), GST_TYPE_PHYS_MEMORY_ALLOCATOR))
#define GST_PHYS_MEMORY_ALLOCATOR_GET_INTERFACE(obj) (G_TYPE_INSTANCE_GET_INTERFACE ((obj), GST_TYPE_PHYS_MEMORY_ALLOCATOR, GstPhysMemoryAllocatorInterface))
#define GST_PHYS_MEMORY_ALLOCATOR(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GST_TYPE_PHYS_MEMORY_ALLOCATOR, GstPhysMemoryAllocator))
#define GST_PHYS_MEMORY_ALLOCATOR_INTERFACE(iface) (G_TYPE_CHECK_INTERFACE_CAST ((iface), GST_TYPE_PHYS_MEMORY_ALLOCATOR, GstPhysMemoryAllocatorInterface))
#define GST_PHYS_MEMORY_ALLOCATOR_CAST(obj) ((GstPhysMemoryAllocator *)(obj))
/**
* GstPhysMemoryAllocatorInterface:
*
* Marker interface for allocators with physical address backed memory
*
* Since: 1.14
*/
struct _GstPhysMemoryAllocatorInterface
{
GTypeInterface parent_iface;
guintptr (*get_phys_addr) (GstPhysMemoryAllocator * allocator, GstMemory * mem);
};
GST_EXPORT
GType gst_phys_memory_allocator_get_type (void);
GST_EXPORT
gboolean gst_is_phys_memory (GstMemory *mem);
GST_EXPORT
guintptr gst_phys_memory_get_phys_addr (GstMemory * mem);
G_END_DECLS
#endif /* __GST_PHYS_MEMORY_H__ */