[gimp-help] Update Bump Map filter



commit 30d02d17c100a762e671f3596fd9a86a107018f1
Author: Julien Hardelin <jhardlin orange fr>
Date:   Thu Feb 7 18:48:03 2019 +0100

    Update Bump Map filter

 images/C/filters/examples/map/bumpmap-ex-1.png | Bin 0 -> 4935 bytes
 images/C/filters/examples/map/bumpmap-ex-2.png | Bin 0 -> 7190 bytes
 images/C/filters/map/bumpmap-dialog.png        | Bin 0 -> 39333 bytes
 images/C/filters/map/bumpmap.png               | Bin 39182 -> 0 bytes
 src/filters/map/bumpmap.xml                    | 129 ++++++++++++++++++-------
 5 files changed, 96 insertions(+), 33 deletions(-)
---
diff --git a/images/C/filters/examples/map/bumpmap-ex-1.png b/images/C/filters/examples/map/bumpmap-ex-1.png
new file mode 100644
index 000000000..85282ab2e
Binary files /dev/null and b/images/C/filters/examples/map/bumpmap-ex-1.png differ
diff --git a/images/C/filters/examples/map/bumpmap-ex-2.png b/images/C/filters/examples/map/bumpmap-ex-2.png
new file mode 100644
index 000000000..7beafe4ed
Binary files /dev/null and b/images/C/filters/examples/map/bumpmap-ex-2.png differ
diff --git a/images/C/filters/map/bumpmap-dialog.png b/images/C/filters/map/bumpmap-dialog.png
new file mode 100644
index 000000000..543ddf702
Binary files /dev/null and b/images/C/filters/map/bumpmap-dialog.png differ
diff --git a/src/filters/map/bumpmap.xml b/src/filters/map/bumpmap.xml
index 67f9e4a88..4436517ea 100644
--- a/src/filters/map/bumpmap.xml
+++ b/src/filters/map/bumpmap.xml
@@ -2,17 +2,10 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
-  2008-12-09 ude: moved "activate filter" paras to separate sect3
-  2007-12-05 j.h: some more explanation after a message on a forum, en;fr
-  2007-09-06 AntI: added 'es'
-  2007-05-21 updated Elevation
-  2007-05-06 KoSt: added 'no'
-  2006-12-12 lexa: added german translation
-  2005-12-07 replaced <simplesect> by <sect3> by lexa
-  2005-11-30 replaced informalfigure by axel.wernicke
-  2005-09-30 created by julien hardelin
+  2019-01-28 j.h: update to v2.10
+  2005-09-30 j.h create
 -->
-<sect2 id="gimp-filter-bump-map">
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-bump-map">
   <title>Bump Map</title>
 
   <indexterm>
@@ -73,33 +66,35 @@
       <mediaobject>
         <imageobject>
           <imagedata format="PNG"
-            fileref="images/filters/map/bumpmap.png"/>
+            fileref="images/filters/map/bumpmap-dialog.png"/>
         </imageobject>
       </mediaobject>
     </figure>
     <variablelist>
       <varlistentry>
-        <term>Preview</term>
+        <term>Presets, Preview, Split view</term>
         <listitem>
-          <para>
-            If checked, parameter setting results are interactively displayed
-            in preview.  Scroll bars allow you to move around the image.
-          </para>
+          <xi:include href="../about-common-features.xml"/>
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Bump map</term>
+        <term>Aux. Input</term>
         <listitem>
           <para>
-            This drop-down list allows you to select the image that will be
-            used as a map for bump-mapping. This list contains images that are
-            present on your screen when you launch the filter. Images opened
-            after starting filter are not present in this list.
+            Clicking on this button opens a small file browser with two panels. 
+            On the left panel, images present on your screen are listed: the 
+            active image is selected. On the right panel, you see the layers list 
+            of the active image: double click on the layer you want to use as a 
+            map for bump-mapping; the file browser is closed and a layer 
+            thumbnail appears in the Aux Input button.
+          </para>
+          <para>
+            The right panel has a <quote>Channel</quote> tab: TODO
           </para>
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Map type</term>
+        <term>Type</term>
         <listitem>
           <para>
             This option allows you to define the method that will be used
