SAMPLE LOCATOR 3

psample_loc3

CALL SEQUENCE

void psample_loc3 (ws_id, loc_dev, view_index, loc_pos)

INPUT PARAMETERS

Pint	ws_id,
Pint	loc_dev,

OUTPUT PARAMETERS

Pint	*view_index,
Ppoint3	*loc_pos

ARGUMENTS

ws_id,

Workstation identifier

loc_dev,

Locator device number

view_index,

View index

loc_pos

Locator position

TYPES

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

PHIGS STATE

EFFECT

Example:

/* Sample locator on workstation number 1 using device number 1 */
	Pint ws_id,loc_dev;view_index;
	Ppoint 3 loc_pos;
	.....
	ws_id = 1;
	loc_dev = 1;
	psample_loc3(ws_id,loc_dev,&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

252

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

SEE ALSO