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)