MIDI Buffer eXchange Command

Changes: BXvb.i0=vb(i1,i2)

The Buffer eXchange (BX) command allows a MIDI Changes script to swap one section of an input buffer with another section of the same or different buffer, in the same or different Voice.

You can use Set Pointers to set start and end note positions in each buffer, and Input Select to use one or both buffers as input streams for voices.

The format for Buffer eXchange is BXvb.i0=vb(i1,i2), where the left side refers to one buffer and the right to the other. v is Voice number 1-8, and b is buffer number 1-4. i0 is the index (position) where the swap should start in the left buffer, and (i1,i2) are the start and end positions in the right buffer If i1 is greater than i2 then the swap will also reverse the order of the notes in both buffers.

Positions i0, i1, and i2 may use any unsigned integer or valid expression, including current MIDI control values, random values, current computer keyboard states or mouse position, input or buffered notes, oscillators, and User Variables. Values will be limited to the 0-255 buffer position range.

The eXchange command does not allow swapping with the live input (buffer 0).

In addition to swapping between buffers, you can also swap between Velocity, Note, or Chord Patterns, designated by V, N, or C instead of a buffer number. Alternatively, you can use P (Pattern) to swap all three at once. Both the left and right sides of the eXchange command must refer to the same type of pattern (V, N, C, or P), but they may refer to the same or different voices. You may not swap between a buffer and a pattern.

Percussion Velocity Patterns can be swapped within the same pattern, between other Percussion Velocity Patterns, or with Voice Velocity Patterns. To refer to Percussion, use A through F instead of Voice number 1-8. For example, BXBV.0=AV(0,7) swaps the first 8 Velocity characters between Percussion Velocity A and B.

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