Name

pinq_def_val_data − Returns valuator information. 

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

Syntax

void pinq_def_val_data (
  Pint            wstype,       /∗ (I) Workstation type. ∗/
  Pint            dev_num,      /∗ (I) Logical input device number. ∗/
  Pstore          store,        /∗ (I) Handle to store the object.  store
                                       manages the memory referenced by
                                       ∗pets and ∗val_data. ∗/
  Pint           ∗error_ind,    /∗ (O) Error indicator. ∗/
  Pfloat         ∗def_value,    /∗ (O) Default value. ∗/
  Pint_list     ∗∗pets,         /∗ (O) List of PETS. ∗/
  Plimit         ∗echo_area,    /∗ (O) Default echo area, in device
                                       coordinates. ∗/
  Pval_data     ∗∗val_data      /∗ (O) Default valuator data record. ∗/
)

Data Structures

typedef void ∗Pstore;
typedef struct {
    Pint      num_ints;   /∗ number of Pints in the list ∗/
    Pint     ∗ints;       /∗ list of integers ∗/
} Pint_list;
typedef struct {
    Pfloat    x_min;    /∗ x minimum ∗/
    Pfloat    x_max;    /∗ x maximum ∗/
    Pfloat    y_min;    /∗ y minimum ∗/
    Pfloat    y_max;    /∗ y maximum ∗/
} Plimit;
typedef struct { /∗ valuator data record ∗/
    Pfloat    low_value;      /∗ low value of valuator range  ∗/
    Pfloat    high_value;     /∗ high value of valuator range ∗/
    union Pval_pets {
        struct Pval_pet_r1 {
            char     ∗title_string;    /∗ title string for the device ∗/
        } pet_r1;
 .
 .
 .
    } pets;
} Pval_data;

Because this function returns information on the default valuator data (PET 1), the data structures for the other PETs have been omitted.

Description

pinq_def_val_data queries the workstation description table and returns values for the following:

•Default initial value

•List of available prompt and echo types

•Default echo area in device coordinates

•Default valuator data record

See Also

pcreate_store
pdel_store
pinit_val
pinq_def_val_data3