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

1. Соедините MIDI-устройство и затем запустите MATLAB

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

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

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

Чтобы установить имя устройства по умолчанию, смотрите MIDI-устройство Значения по умолчанию Набора.

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

[controlNumber,deviceName] = midiid;

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

Используйте midicontrols функция, чтобы создать объект, который прислушивается к сообщениям Изменения Управления и кэширует новые значения, соответствующие заданным контроллерам. Когда вы создаете 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 чтобы отправить сообщения Изменения Управления в ваш 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 также мощный инструмент в системах, которые также включают пользовательские интерфейсы (UIs), так, чтобы, когда одно управление изменяется, другое управление отследило его. Как правило, вы реализуете такое отслеживание путем установки функций обратного вызова на обоих midicontrols объект (использование midicallback) и управление пользовательского интерфейса. Коллбэк для midicontrols объект отправляет новые значения в управление пользовательского интерфейса. Пользовательский интерфейс использует midisync отправить новые значения в midicontrols объект и MIDI управляют поверхностью. Смотрите midisync для примеров.

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

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

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