home *** CD-ROM | disk | FTP | other *** search
/ Large Pack of OldSkool DOS MOD Trackers / ht12_m68k.lha / HivelyTracker / Replayer / src / README.TXT < prev   
Encoding:
Text File  |  2006-12-08  |  1.4 KB  |  56 lines
  1.  
  2. This replayer was basically ripped out of HivelyTracker and bodged into a
  3. standalone replayer. Its not necessarily optimal, i haven't had a chance
  4. to comment anything, and it will only compile under OS4 at the moment.
  5.  
  6. If anyone makes a more portable replayer, or makes a 68k asm replayer, please
  7. send them to me so I can include them in future versions (with credit of
  8. course ;-).
  9.  
  10. There are no documents for the HVL module format, I just knocked it together
  11. as I wrote hivelytracker. This replayer is the documentation.
  12.  
  13.  
  14. Functions:
  15.  
  16. void hvl_InitReplayer( void )
  17.  
  18.   This calculates all waves and stuff. Call it before any other replayer
  19.   funcs.
  20.  
  21.  
  22. struct hvl_tune *hvl_LoadTune( TEXT *name, uint32 freq, uint32 defstereo )
  23.  
  24.   Specify the filename and mixing frequency, and it will load the tune into
  25.   RAM, and return a handle. W00t!
  26.   
  27.   defstereo is the stereo seperation for playing AHX tunes (HVL tunes override
  28.   this setting and ignore it). It can be:
  29.   
  30.   0 = 0%  (mono)
  31.   1 = 25%
  32.   2 = 50%
  33.   3 = 75%
  34.   4 = 100% (paula)
  35.  
  36.  
  37. void hvl_FreeTune( struct hvl_tune *ht )
  38.  
  39.   Frees the tune again.
  40.  
  41.  
  42. BOOL hvl_InitSubsong( struct hvl_tune *ht, uint32 subsong )
  43.  
  44.   Initialises a subsong ready for playing
  45.  
  46.  
  47. void hvl_DecodeFrame( struct hvl_tune *ht, int8 *buf1, int8 *buf2, int32 bufmod )
  48.  
  49.   Decodes a frame of HVL music. Works the same as the ahx replayer library
  50.   on OS4Depot.
  51.  
  52.  
  53.  
  54. Enjoy.
  55. Peter Gordon (pete@petergordon.org.uk)
  56.