<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&kpovmodeler;">
  <!ENTITY package "kdegraphics">
  <!ENTITY Povray "<application
>POV-Ray</application
>">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % French "INCLUDE">
]>

<book lang="&language;">

<bookinfo>
<title
>Manuel de &kpovmodeler;</title>

<authorgroup>
<author
><firstname
>Lauri</firstname
> <surname
>Watts</surname
> <affiliation
> <address
><email
>lauri@kde.org</email
></address>
</affiliation>
</author>

<author
><firstname
>Andreas</firstname
> <surname
>Zehender</surname
> <affiliation
> <address
><email
>zehender@kde.org</email
></address>
</affiliation>
</author>

<author
><firstname
>Olivier</firstname
> <surname
>Saraja</surname
> <affiliation
> <address
><email
>olivier@linuxgraphic.org</email
></address>
</affiliation>
</author>

&traducteurGuillaumeDuweltzRebert; 
</authorgroup>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2002-09-07</date>
<releaseinfo
>1.00.00</releaseinfo>

<abstract>
<para
>&kpovmodeler; est un modeleur graphique 3D, qui peut générer des scènes pour &Povray; </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>KPovModeler</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction"
> 
<title
>Introduction</title
> 

<para
>&kpovmodeler; est une application de modélisation 3D qui génère des scènes &Povray;</para>

<para
>Bien qu'il ne soit pas indispensable de connaître parfaitement l'application &Povray; pour bien utiliser &kpovmodeler;, il est fortement recommandé de lire et de comprendre la documentation de &Povray;.</para>

<para
>Pour trouver plus d'informations sur &Povray; allez à <ulink url="http://www.povray.org"
>www.povray.org</ulink
>.</para>

</chapter>

<chapter id="the-interface">
<title
>L'interface &kpovmodeler;</title>

<para
>Quand vous lancez &kpovmodeler;, la disposition par défaut est la suivante :</para>

<screenshot>
<screeninfo
>La disposition de la vue par défaut</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="defaultviewlayout.png" format="PNG"/></imageobject>
<textobject
><phrase
>La disposition de la vue par défaut</phrase
></textobject>
</mediaobject>
</screenshot>

<itemizedlist>
<listitem>
<para
><link linkend="menu-reference"
>Barres de menus (1)</link
></para>
</listitem>
<listitem>
<para
>Barres d'outils (2)</para>
</listitem>
<listitem>
<para
><link linkend="the-object-tree"
>L'arborescence des objets (3)</link
></para>
</listitem>
<listitem>
<para
><link linkend="the-properties-view"
>Vue des propriétés des objets (4)</link
></para>
</listitem>
<listitem>
<para
><link linkend="the-wireframe-views"
>Vues de la caméra et en mode fil de fer (5)</link
></para>
</listitem>
</itemizedlist>

<sect1 id="the-object-tree">
<title
>L'arborescence des objets</title>

<para
>L'arborescence des objets affiche les objets dans la scène et leur hiérarchie.</para>
<screenshot>
<mediaobject>
<imageobject
><imagedata fileref="objecttree.png" format="PNG"/></imageobject>
<textobject
><phrase
>L'arborescence des objets</phrase
></textobject>
</mediaobject>
</screenshot>

<sect2 id="object-tree-selecting-object">
<title
>Sélection d'objets</title>
<para
>Dans une arborescence d'objets, vous pouvez sélectionner des objets. Une fois un objet sélectionné, ses attributs sont affichés dans la <link linkend="the-properties-view"
>vue des propriétés</link
> et dessinés en jaune dans les <link linkend="the-wireframe-views"
>vues fil de fer</link
>.</para>

<para
>Vous pouvez sélectionner plusieurs objets. Cependant, vous ne pouvez pas sélectionner un enfant d'un objet déjà sélectionné, car tous les enfants sont sélectionnés indirectement avec le parent.</para>

<para
>Si un seul objet est sélectionné, il est dorénavant référencé comme étant <quote
>l'objet actif</quote
>.</para>
</sect2>

<sect2 id="object-tree-add-objects">
<title
>Ajout d'objets</title>

<para
>Pour ajouter un nouvel objet à l'arborescence des objets, sélectionnez l'objet où vous voulez l'insérer, et cliquez sur l'icône de la barre d'outils, ou choisissez une entrée dans le menu <guimenu
>Insertion</guimenu
></para>

<para
>Il existe trois positions possibles pour un nouvel objet :</para>
<itemizedlist>
<listitem
><para
>En tant que premier enfant de l'objet actif</para
></listitem>
<listitem
><para
>En tant que dernier enfant de l'objet actif</para
></listitem>
<listitem
><para
>En tant qu'enfant de même parent</para
></listitem>
</itemizedlist>

<para
>S'il y a plusieurs position possible, le menu contextuel suivant vous demandera de choisir la bonne position :</para>

<screenshot>
<mediaobject>
<imageobject
><imagedata fileref="insertaspopup.png" format="PNG"/></imageobject>
<textobject
><phrase
>La fenêtre surgissante d'insertion de position</phrase
></textobject>
</mediaobject>
</screenshot>

</sect2>

<sect2 id="object-tree-remove-objects">
<title
>Suppression d'objets</title>
<para
>Pour supprimer des objets, sélectionnez-les, et choisissez <guimenuitem
>Supprimer</guimenuitem
> soit à partir du menu <guimenu
>Édition</guimenu
>, soit avec le menu contextuel du &BDS;.</para>
</sect2>

<sect2 id="object-tree-move-objects">
<title
>Déplacer des objets.</title>
<para
>Pour déplacer des objets, glissez-déposez les objets sélectionnés sur l'arborescence d'objets.</para>
<para
>Vous pouvez également couper un objet, et l'insérer à une nouvelle position</para>
</sect2>

</sect1>

<sect1 id="the-properties-view">
<title
>La vue des propriétés</title>

<para
>La vue des propriétés affiche les attributs de l'objet actif.</para>
<screenshot>
<mediaobject>
<imageobject
><imagedata fileref="objectpropertiesview.png" format="PNG"/></imageobject>
<textobject
><phrase
>La vue des propriétés</phrase
></textobject>
</mediaobject>
</screenshot>

<para
>Si vous avez changé des propriétés, cliquez le bouton <guibutton
>Appliquer </guibutton
> pour rendre les changements permanents. Si vous avez saisi des données non valables, une boîte de dialogue apparaîtra avec une description de l'erreur. Vous pourrez alors ajuster les propriétés et cliquer à nouveau sur le bouton <guibutton
>Appliquer</guibutton
>, ou annuler ces changements avec le bouton <guibutton
>Annuler</guibutton
>.</para>
<para
>Si vous avez paramétré le chemin vers votre documentation utilisateur de &Povray; dans <link linkend="configure-povray-tab"
>fenêtre de configuration</link
>, vous pouvez ouvrir la page de référence &Povray; pour l'objet affiché avec le bouton <guibutton
>Aide</guibutton
> </para
> 

<note
><para
>Vous avez besoin de la documentation utilisateur de &Povray; en HTML version 3.1g ou 3.5 pour utiliser cette fonctionnalité. Si votre distribution ne contient pas cette documentation, vous pouvez la télécharger <ulink url="ftp://ftp.povray.org/pub/povray/Old-Versions/Official-3.1g/Docs/povhtml.zip"
>ici</ulink
>. Le paquetage version 3.5 de &Povray; contient la documentation html.</para>
</note>

<para
>Si vous éditez une texture ou une partie d'une texture, vous pouvez la prévisualiser dans la vue des propriétés.</para>

<screenshot>
<mediaobject>
<imageobject
><imagedata fileref="texturepreview.png" format="PNG"/></imageobject>
<textobject
><phrase
>La vue des propiétés, prévisualisation de texture</phrase
></textobject>
</mediaobject>
</screenshot>

<para
>Actionnez le bouton <guibutton
>Prévisualisation</guibutton
> dans la vue des propriétés et une petit scène d'exemple avec la texture sélectionnée sera calculée. Par défaut, toute la texture sera dessinée, même si l'option « pas le haut » est sélectionnée. Si vous voulez dessiner seulement une partie de la texture (par exemple une texture à l'intérieur d'une texture map et non la texture map en entier), cochez la case <guilabel
>local</guilabel
>.</para>

</sect1>

<sect1 id="the-wireframe-views">
<title
>Les vues fil de fer</title>

<sect2 id="orthographic-views">
<title
>Les vues orthogonales</title>

<para
>Les vues fil de fer orthogonales affichent la scène comme une projection orthogonale suivant l'un des axes.</para>

<screenshot>
<mediaobject>
<imageobject
><imagedata fileref="topview.png" format="PNG"/></imageobject>
<textobject
><phrase
>La vue fil de fer du dessus</phrase
></textobject>
</mediaobject>
</screenshot>

<para
>Il y a six sortes de vues fil de fer orthogonales :</para>
<itemizedlist>
<listitem
><para
>Dessus</para
></listitem>
<listitem
><para
>Dessous</para
></listitem>
<listitem
><para
>Gauche</para
></listitem>
<listitem
><para
>Droite</para
></listitem>
<listitem
><para
>Face</para
></listitem>
<listitem
><para
>Arrière</para
></listitem>
</itemizedlist>

<para
>Chaque type affiche la scène avec une perspective différente.</para>

<sect3 id="graphical-change">
<title
>Changements d'attributs graphiques</title>
<para
>Dans les vues orthogonales, vous pouvez changer les propriétés des attributs des objets graphiquement avec la souris.</para>

<screenshot>
<mediaobject>
<imageobject
><imagedata fileref="controlpoints.png" format="PNG"/></imageobject>
<textobject
><phrase
>Les points de contrôle de l'objet caméra</phrase
></textobject>
</mediaobject>
</screenshot>

