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 shutdown_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)