PHIGURE C REFERENCE MANUAL

SAMPLE CHOICE

psample_choice

CALL SEQUENCE

void psample_choice (ws_id, choice_dev, status, choice)

INPUT PARAMETERS

Pint 	ws_id,
Pint 	choice_dev,

OUTPUT PARAMETERS

Pin_status	*status,
Pint	*choice

ARGUMENTS

ws_id,: workstation identifier
choice_dev,: Choice device number
status,: Choice status
choice: Choice

TYPES

typedef enum {
	PIN_STATUS_NONE, 
	PIN_STATUS_OK, 
	PIN_STATUS_NO_IN
} Pin_status;

PHIGS STATE

(PHOP, WSOP, *, *).

EFFECT

Reads the current choice on the active input device, choice_dev.

Example:

/* Sample choice on workstation number 1 using device number 40 */
	Pint ws_id,choice_dev;
	Pint choice;
	.....
	ws_id = 1;
	choice_dev = 40;
	psample_choice(ws_id,choice_dev,&choice);
	......

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
252: Ignoring function, the function requires the input device to be in SAMPLE mode