<para
>La capture d'écran ci-dessous montre les points de contrôle de la caméra. Vous pouvez bouger les points de contrôle pour modifier la position et la direction de la caméra.</para>

<para
>Si une transformation est sélectionnée, les points de contrôle sont enlevés et une petite croix est affichée dans la vue fil de fer. La croix marque le centre des agrandissements et des rotations, ainsi que la position pour les translations. Vous pouvez changer les transformations avec la souris en la déplaçant à l'intérieur de la vue.</para>

<para
>Certains objets comme les patches bicubiques gèrent la sélection et la modification de plusieurs points de contrôle.</para>

<informaltable>
<tgroup cols="2"
><tbody>
<row>
  <entry
>&BGS;</entry>
  <entry
>Sélectionnez un point de contrôle et désélectionnez tous les autres</entry>
</row>
<row>
  <entry
><keycombo action="click"
>&Ctrl; <mousebutton
> bouton gauche</mousebutton
></keycombo
> de la souris</entry>
  <entry
>Sélectionne ou désélectionne un point de contrôle.</entry>
</row>
<row>
  <entry
><keycombo action="click"
>&Maj;<mousebutton
>bouton gauche</mousebutton
></keycombo
> de la souris</entry>
  <entry
>Dessine un rectangle dans la vue. Tous les points de contrôle à l'intérieur de ce rectangle seront sélectionnés, les autres seront désélectionnés</entry>
</row>
<row>
  <entry
>Bouton <keycombo action="click"
>&Maj;&Ctrl;<keycap
>gauche</keycap
></keycombo
> de la souris</entry>
  <entry
>Dessine un rectangle dans la vue, tous les points de contrôle à l'intérieur de ce rectangle seront sélectionnés</entry>
</row>
</tbody
></tgroup>
</informaltable>

</sect3>

<sect3 id="display-window-selection">
<title
>Sélection de l'affichage d'une fenêtre</title>
<para
>Vous pouvez zoomer et translater la vue pour changer l'affichage de la fenêtre.</para>
<informaltable>
<tgroup cols="2"
><tbody>
<row>
  <entry
>&BCS;</entry>
  <entry
>Translater la vue</entry>
</row>
<row>
  <entry
><mousebutton
>roue</mousebutton
></entry>
  <entry
>Zoome la vue en fonction de la position de la souris</entry>
</row>
<row>
  <entry
><keycap
>Gauche</keycap
>, <keycap
>Droite</keycap
>, <keycap
>Haut</keycap
>, <keycap
>Bas</keycap
> </entry>
  <entry
>Translater la vue</entry>
</row>
<row>
  <entry
><keycombo action="simul"
>&Ctrl;<keycap
>Left</keycap
></keycombo
>, <keycombo action="simul"
>&Ctrl;<keycap
>Right</keycap
></keycombo
></entry>
  <entry
>Zoome la vue</entry>
</row>
</tbody
></tgroup>
</informaltable>

</sect3>

</sect2>

<sect2 id="camera-view">
<title
>La vue Caméra</title>

<para
>La vue caméra affiche la scène du point de vue de la caméra.</para>

<screenshot>
<mediaobject>
<imageobject
><imagedata fileref="cameraview.png" format="PNG"/></imageobject>
<textobject
><phrase
>La vue caméra</phrase
></textobject>
</mediaobject>
</screenshot>

<para
>La boîte bleue affiche le champ de la vue quand la scène est calculée.</para>

<para
>Vous ne pouvez pas changer les points de contrôle dans la vue caméra.</para>

</sect2>

<sect2 id="visibility-levels">
<title
>Niveaux de Visibilité</title>

<para
>Par défaut tous les objets sont affichés dans les vues fil de fer.</para>
<para
>Chaque objet des vues fil de fer possède un niveau de visibilité. Vous pouvez spécifier un niveau de visibilité relatif au niveau de visibilité de l'objet parent, ou une valeur absolue. Les objets ne sont affichés que s'ils sont sélectionnés ou que leur niveau de visibilité est plus petit ou égal au niveau de visibilité de la scène dans la barre d'outils.</para>

</sect2>

</sect1>


<sect1 id="view-layouts">
<title
>Disposition des Vues</title>

<para
>&kpovmodeler; fournit une disposition des vues par défaut : l'arborescence des objets et la vue des propriétés des objets sur la gauche et les quatre vues graphique sur la droite.</para>

<para
>Si vous n'aimez pas la disposition par défaut, ou que vous avez besoin d'une autre disposition, vous pouvez librement en configurer un nouvelle. Vous pouvez même enregistrer plusieurs dispositions, et passer de l'une a l'autre à la volée.</para>

<sect2 id="change-the-view-layout">
<title
>Modifier la Disposition des Vues</title>

<para
>Vous pouvez déplacer les vues existantes glissant la barre en haut de chaque vue ou vous voulez.</para>

<screenshot>
<mediaobject>
<imageobject
><imagedata fileref="dockwidget.png" format="PNG"/></imageobject>
<textobject
><phrase
>La poignée d'attache du tableau de bord</phrase
></textobject>
</mediaobject>
</screenshot>

<para
>Pour attacher un élément graphique à une vue existante, glissez la poignée d'attache au sommet ou au bas de la vue. Un rectangle vous indiquera la nouvelle position.</para>
<para
>Pour créer une nouvelle colonne, glissez la poignée d'attache à la droite ou à la gauche d'une vue. Les vues s'étaleront alors sur toute la hauteur de la fenêtre.</para>
<para
>Si vous voulez que plusieurs vues partagent le même espace de travail, glissez la poignée d'attache d'une vue au centre d'une autre vue. Vous pourrez ensuite passer de l'une à l'autre en cliquant sur l'onglet correspondant au sommet des vues.</para>

<screenshot>
<mediaobject>
<imageobject
><imagedata fileref="dockwidgettab.png" format="PNG"/></imageobject>
<textobject
><phrase
>La disposition de vue tabulaire</phrase
></textobject>
</mediaobject>
</screenshot>

<para
>La dernière possibilité de disposition est d'avoir des vues flottantes : les vues ne sont pas attachées dans la vue principale. Pour détacher une vue, glissez la poignée d'attache sur le bureau de travail ou pressez la petite flèche qui pointe vers le coté haut-gauche.</para>

<para
>Pour fermer une vue, cliquez la petite croix dans la barre de vue. Pour empêcher la fermeture d'une fenêtre, cliquez sur le petit bouton entre la flèche et la croix.</para>

<para
>Vous pouvez ajouter des vues supplémentaires à votre vue principale. Le menu <guimenu
>Affichage</guimenu
> contient une entrée pour chaque type de vue. Les nouvelles vues seront placées au hasard, vous pourrez ensuite les déplacer où vous voulez.</para>

</sect2>

<sect2 id="save-a-view-layout">
<title
>Enregistrer la disposition des vues</title>

<para
>Vous pouvez enregistrer la disposition courante avec le menu <menuchoice
> <guimenu
>Affichage</guimenu
> <guimenuitem
>Enregistrer la disposition des vues...</guimenuitem
> </menuchoice
>. Une boîte de dialogue vous laissera le choix de sélectionner une disposition existante, ou d'en créer une nouvelle.</para>

<para
>Vous pouvez alors ajuster finement la disposition de vue dans la boîte de dialogue <link linkend="configure-view-layout-tab"
>paramétrages</link
>. </para>
</sect2>

<sect2 id="switching-between-view-layout">
<title
>Alterner les dispositions des vues</title>
<para
>Vous pouvez passer à une disposition de vue enregistrée en sélectionnant le menu <menuchoice
><guimenu
>Affichage</guimenu
><guimenuitem
>Disposition des vues</guimenuitem
></menuchoice
></para>

</sect2>

</sect1>

</chapter>


<chapter id="povray-interaction">
<title
>Interaction avec &Povray;</title>

<sect1 id="rendering-the-scene">
<title
>Calculer la scène</title>

<para
>Une fois que vous avez créé une scène, vous voudrez la dessiner. &kpovmodeler; utilise &Povray; 3.1g pour calculer la scène, donc vous avez besoin d'une installation correcte de &Povray;. Au moment de l'écriture de ce document, &Povray; 3.5 est paru. Cette version n'est pas gérée par &kpovmodeler; version 1.0.</para>
<para
>Allez à l'adresse <ulink url="http://www.povray.org"
>www.povray.org</ulink
> pour télécharger une version de &Povray; ainsi que les instructions d'installation.</para>

<para
>Pour calculer la scène courante, actionnez l'icône de calcul du rendu <inlinemediaobject
> <imageobject
><imagedata fileref="rendericon.png" format="PNG"/></imageobject
> <textobject
><phrase
>L'icône de calcul du rendu</phrase
></textobject
> </inlinemediaobject
> dans la barre d'outils, ou sélectionnez l'entrée du menu <menuchoice
><guimenu
>Affichage</guimenu
><guimenuitem
>Rendu</guimenuitem
></menuchoice
>.</para>

<sect2 id="render-modes">
<title
>Modes de calcul du rendu</title>

<para
>Un mode de rendu est similaire à une entrée des fichier ini de &Povray;. Il spécifie la taille de l'image, les niveaux de qualité pour le calcul. Si vous voulez calculer une scène avec différents niveaux de qualité, ainsi que différentes tailles, vous pouvez ajouter autant de modes de rendu que vous le souhaitez, allant d'une rapide prévisualisation à des images plein écran de haute résolution, et avec un grand niveau de qualité.</para>

<sect3 id="render-modes-configuration">
<title
>Configuration des modes de calcul du rendu</title>

