




                       THE PURPOSE OF THE "READ.ME" FILE

This documentation contains additional information that may be helpful for
users to better understand the COMPOSE program.

You can print out this document as suggested in the user's manual, i.e,
from the DOS prompt (usually "A>", or "C>");

type            A>Ctrl-P   (hold the Ctrl key down while typing the letter P),
and then type   A>type read.me

Note that the Ctrl-P turns on a DOS function to print whatever is being
displayed on your screen.

NOTE:  Don't forget to reset this printing option by issuing another Ctrl-P
       after printing is completed or everything else you display will be
       printed!

                          GETTING STARTED WITH COMPOSE


Prior to running COMPOSE, you must make a copy of the original
COMPOSE program diskette.  Follow the instructions in your manual if you
need help.

After installing your IBM Music Feature card(s), and the COMPOSE program
following the instructions in the COMPOSE manual, try the exercise
below to gain quick familiarity with COMPOSE:

A.  Boot your machine with DOS (version 2.1 or higher).
B.  Load COMPOSE by typing "CMP", and the Enter key (RETURN).
    NOTE: the COMPOSE program should be in drive A: or drive C: depending on
          where you are executing the program.
C.  When loading is complete, the COMPOSE main screen is displayed.

Now try the following steps to get started with COMPOSE:

When the main COMPOSE screen is displayed you will see empty staves on the
screen and COMPOSE will wait for your instructions on what to do.
For example, you try the following for immediate results;

1. CREATE A SIMPLE COMPOSITION

   Press the Enter button a few times; observe that notes appear on the staff
   at the current cursor position (identified by the long vertical crosshair;
   the horizontal part of the crosshair defines where the note will go).
   Use cursor-up or cursor-down to move the note position as you desire,
   then press Enter several times to define more notes.

2. PLAY BACK THE COMPOSITION

   Press the function key F9:Play to request the playback of the notes you
COMPOSE version 1.0 / KAPI version 1.02  READ.ME by YAMAHA              Page 2
                                                                 30 April 1987


   just entered.  Note that a popup window appears which controls the
   playback of your "composition".  From the play window, press F9:Start to
   begin the playback of your composition.  You should now hear the music
   that you have created!  If not, check the audio connection of your IBM
   Music Feature to your headphones or amplifier.  When finished press the
   Esc key to return to the main screen.

3. PRINT THE COMPOSITION

   From the main screen, press F10:Print to display the COMPOSE print window.
   From this print window, press F9:Start to begin printing the music you
   created and played in steps 1 and 2.  When printing completes, you now have
   a record of your music!  When finished, press the Esc key to return to the
   main screen.

4. EDIT THE COMPOSITION

   Now that you have a composition, you may want to enhance (or possibly
   correct) your first pass of the composition.  Move the note cursor (again,
   the long vertical crosshair cursor) to a position where you can do the
   following kinds of music editing;

   a. Delete a note

      Position the note cursor on top of a note, and press the Del key;
      the note disappears.

   b. Add a note

      Position the note cursor between any two notes, and press the Enter
      key; the new note appears, inserted between the two existing notes.

   c. Make a chord

      Position the note cursor on top of an existing note, and move
      the note position above or below the existing note (using the
      cursor-up or cursor-down keys) then press Enter to add the note.
      using this approach, you can easily create chords!

When finished with editing the composition, you can play it or print it
by repeating step 2 or step 3 as often as you want, all interactively!
Now that you have been introduced to creating, playing, printing, and
editing of musical compositions using the COMPOSE program, you are ready
to begin serious work!

We now recommend that you read the COMPOSE User's Manual for complete details
on the program.  Have fun, and great music!
COMPOSE version 1.0 / KAPI version 1.02  READ.ME by YAMAHA              Page 3
                                                                 30 April 1987



                              SYSTEM CONFIGURATION

