home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / mus2 / mrorgan.lzh / MRORGAN.DOC < prev   
Text File  |  1986-06-06  |  9KB  |  192 lines
  1.                                 MRORGAN.COM v. 1.0                   Page 1
  2.  
  3.  
  4.  
  5.          
  6.                            Memory Resident Organ Program
  7.          
  8.                             by Mark Lutton -- June, 1986
  9.          
  10.          
  11.          
  12.                                     INTRODUCTION
  13.          
  14.                  MRORGAN.COM allows you to play your IBM PC keyboard like 
  15.          a one-note organ.  The program has three advantages over all 
  16.          previous keyboard programs:
  17.          
  18.                  1.  Unlike "piano" programs which beep the note only 
  19.          once, MRORGAN starts the note the instant you press the key and 
  20.          holds it as long as you hold the key down.  If you hold down more 
  21.          than one key the most recent one has priority.
  22.          
  23.                  2.  It is memory resident, so you can play music even as 
  24.          you run other programs.  Whistle while you work!  You can use it 
  25.          with a typing-tutor program to get audible feedback -- every key 
  26.          is a different note.  Yet it takes only 1.5K of RAM and gets 
  27.          along with many other memory-resident programs.
  28.          
  29.                  3.  You can redefine the key assignments.
  30.          
  31.          
  32.                  The MRORGAN system consists of the following files:
  33.          
  34.          MRORGAN.COM -- the program.
  35.          
  36.          MRORGAN.DOC -- this documentation.
  37.          
  38.          DUMB.COM -- a program that does nothing.
  39.          
  40.          KEYMAP.ORG -- a file for redefining the keyboard layout.
  41.          
  42.          
  43.          
  44.                                  PLAYING THE ORGAN
  45.          
  46.                  Run MRORGAN and it will install itself as a 
  47.          "terminate-and-stay-resident" program.  Now you can play the 
  48.          keyboard.  The keys are laid out like a piano.  The keys 
  49.          ZXCVBNM,./ are C, D, E, F, G, A, B, C, D and E.  The keys 
  50.          asdfghjkl; are B, C#, D#, F, F#, G#, A#, C, C#, and D#.  (F and K 
  51.          should not have any notes because there's no black key between E 
  52.          and F or B and C on the piano, but everyone complained about the 
  53.          missing notes so I put some there.)  The keys Q through P are an 
  54.          octave higher than Z through / and the number keys are the 
  55.          corresponding black keys.
  56.  
  57.                                 MRORGAN.COM v. 1.0                   Page 2
  58.  
  59.  
  60.  
  61.                  Every time you hit the left shift key the notes jump down 
  62.          one octave, and every time you hit the right shift key they jump 
  63.          up one octave.  This allows you to play music with a wide range 
  64.          like Mozart's "Elvira Madigan" concerto.  The shift keys 
  65.          themselves don't make sounds.
  66.          
  67.                  If you press Ctrl, Alt, left shift and right shift all at 
  68.          once, the sound will be turned off.  Hit them all again and you 
  69.          are back to normal.  Start up MRORGAN first thing in the morning 
  70.          and hit all four keys at once.  You can work all day long and 
  71.          nobody will know MRORGAN is installed.  When the boss steps out, 
  72.          hit the four keys and start jamming!  Quickly hit them again if 
  73.          the boss suddenly looks back.
  74.          
  75.                  For the techies, MRORGAN takes over interrupt 9 but 
  76.          passes every keystroke through, so it is invisible to any 
  77.          resident programs that were loaded before it.  A resident program 
  78.          loaded after MRORGAN might not be so nice as to pass on the 
  79.          key-up events, and if so you'll be able to start sounds but not 
  80.          shut them off!  Usually, though, these programs intercept only 
  81.          those events they are interested in and pass on all the rest, so 
  82.          generally most of MRORGAN's notes will work.
  83.          
  84.          
  85.          
  86.                                       CONCERTS
  87.          
  88.                  You will probably notice that if you attempt to play 
  89.          anything musically significant like "Jesu Joy of Man's Desiring" 
  90.          (qwetrryttiuiteqwertytreweqmqwbmwreweqwetrryttiuiteqwentrewqbqmqet
  91.          iteqeti) you will get strange results from DOS or whatever 
  92.          program you are trying to run.  If you want to play a recital 
  93.          without DOS or some stuck-up program beeping at you, start up the 
  94.          program DUMB, included in this system, which will do nothing at 
  95.          all until you hit Ctrl-Break or Ctrl-C.
  96.          
  97.          
  98.          
  99.                               CUSTOMIZING THE KEYBOARD
  100.          
  101.                  Included with this system is a file called KEYMAP.ORG.  
  102.          MRORGAN reads this file from the current directory when it starts 
  103.          up.  If it doesn't find it doesn't get mad; it just beeps and 
  104.          sets up the keyboard in its own way.
  105.          
  106.  
  107.                                 MRORGAN.COM v. 1.0                   Page 3
  108.  
  109.  
  110.  
  111.                  Here is part of the file:
  112.          
  113.          1=G4      ;Key 1:  ESC
  114.          2=B4      ;Key 2:  1  (top row)
  115.          3=C#5     ;Key 3:  2
  116.          4=D#5     ;Key 4:  3
  117.          5=F4      ;Key 5:  4
  118.          
  119.                  Each line is an override for one key.  The number to the 
  120.          left of the equal sign is the "scan code" for the key; 1 is ESC, 
  121.          2 is 1, 3 is 2 -- well, it makes as much sense as anything else 
  122.          about this computer.  After the equal sign is the note to play 
  123.          for that key.  C4 is C in the 4th octave of the piano, in other 
  124.          words Middle C.  B3 is the white key to the left and C#4 or Db4 
  125.          is the black key just to the right.  You can't put spaces or tabs 
  126.          before the number or around the equal sign.  Anything after the 
  127.          ";" on a line is a comment and is ignored. 
  128.          
  129.                  Letters can be upper or lower case.  "#" is sharp and "b" 
  130.          is flat -- one only, no double sharps or double flats allowed.
  131.          
  132.                  A note of "0" is silence.  The shift keys have 0's so 
  133.          they won't sound -- unless you want them to, in which case you 
  134.          can put something there.  Because of the way some keyboards 
  135.          implement Num Lock, Scroll Lock and Caps Lock, assigning a note 
  136.          to them doesn't always work, especially on AT-type machines.
  137.          
  138.                  The parser that reads this file is pretty stupid.  It 
  139.          gives up after the first mistake and tells you what line it 
  140.          didn't like but not what was wrong with it.  The rest of the file 
  141.          is ignored.
  142.          
  143.          
  144.          
  145.                                GETTING RID OF MRORGAN
  146.          
  147.                  MRORGAN does not have any facility to remove itself from 
  148.          memory, because if it tried to do so and it weren't the last one 
  149.          loaded it could crash the system.  There are public-domain 
  150.          programs like MARK and RELEASE that remove resident programs in 
  151.          reverse order.  They work fine with MRORGAN.
  152.          
  153.          
  154.          
  155.                                    COMPATIBILITY
  156.          
  157.                  MRORGAN runs on the IBM PC, XT, AT, Compaq, Compaq 286, 
  158.          and some clones.  Most build-it-yourself Taiwanese clones don't 
  159.          have a speaker.  (Surprise!)  MRORGAN runs; you just can't hear 
  160.          it.  It may work on other MS-DOS machines (maybe) if the timer 
  161.          chip is set up exactly like the PC.  It requires MS-DOS 2.0 or 
  162.  
  163.                                 MRORGAN.COM v. 1.0                   Page 4
  164.  
  165.  
  166.  
  167.          later release.
  168.          
  169.          
  170.          
  171.                                       LEGALESE
  172.          
  173.                  MRORGAN may be freely copied and used by anyone for no 
  174.          charge.  It may be given away, posted on bulletin boards, etc., 
  175.          except that (1) it must be given in unmodified form, and (2) the 
  176.          package must include the four files MRORGAN.COM, MRORGAN.DOC, 
  177.          DUMB.COM and KEYMAP.ORG.  The program has been thoroughly tested 
  178.          but the author makes no guarantees of any kind.  Bug reports and 
  179.          suggestions for enhancements will be considered at the author's 
  180.          convenience.
  181.          
  182.                                     Mark Lutton
  183.                                     30 Rich St.
  184.                                   Malden, MA 02148
  185.                               Compuserve:  73106,1627
  186.                                 Delphi:  MARKLUTTON
  187.          
  188.          
  189.          
  190.           MRORGAN program and documentation copyright (c) 1986 Mark Lutton
  191.  
  192.