<para
>Quand vous actionnez l'icône de paramétrage du calcul de rendu <inlinemediaobject
> <imageobject
><imagedata fileref="rendersettingsicon.png" format="PNG"/></imageobject
> <textobject
><phrase
>Modes de rendu</phrase
></textobject
> </inlinemediaobject
> dans la barre d'outils ou que vous sélectionnez le menu <menuchoice
><guimenu
>Vue</guimenu
><guimenuitem
>Modes de rendu...</guimenuitem
></menuchoice
>, La boîte de dialogue suivante s'ouvrira :</para>

<screenshot>
<mediaobject>
<imageobject
><imagedata fileref="rendermodesselection.png" format="PNG"/></imageobject>
<textobject
><phrase
>La boîte de dialogue de sélection des modes de rendu</phrase
></textobject>
</mediaobject>
</screenshot>

<para
>La première boîte de dialogue vous affiche une liste de tous les modes de rendu disponible.</para>

<variablelist>

<varlistentry
><term
><guibutton
>Ajouter</guibutton
></term>
<listitem
><para
><action
>Ajoute un mode de rendu par défaut dans la liste</action
>.</para>
</listitem>
</varlistentry>

<varlistentry
><term
><guibutton
>Supprimer</guibutton
></term>
<listitem
><para
><action
>Enlève le mode de rendu sélectionné de la liste</action
>.</para>
</listitem>
</varlistentry>

<varlistentry
><term
><guibutton
>Édition</guibutton
></term>
<listitem
><para
><action
>Ouvre une boîte de dialogue pour éditer le mode de rendu sélectionné</action
>.</para>
</listitem>
</varlistentry>

<varlistentry
><term
><guibutton
>Monter</guibutton
></term>
<listitem
><para
><action
>Déplace le mode de rendu sélectionné d'une position vers le haut</action
>.</para>
</listitem>
</varlistentry>

<varlistentry
><term
><guibutton
>Descendre</guibutton
></term>
<listitem
><para
><action
>Déplace le mode de rendu sélectionné d'une position vers le bas</action
>.</para>
</listitem>
</varlistentry>

</variablelist>

<para
>Le bouton <guibutton
>Édition</guibutton
> ouvre la boîte de dialogue de configuration suivante :</para>

<screenshot>
<mediaobject>
<imageobject
><imagedata fileref="rendermodesize.png" format="PNG"/></imageobject>
<textobject
><phrase
>L'onglet « Taille » des modes de rendu</phrase
></textobject>
</mediaobject>
</screenshot>

<para
>Chaque mode de rendu a une description. Vous pouvez saisir n'importe quelle description, mais elle doit refléter les propriétés du mode de rendu.</para>

<para
>Dans l'onglet <guilabel
>Taille</guilabel
>, vous pouvez saisir la largeur et la hauteur de l'image calculée. Si vous ne voulez calculer qu'une petite partie de l'image, cochez la case <guilabel
>Sous-sélection</guilabel
> et saisissez la partie de l'image à calculer dans les champs ci-dessous.</para>

<screenshot>
<mediaobject>
<imageobject
><imagedata fileref="rendermodequality.png" format="PNG"/></imageobject>
<textobject
><phrase
>L'onglet « Qualité » des modes de rendu</phrase
></textobject>
</mediaobject>
</screenshot>

<para
>Dans l'onglet <guilabel
>Qualité</guilabel
>, vous pouvez sélectionner plusieurs niveaux de qualité pour les images à calculer.</para>

<para
>Dans la liste déroulante <guilabel
>Qualité</guilabel
>, vous pouvez sélectionner les fonctionnalités que &Povray; utilisera pour les calculs. Les possibilités vont d'un simple modèle de coloration et d'illumination, à des modèles très complexes avec éclairage avec inter-réflexion et diffusion. Consultez le manuel de &Povray; pour une description détaillée des caractéristiques de rendu.</para>

<para
>Si une image est calculée avec un seul échantillon par pixel, plusieurs erreurs peuvent survenir. Ces images ont souvent du moirage ou des effets de crénelage dans les courbes et les lignes, et des détails peuvent être perdus si leur apparence est plus petite qu'un pixel. Cet effet est appelé : <quote
>crénelage</quote
>.</para>

<para
>&Povray; utilise une technique appelée <quote
>anticrénelage</quote
> pour réduire l'impacte de ces erreurs. En général, les images apparaîtront plus lisse avec cette option.</para>

<para
>Si vous activez l'anticrénelage, &Povray; calculera et combinera plus d'un échantillon par pixel. Ceci est appelé le <quote
>superéchantillonage</quote
></para>

<para
>&Povray; supporte deux méthodes de superéchantillonnage. La première est une méthode adaptative non-récursive ; <quote
>adaptative</quote
> parce que le superéchantillonnage dépend de l'entourage direct du pixel calculé. Tous les pixels ne sont pas échantillonnés avec cette méthode. La seconde méthode est une méthode adaptative récursive ; <quote
>récursive</quote
> car chaque pixel est divisé et subdivisé récursivement, et <quote
>adaptative</quote
> car la profondeur de récursivité dépend de la valeur de la couleur calculée.</para>

<para
>Quand vous sélectionnez la première méthode, &Povray; lance un rayon par pixel. Si la différence de couleur entre la valeur de ce pixel et celle de ses voisins dépasse un certain seuil, chacun des pixels est superéchantilonné en lançant un nombre fixe de rayons supplémentaires. Si vous réglez la profondeur à une valeur de 4, une grille de 4x4 points sera calculée, une valeur de 5 résultera en une grille de 5x5 (25) échantillons par pixel.</para>

<para
>La différence entre deux pixels est calculée comme suit : r<subscript
>1</subscript
>, g<subscript
>1</subscript
> et b<subscript
>1</subscript
> sont les valeurs de rouge, vert et bleu du premier pixel ; r<subscript
>2</subscript
>, g<subscript
>2</subscript
> et b<subscript
>2</subscript
> sont les valeurs de rouge, vert et bleu du second pixel. La différence est alors : </para>
<para
>diff = abs(r<subscript
>1</subscript
>-r<subscript
>2</subscript
>) + abs(g<subscript
>1</subscript
>-g<subscript
>2</subscript
>) + abs(b<subscript
>1</subscript
>-b<subscript
>2</subscript
>)</para>

<para
>La méthode récursive commence avec 4 échantillons par pixel. Si la valeur de couleur résultante dépasse un certain seuil, le pixel est subdivisé en 4 sous pixels qui sont tracés séparément, et testé pour une prochaine sous-division. Vous pouvez spécifier la profondeur de récursivité maximum avec la valeur de profondeur.</para>

<para
>Une méthode additionnelle pour réduire les effets de crénelage consiste à ajouter du « bruit » au processus d'échantillonage, appelée <quote
>jittering</quote
>. Si vous activez le jittering, &Povray; va modifier légèrement l'échantillon pour réduire le nombre de motifs de couleur régulier.</para>

<para
>Le dernier paramètre de qualité est la radiosité. La radiosité est une fonctionnalité expérimentale de &Povray; qui calcule les réflexion de lumière inter-diffuse. Soyez patient quand vous calculez une scène avec cette option.</para>

<screenshot>
<mediaobject>
<imageobject
><imagedata fileref="rendermodeoutput.png" format="PNG"/></imageobject>
<textobject
><phrase
>L'onglet des modes de rendu</phrase
></textobject>
</mediaobject>
</screenshot>

<para
>Dans le dernier onglet, vous pouvez configurer si vous voulez qu'un canal alpha soit calculé par &Povray;. Un pixel sera alors transparent si le rayon correspondant ne rencontre aucun objet.</para>

</sect3>

<sect3 id="choosing-a-render-mode">
<title
>Choisir un mode de rendu</title>

<para
>Vous pouvez sélectionner le mode de rendu dans la liste déroulante dans la barre d'outils de calcul de rendu.</para>

<screenshot>
<mediaobject>
<imageobject
><imagedata fileref="rendermodestoolbar.png" format="PNG"/></imageobject>
<textobject
><phrase
>La barre d'outils des modes de rendu</phrase
></textobject>
</mediaobject>
</screenshot>

</sect3>

</sect2>

<sect2 id="the-render-window">
<title
>La fenêtre de rendu</title>

<para
>Quand vous lancez le calcul d'une scène, cette fenêtre s'ouvrira :</para>

<screenshot>
<mediaobject>
<imageobject
><imagedata fileref="renderwindow.png" format="PNG"/></imageobject>
<textobject
><phrase
>La fenêtre de rendu</phrase
></textobject>
</mediaobject>
</screenshot>

<para
>Elle affiche l'image calculée, la progression et la vitesse de calcul actuelle.</para>

<variablelist>

<varlistentry
><term
><guibutton
>Arrêter</guibutton
></term>
<listitem
><para
><action
>Arrêter &Povray;</action
>.</para>
</listitem>
</varlistentry>

<varlistentry
><term
><guibutton
>Suspendre</guibutton
></term>
<listitem
><para
><action
>Suspendre le calcul de rendu</action
>.</para>
</listitem>
</varlistentry>

<varlistentry
><term
><guibutton
>Reprendre</guibutton
></term>
<listitem
><para
><action
>Reprendre le calcul de rendu</action
>.</para>
</listitem>
</varlistentry>

<varlistentry
><term
><guibutton
>Résultat de Povray...</guibutton
></term>
<listitem
><para
><action
>Ouvre une autre fenêtre qui affiche les messages de la console &Povray;</action
>. Si &Povray; se termine anormalement, vous pouvez trouver la raison dans cette fenêtre.</para>
</listitem>
</varlistentry>

<varlistentry
><term
><guibutton
>Enregistrer...</guibutton
></term>
<listitem
><para
><action
>Vous permet de sauvegarder l'image quand elle est calculée.</action
></para>
</listitem>
</varlistentry>

