home *** CD-ROM | disk | FTP | other *** search
/ Piper's Pit BBS/FTP: ibm 0010 - 0019 / ibm0010-0019 / ibm0010.tar / ibm0010 / LYRADEMO.ZIP / LYRADEMO.DOC < prev    next >
Encoding:
Text File  |  1990-05-20  |  15.1 KB  |  326 lines

  1.                       Lyra Demo Documentation (version 1.20)
  2.  
  3.  
  4.         Thanks for obtaining the demo version of Lyra for the IBM PC!
  5.         Lyra is a MIDI oriented music composition program that is
  6.         designed to be affordable, easy to use, and powerful. In
  7.         addition, it is 100% compatible with the large ready-to-use
  8.         library of music files for the Color Computer available from
  9.         several sources (including DL4 on the CoCo sig on Compuserve).
  10.  
  11.         Lyra will work with any IBM PC (AT recommended!) compatible that
  12.         has a Hercules or CGA (or EGA, VGA) display. A Microsoft
  13.         mouse, while not necessary, is highly recommended. If you wish to
  14.         play music, you must have an MPU-401 and a MIDI synthesizer or a 
  15.         Sound Blaster card connected. 
  16.  
  17.         Before you use the program, make a backup copy and store the
  18.         original in a safe place. All of the files on the disk can be
  19.         copied to a hard disk; just make sure that everything is in the
  20.         same directory. (Note: the commercial version is not copy
  21.         protected.)
  22.  
  23.         Load the program by typing
  24.  
  25.                                        lyrademo
  26.  
  27.         and pressing the return key. The screen will change to a 640x200
  28.         2 color graphics mode and a box in the center of the screen will
  29.         give you a brief introduction. Press any key to continue.
  30.  
  31.         Move your mouse about and you will see a cursor shaped like an
  32.         arrow or diamond moving around the screen. Using Lyra is
  33.         basically knowing what you can do with the arrow.
  34.  
  35.  
  36.         ENTERING NOTES
  37.  
  38.         The cursor keys at the right hand side of the keyboard can be
  39.         used to move the note on the screen, or you can use the mouse, or
  40.         a combination of the two. By moving the note up or down on the
  41.         musical staff, you select a pitch. This pitch is displayed just
  42.         below the bass clef. When you have the right pitch, press the
  43.         left mouse button or "return" (or "enter") key. The note will be
  44.         entered into the score.
  45.  
  46.         Please note that Lyra allows you to enter only one note per 
  47.         voice. We'll discuss "voices" in just a minute.
  48.  
  49.  
  50.         CHANGING NOTE PITCHES
  51.  
  52.         Once you have entered several notes, you can experiment with
  53.         changing notes to different pitches. This is done by simply
  54.         positioning the cursor directly above or below the note you wish 
  55.         to change and pressing the left mouse button or "return" key. 
  56.  
  57.  
  58.         ENTERING SHARPS AND FLATS
  59.  
  60.         A note that should have a sharp or flat in front of it can by
  61.         entered by positioning the cursor and pressing the "S" or "F"
  62.         key. A natural (used only when the key signature is being used)
  63.         is entered with the "N" key.
  64.  
  65.  
  66.         INSERTING NOTES
  67.  
  68.         You can just as easily insert notes. Position the cursor just
  69.         before or after a note and press the "return" key or click the 
  70.         left mouse button. 
  71.  
  72.  
  73.         DELETING NOTES
  74.  
  75.         Deleting a note is done by putting the cursor directly above or
  76.         below the errant note and pressing the "Del" key (on the right
  77.         hand side of the keyboard) or the "D" key. The right mouse button
  78.         or ESC key also deletes a note.
  79.  
  80.  
  81.         CHANGING VOICES
  82.  
  83.         Lyra is capable of 8 simultaneous notes (or 8 note chords). When
  84.         you start the program, all notes are automatically entered into
  85.         voice 1. You can change this to one of the 7 other voices by
  86.         pressing the ALT key (left hand side of the keyboard) with a
  87.         number key. ALT+2 selects voice 2, ALT+8 selects voice 8, and so
  88.         on. You can also select a voice by moving the cursor to the upper
  89.         right hand corner of the screen with the mouse. When it is over
  90.         the box with the voice number you wish to select, click the left
  91.         mouse button. The voice you want to use must have its box
  92.         displayed as a solid white (or whatever is the same color as the
  93.         box border). Only one voice can be selected at a time.
  94.  
  95.         You'll notice that repeatedly selecting the same voice will cause 
  96.         the box to change from solid to "halftone" to hollow. When it is 
  97.         halftone, that voice will not be displayed on the music staff. 
  98.         You can use this feature to pick out individual voices when the 
  99.         display gets crowded. When the voice box is hollow then the 
  100.         corresponding voice is displayed in "halftone". This makes it 
  101.         easy to pick out a voice when the display gets crowded. 
  102.  
  103.  
  104.         SELECTING NOTE LENGTHS
  105.  
  106.         Note lengths are selected by pressing one of the number keys (1
  107.         through 7) or moving the mouse to the row of notes and rests at
  108.         the bottom of the screen and clicking on the desired note or
  109.         rest. You can select a rest by pressing the SHIFT key with the
  110.         number key. When you do, the selected rest will change colors.
  111.         You can also select a note or rest with the mouse; move the
  112.         cursor over the desired item and press the left button. The
  113.         selected note or rest will be highlighted.
  114.  
  115.  
  116.         TRIPLETS, DOTTING AND TIEING NOTES
  117.  
  118.         All notes can be modified by making them triplet, dotted, or tied
  119.         to the previous notes. Just position the cursor directly over the
  120.         note you wish to change and press the "," (triplet), "." (dot),
  121.         or "T" (tie) key. Please note that the tie is NOT the same thing
  122.         as a slur!
  123.  
  124.  
  125.         MOVING THE DISPLAY
  126.  
  127.         The cursor can be quickly moved up or down an octave with the "Pg
  128.         Up" or "Pg Dn" keys. The "Home" and "End" keys move the cursor to
  129.         the left or right ends of the score. When the cursor it at either
  130.         side of the score, it changes shape into an arrow pointing to the
  131.         side. If you press the left mouse button or the left or right
  132.         cursor keys, the whole display will move in that direction. You
  133.         can move to an approximate point in the score by moving the
  134.         cursor over the area directly above the notes and rests at the
  135.         bottom of the screen. Click in the box and the bar positioned at
  136.         the extreme left will move to where you clicked, and the display
  137.         will change. If you click in the middle of the box, the display
  138.         will start at about the middle of the score. If you click at the
  139.         point one-third from the left side of the box, the score will
  140.         display at about one-third from the beginning. And so on. You can
  141.         also use the "Goto bar" command under the Edit menu.
  142.  
  143.  
  144.         A NOTE ON DIALOG BOXES
  145.  
  146.         Many of the commands accessed through the menus request
  147.         information from you through a box displayed on the center of the
  148.         screen. If there is more than one line to enter, you can move
  149.         about using the up and down arrow keys to move from line to line.
  150.         You can use the right and left arrow and HOME and END keys to
  151.         move from one letter to another. The INS and DEL keys can be used
  152.         to insert spaces or delete letters from a line.
  153.  
  154.         When you are finished entering everything, press the ENTER key.
  155.         If you want to abort, press the ESC key.
  156.  
  157.         Pressing the left button of the mouse is the same as the ENTER
  158.         key and the right button as the ESC key.
  159.  
  160.         Some dialog boxes display a list of items with a large inverted
  161.         color selector cursor. Just move the cursor about with arrow keys
  162.         or mouse until the item you want is selected, and press ENTER (or
  163.         the left mouse button).
  164.  
  165.  
  166.         USING THE MENUS
  167.  
  168.         At the top of the screen is a list of the various menus that have
  169.         different commands. You can access a menu by pressing the "Alt"
  170.         key plus the first letter of the menu. For example, to access the
  171.         "File" menu, press ALT+F. Or move move the cursor to the top of
  172.         the screen directly under the menu you wish to access.
  173.  
  174.         Select a command by moving the highlight down either with the
  175.         arrow key or mouse and pressing "return" or the left mouse
  176.         button. Pressing the key corresponding to the first letter of the
  177.         menu item will immediately execute the command. You can move to a
  178.         different menu by pressing the right or left arrow keys or moving
  179.         the mouse in the desired direction. You can abort by pressing the
  180.         "Esc" key, or moving the highlight bar to beyond the bottom of
  181.         the menu.
  182.  
  183.         When an item is displayed in half-tone, it is not available. This
  184.         is due to the fact that you must perform some other command first
  185.         (as with the block commands).
  186.  
  187.         Most of the menu commands are fairly self-explanatory. Of those
  188.         that may cause you trouble, here's a brief explanation.
  189.  
  190.  
  191.         THE OPTION COMMANDS
  192.  
  193.         The purpose of these commands is to let you enter musical or MIDI
  194.         information that is not a note. Select the desired option; the
  195.         cursor changes to a box. Move the box to where you wish to put
  196.         the option and press the "return" key or the left mouse button.
  197.  
  198.         The instrument option transmits MIDI program changes. You can set
  199.         up the names of the instruments and their associated program
  200.         numbers in the Instrument command under the MIDI menu.
  201.  
  202.         "Tempo" is used to enter a "local" tempo change. The actual tempo
  203.         is a combination of the Master Tempo (which is set under the Play
  204.         menu) and the local tempo. When the Master Tempo is set to 1.00,
  205.         then the local tempo is the beats per minute (not exact in this
  206.         version).
  207.  
  208.         "Byte" instructs Lyra to send the specified hex byte (you must
  209.         enter two hex digits) unaltered to your synthesizer. By stringing
  210.         several together you can send almost any type of MIDI
  211.         information.
  212.  
  213.         "Octave" is used to either raise or lower the pitch of a voice by
  214.         one octave. If the marker is placed above the staff, then it
  215.         raises the pitch; if placed below the staff, it lowers the pitch.
  216.  
  217.         "Loco" cancels the effect of a previous Octave command.
  218.  
  219.         "Volume" lets you change the volume of music. You can customize
  220.         the exact MIDI volume by using the Set Volumes command under the
  221.         MIDI menu.
  222.  
  223.         "Events" is used to send larger amounts of MIDI data than can be
  224.         conveniently sent with the MIDI byte option. In fact, you can
  225.         send a whole file of MIDI data such as a system exclusive dump.
  226.         The actual data in the event is set up through the MIDI menu.
  227.  
  228.  
  229.         THE BLOCK COMMANDS
  230.  
  231.         These commands let you work with blocks of music. You first must
  232.         mark a block by positioning the cursor over the starting and
  233.         ending points and pressing the "M" key each time. The music
  234.         within a block is displayed in inverted colors. A block may be
  235.         cleared by selecting the Reset command under the Block menu.
  236.  
  237.         If you select the Copy command, the music in the block will be
  238.         copied to a special area of memory and held until you make use of
  239.         it with the Paste command.
  240.  
  241.         The Cut command copies the block of music to the holding area in
  242.         memory and also deletes that music from the score.
  243.  
  244.         The Paste command takes the music in the holding area of memory
  245.         and puts it back into the score at a spot you designate. When you
  246.         select the command, the cursor changes shape. Move it to where
  247.         you want the pasting to occur and press the "return" key or the
  248.         left mouse button.
  249.  
  250.         The Transpose command lets you transpose a block by a given
  251.         number of steps (use negative numbers to lower pitches). You can
  252.         specify either a "harmonic" transposition which will move the
  253.         notes to a new key, or "modal" which keeps the notes in the
  254.         current key signature.
  255.  
  256.         The block commands work only with music that is currently
  257.         displayed. You can selectively work with different voices by
  258.         turning off the undesired voices first.
  259.  
  260.         Take care with these commands. They all assume that when you
  261.         paste, all music at the paste point aligns at that point. If one
  262.         or more voices are empty or are in the middle of a long note,
  263.         then the new music for that voice will be out of alignment with
  264.         the other voices.
  265.  
  266.  
  267.         PLAYING MUSIC
  268.  
  269.         In order to play music, you must have an MPU-401 (or compatible)
  270.         properly connected, and a MIDI synthesizer hooked up to the MPU-
  271.         401. If you have everything connected up correctly, then you
  272.         might check the channel assignments under the MIDI menu to make
  273.         sure your synthesizer is "listening" on the right channels.
  274.  
  275.         You can also make use of the Sound Blaster by setting the "MIDI 
  276.         Device" line of the Configure command (under the Edit menu) to 
  277.         SBLASTER-S. Be sure that you have entered the correct address and 
  278.         interrupt. The address normally is given in decimal; you can 
  279.         enter a hex value by putting an "H" at the end of the number 
  280.         (such as 220H).
  281.  
  282.         The Filter command under the Play menu is used to filter out
  283.         certain types of data. You can enter one or more of the following
  284.         letters: b, c, e, i, or m. B stands for "midi byte", c for
  285.         "channel", e for "event", and i for "instrument", and m for
  286.         "clock". When the letter is in the filter, that type of MIDI
  287.         information is not transmitted. When channel is filtered, then
  288.         all notes are transmitted on channel 1.
  289.  
  290.         The Play command will play only the music that is displayed on
  291.         the screen. If you wish to mute a voice, turn its display off.
  292.  
  293.  
  294.         WHAT ABOUT THE REST OF THE PROGRAM?
  295.  
  296.         Obviously, there is a lot more that Lyra can do than we've covered 
  297.         here. Feel free to experiment! The only commands that have been 
  298.         disabled are those that display the message "Not Available: Demo 
  299.         Version". If you have questions about what certain functions can 
  300.         do, feel free to write or call for more information. 
  301.  
  302.  
  303.         ABOUT THE COMMERCIAL VERSION
  304.  
  305.         The price of the full commercial version is $49.95.
  306.         As with all MusicWare products, your purchase includes a 30 day
  307.         money back guarantee, free updates for 6 months, and free
  308.         telephone help (when purchase directly from MusicWare). Payment
  309.         may be made with a personal check, Visa, MasterCard, or money
  310.         order. The phone number is (503) 738-0119; ask for Lester Hands.
  311.  
  312.                 MusicWare
  313.                 Hamlet Route Box 1261
  314.                 Seaside, OR 97138
  315.  
  316.         Your comments and suggestions are appreciated.
  317.  
  318.  
  319.         Lyra is a trademark of MusicWare.
  320.  
  321.         Copyright (C) 1989 by Lester Hands. You are permitted to
  322.         distribute copies of the demo program disk for non-commercial
  323.         purposes, provided that no changes are made in any of the files.
  324.  
  325. 
  326.