Name

pinq_def_choice_data3 − Returns choice information. 

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

Syntax

void pinq_def_choice_data3 (
  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
                                         ∗choice_data. ∗/
  Pint            ∗error_ind,     /∗ (O) Error indicator. ∗/
  Pint            ∗max_choices,   /∗ (O) Maximum number of choices. ∗/
  Pint_list      ∗∗pets,          /∗ (O) List of PETs. ∗/
  Plimit3         ∗echo_vol,      /∗ (O) Default echo volume, in device
                                         coordinates. ∗/
  Pchoice_data3  ∗∗choice_data    /∗ (O) Default choice 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 ∗/
    Pfloat    z_min;    /∗ z minimum ∗/
    Pfloat    z_max;    /∗ z maximum ∗/
} Plimit3;
typedef struct { /∗ choice data record 3 ∗/
    union Pchoice3_pets {
        struct Pchoice3_pet_r1 {
            Pint       num_strings;     /∗ number of choice strings ∗/
            char     ∗∗strings;         /∗ array of choice strings ∗/
            char      ∗title_string;    /∗ title string for the device ∗/
        } pet_r1;
 .
 .
 .
    } pets;
} Pchoice_data3;

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

Description

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

•Maximum number of choice alternatives

•List of available prompt and echo types

•Default echo volume in device coordinates

•Default choice data record

See Also

pcreate_store
pdel_store
pinit_choice3
pinq_def_choice_data