>Wongck at 15:19, 12 October 2011

2011-10-12T15:19:09Z

← Older revision		Revision as of 11:19, 12 October 2011
Line 609:		Line 609:
	</pre>		</pre>
	Back to [[ASM_Tutorial]]		Back to [[ASM_Tutorial]]
	[[Category:~~Programming~~]]		[[Category: ASSEMBLEUR 68000 sur ATARI ST Part 2]]

>Silver Surfer: Added category

2009-05-02T20:44:17Z

Added category

← Older revision		Revision as of 16:44, 2 May 2009
Line 609:		Line 609:
	</pre>		</pre>
	Back to [[ASM_Tutorial]]		Back to [[ASM_Tutorial]]
			[[Category:Programming]]

>Zorro 2 at 15:06, 9 October 2006

2006-10-09T15:06:04Z

New page

<pre>

--------------------
CHAPITRE NÂ°7:

LE VDI

--------------------

*** INTRODUCTION ***
--------------------

- Le VDI est un ensemble de fonctions (tout comme le Gemdos,le bios et
l'xbios) graphiques:

En appellant les fonctions adequates, on pourra donc par exemple affi-
cher un cercle,un polygone,remplir des surfaces etc...

Je vais aussi Ãªtre amenâ€š Ã parler des fonctions de l'AES, celles-ci ne
seront pas â€študiâ€šes dans cet ouvrage (vu la complexitâ€š de leur mise en
oeuvre).
Les fonctions de l'AES s'occupent essentiellement de la gestion de
l'â€šcran et de la souris.(FenÃ¨tres,gestion des objets...)

- Il faudra fournir un certain nombre de paramÃ¨tres aux fonctions du VDI
pour pouvoir obtenir l'effet dâ€šsirâ€š:
La transmission des paramÃ¨tres se fait par l'intermâ€šdiaire d'un TABLEAU:
(Un TABLEAU n'est rien d'autre qu'un espace de la mâ€šmoire qu'on a râ€šser-
vâ€š Ã partir d'une adresse (avec DS.x place) ).
Ce tableau est commun aux fonctions du VDI et de l'AES.
Le tableau se trouve dans le segment BSS et c'est Ã certaines de ses ad-
resses qu'on placera les paramÃ¨tres.
Dans le segment DATA, on devra aussi poser un label qui pointe sur les
diffâ€šrentes adresses du tableau.(Un label qui pointe sur des adresses
en zone DATA est gâ€šnâ€šralement appellâ€š VECTEUR...)
Dans le tableau qui regroupe toutes les râ€šservations pour les fonctions
du VDI et de l'AES, on distingue plusieurs groupes de tableaux:

.Le tableau pointâ€š par l'adresse 'CONTROL' (pour le VDI et l'AES)
:c'est dans ce tableau qu'on dâ€šposera le code de la fonction et
les dimensions des tableaux 'intin','ptsin','intout','ptsout'.

.Celui pointâ€š par l'adresse 'GLOBAL' (pour l'AES)
:dâ€štails plus loin...

.4 tableaux pointâ€šs par les adresses 'INTIN','INTOUT','PTSIN','PTSOUT'
Dans les tableaux de type 'IN', l'utilisateur peut fournir des para-
mÃ¨tres et dans ceux du type 'OUT', certaines fonctions du VDI ou de
l'AES retournent des valeurs.
Dans INTIN on placera les paramÃ¨tres propres Ã la fonction VDI ou
AES utilisâ€še.
Dans INTOUT, le VDI ou l'AES posera des donnâ€šes de retour.
Dans PTSIN on range des coordonnâ€šes:ce tableau est utlisâ€š par le VDI.
Dans PTSOUT le VDI fournit en retour des coordonnâ€šes (avec certaines
fonction).

.On trouvera aussi 2 tableaux: 'ADDRIN' et 'ADDROUT' qui sont
spâ€šcifiques Ã l'AES et qui contiennent des adresses (pointant
sur des donnâ€šes...).

.Le vecteur 'VDIPB' du segment DATA pointe successivement les adresses
des tableaux: CONTROL,INTIN,PTSIN,INTOUT,PTSOUT qui sont utilisâ€šs par
le VDI.

.Il existe aussi un vecteur (AESPB) qui pointe sur les adresses des
tableaux OPCODE,APVERS,INTIN,INTOUT,ADDRIN,ADDROUT et qui est uti-
lisâ€š par les fonctions de l'AES.

