===== outtext =====


====Syntax of outtext ==== 
 <code c>
#include <graphics.h>
void outtext(char *textstring);
  </code>


==== Description of outtext ==== 
<code c>
outtext displays a text string in the viewport, using the current font,
direction, and size.
outtext outputs textstring at the current position (CP). If the
horizontal text justification is LEFT_TEXT and the text direction is
HORIZ_DIR, the CP's x-coordinate is advanced by textwidth(textstring).
Otherwise, the CP remains unchanged.
To maintain code compatibility when using several fonts, use textwidth
and textheight to determine the dimensions of the string.
If a string is printed with the default font using outtext, any part of
the string that extends outside the current viewport is truncated.
outtext is for use in graphics mode; it will not work in text mode.
</code>


==== Example of outtext ====
<code c>
/* outtext example */

#include <graphics.h>
#include <stdlib.h>
#include <stdio.h>
#include <conio.h>

int main(void)
{
   /* request autodetection */
   int gdriver = DETECT, gmode, errorcode;
   int midx, midy;

   /* initialize graphics and local variables */
   initgraph(&gdriver, &gmode, "");

   /* read result of initialization */
   errorcode = graphresult();
   if (errorcode != grOk) {  /* an error occurred */
printf("Graphics error: %s\n", grapherrormsg(errorcode));

printf("Press any key to halt:");
getch();
exit(1);   /* terminate with an error code */
   }

   midx = getmaxx() / 2;
   midy = getmaxy() / 2;

   /* move the CP to the center of the screen */
   moveto(midx, midy);

   /* output text starting at the CP */
   outtext("This ");
   outtext("is ");
   outtext("a ");
   outtext("test.");

   /* clean up */
   getch();
   closegraph();
   return 0;
}
</code>


==== See also ====
[[gettextsettings]]
[[outtextxy]]
[[settextjustify]]
[[textheight]]
[[textwidth]]


===== output of outtext example ===== 

    no output of example at the moment
    do not hesitate and add it...