VkClusterAccelerationStructureInstantiateClusterInfoNV(3)

# VkClusterAccelerationStructureInstantiateClusterInfoNV(3) Manual Page

## Name

VkClusterAccelerationStructureInstantiateClusterInfoNV - Parameters describing instantiate operation for a template cluster acceleration structure

## C Specification

The VkClusterAccelerationStructureInstantiateClusterInfoNV structure is defined as:

    // Provided by VK_NV_cluster_acceleration_structure
    typedef struct VkClusterAccelerationStructureInstantiateClusterInfoNV {
        uint32_t                    clusterIdOffset;
        uint32_t                    geometryIndexOffset:24;
        uint32_t                    reserved:8;
        VkDeviceAddress             clusterTemplateAddress;
        VkStridedDeviceAddressNV    vertexBuffer;
    } VkClusterAccelerationStructureInstantiateClusterInfoNV;

## Members

- `clusterIdOffset` is an unsigned offset applied to the `clusterID` value stored in the cluster template.

- `geometryIndexOffset` is a signed offset applied to the geometry index of each triangle.

- `reserved` is reserved for future use.

- `clusterTemplateAddress` is the address of a previously built cluster template.

- `vertexBuffer` is a VkStridedDeviceAddressNV structure containing the vertex data for the indexed triangles stored in the cluster template. If the address in VkStridedDeviceAddressNV is `0` the vertex data is sourced from the cluster template.

## Description

Valid Usage

- VUID-VkClusterAccelerationStructureInstantiateClusterInfoNV-vertexBuffer-10507
  `vertexBuffer` must not be `0` if the template was built without vertex data

- VUID-VkClusterAccelerationStructureInstantiateClusterInfoNV-vertexBuffer-10508
  The format in `vertexBuffer` must match the original format specified in VkClusterAccelerationStructureTriangleClusterInputNV

- VUID-VkClusterAccelerationStructureInstantiateClusterInfoNV-reserved-10509
  `reserved` must be `0`

- VUID-VkClusterAccelerationStructureInstantiateClusterInfoNV-geometryIndexOffset-10510
  The maximum geometry index after using the value in `geometryIndexOffset` must be less than VkPhysicalDeviceClusterAccelerationStructurePropertiesNV::`maxClusterGeometryIndex`

Valid Usage (Implicit)

- VUID-VkClusterAccelerationStructureInstantiateClusterInfoNV-clusterTemplateAddress-parameter
  `clusterTemplateAddress` must be a valid VkDeviceAddress value

## See Also

VK_NV_cluster_acceleration_structure, VkDeviceAddress, VkStridedDeviceAddressNV

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