# $Id: README,v 1.1.1.1 2004/03/09 15:36:16 clif Exp $
# $Log: README,v $
# Revision 1.1.1.1  2004/03/09 15:36:16  clif
# The initial TkReplay from Crowley's website.
#
# Revision 1.2  1996/07/31  16:24:01  crowley
# This is the 1.1 revision of TkReplay.  Lots of small changes.
# Most of them from Dean Brettle.  Connecting and replay are
# faster.  Socket support has been added.
#
# Revision 1.1  1996/07/29  22:48:12  crowley
# Initial revision
#
The WarpPointer dynamically loadable extension for Tcl 7.5

by Charlie Crowley
crowley@cs.unm.edu
http://www.cs.unm.edu/~crowley


INTRODUCTION

This extension allows you to move the mouse pointer.


COMPILING THE EXTENSION

For Unix systems:

(1) This extension requires Tcl7.5 and Tk4.1.  You can obtain the Tcl 7.5
release by anonymous ftp from ftp.sunlabs.com:/pub/tcl.  You must configure
and build Tcl before you build this extension.

(2) Suppose you have built Tcl7.5 in directory /user/you/tcl7.5
and TK4.1 in /user/you/tk4.1. Then execute the command:
    ./configure --with-tcl=/user/you/tcl7.5/unix --with-tk=/user/you/tk4.1/unix
This runs a configuration script created by GNU autoconf, which
configures Tcl for your system and creates a Makefile.  The configure
script allows you to customize the Tcl configuration for your site;
for details on how you can do this, type "./configure -help" or refer
to the autoconf documentation (not included here).  Note: the example
will use the same C compiler (e.g. gcc) as Tcl, as well as several
other of Tcl's configuration options.  You should not usually modify
CC in the Makefile generated here (if do you, be sure to check all of
the definitions related to dynamic loading to make sure that they are
still correct).

(3) Type "make".  This will create a shared library called "WarpPointer.so"
and a package index file called "pkgIndex.tcl".

(4) Type "make test" to test the example.  This will attempt to load
the example package from the current directory.  If it succeeds, you
will see the message "Test passed.", otherwise you will see an error.

For Microsoft Windows systems:

   This externsion does not work with Microsoft Windows systems.

For Macintosh systems:

   This externsion does not work with Macintosh systems.


USING THE EXTENSION

The directory contains "WarpPointer.so" and "pkgIndex.tcl" must be in
"auto_path" so the package will be found.  Then you can load the package
with the tcl command:
    require WarpPointer
Then you can move the mouse pointer 100 pixels to the right and 50
pixels down with the tcl command:
    WarpPointer 100 50 0
Or you can move it just inside the window Tk window with:
    WarpPointer 10 10 [winfo id .]

The manual page "WarpPointer.n" contains more information on used
the WarpPointer command.

