╔══════════════════════════════════════════════════════════════════╗
║ ║
║ 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.
──────────────────────────────────────────────────────────────────