graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPGTSK - Get Stroke

GPGTSK (length, view, npoint, pointlist)

Purpose

Use GPGTSK to retrieve a stroke input device value from the current event report. The event is not removed from the current event report until the next invocation of the Await Event (GPAWEV) subroutine.

The number of points returned is limited to the current input buffer size found in the stroke data record at the time the device was placed in event mode. The view index indicates the view table entry whose matrix was used to convert the stroke points to World Coordinates (WC) This view was the view active for input with the highest input priority containing all the stroke locations.

The device to which this value corresponds was identified on the previous invocation of GPAWEV

Stroke input is returned from the view active for input with the highest input priority which contains all the points. View 0 is the highest priority view, unless modified by your application.

Parameters

length -- specified by user, fullword integer

Length of point list array provided by application for the return of the stroke points. This value is specified as the maximum number of points that can be stored in the pointlist (>=0)

view -- returned by the graPHIGS API, fullword integer

View index.

npoint -- returned by the graPHIGS API, fullword integer

Number of points returned in the pointlist

pointlist -- returned by the graPHIGS API, array of short floating-point numbers (WC)

Coordinates of points in initial stroke buffer.

The points are ordered similarly to the pointlist parameters on output primitives.

Error Codes

150: GET FUNCTION DOES NOT MATCH CURRENT EVENT CLASS
505: LENGTH OF RETURN ARRAY < ZERO
519: NO CURRENT EVENT REPORT AVAILABLE

Related Subroutines

GPAWEV: Await Event

RCP code

201336066 (X'0C002502')