Povedit est une interface graphique pour POV. 

Il s'agit d'un ensemble d'éditeurs permettant

 de faciliter la création d'images avec POVRAY.






 



Installation de povedit

Décompressez l'archive povedit.tgz (tar xvzf povedit.tgz)
Placez vous dans le répertoire povedit (cd povedit)
Tapez ./install ( en root )


Si vous avez choisi de télécharger povedit.rpm, tapez rpm -i povedit.rpm (en root)

Pour lancer povedit, tapez povedit; il faut que /usr/local/bin appartienne à votre path. Sinon, vous pouvez modifier votre path  ( export PATH=$PATH:/usr/local/bin ) ou taper le chemin complet ( /usr/local/bin/povedit ).

povedit est installé dans le répertoire /usr/local/povedit.

Povedit peut être placé sur votre bureau (KDE pour l'instant. Ca doit pas être très différent avec Gnome). Pour cela tapez ./povbureau (pas en root, sinon ce sera installé sur le bureau de root...)





Table des matières :

Menu Principal

Editeurs

Barre de boutons

Choix des options de rendu

Rendus multiples

Controle graphique du rendu

Mise à jour de povedit

Album  

Bugs connus

Liste de quelques problèmes, ainsi que de leurs tentatives de solution.
















DIFFERENCES AVEC LA

VERSION WINDOWS




Povedit ressemble fortement à povray pour windows, mais il y a quand même quelques différences.

a) Povedit est doté de fonctionnalités supplémentaires.
        a1) possibilité de cacher une zone de texte (sans modifier le texte)
    a2) possibilité d'insérer dans un éditeur le résultat d'un programme externe. Pour l'instant, on ne peut accéder qu' au programme "test", pour montrer la faisabilité.


Rendus multiples

Controle graphique des paramètres numériques

Memorisation des rendus successifs
Rendu en cluster
Rendus multiples d'une même scène

b) Povedit n'implémente pas certaines possibilités de povray pour windows.
 Il y a trois cas de figure :
        b1) Il est impossible d'implémenter cette possibilité. Par exemple, le texte des benchmarks n'est pas indiqué.
        b2) Cette possibilité est inutile.
        b3) J'ai eu la flemme... Je le ferai plus tard.
        b4) Je ne sais pas le faire.

Si vous pensez qu'il est nécessaire d'implémenter quelque chose, envoyez moi un courrier.

c) La gestion des rendus est différente.
Povedit ne demande pas à ce qu'un fichier soit sauvé pour en effectuer le rendu.



INITIALISATION



La première fois que vous utilisez povedit, le logiciel va essayer de trouver des adresses qui lui sont nécessaires.
Une boite de saisie s'ouvre alors, pour rechercher ces adresses.





Il s'agit :     de l'exécutable povray (ou autre, povedit fonctionne avec megapov et même avec BMRT)
                   de l'adresse des fichiers d'include pour pov. On peut considérer que ces fichiers sont indispensables.
                   de l'adresse de vos fichiers d'include personnels (non indispensable mais pratique)
   

Vous pouvez également choisir la langue à utiliser, la police par défaut des éditeurs, et la couleur de la plupart des fenêtres.


Cette fenêtre ne "rend pas la main" tant que les adresses demandées ne sont pas correctes. Il est  capital que ces adresses soient correctes, le fonctionnement de povedit en dépend. Cependant, le troisième champ est optionnel, vous pouvez le laisser en blanc (il vous sera possible de spécifier ultérieurement cette ou ces adresses).


Ces adresses seront copiées dans un tépertoire de configuration "caché", nommé ~/.poveditrc.
En cas de problème, vous pouvez détruire ce répertoire. Au prochain démarrage de poveditor, ces adresses devront être indiquées à nouveau.












Lorsque la fenêtre d'initialisation est refermée, vous accédez à la fenêtre principale de povedit.

Povedit se compose d'une barre de menu (1), d'une barre de boutons configurable (2), d'une tirette de réglage de la qualité (3), d'une liste déroulante d'options (4), d'une fenêtre de saisie d'options supplémentaires (5), et d'un ensemble d'éditeurs (6).





gg





MENU PRINCIPAL



 



Le menu de povedit comporte 12 options, que nous allons détailler :

a) Le menu "Fichiers"


        a1) Nouveau : ouvre un éditeur vide.
        a2) Ouvrir : ouvre un fichier.
        a3) Insérer : insère le contenu d'un fichier dans l'éditeur courant
        a4) Fermer : ferme l'éditeur courant
        a5) Tout fermer : ferme tous les éditeurs.
        a6) Sauver : sauve le contenu de l'éditeur courant.
        a7) Sauver sous : sauve le contenu de l'éditeur courant sous un nouveau nom
        a8) Tout sauver : sauve le contenu de tous les éditeurs.
        a9) Imprimer : imprime le contenu de l'éditeur courant.
        a10) Config. impression: non implémenté.
        a11)Quitter povedit : devinez?
        a12) Anciens fichiers : permet d'ouvrir un fichier précédemment ouvert.
v




 
                                                                      
  


b) Le menu "Edition"

   b1) Aide sur ce menu : non implémenté
        b2) Défaire : permet d'annuler la dernière modification du fichier.
        b3) Refaire : permet d'annuler la dernière annulation (!)
        b4) Couper : coupe la zone de texte sélectionnée et la place dans le buffer.
        b5) Copier : place la zone de texte sélectionnée dans le buffer.
        b6) Coller : insère le contenu du buffer au point d'insertion de l'éditeur courant.
        b7) Detruire : coupe la zone de texte sélectionnée sans la placer dans le buffer.
        b8) Cacher : cache la zone sélectionnée
        b9) Montrer : ré-affiche la ou les zone(s) précédemment cachées
        b8) Tout sélectionner : sélectionne tout le texte.
        b9) Le sous menu Selection permet d'opérer sur le texte sélectionné


 

            b91) Majuscules : convertit la sélection en majuscules
            b91) Miniscules: convertit la sélection en minuscules
            b92) Convert Spaces to Tabs : convertit les espaces en tabulations.
            b93) Convert Tabs to Spaces  : convertit les tabulations en espaces.


                                                                        

     






 






c) Le menu "Recherche"


                                                                         
    c1 ) Aide sur ce menu : non implémenté
    c2) Chercher : recherche une chaine de texte dans l'éditeur courant. Le texte trouvé est provisoirement affiché en rouge.
    c3) Remplacer : remplace une chaine par une autre.
    c4) Chercher suivant : recherche à nouveau la chaine précédemment sélectionnée.
    c5) Parenthèse associée : recherche la parenthèse qui correspond à celle qui précède le point d'insertion. Si le point d'insertion n'est pas derrière une parenthèse, cette commande n'a pas d'effet. Cette commande fonctionne pour les parenthèses ouvrantes et fermantes.
    c6) Aller à : place le point d'insertion à la ligne précisée.


d) Le menu "Texte"
 

d1) Montrer les blancs : montre ou cache les blancs du texte.
d2) Nombre de répétitions : Sélectionne le nombre de fois à répéter la prochaine commande.
 




e) Le menu "Editor" : non implémenté.

f) Le Menu "Inserer" :

Le menu Insérer appelle un menu flottant qui est construit dynamiquement au démarrage de povedit. Pour ce faire, povedit explore le répertoire /usr/local/povedit/Insert_Menu/ .


Propose de sélectionner un "objet pov" depuis un menu flottant. Ce menu flottant correspond au contenu du répertoire "Insert_Menu" situé dans le répertoire d'installation de povedit. Les sous répertoires correspondent à des entrées de menu cascadées, les fichiers d'extension "pov" ou "txt" aux entrées de menu. Pour insérer un objet, cliquez simplement dessus, il sera inséré dans l'éditeur courant à la position du point d'insertion.
Vous pouvez naturellement ajouter ou retirer des fichiers dans ce répertoire, ces changements seront répercutés dans le menu d'insertion.

