MIDI Controls
Output values from controls on MIDI control surface
Libraries:
Audio Toolbox /
Sources
DSP System Toolbox /
Sources
Description
The MIDI Controls block outputs values from controls on a MIDI control surface in real time. Use the MIDI Controls block to interact with your audio processing model.
The MIDI Controls block combines the functionality of the general MIDI functions in
MATLAB®: midicontrols
, midiread
, midisync
. Use the MATLAB
midiid
command to discover MIDI device
names or MIDI device control numbers.
Examples
Output Values from MIDI Control Surface
The example shows how to set the MIDI Controls block parameters to output control values from your MIDI device.
Using a MIDI Control Surface to Interact with a Simulink Model
Use a MIDI control surface as a physical user interface to a Simulink® model, allowing you to use knobs, sliders and buttons to interact with that model. It can be used in Simulink as well as with generated code running on a workstation.
Ports
Output
Port_1 — Output signal
matrix
The output size of the MIDI Controls block is determined by the MIDI controls and MIDI control numbers parameters.
The output data type is determined by the Output mode parameter.
Data Type | Output Mode |
---|---|
double | Normalized
(0-1) |
uint8 | RAW MIDI
(0-127) |
Data Types: double
| uint8
Parameters
MIDI device — MIDI control surface your block listens to
Default
(default) | Specify other
To set the default MIDI device, use the setpref
function. For example, if the device is named BCF2000
, at
the MATLAB command line, enter:
setpref('midi','DefaultDevice','BCF2000');
MIDI device name — Device name of MIDI control surface your block listens to
character vector
The MIDI device name is assigned by the device manufacturer or host
operating system, and specified as a character vector. Use midiid
to interactively
identify your MIDI device.
To enable this parameter, set MIDI device to
Specify other
.
MIDI controls — Specify if block responds to all controllers or specific controllers on MIDI surface
Respond to any control
(default) | Respond to specified controls
This parameter also determines the size of the block output port. If you
choose Respond to any control
, then the block
output is a scalar corresponding to the value of the most recently
manipulated control.
MIDI control numbers — Control numbers associated with MIDI surface controllers that your block responds to
0
(default) | integer | array of integers
Use midiid
to interactively identify the control
numbers of your MIDI device. This parameter is available when you set
MIDI controls to Respond to specified
controls
.
Initial values — Control numbers associated with MIDI surface controllers that your block responds to
0
(default) | scalar | array
If you specify Initial values as a scalar, all controls specified by MIDI control numbers are assigned that value.
If you specify Initial values as an array, the array must be the same size as MIDI control numbers.
Send initial values to device at start — Synchronize MIDI surface with values specified initial values
off
(default) | on
Select this parameter to synchronize a MIDI device with values specified
by the Initial values when simulation starts. If your
MIDI device can receive and respond to messages, it adjusts its controls as
specified. This parameter is valid only when MIDI
controls is set to Respond to specified
controls
.
Many MIDI devices are not bidirectional. Selecting this parameter with a unidirectional device has no effect. The MIDI Controls block cannot tell whether a value is successfully sent to a device or even whether the device is bidirectional. If sending a value fails, no errors or warnings are generated.
Output Mode — Output mode for MIDI control value
Normalized (0-1)
(default) | RAW MIDI (0-127)
Output mode for MIDI control value, specified as Normalized
(0-1)
or RAW MIDI
(0-127)
.
Block Characteristics
Data Types |
|
Direct Feedthrough |
|
Multidimensional Signals |
|
Variable-Size Signals |
|
Zero-Crossing Detection |
|
Tips
The MIDI Controls block is not supported for rapid accelerator mode.
Extended Capabilities
C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.
The executable generated from this block relies on prebuilt dynamic library files
(.dll files) included with MATLAB. Use the packNGo
function to package the code
generated from this object and all the relevant files in a compressed zip file.
Using this zip file, you can relocate, unpack, and rebuild your project in another
development environment where MATLAB is not installed. For more details, see Run Audio I/O Features Outside MATLAB and Simulink.
See Also
parameterTuner
| Audio Test Bench | midiid
| midicontrols
| midiread
| midisync
MATLAB 명령
다음 MATLAB 명령에 해당하는 링크를 클릭했습니다.
명령을 실행하려면 MATLAB 명령 창에 입력하십시오. 웹 브라우저는 MATLAB 명령을 지원하지 않습니다.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)