1 files changed, 76 insertions, 0 deletions
diff --git a/lib/timidity/doc/C/README.xskin b/lib/timidity/doc/C/README.xskin
new file mode 100644
index 0000000000..33b72ed10c
--- /dev/null
+++ b/lib/timidity/doc/C/README.xskin
@@ -0,0 +1,76 @@
+------------------------------------------------------------------
+This document describes about TiMidity++ skin interface.
+
+ Skin interface is the front-end of TiMidity++ to allow users to
+control TiMidity++ with funny GUI. The face of GUI is changable
+by using "skin data" of WinAmp / x11amp.
+
+
+* SETTING UP THE X-SKIN INTERFACE *
+
+ First, choose a skin data to use and place it on some directory.
+And set this path to the environment variable "timidity_skin"
+ e.g, If your favourite skin data (*.bmp) is placed on 
+ ~/.x11amp/Skins/timidity/ :
+
+% setenv timidity_skin ~/.x11amp/Skins/timidity/                 (csh)
+$ timidity_skin=~/.x11amp/Skins/timidity ; export timidity_skin  (sh)
+
+ If your skin data archive file is on /dos/programs/winamp/skins/winamp.zip: 
+
+% setenv timidity_skin /dos/programs/winamp/skins/winamp.zip
+$ timidity_skin=/dos/programs/winamp/skins/winamp.zip ; export timidity_skin
+
+ Only one skin can be specified. There are no selector of skin data.
+ Since default skin is not prepared, if the environment variable isn't 
+specified or the data specified is broken, TiMidity++ won't boot.
+
+ This skin interface requires 10 BMP files for skin data such that: 
+
+ main, titlebar, playpaus, cbuttons, monoster,
+ posbar, shufrep, text, volume, number
+
+ If your data losts some of these files, please borrow the corresponding
+data from other skin data.
+ In case the data has viscolor.txt, the color of spectrum analyzer is
+determined by this file. If not, the default colors are used.
+
+
+* BOOTING TiMidity++ *
+
+ To use skin interface, boot TiMidity++ with command-line option -ii(tv).
+After initializing of internal of TiMidity++, a window looks like WinAmp :)
+will raise. 
+
+
+* USAGE OF INTERFACE *
+
+ Features of this interface now available are:
+
+  Prev/Play/Pause/Stop/Next/ Shuffle/Repeat/ Volume/ Exit 
+
+with every corresponding buttons.
+ Clicking the area of displaying elapsed-time changes the contents of
+this area as elapsed-time / remained-time.
+ Clicking the area below the time displaying area changes the contents of
+this area as spectrum analyzer. If you want to display the spectrum analyzer,
+you should compile TiMidity++ with configure option --enable-spectrogram.
+
+ You can move interface's window by grabbing any place of this window.
+
+ To exit this interface, click the little button on right corner.
+
+
+* BUG? *
+
+ Text displaying area can display only English, digits and some graphical
+characters. Any of multi-byte character won't displayed.
+ Cannot set panpot, Equalizer and PlayList of TiMidity++.
+ There no effect by clicking the eject button.
+ Cannot iconize, smalling.
+
+
+ YOU CAN USE THIS INTERFACE AT YOUR OWN RISK.
+
+                              Daisuke Nagano <breeze_geo@geocities.co.jp>
+                      http://www.geocities.co.jp/Playtown/4370/index.html