[Main] [Docs] [Installs] [Search] [Team] [Guestbook] [Links]

Utilizzo

WHDLoad può essere avviato dalla riga di comando (CLI/Shell) o dal Workbench. Le opzioni possono essere inserite in un file di configurazione globale, specificate tramite argomenti nella riga di comando o mediante i Tooltype. L'opzione Slave è in genere richiesta. Potrebbero essere necessarie anche ulteriori opzioni, dipendentemente dall'hardware posseduto e dal programma da eseguire da WHDLoad. Nel caso di avvio dalla riga di comando, WHDLoad terminerà l'esecuzione con i seguenti return code:

Opzioni e configurazione globale

Esistono opzioni globali e locali. Le opzioni locali vengono specificate come argomenti dalla riga di comando o come ToolType nell'esecuzione da Workbench.
Se lanciato dal Workbench tramite un'icona, WHDLoad proverà a fare l'update delle opzioni PreloadSize, Config dell'icona stessa, e a;tre opzioni potenzialmente cambiate nella finestra di splash. Se questo modo di procedere è desiderate anche quando si lancia WHDLoad dalla linea di comando, un tool come WBRun (presente in OS3.5/3.0) deve essere utilizzato per simulare un lancio dal Workbench.
Il file di configurazione globale è "S:WHDLoad.prefs". E' un normale file ASCII e contiene un'opzione per riga. Le righe vuote ed i commenti vengono ignorati. Un commento deve stare su una singola riga e comincia con il carattere ";".
Un file di configurazione d'esempio è contenuto nel pacchetto WHDLoad "S/WHDLoad.prefs").

Elenco delle opzioni disponibili

ci sono tre tipi di opzioni:

numerica: il valore dell'opzione è un intero,
nella riga di comando devi utilizzare la notazione decimale, con i ToolType puoi anche usare la notazione esadecimale contrassegnata da un "$" all'inizio
stringa: il valore dell'opzione è una stringa
switcher: l'opzione verrà abilitata se specificata (booleano)

La colonna Locale indica se l'opzione può essere utilizzata nella line di comando e come ToolType nell'icona. La colonna Globale indica se l'opzione può essere utilizzata nel file di configurazione globale.

Molte opzioni non sono disponibili in WHDLoadCD32. La colonna CD³² indica se l'opzione è presente in questa versione speciale di WHDLoad.

tr>
Nome opzioneTipoLocaleGlobaleCD³²Valore di default
BranchCacheswitchx--
ButtonWaitswitchxxx
Cacheswitchx-x
Chkswitchx--
ChkAudPtswitchx--
ChkBltHogswitchx--
ChkBltSizeswitchx--
ChkBltWaitswitchx--
ChkColBstswitchx--
ChkCopConswitchx--
ChkIntsswitchx--
ChipNoCacheswitchxx-
Configstringx-x""
ConfigDelaynumericalxxx400
CoreDumpswitchx--
CoreDumpPathstring-x-PROGDIR:
Customstringx-x""
Custom1numericalx-x0
Custom2numericalx-x0
Custom3numericalx-x0
Custom4numericalx-x0
Custom5numericalx-x0
Dswitchx--
Datastringx-x-
DebugKeynumericalxx-$78 (CAA)
DCacheswitchx--
ExecuteCleanupstringxx--
ExecuteStartupstringxx--
Expertswitch-x-
ExpChipswitchx--
ExpLocalswitchx--
Exp24Bitswitchx--
FileLogswitchx--
FreezeKeynumericalxx-$78 (CAA)
FullChipswitchx--
LogBuffernumericalxx-4096
MMUswitchxx-
NoAutoVecswitchxxx
NoCacheswitchx-x
NoFileCacheswitchx-x
NoFilterswitchxxx
NoFlushMemswitchxx-
NoMemReverseswitch-x-
NoMMUswitchxx-
NoNetworkswitchxx-
NoResIntswitchx-x
NoReqswitchxxx
NoVBRMoveswitchx-x
NoWriteCacheswitchxx-
NTSCswitchxxx
PALswitchxxx
Preloadswitchxxx
PreloadSizenumericalx--
Proxystring-x--
QuitKeynumericalxxx$59 (F10)
ReadDelaynumerical-xx0
RestartKeynumericalxxx$78 (CAA)
SaveDirstringx---
SavePathstringxx--
ShowRegsstring-x-SYS:Utilities/MultiView
Slavestringx-xWHDLoad.Slave
Snoopswitchx--
SnoopAGAswitchx--
SnoopECSswitchx--
SnoopOCSswitchx--
SplashDelaynumericalxxx200
StoreBufferswitchx--
SuperScalarswitchx--
TimeOutnumericalx-x0
WriteDelaynumericalxx-150

