home *** CD-ROM | disk | FTP | other *** search
/ The Best of Windows 95.com 1996 September / WIN95_09964.iso / midi / tim3202i.zip / README.tk < prev    next >
Text File  |  1996-05-20  |  4KB  |  114 lines
  1. ---------------------------------------------------------------------
  2. Note: These modifications are now integrated into the sources, so you
  3. don't need to patch them, just uncomment the appropriate lines in
  4. the Makefile.    ..tt
  5. ---------------------------------------------------------------------
  6.  
  7.  
  8. This is the README file of TkMidity Ver.1.3, Tcl/Tk interface for
  9. TiMidity MIDI Converter/Player.
  10.  
  11. TkMidity realizes the Tk interface panel communicating with true
  12. TiMidity program. By using Tk, you can enjoy a beautiful Motif-like
  13. window without Motif libraries.
  14.  
  15.  
  16. * CONTENTS
  17.  
  18. This archive contains the following files:
  19.  
  20. README.tk    - this file
  21. tkmidity.patch    - a small patch to timidity-0.2h including fixes for
  22.           tiny bugs 
  23. tk_ctl.c    - a new source file for tk-interface
  24. tkmidity.ptcl    - main tcl/tk source to be preprocessed
  25. tkpanel.tcl    - main control panel tcl/tk script
  26. browser.tcl    - file browser
  27. misc.tcl    - miscellaneous subroutines
  28. tkbitmaps/*.xbm    - bitmap files for TkMidity
  29. tkmidity.ad    - (gray background) resources for TkMidity
  30.  
  31.  
  32. * INSTALLATION
  33.  
  34. - Extract all files on timidity 0.2h source directory
  35. - Apply tkmidity.patch
  36. - Modify Makefile (especially check the wish program name in Makefile)
  37. - Just "make" it.
  38. - Install it by "make install".
  39. - Enjoy!
  40.  
  41.  
  42. * USAGE
  43.  
  44. There are four modes newly featured to TiMidity; repeat, shuffle,
  45. auto-start and auto-exit modes. Repeat mode plays musics after all
  46. files are finished repeatedly. Shuffle mode means the random pick-up
  47. playing. When Auto-start is on, the TkMidity begins playing music as
  48. soon as program starts. Auto-exit means to quit TkMidity automatically
  49. after all songs are over. Each setting can be saved by Save Config
  50. menu.
  51.  
  52. You can change the display configuration in Displays menu. This
  53. configuration also can be saved on the start-up file by Save Config
  54. menu.
  55.  
  56. The version 1.3 supports File Open/Close menus, and direct keyboard
  57. control. You can append arbitrary files from file browser. The
  58. shortcut key actions are as follows:
  59.  
  60.     [Enter]        : Start Playing
  61.     [Space]        : Pause / Start Again
  62.     [c]        : Stop Playing
  63.     [q]        : Quit TkMidity
  64.     [p] or [Left]    : Previous File
  65.     [n] or [Right]    : Next File
  66.     [v] or [Down]    : Volume Down (10%)
  67.     [V] or [Up]    : Volume Up (10%)
  68.     [F10]        : Menu Mode
  69.     [Alt]+[Any]    : Select Each Menu
  70.  
  71.  
  72. * PROGRAM NOTES
  73.  
  74. This version supports both Tcl7.4/Tk4.0 and TclX7.3/Tk3.6 with
  75. addinput. Unfortunately random function is omitted in the normal Tcl
  76. library, I wrote a simple hack to invoke bash from the tcl script.
  77. But this dirty trick should cause an overhead. If you know more smart
  78. solution, please teach me. 
  79.  
  80. If you have only Tcl7.3 base wish (like included in Slackware 2.x),
  81. the extended Tcl (TclX) and addinput patch are required to handle i/o
  82. between tcl and timidity. Fortunately in the normal Linux distribution
  83. by Slackware, this patch is already included. If you don't have this
  84. patch, please get it via a-ftp, etc. Since Tcl7.4 base wish has
  85. another function to handle i/o, the patch above is not necessary.
  86. The original addinput patch can be obtained from:
  87.     ftp.neosoft.com:~ftp/pub/distrib
  88. or 
  89.     harbor.ecn.purdue.edu:~ftp/pub/tcl/extensions
  90.  
  91.  
  92. * TROUBLE SHOOTING
  93.  
  94. - The program says many RC_UNKNOWN ... and dies.
  95.  
  96. Possibly, the trouble of communication between TiMidity and Tk
  97. interpreter. Please check the wish program name in your Makefile.
  98. The default is "wishx" (not "wish").
  99.  
  100. Start the Tk panel directly from command line as:
  101.     % wishx -f /usr/local/lib/timidity/tkmidity.tcl
  102. The Tk window will appear and tell a words "NEXT" on console.
  103. Then you can start TiMidity successfully.
  104.  
  105. - Tk panel appears, but "Pipe Broken" message pops up.
  106.  
  107. This occurs when the non-existing file is selected to play. 
  108. The ver.1.3 script verifies the existence of the file before pass to
  109. TiMidity, but occasionally this could happen...
  110.  
  111.  
  112.         Takashi Iwai    <iwai@dragon.mm.t.u-tokyo.ac.jp>
  113.                 <http://bahamut.mm.t.u-tokyo.ac.jp/~iwai/>
  114.