Name

pinq_pick_st3 − Returns information about the pick device state. 

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

Syntax

void pinq_pick_st3 (
  Pint           wsid,         /∗ (I) Workstation identifier. ∗/
  Pint           dev_num,      /∗ (I) Pick device number. ∗/
  Pinq_type      return_type,  /∗ (I) Type of the returned values. ∗/
  Pstore         store,        /∗ (I) Handle to store the object.  store
                                      manages the memory referenced by
                                      ∗pick_filter, ∗init_path,
                                      and ∗pick_data. ∗/
  Pint          ∗error_ind,    /∗ (O) Error indicator. ∗/
  Pop_mode      ∗op_mode,      /∗ (O) Operating mode. ∗/
  Pecho_switch  ∗echo,         /∗ (O) Echo switch. ∗/
  Pfilter      ∗∗pick_filter,  /∗ (O) Pick filter. ∗/
  Pin_status    ∗init_status,  /∗ (O) Initial pick status. ∗/
  Ppick_path   ∗∗init_pick,    /∗ (O) Initial pick path. ∗/
  Pint           ∗pet,         /∗ (O) Prompt and echo type. ∗/
  Plimit3        ∗echo_vol,    /∗ (O) Echo volume, in device coordinates.∗/
  Ppick_data3   ∗∗pick_data,   /∗ (O) Data record. ∗/
  Ppath_order    ∗order        /∗ (O) Pick path order. ∗/
)

Data Structures

typedef enum {
    PINQ_SET,        /∗ Use the exact state list values. ∗/
    PINQ_REALIZED    /∗ Use the values approximated by the graphics
                        handler. ∗/
} Pinq_type;
typedef void ∗Pstore;
typedef enum {
    POP_REQ,       /∗ request mode ∗/
    POP_SAMPLE,    /∗ sample mode ∗/
    POP_EVENT      /∗ event mode ∗/
} Pop_mode;
typedef enum {
    PSWITCH_NO_ECHO,    /∗ echo disabled ∗/
    PSWITCH_ECHO        /∗ echo enabled ∗/
} Pecho_switch;
typedef struct {
    Pint_list    incl_set;    /∗ inclusion set ∗/
    Pint_list    excl_set;    /∗ exclusion set ∗/
} Pfilter;
    typedef struct {
        Pint      num_ints;   /∗ number of Pints in the list ∗/
        Pint     ∗ints;       /∗ list of integers ∗/
    } Pint_list;
typedef enum {
    PIN_STATUS_NONE,    /∗ no input ∗/
    PIN_STATUS_OK,      /∗ an initial pick exists ∗/
    PIN_STATUS_NO_IN    /∗ an initial pick does not exist ∗/
} 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;
typedef struct {
    Pfloat    x_min;    /∗ x minimum ∗/
    Pfloat    x_max;    /∗ x maximum ∗/
    Pfloat    y_min;    /∗ y minimum ∗/
    Pfloat    y_max;    /∗ y maximum ∗/
    Pfloat    z_min;    /∗ z minimum ∗/
    Pfloat    z_max;    /∗ z maximum ∗/
} Plimit3;
typedef struct { /∗ pick data record ∗/
    union Ppick3_pets {
        struct Ppick3_pet_r1 {
            Pfloat    aperture;     /∗ pick aperture ∗/
        } pet_r1;
        struct Ppick3_pet_r2 {
            Pfloat    aperture;     /∗ pick aperture ∗/
        } pet_r2;
        struct Ppick3_pet_r3 {
            Pfloat    aperture;     /∗ pick aperture ∗/
        } pet_r3;
    } pets;
} Ppick_data3;
typedef enum {
    PORDER_TOP_FIRST,       /∗ top first ∗/
    PORDER_BOTTOM_FIRST     /∗ bottom first ∗/
} Ppath_order;

Description

pinq_pick_st3 queries the workstation state list and returns values for the following:

•Operating mode

•Echo switch

•Pick inclusion filter

•Pick exclusion filter

•Initial status

•Initial pick path

•Prompt and echo type

•Echo volume in device coordinates

•Pick data record

•Pick path order

See Also

pcreate_store
pdel_store
pinit_pick3
pinq_pick_st3
pset_pick_filter
pset_pick_mode