Gruppo Editoriale - Amiga Magazine Online

Le pagine di
1 Tmnsactor per AMIGA
duate dalle abbreviazioni "ie-X" e "ie-Y"); oppure come un
singolo APTR: "ie-position.ie-addr" (abbreviato come
"ieEventAddress").
Questo ultimo caso, che serve ad individuare l'indirizzo di
oggetti manipolati da Intuition, come i Gadget, non ha
riscontro per gli input handler che intercettano gli eventi
prima di Intuition.
I1 primo caso ha significato quando la classe è
IECLASS-RAWMOUSE e il qualificatore contiene il valore
IEQUALIFIER-RELATIVEMOUSE: in tal caso, la prima
word esprime il movimento del mouse rispetto all'asse delle
x (positivo verso destra, negativo verso sinistra) e la secon-
da quello rispetto all'asse delle y (positivo verso il basso e
negativo verso l'alto).
Quando invece la classe è IECLASS-RAWKEY, il campo
ie-X va interpretato come la sequenza di due byte in cui il
primo esprime il valore ie-Code del tasto premuto prima
dell'attuale e il secondo i suoi qualificatori (limitatamente a
quelli il cui valore è inferiore a $100). Il campo ie-Y contie-
ne lo stesso tipo di valori per il penultimo tasto premuto.
Queste informazioni vengono trasmesse solo quando l'e-
vento riguarda la pressione di un tasto, non al momento del
suo rilascio (e non appare quando si preme un singolo
qualificatore).
In definitiva, dall'evento che riporta informazioni su un
tasto si possono ricavare i valori dei due tasti che l'hanno
preceduto. Ad esempio, se viene premuta la sequenza di
tasti: "Shift-A B C", l'evento che segnala la pressione del
tasto "C" avrà nel campo ie-Y il valore $2001 in cui $20
corrisponde all'ie-Code del tasto "A" e $01 al qualificatore
Shift-sx; nel campo ie-X si troverà $3500 che indica il tasto
raw $35 ("B") senza alcun qualificatore. Va osservato che
questo comportamento non sembra essere documentato
nella prima edizione del ROM Kernel Manual e, pertanto,
non deve essere considerato sicuro.
Le ultime due longword costituiscono una struttura timeval
(ieTimeStamp). La struttura timeval, descritta nel file inclu-
de "devices/timer.h", contiene il valore del tempo di siste-
ma espresso in secondi (tv-secs) e microsecondi
(W-micro).
Come diventare "input handler"
Per poter ricevere ed eventualmente modificare il flusso di
eventi in input occorre richiedere all'input.device di diven-
tare un "input handler" (gestore di input), indicando la
priorità che si intende assumere. I1 device mantiene una lista
di tutti gli input handler, ordinata gerarchicamente secondo
la priorità segnalata al momento della richiesta. Intuition ha
priorità 50, dunque, per ricevere i dati prima, occorre
specificare una priorità più alta, compresa tra 51 e 127.
Inoltre, bisogna specificare l'indirizzo della propria routine,
che verrà chiamata per gestire il flusso dei dati e un indirizzo
(opzionale) di memoria che costituirà una area dati privata
per la nostra routine.
La nostra funzione sarà chiamata, dal task dell'input.device,
tutte le volte che awiene un nuovo evento, con l'indirizzo
del flusso di input nel registro A0 e quello della nostra area
dati nel registro Al; il task, inoltre, attende come valore di
ritorno, nel registro DO, I'indirizzo del flusso di input da
passare agli altri input handler. Se noi scriviamo la routine
in C, dobbiamo risolvere il problema di trasferire i dati dai
registri allo stack.
Questo può essere fatto in due modi diversi: prima di tutto
scrivendo un brevissimo programma in assembler che tra-
sferisca il contenuto dei registri sullo stack (con un'istruzio-
ne del tipo M0VEM.L AO/Al,-(A7) ), chiami poi la nostra
routine in C e, infine, ripristini il valore dello Stack Pointer;
oppure, per chi possiede la versione 5.x del compilatore
Lattice, definendo la propria routine con la keyword -asm
e specificando i parametri come register A0 e register Al (si
veda sorgente su disco).
Si tenga presente, inoltre, che la routine, pur appartenendo
fisicamente al segmento dimemoria del nostro programma,
viene eseguita come parte del task dell'input.device; per-
tanto, in primo luogo, utilizzerà il suo stack (di cui non si
dovrà abusare); in secondo luogo, la routine NON verrà
chiamata con I'indirizzo della base dei dati nel registro A4.
La presenza di tale valore è necessaria quando si compila un
programma C con indirizzamento relativo dei dati, cosa che
permette di risparmiare molta memoria e che awiene di
default sul Lattice C 5.0; è necessario quindi caricare l'indi-
rizzo della base dei dati nel registro A4: ciò può avvenire
specificando l'opzione -y (in qualsiasi versione del Lattice)
oppure, nella versione 5.x del Lattice, utilizzando la key-
word -saveds al momento della dichiarazione della fun-
zione o la funzione di libreria geta4().
In terzo luogo, il nostro programma principale non può
terminare finché l'handler resta in funzione, in quanto
ArnigaDos libererebbe sia la nostra memoria che quella
dell'input handler.
Per far entrare in funzione l'input handler, si deve dapprima
creare un Port con la funzione CreatePort; poi uno IOSt-
dReq con la funzione CreateStdIO e aprire il device con
OpenDevice.
A questo punto occorre inserire in una struttura Interrupt i
dati relativi al nostro handler: un puntatore alla funzione nel
campo is-Code, uno all'area dati in quello is-Data e la
priorità richiesta nel campo is-Node.ln-Pri. Infine, una
volta posto il puntatore alla struttura Interrupt nel campo
io-Data dell'IOStdReq e il comando IND-ADDHANDLER
nel campo io-Command, si puo inviare la richiesta
alllinput.device con la funzione DOIO().
Come al solito, ad ogni passo occorre controllare i valori di
ritorno delle funzioni, per assicurarsi che ogni nostra ope-
razione abbia avuto successo. Da questo momento l'han-
dler è attivato e lo rimarrà fino a quando il device non
riceverà la richiesta di eseguire un comando
IND-REMHANDLER. Prima di terminare occorre ricordarsi
di liberare tutte le risorse allocate.