Welcome!


<About XM2YXM>
The idea to create such a tool came along as i wanted
to have some music in KAMIX. I was searching for something
not too complex, but i haven't found. And i don't have programms
to edit MIDI songs to use as SEQ.
In the past i was often using the ProTracker on the Amiga 
to make some tunes and it wasn't far to me, that had to do
somthing ProTracker like. I've heard about DMS, but didn't found.
On the PC i've decided that the FastTrackerII form STARBREEZE
is my favourite one. The FT2 has the same atomsphere during working
as the ProTracker.


<Disadvantages using XM2YXM Songs>
Well there are many:
 - Cannot be timed using timer, which is more precise.
 - There is not a 100% relay that the songs are sounding the
   same as on PC. The reasons are: not all effects can be used,
   the effects which are used are not 1:1, note conversion not 1:1, ....
 - Using the songs in NTSC mode causes the tune to run faster, because
   the timing is done every VSync().

you see many points not to use it .... but for simply tune ..... i mean ....
here to the demo songs to get an impression.


<Requirements>
- XM2YXM uses the programms AIFF2VAG, MKVAB, VABSPLIT which you sure have.
  note: if you have XM2YXM in different directory then a <path> has to be done where
        the programms are stored.
- The programm FT2 v2.08 or v2.09 from Starbreeze. Its shareware $20
  They think about to make it public.
- some samples
- time


<How XM2YXM works>
The programm creates lots of files in the destination directory.
 - *.def	(used by MKVAB)
 - s_??.vag	(converted sample(s) out of the module)
 - *.vab	(done by MKVAB)
 - *.vh/*.vb	(done by SPLITVAB)
 - *.yxm	(Song header+patterns)

Before you convert a module, i suggest to check the destination directory,
if there are no other samples form previous convert.
Example: First you convert a module with 12 samples. The you convert
into the same directory a module with 7 samples. The *.vb file will
have 12 samples although the module had 7. This is because XM2YXM
uses s_*.vag as parameter for the AIFF2VAG command. The first 7 are ok
but the remaining are also taken. (i've said, its hostile)


<Usage of FT2>
 - Channels
There can be used up to 16 channels, but i wouldn't suggest
because the performance of the replayer routine is not good yet,
you wouldn't be able to do something else than to hear to the tune.

 - Instruments (samples)
This version supports up to 16 samples. (instruments)
This will change in future.
PinkPong loop mode is not supported.
Loops with LoopLength <= 28 /56bytes are not supported due to ADPCM format.
Always use 16bit samples, if you have 8bit samples than convert them with FT2
<Sample Edit> The request CONVERT SAMPLE should be checked with YES! 

<INSTRUMENT EDIT Menu>
The only things that are working are VOLUME, PANNING, FINETUNE.
I cannot implement the rest.

- Editing song
Don't use notes below E-1, because i didn't saw any other way to
convert the FT2 notes as to subtract the FT2 note - 15. Why 15???
I've tested it as long as - 15 sounded ok. (not very clever,but.)

The list below shows the supported Standard Effects and the Column Volume
Effects....

/* -------------------------------------------------------------------
** Startard Effects
** (+) - supported
** (-) - not supported
**
** 0  - Appregio			/(-)
** 1  - Porta up			/(-)
** 2  - Porta down			/(-)
** 3  - Tone porta			/(-)
** 4  - Vibrato				/(-)
** 5  - Tone porta+Volume Slide		/(-)
** 6  - Vibrato+Volume Slide		/(-)
** 7  - Tremolo				/(-)
** 8  - Set panning			/(-)
** 9  - Sample Offset			/(-)
** A  - Volume Slide			/(+) (not yet)
** B  - Position Jump			/(-)
** C  -	Set Volume			/(+)
** D  -	Pattern Break			/(+)
** E0 -	(reserved)			/(+) (not yet)
** E1 -	Fine porta up			/(-)
** E2 -	Fine porta down			/(-)
** E3 -	Set gliss control		/(-)
** E4 -	Set vibrato			/(-)
** E5 -	Set finetune			/(-)
** E6 -	Set loop begin/loop		/(+) (not working correctly)
** E7 -	Set tremolo control		/(-)
** E9 -	Retring note			/(-)
** EA -	Fine volume slide up		/(+) (not yet)
** EB -	Fine volume slide down		/(+) (not yet)
** EC -	Note cut			/(-)
** ED -	Note delay 			/(-)
** EE - Pattern delay			/(+) (not yet)
** EF - (reserved)			/(+) (not yet, thinking about using the PSX sfx)
** F  - Set Tempo			/(+) 1<=x<=31
** G  - Set Global Volume		/(+) (not yet)
** H  -	Global Volume Slide		/(+) (not yet)
** K  -	KeyOff (97)			/(+)
** L  -	Set envelope position		/(-)
** P  -	Panning Slide		  	/(-)
** R  - Multi Retrig Note		/(-)
** T  -	Tremor				/(-)
** X1 -	Extra fine prota up		/(-)
** X2 -	Extra fine porta down		/(-)
**
** 
** Volume Column Effects:
** (+) - supported
** (-) - not supproted
**
** $10-$50 - Set volume -$10		/(+)
** $60-$6F - Volume slide down		/(+) (not yet)
** $70-$7F - Volume slide up		/(+) (not yet)
** $80-$8F - Fine volume slide down	/(+) (not yet)
** $90-$9F - Fine volume slide up	/(+) (not yet)
** $A0-$AF - Set vibrato speed		/(-)
** $B0-$BF - Vibrato			/(-)
** $C0-$CF - Set panning		/(-)
** $D0-$DF - Panning slide left		/(-)
** $E0-$EF - Panning slide right	/(-)
** $F0-$FF - Tone porta			/(-)
**
*/