Ce tableau est donc composâ€š ainsi:

BSS ;segment BSS

CONTROL: ;tableau CONTROL (':' car il pointe sur une
;adresse et non pas sur une instruction...)
opcode ds.w 1 ;1Â° adresse du tableau 'control':opcode
sptsin ds.w 1 ;2Â° adresse:sptsin
sptsout ds.w 1 ;3Â° adresse:sptsout
sintin ds.w 1 ;4Â° adresse:sintin
sintout ds.w 1 ;5Â° adresse:sintout
idsfct ds.w 1 ;6Â° adresse:idsfct
handle ds.w 1 ;7Â° adresse:handle
ds.w 10

;le tableau CONTROL a une taille de 54 octets.

GLOBAL: ;dâ€šbut du tableau GLOBAL
apvers ds.w 1 ;1Â° adresse du tableau 'global':apvers
apcount ds.w 1 ;2Â° adresse:apcount
apid ds.w 1 ;3Â° adresse:apid
apprivate ds.l 1 ;4Â° adresse:apprivate
apptree ds.l 1 ;5Â° adresse:apptree
ap1resv ds.l 1 ;6Â° adresse:ap1resv
ap2resv ds.l 1 ;7Â° adresse:ap2resv
ap3resv ds.l 1 ;8Â° adresse:ap3resv
ap4resv ds.l 1 ;9Â° adresse:ap4resv

;le tableau GLOBAL a une taille de 30 octets

intin ds.w 128 ;tableau 'intin':128 mots

intout ds.w 128 ;tableau 'intout':128 mots

ptsin ds.w 128 ;tableau 'ptsint':128 mots

ptsout ds.w 128 ;tableau 'ptsout':128 mots

addrin ds.w 128 ;tableau 'addrin' (AES):128 mots

addrout ds.w 128 ;tableau 'addrout' (AES):128 mots

grhandle ds.w 1 ;ici on râ€šserve 1 mot pour le handle

ds.b 300 ;RESERVATIONS POUR SETBLOCK en 'PILE'
PILE ds.b 1

DATA ;segment DATA

;le vecteur de l'AES

ALIGN.W ;adresse paire car ici se trouvent des L-M

aespb dc.l control,global,intin,intout,addrin,addrout

;le vecteur du VDI

ALIGN.W ;adresse paire car ici se trouvent des L-M

vdipb dc.l control,intin,ptsin,intout,ptsout

END

- Ce tableau devra Ãªtre inclu dans vos listings si vous utilisez des
fonctions du VDI ou de l'AES.
Il se trouve dans le fichier :TABLEAU.L ,il vous suffira donc de
l'inclure Ã la fin de votre listing.

- VoilÃ maintenant la signification de chaque CHAMP (sous-parties)
des tableaux CONTROL et GLOBAL:

Tableau CONTROL:

opcode :(en CONTROL+0) =le code de la fonction Ã appeller
sptsin :(en CONTROL+2) =le nombre de couples de points dans PTSIN
sptsout :(en CONTROL+4) =idem pour PTSOUT
sintin :(en CONTROL+6) =nombre de mots dans INTIN
sintout :(en CONTROL+8) =idem pour INTOUT
idsfct :(en CONTROL+10)=nrÂ° d'identification de la fonction
handle :(en CONTROL+12)=nrÂ° du handle

Tableau GLOBAL

apvers :(en GLOBAL+0) =nrÂ° de la version de l'AES en service
apcount :(en GLOBAL+2) =nombre maximum autorisâ€š de programmes
simultanement en mâ€šmoire
apid :(en GLOBAL+4) =nrÂ° de l'application en cours
apprivate:(en GLOBAL+6) =selon la fonction
apptree :(en GLOBAL+10)=pointeur sur une structure d'arbre d'objets
ap1resv :(en GLOBAL+14)=râ€šservâ€š Ã des applications futures...
ap2resv :(en GLOBAL+18)=idem
ap3resv :(en GLOBAL+22)=idem
ap4resv :(en GLOBAL+26)=idem

- Mais avant de pouvoir utiliser les diffâ€šrentes fonctions du VDI ou
de l'AES, il faudra faire quelques initialisations.
(Comme pour le GEMDOS avec SETBLOCK).

Il faudra appeler les fonctions:APPL_INIT puis GRAF_HANDLE
pour initialiser l'AES.

