Miles Sound System SDK 7.2a

AIL_map_sequence_channel

The function AIL_map_sequence_channel causes all events in a given sequence which are associated with a given MIDI channel seq_channel to be transmitted instead on a "remapped" MIDI channel new_channel.

void AIL_map_sequence_channel(
  HSEQUENCE S,
  S32 seq_channel,
  S32 new_channel
);

In Parameters

S: specifies the sequence whose channel is to be remapped.
seq_channel: specifies the sequence's original MIDI channel number which is to be remapped to new_channel.
new_channel: specifies the new physical channel through which events on seq_channel will be redirected.

Discussion

As with all XMIDI functions which require an explicit channel parameter, MIDI channel numbers are passed to and from the MSS API in 1-based format (1-16), rather than the 0-based format (0-15) used when composing MIDI Status byte values.

Normally, XMIDI Channel Lock (110) controller events are embedded at the beginning of each sound-effect sequence to automatically handle the necessary channel locking and remapping necessary to overlay the sequence. Most applications will not require the high degree of direct control over a sequence's channel assignments that is provided by this function. A less flexible but somewhat simpler way of implementing dynamic Control Change events involves the use of the XMIDI Indirect Controller Prefix controller. Refer to the Extended MIDI (XMIDI) TechnicalReference, to learn about the use of this feature.

Group: XMIDI Services
Related Functions: AIL_true_sequence_channel
Related Basic Types: HSEQUENCE, S32, void