SVGFEGaussianBlurElement: setStdDeviation() method

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

The setStdDeviation() method of the SVGFEGaussianBlurElement interface sets the values for the stdDeviation attribute.

Syntax

js
SVGFEGaussianBlurElement.setStdDeviation(x, y)

Parameters

x

A float representing X component of the stdDeviation attribute.

y

A float representing Y component of the stdDeviation attribute.

Return value

None (undefined).

Examples

Using setStdDeviation()

html
<svg viewBox="0 0 200 200" xmlns="http://www.w3.org/2000/svg">
  <defs>
    <filter id="gaussian-blur-filter">
      <feGaussianBlur
        in="SourceGraphic"
        stdDeviation="5 5"
        result="blurred-graphic" />
    </filter>
  </defs>

  <!-- Rectangle with an initial blur effect -->
  <rect
    x="50"
    y="50"
    width="100"
    height="100"
    style="fill:hotpink;"
    filter="url(#gaussian-blur-filter)" />
</svg>

<!-- Button to update the blur -->
<button id="updateBlur">Update Blur</button>
js
// Get the feGaussianBlur element
const gaussianBlur = document.querySelector("feGaussianBlur");

// Button to trigger the update
document.getElementById("updateBlur").addEventListener("click", () => {
  // Change the standard deviation (blur radius) of the blur effect
  gaussianBlur.setStdDeviation(15, 20); // Update to X: 15, Y: 20
});

Specifications

Specification
Filter Effects Module Level 1
# dom-svgfegaussianblurelement-setstddeviation

Browser compatibility

BCD tables only load in the browser

See also