W3cubDocs

/Web APIs

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

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()`

<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"
    fill="hotpink"
    filter="url(#gaussian-blur-filter)" />
</svg>

<!-- Button to update the blur -->
<button id="updateBlur">Update Blur</button>

// 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

	Desktop					Mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet	WebView Android	WebView on iOS
`setStdDeviation`	5	12	3	≤12.1	6	18	4	≤12.1	6	1.0	4.4	6