vulkan: add download element
authorMatthew Waters <matthew@centricular.com>
Thu, 13 Jun 2019 07:05:44 +0000 (17:05 +1000)
committerMatthew Waters <matthew@centricular.com>
Wed, 19 Jun 2019 15:41:56 +0000 (01:41 +1000)
Currently only downloads images into a host-visible buffer and
synchronises immediately.

ext/vulkan/gstvulkan.c
ext/vulkan/meson.build
ext/vulkan/vkdownload.c [new file with mode: 0644]
ext/vulkan/vkdownload.h [new file with mode: 0644]

index 3d7cecf..4fdaba2 100644 (file)
@@ -32,6 +32,7 @@
 #include "vksink.h"
 #include "vkupload.h"
 #include "vkimageidentity.h"
+#include "vkdownload.h"
 
 #define GST_CAT_DEFAULT gst_vulkan_debug
 GST_DEBUG_CATEGORY_STATIC (GST_CAT_DEFAULT);
@@ -51,6 +52,11 @@ plugin_init (GstPlugin * plugin)
     return FALSE;
   }
 
+  if (!gst_element_register (plugin, "vulkandownload",
+          GST_RANK_NONE, GST_TYPE_VULKAN_DOWNLOAD)) {
+    return FALSE;
+  }
+
   if (!gst_element_register (plugin, "vulkanimageidentity",
           GST_RANK_NONE, GST_TYPE_VULKAN_IMAGE_IDENTITY)) {
     return FALSE;
index 99b2b37..b45ee63 100644 (file)
@@ -10,6 +10,7 @@ subdir('shaders')
 
 vulkan_sources = [
   'gstvulkan.c',
+  'vkdownload.c',
   'vkfullscreenrender.c',
   'vkimageidentity.c',
   'vksink.c',
diff --git a/ext/vulkan/vkdownload.c b/ext/vulkan/vkdownload.c
new file mode 100644 (file)
index 0000000..d07101e
--- /dev/null
@@ -0,0 +1,880 @@
+/*
+ * GStreamer
+ * Copyright (C) 2019 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.
+ */
+
+/**
+ * SECTION:element-vulkandownload
+ * @title: vulkandownload
+ *
+ * vulkandownload downloads data into Vulkan memory objects.
+ */
+
+#ifdef HAVE_CONFIG_H
+#include "config.h"
+#endif
+
+#include <string.h>
+
+#include "vkdownload.h"
+#include "vktrash.h"
+
+GST_DEBUG_CATEGORY (gst_debug_vulkan_download);
+#define GST_CAT_DEFAULT gst_debug_vulkan_download
+
+static GstCaps *
+_set_caps_features_with_passthrough (const GstCaps * caps,
+    const gchar * feature_name, GstCapsFeatures * passthrough)
+{
+  guint i, j, m, n;
+  GstCaps *tmp;
+
+  tmp = gst_caps_copy (caps);
+
+  n = gst_caps_get_size (caps);
+  for (i = 0; i < n; i++) {
+    GstCapsFeatures *features, *orig_features;
+
+    orig_features = gst_caps_get_features (caps, i);
+    features = gst_caps_features_new (feature_name, NULL);
+
+    m = gst_caps_features_get_size (orig_features);
+    for (j = 0; j < m; j++) {
+      const gchar *feature = gst_caps_features_get_nth (orig_features, j);
+
+      /* if we already have the features */
+      if (gst_caps_features_contains (features, feature))
+        continue;
+
+      if (g_strcmp0 (feature, GST_CAPS_FEATURE_MEMORY_SYSTEM_MEMORY) == 0)
+        continue;
+
+      if (passthrough && gst_caps_features_contains (passthrough, feature)) {
+        gst_caps_features_add (features, feature);
+      }
+    }
+
+    gst_caps_set_features (tmp, i, features);
+  }
+
+  return tmp;
+}
+
+struct ImageToRawDownload
+{
+  GstVulkanDownload *download;
+
+  GstVideoInfo in_info;
+  GstVideoInfo out_info;
+
+  GstBufferPool *pool;
+  gboolean pool_active;
+
+  GstVulkanCommandPool *cmd_pool;
+  GList *trash_list;
+};
+
+static gpointer
+_image_to_raw_new_impl (GstVulkanDownload * download)
+{
+  struct ImageToRawDownload *raw = g_new0 (struct ImageToRawDownload, 1);
+
+  raw->download = download;
+
+  return raw;
+}
+
+static GstCaps *
+_image_to_raw_transform_caps (gpointer impl, GstPadDirection direction,
+    GstCaps * caps)
+{
+  GstCaps *ret;
+
+  if (direction == GST_PAD_SINK) {
+    ret =
+        _set_caps_features_with_passthrough (caps,
+        GST_CAPS_FEATURE_MEMORY_SYSTEM_MEMORY, NULL);
+  } else {
+    ret =
+        _set_caps_features_with_passthrough (caps,
+        GST_CAPS_FEATURE_MEMORY_VULKAN_IMAGE, NULL);
+  }
+
+  return ret;
+}
+
+static gboolean
+_image_to_raw_set_caps (gpointer impl, GstCaps * in_caps, GstCaps * out_caps)
+{
+  struct ImageToRawDownload *raw = impl;
+
+  if (!gst_video_info_from_caps (&raw->in_info, in_caps))
+    return FALSE;
+
+  if (!gst_video_info_from_caps (&raw->out_info, out_caps))
+    return FALSE;
+
+  return TRUE;
+}
+
+static void
+_image_to_raw_propose_allocation (gpointer impl, GstQuery * decide_query,
+    GstQuery * query)
+{
+  /* FIXME: implement */
+}
+
+static GstFlowReturn
+_image_to_raw_perform (gpointer impl, GstBuffer * inbuf, GstBuffer ** outbuf)
+{
+  struct ImageToRawDownload *raw = impl;
+  VkCommandBuffer cmd;
+  GError *error = NULL;
+  GstFlowReturn ret;
+  VkResult err;
+  int i;
+
+  if (!raw->cmd_pool) {
+    if (!(raw->cmd_pool =
+            gst_vulkan_queue_create_command_pool (raw->download->queue,
+                &error))) {
+      goto error;
+    }
+  }
+
+  if (!(cmd = gst_vulkan_command_pool_create (raw->cmd_pool, &error)))
+    goto error;
+
+  if (!raw->pool) {
+    GstStructure *config;
+    guint min = 0, max = 0;
+    gsize size = 1;
+
+    raw->pool = gst_vulkan_buffer_pool_new (raw->download->device);
+    config = gst_buffer_pool_get_config (raw->pool);
+    gst_buffer_pool_config_set_params (config, raw->download->out_caps, size,
+        min, max);
+    gst_buffer_pool_set_config (raw->pool, config);
+  }
+  if (!raw->pool_active) {
+    gst_buffer_pool_set_active (raw->pool, TRUE);
+    raw->pool_active = TRUE;
+  }
+
+  if ((ret =
+          gst_buffer_pool_acquire_buffer (raw->pool, outbuf,
+              NULL)) != GST_FLOW_OK)
+    goto out;
+
+  {
+    /* *INDENT-OFF* */
+    VkCommandBufferBeginInfo cmd_buf_info = {
+        .sType = VK_STRUCTURE_TYPE_COMMAND_BUFFER_BEGIN_INFO,
+        .pNext = NULL,
+        .flags = VK_COMMAND_BUFFER_USAGE_ONE_TIME_SUBMIT_BIT,
+        .pInheritanceInfo = NULL
+    };
+    /* *INDENT-ON* */
+
+    err = vkBeginCommandBuffer (cmd, &cmd_buf_info);
+    if (gst_vulkan_error_to_g_error (err, &error, "vkBeginCommandBuffer") < 0)
+      return FALSE;
+  }
+
+  for (i = 0; i < GST_VIDEO_INFO_N_PLANES (&raw->out_info); i++) {
+    VkBufferImageCopy region;
+    GstMemory *in_mem, *out_mem;
+    GstVulkanBufferMemory *buf_mem;
+    GstVulkanImageMemory *img_mem;
+    VkImageMemoryBarrier image_memory_barrier;
+    VkBufferMemoryBarrier buffer_memory_barrier;
+
+    in_mem = gst_buffer_peek_memory (inbuf, i);
+    if (!gst_is_vulkan_image_memory (in_mem)) {
+      GST_WARNING_OBJECT (raw->download, "Input is not a GstVulkanImageMemory");
+      goto error;
+    }
+    img_mem = (GstVulkanImageMemory *) in_mem;
+
+    out_mem = gst_buffer_peek_memory (*outbuf, i);
+    if (!gst_is_vulkan_buffer_memory (out_mem)) {
+      GST_WARNING_OBJECT (raw->download,
+          "Output is not a GstVulkanBufferMemory");
+      goto error;
+    }
+    buf_mem = (GstVulkanBufferMemory *) out_mem;
+
+    /* *INDENT-OFF* */
+    region = (VkBufferImageCopy) {
+        .bufferOffset = 0,
+        .bufferRowLength = GST_VIDEO_INFO_COMP_WIDTH (&raw->in_info, i),
+        .bufferImageHeight = GST_VIDEO_INFO_COMP_HEIGHT (&raw->in_info, i),
+        .imageSubresource = {
+            .aspectMask = VK_IMAGE_ASPECT_COLOR_BIT,
+            .mipLevel = 0,
+            .baseArrayLayer = 0,
+            .layerCount = 1,
+        },
+        .imageOffset = { .x = 0, .y = 0, .z = 0, },
+        .imageExtent = {
+            .width = GST_VIDEO_INFO_COMP_WIDTH (&raw->out_info, i),
+            .height = GST_VIDEO_INFO_COMP_HEIGHT (&raw->out_info, i),
+            .depth = 1,
+        }
+    };
+
+    image_memory_barrier = (VkImageMemoryBarrier) {
+        .sType = VK_STRUCTURE_TYPE_IMAGE_MEMORY_BARRIER,
+        .pNext = NULL,
+        .srcAccessMask = img_mem->barrier.parent.access_flags,
+        .dstAccessMask = VK_ACCESS_TRANSFER_READ_BIT,
+        .oldLayout = img_mem->barrier.image_layout,
+        .newLayout = VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL,
+        /* FIXME: implement exclusive transfers */
+        .srcQueueFamilyIndex = 0,
+        .dstQueueFamilyIndex = 0,
+        .image = img_mem->image,
+        .subresourceRange = img_mem->barrier.subresource_range
+    };
+
+    buffer_memory_barrier = (VkBufferMemoryBarrier) {
+        .sType = VK_STRUCTURE_TYPE_BUFFER_MEMORY_BARRIER,
+        .pNext = NULL,
+        .srcAccessMask = buf_mem->barrier.parent.access_flags,
+        .dstAccessMask = VK_ACCESS_TRANSFER_WRITE_BIT,
+        /* FIXME: implement exclusive transfers */
+        .srcQueueFamilyIndex = 0,
+        .dstQueueFamilyIndex = 0,
+        .buffer = buf_mem->buffer,
+        .offset = region.bufferOffset,
+        .size = region.bufferRowLength * region.bufferImageHeight
+    };
+    /* *INDENT-ON* */
+
+    vkCmdPipelineBarrier (cmd,
+        buf_mem->barrier.parent.pipeline_stages | img_mem->barrier.
+        parent.pipeline_stages, VK_PIPELINE_STAGE_TRANSFER_BIT, 0, 0, NULL, 1,
+        &buffer_memory_barrier, 1, &image_memory_barrier);
+
+    buf_mem->barrier.parent.pipeline_stages = VK_PIPELINE_STAGE_TRANSFER_BIT;
+    buf_mem->barrier.parent.access_flags = buffer_memory_barrier.dstAccessMask;
+
+    img_mem->barrier.parent.pipeline_stages = VK_PIPELINE_STAGE_TRANSFER_BIT;
+    img_mem->barrier.parent.access_flags = image_memory_barrier.dstAccessMask;
+    img_mem->barrier.image_layout = VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL;
+
+    vkCmdCopyImageToBuffer (cmd, img_mem->image, img_mem->barrier.image_layout,
+        buf_mem->buffer, 1, &region);
+  }
+
+  err = vkEndCommandBuffer (cmd);
+  if (gst_vulkan_error_to_g_error (err, &error, "vkEndCommandBuffer") < 0)
+    return FALSE;
+
+  {
+    VkSubmitInfo submit_info = { 0, };
+    VkPipelineStageFlags stages = VK_PIPELINE_STAGE_BOTTOM_OF_PIPE_BIT;
+    GstVulkanFence *fence;
+
+    /* *INDENT-OFF* */
+    submit_info = (VkSubmitInfo) {
+        .sType = VK_STRUCTURE_TYPE_SUBMIT_INFO,
+        .pNext = NULL,
+        .waitSemaphoreCount = 0,
+        .pWaitSemaphores = NULL,
+        .pWaitDstStageMask = &stages,
+        .commandBufferCount = 1,
+        .pCommandBuffers = &cmd,
+        .signalSemaphoreCount = 0,
+        .pSignalSemaphores = NULL
+    };
+    /* *INDENT-ON* */
+
+    fence = gst_vulkan_fence_new (raw->download->device, 0, &error);
+    if (!fence)
+      goto error;
+
+    err =
+        vkQueueSubmit (raw->download->queue->queue, 1, &submit_info,
+        GST_VULKAN_FENCE_FENCE (fence));
+    if (gst_vulkan_error_to_g_error (err, &error, "vkQueueSubmit") < 0)
+      goto error;
+
+    raw->trash_list = g_list_prepend (raw->trash_list,
+        gst_vulkan_trash_new_free_command_buffer (fence, raw->cmd_pool, cmd));
+  }
+
+  /* XXX: STALL!
+   * Need to have the buffer gst_memory_map() wait for this fence before
+   * allowing access */
+  gst_vulkan_trash_list_wait (raw->trash_list, -1);
+  raw->trash_list = NULL;
+
+  ret = GST_FLOW_OK;
+
+out:
+  return ret;
+
+error:
+  if (error) {
+    GST_WARNING_OBJECT (raw->download, "Error: %s", error->message);
+    g_clear_error (&error);
+  }
+  gst_buffer_unref (*outbuf);
+  *outbuf = NULL;
+  ret = GST_FLOW_ERROR;
+  goto out;
+  return GST_FLOW_OK;
+}
+
+static void
+_image_to_raw_free (gpointer impl)
+{
+  struct ImageToRawDownload *raw = impl;
+
+  if (raw->pool) {
+    if (raw->pool_active) {
+      gst_buffer_pool_set_active (raw->pool, FALSE);
+    }
+    raw->pool_active = FALSE;
+    gst_object_unref (raw->pool);
+    raw->pool = NULL;
+  }
+
+  if (raw->cmd_pool) {
+    gst_object_unref (raw->cmd_pool);
+    raw->cmd_pool = NULL;
+  }
+
+  g_free (impl);
+}
+
+static GstStaticCaps _image_to_raw_in_templ =
+GST_STATIC_CAPS ("video/x-raw(" GST_CAPS_FEATURE_MEMORY_VULKAN_IMAGE ")");
+static GstStaticCaps _image_to_raw_out_templ = GST_STATIC_CAPS ("video/x-raw");
+
+static const struct DownloadMethod image_to_raw_download = {
+  "VulkanImageToRaw",
+  &_image_to_raw_in_templ,
+  &_image_to_raw_out_templ,
+  _image_to_raw_new_impl,
+  _image_to_raw_transform_caps,
+  _image_to_raw_set_caps,
+  _image_to_raw_propose_allocation,
+  _image_to_raw_perform,
+  _image_to_raw_free,
+};
+
+static const struct DownloadMethod *download_methods[] = {
+  &image_to_raw_download,
+};
+
+static GstCaps *
+_get_input_template_caps (void)
+{
+  GstCaps *ret = NULL;
+  gint i;
+
+  /* FIXME: cache this and invalidate on changes to download_methods */
+  for (i = 0; i < G_N_ELEMENTS (download_methods); i++) {
+    GstCaps *template = gst_static_caps_get (download_methods[i]->in_template);
+    ret = ret == NULL ? template : gst_caps_merge (ret, template);
+  }
+
+  ret = gst_caps_simplify (ret);
+
+  return ret;
+}
+
+static GstCaps *
+_get_output_template_caps (void)
+{
+  GstCaps *ret = NULL;
+  gint i;
+
+  /* FIXME: cache this and invalidate on changes to download_methods */
+  for (i = 0; i < G_N_ELEMENTS (download_methods); i++) {
+    GstCaps *template = gst_static_caps_get (download_methods[i]->out_template);
+    ret = ret == NULL ? template : gst_caps_merge (ret, template);
+  }
+
+  ret = gst_caps_simplify (ret);
+
+  return ret;
+}
+
+static void gst_vulkan_download_finalize (GObject * object);
+
+static gboolean gst_vulkan_download_query (GstBaseTransform * bt,
+    GstPadDirection direction, GstQuery * query);
+static void gst_vulkan_download_set_context (GstElement * element,
+    GstContext * context);
+static GstStateChangeReturn gst_vulkan_download_change_state (GstElement *
+    element, GstStateChange transition);
+
+static gboolean gst_vulkan_download_set_caps (GstBaseTransform * bt,
+    GstCaps * in_caps, GstCaps * out_caps);
+static GstCaps *gst_vulkan_download_transform_caps (GstBaseTransform * bt,
+    GstPadDirection direction, GstCaps * caps, GstCaps * filter);
+static gboolean gst_vulkan_download_propose_allocation (GstBaseTransform * bt,
+    GstQuery * decide_query, GstQuery * query);
+static gboolean gst_vulkan_download_decide_allocation (GstBaseTransform * bt,
+    GstQuery * query);
+static GstFlowReturn gst_vulkan_download_transform (GstBaseTransform * bt,
+    GstBuffer * inbuf, GstBuffer * outbuf);
+static GstFlowReturn gst_vulkan_download_prepare_output_buffer (GstBaseTransform
+    * bt, GstBuffer * inbuf, GstBuffer ** outbuf);
+
+enum
+{
+  PROP_0,
+};
+
+enum
+{
+  SIGNAL_0,
+  LAST_SIGNAL
+};
+
+/* static guint gst_vulkan_download_signals[LAST_SIGNAL] = { 0 }; */
+
+#define gst_vulkan_download_parent_class parent_class
+G_DEFINE_TYPE_WITH_CODE (GstVulkanDownload, gst_vulkan_download,
+    GST_TYPE_BASE_TRANSFORM, GST_DEBUG_CATEGORY_INIT (gst_debug_vulkan_download,
+        "vulkandownload", 0, "Vulkan Downloader"));
+
+static void
+gst_vulkan_download_class_init (GstVulkanDownloadClass * klass)
+{
+  GObjectClass *gobject_class;
+  GstElementClass *gstelement_class;
+  GstBaseTransformClass *gstbasetransform_class;
+
+  gobject_class = (GObjectClass *) klass;
+  gstelement_class = (GstElementClass *) klass;
+  gstbasetransform_class = (GstBaseTransformClass *) klass;
+
+  gst_element_class_set_metadata (gstelement_class, "Vulkan Downloader",
+      "Filter/Video", "A Vulkan data downloader",
+      "Matthew Waters <matthew@centricular.com>");
+
+  {
+    GstCaps *caps;
+
+    caps = _get_input_template_caps ();
+    gst_element_class_add_pad_template (gstelement_class,
+        gst_pad_template_new ("sink", GST_PAD_SINK, GST_PAD_ALWAYS, caps));
+    gst_caps_unref (caps);
+
+    caps = _get_output_template_caps ();
+    gst_element_class_add_pad_template (gstelement_class,
+        gst_pad_template_new ("src", GST_PAD_SRC, GST_PAD_ALWAYS, caps));
+    gst_caps_unref (caps);
+  }
+
+  gobject_class->finalize = gst_vulkan_download_finalize;
+
+  gstelement_class->change_state = gst_vulkan_download_change_state;
+  gstelement_class->set_context = gst_vulkan_download_set_context;
+  gstbasetransform_class->query = GST_DEBUG_FUNCPTR (gst_vulkan_download_query);
+  gstbasetransform_class->set_caps = gst_vulkan_download_set_caps;
+  gstbasetransform_class->transform_caps = gst_vulkan_download_transform_caps;
+  gstbasetransform_class->propose_allocation =
+      gst_vulkan_download_propose_allocation;
+  gstbasetransform_class->decide_allocation =
+      gst_vulkan_download_decide_allocation;
+  gstbasetransform_class->transform = gst_vulkan_download_transform;
+  gstbasetransform_class->prepare_output_buffer =
+      gst_vulkan_download_prepare_output_buffer;
+}
+
+static void
+gst_vulkan_download_init (GstVulkanDownload * vk_download)
+{
+  guint i, n;
+
+  n = G_N_ELEMENTS (download_methods);
+  vk_download->download_impls = g_malloc (sizeof (gpointer) * n);
+  for (i = 0; i < n; i++) {
+    vk_download->download_impls[i] =
+        download_methods[i]->new_impl (vk_download);
+  }
+}
+
+static void
+gst_vulkan_download_finalize (GObject * object)
+{
+  GstVulkanDownload *vk_download = GST_VULKAN_DOWNLOAD (object);
+  guint i;
+
+  gst_caps_replace (&vk_download->in_caps, NULL);
+  gst_caps_replace (&vk_download->out_caps, NULL);
+
+  for (i = 0; i < G_N_ELEMENTS (download_methods); i++) {
+    download_methods[i]->free (vk_download->download_impls[i]);
+  }
+  g_free (vk_download->download_impls);
+  vk_download->download_impls = NULL;
+
+  G_OBJECT_CLASS (parent_class)->finalize (object);
+}
+
+static gboolean
+gst_vulkan_download_query (GstBaseTransform * bt, GstPadDirection direction,
+    GstQuery * query)
+{
+  GstVulkanDownload *vk_download = GST_VULKAN_DOWNLOAD (bt);
+
+  switch (GST_QUERY_TYPE (query)) {
+    case GST_QUERY_CONTEXT:{
+      if (gst_vulkan_handle_context_query (GST_ELEMENT (vk_download), query,
+              NULL, &vk_download->instance, &vk_download->device))
+        return TRUE;
+
+      if (gst_vulkan_queue_handle_context_query (GST_ELEMENT (vk_download),
+              query, &vk_download->queue))
+        return TRUE;
+
+      break;
+    }
+    default:
+      break;
+  }
+
+  return GST_BASE_TRANSFORM_CLASS (parent_class)->query (bt, direction, query);
+}
+
+static void
+gst_vulkan_download_set_context (GstElement * element, GstContext * context)
+{
+  GstVulkanDownload *vk_download = GST_VULKAN_DOWNLOAD (element);
+
+  gst_vulkan_handle_set_context (element, context, NULL,
+      &vk_download->instance);
+
+  GST_ELEMENT_CLASS (parent_class)->set_context (element, context);
+}
+
+struct choose_data
+{
+  GstVulkanDownload *download;
+  GstVulkanQueue *queue;
+};
+
+static gboolean
+_choose_queue (GstVulkanDevice * device, GstVulkanQueue * queue,
+    struct choose_data *data)
+{
+  guint flags = device->queue_family_props[queue->family].queueFlags;
+
+  if ((flags & VK_QUEUE_GRAPHICS_BIT) != 0) {
+    if (data->queue)
+      gst_object_unref (data->queue);
+    data->queue = gst_object_ref (queue);
+    return FALSE;
+  }
+
+  return TRUE;
+}
+
+static GstVulkanQueue *
+_find_graphics_queue (GstVulkanDownload * download)
+{
+  struct choose_data data;
+
+  data.download = download;
+  data.queue = NULL;
+
+  gst_vulkan_device_foreach_queue (download->device,
+      (GstVulkanDeviceForEachQueueFunc) _choose_queue, &data);
+
+  return data.queue;
+}
+
+static GstStateChangeReturn
+gst_vulkan_download_change_state (GstElement * element,
+    GstStateChange transition)
+{
+  GstVulkanDownload *vk_download = GST_VULKAN_DOWNLOAD (element);
+  GstStateChangeReturn ret = GST_STATE_CHANGE_SUCCESS;
+
+  GST_DEBUG ("changing state: %s => %s",
+      gst_element_state_get_name (GST_STATE_TRANSITION_CURRENT (transition)),
+      gst_element_state_get_name (GST_STATE_TRANSITION_NEXT (transition)));
+
+  switch (transition) {
+    case GST_STATE_CHANGE_NULL_TO_READY:
+      break;
+    case GST_STATE_CHANGE_READY_TO_PAUSED:
+      if (!gst_vulkan_ensure_element_data (element, NULL,
+              &vk_download->instance)) {
+        GST_ELEMENT_ERROR (vk_download, RESOURCE, NOT_FOUND,
+            ("Failed to retreive vulkan instance"), (NULL));
+        return GST_STATE_CHANGE_FAILURE;
+      }
+      if (!gst_vulkan_device_run_context_query (GST_ELEMENT (vk_download),
+              &vk_download->device)) {
+        GError *error = NULL;
+        GST_DEBUG_OBJECT (vk_download,
+            "No device retrieved from peer elements");
+        if (!(vk_download->device =
+                gst_vulkan_instance_create_device (vk_download->instance,
+                    &error))) {
+          GST_ELEMENT_ERROR (vk_download, RESOURCE, NOT_FOUND,
+              ("Failed to create vulkan device"), ("%s", error->message));
+          g_clear_error (&error);
+          return GST_STATE_CHANGE_FAILURE;
+        }
+      }
+
+      if (!gst_vulkan_queue_run_context_query (GST_ELEMENT (vk_download),
+              &vk_download->queue)) {
+        GST_DEBUG_OBJECT (vk_download, "No queue retrieved from peer elements");
+        vk_download->queue = _find_graphics_queue (vk_download);
+      }
+      if (!vk_download->queue) {
+        GST_ELEMENT_ERROR (vk_download, RESOURCE, NOT_FOUND,
+            ("Failed to create/retrieve vulkan queue"), (NULL));
+        return GST_STATE_CHANGE_FAILURE;
+      }
+      break;
+    case GST_STATE_CHANGE_PAUSED_TO_PLAYING:
+      break;
+    default:
+      break;
+  }
+
+  ret = GST_ELEMENT_CLASS (parent_class)->change_state (element, transition);
+  if (ret == GST_STATE_CHANGE_FAILURE)
+    return ret;
+
+  switch (transition) {
+    case GST_STATE_CHANGE_PLAYING_TO_PAUSED:
+      break;
+    case GST_STATE_CHANGE_PAUSED_TO_READY:
+      if (vk_download->queue)
+        gst_object_unref (vk_download->queue);
+      vk_download->queue = NULL;
+      if (vk_download->device)
+        gst_object_unref (vk_download->device);
+      vk_download->device = NULL;
+      if (vk_download->instance)
+        gst_object_unref (vk_download->instance);
+      vk_download->instance = NULL;
+      break;
+    case GST_STATE_CHANGE_READY_TO_NULL:
+      break;
+    default:
+      break;
+  }
+
+  return ret;
+}
+
+static GstCaps *
+gst_vulkan_download_transform_caps (GstBaseTransform * bt,
+    GstPadDirection direction, GstCaps * caps, GstCaps * filter)
+{
+  GstVulkanDownload *vk_download = GST_VULKAN_DOWNLOAD (bt);
+  GstCaps *result, *tmp;
+  gint i;
+
+  tmp = gst_caps_new_empty ();
+
+  for (i = 0; i < G_N_ELEMENTS (download_methods); i++) {
+    GstCaps *tmp2;
+    GstCaps *templ;
+
+    if (direction == GST_PAD_SINK) {
+      templ = gst_static_caps_get (download_methods[i]->in_template);
+    } else {
+      templ = gst_static_caps_get (download_methods[i]->out_template);
+    }
+    if (!gst_caps_can_intersect (caps, templ)) {
+      gst_caps_unref (templ);
+      continue;
+    }
+    gst_caps_unref (templ);
+
+    tmp2 = download_methods[i]->transform_caps (vk_download->download_impls[i],
+        direction, caps);
+
+    if (tmp2)
+      tmp = gst_caps_merge (tmp, tmp2);
+  }
+
+  if (filter) {
+    result = gst_caps_intersect_full (filter, tmp, GST_CAPS_INTERSECT_FIRST);
+    gst_caps_unref (tmp);
+  } else {
+    result = tmp;
+  }
+
+  return result;
+}
+
+static gboolean
+gst_vulkan_download_set_caps (GstBaseTransform * bt, GstCaps * in_caps,
+    GstCaps * out_caps)
+{
+  GstVulkanDownload *vk_download = GST_VULKAN_DOWNLOAD (bt);
+  gboolean found_method = FALSE;
+  guint i;
+
+  gst_caps_replace (&vk_download->in_caps, in_caps);
+  gst_caps_replace (&vk_download->out_caps, out_caps);
+
+  for (i = 0; i < G_N_ELEMENTS (download_methods); i++) {
+    GstCaps *templ;
+
+    templ = gst_static_caps_get (download_methods[i]->in_template);
+    if (!gst_caps_can_intersect (in_caps, templ)) {
+      gst_caps_unref (templ);
+      continue;
+    }
+    gst_caps_unref (templ);
+
+    templ = gst_static_caps_get (download_methods[i]->out_template);
+    if (!gst_caps_can_intersect (out_caps, templ)) {
+      gst_caps_unref (templ);
+      continue;
+    }
+    gst_caps_unref (templ);
+
+    if (!download_methods[i]->set_caps (vk_download->download_impls[i], in_caps,
+            out_caps))
+      continue;
+
+    GST_LOG_OBJECT (bt, "downloader %s accepted caps in: %" GST_PTR_FORMAT
+        " out: %" GST_PTR_FORMAT, download_methods[i]->name, in_caps, out_caps);
+
+    vk_download->current_impl = i;
+    found_method = TRUE;
+    break;
+  }
+
+  GST_DEBUG_OBJECT (bt,
+      "set caps in: %" GST_PTR_FORMAT " out: %" GST_PTR_FORMAT, in_caps,
+      out_caps);
+
+  return found_method;
+}
+
+static gboolean
+gst_vulkan_download_propose_allocation (GstBaseTransform * bt,
+    GstQuery * decide_query, GstQuery * query)
+{
+  GstVulkanDownload *vk_download = GST_VULKAN_DOWNLOAD (bt);
+  guint i;
+
+  for (i = 0; i < G_N_ELEMENTS (download_methods); i++) {
+    GstCaps *templ;
+
+    templ = gst_static_caps_get (download_methods[i]->in_template);
+    if (!gst_caps_can_intersect (vk_download->in_caps, templ)) {
+      gst_caps_unref (templ);
+      continue;
+    }
+    gst_caps_unref (templ);
+
+    templ = gst_static_caps_get (download_methods[i]->out_template);
+    if (!gst_caps_can_intersect (vk_download->out_caps, templ)) {
+      gst_caps_unref (templ);
+      continue;
+    }
+    gst_caps_unref (templ);
+
+    download_methods[i]->propose_allocation (vk_download->download_impls[i],
+        decide_query, query);
+  }
+
+  return TRUE;
+}
+
+static gboolean
+gst_vulkan_download_decide_allocation (GstBaseTransform * bt, GstQuery * query)
+{
+  return TRUE;
+}
+
+static gboolean
+_download_find_method (GstVulkanDownload * vk_download)
+{
+  vk_download->current_impl++;
+
+  if (vk_download->current_impl >= G_N_ELEMENTS (download_methods))
+    return FALSE;
+
+  GST_DEBUG_OBJECT (vk_download, "attempting download with downloader %s",
+      download_methods[vk_download->current_impl]->name);
+
+  return TRUE;
+}
+
+static GstFlowReturn
+gst_vulkan_download_prepare_output_buffer (GstBaseTransform * bt,
+    GstBuffer * inbuf, GstBuffer ** outbuf)
+{
+  GstBaseTransformClass *bclass = GST_BASE_TRANSFORM_GET_CLASS (bt);
+  GstVulkanDownload *vk_download = GST_VULKAN_DOWNLOAD (bt);
+  GstFlowReturn ret;
+
+restart:
+  {
+    gpointer method_impl;
+    const struct DownloadMethod *method;
+
+    method = download_methods[vk_download->current_impl];
+    method_impl = vk_download->download_impls[vk_download->current_impl];
+
+    ret = method->perform (method_impl, inbuf, outbuf);
+    if (ret != GST_FLOW_OK) {
+    next_method:
+      if (!_download_find_method (vk_download)) {
+        GST_ELEMENT_ERROR (bt, RESOURCE, NOT_FOUND,
+            ("Could not find suitable downloader"), (NULL));
+        return GST_FLOW_ERROR;
+      }
+
+      method = download_methods[vk_download->current_impl];
+      method_impl = vk_download->download_impls[vk_download->current_impl];
+      if (!method->set_caps (method_impl, vk_download->in_caps,
+              vk_download->out_caps))
+        /* try the next method */
+        goto next_method;
+
+      /* try the downloading with the next method */
+      goto restart;
+    }
+  }
+
+  if (ret == GST_FLOW_OK) {
+    /* basetransform doesn't unref if they're the same */
+    if (inbuf != *outbuf)
+      bclass->copy_metadata (bt, inbuf, *outbuf);
+  }
+
+  return ret;
+}
+
+static GstFlowReturn
+gst_vulkan_download_transform (GstBaseTransform * bt, GstBuffer * inbuf,
+    GstBuffer * outbuf)
+{
+  return GST_FLOW_OK;
+}
diff --git a/ext/vulkan/vkdownload.h b/ext/vulkan/vkdownload.h
new file mode 100644 (file)
index 0000000..061d087
--- /dev/null
@@ -0,0 +1,87 @@
+/*
+ * GStreamer
+ * Copyright (C) 2019 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.
+ */
+
+#ifndef _VK_DOWNLOAD_H_
+#define _VK_DOWNLOAD_H_
+
+#include <gst/gst.h>
+#include <gst/video/video.h>
+#include <gst/vulkan/vulkan.h>
+
+G_BEGIN_DECLS
+
+#define GST_TYPE_VULKAN_DOWNLOAD            (gst_vulkan_download_get_type())
+#define GST_VULKAN_DOWNLOAD(obj)            (G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_VULKAN_DOWNLOAD,GstVulkanDownload))
+#define GST_VULKAN_DOWNLOAD_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST((klass),GST_TYPE_VULKAN_DOWNLOAD,GstVulkanDownloadClass))
+#define GST_IS_VULKAN_DOWNLOAD(obj)         (G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_VULKAN_DOWNLOAD))
+#define GST_IS_VULKAN_DOWNLOAD_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass),GST_TYPE_VULKAN_DOWNLOAD))
+
+typedef struct _GstVulkanDownload GstVulkanDownload;
+typedef struct _GstVulkanDownloadClass GstVulkanDownloadClass;
+
+struct DownloadMethod
+{
+  const gchar       *name;
+
+  GstStaticCaps     *in_template;
+  GstStaticCaps     *out_template;
+
+  gpointer          (*new_impl)                 (GstVulkanDownload * download);
+  GstCaps *         (*transform_caps)           (gpointer impl,
+                                                 GstPadDirection direction,
+                                                 GstCaps * caps);
+  gboolean          (*set_caps)                 (gpointer impl,
+                                                 GstCaps * in_caps,
+                                                 GstCaps * out_caps);
+  void              (*propose_allocation)       (gpointer impl,
+                                                 GstQuery * decide_query,
+                                                 GstQuery * query);
+  GstFlowReturn     (*perform)                  (gpointer impl,
+                                                 GstBuffer * buffer,
+                                                 GstBuffer ** outbuf);
+  void              (*free)                     (gpointer impl);
+};
+
+struct _GstVulkanDownload
+{
+  GstBaseTransform      parent;
+
+  GstVulkanInstance     *instance;
+  GstVulkanDevice       *device;
+  GstVulkanQueue        *queue;
+
+  GstCaps               *in_caps;
+  GstCaps               *out_caps;
+
+  /* all impl pointers */
+  gpointer              *download_impls;
+  guint                 current_impl;
+};
+
+struct _GstVulkanDownloadClass
+{
+  GstBaseTransformClass video_sink_class;
+};
+
+GType gst_vulkan_download_get_type(void);
+
+G_END_DECLS
+
+#endif