home *** CD-ROM | disk | FTP | other *** search
/ Sound Sensations! / sound_sensations.iso / jukebox / muplyr21 / mp21.doc < prev    next >
Text File  |  1991-01-16  |  12KB  |  440 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                                 
  16.                                                             
  17.                                                                                                  
  18.                                                                         
  19.                                                        
  20.                                          (tm)  
  21.                                      MUSIC PLAYER 2.1  
  22.                                                          
  23.                                           The acclaimed music  
  24.                                      playing software     
  25.                                             
  26.                                 (C)opyright 1990,1991  
  27.                                          C&K Software Technologies  
  28.                                   and Pacific Rim Development      
  29.                                                   
  30.                                             
  31.                                             
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                              FEATURES OF MP21
  67.  
  68.  
  69. Music Player 2.1's main features are: The ability to play MP12 and MP20
  70. files, a brand new title screen, the menu from MP20, and repeated
  71. menu use.
  72.  
  73.  
  74.  
  75.                                                                                                             
  76.                                      MUSIC PLAYER 2.1  
  77.                                     TABLE OF CONTENTS    
  78.                                                                          
  79.  
  80.  
  81. Features and Table of Contents ...................................... 1
  82.  
  83. Welcome! ............................................................ 2
  84.  
  85. Printing the Manual ................................................. 2
  86.  
  87. Installation (INSTALL.BAT, \CK\MP21\, true blue IBM's) .............. 2
  88.  
  89. Title (Problems with Hercules Mono) ................................. 3
  90.  
  91. Menu (Choices, Exiting/ESC) ......................................... 3
  92.  
  93. Making Music (Format, Commands, Sample, ASCII WP, DOS way) .......... 3
  94.  
  95. Bugs (RIFFRAFF.MUS, tempo, Hercules Title Screen) ................... 4
  96.  
  97. Revision History (1.0 to 2.0, Angry Sysops, 2.1) .................... 4
  98.  
  99. Share (Shareware, Address, Order Form, GST Free) .................... 4
  100.  
  101. Other Titles (MP12, MP20, Kids' Maze, Copycat, where to
  102.          find them, Nanaimo BBSes, Express BBS) ................. 5
  103.  
  104. Legal Stuff ......................................................... 5
  105.  
  106. Copyright Information (Don't change files) .......................... 5
  107.  
  108. Goodbye ............................................................. 5
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.                       - 1 -        
  122.  
  123.                                                                             
  124.  
  125.  
  126.                               WELCOME TO MP21        
  127.                                                                             
  128.  
  129.     Hi! I'm Kevin Matz, I'm 11 years old right now, and I wrote
  130. Music Player 2.1.  Music Player 2.1 (MP21 or Musplayr for short) is a
  131. simple, but advanced, software package that lets you play songs, tunes,
  132. and melodies easily.  You can even enter your own music, using just an
  133. ASCII-output word processor.  Just continue reading to find out how to
  134. use, and enjoy, Music Player 2.1!
  135.  
  136.  
  137.  
  138.  
  139.                                                                             
  140.                           PRINTING OF THIS MANUAL  
  141.                                                                             
  142.  
  143.  
  144.     To print this manual for this reference, you'll need a
  145. printer (of course?).  At the DOS prompt, enter.... >COPY MP21.DOC PRN
  146. and if your printer is on and ready, this manual will appear before
  147. your eyes!  (Boring stuff, eh?)
  148.  
  149.  
  150.                                         
  151.                                                                             
  152.                                  INSTALLATION  
  153.                                                                             
  154.  
  155.  
  156.     This must be the hardest part of using MP21.  I've written a
  157. short batch file, INSTALL.BAT, which should assist you in setting up
  158. MP21.  At the DOS prompt, type INSTALL <source-drive> <target-drive>,
  159. like one of these examples:
  160.  
  161. If the disk with MP21 on it now is in A: and you want to install it on B:,
  162. use this:
  163.  
  164. > INSTALL A: B:
  165.  
  166.  
  167. If the disk is in B: and you want it on your hard drive C:, use this:
  168.  
  169. >INSTALL B: C:
  170.  
  171.  
  172.     Please note first: Install will make a directory \CK\MP21\ on
  173. your <target drive>, and place the files there.
  174.                                                     
  175.     Then, (no, its not finished yet,) you'll have to copy GW-BASIC
  176. to the \CK\MP21\ directory.  It should be either in the \DOS directory
  177. on a hard drive, or on the DOS disk that came with your system.
  178.  
  179.     When you've finished all that, just enter MUSPLAYR at the DOS
  180. prompt.  If that doesn't work, there's something wrong (or else you must
  181. have a true blue IBM, where you'll have to type BASICA MP21).
  182.  
  183.  
  184.                       - 2 -
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                                        TITLE                                
  195.  
  196.  
  197.     After you've typed MUSPLAYR, you'll see a short display of
  198. the copyright information, then you'll see the title screen flash up.
  199. If you are using a Hercules Monochrome card, unfortunately you won't
  200. get to see my exciting title screen, for reasons I am not sure of.
  201. Anyway, just hit any key and WHOOSH! You're there at the menu screen.
  202.  
  203.  
  204.  
  205.                                      MENU
  206.  
  207.  
  208.  
  209.     Use the arrow keys to move the arrow over a selection.  Hit
  210. ENTER to pick one, and then MP21 will play it.  When the song is
  211. finished, you will go back to the menu to pick another.  To exit the
  212. program, just hit ESC.
  213.  
  214.  
  215.  
  216.                                  MAKING MUSIC                        
  217.  
  218.     By now, you're probably ready to start making your own music,
  219. or typing in music that you've already heard.  To make music in the MP21
  220. format, you use the GW-BASIC PLAY command format.  For details on every
  221. single PLAY command, you might want to see your GW-BASIC manual, but I've
  222. outlined the main ones you'd be interested in:
  223.  
  224. C D E F G A B - Notes on the piano. For sharps and flats, use #, like this:
  225. C#, or G#. You can put a number after a note for the length (like this:
  226. C16 or G8) or use the L command.
  227.  
  228. Lx - where "x" is a number between 1 and 64, representing the length of the
  229. following notes.
  230.  
  231. Ox - where "x" is a number between 0 and 6, representing the octave number.
  232. The default is octave 4.
  233.  
  234. Px - where "x" is the length (1-64) of a pause (rest).
  235.  
  236. Tx - where "x" is the number of L4's in a minute, a number between 32 and
  237. 255. The default is 120.
  238.  
  239. When you are writing music in this format, group everything together, like
  240. this:      O3L16CDEFGABO4C
  241.  
  242.  
  243.  
  244.  
  245.  
  246.                                 - 3 -
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258. You can have several lines, like this "Twinkle, Twinkle, Little Star" song:
  259.  
  260. O3L16CCGGAAGFFEEDDC
  261. GGFFEED
  262. GGFFEED
  263. CCGGAAGFFEEDDC4
  264.  
  265. Now, you enter your music in a word processor that can save in ASCII
  266. format. Give it a name and a .MUS extension, and put it in the MP21
  267. directory. Or, at the DOS prompt, type COPY CON <filename>.MUS, then
  268. type in your music. When you're finished entering it, hit ENTER, F6,
  269. and ENTER again.  Then run Music Player and try listening to your music!
  270.  
  271.  
  272.                     
  273.  
  274.                                          BUGS
  275.  
  276.  
  277.     Every piece of software has a few bugs (okay, maybe its
  278. just my software!), and Music Player 2.1 is no exception.  Here are
  279. the ones that are the most noticeable:
  280.  
  281. 1. After you listen to RIFFRAFF.MUS, included with MP21, all of the
  282. other songs are sped up when you play them.  I think it has something
  283. to do with the tempo in the song, but I'm not sure how to fix it.
  284. (Update alert! Other songs like RAZMAJAZ.MUS change the speed, also.)
  285.  
  286. 2. The title screen won't show up if you are running a Hercules Mono-
  287. chrome card.  There's a reason, but I can't remember what it is.
  288. Oh well again, eh?
  289.  
  290.  
  291.  
  292.                            EARLY VERSIONS AND HISTORY                                    
  293.  
  294.  
  295.     Version 1.0 was the very first and way about six lines long, and
  296. was never distributed.
  297.  
  298.     Version 1.2 was distributed, but you had to type in the name of
  299. the music file manually.  After the song was finished, you'd go right to
  300. DOS.
  301.  
  302.     Version 2.0 had a title screen, and the menu that you see in 2.1.
  303. Just like 1.2, you'd go right back to DOS again. Sysops of the local
  304. Nanaimo BBSes were really complaining about going to DOS right away.
  305.  
  306.     Version 2.1 (this one!) has a better title screen, and after you
  307. play a song, it returns you to the menu so you can pick another one.
  308. Nanaimo Sysops, I hope you're happy now.  At least I am!
  309.  
  310.  
  311.  
  312.  
  313.  
  314.                     - 4 -
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.                                        SHARE!
  322.  
  323.  
  324.     Music Player 2.1 is Shareware, which means that you can make
  325. copies and give them to your friends for their use, and its legal.
  326. But if you continue using the software, you should make a small donation
  327. of $5 to the author, Kevin Matz, to help pay for the expenses of develop-
  328. ment and distribution.  (Sorry, but it is illegal to change any of the
  329. files, whether program, support, documentation, or music files.)  
  330.  
  331. My address is:        KEVIN MATZ (C&K/Pacific Rim)
  332.             99-12th Street
  333.             Site H1  R.R.#1
  334.             Nanaimo B.C.  
  335.             V9R-5K1  Canada
  336.  
  337. To make it for you to register C&K programs, you type COPY ORDRFORM.CK PRN
  338. at the DOS prompt to print out the order form.  And it makes it easier and
  339. faster for me to process your order.
  340. And there's good news for Canadians: It's GST free!
  341. (For non-Canadians, the GST is a new Goods and Services Tax that's
  342. really annoying! It came to effect on January 1st, 1991, and almost
  343. everything is taxed, although things like false teeth are exempt.
  344. Nobody knows exactly how it works, but one thing's for sure- the only
  345. GST you'll pay is on stamps (now 43 cents?) to mail your registration
  346. to us! I'll pay the GST for the disk I send to you.)
  347.  
  348.  
  349.  
  350.  
  351.                            OTHER TITLES I'VE WRITTEN
  352.  
  353.  
  354.     I've written some other software, too.  If you want, you can
  355. order the registered version of the software by filling out the
  356. Order form, or get the non-registered versions from certain Nanaimo
  357. BBSes.  All of the titles are always available at the Express BBS,
  358. in the C&K Software/Pacific Rim File List.  Call 'em up at
  359. (604)-753-0074, 3/12/2400 bps, 8/N/1.
  360.  
  361. MUSIC PLAYER 1.2, by Chris Addison and me.  The original Music Player.
  362.  
  363. MUSIC PLAYER 2.0, by Chris Addison and me.  Another version of Music
  364. Player.
  365.  
  366. KIDS' MAZE, by Chris Addison and me. A REALLY simple maze game. Just
  367. steer the * through the short maze.
  368.  
  369. COPYCAT, by me.  Copy the chain of colors like the hand-held "Simon"
  370. games.
  371.  
  372. TALK TO ME (Many Versions), by me.  Have a conversation with your
  373. computer! Like Joe Weizenbaum's Eliza. Version 3.0 expected to come
  374. out around August 1991.
  375.  
  376. PEN 1.0 Triangle Version, by me. This very boring program shows a
  377. triangle dancing around the screen, bumping into the sides.
  378.  
  379.  
  380.                   - 5 -
  381.             
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.                                       LEGAL STUFF
  395.  
  396.  
  397.     Kevin Matz, C&K Software Technologies, and Pacific Rim
  398. Development are not responsible for any damages to your computer
  399. system, and cannot be held responsible.  In any case, we will not
  400. pay anyone more than the registration fee, $5, but only if they
  401. have registered.  Here's the full story:
  402.  
  403.     C&K/Pacific Rim makes no warranty, either express or implied,
  404. including but not limited to any implied warranties of merchantability
  405. and fitness for a particular purpose, regarding the programs and makes
  406. all programs available solely on an "as is" basis. In no event shall
  407. C&K/Pacific Rim be liable to anyone for special, collateral, incidental,
  408. or consequental damages in connection with or arising out of the purchase
  409. damages in connection with or arising out of the purchase or use of the
  410. programs and the sole and exclusive liability of C&K/Pacific Rim,
  411. regardlessof the form of action, shall not exceed the purchase price of
  412. the registered software package.  Moreover, C&K/Pacific Rim shall not be
  413. liable for any claim of any kind whatsoever by any other party against
  414. the user of the programs.
  415.  
  416.  
  417.                                 COPYRIGHT AND GOODBYE                        
  418.  
  419.  
  420. Music Player 2.1, its program files, support files, and documentation
  421. are (C)opyright 1990 and 1991, Kevin Matz, distributed by C&K Software
  422. Technologies and Pacific Rim development.  (Sorry, but making changes to
  423. any files of the program, in whole or in part, is illegal.)
  424.  
  425.     See you later,                (Please call the
  426.     Kevin Matz.                EXPRESS BBS at
  427.     Sunday, January 13, 1991.        604-753-0074.)
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.                       - 6 -
  439.  
  440.