Merge pull request #75 from exomia/release/v1.3.252

Release/v1.3.252

.version

@@ -1 +1 @@
-1.3.251
+1.3.252

src/Exomia.Vulkan.Api.Core/Enums/VkCommandPoolResetFlagBits.cs

@@ -21,7 +21,7 @@ namespace Exomia.Vulkan.Api.Core;
 public enum VkCommandPoolResetFlagBits
 {
     /// <summary>
-    ///     VK_COMMAND_POOL_RESET_RELEASE_RESOURCES_BIT specifies that resetting a command pool recycles all of the
+    ///     VK_COMMAND_POOL_RESET_RELEASE_RESOURCES_BITspecifies that resetting a command pool recycles all of the
     ///     resources from the command pool back to the system.
     /// </summary>
     VK_COMMAND_POOL_RESET_RELEASE_RESOURCES_BIT = 0x1

src/Exomia.Vulkan.Api.Core/Enums/VkPipelineCacheHeaderVersion.cs

@@ -19,6 +19,13 @@ namespace Exomia.Vulkan.Api.Core;
 /// </summary>
 public enum VkPipelineCacheHeaderVersion
 {
-    /// <summary>VK_PIPELINE_CACHE_HEADER_VERSION_ONE specifies version one of the pipeline cache.</summary>
+    /// <summary>
+    ///     VK_PIPELINE_CACHE_HEADER_VERSION_ONE specifies version one of the pipeline cache, described by
+    ///     <a
+    ///         href="https://www.khronos.org/registry/vulkan/specs/1.3-extensions/man/html/VkPipelineCacheHeaderVersionOne.html">
+    ///         VkPipelineCacheHeaderVersionOne
+    ///     </a>
+    ///     .
+    /// </summary>
     VK_PIPELINE_CACHE_HEADER_VERSION_ONE = 1
 }

src/Exomia.Vulkan.Api.Core/Enums/VkResult.cs

@@ -151,8 +151,8 @@ public enum VkResult
     VK_ERROR_INCOMPATIBLE_DISPLAY_KHR = -1000003001,
 
     /// <summary>
-    ///     VK_ERROR_VALIDATION_FAILED_EXT<br />
-    ///     <a href="https://www.khronos.org/registry/vulkan/specs/1.3-extensions/html/vkspec.html#VkResult">https://www.khronos.org/registry/vulkan/specs/1.3-extensions/html/vkspec.html#VkResult</a>
+    ///     VK_ERROR_VALIDATION_FAILED_EXTA command failed because invalid usage was detected by the implementation or a
+    ///     validation-layer.
     /// </summary>
     VK_ERROR_VALIDATION_FAILED_EXT = -1000011001,
 

src/Exomia.Vulkan.Api.Core/Enums/VkStructureType.cs

@@ -4363,6 +4363,12 @@ public enum VkStructureType
     /// </summary>
     VK_STRUCTURE_TYPE_IMAGE_VIEW_SAMPLE_WEIGHT_CREATE_INFO_QCOM = 1000440002,
 
+    /// <summary>
+    ///     VK_STRUCTURE_TYPE_EXTERNAL_MEMORY_ACQUIRE_UNMODIFIED_EXT<br />
+    ///     <a href="https://www.khronos.org/registry/vulkan/specs/1.3-extensions/html/vkspec.html#VkStructureType">https://www.khronos.org/registry/vulkan/specs/1.3-extensions/html/vkspec.html#VkStructureType</a>
+    /// </summary>
+    VK_STRUCTURE_TYPE_EXTERNAL_MEMORY_ACQUIRE_UNMODIFIED_EXT = 1000453000,
+
     /// <summary>
     ///     VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_EXTENDED_DYNAMIC_STATE_3_FEATURES_EXT<br />
     ///     <a href="https://www.khronos.org/registry/vulkan/specs/1.3-extensions/html/vkspec.html#VkStructureType">https://www.khronos.org/registry/vulkan/specs/1.3-extensions/html/vkspec.html#VkStructureType</a>

src/Exomia.Vulkan.Api.Core/Extensions/EXT/VK_EXT_external_memory_acquire_unmodified/VkExtExternalMemoryAcquireUnmodified.cs

@@ -0,0 +1,52 @@
+#region License
+
+// Copyright (c) 2018-2023, exomia
+// All rights reserved.
+// 
+// This source code is licensed under the BSD-style license found in the
+// LICENSE file in the root directory of this source tree.
+
+#endregion
+
+global using static Exomia.Vulkan.Api.Core.VkExtExternalMemoryAcquireUnmodified;
+
+#pragma warning disable CA2211 // Non-constant fields should not be visible
+#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member
+
+// ReSharper disable UnusedMember.Global
+// ReSharper disable InconsistentNaming
+// ReSharper disable once CheckNamespace
+namespace Exomia.Vulkan.Api.Core;
+
+/// <summary>
+///     VK_EXT_external_memory_acquire_unmodified - device extension (nr. 454) - author 'EXT' [platform '' | contact 'Lina
+///     Versace @versalinyaa']<br />
+///     <a
+///         href="https://www.khronos.org/registry/vulkan/specs/1.3-extensions/man/html/VK_EXT_external_memory_acquire_unmodified.html">
+///         https://www.khronos.org/registry/vulkan/specs/1.3-extensions/man/html/VK_EXT_external_memory_acquire_unmodified.html
+///     </a>
+/// </summary>
+[VkDepends("VK_KHR_external_memory")]
+public static class VkExtExternalMemoryAcquireUnmodified
+{
+    /// <summary> The spec version. </summary>
+    public const uint VK_EXT_EXTERNAL_MEMORY_ACQUIRE_UNMODIFIED_SPEC_VERSION = 1;
+
+    /// <summary> The extension name. </summary>
+    public const string VK_EXT_EXTERNAL_MEMORY_ACQUIRE_UNMODIFIED_EXTENSION_NAME = "VK_EXT_external_memory_acquire_unmodified";
+
+    /// <summary>
+    ///     An UTF8 null terminated version of <see cref="VK_EXT_EXTERNAL_MEMORY_ACQUIRE_UNMODIFIED_EXTENSION_NAME" />
+    ///     represented by an UTF16 string.
+    /// </summary>
+    /// <remarks>
+    ///     Example usage:<br />
+    ///     <br />
+    ///     fixed(char* ptr = VK_EXT_EXTERNAL_MEMORY_ACQUIRE_UNMODIFIED_EXTENSION_NAME_UTF8_NT) {<br />
+    ///     sbyte* utf8NtPtr = (sbyte*)ptr; // utf8NtPtr - can now be passed and used directly as a utf8_nt string for
+    ///     unmanaged code.<br />
+    ///     }
+    /// </remarks>
+    public const string VK_EXT_EXTERNAL_MEMORY_ACQUIRE_UNMODIFIED_EXTENSION_NAME_UTF8_NT =
+        "\u4b56\u455f\u5458\u455f\u5458\u5245\u414e\u5f4c\u454d\u4f4d\u5952\u415f\u5143\u4955\u4552\u555f\u4d4e\u444f\u4649\u4549\u5f44\u5845\u4554\u534e\u4f49\u5f4e\u414e\u454d\u0000";
+}

src/Exomia.Vulkan.Api.Core/Extensions/EXT/VK_EXT_external_memory_acquire_unmodified/VkExternalMemoryAcquireUnmodifiedEXT.cs

@@ -0,0 +1,52 @@
+#region License
+
+// Copyright (c) 2018-2023, exomia
+// All rights reserved.
+// 
+// This source code is licensed under the BSD-style license found in the
+// LICENSE file in the root directory of this source tree.
+
+#endregion
+
+// ReSharper disable UnusedMember.Global
+// ReSharper disable InconsistentNaming
+// ReSharper disable once CheckNamespace
+namespace Exomia.Vulkan.Api.Core;
+
+/// <summary>
+///     VkExternalMemoryAcquireUnmodifiedEXT - Structure specifying that external memory has remained unmodified since
+///     releasing ownership -
+///     <a
+///         href="https://www.khronos.org/registry/vulkan/specs/1.3-extensions/man/html/VkExternalMemoryAcquireUnmodifiedEXT.html">
+///         https://www.khronos.org/registry/vulkan/specs/1.3-extensions/man/html/VkExternalMemoryAcquireUnmodifiedEXT.html
+///     </a>
+/// </summary>
+/// <remarks>
+///     <list type="table">
+///         <item>
+///             <term>structextends</term>
+///             <description>VkBufferMemoryBarrier,VkBufferMemoryBarrier2,VkImageMemoryBarrier,VkImageMemoryBarrier2</description>
+///         </item>
+///     </list>
+/// </remarks>
+[VkStructExtends("VkBufferMemoryBarrier,VkBufferMemoryBarrier2,VkImageMemoryBarrier,VkImageMemoryBarrier2")]
+[StructLayout(LayoutKind.Sequential)]
+public unsafe struct VkExternalMemoryAcquireUnmodifiedEXT
+{
+    /// <summary> The stype of this structure. </summary>
+    public const VkStructureType STYPE = VK_STRUCTURE_TYPE_EXTERNAL_MEMORY_ACQUIRE_UNMODIFIED_EXT;
+
+    /// <summary>sType is the type of this structure.</summary>
+    public VkStructureType sType;
+
+    /// <summary>pNext is NULL or a pointer to a structure extending this structure.</summary>
+    public void* pNext;
+
+    /// <summary>
+    ///     acquireUnmodifiedMemory specifies, if VK_TRUE, that no range of VkDeviceMemory bound to the resource of the
+    ///     memory barrier&#8217;s subresource range was modified at any time since the resource&#8217;s most recent release of
+    ///     ownership to the queue family specified by the memory barrier&#8217;s srcQueueFamilyIndex. If VK_FALSE, it
+    ///     specifies nothing.
+    /// </summary>
+    public VkBool32 acquireUnmodifiedMemory;
+}

src/Exomia.Vulkan.Api.Core/Structs/VkApplicationInfo.cs

@@ -57,8 +57,8 @@ public unsafe struct VkApplicationInfo
     ///     apiVersion must be the highest version of Vulkan that the application is designed to use, encoded as described
     ///     in
     ///     https://registry.khronos.org/vulkan/specs/1.3-extensions/html/vkspec.html#extendingvulkan-coreversions-versionnumbers.
-    ///     The patch version number specified in apiVersion is ignored when creating an instance object. Only the major and
-    ///     minor versions of the instance must match those requested in apiVersion.
+    ///     The patch version number specified in apiVersion is ignored when creating an instance object. The variant version
+    ///     of the instance must match that requested in apiVersion.
     /// </summary>
     public VkVersion apiVersion;
 }

