NAME

sample_locator − return current locator value

SYNOPSIS

C Syntax:

void sample_locator(fildes,ordinal,valid,x,y,z);
int fildes,ordinal,*valid;
float *x,*y,*z;

FORTRAN77 Syntax:

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

Pascal Syntax:

procedure sample_locator(fildes,ordinal:integer;
var valid:integer;var x,y,z:real);

DESCRIPTION

Input Parameters

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

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

Output Parameters

valid TRUE (1) if a valid point was returned,
FALSE (0) otherwise. 

x,y,z x, y, and z Virtual Device Coordinate values of a point returned from the locator device. 

Discussion

Sample_locator returns the current value of the locator device specified by fildes and ordinal.  This is the equivalent of a non-blocking read. 

SEE ALSO

request_locator(3G). 

Hewlett-Packard Company  —  May 11, 2021