6.1.2 Usare
i file .INI
Essendo difficoltoso impostare diverse
opzioni nelle righe di comando è possibile inserire una o più
opzioni in un file di testo. Questi file hanno estensione .ini (file
di inizializzazione). Precedenti versioni di POV-Ray li chiamavano file
.DEF (default). E' ancora possibile utilizzare file .DEF esistenti con
questa versione di POV-Ray.
La maggioranza delle opzioni che si usano possono venire raccolte in un
file.ini. le righe di comando sono consigliabili per opzioni che
vengono attivate e disattivate spesso nel momento in cui viene renderizzata
una scena alla quale si sta lavorando. Il file povray.ini è
letto automaticamente se è presente. E' possibile specificare ulteriori
file .ini nelle righe di comando semplicemente digitando il nome
del file. Per esempio :
POVRAY MYOPTS.INI
Se non viene specificata alcuna estensione,
allora si assume che sia .ini. POV-Ray riconosce che MYOPTS.INI
non è un parametro perché non è preceduto da un più
o da un meno. Infatti un errore comune in coloro che utilizzano da poco
POV-Ray è quello di dimenticarsi di mettere il parametro +I
davanti al nome del file di input. Senza il parametro POV-Ray "crede"
che il file simple.pov sia un file .ini. Non dimenticate !
Se nessun più o meno precede un parametro della linea di comando,
quel parametro viene considerato come una specificazione di file .ini.
Nella riga di comando possono essere presenti più file .ini
e anche parametri. Per esempio :
POVRAY MYOPTS +V OTHER
Questa linea di comando legge le impostazioni
dal file myopts.ini, imposta il parametro +V
e legge le impostazioni dal file other.ini.
Un file .ini è un normale file di testo ASCII, con opzioni
specificate in una sintassi del tipo...
Parola_dell'opzione=VALORE ; Il testo dopo
il punto e virgola è un commento.
per esempio il file .ini equivalente
al parametro +Isimple.pov
è...
Input_File_Name=simple.pov
Le opzioni sono lette nel file dall'alto
verso il basso, ma possono essere specificate in qualsiasi ordine. Se si
specifica più di una volta la stessa opzione, il valore della precedente
è generalmente sovrascritto dall'ultima. L'unica eccezione è
l'opzione
Library_Path=percorso
Si possono specificare fino a dieci
percorsi (path).
Quasi tutte le opzioni dei file .ini hanno un equivalente nei parametri
della linea di comando. La sezione "Guida di Riferimento
alle Opzioni di POV-Ray " dà una dettagliata descrizione
di tutte le opzioni di POV-Ray, incluse sia quelle dei file .ini
che quelle dei parametri.
Le parole chiave dei file .ini non sono sensibili alle maiuscole.
E' consentito usare solo un'opzione per riga di testo. E' possibile includere
anche parametri della riga di comado nei file .ini, se ciò
risulta di aiuto. Si possono scrivere più parametri per riga, ma
senza mescolarli nella stessa riga con le opzioni dei file .ini.
Si possono "annidare" (inserire l'uno nell'altro) i file .ini
semplicemente mettendo il nome del file in una riga da solo e senza segno
di uguale in fondo. Si possono annidare file .ini fino a dieci livelli.
Per esempio :
; Questo è un file .ini di esempio,
tutta questa linea è di commento
;Sono permesse le linee vuote
Input_File_Name=semplice.pov
;Questa linea imposta il nome del file di input
+W80 +H60
; Sono permessi anche i comandi con + e -
MOREOPT
; Leggi il file MOREOPT.INI e continua con la prossima linea
+V
; Un altro parametro
; E questo è tutto !
I file .ini possono avere diverse
sezioni alle quali può venire assegnata un'etichetta che deve essere
posta tra parentesi quadre. Per esempio :
; RES.INI
; Questo file .ini di esempio è usato per impostare la risoluzione
+W120 +H100 ; Questa sezione non ha etichetta.
; Selezionala col comando "RES"
[Bassa]
+W80 +H60 ; Questa sezione ha un'etichetta.
; Selezionala col comando "RES[Bassa]"
[Media]
+W320 +H200 ; Questa sezione ha un'etichetta.
; Selezionala col comando "RES[Media]"
[Alta]
+W640 +H480 ; Le etichette non sono sensibili alle maiuscole.
; "RES[alta]" funziona ugualmente
[Molto Alta]
+W800 +H600 ; Le etichette possono contenere spazi.
Quando si specifica un file .ini
si deve aggiungere il nome dell'eventuale etichetta tra parentesi quadre.
Ad esempio :
POVRAY RES[Media] +Imyfile.pov
POV-Ray legge res.ini e ignora
tutte le opzioni finchè non trova l'etichetta Media ed esegue le
opzioni specificate da questa etichetta finché non ne trova un'altra,
dopo di che ignora il resto. Se nessuna etichetta è specificata
nella linea di comando, viene letta solo l'area senza etichetta in cima
al file. Se un'etichetta è specificata, allora l'area senza etichetta
viene ignorata.