╔══════════════════════════════════════════════════════════════════╗ 
                                                                     
        D I S P L A Y I N G    M U S I C    W I T H    D M U S E     
      ════════════════════════════════════════════════════════════   
    ╚══════════════════════════════════════════════════════════════════╝ 

                 ┌────────────────────────────────────────┐ 
                 │ <shft> F1  =  Toggle to regular window │ 
                 └────────────────────────────────────────┘ 

    ┌──────────────────────────────────────────────────────────────────┐ 
                                                                     
          If you are reading this document for the first time and    
      are unfamiliar with the commands for scrolling the text, you   
      should be aware that <ctrl> ▲ (hold down the <ctrl> key and    
      push the cursor UP key) will scroll the text UP and <ctrl> ▼   
      will scroll the text DOWN.  You can also use the PageUp and    
      PageDown keys to scroll quickly through the document.          
                                                                     
    └──────────────────────────────────────────────────────────────────┘ 



1.1       We have tried to make displaying music with this program 
      as easy as possible.  Use the <F2> key and the right cursor 
      <►> to highlight the Graphics box.  Then use the down cursor 
      <▼> to highlight Display MuseData files in musical notation 
      and press <Enter> to select this option.  


1.2       Your first task will be to identify the file or group of 
      files which contain the musical data you want to display.  

      ╔═════════════════════════════════════════════════════════════╗ 
                                                                  
        Display files come in two types: Music Page Files (.mpg)  
        and Compressed Format Files (.cft).  In the case of       
        displaying from Music Page Files, you have two options:   
        (1) you can display a single .mpg file, or (2) you can    
        display all (.mpg) files in a directory.  In the case of  
        displaying from a Compressed Format File, the structure   
        of the .cft file will determine your display options.     
        A .cft file can be a compressed version of (1) a single   
        .mpg file, (2) a directory of .mpg files, or (3) a        
        directory containing sub-directories of .mpg files.       
                                                                  
      ╚═════════════════════════════════════════════════════════════╝ 


1.3       A box will appear showing all of the sub-directorys, all 
      of the .mpg files, and all of the .cft files in the current 
      directory.  You can use the highlight and the <Enter> key to 
      change the current directory (.. = change to parent directory), 
      or to select a .cft file or a .mpg file.  Use the <F3> key to 
      select a sub-directory containing .mpg files.  

      ╔═════════════════════════════════════════════════════════════╗ 
                                                                  
        The only problem with this system is that you need to     
        know location of the .cft and .mpg files on your file     
        system.  Presumably you will have loaded these files      
        yourself, either from the internet or from portable       
        media.  If you can't remember where you put them, the     
        Resident File Manager (one of the utilies) can be useful  
        in finding them.  Also, if you have activated the Zbex    
        programming language, the Zbex "lost" program will give   
        you the names and locations of all .cft or .mpg files     
        on your file system.                                      
                                                                  
      ╚═════════════════════════════════════════════════════════════╝ 


1.4       After you have selected a data file for display, Dmuse 
      will tell you what is in the file or files.  Follow the 
      instructions on the screen to select the page you would 
      like to display first.  


1.5       When a page is first displayed, depending on the resolution 
      of your screen, you may see only a small portion of the page.  
      At the present time, all pages are typeset at 300 dots to the 
      inch.  You may scale the page by a factor of 2, 3, or 4, by 
      pressing the number 2, 3, or 4 keys on the keyboard.  Pressing 
      the 1 key will return the scale to full size.  You may also 
      scroll the display up and down, right or left, using the cursor 
      keys.  The <shft> cursor keys will also do this, only in bigger 
      jumps.  


1.6       When you are done viewing a page, you have three options: 

      (1) press <Enter> to see the next page, if there is one.  
      (2) press <Backspace> to see the previous page, or 
      (3) press <esc> to return to the main program.  


    ────────────────────────────────────────────────────────────────── 


              ╔═════════════════════════════════════════════╗ 
                                                          
               Subjects relating to the Display of Music  
               ═════════════════════════════════════════  
              ╚═════════════════════════════════════════════╝ 


     I. Compressing and de-compressing music data files.  

2.1       Musical notation files are almost always transmitted in 
      the .cft format.  Not only is this format much more efficient 
      (compression = about 4.5 to 1), but also the .cft format 
      allows the tranmission of multiple pages in a specified 
      directory structure.  You can display music directly from the 
      .cft format; however, if you want to make modifications to 
      the musical data, you must run the Expand .cft file utility 
      to create a set of equivalent .mpg files.  The utility does 
      not alter the original .cft file.  mpg files are flat ASCII   
      files and can be edited in a Dmuse window.  


2.2       If you want to compress a set of .mpg files into a .cft file, 
      there is also a utility for this, namely Compress MusePage files 
      to .cft file.  Care must be taken in how you alter the .mpg 
      files; otherwise the compression to the .cft format could produce 
      unpredictable results.  For more information on the structure of 
      .cft files and .mpg files, see the selectons mpg file format and 
      cft file format under the Help box of the top menu bar.  


    II. Building Libraries of Slurs.  

2.3       In musical notation, slurs are the curved lines used to 
      link groups of notes together.  Because slurs can vary widely 
      in shape and length, they are the most difficult and time 
      consuming notation to produce using the computer.  Fortunately, 
      it is possible to construct sets of slurs which can deliver the 
      correct slur shape about 90 percent of the time.  These sets 
      are quite large and occupy about seven megabytes of disk space 
      for each note size.  The computation of a set (for each note 
      size) takes anywhere about 8 seconds on a 1 GHz computer.  The 
      payoff is that the display and printing of music will run an 
      average of 30 percent faster (depending on the number of slurs 
      on a page) with slur libraries than without them.  The utility 
      for building slur libraries is under the Graphics header in the 
      menu bar.  


    ──────────────────────────────────────────────────────────────────