SVGFEConvolveMatrixElement: result-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 result Schreibgeschützte Eigenschaft des SVGFEConvolveMatrixElement-Interfaces beschreibt den zugewiesenen Namen eines SVG-Filterprimitives als SVGAnimatedString.

Sie spiegelt das <feConvolveMatrix>-Element und dessen result-Attribut wider. Der <feConvolveMatrix>-Filter wendet einen Matrixkonvolutionseffekt an, der Pixel im Eingangsbild mit benachbarten Pixeln kombiniert, um einen Konvolutionseffekt wie Weichzeichnung, Kantenerkennung, Schärfung, Prägen oder Abschrägen zu erzeugen.

Der Attributwert ist ein <custom-ident>. Wenn angegeben, können Grafiken, die aus der Verarbeitung dieses Filterprimitives resultieren, von einem in-Attribut in einem nachfolgenden Filterprimitive 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 steht nur zur Wiederverwendung als impliziter Input für das nächste Filterprimitive zur Verfügung, falls dieses Filterprimitive keinen Wert für sein in-Attribut angibt.

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

Siehe auch