AMD FSR™ Ray Regeneration Sample

This sample demonstrates how to integrate and experiment with AMD FSR™ Ray Regeneration 1.2.1, a real-time ray-tracing denoising solution designed to improve the stability and visual quality of ray-traced lighting signals.

For details on the underlying algorithm, refer to the AMD FSR™ Ray Regeneration technique documentation.

Table of contents

• 1. Requirements
• 2. UI elements
  • 2.1. Provider
  • 2.2. Context creation
  • 2.3. Configure
  • 2.4. Dispatch
  • 2.5. Display
• 3. Setting up AMD FSR™ Ray Regeneration
• 4. Sample controls and configurations
• 5. See also

1. Requirements

• AMD FSR™ Ray Regeneration requires an AMD Radeon™ RX 9000 Series GPU or later.
• DirectX® 12 + Shader Model 6.6
• Windows® 11

Note

AMD FSR™ Ray Regeneration is only supported on AMD Radeon™ RX 9000 Series GPUs or newer. On unsupported GPUs, the sample will still run, but denoising features will be disabled.

2. UI elements

The sample contains various UI elements to help you explore the techniques it demonstrates. The tables below summarize the UI elements and what they control within the sample.

2.1. Provider

Element name	Values	Description
Version	AMD FSR™ Ray Regeneration - 1.2.1	Dropdown for specifying the provider. Sets the corresponding versionId member of the ffxOverrideVersion description.

2.2. Context creation

Element name	Values	Description
Enable direct diffuse denoising	Checked, Unchecked	Checkbox for specifying whether the direct diffuse radiance should be denoised. Toggles the FFX_DENOISER_SIGNAL_DIRECT_DIFFUSE flag to the signalFlags member of the ffxCreateContextDescDenoiser context creation description.
Enable direct specular denoising	Checked, Unchecked	Checkbox for specifying whether the direct specular radiance should be denoised. Toggles the FFX_DENOISER_SIGNAL_DIRECT_SPECULAR flag to the signalFlags member of the ffxCreateContextDescDenoiser context creation description.
Enable indirect diffuse denoising	Checked, Unchecked	Checkbox for specifying whether the indirect diffuse radiance should be denoised. Toggles the FFX_DENOISER_SIGNAL_INDIRECT_DIFFUSE flag to the signalFlags member of the ffxCreateContextDescDenoiser context creation description.
Enable indirect specular denoising	Checked, Unchecked	Checkbox for specifying whether the indirect specular radiance should be denoised. Toggles the FFX_DENOISER_SIGNAL_INDIRECT_SPECULAR flag to the signalFlags member of the ffxCreateContextDescDenoiser context creation description.
Enable dominant light visibility denoising	Checked, Unchecked	Checkbox for specifying whether the dominant light visibility should be denoised. Toggles the FFX_DENOISER_SIGNAL_DOMINANT_LIGHT_VISIBILITY flag to the signalFlags member of the ffxCreateContextDescDenoiser context creation description.
Enable separate dominant light visibility denoising	Checked, Unchecked	Checkbox for specifying whether the dominant light visibility signal is denoised by its own dedicated context instead of the main one. Only available when dominant light visibility denoising is enabled. When checked, the sample creates a second ffxCreateContextDescDenoiser context whose signalFlags contains only FFX_DENOISER_SIGNAL_DOMINANT_LIGHT_VISIBILITY, and removes that flag from the main context. Both contexts receive the same ffxDispatchDescDenoiser frame parameters and are dispatched separately. This is exposition only, to demonstrate driving multiple denoiser contexts; in production the two dispatches can occur at different points in the frame.
Enable ambient occlusion denoising	Checked, Unchecked	Checkbox for specifying whether the ambient occlusion should be denoised. Toggles the FFX_DENOISER_SIGNAL_AMBIENT_OCCLUSION flag to the signalFlags member of the ffxCreateContextDescDenoiser context creation description.
Enable specular occlusion denoising	Checked, Unchecked	Checkbox for specifying whether the specular occlusion should be denoised. Toggles the FFX_DENOISER_SIGNAL_SPECULAR_OCCLUSION flag to the signalFlags member of the ffxCreateContextDescDenoiser context creation description.
Enable checkerboarding	Checked, Unchecked	Checkbox for specifying whether the enabled signals are supplied in checkerboard (half-resolution) form for reconstruction. When checked, the sample sets the checkerboardSignalFlags member of the ffxCreateContextDescDenoiser context creation description to the enabled signals, and sets the per-signal checkerboardOrigin each frame.
Enable debugging	Checked, Unchecked	Checkbox for specifying whether debugging should be enabled. Toggles the FFX_DENOISER_ENABLE_DEBUGGING flag to the flags member of the ffxCreateContextDescDenoiser context creation description.
Enable validation	Checked, Unchecked	Checkbox for specifying whether exhaustive validation should be enabled. Toggles the FFX_DENOISER_ENABLE_VALIDATION flag to the flags member of the ffxCreateContextDescDenoiser context creation description.

