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 preserveAlpha Attribut gibt an, wie ein <feConvolveMatrix> Element mit Alpha-Transparenz umgeht.

Dieses Attribut kann mit den folgenden SVG-Elementen verwendet werden:

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>

Verwendungshinweise

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 Alpha-Präkomposition von den Farbkomponentenwerten, wendet den Kernel an und setzt die Alpha-Präkomposition dann als letzten Schritt wieder ein.

false

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

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser