**CIGAL Reference Manual, Chapter 6 (RealTime): r_text**
===== r_text -- Display a text string on the screen =====
**usage: r_text   opflg eflag ltime Point TextStr [Flg Maxchar]**

R_TEXT is a REALTIME operator that displays a string of text on the screen.
The position of the text display is specified by POINT, an array of 2 integer
values for X and Y. TEXTSTR can either be a simple character string variable
or a string list variable.  If it is a string list then the list pointer will
automatically be incremented by R_TEXT, so that repeated calls to R_TEXT would
display successive strings from the list.  No incrementing is done for simple
string variables.

The FLG variable is a bit flag that can be used as follows:
      1 - center the displayed text at POINT
      2 - before displaying text first clear previous text at that POINT
      4 - adjust POINT to point to the end of the displayed text
      8 - do not increment the string pointer (if TEXTSTR is a string list)
          This allows the same text to be displayed more than once.
     16 - adjust POINT to point to 1 space after the end of the displayed text
          If MAXCHAR is specified and non-zero it will be used as the maximum number of
          text characters that will be displayed.

**See Also:**\\
[[jvs:cigal:manual:chapter6:r_number|R_NUMBER(6)]], 
[[jvs:cigal:manual:chapter6:r_word|R_WORD(6)]]

[[jvs:cigal|CIGAL Home]], 
[[jvs:cigal:manual|CIGAL Manual]], 
[[jvs:cigal:manual:chapter6|RealTime List]], 
[[jvs:cigal:manual:help|Manual Help]]