DAMTAPE (info essenziale)
-----------------------------

Dato uno "SPECTRUM file" memorizzato (con caricamento a velocita' normale)su nastro
magnetico danneggiato in uno o più punti, DAMTAPE recupera automaticamente gli
spezzoni di programma BASIC contenuti nelle parti integre del supporto comprese
tra le interruzioni dovute al danneggiamento,generando files di testo contenenti
i listati e relativi files.TAP.

Mette inoltre a disposizione dell'utente il "file binari" contenenti il codice
relativo ad area variabili, screen, m/c , chr/num array,udg,headers, ecc.

###############################################################################


DAMTAPE F.A.Q.
--------------------


D. QUALE E' LA PECULIARITA' DI 'damtape' ?
R. Puo' "leggere" blocchi di codice spectrum anche completamente privi di "header"
(ogni frammento di codice).

D. PER QUALE ATTIVITA' 'damtape' E' PARTICOLARMENTE UTILE ?
R. Per recuperare codice binario da nastri reali (dello zx spectrum) danneggiati
(SOLO CON CARICAMENTO A VELOCITA' NORMALE).

D. COSA 'damtape' NON E'!!!
R. 'damtape'NON E' UN CONVERTITORE wav2tap!!! Se il tuo nastro reale e' perfettamente
funzionante e vuoi soltanto convertirlo in un file nastro virtuale(tap/tzx),ti
suggerisco di utilizzare un programma specifico.

D. CHE TIPO DI FILE E' SUPPORTATO ?
R. FILE .WAV (44.1 Mhz,8 bit mono).

D. COSA ACCADE AL TUO FILE .WAV ?
R. step 1:estrazione di ogni singolo "bit".
step 2:shifting...
step 3:ricerca di HEADERS ,BASIC PROGRAMS e creazione AUTOMATICA di "file .tap" e
"list" per ogni frammento di programma BASIC trovato.


Dopo si puo'recuperare manualmente m/c,screens,char/num array,variables area,udg ...


#################################################################################

DAMTAPE MAIN FUNCTIONS (guida utente completa)
------------------------------------------------------------



*************************************************************************************
* UTILITY TO GET BACK THE BINARY CODE FROM DAMAGED ZX SPECTRUM'S REAL TAPES *
*  2002 DamTape                                                                                                                                            * 
* Versione windows beta 5 - 09.2004                                                                                                              *
*************************************************************************************


Dato uno "SPECTRUM file" memorizzato (con caricamento a velocita' normale) su
nastro magnetico danneggiato in uno o più punti, "UTILITY PER RECUPERO DATI DA
NASTRI DANNEGGIATI" recupera automaticamente gli spezzoni di programma BASIC
contenuti nelle parti "sane" del supporto comprese tra le interruzioni dovute al
danneggiamento, generando files di testo contenenti i listati e relativi files.TAP.
Mette inoltre a disposizione dell'utente il "materiale grezzo" corrispondente a
tutti gli altri dati "superstiti" relativi ad area variabili, screen, l/m e chr/num array.


FASE PRELIMINARE

0- Campionare la parte del nastro danneggiato su cui è memorizzato lo "SPECTRUM
file" (a 44.1 mhz, mono, 8 bit) in modo da ottenere un file WAV
che chiameremo convenzionalmente "master.wav", e metterlo nella stessa cartella
in cui si trova "damtape_b5win.exe". Quindi eseguire "damtape_b5win.exe".

1- Dal menu principale di DAMTAPE_b5win cliccare"STEP1" per partire dalla
fase (STEP) iniziale, corrispondente alla decodifica del file WAV (volendo, per
effettuare operazioni particolari, è possibile partire direttamente dallo STEP2
o dallo STEP 3).


STEP 1 (DECODIFICA DEL FILE WAV)

2- Inserire nome + estensione del file WAV da decodificare (es: master.wav).
(al risultato sarà assegnato il nome "DT RAW.TXT )


3-Selezionare la velocita' del nastro (1-17).Anche se DAMTAPE E'STRETTAMENTE INDICATO
PER NASTRI A VELOCITA' NORMALE("1") e' possibile tentare la decodifica di nastri
ad alta velocita'inserendo un valore maggiore di "1" fino ad un massimo di "17".
Naturalmente il rischio di errore in fase di decodifica del file wav e' direttamente
proporzionale alla velocita' del nastro.
Inoltre, a prescindere dalla velocita' di trasmissione dei dati,la post-elaborazione
automatica (step 3) non e'garantita per dati che seguano il protocollo di alcuni loaders
personalizzati.


Di default è preimpostata (ma si puo' deselezionare) la creazione del file "DTrawbits.htm"
che puo' contenere o soltanto tutti i bit trovati (1/0), o tutti i bit trovati ( 1/0 ) ma con
l'indicazione (con una "x") delle pause (più o meno giustificate/errori)
per essere esaminati dall'utente.

Cliccare "decode file .wav" e attendere ...


NOTA (Durante la decodifica):La presenza di eventuali interruzioni del flusso di dati dovuta
a una fine di blocco dati o ad un danneggiamento del nastro verrà registrata sul file
"report.txt" ) .

La decodificadel file .wav puo' durare più o meno a seconda della lunghezza del file e della
velocità del PC.


Poi clicca "next"


STEP 2 (ELABORAZIONE DEL RISULTATO DELLO STEP 1)
4a- Se si proviene dallo STEP1 cliccare "create service files" .(Il nome del file è già preimpostato)
Saranno creati 8 DamTape service files (DTservice #.txt)

Poi clicca "next"

4b- Se invece si è scelto di partire direttamente dallo STEP2 digitare il nome del file da elaborare
e poi clicca"create service files"

Saranno creati 8 DamTape service files (DTservice #.txt)

Poi clicca "next"

STEP3 (recupero dati)

5- inserire il nome (senza numero d'ordine e senza estensione) dei file di servizio prodotti
allo STEP2 (es:DTservice) da sottoporre alla ricerca'.

Selezionare le operazioni da compiere(TASKS):1-create LIST files
2-search for tape headers
3-search for BASIC (and tap creation)




Durante il "task 1" sono creati 8 LIST# .TXT files contenenti la conversione dei files
di servizio in set di caratteri spectrum con token ,formattazione di linea, ecc per un esame
visuale da parte dell'utente.

Questi 8 "LIST# .TXT" files sono molto importanti perchè contengono anche le parti di codice
che non potranno essere incluse nel file tap perchè incomplete o corrotte.


Durante il "task 2" viene verificata la presenza di eventuali "headers",in caso
affermativo vengono visualizzati sullo schermo e registrati sul file "report.txt" i parametri
contenuti in essi. (talvolta alcuni "headers" intercettati sono delle sequenze di byte che
casualmente rispondono positivamente al controllo di "coerenza" di DamTape".L'osservazione
da parte dell'utente dei parametri dell'header dara'indicazione della sua veridicita').


6- Durante il "task3" (search for BASIC) e' possibile che vengano creati alcuni file "tap #.tap"
"vuoti" o di contenuto incomprensibile.Per evitare cio'è possibile attivare un filtro
(massima lunghezza ammessa per la prima linea di programma).
Per default il filtro e' disattivato ma puo' essere attivato cliccando il relativo checkbox .

(USA IL FILTRO CON ATTENZIONE se abilitato parte di codice basic valido puo' essere non riconosciuto
MA DIVERSAMENTE ,se disabilitato,codice basic non valido puo' essere incluso nel file tap rendendolo
inutilizabile.
SUGGERIMENTO:prima prova senza filtro,poi prova con il filtro abilitato (imposta su vari valori).
[Intervallo consentito 0-65536,suggerito 2000].


I file tap (eventualmente ) creati contengono gli spezzoni di programma BASIC recuperati e
potranno essere caricati sull'emulatore con MERGE per essere uniti tra loro; i files
list#.txt di numero d'ordine corrispondente ai "tap #.tap" 'generati correttamente'
(cfr Nota 1) conterranno i rispettivi spezzoni di listato in formato testo
(comprensivi delle parti eventualmente non incluse nei files "tap #.tap": cfr Nota 2).
Le informazioni relative alla creazione dei files "tap#.tap" sono registrate sul
file "report.txt".


NOTA 1: Alcuni out#.tap possono essere "vuoti" o di contenuto incomprensibile:IGNORATELI.


NOTA 2: Per ciascuna parte di programma BASIC recuperata, gli spezzoni di
linee BASIC eventualmente presenti in testa e in coda (che chiameremo "RITAGLI")
non incluse nel file TAP in quanto incomplete, dovranno essere cercate nel
corrispondente file list#.txt (es: i "RITAGLI" di "tap3 1.tap" saranno in list3.txt) e
dovranno essere ricostruiti e digitati manualmente.

NOTA 3: Dal contenuto dei file "DTservice#.txt" di numero corrispondente agli
"tap#.tap" "generati correttamente" (cfr Nota 1) è possibile ricostruire i dati
"superstiti" relativi ad area variabili, screen$, l\m e character\number array.

NOTA 4: Nel caso qualcosa non funzioni è consigliabile ricampionare il nastro
con volume leggermente piu'alto o basso e iniziare di nuovo la procedura.

NB: MOLTO IMPORTANTE: NON DIMENTICARE DI CERCARE NEI FILES LIST#.TXT I "RITAGLI"
(OVVERO LE LINEE INCOMPLETE IN TESTA E IN CODA AGLI SPEZZONI DI PROGRAMMA BASIC
RECUPERATI) NON INCLUSI NEI FILES "TAP #.TAP"!


Ricordatevi di controllare il file "report.txt"




clicca "end" per tornare al main menù.




######################################################################################

DAMTAPE EXTRA FUNCTIONS
-------------------------------------





Dal MAIN MENU'

FUNZIONI EXTRA:
...............................................................................................
1- Clicca "ASSEMBLY" per visualizzare un file singolo o gli 8 "DTservice"[default] come
codice mnemonico assembly.

...............................................................................................

2- Clicca "SCREEN SEARCH" per convertire un file in una serie di files spectrum-screenshot[.SCR,6912 bytes].
seleziona il tipo di file (un file singolo o gli 8 "DT service"[default]),ed il nome.
seleziona la parte di file da cui estrarre i file .scr (START , END , SF(screen frequency-default=1000)

sarà estratto un file .scr a partire dal bytes "start" al bytes"end",ogni "SF" bytes.
sara'creata una cartella "FILESCR TIME" contenente i files ".scr" creati.
Adesso usa un visualizzatore di files .scr per controllare se vi siano contenute
immagini (Suggerisco di usare il programma "ZX RAINBOW"(www.worldofspectrum.org),
cerca la migliore e cancella le altre.



SUGGERIMENTO (per non perdere troppo tempo)
:supponiamo di avere gli otto files creati da"step2" di"DAMTAPE" (DTservice1.txt;
DTservice 2.txt;....DTservice 8.txt)

punto a:seleziona "singolo file"[opzione2] (per es."DTservice 1.txt")
seleziona SF (Screen Frequency)=1000 (sara'prelevato uno screen ogni 1000 bytes)
dalla posizione"0" alla "fine del file"(tutte le opzioni preimpostate) e
visualizza i files ottenuti con "ZX RAINBOW" (con gli attributi DISABILITATI).

punto b:se vedi qualche immagine in un file .scr (anche se probabilmente "shiftata"),
scegli quella centrata in modo migliore nel display e poi controlla il nome
di quel file .scr.Avra' un nome tipo ,per esempio "1 15.scr".
Allora (0[start]+(15[scr name]*1000[SF]))=15000 e' la posizione di
"1 15.scr" in "DTservice1.txt".

punto c:Ora calcella TUTTA la cartella "FILESCR time". Inizia nuovamente ma stavolta
selezionando gli otto file[opzione1],
inserisci il nome"DTservice",seleziona SF (Screen Frequency)= 1, da (15000-X) a (15000+X)
[scegli tu il parametro "X"(in genere "X"="SF" selezionata al punto a)] .
Otterrai così un certo numero di files,visualizzali (con gli attributi ABILITATI)
con "ZX RAINBOW". Se trovi quello giusto, copialo nella stessa directory
di "DamTape" e cancella la cartella "FILESCR time":
altrimenti torna al punto c scegliendo parametri differenti.

....................................................................................
3- Clicca BIN2TAP per convertire un file binario in uno spectrum .tap file(bytes)

seleziona il nome del file e clicca "SET
seleziona la parte di file da inserire nel file .tap (START ed END )
seleziona il parametro "indirizzo iniziale(default=16384) dell'header

sara' creato "bytes.tap"



................................................................................................
4- Clicca "scr2tap/bmp" per visualizzare un file .scr e convertirlo in un file.TAP e BMP

Clicca "open file .SCR" e seleziona il tuo file
Clicca SCR2TAP per convertirlo in un file.tap
Clicca "save as BMP" per salvare come BMP(24bit)





BACK