1textout_ex(3) Allegro manual textout_ex(3)
2
3
4
6 textout_ex - Writes a string on a bitmap. Allegro game programming
7 library.
8
10 #include <allegro.h>
11
12
13 void textout_ex(BITMAP *bmp, const FONT *f, const char *s, int x, int
14 y, int color, int bg);
15
17 Writes the string `s' onto the bitmap at position x, y, using the spec‐
18 ified font, foreground color and background color. If the background
19 color is -1, then the text is written transparently. If the foreground
20 color is -1 and a color font is in use, it will be drawn using the col‐
21 ors from the original font bitmap (the one you imported into the grab‐
22 ber program), which allows multicolored text output. For high and true
23 color fonts, the foreground color is ignored and always treated as -1.
24 Example:
25
26 /* Show the program's version in blue letters. */
27 textout_ex(screen, font, "v4.2.0-beta2", 10, 10,
28 makecol(0, 0, 255), -1);
29
30
32 font(3), textout_centre_ex(3), textout_right_ex(3), textout_jus‐
33 tify_ex(3), textprintf_ex(3), text_height(3), text_length(3)
34
35
36
37Allegro version 4.2.3 textout_ex(3)