1.  Memory requirements

    -  COMPOSE's minimum memory requirement is 256K bytes.
       However, to enjoy its full capability, we recommend that a minimum of
       384K bytes of memory be installed in your system.

    -  With a 256K byte system, the number of musical steps that you can enter
       is limited to the following:

        Microsoft mouse             With mouse      Without mouse
        ---------------             ----------      -------------
        DOS 2.1 w/256 Kbytes        9500 steps      10000 steps
        DOS 3.2 w/256 Kbytes        5500 steps       7000 steps

       WITH DOS 3.2 AND A 256 KBYTE SYSTEM, REGARDLESS OF MOUSE INSTALLATION,
       YOU ARE LIMITED TO LOAD ONLY PART 1 OF THE SAMPLE.CMP FILE!!!

       REFER TO THE USER MANUAL AND THE HELP TEXT FOR FILE LOADING FOR DETAILS
       ON LOADING SELECTED PARTS OF MUSIC COMPOSITIONS!

2.  Disk drives

   It is a good idea that you organize your own directory system to hold the
   COMPOSE program and music performance data files in an easy and systematic
   way.  The very first time when COMPOSE is executed, COMPOSE makes the
   following assumptions for your directory and drives:

                             COMPOSE system          Data files (e.g., music)
                             --------------          ----------
        Hardfile system     "current drive"              C:

        2 floppy disks            A:                     B:

        1 floppy disk       "current drive"         "current drive"


    Notes:

        1.  Default directory is assumed to be the "current" directory.

        2.  When the drive and path setting are changed in the File window,
            they are remembered and used from the next time you start COMPOSE
            from DOS.  The File window is invoked by pressing F4:File.

        3.  COMPOSE keeps COMPOSE.STU updated to contain directory path
            information EVERY TIME COMPOSE IS EXITED.
            To enable this to work on a diskette system, the diskette
            containing COMPOSE should NOT be write-protected.

        4.  A reminder:  Prior to running COMPOSE, you must make a copy of
            COMPOSE using the original write-protected 5.25" or 3.5" master
COMPOSE version 1.0 / KAPI version 1.02  READ.ME by YAMAHA              Page 4
                                                                 30 April 1987


            COMPOSE program diskette.

        5.  If you experience significant difficulty with any of the COMPOSE
            functions, defaults, or any other persistent problem, make another
            copy of your master COMPOSE diskette and try again.
COMPOSE version 1.0 / KAPI version 1.02  READ.ME by YAMAHA              Page 5
                                                                 30 April 1987


                  SUPPLEMENTARY INFORMATION TO USER'S MANUAL


1. Mouse control on the main screen.

   As explained in the manual, the mouse cursor is shaped as a pair of
   crosshairs on the music staves on the main screen.  You can click the left
   button of the mouse to enter the note anywhere on the staff pointed by the
   note cursor.  However, you may find it is sometimes convenient to just
   point the note cursor at where required, and not enter a note.
   To reset the position of the note cursor, press the Ctrl key while you
   move the cursor and click.  This procedure protects you from accidentally
   entering a note onto the staff.  Also note that, while you are pressing
   the Ctrl key, the cursor becomes arrow shaped rather than a pair of cross
   hairs.

2. How to enter a chord with different notes on it.

   COMPOSE does not allow entry of a chord with notes of different
   duration to be included in one chord.  However, if you wanted to
   accomplish the same effect, i.e., certain notes of the chord to be longer
   than other notes of the same chord, you can tie those notes to immediately
   following notes (of the same pitch), which results in the desired effect
   but uses an alternative approach for the notation.

   To do this, place the note cursor on the note (of the chord) to tie, then
   issue  a tie command or open the edit window and select tie.  Of course
   there must be the same pitched note immediately following the chord.

