GSPMR

GDDM-GKS V1R1 Programming Guide and Reference

GSPMR

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

Purpose


GSPMR	(wkid, pmi, mtype, mszsf, coli)

APL code	1345
GKS RCP code	X'38002C00' (939535360)

Function: To set polymarker representation.

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

Parameters

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

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

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

1 (GPOINT): Small dot
2 (GPLUS): Plus
3 (GAST): Asterisk
4 (GOMARK): Circle
5 (GXMARK): Diagonal cross

mszsf (specified by user) (short floating point)
The marker size scale factor. A scale factor applied to the workstation nominal marker size. The result is mapped by the workstation to the nearest available marker size.

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

Operating states

WSOP, WSAC, SGOP

Related functions

Inquire polymarker representation (GQPMR), Polymarker (GPM), Set polymarker index (GSPMI), Set aspect source flags (GSASF), Inquire polymarker facilities (GQPMF)

Description

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

The polymarker 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 using this function.

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

Marker type ASF
Marker size scale factor ASF
Polymarker color index ASF.

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

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


Value	Symbol
-6	Shaded box
-5	Shaded diamond
-4	Asterisk (6 points)
-3	Hollow box
-2	Hollow diamond
-1	Scalable dot
1	Dot
2	Plus
3	Asterisk (8 points)
4	Circle
5	Diagonal cross

Marker type 1 is not scaled; when it is drawn at a workstation, GDDM-GKS ensures that the smallest clearly-visible dot is used.

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
66: Polymarker index is invalid
69: Marker type is equal to zero
70: Specified marker type is not supported on this workstation
71: Marker size scale factor is less than zero
93: Color index is invalid

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