Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
allegro_message(3)		Allegro	manual		    allegro_message(3)

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  dif-
       ferences	 by reducing any accented characters to	7-bit ASCII approxima-
       tions.  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(3),	install_allegro(3), set_uformat(3)

Allegro				 version 4.4.3		    allegro_message(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=allegro_message&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help