Debian Codegraph @

src/menus/colors/desaturate/color-to-gray.xml

raw
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
3 "http://www.docbook.org/xml/4.3/docbookx.dtd">
4 <!--section history:
5 2018-06-08 j.h Created empty
6 -->
7
8 <sect2 xmlns:xi="http://www.w3.org/2001/XInclude" id="gimp-filter-c2g">
9 <title>Color to Gray</title>
10
11 <indexterm>
12 <primary>Colors</primary>
13 <secondary>Color to Gray</secondary>
14 </indexterm>
15 <indexterm>
16 <primary>Desaturate</primary>
17 <secondary>Color to Gray</secondary>
18 </indexterm>
19 <indexterm>
20 <primary>Color to Gray</primary>
21 </indexterm>
22
23 <para>This color to grayscale conversion uses envelopes formed with the
24 so-called <ulink
25 url="https://pippin.gimp.org/publications/Kolaas_11_jist_preprint.pdf">STRESS</ulink>
26 approach to perform local-difference preserving grayscale generation.
27 </para>
28
29 <sect3>
30 <title>Activating the Command</title>
31 <para>
32 You can access this command from the main menu through
33 <menuchoice>
34 <guimenu>Colors</guimenu>
35 <guisubmenu>Desaturate</guisubmenu>
36 <guimenuitem>Color to Gray</guimenuitem>
37 </menuchoice>.
38 </para>
39 </sect3>
40
41 <sect3>
42 <title>Options</title>
43 <figure>
44 <title><quote>Color to Gray</quote> settings</title>
45 <mediaobject>
46 <imageobject>
47 <imagedata format="PNG"
48 fileref="images/menus/colors/desaturate/color-to-gray-dialog.png"/>
49 </imageobject>
50 </mediaobject>
51 </figure>
52 <variablelist>
53 <varlistentry>
54 <term>Presets</term>
55 <term>Input Type</term>
56 <term>Clipping</term>
57 <term>Blending Options</term>
58 <term>Preview</term>
59 <term>Merge filter</term>
60 <term>Split view</term>
61 <listitem>
62 <xi:include href="../about-common-features.xml"/>
63 </listitem>
64 </varlistentry>
65
66 <varlistentry>
67 <term>Radius</term>
68 <listitem>
69 <para>
70 Neighborhood taken into account, this is the radius in pixels taken
71 into account when deciding which colors map to which gray values.
72 </para>
73 </listitem>
74 </varlistentry>
75
76 <varlistentry>
77 <term>Samples</term>
78 <listitem>
79 <para>
80 Number of samples to do per iteration looking for the range of
81 colors.
82 </para>
83 </listitem>
84 </varlistentry>
85
86 <varlistentry>
87 <term>Iterations</term>
88 <listitem>
89 <para>
90 Number of iterations, a higher number of iterations provides less
91 noisy results at a computational cost.
92 </para>
93 </listitem>
94 </varlistentry>
95
96 <varlistentry>
97 <term>Enhance Shadows</term>
98 <listitem>
99 <para>
100 When enabled details in shadows are boosted at the expense of noise.
101 </para>
102 </listitem>
103 </varlistentry>
104
105 </variablelist>
106 </sect3>
107
108 </sect2>