CHAPTER 2 -- Command Center    

Overview 
When you run KLIB, the command center appears. The command center is
where you launch windows for editing objects as well as manipulating them.
We'll give names to the buttons and labels on the command center below. We'll
refer to those names frequently later.

-------------
Command Center Buttons are as follows...
Top row, left to right:
Open, Save, Save As, Midi, Upload, Download, Delete, Copy, Paste, Edit Object, 
List References, Renumber

Bottom Row, Left to Right:
List Windows, Object Name, Object Type, Object ID#
-------------

Working with Files
When you run KLIB, you can immediately create objects and edit them. This is
like starting with a blank sheet of paper. However, creating objects from 
scratch is a tedious process. You may instead want to start from an existing 
set of objects and modify them. KLIB comes with a file of objects uploaded 
from the K2000 ROM. To open this file:Push the  open file button. A standard 
Windows open file dialog box appears. Choose and open the file  Kmaster.kr2 .  
KLIB uses the default extension of .KR2. When you create a new KLIB library, 
use that extension. Push the  Save button to save objects to the currently 
opened file. Save your work often. Alternatively, you can save objects to a
differently file. Push the Save as button. A standard Windows file dialog box
appears. Type in the pathname you wish to save into and push the OK button.

Objects
The organization of objects in KLIB is identical to that in the K2000. Each
object has a type, a name, an ID, and its data contents. A valid object ID is
restricted to a certain range according to its type and its bank number. The
following table shows the valid object IDs.  The master setting object type is
a KLIB-only object type and has no counterpart in the K2000. It follows the
object numbering scheme for user interface consistency. Unlike the K2000, a
KLIB object can be a name-only object. A name-only object simply means that it
has only a type, a name, and an ID, but without the data contents. You
specify this property when you create the object or when you upload it. It is
useful when you only want to reference that object from another one, e.g.,
designating an effect for a program, and you don't want to edit it. Using this
feature reduces the disk file size and memory consumption for KLIB. However,
you will not be able to edit a name-only object. An object which contains a
name-only object will not be able to display that object's properties. If you
attempt to edit a name-only object, KLIB will ask you if you'd like to convert
the object into a full-blown one. Also, you cannot download a name-only
object.

Selecting an Object
To select an object, first choose the type of object you wish  to select. Push
the Object Type button. A menu appears with the list of object types. Click on
the type you wish to select. The Object Name list is now filled with the names
of objects of that type (if there are any in the file). There are 3 ways to
select an object once you've selected the type: 
Pull down the list by clicking the down-arrow button. Type the object's name
in the list box followed by enter. You may type the first few characters of
the object's name. KLIB will search for the first object matching what you
just typed. Type the object's ID and enter. To avoid confusion, you should
avoid naming an  object with a number.  Once an object is selected, the Object
ID button displays its ID.

Creating or Renaming an Object 
To create an object, first you select its type as described above. Type
the object's name  followed by enter . If there is no object matching the name
you typed, a dialog box pops up prompting you for further actions. If there
was a selection when you typed in the objects name, you may either create a
new object or rename the current selection. If you choose to create an object,
the new object's data is copied from the current selection. If you want to
create or rename an object with a name that matches some existing object
already, type the name and press  enter while holding the shift key. The shift
key tells KLIB not to carry out a name search and you'll be able to create an
object with that name. Names are not required to be unique in KLIB, i.e., you
can have many objects with identical names but distinct IDs. KLIB treats them
as distinct objects.If there was no selection (indicated by a blank Object
Name list), a new object is created with default data. If you are creating a
sound block (sample) object, you must make a selection of another sample
object first. KLIB cannot create a sample object from scratch. Enter an object
ID or push the find free button to let KLIB to find a free ID for you. Check
the name-only box to create a name-only object. Push  OK  to complete the
operation.


Editing an Object
Select the object you wish to edit. Push the Edit button. A new window will be
activated displaying the contents of that object. We'll describe the edit
windows for each object type in the next two chapters. If the object you
selected is a name-only object, KLIB will ask if you'd like to create the
data content for that object.


Deleting Objects
Select the type of objects you wish to delete. The dialog  box on the right
appears.  Type in the range of IDs you wish to delete and push the OK button.
If you check the  retain name entry  option, KLIB will not delete the objects
but reduce them to name-only entries.

Copying an Object to/from the Clipboard
To copy an object to the clipboard, select it, and push the  Copy to
Clipboard. The clipboard stores only one of each type of objects. Therefore
when you copy an object to the clipboard, the previous one of the same type
will be discarded from the clipboard. To paste an object from the clipboard,
push the  Paste from Clipboard button. The dialog box on the left appears.
Select the type of object you wish to copy, enter the new object's ID, and
push the  OK  button. You can push the  find free  button to let KLIB to find
a free object ID for you. Although we use the term -clipboard  here, KLIB does
not use the actual Windows' clipboard but rather implements its own. For this
reason, you must have at least one copy of KLIB running to keep the
KLIB clipboard active. That is, the KLIB clipboard will disappear when the
last copy of KLIB quits.

