home *** CD-ROM | disk | FTP | other *** search
/ Audio 4.94 - Over 11,000 Files / audio-11000.iso / msdos / midi / k1utl / k1utl.doc < prev    next >
Text File  |  1990-03-05  |  5KB  |  92 lines
  1.                   K1UTL.EXE
  2.  
  3.             A KAWAI K1 Patch-File Utility
  4.  
  5.  
  6. Introduction:
  7.  
  8.   About three months ago, I bought my first synthesizer--probably not my
  9. last--a Kawai K1m.  Shortly thereafter, I discovered a wealth of sounds for
  10. it on Compuserve.  These, I learned, were in a binary format called MIDIEX.
  11. Some contained single patches, some entire banks of 32 patches, and some had
  12. three sets of banks corresponding to all the internal (or external) K1
  13. sounds.
  14.   I figured that studying how people created these sounds would teach me more
  15. about how to use my synthesizer.  The problem is that reading a binary dump
  16. is slow and decoding the parameters, one at a time, from the K1's window
  17. isn't much faster.  I decided to write a utility that would let me see all
  18. the details at once of a patch contained in one of those files, on the screen
  19. or on paper.  This is it.
  20.  
  21.  
  22. User instructions:
  23.  
  24.   Type "K1UTL" at the MS-DOS prompt and you will be shown a screen with some
  25. copyright and identification information.  Press any key to continue.
  26.  
  27.   The program will then ask for a file name until you type a valid name or
  28. until you press ENTER without typing any other characters.  ENTER alone will
  29. cause the program to exit.  K1UTL does some sanity checking to make sure it
  30. understands the file format.  It has been tested on things like CARD1.K1 and
  31. K1S1.MEX and likes them just fine.
  32.  
  33.   K1UTL next displays the patch names found in the first (or only) bank of
  34. sounds in the file.  Move the cursor among these names using the four arrow
  35. keys.  Select any patches for display, or cancel selections, by pressing the
  36. spacebar when the cursor is on that patch name.  Selected patch names are
  37. displayed with a highlight.  When the screen is first displayed, no patches
  38. are selected, but, as a short cut, the F10 key can be used to select all
  39. patches in the current bank.  Press ENTER to finish making selections.  If
  40. there are no highlighted patch names when you press ENTER, K1UTL will go on
  41. to the next bank of sounds or will exit if there are no more banks.
  42. Pressing the ESCAPE key will cause the program to exit.  For a file
  43. containing only one patch, K1UTL will skip this step, select the lone patch,
  44. and go directly to the ouput options screen described next.
  45.  
  46.   The next screen allows you to pick options for the detailed display of the
  47. patches.  Output may be directed to the screen or a printer.  Use the
  48. spacebar to toggle your choice.  Press ENTER or the down-arrow to confirm
  49. your choice.  If you pick "Screen", the detailed patch display begins.  If
  50. you confirm "Print" as your choice, the cursor moves to a field that lets you
  51. pick what device will be used for printing.  Use the spacebar to select from
  52. options LPT1, LPT2, LPT3, COM1, COM2, and "File".  Once again, ENTER or
  53. down-arrow is used to confirm the selection.  The cursor next moves to a
  54. field where you can use the spacebar to pick the number of patches (1 or 2)
  55. that should appear on each printed page.  Use ENTER or down-arrow to
  56. confirm.  For any of these fields, you can press the ESCAPE key to abort
  57. detailed display of the current bank of sounds.  If "File" was picked as the
  58. device, the cursor moves to a field where you can type the name of an output
  59. file.  Pressing ENTER alone causes detail output to go to the screen.
  60.  
  61.   After any screen display of patch details, you can press ESCAPE to stop
  62. the program or any other key to continue to the next selected patch.
  63.  
  64.  
  65. Hardware:
  66.  
  67.   I've run this program on a Compaq 386 with VGA and on a 286 no-name with
  68. the EGA Wonder card and a monochrome display.  Since it just uses text mode
  69. programming, I can't think of any reason that other displays shouldn't work.
  70. I've re-compiled the version I'm uploading to generate only 8086 code, but
  71. I have no way of testing on one of those machines.  The printer output is
  72. just ASCII text and shouldn't cause problems.
  73.  
  74.  
  75. Futures:
  76.  
  77.   This is really open.  I'd like to add mouse support, but I don't consider
  78. it critical.  I expect to add an option that will let me pull one patch out
  79. of a bank and save it in a format that I can then load into Cakewalk.  In
  80. my most ambitious moments, I've considered turning it into a real, live
  81. editor/librarian.  But don't hold your breath, please.
  82.   If you're reading this, consider yourself a beta-tester.  Any bug reports,
  83. comments, or suggestions for enhancement are welcome.
  84.  
  85.  
  86. Salutations:
  87.  
  88.   Good luck.  I hope you enjoy the program.  I intend to.
  89.  
  90.  
  91.         Phillip Mills -- 71521,2540
  92.