kernelUnitLength

Deprecated since SVG 2
This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.

The kernelUnitLength attribute has two meanings based on the context it's used in. For lighting filter primitives, it indicates the intended distance for the x and y coordinates, for <feConvolveMatrix>, it indicates the intended distance between successive columns and rows in the kernel matrix.

Three elements are using this attribute: <feConvolveMatrix><feDiffuseLighting>, and <feSpecularLighting>

feConvolveMatrix

For the <feConvolveMatrix>, kernelUnitLength indicates the intended distance in current filter units (i.e., units as determined by the value of primitiveUnits attribute) between successive columns and rows, respectively, in the kernelMatrix. By specifying value(s) for kernelUnitLength, the kernel becomes defined in a scalable, abstract coordinate system. If the attribute is not specified, the default value is one pixel in the offscreen bitmap, which is a pixel-based coordinate system, and thus potentially not scalable.

If a negative or zero value is specified the default value will be used instead.

Value <number-optional-number>
Default value Pixel in offscreen bitmap
Animatable Yes
<number-optional-number>
The first number is the x value. The second number is the y value. If the x value is not specified, it defaults to the same value as x.

feDiffuseLighting

For the <feDiffuseLighting>, kernelUnitLength indicates the intended distance in current filter units (i.e., units as determined by the value of attribute primitiveUnits) for the x and y coordinate, respectively, in the surface normal calculation formulas.

The first number is the x value. The second number is the y value. If the y value is not specified, it defaults to the same value as x. By specifying value(s) for kernelUnitLength, the kernel becomes defined in a scalable, abstract coordinate system. If the attribute is not specified, the x and y values represent very small deltas relative to a given position, which might be implemented in some cases as one pixel in the intermediate image offscreen bitmap, which is a pixel-based coordinate system, and thus potentially not scalable.

If a negative or zero value is specified the default value will be used instead.

Value <number-optional-number>
Default value Pixel in offscreen bitmap
Animatable Yes

feSpecularLighting

For the <feSpecularLighting>, kernelUnitLength indicates the intended distance in current filter units (i.e., units as determined by the value of attribute primitiveUnits) for the x and y coordinate, respectively, in the surface normal calculation formulas.

The first number is the x value. The second number is the y value. If the y value is not specified, it defaults to the same value as x. By specifying value(s) for kernelUnitLength, the kernel becomes defined in a scalable, abstract coordinate system. If the attribute is not specified, the x and y values represent very small deltas relative to a given position, which might be implemented in some cases as one pixel in the intermediate image offscreen bitmap, which is a pixel-based coordinate system, and thus potentially not scalable.

If a negative or zero value is specified the default value will be used instead.

Value <number-optional-number>
Default value Pixel in offscreen bitmap
Animatable Yes

Specifications

Specification Status Comment
Filter Effects Module Level 1
The definition of 'kernelUnitLength for <feSpecularLighting>' in that specification.
Working Draft Marked the attribute as deprecated.
Filter Effects Module Level 1
The definition of 'kernelUnitLength for <feDiffuseLighting>' in that specification.
Working Draft Marked the attribute as deprecated.
Filter Effects Module Level 1
The definition of 'kernelUnitLength for <feConvolveMatrix>' in that specification.
Working Draft Marked the attribute as deprecated.
Scalable Vector Graphics (SVG) 1.1 (Second Edition)
The definition of 'kernelUnitLength for <feSpecularLighting>' in that specification.
Recommendation Initial definition for <feSpecularLighting>
Scalable Vector Graphics (SVG) 1.1 (Second Edition)
The definition of 'kernelUnitLength for <feDiffuseLighting>' in that specification.
Recommendation Initial definition for <feDiffuseLighting>
Scalable Vector Graphics (SVG) 1.1 (Second Edition)
The definition of 'kernelUnitLength for <feConvolveMatrix>' in that specification.
Recommendation Initial definition for <feConvolveMatrix>