                    ZX Plus Version 0.22 Documentation
                    ----------------------------------

Indice
------
1.0 Introduzione
2.0     Installazione
3.0     Caricamento
4.0     Il Menu
        4.1     File
                4.1.1   Load
                4.1.2   Save
                4.1.3   Quick Load
                4.1.4   Quick Save
                4.1.5   Exit

        4.2     Menu Options
                4.2.1   Joystick 1
                4.2.2   Joystick 2
                4.2.3   Sound
                4.2.4   Capture Screen
                4.2.5   Screen Mode

        4.3     Machine
                4.3.1   Spectrum 48K
                4.3.2   Spectrum 128K

        4.4     Help
                4.4.1   About

5.0     Tastiera
6.0     Cambiamenti nelle versioni


1.0 Introduzione
----------------
ZX Plus e' un emulatore gratuito di ZX Spectrum 48K e 128K scritto da Mark
Swinhoe e Justin Wood. Per scaricare l'ultima versione di ZX Plus visitate il
sito http://www.emuunlim.com/zxplus. Sul sito sono presenti informazioni come
le ultime novita' sull'emulatore, delle immagini e vari collegamenti a siti
utili. Lo scopo di questo documento e' quello di spiegare l'uso di ZX Plus.
Sia questo documento che ZX Plus sono progettati per essere di facile utilizzo, quindi se riscontrate dei problemi mandate un'e-mail
all'indirizzo zxplus@yahoo.co.uk (scrivendo in inglese).  Allo stesso modo, fateci
anche sapere se manca qualcosa nella documentazione, o se questa non rispecchia il
reale utilizzo dell'emulatore. Questo documento e' diviso in varie sezioni,
in modo da renderne semplice la consultazione. Chi e' gia' pratico di Windows
e degli emulatori puo' evitare di leggere la documentazione e provare direttamente l'emulatore.


2.0 Installazione
-----------------
Scaricate l'emulatore ed estraetelo in una cartella con PKZIP o con Win Zip.
I file contenuti sono:-

   zxplus.exe  - L'emulatore
   roms.bin    - rom 48K e 128K
   z80.tab     - Timing della CPU Z80
   english.txt - Documentazione in inglese
   italia.txt  - Documentazione in italiano tradotta da Mauro Grauso (Chrom_)


3.0 Caricamento
---------------
ZX Plus Puo' essere caricato in due modi. Il primo e' di lanciare il file
eseguibile(zxplus.exe). Se viene seguita questa procedura, l'emulatore parte
eseguendo la rom dello Spectrum 128K, proprio come farebbe un vero Spectrum
all'accensione. La seconda maniera e' di associare i file "snapshot" (con
estensione .Z80 e .SNA) con ZX Plus. In questo modo l'emulatore partira'
caricando il file "snapshot" su cui avete fatto doppio click.


4.0 Il Menu
-----------
Il menu a scomparsa permette di configurare l'emulatore. Esso viene richiamato
premendo il tasto Esc. La stessa procedura permette di disattivare il menu. Si
puo' navigare nei menu premendo le lettere evidenziate (come F per File), o
usando i tasti direzionali e il tasto Invio per selezionare. Per esempio con
la sequenza Esc, F, X si esce dall'emulatore. Si puo' anche esplorare il menu
usando il joystick. Se questo dovesse causare dei problemi, e' stata implementata la combinazione di tasti Alt+F4 come "uscita d'emergenza".
Ora passiamo alla spiegazione dei menu.


4.1.0 File
----------
Il menu "File" serve a caricare gli snapshot, salvarli, e uscire dall'emulatore.


4.1.1 Load
----------
Per caricare un gioco selezionare l'opzione Load dal menu File. Apparira'
una finestra che mostra una riga di comando dove scrivere il nome del gioco,
una con la cartella corrente, e una con il contenuto della cartella.
Per selezionare un file usando la riga di comando scrivere il nome del file
e il percorso e premere Invio. Se e' stato inserito il nome di una cartella,
verra' visualizzato il contenuto di essa. Le cartelle sono visualizzate in
parentesi quadre "[...]", i drive sono contraddistinti da ":", e i file
semplici non hanno simboli di distinzione. Usate i tasti Cursore Su, Cursore
Giu', Home, Fine, Pag Su e Pag Giu' per navigare tra i menu, e il tasto Invio
per selezionare l'oggetto evidenziato. Il menu sparisce quando selezionate
qualcosa di diverso da una cartella o un drive. Per uscire dal menu premere il
tasto Esc.


4.1.2 Save
----------
Questa opzione funziona esattamente come nella sezione 4.1.1 (Load), tranne
per il fatto che se un file non esiste, verra' creato. Verra' mostrato un messaggio di errore se il salvataggio non puo'
essere effettuato. Cio' puo' accadere ad esempio se il nome che avete
assegnato al file non e' valido, o se cercate di salvare su un'unita' CD-ROM. Quando
viene scelta questa opzione, ZX Plus ricorda il nome del file per usarlo
nelle sezioni 4.1.3-4.1.4. L'unica maniera di creare un nuovo file e' di
scrivere il nome del file nella riga di comando. Se usate la riga di comando,
dovrete specificare l'esatta estensione del file, altrimenti l'emulatore non
sara' in grado di salvare correttamente i dati.


