VkClusterAccelerationStructureInstantiateClusterInfoNV(3)

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 either 0 or a VkStridedDeviceAddressNV structure containing the vertex data for the indexed triangles stored in 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.