Commit 2f27062f authored by Julien Hardelin's avatar Julien Hardelin

Add Vignette filter

parent 1c3162b9
<?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>
......@@ -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"/>
......
<?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
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment