C Specification

// Provided by VK_NV_cluster_acceleration_structure
typedef struct VkClusterAccelerationStructureTriangleClusterInputNV {
    VkStructureType    sType;
    void*              pNext;
    VkFormat           vertexFormat;
    uint32_t           maxGeometryIndexValue;
    uint32_t           maxClusterUniqueGeometryCount;
    uint32_t           maxClusterTriangleCount;
    uint32_t           maxClusterVertexCount;
    uint32_t           maxTotalTriangleCount;
    uint32_t           maxTotalVertexCount;
    uint32_t           minPositionTruncateBitCount;
} VkClusterAccelerationStructureTriangleClusterInputNV;

Members

  • sType is a VkStructureType value identifying this structure.

  • pNext is NULL or a pointer to a structure extending this structure.

  • vertexFormat is the VkFormat of each vertex element.

  • maxGeometryIndexValue is the maximum geometry index value for any constructed geometry.

  • maxClusterUniqueGeometryCount is the maximum number of unique values of the geometry index for each cluster or cluster template.

  • maxClusterTriangleCount is the maximum number of triangles in a cluster or cluster template.

  • maxClusterVertexCount is the maximum number of unique vertices in the cluster’s index buffer.

  • maxTotalTriangleCount is the sum of all triangles across all clusters or cluster templates.

  • maxTotalVertexCount is the maximum number of vertices across all clusters or cluster templates.

  • minPositionTruncateBitCount is the least value specified in cluster build in VkClusterAccelerationStructureBuildTriangleClusterInfoNV::positionTruncateBitCount or cluster template build in VkClusterAccelerationStructureBuildTriangleClusterTemplateInfoNV::positionTruncateBitCount.

Description

Valid Usage
  • VUID-VkClusterAccelerationStructureTriangleClusterInputNV-vertexFormat-10439
    The format features of vertexFormat must contain VK_FORMAT_FEATURE_ACCELERATION_STRUCTURE_VERTEX_BUFFER_BIT_KHR

  • VUID-VkClusterAccelerationStructureTriangleClusterInputNV-maxClusterTriangleCount-10440
    maxClusterTriangleCount must be less than or equal to VkPhysicalDeviceClusterAccelerationStructurePropertiesNV::maxTrianglesPerCluster

  • VUID-VkClusterAccelerationStructureTriangleClusterInputNV-maxClusterVertexCount-10441
    maxClusterVertexCount must be less than or equal to VkPhysicalDeviceClusterAccelerationStructurePropertiesNV::maxVerticesPerCluster

  • VUID-VkClusterAccelerationStructureTriangleClusterInputNV-minPositionTruncateBitCount-10442
    minPositionTruncateBitCount must be less than or equal to 32

Valid Usage (Implicit)
  • VUID-VkClusterAccelerationStructureTriangleClusterInputNV-sType-sType
    sType must be VK_STRUCTURE_TYPE_CLUSTER_ACCELERATION_STRUCTURE_TRIANGLE_CLUSTER_INPUT_NV

  • VUID-VkClusterAccelerationStructureTriangleClusterInputNV-pNext-pNext
    pNext must be NULL

  • VUID-VkClusterAccelerationStructureTriangleClusterInputNV-vertexFormat-parameter
    vertexFormat must be a valid VkFormat value

See Also

Document Notes

For more information, see the Vulkan Specification

This page is extracted from the Vulkan Specification. Fixes and changes should be made to the Specification, not directly.

Copyright 2014-2025 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0