## Multi-point Controller Command

This command enables MIDI controller changes as well as tempo changes to be inserted into the song during play back. The changes can either by absolute changes, or the item can be instructed to gradually produce the change (Linear Sweep).

This symbol can be used for sophisticated control over the performance of the song. For example, it can be used to:

- fade a part in or out during a song
- gradually speed up or slow down a selection
- change the pitch of a sustained note (string bends and the like)

The notation item produced from this command can only be seen from within the score editor. The display associated with this command does not get printed. This item can be changed using the Edit Selection command.

When this command is invoked, the MIDI Controller Specification dialog is presented. It contains the following information:

MIDI Controller Specification

Controller: This is where the type of controller that you want to control should be designated. You can chose from:

Tempo | Controls the tempo of the performance
Volume | Controls the loudness of the performance
Stereo Pan | Controls where in a stereo image the instrument will be heard
Breath Control | For instruments which support it, this controls the parameter designed to simulate wind flow into the instrument
Pitch Bend | Most useful when used to change the pitch of a sustained note
Modulation Wheel | Used to change the settings for the Mod Wheel in the synthesizer, if this parameter is supported
Foot Controller | Used to change the settings for the Foot Controller in the synthesizer, if this parameter is supported
Portamento Time | Used to change the settings for Portamento Time in the synthesizer, if this parameter is supported
Data Entry MSB | Used to change the settings for the Data Entry MSB in the synthesizer, if this parameter is supported
Balance | Used to change the settings for Balance in the synthesizer, if this parameter is supported
Expression | Used to change the settings for the Expression in the synthesizer, if this parameter is supported
Effect Controller 1 | Used to change the settings for Effect Controller 1 in the synthesizer, if this parameter is supported
Effect Controller 2 | Used to change the settings for Effect Controller 2 in the synthesizer, if this parameter is supported
Effects (Reverb) Depth | Used to change the settings for Effects (Reverb) Depth in the synthesizer, if this parameter is supported
Tremolo Depth | Used to change the settings for Tremolo Depth in the synthesizer, if this parameter is supported
Chorus Depth | Used to change the settings for Chorus Depth in the synthesizer, if this parameter is supported
Celeste Detune Depth | Used to change the settings for Celeste Detune Depth in the synthesizer, if this parameter is supported
Phaser Depth | Used to change the settings for Phaser Depth in the synthesizer, if this parameter is supported

Style: You can set up to 4 control points with different values for the controller you specify. This field allows you to specify the algorithm that will be used to interpret the control points.

Absolute | Only the specific values at specific times will be performed
Linear Sweep | Changes between the control points will be changed gradually over the time specified

Time Offset Multiplier: The numeric values that you place into the Time Offset field for each control point are relative times. They are converted to absolute musical intervals by multiplying them by the time offset multiplier specified here.

Linear Sweep Contour: This field can be used to control how dense a series of control changes will be when the Linear Sweep control change style. The larger the value you use, the fewer actual control changes will be used during the linear control sweep. This is most useful for pitch bends, as a very large number of control changes are possible when sweeping the pitch over its full range, thus sometimes overflowing the MIDI data stream.

Put another way, this defines how large a change to the controller value will be considered significant. In the case of pitch bend, where the value can be swept over thousands of values, each and every change of only 3 or 4 is not very important. In this case, you might use a value of 100, or even more, depending on how smooth you wish the pitch bend to be. This allows the program to lean out the number of control changes sent to the MIDI device, which can significantly improve performance. Think of it like this. If you started at 0 and wanted to count out loud to 10000 in 2 minutes, then:

- using a contour setting of 1, you would count like this: "1, 2, 3, 4, 5, 6, 7, 8, 9..." all the way to 10000, and you would have to speak very fast to finish in 2 minutes
- using a contour setting of 100, you would count: "100, 200, 300, 400, 500..." all the way to 10000, and you would probably have no trouble finishing in 2 minutes

The same is true with this setting. A higher contour value makes it easier for the controller to change the value from the value of 1 up to the value of 10000.

Control Point Settings: The lower area of the dialog is where you actually can define up to four control points. The first point is automatically enabled, so there is not an enabling checkbox. The other three points have a checkbox which you use to enable the corresponding control point.

Time Offset: The time offset for each control point gets multiplied by the Time Offset Multiplier field and then added to the current song position. This is how you specify when the control point should be initiated. Each control point's time offset is added to the previous control point's event time. This means that Setting 3 will always occur sometime after Setting 2, and so on. The time offsets do not change when particular notes are played that follow after the controller item in the staff, so one controller item can influence a series of note events.

Controller Value: The scroll bars next to each setting control the value associated with that control point. The range of the control point varies with the type of controller that has been specified.

Special Note: Inserting a Multi-point Controller that contains control points that are scheduled at time offset well beyond the current beat can significantly add to the hesitation time between when you request play and actually hear the song start to play back.

MIDI Controllers: For those that want to know the exact MIDI controllers used by the multi-point controller, the following controller names map to MIDI control numbers as shown:

Name | Controller #
Volume | 7
Stereo Pan | 10
Breath Control | 2
Modulation Wheel | 1
Foot Controller | 4
Portamento Time | 5
Data Entry MSB | 6
Balance | 8
Expression | 11
Effect Controller 1 | 12
Effect Controller 2 | 13
Effects (Reverb) Depth | 91
Tremolo Depth | 92
Chorus Depth | 93
Celeste Detune Depth | 94
Phaser Depth | 95

See Also

- Insert Menu Commands