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)
       
       
       

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
-rw-r--r--  1001/1001    21800   45935  47.5% -lh7- e396 Jun  5 06:17 hvl2wav
-rw-r--r--  1001/1001     1234    2463  50.1% -lh7- 9910 Jun  5 06:17 hvl2wav-i386-aros.readme
drwxr-xr-x  1001/1001        0       0 ****** -lhd- 0000 Jun  5 07:22 src/
-rw-r--r--  1001/1001     2028    6490  31.2% -lh7- 8818 Jun  5 06:17 src/hvl2wav.c
-rw-r--r--  1001/1001      325     722  45.0% -lh7- 6966 Jun  5 06:17 src/makefile
-rw-r--r--  1001/1001    11372   61060  18.6% -lh7- d8c7 Jun  5 06:17 src/replay.c
-rw-r--r--  1001/1001     1459    7210  20.2% -lh7- da70 Jun  5 06:17 src/replay.h
-rw-r--r--  1001/1001      290     576  50.3% -lh7- 755d Jun  5 06:17 src/types.h
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         8 files   38508  124456  30.9%            Jun  5 07:53