externalAudioPlugin class

Базовый класс для внешних аудио плагинов

Описание

externalAudioPlugin базовый класс для размещенных аудио плагинов. Когда вы загружаете внешний плагин с помощью loadAudioPlugin, объект того плагина создается, имея externalAudioPlugin или externalAudioPluginSource как базовый класс. externalAudioPluginSource класс используется, когда внешний аудио плагин является исходным плагином.

Для примера при хостинге аудио плагинов смотрите Хост Внешние Аудио Плагины.

Методы

dispParameterОтобразите информацию сингла или нескольких параметров
getParameterПолучите нормированное значение и информацию о параметре
информацияПолучите информацию о размещенном плагине
процессАудиопоток процесса
setParameterУстановите нормированное значение параметров размещенного плагина

Унаследованные методы

getSampleRateПолучите частоту дискретизации, на уровне которой запущен плагин
setSampleRateУстановите частоту дискретизации, на уровне которой запущен плагин

Копировать семантику

Указатель. Чтобы изучить, как классы Handle влияют на операции копии, смотрите Поведение объекта (MATLAB) в документации MATLAB®.

Примеры

свернуть все

Загрузите плагин аудио VST в MATLAB® путем определения его полного пути. Если вы используете Mac, заменяете .dll расширение файла с .vst.

pluginPath = fullfile(matlabroot,'toolbox/audio/samples/ParametricEqualizer.dll');
hostedPlugin = loadAudioPlugin(pluginPath)

Используйте info возвратить информацию о размещенном плагине.

info(hostedPlugin)

Используйте setParameter изменить нормированное значение Medium Center Frequency параметр к 0,75. Задайте параметр его индексом.

setParameter(hostedPlugin,5,0.75)

Когда вы устанавливаете нормированное значение параметров, значение отображения параметра автоматически обновляется. Нормированное значение параметров обычно соответствует положению виджета пользовательского интерфейса или MIDI-контроллера. Значение отображения параметра обычно отражает значение, используемое внутренне в обработке.

Используйте dispParameter отобразить обновленную таблицу параметров.

dispParameter(hostedPlugin)

В качестве альтернативы можно использовать getParameter возвращать нормированное значение одного параметра.

parameterIndex = 5;
parameterValue = getParameter(hostedPlugin,parameterIndex)

Загрузите плагин аудио VST в MATLAB™ путем определения его полного пути. Если вы используете Mac, заменяете .dll расширение файла с .vst.

pluginPath = ...
    fullfile(matlabroot,'toolbox/audio/samples/ParametricEqualizer.dll');
hostedPlugin = loadAudioPlugin(pluginPath);

Создайте объекты ввода и вывода для цикла аудиопотока, который читает из файла и пишет в ваше аудио устройство. Установите частоту дискретизации размещенного плагина к частоте дискретизации входа к плагину.

fileReader   = dsp.AudioFileReader('FunkyDrums-44p1-stereo-25secs.mp3');
deviceWriter = audioDeviceWriter('SampleRate',fileReader.SampleRate);
setSampleRate(hostedPlugin,fileReader.SampleRate);

Установите MediumPeakGain свойство к-20 дБ.

hostedPlugin.MediumPeakGain = -20;

Используйте размещенный плагин, чтобы обработать звуковой файл в цикле аудиопотока. Разверните среднее пиковое усиление вверх в цикле, чтобы услышать эффект.

while hostedPlugin.MediumPeakGain < 19
    hostedPlugin.MediumPeakGain = hostedPlugin.MediumPeakGain + 0.04;
    x = fileReader();
    y = process(hostedPlugin,x);
    deviceWriter(y);
end

release(fileReader)
release(deviceWriter)

Введенный в R2017b

Для просмотра документации необходимо авторизоваться на сайте