2.2.8.1 Les commutateurs de ligne de commande

Les commutateurs de la ligne de commande sont constitués d'un signe + ou -, suivi par un ou plusieurs caractères alphabétiques, et, quelquefois, une valeur numérique. Voici des commutateurs de ligne de commande typiques.

POVRAY +Isimple.pov +V +W80 +H60

povray est le nom du programme et il est suivi par plusieurs commutateurs. Chacun d'eux commence avec un signe plus ou moins. Le +I avec le nom de fichier dit à POV-Ray quelle scène il doit utiliser en entrée, et +V dit au programme d'afficher ses messages sur l'écran de texte, au cours de son travail. Le +W et le +H définissent la largeur et la hauteur de l'image en pixels. Cette image sera de 80 pixels de large sur 60 de haut.

Pour les commutateurs qui font basculer une caractéristique, le plus l'active, et le moins la désactive. Par exemple, +P active la pause en fin de rendu, alors que -P la désactive. D'autres commutateurs sont utilisés pour spécifier des valeurs, sans basculer la caractéristique. Plus ou moins peuvent être, tous deux, utilisés dans ce cas. Par exemple +W320 place la largeur à 320. Vous pouvez aussi utiliser -W320 et obtenir le même résultat.

Les commutateurs peuvent être utilisés en majuscules ou en minuscules. Ils sont lus de gauche à droite, mais en général, l'ordre importe peu. Si vous en spécifiez un plusieurs fois, la valeur précédente est écrasée par la nouvelle. La seule exception est le commutateur +L pour attribuer les chemins de répertoires. Jusqu'à dix chemins peuvent être spécifiés.

Presque tous les commutateurs + ou - ont une option équivalente dans le fichier INI, qui est décrit dans la section suivante. Une description détaillée de chaque commutateur est donnée dans la section de référence des options.

2.2.8.2 Utilisation des fichiers INI

