AMD FidelityFX™ Breadcrumbs library

AMD FidelityFX™ Breadcrumbs library helps you with post-mortem GPU crash analysis. With the breadcrumbs markers technique, you can track down where your submitted commands caused GPU crashes, and save time on analysing whole rendering process in search of faulty commands.

Supports:

DirectX® 12
Vulkan®

Part of the AMD FidelityFX™ SDK

Download the latest version - v1.1.4

Download AMD FidelityFX™ SDK v1.1.4 package View AMD FidelityFX™ SDK on GitHub Read the AMD FidelityFX™ Breadcrumbs documentation

This release of the AMD FidelityFX™ SDK adds the following features:

AMD FidelityFX™ Breadcrumbs 1.0.1.
Additions to the API and fixes for issues discovered.

Introducing the AMD FidelityFX™ Breadcrumbs library

We're proud to introduce a brand-new FidelityFX technology: AMD FidelityFX Breadcrumbs. Breadcrumbs is a cross-platform library for post-morten analysis of GPU crashes.

Features

State-of-the-art algorithm

GPU crash analysis

Highly optimized with low performance impact

Open source, MIT license

Easy to integrate

Cross platform

Details

AMD FidelityFX™ Breadcrumbs library features the following:

Technique aiding in post-mortem analysis of GPU crashes.
Native support for DirectX® 12 and Vulkan® backends for managing breadcrumbs.
Sample application featuring GPU crash for simple investigation.
Properly formatted tree-like structure of breadcrumbs markers allowing for easy post-mortem analysis.
Optional system info to include in crash output file.

For more information, don’t miss our extensive documentation.

Sample output of AMD FidelityFX™ Breadcrumbs

[BREADCRUMBS]
<Frame 250>
- [>] Queue type <0>, submission no. 0, command list 1: "VK test command list"
   ├─[X] RESOURCE_BARRIER: "Backbuffer barrier to RT"
   ├─[>] Main Rendering
   │  ├─[X] CLEAR_RENDER_TARGET: "Reset current backbuffer contents"
   │  └─[>] DRAW_INDEXED: "Draw simple triangle"
   └─[ ] RESOURCE_BARRIER: "Backbuffer barrier to PRESENT"
<Frame 251>
- [ ] Queue type <0>, submission no. 0, command list 1: "VK test command list"
   ├─[ ] RESOURCE_BARRIER: "Backbuffer barrier to RT"
   ├─[ ] Main Rendering
   │  ├─[ ] CLEAR_RENDER_TARGET: "Reset current backbuffer contents"
   │  └─[ ] DRAW_INDEXED: "Draw simple triangle"
   └─[ ] RESOURCE_BARRIER: "Backbuffer barrier to PRESENT"
<Frame 252>
- [ ] Queue type <0>, submission no. 0, command list 1: "VK test command list"
   ├─[ ] RESOURCE_BARRIER: "Backbuffer barrier to RT"
   ├─[ ] Main Rendering
   │  ├─[ ] CLEAR_RENDER_TARGET: "Reset current backbuffer contents"
   │  └─[ ] DRAW_INDEXED: "Draw simple triangle"
   └─[ ] RESOURCE_BARRIER: "Backbuffer barrier to PRESENT"

Requirements

For DirectX® 12 backend, SDK and runtime with support for ID3D12Device3.
For Vulkan® backend, any version of SDK installed in the system.

Version history

The AMD FidelityFX™ SDK 1.1.4 is a patch release that includes additions to API and fixes for issues discovered with AMD FSR 3.1.0 to 3.1.3.
Exposed 4 new tunings to reduce AMD FSR upscaler ghosting in newly disoccludded pixels or highly reactive pixels.
Changed the default value of fMinDisocclusionAccumulation to -0.333 (from equivalent of 0.333 in AMD FSR 3.1.3) to reduce disocclusion ghosting.
Added ffxQueryGetProviderVersion to get version info from created ffx-api context.
Exposed ffxDispatchDescFrameGenerationPrepareCameraInfo as a linked struct. It is a required input to AMD FSR 3.1.4 and onwards for best quality.
Added frame generation debug checker support.
Dropped unused interpolation command lists if frame generation callback fails, to fix infinite wait at swapchain destruction.
General fixes to Vulkan® Frame Interpolation Swapchain.
General framework fixes and updates.
Frame pacing debug line added to Vulkan®.
Added new FFX error when create frame interpolation swapchain results in E_ACCESSDENIED in DX12 due to overlay or capture software.
Enabled support for frame interpolation swapchain on Windows® 10 1909 and potentially earlier versions.
Fixed flipped disocclusion factor from previous and current backbuffer.
Fixed HDR mode issues in Cauldron sample.
Fixed MSVC C compile errors including ffx-api.
The AMD FidelityFX™ SDK 1.1.4 also updates the following to address select issues:
AMD FidelityFX™ Brixelizer GI 1.0.1
AMD FidelityFX™ Breadcrumbs 1.0.1