home *** CD-ROM | disk | FTP | other *** search
/ Millennium Time Capsule / AC2000.BIN / disks / hbasic_1 / moderful / modplay.txt < prev    next >
Encoding:
Text File  |  1997-08-05  |  3.5 KB  |  88 lines
  1.  
  2.                      Paul Jones and PJCO present...
  3.                          __          ___                         
  4.      /'\_/`\            /\ \        /\_ \                        
  5.     /\      \    ___    \_\ \  _____\//\ \      __     __  __    
  6.     \ \ \__\ \  / __`\  /'_` \/\ '__`\\ \ \   /'__`\  /\ \/\ \   
  7.      \ \ \_/\ \/\ \L\ \/\ \L\ \ \ \L\ \\_\ \_/\ \L\.\_\ \ \_\ \  
  8.       \ \_\\ \_\ \____/\ \___,_\ \ ,__//\____\ \__/.\_\\/`____ \ 
  9.        \/_/ \/_/\/___/  \/__,_ /\ \ \/ \/____/\/__/\/_/ `/___/> \
  10.                                  \ \_\                     /\___/ v1
  11.                                   \/_/                     \/__/ 
  12.  
  13.                   A DSP MOD player for HiSoft BASIC
  14.                   
  15. Disclaimer
  16. ---------------------------------------------------------------------------
  17.  
  18. PJCO, Paul Jones or Atari Compuing can not be responsible for any 
  19. damage caused to your computer, when using MODPLAY.
  20.  
  21. What is it?
  22. ---------------------------------------------------------------------------
  23.  
  24. MODPLAY is a DSP560001 library which lets you play .MOD files with 
  25. HiSoft BASIC. It runs under interupt (in other words you call it and 
  26. you don't need to check on it again) and speed tests show it only uses 
  27. 12% processor time.
  28.  
  29. Installation
  30. --------------------------------------------------------------------------
  31.  
  32. 1) First you need to update your libraries. To do this find your LIB 
  33.    folder (which contains your library .BIN files), copy BAS_MOD.BIN 
  34.    there and double click on BUILDLIB.TTP. For parameters, enter 
  35.    "BAS_MOD -q" and press [return]. The program will now make a file 
  36.    called HBASIC.LIB.
  37.    
  38. 2) Copy the new HBASIC.LIB file to the same directory as your HBASIC 
  39.    editor.
  40.  
  41. Usage 
  42. ---------------------------------------------------------------------------
  43.  
  44. The name of the library is MODPLAY, and it is used in the same way as 
  45. the GEMAES, GEMVDI, XBIOS etc libraries.
  46.  
  47. To use the MODPLAY library in your program, add this line at the start 
  48. of you code:
  49.  
  50.    LIBRARY "MODPLAY" 
  51.  
  52. Four commands are provided to support the playing of MODS this: 
  53.  
  54.   InitMod dummy%() 
  55.      InitMod initialises the modplay engine. 
  56.      This routine should be called with a dummy integer 
  57.      array parameter (any old integer array, it's not actually used). 
  58.  
  59.   PlayMod modfile&
  60.      PlayMod actually starts a mod playing as a background task. 
  61.      Usage: 
  62.     a&=lof(1)
  63.     x&=malloc&(a&)
  64.     bload "FILE.MOD",x&
  65.     playmod x&
  66.      
  67.   StopMod modfile&
  68.      StopMod will stop the currently playing MOD - you MUST always 
  69.      call this to stop a MOD from playing before exiting a program or 
  70.      before starting another modfile playing.
  71.  
  72.   GetModName modfile&,name$ 
  73.      GetModName will return the title of the modfile (NOT the filename, 
  74.      the actual mod title) in the string variable NAME$ 
  75.  
  76. The accompanying demo program PJCOMOD.BAS illustrates the use of the 
  77. modplayer routines. It produces a simple .ttp program which will play 
  78. any MOD which is passed to it as a parameter - there's one limit to 
  79. the size of the file of the MOD file - how much memory you have! :-). 
  80.  
  81. Legal
  82. ---------------------------------------------------------------------------
  83.  
  84. MODPLAY is freeware, which means that no money should be payed for 
  85. using this software. I suggest you mention that any programs you 
  86. create which use MODPLAY should say they used it. MODPLAY is based on 
  87. the work by Craig Graham. Thank you Graig for letting me distribute 
  88. this.