[gimp-help/gimp-help-2-10] Add two missing render pattern filters



commit 943a5457d39bb4a6d8907ceb6e4a52860966f03b
Author: Jacob Boerema <jgboerema gmail com>
Date:   Mon Oct 17 22:46:54 2022 -0400

    Add two missing render pattern filters
    
    - Linear Sinusoid
    - Spiral

 .../examples/render-taj-linear-sinusoid.jpg        | Bin 0 -> 10461 bytes
 images/C/filters/examples/render-taj-spiral.jpg    | Bin 0 -> 20700 bytes
 images/C/filters/render/linear-sinusoid-dialog.png | Bin 0 -> 35817 bytes
 images/C/filters/render/spiral-dialog.png          | Bin 0 -> 29999 bytes
 src/filters/render.xml                             |   6 +-
 src/filters/render/linear-sinusoid.xml             | 146 ++++++++++++++++++++
 src/filters/render/spiral.xml                      | 152 +++++++++++++++++++++
 7 files changed, 301 insertions(+), 3 deletions(-)
---
diff --git a/images/C/filters/examples/render-taj-linear-sinusoid.jpg 
b/images/C/filters/examples/render-taj-linear-sinusoid.jpg
new file mode 100644
index 000000000..8342f17b3
Binary files /dev/null and b/images/C/filters/examples/render-taj-linear-sinusoid.jpg differ
diff --git a/images/C/filters/examples/render-taj-spiral.jpg b/images/C/filters/examples/render-taj-spiral.jpg
new file mode 100644
index 000000000..dc865e260
Binary files /dev/null and b/images/C/filters/examples/render-taj-spiral.jpg differ
diff --git a/images/C/filters/render/linear-sinusoid-dialog.png 
b/images/C/filters/render/linear-sinusoid-dialog.png
new file mode 100644
index 000000000..dd7add560
Binary files /dev/null and b/images/C/filters/render/linear-sinusoid-dialog.png differ
diff --git a/images/C/filters/render/spiral-dialog.png b/images/C/filters/render/spiral-dialog.png
new file mode 100644
index 000000000..b55e3ce92
Binary files /dev/null and b/images/C/filters/render/spiral-dialog.png differ
diff --git a/src/filters/render.xml b/src/filters/render.xml
index ba77c881f..3e43ebc02 100644
--- a/src/filters/render.xml
+++ b/src/filters/render.xml
@@ -25,10 +25,10 @@
   <xi:include href="render/checkerboard.xml"/>
   <xi:include href="render/diffraction.xml"/>
   <xi:include href="render/grid.xml"/>
+  <xi:include href="render/linear-sinusoid.xml"/>
   <xi:include href="render/maze.xml"/>
   <xi:include href="render/sinus.xml"/>
-  
-  <!--<xi:include href="render/spiral.xml"/>-->
+  <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"/>
@@ -36,10 +36,10 @@
   <xi:include href="render/qbist.xml"/>
 
   <!-- -->
+  <xi:include href="render/spyrogimp.xml"/>
   <xi:include href="render/circuit.xml"/>
   <xi:include href="render/gfig.xml"/>
   <xi:include href="render/lava.xml"/>
   <xi:include href="render/line-nova.xml"/>
   <xi:include href="render/spheredesigner.xml"/>
-  <xi:include href="render/spyrogimp.xml"/>
 </sect1>
