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.2		    allegro_message(3)

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO

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

home | help