Begin
File:           numpad1-1.tgz
Description:    A numeric 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 numeric
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 numbers.  A corresponding keypad utility
is available for supporting full alphanumeric keyboard input.

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

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

Numpad 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, numpad keeps a small configuration file in
"$HOME/.photon/.numpad".  This behaviour can be overridden with
two command line options (which are also available as arguments
to show_numpad()).  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 numpad to avoid.

The file input.c in numpad/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.

Version 1.1 of numpad fixes a bug where multiple copies of
the utility could be spawned if show_numpad() was called more
than once in quick succession.  It also adds support for placing
numpad at specific locations and for avoiding specified areas.

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

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

- Numpad 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_numpad() and hide_numpad(), you need the numpad.h
  header file in numpad/include and the numpadf.lib library in
  numpad/lib.  The numpad binary gets copied to numpad/bin.  If
  you want to move these files, you will have to re-target some
  variables in numpad/src/default/Makefile.
End