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...

AudioEffectSpectrumAnalyzer

Наследует: AudioEffect < Resource < RefCounted < Object

Создает AudioEffectInstance, который выполняет частотный анализ и предоставляет результаты для доступа в режиме реального времени.

Описание

Вычисляет преобразование Фурье аудиосигнала. Этот эффект не изменяет звук. Может использоваться для создания визуализаций звука в реальном времени, например, спектрограммы.

Этот ресурс настраивает AudioEffectSpectrumAnalyzerInstance, который выполняет фактический анализ во время выполнения. Для использования этого эффекта необходимо получить экземпляр с помощью AudioServer.get_bus_effect_instance().

Обучающие материалы

Свойства

float

buffer_length

2.0

FFTSize

fft_size

2

Перечисления

enum FFTSize: 🔗

FFTSize FFT_SIZE_256 = 0

Используйте буфер из 256 выборок для быстрого преобразования Фурье. Самая низкая задержка, но наименее стабильная во времени.

FFTSize FFT_SIZE_512 = 1

Используйте буфер из 512 выборок для быстрого преобразования Фурье. Низкая задержка, но менее стабильная с течением времени.

FFTSize FFT_SIZE_1024 = 2

Используйте буфер из 1024 выборок для быстрого преобразования Фурье. Это компромисс между задержкой и стабильностью во времени.

FFTSize FFT_SIZE_2048 = 3

Используйте буфер из 2048 выборок для быстрого преобразования Фурье. Высокая задержка, но стабильная во времени.

FFTSize FFT_SIZE_4096 = 4

Используйте буфер из 4096 выборок для быстрого преобразования Фурье. Самая высокая задержка, но самая стабильная во времени.

FFTSize FFT_SIZE_MAX = 5

Представляет размер перечисления FFTSize.

Описания свойств

float buffer_length = 2.0 🔗

  • void set_buffer_length(value: float)

  • float get_buffer_length()

Длительность буфера, в секундах. Большие значения позволяют хранить данные дольше, но требуют больше памяти. Значение может варьироваться от 0,1 до 4.

FFTSize fft_size = 2 🔗

Размер буфера Быстрого преобразования Фурье (Fast Fourier transform). Более высокие значения сглаживают спектральный анализ с течением времени, но имеют большую задержку. Эффект этой большей задержки особенно заметен при резких изменениях амплитуды.