Purpose
Use Get Stroke to retrieve a stroke input device value from the current event report. The graPHIGS API does not remove the event from the current event report until the next invocation of the Await Event subroutine call.
The graPHIGS API limits the number of returned points to the current input buffer size found in the stroke data record at the time the device was set to event mode. The view index indicates the view table entry which has a matrix that the graPHIGS API used to convert the stroke points from Device Coordinates (DC) to World Coordinates (WC). This view was the view with the highest input priority containing all the stroke locations.
The graPHIGS API identified the device to which this value corresponds on the previous invocation of Await Event.
View zero is the highest priority view unless modified by your application.
Note:
This function returns a two-dimensional result. The graPHIGS API discards the z coordinate of the stroke points. The x and y values of the stroke points are identical to those returned by the Get Stroke 3 subroutine for the same operator action.
Language Bindings
| pget_stroke (view_ind, stroke) |
| PGTSK (n, viewi, np, pxa, pya) |
Errors
Related Subroutines