VkPhysicalDeviceOpacityMicromapPropertiesKHR(3)

# VkPhysicalDeviceOpacityMicromapPropertiesKHR(3) Manual Page

## Name

VkPhysicalDeviceOpacityMicromapPropertiesKHR - Structure describing the opacity micromap properties of a physical device

## C Specification

The `VkPhysicalDeviceOpacityMicromapPropertiesKHR` structure is defined as:

    // Provided by VK_KHR_opacity_micromap
    typedef struct VkPhysicalDeviceOpacityMicromapPropertiesKHR {
        VkStructureType    sType;
        void*              pNext;
        uint32_t           maxOpacity2StateSubdivisionLevel;
        uint32_t           maxOpacity4StateSubdivisionLevel;
        uint32_t           maxOpacityLossy4StateSubdivisionLevel;
        uint64_t           maxMicromapTriangles;
    } VkPhysicalDeviceOpacityMicromapPropertiesKHR;

## Members

- `sType` is a VkStructureType value identifying this structure.

- `pNext` is `NULL` or a pointer to a structure extending this structure.

- `maxOpacity2StateSubdivisionLevel` is the maximum allowed `subdivisionLevel` when `format` is VK_OPACITY_MICROMAP_FORMAT_2_STATE_KHR.

- `maxOpacity4StateSubdivisionLevel` is the maximum allowed `subdivisionLevel` when `format` is VK_OPACITY_MICROMAP_FORMAT_4_STATE_KHR and the micromap is not built with VK_BUILD_ACCELERATION_STRUCTURE_MICROMAP_LOSSY_BIT_KHR.

- `maxOpacityLossy4StateSubdivisionLevel` is the maximum allowed `subdivisionLevel` when `format` is VK_OPACITY_MICROMAP_FORMAT_4_STATE_KHR and the micromap is built with VK_BUILD_ACCELERATION_STRUCTURE_MICROMAP_LOSSY_BIT_KHR.

- `maxMicromapTriangles` limits the number of triangles allowed to be specified when building a micromap

## Description

If the `VkPhysicalDeviceOpacityMicromapPropertiesKHR` structure is included in the `pNext` chain of the VkPhysicalDeviceProperties2 structure passed to vkGetPhysicalDeviceProperties2, it is filled in with each corresponding implementation-dependent property.

Valid Usage (Implicit)

- VUID-VkPhysicalDeviceOpacityMicromapPropertiesKHR-sType-sType
  `sType` must be VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_OPACITY_MICROMAP_PROPERTIES_KHR

Structure Chaining

Extends the structure

  - VkPhysicalDeviceProperties2

## See Also

VK_KHR_opacity_micromap, 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