DDGI SDK Sample Code

English | 中文

Contents

• Introduction
• Compilation
• Example
• Reference Projects
• Technical Support
• License

Introduction

This project demonstrates how to apply the Dynamic Diffuse Global Illumination (DDGI) SDK provided by Huawei to a forward rendering pipeline on a mobile device to improve the rendering quality. References include the Vulkan example^[1] of SaschaWillems, PBR of Learn OpenGL^[2], and DDGI algorithm implementation of NVIDIA RTXGI^[3].

The following video shows the effect of enabling DDGI for a room model on Mate 40 Pro.

(To obtain the room model, click here; license: CC Attribution)

Compilation

Android/HarmonyOS:

1. Development environment
   • Android Studio 4.0 or later
   • NDK 20.1.5948944 or later
   • Android SDK 29.0.0 or later
   • Java JDK 1.8.0 or later

Set the environment variables ANDROID_HOME and ANDROID_NDK_HOME to point to the Android SDK directory and NDK directory, respectively.

2. Compilation and running
   1. Using the IDE: Use Android Studio to open the android directory, connect to the mobile phone, and click Run or press Shift+F10 to execute the code. The generated APK file is archived in the android\examples\bin directory.
   2. Using the CLI: Connect to the phone using a USB cable, enable the ADB mode, and execute the following commands:

cd android
call .\gradlew clean
call .\gradlew installDebug 	# or `call .\gradlew assembleDebug` for just build apk
adb shell am start -n "com.huawei.ddgi.vkExample/.VulkanActivity"

Windows:

1. Development environment
   • Visual Studio 2019 or later
   • Vulkan SDK 1.2.176.1 or later
   • CMake 3.16 or later
   • Python 3.6.0 or later
2. Perform CMake compilation in the directory where the CMakeLists.txt file of the project is located, open the ddgi-sample.sln file generated after compilation(usually in the build folder), right-click DDGIExample, and choose Set StartUp Projects from the shortcut menu.

Note: If the shader code of the project is modified, run the following command for an update:

python .\data\shaders\glsl\compileshaders.py

Example

This example superimposes the indirect light effect of DDGI on the forward rendering pipeline. The following figure shows the procedure.

To apply DDGI, three phases are involved:

• Initialization: Getthe Vulkan environment context and initialize the DDGI SDK.
• Preparations:
  • Create textures. One is for saving the DDGI irradiance and the other is for saving the normal and depth. Then pass the resolution and the handle of textures to the DDGI SDK;
  • Convert the rendering data into the format required by the DDGI SDK, call the correct API function to pass the data to the DDGI SDK, and call the Prepare function of the DDGI SDK to parse the input data;
  • Set parameters of the DDGI algorithm and pass them to the DDGI SDK.
• Rendering:
  • Update the camera and light source information;
  • Call the Render function of the DDGI SDK to perform rendering. The rendering result will be saved in the textures created in the preparations phase.

The final result of direct lighting and DDGI indirect lighting is shown in the following figure:

Reference Projects

[1] SaschaWillems/Vulkan

[2] learnOpenGL/PBR

[3] Nvidia/RTXGI

Technical Support

If you are still evaluating HMS Core, obtain the latest information about HMS Core and share your insights with other developers at Reddit.

• To resolve development issues, please go to Stack Overflow. You can ask questions below the huawei-mobile-services tag, and Huawei R&D experts can solve your problem online on a one-to-one basis.
• To join the developer discussion, please visit Huawei Developer Forum.

If you have problems using the sample code, submit issues and pull requests to the repository.

License

The sample code is licensed under Apache License 2.0. For details about the license, please refer to LICENSE.md.