3. Additional printer options.

   The score printing function in COMPOSE is designed to provide the highest
   quality output possible as a default.

   However, some options are provided;

    a.  Draft mode printing, to reduce the total print time:

        - Hold down the Shift key, then press F9:Start.

          Although the quality of the printing may be less desirable, this
          reduces the printing time by about half.

    b.  Disable empty part printing:

         -Hold down the Ctrl key, then press F9:Start.

          COMPOSE normally prints out empty parts so that you can enter the
          new part data manually along with other already entered data.
          This default is convenient for you to try your ideas and variations
          when you are working and composing using the printed score.
          However, to speed up the printing process, you can bypass this
          default by using this option.

COMPOSE version 1.0 / KAPI version 1.02  READ.ME by YAMAHA              Page 6
                                                                 30 April 1987


     If BOTH Ctrl and Shift are held down while pressing F9:Start, then
     COMPOSE will print in draft mode, and will not print empty parts.


4. How to print a hard copy of the screen (screen dump).

   Press the "Print Screen" key (on right side of keyboard, labelled PrtSc).
   On some keyboards, it is required that you hold the Shift key down and then
   press the PrtSc key.

5. Note on the CX5 composer file conversion

   As explained in the user's manual and by help text, a similar data file
   created by Yamaha CX5 ComposerII can be imported into the COMPOSE program.
   All necessary data conversion during the file loading is done
   automatically.   Occasionally, some data of the CX5 file may not be
   converted successfully
   into the COMPOSE program.  If this situation is encountered, a
   message will be generated in the score as a rehearsal mark comment.
   You can identify such conversion problems by seeing them on the screen
   as usual rehearsal marks. General format of the mark is;

         (@) MSX xxxx

   where xxxx is a comment related to the unsuccessful conversion.

6. Optional arguments to the CMP.BAT file (or COMPOSE.EXE)

   Although the COMPOSE program will run properly with its default
   parameters, you can also change some useful program parameters via
   optional command line arguments to COMPOSE.EXE.
   The general format for parameter specification is;

   At the DOS prompt: COMPOSE -x1 -x2 ...

         where -x1, -x2, ...  are parameters whose functions are explained
         below.  When errors are detected in the command line, the bad
         parameter and any succeeding parameters are ignored.
         Please exercise caution when entering parameters.

   -s    (silent echo)

         Inhibits the echoing of parameters prompt from being displayed when
         COMPOSE command is executed.

   -n     (number of cards limit)

         This number n = 1, 2, 3, or 4 limits the number of useable cards by
         COMPOSE to the specified number, even if there are more cards
         installed.
         If n =0, COMPOSE ignores music card(s) installed in the system.
         With this option, you can edit COMPOSE data without actual music
         card installed.  During this mode, the use of Play, Snapshot, and 
         Step-in functions are inhibited. 
COMPOSE version 1.0 / KAPI version 1.02  READ.ME by YAMAHA              Page 7
                                                                 30 April 1987



   -rn   (resolution)
         n=1,2,or3
         Resolution (r1,r2, or r3) specifies the degree of minimum duration
         interval by which performance is actually driven.
         Since COMPOSE assumes 96 PPQ to be a basis of minimum duration,
         the shortest duration of the note or musical timing is computed on
         the basis of 1/384 (1/4*1/96) note length.
         r1 (default of COMPOSE) specifies actual performance be played with
         the same duration resolution (finest interval=1/384).
         r2 specifies that actual performance be played with half the accuracy
         of r1 (1/192 actual resolution).
         This means the MPU is hlaf busier than r1 option.
         r3 specifies that actual performance be played with 1/4 of the
         resolution of r1 option (now 1/96).  This is the same accuracy as
         that of MIDI resolution.

         You can try r2 or r3 option if you have super fast and complex
         composing piece of music running on slower machine.

   Example usage;   At the DOS prompt:

                             CMP -s -r2 -2

        I.E., Play resolution to 1/192 note, 2 cards only, and do not echo
              prompts for arguments.

THIS IS THE END OF THE READ.ME FILE!