<varlistentry
><term
><guibutton
>Fermeture</guibutton
></term>
<listitem
><para
><action
>Ferme la fenêtre de calcul de rendu</action
>.</para>
</listitem>
</varlistentry>

</variablelist>

</sect2>

</sect1>

<sect1 id="exporting-and-importing-povray">
<title
>Exportation et Importation</title>

<sect2 id="exporting-and-importing-a-whole-scene">
<title
>Exportation et Importation d'un scène entière</title>

<para
>Vous pouvez exporter une scène vers &Povray; avec le menu <menuchoice
><guimenu
>Fichier</guimenu
><guimenuitem
>Exporter...</guimenuitem
></menuchoice
>.</para>
<para
>La boîte de dialogue de sauvegarde de fichier vous permettra de choisir le nom et l'endroit ou enregistrer votre fichier.</para>
<note
><para
>&kpovmodeler; ajoutera automatiquement l'extension <literal role="extension"
>.pov</literal
>.</para
></note>

<para
>Pour importer une scène &Povray;, sélectionnez le menu <menuchoice
><guimenu
>Fichier</guimenu
><guimenuitem
>Importer...</guimenuitem
></menuchoice
> et choisissez un fichier dans la boîte de dialogue.</para>

<note
><para
>Toute la syntaxe de &Povray; n'est pas gérée par &kpovmodeler; pour le moment. S'il y a des erreurs ou des alertes durant l'importation, une boîte de dialogue vous montrera la liste des messages.</para
></note>

<tip
><para
>Si vous voulez importer du code de &Povray; non géré par &kpovmodeler; modifiez les sources avec ces deux commentaires spéciaux <quote
>//*PMRawBegin</quote
> et <quote
>//*PMRawEnd</quote
>.</para
></tip>

</sect2>

<sect2 id="exporting-and-importing-single-objects">
<title
>Exportation et Importation d'un seul objet</title>

<para
>Vous pouvez glisser des objets de l'arborescence d'objets vers un éditeur de texte pour exporter le code &Povray;. Cela insérera le code des objets dans le fichier texte courant de votre éditeur de texte. Pour importer des objets dans la scène, sélectionnez simplement le code dans votre éditeur de texte, et glissez-le dans l'arborescence d'objets.</para>
<para
>Vous pouvez utiliser les fonctionnalités de copier/coller de &kpovmodeler; et de votre éditeur de texte pour échanger du code &Povray;.</para>

</sect2>

</sect1>

</chapter>


<chapter id="customizing">
<title
>Configuration de &kpovmodeler;</title>

<sect1 id="configure-povray-tab">
<title
>L'onglet <guilabel
>Povray</guilabel
></title>

<sect2 id="configure-povray-command">
<title
><guilabel
>Commande Povray</guilabel
></title>

<para
>La commande povray est appelée quand &kpovmodeler; calcule une scène. Les commandes courantes sont <quote
>povray</quote
> ou <quote
>x-povray</quote
>.</para>

</sect2>

<sect2 id="configure-povray-documentation">
<title
><guilabel
>Documentation utilisateur de Povray</guilabel
></title>

<para
>Si vous pressez le bouton <guibutton
>Aide</guibutton
> dans la vue propriétés, &kpovmodeler; ouvre la documentation utilisateur de &Povray; pour les objets affichés. Paramétrez ici le chemin vers votre documentation ainsi que la version de documentation. Les versions gérées sont 3.1g et 3.5.</para>

</sect2>

<sect2 id="configure-povray-library-paths">
<title
><guilabel
>Chemin des Bibliothèques</guilabel
></title>

<para
>&Povray; cherche des fichiers externes (hauteur de champs de données par exemple) dans les chemins de bibliothèques de &Povray;. Si vous faites référence à des fichiers qui ne sont pas dans le dossier de la scène, vous devez l'ajouter à la liste. Si un fichier existe dans plusieurs chemins de bibliothèque, ce sera celui dans le premier chemin de la liste qui sera utilisé.</para>
<para
>Vous pouvez changer l'ordre avec les boutons <guibutton
>Monter</guibutton
> et <guibutton
>Descendre</guibutton
>.</para>

</sect2>

</sect1>

<sect1 id="configure-graphical-view-tab">
<title
>L'onglet <guilabel
>Vue graphique</guilabel
></title>

<sect2 id="configure-colors">
<title
><guilabel
>Couleurs</guilabel
></title>

<para
>L'onglet Couleurs vous permet de configurer les couleurs utilisées pour les vues graphiques.</para>

<variablelist>

<varlistentry>
<term
><guilabel
>Fond :</guilabel
></term>
<listitem
><para
>Couleur du fond.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Maillage :</guilabel
></term>
<listitem
><para
>Les couleurs pour les maillages. La deuxième couleur est utilisée si l'objet est sélectionné.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Points de contrôle :</guilabel
></term>
<listitem
><para
>La couleur des points de contrôle. La deuxième couleur est utilisée si le point de contrôle est sélectionné.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Axes :</guilabel
></term>
<listitem
><para
>Les couleurs pour les axes x, y et z.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Champs de vue :</guilabel
></term>
<listitem
><para
>La couleur des champs de vue rectangle dans la vue caméra et les étiquettes de type de vue.</para
></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="configure-grid">
<title
>La grille</title>

<para
>Cette page vous permet de configurer la grille dans les vues fil de fer.</para>

<sect3 id="configure-displayed-grid">
<title
><guilabel
>Grille affichée</guilabel
></title>

<variablelist>

<varlistentry>
<term
><guilabel
>Couleur :</guilabel
></term>
<listitem
><para
>La couleur de grille.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Distance :</guilabel
></term>
<listitem
><para
>La distance minimale entre deux lignes de grille.</para
></listitem>
</varlistentry>

</variablelist>

</sect3>

<sect3 id="configure-control-point-grid">
<title
><guilabel
>Grille des points de contrôle.</guilabel
></title>

<para
>Vous pouvez ajuster les points de contrôle sur la grille avec le menu contextuel des vues fil de fer. Ici, vous pouvez configurer la grille pour des translations, agrandissements et rotations séparément.</para>

</sect3>

</sect2>

<sect2 id="configure-detail-levels">
<title
><guilabel
>Objets</guilabel
></title>

<sect3 id="configure-object-subdivisions">
<title
><guilabel
>Subdivisions</guilabel
></title>

<para
>Vous pouvez configurer les niveaux de détails de différents objets ici.</para>

<para
>De grandes valeurs aboutiront à un maillage plus fin et donc une meilleure approximation pour les objets affichés, mais cela ralenti le calcul de rendu. Pour certains objets tels que les sphères vous pouvez configurer le niveau de détail pour deux directions séparément.</para>

</sect3>

<sect3 id="configure-object-sizes">
<title
><guilabel
>Tailles</guilabel
></title>

<para
>Vous permet de configurer la taille d'affichage des objets infinis dans les vues fil de fer.</para>

</sect3>

<sect3 id="configure-camera-views">
<title
><guilabel
>Vues caméra</guilabel
></title>

<para
>Si vous cochez la case <guilabel
>Détails élevés pour des projections améliorées</guilabel
>, toutes les lignes du maillage sont subdivisées si la caméra utilise une projection améliorée. Les projections améliorées sont toutes les projections sauf les projections en perspective et orthogonale. Cette fonctionnalité améliore grandement les approximations de ces projections mais ralentit le calcul de rendu.</para>

</sect3>

</sect2>

</sect1>

<sect1 id="configure-dialog-view-tab">
<title
>L'onglet <guilabel
>Vue des propriétés</guilabel
></title>

<sect2 id="configure-texture-preview">
<title
><guilabel
>Prévisualisation de la texture</guilabel
></title>

<para
>Cette page vous permet de configurer la prévisualisation de texture dans la vue propriétés.</para>

<variablelist>

<varlistentry>
<term
><guilabel
>Taille</guilabel
></term>
<listitem
><para
>La taille de l'image de prévisualisation.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Gamma :</guilabel
></term>
<listitem
><para
>La correction Gamma.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Objets calculés</guilabel
></term>
<listitem
><para
>Définit la petite scène d'exemple. Au moins un objet doit être sélectionné.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Mur</guilabel
></term>
<listitem
><para
>Si la case <guilabel
>Activer le mur</guilabel
> est cochée, un mur sera calculé derrière les objets. Le mur aura pour texture un motif quadrillé avec deux couleurs configurables.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Sol</guilabel
></term>
<listitem
><para
>Si la case <guilabel
>Activer le sol</guilabel
> est cochée, un sol sera calculé en dessous des objets. Le sol aura pour texture un motif quadrillé avec deux couleurs configurables.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Anticrénelage</guilabel
></term>
<listitem
><para
>Si la case <guilabel
>Appliquer l'anticrénelage</guilabel
> est cochée, la méthode d'anticrénelage non-récursive sera utilisé pour calculer la scène. Vous pouvez configurer la profondeur et les valeurs seuil. Allez voir la <link linkend="render-modes-configuration"
>section des modes de rendu</link
> pour une description détaillé des paramètres.</para
></listitem>
</varlistentry>

</variablelist>

</sect2>

</sect1>

<sect1 id="configure-view-layout-tab">
<title
>L'onglet <guilabel
>Disposition de Vues</guilabel
></title>

<para
>Dans cette page, vous pouvez régler finement des dispositions de vue existante, ou en créer de nouvelles. Allez voir la section <link linkend="view-layouts"
>Disposition de Vues</link
> pour savoir comment créer et enregistrer des dispositions de vue.</para>

<sect2 id="configure-default-layout">
<title
>La disposition de vues par défaut</title>

<para
>La liste déroulante <guilabel
>Disposition de vue par défaut :</guilabel
> liste toutes les dispositions de vue disponibles. &kpovmodeler; utilisera la disposition de vue sélectionnée au démarrage du programme.</para>

