GSPLR

GDDM-GKS V1R1 Programming Guide and Reference

GSPLR

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

Purpose


GSPLR	(wkid, pli, ltype, lwidth, coli)

APL code	1344
GKS RCP code	X'38002B00' (939535104)

Function: To set polyline representation.

Attribute function. Creates a bundle of polyline attributes and associates them with a polyline index at a workstation.

Parameters

wkid (specified by user) (fullword integer)
The workstation identifier.

pli (specified by user) (fullword integer)
The polyline index number to represent the group of characteristics specified in the other parameters of this function.

ltype (specified by user) (fullword integer)
The identifier for a specific line type. This should be either a negative value, indicating an implementation-dependent line type, or one of the following:

1 (GLSOLI): Solid
2 (GLDASH): Dash
3 (GLDOT): Dotted
4 (GLDASD): Dash-dotted

lwidth (specified by user) (short floating point)
The line-width scale factor. A scale factor applied to the workstation nominal line width. The result is mapped by the workstation to the nearest line width available.

coli (specified by user) (fullword integer)
The polyline color index. A pointer into the color table at the workstation.

Operating states

WSOP, WSAC, SGOP

Related functions

Inquire polyline representation (GQPLR), Polyline (GPL), Set polyline index (GSPLI), Set aspect source flags (GSASF), Inquire polyline facilities (GQPLF)

Description

This function creates a bundle of attribute values and associates them with polyline index pli at workstation wkid. The bundle is stored in the polyline bundle table of the workstation.

The polyline bundle table in the workstation state list has predefined entries taken from the workstation description table when the workstation is opened. Any table entry (including the predefined entries) may be redefined with this function.

When a polyline is displayed, the current polyline index refers to an entry in the polyline bundle table. If polylines are displayed with a polyline index that is not present in the polyline bundle table, polyline index 1 is used. Which of the attributes in the bundle table entry are used depends on the setting of the following polyline attribute aspect source flags:

Line type ASF
Line-width scale factor ASF
Polyline color index ASF.

If a polyline representation is set by this function, the changes may affect the displayed primitives by causing an implicit regeneration of the display, depending on the workstation implicit regeneration mode.

The line types specified by negative values of ltype are implementation-dependent and availability is workstation-dependent. The following table shows the values for ltype supported by GDDM-GKS.


Value	Line type
-4	Solid line (same as 1)
-3	Dash-double-dot line
-2	Long-dashed line
-1	Double-dotted line
1	Solid
2	Dashed line (short dashes)
3	Dotted line
4	dash-dotted line

Principal errors

7: GKS not in proper state: GKS shall be in one of the states WSOP, WSAC, or SGOP
20: Specified workstation identifier is invalid
25: Specified workstation is not open
33: Specified workstation is of category MI
35: Specified workstation is of category INPUT
36: Specified workstation is Workstation Independent Segment Storage
60: Polyline index is invalid
63: Linetype is equal to zero
64: Specified linetype is not supported on this workstation
65: Linewidth scale factor is less than zero
93: Color index is invalid

Notices | Terms of use | Support | Contact z/OS