src/Exomia.Vulkan.Api.Core/Structs/VkComputePipelineCreateInfo.cs

@@ -41,9 +41,9 @@ public unsafe struct VkComputePipelineCreateInfo
     /// </summary>
     public VkPipelineLayout layout;
 
-    /// <summary>basePipelineHandle is a pipeline to derive from</summary>
+    /// <summary>basePipelineHandle is a pipeline to derive from.</summary>
     public VkPipeline basePipelineHandle;
 
-    /// <summary>basePipelineIndex is an index into the pCreateInfosparameter to use as a pipeline to derive from</summary>
+    /// <summary>basePipelineIndex is an index into the pCreateInfosparameter to use as a pipeline to derive from.</summary>
     public int basePipelineIndex;
 }

src/Exomia.Vulkan.Api.Core/Structs/VkPhysicalDeviceSparseProperties.cs

@@ -31,7 +31,7 @@ namespace Exomia.Vulkan.Api.Core;
 public struct VkPhysicalDeviceSparseProperties
 {
     /// <summary>
-    ///     residencyStandard2DBlockShape is VK_TRUE if the physical device will access all single-sample 2D sparse
+    ///     residencyStandard2DBlockShapeis VK_TRUE if the physical device will access all single-sample 2D sparse
     ///     resources using the standard sparse image block shapes (based on image format), as described in the Standard Sparse
     ///     Image Block Shapes (Single Sample) table. If this property is not supported the value returned in the
     ///     imageGranularity member of the VkSparseImageFormatPropertiesstructure for single-sample 2D images is not required
@@ -40,7 +40,7 @@ public struct VkPhysicalDeviceSparseProperties
     public VkBool32 residencyStandard2DBlockShape;
 
     /// <summary>
-    ///     residencyStandard2DMultisampleBlockShape is VK_TRUE if the physical device will access all multisample 2D
+    ///     residencyStandard2DMultisampleBlockShapeis VK_TRUE if the physical device will access all multisample 2D
     ///     sparse resources using the standard sparse image block shapes (based on image format), as described in the Standard
     ///     Sparse Image Block Shapes (MSAA) table. If this property is not supported, the value returned in the
     ///     imageGranularity member of the VkSparseImageFormatPropertiesstructure for multisample 2D images is not required to
@@ -49,7 +49,7 @@ public struct VkPhysicalDeviceSparseProperties
     public VkBool32 residencyStandard2DMultisampleBlockShape;
 
     /// <summary>
-    ///     residencyStandard3DBlockShape is VK_TRUE if the physical device will access all 3D sparse resources using the
+    ///     residencyStandard3DBlockShapeis VK_TRUE if the physical device will access all 3D sparse resources using the
     ///     standard sparse image block shapes (based on image format), as described in the Standard Sparse Image Block Shapes
     ///     (Single Sample) table. If this property is not supported, the value returned in the imageGranularity member of the
     ///     VkSparseImageFormatPropertiesstructure for 3D images is not required to match the standard sparse image block
@@ -58,7 +58,7 @@ public struct VkPhysicalDeviceSparseProperties
     public VkBool32 residencyStandard3DBlockShape;
 
     /// <summary>
-    ///     residencyAlignedMipSize is VK_TRUE if images with mip level dimensions that are not integer multiples of the
+    ///     residencyAlignedMipSizeis VK_TRUE if images with mip level dimensions that are not integer multiples of the
     ///     corresponding dimensions of the sparse image block may be placed in the mip tail. If this property is not reported,
     ///     only mip levels with dimensions smaller than the imageGranularity member of the VkSparseImageFormatProperties
     ///     structure will be placed in the mip tail. If this property is reported the implementation is allowed to return
@@ -69,7 +69,7 @@ public struct VkPhysicalDeviceSparseProperties
     public VkBool32 residencyAlignedMipSize;
 
     /// <summary>
-    ///     residencyNonResidentStrict specifies whether the physical device can consistently access non-resident regions
+    ///     residencyNonResidentStrictspecifies whether the physical device can consistently access non-resident regions
     ///     of a resource. If this property is VK_TRUE, access to non-resident regions of resources will be guaranteed to
     ///     return values as if the resource was populated with 0; writes to non-resident regions will be discarded.
     /// </summary>