</sect2>

<sect2 id="configure-list-of-view-layouts">
<title
>Listes des dispositions de vues</title>

<para
>La liste <guilabel
>Dispositions de vues disponibles</guilabel
> montre toutes les dispositions de vue disponibles. Vous pouvez ajouter une nouvelle disposition de vue avec le bouton <guibutton
>Ajouter</guibutton
> et supprimer la disposition sélectionnée avec le bouton <guibutton
>Supprimer</guibutton
>.</para>
<para
>La disposition de vue sélectionnée est affichée dans la boîte <guilabel
>Disposition de vues</guilabel
></para>
</sect2>

<sect2 id="configure-view-layout-details">
<title
>Détails de la disposition de vue</title>

<para
>Chaque disposition de vue est identifiée par son nom. Le nom doit être unique et ne doit pas être vide.</para>

<para
>La liste ci-dessous affiche les noms de toutes les vues pour la disposition de vues sélectionnée. Vous pouvez ajouter une nouvelle vue avec le bouton <guibutton
>Ajouter</guibutton
> et enlever la vue sélectionnée avec le bouton <guibutton
>Supprimer</guibutton
>.</para>

<para
>Les attributs des vues sont :</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Type :</guilabel
></term>
<listitem>
<para
>Le type de vue. Allez voir <link linkend="the-interface"
>l'interface &kpovmodeler;</link
> pour une description de chaque type de vue.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Type de vue 3D :</guilabel
></term>
<listitem>
<para
>La projection pour les vues fil de fer. Vous pouvez choisir une des six projections orthogonales ou le mode caméra.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Position du tableau de bord :</guilabel
></term>
<listitem>
<para
>La position de la vue. <guilabel
>Nouvelle Colonne</guilabel
> créera une nouvelle colonne à la droite des vues précédentes, <guilabel
>En Dessous</guilabel
> attachera la vue en dessous de la vue précédente, <guilabel
>Tabulaire</guilabel
> créera une vue tabulaire en prenant en compte les autres vues, et <guilabel
>Flottante</guilabel
> n'attachera pas la vue dans la fenêtre principale, mais créera une fenêtre séparée.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Largeur de colonne :</guilabel
></term>
<listitem>
<para
>La largeur de colonne en pourcentage de la largeur de la vue principale.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Hauteur de vue :</guilabel
></term>
<listitem>
<para
>La hauteur de vue en pourcentage de la hauteur de la vue principale.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Largeur :</guilabel
> et <guilabel
>Hauteur :</guilabel
></term>
<listitem>
<para
>La taille en pixels pour des vues mobiles</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Position x :</guilabel
> et <guilabel
>y :</guilabel
></term>
<listitem>
<para
>La position du bureau pour des vues mobiles.</para>
</listitem>
</varlistentry>

</variablelist>

</sect2>

</sect1>

</chapter>

<chapter id="basic-tutorial">
<title
>Tutoriel de base : créer votre première scène</title>

<para
>Bon, vous venez juste d'installer &Povray; et &kpovmodeler; et vous voulez déjà commencer à créer une scène sans aucune connaissance de ces logiciels. Voici comment débuter : si vous suivez les étapes de ce tutoriel, vous serez capable de créer la scène la plus répandue parmi les débutants : une sphère au-dessus d'un plan.</para>

<screenshot>
<mediaobject>
<imageobject
><imagedata fileref="tutorial01-final-render.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>

<para
>À n'importe quel moment, vous pouvez lancer le calcul de la scène en utilisant une de ces méthodes :</para>

<para
>En utilisant le menu : <menuchoice
><guimenu
>Affichage</guimenu
><guimenuitem
>Calcul du Rendu</guimenuitem
></menuchoice
></para>
<para
>En utilisant la barre d'outils : cliquez sur l'icône <inlinemediaobject
> <imageobject
><imagedata fileref="cr22-action-pmrender.png" format="PNG"/></imageobject
> </inlinemediaobject
></para>

<para
>Mais vous devez prendre en considération ces avertissements avant de vous plaindre si vous n'obtenez qu'un écran noir. Si c'est la première fois que vous utilisez un logiciel de 3D, faites attention à ces règles d'or :</para>

<itemizedlist>
<listitem
><para
>Si vous ne créez pas de caméra, aucune règle ne s'appliquera au moteur de calcul de rendu, et donc il ne pourra rien calculer. Le résultat sera une image noire.</para
></listitem>
<listitem
><para
>Si vous ne créez pas de source de lumière, toute votre scène sera sombre, et le résultat sera une image noire.</para
></listitem>
<listitem
><para
>Les objets pour lesquels aucune texture n'a été définie n'apparaîtront pas dans l'image calculée.</para
></listitem>
</itemizedlist>

<sect1 id="basic-tutorial-step-1">
<title
>Étape 1 : lancez &kpovmodeler;</title>

<para
>Si tout est installé convenablement, une fois &kpovmodeler; chargé, vous découvrirez les paramètres par défaut des fenêtres suivant :</para>

<screenshot>
<mediaobject>
<imageobject
><imagedata fileref="defaultviewlayout.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Prenez quelques minutes pour explorer les menus et icônes disponibles. Si vous avez du temps, lisez également la documentation histoire de vous faire une idée de ce que peut vous apporter ce logiciel.</para>

<itemizedlist>
<listitem>
<para
><link linkend="menu-reference"
>Barres de menus (1)</link
></para>
</listitem>
<listitem>
<para
>Barres d'outils (2)</para>
</listitem>
<listitem>
<para
><link linkend="the-object-tree"
>L'arborescence des objets (3)</link
></para>
</listitem>
<listitem>
<para
><link linkend="the-properties-view"
>Vue des propriétés des objets (4)</link
></para>
</listitem>
<listitem>
<para
><link linkend="the-wireframe-views"
>Vues de la caméra et en mode fil de fer (5)</link
></para>
</listitem>
</itemizedlist>

<para
>Vous aurez besoin d'utiliser chacun d'eux intensivement maintenant, donc gardez-les en mémoire.</para>

<para
>&kpovmodeler; démarre avec une scène simple. Pour suivre ce tutoriel, vous devez tout d'abord supprimer tous les objets de l'arborescence d'objets. Sélectionnez la scène et choisissez le menu <menuchoice
><guimenu
>Édition</guimenu
><guimenuitem
>Supprimer</guimenuitem
></menuchoice
>. Vous devriez avoir maintenant une scène vide.</para>

</sect1>

<sect1 id="basic-tutorial-step-2">
<title
>Étape 2 : créer la Caméra</title>

<para
>La première chose sera de créer un caméra. Pour se faire, vous avez deux moyens à votre disposition :</para>
<para
>En utilisant le menu : <menuchoice
><guimenu
>Insertion</guimenu
><guimenuitem
>Caméra</guimenuitem
></menuchoice
></para>
<para
>En utilisant la barre d'outils : cliquez sur l'icône <inlinemediaobject
> <imageobject
><imagedata fileref="cr22-action-pmcamera.png" format="PNG"/></imageobject
> </inlinemediaobject
></para>

<para
>Les vues fil de fer montrent comment la caméra est réglée au regard de la scène. En particulier, nous pouvons maintenant voir quelque chose dans les quatre vues fil de fer. En bas à droite, il s'agit de la vue du point de vue de la caméra. C'est ce que nous verrons vraiment quand nous lancerons le calcul de la scène.</para>

<screenshot>
<mediaobject>
<imageobject
><imagedata fileref="tutorial01-camera-graphic.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>L'arborescence d'objets affiche maintenant une nouvelle entrée, nommée <quote
>Caméra</quote
>. Si vous cliquez dessus, cela affectera le contenu de la vue des propriétés de l'objet, où l'on peut trouver plusieurs paramètres associés à la caméra. Il peut être utile de faire référence à la documentation de &Povray; pour en savoir plus sur ces paramètres.</para>

<screenshot>
<mediaobject>
<imageobject
><imagedata fileref="tutorial01-camera-dialog.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Nous ne changerons rien au paramétrage de base de la caméra, ce sera le contenu d'autres tutoriels, mais veuillez noter que dans les vues graphiques, la caméra a des points de contrôle qui vous permettent de modifier la direction dans laquelle pointe la caméra. Pour cela cliquez simplement sur ces points et déplacez-les où vous le désirez.</para>

</sect1>

<sect1 id="basic-tutorial-step-3">
<title
>Étape 3 : créer une source de lumière</title>

<para
>De la même façon que nous avons créé la caméra, nous allons à présent créer une source de lumière :</para>
<para
>En utilisant le menu : <menuchoice
><guimenu
>Insertion</guimenu
><guimenuitem
>Lumière</guimenuitem
></menuchoice
></para>
<para
>En utilisant la barre d'outils : cliquez sur l'icône <inlinemediaobject
> <imageobject
><imagedata fileref="cr22-action-pmlight.png" format="PNG"/></imageobject
> </inlinemediaobject
></para>

<para
>Une nouvelle entrée apparaît maintenant dans l'arborescence d'objet. Si vous cliquez sur l'entrée de la source de lumière. La vue des propriétés change pour afficher les paramètres disponibles de la source de lumière. Nous changerons quelques paramètres pour que la source de lumière se trouve au-dessus de l'horizon (<guilabel
>y</guilabel
>=3), et un peu sur la droite (<guilabel
>x</guilabel
>=1) et en avant plan (<guilabel
>z</guilabel
>=1). Nous pouvons aussi renommer la source de lumière (<guilabel
>Nom</guilabel
>=<quote
>Lumière principale</quote
>). Modifiez les valeurs dans la vue propriétés de l'objet comme suit :</para>

