graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPSMSK - Sample Stroke

GPSMSK (wsid, device, length, view, npoint, pointarray)

Purpose

Use GPSMSK to immediately retrieve the current measure of the specified stroke device.

This measure consists of a sequence of stroke positions (not exceeding the current input buffer size) in World Coordinates (WC), and the index of the view table entry whose matrix was used to convert the stroke locations to World Coordinates.

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

wsid -- specified by user, fullword integer

Workstation identifier.

device -- specified by user, fullword integer

Stroke device number (>=1)

length -- specified by user, fullword integer

Length of pointarray provided by the application for the graPHIGS API to return stroke information (>=0) This value is specified as the size of the pointarray in point entries.

view -- returned by the graPHIGS API, fullword integer

View table index.

npoint -- returned by the graPHIGS API, fullword integer

Number of points in the stroke measure.

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

Coordinates of points in the stroke returned as a pointlist of width=3.

Error Codes

25: SPECIFIED WORKSTATION DOES NOT EXIST
140: DEVICE NUMBER < ONE OR DEVICE NOT AVAILABLE
505: LENGTH OF RETURN ARRAY < ZERO

Related Subroutines

GPQLI: Inquire List of Logical Input Devices
GPSKMO: Set Stroke Mode

RCP code

201335554 (X'0C002302')