[gimp-help/gimp-help-2-10] Add missing bloom filter.

[Jacob Boerema <jboerema src gnome org>]

commit 750986bb863a67dfb0c672660a5015f47a582581
Author: Jacob Boerema <jgboerema gmail com>
Date:   Thu Oct 6 13:25:53 2022 -0400

    Add missing bloom filter.

 images/C/filters/examples/light-taj-bloom.jpg      | Bin 0 -> 23099 bytes
 images/C/filters/light-and-shadow/bloom-dialog.png | Bin 0 -> 18579 bytes
 src/filters/light-and-shadow/bloom.xml             | 117 +++++++++++++++++++++
 3 files changed, 117 insertions(+)
---
diff --git a/images/C/filters/examples/light-taj-bloom.jpg b/images/C/filters/examples/light-taj-bloom.jpg
new file mode 100644
index 000000000..8a1336a67
Binary files /dev/null and b/images/C/filters/examples/light-taj-bloom.jpg differ
diff --git a/images/C/filters/light-and-shadow/bloom-dialog.png 
b/images/C/filters/light-and-shadow/bloom-dialog.png
new file mode 100644
index 000000000..c12ff39a7
Binary files /dev/null and b/images/C/filters/light-and-shadow/bloom-dialog.png differ
diff --git a/src/filters/light-and-shadow/bloom.xml b/src/filters/light-and-shadow/bloom.xml
new file mode 100644
index 000000000..02fb17754
--- /dev/null
+++ b/src/filters/light-and-shadow/bloom.xml
@@ -0,0 +1,117 @@
+<?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-bloom">
+  <title>Bloom</title>
+
+  <indexterm>
+    <primary>Filters</primary>
+    <secondary>Light and Shadow</secondary>
+    <tertiary>Bloom</tertiary>
+  </indexterm>
+  <indexterm>
+    <primary>Bloom</primary>
+  </indexterm>
+
+  <sect3>
+    <title>Overview</title>
+    <figure>
+      <title>Applying example for the Bloom 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-bloom.jpg"/>
+        </imageobject>
+        <caption>
+          <para>Filter <quote>Bloom</quote> applied</para>
+        </caption>
+      </mediaobject>
+    </figure>
+    <para>
+      This filter adds a glow around bright areas.
+    </para>
+  </sect3>
+
+  <sect3>
+    <title>Activate the filter</title>
+    <para>
+      This filter can be found in the menu under
+      <menuchoice>
+        <guimenu>Filters</guimenu>
+        <guisubmenu>Light and Shadow</guisubmenu>
+        <guimenuitem>Bloom…</guimenuitem>
+      </menuchoice>.
+    </para>
+  </sect3>
+
+  <sect3>
+    <title>Options</title>
+    <figure>
+      <title><quote>Bloom</quote> filter options</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="PNG"
+            fileref="images/filters/light-and-shadow/bloom-dialog.png"/>
+        </imageobject>
+      </mediaobject>
+    </figure>
+    <variablelist>
+      <varlistentry>
+        <term>Presets, Input Type, Blending Options, Preview, Split view</term>
+        <listitem>
+          <xi:include href="../about-common-features.xml"/>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Threshold</term>
+        <listitem>
+          <para>
+            Glow area brightness threshold.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Softness</term>
+        <listitem>
+          <para>
+            Glow area edge softness.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Radius</term>
+        <listitem>
+          <para>
+            The radius of the glow.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Strength</term>
+        <listitem>
+          <para>
+            The strength of the glow.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Limit exposure</term>
+        <listitem>
+          <para>
+            When enabled, it limits the exposure of highlights. This can be
+            used to reduce the glow in areas that are over exposed.
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </sect3>
+</sect2>