User Tools

Site Tools


jvs:cigal:manual:chapter6:r_text

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:
R_NUMBER(6), R_WORD(6)

CIGAL Home, CIGAL Manual, RealTime List, Manual Help

jvs/cigal/manual/chapter6/r_text.txt · Last modified: 2023/02/23 18:43 (external edit)