[gimp-help] Start updating Liht and Shadow filters
- From: Julien Hardlin <jhardlin src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp-help] Start updating Liht and Shadow filters
- Date: Thu, 3 Jan 2019 07:04:11 +0000 (UTC)
commit a8e1078ba0ea3643282c5a206f441b4e81ee602c
Author: Julien Hardelin <jhardlin orange fr>
Date: Thu Jan 3 08:03:33 2019 +0100
Start updating Liht and Shadow filters
images/C/filters/light-and-shadow/nova.png | Bin 31857 -> 0 bytes
.../filters/light-and-shadow/supernova-dialog.png | Bin 0 -> 27718 bytes
images/C/menus/filters/light-and-shadow.png | Bin 19884 -> 154340 bytes
src/filters/distort/waves.xml | 5 +
src/filters/light-and-shadow.xml | 23 ++-
.../light-and-shadow/drop-shadow-legacy.xml | 168 +++++++++++++++++++++
src/filters/light-and-shadow/drop-shadow.xml | 42 +++---
src/filters/light-and-shadow/introduction.xml | 28 +---
.../light-and-shadow/{nova.xml => supernova.xml} | 95 +++++-------
9 files changed, 248 insertions(+), 113 deletions(-)
---
diff --git a/images/C/filters/light-and-shadow/supernova-dialog.png
b/images/C/filters/light-and-shadow/supernova-dialog.png
new file mode 100644
index 000000000..c558bb882
Binary files /dev/null and b/images/C/filters/light-and-shadow/supernova-dialog.png differ
diff --git a/images/C/menus/filters/light-and-shadow.png b/images/C/menus/filters/light-and-shadow.png
index e724e9d9c..11abb81e1 100644
Binary files a/images/C/menus/filters/light-and-shadow.png and b/images/C/menus/filters/light-and-shadow.png
differ
diff --git a/src/filters/distort/waves.xml b/src/filters/distort/waves.xml
index ff2cdf7e4..6232e579b 100644
--- a/src/filters/distort/waves.xml
+++ b/src/filters/distort/waves.xml
@@ -90,6 +90,11 @@
<para>
That is wavelength. Varies the distance between the top of waves.
</para>
+ <para>
+ The high default value suits large images. For images of some
+ hundreds pixels wide and high, a lower value, such as 20 in our
+ example, fits better.
+ </para>
</listitem>
</varlistentry>
<varlistentry>
diff --git a/src/filters/light-and-shadow.xml b/src/filters/light-and-shadow.xml
index 90996bcac..cec04a0aa 100644
--- a/src/filters/light-and-shadow.xml
+++ b/src/filters/light-and-shadow.xml
@@ -2,14 +2,7 @@
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
- 2010-05-23 ude: renamed "light_effects" subdir to "light-and-shadow"
- 2007-12-29 MikaS: added 'fr'
- 2007-12-25 ciampix: updated 'it'
- 2007-10-11 KoSt: updated 'no'
- 2007-09-05 ude: changed name; moved glass filters here
- 2007-09-01 AntI: added 'es'
- 2007-04-08 KoSt: added 'no'
- 2005-09-03 de added by axel.wernicke
+
-->
<sect1 xmlns:xi="http://www.w3.org/2001/XInclude"; id="filters-light-and-shadow">
<title>Light and Shadow Filters</title>
@@ -24,15 +17,21 @@
</figure>
<xi:include href="light-and-shadow/introduction.xml"/>
<!-- Light Effects -->
- <xi:include href="light-and-shadow/gflare.xml"/>
+ <xi:include href="light-and-shadow/supernova.xml"/>
<xi:include href="light-and-shadow/flarefx.xml"/>
+ <xi:include href="light-and-shadow/gflare.xml"/>
<xi:include href="light-and-shadow/lighting.xml"/>
<xi:include href="light-and-shadow/sparkle.xml"/>
- <xi:include href="light-and-shadow/nova.xml"/>
+
<!-- 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/drop-shadow-legacy.xml"/>
<xi:include href="light-and-shadow/perspective-shadow.xml"/>
<xi:include href="light-and-shadow/xach-effect.xml"/>
- <!-- Glass Effects -->
- <xi:include href="light-and-shadow/glasstile.xml"/>
+
+ <!--Suppr-->
+ <!-- Glass Effects
+ <xi:include href="light-and-shadow/glasstile.xml"/>-->
</sect1>
diff --git a/src/filters/light-and-shadow/drop-shadow-legacy.xml
b/src/filters/light-and-shadow/drop-shadow-legacy.xml
new file mode 100644
index 000000000..1839b0275
--- /dev/null
+++ b/src/filters/light-and-shadow/drop-shadow-legacy.xml
@@ -0,0 +1,168 @@
+<?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:
+ 2008-12-15 j.h: no change for v2.6
+ 2007-12-22 MikaS: added 'fr'
+ 2007-10-07 ciampix: added 'it'
+ 2007-09-24 ude: created 'en','de'
+-->
+<sect2 id="script-fu-drop-shadow">
+ <title>Drop Shadow</title>
+
+ <indexterm>
+ <primary>Filters</primary>
+ <secondary>Light and Shadow</secondary>
+ <tertiary>Drop Shadow</tertiary>
+ </indexterm>
+ <indexterm>
+ <primary>Drop Shadow</primary>
+ </indexterm>
+
+ <sect3>
+ <title>Overview</title>
+ <figure>
+ <title>Example for the <quote>Drop Shadow</quote> 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/light-taj-drop-shadow.jpg"/>
+ </imageobject>
+ <caption>
+ <para>
+ <quote>Drop Shadow</quote> applied
+ (white background layer added manually)
+ </para>
+ </caption>
+ </mediaobject>
+ </figure>
+ <para>
+ This filter adds a drop-shadow to the current selection or to the image
+ if there's no active selection. Optional the filter resizes the image if
+ that's necessary for displaying the shadow.
+ </para>
+ <para>
+ You may choose the color, position, and size of the shadow.
+ </para>
+ <para>
+ Please note that the filter does not add a background layer to make the
+ shadow visible. The shadow's background is transparent. The white
+ background in the above example has not been created by the filter,
+ instead it has been added later to let you see the shadow.
+ </para>
+ </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>Drop Shadow…</guimenuitem>
+ </menuchoice>.
+ </para>
+ </sect3>
+
+ <sect3>
+ <title>Options</title>
+ <figure>
+ <title><quote>Drop Shadow</quote> filter options</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/filters/light-and-shadow/drop-shadow.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <variablelist>
+ <varlistentry>
+ <term>Offset X</term>
+ <term>Offset Y</term>
+ <listitem>
+ <para>
+ The layer containing the drop shadow will be moved horizontally
+ by X pixels, vertically by Y pixels. So, X and Y offset
+ determine where the shadow will be placed in relation to the
+ image. High values make the imaginary source of light look like
+ it's far away in horizontal or vertical direction, and low
+ values will make it look closer to the image.
+ </para>
+ <para>
+ The offsets may be negative, leading to a shadow on the left of
+ the selection if offset X < 0, or above the selection if offset
+ Y < 0.
+ </para>
+ <para>
+ If there's no active selection, you must have <guilabel>Allow
+ resizing</guilabel> enabled to see any effect.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Blur radius</term>
+ <listitem>
+ <para>
+ After creating the shadow, a
+ <link linkend="gimp-filter-gaussian-blur">Gaussian blur</link> with the
+ specified radius is applied to the shadow layer, resulting in the
+ realistic appearance of the drop shadow. It may be necessary to
+ enable <guilabel>Allow resizing</guilabel>, since blurring extends
+ the shadow.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Color</term>
+ <listitem>
+ <para>
+ The shadow may have any color. Just click on the button, and
+ select a color when the color selector pops up.
+ </para>
+ <figure>
+ <title><quote>Drop Shadow</quote> color example</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/filters/examples/drop-shadow-color.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Opacity</term>
+ <listitem>
+ <para>
+ The shadow's opacity is just the opacity of the new layer
+ containing the shadow (see
+ <xref linkend="gimp-layer-properties"/>). It defaults to 80%, but
+ you may select any other value from 0 (full transparency) to 100
+ (full opacity) here. After applying the filter to an image you can
+ change the opacity in the <link linkend="gimp-layer-dialog">layers
+ dialog</link>.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Allow resizing</term>
+ <listitem>
+ <para>
+ If enabled, the filter will resize the image if that is needed to
+ make place for the shadow. The new size depends on the size of the
+ selection, the blur radius, and the shadow offsets.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect3>
+</sect2>
diff --git a/src/filters/light-and-shadow/drop-shadow.xml b/src/filters/light-and-shadow/drop-shadow.xml
index 1839b0275..423c2d448 100644
--- a/src/filters/light-and-shadow/drop-shadow.xml
+++ b/src/filters/light-and-shadow/drop-shadow.xml
@@ -2,18 +2,15 @@
<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
- 2008-12-15 j.h: no change for v2.6
- 2007-12-22 MikaS: added 'fr'
- 2007-10-07 ciampix: added 'it'
- 2007-09-24 ude: created 'en','de'
+ 2019-01-01 j.h: This filter doesn't work
+ 2007-09-24 ude: created
-->
-<sect2 id="script-fu-drop-shadow">
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-drop-shadow">
<title>Drop Shadow</title>
<indexterm>
<primary>Filters</primary>
- <secondary>Light and Shadow</secondary>
- <tertiary>Drop Shadow</tertiary>
+ <secondary>Drop Shadow</secondary>
</indexterm>
<indexterm>
<primary>Drop Shadow</primary>
@@ -21,6 +18,12 @@
<sect3>
<title>Overview</title>
+ <warning>
+ <para>
+ This filter doesn't work for the moment. Please use
+ <xref linkend="script-fu-drop-shadow"/>.
+ </para>
+ </warning>
<figure>
<title>Example for the <quote>Drop Shadow</quote> filter</title>
<mediaobject>
@@ -71,6 +74,10 @@
<guimenuitem>Drop Shadow…</guimenuitem>
</menuchoice>.
</para>
+ <para>
+ This filter is normally disabled. You must add an Alpha channel to your
+ image to use it.
+ </para>
</sect3>
<sect3>
@@ -113,11 +120,9 @@
<listitem>
<para>
After creating the shadow, a
- <link linkend="gimp-filter-gaussian-blur">Gaussian blur</link> with the
- specified radius is applied to the shadow layer, resulting in the
- realistic appearance of the drop shadow. It may be necessary to
- enable <guilabel>Allow resizing</guilabel>, since blurring extends
- the shadow.
+ <link linkend="gimp-filter-gaussian-blur">Gaussian blur</link> with
+ the specified radius is applied to the shadow layer, resulting in
+ the realistic appearance of the drop shadow.
</para>
</listitem>
</varlistentry>
@@ -126,7 +131,8 @@
<listitem>
<para>
The shadow may have any color. Just click on the button, and
- select a color when the color selector pops up.
+ select a color when the color selector pops up or use the
+ eye-dropper.
</para>
<figure>
<title><quote>Drop Shadow</quote> color example</title>
@@ -153,16 +159,6 @@
</para>
</listitem>
</varlistentry>
- <varlistentry>
- <term>Allow resizing</term>
- <listitem>
- <para>
- If enabled, the filter will resize the image if that is needed to
- make place for the shadow. The new size depends on the size of the
- selection, the blur radius, and the shadow offsets.
- </para>
- </listitem>
- </varlistentry>
</variablelist>
</sect3>
</sect2>
diff --git a/src/filters/light-and-shadow/introduction.xml b/src/filters/light-and-shadow/introduction.xml
index f33e1a17c..a26ee08b7 100644
--- a/src/filters/light-and-shadow/introduction.xml
+++ b/src/filters/light-and-shadow/introduction.xml
@@ -2,10 +2,7 @@
<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
- 2007-09-05 ude: merged with glass filters introduction ('en','de')
- 2007-08-29 AntI: added 'es'
- 2007-04-19 KoSt: added 'no'
- 2005-09-03 de added by axel.wernicke
+
-->
<sect2 id="filters-light-and-shadow-introduction">
<title>Introduction</title>
@@ -14,35 +11,20 @@
<primary>Filters</primary>
<secondary>Light and Shadow</secondary>
</indexterm>
- <indexterm>
- <primary>Filters</primary>
- <secondary>Light Effects</secondary>
- </indexterm>
- <indexterm>
- <primary>Filters</primary>
- <secondary>Glass Effects</secondary>
- </indexterm>
<para>
- Here you will find three groups of filters:
+ Here you will find two groups of filters:
</para>
<itemizedlist>
<listitem>
<para>
- The original <emphasis>Light Effects</emphasis> filters, which render
- several illumination effects of the image.
- </para>
- </listitem>
- <listitem>
- <para>
- Some <emphasis>Script-Fu</emphasis> and <emphasis>Python-Fu</emphasis>
- scripts, which create various kinds of shadows.
+ for light effects filters, which render several illumination effects of
+ the image.
</para>
</listitem>
<listitem>
<para>
- <emphasis>Glass Effects</emphasis> filters result in an image as if it
- were seen through a lens or glass tiles.
+ for shadow effect filters, which create various kinds of shadows.
</para>
</listitem>
</itemizedlist>
diff --git a/src/filters/light-and-shadow/nova.xml b/src/filters/light-and-shadow/supernova.xml
similarity index 62%
rename from src/filters/light-and-shadow/nova.xml
rename to src/filters/light-and-shadow/supernova.xml
index 7b13a6b68..92101168d 100644
--- a/src/filters/light-and-shadow/nova.xml
+++ b/src/filters/light-and-shadow/supernova.xml
@@ -2,15 +2,9 @@
<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
- 2007-12-29 MikaS: added 'fr'
- 2007-08-29 AntI: added 'es'
- 2007-07-14 Tip added by j.h
- 2007-04-21 KoSt: added 'no'
- 2005-12-07 replaced <simplesect> by <sect3> by lexa
- 2005-08-30 de replaced informalfigure by axel.wernicke
- 2005-09-04 de added by axel.wernicke
+ 2019-01-01 j.h: update to v2.10
-->
-<sect2 id="plug-in-nova">
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-supernova">
<title>Supernova</title>
<indexterm>
@@ -71,60 +65,25 @@
<mediaobject>
<imageobject>
<imagedata format="PNG"
- fileref="images/filters/light-and-shadow/nova.png"/>
+ fileref="images/filters/light-and-shadow/supernova-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>Center of Nova</term>
- <listitem>
- <variablelist>
- <varlistentry>
- <term><guilabel>X</guilabel></term>
- <term><guilabel>Y</guilabel></term>
- <listitem>
- <para>
- You can use input boxes to set horizontal (X) and vertical
- (Y) coordinates of SuperNova center. You can also click the
- SuperNova center in the <emphasis>preview</emphasis> box.
- </para>
- <tip>
- <para>
- To center Supernova precisely, select
- <quote>percent</quote> option in the Unit dropdown list
- and fix X and Y to 50%.
- </para>
- </tip>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guilabel>Show position</guilabel></term>
- <listitem>
- <para>
- This option brings up a reticle in preview, centered on the
- SuperNova.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Color</term>
+ <term><guilabel>Center X</guilabel></term>
+ <term><guilabel>Center Y</guilabel></term>
<listitem>
<para>
- When you click on the color swatch, you bring up the usual color
- selector.
+ You can use input boxes to set horizontal (X) and vertical
+ (Y) coordinates of Supernova center. You can also click and drag the
+ supernova center in preview.
</para>
</listitem>
</varlistentry>
@@ -132,14 +91,18 @@
<term>Radius</term>
<listitem>
<para>
- This is radius of the SuperNova center (1-100). When you
- increase the value, you increase the number of central white
- pixels according to r*r (1, 4, 9...).
+ This is radius of the Supernova center: the upper limit seems to
+ be unlimited. When you increase the value, you increase the number
+ of central white pixels according to r*r (1, 4, 9...).
+ </para>
+ <para>
+ Radius is represented by a horizontal line in preview, with a cross
+ at end. You can click and drag this cross to set radius.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Spikes</term>
+ <term>Number of spokes</term>
<listitem>
<para>
This is number of rays (1-1024). Each pixel in the nova center
@@ -158,6 +121,28 @@
</para>
</listitem>
</varlistentry>
+ <varlistentry>
+ <term>Color</term>
+ <listitem>
+ <para>
+ When you click on the color swatch, you bring up the usual color
+ selector.
+ </para>
+ <para>
+ You also have a color picker. When it is selected, the mouse
+ pointer goes with a square on image: it's the color sample whose
+ size you can modify in the GEGL operation window under Toolbox.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Random seed</term>
+ <listitem>
+ <para>
+ Filter effect is made at random. You can change seed.
+ </para>
+ </listitem>
+ </varlistentry>
</variablelist>
</sect3>
</sect2>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