Esempio di utlizzo

Workbench: Opzioni Workbench
CLI o Shell: 1> WHDLoad SuperGame.Slave Preload NTSC QuitKey=69 Custom1=1

Descrizione delle Opzioni

ButtonWait/S

Questa opzione non ha effetto diretto su WHDLoad, ma può essere testata dallo Slave.
Lo scopo di questa opzione è di far attendere al programma installato la pressione di un tasto quando questo mostra delle immagini e/o suona una musica, poiché di norma il tempo d'attesa è molto breve (dovuto alla differenza di velocità dei caricamenti dall'HD/RAM in confronto alla lentezza del floppy).

BranchCache/S

Questa opzione abilita le branch cache del 68060. Non ha effetto sulle altre CPU.
L'opzione non ha alcun effetto anche nel caso l'opzione NoCache/S è abilitata.

Cache/S

Questa opzione abilita la cache istruzioni e disabilita la cache dati per il programma installato. Sul 68030 anche il modo Burst verrà abilitato. Se la MMU viene usata da WHDLoad, la memoria Chip verrà contrassegnata come Cacheable Writethrough (imprecisa).
L'opzione non ha effetto se NoCache/S viene impostata.

Chk/S

Questa opzione è uno shortcut (scorciatoia) ed abilita le opzioni ChkBltSize/S, ChkBltWait/S e ChkColBst/S.

ChkAudPt/S

Questa opzione controlla che i puntatori scritti nei puntatori del chip audio Custom siano indirizzi validi di memoria chip. I puntatori non devono essere nulli e dentro BaseMem. Questa opzione funziona solo insieme ad una delle opzioni SnoopOCS/SnoopECS/SnoopAGA. Questa opzioni dovrebbe essere utile nel diagnosticare problemi con le routine audio di replay.

ChkBltHog/S

Questa opzione controlla tutto il tempo che il bit blthog (bltpri) nel registro custom.dmacon non sia impostato. Questa caratteristica funziona solo in congiunzione con una delle opzioni SnoopOCS/SnoopECS/SnoopAGA. Il blitter ha priorità sulla cpu per gli accessi alla memoria quando blthog è attivato, questo può creare dei problemi su alcune configurazioni hardware. In alcuni casi le prestazioni potrebbero essere migliori lasciando dei cicli di bus per il processore.

ChkBltSize/S

Questa opzione controlla che il programma installato utilizzi correttamente il blitter, così verranno utilizzate solo aree di memoria valide per le operazioni del blitter. Questa caratteristica funziona solo in congiunzione con una delle opzioni SnoopOCS/SnoopECS/SnoopAGA. Tutte le operazioni del blitter saranno controllate eccetto il line mode.

ChkBltWait/S

Questa opzione controlla che il programma installato attenda che il blitter finisca un lavoro prima di fargliene cominciare un'altro. Questa caratteristica funziona solo in congiunzione con una delle opzioni SnoopOCS/SnoopECS/SnoopAGA.

ChkColBst/S

Questa opzione controlla per tutto il tempo che il bit color nel registro custom.bplcon0 sia impostato. Questa caratteristica funziona solo in congiunzione con una delle opzioni SnoopOCS/SnoopECS/SnoopAGA. Su alcune configurazioni hardware, specialmente quelle con flickerfixer, questo bit deve essere settato affinchè un segnale video ottimale possa essere prodotto. Per questo motivo per ottenere una maggior compatibilità bisognerebbe lasciare questo bit sempre settato. Scritture dirette su custom.bplcon0 e tutte le Copper list sono controllate.