4.1.3 Quick Load
----------------
ZX Plus tiene conto degli ultimi file che avete caricato e / o salvato,
caricando con quest'opzione l'ultimo file caricato / salvato. Se non avete
caricato nessun file precedentemente, non accadra' nulla. Questa opzione e'
spesso usata insieme alla sezione 4.1.4 (Quick Save), in modo da poter
caricare e salvare velocemente mentre state giocando. Diversamente dalle
opzioni Load e Save, una volta selezionato Quick Load, l'emulatore non torna
al menu principale, ma passa direttamente al gioco.


4.1.4 Quick Save
----------------
Questa opzione salva il file che e' stato caricato o salvato per ultimo.
Molto simile alla sezione 4.1.3 (Quick Load).


4.1.5 Exit
----------
Con questa opzione si esce dall'emulatore senza che venga chiesta conferma.
Con la combinazione Alt+F4 si ottiene lo stesso effetto, ma questo secondo
metodo e' consigliato solo in caso che l'emulatore diventi instabile.


4.2 Il Menu Options
-------------------
Da questo menu si puo' configurare l'emulatore e modificare le opzioni,
come ad esempio il tipo di joystick da emulare.


4.2.1 Joystick 1
----------------
Questo menu' e' diviso in quattro parti: joystick emulation, test area,
emulation mapping, e menu mapping. Il tasto Tab sposta il cursore tra le
varie aree. Per confermare le opzioni che selezionate, premete il pulsante
"okay". Per uscire dalla schermata premere il tasto Esc o selezionare il
pulsante Cancel. Si puo' scegliere il tipo di joystick che la prima periferica
di controllo deve emulare: Kempston, Cursors, Sinclair I, o Sinclair II. La
selezione corrente e' visualizzata in bianco. Per spostarsi tra i diversi modi
di emulazione spostarsi su "mode" e premere Invio. La "Test Area" permette di
configurare la soglia di input dei joystick con i tasti + e - del tastierino
numerico della tastiera. Quest'area permette anche di controllare il
funzionamento dei pulsanti del joystick. La soglia di input dei joystick si
usa per i joystick analogici, e serve a decidere quanto bisogna spostare il
joystick in una certa direzione prima che l'emulatore interpreti quel segnale
come uno spostamento. Minore e' la soglia, piu' velocemente rispondera' il
joystick, ma sara' piu' facile che il joystick si muova in una direzione
indesiderata. Quando si preme un pulsante, viene evidenziato in giallo il
numero e la mappatura del pulsante premuto, per mostrare che il pulsante e'
stato premuto. Per queste ragioni la mappatura del joystick sulla tastiera
viene ignorata, in modo da permettere l'utilizzo delle frecce direzionali
della tastiera per navigare il menu.

La mappatura dei tasti permette di utilizzare un tasto della tastiera sul
joystick, in modo da sfruttare meglio il joystick in quei giochi in cui si
usa sia la tastiera che il joystick (come Xenon, dove il tasto M serve a
trasformarsi da astronave a carro armato). Usate le frecce direzionali per
selezionare un tasto, e premete Invio per configurarlo con il joystick.
Apparira' una finestra che chiede di premere un pulsante o un tasto. Puo'
essere mappato qualsiasi tasto della tastiera, compreso quelli che non hanno
funzioni (come i tasti F1-F12). Premendo un pulsante, si assegnera' la
funzione selezionata a quel pulsante. Per eliminare una mappatura di un tasto,
premere il tasto Backspace, dopo aver selezionato il pulsante da eliminare. Il
Pulsante 1 non puo' essere modificato, perche' emula sempre il tasto di fuoco
del joystick. Il "menu mapping" funziona allo stesso modo, ma esegue la
configurazione dei tasti per i menu, invece che per l'emulazione. In questo
secondo caso puo' essere configurato anche il Pulsante 1.


4.2.2 Joystick 2
----------------
Identico alla sezione 4.2.1 (Joystick 1) ma per il joystick 2. Si possono fare
cose impossibili su un vero Spectrum, come utilizzare allo stesso tempo sia un
joystick Kempston che un Sinclair II. Giochi come Batty si giovano di questa
possibilita'.


4.2.3 Sound
-----------
Permette di disattivare l'emulazione dell'audio (no sound), di usare lo speaker
del PC (raccomandato) o di usare la Sound Blaster utilizzando la variabile
d'ambiente BLASTER (per esempio SET BLASTER=A220 I5 D1).


4.2.4 Capture Screen
---------------------
Questa opzione salva un'immagine dello schermo attuale dello Spectrum in un
file bitmap non compresso da 302K, nella posizione specificata. La scelta
della locazione e' esattamente uguale a quella della sezione 4.1.2 (Save),
ma vengono mostrati solo i file con estensione BMP.