<screenshot>
<mediaobject
><imageobject
><imagedata fileref="tutorial01-light-dialog.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Une fois que vous avez actionné le bouton <guilabel
>Appliquer</guilabel
> (ou tapé Entrée), la vue fil de fer et l'arborescence d'objet change immédiatement pour refléter ces modifications, et voici ce que devrait voir la caméra.</para>

<screenshot>
<mediaobject
><imageobject
><imagedata fileref="tutorial01-light-graphic.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

</sect1>

<sect1 id="basic-tutorial-step-4">
<title
>Étape 4 : créer le sol</title>
<para
>Il existe plusieurs manières de créer un sol pour notre scène. Une méthode pourrait être d'insérer un objet boîte (<menuchoice
><guimenu
>Insertion</guimenu
><guisubmenu
>Primitives de solides finis</guisubmenu
><guimenuitem
>Boîte</guimenuitem
></menuchoice
>) et redimensionner x à 100, y à 0 et z à 100, par exemple, mais c'est une façon de faire un peu lourde.</para>

<para
>En fait, &kpovmodeler; vous offre une possibilité intéressante : vous pouvez créer un plan infini qui représentera le sol :</para>

<para
>En utilisant le menu : <menuchoice
><guimenu
>Insertion</guimenu
><guisubmenu
>Primitives de solides infinis</guisubmenu
> <guimenuitem
>Plan</guimenuitem
></menuchoice
></para>
<para
>En utilisant la barre d'outil : cliquez sur l'icône <inlinemediaobject
><imageobject
><imagedata fileref="cr22-action-pmplane.png" format="PNG"/></imageobject
> </inlinemediaobject
> </para>

<para
>Maintenant, en sélectionnant le plan dans l'arborescence d'objets, changez le nom pour avoir quelque chose de plus parlant pour vous et pressez le bouton <guilabel
>Appliquer</guilabel
> (ou Entrée). L'arborescence d'objet va mettre a jour le nom de l'entrée.</para>

<screenshot>
<mediaobject
><imageobject
><imagedata fileref="tutorial01-plane-dialog.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>La vue fil de fer vous affiche également le plan maintenant, même s'il apparaît comme étant de dimension finie pour l'instant. Mais ne vous inquiétez pas, il s'étendra jusqu'à la ligne d'horizon quand vous lancerez le calcul de la scène !</para>

<para
>Si vous regardez l'arborescence d'objets, vous remarquerez que l'entrée correspondant au sol peut être étendue si vous cliquez sur le <quote
>plus</quote
> affiché devant cette entrée. Une fois fait, vous voyez plusieurs paramètres apparentés à l'objet. Dans ce cas, il n'y en a pas beaucoup, à part les options standard à chaque nouvel objet : agrandissement, rotation et translation. En sélectionnant chacun d'eux, vous pourrez modifier les paramètres disponible dans la vue propriétés de l'objet.</para>

<screenshot>
<mediaobject
> <imageobject
><imagedata fileref="tutorial01-plane-tree-expanded.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Dans cette scène, vous allez déplacer arbitrairement le sol d'une unité vers le bas, et pour vous aider, sélectionnez déplacer, et ajuster les paramètres comme suit :</para>

<screenshot>
<mediaobject
><imageobject
><imagedata fileref="tutorial01-plane-tree-translate.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Votre scène devrait ressembler à ce qu'il y a sur l'image suivante.</para>
<screenshot
><mediaobject
><imageobject
><imagedata fileref="tutorial01-plane-graphic.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

</sect1>

<sect1 id="basic-tutorial-step-5">
<title
>Étape 5 : donner une Texture au Sol.</title>

<para
>Vous devez d'abord sélectionner le sol avant de pouvoir lui appliquer une texture. Plusieurs possibilités s'offrent à nous, mais nous utiliserons la technique la plus simple possible.</para>

<para
>En utilisant le menu : <menuchoice
><guimenu
>Insertion</guimenu
><guisubmenu
>Textures</guisubmenu
> <guimenuitem
>Pigment</guimenuitem
></menuchoice
></para>
<para
>En utilisant la barre d'outils : cliquez sur l'icône <inlinemediaobject
> <imageobject
><imagedata fileref="cr22-action-pmpigment.png" format="PNG"/></imageobject
> </inlinemediaobject
>.</para>

<screenshot>
<mediaobject
><imageobject
><imagedata fileref="insertaspopup.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Dans chacun des cas, une fenêtre surgissante vous demandera de choisir une façon dont seront insérés les objets. Choisissez <guilabel
>Premier Enfant</guilabel
>. Le pigment apparaît maintenant dans l'arborescence d'objet. Vous pouvez changer son nom dans la vue propriétés (<guilabel
>Nom</guilabel
>=<quote
>Pigment sol</quote
>), et cliquer sur le bouton <guibutton
>Prévisualisation</guibutton
> pour voir quel sera le rendu du pigment.</para>

<screenshot>
<mediaobject
><imageobject
><imagedata fileref="tutorial01-ground-pigment.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Bien sûr, la prévisualisation du pigment ne montre rien d'autre qu'un matériel noir mat, car nous devons définir les paramètres du pigment. Quoi qu'il en soit, gardez à l'esprit que vous pouvez toujours avoir un aperçu des vos matériaux en utilisant le bouton <guibutton
>Prévisualisation</guibutton
>. Nous allons maintenant définir les couleurs du pigment. Une fois de plus, plusieurs possibilités s'offrent à nous, mais nous choisirons la méthode la plus directe pour l'instant.</para>

<para
>En utilisant le menu : <menuchoice
><guimenu
>Insertion</guimenu
><guisubmenu
>Textures</guisubmenu
> <guimenuitem
>Liste de couleurs</guimenuitem
></menuchoice
></para>
<para
>En utilisant la barre d'outils : cliquez sur l'icône <inlinemediaobject
> <imageobject
><imagedata fileref="cr22-action-pmcolorlist.png" format="PNG"/></imageobject
> </inlinemediaobject
>.</para>

<para
>Si aucune couleur n'apparaît sur la boîte et la sphère de prévisualisation, cliquez sur le bouton <guibutton
>Appliquer</guibutton
> avant d'appeler la prévisualisation.</para>

<screenshot>
<mediaobject
><imageobject
><imagedata fileref="tutorial01-ground-color-list.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Le matériel du sol a été correctement paramétré ! Si vous lancez le calcul de rendu maintenant en utilisant l'icône <inlinemediaobject
> <imageobject
><imagedata fileref="cr22-action-pmrender.png" format="PNG"/></imageobject
> </inlinemediaobject
>, vous devriez avoir ceci :</para>

<screenshot>
<mediaobject
><imageobject
><imagedata fileref="tutorial01-ground-wrong-colors-render.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Bien sûr, ces couleurs ne sont peut être pas celle que vous souhaitiez. Nous devons encore voir comment les modifier. Dans le cas d'une liste de couleurs, vous devez définir deux nouveaux types d'attributs appelés <guilabel
>Couleur pleine</guilabel
>. Vérifiez que la liste de couleurs est bien sélectionnée dans l'arborescence d'objets. Ensuite répétez deux fois cette opération (vous ne pouvez pas le faire plus de fois, car une liste de couleurs pour un quadrillage ne peut accepter que deux couleurs pleines) :</para>

<para
>En utilisant le menu : <menuchoice
><guimenu
>Insertion</guimenu
><guisubmenu
>Textures</guisubmenu
> <guimenuitem
>Couleur pleine</guimenuitem
></menuchoice
></para>

<para
>En utilisant la barre d'outils : cliquez sur l'icône <inlinemediaobject
> <imageobject
><imagedata fileref="cr22-action-pmsolidcolor.png" format="PNG"/></imageobject
> </inlinemediaobject
>.</para>

<para
>Dans l'arborescence d'objets, sélectionnez l'une après l'autre les deux couleurs solides, et changez leur attributs dans la vue des propriétés :</para>

<screenshot>
<mediaobject
><imageobject
><imagedata fileref="tutorial01-ground-solid-color-1.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>...ces attributs sont pour la première couleur solide (pressez le bouton <guibutton
>Appliquer</guibutton
> !),</para>

<screenshot>
<mediaobject
><imageobject
><imagedata fileref="tutorial01-ground-solid-color-2.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>...et ces attributs sont pour la seconde couleur solide (actionnez encore le bouton <guibutton
>Appliquer</guibutton
> !).</para>

<para
>Bien sûr, un nouveau calcul de rendu prouvera que tout a été pris en compte :</para>

<screenshot>
<mediaobject
><imageobject
><imagedata fileref="tutorial01-ground-render.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

</sect1>

<sect1 id="basic-tutorial-step-6">
<title
>Étape 6 : créer la sphère</title>

<para
>Pour cette étape, nous devrions déjà être plus a l'aise, car nous commençons à comprendre le fonctionnement général de &kpovmodeler;. Dans l'arborescence d'objets, sélectionnez la l'entrée « scène ». Créer la sphère est aussi simple que de créer le sol.</para>

<para
>En utilisant le menu : <menuchoice
><guimenu
>Insertion</guimenu
><guisubmenu
>Primitives de solides finis</guisubmenu
> <guimenuitem
>Sphère</guimenuitem
></menuchoice
></para>

<para
>En utilisant la barre d'outils : cliquez sur l'icône <inlinemediaobject
> <imageobject
><imagedata fileref="cr22-action-pmsphere.png" format="PNG"/></imageobject
> </inlinemediaobject
>.</para>

<screenshot>
<mediaobject
><imageobject
><imagedata fileref="insertaspopup.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Comme précédemment, sélectionnez <guilabel
>Premier Enfant</guilabel
> quand on vous le demandera.</para>

