textout_ex(3)                   Allegro manual                   textout_ex(3)



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(3), textout_centre_ex(3), textout_right_ex(3),
       textout_justify_ex(3), textprintf_ex(3), text_height(3), text_length(3)



Allegro                          version 4.2.3                   textout_ex(3)
