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

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

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

2. Определите имя устройства и номера управления

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

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

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

[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) и управление UI. Коллбэк для midicontrols объект отправляет новые значения в элемент управления UI. Пользовательский интерфейс использует midisync для отправки новых значений в midicontrols объект и поверхность управления MIDI. Посмотрите midisync для примеров.

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

Вы можете использовать midicallback как альтернатива размещению midiread в цикле аудиопотока. Если midicontrols объект получает сообщение Control Change, midicallback автоматически вызывает указанный указатель на функцию. Функция обратного вызова обычно вызывает midiread для определения нового значения элементов управления 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 channel number) × 1000 + (MIDI controller number).

Ваше устройство MIDI определяет значения MIDI channel number и MIDI controller number.