Accueil        Lexique        UNITéS        Algorithmes        Tutoriel        Groupe Facebook   

Les unités de Pure Pascal (langage Pascal pour les ordinateurs de la gamme Atari ST), compatible Turbo Pascal.

Unité GEM : Fonction appl_getinfo

Cette page a été ajoutée au document HLP Atari d'Origine, car manquante

Déclaration

function appl_getinfo( ap_gtype : Integer; var ap_gout1, ap_gout2, ap_gout3, ap_gout4 ) : Integer;

Description

La fonction retourne des informations AES dans les variables de paramètres ap_gout1, ap_gout2, ap_gout3, ap_gout4, suivant le paramètre ap_gtype saisi :
Valeur ap_gtype entréeRésultats
0 (AES_LARGEFONT)Informations sur la grande police AES
  • ap_gout1 indique la taille de la police AES.
  • ap_gout2 indique l'identifiant de la police.
  • ap_gout3 indique le type de police :
    • SYSTEM_FONT (0) est la police système
    • OUTLINE_FONT (1) est une police vectorielle
  • ap_gout4 est inutilisé.
1 (AES_SMALLFONT)Informations sur la petite police AES.

Pareil que 0 (AES_LARGEFONT) mais appliqué aux petites fontes.

2 (AES_SYSTEM)Spécificités du système AES
  • ap_gout1 indique avec le numéro de résolution (tel que renvoyé par Getrez ).
  • ap_gout2 indique le nombre de couleurs supportées par la librairie d'objets AES
  • ap_gout3 est 0 si les icônes de couleur ne sont pas prises en charge ou 1 si elles le sont
  • ap_gout4
    • bit0 (AES4) = 0 pour indiquer que le format de fichier de ressources étendu n'est pas pris en charge ou 1 s'il l'est
    • bit1: Indique que le format de fichier de ressources d'interface (RSHDR:rsh_vrsn = 3) est pris en charge
3 (AES_LANGUAGE)Mondialisation de l'AES
  • ap_gout1 Est rempli avec les codes langues suivantes
    • 0: Anglais
    • 1: Allemand
    • 2: Français
    • 3: - réservé
    • 4: Espagnol
    • 5: Italien
    • 6: Suedois
  • ap_gout2, ap_gout3, ap_gout4 sont inutilisés
4 (AES_PROCESS)Prise en charge de plusieurs processus AES
  • ap_gout1 prise en charge (=1) ou non (=0) du multitâche préhemptif
  • ap_gout2 = 0 si appl_find ne peut pas convertir entre les identifiants MiNT et AES et 1 pour indiquer qu'il le peut.
  • ap_gout3 est 0 si appl_search n'est pas implémenté et 1 si c'est le cas.
  • ap_gout4 est 0 si rsrc_rcfix n'est pas implémenté et 1 s'il l'est.
5 (AES_PCGEM)Fonctionnalités d'AES PC-GEM
  • ap_gout1 est 0 si objc_xfind n'est pas implémenté et 1 s'il l'est. (Note du webmaster : cette fonction n'est pas implémentée dans pure pascal)
  • ap_gout2 Réservé, toujours à 0
  • ap_gout3 est 0 si menu_click n'est pas implémenté et 1 s'il l'est. (Note du webmaster : cette fonction n'est pas implémentée dans pure pascal)
  • ap_gout4 est 0 si shel_rdef et shel_wdef ne sont pas implémentés et 1 s'ils le sont.
6 (AES_INQUIRE)Fonctions d'interrogation étendues AES
  • ap_gout1 est 0 si -1 n'est pas un paramètre ap_id valide pour appl_read ou 1 si c'est le cas.
  • ap_gout2 est 0 si -1 n'est pas un paramètre de longueur valide pour shel_get ou 1 si c'est le cas.
  • ap_gout3 est 0 si -1 n'est pas un paramètre de mode valide pour menu_bar ou 1 si c'est le cas.
  • ap_gout4 est 0 si MENU_INSTL (=100,pour MagiC) n'est pas un paramètre de mode valide pour menu_bar ou 1 s'il l'est
