[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface : Subroutine Reference

GPRQSK - Request Stroke

GPRQSK (wsid, device, length, status, view, npoint, pointarray)

Purpose

Use GPRQSK to have the graPHIGS API execute a request to the specified stroke device.

The graPHIGS API returns a sequence of World Coordinate (WC) points and the view table index whose matrix was used to convert the stroke locations to World Coordinates (WC)

Stroke input is returned from the view active for input with the highest input priority that 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 data (>=0)

This value is specified as the size of the pointarray in point entries.

status -- returned by the graPHIGS API, fullword integer

Status (1=NONE, 2=OK )

view -- returned by the graPHIGS API, fullword integer

View table index.

npoint -- returned by the graPHIGS API, fullword integer

Number of points returned in point array (>=0)

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

Coordinates (3D) of points in stroke returned as a pointlist of width=3.

Error Codes

25
SPECIFIED WORKSTATION DOES NOT EXIST
140
DEVICE NUMBER < ONE OR DEVICE NOT AVAILABLE
141
INPUT DEVICE NOT IN CORRECT MODE
168
INPUT DEVICE IS CURRENTLY OWNED BY ANOTHER CONNECTION
505
LENGTH OF RETURN ARRAY < ZERO

Related Subroutines

GPINSK
Initialize Stroke
GPQLI
Inquire List of Logical Input Devices
GPSKMO
Set Stroke Mode

RCP code

201335560 (X'0C002308')


[ Previous | Next | Contents | Glossary | Home | Search ]