preserveAlpha

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.

Das Attribut preserveAlpha gibt an, wie ein <feConvolveMatrix>-Element mit der Alphatransparenz umgeht.

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

Beispiel

html
<svg viewBox="0 0 420 200" xmlns="http://www.w3.org/2000/svg">
  <filter id="convolveMatrix1" x="0" y="0" width="100%" height="100%">
    <feConvolveMatrix kernelMatrix="1 -1 2 0 0 0 0 0 -2" preserveAlpha="true" />
  </filter>
  <filter id="convolveMatrix2" x="0" y="0" width="100%" height="100%">
    <feConvolveMatrix
      kernelMatrix="1 -1 2 0 0 0 0 0 -2"
      preserveAlpha="false" />
  </filter>

  <image
    href="mdn_logo_only_color.png"
    width="200"
    height="200"
    style="filter:url(#convolveMatrix1);" />
  <image
    href="mdn_logo_only_color.png"
    width="200"
    height="200"
    style="filter:url(#convolveMatrix2); transform:translateX(220px);" />
</svg>

Anwendungshinweise

Standardwert false
Wert true | false
Animierbar Ja
true

Dieser Wert gibt an, dass die Faltung nur auf die Farbkanäle angewendet wird. In diesem Fall entfernt der Filter vorübergehend die Vorausmultiplizierung des Alpha-Wertes von den Farbkomponentenwerten, wendet den Kernel an und wendet dann die Alpha-Vorausmultiplizierung als letzten Schritt erneut an.

false

Dieser Wert gibt an, dass die Faltung auf alle Kanäle, einschließlich des Alpha-Kanals, angewendet wird.

Spezifikationen

Specification
Filter Effects Module Level 1
# element-attrdef-feconvolvematrix-preservealpha

Browser-Kompatibilität