MidiDjConsole.ProfileDisplayMidiCommandSet method |
|
Remarks
Sets parameters of the short MIDI command specific for a VFD display control item stored inside the profile. Current parameters of the short MIDI command can be obtained through the MidiDjConsole.ProfileDisplayMidiCommandGet method.
The short MIDI command is composed of 2 bytes combining 3 elements:
• | One byte composed by the code of the MIDI Command, typically a "Control change" (hex B0) on the more significant 4 bits and by the MIDI channel on the less significant 4 bits. |
• | One byte of MIDI "Data", usually indicated as "Data1", representing the code of the physical display control. |
Data to display on the VFD display element are sent through the second byte of MIDI data, usually indicated as "Data2", and can be sent through the MidiDjConsole.ProfileDisplayDataSet method.
The combination of MIDI command parameters is usually defined inside the technical specifications of the physical DJ Console and may vary a lot depending upon the DJ Console in use.
For further details about interfacing with MIDI DJ Consoles see the MidiDjConsole object section and the How to manage MIDI DJ consoles tutorial.
Syntax
[Visual Basic] control.MidiDjConsole.ProfileDisplayMidiCommandSet ( strItemName as String, nMidiCommand as Integer, nMidiChannel as Integer, nMidiControlCode as Integer ) as enumDjcErrorCodes |
[C++] short control.MidiDjConsole.ProfileDisplayMidiCommandSet ( BSTR strItemName, short nMidiCommand, short nMidiChannel, short nMidiControlCode ); |
Parameter |
Description |
|
|
strItemName |
String containing the name of the VFD display item. If no range control item with this specific name should be available inside the profile, the method would fail and would return an error code. |
nMidiCommand |
The MIDI command issued when display's content needs to be modified. In many cases the value of this parameter is 176 (hex B0) which indicates a "Control change" MIDI command. |
nMidiChannel |
The number representing the MIDI channel. |
nMidiControlCode |
The number representing the code (Data1 field described above) of the VFD display control item. |
Return value
Value |
Meaning |
|
|
Negative value |
An error occurred, check the LastError property value in order to get the error code |
enumErrorCodes.ERR_NOERROR (0) |
The method call was successful |