CHARACTER

This Command displays Characters on a Viewport (if the Viewport itself is visible).

Parameters

TEXT

Text to be Displayed. This will be converted into upper case unless it is enclosed in quotes. Text containing embedded word separator characters (spaces, commas etc.) should also be enclosed in quotes.

Qualifiers

/COLUMN=<x-cor>

COLUMN is a synonym for X_COR.

/ROW=<x-cor>

ROW is a synonym for Y_COR.

/STYLE=<style>

Overrides the default Text Style for the Viewport. The possible Style attributes are BLINK, BOLD, REVERSE and UNDERLINE and they may be specified using the following syntax:-

/STYLE=(BOLD,REVERSE,...)

\

Omitting the attributes will result in normal Text and the parentheses may be omitted if only a single attribute is desired.

/VIEWPORT=<id>

Specifies the Viewport within which the Characters are to be displayed. This defaults to the current Viewport (as defined by the previous VIEWPORT Command) if this Qualifier is absent or has no associated Value. The syntax of the Viewport ID is described in full for the VIEWPORT Command.

/X_COR=<x-cor>

This specifies the desired horizontal placement of the first Character of the text String. If this Qualifier is omitted, then the current X Coordinate will be used. The X-Coordinate should be specified in the units appropriate for the current Viewport Display Mode (See the MODE/VIEWPORT Command). Thus, for TEXT Viewport Mode the units are in Columns and may be specified as Integer or Floating Point Numbers, while for GRAPHICS Mode they are in Graphics Units and must be specified in Floating Point.

/Y_COR=<y-cor>

This specifies the desired vertical placement of the first Character of the text String. If this Qualifier is omitted, then the current Y Coordinate will be used. The Y-Coordinate should be specified in the units appropriate for the current Viewport Display Mode (See the MODE/VIEWPORT Command). Thus, for TEXT Viewport Mode the units are in Columns and may be specified as Integer or Floating Point Numbers, while for GRAPHICS Mode they are in Graphics Units and must be specified in Floating Point.

The specified Text will only be actually displayed on the terminal screen if the corresponding Viewport has been made visible (via a DISPLAY Command). Qualifiers may be attached either to the Keyword or to the Character Text and thus the following is legal:-

CHAR/STYLE=(BOLD,REVERSE) "Text String"/XCOR=10.0