GNOME.org
 

[gimp-help] Delete sharpen.xml. Update unsharp-mask.xml and fix issue #88.

commit 58aec808255de6217e9922c6c9c1d1b816f13276
Author: Julien Hardelin <jhardlin orange fr>
Date:   Sun Dec 2 08:38:12 2018 +0100

    Delete sharpen.xml. Update unsharp-mask.xml and fix issue #88.

 images/C/filters/enhance/sharpen-dialog.png       | Bin 0 -> 19501 bytes
 images/C/filters/enhance/sharpen.png              | Bin 32264 -> 0 bytes
 images/C/filters/enhance/unsharp-mask.png         | Bin 36381 -> 0 bytes
 images/C/filters/examples/enhance-taj-sharpen.jpg | Bin 35332 -> 0 bytes
 src/filters/enhance.xml                           |   1 -
 src/filters/enhance/sharpen.xml                   | 102 ----------------------
 src/filters/enhance/unsharp_mask.xml              |  39 ++++-----
 src/menus/image/scale.xml                         |   3 +-
 src/menus/layer/scale.xml                         |   6 +-
 src/menus/select/sharpen.xml                      |   3 +-
 src/using/photography.xml                         |  27 +++---
 11 files changed, 35 insertions(+), 146 deletions(-)
---
diff --git a/images/C/filters/enhance/sharpen-dialog.png b/images/C/filters/enhance/sharpen-dialog.png
new file mode 100644
index 000000000..b852723bb
Binary files /dev/null and b/images/C/filters/enhance/sharpen-dialog.png differ
diff --git a/src/filters/enhance.xml b/src/filters/enhance.xml
index 0febd6440..ce59e709a 100644
--- a/src/filters/enhance.xml
+++ b/src/filters/enhance.xml
@@ -25,5 +25,4 @@
   <xi:include href="enhance/destripe.xml"/>
   <xi:include href="enhance/NL_filter.xml"/>
   <xi:include href="enhance/wavelet-decompose.xml"/>
-  <xi:include href="enhance/sharpen.xml"/>
 </sect1>
diff --git a/src/filters/enhance/unsharp_mask.xml b/src/filters/enhance/unsharp_mask.xml
index af7e0a402..52c999a19 100644
--- a/src/filters/enhance/unsharp_mask.xml
+++ b/src/filters/enhance/unsharp_mask.xml
@@ -2,31 +2,25 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
-  2007-08-20 AntI: added 'es'
-  2007-04-15 KoSt: added 'no'
-  2007-02-10 lexa: translated new section to de
-  2007-01-24 translated new sect3 to it by alessandro falappa
+  2018-12-01 j.h: rename to Sharpen (Unsharp mask). Fix issue #88
   2006-12-17 Added a sect3 to explain Unsharp Mask by j.h
-  2005-12-07 replaced <simplesect> by <sect3> by lexa
-  050901 de added by axel.wernicke
-  050716 en added sect "more information"
 -->
 <sect2 id="gimp-filter-unsharp-mask">
-  <title>Unsharp Mask</title>
+  <title>Sharpen (Unsharp Mask)</title>
 
   <indexterm>
     <primary>Filters</primary>
     <secondary>Enhance</secondary>
-    <tertiary>Unsharp Mask</tertiary>
+    <tertiary>Sharpen (Unsharp Mask)</tertiary>
   </indexterm>
   <indexterm>
-    <primary>Unsharp Mask</primary>
+    <primary>Sharpen (Unsharp mask)</primary>
   </indexterm>
 
   <sect3>
     <title>Overview</title>
     <figure>
-      <title>Applying example for the Unsharp Mask filter</title>
+      <title>Applying example for the Sharpen filter</title>
       <mediaobject>
         <imageobject>
           <imagedata format="JPG"
@@ -42,7 +36,7 @@
             fileref="images/filters/examples/enhance-taj-unsharp-mask.jpg"/>
         </imageobject>
         <caption>
-          <para>Filter <quote>Unsharp mask</quote> applied</para>
+          <para>Filter <quote>Sharpen</quote> applied</para>
         </caption>
       </mediaobject>
     </figure>
@@ -55,7 +49,7 @@
       phenomenon appears when printing color dots on paper.
     </para>
     <para>
-      The Unsharp Mask filter (what an odd name!) sharpens edges of the
+      The Sharpen filter (old name was Unsharp Mask)) sharpens edges of the
       elements without increasing noise or blemish. It is the king of the
       sharpen filters.
     </para>
@@ -98,7 +92,7 @@
       <menuchoice>
         <guimenu>Filters</guimenu>
         <guisubmenu>Enhance</guisubmenu>
-        <guimenuitem>Unsharp Mask…</guimenuitem>
+        <guimenuitem>Sharpen (Unsharp Mask)…</guimenuitem>
       </menuchoice>.
     </para>
   </sect3>
@@ -106,11 +100,11 @@
   <sect3>
     <title>Options</title>
     <figure>
-      <title><quote>Unsharp Mask</quote> filter options</title>
+      <title><quote>Sharpen</quote> filter options</title>
       <mediaobject>
         <imageobject>
           <imagedata format="PNG"
-            fileref="images/filters/enhance/unsharp-mask.png"/>
+            fileref="images/filters/enhance/sharpen-dialog.png"/>
         </imageobject>
       </mediaobject>
     </figure>
@@ -177,14 +171,15 @@
       </imageobject>
     </mediaobject>
     <para>
-      Now, we have an image with some blur we want to sharpen (black curve).
-      We apply some more blur: the intensity variation will be more gradual
-      (green curve).
+      Now, we have an original image with some blur (black curve) we want to 
+      sharpen. We apply some more blur: the intensity variation will be 
+      more gradual (green curve).
     </para>
     <para>
