--------------------------------------------------------------------- HOW TO USE Xaw interface of TiMidity++ Xaw interface of TiMidity prepares a GUI only with Athena Widget sets and Xt libraries that are standard toolkits of X Window System. * WHAT'S NEW int 1.3 - Imported shortcut key translations - Added Trace window including keyboard displaying - Enabled to configure resources of X - Supported Drag and Drop used on OffiX application - Added function to load and/or delete MIDI file entries - Enabled to modify some of extended option settings - Enabled to save the current playing lists into ~/.xtimidity - Menu and dialog messages were Internationalized - Resource files were attached * USAGE New Xaw interface has following file menu; LOAD Load a new MIDI file. SAVE CONFIG Save the current settings and modes e.g. shuffle, repeat, auto-start and auto-exit flags to ~/.xtimidity . HIDE/UNHIDE MESSAGES Toggles displaying status text widget showing messages. HIDE/UNHIDE TRACE Toggles displaying status of trace canvas. SHUFFLE Toggles shuffle flag. REPEAT Toggle repeat flag. AUTO-START Toggle auto-start flag. AUTO-EXIT Toggle auto-exit flag to exit or not after all songs are over. FILE LIST Popup the playing file list window. EXTEND MODES Popup the extend mode control window. ABOUT Information about Xaw interface of TiMidity++. QUIT terminate timidity. From ver.1.3, File Load and File List menues that enabled to add and/or delete playing list. You can append or delete arbitrary files from file browser. To play a file, you can select it by either of pull-down menu on the title bar or File List window. The shortcut key actions on each window are as follows:
[Enter] or [r] : Start Playing [Space] : Pause / Start Again [s] : Stop Playing [q] : Quit TiMidity++ [p] or [Left] : Previous File [n] or [Right] : Next File [v] or [Down] : Volume Down (10%) [V] or [Up] : Volume Up (10%) [Alt + N] : Load Files [Alt + S] : Save settings to ~/.xtimidity [Ctrl + M] : Hide/Show Messages [Ctrl + T] : Hide/Show Trace canvas [Ctrl + S] : Toggles Shuffle state [Ctrl + R] : Toggles Repeat state [p] or [Up] : Move the cursor to the previous file [n] or [Down] : Move the cursor to the next file [Right] : Move the cursor 5 lines backward [Left] : Move the cursor 5 lines forward [v] : Volume Down (10%) [V] : Volume Up (10%) [Enter] or [R] : Start Playing the selected file [d] : Delete the selected file entry [Space] : Pause / Start Again [s] : Stop Playing [q] : Quit TiMidity++ [c] : Close the window [c] : Close the window [q] : Quit TiMidity++ [Tab] : File or directory completion [Enter] : Select the directory entries. [Escape] or [CTRL]+[g] : Cancel and close the window [Ctrl-a] : Move the cursor to the top [Ctrl-e] : Move the cursor to the line-end [Ctrl-k] : Delete strings after the cursor From version 1.1, trace canvas is realized and renewed overall in 1.3. Specify the interface option flag 't' in command line like as 'timidity -iat' when you execute TiMidity(see timidity man page). You can see a funny movements of volume, expression, panning, pitchbending, reverb, chorus and voices et cetera of each channel on the trace canvas. Click left mouse button on the trace screen and you can toggle trace screen between 'pitchbend and instrument' or 'tonebank, reverb and chorus'. * INSTALLATION TiMidity++ uses Xaw3d by default while compiling when it exists on your system because GNU configure is employed. If you feel like to use Xaw, edit common.makefile manually to delete all of '-DXAW3D' definitions from CPPFLAGS and/or CFLAGS and correct -lXaw3d to -lXaw after configure. If you want to use Label Widget as before, make the following line enable at interface/xaw.h to remove /* */. #define WIDGET_IS_LABEL_WIDGET And make clean before build. If you are using X servers compiled without X_LOCALE on the system that doesn't support locale, rewrite the folloing line; #define I18N to '#undef I18N' before compiling TiMidity++. Although $(HOME)/.xtimidity will be regarded as an initial personal configuration file, you can rename it by correcting the line; #define INITIAL_CONFIG ".xtimidity" in xaw.h manually. !!! NOTE !!! Some resource files were attached to TiMidity++1.3.6 or later. If you create a resource file of another locale except English or Japanese, please mail it to Yoshishige Arai or to Masanao Izumo . After building TiMidity++, put TiMidity.ad into the resources directory such as; $(X11R6)/lib/X11/app-defaults And put TiMidity-uj.ad, which is the Japanese-EUC resource file into; $(X11R6)/lib/X11/$(LANG)/app-defaults For example, those are as follows if the Japanese-EUC locale of your system is ja_JP.EUC as FreeBSD; # cp TiMidity.ad /usr/X11R6/lib/X11/app-defaults/TiMidity # cp TiMidity-uj.ad /usr/X11R6/lib/X11/app-defaults/ja_JP.EUC/TiMidity * RESOURCES Application class name is 'TiMidity', so specity resources in .Xdefaults or .Xresources in your home directory as follows for example; TiMidity*textbackground: LemonChiffon TiMidity*background: PeachPuff1 TiMidity*menubutton: goldenrod TiMidity*buttonbackground: gold TiMidity*labelfont: -adobe-helvetica-bold-o-*-*-14-*-75-75-*-*-*-* typical resources are listed below. Name Class Default ---------------------------------------------------------- bitmapDir BitmapDir "DEFAULT_PATH/bitmaps" directory bitmaps is put. arrangeTitle ArrangeTitle False Show MIDI titles on the title bar of the main window. background Background gray65 Background color of the main window. menubutton MenuButtonBackground #CCFF33 Menu button color. textbackground TextBackground gray85 Background color of Text Widget. togglebackground ToggleBackground MediumBlue Background color of toggle buttons. buttonbackground ButtonBackground gray76 Background color of command buttons and other transient windows. tracebackground TraceBackground gray90 Background color of trace canvas. labelfont LabelFont -adobe-helvetica-bold-r-*-*-14-*-75-75-*-*-*-* Label widget font. volumefont VolumeFont -adobe-helvetica-bold-r-*-*-12-*-75-75-*-*-*-* Volume Label font. tracefont TraceFont -*-*-medium-r-normal--14-*-*-*-*-*-*-* Trace window font. textfontset TextFontSet -*-*-medium-r-normal--14-*-*-*-*-*-*-* Text font for message box and so on. ttitlefont TtitleFont -*-fixed-medium-r-normal--14-*-*-*-*-*-*-* MIDI title font at the bottom of trace window. Note that you have to specify FontSet style for font resources of TiMdifity*textfontset and/or TiMidity*ttitlefont if you are using executables compiled with -DI18N on the internationalized X server. * REPORTS Please send problems concerning Xaw interface, feature requests, bug reports or comments to either Yoshishige Arai or to the TiMidity mailing list . Regards, Yoshishige Arai