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

<sect2 id='plug-in-vpropagate' lang="en;fr">
  <title lang="en">Value Propagate</title>
  <title lang="fr">Propagation de Valeur</title>

  <indexterm>
    <primary lang="en">Value Propagate</primary>
    <primary lang="fr">Propagation de Valeur</primary>
  </indexterm>

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

  <mediaobject lang="fr">
    <imageobject>
      <imagedata fileref='../images/filters/fr/filters-distort-vpropagate.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>V</accel>alue Propagate</guimenuitem>
          </para>
          <para lang="en">
            It works on color borders. It spreads pixels that have a Value 
            between selected thresholds, in selected directions.
          </para>

          <para lang="fr">
            Ce filtre se trouve dans
            <guimenuitem>Image&gt;Filtres/Distorsions/<accel>P</accel>ropagation de valeur</guimenuitem>
          </para>
          <para lang="fr">
            Ce filtre agit sur les limites entre les couleurs. Il étend les 
            pixels, figurant dans une gamme de Valeurs choisie, dans une 
            direction choisie. 
          </para>
  </simplesect>

  <simplesect>
    <title lang="en">Options</title>
    <title lang="fr">Options</title>
    <variablelist>
      <varlistentry>
        <term lang="en">Propagate Mode</term>
        <term lang="fr">Mode de propagation</term>
        <listitem lang="en">
           <para>
             The examples will be about the following image (zomm x8):
             <mediaobject>
               <imageobject>
                 <imagedata fileref='../images/filters/examples/vpropag0-en.png' format="PNG"/>
               </imageobject>
             </mediaobject>
           </para>

          <itemizedlist>
            <listitem>
              <para>
                <guilabel>More White</guilabel>: Pixels will be propagated 
                from upper Value pixels towards lower Value pixels. So bright 
                areas will enlarge.
                <mediaobject>
                  <imageobject>
                    <imagedata fileref='../images/filters/examples/vpropag1.png' format="PNG"/>
                  </imageobject>
                </mediaobject>
              </para>
            </listitem>
            <listitem>
              <para>
                <guilabel>More Black</guilabel>: Pixels will be propagated 
                from lower Value pixels towards upper Value pixels. So dark 
                areas will enlarge.
                <mediaobject>
                  <imageobject>
                    <imagedata fileref='../images/filters/examples/vpropag2.png' format="PNG"/>
                  </imageobject>
                </mediaobject>
              </para>
            </listitem>
            <listitem>
              <para>
                <guilabel>Middle Value to Peaks</guilabel>: On a border between 
                the selected thresholds, it blends the two colors.
                <mediaobject>
                  <imageobject>
                   <imagedata fileref='../images/filters/examples/vpropag3.png' format="PNG"/>
                  </imageobject>
                </mediaobject>
              </para>
            </listitem>
            <listitem>
              <para>
                <guilabel>Foregound to Peaks</guilabel>: The propagated areas 
                will be filled with the foreground color of the toolbox.  
                <mediaobject>
                  <imageobject>
                    <imagedata fileref='../images/filters/examples/vpropag4.png' format="PNG"/>
                  </imageobject>
                </mediaobject>
              </para>
            </listitem>
            <listitem>
              <para>
                <guilabel>Only Foreground</guilabel>: Only areas with the 
                Foreground color will propagate.
                <mediaobject>
                  <imageobject>
                    <imagedata fileref='../images/filters/examples/vpropag5.png' format="PNG"/>
                  </imageobject>
                </mediaobject>
              </para>
            </listitem>
            <listitem>
              <para>
                <guilabel>Only Background</guilabel>: Only areas with the 
                Background color will propagate. 
              </para>
            </listitem>
            <listitem>
              <para>
                <guilabel>More Opaque</guilabel> and <guilabel>More Tranparent</guilabel>: 
                These commands work like More White and More Black. Propagated 
                areas will be more opaque or more transparent. These commands 
                need an image with an Alpha channel.
              </para>  
            </listitem>

          </itemizedlist>
        </listitem>

        <listitem lang="fr">
           <para>
             Les exemples donnés porteront sur l'image suivante (en zoom x8):
             <mediaobject>
               <imageobject>
                 <imagedata fileref='../images/filters/examples/vpropag0-fr.png' format="PNG"/>
               </imageobject>
             </mediaobject>
           </para>
           <itemizedlist>
            <listitem>
              <para>
                <guilabel>Plus blanc</guilabel>: L'extension se fait des 
                pixels de plus grande Valeur vers les pixels de plus faible 
                Valeur. On a donc une extension des zones les plus claires.  
                <mediaobject>
                  <imageobject>
                   <imagedata fileref='../images/filters/examples/vpropag1.png' format="PNG"/>
                  </imageobject>
                </mediaobject>
              </para>
            </listitem>
            <listitem>
              <para> 
                <guilabel>Plus noir</guilabel>: L'extension se fait des 
                pixels de plus faible Valeur vers les pixels de plus forte 
                Valeur et donc étend les pixels les plus sombres.
                <mediaobject>
                  <imageobject>
                   <imagedata fileref='../images/filters/examples/vpropag2.png' format="PNG"/>
                  </imageobject>
                </mediaobject>
              </para> 
            </listitem>
            <listitem>
              <para>
                <guilabel>Valeur médiane vers pics</guilabel>: À la limite 
                de deux couleurs, étend sur la couleur de plus forte 
                valeur (pic) un dégradé entre les deux couleurs. 
                <mediaobject>
                  <imageobject>
                   <imagedata fileref='../images/filters/examples/vpropag3.png' format="PNG"/>
                  </imageobject>
                </mediaobject>
              </para>
            </listitem>
            <listitem>
              <para>
                <guilabel>Premier-plan vers pics</guilabel>: Les zones 
                d'extension sont remplies par la couleur de premier-plan de 
                la boîte à outils.
                <mediaobject>
                  <imageobject>
                   <imagedata fileref='../images/filters/examples/vpropag4.png' format="PNG"/>
                  </imageobject>
                </mediaobject>
              </para>
            </listitem>
            <listitem>
              <para>
                <guilabel>Uniquement le premier-plan</guilabel>: Seules les 
                zones ayant la couleur du premier-plan seront affectées par 
                l'extension. Si la limite où se produit l'extension n'est 
                pas nette, l'extension démarrera dès le début du dégradé.
                <mediaobject>
                  <imageobject>
                   <imagedata fileref='../images/filters/examples/vpropag5.png' format="PNG"/>
                  </imageobject>
                </mediaobject>
              </para>
            </listitem>
            <listitem>
              <para> 
                <guilabel>Uniquement l'Arrière-plan</guilabel>: Seules les 
                zones ayant la couleur de l'arrière-plan seront affectées 
                par l'extension. 
              </para>
            </listitem>
            <listitem>
              <para>
                <guilabel>Plus Opaque</guilabel> et <guilabel>Plus transparent</guilabel>: 
                Fonctionnent de la même façon que Plus blanc et Plus noir, 
                les extensions étant rendues plus opaques ou plus 
                transparentes. Ces commandes ne conviennent qu'aux images 
                possédant un canal Alpha. 
              </para>
            </listitem>

          </itemizedlist>
        </listitem>
      </varlistentry>

	    <varlistentry>
        <term lang="en">Parameters Settings</term>
        <term lang="fr">Réglage des paramètres</term>
        <listitem lang="en">
          <itemizedlist>
            <listitem> 
              <para>
                <guilabel>Lower Threshold</guilabel> and <guilabel>Upper Threshold</guilabel>:  
                These commands allow you to set the Value range that will 
                be concerned by Propagate.
              </para>
            </listitem>
            <listitem> 
              <para>
                <guilabel>Propagating Rate</guilabel>: That's the 
                propagating amount. The higher it will be the more 
                colored the propagation will be.
              </para>
            </listitem>
            <listitem> 
              <para>
                <guilabel>Propagating Direction</guilabel>: You can select 
                one or more directions. 
              </para>
            </listitem> 
          </itemizedlist>
        </listitem> 
        <listitem lang="fr">
          <itemizedlist>
            <listitem> 
              <para>
                <guilabel>Seuil bas</guilabel> et <guilabel>Seuil haut</guilabel>: 
                permettent de définir l'intervalle de Valeur sur lequel 
                portera la propagation.
              </para>
            </listitem>
            <listitem> 
              <para>
                <guilabel>Taux de propagation</guilabel>: C'est le montant 
                de la propagation. Plus il est élevé et plus la zone 
                d'extension sera chargée en couleur.
               </para>
            </listitem>
            <listitem> 
              <para>
                <guilabel>Direction de propagation</guilabel>: Vous pouvez 
                choisir une ou plusieurs directions de propagation.
              </para>
            </listitem> 
          </itemizedlist>
        </listitem>   
      </varlistentry>
   </variablelist>
 </simplesect>
</sect2>
