This instruction is available in MSX-AUDIO Basic, MSX-MUSIC Basic and SFG BASIC.
Contents |
CALL TRANSPOSE in MSX-AUDIO Basic and MSX-MUSIC Basic
Effect
Transposes in units of half tones the FM sounds (melody and rhythm) generated by the FM generator(s). It can be set independently of the pitch parameter.
This instruction is without effect on MIDI, PCM and PSG.
Syntax
CALL TRANSPOSE(<TransposeGenerator1>,<TransposeGenerator2>)
The last parameter is optional. Parameters can not end with a comma alone.
Parameters
<TransposeGenerator1> and <TransposeGenerator2> specify a value between -12799 tot 12799. The unit is 1/100. The extreme values are approximative due to hardware limitations.
After initialization with CALL AUDIO or CALL MUSIC, the value is 0. To increase one octave, specify +1200. To decrease one octave, specify -1200.
When using MSX-MUSIC, <TransposeGenerator2> is ignored even if there are two MSX-MUSIC chips (internal and external for example), because all the MSX-MUSIC chips use only the Z80/R800 ports 7C-7D without possibility of alternative ports.
When using MSX-AUDIO, both parameters are taken in account when two MSX-AUDIO chips are used simultaneously by the MSX computer (using different Z80/R800 ports: C0-C1 for the first FM generator, C2-C3 for the second FM generator). If only the first parameter is specified in such situation, it will be applied to both FM generators.
Example
10 CALL AUDIO 20 CALL TRANSPOSE(0,700)
Related to
CALL AUDIO, CALL MUSIC, CALL PITCH, CALL TEMPER
Compatibility
MSX-AUDIO BASIC, MSX-MUSIC BASIC
CALL TRANSPOSE in SFG Basic
Effect
Transposes in units of half tones simultaneously all instruments.
The maximum transposition up or down is one octave.
Syntax
CALL TRANSPOSE (<Transpose>)
Short version: _TRAN (<Transpose>)
Parameter
<Transpose> is a number between -12 and +12.
After initialization with CALL INIT, the value is 0. To increase one octave, specify +12. To decrease one octave, specify -12.
Example
_TRAN(4)