pinit_val3(3g) — Subroutines
Name
pinit_val3 − Sets the valuator device to application-specific values.
Operating States: PHOP, WSOP, ∗, ∗
PHIGS standard function
Syntax
void pinit_val3 (
Pint wsid, /∗ (I) Workstation identifier ∗/
Pint dev_num, /∗ (I) Valuator device number ∗/
Pfloat init, /∗ (I) Initial value ∗/
Pint pet, /∗ (I) Prompt and echo type ∗/
const Plimit3 ∗echo_vol, /∗ (I) Echo volume, in device
coordinates ∗/
const Pval_data3 ∗record /∗ (I) Data record ∗/
)
Data Structures
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 { /∗ valuator data record ∗/
Pfloat low_value; /∗ low value of valuator range ∗/
Pfloat high_value; /∗ high value of valuator range ∗/
union Pval3_pets {
struct Pval3_pet_r1 {
char ∗title_string; /∗ title string for the device ∗/
} pet_r1;
struct Pval3_pet_r2 {
char ∗title_string; /∗ title string for the device ∗/
} pet_r2;
struct Pval3_pet_r3 {
char ∗title_string; /∗ title string for the device ∗/
} pet_r3;
struct Pval3_pet_u1 {
char ∗title_string; /∗ title string for the device ∗/
} pet_u1;
struct Pval3_pet_u2 {
char ∗title_string; /∗ title string for the device ∗/
} pet_u2;
struct Pval3_pet_u3 {
char ∗title_string; /∗ title string for the device ∗/
} pet_u3;
struct Pval3_pet_u4 {
char ∗title_string; /∗ title string ∗/
Pint threshold; /∗ threshold value for the hardware
valuator ∗/
Pint smoothing; /∗ smoothing value for the hardware
valuator ∗/
Pfloat num_turns; /∗ number of turns ∗/
} pet_u4;
struct Pval3_pet_u100 {
char ∗title_string; /∗ title string for the device ∗/
Pfloat change_filter; /∗ change filter ∗/
Pfloat time_filter; /∗ time filter in seconds ∗/
Pval_flag limit_flag; /∗ wrap/limit flag ∗/
Pfloat num_turns; /∗ number of dial rotations ∗/
} pet_u100;
struct Pval3_pet_u102 {
char ∗title_string; /∗ title string for the device ∗/
Pfloat change_filter; /∗ change filter ∗/
Pfloat time_filter; /∗ time filter in seconds ∗/
Pval_flag limit_flag; /∗ wrap/limit flag ∗/
Pfloat num_turns; /∗ number of dial rotations ∗/
} pet_u102;
struct Pval3_pet_u103 {
char ∗title_string; /∗ title string for the device ∗/
Pfloat change_filter; /∗ change filter ∗/
Pfloat time_filter; /∗ time filter in seconds ∗/
Pval_flag limit_flag; /∗ wrap/limit flag ∗/
Pfloat num_turns; /∗ number of dial rotations ∗/
} pet_u103;
} pets;
} Pval_data3;
typedef enum {
PWRAP,
PLIMIT
} Pval_flag;
Description
pinit_val3 sets the valuator device to application-specific values. This function accepts the echo volume in a 6-component list of x-, y-, and z-coordinates, in device coordinates. The order of the list components is XMIN < XMAX, YMIN < YMAX, ZMIN < ZMAX.
When an application calls pinit_val3, the workstation surface cannot contain the valuator device’s prompt. To remove an existing prompt from the surface, call the pset_val_mode function and place the device in request mode.
The size and contents of the data record depend on the prompt and echo type you specify. If the size or contents of the data record does not match the requirements of your chosen prompt and echo type, Digital PHIGS generates an error.
See Valuator-Class PETs for information on valuator-class prompt and echo types.
See Also
pget_val
pinit_val
pinq_def_val_data3
pinq_val_st3
preq_val
psample_val
pset_val_mode