================================================================================
                                K1-II Librarian

                             Written in 1990/91 by
                                 Andreas Jung
                               Klosterstrasse 21
                               D-6602 Dudweiler
                          Federal Republic of Germany

                             All rights reserved !
================================================================================


This  program  ist  public domain and may be distributed for noncommerical use.
Any  commercial  use  and  distribution requieres the written permission of the
author.   The  distribution  of this program in a PD-library is only allowed if
the  price  of the disk does not exceed the costs of disk, package and mailing.
Suggestions, bug-reports and donations are always welcome.


OVERVIEW:
--------
The  K1-Librarian  is  a  program  for use with the Kawai K1-II synthesizer via
MIDI.  The current version includes a bankloader for single- and multi-patches,
a multipatch-editor and support for the effect-session. 


REQUIERMENTS:
-------------
First  you  need  a  K1-II synthesizer and a MIDI-interface connected with your
Amiga.   I  do  not  know  if my program works with the older K1 models; let me
know  !   It  should  work with any amiga with Kickstart Version 1.2 or higher.
K1-Librarian  was  developped  under  Kickstart  1.3  with  Aztec-C 5.0 and was
successfully  tested  under  Kickstart  2.0  The K1-Librarian should run on any
Amiga with at least 512 KB.

Ensure that the follwing files are in right directories:

                               LIBS:arp.library
                               LIBS:req.library
                               LIBS:midi.library
                             LIBS:diskfont.library
                               LIBS:icon.library
                                 L:ram-handler
                                L:port-handler
                             DEVS:parallel-device
                              DEVS:serial.device


CREDITS:
--------
First  I want to thank Michael Balzer, the author of the K1-Editor published on
AmigaLibDisk  332  (by Fred Fish).  The sources of his editor were very helpful
during  the  development of this program.  He also send me the documentation of
the req.library.

Also  thanks  to  Colin  Fox  of Pyramid Designs and Bruce Bawson of CygnusSoft
Software  for the fine req.library and to people of Pregnant Badger Music which
wrote the midi.library.

Thanks to Fred Fish for his engagement in Amiga-PD.


INSTALLATION:
-------------
First copy the files in the drawer LIBS to your work-disk.  Ensure that all the
files  above  are  in  right  drawer.  Now make new drawer called KAWAI on your
(hard)disk and make a assign to it:    ASSIGN KAWAI:  KAWAI 
Next you should copy the drawers SOUNDS, BANKS, DUMP and MULTI to KAWAI:
I  should  be  enough.   The K1-Librarian can be started either from the CLI or
from the workbench.  The following CLI options are recognized:

		'K1 s' - open a custom screen
		'K1 l' - open a interlaced custom screen
		'K1 g' - get single- and multi-patch dump

Workbench support: The following tool-types are recognized:

		SCREEN=ON/OFF
		LACE=ON/OFF
		GETDUMP=ON/OFF
		MULTIDIR=directoryname
		BANKDIR=directoryname
		DUMPDIR=directoryname
		SOUNDDIR=directoryname

K1-Librarian  will open an interlace screen if it is run on a ntsc amiga.  This
is  nessecary  because  the  program  needs  a  lot  of  space  to  display the
synthesizer informations.


GETTING STARTED:
----------------
When  you run K1-Librarian, it will open a window with a field of 4 columns and
16  rows.   This  field  represents the 64 single patches of the K1-II.  In the
lower half of the window there is the control with the following options:

	Load Bank 1/2: 		Load a file with a soundbank (32 single patches) 
	Save Bank 1/2: 		Save current bank from Amiga to disk
 	Get Bank 1/2:   	Get bankdump from K1
	Send Bank 1/2:		Send currrent bank to K1
	Save Sounds 1/2:	Save the sounds of the current bank to disk. They will
						be put in the directory KAWAI:SOUNDS
	Load/Send as 1/2:   A bankfile is directly send from disk to K1 without
						changing the current banks of the K1-Librarian.
	About:				This option will open a requester with informations
						about my program.
	Iconifiy:			If the Librarian is run on the workbench screen, the
						window will be iconified when you select this option.
						The window can be resized by activating the resized
						window and pressing the right mousebutton. This option
						is not available on a custom screen.
	1-16:				Select a program of the effect session (only K1-II)
		

The  field MULTI in the right upper corner switches to the multi-patch section.
Here  we  have  a  field  for  the  32  multi-patches.   Following  options are
available:

	Load Multi:			Load multi-patch from disk
	Save Multi:			Save multi-patch to disk
	Get Multi:			Get multi-patch from K1
	Send Multi:			Send multi-ptach to K1
	Load Dump:			A dump consists of two single-patches banks and one
						multi-patch-bank.
	Save Dump: 			Save dump to disk
	Get Dump: 			Get complete dump from K1
	Send Dump:			Send current Librarian banks as dump to K1
	Colours:			Opens a colour requester to change the screen colours.
						The colours are saved to disk. This option is only
						available on a custom screen	
	Init all:			All single- and multi-patches will be reseted to the 
						factory patches 'Single K-1' and 'Multi-K1'

The proportional gadget on the right side changes the master volume of the K1.

USE OF MOUSE:
-------------
Move  the  mousepointer  to  field with a singl- or multi-patch.  Now press the
right mouse button.  The current patch will be transmitted to the K1.  When you
press  the  left button over a single-patch, a small requester is open with the
possiblity to load a new single-patch or to save the current patch to disk.  If
the  mousepointer  stand  over a multi-patch and you press the left button, you
switch to the multi-patch editor.


MULTI-PATCH EDITOR:
-------------------
The multi-patch editor gives you the abelity to edit the multi-patches.  Please
refer  to  your  K1  handbook for detailed informations.  All parameters can be
changed  by  clicking  in  the requiered field.  Either the field contents will
change  or  a  window with a proportional gadget will appear.  In this case you
can leave this window by pressing the right(!) button.

The  proportional  gadget  on  the  right  side  will change main volume of the
current patch.

You can leave the editor by clicking in the 'OK' field.  The current parameters
are  immediately send to the K1.  Clicking to the 'Chancel' field will have the
effect  that  all changes are ignored and the old parameters are restored.  The
'Print'  option will print the parameter table to you printer.  In this version
I  use  the  PAR:-device.   Perhaps  I will change it to PRT:-device for better
printer  support.   The current print routine should work on any NEC compatible
24  dot  matrix printer.  Last but not least, the 'Rename' option allows you to
change the name of the selected multi-patch.


BUGS
----
There  may  be  problems  when  running  K1-Librarian  and other midi software,
especially  when  you are trying to interchange SysEx-Data from or to K1.  When
you  request  a  single-  or  multi-patch  dump,  the Librarian will if a K1 is
connected   to   the   system.   But  there  seems  to  be  a  problem  in  the
K1Check-routine.  Sometimes the Librarian does not recognize a connected K1 and
sends an error message.

Perhaps  there may be other smaller bugs.  Please let me know if you think that
you should found one.



********************************************************************************
That  enough,  I  am too tired and sooooooooooooooooo lazy to write more.  And,
excuse my horrible english.
