SVGFEConvolveMatrixElement: divisor property

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 divisor read-only property of the SVGFEConvolveMatrixElement interface reflects the divisor attribute of the given <feConvolveMatrix> element.

Value

An SVGAnimatedNumber object.

Examples

Access the divisor property

A convolution filter is applied to a rectangle, and the divisor is used to control the brightness.

html
<svg viewBox="0 0 200 200" xmlns="http://www.w3.org/2000/svg">
  <defs>
    <filter id="convolveFilterWithDivisor">
      <feConvolveMatrix
        in="SourceGraphic"
        order="3"
        kernelMatrix="0 -1 0 -1 4 -1 0 -1 0"
        divisor="1" />
    </filter>
  </defs>
  <rect
    x="20"
    y="20"
    width="100"
    height="100"
    style="fill:lightgreen;"
    filter="url(#convolveFilterWithDivisor)" />
</svg>
js
const convolveMatrix = document.querySelector("feConvolveMatrix");

console.log(convolveMatrix.divisor.baseVal); // Output: 1

Specifications

Specification
Filter Effects Module Level 1
# dom-svgfeconvolvematrixelement-divisor

Browser compatibility

BCD tables only load in the browser

See also