GSPMI

GDDM-GKS V1R1 Programming Guide and Reference

GSPMI

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

Purpose


GSPMI	(pmi)

APL code	1321
GKS RCP code	X'38001600' (939529728)

Function: To set polymarker index.

Attribute function. Selects a bundle of polymarker attributes to be used for subsequent polymarker output primitives.

Parameters

pmi (specified by user) (fullword integer)
The polymarker index. A number that represents a bundle of polymarker output attributes at the workstation.

Operating states

GKOP, WSOP, WSAC, SGOP

Related functions

Set polymarker representation (GSPMR), Inquire polymarker index (GQPMI)

Description

The current polymarker index in the GKS state list is set to the value given by pmi. This value is used when creating subsequent polymarker primitives.

The appearance of polymarkers is determined by their color, and by the current marker type and marker size scale factor. Using Set polymarker representation (GSPMR), you can define a number of bundles of values for these three attributes at any workstation. The bundles are stored in the polymarker bundle table for the workstation. The polymarker index is a pointer into the polymarker bundle table at each workstation. When a polymarker primitive is displayed, attributes from the bundle specified by the polymarker index are used according to the corresponding aspect source flag (ASF). You use Set aspect source flags (GSASF) to define whether or not polymarker attributes are to be taken from bundles for 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 polymarker attributes:

Polymarker color index
Marker type
Marker size scale factor.

If you do not call this function in your program before calling the Polymarker (GPM) function, or if the index you request is not defined or is not available on the workstation, polymarker 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
66: Polymarker index is invalid

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