kernelUnitLength

Das kernelUnitLength Attribut hat zwei Bedeutungen basierend auf dem Kontext, in dem es verwendet wird. Bei Beleuchtungsfilter-Primitiven gibt es die beabsichtigte Entfernung für die x- und y-Koordinaten an. Bei <feConvolveMatrix> gibt es die beabsichtigte Entfernung zwischen aufeinanderfolgenden Spalten und Zeilen in der Kernel-Matrix an.

Dieses Attribut kann mit den folgenden SVG-Elementen verwendet werden:

feConvolveMatrix

Für die <feConvolveMatrix> gibt kernelUnitLength die beabsichtigte Entfernung in aktuellen Filtereinheiten an (d.h. Einheiten, wie sie durch den Wert des Attributs primitiveUnits bestimmt werden) zwischen aufeinanderfolgenden Spalten bzw. Zeilen in der kernelMatrix. Durch die Angabe von Werten für kernelUnitLength wird der Kernel in einem skalierbaren, abstrakten Koordinatensystem definiert. Wenn das Attribut nicht angegeben wird, ist der Standardwert ein Pixel im Offscreen-Bitmap, welches ein pixelbasiertes Koordinatensystem ist und daher möglicherweise nicht skalierbar.

Wird ein negativer oder Nullwert angegeben, wird stattdessen der Standardwert verwendet.

Wert <number-optional-number>
Standardwert Pixel im Offscreen-Bitmap
Animierbar Ja
<number-optional-number>

Die erste Zahl ist der x-Wert. Die zweite Zahl ist der y-Wert. Wenn der x-Wert nicht angegeben wird, wird der gleiche Wert wie x angenommen.

feDiffuseLighting

Für die <feDiffuseLighting> gibt kernelUnitLength die beabsichtigte Entfernung in aktuellen Filtereinheiten an (d.h. Einheiten, wie sie durch den Wert des Attributs primitiveUnits bestimmt werden) für die x- und y-Koordinate in den Berechnungsformeln der Oberflächennormale.

Die erste Zahl ist der x-Wert. Die zweite Zahl ist der y-Wert. Wenn der y-Wert nicht angegeben wird, wird der gleiche Wert wie x angenommen. Durch die Angabe von Werten für kernelUnitLength wird der Kernel in einem skalierbaren, abstrakten Koordinatensystem definiert. Wenn das Attribut nicht angegeben wird, stellen x- und y-Werte sehr kleine Deltas relativ zu einer gegebenen Position dar, was in einigen Fällen als ein Pixel im Offscreen-Bitmap des Zwischenbildes implementiert werden kann, welches ein pixelbasiertes Koordinatensystem ist und daher möglicherweise nicht skalierbar.

Wird ein negativer oder Nullwert angegeben, wird stattdessen der Standardwert verwendet.

Wert <number-optional-number>
Standardwert Pixel im Offscreen-Bitmap
Animierbar Ja

feSpecularLighting

Für die <feSpecularLighting> gibt kernelUnitLength die beabsichtigte Entfernung in aktuellen Filtereinheiten an (d.h. Einheiten, wie sie durch den Wert des Attributs primitiveUnits bestimmt werden) für die x- und y-Koordinate in den Berechnungsformeln der Oberflächennormale.

Die erste Zahl ist der x-Wert. Die zweite Zahl ist der y-Wert. Wenn der y-Wert nicht angegeben wird, wird der gleiche Wert wie x angenommen. Durch die Angabe von Werten für kernelUnitLength wird der Kernel in einem skalierbaren, abstrakten Koordinatensystem definiert. Wenn das Attribut nicht angegeben wird, stellen x- und y-Werte sehr kleine Deltas relativ zu einer gegebenen Position dar, was in einigen Fällen als ein Pixel im Offscreen-Bitmap des Zwischenbildes implementiert werden kann, welches ein pixelbasiertes Koordinatensystem ist und daher möglicherweise nicht skalierbar.

Wird ein negativer oder Nullwert angegeben, wird stattdessen der Standardwert verwendet.

Wert <number-optional-number>
Standardwert Pixel im Offscreen-Bitmap
Animierbar Ja

Spezifikationen

Specification
Filter Effects Module Level 1
# element-attrdef-fespecularlighting-kernelunitlength
Filter Effects Module Level 1
# element-attrdef-fediffuselighting-kernelunitlength
Filter Effects Module Level 1
# element-attrdef-feconvolvematrix-kernelunitlength