GNOME.org
 

[gimp-help] Update distorts/emboss filter

commit a21dede20d951616e8ba3349103ef436c94fd613
Author: Julien Hardelin <jhardlin orange fr>
Date:   Thu Dec 13 08:31:05 2018 +0100

    Update distorts/emboss filter

 images/C/filters/distort/emboss-dialog.png | Bin 0 -> 21096 bytes
 src/filters/distort.xml                    |   7 +-
 src/filters/distort/emboss-legacy.xml      | 141 +++++++++++++++++++++++++++++
 src/filters/distort/emboss.xml             |  45 ++++++---
 4 files changed, 175 insertions(+), 18 deletions(-)
---
diff --git a/images/C/filters/distort/emboss-dialog.png b/images/C/filters/distort/emboss-dialog.png
new file mode 100644
index 000000000..fc2d1b67c
Binary files /dev/null and b/images/C/filters/distort/emboss-dialog.png differ
diff --git a/src/filters/distort.xml b/src/filters/distort.xml
index 845bb57ec..e677c716b 100644
--- a/src/filters/distort.xml
+++ b/src/filters/distort.xml
@@ -2,10 +2,7 @@
 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
-  2007-12-26 ciampix: addedd en and it menu screenshots
-  2007-08-15 Added Spanish translation by AntI
-  2007-04-23 KoSt: added 'no'
-  050904 de added by axel.wernicke
+  
 -->
 <sect1 xmlns:xi="http://www.w3.org/2001/XInclude"; id="filters-distort">
   <title>Distort Filters</title>
@@ -34,7 +31,7 @@
   <xi:include href="distort/whirlpinch.xml"/>
   <xi:include href="distort/wind.xml"/>
   <xi:include href="distort/curve_bend.xml"/>
-  <!--<xi:include href="distort/emboss (legacy).xml"/>-->
+  <xi:include href="distort/emboss-legacy.xml"/>
   <xi:include href="distort/newsprint.xml"/>
   <xi:include href="distort/pagecurl.xml"/>
 
diff --git a/src/filters/distort/emboss-legacy.xml b/src/filters/distort/emboss-legacy.xml
new file mode 100644
index 000000000..1c85d34fe
--- /dev/null
+++ b/src/filters/distort/emboss-legacy.xml
@@ -0,0 +1,141 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+                       "http://www.docbook.org/xml/4.3/docbookx.dtd";>
+<!-- section history:
+  2018-12-05 j.h: rename to emboss (legacy)
+-->
+<sect2 id="plug-in-emboss">
+  <title>Emboss (legacy)</title>
+
+  <indexterm>
+    <primary>Filters</primary>
+    <secondary>Distorts</secondary>
+    <tertiary>Emboss (legacy)</tertiary>
+  </indexterm>
+  <indexterm>
+    <primary>Emboss (legacy)</primary>
+  </indexterm>
+
+  <sect3>
+    <title>Overview</title>
+    <figure>
+      <title>Applying example for the Emboss (legacy) filter</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/taj_orig.jpg"/>
+        </imageobject>
+        <caption>
+          <para>Original image</para>
+        </caption>
+      </mediaobject>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/distort-taj-emboss.jpg"/>
+        </imageobject>
+        <caption>
+          <para>Filter <quote>Emboss (legacy)</quote> applied</para>
+        </caption>
+      </mediaobject>
+    </figure>
+    <para>
+      This filter stamps and carves the active layer or selection, giving it
+      relief with bumps and hollows. Bright areas are raised and dark ones are
+      carved. You can vary the lighting.
+    </para>
+    <para>
+      You can use the filter only with RGB images. If your image is grayscale,
+      it will be grayed out in the menu.
+    </para>
+  </sect3>
+
+  <sect3>
+    <title>Starting filter</title>
+    <para>
+      You can find this filter through
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Distorts</guisubmenu>
+        <guimenuitem>Emboss (legacy)…</guimenuitem>
+      </menuchoice>.
+    </para>
+  </sect3>
+
+  <sect3>
+    <title>Options</title>
+    <figure>
+      <title><quote>Emboss (legacy)</quote> filter options</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/distort/emboss.png"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+    <variablelist>
+      <varlistentry>
+        <term>Preview</term>
+        <listitem>
+          <para>
+            All your setting changes will appear in the Preview without
+            affecting the image until you click on <guilabel>OK</guilabel>.
+            Don't keep <guilabel>Preview</guilabel> checked if your computer
+            is too slow.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Function</term>
+        <listitem>
+          <variablelist>
+            <varlistentry>
+              <term><guilabel>Bumpmap</guilabel></term>
+              <listitem>
+                <para>
+                  Relief is smooth and colors are preserved.
+                </para>
+              </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term><guilabel>Emboss</guilabel></term>
+              <listitem>
+                <para>
+                  It turns your image to grayscale and relief is more marked,
+                  looking like metal.
+                </para>
+              </listitem>
+            </varlistentry>
+          </variablelist>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Azimuth</term>
+        <listitem>
+          <para>
+            This is about lighting according to the points of the compass (0 -
+            360). If you suppose South is at the top of your image, then East
+            (0°) is on the left. Increasing value goes counter-clockwise.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Elevation</term>
+        <listitem>
+          <para>
+            That's height from horizon (0°), in principle up to zenith (90°),
+            but here up to the opposite horizon (180°).
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Depth</term>
+        <listitem>
+          <para>
+            Bumps are higher and hollows deeper when Depth increases.
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect3>
+</sect2>
diff --git a/src/filters/distort/emboss.xml b/src/filters/distort/emboss.xml
index 82a2d24e1..648ba58d0 100644
--- a/src/filters/distort/emboss.xml
+++ b/src/filters/distort/emboss.xml
@@ -2,11 +2,7 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
-  2008-06-02 j.h fr renamed "repoussage" to "relief"
-  2007-08-12 Added Spanish translation by AntI
-  2007-04-23 KoSt: added 'no'
-  2005-12-07 replaced <simplesect> by <sect3> by lexa
-  050905 de added by axel.wernicke
+  2018-12-05 j.h: create
 -->
 <sect2 id="gimp-filter-emboss">
   <title>Emboss</title>
