Name

pinq_val_st3 − Returns information about the valuator device state. 

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

Syntax

void pinq_val_st3 (
  Pint           wsid,         /∗ (I) Workstation identifier. ∗/
  Pint           dev_num,      /∗ (I) Valuator device number. ∗/
  Pstore         store,        /∗ (I) Handle to store the object.  store
                                      manages the memory referenced by
                                      ∗val_data. ∗/
  Pint          ∗error_ind,    /∗ (O) Error indicator. ∗/
  Pop_mode      ∗op_mode,      /∗ (O) Operating mode. ∗/
  Pecho_switch  ∗echo,         /∗ (O) Echo switch. ∗/
  Pfloat        ∗init_value,   /∗ (O) Initial value. ∗/
  Pint          ∗pet,          /∗ (O) Prompt and echo type. ∗/
  Plimit3       ∗echo_vol,     /∗ (O) Echo volume, in device
                                      coordinates. ∗/
  Pval_data3   ∗∗val_data      /∗ (O) Data record. ∗/
)

Data Structures

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 {
    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 { /∗ valuator data record ∗/
    Pfloat    low_value;      /∗ low value of valuator range  ∗/
    Pfloat    high_value;     /∗ high value of valuator range ∗/
    union Pval3_pets {
        struct Pval3_pet_r1 {
            char     ∗title_string;    /∗ title string for the device ∗/
        } pet_r1;
        struct Pval3_pet_r2 {
            char     ∗title_string;    /∗ title string for the device ∗/
        } pet_r2;
        struct Pval3_pet_r3 {
            char     ∗title_string;    /∗ title string for the device ∗/
        } pet_r3;
        struct Pval3_pet_u1 {
            char     ∗title_string;    /∗ title string for the device ∗/
        } pet_u1;
        struct Pval3_pet_u2 {
            char     ∗title_string;    /∗ title string for the device ∗/
        } pet_u2;
        struct Pval3_pet_u3 {
            char     ∗title_string;    /∗ title string for the device ∗/
        } pet_u3;
        struct Pval3_pet_u4 {
            char     ∗title_string;    /∗ title string ∗/
            Pint      threshold;       /∗ threshold value for the hardware
                                          valuator ∗/
            Pint      smoothing;       /∗ smoothing value for the hardware
                                          valuator ∗/
            Pfloat    num_turns;       /∗ number of turns ∗/
        } pet_u4;
        struct Pval3_pet_u100 {
            char       ∗title_string;   /∗ title string for the device ∗/
            Pfloat      change_filter;  /∗ change filter ∗/
            Pfloat      time_filter;    /∗ time filter in seconds ∗/
            Pval_flag   limit_flag;     /∗ wrap/limit flag ∗/
            Pfloat      num_turns;      /∗ number of dial rotations ∗/
        } pet_u100;
        struct Pval3_pet_u102 {
            char       ∗title_string;   /∗ title string for the device ∗/
            Pfloat      change_filter;  /∗ change filter ∗/
            Pfloat      time_filter;    /∗ time filter in seconds ∗/
            Pval_flag   limit_flag;     /∗ wrap/limit flag ∗/
            Pfloat      num_turns;      /∗ number of dial rotations ∗/
        } pet_u102;
        struct Pval3_pet_u103 {
            char       ∗title_string;   /∗ title string for the device ∗/
            Pfloat      change_filter;  /∗ change filter ∗/
            Pfloat      time_filter;    /∗ time filter in seconds ∗/
            Pval_flag   limit_flag;     /∗ wrap/limit flag ∗/
            Pfloat      num_turns;      /∗ number of dial rotations ∗/
        } pet_u103;
    } pets;
} Pval_data3;
    typedef enum {
        PWRAP,
        PLIMIT
    } Pval_flag;

Description

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

•Operating mode

•Echo switch

•Initial valuator value

•Prompt and echo type

•Echo volume in device coordinates

•Valuator data record

See Also

pcreate_store
pdel_store
pinit_val3
pinq_val_st
pset_val_mode