NAME¶
allegro_message - Used mainly to show error messages to users. Allegro game
programming library.
SYNOPSIS¶
#include <allegro.h>
void allegro_message(const char *text_format, ...);
DESCRIPTION¶
Outputs a message, using a printf() format string. Usually you want to use this
to report messages to the user in an OS independent way when some Allegro
subsystem cannot be initialised. But you must not use this function if you are
in a graphic mode, only before calling set_gfx_mode(), or after a
set_gfx_mode(GFX_TEXT). Also, this function depends on a system driver being
installed, which means that it won't display the message at all on some
platforms if Allegro has not been initialised correctly.
On platforms featuring a windowing system, it will bring up a blocking GUI
message box. If there is no windowing system, it will try to print the string
to a text console, attempting to work around codepage differences by reducing
any accented characters to 7-bit ASCII approximations. Example:
if (allegro_init() != 0)
exit(1);
if (init_my_data() != 0) {
allegro_message("Sorry, missing game data!\n");
exit(2);
}
SEE ALSO¶
allegro_init(3alleg4),
install_allegro(3alleg4),
set_uformat(3alleg4)