home *** CD-ROM | disk | FTP | other *** search
/ Season's Greetings & Games Unlimited / UGOLD_cd2.iso / hero / music.doc < prev    next >
Text File  |  1991-12-07  |  4KB  |  70 lines
  1.  
  2.                   MUSIC 1.0
  3.  
  4.             Copyright 1991 Everett Kaser
  5.                  All rights reserved
  6.  
  7.  
  8. The MUSIC.COM program is a stand alone program designed to play the .MUS files
  9. used by SOLITILE 3.  It's use is very simple.  You simply run it, specifying
  10. on the command line the filename of the .MUS file to be played.  It's very
  11. stupid however, so you MUST include the .MUS file extension.  A couple of
  12. examples are:
  13.  
  14.     MUSIC HALLELUJ.MUS
  15.     MUSIC \games\solitile\nobody.mus
  16.  
  17. The program may be interrupted (halted) at any time during the playing of the
  18. music by pressing the <SPACE> bar.  The program will play the music file once
  19. and then halt (if no key is pressed during the playing of the music).  If
  20. there's anything wrong with the syntax of the .MUS file, MUSIC will print an
  21. error message trying to give an indication of the approximate location of the
  22. syntactical goof.
  23.  
  24.  
  25.  
  26. FORMAT OF .MUS FILES
  27. --------------------
  28.  
  29. .MUS files are ASCII files.  They may contain comments, tempo information,
  30. octave information, and notes.
  31.  
  32. COMMENTS are started by a semi-colon (;), and cause everything following them
  33. on that line to be ignored.  The semi-colon may be at the start of a line or
  34. be on the same line after some 'music' information.
  35.  
  36. TEMPO is set by placing a 't' character in the file, followed by an integer.
  37. The integer value is multiplied times each individual note length (see below)
  38. to generate the total length for each note.  This allows the overall "speed"
  39. at which the entire piece is played to be increased or decreased by changing
  40. one value.  T4 is a good value to use when first starting to enter the data
  41. for a piece.  Once you've entered some notes, you can then play them and decide
  42. whether to raise or lower the value.  Remember that this value is MULTIPLIED
  43. with the note length, so the larger the value of the TEMPO, the slower the
  44. piece will be played (T3 is faster than T4).  The tempo may be modified at any
  45. time during the piece.  This can be done by placing a 't-' or a 't+' in the
  46. .MUS file.  This will cause the TEMPO value to be decreased or increased by 1.
  47.  
  48. OCTAVE is set by placing an 'o' character in the file, followed by an integer.
  49. The integer value must be from 1 to 9 (o3 contains 'middle C' on the piano).
  50. An 'o' command (along with a 't' command) should be placed at the beginning of
  51. a .MUS file in order to initialize the octave and tempo to known values.  The
  52. octave can be changed at any time during the piece (and usually needs to be
  53. on most pieces) by using an 'o-' or 'o+'.  Just like tempo, this decreases or
  54. increases the octave by 1.  Increasing the octave (o+) gives higher pitched
  55. notes.  Decreasing the octave (o-) gives lower pitched notes.
  56.  
  57. NOTES are specified as one of a, b, c, d, e, f, g, or r. ('r' stands for Rest).
  58. A note may be preceded by a number which specifies the length of the note.  If
  59. a note is NOT preceded by a number, then it will have the same length as the
  60. previous note.  A note (except for 'r') may be followed by a '#' or '@'
  61. character, to specify that that note should be played 'sharp' or 'flat'.
  62. (There's no checking to ensure that you specify a 'real', 'legal' note.  You
  63. can specify a 'c@' (a C flat) even though there's no such note on a piano.
  64. What you would get is a 'b' note.)  Spaces are generally optional between
  65. notes, although spaces may make reading of the file a little easier for humans.
  66. A Rest (r) causes no notes to be played for that period of time.
  67.  
  68. See any of the .MUS files on the Solitile 3 distribution, or on the Solitile 3
  69. Accessory Disks for examples.
  70.