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.

AudioEffectChorus

Eredita: AudioEffect < Resource < RefCounted < Object

Aggiunge un effetto audio coro a un bus audio.

Da l'impressione di più sorgenti audio.

Descrizione

L'effetto "coro" crea più copie dell'audio originale (chiamate "voci") con variazioni di tono, sovrapponendole all'originale e dando l'impressione che il suono provenga da più sorgenti. Questo crea movimento spettrale e spaziale.

Ogni voce viene riprodotta con un breve ritardo rispetto all'audio originale, controllato da delay. Un oscillatore a bassa frequenza (LFO) interno ne controlla il tono, mentre depth controlla l'ampiezza massima dell'oscillatore.

Nel modo reale, questo tipo di effetto si trova nei pianoforti, cori e ensemble strumentali.

Questo effetto si può anche utilizzare per ampliare l'audio mono e dare ai suoni digitali una qualità più naturale o analogica.

Tutorial

Proprietà

float

dry

1.0

float

voice/1/cutoff_hz

8000.0

float

voice/1/delay_ms

15.0

float

voice/1/depth_ms

2.0

float

voice/1/level_db

0.0

float

voice/1/pan

-0.5

float

voice/1/rate_hz

0.8

float

voice/2/cutoff_hz

8000.0

float

voice/2/delay_ms

20.0

float

voice/2/depth_ms

3.0

float

voice/2/level_db

0.0

float

voice/2/pan

0.5

float

voice/2/rate_hz

1.2

float

voice/3/cutoff_hz

float

voice/3/delay_ms

float

voice/3/depth_ms

float

voice/3/level_db

float

voice/3/pan

float

voice/3/rate_hz

float

voice/4/cutoff_hz

float

voice/4/delay_ms

float

voice/4/depth_ms

float

voice/4/level_db

float

voice/4/pan

float

voice/4/rate_hz

int

voice_count

2

float

wet

0.5

Metodi

float

get_voice_cutoff_hz(voice_idx: int) const

float

get_voice_delay_ms(voice_idx: int) const

float

get_voice_depth_ms(voice_idx: int) const

float

get_voice_level_db(voice_idx: int) const

float

get_voice_pan(voice_idx: int) const

float

get_voice_rate_hz(voice_idx: int) const

void

set_voice_cutoff_hz(voice_idx: int, cutoff_hz: float)

void

set_voice_delay_ms(voice_idx: int, delay_ms: float)

void

set_voice_depth_ms(voice_idx: int, depth_ms: float)

void

set_voice_level_db(voice_idx: int, level_db: float)

void

set_voice_pan(voice_idx: int, pan: float)

void

set_voice_rate_hz(voice_idx: int, rate_hz: float)


Descrizioni delle proprietà

float dry = 1.0 🔗

Il rapporto di volume dell'audio originale. Il valore può variare da 0 a 1.


float voice/1/cutoff_hz = 8000.0 🔗

  • void set_voice_cutoff_hz(voice_idx: int, cutoff_hz: float)

  • float get_voice_cutoff_hz(voice_idx: int) const

La frequenza di soglia del filtro passa-basso della voice, in Hz.


float voice/1/delay_ms = 15.0 🔗

  • void set_voice_delay_ms(voice_idx: int, delay_ms: float)

  • float get_voice_delay_ms(voice_idx: int) const

Il ritardo della voce in millisecondi, rispetto all'audio originale.


float voice/1/depth_ms = 2.0 🔗

  • void set_voice_depth_ms(voice_idx: int, depth_ms: float)

  • float get_voice_depth_ms(voice_idx: int) const

La profondità dell'oscillatore a bassa frequenza della voce in millisecondi.


float voice/1/level_db = 0.0 🔗

  • void set_voice_level_db(voice_idx: int, level_db: float)

  • float get_voice_level_db(voice_idx: int) const

Il guadagno della voce in dB.


float voice/1/pan = -0.5 🔗

  • void set_voice_pan(voice_idx: int, pan: float)

  • float get_voice_pan(voice_idx: int) const

La posizione di panning della voce.


float voice/1/rate_hz = 0.8 🔗

  • void set_voice_rate_hz(voice_idx: int, rate_hz: float)

  • float get_voice_rate_hz(voice_idx: int) const

La frequenza dell'oscillatore a bassa frequenza della voce in Hz.


float voice/2/cutoff_hz = 8000.0 🔗

  • void set_voice_cutoff_hz(voice_idx: int, cutoff_hz: float)

  • float get_voice_cutoff_hz(voice_idx: int) const

La frequenza di soglia del filtro passa-basso della voice, in Hz.


float voice/2/delay_ms = 20.0 🔗

  • void set_voice_delay_ms(voice_idx: int, delay_ms: float)

  • float get_voice_delay_ms(voice_idx: int) const

Il ritardo della voce in millisecondi, rispetto all'audio originale.


float voice/2/depth_ms = 3.0 🔗

  • void set_voice_depth_ms(voice_idx: int, depth_ms: float)

  • float get_voice_depth_ms(voice_idx: int) const

La profondità dell'oscillatore a bassa frequenza della voce in millisecondi.


float voice/2/level_db = 0.0 🔗

  • void set_voice_level_db(voice_idx: int, level_db: float)

  • float get_voice_level_db(voice_idx: int) const

Il guadagno della voce in dB.


float voice/2/pan = 0.5 🔗

  • void set_voice_pan(voice_idx: int, pan: float)

  • float get_voice_pan(voice_idx: int) const

La posizione di panning della voce.


float voice/2/rate_hz = 1.2 🔗

  • void set_voice_rate_hz(voice_idx: int, rate_hz: float)

  • float get_voice_rate_hz(voice_idx: int) const

