COURS208.TXT/fr
******************************************************************
* *
* COURS D'ASSEMBLEUR 68000 SUR ATARI ST *
* *
* par Le Féroce Lapin (from 44E) *
* *
* Seconde série *
* *
* Cours numéro 8 *
******************************************************************
J'espère que vous n'abordez pas ce cours immédiatement après avoir
fini de lire le précédent, mais, qu'au contraire, vous vous êtes
plongé dans la ligne A avec bonheur!
Nous allons maintenant aborder un sujet qui, je dois l'avouer,
m'effrayait un peu au début: le GEM.
En fait, en programmation comme dans beaucoup d'autres sujets, on
se met à bosser simplement lorsqu'on y est obligé. Ainsi je
n'avais réalisé que de tout petits trucs avec le GEM en
assembleur, des trucs du genre ACCessoire de bureau qui permet de
mettre l'écran en inverse vidéo, avec un choix dans une boîte
d'alerte, avant de me trouver face au descriptif du soft que me
proposait une boîte Parisienne. Je dois avouer que les premiers
jours ont été un peu durs, mais qu'à la longue j'ai découvert que
le GEM est vraiment une chose fabuleuse, pas très dur à maîtriser
et que les possibilités sont largement suffisantes pour combler de
bonheur tout programmeur digne de ce nom!!! J'espère donc que vous
prendrez autant de plaisir que moi à programmer sous GEM une fois
que vous aurez lu ce chapitre.
Tout d'abord les remarques qui se trouvent au début du chapitre
sur la ligne A, méritent d'être relus. Chercher donc de la docu-
mentation sans vous soucier du langage. Vous trouverez dans le
dernier cours de cette série une bibliographie dans laquelle j'ai
essayé de recenser divers articles bien sympas.
Le GEM est accessible par le TRAP #2, mais en fait grâce à ce trap
nous avons accès à plusieurs parties du GEM, un peu comme si le
trap #1 débouchait en même temps sur GEMDOS et BIOS. Le GEM est,
en effet, composé principalement de 2 parties:
l'AES et le VDI.
Les routines du VDI - VIRTUAL DEVICE INTERFACE -
s'occupent des graphismes;
traçage de cercles,
ellipse,
traits,
rectangles
etc ...
Par contre, l'affichage des objets typiques du GEM :
fenêtres,
boîtes d'alertes
est réalisé par l'AES - APPLICATION ENVIRONMENT SYSTEM - .
Au fur et à mesure que vous découvrirez les fonctions VDI et AES
vous vous rendrez compte de l'interaction des 2.
Le gros avantage de ce système peut s'expliquer simplement: il
semble évident à tout le monde que sortir un dessin sur un écran,
une disquette ou une imprimante, ce n'est pas la même chose.
ERREUR! Pour le GEM c'est pareil!
En fait, on peut dire que vous avez à préparer votre dessin et à
dire "je l'envoie". Où? Ah là, c'est comme vous voulez parce que
pour le VDI
l'écran,
la table traçante,
le disque,
l'imprimante
etc..
ne sont que des périphériques. Il suffit de lui désigner le péri-
phérique de notre choix et il fait le boulot tout seul!!!!
Le seul problème:
les routines véritablement indépendantes des périphériques se
trouvent dans GDOS - ce nom vous fait sûrement frémir d'effroi...-
-- Plusieurs programmes en même temps ?
Le principe du GEM est très attirant mais doit nous amener à ré-
fléchir un petit peu sur le mélange potentiel des données. En ef-
fet le GEM, même s'il n'est pas réellement multitâche (être multi-
tâche consiste à pouvoir faire tourner des applications exactement
en même temps, ce qui est de toute façon impossible avec un 68000)
le GEM donc, permet d'avoir plusieurs programmes actifs en même
temps, en l'occurrence un programme principal et 6 accessoires.
Pour le GEM il n'y a fondamentalement pas de différence entre un
PRG et un ACC et, pour cette raison, dans le vocabulaire GEM on
les nomme "applications". Le GEM peut donc se retrouver avec 7 ap-
plications à gérer, chacune ayant potentiellement plusieurs fenê-
tres. On imagine facilement le bazar dans la mémoire!!!
-- Comment le GEM s'y retrouve t-il?
Au démarrage d'une application, celle-ci appelle la fonction AP-
PL_INIT (Application_Init). Cette fonction prévient le GEM que no-
tre application désire devenir active, et le GEM répond en nous
fournissant un numéro, l'APP_ID (Application_Identificator) qui
nous servira maintenant de référence. Notre application sera donc
par exemple la 3, et sera reconnue comme telle par le GEM. Atten-
tion, l'APP_ID n'est donné à l'application que pour la durée de
présence en mémoire de celle-ci. Si je lance un ACC le lundi, il
peut hériter de l'APP_ID 4 mais si je le relance le mardi dans des
conditions différentes, il peut obtenir l'APP_ID 5. Seulement il
gardera cet APP_ID pendant toute son activité.
Lorsque l'on ouvre une fenêtre, c'est le même principe. Le GEM
fournit ce que l'on nomme un HANDLE, c'est à dire un numéro cor-
respondant à la fenêtre. En fait le HANDLE c'est le numéro d'iden-
tification d'une fenêtre mais potentiellement aussi d'un périphé-
rique.
-- Multitraitement ?
Une des parties les plus importantes du GEM concerne la gestion
des événements. Un événements c'est une action de l'utilisateur de
la machine: clic souris, appui sur une touche etc... En fait, sous
GEM les applications passent la plus grande partie de leur temps à
attendre. Imaginons un PRG avec une fenêtre ouverte et un menu
déroulant, et en même temps en mémoire 3 accessoires. Je vais dans
le menu des accessoires. Le menu se déroule et les titres passent
en inverse vidéo lorsque la souris passe dessus. Tout ceci est
fait par le GEM, tout seul comme un grand. Je clique sur le titre
de l'accessoire 2.
Le GEM détecte le clic, sait que je suis dans les accessoires, re-
garde sur quelle entrée j'ai cliqué. Comme c'est le GEM qui a at-
tribué les entrées aux ACC, il envoie un message à l'accessoire 2
pour lui dire "il faut que tu t'ouvres". Celui-ci s'ouvre donc, et
affiche une fenêtre à l'écran. Nous avons donc 2 fenêtres en même
temps. Je clique sur celle du PRG, le GEM regarde à qui appartient
cette fenêtre et envoi au PRG un message pour lui dire "on a acti-
vé ta fenêtre numéro XX" etc... Nous allons donc construire dans
nos programmes sous GEM, un noyau de surveillance des actions, et
nous réagirons en fonction de celles-ci.
-- Pour appeler les fonctions du GEM.
Les appels se font avec des paramètres que nous passons dans des
tableaux. Comme nous utilisons DEVPACK, nous utiliserons sa bi-
bliothèque. En effet, pour les appels au GEM, les paramètres sont
nombreux et à placer à des endroits bien précis dans les tableaux.
Pour ces raisons, les macros trouvent ici tout leur intérêt. Nous
appellerons donc les fonctions du GEM avec les macros contenues
dans la bibliothèque de DEVPACK. Cependant il convient de connaî-
tre également les tableaux, afin de pouvoir parfaitement compren-
dre le principe de fonctionnement.
Pour l'AES, il faut 6 tableaux:
CONTROL,
GLOBAL,
INT_IN,
INT_OUT,
ADDR_IN,
ADDR_OUT.
Pour le VDI il en faut 5:
CONTRL,
INTIN,
INTOUT,
PTSIN,
PTSOUT.
Attention à la légère différence d'orthographe entre INT_IN et
INTIN ! Pour indiquer, lors de l'appel au GEM, l'emplacement où il
trouvera ces tableaux, leurs adresses sont placées dans 2 listes:
Une pour l'AES:
aes_params dc.l control, global, int_in, int_out,addr_in, addr_out
et une pour le VDI:
vdi_params dc.l contrl, intin, ptsin, intout, ptsout
Voici les tableaux tels qu'ils sont définis dans la bibliothèque
GEM de DEVPACK:
control ds.w 5
global ds.w 14
int_in ds.w 16
int_out ds.w 7
addr_in ds.l 3
addr_out ds.l 1
contrl ds.w 1
contrl1 ds.w 1
contrl2 ds.w 1
contrl3 ds.w 1
contrl4 ds.w 1
contrl5 ds.w 1
contrl6 ds.w 1
contrl7 ds.w 1
contrl8 ds.w 1
contrl9 ds.w 1
contrl10 ds.w 1
contrl11 ds.w 1
intin ds.w 128 min 30
intout ds.w 128 min 45
ptsin ds.w 128 min 30
ptsout ds.w 128 min 12
Vous remarquez l'étrange mise en place du tableau CONTRL (tableau
pour le VDI). En effet il faut assez souvent passer des paramètres
'à la main' dans ce tableau. Avec ce système, il sera possible de
réaliser une opération du genre MOVE.W #10,CONTRL2
Attention cette numérotation des CONTRL correspond au nombre de
words car chacune des entrées est définie par DS.W et non pas par
DS.B!!! Ceci s'explique par le fait que 99% des documents relatifs
au GEM sont pour le 'C' et que c'est ce type de commande qui est
faite en 'C'. Ainsi vous trouverez souvent; "mettre 10 en
contrl(2)"; il vous suffira de faire MOVE.W #10,CONTRL2 et le tour
est joué.
-- Pourquoi tant de tableaux? Parce que chacun de ces tableaux est
destiné à recevoir ou à renvoyer un certain type de données.
Voyons un descriptif rapide de ces tableaux.
Tableaux AES
** control
Destiné à contenir, dans l'ordre:
numéro de la fonction (.W),
nombre d'octets de INT_IN (.W),
nombre d'octets de INT_OUT (.W),
nombre de longs mots de ADDR_IN (.W)
nombre de longs mots de ADDR_OUT
** global
Ce tableau est un peu spécial, et les explications le concernant
ne sont d'aucune utilité dans le cadre de ces cours. Une fois bien
ingurgité le reste, vous pourrez toujours vous pencher dessus mais
actuellement cela ne ferait que vous embrouiller! (Voir la biblio-
graphie pour en savoir plus)
** int_in
Ce tableau est destiné à recevoir des valeurs entières (Integer
In) dont l'AES aura besoin.
Par exemple un numéro de fenêtre.
** int_out
A l'inverse du précédent ce tableau renvoi des résultats par exem-
ple si vous demander la surface disponible pour une fenêtre, vous
aurez ici les dimensions.
** addr_in
Liste dans laquelle vous pourrez placer des adresses
** addr_out et là, vous pourrez en lire! En fait il suffit, comme
toujours, de lire le nom du tableau pour en déduire ce qu'il
contient!
Tableaux VDI
** contrl
Dans contrl0 nous plaçons l'opcode de la fonction, c'est ainsi que
l'on appelle son numéro.
Dans contrl1 nous plaçons le nombre de données qui seront mise
dans le tableau intin
Dans contrl2 nous plaçons le nombre de points (donc de couples de
données) qui seront placés dans le tableau ptsin
Dans contrl3 nous placerons l'identificateur de la sous-fonction.
Par exemple le traçage des cercles, ellipse, rectangle etc... ce
fait avec la fonction 11. Il faut donc un sous-code permettant de
définir quel module dans la fonction 11 on désire utiliser.
Dans contrl6 nous plaçons le handle du périphérique. (voir plus
haut)
A partir de contrl7 il y a parfois des informations à passer,
suivant la fonction.
** intin et ptsin
Nous remplirons ensuite le tableau INTIN avec les paramètres en-
tiers demandés par la fonction et le tableau PTSIN avec les coor-
données demandées par la fonction. Une fois la fonction appelée,
nous récupèrerons:
en contrl2 le nombre de couples de coordonnées de ptsout et
en contrl4 le nombre de mots de intout.
Voici un appel au GEM. Cette fonction affiche une phrase où l'on
veut sur l'écran, contrairement à Gemdos (9) qui est limité sur
les lignes et les colonnes de texte. De plus cette fonction permet
d'afficher du texte avec des effets (gras, souligné etc...) avec
la fonte de notre choix:
LEA MESSAGE,A1 adresse de la phrase
LEA INTIN,A0 tableau de réception
MOVEQ.L #0,D2 init le compteur de lettres
ICI3 CLR.W D0
MOVE.B (A1)+,D0 prélève en bytes
BEQ GO_ON fin du texte
ADDQ.B #1,D2 on compte les lettres
MOVE.W D0,(A0)+ transfère dans INTIN (en words)
BRA ICI
GO_ON MOVE.W #100,PTSIN position X
MOVE.W #150,PTSIN+2 position Y
MOVE.W D2,CONTRL3 nombre de lettres
MOVE.W #1,CONTRL1
MOVE.W CURRENT_HANDLE,CONTRL6
MOVE.W #8,CONTRL opcode
MOVE.L #VDI_PARAMS,D1
MOVE.W #$73,D0
TRAP #2
AAAAAAAAAARRRRRRGGGLLL!!!!!! C'est l'horreur n'est ce pas!
Il faut vous munir de patience et décortiquer les multiples appels
au GEM.
Pour vous aider dans vos essais, vous trouverez ci-joint un dos-
sier intitulé GEM. Il contient le source d'un ACC qui affiche une
boîte d'alerte, d'un PRG qui gère une ressource (listing issu de
WERCS) et d'un accessoire gérant une fenêtre. Pour ce qui est des
éditeurs de ressources, je travaille avec K Ressource qui est bien
sympa et qui ne plante pas, contrairement à Wercs!
Essayez de bien comprendre le principe: affichez une boîte
d'alerte avec un seul bouton, puis avec plusieurs, faites des
petites ressources toutes simples, puis de plus en plus compli-
quées etc... Le principe restera toujours le même quelle que soit
la taille de votre application. Essayez de faire de petits acces-
soires du genre formateur de disquettes, avec un petit formulaire
qui demande si l'on veut formater le disque A ou le B, en simple
ou en double face etc...
A l'aide de ces exemples, vous devriez réussir à vous débrouiller.
C'est avec ça que j'ai commencé! Jetez également un coup d'oeil
sur la bibliographie, il y a quelques trucs intéressants!
Back to ASM_Tutorial