Les fichiers proposés sont ceux de la version Windows de povray. J'aimerais bien ajouter aux prochaines distributions une section "contributions". Par conséquent, si vous avez des "éléments pov" (des scènes complètes, des textures, des macros, des éclairages intéressants), que vous accepteriez de mettre à la disposition de tous, envoyez les moi, je les intégrerai dans les prochaines distributions. Vous m'enverrez également un courrier précisant que ce travail est bien de vous, et qu'il est libre de droits.



g) Le menu "Rendu"

    g1) Edition des fichiers d'initialisation : Cet item propose l'édition du fichier principal d'initialisation et du fichier d'optionss sélectionnables.


Vous disposez de deux fenêtres d'édition, la première pour le fichier principal d'initialisation, et la seconde pour les diverses options supplémentaires qui peuvent lui être ajoutées.
Les modifications de ces deux fichiers seront conservées pour les sessions suivantes.
Le bouton en haut de la fenêtre vous permet de changer de fichier d'initialisation.

    g2) Rendu d'un fichier : Vous demande de sélectionner un fichier, et effectue directement un rendu de ce fichier.
    g3) Rendu : effectue un rendu de l'éditeur courant. En cas de problème, les messages d'erreur de povray se trouvent dans l'éditeur "Messages" (en lecture seule).
g4) Rendu parallèle : effectue un rendu en partageatn le calcul sur les serveurs qui ont été séctionnés.
    g5) Boite de contrôle : ouvre une boite de contrôle correspondant aux vecteurs de la région sélectionnée.
Le fonctionnement de la boite de contrôle est détaillé dans la section

Controle graphique du rendu

   g6) Tuer toutes les instances de pov en cours : ferme toutes les fenêtres de rendu présentes. Cette option est assez pratique si vous lancez un grand nombre de rendus qui consomment trop de CPU, et que vous ne voulez pas les tuer une à une.





 
  


 


h) Le menu "Options"


h1) Configurer : vous permet de passer quelques paramètres à povedit. Ces modifications seront appliquées au prochain lancement de povedit. Vous devez avoir déjà vu cette fenêtre au premier lancement de povedit.
h2) Afficher l'album : permet d'afficher un "album" des derniers rendus. Cette option est détaillée dans Album
h3) Montrer la barre d'icônes. Permet d'afficher ou de cacher la barre d'icônes.
h4) Enregistrer vers l'album : active ou désactive  la fonction d'enregestrement des rendus dans l'album. Cette fonction peut également être contrôlée en utilisant la case à cocher à droite de la barre d'icônes.





 

i) Le menu "Outils"


i1) Executer programme externe.
Cette option permet d'executer n'importe quel programme, et d'insérer les résultats de ce programme dans l'éditeur courant. Pour l'instant, un seul programme est proposé, qui génére un mesh2 aléatoire...




 



   
Les autres menus ne sont pas implémentés.



EDITEURS


Vous disposez d'un nombre illimité d'éditeurs. Vous pouvez charger un fichier, ou ouvrir un éditeur vide. Ces éditeurs offrent la plupart des fonctionnalités traditionnelles d'édition.



Vous disposez des contrôle suivants dans la fenêtre d'édition :
        Bouton de droite : fait apparaître un menu flottant, avec des zillions de trucs sélectionnables.
                    Choisissez ce que vous voulez ajouter à votre fichier, et ce sera inséré à la position du curseur.
        Shift ( Majuscule)Bouton de droite : Insère à la position du curseur le résultat d'un programme externe. Il vous est proposé une boîte de dialogue vous permettant de sélectionner le programme à exécuter, et de lui passer les paramètres requis.
        Control-h : cache la sélection. Attention! La sélection est cachée, mais elle est quand même utilisée lors d'un rendu.
        Alt-h : Montre les régions précédemment cachées.
        Alt-a : Sélectionne tout
        F9 :  Completion de mots.
        Control-r ou F4 : lance le rendu.
        Control-u :  Undo
        Control-r :  Redo
