AWEPlay 0.400 by Thor

		    The best module player for the AWE32!

   I wrote this program for enjoying the awesome sound, which CAN be produced
   with the AWE32. I hate the "war" between GUS and AWE32 users.  We'd rather
   develop music/players for both card. I just love good music,  and AWE32 is
   a really  good sounding  SB card!  I spended two hard months  figuring out
   how to aviod the MIDI drivers and AWEDIP too :), but it worths, I think...

Features:
	+loads and plays
	 + FastTracker II's XM modules ($0104 only)
	 + Protracker's and FT II's MOD modules (31 instruments)
	+up to 30 channels, max 256 rows, max 256 patterns, max 128 instruments
	+all Protracker's effects implemented
	+almost all FastTracker II's effects implemented
	+8 or 16 bit samples, size limited by RAM on AWE32
	+force upload (if not enough RAM on AWE32, less samples, but playing)
	+amiga or linear frequency tables
	+MOD, XM or S3M panning (separating channels)
	+sample smoothing (for avoiding clicks ... almost)
	+speedy patch upload
	+interactive reverb/chorus set
	+graphics screen

Requirements:
	!386 or better (some 386 can hang from PMW 1.16, my old 386 too)
	!AWE32, SB port on 0x220, EMU on 0x620, MPU401 on 0x330
	=recommended min. 2MB DRAM on AWE32
	!1MB XMS/EMS, recommended 4MB

Currently supported effects:
     general:
	+instrument volume
	+instrument finetune
	+instrument relative tone
	+instrument panning
	+instruments with multisamples
	+instrument volume envelope
	+instrument volume fadeout
	+instrument pan envelope
	+key off
	+8/16 bit samples
	+amiga or linear frequency tables
	=sample loop (bidirectional -> forward)

     in volume column:
	+volume set
	+volume slide up/down
	+fine volume slide up/down
	+vibrato speed
	+vibrato
	+panning set
	+panning slide left/right
	+tone porta

     in effects column:
	+0xx arpeggio
	+1xx portamento up
	+2xx portamento down
	+3xx tone portamento
	+4xx vibrato
	+5xx tone portamento and volume slide
	+6xx vibrato and volume slide
	+7xx tremolo
	+8xx pan
	+9xx sample offset
	+Axx volume slide
	+Bxx position jump
	+Cxx volume set
	+Dxx pattern break
	+Fxx tempo/BPM
	+Gxx global volume set
	+Hxx global volume slide
	+Kxx key off
	+Lxx set envelope position
	+Pxx panning slide
	+X1x extra fine portamento up
	+X2x extra fine portamento down

	+E0x filter on/off
	+E1x fine portamento up
	+E2x fine portamento down
	+E3x set glissando
	+E4x set vibrato control
	+E5x set fine tune
	+E6x jump loop
	+E7x set tremolo control
	+E9x retrig note
	+EAx fine volume slide up
	+EBx fine volume slide down
	+ECx note cut
	+EDx note delay
	+EEx pattern delay

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!							    !!!!!!!!!!!
!!!!!!!!!!!Does anyone knows, what EFx (funk it! or funk repeat) is?!!!!!!!!!!!
!!!!!!!!!!!	   I don't believe, that no one knows it!	    !!!!!!!!!!!
!!!!!!!!!!!		    Let me know, please!		    !!!!!!!!!!!
!!!!!!!!!!!							    !!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

Lacks:	- no instrument vibrato, sweep yet
	  (will be pitch envelope and many more)

Command line switches:
	-p is for disable XM panning, also separating channels like in ST3, and
	   disables default pan position of instruments (sets to channels's pan)
	   For MOD files, panning is automatically set to its values.
	-e is for disable sample smoothing. Sample smoothing almost avoids
	  some specific clicks during playing, but I think (experimental)
	  that bad loop values makes clicks when the sample is looping, and
	  if the sample is silly. (i.e. starting and ending value makes
	  big difference from 0, so a high frequency transient follows...)

Keyboard: (ooh, yeah :)
	[ ]  :	Reverb down, up
	; '  :	Chorus down, up
	ESC  :	Exit

Known bugs:
	- Not bug, but...the program takes a lot of memory (~38K each pattern).
	  If you run out of memory it will print, but not terminate ;(
	- If relativ note makes the final note>101 then it may
	  go down in the sub-frequence (0.01-10Hz).

Notes:
	- Clicks. Some samples make clicks.
	  Cause: Old mods, bad sampled instruments, bad looping points etc.

In the Future:

  Version 0.5 will be the ~FULL~ XM, MOD, (C)AM player.
    - *.am will be an AWE module format for AWE32's capabilities.
    - *.cam will be a compiled am module, which will be playable with AWELib.
    (hardware envelopes, LFOs, reverb, chorus, cut-off filter/slide,
     filter resonance, ROM samples, pitch and cut-off envelope)

  This player has RENAMED to AWEPlay, because
  the version > v0.500 started to develop (editor)!
  AWEPlay will be 0.5, when .am and .cam structure is fixed. So it will
  play them too.

  ( Final :) version AWETrack I will be a TRACKER/PLAYER.

  I'll implement external MIDI keyboard handling, something like in FT2,
  and maybe .mid format, SBK files, sampling, and many more.

Note:
  For those who doesn't know:) *.s3m modules can be converted with FT2 to *.xm!
  AWEPlay doesn't and won't load any s3m files.

So, enjoy the sound of AWE32!

Special thanks to:

	Creative Labs, E-mu,
		For making SoundBlaster AWE32, this brilliant soundcard!
		But not everyone is interested writing only MIDI drivers...

	Judge Dredd, Infiniti 2001,
		Your AweMod gave me the inspiration to develop AWEPlay.

	Mr. H, Triton,
		FastTracker II is the best tracker I think.
		Without FT2 I couldn't test effect so easy.

	Tran, Darevill,
		For your PMW.

	My testers,
		For your helps.

	and Composers of
		chariot.s3m (and of course Vangelis),
		beyond.mod,
		inside.s3m,
		axlfoley.s3m,
		strshine.s3m,
		resonanc.mod
		...
		  for the songs I've tested AWEPlay with.

Please send your comment on AWEPlay to
  juhasza@ludens.elte.hu

Comments like:
 1.)  AWEPlay is I was waiting for!
 2.)  ...

Sorry for my broken english...

1995.III.23       Thor