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

Synopsis:
    #include <graph.h>
    short _FAR _grtext( short x, short y,
                        char _FAR *text );

    short _FAR _grtext_w( double x, double y,
                          char _FAR *text );

Description:
    The _grtext functions display a character string.  The _grtext function
    uses the view coordinate system.  The _grtext_w function uses the window
    coordinate system.

    The character string text is displayed at the point (x,y).  The string
    must be terminated by a null character ('\0').  The text is displayed in
    the current color using the current text settings.

    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 _grtext functions return a non-zero value when the text was
    successfully drawn; otherwise, zero is returned.

See Also:
    _outtext, _outmem, _outgtext, _setcharsize, _setcharsize_w, _settextalign, _settextpath,
    _settextorient, _setcharspacing, _setcharspacing_w

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

    main()
    {
        _setvideomode( _VRES16COLOR );
        _grtext( 200, 100, " WATCOM" );
        _grtext( 200, 200, "Graphics" );
        getch();
        _setvideomode( _DEFAULTMODE );
    }

    produces the following:

    The graphical image cannot be reproduced here. See the printed
    version of the manual.

Classification:
    PC Graphics

Systems:
     _grtext - DOS, QNX

    _grtext_w - DOS, QNX