home *** CD-ROM | disk | FTP | other *** search
/ Best Objectech Shareware Selections / UNTITLED.iso / boss / musi / misc / 028 / hsctrack.doc < prev    next >
Encoding:
Text File  |  1993-05-10  |  6.0 KB  |  174 lines
  1.  
  2.                        HSC-Tracker V1.0
  3.  
  4.               (C)1993 by Zwerg Zwack and Chicken
  5.      Adlib-Routines and Tunes originaly by Hannes Seifert
  6.  Home of HSC-Tracker: The Lycaeum ++41 41-762-989 (v32b,24h)
  7.  
  8.                       Registered to you!
  9.  
  10.  
  11.      --------------------------------------------------
  12.  
  13.  
  14. WHAT IS HSC-TRACKER GOOD FOR ?
  15.  
  16. Once, we looked for an fm-editor able to do a bit more than
  17. this ugly CMF shit. But there was nothing, really nothing!
  18. So Chicken took the next adlib-player and disassembled it.
  19. (bad luck for Hannes Seifert, that it was his player, sorry)
  20. After playing around and doing some speed-ups, he persuaded
  21. Zwerg Zwack to do an editor for it (it's useful to have some
  22. code slaves harhar).
  23.  
  24. Ladies and Gentlemen, here it is: The HSC-Tracker Package.
  25. It comes completely with an editor, a tsr-player and last
  26. but not least, an object-file to include in your own codes!
  27.      
  28.  
  29.      --------------------------------------------------
  30.  
  31.  
  32. THE HSC-TRACKER :
  33.  
  34. Huh? what to say? Just start HSCTRACK.EXE an press F1 to get
  35. the help-screen. It is self-explaining (we hope so!).
  36.  
  37. Take look at the examples to learn how to get the best (?)
  38. results out of the adlib.
  39.  
  40. Ah, btw, something 'bout the settings when starting the tune.
  41. The player always starts with speed two and the first nine
  42. instruments loaded into corespondending channels.
  43.  
  44.  
  45.      --------------------------------------------------
  46.  
  47.  
  48. THE HSC-PLAYER :
  49.  
  50. Just a little silly player running in background. Start it
  51. with the filename (with extension) as parameter. To Stop the
  52. music, execute it again.
  53. Disclaimer: Chicken refuses any responsibility for damages
  54. to your system during serious crashes.
  55.  
  56.  
  57.      --------------------------------------------------
  58.  
  59.  
  60. THE HSC-OBJECT :
  61.  
  62. This object gives you the possibility, to include adlib-music
  63. in your own codes. Link the HSCOBJ together with your source
  64. and declare the HscPlayer and the globals as EXTRN. The object
  65. is written on TASM 3.1, if some problems appear, try to link
  66. with Borland's TLINK.
  67.  
  68. All routines are called through the funktion HscPlayer. You
  69. have to call it as FAR. In AH is the number of the function
  70. called.
  71.  
  72. ah = 0  start music             call this routine when you
  73.                                 start a new tune.
  74.  
  75.         bl      play mode       when 0 the music will play in
  76.                                 background, using the timer
  77.                                 interrupt.
  78.                                 1 is polling-mode. this means
  79.                                 mean, that the irq will only
  80.                                 manage the correct speed, but
  81.                                 the main playing is done when
  82.                                 you call function 1 (poll).
  83.  
  84.         if you use the timer-irq (08h or 1Ch) for own purposes,
  85.         check out, that INT 1Ch is called 18 times per second.
  86.  
  87.         bh      dos irq         0 will include the old int 1Ch
  88.                                 (probably used by another pro-
  89.                                 gram) into the playing irq.
  90.                                 1 will cut it off.
  91.  
  92.         es:si   music data      points to the music data loaded
  93.                                 into memory.
  94.  
  95.  
  96. ah = 1  poll music              when in polling mode, you have
  97.                                 to call this function at least
  98.                                 18 times per second. it will
  99.                                 play the music.
  100.  
  101. ah = 2  stop music              stops music.
  102.  
  103. ah = 3  fade out                fades out the music.
  104.  
  105. ah = 4  detect/reset            searches for an adlib or
  106.                                 compatible soundcard. returns
  107.                                 with carry set when an error
  108.                                 occurs, otherwise ax contains
  109.                                 the port found. this has to
  110.                                 be started one time to reset
  111.                                 the soundcard.
  112.  
  113. ah = 5  rasterbar               will turn on/off a rasterbar
  114.                                 to show the time used by the
  115.                                 player. works not in polling
  116.                                 mode.
  117.  
  118. ah = 6  user irq                you can link in an user-irq,
  119.                                 which gets called every time
  120.                                 the play-routine is executed.
  121.                                 (e.g. equalizers)
  122.  
  123.         bl = 0                  remove user irq
  124.  
  125.         bl = 1                  link irq to ds:dx.
  126.                                 the user irq has to end with
  127.                                 a retf.
  128.  
  129. Beside this, you have access to different global variables,
  130. useful for doodads like equalizers.
  131.  
  132.         hsc_note        9 bytes actual notes
  133.         hsc_instr       9 bytes actual instruments
  134.         hsc_equalizer   9 bytes equalizer (ffh-0fh)
  135.         hsc_playing     9 bytes equalizer peaks (ffh = peak)
  136.  
  137.         hsc_pattern     1 byte  actual pattern
  138.         hsc_track       1 byte  actual track
  139.         hsc_position    1 byte  actual position
  140.  
  141. Hope this is clear enough, else contact the authors or just
  142. return to your joystick and give up coding. :)
  143.  
  144.  
  145.      --------------------------------------------------
  146.  
  147.  
  148. REVISION HISTORY ...
  149.  
  150. April'93 First beta, or was it even pre-alpha ?
  151. 10.05.93 Release of version 1.0
  152.  
  153.  
  154.      --------------------------------------------------
  155.  
  156.  
  157. CONTACT THE AUTHORS !
  158.  
  159. If you got an idea for some features, dig it :).
  160. But for chitchat, little donations (dreamin'?), your coolest
  161. tunes done with HSC-Tracker,
  162.  
  163. write to:       Christian Kündig        Adrian Studer
  164.                 Lindenhofrain 12        Hauptstrasse 52
  165.              CH-8708 Männedorf       CH-6170 Schüpfheim
  166.                 Switzerland             Switzerland
  167.  
  168. or call The Lycaeum ++41 41-762-989 and write a message,
  169. or email via InterNet chicken@ezinfo.vmsmail.ethz.ch
  170.  
  171.  
  172.      --------------------------------------------------
  173.                    sorry for bad english!
  174.