NAME

set_locator − set locator value

SYNOPSIS

C Syntax:

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

FORTRAN77 Syntax:

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

Pascal Syntax:

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

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. 

Hewlett-Packard Company  —  May 11, 2021