Provided by: allegro4-doc_4.4.2-13_all bug

NAME

       textout_ex - Writes a string on a bitmap. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

       void  textout_ex(BITMAP  *bmp,  const FONT *f, const char *s, int x, int y, int color, int
       bg);

DESCRIPTION

       Writes the string `s' onto the  bitmap  at  position  x,  y,  using  the  specified  font,
       foreground  color  and  background  color. If the background color is -1, then the text is
       written transparently. If the foreground color is -1 and a color font is in use,  it  will
       be  drawn  using  the  colors from the original font bitmap (the one you imported into the
       grabber program), which allows multicolored text output. For high and  true  color  fonts,
       the foreground color is ignored and always treated as -1. Example:

          /* Show the program's version in blue letters. */
          textout_ex(screen, font, "v4.2.0-beta2", 10, 10,
                     makecol(0, 0, 255), -1);

SEE ALSO

       font(3alleg4),            textout_centre_ex(3alleg4),           textout_right_ex(3alleg4),
       textout_justify_ex(3alleg4),         textprintf_ex(3alleg4),         text_height(3alleg4),
       text_length(3alleg4)