home *** CD-ROM | disk | FTP | other *** search
/ Brotikasten / BROTCD01.iso / exoten / fstr.txt < prev    next >
Text File  |  1994-09-07  |  10KB  |  203 lines
  1. FAC Soundtracker Replayer for PC compatibles.
  2.  
  3. Overview:
  4.       This is a program that  lets you hear FAC SoundTracker  MUS files on any
  5. PC compatible with an AD-LIB or 100% compatible sound card.
  6.  
  7. System Requirements:
  8.  
  9.       - 286 or higher processor
  10.       - VGA card
  11.       - AD-LIB or 100% compatible sound card.
  12.       - 95 kb of free memory.
  13.  
  14. How I use it?
  15.       The management  of this program is quite easy. No command parameters. No
  16. complicated menues etc.
  17.       To start it you must type FSTR at the command prompt and then a graphics
  18. display will be shown at front of you.
  19.       The screen looks like this
  20.  
  21.               |---------------------------------------|
  22.               |---------------------------------------|
  23.  
  24.                |----|          |-----|         |-----|
  25.                | A  |          |  B  |         |  C  |
  26.                |----|          |-----|         |-----|
  27.  
  28.                |---|  |-----------------------|  |---|
  29.                | D |  |                       |  | F |
  30.                |---|  |           E           |  |---|
  31.                       |                       |
  32.                |---|  |                       |  |---|
  33.                | G |  |                       |  | H |
  34.                |---|  |-----------------------|  |---|
  35.  
  36.       Here you got some icons that represent  the actions that you can do. All
  37. you have  to do is place  the cursor  above  any of them  and press the  mouse
  38. button or the space bar if you are using the keyboard.
  39.       Now, here's the explanation of what they mean.
  40.  
  41. A.  Audio.
  42.       With this icon  you can turn all  the melody channels  on or off and let
  43. only the drums channels sound.
  44.  
  45. B.  File Access
  46.       Pointing here will display a File selection box from where you can search
  47. and load any song (*.mus), or select a song list.
  48.       When you choose a song, its name will be highlighted (note that the list
  49. contains the song name  and not the file  name). Also you can select more than
  50. one song and they will be played continuously.
  51.  
  52. C.  Drums
  53.       From this  you can select  9 melody  channels or 6 melody channels and 5
  54. channels  for drums (they  are really 3 pairs  of modulators, but  we can play
  55. 5 different sound at the same time).
  56.       This  button hasn't the same effect that turning the channels 7 to 9 off
  57. because  there are music  that uses 9  melody channels + 1 drum channel, so if
  58. you turn drums off you will hear all 9 channels playing the melody.
  59.  
  60. D.  Shell
  61.       This is the interesting part, and the one who cause me a lot of pain and
  62. suffering.
  63.       When I start  this proyect I thought in  a little program  to play *.MUS
  64. files,  but as  the time pass  I realize that  watching a screen  that doesn't
  65. change in a long period of time is very boring. So what about placing the music
  66. on  the background while using a text editor, or other process that requires a
  67. few of the system power. And yeah... the word 'shell' appear on my eyes.
  68.       The problem was that  the musics are  very short  (at least the musics I
  69. used developing this program), and  it isn't very  comfortable exiting from an
  70. aplication only to change the song. The solution was the file list.
  71.       Now the problem was that it  isn't convenient to  load all the  songs of
  72. the list in memory, why don't load only the song that I want to play. But there
  73. will be a conflict if  the disk is currently accesed! :-(. Finally after  many 
  74. hours of hard debugging I get this idea working hapily :-)
  75.  
  76. E.  Peak Meter
  77.       From this section you can turn any of the nine channels on or off.
  78.  
  79. F.  Quit
  80.       Push here when you want to return to the silent world.
  81.  
  82. G.  Song List Position.
  83.       If you want to hear  the last song again or send to hell the actual song
  84. you can use this.
  85.  
  86. H.  Song Pattern Position.
  87.       Using this you can advance or go back within a song. 
  88.       
  89.      Finally I want to warning you that YOU ARE USING THIS PROGRAM AT YOUR OWN
  90. RISK, IF YOUR COMPUTER SYSTEM OR YOUR EARS GET DAMAGED FOR ANY REASON, I'M NOT
  91. RESPONSABLE. THIS IS A BETA VERSION.
  92.  
  93. -----------------------------------------------------------------------------
  94. Read this section if you are a coder, musician or a simple curious guy.
  95.  
  96. History.
  97.  
  98.      I began this proyect when I saw that exist  many *.MUS files with amazing
  99. names and  because I love music, then  I don't hesitate about  writing a *.MUS
  100. player for my computer (PC).
  101.      This was necesary beacause here on Chile there are few MSX machines,three
  102. of my friends have  one and only  with PSG chips. So,  experimenting with some
  103. MUS files in TP I found a  relationship between them,  and 3 days later, I got
  104. the replaying routine working but  without the drum  channels, because this is
  105. the first  time  I did a program  that uses my sound  card. The next  step was
  106. imagine how  did the drum part of the file works, and how to program the drums
  107. on the sound card.
  108.      The first part  takes me about 1 day  to determine  which sounds mean the
  109. codes in the file, but learning  to program  the drums and  obtaining a decent
  110. sound took me a bigger time.
  111.      One week after I  finished the replaying  part which runned  with a black
  112. screen and it was computer speed dependant.
  113.     I hadn't all my time free, because I have to study too. A period of finals
  114. exams at Univerity came and the proyect was delayed. When this  period end, it
  115. took me a  lot of time  to return  to code because  I was working in, at first
  116. look, small programs that stealed me a lot of time.
  117.      When I get back on FSTR I pass for many problems because I wanted a small
  118. program (<10 kb long) made 100% in Assembly language. You can ask why not in C 
  119. or TP,my answer is that C requires about 15Mb of disk space and it doesn't fit
  120. on my HD, in  the other hand TP is  a nice language but  the compiled programs
  121. include info that make the program grow. Also I choose assembler because it is
  122. the only language that I know what does exactly happen with my code.
  123.      It took me many hours learning how to do many things that I was used to do
  124. with high level languages. One day I worked many hours and the coding was very
  125. successful, the program was running with many of the facts I want to. Then,
  126. when  I gone  to bed I made  a back up of all the work,  but instead of moving
  127. the files  from  the working  to the back up  directory, I did it from the old
  128. files overwriting the new files, so  all the work was lost and with that files
  129. I lost my patience and my brain :-(
  130.      With that accident on my back, I got up again and re-coded all the program
  131. again but new stranges bug's appear. And finally,  2 months later I killed the
  132. last bug (I think) and the program is ready for your use.
  133.  
  134. Observations.
  135.  
  136.      - MUS  file  format was  created by FAC  on the  MSX systems. I 've never
  137.        heared a MUS song on a MSX computer, the replaying routine was developed
  138.        testing and hearing what happened. I wrote an article on the MSX mailing
  139.        list  (msx@stack.urc.tue.nl) if  somebody could help  me  with  the  MUS 
  140.        format, but nobody respond  me. If you think  that you can  help me with 
  141.        it, I will be very grateful and I promise that I will do the corrections 
  142.        on the next version. See at the end of this TXT for contacting me.
  143.      - This program was made for my own use, but I believe in Public Domain so
  144.        we all can enjoy the creations  of each others. I  code because I  love
  145.        coding (and girls of course), f*ck you business only coders.
  146.      - For now I can't play musics beacause I sold my sound card, I think that
  147.        the next version  could have 9 melody channels and 1 drum channel using
  148.        a Sound Blaster DAC for the drums, also if you help me I can improve the  
  149.        replaying routine to support effects (I still don't know what does some 
  150.        of the codes mean).
  151.      - The system requirements  says 95 Kb, but if you start using buttons the
  152.        program needs more memory.
  153.      - As you can see, using shell will reserve about 13 kb for code 16 kb for
  154.        song and 6 kb for file list #|->.