Copyright © 2013-2015 MultiMedia Soft

MidiDjConsole.ProfileDisplayMidiCommandSet method

Previous pageReturn to chapter overviewNext page

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]

MidiDevices.MidiDjConsole.ProfileDisplayMidiCommandSet (

strItemName as String,

nMidiCommand as Int16,

nMidiChannel as Int16,

nMidiControlCode as Int16

) as enumDjcErrorCodes


 

[C#]

public enumDjcErrorCodes MidiDjConsole.ProfileDisplayMidiCommandSet (

string strItemName,

Int16 nMidiCommand,

Int16 nMidiChannel,

Int16 nMidiControlCode

);


 

[C++]

public: enumDjcErrorCodes MidiDjConsole.ProfileDisplayMidiCommandSet (

string strItemName,

Int16 nMidiCommand,

Int16 nMidiChannel,

Int16 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 see the last error.

enumDjcErrorCodes.ERR_DJC_NOERROR (0)

The method call was successful.