title: BloomNode category: Addons layout: docs

BloomNode

Post processing node for creating a bloom effect.

By default, the node affects the entire image. For a selective bloom, use the emissive material property to control which objects should contribute to bloom or not. This can be achieved via MRT.

const postProcessing = new THREE.PostProcessing( renderer );
const scenePass = pass( scene, camera );
scenePass.setMRT( mrt( {
	output,
	emissive
} ) );
const scenePassColor = scenePass.getTextureNode( 'output' );
const emissivePass = scenePass.getTextureNode( 'emissive' );
const bloomPass = bloom( emissivePass );
postProcessing.outputNode = scenePassColor.add( bloomPass );

Code Example

const postProcessing = new THREE.PostProcessing( renderer );
const scenePass = pass( scene, camera );
const scenePassColor = scenePass.getTextureNode( 'output' );
const bloomPass = bloom( scenePassColor );
postProcessing.outputNode = scenePassColor.add( bloomPass );

Import

BloomNode is an addon, and must be imported explicitly, see Installation#Addons.

import { bloom } from 'three/addons/tsl/display/BloomNode.js';

Constructor

new BloomNode( inputNode : Node.<vec4>, strength : number, radius : number, threshold : number )

Constructs a new bloom node.

inputNode | The node that represents the input of the effect.
---|---
strength | The strength of the bloom. Default is 1.
radius | The radius of the bloom. Default is 0.
threshold | The luminance threshold limits which bright areas contribute to the bloom effect. Default is 0.