Il faudra appeler les fonctions:OPEN_SCREEN_ WORKSTATION puis
pour initialiser le VDI.

- Pour appeller ces fonctions, nous allons passer les paramÃ¨tres
nâ€šcâ€šssaires dans le tableau (aux bonnes adresses) des râ€šserva-
tions et nous appellerons le VDI avec:

MOVE.L #vdipb,d1 ;adresse du VECTEUR VDIPB dans d1
MOVE #$73,d0 ;mot=$73 dans d0
TRAP #2 ;appel du VDI

ou l'AES avec:

MOVE.L #aespb,d1 ;adresse du VECTEUR AESPB dans d1
MOVE #$C8,d0 ;mot=$C8 dans d0
TRAP #2

et cela aprÃ¨s chaque fonction VDI ou AES que nous appelleront.

La fonction OPEN_SCREEN_WORKSTATION permet d'ouvrir une station
de travail en chargeant en mâ€šmoire le systÃ¨me de gestion graphique
du VDI.

Les paramÃ¨tres Ã fournir sont:

Dans opcode,1 MOT=100 (le CODE de la fonction)
Dans sptsin ,1 MOT=0
Dans sintin,1 MOT=11
Dans handle,le MOT pointâ€š par grhandle
Dans intin jusqu'Ã intin+20, 1 MOT=1

En râ€šalitâ€š, les paramÃ¨tres placâ€šs en INTIN, doivent donner les
renseignements suivants:

intin =identification du pâ€šriphâ€šrique Ã la carte mÃ¨re
intin+2 =type de ligne
intin+4 =couleur de la ligne
intin+6 =type de marquage
intin+8 =couleur du marquage
intin+10=jeu de caractÃ¨re
intin+12=couleur de l'â€šcriture
intin+14=type de remplissage
intin+16=motif de remplissage
intin+18=couleur du remplissage
intin+20=coordonnâ€šes pour des drapeaux

Mais nous ne nous en servirons pas, nous mettons alors toutes ces
valeurs Ã 1...

La fonction APPL_INIT de l'AES permet d'initialiser l'AES.

Les paramÃ¨tres Ã fournir sont:

Dans les 4 apresv,1 L-M=0
Dans opcode,1 MOT=10 (le CODE de la fonction)
Dans sptsin,1 MOT=0
Dans sptsout,1 MOT=1
Dans sintin,1 MOT=0
Dans sintout,1 MOT=0

La fonction GRAF_HANDLE de l'AES permet de donner un numâ€šro
d'identification Ã notre programme.
Ce numâ€šro retourne dans INTOUT et nous le placerons en 'grhandle'.

Les paramÃ¨tres Ã passer sont:

Dans opcode,1 MOT=77 (le CODE de la fonction)
Dans sptsin,1 MOT=0
Dans sptsout,1 MOT=5
Dans sintin et sintout, 1 MOT=0

Comme la fonctions OPEN_SCREEN_WORSTATION du VDI a besoin de ce nrÂ°
d'identification ( paramÃ¨tre ), c'est par l'appel de l'AES qu'il
faudra commencer.

AprÃ¨s l'appel de la fonction GRAF_HANDLE de l'AES, nous poserons
le nrÂ° d'identification dâ€šposâ€š en INTOUT en 'grhandle' avec:

MOVE INTOUT,GRHANDLE

Nous allons aussi crâ€šer 2 MACROS instructions qui vont se charger
d'appeller le VDI et l'AES.

VDI MACRO ;macro d'appel du VDI
MOVE.L #VDIPB,d1 ;adresse du Vecteur VDIPB dans d1
MOVE #$73,d0 ;mot=$73 dans d0
TRAP #2 ;appel du GEM
ENDM ;fin de la macro

AES MACRO ;macro d'appel de l'AES
MOVE.L #AESPB,d1 ;adresse du Vecteur AESPB dans d1
MOVE #$C8,D0 ;mot=$C8 dans d0
TRAP #2 ;appel du GEM
ENDM ;fin de la macro

- Le listing complet du programme d'initialisation pour l'AES et le
VDI sera donc:

; initialisation du VDI et de l'AES

TEXT

VDI MACRO
move.l #vdipb,d1
move #$73,d0
trap #2
ENDM

AES MACRO
move.l #aespb,d1
move #$C8,D0
trap #2
ENDM

