Purpose
Use Sample Locator to immediately retrieve the current measure of the specified locator device.
The measure consists of a locator position in World Coordinates (WC) and the index of the view table entry which has a matrix that the graPHIGS API used to convert the location from Device Coordinates (DC) to World Coordinates.
This subroutine 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.
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 Sample Locator 3 subroutine for the same operator action.
Language Bindings
| psample_loc (ws_id, loc_num, view_ind, loc_pos) |
| PSMLC (wkid, lcdnr, viewi, lpx, lpy) |
Errors
Related Subroutines