GNOME.org
 

[gimp-help] Add Vignette filter

commit 2f27062f4823195dbbdc1d8c8dc3361ee9f70bee
Author: Julien Hardelin <jhardlin orange fr>
Date:   Fri Jan 11 16:05:16 2019 +0100

    Add Vignette filter

 .../light-and-shadow/vignette-ex-default.jpg       | Bin 0 -> 24286 bytes
 .../light-and-shadow/vignette-ex-gamma.jpg         | Bin 0 -> 32459 bytes
 .../examples/light-and-shadow/vignette-ex-orig.jpg | Bin 0 -> 37195 bytes
 .../light-and-shadow/vignette-ex-radius.jpg        | Bin 0 -> 18696 bytes
 .../light-and-shadow/vignette-ex-softness.jpg      | Bin 0 -> 37040 bytes
 .../light-and-shadow/vignette-ex-squeeze05.jpg     | Bin 0 -> 20969 bytes
 .../C/filters/light-and-shadow/vignette-dialog.png | Bin 0 -> 33662 bytes
 omf/gimp-C.omf                                     |  33 +++
 src/filters/light-and-shadow.xml                   |   2 +-
 src/filters/light-and-shadow/vignette.xml          | 247 +++++++++++++++++++++
 10 files changed, 281 insertions(+), 1 deletion(-)
---
diff --git a/images/C/filters/examples/light-and-shadow/vignette-ex-default.jpg 
b/images/C/filters/examples/light-and-shadow/vignette-ex-default.jpg
new file mode 100644
index 000000000..9990b0f75
Binary files /dev/null and b/images/C/filters/examples/light-and-shadow/vignette-ex-default.jpg differ
diff --git a/images/C/filters/examples/light-and-shadow/vignette-ex-gamma.jpg 
b/images/C/filters/examples/light-and-shadow/vignette-ex-gamma.jpg
new file mode 100644
index 000000000..56ece683a
Binary files /dev/null and b/images/C/filters/examples/light-and-shadow/vignette-ex-gamma.jpg differ
diff --git a/images/C/filters/examples/light-and-shadow/vignette-ex-orig.jpg 
b/images/C/filters/examples/light-and-shadow/vignette-ex-orig.jpg
new file mode 100644
index 000000000..1483b277a
Binary files /dev/null and b/images/C/filters/examples/light-and-shadow/vignette-ex-orig.jpg differ
diff --git a/images/C/filters/examples/light-and-shadow/vignette-ex-radius.jpg 
b/images/C/filters/examples/light-and-shadow/vignette-ex-radius.jpg
new file mode 100644
index 000000000..4e513ada4
Binary files /dev/null and b/images/C/filters/examples/light-and-shadow/vignette-ex-radius.jpg differ
diff --git a/images/C/filters/examples/light-and-shadow/vignette-ex-softness.jpg 
b/images/C/filters/examples/light-and-shadow/vignette-ex-softness.jpg
new file mode 100644
index 000000000..2eab3ba84
Binary files /dev/null and b/images/C/filters/examples/light-and-shadow/vignette-ex-softness.jpg differ
diff --git a/images/C/filters/examples/light-and-shadow/vignette-ex-squeeze05.jpg 
b/images/C/filters/examples/light-and-shadow/vignette-ex-squeeze05.jpg
new file mode 100644
index 000000000..e210e9156
Binary files /dev/null and b/images/C/filters/examples/light-and-shadow/vignette-ex-squeeze05.jpg differ
diff --git a/images/C/filters/light-and-shadow/vignette-dialog.png 
b/images/C/filters/light-and-shadow/vignette-dialog.png
new file mode 100644
index 000000000..ff832f0e8
Binary files /dev/null and b/images/C/filters/light-and-shadow/vignette-dialog.png differ
diff --git a/omf/gimp-C.omf b/omf/gimp-C.omf
new file mode 100644
index 000000000..301f49fc3
--- /dev/null
+++ b/omf/gimp-C.omf
@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<omf>
+  <resource>
+    <creator>
+      GIMP Help Team
+    </creator>
+    <maintainer>
+      GIMP Help Team
+    </maintainer>
+    <title>
+      GIMP User Manual
+    </title>
+    <date>
+      2004-12-24
+    </date>
+    <version identifier="2.2" date="2004-12-24" description="For GIMP 2.2"/>
+    <!-- FIXME: category is too general, but it's not clear where GIMP would
+                fit best: Applications|Multimedia|Graphics|Editing ?
+      -->
+    <subject category="GNOME|Applications"/>
+    <description>
+      User manual for GNU Image Manipulation Program.
+    </description>
+    <type>
+      user's guide
+    </type>
+    <format mime="text/xml" dtd="-//OASIS//DTD DocBook XML V4.3//EN"/>
+    <identifier url="file://$(datadir)/gimp/2.0/help/en/gimp.xml"/>
+    <language code="C"/>
+    <relation seriesid="4f6081c0-5547-11d9-99e3-e39b20af7bbf"/>
+    <rights type="GNU FDL" license.version="1.2" holder="GIMP Help Team"/>
+  </resource>        
+</omf>
diff --git a/src/filters/light-and-shadow.xml b/src/filters/light-and-shadow.xml
index 938eef8e5..73261c799 100644
--- a/src/filters/light-and-shadow.xml
+++ b/src/filters/light-and-shadow.xml
@@ -26,7 +26,7 @@
   <!-- Shadows -->
   <xi:include href="light-and-shadow/drop-shadow.xml"/>
   <xi:include href="light-and-shadow/long-shadow.xml"/>
