Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-Fileappl_exit()
Application Services Library
appl_init()                                                             AES

Syntax

WORD appl_init( VOID )

Function       appl_init() should be the first function called in any
               application that intends to use GEM calls.

Opcode         10 (0x0A)

Availability   All AES versions.

Parameters     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.

Binding        return crys_if(0x0A);

Return Value   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.
               GEM applications may not make any AES or VDI calls unless
               appl_init() succeeds.
               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.

Version Notes  See above.

See Also       appl_exit()

Group          Application Services Library