Purpose
Use Get Locator 3 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 the Await Event subroutine call.
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.
Language Bindings
| pget_loc3 (view_ind, loc_pos) |
| PGTLC3 (viewi, lpx, lpy, lpz) |
Errors
Related Subroutines