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.

We’d love to hear your thoughts on the next set of proposals for the JavaScript language. You can find a description of the proposals here.

Please take two minutes to fill out our short survey.

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

Eine Oktave ist eine Rauschfunktion, die durch ihre Frequenz und Amplitude definiert ist. Eine Turbulenz wird durch das Akkumulieren mehrerer Oktaven mit zunehmenden Frequenzen und abnehmenden Amplituden erstellt. Je höher die Anzahl der Oktaven, desto natürlicher wirkt das Rauschen. 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" style="filter: url(#noise1);" />
  <rect
    x="0"
    y="0"
    width="200"
    height="200"
    style="filter: url(#noise2); transform: translateX(220px);" />
</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" style="filter: url(#displacementFilter)" />
</svg>

Anwendungshinweise

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