NAME
cxPickHitPointGet
- get detail information about a pick hit on a point
C SPECIFICATION
#include <cx/Pick.h>
cxErrorCode cxPickHitPointGet(
cxPick *pick,
int n,
long *index)
FORTRAN SPECIFICATION
integer function cxPickHitPointGet(pick,n,index)
integer pick
integer n
integer index
PARAMETERS
-
pick
-
Pick data structure to interrogate.
-
n
-
Index of hit in pick structure.
-
index
-
Returned index of the point in a point set.
FUNCTION RETURN VALUE
The return value for this function is an integer error code enumeration.
DESCRIPTION
This function extracts detail hit information about a point. The index
of the particular point in a point set is returned in index. The
function returns a nonzero value if the hit index is not valid or the
hit requested is not on a point.
The function returns cx_err_none on success.
A non-zero value is returned in case of an error. This will usually be
because the hit is not of the proper object type.
The user can tell the function not to get information on a particular
field by passing a NULL pointer value. You need not create dummy variables
in the calling routine which calls cxPickHitPointGet, because the request is simply ignored
when the pointer comes in NULL.
SEE ALSO
Last modified: Mon Nov 18 13:52:13 GMT 1996
[ Documentation Home ]
© The Numerical Algorithms Group Ltd, Oxford UK. 1996