; APPL_INIT

move.l #0,ap1resv
move.l #0,ap2resv
move.l #0,ap3resv
move.l #0,ap4resv
move.w #10,opcode
move.w #0,sptsin
move.w #1,sptsout
move.w #0,sintin
move.w #0,sintout
AES ;-->AES

; GRAF_HANDLE

move.w #77,opcode
move.w #0,sptsin
move.w #5,sptsout
move.w #0,sintin
move.w #0,sintout
AES ;-->AES

move.w intout,grhandle ;On sauvgarde le HANDLE

; OPEN VIRTUAL SCREEN WORKSTATION

move.w #100,opcode
move.w #0,sptsin
move.w #11,sptsout
move.w grhandle,handle
move.w #1,intin
move.w #1,intin+2
move.w #1,intin+4
move.w #1,intin+6
move.w #1,intin+8
move.w #1,intin+10
move.w #1,intin+12
move.w #1,intin+14
move.w #1,intin+16
move.w #1,intin+18
move.w #1,intin+20
VDI ;-->VDI

END

Le listing de cette initialisation se trouve dans le fichier INIT_GEM.L

- Tous vos programmes qui utilisent le VDI ou l'AES auront donc
cette structure:

TEXT

INCLUDE "INIT_TOS.L" ;fichier de la macro SETBLOCK
INCLUDE "INIT_GEM.L" ;fichier des initialisations du VDI/AES

SETBLOCK ;râ€šserve mâ€šmoire

. ;les instructions qui forment
. ;votre programme...
.

DATA

. ;les donnâ€šes initialisâ€šes
.

BSS

INCLUDE "TABLEAU.L" ;le TABLEAU du VDI et de l'AES:
;Contient aussi les râ€šservations en 'PILE'
;pour SETBLOCK...
END

*** LES FONTIONS DU VDI ***
---------------------------

Vous voilÃ prÃ¨ts Ã prâ€šsent Ã utiliser les fonctions graphiques du VDI:

Je vais citer les fonctions les plus intâ€šressantes et vous donner pour
chacunes d'elles les paramÃ¨tres Ã passer dans le tableau: TABLEAU.L

Je vous donnerais aussi les paramÃ¨tres de retour si la fonction en
fournit et si ils peuvent Ãªtre utiles...

TEXT:Permet l'â€šdition d'un texte Ã des coordonnâ€šes (x,y)
----
ParamÃ¨tres:

Opcode=8
sptsin=1
sintin=n
handle=grhandle
intin=la chaine de caractÃ¨re composâ€še de 'n' lettres
ptsin=x
ptsin+2=y

NB:La chaine de caractÃ¨re doit se terminer par une valeur NULLE.
--

GRAPHIC TEXT COLOR:Permet de selectionner la couleur d'un texte graph.
------------------
ParamÃ¨tre:

opcode=22
sptsin=0
sintin=1
handle=grhandle
intin=couleur choisie

GRAPHIC TEXT SPECIAL EFFECTS:Permet de manipuler le type du texte graph.
----------------------------
Le type du texte graphique est dâ€šposâ€š en 'intin' sous la forme d'un mot,
seuls les bits 0 Ã 5 du mot sont utilisâ€šs et permettent de choisir:

nrÂ° BIT: Effet sur TEXT

0 caractÃ¨res gras
1 caractÃ¨res fins
2 caractÃ¨res italiques
3 caractÃ¨res soulignâ€šs
4 caractÃ¨res 'light'
5 caractÃ¨res 'outline'

paramÃ¨tres:

opcode=106
sptsin=0
sintin=1
handle=grhandle
intin=vecteur bit

CONTOUR FILL:Permet de remplir une surface Ã partir d'un point de dâ€špart
------------ de coordonnâ€šes (x,y)

ParamÃ¨tres:

opcode=103
sptsin=1
sintin=1
handle=grhandle
intin=couleur du remplissage
ptsin=x
ptsin+2=y

SET FILL COLOR INDEX:Dâ€štermine la couleur utilisâ€še pour les fonctions de
-------------------- remplissage.

ParamÃ¨tres:

opcode=25
sptsin=0
sintin=1
handle=grhandle
intin=couleur de remplissage

ParamÃ¨tres de retour:

intout=couleur de remplissage

SET FILE INTERIOR:Permet de selectionner le type de remplissage pour
----------------- les fonctions de remplissage

