[gimp-help] Update polar_coordinates filter. Move Use selection as input option to common features.



commit 405c2b0a8226505fde116f95cf0ec34c81cec14e
Author: Julien Hardelin <jhardlin orange fr>
Date:   Mon Dec 24 08:43:49 2018 +0100

    Update polar_coordinates filter. Move Use selection as input option to common features.

 images/C/filters/distort/polar_coords-dialog.png | Bin 0 -> 29784 bytes
 images/C/filters/distort/polarcoords.png         | Bin 30238 -> 0 bytes
 images/C/filters/use_entire_layer.jpg            | Bin 0 -> 40387 bytes
 images/C/filters/use_selection_only.jpg          | Bin 0 -> 41814 bytes
 src/filters/common-features.xml                  |  31 +++++++++++++
 src/filters/distort/polarcoords.xml              |  54 +++++++++++++++++------
 src/filters/distort/spherize.xml                 |  18 ++------
 7 files changed, 75 insertions(+), 28 deletions(-)
---
diff --git a/images/C/filters/distort/polar_coords-dialog.png 
b/images/C/filters/distort/polar_coords-dialog.png
new file mode 100644
index 000000000..6475ea037
Binary files /dev/null and b/images/C/filters/distort/polar_coords-dialog.png differ
diff --git a/images/C/filters/use_entire_layer.jpg b/images/C/filters/use_entire_layer.jpg
new file mode 100644
index 000000000..245ddbdfa
Binary files /dev/null and b/images/C/filters/use_entire_layer.jpg differ
diff --git a/images/C/filters/use_selection_only.jpg b/images/C/filters/use_selection_only.jpg
new file mode 100644
index 000000000..ff7bd972e
Binary files /dev/null and b/images/C/filters/use_selection_only.jpg differ
diff --git a/src/filters/common-features.xml b/src/filters/common-features.xml
index e74cdd06d..cec0367de 100644
--- a/src/filters/common-features.xml
+++ b/src/filters/common-features.xml
@@ -78,5 +78,36 @@
         </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>
+          <para>
+            If this option is selected, selection contents is made from the 
+            entire layer. The layer outside the selection remains normal.
+          </para>
+          <mediaobject>
+            <imageobject>
+              <imagedata format="JPG"
+              fileref="images/filters/use_entire_layer.jpg"/>
+            </imageobject>
+          </mediaobject>
+        </listitem>
+      </varlistentry>
   </variablelist>
 </sect1>
\ No newline at end of file
diff --git a/src/filters/distort/polarcoords.xml b/src/filters/distort/polarcoords.xml
index f0b3660ce..9849d1a2d 100644
--- a/src/filters/distort/polarcoords.xml
+++ b/src/filters/distort/polarcoords.xml
@@ -2,26 +2,24 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
-  2007-04-24 KoSt: added 'no'
-  2005-12-07 replaced <simplesect> by <sect3> by lexa
-  050910 de added by axel.wernicke
+  2018-12-23 j.h: update to v-2.10
 -->
 <sect2 id="gimp-filter-polar-coordinates">
-  <title>Polar Coords</title>
+  <title>Polar Coordinates</title>
 
   <indexterm>
     <primary>Filters</primary>
     <secondary>Distorts</secondary>
-    <tertiary>Polar Coords</tertiary>
+    <tertiary>Polar Coordinates</tertiary>
   </indexterm>
   <indexterm>
-    <primary>Polar Coords</primary>
+    <primary>Polar Coordinates</primary>
   </indexterm>
 
   <sect3>
     <title>Overview</title>
     <figure>
-      <title>Example for Polar Coords filter</title>
+      <title>Example for Polar Coordinates filter</title>
       <mediaobject>
         <imageobject>
           <imagedata format="JPG"
@@ -37,7 +35,7 @@
             fileref="images/filters/examples/distort-taj-polarcoords.jpg"/>
         </imageobject>
         <caption>
-          <para><quote>Polar Coords</quote> filter applied</para>
+          <para><quote>Polar Coordinates</quote> filter applied</para>
         </caption>
       </mediaobject>
     </figure>
@@ -54,7 +52,7 @@
       <menuchoice>
         <guimenu>Filters</guimenu>
         <guisubmenu>Distorts</guisubmenu>
-        <guimenuitem>Polar Coords…</guimenuitem>
+        <guimenuitem>Polar Coordinates…</guimenuitem>
       </menuchoice>.
     </para>
   </sect3>
@@ -62,21 +60,21 @@
   <sect3>
     <title>Options</title>
     <figure>
-      <title><quote>Polar Coords</quote> filter options</title>
+      <title><quote>Polar Coordinates</quote> filter options</title>
       <mediaobject>
         <imageobject>
           <imagedata format="PNG"
-            fileref="images/filters/distort/polarcoords.png"/>
+            fileref="images/filters/distort/polar_coords-dialog.png"/>
         </imageobject>
       </mediaobject>
     </figure>
     <variablelist>
       <varlistentry>
-        <term>Preview</term>
+        <term>Presets, Preview, Split view</term>
         <listitem>
           <para>
-            The result of your settings will appear in the Preview without
-            affecting the image until you click on <guibutton>OK</guibutton>.
+            These options are common to GEGL-based filters. Please refer to 
+            <xref linkend="gimp-filters-common"/>.
           </para>
         </listitem>
       </varlistentry>
@@ -126,6 +124,34 @@
           </para>
         </listitem>
       </varlistentry>
+      <varlistentry>
+        <term>X, Y</term>
+        <listitem>
+          <para>
+            These polar coordinates are active only if the <quote>Choose 
+            middle</quote> option is unchecked.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Choose middle</term>
+        <listitem>
+          <para>
+            Checked by default: origin center is at the middle of the layer. If 
+            unchecked, you can modify X an Y parameters to position the origin 
+            center.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Use the selection as input, Use the entire layer as input</term>
+        <listitem>
+          <para>
+            These options are common to GEGL-based filters. Please refer to 
+            <xref linkend="gimp-filters-common"/>.
+          </para>
+        </listitem>
+      </varlistentry>
     </variablelist>
   </sect3>
 
diff --git a/src/filters/distort/spherize.xml b/src/filters/distort/spherize.xml
index bb0229cd5..3b6432505 100644
--- a/src/filters/distort/spherize.xml
+++ b/src/filters/distort/spherize.xml
@@ -70,8 +70,7 @@
     
     <variablelist>
       <varlistentry>
-        <term><guilabel>Presets</guilabel>, <guilabel>Preview</guilabel>, 
-          <guilabel>Split view</guilabel></term>
+        <term>Presets, Preview, Split view</term>
         <listitem>
           <para>
             These options are common to GEGL-based filters. Please refer to 
@@ -167,20 +166,11 @@
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term><guilabel>Use the selection as input</guilabel></term>
+        <term>Use the selection as input, Use the entire layer as input</term>
         <listitem>
           <para>
-            If this option is selected, the filter uses pixels in selection 
-            only.
-          </para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><guilabel>Use the entire layer as input</guilabel></term>
-        <listitem>
-          <para>
-            If this option is selected, the filter uses pixels adjacent to the 
-            selection to create a more progressive border.
+            These options are common to GEGL-based filters. Please refer to 
+            <xref linkend="gimp-filters-common"/>.
           </para>
         </listitem>
       </varlistentry>


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]