Il est à noter que le "Undo" et le "Redo" sont illimités.
        Control-c : Copie la sélection dans un buffer.
        Control-v : Copie le bufferau point d'insertion.
        Control-x : Detruit la sélection en la copiant dans le buffer.
        Control-z : Detruit la sélection sans la copier dans le buffer.
        Control-f : Recherche une expression.
        Control-g : demande un numero de ligne, et positionne le point d'insertion à ce numéro.
        Control-e : selection de la police.
        Control-k : ferme toutes les fenetres de rendu.
      Control-b : Recherche l'accolade correspondant à celle qui est juste après le point d'insertion, si c'est une accolade ouvrante, ou à celle qui est juste avant le point d'insertion, si c'est une accolade fermante.
        Control-p : ouvre l'album
       Return : force le recalcul de la coloration syntaxique
       F5 : rendu parallèle
       Control-o :  Ouvre un fichier
       Control-n :  Nouvel éditeur vide
       Control-s : Sauve
        Control-i : Insère un fichier dans l'éditeur courant
        Control-k : Ferme l'éditeur courant
        Control-Alt-k :  Ferme tout
        Control-Shift-s : Sauve tout
        Control-Alt-s : Sauve sous...



BARRE DE BOUTONS


Povedit possède une barre d'icônes configurable. La plupart des fonctions de povedit peuvent être placées dans la barre d'icônes, mais il est préférable au plan ergonomique de n'en pas mettre un trop grand nombre.
Ces icônes sont très compréhensibles, et possèdent de plus des bulles d'aide pour vous rappeler ce qu'elles font.
Les icônes ont été réalisées par André Pascual, qui est un bon graphiste, et qui est sympa, ce qui ne gâte rien...
Vous pouvez aller voir ce qu'il fait à http://linuxgraphic.org
Par défaut, povedit est proposé avec une barre "standard" :

                                              
 
Pour modifier cette barre, cliquez sur Options/Configurer la barre d'icônes. Une fenêtre avec deux listes s'ouvre. La liste de gauche est l'ensemble des fonctions disponibles, celle de droite la liste des options dans la barre. Les boutons ">", "<", et "OK" sont assez évidents...
(Les noms des fonctions disponibles seront prochainement francisés)

Attention ! Les icones seront placées dans le même ordre que celui de la liste de fonctions sélectionnées.



La case à cocher indique si la mémorisation des rendus est active.



CHOIX DES OPTIONS DE RENDU


Le choix des options de rendu est une opération en quatre parties :
    1) En premier lieu, les options sont lues dans un fichier de configuration global. Par défaut, ce fichier s'appelle ~/povedit.ini, mais vous pouvez en changer avec le menu mmmmmmmmmmmmm
    2) On ajoute a ces options le choix dans la boite de liste.
    3) Finalement, on ajoute encore le contenu de la fenêtre de saisie.
    4) Enfin, la qualité du rendu est indiquée à povray.

La liste déroulante de gauche permet de passer quelques options standard. Vous pouvez rajouter vos options les plus fréquemment utilisées par Editor/Options. Ces options seront inscrites dans votre fichier de configuration, et automatiquement rechargées lors du lancement de povedit.


Des options supplémentaires peuvent être données dans la boite de saisie à droite de la liste déroulante. Ces options peuvent "surcharger" les options initiales.



RENDUS MULTIPLES

Povedit peut effectuer plusieurs rendus d'une scène, en faisant varier un paramètre entre des bornes prédéfinies . Cette option  peut être pratique pour trouver la valeur optimale d'un paramètre, en ayant une vue d'ensemble.

Pour cela, rien de plus simple :
    A) Déclarez vos variables. Cette déclaration est de la forme
//;; Identifiant valeur_initiale valeur_finale nombre_de_vues
Par exemple :
//;; toto 4 4.5 10
    B) Utilisez cette variable ou vous voulez à la place d'une expression numérique à l'intérieur d'un vecteur (cette restriction sera supprimée).
Si vous demandez un rendu, vous en obtiendrez 11, pour lesquels la variable toto prendra les valeurs
4 , 4.05 , 4.1 , 4.15 , ... , 4.95 , 5.


 

CONTROLE GRAPHIQUE DES RENDUS

(Boites de contrôle)


