Name

psample_loc3 − Returns the 3D coordinates of the locator position from the locator-class logical input device specified. 

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

Syntax

void psample_loc3 (
  Pint       wsid,      /∗ (I) Workstation identifier ∗/
  Pint       dev_num,   /∗ (I) Locator device number ∗/
  Pint      ∗view_ind,  /∗ (O) View index ∗/
  Ppoint3   ∗locator    /∗ (O) 3D locator position, in world coordinates ∗/
)

Data Structures

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

Description

psample_loc3 takes the current measure of the locator-class logical input device specified by the device number and the workstation identifier.  The 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

pget_loc3
pinit_loc3
pinq_loc_st3
preq_loc3
psample_loc
pset_loc_mode
pset_view_tran_in_pri