audioOscillator
Сгенерируйте форму синуса, квадрата и пилообразного зуба
Описание
The audioOscillator Системная object™ генерирует настраиваемые формы сигналов. Типичные использования включают генерацию тестовых сигналов для испытательных стендов и генерацию управляющих сигналов для аудио эффектов. Свойства audioOscillator Системный объект задает тип сгенерированной формы волны.
Чтобы сгенерировать настраиваемые формы волны:
Создайте
audioOscillatorОбъекту и установите его свойства.Вызывайте объект с аргументами, как будто это функция.
Дополнительные сведения о работе системных объектов см. в разделе «Что такое системные объекты?».
Создание
Синтаксис
Описание
osc = audioOscillatorosc, со значениями свойств по умолчанию.
osc = audioOscillator(signalTypeValue)signalTypeValue.
osc = audioOscillator(signalTypeValue,frequencyValue)frequencyValue.
osc = audioOscillator(___, устанавливает каждое свойство Name,Value)Name к заданной Value. Неопределенные свойства имеют значения по умолчанию.
osc = audioOscillator('SignalType','sine','Frequency',8000,'DCOffset',1) создает Системный объект, osc, который генерирует синусоиды 8 кГц со смещением постоянного тока единицей.Свойства
Использование
Синтаксис
Описание
Выходные аргументы
Функции объекта
Чтобы использовать функцию объекта, задайте системный объект в качестве первого входного параметра. Например, чтобы освободить системные ресурсы системного объекта с именем obj, используйте следующий синтаксис:
release(obj)
createAudioPluginClass и configureMIDI функции сопоставляют настраиваемые свойства audioOscillator Системный объект по пользовательским параметрам:
| Свойство | Область значений | Отображение | Модули |
|---|---|---|---|
Frequency | [0.1, 20000] | журнал | Hz |
Amplitude | [0, 10] | линейный | нет модулей |
DCOffset | [–10, 10] | линейный | нет модулей |
DutyCycle (доступно при установке SignalType на 'square') | [0, 1] | линейный | нет модулей |
Width (доступно при установке SignalType на 'sawtooth') | [0, 1] | линейный | нет модулей |
Примеры
Сгенерируйте частотно-переменный Sine wave
Используйте audioOscillator чтобы сгенерировать синусоиду переменной частоты.
Создайте аудио генератора, чтобы сгенерировать синусоиду. Используйте настройки по умолчанию.
osc = audioOscillator;
Создайте временные возможности, чтобы визуализировать синусоиду переменной частоты, сгенерированную аудио генератора.
scope = timescope( ... 'SampleRate',osc.SampleRate, ... 'TimeSpanSource','Property','TimeSpan',0.1, ... 'YLimits',[-1.5,1.5], ... 'TimeSpanOverrunAction','Scroll', ... 'ShowGrid',true, ... 'Title','Variable-Frequency Sine Wave');
Поместите аудио генератора в цикл аудиопотока. Увеличьте частоту вашей синусоиды в 50-Hz шаги.
counter = 0; while (counter < 1e4) counter = counter + 1; sineWave = osc(); scope(sineWave); if mod(counter,1000)==0 osc.Frequency = osc.Frequency + 50; end end
Создайте мелодию путем настройки частоты колебаний
Настройте частоту аудио генератора с регулярными интервалами, чтобы создать мелодию. Воспроизведите мелодию на устройстве аудио выхода.
Создайте структуру для хранения значений частот нот в мелодии.
notes = struct('C4',261.63,'E4',329.63,'G4sharp',415.30,'A4',440,'B4',493.88, ... 'C5',523.25,'D5',587.25,'D5sharp',622.25,'E5',659.25,'Silence',0);
Создание audioOscillator и audioDeviceWriter объекты. Используйте настройки по умолчанию.
osc = audioOscillator; aDW = audioDeviceWriter;
Создайте вектор с начальной мелодией Fur Elise.
melody = [notes.Silence notes.Silence,... notes.E5 notes.D5sharp notes.E5 notes.D5sharp notes.E5 notes.B4 ... notes.D5 notes.C5 notes.A4 notes.A4 notes.Silence ... notes.C4 notes.E4 notes.A4 notes.B4 notes.B4 notes.Silence ... notes.E4 notes.G4sharp notes.B4 notes.C5 notes.C5 notes.Silence];
Задайте длительность примечания в секундах. В цикле аудиопотока вызовите звуковой генератор и запишите звук в аудио устройство. Обновляйте частоту аудио генератора в noteDuration временные шаги, чтобы следовать мелодии. Как лучшая практика, отпустите объекты после завершения.
noteDuration = 0.3;
i = 1;
tic
while i < numel(melody)
tone = osc();
aDW(tone);
if toc >= noteDuration
i = i + 1;
osc.Frequency = melody(i);
tic
end
end
release(osc)
release(aDW)Управление частотой среза Lowpass
Создайте низкочастотный осциллятор (LFO) lowpass фильтра, используя audioOscillator как сигнал управления.
Создание dsp.AudioFileReader и audioDeviceWriter Системные объекты для чтения с аудио файла и записи в аудио устройство. Создайте объект биквадного фильтра, чтобы применить lowpass к аудиосигналу.
fileReader = dsp.AudioFileReader('Filename','Engine-16-44p1-stereo-20sec.wav'); deviceWriter = audioDeviceWriter('SampleRate',fileReader.SampleRate); lowpassFilter = dsp.BiquadFilter( ... 'SOSMatrixSource','Input port', ... 'ScaleValuesInputPort',false);
Создайте объект аудио генератора. Аудио генератора управляет частотой отключения lowpass фильтра в цикле аудиопотока.
osc = audioOscillator('SignalType','sawtooth', ... 'DCOffset',0.05, ... 'Amplitude',0.03, ... 'SamplesPerFrame',fileReader.SamplesPerFrame, ... 'SampleRate',fileReader.SampleRate, ... 'Frequency',5);
В цикле пропустите аудиосигнал через lowpass. Напишите сигнал выхода в своё аудио устройство.
while ~isDone(fileReader) audioIn = fileReader(); ctrlSignal = osc(); [B,A] = designVarSlopeFilter(48,ctrlSignal(end)); audioOut = lowpassFilter(audioIn,B,A); deviceWriter(audioOut); end
Как лучшая практика, освобождайте объекты после завершения.
release(osc) release(fileReader) release(deviceWriter)
Для более полной реализации LFO-фильтра, смотрите audiopluginexample. LFOFilter в галерее Audio Plugin Example.