GDDM-GKS V1R1 Programming Guide and Reference
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF | BOOK


GPL

GDDM-GKS V1R1 Programming Guide and Reference
SC33-0334-00



Purpose



 GPL  (n, px, py)
   
 APL code  1313
 GKS RCP code  X'38000C00' (939527168)
   


Function: To polyline.

Output function. Draws a sequence of connected straight lines between points.

Parameters


n (specified by user) (fullword integer)
The number of points.

px (specified by user) (array of short floating-point numbers)

py (specified by user) (array of short floating-point numbers)
The coordinates of the n points to be connected, in world coordinates.


Operating states


WSAC, SGOP

Related functions


Set linetype (GSLN), Set linewidth scale factor (GSLWSC), Set polyline color index (GSPLCI), Set polyline index (GSPLI), Set polyline representation (GSPLR), Set aspect source flags (GSASF)

Description


This function draws a sequence of connected straight lines, beginning with the first point and ending with the last point, given by the arrays px and py.

The current values of the polyline attributes, as given by the GKS state list, are bound to the polyline primitive.

If the line type is not solid, the line type starts at the start of the polyline and is not restarted at points in the polyline, or when clipping occurs.

Principal errors


5
GKS not in proper state: GKS shall be either in the state WSAC or in the state SGOP
100
Number of points is invalid

Go to the previous page Go to the next page



Copyright IBM Corporation 1990, 2012