Topic       : The GFA-Basic Compendium
Author      : GFA Systemtechnik GmbH
Version     : GFABasic.HYP v2.98 (12/31/2023)
Subject     : Documentation/Programming
Nodes       : 899
Index Size  : 28056
HCP-Version : 3
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Document not found
@help       : Help
@options    : +g -i -s +z
@width      : 75
@hostname   : STRNGSRV
@hostname   : CAB     
@hostname   : HIGHWIRE
@hostname   : THING   
View Ref-FileDEFTEXT [color],[attr],[angle],[height],[fontnr]

color, attr, angle, height, fontnr: iexp

This command determines the appearance of a character string that is to be
displayed with TEXT. The parameter 'color', depending on the current
resolution, may contain a value between 0 and 255. The second parameter 'attr'
sets the text attributes which can be created by combinations of the values
given below:

    Bit Value    Effect      Example
    -    0  -->  Normal      Normal
    0    1  -->  Bold        Bold
    1    2  -->  Light       Light
    2    4  -->  Italic      Italic
    3    8  -->  Underlined  Underlined
    4   16  -->  Outlined    Outlined

The parameter 'angle' determines the direction of the text characters, the
value being specified in 1/10 degree steps in a clockwise direction.
















Note: However, only the following values are permitted by GEM:

       0  -->  From left to right (default)
     900  -->  From bottom to top
    1800  -->  From right to left, upside down
    2700  -->  From top to bottom

If a value other than one of the above is given, the nearest multiple of 900
is used.

The parameter 'height' specifies the text height of a capitol letter in pixels,
and with the normal character set only the following character heights are
actually readable:

     4  -->  Icon
     6  -->  Subscript
    13  -->  Normal character height
    32  -->  Expanded character height

Finally, the parameter 'fontnr' specifies the number of the desired character
set. This font must have previously been installed (see also GDOS:
VST_LOAD_FONTS(), VQT_NAME(), ...).

Example:

    FOR i|=0 TO 5
      DEFTEXT 1,2^i|,0,13
      TEXT 100,i|*16+100,"This is the text attribute "+STR$(i|)
    NEXT i|

--> Displays the example text with different attributes.

    VDI calls:
    DEFTEXT vst_color(),vst_effects(),vst_rotation(),vst_height(),vst_font()

Memo: Internally any call to this command also executes vqt_attributes().
      This is done so text effects in windows will look the same.

      Only parameters used generate code. Example: DEFTEXT ,,,,font
      This example generates code only for vst_font().

      Editor accepts DEFTEXT with no parameters. Has no effect.
        Generates a call to vqt_attributes() compiled.

vst_color()+, vst_effects()+, vst_rotation()+, vst_height()+, vst_font()+