home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 519a.lha / K1-II_Librarian_v4.8 / K1.doc.pp / K1.doc
Text File  |  1991-06-09  |  12KB  |  264 lines
  1. ================================================================================
  2. =                               K1-II Librarian                                =
  3. =                            Version 4.0 or higher                             =
  4. =                                                                              =
  5. =                        Written in 1990/91 and (C) by                         =
  6. =                                Andreas Jung                                  =
  7. =                              Klosterstrasse 21                               =
  8. =                              D-6602 Dudweiler                                =
  9. =                         Federal Republic of Germany                          =
  10. =                                                                              =
  11. =                            All rights reserved !                             =
  12. ================================================================================
  13.  
  14. COPYRIGHT NOTICE/DISTRIBUTION
  15. -----------------------------
  16. This program is not public domain.  All rights are reserved to the author.  But
  17. the program may be freely distributed for noncommercial use.  Commercial use or
  18. commercial  distribution  of  any  kind  requires the written permission of the
  19. author.   If  you  want  to distribute this program in a PD-library, you should
  20. write  to  me  and you will get a special release version for your library.  If
  21. you  want  to contact me, please enclose any form of payment for package, disks
  22. etc.   Suggestions, bug-reports and donations of any kind (except letter bombs)
  23. are always welcome.
  24.  
  25.  
  26. OVERVIEW:
  27. --------
  28. The  K1-Librarian  is  a  program  for use with the Kawai K1-II synthesizer via
  29. MIDI.  The current version includes a bankloader for single- and multi-patches,
  30. a  singlepatch-editor,  a  multipatch-editor and support for the effect-session
  31. and K1 controllers.  The program is totally mouse controlled.  All are selected
  32. with  the  mouse.   It  does not use pulldown menus for a most efficient use of
  33. this program.
  34.  
  35.  
  36. REQUIREMENTS:
  37. -------------
  38. First  you  need  a Kawai K1-II synthesizer and a MIDI-interface connected with
  39. your Amiga.  I do not know if my program works with the older K1 models; let me
  40. know  !   It  should  work with any Amiga with Kickstart Version 1.2 or higher.
  41. K1-Librarian  was  developed  under  Kickstart  1.3  with  Aztec-C  5.0 and was
  42. successfully  tested  under  Kickstart  2.0  The K1-Librarian should run on any
  43. Amiga with at least 512 KB.
  44.  
  45. Ensure that the following files are in right directories:
  46.  
  47.                                LIBS:arp.library
  48.                                LIBS:req.library
  49.                                LIBS:midi.library
  50.                              LIBS:diskfont.library
  51.                                LIBS:icon.library
  52.                                  L:ram-handler
  53.                                 L:port-handler
  54.                               DEVS:printer-device
  55.                               DEVS:serial.device
  56.                        DEVS:printers/<printerdriver>    
  57.                             
  58.  
  59. CREDITS:
  60. --------
  61. First  I  want to thank Michael Balzer, the author of the K1-Editor released on
  62. AmigaLibDisk  332  (by Fred Fish).  The sources of his editor were very helpful
  63. during  the  development of this program.  He also send me the documentation of
  64. the Req-Library.
  65.  
  66. Also   thanks   to   Colin   Fox   of  Pyramid  Designs  and  Bruce  Bawson  of
  67. CygnusSoft-Software  for  the fine Req-Library and to people of Pregnant Badger
  68. Music which wrote the Midi-Library.
  69.  
  70. Thanks  to  Timm  Martin  for  the  release  of the sources of his sleepy mouse
  71. pointer and the input-device routine.
  72.  
  73. Thanks to Fred Fish for his engagement in Amiga-PD.
  74.  
  75.  
  76. INSTALLATION:
  77. -------------
  78. First copy the files in the drawer LIBS to your work-disk.  Ensure that all the
  79. files  above  are  in  right  drawer.  Now make new drawer called KAWAI on your
  80. (hard)disk and make a assign to it:        ASSIGN KAWAI:  KAWAI 
  81. Next  you should copy the drawers SOUNDS, BANKS, DUMP and MULTI to the assigned
  82. directory  KAWAI:   I should be enough.  The K1-Librarian can be started either
  83. from the CLI or from the workbench.  The following CLI options are recognized:
  84.  
  85.         'K1 s' - open a custom screen
  86.         'K1 l' - open a interlaced custom screen
  87.         'K1 g' - get single- and multi-patch dump
  88.         'K1 i' - initalize all patches by default
  89.  
  90. If you want more than on option, they must by seperated by a blank:
  91.       e.g. 'K1 l g' - open interlaced custom screen and get single/multi-patch
  92.  
  93. Workbench support: The following tool-types are recognized:
  94.  
  95.         SCREEN=ON/OFF
  96.         LACE=ON/OFF
  97.         GETDUMP=ON/OFF
  98.         INITIALIZE=ON/OFF
  99.         MULTIDIR=directoryname
  100.         BANKDIR=directoryname
  101.         DUMPDIR=directoryname
  102.         SOUNDDIR=directoryname
  103.         DEFAULTDUMP=dumpname
  104.  
  105. K1-Librarian  will open an interlace screen if it is run on a ntsc amiga.  This
  106. is  nessecarry  because  the  program  needs  a  lot  of  space  to display the
  107. synthesizer informations.
  108.  
  109.  
  110. OTHER MIDI SOFTWARE
  111. -------------------
  112. K1-Librarian uses the Midi-Library.  All programs which use this library may be
  113. started  at  the  same  time.   But there are some programs that can not be run
  114. simultaneously  with  K1-Librarian.   One  program  is  e.g.   the Steinberg 24
  115. sequencer.  On the other side Bars & Pipes seems to work without problems.
  116.  
  117.  
  118. CHANNEL-NUMBERS:
  119. ----------------
  120. When  you  start  the  Librarian, it will check on which midi channel the K1 is
  121. sending.  It is not neccessary to select a special transmit or receive channel.
  122. The Librarian automatically recognizes the receive channel and remembers of it,
  123. when it will send some data to the K1. Therefore you not change the receive
  124. channel of the K1 because there may be a malfunction of the Librarian.
  125.  
  126.  
  127. GETTING STARTED:
  128. ----------------
  129. When  you run K1-Librarian, it will open a window with a field of 4 columns and
  130. 16  rows.   This  field  represents the 64 single patches of the K1-II.  In the
  131. lower half of the window there is the control with the following options:
  132.  
  133.     Load Bank 1/2:     Load a file with a soundbank (32 single patches) 
  134.     Save Bank 1/2:     Save current bank from Amiga to disk
  135.     Get Bank 1/2:      Get bankdump from K1
  136.     Send Bank 1/2:     Send current bank to K1
  137.     Save Sounds 1/2:   Save the sounds of the current bank to disk. They will
  138.                        be put in the directory KAWAI:SOUNDS
  139.     Load/Send as 1/2:  A bankfile is directly send from disk to K1 without
  140.                        changing the current banks of the K1-Librarian.
  141.     About:             This option will open a requester with informations
  142.                        about my program.
  143.     Iconify:           The program's window will be iconified when you select
  144.                        this option. The window can be resized by activating the 
  145.                        iconified window and pressing the right mousebutton. 
  146.     1-16:              Select a program of the effect session (only K1-II)
  147.         
  148.  
  149. The  field MULTI in the right upper corner switches to the multi-patch section.
  150. Here  we  have  a  field  for  the  32  multi-patches.   Following  options are
  151. available:
  152.  
  153.     Load Multi:        Load multi-patch from disk
  154.     Save Multi:        Save multi-patch to disk
  155.     Get Multi:         Get multi-patch from K1
  156.     Send Multi:        Send multi-patch to K1
  157.     Load Dump:         A dump consists of two single-patches banks and one
  158.                        multi-patch-bank.
  159.     Save Dump:         Save dump to disk
  160.     Get Dump:          Get complete dump from K1
  161.     Send Dump:         Send current Librarian banks as dump to K1
  162.     Colors:            Opens a color requester to change the screen colours.
  163.                        The colours are saved to disk. 
  164.     Init all:          All single- and multi-patches will be reseted to the 
  165.                        factory patches 'Single K-1' and 'Multi-K1'
  166.     Change screen:     Toggle between workbench and custom screen 
  167.     Controllers:       Show some gadgets for master K1-II controlls e.g. 
  168.                        mastervolume, pitchbender and modulation wheel        
  169.  
  170. The proportional gadget on the right side changes the master volume of the K1.
  171.  
  172.            
  173. USE OF MOUSE:
  174. -------------
  175. Move  the  mousepointer  to field with a single- or multi-patch.  Now press the
  176. right mouse button.  The current patch will be transmitted to the K1.  When you
  177. press  the left button over a single-patch or multi-patch, a small requester is
  178. opened with the following possiblities:
  179.  
  180.  Single-Patches:
  181.  ---------------
  182.     Load sound:        Load sound from disk
  183.     Save sound:        Save sound to disk        
  184.     Edit sound:        Switch to single-patch editor (see below)
  185.     Transmit sound:    Send current sound to K1
  186.     Copy to:           Copy current patch to other position. Select
  187.                        destination by clicking to the wished position
  188.     Swap with:         Swap current patch with another patch
  189.     Cancel:            Close and leave requester    
  190.  
  191.  Multi-Patches:
  192.  --------------
  193.     Edit multi:        Switch to multi-patch editor (see below)
  194.     Transmit multi:    Send current multi-patch to K1
  195.     Copy to:           Copy current multi-ptahc to other position. Select
  196.                        destination by clicking to the wished position
  197.     Swap with:         Swap current patch with another patch
  198.     Cancel:            Close and leave requester    
  199.  
  200.  
  201. SINGLE-PATCH-EDITOR:
  202. --------------------
  203. The  single-patch  editor  is the heart of the K1-Librarian.  All parameters of
  204. any  sound  are displayed and can be changed.  Please refer to your K1 handbook
  205. for  detailed informations about the different parameters.  To edit a parameter
  206. do the following:  Move mouse-pointer over the parameter you wish to change and
  207. press  the  left  mouse button.  A small window with a proportional gadget will
  208. appear.   Now  move  the  gagdet  to  the  desired  value.  Leave the window by
  209. pressing the right (!) mouse button. 
  210.  
  211. The  program will send the changed parameter in realtime to the K1.  This means
  212. that  you  can  press  some keys on your K1 and hear directly the change of the
  213. selected sound.  So you can immediately test your sound creation.  The KS-curve
  214. and  the  VEL-curve are displayed graphically.  They can be changed by clicking
  215. on the desired field.
  216.  
  217. Warning:   Don't  change the single sound patch during editing a special sound.
  218.            All sound parameters concern the K1 selected sound
  219.  
  220.  
  221. MULTI-PATCH EDITOR:
  222. -------------------
  223. The multi-patch editor gives you the abelity to edit the multi-patches.  Please
  224. refer  to  your  K1  handbook for detailed informations.  All parameters can be
  225. changed  by  clicking  in  the  required field.  Either the field contents will
  226. change  or  a  window with a proportional gadget will appear.  In this case you
  227. can leave this window by pressing the right(!) button.
  228.  
  229. The  proportional  gadget  on  the  right  side  will change main volume of the
  230. current patch.
  231.  
  232. You can leave the editor by clicking in the 'OK' field.  The current parameters
  233. are  immediately send to the K1.  Clicking to the 'Chancel' field will have the
  234. effect  that  all changes are ignored and the old parameters are restored.  The
  235. 'Print'  option  will  print  the parameter table to you printer.  This version
  236. uses  the  PRT-device.   Last  but not least, the 'Rename' option allows you to
  237. change the name of the selected multi-patch.
  238.  
  239.  
  240. BUGS
  241. ----
  242. There  may be problems when running K1-Librarian and other midi software at the
  243. same  time, especially when you are trying to interchange SysEx-Data from or to
  244. K1.   When  you request a single- or multi-patch dump, the Librarian will check
  245. if  a  K1  is  connected to the system.  But there seems to be a problem in the
  246. K1-check-routine.   Sometimes  the  Librarian does not recognize a connected K1
  247. and  sends  an  error  message.   This  bug seems to be fixed in version 3.5 or
  248. later.
  249.  
  250. Perhaps  there may be other smaller bugs.  Please let me know if you think that
  251. you should found one.
  252.  
  253.  
  254. GREETINGS:
  255. ----------
  256. Greetings to the following persons, firms or groups:
  257.     NICOC, GSE, D.S., M.T., Commodore, Kawai
  258.  
  259.  
  260.  
  261. ********************************************************************************
  262. ********************************************************************************
  263. ********************************************************************************
  264.