GFXReconstruct - a tool to capture and replay streams of Vulkan API calls

6 Oct 2022, 11:30
201 (Opus Hall)


Opus Hall

30 S 10th Street, Minneapolis, MN
Talk (full slot, Wineconf and FOSS XR only) Main Track


Brad Grantham (LunarG, Inc.)


LunarG’s GFXReconstruct is a suite of tools for capturing streams of graphics API calls from running Vulkan applications, processing those streams in various ways, and replaying streams on live devices.

GFXReconstruct 1.0 supports capturing and replaying Vulkan API calls on Linux, Android, and Windows. The use cases that drive development of the tool include GPU bringup, driver feature regression testing, and submission of reproducible test cases for bug reporting. The container format is API-agnostic and LunarG plans support for more APIs. A capture file contains all context to replay the captured API call stream and is stored compressed by default.

In this session we’ll introduce GFXReconstruct 1.0. We’ll talk about how we develop gfxreconstruct and how we incorporate community contributions. We’ll show where to get it, how to install binaries, and also how to build it. Using the VK_LAYER_LUNARG_gfxreconstruct Vulkan API layer to capture a Linux application's Vulkan calls, we'll demonstrate how to look at a human-readable dump of those calls and how to replay the captured stream. We'll briefly review the other tools in the GFXReconstruct package too.

LunarG is a software engineering consultancy specializing in 3D graphics software solutions and is an active developer and maintainer of Vulkan Ecosystem components such as the Vulkan Loader, Vulkan Validation Layer, GFXReconstruct, and the Vulkan SDK.

GSoC, EVoC or Outreachy No
Code of Conduct Yes
For which conference do you send the proposal? X.Org Developers Conference 2022

Primary author

Brad Grantham (LunarG, Inc.)

Presentation Materials

2023 Platinum Sponsor
2023 Gold Sponsors
2023 Silver Sponsors
The Linux Foundation
2023 Bronze Sponsors
Khronos Group
2023 Supporters
A Coruña Turismo
Raspberry Pi