Документация

1. Подключите устройство MIDI, а затем запустите MATLAB

Перед запуском MATLAB подключите поверхность управления MIDI к компьютеру и включите ее. Инструкции по подключению см. в инструкциях для устройства MIDI. Если запустить MATLAB перед подключением устройства, MATLAB может не распознать устройство при его подключении. Чтобы устранить проблему, перезапустите MATLAB с уже подключенным устройством.

2. Определение имени устройства и контрольных номеров

Используйте midiid для определения имени устройства и контрольных номеров поверхности управления MIDI. После звонка midiid, он продолжает прослушивать, пока не получит сообщение Control Change. При получении сообщения Control Change возвращается управляющий номер, связанный с номером MIDI-контроллера, которым вы манипулировали, и при необходимости возвращается имя устройства вашей MIDI-поверхности управления. Имя устройства определяется изготовителем и операционной системой хоста. Для получения информации о том, как MATLAB вычисляет управляющий номер, см. раздел Управляющие номера.

Чтобы задать имя устройства по умолчанию, см. раздел Установка устройства MIDI по умолчанию.

 Пример просмотра

[controlNumber,deviceName] = midiid;

3. Создание прослушивателя для сообщений об изменении элементов управления

Используйте midicontrols создание объекта, который прослушивает сообщения Control Change и кэширует последние значения, соответствующие указанным контроллерам. При создании midicontrols объект, поверхность управления MIDI задается по имени устройства, а конкретные контроллеры на поверхности - по соответствующим номерам элементов управления. Потому что midicontrols объект не может запрашивать начальные значения на поверхности управления MIDI, рассмотрите возможность установки начальных значений при создании объекта.

 Пример просмотра

controlNum1 = midiid;
[controlNum2,deviceName] = midiid;
initialControlValues = [0.1,0.9];

midicontrolsObject = midicontrols([controlNum1,controlNum2], ...
    initialControlValues, ...
    'MIDIDevice',deviceName);

4. Получение текущих управляющих значений

Используйте midiread функция для запроса midicontrols объект для текущих управляющих значений. midiread возвращает матрицу со значениями, соответствующими всем контроллерам midicontrols объект прослушивает. Как правило, требуется разместить midiread в цикле аудиопотока для непрерывного обновления.

 Пример просмотра

[controlNumber, deviceName] = midiid;
initialControlValue = 1;
midicontrolsObject = midicontrols(controlNumber,initialControlValue,'MIDIDevice',deviceName);

% Create a dsp.AudioFileReader System object™ with default settings. Create
% an audioDeviceWriter System object and specify the sample rate.
fileReader = dsp.AudioFileReader('RockDrums-44p1-stereo-11secs.mp3');
deviceWriter = audioDeviceWriter(...
    'SampleRate',fileReader.SampleRate);

% In an audio stream loop, read an audio signal frame from the file, apply
% gain specified by the control on your MIDI device, and then write the
% frame to your audio output device. By default, the control value returned
% by midiread is normalized.
while ~isDone(fileReader)
    audioData = step(fileReader);
    
    controlValue = midiread(midicontrolsObject);
    
    gain = controlValue*2;
    audioDataWithGain = audioData*gain;
    
    play(deviceWriter,audioDataWithGain);
end

% Close the input file and release your output device.
release(fileReader);
release(deviceWriter);

5. Синхронизация двунаправленных управляющих поверхностей MIDI

Вы можете использовать midisync для отправки сообщений Control Change на поверхность управления MIDI. Если поверхность управления MIDI является двунаправленной, она настраивает указанные контроллеры. Одно важное использование midisync - установка начальных значений положения контроллера на поверхности управления MIDI.

 Пример просмотра

[controlNumber,deviceName] = midiid;
initialControlValue = 0.5;
midicontrolsObject = midicontrols(controlNumber,initialControlValue,'MIDIDevice',deviceName);

midisync(midicontrolsObject);

Другое важное использование midisync обновляет поверхность управления MIDI, если управляющие значения корректируются в цикле аудиопотока. В этом случае вы звоните midisync с обоими вашими midicontrols и обновленные управляющие значения.

 Пример просмотра

[controlNumber, deviceName] = midiid;
initialControlValue = 0.5;
midicontrolsObject = midicontrols(controlNumber,initialControlValue);
fileReader = dsp.AudioFileReader('Ambiance-16-44p1-mono-12secs.wav');
deviceWriter = audioDeviceWriter(...
    'SampleRate',fileReader.SampleRate);

% Synchronize specified initial value with the MIDI control surface.
midisync(midicontrolsObject);          

while ~isDone(fileReader)
    audioData = step(fileReader);
    controlValue = midiread(midicontrolsObject);
    gain = controlValue*2;
    audioDataWithGain = audioData*gain;
    
    % Check if max output is above a given threshold.
    if max(audioDataWithGain) > 0.7
        
        % Force new control value to be nonnegative.
        newControlValue = max(0,controlValue-0.5);
        
        % Send a Control Change message to the MIDI control surface.
        midisync(midicontrolsObject,newControlValue)
    end
    
    play(deviceWriter,audioDataWithGain);
end

release(fileReader);
release(deviceWriter);

midisync также является мощным инструментом в системах, которые также включают пользовательские интерфейсы (UI), так что при изменении одного элемента управления другой элемент управления отслеживает его. Как правило, такое отслеживание реализуется путем установки функций обратного вызова на обоих midicontrols объект (с использованием midicallback) и управления пользовательским интерфейсом. Обратный вызов для midicontrols объект отправляет новые значения в элемент управления пользовательского интерфейса. Пользовательский интерфейс использует midisync для отправки новых значений в midicontrols объект и управляющая поверхность MIDI. Посмотрите midisync для примеров.

Альтернатива потоковой обработке

Вы можете использовать midicallback в качестве альтернативы размещению midiread в цикле аудиопотока. Если midicontrols объект получает сообщение Control Change, midicallback автоматически вызывает указанный дескриптор функции. Функция обратного вызова обычно вызывает midiread для определения нового значения элементов управления MIDI. Этот обратный вызов можно использовать, если требуется, чтобы MIDI-контроллер запустил действие, например обновление пользовательского интерфейса. Использование этого подхода предотвращает непрерывное выполнение программы MATLAB в окне команд.

Установка устройства MIDI по умолчанию

Можно установить устройство MIDI по умолчанию в среде MATLAB с помощью setpref функция. Использовать midiid чтобы определить имя устройства, а затем использовать setpref для установки настройки.

[~,deviceName] = midiid

Move the control you wish to identify; type ^C to abort.
Waiting for control message... done

deviceName =

BCF2000

setpref('midi','DefaultDevice',deviceName)

Если эта настройка не задана, MATLAB и операционная система хоста выберут для вас устройство. Однако такой автовыбор может привести к непредсказуемым результатам, поскольку на многих компьютерах установлены «виртуальные» (программные) устройства MIDI, о которых вы можете не знать. Для предсказуемого поведения задайте настройку.

Контрольные номера

MATLAB определяет контрольные номера как (номер канала MIDI) × 1000 + (номер контроллера MIDI).

Устройство MIDI определяет значения номера канала MIDI и номера контроллера MIDI.