NAME

set_locator, intset_locator2d − 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  —  November 03, 1994