textmode.filters.js / BloomOptions

Interface: BloomOptions

Configuration options for the 'bloom' filter.

Creates a glow effect around bright areas of the image. Pixels above the brightness threshold emit a soft glow that spreads outward. Perfect for creating neon, glowing text, or dreamy effects.

Example

const t = textmode.create({
  width: window.innerWidth,
  height: window.innerHeight,
  plugins: [FiltersPlugin],
});

let video;

t.setup(async () => {
  video = await t.loadVideo('https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4');
  video.play();
  video.loop();
  video.characters(' .:-=+*#%@');
});

t.draw(() => {
  t.background(0);
  if (video) {
    t.image(video, t.grid.cols, t.grid.rows);
  }

  const wobble = Math.sin(t.secs * 2);
  t.layers.base.filter('bloom', {
    threshold: 0.5,
    intensity: 1.2 + wobble * 0.5,
    radius: 6 + wobble * 2,
  });
});

t.windowResized(() => {
  t.resizeCanvas(window.innerWidth, window.innerHeight);
});

Properties

Property	Type	Description
threshold	number	Brightness level above which pixels will glow. - 0.0 = everything glows - 0.5 = mid-brightness and above glows (default) - 1.0 = only the brightest pixels glow Default 0.5
intensity	number	Strength of the glow effect. - 0.0 = no visible glow - 1.0 = normal glow intensity (default) - 2.0+ = very bright, intense glow Default 1.0
radius	number	Size of the glow spread in pixels. Larger values create a wider, softer glow. - 1.0 = tight glow - 4.0 = moderate spread (default) - 10.0+ = wide, diffuse glow Default 4.0