Exponenta Banner
exponenta event banner

midicontrols

Откройте группу средств управления MIDI для чтения

свернуть все на странице

В будущем релизе, midicontrols функция потребует Audio Toolbox™.

Синтаксис

h = midicontrols
h = midicontrols(ControlNumbers)
h = midicontrols(ControlNumbers,InitialValues)
h = midicontrols(___,'MIDIDevice',devicename)
h = midicontrols(___,'OutputMode',mode)

Описание

пример

h = midicontrols возвращает объект, который отвечает на любое управление на MIDI-устройстве по умолчанию. Вызов midiread с объектом, возвращает двойное скалярное значение управления MIDI, которое недавно переместилось после того, как объект был создан. Значение обычно находится в области значений [0 1]. Смотрите OutputMode для альтернативы. Этот объект может только определить значение управления, если управление перемещено после midicontrols объект создается. Если midiread называется, прежде чем управление перемещено, midiread возвращает начальное значение по умолчанию 0.

пример

h = midicontrols(ControlNumbers) возвращает объект, который отвечает на средства управления MIDI, заданные ControlNumbers. Вызов midiread с объектом, возвращает двойной массив той же формы как ControlNumbers. Используйте midiid в интерактивном режиме идентифицировать контрольное число отдельных средств управления MIDI.

пример

h = midicontrols(ControlNumbers,InitialValues) возвращает объект, который использует заданный InitialValues когда средства управления не перемещены после того, как объект создается. Поскольку начальные значения квантуются для базового протокола MIDI, иногда midiread возвращает начальное значение, которое немного отличается от InitialValues.

пример

h = midicontrols(___,'MIDIDevice',devicename) задает MIDI-устройство, на которое отвечает объект. Используйте midiid в интерактивном режиме идентифицировать имя определенного MIDI-устройства. Если вы не задаете 'MIDIDevice' пара "имя-значение", MIDI-устройство по умолчанию используется. Настройка MATLAB® 'midi' 'DefaultDevice' определяет устройство по умолчанию.

пример

h = midicontrols(___,'OutputMode',mode) указывает диапазон значений, возвращенных midiread и принятый как InitialValues. Эта пара "имя-значение" является дополнительной, и можно вставить ее только в конце списка аргументов.

Примеры

свернуть все

Создайте объект и читайте из него:

h =midicontrols
midiread(h)

Переместите одни из средств управления и считайте данные:

midiread(h)

Заставьте объект ответить на определенное управление:

h = midicontrols(1081);

Возвратите квадратный массив с начальным значением 0,5:

h = midicontrols([1081 1083; 1082 1084], 0.5);

Возвратите квадратный массив с необработанным начальным значением 63:

h = midicontrols([1081 1083; 1082 1084], 63, 'OutputMode', 'rawmidi');

Примите, что вашим MIDI-устройством является Behringer BCF2000. Установите устройство по умолчанию этот путь:

setpref midi DefaultDevice BCF2000
Эта настройка сохраняется через сеансы работы с MATLAB, таким образом, вы не должны устанавливать ее снова, если вы не хотите изменить устройства.

Ответьте на управление 1001 на Behringer BCF2000:

h = midicontrols(1001, 'MIDIDevice', 'BCF2000');

Входные параметры

свернуть все

ControlNumbers числа с двойной точностью с целочисленным знаком. Каждое управление на MIDI-устройстве имеет определенное целое число, присвоенное ему производителем устройств. Если ControlNumbers [], затем midicontrols объект отвечает на любое управление на MIDI-устройстве. В результате midiread возвращает двойной скаляр.

Пример: 1081

Типы данных: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

InitialValues должен или быть массив одного размера с ControlNumbers или скаляр. Если вы не задаете InitialValues, начальным значением по умолчанию является 0. Как правило, начальные значения должны быть в области значений [0 1]. Однако, если вы задаете 'rawmidi' как OutputMode, InitialValues область значений между 0 и 127. Поскольку начальные значения квантуются для базового протокола MIDI, иногда midiread возвращает начальное значение, которое немного отличается от InitialValues.

Пример: 0.3 or [0 0.3 0.6]

Типы данных: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

devicename символьная строка, присвоенная производителем устройств или хостовой операционной системой. Заданный devicename может быть подстрока точного имени устройства. Если вы не задаете ‘MIDIDevice’пара "имя-значение", MIDI-устройство по умолчанию используется. Настройка MATLAB ‘midi’, ‘DefaultDevice’определяет устройство по умолчанию.

Если вы не устанавливаете настройку MATLAB, хостовая операционная система выбирает устройство по умолчанию незаданным способом. Некоторые системы имеют виртуальный (т.е., программное обеспечение) установленные MIDI-устройства. Даже если у вас есть только одно аппаратное MIDI-устройство, присоединенное к вашей системе, система не может выбрать его, который может вызвать беспорядок. Как лучшая практика, используйте midiid чтобы идентифицировать имя устройства, вы хотите. Затем используйте setpref установить его как устройство по умолчанию.

Пример: 'BCF2000 MIDI 1'

Типы данных: char

mode строка и должен быть один из ‘normalized’ или ‘rawmidi’. В нормированном режиме значения находятся в области значений [0 1]. Кроме того, начальные значения квантуются для базового протокола MIDI. В необработанном режиме MIDI значения являются целыми числами в области значений [0 127], и квантование начальных значений не выполняется. Значением по умолчанию этой пары "имя-значение" является ‘normalized’.

Пример: 'rawmidi'

Типы данных: char

Выходные аргументы

свернуть все

h объект, который слушает средства управления на MIDI-устройстве.

Смотрите также

| | | |

Введенный в R2013b

Документация DSP System Toolbox
Поддержка