ChkCopCon/S

Questa opzione controlla che il programma installato non abiliti l'accesso da parte del Copper ai registri DMA, tramite l'impostazione di custom.copcon. Questa caratteristica funziona solo in congiunzione con una delle opzioni SnoopOCS/SnoopECS/SnoopAGA. Può essere utile per determinare se il programma utilizza il Copper per controllare le attività DMA.

ChkInts/S

Questa opzione controlla ad ogni interrupt se c'é una coppia corrispondente in intreq e intena per questo interrupt. In caso non ci fosse il programma installato sarà terminato con un appropriato requester di errore. Questa caratteristica permette di scoprire con facilità il riconoscimento di problemi di interrupt in sistemi veloci (68040/060) o hardware malfunzionante che causa interrupt non richiesti. A causa del fatto che la condizione può aumentare se gli interrupt vengono disabilitati tramite intena nello stesso momento che avviene un interrupt, questo è stato implementato come uno switch. A partire dalla versione 17.1 di WHDLoad questa opzione abilita anche tutti i controlli di base e della tastiera per i livelli di interrupt 4-6 che sono normalmente abilitati solo per i livelli 1-3.

ChipNoCache/S

Questa opzione disabilita la cacheabilità della Memoria-Chip (BaseMem). Dovrebbe essere utilizzata con hardware che non permette la cacheabilità della Memoria-Chip (come le schede BlizzardPPC) per evitare rallentamenti nella velocità di esecuzione del programma installato. Vedi anche CPU Cache Handling.

Config/K

Tramite questa opzione possono essere selezionati gli elementi della configurazione che appaiono nella finestra splash all'avvio di WHDLoad. Questa opzione sovrascrive ws_config specificato nello Slave. Per la sintassi necessaria fai riferimento a ws_config negli autodocs. Se ws_config non è presente nè nello Slave nè nel Config/K set e lo Slave controlla gli elementi Custom1-5/K/N/ButtonWait/S tramite la funzione resload_Control, WHDLoad aggiungerà una opzione Config/K all'icona se lanciato dal Workbench. Il tipo degli elementi verrà derivato dal valore corrente delle opzioni Custom1-5/K/N (0-1 booleano, 2-63 lista, >63 binario).

ConfigDelay/K/N

Questa opzione specifica la durata dell'intervallo, espressa in cinquantesimi di secondo, durante il quale WHDLoad mostrerà la finestra delle informazioni all'avvio se ci dovessero essere dei pulsanti (vedi Config/K e Expert/S) sulla stessa. Se ConfigDelay/K/N è più basso di ReadDelay/K/N o SplashDelay/K/N viene ignorato. La finestra è visualizzata almeno per la durata dell'elaborazione del Preload/S. Se un pulsante di configurazione viene premuto il timer per ConfigDelay viene riazzerato.
Se l'opzione viene settata a -1 un pulsante Start viene aggiunto e alla finestra e resta visualizzato fino a quando non viene premuto. La finestra splash può essere chiusa anche premendo la barra Spazio, Invio o Return. Se viene premuto il tasto ESC WHDLoad ferma immediatamente il Preload/S e termina immediatamente.

CoreDump/S

Se selezionata, ogni volta che si uscirà da un programma installato, WHDLoad creerà un dump della memoria e dei registri. Questo può essere utile per rippare un modulo musicale dal dump della memoria o per il debugging.

CoreDumpPath

La directory di destinazione per tutti i file di dump creati da WHDLoad.

Custom/K, Custom1/K/N, Custom2/K/N, Custom3/K/N, Custom4/K/N, Custom5/K/N

Queste opzioni non vengono utilizzate direttamente da WHDLoad, ma possono essere testate dallo Slave per controllare varie cose specifiche dello stesso. Custom/K può contenere una stringa e Custom1-5/K possono solo contenere un numero intero. Controlla la documentazione dell'installatore per sapere se supporta le opzioni Custom.

