Name

psample_pick − Returns pick path information from the pick-class logical input device specified. 

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

Syntax

void psample_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) Input status ∗/
  Ppick_path  ∗pick      /∗ (O) Pick path ∗/
)

Data Structures

typedef enum {
    PIN_STATUS_NONE,    /∗ not used by this function ∗/
    PIN_STATUS_OK,      /∗ measure contains a pick path ∗/
    PIN_STATUS_NO_IN    /∗ measure does not contain a pick path ∗/
} 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

psample_pick takes the current measure of 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 uniquely identify the picked primitive. The individual components of the list contain the following integer values:

•Structure identifier

•Pick identifier of the element

•Offset (by element) into the structure

Digital PHIGS returns the  pick path in the order specified by the pick path order entry (PORDER_TOP_FIRST or PORDER_BOTTOM_FIRST) in the workstation state list.  To set the pick path order, use the pinit_pick function. 

Digital PHIGS determines the pickability of primitives by the name set of the primitive and the current pick filter for the logical input device. 

See Also

pget_pick
pinit_pick
pinq_pick_st
preq_pick
pset_pick_filter
pe_set_pick_highl_ind
pset_pick_id
pset_pick_mode