1 - Amiga Magazine Online

siamo interessati (si veda la tabella 2). Quando si verifica
uno di questi eventi, Intuition invia un messaggio (strut-
tura IntuiMsg) alla porta associata alla finestra; vedremo
fra poco come ricevere e interpretare questi messaggi.
I Jag difinestra, al contrario, segnalano a Intuition alcuni
particolari sulle proprietà della finestra; spesso ci sono
corrispondenze precise fra Jag di finestra e Jag IDCMP
per esempio, se il Jag difinestra chiede che venga dise-
gnato il gadget di chiusura, il Jag IDCMP dovrà chiedere
che venga spedito il messaggio relativo quando l'utente
preme il gadget, a meno di non volere un gadget di chiu-
sura che non funziona!
I1 titolo è, semplicemente, il titolo della finestra, sotto for-
ma di stringa, mentre schermo e flag di schermo indicano
su quale schermo essa dovrà aprirsi: se Jag di schermo
vale CUSTOMSCREEN (15), la finestra si aprirà sullo
schermo indicato (questo puntatore può essere ottenuto
da OpenS( ) o dalle tradizionali funzioni di Intuition), al-
trimenti il valore WBENCHSCREEN (1) farà sì che la fine-
stra si apra sullo schermo del Workbench, o sullo scher-
mo pubblico di default, e in tal caso il parametro scher-
mo sarà ignorato.
Rimane il parametro gadget, che però vedremo in seguito
quando parleremo della funzione Gadget( ), e la taglist
che può essere utile per specificare ulteriori parametri.
i1 valore ritornato da OpenW( ) è un puntatore alla fine-
stra di Intuition (PTR T0 window), che può essere usato
con le normali funzioni di AmigaOS, oppure NIL in caso
di fallimento. Inutile dire che la finestra può essere chiu-
sa con la funzione:
analogamente a quanto abbiamo visto per gli schermi.
Le funzioni di disegno
Una volta aperto uno schermo o finestra, è possibile usa-
re le funzioni di disegno che E mette a disposizione. Tut-
te queste funzioni fanno riferimento a una variabile pre-
definita di nome stdrast, che contiene un puntatore a
un'area di disegno (struttura RastPort della graphics.li-
brary); sia OpenS( ) che OpenW( ) impostano stdrast alla
RastPort dello schermo o della finestra appena aperta, ed
è quindi sufficiente aprire uno schermo o finestra perché
sia subito possibile disegnare al loro interno (di conver-
so, le funzioni di chiusura impostano stdrast a NIL, per
cui non è più possibile disegnare alcunché).
La prima, e più semplice, di queste funzioni è la:
che traccia un singolo punto alle coordinate x, y con il
colore indicato (il numero massimo di colori dipende dal-
lo schermo su cui si disegna). Similmente, la funzione:
traccia una linea dal punto xl, yl al punto x2, y2 nel co-
lore indicato, mentre la:
traccia un rettangolo (pieno) con gli estremi indicati. L'ul-
tima funzione di tracciamento è la:
in cui il formato e gli (eventuali) argomenti sono simili a
quelli di WriteF( ) ma che, a differenza di questa, "stam-
pa" la stringa risultante alle coordinate x, y della stdrast.
I1 font usato per questa stringa sarà quello di default, a
meno che non venga modificato tramite le funzioni della
graphics.library o la funzione di E:
che imposta (ovviamente) il font Topaz nella dimensione
punti (attenzione: l'uso di questa funzione è sconsigliato,
poiché non tiene conto delle preferenze dell'utente); il
font Topaz è sempre disponibile nelle versioni a 8 e 9
punti (sono entrambe in ROM), altre dimensioni possono
essere presenti su disco o prodotte scalando opportuna-
mente una di quelle disponibili.
La gestione dei colori è affidata a due funzioni, la prima
è:
la quale, limitatamente allo schermo indicato,che deve es-
sere uno schermo custom, eventualmente aperto con
OpenS( ), imposta il colore numero reg ai valori RGB in-
dicati. I colori sono espressi su 24 bit, 8 bit per compo-
nente, per cui 255, 255, 255 rappresenta il bianco puro,
mentre 128, 128, O è un giallo a mezza intensità; la fun-
zione provvede ad "adattare" il colore richiesto alle possi-
bilità della macchina disponibile (per gli Amiga ECS, so-
no possibili soltanto 4.096 colori, contro gli oltre 16 mi-
lioni degli Amiga AGA).
La seconda funzione è: