SVGFEConvolveMatrixElement: Ergebnis-Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die schreibgeschützte Eigenschaft result des SVGFEConvolveMatrixElement-Interfaces beschreibt den zugewiesenen Namen eines SVG-Filterprimitivs als SVGAnimatedString.

Sie spiegelt das <feConvolveMatrix>-Elementattribut result wider. Der <feConvolveMatrix>-Filter wendet einen Matrixkonvolutionseffekt an, der Pixel im Eingabebild mit benachbarten Pixeln kombiniert, um einen Konvolutionseffekt wie Weichzeichnen, Kantenerkennung, Schärfen, Prägen oder Abfasen zu erzeugen.

Der Attributwert ist ein <custom-ident>. Falls angegeben, können Grafiken, die aus der Verarbeitung dieses Filterprimitivs resultieren, durch ein in-Attribut auf einem nachfolgenden Filterprimitiv innerhalb desselben <filter>-Elements referenziert werden.

Wenn kein result-Attribut definiert ist, sind result.baseVal und result.animVal des Filters leere Zeichenfolgen, und die Ausgabe des <feConvolveMatrix>-Filters kann nur als implizite Eingabe in das nächste Filterprimitiv wiederverwendet werden, wenn dieses Filterprimitiv keinen Wert für sein in-Attribut bereitstellt.

Wert

Ein SVGAnimatedString.

Beispiel

js
const feConvolveMatrixElement = document.querySelector("feConvolveMatrix");
const filterName = feConvolveMatrixElement.result;
console.log(filterName.baseVal); // the filter's assigned name

Spezifikationen

Specification
Filter Effects Module Level 1
# dom-svgfilterprimitivestandardattributes-result

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch