kernelUnitLength

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

Das Attribut kernelUnitLength hat zwei Bedeutungen, je nachdem, in welchem Kontext es verwendet wird. Bei Beleuchtungsfilter-Primitiven gibt es die beabsichtigte Entfernung für die x- und y-Koordinaten an, bei <feConvolveMatrix> die beabsichtigte Entfernung zwischen aufeinanderfolgenden Spalten und Reihen der Kernmatrix.

Sie können dieses Attribut mit den folgenden SVG-Elementen verwenden:

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 und Reihen in der kernelMatrix. Durch das Festlegen von Wert(en) für kernelUnitLength wird der Kernel in einem skalierbaren, abstrakten Koordinatensystem definiert. Wenn das Attribut nicht angegeben ist, beträgt der Standardwert ein Pixel im Offscreen-Bitmap, was ein pixelbasiertes Koordinatensystem ist und daher möglicherweise nicht skalierbar ist.

Wenn ein negativer oder Nullwert angegeben wird, 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 ist, wird standardmäßig der gleiche Wert wie x verwendet.

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 Formeln zur Berechnung der Oberflächennormalen.

Die erste Zahl ist der x-Wert. Die zweite Zahl ist der y-Wert. Wenn der y-Wert nicht angegeben ist, wird standardmäßig der gleiche Wert wie x verwendet. Durch das Festlegen von Wert(en) für kernelUnitLength wird der Kernel in einem skalierbaren, abstrakten Koordinatensystem definiert. Wenn das Attribut nicht angegeben ist, stellen die x- und y-Werte sehr kleine Deltas relativ zu einer gegebenen Position dar, die in einigen Fällen als ein Pixel im Zwischenbild Offscreen-Bitmap implementiert werden können, was ein pixelbasiertes Koordinatensystem ist und daher möglicherweise nicht skalierbar ist.

Wenn ein negativer oder Nullwert angegeben wird, 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 Formeln zur Berechnung der Oberflächennormalen.

Die erste Zahl ist der x-Wert. Die zweite Zahl ist der y-Wert. Wenn der y-Wert nicht angegeben ist, wird standardmäßig der gleiche Wert wie x verwendet. Durch das Festlegen von Wert(en) für kernelUnitLength wird der Kernel in einem skalierbaren, abstrakten Koordinatensystem definiert. Wenn das Attribut nicht angegeben ist, stellen die x- und y-Werte sehr kleine Deltas relativ zu einer gegebenen Position dar, die in einigen Fällen als ein Pixel im Zwischenbild Offscreen-Bitmap implementiert werden können, was ein pixelbasiertes Koordinatensystem ist und daher möglicherweise nicht skalierbar ist.

Wenn ein negativer oder Nullwert angegeben wird, 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