An image is sharp at the edges, soft in the center. You control it. You control the radius.
FFmpeg radius isn’t a setting you stumble upon—it’s a precise tool that changes how pixels blend, how blur or sharpening spreads across a frame. In FFmpeg, the radius parameter defines the range of influence for filters like gblur, boxblur, unsharp, and certain deblocking operations. A small radius tightens the effect; a large radius makes it bleed into neighboring pixels.
When you use gblur, for example:
ffmpeg -i input.mp4 -vf "gblur=sigma=2:steps=1:radius=3"output.mp4
Here, radius=3 sets how far the blur calculates from each pixel. Increase it, and motion softens; decrease it, and detail survives. In sharpening, like with unsharp, the radius dictates the width of detail enhancement—too high, and edges look artificial; too low, and the change is subtle.
Radius in FFmpeg filters is not isolated. It pairs with other parameters like sigma for blur intensity, luma_msize for luminance operations, or kernel sizes in convolution filters. Understanding these relationships lets you design transforms that sculpt footage instead of flattening it.
Advanced workflows often chain radius-dependent filters:
- Apply
boxblur to reduce noise with radius=2. - Follow with
unsharp at radius=1 to tighten edges back up. - Use selective blurring by masking areas, feeding a custom radius per region.
This control scales beyond cosmetic tweaks. Radius-driven blurs are critical for anonymization, depth-of-field simulation, or optical effects in VFX pipelines. In real-time streaming, fine-tuned radius values can preserve perceived clarity while lowering data rates.
The real skill lies in knowing when to push the radius high for smooth gradients, and when to keep it tight for crisp fidelity. FFmpeg makes this exact. No hidden magic—just parameters, code, and math.
If you want to see how fast you can go from idea to live processing, take your FFmpeg radius experiments and deploy them with hoop.dev. Build it, test it, stream it—watch it happen in minutes.