[gimp-help] Add render/grid and grid (legacy) filters
- From: Julien Hardlin <jhardlin src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp-help] Add render/grid and grid (legacy) filters
- Date: Wed, 6 Mar 2019 06:49:30 +0000 (UTC)
commit 381da5e5bd1c18468d80ea96559ebe63138e36cd
Author: Julien Hardelin <jhardlin orange fr>
Date: Wed Mar 6 07:48:51 2019 +0100
Add render/grid and grid (legacy) filters
images/C/filters/render/grid-dialog.png | Bin 0 -> 25240 bytes
src/filters/render.xml | 4 +-
src/filters/render/grid-legacy.xml | 165 ++++++++++++++++++++++++++++++++
src/filters/render/grid.xml | 95 +++++++-----------
4 files changed, 200 insertions(+), 64 deletions(-)
---
diff --git a/images/C/filters/render/grid-dialog.png b/images/C/filters/render/grid-dialog.png
new file mode 100644
index 000000000..58a379613
Binary files /dev/null and b/images/C/filters/render/grid-dialog.png differ
diff --git a/src/filters/render.xml b/src/filters/render.xml
index 8279ebeba..e38afa40d 100644
--- a/src/filters/render.xml
+++ b/src/filters/render.xml
@@ -13,7 +13,7 @@
<xi:include href="render/ifsfractal.xml"/>
<!--Noise-->
- <xi:include href="render/cell_noise.xml"/>
+ <!--<xi:include href="render/cell_noise.xml"/>-->
<!--<xi:include href="render/perlin_noise.xml"/>-->
<xi:include href="render/plasma.xml"/>
<!--<xi:include href="render/simplex_noise.xml"/>-->
@@ -29,7 +29,7 @@
<!--<xi:include href="render/spiral.xml"/>-->
<xi:include href="render/checkerboard-legacy.xml"/>
<xi:include href="render/cmlexplorer.xml"/>
- <!--<xi:include href="render/grid-legacy.xml"/>-->
+ <xi:include href="render/grid-legacy.xml"/>
<xi:include href="render/jigsaw.xml"/>
<xi:include href="render/qbist.xml"/>
diff --git a/src/filters/render/grid-legacy.xml b/src/filters/render/grid-legacy.xml
new file mode 100644
index 000000000..3a2d63893
--- /dev/null
+++ b/src/filters/render/grid-legacy.xml
@@ -0,0 +1,165 @@
+<?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-03-05 j.h check for v2.10
+-->
+<sect2 id="plug-in-grid">
+ <title>Grid (legacy)</title>
+
+ <indexterm>
+ <primary>Filters</primary>
+ <secondary>Render</secondary>
+ <tertiary>Grid (legacy)</tertiary>
+ </indexterm>
+ <indexterm>
+ <primary>Grid</primary>
+ <secondary>Grid (legacy) filter</secondary>
+ </indexterm>
+
+ <sect3>
+ <title>Overview</title>
+ <figure>
+ <title>Applying example for the Grid (legacy) 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/render-taj-grid.jpg"/>
+ </imageobject>
+ <caption>
+ <para>Filter <quote>Grid (legacy)</quote> applied</para>
+ </caption>
+ </mediaobject>
+ </figure>
+
+ <para>
+ It renders a Cartesian grid in the active layer, on top of the existing
+ contents. The width, spacing, offsets, and colors of the grid lines can
+ all be set by the user. By default, the lines are with the
+ <acronym>GIMP</acronym>'s foreground color. (Note: this plug-in
+ was used to create demonstration images for many of the other plug-ins.)
+ </para>
+ <tip>
+ <para>
+ If you set the grid line widths to 0, then only the intersections
+ will be drawn, as plus-marks.
+ </para>
+ </tip>
+ </sect3>
+
+ <sect3>
+ <title>Activating the filter</title>
+ <para>
+ This filter is found in the image window menu under
+ <menuchoice>
+ <guimenu>Filters</guimenu>
+ <guisubmenu>Render</guisubmenu>
+ <guisubmenu>Pattern</guisubmenu>
+ <guimenuitem>Grid (legacy)…</guimenuitem>
+ </menuchoice>.
+ </para>
+ </sect3>
+
+ <sect3>
+ <title>Options</title>
+ <figure>
+ <title><quote>Grid (legacy)</quote> filter options</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/filters/render/grid.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ There are separate options for controlling the horizontal grid
+ lines, vertical grid lines, and intersections. By default, the
+ horizontal and vertical settings are locked together, so that
+ all changes are applied symmetrically. If you want to change
+ just one of them, click on the <quote>chain</quote> symbol below it to
+ unlock them. The results of changing the Intersection parameters are
+ rather complex.
+ </para>
+ <para>
+ Besides, for some options, you can select the unit of measurement
+ thanks to a drop-down list.
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term>Width</term>
+ <listitem>
+ <para>
+ Sets the widths of the horizontal or vertical grid
+ lines, or of the symbols drawn at their intersections.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Spacing</term>
+ <listitem>
+ <para>
+ Sets the distance between grid lines.
+ The <guilabel>Intersection</guilabel> parameter clears the space
+ between the intersection point and the end of the arms of the
+ intersection crosses.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Offset</term>
+ <listitem>
+ <para>
+ Sets the offset for grid lines with respect to the upper left
+ corner. For intersections, sets the length of the arms of the
+ intersection crosses.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Color Selectors</term>
+ <listitem>
+ <para>
+ These allow you to set the colors of the grid lines and
+ intersection marks.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <figure>
+ <title>Intersection parameters</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/filters/examples/render-grid-detail1.png"/>
+ </imageobject>
+ <caption>
+ <para>
+ <parameter>Width</parameter> <
+ 2 × <parameter>Spacing</parameter>
+ </para>
+ </caption>
+ </mediaobject>
+ <mediaobject>
+ <imageobject>
+ <imagedata format="PNG"
+ fileref="images/filters/examples/render-grid-detail2.png"/>
+ </imageobject>
+ <caption>
+ <para>
+ <parameter>Width</parameter> >
+ 2 × <parameter>Spacing</parameter>
+ </para>
+ </caption>
+ </mediaobject>
+ </figure>
+ </sect3>
+</sect2>
diff --git a/src/filters/render/grid.xml b/src/filters/render/grid.xml
index e2fcd170a..1d492e814 100644
--- a/src/filters/render/grid.xml
+++ b/src/filters/render/grid.xml
@@ -2,13 +2,9 @@
<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
- 2007-11-06 AntI: Added "es"
- 2007-05-18 KoSt: added 'no'
- 2005-12-08 <simplesect> replaced by <sect3> by lexa
- 2005/09/19 de added by axel.wernicke
- 2005/06/20 en updated - default color
+ 2019-03-05 j.h: create
-->
-<sect2 id="gimp-filter-grid">
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-grid">
<title>Grid</title>
<indexterm>
@@ -47,17 +43,14 @@
<para>
It renders a Cartesian grid in the active layer, on top of the existing
- contents. The width, spacing, offsets, and colors of the grid lines can
+ contents. The width, line width, offsets, and colors of the grid lines can
all be set by the user. By default, the lines are with the
- <acronym>GIMP</acronym>'s foreground color. (Note: this plug-in
- was used to create demonstration images for many of the other plug-ins.)
+ <acronym>GIMP</acronym>'s foreground color.
+ </para>
+ <para>
+ This filter is more simple than the <xref linkend="plug-in-grid"/> legacy
+ filter.
</para>
- <tip>
- <para>
- If you set the grid line widths to 0, then only the intersections
- will be drawn, as plus-marks.
- </para>
- </tip>
</sect3>
<sect3>
@@ -80,18 +73,15 @@
<mediaobject>
<imageobject>
<imagedata format="PNG"
- fileref="images/filters/render/grid.png"/>
+ fileref="images/filters/render/grid-dialog.png"/>
</imageobject>
</mediaobject>
</figure>
<para>
- There are separate options for controlling the horizontal grid
- lines, vertical grid lines, and intersections. By default, the
- horizontal and vertical settings are locked together, so that
- all changes are applied symmetrically. If you want to change
- just one of them, click on the <quote>chain</quote> symbol below it to
- unlock them. The results of changing the Intersection parameters are
- rather complex.
+ By default, the horizontal and vertical settings are locked together, so
+ that all changes are applied symmetrically. If you want to change just
+ one of them, click on the <quote>chain</quote> symbol below it to unlock
+ them.
</para>
<para>
Besides, for some options, you can select the unit of measurement
@@ -99,22 +89,16 @@
</para>
<variablelist>
<varlistentry>
- <term>Width</term>
+ <term>Presets, Preview, Split view, Use selection as input</term>
<listitem>
- <para>
- Sets the widths of the horizontal or vertical grid
- lines, or of the symbols drawn at their intersections.
- </para>
+ <xi:include href="../about-common-features.xml"/>
</listitem>
</varlistentry>
<varlistentry>
- <term>Spacing</term>
+ <term>Width, Height</term>
<listitem>
<para>
- Sets the distance between grid lines.
- The <guilabel>Intersection</guilabel> parameter clears the space
- between the intersection point and the end of the arms of the
- intersection crosses.
+ These are width and height of boxes determined by the grid.
</para>
</listitem>
</varlistentry>
@@ -123,47 +107,34 @@
<listitem>
<para>
Sets the offset for grid lines with respect to the upper left
- corner. For intersections, sets the length of the arms of the
- intersection crosses.
+ corner.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>Color Selectors</term>
+ <term>Line width, Line height</term>
<listitem>
<para>
- These allow you to set the colors of the grid lines and
- intersection marks.
+ This is thickness of the grid.
</para>
</listitem>
</varlistentry>
- </variablelist>
- <figure>
- <title>Intersection parameters</title>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/filters/examples/render-grid-detail1.png"/>
- </imageobject>
- <caption>
+ <varlistentry>
+ <term>Color</term>
+ <listitem>
<para>
- <parameter>Width</parameter> <
- 2 × <parameter>Spacing</parameter>
+ Default Color is the toolbox foreground color.
</para>
- </caption>
- </mediaobject>
- <mediaobject>
- <imageobject>
- <imagedata format="PNG"
- fileref="images/filters/examples/render-grid-detail2.png"/>
- </imageobject>
- <caption>
<para>
- <parameter>Width</parameter> >
- 2 × <parameter>Spacing</parameter>
+ You can change these colors clicking on the color dwell or using
+ the color picker on the right. Color picker size can be set in the
+ GEGL Operation window under Toolbox.
</para>
- </caption>
- </mediaobject>
- </figure>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para>
+ See also <xref linkend="gimp-concepts-image-grid-and-guides"/>.
+ </para>
</sect3>
</sect2>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
