====================================================================
		AWE VIRTUAL KEYBOARD ver.0.1.3
====================================================================

* GENERAL NOTES

This is a virtual keyboard for AWE driver.  It's a simple fake of
a MIDI keyboard on X-windows system.  Enjoy a music with your mouse
and "computer" keyboard :-)

The program requires Tcl7.5/Tk4.1 libraries and, of course, AWE driver
ver.0.4.2c or newer on your linux or other system.  The older version
of awedrv will not work properly.  Since the most of the part is
written by Tcl/Tk script, it'll be no so difficult to apply this
program to other sound systems.

* INSTALLATION

To install this program, edit Makefile and set the installation
directory in INSTALL_DIR, and make it.  You need to install the
program unless the installation directory is set to the current
directory.

If you have a comple error about undefined symbol AWE_PLAY_MULTI or
AWE_MD_TOGGLE_..., your awe driver may be obsolete.  Please update to
the latest version (currently ver.0.4.2c).

* USAGE

Load the soundfont via sfxload utility before using this program.
Then, just start vkeybd.  The optional argument is a soundfont file
which is currently loaded on AWE driver.  If the argument is omitted,
the default font file "synthgm.sbk" is used.

At beginning, vkbd reads the specified font file to obtain the preset
list in it.  The preset list will appear when "Program" toggle button
is on, and you can select your favorite sound from the list.

The visible three octave keys start from the key defined in the "KEY"
scale bar (as default 48, C4).  You can turn on and off the sound by
clicking the mouse button on the virtual keyboard.

Each key is mapped on your computer keyboard from 'z' to '\'.
To use the computer keyboard, you should turn off auto repeat on your
X display via "xset -r".
The key assignment may be different from mine.  In such a case, edit
the Tcl script (vkeybd.tcl) and change the assignment as you like.
The key map is defined as a list of the element which consists of key
symbol and midi number.

The "SeqOff" button is ued to release the sequencer device from
virtual keyboard.  It's convinient to pause a little time for using
another program like MIDI player.

The "VEL" scale bar is used to change the velocity of the sound.
The right button from SeqOff is a controller selection button.
When this button is pressed, a pull-down menu appears, and you can
select the control event to be changed by the scale bar in the right
side of this button.  The "reset" item is used to reset all the
controller values to the default ones.

The "Chorus" and "Reverb" buttons are menu buttons to choose the
arbitrary chorus and reverb modes, respectively.
The scale bar in the right side of these buttons represents a virtual
pitch wheel.  "ClrPitch" button is used to reset the wheel position to 
normal.

--
Takashi Iwai  <iwai@dragon.mm.t.u-tokyo.ac.jp>
