================================================================================ = K1-II Librarian = = Version 4.0 or higher = = = = Written in 1990/91 and (C) by = = Andreas Jung = = Klosterstrasse 21 = = D-6602 Dudweiler = = Federal Republic of Germany = = = = All rights reserved ! = ================================================================================ COPYRIGHT NOTICE/DISTRIBUTION ----------------------------- This program is not public domain. All rights are reserved to the author. But the program may be freely distributed for noncommercial use. Commercial use or commercial distribution of any kind requires the written permission of the author. If you want to distribute this program in a PD-library, you should write to me and you will get a special release version for your library. If you want to contact me, please enclose any form of payment for package, disks etc. Suggestions, bug-reports and donations of any kind (except letter bombs) 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 singlepatch-editor, a multipatch-editor and support for the effect-session and K1 controllers. The program is totally mouse controlled. All possible actions are selected with the mouse. I did not use pulldown menus for a most efficient use of this program. REQUIREMENTS: ------------- First you need a Kawai 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 developed 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 following 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:printer-device DEVS:serial.device DEVS:printers/ CREDITS: -------- First I want to thank Michael Balzer, the author of the K1-Editor released 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 (released on AmigaLibDisk 227) Thanks to Timm Martin for the release of the sources of his sleepy mouse pointer and the input-device routine (released on AmigaLibDisk 430) Thanks to Paris E. Bingham Jr. who wrote the input handler (released on AmigaLibDisk 446) 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 the assigned directory 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 'K1 i' - initalize all patches by default If you want more than on option, they must by seperated by a blank: e.g. 'K1 l g' - open interlaced custom screen and get single/multi-patch Workbench support: The following tool-types are recognized: SCREEN=ON/OFF LACE=ON/OFF GETDUMP=ON/OFF INITIALIZE=ON/OFF MULTIDIR=directoryname BANKDIR=directoryname DUMPDIR=directoryname SOUNDDIR=directoryname DEFAULTDUMP=dumpname K1-Librarian will open an interlace screen if it is run on a ntsc amiga. This is nessecarry because the program needs a lot of space to display the synthesizer informations. OTHER MIDI SOFTWARE ------------------- K1-Librarian uses the Midi-Library. All programs which use this library may be started at the same time. But there are some programs that can not be run simultaneously with K1-Librarian. One program is e.g. the Steinberg 24 sequencer. On the other side Bars & Pipes seems to work without problems. CHANNEL-NUMBERS: ---------------- When you start the Librarian, it will check on which midi channel the K1 is sending. It is not neccessary to select a special transmit or receive channel. The Librarian automatically recognizes the receive channel and remembers of it, when it will send some data to the K1. Therefore you not change the receive channel of the K1 because there may be a malfunction of the Librarian. BANK-ORGANISATION ----------------- The K1 has space for 64 single patches. They are organised in two banks: Bank 1: A1 - D7 Bank 2: a1 - d7 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 current 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. Iconify: The program's window will be iconified when you select this option. The window can be resized by activating the iconified window and pressing the right mousebutton. 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-patch 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 Colors: Opens a color requester to change the screen colours. The colours are saved to disk. Init all: All single- and multi-patches will be reseted to the factory patches 'Single K-1' and 'Multi-K1' Change screen: Toggle between workbench and custom screen Controllers: Show some gadgets for master K1-II controlls e.g. mastervolume, pitchbender and modulation wheel The proportional gadget on the right side changes the master volume of the K1. USE OF MOUSE: ------------- Move the mousepointer to field with a single- 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 or multi-patch, a small requester is opened with the following possiblities: Single-Patches: --------------- Load sound: Load sound from disk Save sound: Save sound to disk Edit sound: Switch to single-patch editor (see below) Transmit sound: Send current sound to K1 Copy to: Copy current patch to other position. Select destination by clicking to the wished position Swap with: Swap current patch with another patch Cancel: Close and leave requester Multi-Patches: -------------- Edit multi: Switch to multi-patch editor (see below) Transmit multi: Send current multi-patch to K1 Copy to: Copy current multi-ptahc to other position. Select destination by clicking to the wished position Swap with: Swap current patch with another patch Cancel: Close and leave requester SINGLE-PATCH-EDITOR: -------------------- The single-patch editor is the heart of the K1-Librarian. All parameters of any sound are displayed and can be changed. Please refer to your K1 handbook for detailed informations about the different parameters. To edit a parameter do the following: Move mouse-pointer over the parameter you wish to change and press the left mouse button. A small window with a proportional gadget will appear. Now move the gagdet to the desired value. Leave the window by pressing the right (!) mouse button. The program will send the changed parameter in realtime to the K1. This means that you can press some keys on your K1 and hear directly the change of the selected sound. So you can immediately test your sound creation. The KS-curve and the VEL-curve are displayed graphically. They can be changed by clicking on the desired field. Warning: Don't change the single sound patch during editing a special sound. All sound parameters concern the K1 selected sound 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 required 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. This version uses the PRT-device. Last but not lest, the 'Rename' option allows you to change the name of the selected multi-patch. The gadgets under the editor block allows you to reset some parameters to default values: ZoneLow: Default: C-2 ZoneHigh: Default: G-8 Channel: Default: Ch. 1-8 Mode: Default: MIX Poly: Default: VR ERROR-MESSAGES: --------------- 'Can't open XXX.library': The program can not open the XXX.library. You should copy the required library to the LIBS: directory and then start the K1 Librarian again. 'Can't create midi destination', 'Can't create midi route destination', 'Can't create midi route source': One of these messages will appear if another program is running which uses and allocates the serial device, e.g. if your are running a midi sequencer. Finish all running programs which are using the serial device and then start the K1 Librarian. 'Can't open xxx-window', 'Can't open xxx-screen': One of these messages will appear if the program can't open a screen or a window. This can happen if there is to few chip memory available. Close other window of others tasks of save some chip memory. INPUT-HANDLER ------------- The program will launch an input handler. Its task is to check the inputevents for the combination of RIGHT SHIFT and BACKSPACE. If both keys are pressed the program's window or screen will be prompted to front. This is neccessary if you have "lost" the programs window. BUG-FIXES --------- K1 Librarian switched to multi-patch d8 when selecting effect number 1. Fixed in version 5.0 (Reported from David Ingebretsen, Salt Lake City) There was a small bug in the single-patch editor when changing the velcurve and the pressure on frequency parameters. Fixed in version 5.0. (Reported from David Ingebretsen, Salt Lake City) BUGS ---- There may be problems when running K1-Librarian and other midi software at the same time, 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 check if a K1 is connected to the system. But there seems to be a problem in the K1-check-routine. Sometimes the Librarian does not recognize a connected K1 and sends an error message. This bug seems to be fixed in version 3.5 or later. Perhaps there may be other smaller bugs. Please let me know if you think that you should found one. ******************************************************************************** ******************************************************************************** ********************************************************************************