<para
>La vue propriétés des objets vous permet de changer ses paramètres immédiatement, ce que nous allons faire maintenant. En réglant le <guilabel
>Rayon</guilabel
> à 1 (n'oubliez pas d'actionner Entrée ou le bouton <guibutton
>Appliquer</guibutton
>), nous serons sûrs que la sphère sera en contact avec le sol. Sinon, comme nous avons déplacé le sol d'une unité vers le bas, la sphère aurait l'air de flotter au-dessus du sol.</para>

<screenshot>
<mediaobject
><imageobject
><imagedata fileref="tutorial01-sphere-dialog.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Bien entendu, un calcul du rendu nous donnera un résultat étrange : comme vu précédemment, la sphère apparaît avec un matériel noir mat. Nous allons lui allouer un matériel plus approprié à l'étape suivante.</para>

<screenshot>
<mediaobject
><imageobject
><imagedata fileref="tutorial01-sphere-render-nocolor.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

</sect1>

<sect1 id="basic-tutorial-step-7">
<title
>Étape 7 : ajouter une texture à la sphère</title>

<para
>Avec la sphère sélectionnée, vous pouvez maintenant lui allouer un matériel. Comme nous l'avons déjà fait pour le sol, mettons sur la sphère une couleur :</para>

<para
>En utilisant le menu : <menuchoice
><guimenu
>Insertion</guimenu
><guisubmenu
>Textures</guisubmenu
> <guimenuitem
>Pigment</guimenuitem
></menuchoice
></para>

<para
>En utilisant la barre d'outils : cliquez sur l'icône <inlinemediaobject
><imageobject
><imagedata fileref="cr22-action-pmpigment.png" format="PNG"/></imageobject
> </inlinemediaobject
> </para>

<para
>Sélectionnez <guilabel
>Premier Enfant</guilabel
> et renommez l'objet en <quote
>Sphère pigment</quote
>, par exemple. En sélectionnant l'entrée pigment de la sphère, insérez une couleur uniforme et réglez les paramètres comme suit :</para>

<para
>En utilisant le menu : <menuchoice
><guimenu
>Insertion</guimenu
><guisubmenu
>Textures</guisubmenu
> <guimenuitem
>Couleur pleine</guimenuitem
></menuchoice
></para>

<para
>En utilisant la barre d'outils : cliquez sur l'icône <inlinemediaobject
><imageobject
><imagedata fileref="cr22-action-pmsolidcolor.png" format="PNG"/></imageobject
> </inlinemediaobject
></para>

<screenshot>
<mediaobject
><imageobject
><imagedata fileref="tutorial01-sphere-solid-color.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Vous pouvez déjà lancer le calcul de la scène et obtenir un premier résultat basique :</para>

<screenshot>
<mediaobject
><imageobject
><imagedata fileref="tutorial01-sphere-render-solidcolor.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Mais il y a d'autres effets plus intéressants à ajouter si nous prenons le temps d'ajouter des attributs de finition.</para>

<para
>En utilisant le menu : <menuchoice
><guimenu
>Insertion</guimenu
><guisubmenu
>Textures</guisubmenu
> <guimenuitem
>Finition</guimenuitem
></menuchoice
></para>
<para
>En utilisant la barre d'outils : cliquez sur l'icône <inlinemediaobject
> <imageobject
><imagedata fileref="cr22-action-pmfinish.png" format="PNG"/></imageobject
> </inlinemediaobject
>.</para>

<para
>Changez ensuite les valeurs d'après la capture suivante et actionnez <guibutton
>Appliquer</guibutton
> ou Entrée.</para>

<screenshot>
<mediaobject
><imageobject
><imagedata fileref="tutorial01-sphere-finish-dialog.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Les paramètres <guilabel
>Specular</guilabel
> et <guilabel
>Réflexion</guilabel
> donnent de particulièrement beaux effets visuel, il sont en particulier parfaits pour des effets de verre ou de chrome, même si le paramètre <guilabel
>Métallique</guilabel
> n'a pas été coché à cette étape :</para>

<screenshot>
<mediaobject
><imageobject
><imagedata fileref="tutorial01-sphere-render-finish.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

</sect1>

<sect1 id="basic-tutorial-conclusion">
<title
>Conclusion</title>

<para
>Vous devez maintenant avoir un bon aperçu des possibilités de kpovmodeler, et vous êtes maintenant suffisamment capable de créer de simples mais belles scènes.</para>

</sect1>
</chapter>

<chapter id="concepts">
<title
>Concepts de base</title>

<sect1 id="what-is-raytracing">
<title
>Qu'est ce que le Raytracing ?</title>

<para
>Le Raytracing est une méthode de <link linkend="gloss-rendering"
>calcul de rendu</link
>, c'est-à-dire, créer une image 2D à partir d'une scène 3D.</para>

