home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 9 / CD_ASCQ_09_1193.iso / news / 2315 / povdef / povdef.doc < prev    next >
Text File  |  1993-04-06  |  20KB  |  411 lines
  1.                            ┌──────────────────────┐
  2.                            │                      │
  3.                            │  P O V D E F  V 2.0  │
  4.                            │                      │
  5.                            │         1993         │
  6.                            │                      │
  7.                            │  Sylvain    BERGEON  │
  8.                            │                      │
  9.                            │  23 Rue Arthur RANC  │
  10.                            │                      │
  11.                            │  86 000    POITIERS  │
  12.                            │                      │
  13.                            │  tel : 49 88 69 63   │
  14.                            │   ap 20h00 (SVP).    │
  15.                            └──────────────────────┘
  16.  
  17.          Ce  logiciel est  en freeware   et peut  être édité  par tout
  18.          revendeur, éditeur, distributeur de shareware et freeware. Le
  19.          prix du logiciel ne doit pas dépasser le montant des frais de
  20.          publication, de duplication, de  support magnétique ou autre,
  21.          plus les frais  d'envoi, soit environ 50 FF  maximum pour une
  22.          disquette 3½ HD 1,44 Mo.
  23.  
  24.          Cela reste possible avec le strict respect du travail du(des)
  25.          programmeur(s), sans  aucune falsification de  données, ainsi
  26.          qu'avec   la  distribution   de  la   totalité  des  fichiers
  27.          (POVDEF.DOC et POVDEF.EXE).
  28.  
  29.          Si vous soupçonniez une  quelconque anomalie de distribution,
  30.          veuillez me contacter en précisant la date de votre achat, la
  31.          version  de  votre  logiciel,  le  nom  du  distributeur, son
  32.          adresse, et les fichiers présents et/ou manquants.
  33.  
  34.  
  35.          ─────────────────────────────────────────────────────────────
  36.                                                  D E S C R I P T I O N
  37.          ─────────────────────────────────────────────────────────────
  38.  
  39.          Ce logiciel  se veut simple  et rapide d'emploi,  sans aucune
  40.          prétention.  Il permet  de choisir  différentes options  de
  41.          calcul de POVRAY pour plusieurs scripts et de créer un
  42.          auto-exécutable  (BATCH) qui lancera automatiquement tous les
  43.          calculs, les uns à la suite des autres. Il peut être utilisé
  44.          de deux façons différentes. Pour préparer une liste de script
  45.          à calculer (pendant la nuit par exemple) ou pour lancer
  46.          directement un calcul sans avoir à taper une ligne de dos.
  47.  
  48.          Il est  encore plus efficace  dans l'élaboration d'une  image
  49.          losqu'il est utilisé de pair avec QEDIT (éditeur de texte) et
  50.          la fonction DOSKEY ( Mémorisation des dernières commandes dos
  51.          exécutées).  Si  vous  trouvez  un  quelconque  intérêt  à ce
  52.          logiciel, si vous avez des suggestions, ou si vous rencontrez
  53.          des problèmes (bugs, plantages...) n'hésirez pas à m'en faire
  54.          part.
  55.  
  56.          Dans  le même  genre je  prévois d'écrire  une interface pour
  57.          piloter le logiciel IMAGE ALCHEMY.  Si vous avez là aussi des
  58.          suggestions, écrivez-moi.
  59.  
  60.  
  61.          ─────────────────────────────────────────────────────────────
  62.                                                I N S T A L L A T I O N
  63.          ─────────────────────────────────────────────────────────────
  64.  
  65.  
  66.          POVDEF   écrit  après   chaque  utilisation   un  fichier  de
  67.          sauvegarde  des  paramètres  courants  et  des derniers choix
  68.          effectués. A chaque utilisation  ce fichier de paramètres est
  69.          lu par POVDEF.  Si vous lancez POVDEF pour  la première fois,
  70.          certains paramètres seront spécifiés par défaut.
  71.  
  72.          Les  autres paramètres  comme les  sous-répertoires que  vous
  73.          désirez  utiliser  (et  qui  sont  propres  à  votre système)
  74.          doivent être indiqués. Sans quoi le  programme ne sera  pas à
  75.          même d'écrire quoi que se soit.
  76.  
  77.          Quand  vous  les  aurez  sélectionnés  une  fois, le logiciel
  78.          écrira  automatiquement le  fichier de  paramétrage, lors des
  79.          prochaines utilisations.
  80.  
  81.  
  82.  
  83.          ─────────────────────────────────────────────────────────────
  84.                                                      L E S   M E N U S
  85.          ─────────────────────────────────────────────────────────────
  86.  
  87.          Dans tous les menus, les  touches de déplacement et la touche
  88.          [ENTREE] suffisent pour circuler d'un choix à l'autre et d'un
  89.          menu à l'autre.
  90.  
  91.          Flèches:
  92.  
  93.          [HAUT] [BAS]  - Déplacement vertical dans  un menu, une liste
  94.                          de fichiers, ou une liste de répertoires.
  95.  
  96.          [DROITE]      - Sélection/Validation  d'un  choix  dans un
  97.                          menu.
  98.                        - Sélection/Validation d'un  fichier dans une
  99.                          liste.
  100.                        - Sélection  du  répertoire  suivant  dans une
  101.                          arborescence.
  102.                        - Validation du répertoire en cours s'il s'agit
  103.                          du dernier de la branche.
  104.  
  105.          [GAUCHE]      - Validation  d'un choix  dans un  menu.
  106.                        - Validation  d'un  fichier  dans  une  liste.
  107.                        - Retour au répertoire précédent dans une
  108.                          arborescence.
  109.  
  110.          [ENTREE]      - Validation d'un choix dans un menu
  111.                        - Validation  d'un  fichier  dans  une  liste.
  112.                        - Validation du répertoire en cours dans un
  113.                          arborescence.
  114.  
  115.          ─────────────────────────────────────────────────────────────
  116.                                                         C O N T E N U
  117.          ─────────────────────────────────────────────────────────────
  118.          Si  vous conaissez  déjà bien  povray et  que les  options de
  119.          calcul  ne vous  posent  aucun  problème, vous  pouvez sauter
  120.          directement  au  explication  propres  à  POVDEF soit (12-21)
  121.          sinon commencez à lire à partir de (1).
  122.  
  123.  
  124.                MENU SIMPLE POUR UN SEUL SCRIPT
  125.               ┌───────────────────┐┌───────────┐
  126.        ┌──( 1)│Taille de l'image  ││ Cette     │
  127.        │  ( 2)│Qualité du rendu   ││ fenêtre   │
  128.        │  ( 3)│Antialiasing       ││ affiche   │
  129.        │  ( 4)│Format graphique   ││ en        │
  130.        │  ( 5)│Affichage direct   ││ permanence│
  131.    ┌───┤  ( 6)│Palette d'affichage││ les       │
  132.    │   │  ( 7)│Abandon possible   ││ options   │
  133.    │   │  ( 8)│Continuer un rendu ││ en        │
  134.    │   │  ( 9)│Pause après calcul ││ cours     │
  135.    │   │  (10)│Taille du buffer   ││ qui       │
  136.    │   └──(11)│Statistiques       ││ seront    │
  137.    │   ┌──(12)│Librairies         ││ associées │
  138.    │   │  (13)│Répertoires        ││ au        │
  139.  ┌─│───┤  (14)│Lancer le calcul   ││ script.   │
  140.  │ │   │  (15)│Gestion de liste   ││           │
  141.  │ │   └──(16)│Quitter            ││           │
  142.  │ │          └───────────────────┘└───────────┘
  143.  │ │
  144.  │ │
  145.  │ │          MENU ETENDU A LA GESTION DE LISTE
  146.  │ │
  147.  │ │          ┌───────────────────┐┌───────────┐
  148.  │ │          │Taille de l'image  ││ Cette     │
  149.  │ │          │Qualité du rendu   ││ fenêtre   │
  150.  │ │          │Antialiasing       ││ affiche   │
  151.  │ │          │Format graphique   ││ en        │
  152.  │ │          │Affichage direct   ││ permanence│
  153.  │ │          │Palette d'affichage││ les       │
  154.  │ │          │Abandon possible   ││ options   │
  155.  │ │          │Continuer un rendu ││ en        │
  156.  │ │          │Pause après calcul ││ cours     │
  157.  │ │          │Taille du buffer   ││ qui       │
  158.  │ │          │Statistiques       ││ seront    │
  159.  │ │          │Librairies         ││ associées │
  160.  │ │          │Répertoires        ││ au(x)     │
  161.  │ │    ┌─(17)│Ajouter à la liste ││ scripts.  │
  162.  │ │    │ (18)│Enlever de la liste││           │
  163.  ├─│────┤ (19)│Ecrire batch       ││           │
  164.  │ │    │ (20)│Gestion simple     ││           │
  165.  │ │    └─(21)│Accés au dos       ││           │
  166.  │ │          │Quitter            ││           │
  167.  │ │          └───────────────────┘└───────────┘
  168.  │ │
  169.  │ │
  170.  │ │   ┌───(1) TAILLE DE L'IMAGE
  171.  │ └───┤
  172.  │     │       La fenêtre  qui s'ouvre vous permet  de choisir parmi 7
  173.  │     │ tailles d'image prédéfinies. Ces différents formats sont ceux
  174.  │     │ les plus  couramments utilisés du plus petit (logo  32x32) au
  175.  │     │ plus grand  (HiDef S-VGA 1024x768)  en passant par  le format
  176.  │     │ Vidéo, VGA, Preview ...
  177.  │     │
  178.  │     │   (2) QUALITE DU RENDU
  179.  │     │
  180.  │     │       Ouvre  un  menu  en  hauteur  qui  permet de choisir le
  181.  │     │ niveau de rendu de l'image.
  182.  │     │
  183.  │     │   (3) ANTIALIASING
  184.  │     │
  185.  │     │       Un  menu en  longueur permet  le paramétrage  du niveau
  186.  │     │ d'antialiasing. Si vous choisissez:
  187.  │     │
  188.  │     │       "non"  Il n'y aura pas d'antialiasing
  189.  │     │       "0.1"  Antialias maximum
  190.  │     │       "0.3"  Donne le résultat optimum
  191.  │     │       "0.9"  Antialias minimum
  192.  │     │
  193.  │     │   (4) FORMAT GRAPHIQUE
  194.  │     │
  195.  │     │       Choix du format graphique de l'image calculée
  196.  │     │            ┌──────────┬─────────────┐
  197.  │     │            │ Format   │  Extension  │
  198.  │     │            ├──────────┼─────────────┤
  199.  │     │            │  Targa   │    *.TGA    │
  200.  │     │            │  Dump    │    *.DMP    │
  201.  │     │            │  Raw     │    *.RAW    │
  202.  │     │            └──────────┴─────────────┘
  203.  │     │
  204.  │     │   (5) AFFICHAGE DIRECT
  205.  │     │
  206.  │     │       Ce menu vous donne la possibilité de choisir le type de
  207.  │     │ carte  graphique  dont  vous  êtes  équipé  pour  obtenir  un
  208.  │     │ affichage  optimal  lors  du   calcul  de  l'image.  L'option
  209.  │     │ d'autodétection est  bien utile si vous  ne connaissez pas le
  210.  │     │ type  de carte  avec lequel  vous travaillez  (s'il s'agit de
  211.  │     │ votre  matériel essayez  quand  même  de vous  renseigner, ça
  212.  │     │ pourra vous servir...). Enfin l'option pas d'affichage direct
  213.  │     │ désactive  l'affichage  pendant  le  calcul.  C'est  un choix
  214.  │     │ intéressant    pour  gagner   du  temps   lors  d'un   calcul
  215.  │     │ (désactivez  l'affichage   si  vous  calculez   la  nuit  par
  216.  │     │ exemple).
  217.  │     │
  218.  │     │   (6) PALETTE D'AFFICHAGE
  219.  │     │
  220.  │     │       Cette option  ne sert  que  si  l'affichage direct  est
  221.  │     │ activé.  Elle permet  de choisir la palette à  utiliser  lors
  222.  │     │ de l'affichage. Nuances de gris, 256 Coul, 32000 Couleurs  ou
  223.  │     │ 16M Coul. Inutile  de demander 3200 ou  16  M de couleurs  si
  224.  │     │ votre carte n'en permet pas l'affichage ...
  225.  │     │
  226.  │     │  (7) ABANDON POSSIBLE
  227.  │     │
  228.  │     │      En activant  cette option vous pourrez  à n'importe quel
  229.  │     │ moment  arrêter  un  calcul  en  appuyant  simplement sur une
  230.  │     │ touche. A  l'inverse si l'option est  désactivée, vous pouvez
  231.  │     │ être sûr que rien ni personne ne pourra arrêter le calcul (si
  232.  │     │ vous n'êtes pas là par exemple), à moins de rebooter.
  233.  │     │
  234.  │     │  (8) CONTINUER UN RENDU
  235.  │     │
  236.  │     │      Si  vous   avez  interrompu  un   calcul  (avec l'option
  237.  │     │ précédente par exemple (7)), cette option permet de reprendre
  238.  │     │ l'image où elle  s'était arrêtée (à la ligne  près c'est très
  239.  │     │ pratique).
  240.  │     │
  241.  │     │ (10) TAILLE DU BUFFER
  242.  │     │
  243.  │     │      Par défaut,  POV-Ray n'utilise pas  de buffer. Il  écrit
  244.  │     │ après  chaque ligne  le résultat  de son  dur labeur (soit un
  245.  │     │ accès disque par  ligne). Si vous lui indiquez  une taille de
  246.  │     │ buffer, il va stocker en  mémoire toutes les lignes calculées
  247.  │     │ jusqu'au   remplissage  du   buffer,  après   quoi  il  écrit
  248.  │     │ l'intégralité du buffer à la suite du fichier, vide le buffer
  249.  │     │ et ainsi de suite, recommence jusqu'à la fin de l'image.
  250.  │     │
  251.  │     └─(11) STATISTIQUES
  252.  │
  253.  │            Si vous  avez désactivé l'affichage  direct (5) le  seul
  254.  │       moyen  de suivre  l'évolution du  calcul est  d'activer cette
  255.  │       option. POV-Ray  vous indique alors sa  progression ligne par
  256.  │       ligne.
  257.  │
  258.  │
  259.  │
  260.  │     ┌─(12) LIBRAIRIES
  261.  │     │
  262.  │     │      Tous les fichiers inclus dans vos scripts (*.inc, *.gif,
  263.  │     │ *.tga..)  doivent se  trouver dans  des répertoires  que l'on
  264.  │     │ nomme librairies. Ce menu de POVDEF vous permet de prédéfinir
  265.  │     │ 4 librairies différentes parmi tous  les répertoires de votre
  266.  │     │ disque.
  267.  │     │
  268.  │     │ ex:
  269.  │     │
  270.  │     │       SCRIPT                                  LIBRAIRIE
  271.  │     │ ┌───────────────────────────────────────┬─────────────────────────┐
  272.  │     │ │.../...                                │                         │
  273.  │     │ │        ┌─────────────┐                │                         │
  274.  │     │ │#include│"script.inc" ├────────────────┼──>c:\pvray\includes     │
  275.  │     │ │        └─────────────┘                │                         │
  276.  │     │ │object {                               │                         │
  277.  │     │ │                 ┌───────────┬─────────┼──>c:\pvray\images       │
  278.  │     │ │heigh_field { gif│"image.gif"│...}     │                         │
  279.  │     │ │                 └───────────┘         │                         │
  280.  │     │ │...                                    │                         │
  281.  │     │ │texture {                              │                         │
  282.  │     │ │                   ┌───────────┬───────┼──>c:\pvray\mapping      │
  283.  │     │ │image_map { ... tga│"image.tga"│...}   │                         │
  284.  │     │ │                   └───────────┘       │                         │
  285.  │     │ │...                                    │                         │
  286.  │     │ │}                                      │                         │
  287.  │     │ │.../...                                │                         │
  288.  │     │ └───────────────────────────────────────┴─────────────────────────┘
  289.  │     │     (L'organisation de votre disque s'en portera d'autant mieux...)
  290.  │     │
  291.  │     │         Il  n'est  pas   possible  d'associer  des librairies
  292.  │     │ différentes pour plusieurs script  limitez vous donc au total
  293.  │     │ à quatre  librairies pour  l'ensemble de  vos scripts  (C'est
  294.  │     │ largement suffisant si vous êtes bien organisé)
  295.  │     │
  296.  │     │ (13) REPERTOIRES
  297.  │     │
  298.  │     │      Pour fonctionner, POVDEF doit savoir:
  299.  │     │      - où trouver POVRAY.EXE (Le programme)
  300.  │     │      - où Trouver le fichier d'entrée (le script)
  301.  │     │      - où écrire le fichier de sortie (l'image)
  302.  │     │      Vous  devez  donc  lui  indiquer  les  répertoires où il
  303.  │     │ pourra les  localiser. Chaque script  peut-être associé  à un
  304.  │     │ répertoire propre (à la différence des librairies), Il faudra
  305.  │     │ pour ça changer à chaque  fois le répertoire ( C'est possible
  306.  │     │ mais,  toujours pour  un souci  d'organisation, il  n'est pas
  307.  │     │ recommandé d'éparpiller des scripts partout...).
  308.  │     │
  309.  │     │ (14) LANCER LE CALCUL
  310.  │     │
  311.  │     │      La  liste  des  scripts  diponibles  dans  le répertoire
  312.  │     │ spécifié (13) apparaît. Sélectionnez  le script à calculer et
  313.  │     │ le  calcul  se  lance  automatiquement.  A  la fin du calcul,
  314.  │     │ POVDEF  réapparait  et  vous  pouvez  continuer à travailler.
  315.  │     │ Avant de  lancer le calcul,  POVDEF crée un  fichier batch du
  316.  │     │ même nom que  le script que vous avez  sélectionné et l'écrit
  317.  │     │ dans le  même répertoire. Vous pourrez  relancer le calcul en
  318.  │     │ tapant  directement  sous  dos  le  nom  de votre script (les
  319.  │     │ options sélectionnées  lors  de   l'écriture  du  batch  sont
  320.  └─────┤ conservées mais  il est possible d'en  forcer quelques-une en
  321.        │ les ajoutant à la suite du batch.
  322.        │
  323.        │ ex:
  324.        │       ┌──────────────────┐
  325.        │       ┤ LANCER LE CALCUL │
  326.        │       └──────┬───────────┘
  327.        │    ^         │     ┌──────────┐
  328.        │    │         │     │ TOTO.POV ├─>─┐
  329.        │    │         └───>─┤ TATA.POV │   │
  330.        │    │               │ TITI.POV │   │
  331.        │    │               └──────────┘   │
  332.        │    │                              │
  333.        │    │      ┌───────────────────────┴────────────────────┐
  334.        │    │      │POVDEF Crée le batch c:\rep_Scripts\TOTO.BAT│
  335.        │    │      └───────────────────────┬────────────────────┘
  336.        │    │                  ┌───────────┴──────────┐
  337.        │    │                  │POVDEF Lance le calcul│
  338.        │    │                  └───────────┬──────────┘
  339.        │    │   ┌───────────────┐          │
  340.        │    └───┤Retour à POVDEF├<─────────┘
  341.        │        └───────────────┘
  342.        │
  343.        │
  344.        │ (15) GESTION DE LISTE
  345.        │
  346.        │      Cette  option fait  basculer  le  logiciel vers  le menu
  347.        │ étendu à la gestion de liste (voir (17),(18)(19),(20),(21)).
  348.        │
  349.        │ (16) QUITTER
  350.        │
  351.        │      Retour au dos. Vous pouvez  aussi appuyer sur [ESC]. Les
  352.        │ options en cours sont  automatiquement sauvegardées ainsi que
  353.        │ la liste en cours s'il y a lieu.
  354.        │
  355.        │ (17) AJOUTER A LA LISTE
  356.        │
  357.        │      Vous permet de sélectionner un script dans le répertoire
  358.        │ spécifié  (13)  et  de  l'associer  aux  options  en cours en
  359.        │ l'écrivant à  la suite de la  liste. Un même scripts  ne peut
  360.        │ être écrit deux  fois avec les mêmes options  (normal non ?!)
  361.        │ mais peut être écrit deux  fois avec des options différentes.
  362.        │ Une  ligne   ajoutée  à  la  liste   ne  peut  être  modifiée
  363.        │ directement,  il faut  pour cela  l'effacer de  la liste (18)
  364.        │ puis la rajouter à nouveau une fois.
  365.        │
  366.        │ (18) ENLEVER DE LA LISTE
  367.        │
  368.        │      Choisissez  parmi  toutes  les  lignes  de  la  liste et
  369.        │ validez  [ENTREE]  ou  [FLECHE-DROITE(->)]  celles  que  vous
  370.        │ voulez effacer.  Il ne se  passe rien si  la liste est  vide.
  371.        │ Cette option permet aussi l'affichage  complet de la liste si
  372.        │ vous désirez la consulter. Pour ne rien modifier il suffit de
  373.        │ quitter par [ESC] ou par [FLECHE-GAUCHE(<-)]
  374.        │
  375.        │ (19) ECRIRE BATCH
  376.        │
  377.        │      Crée un exécutable de type batch  dans le répertoire des
  378.        │ scripts en  cours. Sauvegarde les options  en cours ainsi que
  379.        │ la liste créée. Le batch porte le nom de "RENDER.BAT" il vous
  380.        │ suffira  sous  dos  de  vous  placer  dans  le répertoire des
  381.        │ scripts et de  taper "render" pour que le  calcul de tous les
  382.        │ fichiers  sélectionnés  commence.  (Attention,  si  vous avez
  383.        │ activé la pause après calcul,  le programme attendra que vous
  384.        │ pressiez une touche pour continuer au calcul suivant).
  385.        │
  386.        │ (20) GESTION SIMPLE
  387.        │
  388.        │      Bascule POVDEF  en mode restreint  pour la gestion  d'un
  389.        │ seul script à la fois. (voir (15))
  390.        │
  391.        └─(21) ACCES AU DOS
  392.  
  393.               Vous  permet de  repasser sous  dos (pour  manipuler des
  394.          fichiers  par  exemple)  et  de  revennir  à POVDEF en tapant
  395.          simplement "EXIT".  (C'est bien pratique  quand un script  ou
  396.          une image n'est pas placé dans  le bon répertoire ou la bonne
  397.          librairie.)
  398.  
  399.  
  400.          MERCI DE VOTRE ATTENTION.
  401.  
  402.          ─────────────────────────────────────────────────────────────
  403.                                                        C O N S E I L S
  404.          ─────────────────────────────────────────────────────────────
  405.  
  406.          Utilisez DOSKEY.COM  pour plus de rapidité  dans le lancement
  407.          des programmes.
  408.          Vérifiez  bien  que  votre  programme  POV-Ray  porte  le nom
  409.          "POVRAY.EXE" (la béta 0.51a portait le nom "PVRAY.EXE").
  410.  
  411.