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...
AudioEffectChorus
Наследует: AudioEffect < Resource < RefCounted < Object
Добавляет эффект хоруса к аудиошине.
Создает впечатление наличия нескольких источников звука.
Описание
Эффект «хорус» создает множество копий исходного аудио (называемых «голосами») с вариациями высоты тона, накладывая их друг на друга, создавая впечатление, что звук исходит из нескольких источников. Это создает спектральное и пространственное движение.
Каждый голос воспроизводится через короткий промежуток времени после исходного аудио, управляемый delay. Внутренний низкочастотный осциллятор (LFO) управляет их высотой тона, а depth управляет максимальным значением LFO.
В реальном мире подобный эффект встречается в фортепиано, хорах и инструментальных ансамблях.
Этот эффект также может использоваться для расширения монофонического звука и придания цифровым звукам более естественного или аналогового качества.
Обучающие материалы
Свойства
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
Методы
get_voice_cutoff_hz(voice_idx: int) const |
|
get_voice_delay_ms(voice_idx: int) const |
|
get_voice_depth_ms(voice_idx: int) const |
|
get_voice_level_db(voice_idx: int) const |
|
get_voice_pan(voice_idx: int) const |
|
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) |
Описания свойств
Коэффициент громкости исходного аудио. Значение может варьироваться от 0 до 1.
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/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 🔗
Усиление голоса в дБ.
Позиция панорамирования голоса.
Частота низкочастотного генератора голоса в Гц.
Пороговая частота низкочастотного фильтра голоса в Гц.
Задержка голоса в миллисекундах по сравнению с исходным аудиофайлом.
Глубина низкочастотного осциллятора голоса в миллисекундах.
Усиление голоса в дБ.
Позиция панорамирования голоса.
Частота низкочастотного генератора голоса в Гц.
Пороговая частота низкочастотного фильтра голоса в Гц.
Задержка голоса в миллисекундах по сравнению с исходным аудиофайлом.
Глубина низкочастотного осциллятора голоса в миллисекундах.
Усиление голоса в дБ.
Позиция панорамирования голоса.
Частота низкочастотного генератора голоса в Гц.
Количество голосов в эффекте. Значение может варьироваться от 1 до 4.
Соотношение громкости всех голосов. Значение может варьироваться от 0 до 1.
Описания метода
float get_voice_cutoff_hz(voice_idx: int) const 🔗
Возвращает пороговое значение частоты низкочастотного фильтра для заданного параметра voice_idx в Гц. Частоты выше этого значения удаляются из голоса.
float get_voice_delay_ms(voice_idx: int) const 🔗
Возвращает задержку заданного параметра voice_idx в миллисекундах по сравнению с исходным аудиосигналом.
float get_voice_depth_ms(voice_idx: int) const 🔗
Возвращает глубину низкочастотного осциллятора заданного параметра voice_idx в миллисекундах.
float get_voice_level_db(voice_idx: int) const 🔗
Возвращает коэффициент усиления заданного параметра voice_idx в дБ.
float get_voice_pan(voice_idx: int) const 🔗
Возвращает положение панорамирования для заданного voice_idx. Отрицательные значения означают левый канал, положительные — правый.
float get_voice_rate_hz(voice_idx: int) const 🔗
Возвращает частоту низкочастотного осциллятора заданного параметра voice_idx в Гц.
void set_voice_cutoff_hz(voice_idx: int, cutoff_hz: float) 🔗
Устанавливает пороговое значение частоты низкочастотного фильтра для заданного параметра voice_idx в Гц. Частоты выше cutoff_hz удаляются из voice_idx. Значение может варьироваться от 1 до 20500.
void set_voice_delay_ms(voice_idx: int, delay_ms: float) 🔗
Устанавливает задержку заданного параметра voice_idx в миллисекундах по сравнению с исходным аудио. Значение может варьироваться от 0 до 50.
void set_voice_depth_ms(voice_idx: int, depth_ms: float) 🔗
Задает глубину низкочастотного осциллятора заданного void_idx в миллисекундах. Значение может варьироваться от 0 до 20.
void set_voice_level_db(voice_idx: int, level_db: float) 🔗
Устанавливает коэффициент усиления заданного параметра voice_idx в дБ. Значение может варьироваться от -60 до 24.
void set_voice_pan(voice_idx: int, pan: float) 🔗
Задает положение панорамирования для заданного параметра voice_idx. Отрицательные значения панорамируют звук влево, положительные — вправо. Значение может принимать значения от -1 до 1.
void set_voice_rate_hz(voice_idx: int, rate_hz: float) 🔗
Задает частоту низкочастотного осциллятора заданного void_idx в Гц. Значение может варьироваться от 0,1 до 20.