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


GSSGP

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



Purpose



 GSSGP  (sgna, prior)
   
 APL code  1368
 GKS RCP code  X'38004300' (939541248)
   


Function: To set segment priority.

Segment function. Sets the priority for a segment.

Parameters


sgna (specified by user) (fullword integer)
The segment name.

prior (specified by user) (short floating point)
The segment priority.


Operating states


WSOP, WSAC, SGOP

Related functions


Create segment (GCRSG), Inquire segment attributes (GQSGA), Inquire dynamic modification of segment attributes (GQDSGA)

Description


This function sets "front-to-back" display priority for segment sgna. The segment priority in the segment state list for the segment is set to the value given by prior.

If displayed segments overlap, precedence is given to segments with higher priority. Segments with lower priority are displayed as being behind overlapping segments with a greater priority. If segments with the same priority overlap, the last segment drawn is placed on top.

Segment priority also affects pick input. When overlapping or intersecting segments are picked, the segment with the higher priority is delivered.

The following illustrations show the effect of the hierarchy of segment priorities. In the first display, the segments are drawn in the order in which they were created. Higher-numbered panels overlap lower-numbered ones.


   PICTURE 36          

The second display shows the effect of GSSGP when lower-numbered segments are assigned higher priorities. When segment priorities are set using this function, an implicit regeneration of the display may be required at workstations where the segment is displayed. If the implicit regeneration mode of a workstation is suppressed, you can call Redraw all segments on workstation (GRSGWK) to ensure a true representation of the graphics picture, including segment priority.


   PICTURE 37          

Principal errors


7
GKS not in proper state: GKS shall be in one of the states WSOP, WSAC, or SGOP
120
Specified segment name is invalid
122
Specified segment does not exist
126
Segment priority is outside the range (0,1)

Go to the previous page Go to the next page



Copyright IBM Corporation 1990, 2012