GPHIGS C FUNCTIONS - GET STROKE 3

GET STROKE 3

PGET_STROKE3

CALL SEQUENCE

void pget_stroke3(

Pint	*view_index,	/* (out) view index	*/
Ppoint_list3	*stroke	/* (out) stroke position	*/

TYPES

typedef struct {
	Pint	num_points;	/* number of Ppoint3s in the list	*/
	Ppoint3	*points;	/* list of points	*/
} Ppoint_list3;

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

PHIGS STATE

(PHOP, WSOP, *, *).

EFFECT

Reads a 3D STROKE event. The STROKE input logic value is read in the current event report in the PHIGS state list. It is composed of points in WC and of the view index used to convert these points from NPC to WC when the event is placed in the queue. The stroke point list must be allocated before calling this function and its size must be equal to the maximum input buffer size field of the stroke data record parameter of INITIALIZE STROKE3.

Example:

/* Event stroke */
	Pint view_index;
	Ppoint points[10];
	Ppoint_list stroke_pos;
	......
	stroke_pos.points = points;
	pget_stroke(&view_index,&stroke_pos);
	......

ERRORS

3: Ignoring function, function requires state (PHOP, WSOP,*,*)
259: Ignoring function, the input device class of the current input report does not match the class