7Réservé à Magic et pour d'autres extensions d'OS. MULTITOS ou autre AES Multitache renvoie 0 pour toutes les valeurs.

Pour Magic :

  • ap_gout1
    • Bit 0 : Fonctions wdlg_xx implémentées (1)
    • Bit 1 : Fonctions lbox_xx implémentées (1)
    • Bit 2 : Fonctions fnts_xx implémentées (1)
    • Bit 3 : Fonctions fslx_xx implémentées (1)
    • Bit 4 : Fonctions pdlg_xx implémentées (1) ou non (0) dans chaque cas
  • ap_gout2 - Réservé
  • ap_gout3 - Réservé
  • ap_gout4 - Réservé
8 (AES_MOUSE)Support de souris AES
  • ap_gout1 est 0 pour indiquer que les paramètres de mode de 258-260 ne sont pas pris en charge par graf_mouse et 1 s'ils le sont.
  • ap_gout2 est 0 pour indiquer que l'application a le contrôle sur le formulaire de la souris et 1 pour indiquer que le formulaire de la souris est maintenu par l'AES pour chaque application.
  • ap_gout3 : Avertissement : Double affectation - Prise en charge des molettes de souris (XaAES) - Si un pilote TORG 105 est installé, cette valeur correspond au vecteur binaire des molettes de souris actuellement disponibles.
  • ap_gout4 est inutilisé.
9 (AES_MENU)Support de menu AES
  • ap_gout1 est 0 pour indiquer que les sous-menus ne sont pas pris en charge et 1 si les sous-menus de style MultiTOS le sont.
  • ap_gout2 est 0 pour indiquer que les menus contextuels ne sont pas pris en charge et 1 si les menus contextuels de style MultiTOS le sont.
  • ap_gout3 est 0 pour indiquer que les menus déroulants ne sont pas pris en charge et 1 si les menus déroulants de style MultiTOS le sont
  • ap_gout4 est 0 pour indiquer que le message MN_SELECTED ne contient pas d'informations sur l'arborescence d'objets dans buffer[5..7] (les index 5 à 7 du tableau Buffer) et 1 pour indiquer qu'il en contient.
10 (AES_SHELL)shel_write
  • ap_gout1 : Modes pris en charge
    • Bits 0 à 7 : Indique la valeur maximale autorisée pour (sh_wdoex et 0x00ff)
    • Bits 8 à 15 : Indique les bits de (sh_wdoex et 0xFF00) pris en charge, comme dans MultiTOS
  • ap_gout2 :
    • 1 : shel_write (0) invalide les appels shel_write précédents (le bureau devient alors le programme suiveur) (TOS 1.04 et MagiC)
    • 0 : Lance le programme (MultiTOS)
  • ap_gout3 :
    • 0 : shel_write (1) lance un programme à la fin du programme en cours d'exécution (TOS 1.04 et MagiC)
    • 1 : Lance le programme immédiatement (MultiTOS)
  • ap_gout4 : Passage du paramètre de style ARGV via sh_wiscr pris en charge (1) ou non (0)
