[gimp-help-2] Some updates in blur filters and warp-transform.xml
- From: Julien Hardlin <jhardlin src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp-help-2] Some updates in blur filters and warp-transform.xml
- Date: Sat, 14 Oct 2017 05:52:12 +0000 (UTC)
commit c890da266998ee38c82136980fd4c0e5d722d130
Author: Julien Hardelin <jhardlin orange fr>
Date: Sat Oct 14 07:51:49 2017 +0200
Some updates in blur filters and warp-transform.xml
images/C/filters/blur/gauss.png | Bin 21496 -> 20892 bytes
images/C/filters/common/filter-options-common.png | Bin 0 -> 16368 bytes
images/C/filters/common/preset-icon-add.png | Bin 0 -> 1222 bytes
images/C/filters/common/preset-icon-manage.png | Bin 0 -> 1170 bytes
src/filters/blur.xml | 3 +-
src/filters/blur/blur.xml | 74 -----------------
src/filters/blur/gauss.xml | 89 ++++++++++++--------
src/filters/common-features.xml | 78 ++++++++++++++++++
src/gimp.xml | 4 +-
src/toolbox/transform/warp-transform.xml | 22 ++++--
10 files changed, 150 insertions(+), 120 deletions(-)
---
diff --git a/images/C/filters/blur/gauss.png b/images/C/filters/blur/gauss.png
index f04ea72..6c8f049 100644
Binary files a/images/C/filters/blur/gauss.png and b/images/C/filters/blur/gauss.png differ
diff --git a/images/C/filters/common/filter-options-common.png
b/images/C/filters/common/filter-options-common.png
new file mode 100644
index 0000000..59211a8
Binary files /dev/null and b/images/C/filters/common/filter-options-common.png differ
diff --git a/images/C/filters/common/preset-icon-add.png b/images/C/filters/common/preset-icon-add.png
new file mode 100644
index 0000000..71c65c6
Binary files /dev/null and b/images/C/filters/common/preset-icon-add.png differ
diff --git a/images/C/filters/common/preset-icon-manage.png b/images/C/filters/common/preset-icon-manage.png
new file mode 100644
index 0000000..cb4aeec
Binary files /dev/null and b/images/C/filters/common/preset-icon-manage.png differ
diff --git a/src/filters/blur.xml b/src/filters/blur.xml
index d9fd6bb..67c24fc 100644
--- a/src/filters/blur.xml
+++ b/src/filters/blur.xml
@@ -2,13 +2,12 @@
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
- 2005-08-18 de reviewed by axel.wernicke
+ 2017-10-13 j.h: remove blur.xml
-->
<sect1 xmlns:xi="http://www.w3.org/2001/XInclude"; id="filters-blur">
<title>Blur Filters</title>
<xi:include href="blur/introduction.xml"/>
- <xi:include href="blur/blur.xml"/>
<xi:include href="blur/gauss.xml"/>
<xi:include href="blur/gauss_select.xml"/>
<xi:include href="blur/mblur.xml"/>
diff --git a/src/filters/blur/gauss.xml b/src/filters/blur/gauss.xml
index af56c87..8a8e457 100644
--- a/src/filters/blur/gauss.xml
+++ b/src/filters/blur/gauss.xml
@@ -2,14 +2,7 @@
<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
- 2008-08-01 prokoudine: added RU caption to the images
- 2008-08-01 prokoudine: improved Russian content, added localized screenshot
- 2007-03-28 KoSt: added 'no'
- 2006-03-07 fixed wrong utf-8 character in cs
- 2005-12-07 replaced <simplesect> by <sect3> by lexa
- 2005-11-28 replaced informalfigures by figures by lexa
- 2005-11-10 en;fr reviewed by julien hardelin
- 2005-09-30 de fixed figure issue by axel.wernicke
+ 2017-10-12 j.h : some updates
-->
<sect2 id="gimp-filter-gaussian-blur">
<title>Gaussian Blur</title>
@@ -47,14 +40,14 @@
</mediaobject>
</figure>
<para>
- The IIR Gaussian Blur plug-in acts on each pixel of the active layer or
+ The Gaussian Blur plug-in acts on each pixel of the active layer or
selection, setting its Value to the average of all pixel Values present
in a radius defined in the dialog. A higher Value will produce a higher
amount of blur. The blur can be set to act in one direction more than
the other by clicking the Chain Button so that it is broken, and
altering the radius. GIMP supports two implementations of Gaussian Blur:
- IIR G.B. and RLE G.B. They both produce the same results, but each one
- can be faster in some cases.
+ FIR and RLE. They both produce the same results, but each one can be
+ faster in some cases.
</para>
</sect3>
@@ -83,40 +76,64 @@
</figure>
<variablelist>
<varlistentry>
- <term>Blur Radius</term>
+ <term><guilabel>Presets</guilabel>, <guilabel>Preview</guilabel>,
+ <guilabel>Split view</guilabel></term>
+ <listitem>
+ <para>
+ These options are common to GEGL filters. Please refer to <xref
+ linkend="gimp-filters-common"/>.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Size X, Size Y</term>
<listitem>
<para>
Here you can set the blur intensity. By altering the ratio of
horizontal to vertical blur, you can give the effect of a motion
- blur. You can choose the unit with the drop list.
+ blur.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Filter</term>
+ <listitem>
+ <para>
+ <guilabel>None</guilabel>: default option: no FIR nor RLE
+ filter is applied.
+ </para>
+ <para>
+ <guilabel>FIR</guilabel>: stands for <quote>Finite Impulse
+ Response</quote>.
+ </para>
+ <para>
+ <guilabel>RLE</guilabel>: stands for <quote>run-length
+ encoding</quote>. RLE Gaussian Blur is best used on
+ computer-generated images or those with large areas of constant
+ intensity.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel>Abyss policy</guilabel></term>
+ <listitem>
+ <para>
+ Abyss policy (border management) is treated with
+ <xref linkend="abyss-policy"/>.
</para>
</listitem>
</varlistentry>
+
<varlistentry>
- <term>Blur Method</term>
+ <term><guilabel>Clip to the input extent</guilabel></term>
<listitem>
- <variablelist>
- <varlistentry>
- <term><guilabel>IIR</guilabel></term>
- <listitem>
- <para>
- IIR stands for <quote>infinite impulse response</quote>. This
- blur works best for large radius values and for images which
- are not computer generated.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guilabel>RLE</guilabel></term>
- <listitem>
- <para>
- RLE stands for <quote>run-length encoding</quote>. RLE
- Gaussian Blur is best used on computer-generated images or
- those with large areas of constant intensity.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
+ <para>
+ TODO. Not working. Should the output extent be clipped to the
+ input extent.
+ </para>
</listitem>
</varlistentry>
</variablelist>
diff --git a/src/filters/common-features.xml b/src/filters/common-features.xml
new file mode 100644
index 0000000..f1baa59
--- /dev/null
+++ b/src/filters/common-features.xml
@@ -0,0 +1,78 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+ "http://www.docbook.org/xml/4.3/docbookx.dtd";>
+<!-- section history:
+ 2017-10-12 j.h: created
+-->
+<sect1 id="gimp-filters-common">
+ <title>Common Features</title>
+
+ <para>
+ With GIMP-2.10, GEGL has been applied to most filters. These filters have
+ some options in common:
+ </para>
+ <figure>
+ <title>Filters Common Options</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/filters/common/filter-options-common.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <variablelist>
+ <varlistentry>
+ <term>Presets</term>
+ <listitem>
+ <para>
+ Filters presets are different from tool presets.
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ A <emphasis role="bold">text box</emphasis> to enter a preset
+ name or choose it in a drop down list.
+ </para>
+ </listitem>
+ <listitem>
+ <para> A
+ <guiicon>
+ <inlinegraphic fileref="images/filters/common/preset-icon-add"/>
+ </guiicon>
+ icon to save current settings as named preset.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ A <guiicon><inlinegraphic
+ fileref="images/filters/common/preset-icon-manage"/></guiicon>
+ icon to manage preset.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Preview</term>
+ <listitem>
+ <para>
+ When this option is checked (default), changes in image are directly
+ displayed in canvas. They are not applied to the image until you
+ click on the <guilabel>OK</guilabel> button.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Split view</term>
+ <listitem>
+ <para>
+ When this option is checked, the image view is divided in two part,
+ filter applied on the left, filter not applied on the right.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+</sect1>
\ No newline at end of file
diff --git a/src/gimp.xml b/src/gimp.xml
index 8350f79..d435852 100755
--- a/src/gimp.xml
+++ b/src/gimp.xml
@@ -201,6 +201,7 @@
<chapter id="filters">
<title>Filters</title>
<xi:include href="filters/introduction.xml"/>
+ <xi:include href="filters/common-features.xml"/>
<xi:include href="filters/blur.xml"/>
<xi:include href="filters/enhance.xml"/>
<xi:include href="filters/distort.xml"/>
@@ -218,8 +219,9 @@
<!-- -->
<xi:include href="filters/alpha-to-logo.xml"/>
</chapter>
- <xi:include href="key-reference.xml"/>
+
</part>
+ <xi:include href="key-reference.xml"/>
<xi:include href="glossary/glossary.xml"/>
<!--
<xi:include href="dictionary/dictionary.xml"/>
diff --git a/src/toolbox/transform/warp-transform.xml b/src/toolbox/transform/warp-transform.xml
index ae2cdbd..71e90fa 100644
--- a/src/toolbox/transform/warp-transform.xml
+++ b/src/toolbox/transform/warp-transform.xml
@@ -224,19 +224,20 @@
</listitem>
</varlistentry>
- <varlistentry>
+ <varlistentry id="abyss-policy">
<term>Abyss policy</term>
<listitem>
<para>
<quote>Abyss</quote> is a term used by GIMP developers for
- <quote>data outside the input buffer</quote>.
+ <quote>data outside the input buffer</quote>. The warp tool moves
+ pixels from one point to another. Some pixels may come from
+ outside the layer boundary. These pixels don't actually exist
+ anywhere, and therefore don't have any associated color; yet,
+ <emphasis>some</emphasis> color must be assigned to them.
</para>
<para>
- When warping a whole layer, you may get some parts of the
- future layer (the layer you will get after validating the
- transformation) that are empty. <quote>Abyss policy</quote> has a
- drop-down list that allows you to fill empty areas in different
- manners:
+ <quote>Abyss policy</quote> has a drop-down list that allows you to
+ fill empty areas in different manners:
</para>
<itemizedlist>
<listitem>
@@ -263,6 +264,13 @@
edge of the layer takes you back to the left edge.
</para>
</listitem>
+ <listitem>
+ <para>
+ <guilabel>Black, White></guilabel> : these options are similar
+ to "none", but use black and white for out-of-bounds pixels,
+ instead of transparency.
+ </para>
+ </listitem>
</itemizedlist>
<!--TO TRANSLATORS: a xcf file exists for this image at
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
