summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorChad Versace <chadversary@chromium.org>2017-06-28 08:21:36 -0700
committerChad Versace <chadversary@chromium.org>2017-06-28 08:23:07 -0700
commited43923c9049f3861b825d2b4dfc665aee4ef859 (patch)
treef3dc59feeab14cc3d3674c33c8d1cd525d11cd20
parentf6abb53ec16a07fe2d80633af550f64247da0d34 (diff)
downloadvulkan-spec-wip/1.0-VK_MESAX_external.zip
vulkan-spec-wip/1.0-VK_MESAX_external.tar.xz
WIP: Begin spec text for VkDmaBufImageFormatPropertiesMESAXwip/1.0-VK_MESAX_external
-rw-r--r--doc/specs/vulkan/chapters/features.txt40
1 files changed, 40 insertions, 0 deletions
diff --git a/doc/specs/vulkan/chapters/features.txt b/doc/specs/vulkan/chapters/features.txt
index d6b3d4d..fc1f6f7 100644
--- a/doc/specs/vulkan/chapters/features.txt
+++ b/doc/specs/vulkan/chapters/features.txt
@@ -4167,6 +4167,46 @@ for the following external handle types:
endif::VK_KHX_external_memory_capabilities[]
+ifdef::VK_MESAX_external_image_dma_buf[]
+// refBegin VkDmaBufImageFormatPropertiesMESAX TODO
+
+To determine the image capabilities compatible with
+<<glossry-drm-format-modifier,DRM format modifiers>>,
+
+ * add slink:VkPhysicalDeviceExternalImageFormatInfoKHX to the pname:pNext
+ chain of slink:VkPhysicalDeviceImageFormatInfo2KHR and add
+ slink:VkExternalImageFormatPropertiesKHX to the pname:pNext chain of
+ slink:VkImageFormatProperties2KHR, as described above;
+ * set slink:VkPhysicalDeviceExternalImageFormatInfoKHX::pname:handleType to
+ elink:VK_EXTERNAL_MEMORY_HANDLE_TYPE_DMA_BUF_BIT_MESAX;
+ * and add slink:VkDmaBufImageFormatPropertiesMESAX to the pname:pNext chain
+ of the slink:VkExternalImageFormatPropertiesKHX.
+
+The sname:VkDmaBufImageFormatPropertiesMESAX structure is defined as
+
+include::../api/structs/VkDmaBufImageFormatPropertiesMESAX.txt[]
+
+ * pname:sType is the type of this structure.
+ * pname:pNext is `NULL` or a pointer to an extension-specific structure.
+ * pname:pModifierCount is a pointer to an integer related to the number DRM
+ format modifiers available, as described below.
+ * pname:pModifierProperties is either `NULL` or a pointer to an array of
+ slink:VkDmaBufImageFormatModifierPropertiesMESAX structures.
+
+If pname:pModifierProperties is `NULL`, then the number of DRM format modifiers
+compatible with the image parameters specified in
+slink:VkPhysicalDeviceImageFormatInfo2KHR and its pname:pNext chain. Otherwise,
+pname:pModifierCount must: point to a variable set by the user to the number of
+elements in the pname:pModifierProperties array, and on return the variable is
+overwritten with the number of structures actually written to
+pname:pModifierProperties. If pname:pModifierCount is less than the number of
+available DRM format modifiers, then at most pname:pModifierCount structures
+will be written to the array.
+
+TODO: Specify VkDmaBufImageFormatModifierPropertiesMESAX.
+
+endif::VK_MESAX_external_image_dma_buf[]
+
endif::VK_KHR_get_physical_device_properties2[]