D/S

Questa opzione risulta utile per il debugging. Se è abilitata e viene trovato un freezer software supportato in memoria (HRT-TK), WHDLoad simulerà un NMI prima di eseguire la prima istruzione CPU contenuta nello Slave.

Data/K

Tramite questa opzione si può specificare una directory in cui WHDLoad entrerà prima di cominciare a caricare dati per il programma installato. Directory multiple possono essere specificate separandole con una virgola (quindi il nome delle directory specificate non può contenere virgole!). Se vengono utilizzate directory multiple, nel caricare i files vengono provate tutte nell'ordine specificato. Questa opzione sovrascrive il valore ws_CurrentDir contenuto nello Slave.

DCache/S

Questa opzione abilita le cache dati e istruzioni per il programma installato. Sul 68030Se la modalità Burst verrà attivata. Se la MMU viene utilizzata da WHDLoad allora la memoria Chip verrà segnata come Cacheable Writethrough (imprecisa).
L'opzione non ha effetto se viene impostata anche NoCache/S.

DebugKey/K/N

Imposta il codice di rawkey per uscire dal programma e scrivere i file coredump. Questo funziona solo se expert mode è attiva, se il VBR è stato spostato da WHDLoad (NoVBRMove/S non è impostata e la CPU è almeno un 68010) o se lo Slave lo supporta.

ExecuteCleanup

Con questa opzione si può specficare un comando che WHDLoad eseguirà all'uscita. Utlizzando il comando di sistema Execute potrà essere eseguito anche uno script.

ExecuteStartup

Con questa opzione si può specficare un comando che WHDLoad eseguirà all'avvio. Può essere utile per disabilitare hardware che crea problemi con WHDLoad, come uno stack TCP/IP o USB. In Bugs ci sono informazioni aggiuntive. Utlizzando il comando di sistema Execute potrà essere eseguito anche uno script.

Expert/S

Questa opzione abilita l'expert mode (modalità esperto) di WHDLoad. Ha effetto sulla DebugKey/S e sui warning durante lo switching tra il programma installato e l'OS (color cycle copper screens). Se l'expert mode non è attivo la DebugKey/S non è disponibile. In questa modalità apparirà anche un nuovo pulsante in alcuni requester d'errore di WHDLoad. Questo pulsante chiamato Show Regs permette di vedere i registri ed informazioni di stato simile a quanto mostrato dal register dump. Altri pulsanti sono aggiunti alla finestra splash per cambiare la selezione delle opzioni di debug. Le opzioni cambiate sono salvate nell'icona se lanciato dal workbench.

ExpChip/S, ExpLocal/S, Exp24Bit/S

Se il programma installato utilizza la memoria espansa (ws_ExpMem), queste opzioni possono essre utilizzate per forzare WHDLoad ad allocare questa memoria rispettivamente nella memoria Chip, nella memoria Local o in nella 24BitDMA. Questo può risultare in un degrado delle prestazioni perché la memoria specificata potrebbe essere accessa in modo più lento dalla CPU rispetto alla memoria Fast di default. Puoi utilizzare tool di terze parti (come SysInfo, GvpInfo,...) per controllare la configurazione della tua memoria e vedere quale proprietà possiede una certa memoria.
In generale queste opzioni sono intese per risolvere problemi di compatibilità per quanto riguarda i programmi installati su sistemi veloci rendendoli più lenti nell'esecuzione mediante l'utilizzo di memoria più lenta.

FileLog/S

Questa opzione è intesa solo per il debugging. Vedi Dumps and Logfiles per maggiori informazioni.

FreezeKey/K/N

Se utilizzi uno dei software freezer supportati (HRTMon o Thrillkill) puoi servirti di questa opzione per impostare un codice rawkey mediante il quale WHDLoad entrerà nel freezer. Perché funzioni, il VBR deve essere spostato da WHDLoad (NoVBRMove/S non deve essere impostato e la CPU deve essere almeno un 68010) ed il freezer deve essere attivo. Leggi il capitolo System Monitors / Freezer per ulteriori informazioni.

