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

GET STROKE 3 (PHOP,WSOP,*,*)

Purpose

Use Get Stroke 3 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 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.

Language Bindings

C

pget_stroke3 (view_ind, stroke)

Output Parameters

Pint *view_ind
View index.

Ppoint_list3 *stroke
Stroke.

FORTRAN

PGTSK3 (n, viewi, np, pxa, pya, pza)

Input Parameters

integer n
Dimension of arrays for the stroke points (>=0).

Output Parameters

integer viewi
View index.

integer np
Number of points.

real pxa (n)
x coordinates of the points in the stroke in WC.

real pya (n)
y coordinates of the points in the stroke in WC.

real pza (n)
z coordinates of the points in the stroke in WC.

Errors

3
Function Requires State (PHOP,WSOP,*,*)
259
Requested Device Class Not Current Input Report Class

Related Subroutines

  • Await Event

  • Get Stroke

  • Set View Transformation Input Priority

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