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


GSSGT

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



Purpose



 GSSGT  (sgna, m)
   
 APL code  1365
 GKS RCP code  X'38004000' (939540480)
   


Function: To set segment transformation.

Segment function. Assigns a predefined transformation to a segment.

Parameters


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

m (specified by user) (array of short floating-point numbers)
The transformation matrix.


Operating states


WSOP, WSAC, SGOP

Related functions


Evaluate transformation matrix (GEVTM), Accumulate transformation matrix (GACTM), Create segment (GCRSG), Inquire segment attributes (GQSGA), Inquire dynamic modification of segment attributes (GQDSGA)

Description


This function applies segment transformation matrix m to segment sgna. The segment transformation matrix in the segment state list for the segment is set to the matrix m.

Segment transformations scale, translate, and rotate the coordinates of the primitives in the displayed segment. You define the transformation values by calling Evaluate transformation matrix (GEVTM) or Accumulate transformation matrix (GACTM).

Application of the transformation is not cumulative. It does not affect the contents of the segment. The transformation is always applied to the segment as originally created. Applying the same segment transformation more than once to the segment gives identical results.

GSSGT transforms a segment stored on a workstation. It applies to all workstations where the segment is stored, even if they are not all active.

When a segment transformation is set by 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.

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

Go to the previous page Go to the next page



Copyright IBM Corporation 1990, 2012