Name

PGTLC − Returns the 2D position of the locator. 

Operating States: PHOP, WSOP, ∗, ∗
PHIGS standard function
 

Syntax

PGTLC (VIEWI, LPX, LPY)

Argument     Data Type      Access    Description
---------------------------------------------------------------------------
VIEWI        Integer        Write     View index
LPX, LPY     Real           Write     Locator position, in world
                                      coordinates (x, y)
---------------------------------------------------------------------------

Description

PGTLC obtains information contained in the current event report entry.  If the report contains input generated by anything other than a locator-class input device, a call to this function generates an error.  (See the PWAIT function for more information about input classes and the current event report.) 

The PGTLC function returns the world coordinate point and the view index of the view transformation Digital PHIGS uses to translate the normalized projection coordinate point to the world coordinate point. 

Digital PHIGS uses the current workstation transformation to translate the device coordinate point to the normalized projection coordinate point.  See Getting Started with DEC PHIGS for more information on view indexes. 

This function ignores the z-coordinate component and returns a two-dimensional result. 

See Also

PWAIT
PFLUSH
PGTLC3
PINLC
PRQLC
PSMLC
PSLCM
PSVTIP