FullChip/S

Quando questa opzione è selezionata WHDLoad salva e carica completamente la memoria chip (execbase.MaxLocMem), invece dell'area specificata da ws_BaseMemSize nello Slave. Se WHDLoad utilizza una MMU per proteggere la memoria, questa viene protetta solo dagli accessi illegali provenienti dalla CPU. Accessi diretti alla memoria dai coprocessori come Blitter/DMA del disco non vengono protetti. Queste azioni DMA possono corrompere la memoria senza che WHDLoad possa accorgersene. Se questa opzione viene selezionata gli accessi DMA non possono corrompere la memoria chip in quanto la stessa viene caricata e salvata completamente.
Prima che il programma venga lanciato la memoria chip addizionale (quella tra BaseMemSize e MaxLocMem) viene riempita con un pattern speciale. Alla fine del programma WHDLoad controlla la memoria addizionale per vedere se ci sono state modifiche. Se un cambiamento viene rilevato WHDLoad mostra un apposito requester di errore. Solo in questo caso la memoria addizionale viene scritta nel memory dump file (quindi non nel complete dump file), per consentire ulteriori analisi del problema.
Questa opzione può essere utile nello sviluppo/debugging per evitare corruzione della memoria host in AmigaOS e per aiutare installatori che non funzionano completamente a causa di bug ancora irrisolti.
FullChip/S non può essere attivato insieme all'opzione ExpChip/S. Se entrambi sono attivati FullChip/S verrà ignorato.

LogBuffer/K/N

Utilizzando questa opzione può essere specificato il buffer interno di WHDLoad utilizzato per trasportare messaggi da FileLog/S alla funzione resload_Log. La grandezza di default per il buffer è di 4096 bytes. Questo buffer è allocato solamente se l'opzione FileLog/S è stata specificata. Se il buffer è pieno, WHDLoad interromperà il programma e richiederà al sistema operativo di scrivere il buffer nel log file. Per evitare queste occorrenze la dimensione del buffer deve essere scelta in maniera opportuna.

MMU/S

