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


GSPLI

GDDM-GKS V1R1 Programming Guide and Reference
SC33-0334-00
Purpose
 GSPLI  (pli)
   
 APL code  1317
 GKS RCP code  X'38001200' (939528704)
   
Function: To set polyline index.
Attribute function. Selects a bundle of polyline attributes to be used for polyline output primitives.
Parameters

pli (specified by user) (fullword integer)
The polyline index. A number that represents a bundle of polyline output attributes at the workstation.
Operating states
GKOP, WSOP, WSAC, SGOP
Related functions
Inquire polyline index (GQPLI), Set polyline representation (GSPLR)
Description
The current polyline index in the GKS state list is set to the value given by pli. This value is used when creating subsequent polyline primitives.
The appearance of polylines is determined by their color, and by the current line type and line width scale factor. Using Set polyline representation (GSPLR), you can define a number of bundles of values for these three attributes at any workstation. The bundles are stored in the polyline bundle table for the workstation. The polyline index is a pointer into the polyline bundle table at each workstation. When a polyline primitive is displayed, attributes from the bundle specified by the polyline index are used according to the corresponding aspect source flag (ASF). You use Set aspect source flags (GSASF) to define whether or not polyline attributes are to be taken from bundles on the output workstations. If the ASF for an attribute is bundled, the bundled attribute is used. An aspect source flag exists for each of these attributes:
  • Polyline color index
  • Line type
  • Line width scale factor.
If you do not call this function in your program before calling the Polyline (GPL) function, or if the index you request is not defined or is not available on the workstation, polyline index 1 is used.
Principal errors
8
GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC, or SGOP
60
Polyline index is invalid

Go to the previous page Go to the next page
Notices | Terms of use | Support | Contact z/OS



Copyright IBM Corporation 1990, 2012