SAMPLE LOCATOR 3
CALL SEQUENCE
void psample_loc3(
Pint ws_id, /* workstation identifier */
Pint loc_dev, /* locator device number */
Pint *view_index, /* (out) view index */
Ppoint3 *loc_pos /* (out) locator position */
)
TYPES
typedef struct {
Pfloat x; /* x coordinate */
Pfloat y; /* y coordinate */
Pfloat z; /* z coordinate */
} Ppoint3;
PHIGS STATE
(PHOP, WSOP, *, *).
EFFECT
Read current 3D position of graphic cursor in WC space on active input device
loc_dev.
Example:
/* Sample locator on workstation number 1 using device number 1 */
Pint ws_id,loc_dev;view_index;
Ppoint 3 loc_pos;
.....
ws_id = 1;
loc_dev = 1;
psample_loc3(ws_id,loc_dev,&view_index,&loc_pos);
......
ERRORS
- 3
Ignoring function, function requires state (PHOP, WSOP,*,*)
- 54
- Ignoring function, the specified workstation is not open
- 61
- Ignoring function, specified workstation is neither of category INPUT nor
of category OUTIN
- 250
- Ignoring function, the specified device is not available on the specified
workstation
- 251
- Ignoring function, the function requires the input device to be in REQUEST
mode
- 252
- Ignoring function, the function requires the input device to be in SAMPLE
mode
SEE ALSO
sample locator, set locator mode, initialize locator 3, request locator 3, get
locator 3, await event, inquire locator device state 3, inquire default locator
device state 3, locator without interaction (ext)