Name

preq_loc3 − Prompts for input using the locator-class logical input device specified. 

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

Syntax

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

Data Structures

typedef enum {
    PIN_STATUS_NONE,    /∗ user performed a break action ∗/
    PIN_STATUS_OK,      /∗ user selected a locator position ∗/
    PIN_STATUS_NO_IN    /∗ not used by this function ∗/
} Pin_status;
typedef struct {
    Pfloat     x;    /∗ x coordinate ∗/
    Pfloat     y;    /∗ y coordinate ∗/
    Pfloat     z;    /∗ z coordinate ∗/
} Ppoint3;

Description

preq_loc3 prompts you for input using the locator-class logical input device specified by the device number and the workstation identifier.  If the input status is PIN_STATUS_OK, this function returns the world coordinate point and the view index of the view transformation Digital PHIGS uses to translate the normalized projection coordinate points to the world coordinate points. See Getting Started with DEC PHIGS for more information about view indexes. 

Digital PHIGS uses the current workstation transformation to translate the device coordinate point to a normalized projection coordinate point. 

See Also

pget_loc3
pinit_loc3
preq_loc
psample_loc3
pset_loc_mode
pset_view_tran_in_pri