Syntax
[C/C++:]
void gDisplayStr(char string[]);
[F90:]
subroutine gDisplayStr(string)
character*(*), intent(in) :: string
Arguments
string
Any character argument (except array name)
Description
The routine gDisplayStr() outputs a character string consisting of any combination of characters in the ASCII set and any special characters permitted by the system. Strings should be terminated by *. otherwise the number of characters is limited to the total length of
string up to a maximum of 255 characters.
The following escape sequences offer control of various functions:
*L or *l- shift into lower case
*U or *u- shift into upper case
*Fnnn or *fnnn temporary change to font nnn where nnn = 000 to 199 (see gSetCharFont())
*N or *n- move to next line (see gStartTextBlock(), gMoveToNextLine())
*E or *e- activate current exponent position and size settings (see gSetStrExponent())
*I or *i- activate current index position and size settings (see gSetStrExponent())
*O or *o- position next character over previous character at exponent size setting
*S or *s- start underscore (see gSetStrUnderscore())
*W or *w- increase current font weight by 3 (see gSetFontWeight())
*\- set italic angle to -15 degrees (see gSetItalicAngle())
*|- reset italic angle to that on entry
*/- set italic angle to +15 degrees (see gSetItalicAngle())
*A or *a- set current position on base line as an alignment position
(used to switch exponent, index positioning and character size off and
also resets underline and weight)
*B or *b- move back to last align position on base line
*:- displays umlaut form of character if followed by aouAOU
*:S- displays German sz character if available in current font
** means output *
The escape character * can be set to any other character by the gSetEscapeChar() routine.
The characters are drawn using the current font with its weight and representation set by the most recent calls to gSetFontWeight() and gSetFontForm() respectively. If the *F escape sequence is used this will make a temporary change to the current font for the output of this string only. Two further facilities are available for controlling the font.
*FS sets the GINO font to the temporary string font.
*FR restores the font which was current when the string routine was called.
If *N is used, the routine gStartTextBlock() must have been called to set up a text block start position, otherwise a warning message is output and the next line is positioned below the end of the previous string.
Multiple use of *E or *I adjusts the position above or below the base line for each occurrence.
The start and end position and direction of the string are determined by the current setting of character justification (see gSetStrJustify()).
Hardware or software characters are output depending on the current setting of gSetHardChars(), gSetPointChars(), gSetMixedChars() or gSetSoftChars() and they are drawn subject to the current size, orientation, italics and underline. These settings may not be exactly matched for hardware characters. If GINO transformable characters are currently selected (using gSetCharTransformMode()), the string will be output using vectors, in the current line style subject to the current transformation and viewing setting.
All character codes outside the range 0 to 255 are output as ASCII code 47, a '/'. In addition, if software characters are being output then all character codes outside the range 25-127 are also output as a '/'. The exception being the codes representing the a,o, u umlaut and beta characters according to the characters code of the current implementation (DOS or ISO). Thus the following ASCII codes are mapped onto the special characters provided in several GINO software fonts:
DOS ISO Char
132 228
148 246
129 252 
225 223
142 196
153 214
154 220
See Also
gDisplayStr UsagegPrintfgMoveToNextLinegSetStrExponentgSetCharFontgSetStrJustifygSetStrUnderscoregSetFontFormgSetFontWeightgSetItalicAnglegSetEscapeChargSetCharTransformMode
