textout_ex(3) Allegro manual textout_ex(3)NAMEtextout_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 spec‐
ified 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 col‐
ors from the original font bitmap (the one you imported into the grab‐
ber 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 ALSOfont(3), textout_centre_ex(3), textout_right_ex(3), textout_jus‐
tify_ex(3), textprintf_ex(3), text_height(3), text_length(3)Allegro version 4.4.2 textout_ex(3)