KS editor 0.1a 

copyright 1994 Erwin Petter, all rights reserved.

************ D i s c l a i m e r 

You may distribute and copy this software freely. It cannot be sold or
bundled with any commercial package without permission of the author. The
author accepts no responsibility for damages resulting from the use of
the program.

************ I n t r o d u c t i o n

This is a sysex-utility for the KS32 which uses the multimedia-extensions
of Windows. A simple editor for editing banks and sounds is included. The
program should work with all midi-equipment that has a Windows-driver. With
my Pro Audio 16 sound card everything worked well.

The Program should also work with the SQ1 or SQ2 as they are compatible.

The screen was designed for a standard VGA 640x480 using the standard 
VGA driver because that is the screen that most PC-users have. 

The program can read files (sequences, banks and sounds) and 
send them to your KS. It can receive sequences, sounds and banks from your
KS and save them to disk. Receiving is done by request, so you don't have
to press any button on your KS. 

In the program you can edit a standard sound. Drumsound editing is not
implemented yet. You should be able though, to edit the effect included
with the drumsound.

This program was written in Borland Turbo Pascal for Windows 1.5

************ I n s t a l l a t i o n

Files:

With this program the following files are distributed:

KSEDITOR.EXE (The program)
KS32.INI   (Put this in your Windows-directory)
README.TXT (This File)

- Install the program in any program group you want (see the windows
  manual). You see an icon showing the KS32-display.

- Put the file KS32.INI in your Windows-directory

- If you first enter the program, choose the midi-drivers in the menu-item
  "Setup" in the Sysex-Menu.


************ D e s c r i p t i o n

The main screen is split up into three parts.

1) The Bank Window. Here the names of 80 sounds are displayed in a list. If 
you want to edit a sound, just doubleclick on the name. If you want to put
an edited sound in the list, put the selector on the desired point and press
F10 (or choose the Menu-Item). The editing-window can be used as a clipboard.
You can load a default bank in the window, when starting the program. Just
put the following lines in the file KS32.INI

[Bank]
Defbank=C:\KS\BANK.SYX

or any file you like.

When loading a bank, the first sound is put into the editing window.

2)The Effect and Name Window. Here you can edit the name of the sound and
some other parameters which are common to each voice.
In the lower part of the Window, an effect-edit region is displayed. If you
change the effect, the region changes. The default-values for an effect are
NOT loaded. Instead most values stay the same when you change the effect.

3) The Voice-Edit Window. Here you can edit one of the eight properties of
a voice. These are the same as the buttons on your KS. If you press one
of the eigth buttons, you get a different screen. If you press one of the
three voice buttons all the editing you did is converted into internal
values. If an error is occurred you will get the message than. So there can
be a delay between making an error and getting the message. You will have to
check all of the eigth screens of the last voice to find the error. The
conversion to internal values is also done before the sound is sent or
saved. Instead of the wrong value, the old value is taken.


************ A b o u t  E d i t i n g

There are some restrictions in editing:
a + before a positive number is not allowed and will cause an error.
no spaces before the number are allowed.
The parameters that can have negative values have a + Marker before
the Editing-region.
The values KEYUP for delay-time and ZONE for Keybscale must be typed as
written here, in capitals, otherwise you will get an error.

************ A b o u t   S y s e x

The number of bytes which are received is always checked. If the wrong
number of bytes is received you will get an error. If you do not get
an error you can be almost sure that the sound was received OK. With my
system the error percentage was about 3%, especially with huge songs.

I only tried only one Sysex-file that was bigger than 64K. I don't have the
memory expansion for the sequencer so I could not test sending and
receiving of huge Songs extensively. I just hope it will work.

The midi-drivers can be changed in the Menu-item Setup in the Sysex-Menu. 
If you change the values, these are saved in the file KS32.INI. If you don't
do a Setup the program will take the first Midi-device (0). Choosing the
wrong midi-driver can cause a hang-up when receiving (see known problems).
If you don't have a midi-driver installed the Sysex-commands are disabled.
You can still edit sounds and banks though, and save them to disk.

************ K n o w n   P r o b l e m s:

With my system it is not possible to cancel a receive-command. I included
a CANCEL-button but it won't work. I think that the midi-driver blocks all
the events. At the moment I don't know a solution for this.

If you CAN cancel receive-commands please let me know.


************ A c k n o w l e d g e m e n t s:

I thank the ENSONIQ corporation for sending me the specifications so
quickly from overseas.


************ Q u e s t i o n s:

Send any questions and bug reports to:
petter@ibmt.fhg.de
[you may also just give me your opinion on the program]

************ Bugs fixed *********************
When receiving or loading a new sound, the data of the
currently selected voice was copied in voice1.

When putting a sound in the bank, the same problem occurred.

These bugs have been fixed