2.3. Configure

Element name	Values	Description
Cross bilateral normal strength	[0.0, 1.0]	Sets the FFX_API_CONFIGURE_DENOISER_KEY_CROSS_BILATERAL_NORMAL_STRENGTH configuration parameter.
Disocclusion threshold	[0.01, 0.05]	Sets the FFX_API_CONFIGURE_DENOISER_KEY_DISOCCLUSION_THRESHOLD configuration parameter.
Gaussian kernel relaxation	[0.0, 1.0]	Sets the FFX_API_CONFIGURE_DENOISER_KEY_GAUSSIAN_KERNEL_RELAXATION configuration parameter.
Max radiance	[0.0, 65504.0]	Sets the FFX_API_CONFIGURE_DENOISER_KEY_MAX_RADIANCE configuration parameter.
Radiance std clip	[0.0, 65504.0]	Sets the FFX_API_CONFIGURE_DENOISER_KEY_RADIANCE_CLIP_STD_K configuration parameter.
Stability bias	[0.0, 1.0]	Sets the FFX_API_CONFIGURE_DENOISER_KEY_STABILITY_BIAS configuration parameter.
Debug view linear depth max bound	[0.001, 1024.0]	Sets the max field of the FFX_API_CONFIGURE_DENOISER_KEY_DEBUG_VIEW_LINEAR_DEPTH_BOUNDS configuration parameter. Only the max bound is exposed in the sample UI; the min bound is set programmatically.

2.4. Dispatch

Element name	Values	Description
Reset	NA	Button for resetting the history accumulation. Toggles the FFX_DENOISER_DISPATCH_RESET flag to the flags member of the ffxDispatchDescDenoiser dispatch description.

2.5. Display

