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

REQUEST STROKE (PHOP,WSOP,*,*)

Purpose

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

A status of NONE means that a break action occurred. Otherwise, the graPHIGS API returns a status of OK together with a sequence of World Coordinate (WC) points and the view table index which has a matrix that the graPHIGS API used to convert the stroke locations from Device Coordinates (DC) to World Coordinates. The graPHIGS API sets these values according to the current measure of the stroke device.

This subroutine returns the stroke input from the view with the highest input priority that 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 Request Stroke 3 subroutine for the same operator action.

Language Bindings

C

preq_stroke (ws_id, stroke_num, in_status, view_ind, stroke)

Input Parameters

Pint ws_id
Workstation identifier.

Pint stroke_num
Stroke device number (>=1).

Output Parameters

Pin_status *in_status
Input status (0=PIN_STATUS_NONE, 1=PIN_STATUS_OK).

Pint *view_ind
View index.

Ppoint_list *stroke
Requested stroke point list. 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

PRQSK (wkid, skdnr, n, stat, 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 stat
Input status (0=PNONE, 1=POK).

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
251
Function Requires Input Device To Be In Request Mode

Related Subroutines

  • Initialize Stroke

  • Inquire Number Of Available Logical Input Devices

  • Set Stroke Mode

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