LWJGL 3.3.3 · org.lwjgl.vulkan.NVDisplacementMicromap

Ray tracing can very efficiently render from geometry which has very fine detail, but when using only a basic triangle representation, memory consumption can be an issue. This extension adds the ability to add a displacement map to add more detail to triangles in an acceleration structure with an efficient in-memory format. The format is externally visible to allow the application to compress its internal geometry representations into the compressed format ahead of time. This format adds displacements along a defined vector to subtriangle vertices which are subdivided from the main triangles.

This extension provides:

a new VkMicromapTypeEXT format for the displacement micromap,
a structure to extend VkAccelerationStructureGeometryTrianglesDataKHR to attach a displacement micromap to the geometry of the acceleration structure,
enums extending VkBuildAccelerationStructureFlagBitsKHR to allow for updates.

VK_NV_displacement_micromap

Name String

VK_NV_displacement_micromap

Extension Type

Device extension

Registered Extension Number

398

Revision

Extension and Version Dependencies

VK_EXT_opacity_micromap

This is a provisional extension and must be used with caution. See the description of provisional header files for enablement and stability details.

Contact

Christoph Kubisch pixeljetstream
Eric Werness ewerness-nv

Other Extension Metadata

Last Modified Date

2023-03-17

Interactions and External Dependencies

TBD

Contributors

Christoph Kubisch, NVIDIA
Eric Werness, NVIDIA

Field Summary

Modifier and Type	Field and Description
public static final int	VK_BUILD_ACCELERATION_STRUCTURE_ALLOW_DISPLACEMENT_MICROMAP_UPDATE_NV Extends `VkBuildAccelerationStructureFlagBitsKHR`.
public static final int	VK_DISPLACEMENT_MICROMAP_FORMAT_1024_TRIANGLES_128_BYTES_NV VkDisplacementMicromapFormatNV - Format enum for displacement micromaps Description `DISPLACEMENT_MICROMAP_FORMAT_64_TRIANGLES_64_BYTES_NV` indicates that the given micromap format encodes 64 micro-triangles worth of displacements in 64 bytes as described in Displacement Micromap Encoding. `DISPLACEMENT_MICROMAP_FORMAT_256_TRIANGLES_128_BYTES_NV` indicates that the given micromap format encodes 256 micro-triangles worth of displacements in 128 bytes as described in Displacement Micromap Encoding. `DISPLACEMENT_MICROMAP_FORMAT_1024_TRIANGLES_128_BYTES_NV` indicates that the given micromap format encodes 1024 micro-triangles worth of displacements in 128 bytes as described in Displacement Micromap Encoding.
public static final int	VK_DISPLACEMENT_MICROMAP_FORMAT_256_TRIANGLES_128_BYTES_NV VkDisplacementMicromapFormatNV - Format enum for displacement micromaps Description `DISPLACEMENT_MICROMAP_FORMAT_64_TRIANGLES_64_BYTES_NV` indicates that the given micromap format encodes 64 micro-triangles worth of displacements in 64 bytes as described in Displacement Micromap Encoding. `DISPLACEMENT_MICROMAP_FORMAT_256_TRIANGLES_128_BYTES_NV` indicates that the given micromap format encodes 256 micro-triangles worth of displacements in 128 bytes as described in Displacement Micromap Encoding. `DISPLACEMENT_MICROMAP_FORMAT_1024_TRIANGLES_128_BYTES_NV` indicates that the given micromap format encodes 1024 micro-triangles worth of displacements in 128 bytes as described in Displacement Micromap Encoding.
public static final int	VK_DISPLACEMENT_MICROMAP_FORMAT_64_TRIANGLES_64_BYTES_NV VkDisplacementMicromapFormatNV - Format enum for displacement micromaps Description `DISPLACEMENT_MICROMAP_FORMAT_64_TRIANGLES_64_BYTES_NV` indicates that the given micromap format encodes 64 micro-triangles worth of displacements in 64 bytes as described in Displacement Micromap Encoding. `DISPLACEMENT_MICROMAP_FORMAT_256_TRIANGLES_128_BYTES_NV` indicates that the given micromap format encodes 256 micro-triangles worth of displacements in 128 bytes as described in Displacement Micromap Encoding. `DISPLACEMENT_MICROMAP_FORMAT_1024_TRIANGLES_128_BYTES_NV` indicates that the given micromap format encodes 1024 micro-triangles worth of displacements in 128 bytes as described in Displacement Micromap Encoding.
public static final int	VK_MICROMAP_TYPE_DISPLACEMENT_MICROMAP_NV Extends `VkMicromapTypeEXT`.
public static final String	VK_NV_DISPLACEMENT_MICROMAP_EXTENSION_NAME The extension name.
public static final int	VK_NV_DISPLACEMENT_MICROMAP_SPEC_VERSION The extension specification version.
public static final int	VK_PIPELINE_CREATE_RAY_TRACING_DISPLACEMENT_MICROMAP_BIT_NV Extends `VkPipelineCreateFlagBits`.
public static final int	VK_STRUCTURE_TYPE_ACCELERATION_STRUCTURE_TRIANGLES_DISPLACEMENT_MICROMAP_NV Extends `VkStructureType`.
public static final int	VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DISPLACEMENT_MICROMAP_FEATURES_NV Extends `VkStructureType`.
public static final int	VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DISPLACEMENT_MICROMAP_PROPERTIES_NV Extends `VkStructureType`.

