:github_url: hide .. _class_AudioEffectSpectrumAnalyzer: AudioEffectSpectrumAnalyzer =========================== **Наследует:** :ref:`AudioEffect` **<** :ref:`Resource` **<** :ref:`RefCounted` **<** :ref:`Object` Аудиоэффект, который можно использовать для аудиовизуализации в реальном времени. .. rst-class:: classref-introduction-group Описание ---------------- Этот звуковой эффект не влияет на вывод звука, но может использоваться для визуализации звука в реальном времени. Этот ресурс настраивает :ref:`AudioEffectSpectrumAnalyzerInstance`, который выполняет фактический анализ во время выполнения. Экземпляр можно получить с помощью :ref:`AudioServer.get_bus_effect_instance()`. См. также :ref:`AudioStreamGenerator` для процедурной генерации звуков. .. rst-class:: classref-introduction-group Обучающие материалы -------------------------------------- - `Демонстрация визуализатора аудиоспектра `__ .. rst-class:: classref-reftable-group Свойства ---------------- .. table:: :widths: auto +----------------------------------------------------------+--------------------------------------------------------------------------------+----------+ | :ref:`float` | :ref:`buffer_length` | ``2.0`` | +----------------------------------------------------------+--------------------------------------------------------------------------------+----------+ | :ref:`FFTSize` | :ref:`fft_size` | ``2`` | +----------------------------------------------------------+--------------------------------------------------------------------------------+----------+ | :ref:`float` | :ref:`tap_back_pos` | ``0.01`` | +----------------------------------------------------------+--------------------------------------------------------------------------------+----------+ .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Перечисления ------------------------ .. _enum_AudioEffectSpectrumAnalyzer_FFTSize: .. rst-class:: classref-enumeration enum **FFTSize**: :ref:`🔗` .. _class_AudioEffectSpectrumAnalyzer_constant_FFT_SIZE_256: .. rst-class:: classref-enumeration-constant :ref:`FFTSize` **FFT_SIZE_256** = ``0`` Используйте буфер из 256 выборок для быстрого преобразования Фурье. Самая низкая задержка, но наименее стабильная во времени. .. _class_AudioEffectSpectrumAnalyzer_constant_FFT_SIZE_512: .. rst-class:: classref-enumeration-constant :ref:`FFTSize` **FFT_SIZE_512** = ``1`` Используйте буфер из 512 выборок для быстрого преобразования Фурье. Низкая задержка, но менее стабильная с течением времени. .. _class_AudioEffectSpectrumAnalyzer_constant_FFT_SIZE_1024: .. rst-class:: classref-enumeration-constant :ref:`FFTSize` **FFT_SIZE_1024** = ``2`` Используйте буфер из 1024 выборок для быстрого преобразования Фурье. Это компромисс между задержкой и стабильностью во времени. .. _class_AudioEffectSpectrumAnalyzer_constant_FFT_SIZE_2048: .. rst-class:: classref-enumeration-constant :ref:`FFTSize` **FFT_SIZE_2048** = ``3`` Используйте буфер из 2048 выборок для быстрого преобразования Фурье. Высокая задержка, но стабильная во времени. .. _class_AudioEffectSpectrumAnalyzer_constant_FFT_SIZE_4096: .. rst-class:: classref-enumeration-constant :ref:`FFTSize` **FFT_SIZE_4096** = ``4`` Используйте буфер из 4096 выборок для быстрого преобразования Фурье. Самая высокая задержка, но самая стабильная во времени. .. _class_AudioEffectSpectrumAnalyzer_constant_FFT_SIZE_MAX: .. rst-class:: classref-enumeration-constant :ref:`FFTSize` **FFT_SIZE_MAX** = ``5`` Представляет размер перечисления :ref:`FFTSize`. .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Описания свойств -------------------------------- .. _class_AudioEffectSpectrumAnalyzer_property_buffer_length: .. rst-class:: classref-property :ref:`float` **buffer_length** = ``2.0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_buffer_length**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_buffer_length**\ (\ ) Длина буфера для хранения (в секундах). Более высокие значения сохраняют данные дольше, но требуют больше памяти. .. rst-class:: classref-item-separator ---- .. _class_AudioEffectSpectrumAnalyzer_property_fft_size: .. rst-class:: classref-property :ref:`FFTSize` **fft_size** = ``2`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_fft_size**\ (\ value\: :ref:`FFTSize`\ ) - :ref:`FFTSize` **get_fft_size**\ (\ ) Размер буфера `Быстрого преобразования Фурье (Fast Fourier transform) `__. Более высокие значения сглаживают спектральный анализ с течением времени, но имеют большую задержку. Эффект этой большей задержки особенно заметен при резких изменениях амплитуды. .. rst-class:: classref-item-separator ---- .. _class_AudioEffectSpectrumAnalyzer_property_tap_back_pos: .. rst-class:: classref-property :ref:`float` **tap_back_pos** = ``0.01`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_tap_back_pos**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_tap_back_pos**\ (\ ) .. container:: contribute There is currently no description for this property. Please help us by `contributing one `__! .. |virtual| replace:: :abbr:`virtual (Этот метод обычно должен быть переопределен пользователем, чтобы иметь какой-либо эффект.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` .. |const| replace:: :abbr:`const (Этот метод не имеет побочных эффектов. Он не изменяет ни одну из переменных-членов экземпляра.)` .. |vararg| replace:: :abbr:`vararg (Этот метод принимает любое количество аргументов после описанных здесь.)` .. |constructor| replace:: :abbr:`constructor (Этот метод используется для создания типа.)` .. |static| replace:: :abbr:`static (Этот метод не нуждается в вызове экземпляра, поэтому его можно вызвать напрямую, используя имя класса.)` .. |operator| replace:: :abbr:`operator (Этот метод описывает допустимый оператор для использования с этим типом в качестве левого операнда.)` .. |bitfield| replace:: :abbr:`BitField (Это значение является целым числом, составленным как битовая маска следующих флагов.)` .. |void| replace:: :abbr:`void (Нет возвращаемого значения.)`