vers l'index général de l'aide
vers la page générale des options
"n" représente une valeur entière, "n.n" représente une valeur décimale, "b" représente une valeur booléenne (on/off), "c", représente une chaîne.
commande | ini | défaut | description |
+Ic | Input_File_Name=c | ... | spécifie le nom du fichier de script à interpréter |
+Lc | Library_Path=c | ... | spécifie un chemin d'accès pour les fichiers |
+MVn.n | Version=n.n | version courante | spécifie quelle version de la syntaxe de POV-Ray est utilisée par défaut |
L'option Library_Path, suivie d'un chemin de répertoires (sans slash ou bakslash à la fin) au format normal de votre système d'exploitation, indique à POV-Ray dans quels répertoires il peut aller chercher les fichiers invoqués dans les scripts (#include, images,...). POV-Ray va d'abord chercher le fichier dans le même répertoire que le fichier de script, puis ensuite parcourir les répertoires spécifiés par Library_Path, dans l'ordre où ils sont spécifiés, puisque on peut en utiliser 20.
+Ld:\povimages\maps
L'option Version permet de forcer l'interpréteur à adopter par défaut une syntaxe qui correspond à une version antérieure de POV-Ray. Consultez la documentation de votre version pour savoir quelles fonctionnalités ont conservé la capacité de recevoir l'ancienne syntaxe. Remarque : la conservation ultérieure de ces syntaxes n'est jamais garantie, et il est préférable de se familiariser avec la syntaxe la plus récente.
commande | ini | défaut | description |
(indisp.) | Pre_Scene_Command=c | ... | commande à exécuter avant le rendu de la scène |
(indisp.) | Pre_Frame_Command=c | ... | commande à exécuter avant le rendu de chaque frame |
(indisp.) | Post_Scene_Command=c | ... | commande à exécuter après le rendu de la scène |
(indisp.) | Post_Frame_Command=c | ... | commande à exécuter après le rendu de chaque frame |
(indisp.) | User_Abort_Command=c | ... | commande à exécuter lorsque l'utilisateur interrompt le rendu |
(indisp.) | Fatal_Error_Command=c | ... | commande à exécuter lorsque POV-Ray s'interrompt avec une erreur |
Ces options permettent, à divers moments du processus de rendu, de commander l'exécution d'un autre programme. Elles ne sont disponible que dans les fichiers .ini.
Si le programme exécuté accepte des options de ligne de commande, il est possible lui de passer
certains paramètres particuliers :
%o : le nom du fichier de sortie, avec son extension et éventuellement le numero de frame
%s : le nom du script, avec son extension
%n : le numero de la frame courante
%k : la valeur de clock courante
%h : la hauteur de l'image, en pixels
%w : la largeur de l'image, en pixels
%% : le caractère "%"
Post_Scene_Command=tga2gif -d -m %s
La plupart des programmes ainsi invoqués ont la propriétés de renvoyer au système d'exploitation un code (un chiffre) particulier à la fin de leur exécution, signalant comment s'est déroulé le programme. En général, 0 signifie que tout s'est bien passé, et une autre valeur que 0 signifie qu'une erreur s'est produite.
Il est possible de spécifier, pour chaque "moment" d'exécution de commande, ce que POV-Ray doit faire, selon que le résulat est égal à 0 ou non.
commande | ini | défaut | description |
(indisp.) | Pre_Scene_Return=c | I | réaction au retour de la commande avant le rendu de la scène |
(indisp.) | Pre_Frame_Return=c | I | réaction au retour de la commande avant le rendu de chaque frame |
(indisp.) | Post_Scene_Return=c | I | réaction au retour de la commande après le rendu de la scène |
(indisp.) | Post_Frame_Return=c | I | réaction au retour de la commande après le rendu de chaque frame |
(indisp.) | User_Abort_Return=c | I | réaction au retour de la commande à exécuter lorsque l'utilisateur interrompt le rendu |
(indisp.) | Fatal_Error_Return=c | I | réaction au retour de la commande à exécuter lorsque POV-Ray s'interrompt avec une erreur |
La réaction a lieu si la valeur de retour est différente de 0.
Les valeurs de l'option peuvent être :
I : ignorer la valeur de retour
S : passer une étape du processus
A : passer toutes les étapes du processus
Q : quitter immédiatement POV-Ray
U : génère une interruption par l'utilisateur
F : génère une interruption avec une erreur
Post_Scene_Return=F
On peut inverser la condition (déclenchement si le retour est égal à 0) en plaçant un "-" devant la lettre.
commande | ini | défaut | description |
+GD, -GD | Debug_Console=b | + | active/désactive les messages de "debug" |
+GF, -GF | Fatal_Console=b | + | active/désactive les messages d'erreurs |
+GR, -GR | Render_Console=b | + | active/désactive les messages de "render" |
+GS, -GS | Statistic_Console=b | + | active/désactive les messages de statistiques |
+GW, -GW | Warning_Console=b | + | active/désactive les messages de "warning" |
+GA, -GA | All_Console=b | + | active/désactive les messages de toutes les consoles |
Faire suivre une activation de messages par un nom de fichier provoque l'écriture des messages dans ce fichier (pour garder une trace) : +GDdebug.txt. Dans un fichier .ini, il faut spécifier Debug_File=debug.txt, Fatal_File=fatal.txt, etc...
Pour plus de détails sur le fonctionnement des messages de la console, voyez la section qui leur est consacrée dans les "directives".
commande | ini | défaut | description |
+?, +?n | (indisponible) | - | affiche un écran d'aide rapide, page n |
Cette option est fait pour les versions de POV-Ray fonctionnant dans un environnement non-graphique, et, utilisé seul juste après le nom du programme (POV-Ray), provoque l'affichage d'un ou plusieurs écrans d'aide succinte.
commande | ini | défaut | description |
+Qn | Quality=n | 9 | sélectionne le niveau de qualité à employer dans le rendu |
+QR, -QR | Radiosity=b | - | enclenche le calcul de la radiosité |
Voici les valeurs possibles de n :
0, 1 : Utilise seulement les "quick colors", et l'éclairage ambiant.
2, 3 : Utilise les valeurs locales de diffuse et ambient des objets.
4 : Calcule les ombres, mais pas les lumières étendues.
5 : Calcule les ombres, y compris les lumières étendues.
6, 7 : Utilise les motifs des textures
8 : Calcule la réflection, la réfraction et la transparence.
9 : Calcule les media c'est le niveau de qualité par défaut.
10 : Calcule la radiosité mais pas les media (n'oubliez pas +QR pour enclencher la radiosité).
11 : Calcule la radiosité ET les media (n'oubliez pas +QR pour enclencher la radiosité).
Voyez la section "les boîtes d'optimisation" pour avoir tout le détail sur cette fonctionnalité.
commande | ini | défaut | description |
+MB, -MB | Bounding=b | + | enclenche l'optimisation automatique |
+MBn, -MBn | Bounding_Threshold=n | 25 | spécifie à partir de combien d'objets il faut enclencher l'optimisation |
+UL, -UL | Light_Buffer=b | + | enclenche l'optimisation des lumières |
+UV, -UV | Vista_Buffer=b | + | enclenche l'utilisation du "vista buffer" |
+UR, -UR | Remove_Bounds=b | + | enlève les optimisations manuelles des objets quand elles semblent inutiles |
+SU, -SU | Split_Unions=b | - | enlève les optimisations manuelles des unions quand elles semblent inutiles |
Voyez la section "l'anticrénelage" pour avoir tout le détail sur cette fonctionnalité.
commande | ini | défaut | description |
+A, -A | Antialias=b | - | enclenche l'anticrénelage (avec un seuil de 0.3) |
+An.n, -An.n | Antialias_Threshold=n.n | 0.3 | spécifie le seuil de déclenchement de l'anticrénelage |
+AMn | Sampling_Method=n | 1 | sélectionne la méthode à employer (1 ou 2) |
+Rn | Antialias_Depth=n | 2 | spécifie la finesse de la subdivision |
+J, -J | Jitter=b | + | enclenche l'errance d'échantillonnage |
+Jn.n, -Jn.n | Jitter_Amount=n.n | 1 | spécifie le taux d'errance d'échantillonnage |
rédacteur : Fabien Mosen