VkClusterAccelerationStructureTriangleClusterInputNV(3)

# VkClusterAccelerationStructureTriangleClusterInputNV(3) Manual Page

## Name

VkClusterAccelerationStructureTriangleClusterInputNV - Parameters describing a cluster acceleration structure

## C Specification

The VkClusterAccelerationStructureTriangleClusterInputNV structure is defined as:

    // 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

VK_NV_cluster_acceleration_structure, VkClusterAccelerationStructureOpInputNV, VkFormat, VkStructureType

## 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

Copyright 2014-2026 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0