z

The z attribute defines the location along the z-axis for a light source in the coordinate system established by the primitiveUnits attribute on the <filter> element, assuming that, in the initial coordinate system, the positive z-axis comes out towards the person viewing the content and assuming that one unit along the z-axis equals one unit in x and y.

You can use this attribute with the following SVG elements:

Example

<svg viewBox="0 0 420 200" xmlns="http://www.w3.org/2000/svg">
  <filter id="diffuseLighting1" x="0" y="0" width="100%" height="100%">
    <feDiffuseLighting in="SourceGraphic">
      <fePointLight x="60" y="60" z="10" />
    </feDiffuseLighting>
  </filter>
  <filter id="diffuseLighting2" x="0" y="0" width="100%" height="100%">
    <feDiffuseLighting in="SourceGraphic">
      <fePointLight x="60" y="60" z="50" />
    </feDiffuseLighting>
  </filter>

  <rect x="0" y="0" width="200" height="200" style="filter: url(#diffuseLighting1);" />
  <rect x="0" y="0" width="200" height="200" style="filter: url(#diffuseLighting2); transform: translateX(220px);" />
</svg>

fePointLight

For <fePointLight>, z defines the location along the z-axis for the light source in the coordinate system established by the primitiveUnits attribute on the <filter> element.

Value <number>
Default value 1
Animatable Yes

feSpotLight

For <feSpotLight>, z defines the location along the z-axis for the light source in the coordinate system established by the primitiveUnits attribute on the <filter> element.

Value <number>
Default value 1
Animatable Yes

Specifications

Specification Status Comment
Filter Effects Module Level 1
The definition of 'z for <fePointLight>' in that specification.
Working Draft No change
Filter Effects Module Level 1
The definition of 'z for <feSpotLight>' in that specification.
Working Draft No change
Scalable Vector Graphics (SVG) 1.1 (Second Edition)
The definition of 'z for <fePointLight>' in that specification.
Recommendation Initial definition for <fePointLight>
Scalable Vector Graphics (SVG) 1.1 (Second Edition)
The definition of 'z for <feSpotLight>' in that specification.
Recommendation Initial definition for <feSpotLight>