REQUEST STROKE 3
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