home *** CD-ROM | disk | FTP | other *** search
/ AM/FM: Amiga Musicians' Freeware Magazine 11 / AM-FM 11.adf / utilities / bmp.doc.pp / bmp.doc
Encoding:
Text File  |  1992-11-07  |  5.3 KB  |  138 lines
  1.  
  2.                           Background Music Player 2.0
  3.                              Written By J.L. White
  4.                            (C)1989 Merlin's Software
  5.  
  6.                          Requires the latest Arp.library
  7.  
  8.  
  9.  
  10.  Background Music Player or BMP for short, plays digitized sampled sounds in
  11. the background of slideshows, animations, etc. It's perfect for playing some
  12. special sound you have in your startup-sequence or playing a disk full of
  13. sounds in some demo. I originally started working on this program in early
  14. 87 and there have been 5 versions out. I have not put out a new version in
  15. quite a while and thought I would play with it some more since I have gotten
  16. better at my programming skills. Since there were so many new changes, I 
  17. decided to release it as 2.0. Hope you enjoy BMP and thanks to all those
  18. who had sent in shareware donations. "You help keep us going!"
  19.  
  20.  BMP 2.0 combines all the features of the previous versions with many new
  21. ones. I decided to play around with the `ARP' routines to get use of the
  22. file requester. I use TXEd which uses it and have seen a show program called
  23. DAZ that does also. I am currently working on a collection of sampled sound
  24. files to add to our PD collection and thought it would be a nice addition to
  25. BMP. I also added a graph display of the file and a scroll bar to move along
  26. as the music plays. The bar is not 100% accurate but it's close enough. I
  27. also took a few notes from Richard Lee Stockton's code for SOUND. BMP uses 
  28. his way of loading the sound into FAST MEM instead of CHIP so you are not 
  29. limited to only 130K. Thanks Richard, for releasing such wonderful code!
  30.  
  31.  
  32. NOTE: You must have the Arp.library in your libs: directory for BMP to work.
  33.  
  34.  
  35. USAGE FROM WORKBENCH:
  36.  
  37.  Included are two icons. One for BMP itself and one for a sound file. If you
  38. click on the BMP icon itself the program loads up and opens the `ARP' file
  39. requester for the SoundFile you want to play. Once you click on the file, it
  40. loads it, makes the graph, then plays the music. It will keep repeating in a
  41. loop until you hit the close gadget or hit a key. When you do it brings up 
  42. the requester again for another filename. Click CANCEL when you are ready to
  43. quit.
  44.  
  45.  The icon for the soundfile has a few options that can be added into the
  46. tool_types. There are four options:
  47.  
  48. 1. LOOPS=+1 
  49.    This allows you to choose how many times to play the file. If you wish
  50.    to have it play continuously until the gadget is hit, enter a +0. The +
  51.    must be there to set it correctly.
  52.  
  53. 2. GRAPHCOLOR=@1  
  54.    This tells BMP what color to paint the graph. You can choose 0-3. These
  55.    are the colors set on your Workbench screen. If you are running one of the
  56.    programs that allow you to use more than the basic 4 colors , you can use 
  57.    any valid number available. The @ must be there to set it correctly.
  58.  
  59. 3. BACKCOLOR=#2
  60.    This tells BMP what color to paint the background. You can choose 0-3. 
  61.    These are the colors set on your Workbench screen. If you are running one 
  62.    of the programs that allow you to use more than the basic 4 colors , you 
  63.    can use any valid number available. As above, the # must be there to set
  64.    it correctly.
  65.  
  66. 4. GRAPHON=YES
  67.    This tells BMP to open the full graph instead of just a title window. The
  68.    default is YES but if you don't need (or want) to display the graph then
  69.    set it to NO. If you do, this voids out options 2 & 3.
  70.  
  71.  
  72. If none are entered then BMP uses its defaults which are:
  73. LOOPS=+1
  74. GRAPHCOLOR=@1
  75. BACKCOLOR=#2
  76. GRRAPHON=YES
  77.  
  78.  
  79. USAGE FROM CLI:
  80.  
  81.  The options are pretty much the same as for workbench but you enter them on
  82. the command line. If you type BMP by itself the requester is brought up and
  83. used as above. You can enter as many filenames as you wish on the command
  84. line (or 255 characters worth). The -Quiet option is also included in CLI.
  85. The default for Workbench is to open the full graph but from CLI the default
  86. is to open just a title window that display the filename and filesize.
  87.  
  88.  
  89.  The usage is: BMP -Quiet *GraphOn #BackColor @GraphColor +Loops Filename ...
  90.  
  91.  -Quiet opens no window or graph. You only have to enter the `-'.
  92.  *GraphOn opens a full graph window. You only have to enter the `*'.
  93.  #BackColor tells what color to use for Background (0,1,2,3).
  94.  @GraphColor tells what color to use for Graph (0,1,2,3).
  95.  +Loops tells how many times to play the SoundFile.
  96.  Filename is the name of the file you wish to play.
  97.  
  98.  Here Is An Example:
  99.  BMP * #3 @1 +3 SoundFile1 +1 SoundFile2 #2 @0 +0 SoundFile3
  100.  
  101.  This would play the 1st sound 3 times using White on Orange, The 2nd sound
  102.  1 time using White on Orange, & the 3rd forever using Blue on Black.
  103.  
  104.  Here Is Another Example:
  105.  BMP +1 SoundFile1 SoundFile2
  106.  
  107.  This would play SoundFile1 once then SoundFile2 once with a title window.
  108.  
  109.  Here Is Another Example:
  110.  BMP -Q +1 SoundFile1
  111.  
  112.  This would play SoundFile1 one time without opening a window. This way is
  113.  perfect to add in your startup-sequence.
  114.  
  115.  
  116.     _ , Chat At Ya Later...
  117.    {~} 
  118.   ( V-)
  119.   "|Y|"
  120.   _|||_---> J.L. White
  121.  
  122.  
  123. This is released as Sharware but can be given out freely to anyone that has
  124. a use for it. If you like it and use it, send a donation of $10.00 to the
  125. address below and get whatever the latest version is with a free disk full
  126. of samples you can use.
  127.  
  128. Read M-List for all our available disk.
  129.  
  130. Send donations to:
  131.  
  132. J.L. White
  133. 1304 Four Seasons Blvd.
  134. Tampa,Fla. 33613
  135. (813) 971-4451
  136.  
  137.  
  138.