Note : quoique le terme de 'fichier INI' soit utilisé par POV-Ray, cela a été intégré avant la définition de Microsoft Windows, et bien que les fichiers INI de POV-Ray soient identiques à ceux de Windows, il y a quelques différences mineures (la plus importante est qu'il est légal d'avoir plusieurs appels d'un même élément dans une section). Les fichiers INI sont utilisés sur toutes les versions de POV-Ray, pas seulement sur la plate-forme de Windows.

Parce qu'il est difficile de mettre de trop nombreuses options dans une ligne de commande, vous avez la possibilité de poser de multiples options dans un ou plusieurs fichiers texte. Ces fichiers d'initialisation ou fichiers INI ont .ini comme extension par défaut. Les versions précédentes de POV-Ray les appelaient des fichiers par défaut ou fichiers DEF. Vous pouvez toujours utiliser les fichiers DEF existants avec cette version.

La majorité des options que vous utilisez seront dans des fichiers INI. La ligne de commande est recommandée pour les options que vous modifiez souvent lorsque vous faites des tests de rendu. Le fichier povray.ini est automatiquement lu s'il existe. Vous pouvez spécifier des fichiers INI additionnels dans la ligne de commande, en tapant simplement leur nom. Par exemple :

POVRAY MYOPTS.INI

Si aucune extension n'est donnée, .ini est assumée. POV-Ray sait que ce n'est pas un commutateur car il n'est pas précédé d'un plus ou d'un moins.

Vous pouvez avoir de multiples fichiers INI dans la ligne de commande, au milieu de commutateurs. Par exemple :

POVRAY MYOPTS +V OTHER

Cela lit les options de myopts.ini, puis place le commutateur +V, et enfin lit les options de other.ini.

Un fichier INI est un fichier texte en ASCII avec des options de la forme...

Option_keyword=VALUE ; Le texte après le point-virule est un commentaire

Par exemple, l'équivalent du commutateur +Isimple.pov est...

Input_File_Name=simple.pov

Les options sont lues de haut en bas, mais l'ordre n'est pas important. Si vous spécifiez une option plusieurs fois, les valeurs précédentes sont écrasées par la dernière. La seule exception est l'option Library_Path=chemin. Jusqu'à 25 chemins de recherche peuvent être spécifiés.

Presque toutes les options de style INI ont un équivalent dans les commutateurs + ou -. La section de référence donne une description détaillée de toutes les options de POV-Ray. Elle inclut à la fois les paramètres pour le fichier INI et les commutateurs +/-.

Les mots clés INI ne sont pas sensibles à la casse. Seulement une option est permise par ligne de texte. Vous pouvez également inclure des commutateurs dans vos fichiers INI, si c'est plus simple pour vous. Vous pouvez avoir plusieurs commutateurs par ligne de texte, mais vous ne pouvez pas mélanger des options INI et des commutateurs sur une même ligne. Vous pouvez emboîter les fichiers INI en plaçant simplement le nom du fichier sur une ligne, sans signe égal derrière lui. Le maillage peut aller jusqu'à dix niveaux. Par exemple :

; Voici un exemple de fichier INI. Toute cette ligne est un commentaire.
; Les lignes blanches sont autorisées.
Input_File_Name=simple.pov ;Cela fixe le nom du fichier en entrée
+W80 +H60 ; Les commutateurs traditionnels +/- sont aussi autorisés
MOREOPT ; Lit MOREOPT.INI et poursuit avec la ligne suivante
+V ; Un autre commutateur
; C'est tout !

Les fichiers INI peuvent avoir des sections étiquetées, ainsi plus d'une série d'options peut être stockée dans le même fichier. Chaque section commence avec une étiquette entre les parenthèses []. Par exemple :

; RES.INI
; Cet exemple de fichier INI est utilisé pour fixer la résolution.
+W120 +H100 ; Cette section n'a pas d'étiquette.
; Sélectionnez-la avec "RES"
[Low]
+W80 +H60 ; Cette section a une étiquette.
; Sélectionnez-la avec "RES[Low]"
[Med]
+W320 +H200  ; Cette section a une étiquette.
; Sélectionnez-la avec "RES[Med]"
[High]
+W640 +H480 ; Les étiquettes ne sont pas sensibles à la casse.
; "RES[high]" fonctionne
[Really High]
+W800 +H600 ; Les étiquettes peuvent contenir des espaces

Quand vous spécifiez le fichier INI, vous devez le faire suivre de l'étiquette de la section entre parenthèses. Par exemple...

POVRAY RES[Med] +Imyfile.pov

POV-Ray lit res.ini et saute toutes les sections jusqu'à ce qu'il trouve l'étiquette Med. Il effectue les options après cette étiquette jusqu'à ce qu'il trouve une autre étiquette, et saute. Si aucune étiquette n'est donnée dans la ligne de commande, alors seulement la section sans étiquette, en haut du fichier, est lue. Si une étiquette est spécifiée, la zone non étiquetée est ignorée.

Si un fichier ou un chemin contient des espaces, toute la spécification doit être cernées d'apostrophes. Vous pouvez utiliser la simple ou la double, mais vous devez avoir la même au début et à la fin. Par exemple :

+I"my file.pov"
+I'my file.pov'
Input_File="my file.pov"
Input_File='my file.pov'

En utilisant les simples et doubles apostrophes, il est possible de spécifier des fichers dont le nom ou l'adresse contient l'autre type d'apostrophe. Par exemple :

+I"file's.pov"
+I'my "big" file.pov'
Input_File="file's.pov"
Input_File='my "big" file.pov'

2.2.8.3 Utilisation de la variable d'environnement POVINI

La variable d'environnement POVINI est utilisée pour spécifier l'emplacement et le nom du fichier INI qui est lu à chaque exécution de POV-Ray. Si POVINI n'est pas spécifié, ou que votre plate-forme n'utilise pas les variables d'environnement, un fichier INI par défaut est lu. Si le fichier spécifié n'existe pas, un message d'erreur est généré. Pour donner la variable d'environnement sous MS-DOS, vous devez ajouter la ligne suivante à votre fichier autoexec.bat...

set POVINI=c:\povray3\default.ini

Dans la plupart des systèmes d'exploitation, la séquence de lecture des options est la suivante :

1. Lit les options du fichier INI par défaut, spécifié dans la variable d'environnement POVINI ou spécifique à la plate-forme.
2. Lit les commutateurs de la ligne de commande (cela inclut la lecture des fichiers INI/DEF spécifiés).

La variable d'environnement POVRAYOPT des précédentes versions n'est plus disponible.