8
8
<link rel="up" href="libgimp-general.html" title="Functions not Related to Specific Images">
9
9
<link rel="prev" href="libgimp-gimpcontext.html" title="gimpcontext">
10
10
<link rel="next" href="libgimp-gimphelp.html" title="gimphelp">
11
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
11
<meta name="generator" content="GTK-Doc V1.15 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
<link rel="part" href="libgimp.html" title="Part I. GIMP Library">
14
<link rel="chapter" href="libgimp-general.html" title="Functions not Related to Specific Images">
15
<link rel="chapter" href="libgimp-image.html" title="Manupulating Images and their Properties">
16
<link rel="chapter" href="libgimp-data.html" title="Data Objects">
17
<link rel="chapter" href="libgimp-selectors.html" title="Controlling the Core's Selection Dialogs">
18
<link rel="part" href="libgimpui.html" title="Part II. GIMP User Interface Library">
19
<link rel="chapter" href="libgimpui-hierarchy.html" title="Object Hierarchy">
20
<link rel="index" href="libgimp-index.html" title="Index">
21
<link rel="index" href="libgimp-index-new-in-2-2.html" title="Index of new symbols in GIMP 2.2">
22
<link rel="index" href="libgimp-index-new-in-2-4.html" title="Index of new symbols in GIMP 2.4">
23
<link rel="index" href="libgimp-index-new-in-2-6.html" title="Index of new symbols in GIMP 2.6">
24
<link rel="index" href="libgimp-index-deprecated.html" title="Index of deprecated symbols">
26
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
27
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
49
37
</tr></table></div>
50
38
<div class="refsynopsisdiv" title="Synopsis">
51
39
<a name="libgimp-gimpgimprc.synopsis"></a><h2>Synopsis</h2>
52
<pre class="synopsis">
54
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
55
>gchar</a>* <a class="link" href="libgimp-gimpgimprc.html#gimp-gimprc-query" title="gimp_gimprc_query ()">gimp_gimprc_query</a> (const <a
56
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
59
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
60
>gboolean</a> <a class="link" href="libgimp-gimpgimprc.html#gimp-gimprc-set" title="gimp_gimprc_set ()">gimp_gimprc_set</a> (const <a
61
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
64
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
67
href="../libgimpconfig/GimpColorConfig.html"
68
>GimpColorConfig</a> * <a class="link" href="libgimp-gimpgimprc.html#gimp-get-color-configuration" title="gimp_get_color_configuration ()">gimp_get_color_configuration</a> (void);
70
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
71
>gchar</a>* <a class="link" href="libgimp-gimpgimprc.html#gimp-get-default-comment" title="gimp_get_default_comment ()">gimp_get_default_comment</a> (void);
73
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
74
>GimpUnit</a> <a class="link" href="libgimp-gimpgimprc.html#gimp-get-default-unit" title="gimp_get_default_unit ()">gimp_get_default_unit</a> (void);
76
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
77
>gchar</a>* <a class="link" href="libgimp-gimpgimprc.html#gimp-get-module-load-inhibit" title="gimp_get_module_load_inhibit ()">gimp_get_module_load_inhibit</a> (void);
79
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
80
>gboolean</a> <a class="link" href="libgimp-gimpgimprc.html#gimp-get-monitor-resolution" title="gimp_get_monitor_resolution ()">gimp_get_monitor_resolution</a> (<a
81
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
84
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
87
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
88
>gchar</a>* <a class="link" href="libgimp-gimpgimprc.html#gimp-get-theme-dir" title="gimp_get_theme_dir ()">gimp_get_theme_dir</a> (void);
40
<pre class="synopsis"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>* <a class="link" href="libgimp-gimpgimprc.html#gimp-gimprc-query" title="gimp_gimprc_query ()">gimp_gimprc_query</a> (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *token</code></em>);
41
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="libgimp-gimpgimprc.html#gimp-gimprc-set" title="gimp_gimprc_set ()">gimp_gimprc_set</a> (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *token</code></em>,
42
<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);
43
<a href="../libgimpconfig/GimpColorConfig.html"><span class="returnvalue">GimpColorConfig</span></a> * <a class="link" href="libgimp-gimpgimprc.html#gimp-get-color-configuration" title="gimp_get_color_configuration ()">gimp_get_color_configuration</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
44
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>* <a class="link" href="libgimp-gimpgimprc.html#gimp-get-default-comment" title="gimp_get_default_comment ()">gimp_get_default_comment</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
45
<a href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"><span class="returnvalue">GimpUnit</span></a> <a class="link" href="libgimp-gimpgimprc.html#gimp-get-default-unit" title="gimp_get_default_unit ()">gimp_get_default_unit</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
46
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>* <a class="link" href="libgimp-gimpgimprc.html#gimp-get-module-load-inhibit" title="gimp_get_module_load_inhibit ()">gimp_get_module_load_inhibit</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
47
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="libgimp-gimpgimprc.html#gimp-get-monitor-resolution" title="gimp_get_monitor_resolution ()">gimp_get_monitor_resolution</a> (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *xres</code></em>,
48
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *yres</code></em>);
49
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>* <a class="link" href="libgimp-gimpgimprc.html#gimp-get-theme-dir" title="gimp_get_theme_dir ()">gimp_get_theme_dir</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
91
52
<div class="refsect1" title="Description">
98
59
<a name="libgimp-gimpgimprc.details"></a><h2>Details</h2>
99
60
<div class="refsect2" title="gimp_gimprc_query ()">
100
61
<a name="gimp-gimprc-query"></a><h3>gimp_gimprc_query ()</h3>
101
<pre class="programlisting"><a
102
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
103
>gchar</a>* gimp_gimprc_query (const <a
104
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
105
>gchar</a> *token);</pre>
62
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>* gimp_gimprc_query (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *token</code></em>);</pre>
107
64
Queries the gimprc file parser for information on a specified token.
115
72
with the specified token. This corresponds _only_ to entries with
116
73
the format: (<token> <value>). The value must be a
117
74
string. Entries not corresponding to this format will cause warnings
118
to be issued on gimprc parsing and will not be queryable.</p>
75
to be issued on gimprc parsing and will not be queryable.
121
77
<div class="variablelist"><table border="0">
122
78
<col align="left" valign="top">
125
81
<td><p><span class="term"><em class="parameter"><code>token</code></em> :</span></p></td>
126
<td> The token to query for.
82
<td>The token to query for.
138
94
<div class="refsect2" title="gimp_gimprc_set ()">
139
95
<a name="gimp-gimprc-set"></a><h3>gimp_gimprc_set ()</h3>
140
<pre class="programlisting"><a
141
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
142
>gboolean</a> gimp_gimprc_set (const <a
143
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
146
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
147
>gchar</a> *value);</pre>
96
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gimp_gimprc_set (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *token</code></em>,
97
<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
149
99
Sets a gimprc token to a value and saves it in the gimprc.
153
103
the gimprc file that is considered extraneous to the operation of
154
104
GIMP. Plug-ins that need configuration information can use this
155
105
function to store it, and <a class="link" href="libgimp-gimpgimprc.html#gimp-gimprc-query" title="gimp_gimprc_query ()"><code class="function">gimp_gimprc_query()</code></a> to retrieve it. This
156
will accept _only_ string values in UTF-8 encoding.</p>
106
will accept _only_ string values in UTF-8 encoding.
159
108
<div class="variablelist"><table border="0">
160
109
<col align="left" valign="top">
163
112
<td><p><span class="term"><em class="parameter"><code>token</code></em> :</span></p></td>
164
<td> The token to add or modify.
113
<td>The token to add or modify.
168
117
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
169
<td> The value to set the token to.
118
<td>The value to set the token to.
181
130
<div class="refsect2" title="gimp_get_color_configuration ()">
182
131
<a name="gimp-get-color-configuration"></a><h3>gimp_get_color_configuration ()</h3>
183
<pre class="programlisting"><a
184
href="../libgimpconfig/GimpColorConfig.html"
185
>GimpColorConfig</a> * gimp_get_color_configuration (void);</pre>
187
Retrieve a copy of the current color management configuration.</p>
132
<pre class="programlisting"><a href="../libgimpconfig/GimpColorConfig.html"><span class="returnvalue">GimpColorConfig</span></a> * gimp_get_color_configuration (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
134
Retrieve a copy of the current color management configuration.
190
136
<div class="variablelist"><table border="0">
191
137
<col align="left" valign="top">
193
139
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
194
<td> A copy of the core's <a
195
href="../libgimpconfig/GimpColorConfig.html"
196
><span class="type">GimpColorConfig</span></a>. You should unref
140
<td> A copy of the core's <a href="../libgimpconfig/GimpColorConfig.html"><span class="type">GimpColorConfig</span></a>. You should unref
197
141
this copy if you don't need it any longer.
205
149
<div class="refsect2" title="gimp_get_default_comment ()">
206
150
<a name="gimp-get-default-comment"></a><h3>gimp_get_default_comment ()</h3>
207
<pre class="programlisting"><a
208
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
209
>gchar</a>* gimp_get_default_comment (void);</pre>
151
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>* gimp_get_default_comment (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
211
153
Get the default image comment as specified in the Preferences.
214
Returns a copy of the default image comment.</p>
156
Returns a copy of the default image comment.
217
158
<div class="variablelist"><table border="0">
218
159
<col align="left" valign="top">
227
168
<div class="refsect2" title="gimp_get_default_unit ()">
228
169
<a name="gimp-get-default-unit"></a><h3>gimp_get_default_unit ()</h3>
229
<pre class="programlisting"><a
230
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
231
>GimpUnit</a> gimp_get_default_unit (void);</pre>
170
<pre class="programlisting"><a href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"><span class="returnvalue">GimpUnit</span></a> gimp_get_default_unit (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
233
172
Get the default unit (taken from the user's locale).
236
Returns the default unit's integer ID.</p>
175
Returns the default unit's integer ID.
239
177
<div class="variablelist"><table border="0">
240
178
<col align="left" valign="top">
251
189
<div class="refsect2" title="gimp_get_module_load_inhibit ()">
252
190
<a name="gimp-get-module-load-inhibit"></a><h3>gimp_get_module_load_inhibit ()</h3>
253
<pre class="programlisting"><a
254
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
255
>gchar</a>* gimp_get_module_load_inhibit (void);</pre>
191
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>* gimp_get_module_load_inhibit (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
257
193
Get the list of modules which should not be loaded.
260
Returns a copy of the list of modules which should not be loaded.</p>
196
Returns a copy of the list of modules which should not be loaded.
263
198
<div class="variablelist"><table border="0">
264
199
<col align="left" valign="top">
273
208
<div class="refsect2" title="gimp_get_monitor_resolution ()">
274
209
<a name="gimp-get-monitor-resolution"></a><h3>gimp_get_monitor_resolution ()</h3>
275
<pre class="programlisting"><a
276
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
277
>gboolean</a> gimp_get_monitor_resolution (<a
278
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
281
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"
282
>gdouble</a> *yres);</pre>
210
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gimp_get_monitor_resolution (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *xres</code></em>,
211
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *yres</code></em>);</pre>
284
213
Get the monitor resolution as specified in the Preferences.
287
216
Returns the resolution of the monitor in pixels/inch. This value is
288
217
taken from the Preferences (or the windowing system if this is set
289
218
in the Preferences) and there's no guarantee for the value to be
293
221
<div class="variablelist"><table border="0">
294
222
<col align="left" valign="top">
297
225
<td><p><span class="term"><em class="parameter"><code>xres</code></em> :</span></p></td>
302
230
<td><p><span class="term"><em class="parameter"><code>yres</code></em> :</span></p></td>
315
243
<div class="refsect2" title="gimp_get_theme_dir ()">
316
244
<a name="gimp-get-theme-dir"></a><h3>gimp_get_theme_dir ()</h3>
317
<pre class="programlisting"><a
318
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
319
>gchar</a>* gimp_get_theme_dir (void);</pre>
245
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>* gimp_get_theme_dir (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
321
247
Get the directory of the current GUI theme.
324
Returns a copy of the current GUI theme dir.</p>
250
Returns a copy of the current GUI theme dir.
327
252
<div class="variablelist"><table border="0">
328
253
<col align="left" valign="top">