Name

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

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

Syntax

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

Data Structures

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

Description

psample_loc 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. 

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

See Also

pget_loc
pinit_loc
pinq_loc_st
preq_loc
psample_loc3
pset_loc_mode
pset_view_tran_in_pri