Access	Constructor and Description
private	NVDisplacementMicromap()

Method Summary

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

VK_BUILD_ACCELERATION_STRUCTURE_ALLOW_DISPLACEMENT_MICROMAP_UPDATE_NV	back to summary
public static final int VK_BUILD_ACCELERATION_STRUCTURE_ALLOW_DISPLACEMENT_MICROMAP_UPDATE_NV Extends `VkBuildAccelerationStructureFlagBitsKHR`.

VK_DISPLACEMENT_MICROMAP_FORMAT_1024_TRIANGLES_128_BYTES_NV back to summary

VK_DISPLACEMENT_MICROMAP_FORMAT_1024_TRIANGLES_128_BYTES_NV	back to summary
public static final int VK_DISPLACEMENT_MICROMAP_FORMAT_1024_TRIANGLES_128_BYTES_NV VkDisplacementMicromapFormatNV - Format enum for displacement micromaps Description `DISPLACEMENT_MICROMAP_FORMAT_64_TRIANGLES_64_BYTES_NV` indicates that the given micromap format encodes 64 micro-triangles worth of displacements in 64 bytes as described in Displacement Micromap Encoding. `DISPLACEMENT_MICROMAP_FORMAT_256_TRIANGLES_128_BYTES_NV` indicates that the given micromap format encodes 256 micro-triangles worth of displacements in 128 bytes as described in Displacement Micromap Encoding. `DISPLACEMENT_MICROMAP_FORMAT_1024_TRIANGLES_128_BYTES_NV` indicates that the given micromap format encodes 1024 micro-triangles worth of displacements in 128 bytes as described in Displacement Micromap Encoding. Note For compactness, these values are stored as 16-bit in some structures.

public static final int VK_DISPLACEMENT_MICROMAP_FORMAT_1024_TRIANGLES_128_BYTES_NV

VkDisplacementMicromapFormatNV - Format enum for displacement micromaps

Description

DISPLACEMENT_MICROMAP_FORMAT_64_TRIANGLES_64_BYTES_NV indicates that the given micromap format encodes 64 micro-triangles worth of displacements in 64 bytes as described in Displacement Micromap Encoding.
DISPLACEMENT_MICROMAP_FORMAT_256_TRIANGLES_128_BYTES_NV indicates that the given micromap format encodes 256 micro-triangles worth of displacements in 128 bytes as described in Displacement Micromap Encoding.
DISPLACEMENT_MICROMAP_FORMAT_1024_TRIANGLES_128_BYTES_NV indicates that the given micromap format encodes 1024 micro-triangles worth of displacements in 128 bytes as described in Displacement Micromap Encoding.

Note

For compactness, these values are stored as 16-bit in some structures.

VK_DISPLACEMENT_MICROMAP_FORMAT_256_TRIANGLES_128_BYTES_NV back to summary

