Previous Next Up Title Contents Index Functions Index Top Library

REQUEST STROKE 3

preq_stroke3


CALL SEQUENCE

void preq_stroke3 (ws_id, stroke_dev, status, view_index, stroke)

INPUT PARAMETERS

Pint	ws_id,
Pint	stroke_dev,

OUTPUT PARAMETERS

Pin_status 	*status,
Pint	*view_index,
Ppoint_list3	*stroke

ARGUMENTS

ws_id,
Workstation identifier
stroke_dev,
Stroke device number
status,
Input status
view_index,
View index
stroke
Stroke positions

TYPES

typedef enum {
	PIN_STATUS_NONE, 
	PIN_STATUS_OK, 
	PIN_STATUS_NO_IN
} Pin_status;

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

Request a set of 3D points in WC space by successive user action on the active input device stroke_dev .

Example:

/* Request stroke on workstation number 1 using device number 1 */
	Pint ws_id,stroke_dev;view_index;
	Pin_status status;
	Ppoint  points[10];
	Ppoint_list stroke_pos;
	.....
	ws_id = 1;
	stroke_dev = 1;
	stroke_pos.points = points;
	preq_stroke(ws_id,stroke_dev,&status,&view_index,&stroke_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

SEE ALSO

set stroke mode, initialize stroke 3, sample stroke 3, get stroke 3, await event, inquire stroke device state 3, inquire default stroke device state 3


Previous Next Up Title Contents Index Functions Index Top Library