Click above to get retro games delivered to your door ever month!

Synopsis:
    #include <graph.h>
    void _FAR _outgtext( char _FAR *text );

Description:
    The _outgtext function displays the character string indicated by the
    argument text.  The string must be terminated by a null character
    ('\0').

    The string is displayed starting at the current position (see the
     _moveto function) in the current color and in the currently selected
    font (see the  _setfont function).  The current position is updated to
    follow the displayed text.

    When no font has been previously selected with  _setfont, a default font
    will be used.  The default font is an 8-by-8 bit-mapped font.

    The graphics library can display text in three different ways.

     1. The  _outtext and  _outmem functions can be used in any video mode.
        However, this variety of text can be displayed in only one size.

     2. The  _grtext function displays text as a sequence of line segments,
        and can be drawn in different sizes, with different orientations and
        alignments.

     3. The  _outgtext function displays text in the currently selected
        font.  Both bit-mapped and vector fonts are supported; the size and
        type of text depends on the fonts that are available.


Returns:
    The _outgtext function does not return a value.

Example:
    #include <conio.h>
    #include <stdio.h>
    #include <graph.h>

    main()
    {
        int i, n;
        char buf[ 10 ];

        _setvideomode( _VRES16COLOR );
        n = _registerfonts( "*.fon" );
        for( i = 0; i < n; ++i ) {
            sprintf( buf, "n%d", i );
            _setfont( buf );
            _moveto( 100, 100 );
            _outgtext( "WATCOM Graphics" );
            getch();
            _clearscreen( _GCLEARSCREEN );
        }
        _unregisterfonts();
        _setvideomode( _DEFAULTMODE );
    }

Classification:
    PC Graphics

Systems:
    DOS, QNX

See Also:
    _registerfonts, _unregisterfonts, _setfont, _getfontinfo,
    _getgtextextent, _setgtextvector, _getgtextvector, _outtext, _outmem,
    _grtext