Element name	Values	Description
View mode (left)	Denoised Composited, Denoised Composited - Direct, Denoised Composited - Direct Diffuse, Denoised Composited - Direct Specular, Denoised Composited - Indirect, Denoised Composited - Indirect Diffuse, Denoised Composited - Indirect Specular, Denoised Composited - Dominant Light Visibility, Denoised Signal - Direct Diffuse, Denoised Signal - Direct Specular, Denoised Signal - Indirect Diffuse, Denoised Signal - Indirect Specular, Denoised Signal - Dominant Light Visibility, Denoised Signal - Ambient Occlusion, Denoised Signal - Specular Occlusion, Noisy Composited, Noisy Composited - Direct, Noisy Composited - Direct Diffuse, Noisy Composited - Direct Specular, Noisy Composited - Indirect, Noisy Composited - Indirect Diffuse, Noisy Composited - Indirect Specular, Noisy Composited - Dominant Light Visibility, Noisy Signal - Direct Diffuse, Noisy Signal - Direct Specular, Noisy Signal - Indirect Diffuse, Noisy Signal - Indirect Specular, Noisy Signal - Dominant Light Visibility, Noisy Signal - Ambient Occlusion, Noisy Signal - Specular Occlusion, Skip, Diffuse Albedo, Specular Albedo, Roughness, Linear Depth, Linear Depth Delta, Motion Vectors, Normals	Dropdown for specifying the view mode to display. When View mode (right) differs from this, it is shown on the left side of the split comparison; otherwise it fills the screen.
View mode (right)	Denoised Composited, Denoised Composited - Direct, Denoised Composited - Direct Diffuse, Denoised Composited - Direct Specular, Denoised Composited - Indirect, Denoised Composited - Indirect Diffuse, Denoised Composited - Indirect Specular, Denoised Composited - Dominant Light Visibility, Denoised Signal - Direct Diffuse, Denoised Signal - Direct Specular, Denoised Signal - Indirect Diffuse, Denoised Signal - Indirect Specular, Denoised Signal - Dominant Light Visibility, Denoised Signal - Ambient Occlusion, Denoised Signal - Specular Occlusion, Noisy Composited, Noisy Composited - Direct, Noisy Composited - Direct Diffuse, Noisy Composited - Direct Specular, Noisy Composited - Indirect, Noisy Composited - Indirect Diffuse, Noisy Composited - Indirect Specular, Noisy Composited - Dominant Light Visibility, Noisy Signal - Direct Diffuse, Noisy Signal - Direct Specular, Noisy Signal - Indirect Diffuse, Noisy Signal - Indirect Specular, Noisy Signal - Dominant Light Visibility, Noisy Signal - Ambient Occlusion, Noisy Signal - Specular Occlusion, Skip, Diffuse Albedo, Specular Albedo, Roughness, Linear Depth, Linear Depth Delta, Motion Vectors, Normals	Dropdown for specifying the view mode shown on the right side of the split comparison. When it differs from View mode (left), the screen is split by a magenta vertical divider at Split position (left mode on the left, right mode on the right); when equal, no split is drawn.
Split position	[0.0, 1.0]	Slider for specifying the horizontal position of the split divider, as a fraction of the render width from the left edge. Only has an effect when View mode (left) and View mode (right) differ.
R G B A	Checked, Unchecked	Checkboxes for specifying which color channels (i.e. red, green, blue, alpha) of the selected view mode should be displayed.
Show debug view	Checked, Unchecked	Checkbox for specifying whether the debug view should be dispatched and drawn. The debug view requires debugging to be enabled.
Debug view mode	Overview, Fullscreen Target	Dropdown for specifying the debug view mode to display. Sets the corresponding mode member of the ffxDispatchDescDenoiserDebugView dispatch description.
Debug viewport index	[0,FFX_API_DENOISER_DEBUG_VIEW_MAX_VIEWPORTS)	Slider for specifying the debug viewport index for the Fullscreen Target debug view mode. Sets the corresponding viewportIndex member of the ffxDispatchDescDenoiserDebugView dispatch description.

Note

The split comparison operates on the render-resolution signals, before upscaling. For an accurate side-by-side comparison, ideally no upscaler should be used (i.e. fullscreen denoising at native resolution), so that both sides are shown without upscaling artifacts influencing the result.

Note

The noisy composition and signal view modes (Noisy Composited… and Noisy Signal…) are unavailable when Enable checkerboarding is active, because AMD FSR™ Upscaling cannot mix checkerboarded and non-checkerboarded input textures. Selecting one while checkerboarding is enabled falls back to Denoised Composited and logs a warning.

3. Setting up AMD FSR™ Ray Regeneration

The sample includes a dedicated Render Module for AMD FSR™ Ray Regeneration which creates the context and manages its lifetime. See the AMD FSR™ Ray Regeneration technique documentation for more details.

4. Sample controls and configurations

For information on sample controls, configuration options, and Cauldron Framework UI elements, see Running the samples.

5. See also

• AMD FSR™ Ray Regeneration API
• AMD FSR™ Ray Regeneration technique documentation