<?xml version='1.0' encoding='UTF-8'?>

<sect2 id='plug-in-IWarp' lang="en;fr">
  <title lang="en">IWarp</title>
  <title lang="fr">Déformation interactive</title>

  <indexterm>
    <primary lang="en">IWarp</primary>
    <primary lang="fr">Déformation interactive</primary>
  </indexterm>

  <mediaobject lang="en">
    <imageobject>
      <imagedata fileref='../images/filters/filters-distort-iwarp.png' format="PNG"/>
    </imageobject>
  </mediaobject>
  <mediaobject lang="fr">
    <imageobject>
      <imagedata fileref='../images/filters/fr/filters-distort-iwarp.png' format="PNG"/>
    </imageobject>
  </mediaobject>
  
  <simplesect>
    <title lang="en">Overview</title>
    <title lang="fr">Généralités</title>    

          <para lang="en">
            This filter is found in 
            <guimenuitem>Image&gt;Filters/Distorts/<accel>I</accel>Warp</guimenuitem>
          </para>
          <para lang="en">
            This filter allows you to deform interactively some parts of the 
            image and, thanks to its Animate option, to create the elements 
            of a fade in/fade out animation between the original image and 
            the deformed one, that you can play and use in a Web page.
          </para>
          <para lang="en">
            To use it, first select a deform type then click on the Preview 
            and drag the mouse pointer.
          </para>  

          <para lang="fr">
            Ce filtre se trouve à 
            <guimenuitem>Image&gt;Filtres/Distorsion/<accel>D</accel>éformation interactive</guimenuitem>
          </para>
          <para lang="fr">
            Ce filtre permet de déformer certaines parties de l'image de 
            façon interactive et, grâce à son option Animer, de créer les 
            éléments d'une animation en fondu enchaîné (morphing) entre 
            l'image d'origine et l'image déformée, que vous pourrez jouer et 
            utiliser dans une page Web.
          </para> 
          <para lang="fr">
            Pour l'utiliser, choisissez d'abord un type de déformation, puis 
            cliquez sur l'Aperçu à l'endroit que vous voulez déformer et 
            faites glisser le pointeur.
          </para>
  </simplesect>

  <simplesect>
    <title lang="en">Preview</title>
    <title lang="fr">Aperçu</title>
        <para lang="en">
          Here, the Preview is your work space: You click on the Preview and 
          drag mouse pointer. The underlying part of image will be deformed 
          according to the settings you have choosen. If your work is not 
          convenient, press <emphasis>Reset</emphasis> button.
        </para> 
        <para lang="fr">
          L'Aperçu est ici votre espace de travail: vous cliquez sur l'Aperçu 
          et faites glisser le pointeur. La partie de l'image sous-jacente au 
          pointeur sera déformée en fonction des réglages choisis. Si votre 
          travail ne vous plaît pas, cliquez sur le bouton 
          <emphasis>Réinitialiser</emphasis>. 
        </para>
      
  </simplesect>

  <simplesect>
    <title lang="en">Settings</title>
    <title lang="fr">Réglages</title>
    <para lang="en">
      The Settings tab allows you to set parameters which will affect the 
      preview you are working on. So, you can apply different deform modes 
      to different parts of the preview.  
    </para>
    <para lang="fr">
      L'onglet Réglages vous permet de fixer les paramètres qui affecteront 
      l'aperçu sur lequel vous travaillez. Vous pouvez ainsi appliquer 
      différents types de déformation en différents points de l'aperçu.
    </para>
    <variablelist>
      <varlistentry>
        <term lang="en">Deform Radius</term>
        <term lang="fr">Rayon de déformation</term>
        <listitem>
          <para lang="en">
            Defines the radius, in pixels (5-100), of the filter action 
            circle around the pixel pointed by the mouse.
          </para>
          <para lang="fr">
            Définit le rayon, en pixels (5-100), du cercle d'action du filtre 
            autour du pixel pointé par la souris.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en">Deform Amount</term>
        <term lang="fr">Intensité de déformation</term>
        <listitem>
          <para lang="en">
            Sets how much out of shape your image will be put (0.0-1.0).
          </para>
          <para lang="fr">
            Règle l'importance de la déformation (0.0-1.0).
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en">Deform Mode</term>
        <term lang="fr">Mode de déformation</term>
        <listitem lang="en">
          <para>
            <guilabel>Move</guilabel>: Allows you to 
            <emphasis>stretch</emphasis> parts of the image.
          </para>
          <para>
            <guilabel>Remove</guilabel>: This remove the distortion where 
            you drag the mouse pointer, partially or completely. This 
            allows you to avoid pressing Reset button, working on the 
            whole image. Be careful when working on an animation: this 
            option will affect one frame only. 
          </para>
          <para>
            <guilabel>Grow</guilabel>: This option inflates the pointed 
            pattern.
          </para>
          <para>
            <guilabel>Shrink</guilabel>: Self explanatory.
          </para>
          <para>
            <guilabel>Swirl CCW </guilabel>: Create a vortex counter clockwise.
          </para>
          <para>
            <guilabel>Swirl CW </guilabel>: Create a vortex clockwise.
          </para> 
        </listitem>

        <listitem lang="fr">
          <para>
            <guilabel>Déplacer</guilabel>: Ce mode permet d'étirer une partie de 
            l'image.
          </para>
          <para> 
            <guilabel>Enlever</guilabel>: Vous permet de supprimer l'effet 
            de distorsion avec le pointeur, en partie ou en totalité, en 
            vous évitant de ré-initialiser l'ensemble de l'image. 
            Méfiez-vous si vous travaillez sur une animation: la 
            suppression ne se fera que sur une seule des images de la 
            séquence.  
          </para>
          <para>
            <guilabel>Agrandir</guilabel>: cette option fait enfler le 
            motif sous-jacent au pointeur.
          </para> 
          <para>
            <guilabel>Réduire</guilabel>: cette option rétrécit le motif 
            sous-jacent au pointeur.
          </para>
          <para>
            <guilabel>Tourbillon sens anti-horaire</guilabel>: Crée un 
            tourbillon dans le sens inverse des aiguilles d'une montre.
          </para>
          <para>
            <guilabel>Tourbillon sens horaire</guilabel>: Crée un 
            tourbillon dans le sens des aiguilles d'une montre.
          </para>     
        </listitem>
       </varlistentry>

      <varlistentry>
        <term lang="en">Bilinear</term>
        <term lang="fr">Bilinéaire</term>
        <listitem>
          <para lang="en">
            This option smoothes the IWarp effect.
          </para>
          <para lang="fr">
            Cette option adoucit l'effet de déformation.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en">Adaptative Supersample</term>
        <term lang="fr">Super-échantillonnage adaptatif</term>
        <listitem lang="en">
          <para>
            This option renders a better image at the cost of increased 
            calculation. 
          </para> 
          <para>
            <guilabel>Max Depth</guilabel>: FIXME
          </para>
          <para>
            <guilabel>Threshold</guilabel>: FIXME
          </para>
        </listitem>
 
        <listitem lang="fr">
          <para>
            Cette option agit plus en détail et fournit une meilleure image, 
            au prix d'une lourde charge de calcul.
           </para>
          <para>
            <guilabel>Profondeur max</guilabel>: A FAIRE
          </para>
          <para>
            <guilabel>Seuil</guilabel>:    A FAIRE
          </para>
        </listitem>
      </varlistentry>
    </variablelist> 
  </simplesect>

  <simplesect>
    <title lang="en">Animate</title>
    <title lang="fr">Animer</title>
    <para lang="en">
      This option allows to generate several intermediate images between the 
      original image and the final deformation of this image. You can play 
      this animation thanks to the plugin 
      <!-- XXX <link linkend="plug-in-animationplay"> -->
      Playback
      <!--</link>-->.      
    </para>
    <para lang="fr" >
      Cette option permet de créer une série d'images intermédiaires entre 
      l'image d'origine et la déformation finale de cette image. Vous pourrez 
      faire défiler ces images comme un petit film grâce au greffon 
      <!-- XXX <link linkend="plug-in-animationplay">-->
      Rejouer l'animation
      <!--</link>-->. 
    </para>  
    <variablelist>
      <varlistentry>
        <term lang="en">Number of Frames</term>
        <term lang="fr">Nombre d'images</term>
        <listitem lang="en">        
          <para>
            That's the number of images in your animation (2-100). These frames 
            are stored as layers attached to your image. Use the XCF format 
            when saving it.
          </para>
        </listitem>
        <listitem lang="fr">        
          <para>
            C'est le nombre d'images composant votre animation (2-100). Ces 
            images seront stockées en tant que calques attachés à l'image.
            Utilisez le formst XCF pour sauvegarder cette image.
          </para>    
        </listitem>          
      </varlistentry>

      <varlistentry>
        <term lang="en">Reverse</term>
        <term lang="fr">Inverser</term>
        <listitem lang="en">        
          <para>
            This option plays the animation backwards.
          </para>
        </listitem>
        <listitem lang="fr">        
          <para>
            Permet d'inverser le sens de défilement des images.
          </para>       
        </listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en">Ping-Pong</term>
        <term lang="fr">Ping-Pong</term>
        <listitem lang="en">        
          <para>
            When the animation ends one way, it goes backwards.
          </para>
        </listitem>
        <listitem lang="fr">          
          <para>
            Quand elle est finie dans un sens, l'animation reprend dans 
            l'autre sens.
          </para>       
        </listitem>
      </varlistentry>

    </variablelist> 
  </simplesect>

  <simplesect>
    <title lang="en">Example</title>
    <title lang="fr">Exemple</title>
    <mediaobject role='html'>
      <imageobject>
        <imagedata fileref='../images/filters/examples/iwarp-anim.mng'
        /> <!-- XXX DocBook don't know format='MNG' -->
      </imageobject>
    </mediaobject>
  </simplesect>
  
  
</sect2>
