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

SAMPLE STROKE (PHOP,WSOP,*,*)

Purpose

Use Sample Stroke 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 which has a matrix that the graPHIGS API used to convert the stroke locations from Device Coordinates (DC) to World Coordinates.

This subroutine returns the stroke input from the view with the highest input priority which contains all the points. 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 coordinates of the stroke points. The x and y values of the stroke points are identical to those returned by the the Sample Stroke 3 subroutine for the same operator action.

Language Bindings

C

psample_stroke (ws_id, stroke_num, view_ind, stroke)

Input Parameters

Pint ws_id
Workstation identifier.

Pint stroke_num
Stroke device number (>=1).

Output Parameters

Pint *view_ind
View index.

Ppoint_list *stroke
Stroke point list in WC. The application must allocate the memory for the point list returned. The Initialize Stroke subroutine specifies the maximum size of the returned stroke point list. The Inquire Default Stroke Device Data subroutine returns the maximum size of a stroke point list supported by the workstation.

FORTRAN

PSMSK (wkid, skdnr, n, viewi, np, pxa, pya)

Input Parameters

integer wkid
Workstation identifier.

integer skdnr
Stroke device number (>=1).

integer n
Dimension of arrays for stroke points.

Output Parameters

integer viewi
View index (>=0).

integer np
Number of points.

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

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

Errors

3
Function Requires State (PHOP,WSOP,*,*)
54
Specified Workstation Is Not Open
61
Specified Workstation Is Not Of Category Input Or Outin
250
Specified Device Not Available On Workstation
252
Function Requires Input Device To Be In Sample Mode

Related Subroutines

  • Inquire Number Of Available Logical Input Devices

  • Set Stroke Mode

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