GFXReconstruct is a suite of tools intended for the purpose of improving application and platform quality by allowing the analysis of capture and replay of graphics command streams. Use cases include, for example, regression testing, silicon and platform bringup, and reporting bugs.

Android binaries to compliment the desktop binaries distributed with the Vulkan SDK.

To successfully capture an application, the GFXReconstruct layer must be able to detect if the application modifies the mapped memory in order to dump the changes in the capture file so that they can be re-applied while replaying. To achieve this GFXR utilizes four different modes:

AMD（超威半导体公司）和LunarG很高兴能告知大家GFXReconstruct capture/replay工具已经支持DirectX®12 (D3D12)和DirectX® Raytracing (DXR)。 LunarG最初设计GFXReconstruct是为了capture/replay Vulkan®应用程序。 这一开源工具可免费使用，并已被Vulkan开发者广泛采用。 经过AMD和LunarG的通力合作，已经使GFXReconstruct扩展到支持使用DirectX生态系统capture/replay应用程序。 D3D12是Windows平台上开发游戏的标准，自其发布以来已经应用 …

2023年9月7日 · This document shows several examples of how to use the GFXReconstruct tools. These examples will help work through issues you may discover while attempting to perform the same process on your own application.

2023年8月7日 · GFXReconstruct lets a developer examine and replay a program’s captured graphics commands after a program has been run. API-agnostic; Vulkan and Direct3D 12 so far! Device memory allocation info: [...] "sType": "VK_STRUCTURE_TYPE_APPLICATION_INFO", "pNext": null, "pApplicationName": "vkcube", [...]

The primary purpose of GFXReconstruct is verbatim playback for regression and application inspection. But it is possible to replay on other drivers, GPUs, vendors, to varying degrees. Trimmed captures contain all objects created before the start of the trim range.

We inject a compute-based replacer or sanitizer pass into the existing VkCommandBuffer used to submit the calls to vkCmdTraceRays or vkCmdBuildAccelerationStructuresKHR. This is a simple hashmap lookup, but on gpu-timeline. We’ll have a strong guarantee that we’ll be last to manipulate any buffer content before submission.

The GFXRconstruct capture process leans on a DLL substitution mechanism to intercept D3D12 API calls. When an application loads the D3D12 or DXGI runtimes, it loads the GFXReconstruct capture libraries instead, which provides a means of API call interception.

Path to use when creating the capture file. Default is: gfxrecon_capture.gfxr. Specify one or more comma-separated frame ranges to capture. Each range will be written to its own file. A frame range can be specified as a single value, to specify a single frame to capture, or as two hyphenated values, to specify the first and last frame to capture.