midicontrols

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

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

Синтаксис

midicontrolsObject = midicontrols
midicontrolsObject = midicontrols(controlNumbers)
midicontrolsObject = midicontrols(controlNumbers,initialValues)
midicontrolsObject = midicontrols(___,'MIDIDevice',deviceName)
midicontrolsObject = midicontrols(___,'OutputMode',mode)

Описание

пример

midicontrolsObject = midicontrols возвращает объект, который слушает все средства управления на вашем MIDI-устройстве по умолчанию.

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

пример

midicontrolsObject = midicontrols(controlNumbers) слушает средства управления, заданные controlNumbers на вашем MIDI-устройстве по умолчанию.

пример

midicontrolsObject = midicontrols(controlNumbers,initialValues) задает initialValues сопоставленный с controlNumbers.

пример

midicontrolsObject = midicontrols(___,'MIDIDevice',deviceName) задает MIDI-устройство ваш midicontrols объект слушает, с помощью любого из предыдущих синтаксисов.

пример

midicontrolsObject = midicontrols(___,'OutputMode',mode) указывает диапазон значений, возвращенных midiread и принятый как initialValues для midicontrols и как controlValues для midisync.

Примеры

свернуть все

Создайте a midicontrols возразите и считайте значение управления по умолчанию.

midicontrolsObject = midicontrols
midiread(midicontrolsObject)
midicontrolsObject = 

midicontrols object: any control on 'BCF2000'

ans =

     0

Переместите любое управление в свое MIDI-устройство. Использование midiread возвращать новое значение последнего перемещенного управления.

midiread(midicontrolsObject)
ans =

    0.3810

Использование midiid идентифицировать имя вашего MIDI-устройства и заданного управления. Переместите управление MIDI, которое вы хотите идентифицировать.

[controlNumber,deviceName] = midiid;
Move the control you wish to identify; type ^C to abort.
Waiting for control message...

Создайте объект, который отвечает на управление, которое вы задали.

midicontrolsObject = midicontrols(controlNumber);

Переместите ваш, выбрал управление MIDI, и затем используйте midiread возвращать его новое значение.

midicontrolsObject = midiread(midicontrolsObject);
ans =

    0.4048

Определите контрольные числа четырех различных средств управления на вашем MIDI-устройстве.

[controlNumber1,~] = midiid;
[controlNumber2,~] = midiid;
[controlNumber3,~] = midiid;
[controlNumber4,~] = midiid;

controlNumbers = [controlNumber1,controlNumber3;...
                  controlNumber2,controlNumber4]
Move the control you wish to identify; type ^C to abort.
Waiting for control message... done
Move the control you wish to identify; type ^C to abort.
Waiting for control message... done
Move the control you wish to identify; type ^C to abort.
Waiting for control message... done
Move the control you wish to identify; type ^C to abort.
Waiting for control message... done

controlNumbers =

        1081        1085
        1082        1087

Создайте a midicontrols объект, который слушает ваши заданные средства управления. Задайте начальное значение для всех средств управления.

initialValue = 0.5;
midicontrolsObject = midicontrols(controlNumbers,initialValue);

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

midiread(midicontrolsObject)
ans =

    0.0873    0.5000
    0.5000    0.5000

Определите контрольные числа двух различных средств управления на вашем MIDI-устройстве.

[controlNumber1,~] = midiid;
[controlNumber2,~] = midiid;

controlNumbers = [controlNumber1,controlNumber2];

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

Создайте a midicontrols объект, который слушает ваши заданные средства управления. Задайте начальное значение для всех средств управления.

initialValue = 12;
midicontrolsObject = midicontrols(controlNumbers,initialValue,'OutputMode','rawmidi');

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

midiread(midicontrolsObject)
ans =

    63    12

Примите, что вашим MIDI-устройством является Behringer BCF2000. Введите этот синтаксис в командной строке MATLAB®:

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

Примите, что ваше MIDI-устройство является Behringer BCF2000 и имеет контроль с идентификационным номером 1001. Создайте a midicontrols объект, который слушает контрольное число 1001 на вашем устройстве Behringer BCF2000.

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

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

свернуть все

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

Если вы задаете controlNumbers как пустой вектор, [ ], затем midicontrols объект отвечает на любое управление на вашем MIDI-устройстве.

Пример: 1081

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

Начальные значения MIDI управляют в виде скаляра или массива тем же размером как controlNumbers. Если вы задаете initialValues как скаляр, все средства управления заданы controlNumbers присвоены то значение.

Значение, сопоставленное с вашими средствами управления MIDI, не может быть определено, пока вы не перемещаете управление MIDI. Если вы задаете начальное значение, сопоставленное с вашим управлением MIDI, начальное значение возвращено midiread функция до управления MIDI перемещена.

  • Если OutputMode задан как 'normalized', затем начальные значения должны быть в области значений [0,1]. Фактические начальные значения квантуются и могут немного отличаться от начальных значений, заданных когда ваш midicontrols объект создается.

  • Если OutputMode задан как 'rawmidi', затем начальные значения должны быть целыми числами в области значений [0,127]

Пример: 0.3

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

Пример 5

Пример: [5;15;20]

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

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

Если вы не устанавливаете MIDI-устройство по умолчанию, хостовая операционная система выбирает устройство по умолчанию незаданным способом. Как лучшая практика, использовать midiid чтобы идентифицировать имя устройства, вы хотите.

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

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

Режим вывода для MIDI управляет значением в виде 'normalized' или 'rawmidi'.

  • 'normalized' — Значения вашего управления MIDI нормированы. Если ваш midicontrols объект вызван midiread, затем значения в области значений [0,1] возвращены.

  • 'rawmidi' — Значения вашего управления MIDI не нормированы. Если ваш midicontrols объект вызван midiread, затем целочисленные значения в области значений [0,127] возвращены.

Пример: 'OutputMode','normalized'

Пример: 'OutputMode','rawmidi'

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

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

свернуть все

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

Больше о

свернуть все

Контрольные числа MIDI-устройства

MATLAB задает MIDI device control numbers как (MIDI Channel Number) × 1000 + (MIDI Controller Number).

  • MIDI Channel Number является каналом передачи что ваше использование устройства, чтобы отправить сообщения. Это значение находится в области значений 1–16.

  • MIDI Controller Number является номером, присвоенным отдельному управлению на вашем MIDI-устройстве. Это значение находится в области значений 1–127.

Ваше MIDI-устройство определяет значения MIDI Channel Number и MIDI Controller Number.

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

| | | | | | | | |

Темы

Введенный в R2016a

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

Поддержка

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