Name

pinq_def_pick_data − Returns pick information. 

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

Syntax

void pinq_def_pick_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
                                         ∗pick_data. ∗/
  Pint            ∗error_ind,     /∗ (O) Error indicator. ∗/
  Pint_list      ∗∗pets,          /∗ (O) List of PETs. ∗/
  Plimit          ∗echo_area,     /∗ (O) Default echo area, in device
                                         coordinates. ∗/
  Ppick_data     ∗∗pick_data      /∗ (O) Default pick 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 { /∗ pick data record ∗/
    union Ppick_pets {
        struct Ppick_pet_r1 {
            Pfloat    aperture;     /∗ pick aperture ∗/
        } pet_r1;
 .
 .
 .
    } pets;
} Ppick_data;

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

Description

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

•List of available prompt and echo types

•Default echo area in device coordinates

•Default pick data record

See Also

pcreate_store
pdel_store
pinit_pick
pinq_def_pick_data3