1.5.6 Le menu 'Insert'

Le menu 'Insert' vous permet d'insérer des sections d'éntête, des définitions d'objet, etc. dans un fichier modifié avec l'éditeur interne, avec seulement quelques clics de votre souris. Il n'est visible que si vous avez sélectionné une fenêtre d'édition.

Ce menu est construit dynamiquement depuis le dossier appelé 'Insert Menu', qui est dans le dossier d'installation de POV-Ray pour Windows. Son mode de fonctionnement est identique au menu de démarrage de Windows 95/NT. Vous pouvez même le changer en cours de route, et POVWIN détectera automatiquement s'il a été modifié et le rechargera.

Il a la caractéristique suplémentaire que les entrées de menu peuvent avoir un fichier image associé, qui est affiché quand l'entrée est surbrillée. Une série de ces images est fournie avec POV-Ray pour Windows en standard; vous pouvez les regénérer à une résolution plus élevée si vous voulez - voir 'Re-Render Insert Menu Bitmaps' dans le menu 'Other Settings'.

1.5.6.1 Comment est construit le menu 'Insert'

1.5.6.2 Correspondance physique

Chaque sous-menu du menu 'Insert' est un dossier. Pour créer un nouveau sous-menu, créez simplement un nouveau dossier. Le sous-menu aura le même nom que le dossier.

Les éléments actuels que vous pouvez insérer dans votre fichier de scène sont simplement des fichiers textes. POVWIN les reconnaît par leur extension.TXT. Tout fichier .TXT dans l'arborescence du dossier 'Insert Menu' apparaîtra dans le menu 'Insert'. Le nom présenté sera celui du fichier .TXT, sans son extension. Si vous sélectionnez ce fichier depuis le menu 'Insert', le contenu du texte correspondant sera inséré dans votre fichier de scène à la position actuelle du caret.

1.5.6.3 Trier le menu 'Insert'

Il est possible d'ordonner les entrées du menu d'insertion de toutes les façons que vous voulez, à la fois pour les dossiers et pour les fichiers (ou sous-dossiers) contenus. Normalement, les entrées sont ajoutées au menu dans l'ordre alphabétique, avec tous les dossiers ajoutés avant les fichiers. Toutefois, vous pouvez influencer l'ordre de chaque groupe (dossiers et fichiers) en préfixant un dossier ou un fichier avec 'NN - ', où 'NN' est tout caractère ou chiffre (notez toutefois que cela ne vous permettra pas de placer un fichier avant un dossier).

Par exemple, supposons que vous voulez placer le dossier 'Transformations' (qui crée l'entrée de menu appelée 'Transformations' dans l'image exemple) entre les éléments de menu 'Expressions' et 'Headers'. Vous pouvez obtenir cela en renommant le dossier de 'Transformations' à, disons, 'F0 - Transformations' (le choix du 'F0' dans cet exemple est arbitraire - vous pouvez utiliser n'importe quoi qui puisse se placer dans l'ordre alphabétique entre 'Expressions' et 'Headers').

Quand le code de l'éditeur construit le menu d'insertion (ce qui se produit chaque fois que vous le modifiez), tout fichier ou dossier qui commence par 'NN - ' (notez l'espace de fin) sera trié en utilisant le préfixe, mais affiché sans ce préfixe.

1.5.6.4 Ajouter un séparateur

La création d'un fichier spécial appelé '-.txt' (un tiret suivi de .txt) correctement préfixé par un 'NN - ' (ex. '30 - -.txt'), entrainera la création d'un séparateur de menu au lieu de l'insertion d'un nouvel élément. Le contenu de ce fichier est ignoré.

Pour créer un séparateur entre deux sous-menus, faites la même chose, mais créez plutôt un dossier et ne mettez pas l'extension '.txt'.

1.5.6.5 Utilisation du menu 'Insert'

Chaque fichier texte du menu 'Insert' peut avoir un fichier BMP associé qui fournit une prévisualisation de l'élément que le fichier texte peut générer. Dans l'image exemple donnée, l'élément fournit le modèle spiral2, aussi la prévisualisation montre un exemple de ce modèle.

Les images de prévisualisation peuvent être de n'importe quelle profondeur, mais si vous voulez les distribuer nous vous recommandons de ne pas dépasser le 8 bit. En plus elles ne doivent pas être plus grandes que 640x480 pixels.

Le meilleur moyen de comprendre la façon dont tout ceci fonctionne est d'inspecter le dossier du menu 'Insert' fourni avec POV-Ray pour Windows. Le premier élément du menu 'Insert' vous permet de le faire en ouvrant une fenêtre de l'explorateur positionnée sur ce point de votre disque.

Voir aussi 'Re-Render Insert Menu Bitmaps' dans le menu 'Other Settings'.

1.5.5 Le menu 'Editor' 1.5.5 Le menu 'Editor' 1.5.7 Le menu 'Render' 1.5.7 Le menu 'Render'