PHIGURE C REFERENCE MANUAL - REQUEST LOCATOR 3

REQUEST LOCATOR 3

preq_loc3

CALL SEQUENCE

void preq_loc3 (ws_id, loc_dev, status, view_index, loc_pos)

INPUT PARAMETERS

Pint	ws_id,
Pint	loc_dev,

OUTPUT PARAMETERS

Pin_status 	*status,
Pint	*view_index,
Ppoint3	*loc_pos

ARGUMENTS

ws_id,: Workstation identifier
loc_dev,: Locator device number
status,: Input status
view_index,: View index
loc_pos: Locator position

TYPES

typedef enum {
	PIN_STATUS_NONE, 
	PIN_STATUS_OK, 
	PIN_STATUS_NO_IN
} Pin_status;

typedef struct {
	Pfloat 	x;	/* x coordinate	*/
	Pfloat 	y;	/* y coordinate	*/
	Pfloat 	z;	/* z coordinate	*/
} Ppoint3;

PHIGS STATE

(PHOP, WSOP, *, *).

EFFECT

Request the 3D position of the graphic cursor in WC space by user action on the left mouse button of the active input device loc_dev with the possibility of cancelling the input by clicking on the right button of the mouse.

The request state is thus attributed the OK or NONE (break) state.

Example:

/* Request locator on workstation number 1 using device number 1 */
	Pint ws_id,loc_dev,view_index;
	Pin_status status;
	Ppoint 3 loc_pos;
	.....
	ws_id = 1;
	loc_dev = 1;
	preq_loc3(ws_id,loc_dev,&status,&view_index,&loc_pos);
	......

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