home *** CD-ROM | disk | FTP | other *** search
/ Prima Shareware 3 / DuCom_Prima-Shareware-3_cd1.bin / PROGRAMO / C / SOUNDPRO / README.DOC < prev    next >
Encoding:
Text File  |  1995-05-13  |  3.3 KB  |  79 lines
  1. ══════════════════════════ SoundPro Ver 1.00 ═══════════════════════════════
  2.                  By Marc Hughes
  3.  
  4. When I wanted to have some sound blaster routines, I looked over many many
  5. kits, I only foud 1 I liked, but that was way out of my price range.  So
  6. I decided to make this low cost simple to use set of functions.  I was
  7. inspired by the QBasic Play command.  so I created this over the course
  8. of a few months.  In this version there is no stereo, or double track
  9. capabilities.  If you register there is, giving you much much more power.
  10.  
  11. To Compile this simply compile your source and link it with library.obj.
  12. Its a generic name, but its easy to remember.  All the functions are listed
  13. below, and in an example program I have included.  I decided to distrubute
  14. this in OBJ format simply becaus it is more compatible with other compiliers.
  15.  
  16. This is a program that willl play simple music over the PC-Speaker, or your
  17. sound blaster.  It uses the clock-tick interupt, so it will run at the same
  18. speed on all machines. MAXBUFFER is the maximum size of the recorded buffer.
  19. The music repeats until told to stop, good for background music in games.
  20.  
  21. -=- void initsound(); -=-
  22. This function starts the interupts.  It must be called to play any sound.
  23. You may call any of the other functions, except stop(), they will work normally
  24. BUT no sound will be played. (SB_initsound does the same, except for Sound
  25.                   Blaster instead of pc speaker)
  26.  
  27. -=- void shutdown(); -=-
  28. This will shut down the player, and get rid of all the interupts.  Call
  29. this before you shut your program down.
  30.                  (SB_shutdown does the same, except for Sound
  31.                   Blaster instead of pc speaker)
  32.  
  33. -=- void stop(); -=-
  34. This function stops the music.
  35.  
  36. -=- void resume(); -=-
  37. This function restarts the music after a call to stop();
  38.  
  39. -=- void CLEAR(); -=-
  40. This clears out the music buffer.  To play additional music, you must call
  41. play() statement, and a resume() statement.
  42.  
  43. -=- void play(char buf[]); -=-
  44. The function play(*char) takes in a string of music, and appends it to the
  45. end of the current sequence.  Old music, already played is not deleted from
  46. the buffer.  Here are the commands for the string:
  47.  
  48.     * Stop playing (Usefull for end of song.)
  49.     Q Set next notes to Quater notes
  50.     W  "   "    "    "  Whole notes
  51.     H  "   "    "    "  Half notes
  52.     T  "   "    "    "  Eigth notes
  53.     +  Increases the note length by 1  Clock Ticks
  54.     -  Decreases "    "     "    "  1  Clock Ticks
  55.     {    "  "    "    "     "    "  10 Clock Ticks
  56.     }  Increases "    "     "    "  10 Clock Ticks
  57.     ?  Set current note length to   50 Clock Ticks
  58.       A-G  Plays the lettered note
  59.       a-g  Plays the lettered note up an octave
  60.       ' ' (Space) Plays a rest
  61.  
  62.  
  63. If you would like to use this in your own programs, please send $5.00 plus
  64. $1.37 (For shipping, handling, disk) to:
  65.  
  66.     Marc Hughes
  67.     5 Cooper St.
  68.     Auburn, MA 01501
  69.  
  70. For registering you also get, stereo sound, sound effects, file reaing, and
  71. full source code to do whatever you like with.  You MAY NOT use this shareware
  72. version in any of your own programs that you release.
  73.  
  74. DISCLAIMER:
  75.     I will not be held responsible for anything going wrong with your
  76.     computer, if you don't agree with this, delete this file imediately!!
  77.  
  78. ════════════════════════════════════════════════════════════════════════════
  79.