Name

pget_loc − Returns the 2D position of the locator. 

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

Syntax

void pget_loc (
  Pint    ∗view_ind,   /∗ (O) View index ∗/
  Ppoint  ∗loc_pos     /∗ (O) Locator position, in world coordinates ∗/
)

Data Structures

typedef struct {
    Pfloat     x;    /∗ x coordinate ∗/
    Pfloat     y;    /∗ y coordinate ∗/
} Ppoint;

Description

pget_loc 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 pawait_event function for more information about input classes and the current event report.) 

The pget_loc 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

pawait_event
pflush_events
pget_loc3
pinit_loc
preq_loc
psample_loc
pset_loc_mode
pset_view_tran_in_pri