<para
>Quand vous lancez le calcul d'une scène, le moteur de rendu lance des rayons hypothétiques depuis le point de vue de l'utilisateur (c'est-à-dire, depuis la caméra à partir de laquelle vous regardez la scène) vers chaque pixel de la scène. Il calcule comment les rayons vont se réfléchir, et se réfracter sur les objets, ainsi que les effets des sources de lumières et phénomènes atmosphériques tels que le brouillard. La scène est ainsi construite pixel par pixel.</para>

<para
>Comme vous pouvez l'imaginer, sans caméra, vous ne pouvez rien voir - la caméra est vos <quote
>yeux</quote
> dans la scène. De plus, sans lumière, vous ne verrez rien non plus - Ce sera tout simplement noir. Donc toute scène que vous voulez calculer doit contenir des sources de lumière, des objets et au moins une caméra.</para>

</sect1>

</chapter>

<chapter id="objects-reference">
<title
>Référence des Objets</title>

<para
>Pour une référence complète de tous les objets et attributs, allez voir la documentation utilisateur de &Povray;.</para>
</chapter>


<chapter id="menu-reference">
<title
>Référence des menus</title>

<sect1 id="file-menu">
<title
>Le menu <guimenu
>Fichier</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Fichier</guimenu
> <guimenuitem
>Nouveau</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Crée un nouvelle scène.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Fichier</guimenu
> <guimenuitem
>Importer...</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Importe une scène &Povray;</action
> créée hors de &kpovmodeler;.</para>
<para
>Une boîte de dialogue standards'ouvrira, vous permettant de choisir un fichier. Les fichiers Povray ont généralement comme extension <literal role="extension"
>*.pov</literal
> ou <literal role="extension"
>*.inc</literal
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>O</keycap
></keycombo
> </shortcut
> <guimenu
>Fichier</guimenu
> <guimenuitem
>Ouvrir...</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Ouvre un fichier.</action
> La boîte de dialogue standard vous permettra de choisir un fichier que vous avez créé auparavant avec &kpovmodeler;</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Fichier</guimenu
> <guisubmenu
>Récemment ouverts</guisubmenu
> </menuchoice
></term>
<listitem>
<para
><action
>Ouvre un fichier à partir d'une liste de fichiers sur lesquels vous avez travaillé récemment.</action
></para>
<para
>À chaque fois que vous ouvrez ou créez un nouveau modèle, il est ajouté à ce sous-menu, remplaçant ainsi la plus vieille entrée de la liste.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
></shortcut
> <guimenu
>Fichier</guimenu
> <guimenuitem
>Enregistrer</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Enregistre la scène active courante.</action
></para>
<para
>Si vous avez déjà enregistré cette scène, elle sera enregistrée dans le même fichier. Si c'est une nouvelle scène, il vous sera demandé de choisir un fichier de sauvegarde.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Fichier</guimenu
> <guimenuitem
>Enregistrer sous...</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Enregistre la scène active courante dans un nouveau fichier.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Fichier</guimenu
> <guimenuitem
>Exporter...</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Exporte la scène dans un fichier &Povray;.</action
></para>
<para
>La boîte de dialogue de sauvegarde de fichier vous permettra de choisir le nom et l'endroit ou enregistrer votre fichier.</para>
<note
><para
>&kpovmodeler; ajoutera automatiquement l'extension <literal role="extension"
>.pov</literal
>.</para
></note>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Fichier</guimenu
> <guimenuitem
>Recharger</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Revient dans l'état ou la scène se trouvait la dernière fois que vous l'avez enregistrée.</action
> Les changements que vous avez fait depuis seront perdus.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>P</keycap
></keycombo
></shortcut
> <guimenu
>Fichier</guimenu
> <guimenuitem
>Imprimer...</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>La fonction d'impression n'est pas encore implémentée.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>W</keycap
></keycombo
></shortcut
> <guimenu
>Fichier</guimenu
> <guimenuitem
>Fermer</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Ferme la scène courante</action
> sans quitter &kpovmodeler;</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
></shortcut
> <guimenu
>Fichier</guimenu
> <guimenuitem
>Quitter</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Quitte</action
> &kpovmodeler;. Si vous avez des modifications non enregistrées, vous aurez encore une chance de le faire avant de quitter.</para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="edit-menu">
<title
>Le Menu <guimenu
>Édition</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Z</keycap
></keycombo
> </shortcut
> <guimenu
>Édition</guimenu
> <guimenuitem
>Annuler</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Annule votre dernière action.</action
></para>
<para
>Cette entrée de menu n'est pas accessible tant que vous n'avez pas fait de changement dans la scène courante.</para
><!-- FIXME: is the number of items in the -->
<!-- undo history configurable? -->
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
> &Ctrl;&Maj;<keycap
>Z</keycap
></keycombo
></shortcut
> <guimenu
>Édition</guimenu
> <guimenuitem
>Refaire</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Refait la dernière action annulée.</action
> Cette entrée de menu n'est pas accessible tant que vous n'avez pas utilisé <menuchoice
><guimenu
>Édition</guimenu
> <guimenuitem
>Annuler</guimenuitem
></menuchoice
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
> &Ctrl;<keycap
>X</keycap
></keycombo
></shortcut
> <guimenu
>Édition</guimenu
> <guimenuitem
>Couper</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Coupe</action
> le ou les objet(s) actuellement sélectionné(s), et les met dans le presse-papiers.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
> &Ctrl;<keycap
>C</keycap
></keycombo
></shortcut
> <guimenu
>Édition</guimenu
> <guimenuitem
>Copier</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Copie</action
> le ou les objet(s) actuellement sélectionné(s), et les met dans le presse-papiers.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
> &Ctrl;<keycap
>V</keycap
></keycombo
></shortcut
> <guimenu
>Édition</guimenu
> <guimenuitem
>Coller</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Colle</action
> le contenu du presse-papiers.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Édition</guimenu
> <guimenuitem
>Supprimer</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Supprime</action
> le ou les objet(s) actuellement sélectionné(s) de la scène.</para>
<!-- FIXME: Shouldn't this be bound to the delete key? -->
</listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="view-menu">
<title
>Le Menu <guimenu
>Affichage</guimenu
></title>

<variablelist>

<varlistentry>
<term
><guimenu
>Affichage</guimenu
> <guimenuitem
>Nouvel arbre des objets</guimenuitem
> </term>
<listitem>
<para
><action
>Crée</action
> une nouvelle <link linkend="the-object-tree"
>Arborescence d'objets</link
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenu
>Affichage</guimenu
> <guimenuitem
>Nouvelle vue des propriétés</guimenuitem
> </term>
<listitem>
<para
><action
>Crée</action
> une nouvelle <link linkend="the-properties-view"
>Vue des propriétés des objets</link
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenu
>Affichage</guimenu
> <guimenuitem
>Nouvelle vue du haut</guimenuitem
> </term>
<listitem>
<para
><action
>Crée</action
> une nouvelle <link linkend="orthographic-views"
>vue orthogonale</link
> à partir de la vue en perspective du dessus.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenu
>Affichage</guimenu
> <guimenuitem
>Nouvelle vue du bas</guimenuitem
> </term>
<listitem>
<para
><action
>Crée</action
> une nouvelle <link linkend="orthographic-views"
>vue orthogonale</link
> à partir de la vue en perspective du dessous.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenu
>Affichage</guimenu
> <guimenuitem
>Nouvelle vue de gauche</guimenuitem
> </term>
<listitem>
<para
><action
>Crée</action
> une nouvelle <link linkend="orthographic-views"
>vue orthogonale</link
> à partir de la vue en perspective de gauche.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenu
>Vue</guimenu
> <guimenuitem
>Nouvelle vue de droite</guimenuitem
> </term>
<listitem>
<para
><action
>Crée</action
> une nouvelle <link linkend="orthographic-views"
>vue orthogonale</link
> à partir de la vue en perspective de droite.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenu
>Vue</guimenu
> <guimenuitem
>Nouvelle vue avant</guimenuitem
> </term>
<listitem>
<para
><action
>Crée</action
> une nouvelle <link linkend="orthographic-views"
>vue orthogonale</link
> à partir de la vue en perspective de l'avant.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenu
>Vue</guimenu
> <guimenuitem
>Nouvelle vue de l'arrière</guimenuitem
> </term>
<listitem>
<para
><action
>Crée</action
> une nouvelle <link linkend="orthographic-views"
>vue orthogonale</link
> à partir de la vue en perspective de l'arrière.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenu
>Vue</guimenu
> <guimenuitem
>Nouvelle vue de caméra</guimenuitem
> </term>
<listitem>
<para
><action
>Crée</action
> une nouvelle <link linkend="camera-view"
>vue caméra</link
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenu
>Affichage</guimenu
> <guimenuitem
>Disposition des vues</guimenuitem
> </term>
<listitem>
<para
>Contient une liste de toutes les dispositions de vues existantes. Modifie la disposition avec celle sélectionnée.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenu
>Affichage</guimenu
> <guimenuitem
>Enregistrer la disposition des vues</guimenuitem
> </term>
<listitem>
<para
>Enregistre la disposition de vue courante. Une boîte de dialogue s'ouvre pour choisir un nom pour cette nouvelle disposition, ou pour en écraser une existante.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenu
>Affichage</guimenu
> <guimenuitem
>Modes de rendu...</guimenuitem
> </term>
<listitem>
<para
>Ouvre la boîte de dialogue <link linkend="render-modes-configuration"
> configuration des modes de rendu</link
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenu
>Affichage</guimenu
> <guimenuitem
>Rendu</guimenuitem
> </term>
<listitem>
<para
>Calcule le rendu de la scène.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenu
>Affichage</guimenu
> <guimenuitem
>Fenêtre de rendu</guimenuitem
> </term>
<listitem>
<para
>Affiche la fenêtre de rendu de &Povray;.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guimenu
>Affichage</guimenu
> <guimenuitem
>Réaffichage</guimenuitem
> </term>
<listitem>
<para
>Réaffiche les vues fil de fer.</para>
</listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="insert-menu">
<title
>Le menu <guimenu
>Insertion</guimenu
></title>

<para
>Actions de création pour tous les objets &Povray; gérés.</para>

</sect1>

<sect1 id="settings-menu">
<title
>Le menu <guimenu
>Configuration</guimenu
></title>
<para
>Ce menu fourni des options pour configurer &kpovmodeler;, changer son apparence, les raccourcis clavier, et les comportements par défaut.</para>

<variablelist>

<varlistentry>
<term
><menuchoice
><guimenu
>Paramètres</guimenu
> <guimenuitem
>Afficher la barre d'état</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Affiche/cache la barre d'état.</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuration</guimenu
> <guimenuitem
>Montrer le chemin</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Affiche/cache le chemin dans la légende.</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuration</guimenu
> <guimenuitem
>Enregistrer la configuration</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Enregistre les paramètres courants.</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuration</guimenu
> <guimenuitem
>Configurer les raccourcis clavier...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Ouvre une boîte de dialogue pour modifier la définition des touches.</action
> En utilisant cette option, vous pourrez changer les raccourcis standard pour les commandes de &kpovmodeler;, ou en créer de nouvelles.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuration</guimenu
> <guimenuitem
>Configurer les barres d'outils...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Ouvre une boîte de dialogue pour configurer la barre d'outils.</action
> Vous pouvez ajouter et enlever des boutons pour les commandes de &kpovmodeler; avec cette option.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuration</guimenu
> <guimenuitem
>Configurer KPovModeler...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Ouvre la boîte de dialogue de configuration de &kpovmodeler;</action
></para>
</listitem>
</varlistentry>

</variablelist>

</sect1>


<sect1 id="help-menu">
<title
>Le Menu <guimenu
>Aide</guimenu
></title>
&help.menu.documentation; </sect1>

</chapter>

<chapter id="credits-and-licenses">
<title
>Remerciements et licences</title>

<para
>&kpovmodeler; copyright 2001,2002 Les auteurs de &kpovmodeler;.</para>

<itemizedlist>
<title
>Auteurs</title>
<listitem>
<para
>Andreas Zehender <email
>zehender@kde.org</email
></para>
</listitem>
<listitem>
<para
>Luis Passos Carvalho <email
>lpassos@mail.telepac.pt</email
></para>
</listitem>
<listitem>
<para
>Phillippe Van Hecke <email
>lephiloux@tiscalinet.be</email
></para>
</listitem>
<listitem>
<para
>Leonardo Skorianez <email
>skorianez@bol.com.br</email
></para>
</listitem>
</itemizedlist>

<para
>Documentation copyright 2002 Lauri Watts <email
>lauri@kde.org</email
></para>
<para
>Documentation copyright 2002 Andreas Zehender <email
>zehender@kde.org</email
></para>
<para
>Documentation copyright 2002 Olivier Saraja <email
>olivier@linuxgraphic.org</email
></para>

<para
>Traduction française par &GuillaumeDuwelzRebert;.</para
> 
&underFDL; &underGPL; </chapter>

<glossary id="glossary">
<title
>Glossaire</title>

<glossentry id="gloss-bump-map">
<glossterm
>Bump Map</glossterm>
<glossdef>
<para
>Une <quote
>bump map</quote
> est une façon de simuler une surface rugueuse, sans avoir à modéliser chaque petit <quote
>défaut</quote
> sur la surface, et sans changer la surface géométrique de l'objet lui-même.</para>
<para
>Il est classique d'utiliser le même fichier en tant que <quote
>bump map</quote
> et <quote
><link linkend="gloss-texture-map"
>texture map</link
></quote
>.</para>
</glossdef>
</glossentry>

<glossentry id="gloss-primitives">
<glossterm
>Primitives</glossterm>
<glossdef>
<para
>Les primitives sont les formes géométrique de bases que vous pouvez utiliser en tant que <quote
>blocs de construction</quote
>. La plupart des modeles 3D sont créés avec plusieurs dizaine, ou centaine de ces primitives, qui sont éditées et manipulées pour leur donner une apparence plus réaliste.</para>
</glossdef>
</glossentry>

<glossentry id="gloss-rendering">
<glossterm
>Calcul du rendu</glossterm>
<glossdef>
<para
>Pas encore écrit</para>
</glossdef>
</glossentry>

<glossentry id="gloss-texture-map">
<glossterm
>Texture Map</glossterm>
<glossdef>
<para
>Une <quote
>texture map</quote
> est une façon d'appliquer des couleurs à la surface d'un objet, pixel par pixel, en appliquant un fichier image en tant que map de couleur</para>
<para
>Il est courant d'enregistrer l'image en tant que <quote
><link linkend="gloss-bump-map"
>bump map</link
></quote
>.</para>
</glossdef>
</glossentry>



</glossary>

&documentation.index; 

<appendix id="installation">
<title
>Installation</title>

&install.intro.documentation;
&install.compile.documentation;

</appendix>

</book>

<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

// vim:ts=2:sw=2:tw=78:noet
-->
