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  Al-
     legro  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(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+15.1.quarterly>

home | help