-      Let us subtract the blurredness intensity from the intensity of the
-      image. We get the red curve, which is more abrupt: contrast and
-      sharpness are increased. QED.
+      Let us subtract the difference between blurredness intensity (green 
+      curve) and the intensity of the original image (black curve) to the 
+      intensity of the original image (black curve). We get the red 
+      curve, which is more abrupt: contrast and sharpness are increased. QED.
     </para>
     <mediaobject>
       <imageobject>
diff --git a/src/menus/image/scale.xml b/src/menus/image/scale.xml
index eb71074fa..11924fcf6 100644
--- a/src/menus/image/scale.xml
+++ b/src/menus/image/scale.xml
@@ -104,7 +104,8 @@
             enlarge an image, the more blurred it becomes. The appearance of
             an enlarged image depends upon the interpolation method you
             choose. You may improve the appearance by using the
-            <link linkend="plug-in-sharpen">Sharpen</link> filter after you
+            <link linkend="gimp-filter-unsharp-mask">Sharpen (Unsharp 
+            Mask)</link> filter after you
             have scaled an image, but it is best to use high resolution when
             you scan, take digital photographs or produce digital images by
             other means. Raster images inherently do not scale up well.
diff --git a/src/menus/layer/scale.xml b/src/menus/layer/scale.xml
index d1c642b01..6c9172c57 100644
--- a/src/menus/layer/scale.xml
+++ b/src/menus/layer/scale.xml
@@ -3,10 +3,7 @@
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
   2008-05-19 j.h: added Lanczos option
-  2007-06-18 Added Spanish translation by AntI
-  2007-03-12 Kolbjørn: added no translation
   2006-08-16 scb: revised 'en'
-  2005-11-10 split of from layer-mask.xml by axel.wernicke
 -->
 <sect2 id="gimp-layer-scale">
   <title>Scale Layer</title>
@@ -96,7 +93,8 @@
                   the more blurred it becomes. The exact result of the
                   enlargement depends upon the interpolation method you
                   choose. After scaling, you can improve the result by using
-                  the <link linkend="plug-in-sharpen">Sharpen</link> filter,
+                  the <link linkend="gimp-filter-unsharp-mask">Sharpen 
+                  (Unsharp Mask)</link> filter,
                   but it is much better for you to use a high resolution
                   when scanning, taking digital photographs or producing
                   digital images by other means. It is an inherent
diff --git a/src/menus/select/sharpen.xml b/src/menus/select/sharpen.xml
index 02b4e9c38..b0ddd4a4a 100644
--- a/src/menus/select/sharpen.xml
+++ b/src/menus/select/sharpen.xml
@@ -23,7 +23,8 @@
   <note>
     <para>
       Please do not confuse this command with the
-      <link linkend="plug-in-sharpen">Sharpen</link> filter.
+      <link linkend="gimp-filter-unsharp-mask">Sharpen (Unsharp Mask)</link> 
+filter.
     </para>
   </note>
 
diff --git a/src/using/photography.xml b/src/using/photography.xml
index 8f3e9e3f4..bf01d142c 100644
--- a/src/using/photography.xml
+++ b/src/using/photography.xml
@@ -478,12 +478,14 @@
       </para>
       <para>
         The most generally useful technique for sharpening a fuzzy image is
-        called the <link linkend="gimp-filter-unsharp-mask">Unsharp Mask</link>.
+        called the <link linkend="gimp-filter-unsharp-mask">Sharpen (Unsharp 
+        Mask</link>.
         In spite of the rather confusing name, which derives from its
         origins as a technique used by film developers, its result is to make
         the image sharper, not <quote>unsharp</quote>.
-        It is a plug-in, and you can access it as Filters-&gt;Enhance-&gt;Unsharp
-        Mask in the image menu. There are two parameters,
+        It is a plug-in, and you can access it as 
+        Filters-&gt;Enhance-&gt;Sharpen (Unsharp Mask) in the image menu. There 
+        are two parameters,
         <quote>Radius</quote> and <quote>Amount</quote>.
         The default values often work pretty well, so you should try them
         first. Increasing either the radius or the amount increases the
@@ -493,24 +495,19 @@
       </para>
       <tip>
         <para>
-          Sometimes using Unsharp Mask can cause color distortion where there
+          Sometimes using Sharpen (Unsharp Mask) can cause color distortion 
+          where there
           are strong contrasts in an image. When this happens, you can often
           get better results by decomposing the image into separate
-          Hue-Saturation-Value (HSV) layers, and running Unsharp Mask on the
-          Value layer only, then recomposing. This works because the human eye
-          has much finer resolution for brightness than for color. See the
-          sections on
+          Hue-Saturation-Value (HSV) layers, and running Sharpen (Unsharp Mask) 
+          on the Value layer only, then recomposing. This works because the 
+          human eye has much finer resolution for brightness than for color. See 
+          the sections on
           <link linkend="plug-in-decompose-registered">Decompose</link> and
           <link linkend="plug-in-compose">Compose</link> for more information.
         </para>
       </tip>
-      <para>
-        Next to "Unsharp Mask" in the Filters menu is another filter called
-        <link linkend="plug-in-sharpen">Sharpen</link>,
-        which does similar things. It is a little easier to use but not
-        nearly as effective: our recommendation is that you ignore it and go
-        straight to Unsharp Mask.
-      </para>
+      
       <para>
         In some situations, you may be able to get useful results by
         selectively sharpening specific parts of an image using the
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]