Main addon
The main
addon has no public API, but contains
functionality to enable programs using Allegro to build and run without
platform-specific changes.
On platforms that require this functionality (e.g. OSX) this addon
contains a C main
function that invokes al_run_main with the user’s own
main
function, where the user’s main
function
has had its name mangled to something else. The file that defines the
user main
function must include the header file
allegro5/allegro.h
; that header performs the name mangling
using some macros.
If the user main
function is defined in C++, then it
must have the following signature for this addon to work:
int main(int argc, char **argv)
This addon does nothing on platforms that don’t require its functionality, but you should keep it in mind in case you need to port to platforms that do require it.
Link with allegro_main.