mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-09-08 13:18:52 +00:00
According with gi annotations [1] the "optional" annotation must be only for (out) or (inout) parameters. 1. https://gi.readthedocs.io/en/latest/annotations/giannotations.html Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/4244>
341 lines
8.4 KiB
C
341 lines
8.4 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 "gstvkqueue.h"
|
|
|
|
/**
|
|
* SECTION:vkqueue
|
|
* @title: GstVulkanQueue
|
|
* @short_description: Vulkan command queue
|
|
* @see_also: #GstVulkanDevice
|
|
*
|
|
* GstVulkanQueue encapsulates the vulkan command queue.
|
|
*/
|
|
|
|
#define GST_CAT_DEFAULT gst_vulkan_queue_debug
|
|
GST_DEBUG_CATEGORY (GST_CAT_DEFAULT);
|
|
GST_DEBUG_CATEGORY_STATIC (GST_CAT_CONTEXT);
|
|
|
|
static void
|
|
_init_debug (void)
|
|
{
|
|
static gsize init;
|
|
|
|
if (g_once_init_enter (&init)) {
|
|
GST_DEBUG_CATEGORY_INIT (GST_CAT_DEFAULT, "vulkanqueue", 0, "Vulkan Queue");
|
|
GST_DEBUG_CATEGORY_GET (GST_CAT_CONTEXT, "GST_CONTEXT");
|
|
g_once_init_leave (&init, 1);
|
|
}
|
|
}
|
|
|
|
struct _GstVulkanQueuePrivate
|
|
{
|
|
GMutex submit_lock;
|
|
};
|
|
|
|
#define parent_class gst_vulkan_queue_parent_class
|
|
G_DEFINE_TYPE_WITH_CODE (GstVulkanQueue, gst_vulkan_queue, GST_TYPE_OBJECT,
|
|
G_ADD_PRIVATE (GstVulkanQueue); _init_debug ());
|
|
|
|
#define GET_PRIV(queue) gst_vulkan_queue_get_instance_private (queue)
|
|
|
|
static void gst_vulkan_queue_dispose (GObject * object);
|
|
|
|
static void
|
|
gst_vulkan_queue_init (GstVulkanQueue * queue)
|
|
{
|
|
GstVulkanQueuePrivate *priv = GET_PRIV (queue);
|
|
|
|
g_mutex_init (&priv->submit_lock);
|
|
}
|
|
|
|
static void
|
|
gst_vulkan_queue_class_init (GstVulkanQueueClass * queue_class)
|
|
{
|
|
GObjectClass *gobject_class = (GObjectClass *) queue_class;
|
|
|
|
gobject_class->dispose = gst_vulkan_queue_dispose;
|
|
}
|
|
|
|
static void
|
|
gst_vulkan_queue_dispose (GObject * object)
|
|
{
|
|
GstVulkanQueue *queue = GST_VULKAN_QUEUE (object);
|
|
GstVulkanQueuePrivate *priv = GET_PRIV (queue);
|
|
|
|
if (queue->device)
|
|
gst_object_unref (queue->device);
|
|
queue->device = NULL;
|
|
|
|
g_mutex_clear (&priv->submit_lock);
|
|
|
|
G_OBJECT_CLASS (parent_class)->dispose (object);
|
|
}
|
|
|
|
/**
|
|
* gst_vulkan_queue_get_device
|
|
* @queue: a #GstVulkanQueue
|
|
*
|
|
* Returns: (transfer full) (nullable): the #GstVulkanDevice for @queue
|
|
*
|
|
* Since: 1.18
|
|
*/
|
|
GstVulkanDevice *
|
|
gst_vulkan_queue_get_device (GstVulkanQueue * queue)
|
|
{
|
|
g_return_val_if_fail (GST_IS_VULKAN_QUEUE (queue), NULL);
|
|
|
|
return gst_object_ref (queue->device);
|
|
}
|
|
|
|
/**
|
|
* gst_vulkan_queue_create_command_pool:
|
|
* @queue: a #GstVulkanQueue
|
|
* @error: (out) (optional): a #GError
|
|
*
|
|
* Returns: (transfer full): a new #GstVulkanCommandPool or %NULL
|
|
*
|
|
* Since: 1.18
|
|
*/
|
|
GstVulkanCommandPool *
|
|
gst_vulkan_queue_create_command_pool (GstVulkanQueue * queue, GError ** error)
|
|
{
|
|
GstVulkanCommandPool *pool;
|
|
VkCommandPoolCreateInfo cmd_pool_info = { 0, };
|
|
VkCommandPool vk_pool;
|
|
VkResult err;
|
|
|
|
g_return_val_if_fail (GST_IS_VULKAN_QUEUE (queue), NULL);
|
|
|
|
cmd_pool_info.sType = VK_STRUCTURE_TYPE_COMMAND_POOL_CREATE_INFO;
|
|
cmd_pool_info.pNext = NULL;
|
|
cmd_pool_info.queueFamilyIndex = queue->family;
|
|
cmd_pool_info.flags = VK_COMMAND_POOL_CREATE_RESET_COMMAND_BUFFER_BIT;
|
|
|
|
GST_OBJECT_LOCK (queue->device);
|
|
err =
|
|
vkCreateCommandPool (queue->device->device, &cmd_pool_info, NULL,
|
|
&vk_pool);
|
|
if (gst_vulkan_error_to_g_error (err, error, "vkCreateCommandPool") < 0) {
|
|
GST_OBJECT_LOCK (queue->device);
|
|
goto error;
|
|
}
|
|
GST_OBJECT_UNLOCK (queue->device);
|
|
|
|
pool = g_object_new (GST_TYPE_VULKAN_COMMAND_POOL, NULL);
|
|
gst_object_ref_sink (pool);
|
|
pool->queue = gst_object_ref (queue);
|
|
pool->pool = vk_pool;
|
|
|
|
return pool;
|
|
|
|
error:
|
|
return NULL;
|
|
}
|
|
|
|
/**
|
|
* gst_context_set_vulkan_queue:
|
|
* @context: a #GstContext
|
|
* @queue: a #GstVulkanQueue
|
|
*
|
|
* Sets @queue on @context
|
|
*
|
|
* Since: 1.18
|
|
*/
|
|
void
|
|
gst_context_set_vulkan_queue (GstContext * context, GstVulkanQueue * queue)
|
|
{
|
|
GstStructure *s;
|
|
|
|
g_return_if_fail (context != NULL);
|
|
g_return_if_fail (gst_context_is_writable (context));
|
|
|
|
if (queue)
|
|
GST_CAT_LOG (GST_CAT_CONTEXT,
|
|
"setting GstVulkanQueue(%" GST_PTR_FORMAT ") on context(%"
|
|
GST_PTR_FORMAT ")", queue, context);
|
|
|
|
s = gst_context_writable_structure (context);
|
|
gst_structure_set (s, GST_VULKAN_QUEUE_CONTEXT_TYPE_STR,
|
|
GST_TYPE_VULKAN_QUEUE, queue, NULL);
|
|
}
|
|
|
|
/**
|
|
* gst_context_get_vulkan_queue:
|
|
* @context: a #GstContext
|
|
* @queue: resulting #GstVulkanQueue
|
|
*
|
|
* Returns: Whether @queue was in @context
|
|
*
|
|
* Since: 1.18
|
|
*/
|
|
gboolean
|
|
gst_context_get_vulkan_queue (GstContext * context, GstVulkanQueue ** queue)
|
|
{
|
|
const GstStructure *s;
|
|
gboolean ret;
|
|
|
|
g_return_val_if_fail (queue != NULL, FALSE);
|
|
g_return_val_if_fail (context != NULL, FALSE);
|
|
|
|
s = gst_context_get_structure (context);
|
|
ret = gst_structure_get (s, GST_VULKAN_QUEUE_CONTEXT_TYPE_STR,
|
|
GST_TYPE_VULKAN_QUEUE, queue, NULL);
|
|
|
|
GST_CAT_LOG (GST_CAT_CONTEXT, "got GstVulkanQueue(%" GST_PTR_FORMAT
|
|
") from context(%" GST_PTR_FORMAT ")", *queue, context);
|
|
|
|
return ret;
|
|
}
|
|
|
|
/**
|
|
* gst_vulkan_queue_handle_context_query:
|
|
* @element: a #GstElement
|
|
* @query: a #GstQuery of type #GST_QUERY_CONTEXT
|
|
* @queue: (nullable): the #GstVulkanQueue
|
|
*
|
|
* If a #GstVulkanQueue is requested in @query, sets @queue as the reply.
|
|
*
|
|
* Intended for use with element query handlers to respond to #GST_QUERY_CONTEXT
|
|
* for a #GstVulkanQueue.
|
|
*
|
|
* Returns: whether @query was responded to with @queue
|
|
*
|
|
* Since: 1.18
|
|
*/
|
|
gboolean
|
|
gst_vulkan_queue_handle_context_query (GstElement * element, GstQuery * query,
|
|
GstVulkanQueue * queue)
|
|
{
|
|
gboolean res = FALSE;
|
|
const gchar *context_type;
|
|
GstContext *context, *old_context;
|
|
|
|
g_return_val_if_fail (element != NULL, FALSE);
|
|
g_return_val_if_fail (query != NULL, FALSE);
|
|
g_return_val_if_fail (GST_QUERY_TYPE (query) == GST_QUERY_CONTEXT, FALSE);
|
|
|
|
if (!queue)
|
|
return FALSE;
|
|
|
|
gst_query_parse_context_type (query, &context_type);
|
|
|
|
if (g_strcmp0 (context_type, GST_VULKAN_QUEUE_CONTEXT_TYPE_STR) == 0) {
|
|
gst_query_parse_context (query, &old_context);
|
|
|
|
if (old_context)
|
|
context = gst_context_copy (old_context);
|
|
else
|
|
context = gst_context_new (GST_VULKAN_QUEUE_CONTEXT_TYPE_STR, TRUE);
|
|
|
|
gst_context_set_vulkan_queue (context, queue);
|
|
gst_query_set_context (query, context);
|
|
gst_context_unref (context);
|
|
|
|
res = queue != NULL;
|
|
}
|
|
|
|
return res;
|
|
}
|
|
|
|
/**
|
|
* gst_vulkan_queue_run_context_query:
|
|
* @element: a #GstElement
|
|
* @queue: (inout): a #GstVulkanQueue
|
|
*
|
|
* Attempt to retrieve a #GstVulkanQueue using #GST_QUERY_CONTEXT from the
|
|
* surrounding elements of @element.
|
|
*
|
|
* Returns: whether @queue contains a valid #GstVulkanQueue
|
|
*
|
|
* Since: 1.18
|
|
*/
|
|
gboolean
|
|
gst_vulkan_queue_run_context_query (GstElement * element,
|
|
GstVulkanQueue ** queue)
|
|
{
|
|
GstQuery *query;
|
|
|
|
g_return_val_if_fail (GST_IS_ELEMENT (element), FALSE);
|
|
g_return_val_if_fail (queue != NULL, FALSE);
|
|
|
|
_init_debug ();
|
|
|
|
if (*queue && GST_IS_VULKAN_QUEUE (*queue))
|
|
return TRUE;
|
|
|
|
if ((query =
|
|
gst_vulkan_local_context_query (element,
|
|
GST_VULKAN_QUEUE_CONTEXT_TYPE_STR))) {
|
|
GstContext *context;
|
|
|
|
gst_query_parse_context (query, &context);
|
|
if (context)
|
|
gst_context_get_vulkan_queue (context, queue);
|
|
|
|
gst_query_unref (query);
|
|
}
|
|
|
|
GST_DEBUG_OBJECT (element, "found queue %p", *queue);
|
|
|
|
if (*queue)
|
|
return TRUE;
|
|
|
|
return FALSE;
|
|
}
|
|
|
|
/**
|
|
* gst_vulkan_queue_submit_lock:
|
|
* @queue: a #GstVulkanQueue
|
|
*
|
|
* Locks the queue for command submission using `vkQueueSubmit()` to meet the
|
|
* Vulkan requirements for externally synchronised resources.
|
|
*
|
|
* Since: 1.18
|
|
*/
|
|
void
|
|
gst_vulkan_queue_submit_lock (GstVulkanQueue * queue)
|
|
{
|
|
GstVulkanQueuePrivate *priv = GET_PRIV (queue);
|
|
|
|
g_mutex_lock (&priv->submit_lock);
|
|
}
|
|
|
|
/**
|
|
* gst_vulkan_queue_submit_unlock:
|
|
* @queue: a #GstVulkanQueue
|
|
*
|
|
* Unlocks the queue for command submission using `vkQueueSubmit()`.
|
|
*
|
|
* See gst_vulkan_queue_submit_lock() for details on when this call is needed.
|
|
*
|
|
* Since: 1.18
|
|
*/
|
|
void
|
|
gst_vulkan_queue_submit_unlock (GstVulkanQueue * queue)
|
|
{
|
|
GstVulkanQueuePrivate *priv = GET_PRIV (queue);
|
|
|
|
g_mutex_unlock (&priv->submit_lock);
|
|
}
|