Name

preq_pick − Prompts for input using the pick-class logical input device specified. 

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

Syntax

void preq_pick (
  Pint         wsid,      /∗ (I) Workstation identifier ∗/
  Pint         dev_num,   /∗ (I) Pick device number ∗/
  Pint         depth,     /∗ (I) Depth of the pick path to return ∗/
  Pin_status  ∗status,    /∗ (O) Pick status ∗/
  Ppick_path  ∗pick       /∗ (O) Requested pick path ∗/
)

Data Structures

typedef enum {
    PIN_STATUS_NONE,    /∗ user performed a break action ∗/
    PIN_STATUS_OK,      /∗ user selected a primitive ∗/
    PIN_STATUS_NO_IN    /∗ user triggered the device, but did not make a
                           selection ∗/
} Pin_status;
typedef struct {
    Pint                depth;        /∗ pick path depth ∗/
    Ppick_path_elem    ∗path_list;    /∗ pick path list ∗/
} Ppick_path;
    typedef struct {
        Pint    struct_id;    /∗ structure identifier ∗/
        Pint    pick_id;      /∗ pick identifier ∗/
        Pint    elem_pos;     /∗ element position ∗/
    } Ppick_path_elem;

Description

preq_pick prompts for input using the pick-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 pick path. 

The pick path is a list Digital PHIGS uses to trace the traversal of the structure hierarchy and to identify uniquely the picked structure.  The individual components of the list contain the following integer values:

•Structure identifier

•Pick identifier of the element

•Offset (by element) into the structure

See Also

pget_pick
pinit_pick
pinit_pick3
psample_pick
pset_pick_filter
pe_set_pick_highl_ind
pset_pick_id
pset_pick_mode