GPGTLC - Get Locator

Purpose

Use GPGTLC to retrieve a locator input value from the current event report. The event is not removed from the current event report until the next invocation of the Await Event (GPAWEV) subroutine.

The view index indicates the view table entry whose matrix was used to convert the locator point to World Coordinates (WC) This was the view active for input with the highest input priority at the indicated screen location.

The device to which this value corresponds was identified on the previous invocation of GPAWEV

Locator input is returned from the view active for input with the highest input priority under the cursor. View zero is the highest priority view unless modified by your application.

Parameters