                       ** Copy From KCS **

Due to popular demand, I've given Tunesmith the ability to read single 
sequences directly from the KCS, and convert them to themes. This function is 
accessed from the "Copy From KCS" option in the menu. This option, while not
as sophisticated as most of Tunesmith's other functions, does allow you to
use your own musical material to drive Tunesmith's Accompaniment and Tonality
Generators.

The rules for converting sequences to themes follow:

* When Tunesmith is not running in the MPE, a file select window will appear
after you select Copy From KCS, which will allow you to load a single .SEQ 
file. If you're using MIDI files, you will need to convert them to .SEQ files
before loading them into Tunesmith, using the program CONVERT.PRG. Conversion
then proceeds as described below. (Copy From KCS only works outside the MPE 
for Tunesmith versions 1.07 and later.)

* Tunesmith converts the sequence, track, or range that was last displayed 
on the Edit screen in the KCS. Only the first 99 notes or rests in the sequence
will  be converted, and an error message will be issued if no notes are found
in the selected area. If a range is highlighted, the first TIME value in the 
range is always taken to be 0, and the final event is always treated as a DE
event. For complete sequences and tracks, the TIME of the first event is 
handled the usual way. 

* Sequences are auto-corrected to the current Microbeat setting during the 
conversion. (The source sequence is not affected by this.) The current 
Microbeat and Pulse settings are then used for the new theme. (These values 
are taken from the THEME & VARIATION PARAMETERS window, not the display
window.)

* Sequences are assumed to be monophonic. If more than one note falls on 
the same microbeat (after autocorrection), the first note will be used.

* Pitches are converted to scale positions based on the current settings of 
the Scale, Key, Mode, and Octave parameters. If a note in a sequence is not 
a member of the current tonality, that note will be replaced with a rest.

* Velocities in the sequence are converted to one of Tunesmith's three 
accent levels based on the Velocity and Accent settings for voice 1, 
according to the following rule: Notes with velocities greater than 
(Velocity + |Accent|) are "accented" notes, notes with velocities greater 
than (Velocity - |Accent|) and less than (Velocity + |Accent|) are 
"normal", and velocities less than (Velocity - |Accent|) are considered 
"de-accented". (Note that the absolute value of the Accent parameter is 
used.)

* Notes with durations that are much shorter than their lengths are broken 
into a note followed by a rest, with the timing of the rest determined by 
the note's DUR value. This gives you extra control over the algorithms that
place an accompaniment note on a rest.

* All DE events (except the "trailing" DE, if present) are converted to rests
in Tunesmith. The program uses the note C - (MIDI note 0) as a flag during
this process, so you should avoid using that note either in your sequences
or tonalities.

* The converted theme is placed in the first empty variation slot. (Tunesmith 
can't place the result in a theme location, due to the structure of the
program's internal data.) If no variations are empty, an error message will
occur.

* If the converted theme is greater than 255 microbeats long, the program's
Left display will not work properly. 

You can see that Tunesmith makes a great many assumptions about the content 
of the sequence, which means that there may be some disagreement between 
you and the program about the proper way to convert the sequence. If so, 
you can minimize problems by cleaning up the sequence before converting  
(strip out all data other than single note ons, auto-correct, etc.) You 
should also be careful to choose the right tonality, and to account for
Key, Mode and Octave settings, as well as the Scale.
