Le menu 'Tools' vous fournit un mode simple pour personnaliser POV-Ray pour Windows. Vous pouvez développer vos propres commandes (jusqu'à 32) à apparaître dans ce menu. Puisque le menu est déterminé par le fichier PVTOOLS.INI, modifier et recharger ce fichier INI change le menu 'Tools'.
La syntaxe des entrées dans PVTOOLS.INI est la suivante :
[Menu]
Itemn=Description
[Command]
Itemn=command_string
[Help]
Itemn=help_line
Où n est un nombre entre 0 et 31, et les entrées dans la section [Help] sont optionnelles.
Item0 ... Item31
sont les numéros d'éléments qui définissent l'ordre d'apparition dans le menu 'Tools'.
[Menu]
Les entrées dans la section [Menu] sont telles qu'elles apparaissent dans le menu 'Tools'. Le caractère '&' dit à Windows où placer le soulignement. La lettre soulignée devient l'abréviation pour la commande. Par exemple la lettre 'C' dans '&Click Me' deviendra 'Click Me' lors de l'affichage dans le menu 'Tools', et vous pourrez accéder à la commande en pressant Alt+T puis 'C'. (Alt+T active le menu 'Tools').
Vous devez vous assurer que toutes les entrées du menu 'Tools' ont des abréviations différentes si vous voulez y accéder par ce biais. Bien sûr, vous n'avez pas à fournir d'abréviation si vous ne le voulez pas.
[Command]
Ceci est la commande que POV-Ray exécutera pour cette entrée. Cela peut être un EXE Windows ou un PIF, un EXE DOS ou un COM, ou même un fichier de traitement par lot du DOS. La commande est constituée du nom de la commande suivi des paramètres que vous voulez fournir au programme.
Il y a une commande spéciale, appelée '$S'. $S signifie 'utiliser l'association de programme pour le nom de fichier qui suit'. Voyons un exemple -
Item4=$S %1
Puisque %1 se réfère au fichier en sortie (voir dessous), cela signifie que 'Item 4' du menu outils aboutit à une commande pour Windows pour ouvrir le dernier fichier en sortie avec tout programme qui lui est associé. Par exemple, si le dernier fichier en sortie était 'c:\images\torus4.bmp' alors la commande en exemple utilisera tout programme associé aux fichiers BMP (ex. le programme que Windows lance quand vous faites un double clic sur le fichier TORUS4.BMP dans l'explorateur Windows) pour l'ouvrir.
NOTE ! Si vous utilisez la commande d'appel d'ouverture ($S), NE CERNEZ pas les paramètres avec '"', même s'il y a des espaces.
POV-Ray pour Windows a un certain nombre de paramètres prédéfinis que vous pouvez placer dans la ligne de commande avant de lancer le programme. Ils sont repérés par un signe de pourcentage ('%') suivi d'une lettre ou d'un nombre. Par exemple, '%i' signifie placer le dossier des fichiers INI de POV-Ray pour Windows à la place de '%i'.
Regardons cette commande :
notepad.exe %ipvtools.txt
Si vous avez installé POV-Ray pour Windows dans le répertoire 'c:\povwin3', alors votre dossier standard de fichiers INI est 'c:\povwin3\ini\'. Quand POV-Ray lance la commande précédente, le '%i' est remplacé par 'c:\povwin3\ini\'. Notez que le dernier '\' est fourni par POV-Ray. Cela signifie que :
notepad.exe %ipvtools.txt
deviendra :
notepad.exe c:\povwin3\ini\pvtools.txt
Voici toutes les substitutions prédéfinies :
| %0 | Le contenu de l'entrée de 'SourceFile' de la section 'LastRender' dans PVENGINE.INI. Ce sera le fichier de sortie fourni par POV-Ray pour le rendu le plus récent. Cette information est extraite du moteur de rendu lui-même, plutôt que de toute information en entrée ou ligne de commande. C'est le fichier qui, après l'analyse de la ligne de commande et des fichiers INI, est finalement assigné comme fichier en entrée. |
| %1 | Le contenu de l'entrée 'OutputFile' de la section 'LastRender' dans PVENGINE.INI. Cela sera le fichier de sortie de la dernière génération, si il existe. Cette entrée peut être vide. |
| %2 | Le contenu de l'entrée 'SceneFile' de la section 'LastRender' dans PVENGINE.INI. Cela sera le nom du fichier scène de la dernière génération, sans l'extension .POV. Vous pouvez utiliser cela en ajoutant une nouvelle extension. Par exemple,
tga2gif %d\%1 %2.gif
peut donner :
tga2gif c:\scenes\myscene.tga myscene.gif
en assumant que le fichier en entrée était myscene.pov et que le dossier actuel était c:\scenes. |
| %3 | Le contenu de l'entrée 'HistogramFile' de la section 'LastRender' dans PVENGINE.INI. S'il y a eu un fichier histogramme écrit, ce sera son nom. Si le fichier histogramme était dans un format .CSV, vous ne l'utilisez probablement pas pour lancer Excel. Par contre, vous pouvez l'utiliser pour lancer un visualiseur ou un programme de fin de tâche. |
| %4 | Le contenu de l'entrée 'IniOutputFile' de la section 'LastRender' dans PVENGINE.INI. Si vous avez demandé à POV-Ray d'écrire un fichier INI avec le dernier rendu, cela contient son nom. |
| %D | Le contenu de l'entrée 'CurrentDirectory' de la section 'LastRender' dans PVENGINE.INI. C'est le dossier de travail courant qui a été fixé sur votre machine quand POV-Ray a commencé à générer le dernier fichier, et les autres fichiers en sortie y sont probablement adressés. Vous pouvez avoir besoin de fournir d'autres entrées à '%d' pour avoir l'adresse complète. |
| %H | Le dossier contenant POV-Ray pour Windows, comme spécifié dans la base de registre, ex. 'c:\Program Files\POV-Ray for Windows v3.6\'. Notez que le dernier 'backslash' est ajouté. |
| %I | Le dossier INI de POV-Ray pour Windows. ex. 'c:\Program Files\POV-Ray for Windows v3.6\ini'. |
| %N | Le nom de fichier INI prédéfini, comme utilisé dans la boîte de dialogue des options de rendu. |
| %R | Le dernier fichier généré (avec le chemin complet) comme fourni à POV-Ray depuis le générateur ou la boîte de dialogue de sélection de fichier. Cela n'est pas nécessairement la même chose que %S ou %0. |
| %S | Le nom du fichier source comme fourni à POV-Ray dans la dernière génération de la session actuelle. Cela n'est pas nécessairement la même chose que les directives %0 ou %R. Par exemple, %R ne fournira jamais le chemin d'un fichier qui a été rendu via la file d'attente des fichiers sans l'utilisation du dialogue 'Command'. %S inclura un tel fichier. |
| %T | L'adresse complète de PVTOOLS.INI. C'est le fichier qui contient les commandes du menu 'Tools'. |
| %% | Le caractère pourcentage ('%'). |
Si quelque chose semble confus, il y a une manière aisée de trouver ce qui advient. Si vous placez l'ordre DEBUG=1 dans la section 'General' de PVTOOLS.INI, POV-Ray pour Windows sortira la chaîne de caractère de chaque commande à la fois avant et après son extension, au lieu de lancer la commande que vous sélectionnez dans le menu outils. Ainsi vous pouvez exactement voir ce que POV-Ray substitue. La sortie sera visible dans la fenêtre des messages.
Par exemple :
[General]
Debug=1
fera la sortie. Tandis que
[General]
Debug=0
ou l'omission de l'ordre la désactive totalement.
[Help]
Vous pouvez avoir une ligne d'aide apparaissant dans la barre de statut à la base de la fenêtre. Vous n'avez pas besoin de fournir cette entrée si vous ne le voulez pas.
Exemple :
[Help]
Item8=Vous laisse sortir sous DOS
Cette commande fait apparaître la phrase 'Vous laisse sortir sous DOS' sur la barre de statut quand la souris est au-dessus du huitième élément du menu 'Tools'.
Si vous voulez que vos modifications prennent effet tout de suite après l'édition de PVTOOLS.INI avec un éditeur de texte, vous devez sélectionner la commande du menu 'Tools' 'Reload Tool Menu' pour demander à POV-Ray pour Windows de relire le fichier INI et activer les nouvelles options.
Cette commande standard du menu 'Tools' vous permet de modifier PVTOOLS.INI en utilisant l'éditeur Notepad. La commande fait partie de PVTOOLS.INI lui-même, ce qui signifie que vous pouvez la détruire complètement si vous ne voulez pas de sa présence par défaut dans la distribution de POV-Ray pour Windows.
[Menu]
Item0=Edit &master POVRAY.INI
Item1=Edit &last rendered file
Item2=Edit last &scene file
Item3=&View last rendered file
Item4=View &histogram image file
Item5=Edit resolution &INI file
Item6=Edit &this menu.
[Command]
# NOTE! If using the Shell Open command ($S), DO NOT quote the parameters with '"'
Item0=notepad.exe "%hrenderer\povray.ini"
Item1=notepad.exe "%r"
Item2=notepad.exe "%0"
Item3=$S %1
Item4=$S %3
Item5=notepad.exe "%n"
Item6=notepad.exe "%t"
[Help]
Item0=Edit master POVRAY.INI in installation directory
Item1=Edit the last file that POV-Ray was rendering
Item2=Edit the last scene file that you selected
Item3=View the output of the last render (assumes file output was on)
Item4=View the histogram of the last render (assumes histogram image output was on)
Item5=Edit secondary INI file as specified in Command-line dialog.
Item6=Edit PVTOOLS.INI to alter this menu
[General]
Debug=0
'GUI Extensions' sont des DLL spécialisées qui peuvent ajouter des fonctionnalités à l'interface utilisateur de POV-Ray pour Windows. Elles peuvent permettre un accès pour les programmes externes (comme le populaire modeleur Moray) pour contrôler POV-Ray dans certaines limites. Si vous voulez plus d'information sur les extensions du GUI, voyez le groupe de discussion povray.programming sur le serveur de news POV, ou retrouvez le code source de POV-Ray pour Windows dans notre site FTP, et regardez les exemples d'extensions dans le sous-dossier GUIEXT.
Tant que vous n'utilisez pas un programme qui a une extension GUI, ou installée vous-même, il y aura un message 'No GUI Extensions Loaded' dans ce menu. Si vous en avez quelques unes installées, vous pouvez les activer ou les désactiver en décochant l'élément de menu 'Use Extensions'.
La POV-Team ne fournit aucun support de quelque nature que ce soit pour les extensions GUI. La documentation POV qui autorise les auteurs de GUIEXT d'écrire des extensions spécifie qu'ils doivent fournir le support pendant une certaine durée à la suite de leur réalisation. Si vous avez une tierce partie GUIEXT pour laquelle vous avez des problèmes, vous devez vous adresser à l'auteur de l'extension. S'il n'est plus en mesure de vous aider, nous ne pouvons rien faire pour vous.
 1.5.8 Le menu Options |
1.5.10 Les menus contextuels  |