audioOscillator
Сгенерируйте синус, квадрат и пилообразные формы волны
Описание
Система audioOscillator object™ генерирует настраиваемые формы волны. Типичное использование включает генерацию тестовых сигналов для испытательных стендов и генерацию управляющих сигналов для звуковых эффектов. Свойства Системного объекта audioOscillator задают тип сгенерированной формы волны.
Сгенерировать настраиваемые формы волны:
Создайте объект
audioOscillatorи установите его свойства.Вызовите объект с аргументами, как будто это была функция.
Чтобы узнать больше, как Системные объекты работают, смотрите то, Что Системные объекты? MATLAB.
Создание
Синтаксис
osc = audioOscillatorosc = audioOscillator(signalTypeValue)osc = audioOscillator(signalTypeValue,frequencyValue)osc = audioOscillator(___,Name,Value)Описание
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 кГц со смещением DC одного.Свойства
Использование
Для версий ранее, чем R2016b, используйте функцию step, чтобы запустить алгоритм Системного объекта. Аргументы к step являются объектом, который вы создали, сопровождаемый аргументами, показанными в этом разделе.
Например, y = step(obj,x) и y = obj(x) выполняют эквивалентные операции.
Синтаксис
waveform = osc()Описание
Выходные аргументы
Функции объекта
Чтобы использовать объектную функцию, задайте Системный объект как первый входной параметр. Например, чтобы выпустить системные ресурсы Системного объекта под названием obj, используйте этот синтаксис:
release(obj)
createAudioPluginClass и функции configureMIDI сопоставляют настраиваемые свойства Системного объекта audioOscillator к стоящим с пользователем параметрам:
| Свойство | Область значений | Отображение | Модули |
|---|---|---|---|
Frequency | [0.1, 20000] | журнал | Гц |
Amplitude | [0, 10] | линейный | никакие модули |
DCOffset | [–10, 10] | линейный | никакие модули |
DutyCycle (доступный, когда вы устанавливаете SignalType на 'square'), | [0, 1] | линейный | никакие модули |
Width (доступный, когда вы устанавливаете SignalType на 'sawtooth'), | [0, 1] | линейный | никакие модули |
Примеры
Сгенерируйте синусоиду переменной частоты
Используйте audioOscillator, чтобы сгенерировать синусоиду переменной частоты.
Создайте аудио осциллятор, чтобы сгенерировать синусоиду. Используйте настройки по умолчанию.
osc = audioOscillator;
Создайте осциллограф времени, чтобы визуализировать синусоиду переменной частоты, сгенерированную аудио осциллятором.
scope = dsp.TimeScope( ... 'SampleRate',osc.SampleRate, ... 'TimeSpan',0.1, ... 'YLimits',[-1.5,1.5], ... 'TimeSpanOverrunAction','Scroll', ... 'ShowGrid',true, ... 'Title','Variable-Frequency Sine Wave');
Поместите аудио осциллятор в цикл аудиопотока. Увеличьте частоту своей синусоиды с шагом на 50 Гц.
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 objects™. Используйте настройки по умолчанию.
osc = audioOscillator; aDW = audioDeviceWriter;
Создайте вектор с начальной мелодией Фур Элис.
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, чтобы читать из звукового файла и записать в ваше аудио устройство. Создайте biquad объект фильтра, чтобы применить 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.