.\"	"@(#)track_cursor.txt	1.1 Stardent 90/08/23"
.\"			Copyright (c) 1989 by
.\"			Stardent Computer Inc.
.\"			All Rights Reserved
.\"	
.\"	This software comprises unpublished confidential information of
.\"	Stardent Computer Inc. and may not be used, copied or made
.\"	available to anyone, except in accordance with the license
.\"	under which it is furnished.
.\"	
.\"	This file is under sccs control at Stardent in:
.\"	@uranus/sccs1.p/avs_user_mods/data/track_cursor/s.track_cursor.txt
.\"	
.\"	
NAME:		track cursor

AUTHOR INFO:	David Kamins, Stardent Computer, 617-964-1000

SOURCE FILE:	track_cursor.c

TYPE:		data

INPUTS:		NONE

OUTPUTS:	field 2d uniform 4-vector byte (image)

PARAMETERS:     Name		Type	Default		Min	Max
	        Track Width	integer 64		16	256
	        Track Height	integer 64		16	256

DESCRIPTION:
	Track Cursor uses X Window System calls to follow the cursor around
the screen and grab N*M pixels off the screen (with the cursor positioned at
the upper left hand corner of the snagged window). It then outputs the (32-bit,
true color) window contents as an AVS field 2D 4-vector byte which may be
displayed using DISPLAY IMAGE, etc.

	This is a useful magnifying glass as well as a convenient way to snag
window sections into AVS for further processing.

EXAMPLE NETWORK:
	 TRACK CURSOR
              |
         DISPLAY IMAGE

LIMITATIONS:
	This module was written with the Stardent GS in mind. Porting to
other platforms may necessitate changes to the Makefile in order to get
the correct X-library. (Note that this implementation also assumes
32-bit pixel maps)