Begin
File:           keypad.tgz
Description:    A keypad utility for touch-screen applications.
Keywords:       touch touchscreen gui keypad numpad text entry
Version:        1.1
Entered-date:   August 6, 1998
Author:         Bruce Fletcher
Ported-by:
Original-site:
Copying-policy: Go crazy!
Supplemental:

Note from freesoft: This compiles fine under Photon1.12.

This is a Photon utility which allows you to input alphanumeric
characters into any Photon GUI without a keyboard.  The utility
works by generating Photon keypress events and injecting them into
the Photon event stream, so whichever widget currently has focus
will receive the entered characters.  Keypad supports upper and
lower case letters, numbers, some symbols, plus left/right arrows,
backspace, delete, and enter.  Printable characters can be changed
simply by changing the buttons' text strings in PhAB.  There is
a corresponding numpad utility for strictly numeric text entry.

There is also a small interface library with two functions,
show_keypad() and hide_keypad(), which allow you to control the
utility from within your application.

Keypad has two operating modes.  In auto-hide mode, keypad quits
as soon as 'enter' is selected on the keypad.  Otherwise, keypad
stays up until it is shut down by hide_keypad(), slay, kill, etc.

Keypad can be moved around on the screen by the user, and it will
remember from one time to the next where it was placed on the
screen.  To do this, keypad keeps a small configuration file in
"$HOME/.photon/.keypad".  This behaviour can be overridden with
two command line options (which are also available as arguments
to show_keypad()).  You can specify a location for the dialog
to appear, and/or you can specify a rectangle (presumbably the
bounds of the text-box being focused) for the keypad to avoid.

The file input.c in keypad/examples contains generic callback
functions which can be used to place the dialog near a text-box
by simply adding an activate callback of input_alpha@input.c
on the text-box.

There is no version 1.0 of keypad; the version number 1.1 indicates
common functionality with 1.1 of the corresponding numpad utility.

Some notes on using keypad:
- For show_keypad() to work, keypad must be accessible in the
  $PATH for your application.

- Keypad is probably more convenient to use if your text-entry
  fields have the Pt_TEXT_AUTO_HIGHLIGHT text-flag enabled.

- Keypad is scaled for use on a 1024*768 or 1280*1024 display.
  Depending on your application, you might want to re-scale it.

- To use show_keypad() and hide_keypad(), you need the keypad.h
  header file in keypad/include and the keypadf.lib library in
  keypad/lib.  The keypad binary gets copied to keypad/bin.  If
  you want to move these files, you will have to re-target some
  variables in keypad/src/default/Makefile.
End