kernelUnitLength

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, kann sie bereits aus den relevanten Webstandards entfernt worden sein, befindet sich im Prozess der Entfernung oder wird nur aus Kompatibilitätsgründen beibehalten. Vermeiden Sie die Verwendung und aktualisieren Sie gegebenenfalls bestehenden Code; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu treffen. Beachten Sie, dass diese Funktion jederzeit nicht mehr funktionieren kann.

Das kernelUnitLength-Attribut hat zwei Bedeutungen, basierend auf dem Kontext, in dem es verwendet wird. Für Lichtfilter-Primitiven gibt es die beabsichtigte Entfernung für die x- und y-Koordinaten an, während es für <feConvolveMatrix> die beabsichtigte Entfernung zwischen aufeinanderfolgenden Spalten und Reihen in der Kernel-Matrix angibt.

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

feConvolveMatrix

Für das <feConvolveMatrix> gibt kernelUnitLength die beabsichtigte Entfernung in aktuellen Filter-Einheiten an (d.h. Einheiten, die durch den Wert des Attributs primitiveUnits bestimmt werden) zwischen aufeinanderfolgenden Spalten und Reihen in der kernelMatrix. Durch das Festlegen von Werten für kernelUnitLength wird der Kernel in einem skalierbaren, abstrakten Koordinatensystem definiert. Wenn das Attribut nicht angegeben ist, ist der Standardwert ein Pixel in der Offscreen-Bitmap, welches ein pixelbasiertes Koordinatensystem darstellt 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 in der 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 er standardmäßig auf den gleichen Wert wie x gesetzt.

feDiffuseLighting

Für das <feDiffuseLighting> gibt kernelUnitLength die beabsichtigte Entfernung in aktuellen Filter-Einheiten an (d.h. Einheiten, die durch den Wert des Attributs primitiveUnits bestimmt werden) für die x- und y-Koordinaten 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 er standardmäßig auf den gleichen Wert wie x gesetzt. Durch das Festlegen von Werten für kernelUnitLength wird der Kernel in einem skalierbaren, abstrakten Koordinatensystem definiert. Wenn das Attribut nicht angegeben ist, repräsentieren die x- und y-Werte sehr kleine Deltas relativ zu einer gegebenen Position, die in manchen Fällen als ein Pixel in der zwischengeschalteten Bild-Offscreen-Bitmap implementiert werden könnten, welches ein pixelbasiertes Koordinatensystem darstellt 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 in der Offscreen-Bitmap
Animierbar Ja

feSpecularLighting

Für das <feSpecularLighting> gibt kernelUnitLength die beabsichtigte Entfernung in aktuellen Filter-Einheiten an (d.h. Einheiten, die durch den Wert des Attributs primitiveUnits bestimmt werden) für die x- und y-Koordinaten 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 er standardmäßig auf den gleichen Wert wie x gesetzt. Durch das Festlegen von Werten für kernelUnitLength wird der Kernel in einem skalierbaren, abstrakten Koordinatensystem definiert. Wenn das Attribut nicht angegeben ist, repräsentieren die x- und y-Werte sehr kleine Deltas relativ zu einer gegebenen Position, die in manchen Fällen als ein Pixel in der zwischengeschalteten Bild-Offscreen-Bitmap implementiert werden könnten, welches ein pixelbasiertes Koordinatensystem darstellt 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 in der 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