Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

AudioEffectFilter

Eredita: AudioEffect < Resource < RefCounted < Object

Ereditato da: AudioEffectBandLimitFilter, AudioEffectBandPassFilter, AudioEffectHighPassFilter, AudioEffectHighShelfFilter, AudioEffectLowPassFilter, AudioEffectLowShelfFilter, AudioEffectNotchFilter

Classe base per i filtri. Utilizza effetti che ereditano da questa classe anziché utilizzarla direttamente.

Descrizione

Un "filtro" controlla il guadagno delle frequenze, usando cutoff_hz come soglia di frequenza. I filtri possono aiutare a dare spazio a ciascun suono e a creare effetti interessanti.

Esistono diversi tipi di filtro che ereditano da questa classe:

Filtri shelf: AudioEffectLowShelfFilter e AudioEffectHighShelfFilter

Filtri passa-banda e notch: AudioEffectBandPassFilter, AudioEffectBandLimitFilter e AudioEffectNotchFilter

Filtri passa-basso/passa-alto: AudioEffectLowPassFilter e AudioEffectHighPassFilter

Tutorial

Proprietà

float	cutoff_hz	`2000.0`
FilterDB	db	`0`
float	gain	`1.0`
float	resonance	`0.5`

Enumerazioni

enum FilterDB: 🔗

FilterDB FILTER_6DB = 0

Taglio a 6 dB per ottava. Un'ottava corrisponde al doppio della frequenza sopra cutoff_hz o alla metà della frequenza sotto cutoff_hz.

FilterDB FILTER_12DB = 1

Taglio a 12 dB per ottava. Un'ottava corrisponde al doppio della frequenza sopra cutoff_hz o alla metà della frequenza sotto cutoff_hz.

FilterDB FILTER_18DB = 2

Taglio a 18 dB per ottava. Un'ottava corrisponde al doppio della frequenza sopra cutoff_hz o alla metà della frequenza sotto cutoff_hz.

FilterDB FILTER_24DB = 3

Taglio a 24 dB per ottava. Un'ottava corrisponde al doppio della frequenza sopra cutoff_hz o alla metà della frequenza sotto cutoff_hz.

Descrizioni delle proprietà

float cutoff_hz = 2000.0 🔗

void set_cutoff(value: float)
float get_cutoff()

Soglia di frequenza per il filtro, in Hz. Il valore può variare da 1 a 20500.

FilterDB db = 0 🔗

void set_db(value: FilterDB)
FilterDB get_db()

Pendenza della curva di taglio in dB per ottava (il doppio della frequenza sopra cutoff_hz o la metà della frequenza sotto cutoff_hz), nota anche come "ordine" del filtro. Gli ordini più elevati hanno un taglio più aggressivo.

float gain = 1.0 🔗

void set_gain(value: float)
float get_gain()

Guadagno delle frequenze influenzate dal filtro. Questa proprietà è disponibile solo per AudioEffectLowShelfFilter e AudioEffectHighShelfFilter. Il valore può variare da 0 a 4.

float resonance = 0.5 🔗

void set_resonance(value: float)
float get_resonance()

Guadagno esattamente o proprio vicino alla soglia di frequenza cutoff_hz. Il valore può variare da 0 a 1.

Il suo comportamento esatto dipende dal tipo di filtro selezionato:

Per i filtri shelf, accentua o maschera l'ordine, aumentando le frequenze adiacenti alla frequenza cutoff_hz e diminuendo le frequenze sul lato opposto.
Per i filtri passa-banda e notch, allarga o restringe il filtro sulla nella soglia di frequenza cutoff_hz.
Per i filtri passa-basso/passa-alto, aumenta o diminuisce le frequenze nella soglia di frequenza cutoff_hz.