osx man page for init_dialog

init_dialog(3alleg4)						  Allegro manual					      init_dialog(3alleg4)

NAME

       init_dialog - Low level initialisation of a dialog. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

       DIALOG_PLAYER *init_dialog(DIALOG *dialog, int focus_obj);

DESCRIPTION

       This  function  provides  lower level access to the same functionality as do_dialog(), but allows you to combine a dialog box with your own
       program control structures. It initialises a dialog, returning a pointer to a player object that can be used with update_dialog() and shut-
       down_dialog(). With these functions, you could implement your own version of do_dialog() with the lines:

	  DIALOG_PLAYER *player = init_dialog(dialog, focus_obj);

	  while (update_dialog(player))
	     ;

	  return shutdown_dialog(player);

       Note  that you are responsible for showing and hiding the mouse cursor, which do_dialog would otherwise do for you, or saving and restoring
       the screen contents, as popup_dialog would do for you.

SEE ALSO

       update_dialog(3alleg4), shutdown_dialog(3alleg4), do_dialog(3alleg4)

Allegro 							   version 4.4.2					      init_dialog(3alleg4)