11 (AES_WINDOW)Support des fenêtres.
  • ap_gout1 :Fonctions WF_ étendues dans wind_get/wind_set (0=non disponible, 1=disponible). Voir la fiche de chacune de ces 2 fonctions pour les signification des constantes suivantes :
    • Bit 0 : WF_TOP renvoie la fenêtre inférieure à la fenêtre actuelle
    • Bit 1 : wind_get(WF_NEWDESK) pris en charge
    • Bit 2 : wind_get/set(WF_COLOR)
    • Bit 3 : wind_get/set(WF_DCOLOR)
    • Bit 4 : wind_get(WF_OWNER)
    • Bit 5 : wind_get/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 : Prise en charge Modes wind_get(WF_CALCW2F/WF_CALCF2W) et wind_set(WO0_WCOWORK)
    • Bit 15 : wind_set et wind_get peuvent être appelés avec le handle spécial -2. Ensuite, wind_set et wind_get invoqués avec ce handle spécial indiquent si le mode est pris en charge par AES.
  • ap_gout2 :
    • Bit 0: wind_get/set (WF_WIDGETS), N.AES
    • Bit 1..15: Reservé
  • ap_gout3 :Prise en charge des nouveaux widgets : (0 = pris en charge, 1 = non pris en charge)
    • Bit 0 : Bouton d'iconification
    • Bit 1 : Bouton d'arrière-plan (MagiC)
    • Bit 2 : [Maj]-clic pour l'arrière-plan
    • Bit 3 : Boîte de fermeture rapide (GEM/3 et MagiC)
    • Bit 4..15 : Réservé, 0
  • ap_gout4 : wind_update 'Vérifier et définir' implémenté (1) ou non (0)
12 (AES_MESSAGE) Messages envoyés aux applications
  • ap_gout1 : Champ de bits des messages supplémentaires pris en charge (0 = non, 1 = oui)
    • Bit 0 : WM_NEWTOP est significatif
    • Bit 1 : WM_UNTOPPED est envoyé
    • Bit 2 : WM_ONTOP est envoyé
    • Bit 3 : AP_TERM est envoyé
    • Bit 4 : Messages d'arrêt et de changement de résolution MultiTOS pris en charge
    • Bit 5 : CH_EXIT est envoyé
    • Bit 6 : WM_BOTTOMED est envoyé
    • Bit 7 : WM_ICONIFY est envoyé
    • Bit 8 : WM_UNICONIFY est envoyé
    • Bit 9 : WM_ALLICONIFY est envoyé
    • Bit 10 : WM_REPOSED est envoyé
  • ap_gout2 : réservé (toujours 0)
  • ap_gout3 :WM_ICONIFY renvoie les coordonnées (1) ou non (0)
13 (AES_OBJECT)Informations d'objet
  • ap_gout1 Objets 3D via ob_flags implémentés (1) ou non (0).
  • ap_gout2
    • 0 - objc_sysvar non présent
    • 1 - MultiTOS 1.01 objc_sysvar présent
    • 2 - objc_sysvar étendu présent
  • ap_gout3. Polices Speedo et GDOS autorisées dans TEDINFO (1) ou non (0)
  • ap_gout4. Réservé à MagiC et aux autres extensions ; MultiTOS définit toujours toutes les valeurs de retour à 0. Dans MagiC et N.AES, les conditions suivantes s'appliquent :
    • Bit 0 : G_SWBUTTON pris en charge
    • Bit 1 : G_POPUP pris en charge
    • Bit 2 : WHITEBAK contrôle les soulignements et les boutons
    • Bit 3 : G_SHORTCUT pris en charge.
14 (AES_MENU)Formulaires (MagiC form_xdo et form_xdial)
  • ap_gout1 : Présence de Flydials MagiC (1) ou absence (0)
  • ap_gout2 : Présence de tables de clavier MagiC (1) ou absence (0)
  • ap_gout3 : Dernière position du curseur renvoyée par obj_edit (1) ou absence (0)
  • ap_gout4 : Réservé, 0
64 (AES_EXTENDED)Fonctions étendues
  • ap_gout1 : shel_write(10) avec AP_AESTERM possible (1) ou non (0)
  • ap_gout2 : shel_write étendu SHW_SHUTDOWN(4)/SHW_RESCHANGE(5) présent (1) ou non (0))
  • ap_gout3 : appl_search :
    • Bit 0 : Noms longs présents
    • Bit 1 : Mode APP_TASKINFO disponible
  • ap_gout4 : form_error avec tous les codes d'erreur GEMDOS présents (1) ou non (0)
