Name

pget_loc3 − Returns the 3D position of the locator. 

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

Syntax

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

Data Structures

typedef struct {
    Pfloat     x;    /∗ x coordinate ∗/
    Pfloat     y;    /∗ y coordinate ∗/
    Pfloat     z;    /∗ z coordinate ∗/
} Ppoint3;

Description

pget_loc3 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_loc3 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 about view indexes. 

See Also

pawait_event
pflush_events
pget_loc
pinit_loc3
preq_loc3
psample_loc3
pset_loc_mode
pset_view_tran_in_pri