Povedit vous permet de contrôler graphiquement les paramètres d'un fichier.
Pour cela, sélectionnez une partie du fichier, et tapez "Control G" ou menu Rendeer/Control box.
Une fenêtre de contrôle s'ouvre, proposant une batterie de curseurs contrôlant toutes les valeurs numériques de la partie sélectionnée ( actuellement limitée aux valeurs à l'intérieur d'un vecteur, mais cette restriction sera supprimée).
Au dessus de chaque curseur, on a la partie du texte source qui se trouve avant le vecteur que ce curseur contrôle.




Vous pouvez modifier les valeurs, et lancer une visualisation en cliquant sur "Visu". Lorsque vous êtes satisfaits du résultat, cliquez "OK", et les modifications seront validées. En cliquant sur "Cancel", les modifications sont annulées.


Il est alors assez facile de trouver, après quelques tâtonnements, la valeur optimale d'une texture, d'une lumière, d'une position, d'une transformation.



MEMORISATION DES RENDUS

Povedit vous permet de mémoriser une suite de rendus. Comme cette opération est assez gourmande en mémoire, elle est inactive par défaut.
Lorsque cette option est active, lors de chaque rendu, une vignette sera créée, et insérée dans le l'album.


Vous pouvez alors  retrouver n'importe quel rendu en cliquant sur la vignette correspondante. Un nouvel éditeur est créé, contenant le code source de la vignette.

ATTENTION! Pour que la mémorisation des rendus fonctionne, il faut que les options +FP et +O- soient activées.

MISE A JOUR DU LOGICIEL

Vous pouvez mettre automatiquement à jour povedit en cliquant sur Menu Fichiers/Mise à jour
Important : il FAUT que vous soyes connecté à l'Internet pour effectuer cette mise à jour.
La mise à jour s'effectue automatiquement.

Povedit se connecte à un site disposant de la dernière version par le protocole http. Un fichier est inclus dans chaque distribution, comportant en particulier les signatures MD5 des fichiers source. Ces signatures sont alors comparées avec celles des fichiers de la machine locale, et les fichiers dont la signature diffère sont mis à jour.
Vos anciens fichiers seront sauvegardés avec l'extension 'bak'.

 Pendant cette mise à jour, qui est relativement rapide (de l'ordre d'une minute, moins si vous avez un accès rapide), une fenêtre de progression s'affiche :


Les lignes vertes indiquent que la mise à jour s'est bien passée, ou qu'elle n'était pas nécessaire.
Les lignes rouges indiquent un problème. (Il ne devrait pas y en avoir...)

Attention!

La procédure de mise à jour ne peut écrire dans le répertoire de povedit. Les nouveaux fichiers sont stochés temporairement dans /tmp. Vous aurez à copier -en root- ces fichiers dans le répertoire /usr/local/povedit.



Liste de quelques problèmes, ainsi que de leurs tentatives de solution.


Le module Tkinter se charge pas. Vous êtes sûr qu'il est installé?  Eventuellement
modifiez la variable sys.path, au tout début de main.py mais c'est pas normal, le module Tkinter est -mal- installé, python devrait le trouver tout seul.

Le module Pmw charge pas. Même réponse.

Le rendu ne marche pas. Verifiez les variables AdresseIncludesPourPOVet  AdresseDePOV. Elles se trouvent dans le fichier ~/.povinitrc. Eventuellement, détruisez ce fichier, et relancez povinit, en faisant bien attention à ces adresses. povedit fait une vérification très sommaire des entrées de la boite de dialogue d'initialisation.
N'oubliez pas d'aller voir dans l'éditeur "Messages". Il y a peut être une erreur dans votre fichier pov...

Si vous ne trouvez pas l'adresse de l'executable povray, tapez "which povray" dans un terminal.
De même, pour les fichiers d'include de pov, vous pouvez essayer "locate colors.inc".
En dernier recours, essayez "find / -name colors.inc ", mais attention cette commande va explorer tout le filesystem /, ca risque d'être long si vous avez un gros disque ( environ 5 minutes)

Bugs connus

Lors d'une insertion, la scroll bar descend...
Rapports de bugs, demandes ne nouvelles possibilités, etc, etc : guignot@wanadoo.fr


Retour à la page d'accueil