1
<?xml version="1.0" encoding="UTF-8" ?>
2
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
3
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
5
<refentry id="GimpColorSelection">
7
<refentrytitle role="top_of_page" id="GimpColorSelection.top_of_page">GimpColorSelection</refentrytitle>
8
<manvolnum>3</manvolnum>
9
<refmiscinfo>LIBGIMPWIDGETS Library</refmiscinfo>
13
<refname>GimpColorSelection</refname>
14
<refpurpose>Widget for doing a color selection.</refpurpose>
17
<refsynopsisdiv id="GimpColorSelection.synopsis" role="synopsis">
18
<title role="synopsis.title">Synopsis</title>
21
<link linkend="GimpColorSelection-struct">GimpColorSelection</link>;
22
<link linkend="GtkWidget">GtkWidget</link> * <link linkend="gimp-color-selection-new">gimp_color_selection_new</link> (void);
23
<link linkend="void">void</link> <link linkend="gimp-color-selection-set-show-alpha">gimp_color_selection_set_show_alpha</link> (<link linkend="GimpColorSelection">GimpColorSelection</link> *selection,
24
<link linkend="gboolean">gboolean</link> show_alpha);
25
<link linkend="gboolean">gboolean</link> <link linkend="gimp-color-selection-get-show-alpha">gimp_color_selection_get_show_alpha</link> (<link linkend="GimpColorSelection">GimpColorSelection</link> *selection);
26
<link linkend="void">void</link> <link linkend="gimp-color-selection-set-color">gimp_color_selection_set_color</link> (<link linkend="GimpColorSelection">GimpColorSelection</link> *selection,
27
const <link linkend="GimpRGB">GimpRGB</link> *color);
28
<link linkend="void">void</link> <link linkend="gimp-color-selection-get-color">gimp_color_selection_get_color</link> (<link linkend="GimpColorSelection">GimpColorSelection</link> *selection,
29
<link linkend="GimpRGB">GimpRGB</link> *color);
30
<link linkend="void">void</link> <link linkend="gimp-color-selection-set-old-color">gimp_color_selection_set_old_color</link> (<link linkend="GimpColorSelection">GimpColorSelection</link> *selection,
31
const <link linkend="GimpRGB">GimpRGB</link> *color);
32
<link linkend="void">void</link> <link linkend="gimp-color-selection-get-old-color">gimp_color_selection_get_old_color</link> (<link linkend="GimpColorSelection">GimpColorSelection</link> *selection,
33
<link linkend="GimpRGB">GimpRGB</link> *color);
34
<link linkend="void">void</link> <link linkend="gimp-color-selection-reset">gimp_color_selection_reset</link> (<link linkend="GimpColorSelection">GimpColorSelection</link> *selection);
35
<link linkend="void">void</link> <link linkend="gimp-color-selection-color-changed">gimp_color_selection_color_changed</link> (<link linkend="GimpColorSelection">GimpColorSelection</link> *selection);
36
<link linkend="void">void</link> <link linkend="gimp-color-selection-set-config">gimp_color_selection_set_config</link> (<link linkend="GimpColorSelection">GimpColorSelection</link> *selection,
37
<link linkend="GimpColorConfig">GimpColorConfig</link> *config);
41
<refsect1 id="GimpColorSelection.object-hierarchy" role="object_hierarchy">
42
<title role="object_hierarchy.title">Object Hierarchy</title>
44
<link linkend="GObject">GObject</link>
45
+----<link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
46
+----<link linkend="GtkObject">GtkObject</link>
47
+----<link linkend="GtkWidget">GtkWidget</link>
48
+----<link linkend="GtkContainer">GtkContainer</link>
49
+----<link linkend="GtkBox">GtkBox</link>
50
+----<link linkend="GtkVBox">GtkVBox</link>
51
+----GimpColorSelection
57
<refsect1 id="GimpColorSelection.implemented-interfaces" role="impl_interfaces">
58
<title role="impl_interfaces.title">Implemented Interfaces</title>
60
GimpColorSelection implements
61
<link linkend="GtkBuildable">GtkBuildable</link>, <link linkend="AtkImplementorIface">AtkImplementorIface</link> and <link linkend="GtkOrientable">GtkOrientable</link>.</para>
65
<refsect1 id="GimpColorSelection.properties" role="properties">
66
<title role="properties.title">Properties</title>
68
"<link linkend="GimpColorSelection--config">config</link>" <link linkend="GimpColorConfig">GimpColorConfig</link>* : Write
72
<refsect1 id="GimpColorSelection.signals" role="signal_proto">
73
<title role="signal_proto.title">Signals</title>
75
"<link linkend="GimpColorSelection-color-changed">color-changed</link>" : Run First
80
<refsect1 id="GimpColorSelection.description" role="desc">
81
<title role="desc.title">Description</title>
86
<refsect1 id="GimpColorSelection.details" role="details">
87
<title role="details.title">Details</title>
88
<refsect2 id="GimpColorSelection-struct" role="struct">
89
<title>GimpColorSelection</title>
90
<indexterm zone="GimpColorSelection-struct"><primary sortas="GimpColorSelection">GimpColorSelection</primary></indexterm><programlisting>typedef struct _GimpColorSelection GimpColorSelection;</programlisting>
93
<refsect2 id="gimp-color-selection-new" role="function">
94
<title>gimp_color_selection_new ()</title>
95
<indexterm zone="gimp-color-selection-new"><primary sortas="gimp_color_selection_new">gimp_color_selection_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> * gimp_color_selection_new (void);</programlisting>
97
Creates a new <link linkend="GimpColorSelection"><type>GimpColorSelection</type></link> widget.</para>
99
</para><variablelist role="params">
100
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> The new <link linkend="GimpColorSelection"><type>GimpColorSelection</type></link> widget.
101
</simpara></listitem></varlistentry>
102
</variablelist></refsect2>
103
<refsect2 id="gimp-color-selection-set-show-alpha" role="function">
104
<title>gimp_color_selection_set_show_alpha ()</title>
105
<indexterm zone="gimp-color-selection-set-show-alpha"><primary sortas="gimp_color_selection_set_show_alpha">gimp_color_selection_set_show_alpha</primary></indexterm><programlisting><link linkend="void">void</link> gimp_color_selection_set_show_alpha (<link linkend="GimpColorSelection">GimpColorSelection</link> *selection,
106
<link linkend="gboolean">gboolean</link> show_alpha);</programlisting>
108
Sets the <parameter>show_alpha</parameter> property of the <parameter>selection</parameter> widget.</para>
110
</para><variablelist role="params">
111
<varlistentry><term><parameter>selection</parameter> :</term>
112
<listitem><simpara> A <link linkend="GimpColorSelection"><type>GimpColorSelection</type></link> widget.
113
</simpara></listitem></varlistentry>
114
<varlistentry><term><parameter>show_alpha</parameter> :</term>
115
<listitem><simpara> The new <parameter>show_alpha</parameter> setting.
116
</simpara></listitem></varlistentry>
117
</variablelist></refsect2>
118
<refsect2 id="gimp-color-selection-get-show-alpha" role="function">
119
<title>gimp_color_selection_get_show_alpha ()</title>
120
<indexterm zone="gimp-color-selection-get-show-alpha"><primary sortas="gimp_color_selection_get_show_alpha">gimp_color_selection_get_show_alpha</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gimp_color_selection_get_show_alpha (<link linkend="GimpColorSelection">GimpColorSelection</link> *selection);</programlisting>
122
Returns the <parameter>selection</parameter>'s <parameter>show_alpha</parameter> property.</para>
124
</para><variablelist role="params">
125
<varlistentry><term><parameter>selection</parameter> :</term>
126
<listitem><simpara> A <link linkend="GimpColorSelection"><type>GimpColorSelection</type></link> widget.
127
</simpara></listitem></varlistentry>
128
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> <link linkend="TRUE--CAPS"><type>TRUE</type></link> if the <link linkend="GimpColorSelection"><type>GimpColorSelection</type></link> has alpha controls.
129
</simpara></listitem></varlistentry>
130
</variablelist></refsect2>
131
<refsect2 id="gimp-color-selection-set-color" role="function">
132
<title>gimp_color_selection_set_color ()</title>
133
<indexterm zone="gimp-color-selection-set-color"><primary sortas="gimp_color_selection_set_color">gimp_color_selection_set_color</primary></indexterm><programlisting><link linkend="void">void</link> gimp_color_selection_set_color (<link linkend="GimpColorSelection">GimpColorSelection</link> *selection,
134
const <link linkend="GimpRGB">GimpRGB</link> *color);</programlisting>
136
Sets the <link linkend="GimpColorSelection"><type>GimpColorSelection</type></link>'s current color to the new <parameter>color</parameter>.</para>
138
</para><variablelist role="params">
139
<varlistentry><term><parameter>selection</parameter> :</term>
140
<listitem><simpara> A <link linkend="GimpColorSelection"><type>GimpColorSelection</type></link> widget.
141
</simpara></listitem></varlistentry>
142
<varlistentry><term><parameter>color</parameter> :</term>
143
<listitem><simpara> The <parameter>color</parameter> to set as current color.
144
</simpara></listitem></varlistentry>
145
</variablelist></refsect2>
146
<refsect2 id="gimp-color-selection-get-color" role="function">
147
<title>gimp_color_selection_get_color ()</title>
148
<indexterm zone="gimp-color-selection-get-color"><primary sortas="gimp_color_selection_get_color">gimp_color_selection_get_color</primary></indexterm><programlisting><link linkend="void">void</link> gimp_color_selection_get_color (<link linkend="GimpColorSelection">GimpColorSelection</link> *selection,
149
<link linkend="GimpRGB">GimpRGB</link> *color);</programlisting>
151
This function returns the <link linkend="GimpColorSelection"><type>GimpColorSelection</type></link>'s current color.</para>
153
</para><variablelist role="params">
154
<varlistentry><term><parameter>selection</parameter> :</term>
155
<listitem><simpara> A <link linkend="GimpColorSelection"><type>GimpColorSelection</type></link> widget.
156
</simpara></listitem></varlistentry>
157
<varlistentry><term><parameter>color</parameter> :</term>
158
<listitem><simpara> Return location for the <parameter>selection</parameter>'s current <parameter>color</parameter>.
159
</simpara></listitem></varlistentry>
160
</variablelist></refsect2>
161
<refsect2 id="gimp-color-selection-set-old-color" role="function">
162
<title>gimp_color_selection_set_old_color ()</title>
163
<indexterm zone="gimp-color-selection-set-old-color"><primary sortas="gimp_color_selection_set_old_color">gimp_color_selection_set_old_color</primary></indexterm><programlisting><link linkend="void">void</link> gimp_color_selection_set_old_color (<link linkend="GimpColorSelection">GimpColorSelection</link> *selection,
164
const <link linkend="GimpRGB">GimpRGB</link> *color);</programlisting>
166
Sets the <link linkend="GimpColorSelection"><type>GimpColorSelection</type></link>'s old color.</para>
168
</para><variablelist role="params">
169
<varlistentry><term><parameter>selection</parameter> :</term>
170
<listitem><simpara> A <link linkend="GimpColorSelection"><type>GimpColorSelection</type></link> widget.
171
</simpara></listitem></varlistentry>
172
<varlistentry><term><parameter>color</parameter> :</term>
173
<listitem><simpara> The <parameter>color</parameter> to set as old color.
174
</simpara></listitem></varlistentry>
175
</variablelist></refsect2>
176
<refsect2 id="gimp-color-selection-get-old-color" role="function">
177
<title>gimp_color_selection_get_old_color ()</title>
178
<indexterm zone="gimp-color-selection-get-old-color"><primary sortas="gimp_color_selection_get_old_color">gimp_color_selection_get_old_color</primary></indexterm><programlisting><link linkend="void">void</link> gimp_color_selection_get_old_color (<link linkend="GimpColorSelection">GimpColorSelection</link> *selection,
179
<link linkend="GimpRGB">GimpRGB</link> *color);</programlisting>
181
This function returns the <link linkend="GimpColorSelection"><type>GimpColorSelection</type></link>'s old color.</para>
183
</para><variablelist role="params">
184
<varlistentry><term><parameter>selection</parameter> :</term>
185
<listitem><simpara> A <link linkend="GimpColorSelection"><type>GimpColorSelection</type></link> widget.
186
</simpara></listitem></varlistentry>
187
<varlistentry><term><parameter>color</parameter> :</term>
188
<listitem><simpara> Return location for the <parameter>selection</parameter>'s old <parameter>color</parameter>.
189
</simpara></listitem></varlistentry>
190
</variablelist></refsect2>
191
<refsect2 id="gimp-color-selection-reset" role="function">
192
<title>gimp_color_selection_reset ()</title>
193
<indexterm zone="gimp-color-selection-reset"><primary sortas="gimp_color_selection_reset">gimp_color_selection_reset</primary></indexterm><programlisting><link linkend="void">void</link> gimp_color_selection_reset (<link linkend="GimpColorSelection">GimpColorSelection</link> *selection);</programlisting>
195
Sets the <link linkend="GimpColorSelection"><type>GimpColorSelection</type></link>'s current color to its old color.</para>
197
</para><variablelist role="params">
198
<varlistentry><term><parameter>selection</parameter> :</term>
199
<listitem><simpara> A <link linkend="GimpColorSelection"><type>GimpColorSelection</type></link> widget.
200
</simpara></listitem></varlistentry>
201
</variablelist></refsect2>
202
<refsect2 id="gimp-color-selection-color-changed" role="function">
203
<title>gimp_color_selection_color_changed ()</title>
204
<indexterm zone="gimp-color-selection-color-changed"><primary sortas="gimp_color_selection_color_changed">gimp_color_selection_color_changed</primary></indexterm><programlisting><link linkend="void">void</link> gimp_color_selection_color_changed (<link linkend="GimpColorSelection">GimpColorSelection</link> *selection);</programlisting>
206
Emits the "color-changed" signal.</para>
208
</para><variablelist role="params">
209
<varlistentry><term><parameter>selection</parameter> :</term>
210
<listitem><simpara> A <link linkend="GimpColorSelection"><type>GimpColorSelection</type></link> widget.
211
</simpara></listitem></varlistentry>
212
</variablelist></refsect2>
213
<refsect2 id="gimp-color-selection-set-config" role="function" condition="since:GIMP 2.4">
214
<title>gimp_color_selection_set_config ()</title>
215
<indexterm zone="gimp-color-selection-set-config" role="GIMP 2.4"><primary sortas="gimp_color_selection_set_config">gimp_color_selection_set_config</primary></indexterm><programlisting><link linkend="void">void</link> gimp_color_selection_set_config (<link linkend="GimpColorSelection">GimpColorSelection</link> *selection,
216
<link linkend="GimpColorConfig">GimpColorConfig</link> *config);</programlisting>
218
Sets the color management configuration to use with this color selection.</para>
220
</para><variablelist role="params">
221
<varlistentry><term><parameter>selection</parameter> :</term>
223
</simpara></listitem></varlistentry>
224
<varlistentry><term><parameter>config</parameter> :</term>
226
</simpara></listitem></varlistentry>
227
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
230
<refsect1 id="GimpColorSelection.property-details" role="property_details">
231
<title role="property_details.title">Property Details</title>
232
<refsect2 id="GimpColorSelection--config" role="property"><title>The <literal>"config"</literal> property</title>
233
<indexterm zone="GimpColorSelection--config"><primary sortas="GimpColorSelection:config">GimpColorSelection:config</primary></indexterm><programlisting> "config" <link linkend="GimpColorConfig">GimpColorConfig</link>* : Write</programlisting>
234
<para></para></refsect2>
237
<refsect1 id="GimpColorSelection.signal-details" role="signals">
238
<title role="signals.title">Signal Details</title>
239
<refsect2 id="GimpColorSelection-color-changed" role="signal"><title>The <literal>"color-changed"</literal> signal</title>
240
<indexterm zone="GimpColorSelection-color-changed"><primary sortas="GimpColorSelection::color-changed">GimpColorSelection::color-changed</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="GimpColorSelection">GimpColorSelection</link> *gimpcolorselection,
241
<link linkend="gpointer">gpointer</link> user_data) : Run First</programlisting>
243
</para><variablelist role="params">
244
<varlistentry><term><parameter>gimpcolorselection</parameter> :</term>
245
<listitem><simpara>the object which received the signal.
246
</simpara></listitem></varlistentry>
247
<varlistentry><term><parameter>user_data</parameter> :</term>
248
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
249
</variablelist></refsect2>