La frequenza dell'oscillatore a bassa frequenza della voce in Hz.


float voice/3/cutoff_hz 🔗

  • void set_voice_cutoff_hz(voice_idx: int, cutoff_hz: float)

  • float get_voice_cutoff_hz(voice_idx: int) const

La frequenza di soglia del filtro passa-basso della voice, in Hz.


float voice/3/delay_ms 🔗

  • void set_voice_delay_ms(voice_idx: int, delay_ms: float)

  • float get_voice_delay_ms(voice_idx: int) const

Il ritardo della voce in millisecondi, rispetto all'audio originale.


float voice/3/depth_ms 🔗

  • void set_voice_depth_ms(voice_idx: int, depth_ms: float)

  • float get_voice_depth_ms(voice_idx: int) const

La profondità dell'oscillatore a bassa frequenza della voce in millisecondi.


float voice/3/level_db 🔗

  • void set_voice_level_db(voice_idx: int, level_db: float)

  • float get_voice_level_db(voice_idx: int) const

Il guadagno della voce in dB.


float voice/3/pan 🔗

  • void set_voice_pan(voice_idx: int, pan: float)

  • float get_voice_pan(voice_idx: int) const

La posizione di panning della voce.


float voice/3/rate_hz 🔗

  • void set_voice_rate_hz(voice_idx: int, rate_hz: float)

  • float get_voice_rate_hz(voice_idx: int) const

La frequenza dell'oscillatore a bassa frequenza della voce in Hz.


float voice/4/cutoff_hz 🔗

  • void set_voice_cutoff_hz(voice_idx: int, cutoff_hz: float)

  • float get_voice_cutoff_hz(voice_idx: int) const

La frequenza di soglia del filtro passa-basso della voice, in Hz.


float voice/4/delay_ms 🔗

  • void set_voice_delay_ms(voice_idx: int, delay_ms: float)

  • float get_voice_delay_ms(voice_idx: int) const

Il ritardo della voce in millisecondi, rispetto all'audio originale.


float voice/4/depth_ms 🔗

  • void set_voice_depth_ms(voice_idx: int, depth_ms: float)

  • float get_voice_depth_ms(voice_idx: int) const

La profondità dell'oscillatore a bassa frequenza della voce in millisecondi.


float voice/4/level_db 🔗

  • void set_voice_level_db(voice_idx: int, level_db: float)

  • float get_voice_level_db(voice_idx: int) const

Il guadagno della voce in dB.


float voice/4/pan 🔗

  • void set_voice_pan(voice_idx: int, pan: float)

  • float get_voice_pan(voice_idx: int) const

La posizione di panning della voce.


float voice/4/rate_hz 🔗

  • void set_voice_rate_hz(voice_idx: int, rate_hz: float)

  • float get_voice_rate_hz(voice_idx: int) const

La frequenza dell'oscillatore a bassa frequenza della voce in Hz.


int voice_count = 2 🔗

  • void set_voice_count(value: int)

  • int get_voice_count()

Il numero di voci nell'effetto. Il valore può variare da 1 a 4.


float wet = 0.5 🔗

Il rapporto del volume di tutte le voci. Il valore può variare da 0 a 1.


Descrizioni dei metodi

float get_voice_cutoff_hz(voice_idx: int) const 🔗

Restituisce la soglia di frequenza della voice all'indice voice_idx nel filtro passa-basso, in Hz. Le frequenze superiori a questo valore vengono rimosse dalla voce.


float get_voice_delay_ms(voice_idx: int) const 🔗

Restituisce il ritardo della voice all'indice voice_idx, in millisecondi, rispetto all'audio originale.


float get_voice_depth_ms(voice_idx: int) const 🔗

Restituisce la profondità dell'oscillatore a bassa frequenza della voce all'indice voice_idx in millisecondi.


float get_voice_level_db(voice_idx: int) const 🔗

Restituisce il guadagno della voce all'indice voice_idx in dB.


float get_voice_pan(voice_idx: int) const 🔗

Restituisce il panning della voce all'indice voice_idx. I valori negativi indicano il canale sinistro, i valori positivi indicano il canale destro.


float get_voice_rate_hz(voice_idx: int) const 🔗

Restituisce la frequenza dell'oscillatore a bassa frequenza della voce all'indice voice_idx, in Hz.


void set_voice_cutoff_hz(voice_idx: int, cutoff_hz: float) 🔗

Imposta la soglia di frequenza della voce all'indice voice_idx nel filtro passa-basso, in Hz. Le frequenze superiori a cutoff_hz vengono rimosse dalla voce voice_idx. Il valore può variare da 1 a 20500.


void set_voice_delay_ms(voice_idx: int, delay_ms: float) 🔗

Imposta il ritardo della voice all'indice voice_idx, in millisecondi, rispetto all'audio originale. Il valore può variare da 0 a 50.


void set_voice_depth_ms(voice_idx: int, depth_ms: float) 🔗

Imposta la profondità dell'oscillatore a bassa frequenza della voce all'indice voice_idx in millisecondi. Il valore può variare da 0 a 20.


void set_voice_level_db(voice_idx: int, level_db: float) 🔗

Imposta il guadagno della voce all'indice voice_idx in dB. Il valore può variare da -60 a 24.


void set_voice_pan(voice_idx: int, pan: float) 🔗

Imposta il panning della voce all'indice voice_idx. I valori negativi spostano il suono a sinistra, I valori positivi spostano il suono a destra. Il valore può variare da -1 a 1.


void set_voice_rate_hz(voice_idx: int, rate_hz: float) 🔗

Imposta la frequenza dell'oscillatore a bassa frequenza della voce all'indice voice_idx, in Hz. Il valore può variare da 0.1 a 20.