diff --git a/src/filters/render/linear-sinusoid.xml b/src/filters/render/linear-sinusoid.xml
new file mode 100644
index 000000000..224055d8d
--- /dev/null
+++ b/src/filters/render/linear-sinusoid.xml
@@ -0,0 +1,146 @@
+<?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";>
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-linear-sinusoid">
+  <title>Linear Sinusoid</title>
+
+  <indexterm>
+    <primary>Filters</primary>
+    <secondary>Render</secondary>
+    <tertiary>Linear Sinusoidal textures</tertiary>
+  </indexterm>
+  <indexterm>
+    <primary>Linear Sinusoid</primary>
+  </indexterm>
+
+  <sect3>
+    <title>Overview</title>
+    <figure>
+      <title>Applying example for the Linear Sinusoid filter</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/render-taj-linear-sinusoid.jpg"/>
+        </imageobject>
+        <caption>
+          <para>Filter <quote>Linear Sinusoid</quote> applied</para>
+        </caption>
+      </mediaobject>
+    </figure>
+    <para>
+      You can find this filter from the image menu through
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Render</guisubmenu>
+        <guisubmenu>Pattern</guisubmenu>
+        <guimenuitem>Linear Sinusoid…</guimenuitem>
+      </menuchoice>.
+    </para>
+    <para>
+      The Linear Sinusoid filter lets you make sinusoidally based textures,
+      with repeating lighter and darker areas based on a number of adjustable
+      parameters.
+    </para>
+    <para>
+      The results don't depend on the image you opened.
+    </para>
+  </sect3>
+
+  <sect3>
+    <title>Options</title>
+    <figure>
+      <title><quote>Linear Sinusoid</quote> filter options dialog</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/render/linear-sinusoid-dialog.png"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+    <variablelist>
+      <varlistentry>
+        <term>
+          <guilabel>Presets</guilabel>, <guilabel>Input Type</guilabel>,
+          <guilabel>Blending Options</guilabel>, <guilabel>Preview</guilabel>, 
+          <guilabel>Split view</guilabel>
+        </term>
+        <listitem>
+          <xi:include href="../about-common-features.xml"/>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>X Period</term>
+        <term>Y Period</term>
+        <listitem>
+          <para>
+            Low values will increase the amount of repeating patterns, high
+            values will enlarge the repeating patterns.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>X Amplitude</term>
+        <term>Y Amplitude</term>
+        <listitem>
+          <para>
+            Low values will cause a blurring effect, higher values make the
+            pattern sharper.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>X Phase</term>
+        <term>Y Phase</term>
+        <listitem>
+          <para>
+            This determines the offset where the pattern starts.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Angle</term>
+        <listitem>
+          <para>
+            This controls the angle at which the pattern is generated.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Offset</term>
+        <term>Exponent</term>
+        <listitem>
+          <para>
+            The value offset and exponent control the relative amount of
+            darker and lighter areas in the pattern.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>X Offset</term>
+        <term>Y Offset</term>
+        <listitem>
+          <para>
+            The offset of the X and Y axis.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Rotation</term>
+        <listitem>
+          <para>
+            The rotation angle of the pattern.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Supersampling</term>
+        <listitem>
+          <para>
+            The number of samples along each axis per pixel.
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect3>
+</sect2>
diff --git a/src/filters/render/spiral.xml b/src/filters/render/spiral.xml
new file mode 100644
index 000000000..8d0b25f1a
--- /dev/null
+++ b/src/filters/render/spiral.xml
@@ -0,0 +1,152 @@
+<?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-11 j.h: update to v2.10
+-->
+<sect2 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-filter-spiral">
+  <title>Spiral</title>
+
+  <indexterm>
+    <primary>Filters</primary>
+    <secondary>Render</secondary>
+    <tertiary>Spiral</tertiary>
+  </indexterm>
+  <indexterm>
+    <primary>Spiral</primary>
+  </indexterm>
+
+  <sect3>
+    <title>Overview</title>
+    <figure>
+      <title>Applying example for the Spiral filter</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/filters/examples/render-taj-spiral.jpg"/>
+        </imageobject>
+        <caption>
+          <para>Filter <quote>Spiral</quote> applied</para>
+        </caption>
+      </mediaobject>
+    </figure>
+    <para>
+      You can find this filter from the image menu through
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Render</guisubmenu>
+        <guisubmenu>Pattern</guisubmenu>
+        <guimenuitem>Spiral…</guimenuitem>
+      </menuchoice>.
+    </para>
+    <para>
+      The Spiral filter allows you to make spiral patterns using two
+      different colors. Besides choosing the colors, several other
+      parameters are available to control the appearance of the spiral.
+    </para>
+    <para>
+      Results don't depend on the image you opened.
+    </para>
+  </sect3>
+
+  <sect3>
+    <title>Options</title>
+    <figure>
+      <title><quote>Spiral</quote> filter options dialog</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/render/spiral-dialog.png"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+    <variablelist>
+      <varlistentry>
+        <term>
+          <guilabel>Presets</guilabel>, <guilabel>Input Type</guilabel>,
+          <guilabel>Blending Options</guilabel>, <guilabel>Preview</guilabel>, 
+          <guilabel>Split view</guilabel>
+        </term>
+        <listitem>
+          <xi:include href="../about-common-features.xml"/>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>Type</term>
+        <listitem>
+          <para>
+            The type of spiral pattern. It can can be
+            <guilabel>Linear</guilabel>, where the spiral has the same thickness
+            everywhere, or <guilabel>Logarithmic</guilabel>, where the spiral
+            starts small in the middle and gets larger the closer to the
+            edge you get.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>X</term>
+        <term>Y</term>
+        <listitem>
+          <para>
+            The starting offset of the spiral pattern.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Radius</term>
+        <listitem>
+          <para>
+            The spiral radius controls the size of the spirals.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Balance</term>
+        <listitem>
+          <para>
+            The area balance between the two colors.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Rotation</term>
+        <listitem>
+          <para>
+            The rotation angle of the spiral.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Direction</term>
+        <listitem>
+          <para>
+            The spiral swirl of the rotation can be either
+            <guilabel>Clockwise</guilabel>, or
+            <guilabel>Counter-clockwise</guilabel>.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Color 1, Color 2</term>
+        <listitem>
+          <para>
+            Here, you can set the two colors that make up the spiral.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>On-canvas controls</term>
+        <listitem>
+          <para>
+            If this setting is enabled, which is the default, you can control
+            the <guilabel>Radius</guilabel>,
+            <guilabel>Balance</guilabel> and
+            <guilabel>Rotation</guilabel> with the controls on top of the
+            image.
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect3>
+</sect2>


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]