Purpose
Use Get Locator to retrieve a locator input value from the current event report. The graPHIGS API does not remove the event from the current event report until the next invocation of the Await Event subroutine call.
The view index indicates the view table entry which has a matrix that the graPHIGS API used to convert the locator point from Device Coordinates (DC) to World Coordinates (WC). This was the view with the highest input priority at the indicated screen location.
The graPHIGS API identified the device to which this value corresponds on the previous invocation of Await Event Await Event.
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 subroutine 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 Get Locator 3 subroutine for the same operator action.
Language Bindings
| pget_loc (view_ind, loc_pos) |
| PGTLC (viewi, lpx, lpy) |
Errors
Related Subroutines