Audrey Virtual Keyboard
			   
			    Version 1.1 9/12/2001
			   
			      by Keith Davidson

			      

Introduction
------------
   This utility simulates the Audrey keyboard using a virtual keyboard 
   that you interact with via the touch screen.  It is based on the keypad
   example found on the QNX web site.  It also allows entering of keys (such
   as ctrl, alt, pgup, etc) that do not exist on the Audrey keyboard.  In
   particular the home, end, pgup, and pgdn keys are handy for web browsing.

   I created this so the Audrey could be fully functional without the
   keyboard.  As far as I know, this is the first application written
   explicitly for the Audrey.  I've never used QNX before but this application
   was pretty easy to develop using the excellent PhAB tools.  Hopefully
   others will take the plunge and we will see many useful Audrey specific
   apps!

   I dedicate this program to the victims and survivors of the tragic
   terrorist attacks on September 11, 2001.

License & Disclaimer
--------------------
   Use this utility for any purpose you want.  I am not responsible for any
   damage it may cause to your Audrey, you, your pet, or anything else.


Installation
------------
   o This is compiled with QNX_RTP 6.0 so you *DO NOT* need any of the 6.1
     libraries.  The executable is only 27K.
   o You will need an Audrey with the shell hack.  If you don't know what
     that means, go study up at http://www.audreyhacking.com and come back
     when you have a shell on your Audrey.
   o From the shell (you do not need to be in a root shell):
      - cd /nto/photon/bin
      - use ftp to get the file "keyboard" from this distribution
      - chmod +x keyboard
   o You could just run it from the shell but it is much nicer to setup a
     button in Audrey Options to activate the keyboard.  See 
     http://www.demark.org/audrey/btns for more details on this procedure.
      - ftp the 2 .gif files from this distribution into /kojak/img/eng/config
      - Use vi to edit /kojak/SystemPanel.init
      - Add the following line to the end of the file
         ,keyboard_button.gif,launch,/nto/photon/bin/keyboard
      - Save the file
   o You should be able to run the keyboard from Audrey Options now
   o If you are brave, you can add it to your startup configuration.  Since
     people have been known to render their Audreys lifeless doing this,
     you will have to figure out how to do this on your own.

Useage
------
   Hopefully it is pretty obvious!  The few things that may not be:

   o Keys entered with the keyboard go to the window or field that has the
     focus.  Basically tap where you want the characters to be sent and then
     tap away at the keyboard.
   o You can click the small arrow in the title bar to minimize the keyboard-
     perfect for having it be quickly available without taking up valuable
     screen space!
   o The Next Win button sends an Alt-F3 sequence which pushes the window with
     the focus beneath other windows.  It works great for pterms but some of
     the built in Audrey apps ignore it.
   o You can use the -p option to specific a startup position (e.g. "-p20,20")


Version History
---------------
   Version 1.1 - Totally new version written with the appbuilder tool and 
                 using PhEventEmit() to push characters into the keyboard
		 buffer.
   Version 1.0 - Initial JavaScript version (I was hoping to avoid diving
                 in and doing it the right way)


Bugs
----
   Hopefully there are none but I have not done a lot of testing so there
   might be a few lurkers (especially since this is my first QNX/Photon app).
   If you stumble across a bug, send the information to reproduce it to
   kbdsp - @ - hotmail.com.


ToDo
----
   o I can't get the snapshot/copy/paste keys working.  They seem to map to
     Alt-F# sequences but when I send those the Audrey simply ignores them.
     (well actually the window manager picks them up and pushes the current
     window behind the others, tries to close the window, etc.  If anyone
     can offer insight here, please contact me at kbdsp - @ - hotmail.com
     
   o Cleanup the source and release it.
   
   o My 12 year old son made the icons and I think he did a great job,
     however, if someone would like to redo the text in Photoshop so they
     are consistent with the various other icons available that would be
     great!