@@ -73,19 +69,18 @@
       <mediaobject>
         <imageobject>
           <imagedata format="PNG"
-            fileref="images/filters/distort/emboss.png"/>
+            fileref="images/filters/distort/emboss-dialog.png"/>
         </imageobject>
       </mediaobject>
     </figure>
     <variablelist>
       <varlistentry>
-        <term>Preview</term>
+        <term><guilabel>Presets</guilabel>, <guilabel>Preview</guilabel>, 
+          <guilabel>Split view</guilabel></term>
         <listitem>
           <para>
-            All your setting changes will appear in the Preview without
-            affecting the image until you click on <guilabel>OK</guilabel>.
-            Don't keep <guilabel>Preview</guilabel> checked if your computer
-            is too slow.
+            These options are common to GEGL-based filters. Please refer to 
+            <xref linkend="gimp-filters-common"/>.
           </para>
         </listitem>
       </varlistentry>
@@ -113,6 +108,31 @@
           </variablelist>
         </listitem>
       </varlistentry>
+      <varlistentry>
+        <term>Emboss Type</term>
+        <listitem>
+          <variablelist>
+            <varlistentry>
+              <term><guilabel>Emboss</guilabel></term>
+              <listitem>
+                <para>
+                  Default: it turns your image to grayscale and relief is 
+                  more marked, looking like metal. Although the image looks 
+                  grayscale, it remains a RGB image.
+                </para>
+              </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term><guilabel>Bumpmap</guilabel></term>
+              <listitem>
+                <para>
+                  Relief is smooth and colors are preserved.
+                </para>
+              </listitem>
+            </varlistentry>
+          </variablelist>
+        </listitem>
+      </varlistentry>
       <varlistentry>
         <term>Azimuth</term>
         <listitem>
@@ -136,8 +156,7 @@
         <term>Depth</term>
         <listitem>
           <para>
-            Seems to be the distance of the light source. Light decreases when
-            value increases.
+            Bumps are higher and hollows deeper when Depth increases.
           </para>
         </listitem>
       </varlistentry>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]