@@ -115,18 +110,18 @@
               </listitem>
             </varlistentry>
             <varlistentry>
-              <term><guilabel>Sinusoidal</guilabel></term>
+              <term><guilabel>Spherical</guilabel></term>
               <listitem>
                 <para>
-                  Bump height is a sinusoidal function of luminosity.
+                  Bump height is a spherical function of luminosity.
                 </para>
               </listitem>
             </varlistentry>
             <varlistentry>
-              <term><guilabel>Spheric</guilabel></term>
+              <term><guilabel>Sinusoidal</guilabel></term>
               <listitem>
                 <para>
-                  Bump height is a spheric function of luminosity.
+                  Bump height is a sinusoidal function of luminosity.
                 </para>
               </listitem>
             </varlistentry>
@@ -134,7 +129,7 @@
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Compensate for darkening</term>
+        <term>Compensate</term>
         <listitem>
           <para>
             Bump-mapping tends to darken image. You can compensate this
@@ -143,7 +138,7 @@
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Invert bumpmap</term>
+        <term>Invert</term>
         <listitem>
           <para>
             Bright pixels default to bumps and dark pixels to hollows. You can
@@ -152,7 +147,7 @@
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Tile bumpmap</term>
+        <term>Tiled</term>
         <listitem>
           <para>
             If you check this option, there will be no relief break if
@@ -162,7 +157,7 @@
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Azimut</term>
+        <term>Azimuth</term>
         <listitem>
           <para>
             This is about lighting according to the points of the compass
@@ -190,8 +185,8 @@
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>X offset</term>
-        <term>Y offset</term>
+        <term>Offset X</term>
+        <term>Offset Y</term>
         <listitem>
           <para>
             With this slider, you can adjust the map image position
@@ -215,7 +210,7 @@
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>Ambient</term>
+        <term>Ambient lighting factor</term>
         <listitem>
           <para>
             This slider controls the intensity of ambient light. With high
@@ -225,4 +220,72 @@
       </varlistentry>
     </variablelist>
   </sect3>
+  
+  <sect3>
+    <title>Using Bumpmap filter</title>
+    <para>
+      We shall emboss an image with a text.
+    </para>
+    <orderedlist>
+      <listitem>
+        <para>
+          Open your main image.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Create the map: here a white text on black background.
+          <mediaobject>
+            <imageobject>
+              <imagedata format="PNG"
+                fileref="images/filters/examples/map/bumpmap-ex-1.png"/>
+            </imageobject>
+            <caption>
+              <para>
+                The image and the map
+              </para>
+            </caption>
+          </mediaobject>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          <command>Edit/Copy the map</command>. Activate the image and 
+          <command>Edit/Past as/New Layer</command>. Right click on the new layer 
+            and apply <command>Layer to Image Size</command> to make the layer 
+            the same size as the image. 
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          The map layer being active, apply a Gaussian Blur. Here, the default 
+          1.5 pixels is used.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Make the map layer invisible and activate the image layer.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Open the <quote>Bump Map</quote> filter. Click on the 
+          <guibutton>Aux. Input</guibutton> button and double-click on the 
+          text layer in the right panel.
+          <mediaobject>
+            <imageobject>
+              <imagedata format="PNG"
+                fileref="images/filters/examples/map/bumpmap-ex-2.png"/>
+            </imageobject>
+            <caption>
+              <para>
+                Bump Map filter applied. Depth = 3. Ambient lighting 
+                factor&nbsp;=&nbsp;0.326.
+              </para>
+            </caption>
+          </mediaobject>
+        </para>
+      </listitem>
+    </orderedlist>
+  </sect3>
 </sect2>


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