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

<sect2 id='plug-in-whirlpinch' lang="en;fr">
  <title lang="en">Whirl and Pinch</title>
  <title lang="fr">Tourner et aspirer</title>

  <indexterm>
    <primary lang="en">Whirl and Pinch</primary>
    <primary lang="fr">Tourner et aspirer</primary>
  </indexterm>

  <mediaobject lang="en">
    <imageobject>
      <imagedata fileref='../images/filters/filters-distort-whirlpinch.png' format="PNG"/>
    </imageobject>
  </mediaobject>

  <mediaobject lang="fr">
    <imageobject>
      <imagedata fileref='../images/filters/fr/filters-distort-whirlpinch.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
      <menuchoice>
        <guimenu>Filters</guimenu>
        <guisubmenu>Distorts</guisubmenu>
        <guimenuitem>W<accel>h</accel>irl and Pinch</guimenuitem>
      </menuchoice>
    </para>
    <para lang="en">
      "Whirl and Pinch" distorts your image in a concentric way.
    </para>
    <para lang="en">
      "Whirl" distorts the image much like the little whirlpool that
      appears when you empty your bath. 
    </para>
    <para lang="en">
      "Pinch" can be compared to applying your image to a soft rubber
      surface and squeezing the edges or corners. If the Pinch amount
      slider is set to a negative value, it will look as if someone
      tried to push a round object up toward you from behind the
      rubber skin. If the Pinch amount is set to a positive value, it
      looks like someone is dragging or sucking on the surface from
      behind, and away from you. 
    </para> 
    <tip>
      <para>
	The "pinch" effect can sometimes be used to compensate for image
	distortion produced by telephoto or fisheye lenses ("barrel
	distortion"). 
      </para>
    </tip>
    
    <para lang="fr">
      Ce filtre se trouve à 
      <menuchoice>
        <guimenu>Filtres</guimenu>
        <guisubmenu>Distorsion</guisubmenu>
        <guimenuitem>T<accel>o</accel>urner et aspirer</guimenuitem>
      </menuchoice>
    </para>
    <para lang="fr">
      Il crée une déformation de l'image évoquant un tourbillon aspiratif 
      dans un lavabo.
    </para> 
  </simplesect>

  <simplesect>
    <title lang="en">Parameter Settings</title>
    <title lang="fr">Réglage des paramètres</title>    

    <informaltable rowsep='0' colsep='0' frame='none' lang="en">
      <tgroup cols='3'>
      <tbody>
      <row>
        <entry><mediaobject><imageobject>
          <imagedata fileref='../images/filters/examples/whirlpinch-orig.png' format="PNG"/>
        </imageobject></mediaobject></entry>
        <entry><mediaobject><imageobject>
          <imagedata fileref='../images/filters/examples/whirlpinch-whirl.png' format="PNG"/>
        </imageobject></mediaobject></entry>
        <entry><mediaobject><imageobject>
          <imagedata fileref='../images/filters/examples/whirlpinch-pinch.png' format="PNG"/>
        </imageobject></mediaobject></entry>
      </row>
      <row>
        <entry align='center'>
          <para lang='en'>Original</para>
        </entry>
        <entry align='center'>
          <para lang='en'>Whirled</para>
        </entry>
        <entry align='center'>
          <para lang='en'>Pinched</para>
        </entry>
      </row>
      </tbody>
      </tgroup>
    </informaltable>

    <para lang="en">
      Changes to parameters are immediately displayed into the 
      <emphasis>Preview</emphasis>. The whirlpool is focused around the 
      center of the current layer or selection.
    </para>

    <para lang="fr">
      Les modifications apportées aux paramètres apparaissent aussitôt dans 
      l'<emphasis>Aperçu</emphasis>. Le tourbillon est centré sur le centre 
      du calque actif ou de la sélection.
    </para>

          <para lang="en">
            <guilabel>Whirl Angle</guilabel>: Clockwise or counter 
            clockwise (-360 to +360). Controls how many degrees the
            affected part of the image is rotated.   
          </para>
          <para lang="en">
            <guilabel>Pinch Amount</guilabel>: Whirlpool depth(-1 to
            +1).  Determines how strongly the affected part of the
            image is pinched.
          </para>
          <para lang="en">
            <guilabel>Radius</guilabel>: Whirlpool width (0.0-2.0). 
            Determines how much of the image is affected by the
            distortion.  If you set <parameter>Radius</parameter> to
            2, the entire image will be affected. If you set
            <parameter>Radius</parameter> to 1, half the image will 
            be affected. If <parameter>Radius</parameter> is set to 0,
            nothing will be 
            affected (think of it as the radius in a circle with 0 in
            the center and 1 halfway out).  
          </para>

          <para lang="fr">
            <guilabel>Angle de rotation</guilabel>: C'est l'angle de 
            rotation du tourbillon, dans un sens ou dans l'autre 
            (-360 +360).
          </para>
          <para lang="fr">
            <guilabel>Quantité d'aspiration</guilabel>: Règle la prodondeur 
            du tourbillon (-1 +1). Une valeur négative donne un tourbillon 
            venant vers vous.
          </para>
          <para lang="fr">
            <guilabel>Rayon</guilabel>: Règle la largeur du tourbillon 
            (0.0-2.0). 
          </para>
   
  </simplesect>
</sect2>
