NAME

sample_locator, intsample_locator2d − return current locator value

SYNOPSIS

C Syntax:

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

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

FORTRAN77 Syntax:

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

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

Pascal Syntax:

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

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

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 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. 

SEE ALSO

request_locator(3G). 

Hewlett-Packard Company  —  November 03, 1994