[gimp-help] Update common GEGL filter options documentation

[Jacob Boerema <jboerema src gnome org>]

commit be23471e151d71b1d8e00fc519583844156c55c4
Author: Jacob Boerema <jgboerema gmail com>
Date:   Sat May 28 21:53:06 2022 -0400

    Update common GEGL filter options documentation

 images/C/filters/common/filter-options-common.png | Bin 16368 -> 16963 bytes
 src/filters/common-features.xml                   | 121 +++++++++++++---------
 2 files changed, 74 insertions(+), 47 deletions(-)
---
diff --git a/images/C/filters/common/filter-options-common.png 
b/images/C/filters/common/filter-options-common.png
index 59211a87d..2d14f06a9 100644
Binary files a/images/C/filters/common/filter-options-common.png and 
b/images/C/filters/common/filter-options-common.png differ
diff --git a/src/filters/common-features.xml b/src/filters/common-features.xml
index ca4f4eaca..af33d521e 100644
--- a/src/filters/common-features.xml
+++ b/src/filters/common-features.xml
@@ -8,11 +8,11 @@
   <title>Common Features</title>
 
   <para>
-    With GIMP-2.10, GEGL has been applied to most filters. These filters have 
-    some options in common:
+    Since <acronym>GIMP</acronym> 2.10, most filters are <acronym>GEGL</acronym>
+    filters. These have several options in common:
   </para>
   <figure>
-    <title>Filters Common Options</title>
+    <title>Common Options of GEGL Filters</title>
     <mediaobject>
       <imageobject>
         <imagedata format="PNG"
@@ -26,32 +26,33 @@
       <term>Presets</term>
       <listitem>
         <para>
-          Filters presets are different from tool presets.
+          Filter presets are similar to tool presets, in that you can save
+          your favorite settings and recall them when needed. They consist
+          of:
         </para>
         <itemizedlist>
           <listitem>
             <para>
-              A <emphasis role="bold">text box</emphasis> to enter a preset 
-              name or choose it in a drop down list.
+              A <emphasis role="bold">drop down list</emphasis> that shows the
+              current preset and lets you choose a different one.
             </para>
           </listitem>
           <listitem>
-            <para> A
+            <para>
               <guiicon>
                 <inlinegraphic 
                 fileref="images/filters/common/preset-icon-add.png"/>
               </guiicon> 
-                icon to save current settings as named preset.
+              An icon to save the current settings as a named preset.
             </para>
           </listitem>
           <listitem>
             <para>
-              A 
               <guiicon>
                 <inlinegraphic
                  fileref="images/filters/common/preset-icon-manage.png"/>
               </guiicon> 
-                icon to manage preset.
+              An icon that opens a menu with options to manage presets.
             </para>
           </listitem>
         </itemizedlist>
@@ -59,59 +60,85 @@
     </varlistentry>
 
     <varlistentry>
-      <term>Preview</term>
+      <term>Input Type</term>
+      <listitem>
+        <note> 
+          <para>
+            The input type dropdown list is only visible when a selection
+            is available.
+          </para>
+        </note>
+      </listitem>
+      <listitem>
+        <para>
+          <guilabel>Use the selection as input</guilabel> If this option is
+          selected, the filter only uses pixels inside the selection as
+          input for the filter.
+        </para>
+        <mediaobject>
+          <imageobject>
+            <imagedata format="JPG"
+            fileref="images/filters/use_selection_only.jpg"/>
+          </imageobject>
+        </mediaobject>
+      </listitem>
       <listitem>
         <para>
-          When this option is checked (default), changes in image are directly 
-          displayed in canvas. They are not applied to the image until you 
-          click on the <guibutton>OK</guibutton> button.
+          <guilabel>Use the entire layer as input</guilabel> If this option
+          is selected, the input of the filter is the entire layer. The
+          ouput will only affect the selection. The layer outside the
+          selection remains unchanged.
         </para>
+        <mediaobject>
+          <imageobject>
+            <imagedata format="JPG"
+            fileref="images/filters/use_entire_layer.jpg"/>
+          </imageobject>
+        </mediaobject>
       </listitem>
     </varlistentry>
-    
+
     <varlistentry>
-      <term>Split view</term>
+      <term>Blending Options</term>
       <listitem>
         <para>
-          When this option is checked, the image view is divided in two parts, 
-          filter applied on the left, filter not applied on the right.
+          When you expand this option by clicking the +, you can choose the
+          blend <guilabel>Mode</guilabel> to be used when applying the filter,
+          and the <guilabel>Opacity</guilabel>.
+          These work the same as the Layer
+          <xref linkend="gimp-layer-dialog-paint-mode-menu"/> blending options.
         </para>
+      </listitem>
+    </varlistentry>
+
+    <varlistentry>
+      <term>Preview</term>
+      <listitem>
         <para>
-          Click-and-drag this split line to move it, and 
-          <keycap>Ctrl</keycap>-click it to make it horizontal.
+          When this option is enabled (default), changes in the filter settings
+          are directly displayed on canvas. They are not applied to the image
+          until you click the <guibutton>OK</guibutton> button.
         </para>
       </listitem>
     </varlistentry>
     
     <varlistentry>
-        <term><guilabel>Use the selection as input</guilabel></term>
-        <listitem>
-          <para>
-            If this option is selected, the filter uses pixels in selection 
-            only.
-          </para>
-          <mediaobject>
-            <imageobject>
-              <imagedata format="JPG"
-              fileref="images/filters/use_selection_only.jpg"/>
-            </imageobject>
-          </mediaobject>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><guilabel>Use the entire layer as input</guilabel></term>
-        <listitem>
+      <term>Split view</term>
+      <listitem>
+        <para>
+          When this option is enabled, the view of the image is divided in two
+          parts. On the left side it shows the effect of the filter applied,
+          and on the right side it shows the image without filter.
+        </para>
+        <note>
           <para>
-            If this option is selected, selection contents is made from the 
-            entire layer. The layer outside the selection remains normal.
+            You can click-and-drag the line that divides the preview to move it,
+            and <keycap>Ctrl</keycap>-click to make the line horizontal, or
+            to switch it back to vertical.
           </para>
-          <mediaobject>
-            <imageobject>
-              <imagedata format="JPG"
-              fileref="images/filters/use_entire_layer.jpg"/>
-            </imageobject>
-          </mediaobject>
-        </listitem>
-      </varlistentry>
+        </note>
+      </listitem>
+    </varlistentry>
+    
   </variablelist>
 </sect1>
\ No newline at end of file