Name

pinq_def_loc_data3 − Returns locator information. 

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

Syntax

void pinq_def_loc_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 ∗loc_data. ∗/
  Pint         ∗error_ind,   /∗ (O) Error indicator. ∗/
  Ppoint3      ∗loc_pos,     /∗ (O) Default initial position. ∗/
  Pint_list   ∗∗pets,        /∗ (O) List of PETs. ∗/
  Plimit3      ∗echo_vol,    /∗ (O) Default echo volume, in device
                                    coordinates. ∗/
  Ploc_data3  ∗∗loc_data     /∗ (O) Default locator data record. ∗/
)

Data Structures

typedef void ∗Pstore;
typedef struct {
    Pfloat     x;    /∗ x coordinate ∗/
    Pfloat     y;    /∗ y coordinate ∗/
    Pfloat     z;    /∗ z coordinate ∗/
} Ppoint3;
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 { /∗ locator data record ∗/
    union Ploc3_pets {
        struct Ploc3_pet_r1 {
            Pint     impl_dep;
        } pet_r1;
 .
 .
 .
    } pets;
} Ploc_data3;

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

Description

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

•Default initial locator position in world coordinates

•List of available prompt and echo types

•Default echo volume in device coordinates

•Default locator data record

See Also

pcreate_store
pdel_store
pinit_loc3
pinq_def_loc_data