SVGFESpecularLightingElement: surfaceScale 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 surfaceScale read-only property of the SVGFESpecularLightingElement interface reflects the surfaceScale attribute of the given <feSpecularLighting> element.

Value

An SVGAnimatedNumber object.

Examples

Accessing the surfaceScale Property

html
<svg viewBox="0 0 200 200" xmlns="http://www.w3.org/2000/svg">
  <defs>
    <filter id="specularLightingFilter">
      <!-- Adds specular lighting with a surface scale -->
      <feSpecularLighting
        in="SourceGraphic"
        specularExponent="20"
        lighting-color="hotpink"
        surfaceScale="3">
        <fePointLight x="50" y="50" z="30" />
      </feSpecularLighting>
    </filter>
  </defs>
  <rect
    x="20"
    y="20"
    width="100"
    height="100"
    style="fill:lightblue;"
    filter="url(#specularLightingFilter)" />
</svg>
js
// Select the feSpecularLighting element
const specularLightingElement = document.querySelector("feSpecularLighting");

// Access the surfaceScale property
console.log(specularLightingElement.surfaceScale.baseVal); // Output: 3

Specifications

Specification
Filter Effects Module Level 1
# dom-svgfespecularlightingelement-surfacescale

Browser compatibility

BCD tables only load in the browser

See also