Il existe 5 types de remplissages:

0=pas de remplissage
1=remplissage de type PLEIN avec la couleur selectionnâ€še
2=remplissage avec des motifs prâ€šdâ€šfinis
3=remplissage avec des HACHURES
4=remplissage avec un motif redâ€šfini par le programmeur

ParamÃ¨tres:

opcode=23
sptsin=0
sintin=1
handle=grhandle
intin=type de remplissage (0-5)

SET FILL STYLE:Permet de selectionner la matrice pour les fonctions de
-------------- remplissage:36 motifs sont disponibles

La matrice est la trame utilisâ€še pour le remplissage de la surface:
Elle peut Ã¨tre du type 3 (24 motifs) ou du type 2 (12 motifs) (voir
la fonction SET FILL INTERIOR pour les 5 types disponibles)

ParamÃ¨tres:

opcode=24
sptsin=0
sintin=1
handle=grhandle
intin=nrÂ° motif (1-24) ou (1-12)

SET WRITING MODE:Permet de selectionner le mode d'â€šcriture de toutes les
---------------- â€šditions graphiques.

En mode 1:mode AND, ce qui est en dessous est toujours effacâ€š.
En mode 2:mode OR , on â€šcrit seulement lÃ oâ€” il n'y a pas encore de
points et les vides sont toujours reprâ€šsentâ€šs.
En mode 3:mode XOR ,on ne place des points que lÃ oâ€” il n'y en a pas
encore et les points dâ€šjÃ occupâ€šs sont â€šffacâ€šs
En mode 4:mode transparent inverse, on ne place que des points lÃ oâ€” il
y en avait dâ€šjÃ et seulement si ils ne possÃ¨dent pas de cou-
leur (permet d'obtenir un NEGATIF de la trame destination).

ParamÃ¨tres:

opcode=32
sptsin=0
sintin=1
handle=grhandle
intin=mode graphique (1-4)

FILL RECTANGLE:Rempli un rectangle dâ€šfinit ainsi:coordonnâ€šes du coin
-------------- supâ€šrieur gauche (x1,y1),coordonnâ€šes du coin infâ€šrieur
droit (x2,y2)

ParamÃ¨tres:

opcode=114
sptsin=2
sintin=0
handle=grhandle
ptsin =x1
ptsin+2=y1
ptsin+4=x2
ptsin+6=y2

CIRCLE:Permet de dessiner un cercle de coordonnâ€šes (x,y) et de rayon R
------ Ã l'â€šcran.

ParamÃ¨tres:

opcode=11
sptsin=3
sintin=0
idsfct=5
handle=grhandle

ptsin =x
ptsin+2=y
ptsin+4=0
ptsin+6=0
ptsin+8=R
ptsin+10=0

- VoilÃ pour les fonctions du VDI, je n'ai bien sur pas prâ€šsentâ€š toutes
les fonctions...
Elles sont bien trop lentes et trop lourdes Ã exploiter pour pouvoir
vâ€šritablement Ãªtre dignes de votre attention...
Je parlerais bientot des LINES_A, ce sont aussi des fonctions graphi-
ques mais elles au moins sont trÃ¨s rapides.En attendant, vous pouvez
regarder le listing d'un programme exemple qui illustre clairement
l'utilisation des fonctions du VDI dâ€šcrites ci-dessus.

.Listing :fichier VDI.L
.â€šxecutable:fichier VDI.PRG

NB:Si vous dâ€šsirez utiliser une fonction du VDI dans une boucle, il
-- n'est pas nâ€šcessaire de râ€šinitialiser tous les paramÃ¨tres du tableau
puisqu'ils ne sont pas effacâ€šs:il suffira donc de faire varier les
paramÃ¨tres qui doivent changer dans votre boucle puis d'appeller le
VDI.

Ceux qui dâ€šsirent malgrâ€š tout en savoir plus sur les fonctions du VDI
ou de l'AES pourront se râ€šfÃ¨rer au livre:
'LE LIVRE DU GEM' de Micro Application.

PIECHOCKI Laurent
8, Impasse Bellevue Suite dans le fichier LINEA.DOC
57980 TENTELING ---------

</pre>
Back to [[ASM_Tutorial]]

Pl2 VDI.DOC - Revision history

>Wongck at 15:19, 12 October 2011

>Silver Surfer: Added category

>Zorro 2 at 15:06, 9 October 2006