65 (AES_NAES)Fonctions NAES étendues
  • ap_gout1 : appl_control present (1) or not (0)
  • ap_gout2 : Opcode le plus élevé pour appl_control
  • ap_gout3 : shel_help présent (1) ou pas (0)
  • ap_gout4 : wind_draw présent (1) or pas (0)
96AES Version.
Il existe une version étendue de cette info depuis XaAES du 18/12/2004 : avec la fonction appl_getinfo_str.
  • ap_gout1 : Numéro de version majeure (décimal)
  • ap_gout2 : Numéro de version mineure (décimal)
  • ap_gout3 : État de développement (bêta, alpha, etc.)
    Il s'agit d'un entier de 16 bits, dont les bits 0 à 7 (octet de poids faible) indiquent l'état de développement de l'AES. Voir ci-dessous (AES_DEVSTATUS_xxx) pour la signification des différentes valeurs. Les bits 8 à 15 sont des indicateurs. Voir ci-dessous (AES_FDEVSTATUS_xxx) pour les définitions actuelles.
    • AES_DEVSTATUS_ALPHA 0
    • AES_DEVSTATUS_BETA 1
    • AES_DEVSTATUS_RELEASE 2
    • ...
    • AES_FDEVSTATUS_STABLE 0x100
  • ap_gout4 : Plateforme cible (m68k, etc.)
    Cette valeur indique la plateforme pour laquelle l'AES a été conçu. Voir ci-dessous (AES_ARCH_xxx) pour la signification des différentes valeurs.
    ÉtiquetteValeur Plateforme cible
    AES_ARCH_M68K ou 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
Ensemble (ap_gout1 et ap_gout2), ces deux éléments contiennent la représentation décimale du numéro de version d'AES. Pour XaAES v0.992, ap_gout1 contient 0 (0x0000) et ap_gout1 contient 992 (0x3e0).
97 Paramètres WF_OPTS disponibles
Depuis XaAES du 09/07/2005
  • ap_gout1 : Options de fenêtre disponibles 0 - voir wind_set/get(WF_OPTS, wopt0)
  • ap_gout2 : Options de fenêtre disponibles 1 - voir wind_set/get(WF_OPTS, wopt1)
  • ap_gout3 : Options de fenêtre disponibles 2 - voir wind_set/get(WF_OPTS, wopt2)
  • ap_gout4 : réservé, 0
98 Fonctions AES étendus disponibles
Depuis XaAES du 08/12/2005
  • ap_gout1 :
    • Bit 0 : Si défini, les fonctions suivantes introduites par MagiC 5.10 existent :
      • objc_wdraw
      • objc_wchange
      • objc_wedit
      • graf_wwatchbox
      • form_wbutton
      • form_wkeybd
    • Bit 1 : Si défini, appl_options existe
    • Bit 2 : Si défini, objc_data existe
    • Bit 3..15 : Non encore défini, lit toujours 0
  • ap_gout2 : Pas encore défini, tous les bits lisent 0
  • ap_gout3 : Pas encore défini, tous les bits lisent 0
  • ap_gout4 : Pas encore défini, tous les bits lisent 0
99 Options d'applications disponibles
Les masques de bits renvoyés ici sont identiques à ceux utilisés pour modifier les options de l'application via appl_options(APL_OPTS). Bien entendu, cette option n'est pas disponible si le bit 0 de ap_gout1 est effacé après appl_getinfo(AES_FUNCTIONS). Depuis XaAES du 08/12/2005
  • ap_gout1 :
    • Bit 0 : Si cette option est définie, la gestion étendue du curseur est disponible.
    • Bit 1 : si défini, la gestion étendue du curseur objc_edit est présente ; voir plus d'informations à ce sujet ci-dessous
    • Bit 2..15 : Non encore défini, lit toujours 0
  • ap_gout2 : Pas encore défini, tous les bits lisent 0
  • ap_gout3 : Pas encore défini, tous les bits lisent 0
  • ap_gout4 : Pas encore défini, tous les bits lisent 0
