NAME

sample_locator − returns the 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);

HP-UX COMPATIBILITY

Level: HP-UX/STANDARD

Origin: ANSI Computer Graphics Interface

DESCRIPTION

INPUT PARAMETERS

fildes
is an integer file descriptor returned by gopen when an I/O path to a graphics device is opened. 
ordinal
a logical device number ranging from 1 to number of devices of this class.

OUTPUT PARAMETERS

valid
is set to TRUE (1) if a valid point was returned, FALSE (0) otherwise.
x,y,z
are set to the 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