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.

AudioEffectPitchShift

Успадковує: AudioEffect < Resource < RefCounted < Object

Додає аудіоефект зміни висоти тону до аудіошини.

Підвищує або знижує висоту тону вхідного аудіосигналу.

Опис

Дозволяє змінювати висоту звуку без зміни швидкості. Усі частоти можна підвищувати або знижувати з мінімальним впливом на перехідні процеси.

Посібники

Властивості

FFTSize

fft_size

3

int

oversampling

4

float

pitch_scale

1.0


Переліки

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.


Описи властивостей

FFTSize fft_size = 3 🔗

Розмір буфера швидкого перетворення Фур'є. Більші значення згладжують ефект у часі, але призводять до більшої затримки. Вплив цієї більшої затримки особливо помітний на аудіосигналах, що мають різкі зміни амплітуди.


int oversampling = 4 🔗

  • void set_oversampling(value: int)

  • int get_oversampling()

Коефіцієнт передискретизації для використання. Вищі значення призводять до кращої якості, але є більш вимогливими до ЦП і можуть спричинити потріскування звуку, якщо ЦП не встигає.


float pitch_scale = 1.0 🔗

  • void set_pitch_scale(value: float)

  • float get_pitch_scale()

Шкала висоти тону, яку слід використовувати. 1.0 — це стандартна висота тону, при якій звуки відтворюються без змін. Значення pitch_scale може коливатися від 0 (безмежно низька висота тону, нечутна) до 16 (у 16 разів вища за початкову висоту тону).