Opacity Micro-Maps (OMMs) are used to accelerate raytracing of high detail geometry by efficiently encoding the opacity states of micro-triangles and micro meshes. This technology encodes the opacity of micro-triangles and makes it possible to trace rays, at high performance, extremely detailed scene elements such as vegetation and foliage. Traditionally high detail opacity information is constructed via alpha textures, however, for raytracing this normally involves costly alpha evaluation in shaders to generate the desired result. Opacity Micro-Maps is a solution that can either remove the need for shader invocations entirely (by approximating the original geometry), or drastically reduce the number required of shader invocations without any loss in quality. OMMs will generally be an accelerator for applications that have traditional alpha testing or alpha blending as part of the raytracing workloads.
Opacity Micro-Maps is supported for raytracing in D3D12 (via NvAPI), VK and NVIDIA OptiX. For details on the data-structures and API usage please see prerequisites for links and details.
Opacity Micro-Map SDK is used to automatically convert existing alpha tested or alpha blended assets to opacity micro-maps without the need to manually convert existing, or author new, content. The asset-to-OMM conversion is done entirely by the SDK by parsing and analyzing the existing alpha texture and geometry to produce highly optimized and efficient OMM data ready direct for consumption by D3D12 or VK. The conversion can either be done at runtime, by the GPU baker, or offline by the CPU baker when pre-processing of assets is more practical. Which version to use depends on the user requirements, capabilities of the build infrastructure and title content. The GPU backend is designed to be executed by the client RHI on either D3D12 or VK. See the SDK integration guide for more in depth discussion.
To read more about OMMs, the SDK and practical integration tips please see the integration guide.
A sample application with the OMM Bake SDK integrated can be found here: Opacity-MicroMap-Samples.
The sample demonstrates OMMs running on D3D12 or Vulkan with both GPU and CPU baking enabled. The sample app runs raytracing with primary rays with specular and diffuse reflections with a configurable number of bounces. Use the UI to tweak the OMM format, subdivision level and other baking parameters. The sample includes a caching mechanism that is meant to illustrate the use of prebaked OMM data.
- See NVIDIA ADA GPU ARCHITECTURE - 2x Faster Alpha Traversal Performance with Opacity Micromap Engine for a technical overview of Opacity Micro-Maps and how they can help accelerate raytracing workloads.
- See NVIDIA Ray Tracing Micro-Mesh for latest news on Micro-Maps and Micro-Meshes.
- See NVAPI 520 (or later) for details on the Opacity Micro-Maps extension for D3D12.
- See VK_EXT_opacity_micromap for details on the Opacity Micro-Maps extension for Vulkan.
- See NVIDIA OptiX and the NVIDIA OptiX Programming Guide which goes in to more detail on the internal layout of the Opacity Micro-Map data format.
-
Clone the repository with all submodules:
git clone --recursive https://github.com/NVIDIAGameWorks/Opacity-MicroMap-SDK.git
If the clone was made non-recursively and the submodules are missing, clone them separately:
git submodule update --init --recursive
-
Configure the solution with CMake. The easiest option is to use CMake GUI.
-
Assuming that the OMM Bake SDK tree is located in
D:\Opacity-MicroMap-SDK, set the following parameters in the GUI:- "Where is the source code" to
D:\Opacity-MicroMap-SDK - "Where to build the binaries" to
D:\Opacity-MicroMap-SDK\build
- "Where is the source code" to
-
Click "Configure", set "Generator" to the Visual Studio you're using (tested with VS 2022 version 17.2.5), set "Optional platform" to x64, click "Finish".
-
Click "Generate", then "Open Project".
-
Build the solution with Visual Studio
-
Either run the
INSTALLproject to generate header and binaries that can be linked to your project, or runTeststo run the unit tests. -
If running
INSTALLthe following binaries will be generated in the cmake output folder which can be used to link to the client application.
%cmake output dir%
└───install
└───include
| └─── omm.h
└───lib
│ └─── omm-sdk.lib
└───bin
└─── omm-sdk.dll
- If running
Testsand CMake have been configured with-DOMM_TEST_ENABLE_IMAGE_DUMPa folder with image files will be located inD:\Opacity-MicroMap-SDK\build\tests\OmmBakeOutputandD:\Opacity-MicroMap-SDK\build\tests\OmmBakeOutput_GPU
-DOMM_STATIC_LIBRARY=ON - Will configure the omm-sdk project as either a SHARED (OFF) or STATIC (ON) target in CMake.
-DOMM_ENABLE_PRECOMPILED_SHADERS_DXIL=ON - Enable this when using the GPU baker with precompiled shaders in D3D12. The DXIL will be part of the generated library files (.dll) and can be used direct to create the nessesary pipeline state objects at runtime. May get disabled if Windows SDK is not found on the system. Required to run GPU Unit Test.
-DOMM_ENABLE_PRECOMPILED_SHADERS_SPIRV=ON - Enable this when using the GPU baker with precompiled shaders in Vulkan. The SPIRV will be part of the generated library files (.dll) and can be used direct to create the nessesary pipeline state objects at runtime. This may get disabled if Vulkan SDK is not found on the system.
-DOMM_SHADER_DEBUG_INFO=OFF - Will include and embed shader debug (-Zi, -Qembed_debug) info when running OMM_ENABLE_PRECOMPILED_SHADERS_DXIL=ON or OMM_ENABLE_PRECOMPILED_SHADERS_SPIRV=ON. Only recommended for debugging purpuses.
-DOMM_ENABLE_OPENMP=ON - The project will include OpenMP to enable parallel execution of the CPU baking lib. This is required for EnableInternalThreads to be effective.
-DOMM_INSTALL=ON - Will configure the INSTALL solution to produce the library files that can be used in other projects. May need to be disable this when running the OMM SDK as submodule.
-DOMM_DISABLE_INTERPROCEDURAL_OPTIMIZATION=ON - Will disable LTO on the project via CMAKE_INTERPROCEDURAL_OPTIMIZATION.
Feel free to file issues directly on the GitHub page or reach out to NVIDIA at opacitymicromap-sdk-support@exchange.nvidia.com