Showing an Object's References
K2000 objects contains references to other objects, e.g., a program has an
effect and one or more keymaps, and a keymap in turn contains sound blocks
(samples). To find out what other objects reference a particular object,
select it, and push the Find Reference button. A window showing the references
pops up. You can simply push the button after you've finished examining it.
You can edit a container object by selecting it in the list box and push the
Go to button

Renumbering Objects
Select the type of objects you wish to renumber, and push the Renumber button.
The dialog box on the left appears. If you wish to renumber a single object,
type in the old and the new object IDs and push the  OKbutton. If you wish
to renumber an entire bank of objects, type the old and the new bank numbers.
The new bank must not contain any object with an ID that conflicts with a
renumbered object.

Selecting MIDI Drivers
Push the connect  button to establish a connection between your PC and the
K2000. If you have more than one MIDI driver installed in your system, the
dialog box on the right will contain list boxes of MIDI devices. Choose the
devices that are connected to the K2000. Type the  SysEx ID that youhave set
for the K2000, and push the button. Consult the K2000 guide for setting the
SysEx ID of the synthesizer

Uploading Objects from the K2000
Uploading means obtaining object data from the K2000. KLIB already comes with
a file containing the ROM object data. If you have purchased other samples or
programs, and wish to modify them, you first load them into the K2000, and
upload them into KLIB using the upload feature. When you push the Upload
button, the following dialog box appears. If you have not yet selected a MIDI
driver, or have not set the SysEx ID, the MIDI driver selection dialog box
described in the previous section will first appear. Select the type of
objects to upload in the  Object type list .  Type the range of object IDs
to upload. KLIB will upload all objects from the K2000 that fall into that
range. To upload only object names, check the  Name only  option. If you
are uploading object IDs that already exist in the file, KLIB will replace
the existing objects with the uploaded ones. Check the Confirm overwrite
option if you wish KLIB to warn you of this fact during uploading. You'll have
a chance to cancel the operation then. After you've set all the parameters,
push the Start  button to start the upload. During the upload, the status
panel  will show the names of the objects as they are being uploaded. If KLIB
encounters an error, a message will appear in the panel. After a set of
objects has been uploaded, you can either push the Close button to  exit from
this dialog, or choose another set of objects to upload by repeating from
step 1.

Common Errors
There are a few common errors you may encounter. First, the status panel may
show a message complaining that the MIDI device is in use by another
application. This happens when you are running another program, such as a
sequencer, which uses the same driver. Some older MIDI drivers are incapable
of handling multiple applications. You should contact your MIDI
card manufacturer to obtain a newer driver which corrects this problem.
Meanwhile you do have to close the other application(s) before you can
proceed. If this problem persists after you've closed the other
MIDI applications, it's possible that those applications did not close the
MIDI devices properly. Exit Windows and restart.

Another scenario is that nothing happens after you pushed the  Start button.
There are a few likely explanations for this: Check that your K2000 has been
powered on. Check that the output of the K2000 is connected to the input of
your MIDI card, and vice versa. Check that the SysEx Id you've selected in the
K2000 matches that in KLIB. In all cases, push the  Stop button, correct the
problem and try again.

Downloading Objects to the K2000
Downloading means sending KLIB objects to the K2000. The process is similar to
that of uploading. A similar dialog box appears when you pushed the  Download
button. Again,  you can download many sets of objects before exiting the
dialog. Unlike uploading, you will not get any problematic symptoms for the
error conditions described above. If the K2000 and the MIDI card are
not connected properly, the MIDI driver will simply send the data to nowhere
and the download operation will appear successful. KLIB does not keep track of
the objects in the K2000. Thus, when you download an object, the
existing object in the K2000 (if any) will be overwritten. Make sure
you've saved your work in the K2000 before performing a download.

Drag-dropping
Drag-dropping is an alternative shortcut to accomplish some of the tasks
described previously. To start a drag-drop, select an object, push and hold
the mouse button on the Object ID  button. At this point, the cursor changes
its shape to a drag-drop icon. Drag the icon to one of several buttons and
release it. KLIB applies the corresponding operation to that object. E.g., if
you drop the object on the  Delete button, that object will be deleted (rather
than popping up the delete dialog box). The following illustration shows 
which buttons you can drop the object into

Object Windows List
In the course of creating and editing objects, you may have opened many edit
windows. To switch around different windows quickly, click on the  Window list
button. A menu of the titles of all the created object windows will appear.
Select the window you wish to switch to. That window will be activated
and brought to the front.

Quitting KLIB
Pull down the system menu on the upper left corner of the command center and
choose Close . If you have made changes to any object in the file, you'll be
prompted for saving the changes before KLIB finally exits