GTX

GDDM-GKS V1R1 Programming Guide and Reference

GTX

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

Purpose


GTX	(px,py,chars)

Function: Output function. Draws a text string at a given position. Use this call only if your program is written in VS FORTRAN. Otherwise, use the function Text (GTXS) instead. (See the section "GDDM-GKS restrictions" below.)

Parameters

px (specified by user) (short floating point)

py (specified by user) (short floating point)
The position of the string in world coordinates.

chars (specified by user) (character)
The string of characters to be drawn.

Operating states

WSAC, SGOP

Related functions

Set text font and precision (GSTXFP), Set text color index (GSTXCI), Set character height (GSCHH), Set character up vector (GSCHUP), Set text alignment (GSTXAL), Inquire text color index (GQTXCI), Inquire text font and precision (GQTXFP), Inquire text alignment (GQTXAL), Inquire text extent (GQTXXS), Inquire text facilities (GQTXF), Set aspect source flags (GSASF), Set text representation (GSTXR), Set text index (GSTXI)

Description

(See the section "GDDM-GKS restrictions" below.)

This function displays a string of text at the position (px, py) in world coordinates.

The current text attributes are bound to the primitive.

If the character string contains control characters or undefined characters, the effect is workstation-dependent. Control characters included in the string can cause error 101 to be reported. Even if error 101 is reported, the character string is generated on the active workstations that do not report the error. If these are WISS or metafile output workstations, error 101 can be reported when the string is later displayed at a workstation.

GDDM-GKS restrictions

On the workstations supported by GDDM-GKS, only one control character, X'15', is valid; it is interpreted as a "new line" character. Character code X'FF' has a reserved meaning and must not be used.

The symbols displayed depend on the text font used when the string is displayed at a workstation. If the text font is -65 (DBSC Kanji or Hangeul symbols) or if the GDDM external defaults specify MIXSOSI=YES, the character strings can contain DBCS characters. If text font -65 has not been set but MIXSOSI=YES, DBCS character strings should be delimited by shift-out (SO) (X'0E') and shift-in (SI) (X'0F') control codes. Invalid use of DBCS code points may cause error 304 to be reported.

If lstr is less than zero, GDDM-GKS will report error 2001.

Principal errors


        5  GKS not in proper state: GKS shall be either in the state
           WSAC or in the state SGOP
      101  Invalid code in string
     2001  Output parameter size insufficient

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