Short:        Converts AHX and HVL mods to WAV
Author:       Xeron/IRIS (pete@petergordon.org.uk), Morphos Port by Fabrizio Bartoloni
Uploader:     lanch tiscali it (Fabrizio "Lanch" Bartoloni)
Type:         mus/edit
Version:      1.0
Architecture: ppc-morphos

HVL2WAV 1.0
===========

By Xeron/IRIS
(pete@petergordon.org.uk)

Web: http://www.hivelytracker.com


hvl2wav converts hivelytracker modules to standard wave files to enable you
to listen to them wherever there is no hivelytracker replayer (and also
so you can edit or reencode them to something else).

The simplest way to use it is just:

hvl2wav filename.hvl

which will output "filename.wav" as a 44100hz stereo wav file.

You can also specify the following options:

 -ofilename
  
   This will output to 'filename' instead of just putting ".wav" at the
   end of the input filename.


 -tm:ss
 
   Timeout after m minutes and ss seconds. If you don't specify the -t
   option, hvl2wav will stop either when the song ends, or at 10:00,
   whichever comes first. Specifying "-t" disables the song end detection
   and sets the length of the output file. This is especially handy for
   AHX or HVL songs that loop; you can specify a time that will let them
   loop 2 or 3 times and then fade it out in a sample editor.
 
 -fn
 
   Sets the frequency to n Hz. By default it generates a 44100Hz file.
   With -f you can set it anywhere between 8000 and 48000hz.

 -sn

   Use subsong n. By default it just uses the main song (0). Not all
   hivelytracker or ahx files have subsongs.
   
 -a

   Calculates optimal gain before converting. This makes the output file as
   loud as possible without clipping, but it does it at the mixing stage,
   so its a lot better quality than if you loaded the output wav file and
   maximised it. A lot of HVL songs will already have the optimal gain value
   in the module (the composer can manually set it, or perform this same
   calculation before saving a hivelytracker module), but AHX songs don't
   have any concept of gain since they rely on paula to do the mixing, and
   so this is probably more useful when converting ahx files than hvl (although
   it does no harm to specify it always if you wish).

 -xn

   This specifies the stereo seperation for AHX files (it has no effect on
   HVL files since they override it with their own panning). n can be set
   to one of 5 values:
   
       0 = 0%   (Mono)
       1 = 25%
       2 = 50%
       3 = 75%
       4 = 100% (Paula)