INITIALIZE CHOICE

PINIT_CHOICE

CALL SEQUENCE

void pinit_choice(

Pint	ws_id,	/* workstation identifier	*/
Pint	choice_dev,	/* choice device number	*/
Pin_status	init_status,	/* initial choice status	*/
Pint	init_choice,	/* initial choice	*/
Pint 	pet,	/* prompt and echo type	*/
const Plimit	*echo_area,	/* echo area	*/
const Pchoice_data	*choice_data_rec	/* data record	*/

)

TYPES

typedef enum {
	PIN_STATUS_NONE, 
	PIN_STATUS_OK, 
	PIN_STATUS_NO_IN
} Pin_status;

typedef struct {
	Pfloat	x_min;	/* minimum x 	*/
	Pfloat	x_max;	/* maximum x 	*/
	Pfloat	y_min;	/* minimum y 	*/
	Pfloat	y_max;	/* maximum y 	*/
} Plimit;

typedef struct {
	union Pchoice_pets {
		struct Pchoice_pet_r1 {
			Pint	num_prompts;	/* number of prompts	*/
			Ppr_switch	prompts[P_NBCHOICE-1];
			char	*strings[P_NBCHOICE];
		} pet_r1;
		struct Pchoice_pet_r2 {
			Pint	num_prompts;	/* number of prompts	*/
			char	*prompts;	/* array of prompts	*/
		} pet_r2;
		struct Pchoice_pet_r3 {
			Pint	num_strings;	/* number of choice strings	*/
			char	**strings;	/* array of choice strings	*/
		} pet_r3;
		struct Pchoice_pet_r4 {
			Pint	num_strings;	/* number of choice strings	*/
			char	**strings;	/* array of choice strings	*/
		} pet_r4;
		struct Pchoice_pet_r5 {
			Pint	struct_id;	/* structure identifier	*/
			Pint	struct_id;	/* number of pick identifiers	*/
			Pint	*pick_ids;	/* array of pick identifiers	*/
		} pet_r5;
		int impl_dep;
	} pets;
} Pchoice_data;

typedef enum {
	PPR_OFF, 
	PPR_ON
} Ppr_switch;

PHIGS STATE

EFFECT

ERRORS

3

Ignoring function, function requires state (PHOP, WSOP,*,*)

54

Ignoring function, the specified workstation is not open

61

Ignoring function, specified workstation is neither of category INPUT nor of category OUTIN

250

Ignoring function, the specified device is not available on the specified workstation

251

Ignoring function, the function requires the input device to be in REQUEST mode

254

Ignoring function, invalid echo area volume: XMIN>>=XMAX, YMIN>>=YMAX or ZMIN>>ZMAX

255

Ignoring function, one of the echo area volume boundary points is outside the range of the device

253

Ignoring function, the specified prompt echo type is not available on the specified workstation

260

Ignoring function, one of the fields within the input device data record is in error

261

Ignoring function, initial value is invalid

SEE ALSO