Name

pinq_def_loc_data − Returns locator information. 

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

Syntax

void pinq_def_loc_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 ∗loc_data. ∗/
  Pint           ∗error_ind,    /∗ (O) Error indicator. ∗/
  Ppoint         ∗loc_pos,      /∗ (O) Default locator position. ∗/
  Pint_list     ∗∗pets,         /∗ (O) List of PETS. ∗/
  Plimit         ∗echo_area,    /∗ (O) Default echo area, in device
                                       coordinates. ∗/
  Ploc_data     ∗∗loc_data      /∗ (O) Default locator 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 { /∗ locator data record ∗/
    union Ploc_pets {
        struct Ploc_pet_r1 {
            Pint   impl_dep;
        } pet_r1;
 .
 .
 .
    } pets;
} Ploc_data;

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_data 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 area in device coordinates

•Default locator data record

See Also

pcreate_store
pdel_store
pinit_loc
pinq_def_loc_data3