-  <!--<xi:include href="light-and-shadow/vignette.xml"/>-->
+  <xi:include href="light-and-shadow/vignette.xml"/>
   <xi:include href="light-and-shadow/drop-shadow-legacy.xml"/>
   <xi:include href="light-and-shadow/perspective-shadow.xml"/>
   <xi:include href="light-and-shadow/xach-effect.xml"/>
diff --git a/src/filters/light-and-shadow/vignette.xml b/src/filters/light-and-shadow/vignette.xml
new file mode 100644
index 000000000..b25707465
--- /dev/null
+++ b/src/filters/light-and-shadow/vignette.xml
@@ -0,0 +1,247 @@
+<?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:
+  2019-01-06 j.h: create
+-->
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-vignette">
+  <title>Vignette</title>
+
+  <indexterm>
+    <primary>Filters</primary>
+    <secondary>Vignette</secondary>
+  </indexterm>
+  <indexterm>
+    <primary>Vignette</primary>
+  </indexterm>
+  
+  <sect3>
+    <title>Overview</title>
+    <para>
+      In photography, <emphasis>vignetting</emphasis> is a reduction of the 
+      image brightness toward periphery. It is often an undesired effect due to 
+      camera settings or lens limitations. But it is also deliberately used to 
+      draw attention to the center of the image. <quote>Vignette</quote> can 
+      produce this effect.
+    </para>
+    <figure>
+      <title>Original images used for examples</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata 
+fileref="images/filters/examples/light-and-shadow/vignette-ex-orig.jpg" 
+format="JPG"/>
+        </imageobject>
+        <caption>
+          <para>
+            Original
+          </para>
+        </caption>
+      </mediaobject>
+      <mediaobject>
+        <imageobject>
+          <imagedata 
+fileref="images/filters/examples/light-and-shadow/vignette-ex-default.jpg" 
+format="JPG"/>
+        </imageobject>
+        <caption>
+          <para>
+            Filter applied with default options
+          </para>
+        </caption>
+      </mediaobject>
+    </figure>
+  </sect3>
+  
+  <sect3>
+    <title>Activate the filter</title>
+    <para>
+      You can find this filter in the image menu menu through
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Light and Shadow</guisubmenu>
+        <guimenuitem>Vignette…</guimenuitem>
+      </menuchoice>.
+    </para>
+  </sect3>
+  
+  <sect3>
+    <title>Options</title>
+    <figure>
+      <title><quote>Vignette</quote> filter options</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata 
+fileref="images/filters/light-and-shadow/vignette-dialog.png" format="PNG"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+    <variablelist>
+      <varlistentry>
+        <term>Presets, Preview, Split view</term>
+        <listitem>
+          <xi:include href="../about-common-features.xml"/>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Vignette shape</term>
+        <listitem>
+          <itemizedlist>
+            <listitem>
+              <para>Circle</para>
+            </listitem>
+            <listitem>
+              <para>Square</para>
+            </listitem>
+            <listitem>
+              <para>Diamond</para>
+            </listitem>
+          </itemizedlist>
+          <para>
+            The shape of the vignette (ellipse or circle for example) depends on 
+            Proportion setting.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Radius</term>
+        <listitem>
+          <para>
+            How far out vignetting goes as part of half image diagonal.
+          </para>
+          <mediaobject>
+            <imageobject>
+              <imagedata 
+fileref="images/filters/examples/light-and-shadow/vignette-ex-radius.jpg" 
+format="JPG"/>
+            </imageobject>
+            <caption>
+              <para>
+                Radius = 0.700
+              </para>
+            </caption>
+          </mediaobject>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Softness</term>
+        <listitem>
+          <para>
+            TODO.
+          </para>
+          <mediaobject>
+            <imageobject>
+              <imagedata 
+fileref="images/filters/examples/light-and-shadow/vignette-ex-softness.jpg" 
+format="JPG"/>
+            </imageobject>
+            <caption>
+              <para>
+                Softness = 0.100
+              </para>
+            </caption>
+          </mediaobject>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Gamma</term>
+        <listitem>
+          <para>
+            Falloff linearity controls the curve of the falloff from the center 
+            to periphery: set how fast is brightness reduced towards edges 
+            of the vignette.
+          </para>
+          <mediaobject>
+            <imageobject>
+              <imagedata 
+fileref="images/filters/examples/light-and-shadow/vignette-ex-gamma.jpg" 
+format="JPG"/>
+            </imageobject>
+            <caption>
+              <para>
+                Gamma = 1.00
+              </para>
+            </caption>
+          </mediaobject>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Proportion</term>
+        <listitem>
+          <para>
+            Proportion is particular: with the default value (maxi) 1.00, the 
+            vignette is a circle in a square image and an ellipse in a 
+            rectangular image. Reducing Proportion, this ellipse tends to a 
+            circle.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Squeeze</term>
+        <listitem>
+          <para>
+            Aspect ratio to use: 
+            <itemizedlist>
+              <listitem>
+                <para>0.0 = 1:1</para>
+              </listitem>
+              <listitem>
+                <para>0.5 = 2:1</para>
+                <mediaobject>
+                  <imageobject>
+                    <imagedata 
+fileref="images/filters/examples/light-and-shadow/vignette-ex-squeeze05.jpg" 
+format="JPG"/>
+                  </imageobject>
+                  <caption>
+                    <para>
+                      Diamond shape, proportion = 0.0 and squeeze = 0.5
+                    </para>
+                  </caption>
+                </mediaobject>
+              </listitem>
+              <listitem>
+                <para>1.0 = completely squeezed vertically</para>
+              </listitem>
+              <listitem>
+                <para>-0.5 = 1:2</para>
+              </listitem>
+              <listitem>
+                <para>-1.0 = completely squeezed horizontally</para>
+              </listitem>
+            </itemizedlist>
+          </para>
+          <note>
+            <para>
+              To directly use squeeze factor as proportion, set Proportion to 0.0.
+            </para>
+          </note>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Center X, Center Y</term>
+        <listitem>
+          <para>
+            Coordinates of vignette center. Origin is the upper left corner of 
+            the image. 1.00 is the right border of the image. The center can be 
+            placed outside of the image.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Rotation</term>
+        <listitem>
+          <para>
+            Rotation of the vignette. The vignette keeps its shape.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Use the selection as input, Use the entire layer as input</term>
+        <listitem>
+          <xi:include href="../about-common-features.xml"/>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect3>
+</sect2>
\ No newline at end of file
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]