Topic : TOS - das Betriebssystem
Author :
Version : tos.hyp (5. März 2013)
Subject : Programmieren/Atari
Nodes : 3001
Index Size : 93602
HCP-Version : 5
Compiled on : Atari
@charset : atarist
@lang :
@default : Titel
@help :
@options : +g -i -s +x +zz -t4
@width : 70
View Ref-File8.3.5 appl_getinfo TOS Name: »Application get information« - Informationen über
vorhandene Funktionsaufrufe und Eigenschaften erfragen.
AES-Nummer: 130
Deklaration: int16_t appl_getinfo ( int16_t ap_gtype, int16_t
*ap_gout1, int16_t *ap_gout2, int16_t *ap_gout3,
int16_t *ap_gout4 );
Beschreibung: Mit dieser Funktion lassen sich gezielt Eigenschaften
des Betriebssystems zur Laufzeit erfragen.
ap_gtype bestimmt die Art der Informationen, die
erfragt werden sollen. Es bedeutet:
AES_LARGEFONT (0): Informationen über den normalen
AES-Zeichensatz ap_gout1: Fonthöhe
ap_gout2: Font-ID
ap_gout3: Font-Typ (0=system, 1=FSM)
AES_SMALLFONT (1): Informationen über den kleinen
Zeichensatz ap_gout1: Fonthöhe
ap_gout2: Font-ID
ap_gout3: Font-Typ (0=system, 1=FSM)
AES_SYSTEM (2): Farben ap_gout1: VDI-Gerätenummer (device id)
ap_gout2: Farben für OBJECTs
ap_gout3: Farbicons vorhanden (1) bzw. nicht (0)
ap_gout4:
Bit 0: neues RSC-Format (AES4) vorhanden
Bit 1: Interface Resource File Format
(RSHDR:rsh_vrsn = 3) wird
unterstützt.
AES_LANGUAGE (3): Sprache ap_gout1:
0 - Englisch
1 - Deutsch
2 - Französisch
3 - reserviert
4 - Spanisch
5 - Italienisch
6 - Schwedisch
AES_PROCESS (4): allgemeine Informationen-1 ap_gout1: Multitasking präemptiv (1) oder nicht (0)
ap_gout2: appl_find konvertiert MiNT/AES-ID's (1) oder
nicht (0)
ap_gout3: appl_search vorhanden (1) oder nicht (0)
ap_gout4: rsrc_rcfix vorhanden (1) oder nicht (0)
AES_PCGEM (5): allgemeine Informationen-2 ap_gout1: objc_xfind vorhanden (1) oder nicht (0)
ap_gout2: reserviert, immer 0
ap_gout3: menu_click vorhanden (1) oder nicht (0)
ap_gout4: shel_rdef/shel_wdef vorhanden (1) oder nicht
(0)
AES_INQUIRE (6): allgemeine Informationen-3 ap_gout1: appl_read (-1) vorhanden (1) oder nicht (0)
ap_gout2: shel_get (-1) vorhanden (1) oder nicht (0)
ap_gout3: menu_bar (-1) vorhanden (1) oder nicht (0)
ap_gout4: menu_bar (100) (MagiC) vorhanden (1) oder
nicht (0)
7: reserviert für MagiC und andere Erweiterungen,
MultiTOS setzt alle Rückgabewerte immer auf 0. In MagiC gilt: ap_gout1:
Bit 0: wdlg_xx()-Funktionen vorhanden (1)
Bit 1: lbox_xx()-Funktionen vorhanden (1)
Bit 2: fnts_xx()-Funktionen vorhanden (1)
Bit 3: fslx_xx()-Funktionen vorhanden (1)
Bit 4: pdlg_xx()-Funktionen vorhanden (1)
ap_gout2: reserviert
ap_gout3: reserviert
ag_gout4: reserviert
AES_MOUSE (8): Maus ap_gout1: graf_mouse Modi (258-260) vorhanden (1) oder
nicht (0)
ap_gout2: Mausform vom AES für jede Applikation
verwaltet (1) oder nicht (0)
ap_gout3: Achtung doppelt Belegung - Mausrad Unterstützung (XaAES)
- Falls ein Treiber installiert ist der TORG
105 unterstützt steht hier ein Bitvektor der
verfügbaren Mausräder.
AES_MENU (9): Menüs ap_gout1: MultiTOS-Submenüs vorhanden (1) oder nicht
(0)
ap_gout2: MultiTOS-Popups vorhanden (1) oder nicht (0)
ap_gout3: MultiTOS-Scrollmenüs vorhanden (1) oder
nicht (0)
ap_gout4: erweiterte MN_SELECTED-Nachricht vorhanden
(1) oder nicht (0)
AES_SHELL (10): shel_write ap_gout1: vorhandene Modi
Bit 0..7: höchster zulässiger Wert für
sh_wdoex & 0x00ff
Bit 8..15: Bits von sh_wdoex & 0xff00, die
wie in MultiTOS behandelt
werden.
ap_gout2:
1: shel_write (0) macht vorherige
shel_write Aufrufe ungültig (d.h. das
Desktop wird Nachfolgeprogramm) (TOS 1.04 und MagiC)
0: startet Programm (MultiTOS)
ap_gout3:
1: shel_write (1) startet Programm nach
Beendigung des laufenden (TOS 1.04 und
MagiC)
0: startet Programm sofort (MultiTOS)
ap_gout4: ARGV via sh_wiscr unterstützt (1) oder nicht
(0)
AES_WINDOW (11): Fenster ap_gout1: gesetzte Bits sind unterstützte Funktionen:
Bit 0: WF_TOP liefert zweitoberstes
Fenster
Bit 1: wind_get (WF_NEWDESK)
Bit 2: wind_g/set (WF_COLOR)
Bit 3: wind_g/set (WF_DCOLOR)
Bit 4: wind_get (WF_OWNER)
Bit 5: wind_g/set (WF_BEVENT)
Bit 6: WF_BOTTOM Bit 7: WF_ICONIFY Bit 8: WF_UNICONIFY Bit 9: WF_WHEEL Bit 10: wind_get(WF_FIRSTAREAXYWH)
Bit 11: wind_get/set(WF_OPTS)
Bit 12: wind_get/set(WF_MENU)
Bit 13: wind_get/set(WF_WORKXYWH)
Bit 14: wind_get(WF_CALCW2F/WF_CALCF2W) und
WO0_WCOWORK Bit 15: wind_set und wind_get können mit
dem speziellen handle -2 aufgerufen
werden. Wind_set und wind_get
liefern dann mit spezielen handle
und dem Modus ob dieser vorhanden
ist (1) oder nicht (0).
ap_gout2:
Bit 0: wind_get/set (WF_WIDGETS), N.AES Bit 1..15: reserviert
ap_gout3: vorhandene Fensterbuttons
Bit 0: Iconifier
Bit 1: Backdrop-Button (MagiC)
Bit 2: Shift-Click für Backdrop
Bit 3: "Hot" Closebox (GEM/3 und MagiC)
Bit 4..15: reserviert, 0
ap_gout4: wind_update 'check and set' vorhanden (1)
oder nicht (0)
AES_MESSAGE (12): Nachrichten ap_gout1: gesetzte Bits sind unterstützte Nachrichten:
Bit 0: WM_NEWTOP Bit 1: WM_UNTOPPED Bit 2: WM_ONTOP Bit 3: AP_TERM Bit 4: MultiTOS-Auflösungswechsel Bit 5: CH_EXIT Bit 6: WM_BOTTOMED Bit 7: WM_ICONIFY Bit 8: WM_UNICONIFY Bit 9: WM_ALLICONIFY Bit 10: WM_REPOSED ap_gout2: reserviert, alle 0
ap_gout3: WM_ICONIFY liefert Koordinaten (1) oder
nicht (0)
AES_OBJECT (13): OBJECTs ap_gout1: 3D-Objekte über ob_flags vorhanden (1) oder
nicht (0)
ap_gout2: 0 - objc_sysvar nicht vorhanden
1 - MultiTOS 1.01 objc_sysvar
2 - extended objc_sysvar
ap_gout3: Speedo- und GDOS-Fonts im TEDINFO erlaubt
(1) oder nicht (0)
ap_gout4: reserviert für MagiC und andere
Erweiterungen, MultiTOS setzt alle
Rückgabewerte immer auf 0. In MagiC und
N.AES gilt:
Bit 0: G_SWBUTTON vorhanden
Bit 1: G_POPUP vorhanden
Bit 2: WHITEBAK steuert Unterstriche und
Buttons
Bit 3: G_SHORTCUT vorhanden
AES_FORM (14): Formulare (MagiC form_xdo und
form_xdial) ap_gout1: MagiC-Flydials vorhanden (1) oder nicht (0)
ap_gout2: MagiC-Tastaturtabellen vorhanden (1) oder
nicht (0)
ap_gout3: letzte Cursorposition wird zurückgegeben (1)
oder nicht (0)
ap_gout4: reserviert, 0
AES_EXTENDED (64): Erweiterte Funktionen ap_gout1: shel_write(10) mit AP_AESTERM möglich (1)
oder nicht (0)
ap_gout2: extended shel_write()
SHW_SHUTDOWN(4)/SHW_RESCHANGE(5) vorhanden
(1) oder nicht (0)
ap_gout3: appl_search:
Bit 0: Langnamen vorhanden
Bit 1: Modus APP_TASKINFO vorhanden
ap_gout4: form_error() mit allen GEMDOS-Fehlercodes
vorhanden (1) oder nicht (0)
AES_NAES (65): Zusätzliche N.AES Funktionen ap_gout1: appl_control() vorhanden (1) oder nicht (0)
ap_gout2: höchster Opcode für appl_control()
ap_gout3: shel_help() vorhanden (1) oder nicht (0)
ap_gout4: wind_draw() vorhanden (1) oder nicht (0)
AES_VERSION (96): AES Version There is an extended mode since XaAES from 2004-12-18.
ap_gout1: Major version number (decimal)
ap_gout2: Minor version number (decimal)
ap_gout3: Development Status (Beta, alpha, etc.)
This is a 16-bit integer where bits 0-7 (the
low byte) is a value indicating the
development status of the AES, see below
(AES_DEVSTATUS_xxx) for meaning of different
values. Bits 8-15 are flags, see below
(AES_FDEVSTATUS_xxx) for current
definitions.
AES_DEVSTATUS_ALPHA 0
AES_DEVSTATUS_BETA 1
AES_DEVSTATUS_RELEASE 2
AES_FDEVSTATUS_STABLE 0x100
ap_gout4: Zielplattform (m68k, etc.)
This is a value indicating which platform
the AES was built for. See below
(AES_ARCH_xxx) for meaning of different
values.
Label Wert Zielplattform
AES_ARCH_M68K 0 MC-68000
AES_ARCH_M68000 0 MC-68000
AES_ARCH_M68010 1 MC-68010
AES_ARCH_M68020 2 MC-68020
AES_ARCH_M68030 3 MC-68030
AES_ARCH_M68040 4 MC-68040
AES_ARCH_M68060 5 MC-68060
AES_ARCH_M6802060 6 MC-68020-060
AES_ARCH_COLDFILRE 7 Coldfire
Together (ap_gout1 & ap_gout2), these two contain the
decimal representation of the AES's version number. For
XaAES v0.992, ap_gout1 contains 0 (0x0000) and ap_gout1 contains 992 (0x3e0).
AES_WOPTS (97): Available WF_OPTS settings since XaAES 2005-07-09
ap_gout1: available window options 0 - see
wind_set/get(WF_OPTS, wopt0)
ap_gout2: available window options 1 - see
wind_set/get(WF_OPTS, wopt1)
ap_gout3: available window options 2 - see
wind_set/get(WF_OPTS, wopt2)
ap_gout4: reserved - always cleared
AES_FUNCTIONS (98): Available extended AES function since XaAES 2005-12-08
ap_gout1:
Bit 0: If set, the following MagiC 5.10
introduced functions exists;
objc_wdrawobjc_wchangeobjc_weditgraf_wwatchboxform_wbuttonform_wkeybd Bit 1: If set, appl_options() exists.
Bit 2..15: Not yet defined, always reads 0.
ap_gout2: Not yet defined, all bits reads 0
ap_gout3: Not yet defined, all bits reads 0
ap_gout4: Not yet defined, all bits reads 0
AES_AOPTS (99): Available application options The bitmasks returned here are identical to the
bitmasks used to modify the application options via
appl_options(APL_OPTS). Needless to say, this option is
not available if bit 0 in ap_gout1 is cleared after
appl_getinfo(AES_FUNCTIONS).
since XaAES 2005-12-08
ap_gout1:
Bit 0: If set, extended slider management
is available.
Bit 1: If set, extended objc_edit() cursor
management is present. See more
info about this below.
Bit 2..15: Not yet defined, always reads 0.
ap_gout2: Not yet defined, all bits reads 0
ap_gout3: Not yet defined, all bits reads 0
ap_gout4: Not yet defined, all bits reads 0
AES_WINX (22360): Infos zu Erweiterungen in WINX dieser Informationstyp existiert seit WINX 2.3
ap_gout1: Bitvektor für WF_-Funktionen in
wind_get/wind_set Bit 0: WF_WINX Bit 1: WF_WINXCFG Bit 2: WF_DDELAY Bit 3: WF_SHADE Bit 4: WF_STACK Bit 5: WF_TOPALL Bit 6: WF_BOTTOMALL Bit 7: WF_KIND ap_gout2: Bitvektor für AES-Nachrichten Bit 0: Erweitertes WM_ARROWED Bit 1: WM_SHADED Nachricht wird versandt
Bit 2: WM_UNSHADED Nachricht wird versandt
ap_gout3: Bitvektor für Erweiterungen von AES-
Funktionen
Bit 0: wind_calc erlaubt WC_WIN-Modi
ap_gout4: Bitvektor für allgemeine Informationen zum
AES Bit 0: DPAT-Schreibtischhintergrund wird
vom AES direkt unterstützt
22358: XaAESWird ab dem 2004-12-18 nicht mehr unterstützt. Siehe
ap_gtype = 96 ap_gout1: Hautpversionnummer
ap_gout2: Unterversionnummer
ap_gout3: Zielplattform für die XaAES erstellt wurde.
ap_gout4: Status (Beta, alpha, etc.)
Hinweis: Ein Problem dieser Funktion besteht darin,
festzustellen, wann sie überhaupt aufgerufen werden
darf. Zwar sollte sie ab AES-Version 4.0 vorhanden
sein, MagiC 2.0 (und auch MagiC 3.0) besitzt aber
beispielsweise die Version 3.99. Aus diesem Grund
definieren viele Programmierer die Funktion
appl_xgetinfo, in der überprüft wird, ob appl_getinfo
in der aktuellen Systemumgebung vorhanden ist.
Ergebnis: Ein Rückgabewert von 0 zeigt einen Fehler an; bei einem
Wert von 1 ist kein Fehler aufgetreten.
Verfügbar: Available as of AES version 4.00.
Gruppe: Applikationen Querverweis: Binding