Purpose
Use Request Locator to have the graPHIGS API execute a request to the specified locator device.
The graPHIGS API returns the locator position and the index of the view which the graPHIGS API used to convert the location from Device Coordinates (DC) to World Coordinates (WC).
The graPHIGS API returns the locator input from the view with the highest input priority under the cursor. View zero is the highest priority view unless modified by your application.
A status of NONE means that a break action occurred. Otherwise, the graPHIGS API returns a status of OK together with the logical input value which is the current measure of the locator device.
Note:
This function returns a two-dimensional result. The graPHIGS API discards the z coordinate of the locator position. The x and y values of the locator position are identical to those returned by the Request Locator 3 subroutine for the same operator action.
Language Bindings
| preq_loc (ws_id, loc_num, in_status, view_ind, loc_pos) |
| PRQLC (wkid, lcdnr, stat, viewi, px, py) |
Errors
Related Subroutines