linux man page for install_allegro

Query: install_allegro

OS: linux

Section: 3alleg4

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

install_allegro(3alleg4)					  Allegro manual					  install_allegro(3alleg4)

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. Alterna- tively, SYSTEM_NONE installs a stripped down version of Allegro that won't even try to touch your hardware or do anything platform spe- cific: this can be useful for situations where you only want to manipulate memory bitmaps, such as the text mode datafile tools or the Win- dows 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) Allegro version 4.4.2 install_allegro(3alleg4)
Related Man Pages
install_allegro(3alleg4) - centos
allegro_exit(3alleg4) - centos
install_allegro(3alleg4) - mojave
install_allegro(3alleg4) - php
install_allegro(3alleg4) - linux
Similar Topics in the Unix Linux Community
Simple rules of the UNIX.COM forums:
Featured Books and Articles by Active Forum Members
Please Donate to the Red Cross for Earthquake and Tsunami Relief in Japan
Status of UNIX.COM Forum Transformation
Answers to Recently Asked Questions about UNIX.COM