4.2.5 Screen mode
-----------------
Permette di cambiare la modalita' di schermo. Ci sono quattro possibilita':
Classic, Scanlines, Interpolation, e Scanlines e Interpolation insieme. Lo
schermo dello Spectrum viene raddoppiato in altezza e in lunghezza, quindi a
schermo pieno, vengono raddoppiare le linee di pixel orizzontali e verticali.
Scanlines freppone delle linee nere tra le linee orizzontali di pixel. ZX Plus
supporta solo l'interpolazione orizzontale, quindi i pixel presenti tra due
pixel dello schermo dello Spectrum, vengono visualizzati eseguendo la media
dei colori tra il pixel di destra e quello di sinistra (come avviene con gli
schermi delle TV).


4.3 Machine
-----------
Seleziona il tipo di macchina de emulare. Fin ora si puo' scegliere solo tra
Spectrum 48K e 128K.


4.3.1 Spectrum 48K
------------------
ZX Plus parte emulando uno ZX Spectrum 48K ed esegue un hard reset.


4.3.2 Spectrum 128K
-------------------
ZX Plus parte emulando uno ZX Spectrum 128K ed esegue un hard reset


4.4 Help
--------
Questo menu contiene tutte le informazioni sull'emulatore. Attualmente sono
presenti solo le informazioni sull'emulatore, e non la guida in linea (che
contiamo di inserirne una quanto prima).


4.4.1 About
-----------
Questo menu mostra il nome del programma, il numero della versione, la data di
uscita della versione, indirizzo Internet e i nomi degli autori. Usare questo
menu e' il miglior modo per controllare quale versione di ZX Plus state utilizzando.

5.0 Tastiera
------------
La tastiera dello Spectrum e' mappata su quella del PC in questo modo :-

                Spectrum        |       PC
        ------------------------+----------------------
                A-Z             |       A-Z
                0-9             |       0-9
                Delete          |       Backspace
                Tasti Cursore   |       Tasti cursore
                Cursor fire     |       Control
                Shift           |       Alt
                Extended mode   |       Shift
                Brake           |       Apostrofo (`)


6.0 Cambiamenti nelle versioni
------------------------------
Versione 0.22 - Aggiunta la configurazione dei joystick e la mappatura su
                tastiera, in modo da gestire i giochi che necessitano di
                tastiera e joystick contemporaneamente.
              - Eliminati altri bug dello Z80. Ora Bravestar e altri giochi
                funzionano meglio.
              - Eliminato il problema con il bordo nel caricamento da
                Windows Explorer.
              - Eliminato il problema del caricamento errato da Windows dei
                file Z80 ver.1.45
              - Cambiato il file zxplus.dat che ora contiene anche la
                configurazione die joistick
              - Eliminato il problema del display corrotto con alcune schede
                video
Versione 0.21 - Eliminato il problema di scorretto caricamento dei file Z80
                versione 2 e 3.
              - Migliorato il calcolo della velocita' da parte dell'emulatore
              - Miglioramenti nell'uso del chip audio AY8912, la cui
                implementazione avverra' probabilmente nella version 0.30
              - Modificato il menu, in modo da interpretare la pressione di
                piu' tasti come un'unica pressione. I tasti backspace, page up,
                page down e le frecce direzionali possono essere premute insieme
                in modo da produrre pressioni multiple di tasti. Questo  evita
                la selezione di piu' opzioni quando si tiene premuto un tasto
              - Migliorato il suono con la SoundBlaster. Eliminato un bug
                che rendeva muti alcuni giochi (Nodes of Yesod, KnightLore, ecc.)
                Cambiata la Rom 128K, ora il reset 128K funziona bene.
Versione 0.20 - Eliminati dei problemi nell'emulazione dello Z80, ma ce ne sono
                ancora molti.
              - Implementato un timing piu' veloce, in modo da ottenere audio
                migliore su macchine piu' potenti. La porta della SoundBlaster
                ora viene trovata automaticamente, riferendosi alla variabile
                d'ambiente BLASTER (se e' diversa da 220h).
              - Implementato lo Spectrum 128K senza audio, il caricamento
                e il salvataggio di file .Z80 e .SNA,lo shadow screen. La rom
                128K e' instabile, quindi quella di default e' la 48K.
                Funzionano correttamente Yie Ar Kung Fu, Target Renegade e
                alcuni altri. I tasti extra dello Spectrum 128K non sono
                ancora stati implementati.
              - Implementati alcuni flag non documentati (bit 3 e 5 di F)
                quindi ora alcune funzioni del basic 48K sono corrette
                mentre altre non lo sono ancora. Prima questi valori
                erano casuali. Mappati i tasti delete con il backspace
                del PC e il tasto break con l'apostrofo del PC.
              - Aggiunto un menu per la selezione della modalita' video:
                Classic (schermo pieno senza interpolazione), Interpolation
                (schermo pieno con interpolazione orizzontale), Scanlines
                (Linee nere frapposte alle linee di pixel dello Spectrum,
                quindi il doppio piu' veloce dell'opzione fullscreen) e
                Scanlines and Interpolation (configurazione di default
                nella versione 0.10). La modalita' video viene salvata nel
                file zxplus.dat.
Versione 0.10 - Prima release.

--EOF--