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
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                17162   35968  47.7% -lh5- 3397 Apr  6 00:46 hvl2wav/hvl2wav
[generic]                 1241    2467  50.3% -lh5- 6e28 Apr  6 00:49 hvl2wav/hvl2wav-mos.readme
[generic]                 2033    6491  31.3% -lh5- b215 Feb 13 08:17 hvl2wav/src/hvl2wav.c
[generic]                  318     684  46.5% -lh5- e3de Mar 12 06:59 hvl2wav/src/makefile
[generic]                12082   61060  19.8% -lh5- d8c7 Feb 13 08:16 hvl2wav/src/replay.c
[generic]                 1459    7210  20.2% -lh5- da70 Feb 13 08:16 hvl2wav/src/replay.h
[generic]                  290     576  50.3% -lh5- 755d Feb 13 08:16 hvl2wav/src/types.h
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         7 files   34585  114456  30.2%            Apr  6 08:18