appl_init() should be the first function called in any application that intends to use GEM calls. appl_init() initializes the AES. This is necessary if you are going to call any AES function, like the file selector, in your program. Calling this function is the first thing your program should do, and just after that, it should load any external resources with rsrc_load()?.

10 (0x0A)

All AES versions.

The function as prototyped accepts no parameters, however, all 'C' compilers use this call to set up internal information as well as to update the applications' global array.

appl_init() returns the applications' global identifier if successful or -1 if the AES cannot register the application. If successful, the global identifier should be stored in a global variable for later use. If not, then you mustn't use any AES calls, and just exit the application.

Besides the return value, the AES fills in the application's global array (to reference the global array see your programming languages' manual).

Name	global[x]	Meaning
_AESversion	0	AES version number.
_AESnumapps	1	Number of concurrent applications possible (normally 1). MultiTOS? will return -1.
_AESapid	2	Application identifier (same as appl_init() return value).
_AESappglobal	3-4	LONG? global available for use by the application.
_AESrscfile	5-6	Pointer to the base of the resource loaded via rsrc_load()?.
-	7-12	Reserved
_AESmaxchar	13	Current maximum character used by the AES to do vst_height()? prior to writing to the screen. This entry is only present as of AES version 0x0400.
_AESminchar	14	Current minimum character used by the AES to do vst_height()? prior to writing to the screen. This entry is only present as of AES version 0x0400.

See above.