Provided by: allegro4-doc_4.4.2-10_all bug

NAME

       install_allegro - Initialise the Allegro library.

SYNOPSIS

       #include <allegro.h>

       int install_allegro(int system_id, int *errno_ptr, int (*atexit_ptr)());

DESCRIPTION

       Initialises  the Allegro library. You must call either this or allegro_init() before doing
       anything other than using the Unicode routines. If you want to use a text mode other  than
       UTF-8,  you  can  set it with set_uformat() before you call this. The other functions that
       can be called before this one  will  be  marked  explicitly  in  the  documentation,  like
       set_config_file().

       The  available system ID codes will vary from one platform to another, but you will almost
       always want to pass SYSTEM_AUTODETECT. Alternatively, SYSTEM_NONE installs a stripped down
       version  of  Allegro  that  won't  even try to touch your hardware or do anything platform
       specific: this can be useful for situations where  you  only  want  to  manipulate  memory
       bitmaps, such as the text mode datafile tools or the Windows GDI interfacing functions.

       The  `errno_ptr' and `atexit_ptr' parameters should point to the errno variable and atexit
       function from your libc: these are required because when Allegro is linked as  a  DLL,  it
       doesn't  have  direct  access  to your local libc data. `atexit_ptr' may be NULL, in which
       case it is your responsibility to call allegro_exit() manually. Example:

          install_allegro(SYSTEM_AUTODETECT, &errno, atexit);

RETURN VALUE

       This function returns zero on success and non-zero on failure (e.g. no system driver could
       be used). Note: in previous versions of Allegro this function would abort on error.

SEE ALSO

       allegro_init(3alleg4),             allegro_exit(3alleg4),            set_uformat(3alleg4),
       set_config_file(3alleg4)