numOctaves

Baseline Widely available

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

Das Attribut numOctaves definiert die Anzahl der Oktaven für die Rauschfunktion des <feTurbulence>-Primitives.

Eine Oktave ist eine Rauschfunktion, die durch ihre Frequenz und Amplitude definiert ist. Eine Turbulenz entsteht durch das Akkumulieren mehrerer Oktaven mit steigenden Frequenzen und abnehmenden Amplituden. Je höher die Anzahl der Oktaven, desto natürlicher sieht das Rauschen aus. Allerdings erfordern mehr Oktaven auch mehr Berechnungen, was sich negativ auf die Leistung auswirkt.

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

<feTurbulence>

Beispiel

Beispiel 1

html,
body,
svg {
  height: 100%;
}

html

<svg viewBox="0 0 420 200" xmlns="http://www.w3.org/2000/svg">
  <filter id="noise1" x="0" y="0" width="100%" height="100%">
    <feTurbulence baseFrequency="0.025" numOctaves="1" />
  </filter>
  <filter id="noise2" x="0" y="0" width="100%" height="100%">
    <feTurbulence baseFrequency="0.025" numOctaves="3" />
  </filter>

  <rect x="0" y="0" width="200" height="200" filter="url(#noise1)" />
  <rect x="220" y="0" width="200" height="200" filter="url(#noise2)" />
</svg>

Beispiel 2

html

<svg
  width="200"
  height="200"
  viewBox="0 0 220 220"
  xmlns="http://www.w3.org/2000/svg">
  <filter id="displacementFilter">
    <feTurbulence baseFrequency="0.05" numOctaves="3" result="turbulence" />
    <feDisplacementMap
      in2="turbulence"
      in="SourceGraphic"
      scale="50"
      xChannelSelector="R"
      yChannelSelector="G" />
  </filter>

  <circle cx="100" cy="100" r="100" filter="url(#displacementFilter)" />
</svg>

Verwendungshinweise

Wert	`<integer>`
Standardwert	`1`
Animierbar	Ja

<integer>: Definiert die Anzahl der Oktaven. Negative Werte sind verboten.

Spezifikationen

Specification
Filter Effects Module Level 1 # element-attrdef-feturbulence-numoctaves