VK_DISPLACEMENT_MICROMAP_FORMAT_256_TRIANGLES_128_BYTES_NV	back to summary
public static final int VK_DISPLACEMENT_MICROMAP_FORMAT_256_TRIANGLES_128_BYTES_NV VkDisplacementMicromapFormatNV - Format enum for displacement micromaps Description `DISPLACEMENT_MICROMAP_FORMAT_64_TRIANGLES_64_BYTES_NV` indicates that the given micromap format encodes 64 micro-triangles worth of displacements in 64 bytes as described in Displacement Micromap Encoding. `DISPLACEMENT_MICROMAP_FORMAT_256_TRIANGLES_128_BYTES_NV` indicates that the given micromap format encodes 256 micro-triangles worth of displacements in 128 bytes as described in Displacement Micromap Encoding. `DISPLACEMENT_MICROMAP_FORMAT_1024_TRIANGLES_128_BYTES_NV` indicates that the given micromap format encodes 1024 micro-triangles worth of displacements in 128 bytes as described in Displacement Micromap Encoding. Note For compactness, these values are stored as 16-bit in some structures.

public static final int VK_DISPLACEMENT_MICROMAP_FORMAT_256_TRIANGLES_128_BYTES_NV

VkDisplacementMicromapFormatNV - Format enum for displacement micromaps

Description

DISPLACEMENT_MICROMAP_FORMAT_64_TRIANGLES_64_BYTES_NV indicates that the given micromap format encodes 64 micro-triangles worth of displacements in 64 bytes as described in Displacement Micromap Encoding.
DISPLACEMENT_MICROMAP_FORMAT_256_TRIANGLES_128_BYTES_NV indicates that the given micromap format encodes 256 micro-triangles worth of displacements in 128 bytes as described in Displacement Micromap Encoding.
DISPLACEMENT_MICROMAP_FORMAT_1024_TRIANGLES_128_BYTES_NV indicates that the given micromap format encodes 1024 micro-triangles worth of displacements in 128 bytes as described in Displacement Micromap Encoding.

Note

For compactness, these values are stored as 16-bit in some structures.

VK_DISPLACEMENT_MICROMAP_FORMAT_64_TRIANGLES_64_BYTES_NV back to summary

VK_DISPLACEMENT_MICROMAP_FORMAT_64_TRIANGLES_64_BYTES_NV	back to summary
public static final int VK_DISPLACEMENT_MICROMAP_FORMAT_64_TRIANGLES_64_BYTES_NV VkDisplacementMicromapFormatNV - Format enum for displacement micromaps Description `DISPLACEMENT_MICROMAP_FORMAT_64_TRIANGLES_64_BYTES_NV` indicates that the given micromap format encodes 64 micro-triangles worth of displacements in 64 bytes as described in Displacement Micromap Encoding. `DISPLACEMENT_MICROMAP_FORMAT_256_TRIANGLES_128_BYTES_NV` indicates that the given micromap format encodes 256 micro-triangles worth of displacements in 128 bytes as described in Displacement Micromap Encoding. `DISPLACEMENT_MICROMAP_FORMAT_1024_TRIANGLES_128_BYTES_NV` indicates that the given micromap format encodes 1024 micro-triangles worth of displacements in 128 bytes as described in Displacement Micromap Encoding. Note For compactness, these values are stored as 16-bit in some structures.

public static final int VK_DISPLACEMENT_MICROMAP_FORMAT_64_TRIANGLES_64_BYTES_NV

VkDisplacementMicromapFormatNV - Format enum for displacement micromaps

Description

DISPLACEMENT_MICROMAP_FORMAT_64_TRIANGLES_64_BYTES_NV indicates that the given micromap format encodes 64 micro-triangles worth of displacements in 64 bytes as described in Displacement Micromap Encoding.
DISPLACEMENT_MICROMAP_FORMAT_256_TRIANGLES_128_BYTES_NV indicates that the given micromap format encodes 256 micro-triangles worth of displacements in 128 bytes as described in Displacement Micromap Encoding.
DISPLACEMENT_MICROMAP_FORMAT_1024_TRIANGLES_128_BYTES_NV indicates that the given micromap format encodes 1024 micro-triangles worth of displacements in 128 bytes as described in Displacement Micromap Encoding.

Note

For compactness, these values are stored as 16-bit in some structures.

VK_MICROMAP_TYPE_DISPLACEMENT_MICROMAP_NV	back to summary
public static final int VK_MICROMAP_TYPE_DISPLACEMENT_MICROMAP_NV Extends `VkMicromapTypeEXT`.

VK_NV_DISPLACEMENT_MICROMAP_EXTENSION_NAME	back to summary
public static final String VK_NV_DISPLACEMENT_MICROMAP_EXTENSION_NAME The extension name.

VK_NV_DISPLACEMENT_MICROMAP_SPEC_VERSION	back to summary
public static final int VK_NV_DISPLACEMENT_MICROMAP_SPEC_VERSION The extension specification version.

VK_PIPELINE_CREATE_RAY_TRACING_DISPLACEMENT_MICROMAP_BIT_NV	back to summary
public static final int VK_PIPELINE_CREATE_RAY_TRACING_DISPLACEMENT_MICROMAP_BIT_NV Extends `VkPipelineCreateFlagBits`.

VK_STRUCTURE_TYPE_ACCELERATION_STRUCTURE_TRIANGLES_DISPLACEMENT_MICROMAP_NV back to summary

VK_STRUCTURE_TYPE_ACCELERATION_STRUCTURE_TRIANGLES_DISPLACEMENT_MICROMAP_NV	back to summary
public static final int VK_STRUCTURE_TYPE_ACCELERATION_STRUCTURE_TRIANGLES_DISPLACEMENT_MICROMAP_NV Extends `VkStructureType`. Enum values: `STRUCTURE_TYPE_PHYSICAL_DEVICE_DISPLACEMENT_MICROMAP_FEATURES_NV` `STRUCTURE_TYPE_PHYSICAL_DEVICE_DISPLACEMENT_MICROMAP_PROPERTIES_NV` `STRUCTURE_TYPE_ACCELERATION_STRUCTURE_TRIANGLES_DISPLACEMENT_MICROMAP_NV`

public static final int VK_STRUCTURE_TYPE_ACCELERATION_STRUCTURE_TRIANGLES_DISPLACEMENT_MICROMAP_NV

Extends VkStructureType.

Enum values:

VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DISPLACEMENT_MICROMAP_FEATURES_NV back to summary

VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DISPLACEMENT_MICROMAP_FEATURES_NV	back to summary
public static final int VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DISPLACEMENT_MICROMAP_FEATURES_NV Extends `VkStructureType`. Enum values: `STRUCTURE_TYPE_PHYSICAL_DEVICE_DISPLACEMENT_MICROMAP_FEATURES_NV` `STRUCTURE_TYPE_PHYSICAL_DEVICE_DISPLACEMENT_MICROMAP_PROPERTIES_NV` `STRUCTURE_TYPE_ACCELERATION_STRUCTURE_TRIANGLES_DISPLACEMENT_MICROMAP_NV`

public static final int VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DISPLACEMENT_MICROMAP_FEATURES_NV

Extends VkStructureType.

Enum values:

VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DISPLACEMENT_MICROMAP_PROPERTIES_NV back to summary

VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DISPLACEMENT_MICROMAP_PROPERTIES_NV	back to summary
public static final int VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DISPLACEMENT_MICROMAP_PROPERTIES_NV Extends `VkStructureType`. Enum values: `STRUCTURE_TYPE_PHYSICAL_DEVICE_DISPLACEMENT_MICROMAP_FEATURES_NV` `STRUCTURE_TYPE_PHYSICAL_DEVICE_DISPLACEMENT_MICROMAP_PROPERTIES_NV` `STRUCTURE_TYPE_ACCELERATION_STRUCTURE_TRIANGLES_DISPLACEMENT_MICROMAP_NV`

public static final int VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DISPLACEMENT_MICROMAP_PROPERTIES_NV

Extends VkStructureType.

public final Class NVDisplacementMicromap

VK_NV_displacement_micromap

Other Extension Metadata

Field Summary

Constructor Summary

Method Summary

Field Detail

Description

Note

Description

Note

Description

Note

Enum values:

Enum values:

Enum values:

Constructor Detail