NAME

set_locator − set locator value

SYNOPSIS

C Syntax:

void set_locator(fildes,ordinal,x,y,z);
int fildes,ordinal;
float x,y,z;
void intset_locator2d(fildes,ordinal,x,y);
int fildes,ordinal;
int x,y;

FORTRAN77 Syntax:

subroutine set_locator(fildes,ordinal,x,y,z)
integer*4 fildes,ordinal
real x,y,z
subroutine intset_locator2d(fildes,ordinal,x,y)
integer*4 fildes,ordinal
int x,y

Pascal Syntax:

procedure set_locator(fildes,ordinal:integer;x,y,z:real); procedure intset_locator2d(fildes,ordinal:integer;x,y:integer);

DESCRIPTION

INPUT PARAMETER

fildes Integer file descriptor returned by gopen when the I/O path to a graphics device is opened. 

ordinal
Logical device number ranging from 1 to the number of devices in the locator class.

x,y,z Define the new x, y and z virtual device coordinate values of the locator device. 

Discussion

Set_locator sets the value of the locator device specified by fildes and ordinal.  For a relative-position device, such as a mouse, this call sets the x,y,z coordinates to the current device location.  For an absolute device such as a tablet, the location is also set, but it is then reset by the device to the current location of the tablet’s pen. 

Integer operations are only available when using the INT_XFORM gopen mode.  When in the INT_XFORM mode, floating point operations are not available for that fildes.  Floating point operations are the default, or can be specified with FLOAT_XFORM mode.  For a list of integer operations, floating point operations, and common operations, see the starbase.3g manual page. 

Hewlett-Packard Company  —  HP-UX Release 9.03: April 1994