◄Summary► ◄Example►                         ◄Up► ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
 
     The settextcolor function sets the current text color to the color
     index specified by <index>. The default text color is the same as
     the maximum color index.
 
     The settextcolor routine sets the color for the outtext function.
     It does not affect the color of the WRITE statement or the color of
     text output with the outgtext font routine. Use the setcolor
     function to change the color of font output.
 
     In text color mode, you can specify a color index in the range
     0-31. The colors in the range 0-15 are interpreted as normal.
     Colors in the range 16-31 are the same as those in the range 0-15
     but also have blinking text. The normal color range is defined
     below:
 
     Index     Color
 
     0         Black
     1         Blue
     2         Green
     3         Cyan
     4         Red
     5         Magenta
     6         Brown
     7         White
     8         Dark gray
     9         Light blue
     10        Light green
     11        Light cyan
     12        Light red
     13        Light magenta
     14        Yellow
     15        Bright white
 
     In every text mode, including monochrome, the getvideoconfig
     function returns the value 32 for the number of available colors.
     The value 32 indicates the range of values (0-31) accepted by the
     settextcolor function. This includes sixteen normal colors (0-15)
     and sixteen blinking colors (16-31).
 
     Blinking is selected by adding 16 to the normal color value. Some
     color values are redundant because monochrome text mode has fewer
     unique display attributes. However, because blinking is selected in
     the same manner, monochrome text mode has the same range (0-31) as
     other text modes.
 
     Return Value
 
     The function returns the color index of the previous text color.
                                    -♦-