
		XM2AST v1.1

		Vaclav Kulakovsky DQLM

		25.11.1997

---------------------------------------------------------------
		THIS PROGRAM IS NOT BUGFREE.
I CANNOT BE HELD LIABLE FOR DAMAGE CAUSED BY THE USE OF XM2AST.
---------------------------------------------------------------

Hi Musicians

XM2AST is a module converter.
Converts XM music modules (FastTracker 2)
into AST music modules (All Sound Tracker modules).

Features
========
XM2AST converts notes,
		volume,
		patterns order,
		samples (sample BasePitch)
		effects  4,7,8,9,A,B,C,E9,ED,P

Options
========
-Ifile.xm	input file XM
-Ofile.ast	output file AST
-A		convert XM to AST
-AI		converts XM to AST and instruments numbers
-Tn             n is number to transpose all samples
		1 octave = 4096
-LU		log XM unconverted effects (meanwhile unknown)
-LO		log AST effects overwriten by instrument command
		(it's good choice to use -LO, because sometimes
		you can lose pattern break effect or speed set)
.....

Examples
========

a) PRINT ACTIONS
----------------
xm2ast -Isong.xm -S 
	prints only notes of xm in song order

xm2ast -Isong.xm -S >song.txt
	prints only notes of xm in song order to file song.txt

xm2ast -Isong.xm -SF 
	prints notes,volume,effect.. of xm in song order

xm2ast -Isong.xm -P
	prints patterns 

b) XM TO AST CONVERSION        
-----------------------
xm2ast -Isong.xm -Osong.ast -A

	converts song.xm to song.ast

xm2ast -Isong.xm -Osong.ast -AI

	converts song.xm to song.ast and converts instruments numbers too

xm2ast -Isong.xm -Osong.ast -A -T-4096

	converts song.xm to song.ast and transpose base pitch of all samples
	1 octave down

Known problems
==============
1.If the base pitch is set higher than 26672, some high notes can't be 
  played correctly, because of the pitch limitation of the AWE (176000 Hz).
  This notes will be played at 176000.
2.If there's more samples in XM instrument, numbers of instrumensts
  in AST will not be correct so you must set it manualy. Sorry.
3.If XM pattern > 128 it will trim to 128 (AST pattern max size) length

Thanks
======
Thanks to Patrice Bouchand a.k.a Cagliostro (author of AST tracker)
for his help.

Register
========
you'll enjoy me, if you send me your work (AST module)
....that's all


=====
if you have suggestions, or if you find bugs please write me or mail me


Vaclav KULAKOVSKY
Benesov 1289
256 01
CZECH REPUBLIC

e-mail: kulak@cdi.cz


-- HISTORY ---------------------------------------------------------------------
v1.1		25.11.1997	fixed some bugs
				added some new effects conversion
				added new options -LO -LU
