Capítulo 458 de 859

Chapter 458: RecurrentDenoiseNode

Core Idea

Post processing node for denoising temporally-accumulated screen-space effects such as SSGI (ambient occlusion / indirect diffuse) and SSR (specular reflections).

The denoising kernel is selected at construction time via mode: 'diffuse' (SSGI) or 'specular' (SSR). The kernel uses a fixed 8-sample Vogel disk.

Key Concepts

  • accumulate : boolean: When true, apply temporal blending after spatial denoising. When false, output spatially filtered colour only (alpha is passed through …
  • alphaSource : DenoiseAlphaSource: Which channel of the raw texture drives alpha-based edge stopping. 'raylength' — alpha encodes SSR ray length; 'ao' — alpha encodes AO …
  • mode : DenoiseMode: Denoising kernel type.

Code Examples

import { recurrentDenoise } from 'three/addons/tsl/display/RecurrentDenoiseNode.js';
  • What it demonstrates: Typical usage of RecurrentDenoiseNode.

Reference Tables

Constructor

Signature
new RecurrentDenoiseNode( inputTexture : TextureNode, camera : Camera, options : RecurrentDenoiseNodeOptions )

Properties

PropertyDescription
.accumulate : booleanWhen true, apply temporal blending after spatial denoising. When false, output spatially filtered colour only (alpha is passed through from the input temporal pass).
.alphaSource : DenoiseAlphaSourceWhich channel of the raw texture drives alpha-based edge stopping. 'raylength' — alpha encodes SSR ray length; 'ao' — alpha encodes AO factor; 'none' — skip alpha-based edge stopping.
.mode : DenoiseModeDenoising kernel type.

Methods

MethodDescription
.getRenderTarget() : RenderTargetReturns the internal output render target (e.g. for temporal reprojection/SSGI temporal feedback loops).

Key Takeaways

  1. RecurrentDenoiseNode extends: EventDispatcher → Node → TempNode
  2. Most relevant properties: accumulate, alphaSource, mode.
  3. Key methods: getRenderTarget.

Connects To