22360 (AES_WINX)Information sur les extensions de WinX
Depuis Winx 2.3
  • ap_gout1 : Vecteur de bitspourlesfonction WF_ dans 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 : Vecteur de bit pour les messages AES
    • Bit 0: WM_ARROWED étendu
    • Bit 1: le message WM_SHADED est envoyé
    • Bit 2: le message WM_UNSHADED est envoyé
  • ap_gout3 : Vecteur de bit pour les extensions de fonction AES.
    Bit 0 : wind_calc autorise les modes WC_WIN
  • ap_gout4 : Vecteur binaire pour des informations générales sur l'AES
    Bit 0 : L'arrière-plan du bureau DPAT est directement pris en charge par l'AES
22528 (XaAES)Obsolète depuis le 18/12/2004, voir ap_gtype = 96
  • ap_gout1 : Numéro de version majeure
  • ap_gout2 : Numéro de version mineure
  • ap_gout3 : Plateforme cible pour laquelle ce XaAES a été compilé
  • ap_gout4 : Statut (bêta, alpha, etc.)

Remarque : Cette fonction pose un problème lorsqu'elle doit être appelée. Bien qu'elle devrait être présente à partir de la version 4.0 d'AES, MagiC 2.0 (et MagiC 3.0), par exemple, affiche la version 3.99. C'est pourquoi de nombreux programmeurs définissent la fonction appl_xgetinfo, qui vérifie si appl_getinfo est présente dans l'environnement système actuel.

Remarque : Cette fonction a été rétroportée vers FreeGEM sous le nom xapp_getinfo (code opération 1020) et existe si le bit ABLE_GETINFO est défini dans le bitmap « capacités ».


Vous trouverez dans cette zone la liste de toutes les Unités (équivalent des "Librairies" en C) de Pure Pascal. Les Unités indiqués comme standards existent dans la majorité des compilateurs Pascal existant sur ordinateurs 16 bits et au dela (dont Turbo Pascal 3 mini). Les unités indiqués comme Atari sont spécifiques aux systèmes d'exploitation des Atari ST (TOS n.n).

Accès aux unités

Les menus déroulants de chaque unité sont des accès directs aux procédures et fonctions, classés alphabétiquement (sans tenir compte de la casse, puisque le langage Pascal ne tient pas compte de la casse!)
CRT (Standard)

DOS (Standard)

GEM : AES (Atari)

GEM : VDI (Atari)

Graph (Standard)

Overlay (Standard)

Printer Strings (Standard)

System (Standard)

TOS : BIOS (Atari)

TOS : GEMDOS (Atari)

TOS : XBIOS (Atari)

Cette page Unités est issu du fichier UNIT.HLP de la documentation de Pure Pascal (d'Application Systems Heidelberg), qui a été convertie en format TXT puis traduite de l'Allemand grâce à Google Translator : des milliers de copier/coller de et vers Google translator ont été nécessaires, ne connaissant pas un mot d'Allemand!

Les unités CRT, DOS, Graph, Overlay, Printer et System sont standard à TOUS les compilateurs Pascal compatible avec Turbo Pascal 5. L'unité String a été introduit avec Turbo Pascal 7 (Et Pure Pascal 1.1) et permet de manipuler les chaines de caractères de type langage C. Les Unités GEM (VDI et AES) et TOS (BIOS, GEMDOS et XBIOS) sont spécifiques au système Atari ST et contiennent parfois des fonctions équivalentes à certaines fonctions des Unités générales (notamment BIOS). Les fonction XBIOS sont des fonctions permettant de tirer pleinement partie du matériel spécifique Atari, notamment Falcon (Audio, DSP, Blitter, Résolutions étendues etc)


Copyright © 2021 par Albatros Concept (Bruno Aubin)