NAME

intsample_locator2d, sample_locator − return current locator value

SYNOPSIS

C Syntax:

void intsample_locator2d(fildes,ordinal,valid,x,y);
int fildes,ordinal,*valid,*x,*y;

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

FORTRAN77 Syntax:

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

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

Pascal Syntax:

procedure intsample_locator2d(fildes,ordinal:integer;var valid:integer;
var x,y:integer);

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. 

Integer operations are only available when using the INT_XFORM gopen mode. When in INT_XFORM mode, floating point operations are not abailable 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, se the starbase.3g manual page. 

SEE ALSO

request_locator(3G). 

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