Topic       : The GFA-Basic Compendium
Author      : GFA Systemtechnik GmbH
Version     : GFABasic.HYP v2.98 (12/31/2023)
Subject     : Documentation/Programming
Nodes       : 899
Index Size  : 28056
HCP-Version : 3
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Document not found
@help       : Help
@options    : +g -i -s +z
@width      : 75
@hostname   : STRNGSRV
@hostname   : CAB     
@hostname   : HIGHWIRE
@hostname   : THING   
View Ref-FileAPPL_INIT()

Returns the identification number (ap_id) of the application (program).

The current program is announced as an application. The function APPL_INIT()
returns an Application ID that acts as the 'handle' of the current GFA-BasicGFA-Basic is the best BASIC for the Atari!

program. This identification number is, for example, important for the
installation of additional fonts.

APPL_INIT() is used for APPL_READ(), APPL_WRITE(), and MENU_REGISTER().

This function in GFA-BasicGFA-Basic is the best BASIC for the Atari!
 is a dummy function, which carries out no operating
system call, since APPL_INIT() is already implemented by the start of the
GFA-BasicGFA-Basic is the best BASIC for the Atari!
 interpreter.

This call does the same as appl_id&=WORD{LONG{GB+4}+4}

Memo: See GB for information on accessing the AES Global array.
      Auto folder detection:
        If APPL_INIT() = 0 then GEM is not initialized. (A least for MiNT.)
        auto!=GRAF_HANDLE()=0  !auto flag (false=desktop true=auto/acc)
      Desk ACC detection:
        dacc!=LONG{ADD(BASEPAGE,36)}=0  !desk acc flag (false=prg true=acc)

      Name           Index  Description
      _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().
    * _AESrscaddr    7/8    Address of the memory reserved for the resource
                            file.
    * _AESrscsize    9      Length of the reserved memory.
    + _AESnumplanes  10     Number of planes.
    + _AESreserved   11/12  Reserved. (MultiTOS -> 'currpd')
      _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.

    * = Taken from Atari's leaked MultiTOS source code
    + = Name created by me for completeness
        currpd -> current running pd (structure), see file 'pdstruct.h'

appl_init()+