Questa deve venire utilizzata su sistemi con 68030 per far funzionare le funzioni relazionate alla MMU (memory protection, migliore gestione delle cache , Snooping, funzioni resload_Protect#?). Su 68040/060 questa opzione non ha effetto perché la MMU viene usata di default. Si raccomanda di impostare questa opzione nel file di configurazione globale in tutti i sistemi con 68030 ed un MMU operativa (ad esempio non in un 68EC030) poiché incrementa la stabilità e la sicurezza di molto. Se viene impostata anche NoMMU/S questa opzione non avrà effetto.

NoAutoVec/S

Se selezionata WHDLoad non uscirà in caso di un inaspettato interrupt autovector o di un NMI (vettori #25-31 / $64-$7c). Questa opzione dovrebbe venire utilizzata su sistemi/hardware che generano questi interrupt a caso per impedire a WHDLoad di uscire. Da notare che questa opzione non può sistemare l'hardware malfunzionante che crea questi interrupt. Alcuni programmi installati possono non funzionare correttamente su quel tipo di hardware anche con questa opzione attivata. Quindi sarebbe meglio rimuovere (o sistemare, se possibile) l'hardware che crea gli interrupt.

NoCache/S

Se selezionato tutte le cache verranno disabilitate.
Questa opzione sovrascive BranchCache/S, Cache/S, DCache/S, StoreBuffer/S e SuperScalar/S.

NoFileCache/S

Disabilita le cache per i file di WHDLoad e forza ad uno switch al SO per ogni operazione disco del programma installato.
Questa opzione disabilita Preload/S.

NoFilter/S

Disabilita il filtro audio. Nota che questa opzione ha effetto solo durante l'inizializzazione all'avvio, se il programma installato cambierà lo stato del filtro audio questa opzione non avrà affetto.

NoFlushMem/S

Normalmente WHDLoad esegue un flush della memoria all'avvio per ottenerne quanta più possibile per l'operazione di Preload/S. Questo rimuoverà tutte le risorse non utilizzate come librerie, font ecc. dalla memoria. Mediante l'utilizzo di questa opzione WHDLoad non eseguirà il flush. Può essere usata su sistemi con molta memoria per incrementare le prestazioni del sistema.

NoMemReverse/S

Se questa opzione è attivata WHDLoad non allocherà memoria utilizzando il flag MEM_REVERSE. In alcune configurazioni questa opzione può causare problemi (quelle che utilizzano memoria dello slot PCMCIA nell'A600/A1200 come fast ram ed in quelle con una scheda M-Tec 1230/8 MB OS3.0). La causa di questi problemi non è ancora stata identificata. Questa opzione può essere di aiuto se della RAM agli indirizzi più alti non funziona correttamente, visto che quando è in uso WHDLoad utilizzerà prima la memoria agli indirizzi più bassi. Se si incontrano degli errori strani vale la pena fare un tentativo con questa opzione.
Questa opzione è sempre attiva su Kickstart 2.0 (V37) a causa di un bug in questa versione che può causare un blocco durante exec.AllocMem.

NoMMU/S

Se questa opzione è impostata WHDLoad non utilizzerà la MMU. Questa è un'opzione critica e pericolosa raccomandata solo per il testing e il debugging e non per il normale utilizzo. Vedi il capitolo MMU per maggiori informazioni. L'opzione ha priorità su MMU/S.

NoNetwork/S

Se questa opzione è impostata WHDLoad non si connetterà a Internet per fare un controllo dell'aggiornamento dello Slave utilizzato e di WHDLoad stesso.

NoReq/S

Questa opzione può essere usata solo quando WHDLoad è stato avviato dalla riga di comando (CLI/Shell). Se è stato avviato da Workbench questa opzione non ha effetto. Serve per forzare WHDLoad a non aprire un qualunque requester in una nuova finestra ma a visualizzarne il messaggio nella finestra della riga di comando dalla quale è stato avviato.

NoResInt/S

Questa opzione disabilita gli interrupt durante l'esecuzione delle funzioni resload, normalmente sono abilitati. Gli interrupt possono generare suoni, fare update dello schermo o eseguire altre funzioni importanti. Disabilitandoli si possono causare problemi nel suono e nello schermo o malfunzionamenti in generale. Malfunzionamenti degli interrupt possono causare la sovrascrittura di aree di dati interne di WHDLoad che di solito finiscono per causare il crash di tutto il sistema operativo. Questa opzione può essere utilizzata per controllare questo tipo di problema. Se un installatore si comporta in maniera anomala o crasha WHDLoad senza questa opzione, ma lavora correttamente se è abilitata, la causa è molto probabilmente un problema di interrupt. In questi casi l'installatore deve essere modificato.
A partire dalla versione 17.0 di WHDLoad il blitter viene testato per vedere se è attivo quando una funzione resload viene eseguita. Nel caso il problema verrà comunicato e WHDLoad terminerà.

NoVBRMove/S

Di default WHDLoad muove la vector table mediante il VBR (Vector Base Register) in una locazione di memoria differente. Questo ha il vantaggio che il programma installato non può cambiare la vector table, cosa che incrementerà la sicurezza e la stabilità di WHDLoad in modo rilevante. Alcuni programmi installati/slave non funzioneranno correttamente con un VBR spostato. La ragione di questo è che il programma installato utilizza le exceptions del processore o altre cose strane. In questo caso, questa opzione deve essere impostata per prevenire che WHDLoad sposti il VBR.
Un'altra caratteristica del spostamento del VBR è che WHDLoad può controllare la tastiera ogni volta che si presenterà un interrupt dell'Autovector. Con questo controllo WHDLoad è in grado di terminare il programma installato indipendentemente dal lavoro del programma installato/slave se vengono premuti QuitKey/S o DebugKey/S (similarmente il programma installato può essere interrotto quando viene premuto FreezeKey/S).
La capacità di spostare il VBR richiede almeno un 68010 per funzionare. Con un 68000 questa opzione non ha effetto, perché il VBR è sempre a $0 e non può essere spostato. Sul 68000 WHDLoad supporta hardware particolari (ACA500, Zeus) che permettono di avere gli Autovector interrupt vectors in una locazione di memoria differente in modo da supportare la funzione QuitKey/S. Queste funzioni hardware non sono utilizzate se questa opzione è stata attivata.

NoWriteCache/S

Questa opzione disabilita le cache di scrittura disco di WHDLoad. Senza questa opzione WHDLoad tenterà di utilizzare la cache per tutte le operazioni di scrittura e di mantenerle in memoria fino all'uscita dal programma per evitare switch non necessari al sistema operativo.

NTSC/S

Se selezionata, WHDLoad userà un display NTSC (60Hz) per il programma installato. In un Amiga PAL, il monitor driver NTSC deve essere installato in "DEVS:Monitors/".

PAL/S

Se selezionata, WHDLoad userà un display PAL (50Hz) per il programma installato. In un Amiga NTSC, il monitor driver PAL deve essere installato in "DEVS:Monitors/".

Preload/S

Se questa opzione è abilitata, WHDLoad caricherà tutti i file e le immagini disco che sarà possibile nella memoria all'avvio. Se durante il preload la memoria non è più sufficiente il preload terminerà e non tutti i file verranno caricati. Questo incrementerà le prestazioni del programma installato mentre sarà in esecuzione, poiché si eviterà lo switch al sistema operativo per caricare i dati dall'harddisk. Questa opzione dovrebbe essere sempre abilitata.

PreloadSize/N

Questa opzione specifica quanti dati devono effettuare il preloaded. Il valore è utilizzato solo per calcolare la progress bar del Preload. Se il programma installato viene lanciato dal Workbench WHDLoad stesso creerà/aggiornerà l'opzione come ToolType dopo essere ritornato al SO. Da notare che il PreloadSize non è solamente la somma della grandezza di tutti i file.

Proxy/K

Utilizzando questa opzione può essere specificato un proxy HTTP, questo verrà utlizzato da WHDLoad per collegarsi a Internet. Il proxy è necessario solo se una connessione diretta a Internet non è possibile. La sintassi per specificare il proxy è [user:password@]hostname[:porta]. L'hostname è obbligatorio, la porta è opzionale e se non specificata viene scelta la 80. User e password sono opzionali e devono essere specificati solo se il proxy li richiede. WHDLoad supporta solamente l'autenticazione semplice.

QuitKey/K/N

Imposta il codice rawkey per uscire dal programma, funziona solo se il VBR viene spostato da WHDLoad (NoVBRMove/S non deve essere impostata e la CPU deve essere almeno un 68010) o se lo Slave lo supporta.

ReadDelay/K/N

Questa opzione specifica il tempo in 1/50 di secondo che WHDLoad dovrà attendere dopo aver caricato i dati dai dischi, o il tempo di attesa dopo il Preload/S. Questo risolve problemi con drive (ad esempio lettori CD) che necessitano di operazioni supplementari dopo la lettura (come spegnere il motore).

RestartKey/K/N

Tramite questa opzione puoi impostare un codice rawkey alla quale pressione WHDLoad riavvierà il programma installato.

SaveDir/K

Questa opzione, insieme a SavePath/K, specifica la sottodirectory per operazioni di scrittura del programma installato. Potrebbe essere necessario specificarla esplicitamente, invece di lasciarne la determinazione a WHDLoad, se si hanno diverse copie dello stesso gioco che utilizzano lo stesso slave ma hanno save files incompatibili. Potrebbe essere utile anche nel caso lo slave non contenga il nome del gioco ed il nome del file dello slave non ti piaccia come nome per la directory dei salvataggi.

SavePath/K

Questa opzione forza WHDLoad a redirigere tutte le operazioni di scrittura al disco del programma installato verso una locazione differente. Questa opzione specifica la directory di base per tutti i programmi installati. Ogni programma avrà poi la sua sottodirectory nella directory di base. La sottodirectory verrà creata se inesistente (al primo accesso in scrittura). Il nome della sottodirectory può essere specificato utilizzando l'opzione SaveDir/K, nel caso non sia specificato sarà derivato da WHDLoad utilizzando le Info dello slave (ws_name) o il nome del file dello slave stesso. Internamente questa directory è trattata come una directory aggiuntiva di Data.

ShowRegs/K/N

Questa opzione è utile solamente in congiunzione con Expert/S. Con questa opzione si può specificare il programma che WHDLoad utilizzerà per visualizzare il dump dei registri se il pulsante Show Regs in un requester d'errore di WHDLoad viene premuto. WHDLoad aggiungerà il nome del file temporaneo salvato (attualmente T:.whdl_register) nella stringa di comando specificata.

Slave

Il nome dello slave che dovrà essere utilizzato da WHDLoad. Lo slave contiene il codice di interfaccia che è richiesto per la comunicazione tra il programma installato e WHDLoad.

Snoop/S, SnoopAGA/S, SnoopECS/S, SnoopOCS/S

Queste opzioni abilitano lo Snoop dei registri Cia/Custom di WHDLoad.

SplashDelay/K/N

Questa opzione specifica il tempo in 1/50 di secondo durante il quale WHDLoad mostrerà la finestra di informazioni all'avvio. Se lo SplashDelay/K/N è inferiore a ReadDelay/K/N viene ignorato e la finestra viene visualizzata per il tempo specificato in ReadDelay/K/N. La finestra viene visualizzata almeno tanto quanto necessario per il Preload/S.
Se l'opzione viene impostata a 0 la finestra non verrà visualizzata. Se l'opzione è impostata a -1 un pulsante Start verrà aggiunto alla finestra e rimarrà aperto fino a quando il pulsante non verrà premuto. La finestra splash può essere chiusa anche premendo la barra Spazio, Invio o Enter. Se il tasto Esc viene premuto WHDLoad ferma il Preload/S ed esce immediatamente. Vedi anche ConfigDelay/K/N.

StoreBuffer/S

Questa opzione abilita lo Store Buffer del 68060. Con altre CPU non ha effetto.
L'opzione non ha effetto se viene impostata anche NoCache/S.

SuperScalar/S

Questa opzione abilita la capacità del 68060 di eseguire più istruzioni per ciclo macchina. Non ha effetto con altre CPU.
L'opzione non ha effetto se viene impostata anche NoCache/S.

TimeOut/K/N

Se impostata l'esecuzione di WHDLoad e del programma installato verrà terminata dopo il periodo di tempo specificato. Richiede che l'opzione NoVBRMove/S non sia impostata e che il programma installato non modifichi il timer ciaa.ciatod. Il tempo è specificato in 1/50 di secondo. Per stabilirne la durata per un demo o un gioco abilita l'opzione Expert/S e imposta una DebugKey/K/N, quando il punto in cui vuoi venga terminato il programma è stato raggiunto premi il debug key. Adesso controlla nel file creato .whdl_register e ricerca il valore ciaa-event. Se la frequenza della tua rete elettrica è di 50Hz allora questo è il valore da impostare con TimeOut/K/N, se invece la frequenza è di 60Hz allora devi moltiplicare il valore per 5/6.

WriteDelay/K/N

Questa opzione specifica il tempo in 1/50 di secondo che WHDLoad dovrà attendere dopo aver scritto fisicamente sul disco. Ha effetto su tutte le funzioni resload_Save#? e la funzione FileLog/S. Questo ha un senso poiché il filesystem di solito non scrive immediatamente i dati nel disco. C'è bisogno di un pò di tempo (1..3 secondi) perché tutte le strutture del filesystem vengano aggiornate con successo. Il valore di default per WriteDelay è 150 che fa attendere WHDLoad per 3 secondi dopo ogni scrittura nell'harddisk. Puoi impostare questo valore a 0, ma in questo caso non dovrai mai uscire dal programma installato con un reset poiché i dati salvati potrebbero non essere stati scritti correttamente nel disco.
[Main] [Docs] [Installs] [Search] [Team] [Guestbook] [Links]