MIDI Buffer Increment Fill Command

Changes: Bivb.i0=(start,count)

This is similar to the Buffer Fill command except that instead of filling with a specified constant, it fills with an ascending or descending sequence. The format is Bivb.i0=(start,count), where v is Voice number 1-8, and b is buffer number 1-4. i0 is the index (position) where the fill should start, start is the initial value, and count is the number of buffer positions to be filled.

If count is positive, the result is an ascending sequence; if negative, the sequence descends from the initial value.

One important use for this command is for creating buffers full of instrument numbers that include multiple families or portions of families of instrument types. You might want this to allow random selection of only certain instrument types, such as only certain plucked or struck string instruments. (See General MIDI Instrument Sounds for a list of instruments by number and family.)

Suppose you want to include the whole Piano family, instrument numbers 0-7, plus the first five Guitar instruments 24-28, plus all of the Bass family 32-39. To build a list in Voice 1, Buffer 3 you could use:

    Bi13.0=(0,8)
    Bi13.8=(24,5)
    Bi13.13=(32,8)

This fills positions 0-20 with the desired instrument numbers. To set the Voice 1 instrument with a random selection from this set, you would use I1=B13.?(0,20).

Unlike the normal Buffer Fill, Increment Fill may not be used with Voice Patterns (Velocity, Note, or Chord).

See also Changes Script Buffer Operations, Changes Script Overview, Changes Script Editor, MIDI Voice Setup Dialogs, Pitch-to-MIDI dialog, Pitch Track Toolbox - Overview