WORD appl_getinfo(WORD *ap_gout1, WORD *ap_gout2, WORD *ap_gout3, WORD *ap_gout4)

Description:  Returns information about the AES.

Opcode:  130  (0x0082)

Availability:  Available if the call appl_find("?AGI") returns -1.

Parameters:  
    ap_gtype specifies the type of information to be returned in the 
    shorts pointed to by ap_gout1, ap_gout2, ap_gout3, and ap_gout4.



Binding:  
    intin[0] = ap_gtype;
    crys_if(0x82);
    *ap_gout1 = intout[1];
    *ap_gout2 = intout[2];
    *ap_gout3 = intout[3];
    *ap_gout4 = intout[4];
    return intout[0];
Return value:  Returns 0 if an error occurred or 1 otherwise.

Definition:
    Values get by parameters depending on ap_gtype value:

     AES_LARGEFONT (0) : AES large font informations:
                         ap_gout1 = AES font's point size
                         ap_gout2 = font id
                         ap_gout3 = type of font (0=system, 1 outline font)

    AES_SMALLFONT (1) : same as above for current small font

    AES_SYSTEM (2) : AES System Specifics:
                         ap_gout1 = resolution number (see Getrez())                                    ap_gout2 = number of colors supported by AES objects
                         ap_gout3 = 1 if color icon supported, 0 else
                         ap_gout4 = 1 if extended resource file supported, 0 else

     AES_LANGUAGE (3) : AES Globalization 
                 ap_gout1 = current language :
                         0 (uk) 1 (de) 2 (fr) 3 (reserved) 4 (sp) 5 (it) 6 (se)

    AES_PROCESS (4) : AES Multiple Process Support 
    ap_gout1 = 1 if system is pre-emptive multitasking, 0 else.
    ap_gout2 = 1 if appl_find() can convert between MiNT and AES process id's, 0 else.
    ap_gout3 = 1 if appl_search() is implemented, 0 else.
    ap_gout4 = 1 if rsrc_rcfix() is implemented, 0 else.

    AES_PCGEM (5) : AES PC-GEM Features 
    ap_gout1 = 1 if objc_xfind() is implemented, 0 else.
    ap_gout2 is currently reserved.
    ap_gout3 = 1 if menu_click() is implemented, 0 else.
    ap_gout4 = 1 if shel_rdef() and shel_wdef() are implemented, 0 else.

    AES_INQUIRE (6) : AES Extended Inquiry Functions 
    ap_gout1 = 1 if -1 is a valid ap_id parameter to appl_read(), 0 else.
    ap_gout2 = 1 if -1 is a valid lenght parameter to shel_get(), 0 else.
    ap_gout3 = 1 if -1 is a valid mode parameter to menu_bar(), 0 else.
    ap_ogut4 = 1 if MENU_INSTL is a valid mode parameter to menu_bar(), 
    0 else.

    AES_EXTENSION (7) : AES System Extension
    ap_gout1 describes extensions avalaible :
    bit 0: wdlg_xx()-functions are present
    bit 1: lbox_xx()-functions are present 
    bit 2: fnts_xx()-functions are present
    bit 3: fslx_xx()-functions are present
    bit 4: pdlg_xx()-functions are present
    fslx_xx() functions are available with MagiC 5 or with some fileselector
    such as BoxKite. Others extensions are provided by WDIALOG, a patch 
    which is compatible with all TOS version.

    AES_MOUSE (8) : AES Mouse Support 
    ap_gout1 = 1 if 258-260 are value mode parameters to graf_mouse(), 0 else.
    ap_gout2 = 1 if the mouse form is controled by AES, 0 if is controled by application.
    ap_gout3, ap_gout4 are currently unused.

    AES_MENU (9) : AES Menu Support
    ap_gout1 = 1 if MultiTOS style sub-menus are supported, 0 else.
    ap_gout2 = 1 if MultiTOS style popup menus are  supported, 0 else.
    ap_gout3 = 1 if MultiTOS style scrollable menus are supported, 0 else.
    ap_gout4 = 1 if MN_SELECTED message contains object tree information in            parameter msg[5-7], 0 else.

    AES_SHELL (10) : AES Shell Support
    ap_gout1 & 0x00FF : indicates the highest legal value for the mode parameter                      of shel_write.
     ap_gout1 & 0xFF00 : indicates which extended shel_write() mode bits are supported.
    ap_gout2 : 0 if shel_write() with a mode parameter of 0 launches an 
    application or 1 if it cancels the previous  shel_write(). 
    ap_gout3 : 0 if shel_write() with a mode parameter of 1 launches an    application immediately 
                        or 1 if it takes effect   when the current application exits. 
    ap_gout4 : 1 if the ARGV style parameter passing is supported, 0 else.
    Remarks:
     * appl_getinfo() is available with WinX 2.2 but the call appl_find( "?AGI"),
       fails. One can test the version of WinX from the cookie. 
     * In some cases, some mode values are not available : a mode is 
    available  if appl_getinfo() returns 0.

    AES_WINDOW (11) : AES Windows Features
    ap_gout1 is a bitmap of extra messages supported (if a bit is set, it is supported) as follows: 
    0 WM_NEWTOP is meaningful. 
                                 1 WM_UNTOPPED is sent. 
                                 2 WM_ONTOP is sent. 
                                 3 AP_TERM is sent. 
                                 4 Shutdown and resolution change messages. 
                                 5 CH_EXIT is sent. 
                                 6 WM_BOTTOMED is sent. 
                                 7 WM_ICONIFY is sent. 
                                 8 WM_UNICONIFY is sent. 
                                 9 WM_ALLICONIFY is sent. 
                                 10-15 Unused 
    ap_gout2 is a bitmap of extra messages supported. Current all                              bits are unused.
    ap_gout3  is a bitmap indicating message behaviour (if a bit is                              set, the behaviour exists) as follows: 
    0 WM_ICONIFY message gives coordinates. 
                                 1-15 Unused 
    ap_gout4 is currently unused.

    AES_OBJECT (12) : AES Extended Objects 
    ap_gout1 : 1 if 3D objects are supported, 0 else.
    ap_gout2 : 2 if extended objc_sysvar() is present, 1 if objc_sysvar() is present, 0 else.
    ap_gout3 : 1 if GDOS fonts are supported as system font, 0 else.
    ap_gout4 is currently reserved.

    AES_FORM (13) : AES Form Support 
    ap_gout1 : 1 if flying diaog are supported, 0 else.
    ap_gout2 : 1 Mag!X style keyboard tables are supported, 0 else.
    ap_gout3 : 1 if objec_edit() returns the last cursor position.
    ap_gout4 is currently reserved.

     Remarks:
     * appl_getinfo() is available with WinX 2.2 but the call appl_find( "?AGI"),
       fails. One can test the version of WinX from the cookie. 
      * In some cases, some mode values are not available : a mode is 
    available
        if appl_getinfo() returns 1. 


mailto: dom
HTTP: http://www-rocq.inria.fr/~bereziat


See Also: Nothing


Thanks for your GEMTOS visit!!!

(C) 2000 Gemtos.free.fr. All rights reserved by the authors.