4
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
5
<title>gimpgimprc</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
6
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
7
7
<link rel="start" href="index.html" title="GIMP Library Reference Manual">
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.7 (XML mode)">
11
<meta name="generator" content="GTK-Doc V1.8 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
<link rel="part" href="gimpdefinitions.html" title="Part I. GIMP Constants">
14
<link rel="part" href="libgimp.html" title="Part II. GIMP Library">
13
<link rel="part" href="libgimp.html" title="Part I. GIMP Library">
15
14
<link rel="chapter" href="libgimp-general.html" title="Functions not Related to Specific Images">
16
<link rel="chapter" href="libgimp-image.html" title="Manupulating Images and all their Properties">
15
<link rel="chapter" href="libgimp-image.html" title="Manupulating Images and their Properties">
17
16
<link rel="chapter" href="libgimp-data.html" title="Data Objects">
18
17
<link rel="chapter" href="libgimp-selectors.html" title="Controlling the Core's Selection Dialogs">
19
<link rel="part" href="libgimpui.html" title="Part III. GIMP User Interface Library">
18
<link rel="part" href="libgimpui.html" title="Part II. GIMP User Interface Library">
20
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-deprecated.html" title="Index of deprecated symbols">
22
25
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
23
26
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
28
31
<th width="100%" align="center">GIMP Library Reference Manual</th>
29
32
<td><a accesskey="n" href="libgimp-gimphelp.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
31
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2538960" class="shortcut">Top</a>
34
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2587905" class="shortcut">Top</a>
33
<a href="#id2541521" class="shortcut">Description</a></nobr></td></tr>
36
<a href="#id2600226" class="shortcut">Description</a></nobr></td></tr>
35
38
<div class="refentry" lang="en">
36
39
<a name="libgimp-gimpgimprc"></a><div class="titlepage"></div>
37
40
<div class="refnamediv"><table width="100%"><tr>
40
<a name="id2538960"></a><span class="refentrytitle">gimpgimprc</span>
43
<a name="id2587905"></a><span class="refentrytitle">gimpgimprc</span>
42
45
<p>gimpgimprc — Interactions with settings from .gimprc.</p>
52
gchar* <a href="libgimp-gimpgimprc.html#gimp-gimprc-query">gimp_gimprc_query</a> (const gchar *token);
53
gboolean <a href="libgimp-gimpgimprc.html#gimp-gimprc-set">gimp_gimprc_set</a> (const gchar *token,
55
gchar* <a href="libgimp-gimpgimprc.html#gimp-get-default-comment">gimp_get_default_comment</a> (void);
56
gchar* <a href="libgimp-gimpgimprc.html#gimp-get-module-load-inhibit">gimp_get_module_load_inhibit</a> (void);
57
gboolean <a href="libgimp-gimpgimprc.html#gimp-get-monitor-resolution">gimp_get_monitor_resolution</a> (gdouble *xres,
59
gchar* <a href="libgimp-gimpgimprc.html#gimp-get-theme-dir">gimp_get_theme_dir</a> (void);
55
gchar* <a href="libgimp-gimpgimprc.html#gimp-gimprc-query">gimp_gimprc_query</a> (const gchar *token);
56
gboolean <a href="libgimp-gimpgimprc.html#gimp-gimprc-set">gimp_gimprc_set</a> (const gchar *token,
59
href="../libgimpconfig/GimpColorConfig.html"
60
>GimpColorConfig</a>* <a href="libgimp-gimpgimprc.html#gimp-get-color-configuration">gimp_get_color_configuration</a> (void);
61
gchar* <a href="libgimp-gimpgimprc.html#gimp-get-default-comment">gimp_get_default_comment</a> (void);
63
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
64
>GimpUnit</a> <a href="libgimp-gimpgimprc.html#gimp-get-default-unit">gimp_get_default_unit</a> (void);
65
gchar* <a href="libgimp-gimpgimprc.html#gimp-get-module-load-inhibit">gimp_get_module_load_inhibit</a> (void);
66
gboolean <a href="libgimp-gimpgimprc.html#gimp-get-monitor-resolution">gimp_get_monitor_resolution</a> (gdouble *xres,
68
gchar* <a href="libgimp-gimpgimprc.html#gimp-get-theme-dir">gimp_get_theme_dir</a> (void);
62
71
<div class="refsect1" lang="en">
63
<a name="id2541521"></a><h2>Description</h2>
72
<a name="id2600226"></a><h2>Description</h2>
65
74
Interactions with settings from .gimprc.
69
78
<div class="refsect1" lang="en">
70
<a name="id2541536"></a><h2>Details</h2>
79
<a name="id2600242"></a><h2>Details</h2>
71
80
<div class="refsect2" lang="en">
72
<a name="id2541547"></a><h3>
81
<a name="id2600252"></a><h3>
73
82
<a name="gimp-gimprc-query"></a>gimp_gimprc_query ()</h3>
74
<a class="indexterm" name="id2541559"></a><pre class="programlisting">gchar* gimp_gimprc_query (const gchar *token);</pre>
83
<a class="indexterm" name="id2600265"></a><pre class="programlisting">gchar* gimp_gimprc_query (const gchar *token);</pre>
76
85
Queries the gimprc file parser for information on a specified token.
92
101
<col align="left" valign="top">
96
<span class="term"><em class="parameter"><code>token</code></em> :</span></td>
104
<td><span class="term"><em class="parameter"><code>token</code></em> :</span></td>
97
105
<td> The token to query for.
102
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
109
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
103
110
<td> The value associated with the queried token.
110
117
<div class="refsect2" lang="en">
111
<a name="id2554933"></a><h3>
118
<a name="id2574878"></a><h3>
112
119
<a name="gimp-gimprc-set"></a>gimp_gimprc_set ()</h3>
113
<a class="indexterm" name="id2541608"></a><pre class="programlisting">gboolean gimp_gimprc_set (const gchar *token,
114
const gchar *value);</pre>
120
<a class="indexterm" name="id2574890"></a><pre class="programlisting">gboolean gimp_gimprc_set (const gchar *token,
121
const gchar *value);</pre>
116
123
Sets a gimprc token to a value and saves it in the gimprc.
119
126
This procedure is used to add or change additional information in
120
127
the gimprc file that is considered extraneous to the operation of
121
128
the GIMP. Plug-ins that need configuration information can use this
122
function to store it, and gimp_gimprc_query to retrieve it. This
129
function to store it, and <a href="libgimp-gimpgimprc.html#gimp-gimprc-query"><code class="function">gimp_gimprc_query()</code></a> to retrieve it. This
123
130
will accept _only_ string values in UTF-8 encoding.</p>
128
135
<col align="left" valign="top">
132
<span class="term"><em class="parameter"><code>token</code></em> :</span></td>
138
<td><span class="term"><em class="parameter"><code>token</code></em> :</span></td>
133
139
<td> The token to add or modify.
138
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
143
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
139
144
<td> The value to set the token to.
144
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
148
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
145
149
<td> TRUE on success.
152
156
<div class="refsect2" lang="en">
153
<a name="id2538710"></a><h3>
157
<a name="id2574991"></a><h3>
158
<a name="gimp-get-color-configuration"></a>gimp_get_color_configuration ()</h3>
159
<a class="indexterm" name="id2563209"></a><pre class="programlisting"><a
160
href="../libgimpconfig/GimpColorConfig.html"
161
>GimpColorConfig</a>* gimp_get_color_configuration (void);</pre>
163
Retrieve a copy of the current color management configuration.</p>
167
<div class="variablelist"><table border="0">
168
<col align="left" valign="top">
170
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
171
<td> A copy of the core's <a
172
href="../libgimpconfig/GimpColorConfig.html"
173
><span class="type">GimpColorConfig</span></a>. You should unref
174
this copy if you don't need it any longer.
179
<p class="since">Since GIMP 2.4
183
<div class="refsect2" lang="en">
184
<a name="id2563265"></a><h3>
154
185
<a name="gimp-get-default-comment"></a>gimp_get_default_comment ()</h3>
155
<a class="indexterm" name="id2538721"></a><pre class="programlisting">gchar* gimp_get_default_comment (void);</pre>
186
<a class="indexterm" name="id2563276"></a><pre class="programlisting">gchar* gimp_get_default_comment (void);</pre>
157
188
Get the default image comment as specified in the Preferences.
164
195
<div class="variablelist"><table border="0">
165
196
<col align="left" valign="top">
168
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
169
<td> Default Image Comment.
175
<div class="refsect2" lang="en">
176
<a name="id2538766"></a><h3>
198
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
199
<td> Default image comment.
205
<div class="refsect2" lang="en">
206
<a name="id2563321"></a><h3>
207
<a name="gimp-get-default-unit"></a>gimp_get_default_unit ()</h3>
208
<a class="indexterm" name="id2563335"></a><pre class="programlisting"><a
209
href="../libgimpbase/libgimpbase-gimpunit.html#GimpUnit"
210
>GimpUnit</a> gimp_get_default_unit (void);</pre>
212
Get the default unit (taken from the user's locale).
215
Returns the default unit's integer ID.</p>
219
<div class="variablelist"><table border="0">
220
<col align="left" valign="top">
222
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
228
<p class="since">Since GIMP 2.4
232
<div class="refsect2" lang="en">
233
<a name="id2563386"></a><h3>
177
234
<a name="gimp-get-module-load-inhibit"></a>gimp_get_module_load_inhibit ()</h3>
178
<a class="indexterm" name="id2538777"></a><pre class="programlisting">gchar* gimp_get_module_load_inhibit (void);</pre>
235
<a class="indexterm" name="id2563399"></a><pre class="programlisting">gchar* gimp_get_module_load_inhibit (void);</pre>
180
237
Get the list of modules which should not be loaded.
187
244
<div class="variablelist"><table border="0">
188
245
<col align="left" valign="top">
191
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
247
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
192
248
<td> The list of modules.
198
254
<div class="refsect2" lang="en">
199
<a name="id2570158"></a><h3>
255
<a name="id2563444"></a><h3>
200
256
<a name="gimp-get-monitor-resolution"></a>gimp_get_monitor_resolution ()</h3>
201
<a class="indexterm" name="id2570169"></a><pre class="programlisting">gboolean gimp_get_monitor_resolution (gdouble *xres,
202
gdouble *yres);</pre>
257
<a class="indexterm" name="id2560040"></a><pre class="programlisting">gboolean gimp_get_monitor_resolution (gdouble *xres,
258
gdouble *yres);</pre>
204
260
Get the monitor resolution as specified in the Preferences.
215
271
<col align="left" valign="top">
219
<span class="term"><em class="parameter"><code>xres</code></em> :</span></td>
274
<td><span class="term"><em class="parameter"><code>xres</code></em> :</span></td>
220
275
<td> X resolution.
225
<span class="term"><em class="parameter"><code>yres</code></em> :</span></td>
279
<td><span class="term"><em class="parameter"><code>yres</code></em> :</span></td>
226
280
<td> Y resolution.
231
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
284
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
232
285
<td> TRUE on success.
239
292
<div class="refsect2" lang="en">
240
<a name="id2570258"></a><h3>
293
<a name="id2560130"></a><h3>
241
294
<a name="gimp-get-theme-dir"></a>gimp_get_theme_dir ()</h3>
242
<a class="indexterm" name="id2570270"></a><pre class="programlisting">gchar* gimp_get_theme_dir (void);</pre>
295
<a class="indexterm" name="id2560142"></a><pre class="programlisting">gchar* gimp_get_theme_dir (void);</pre>
244
297
Get the directory of the current GUI theme.
251
304
<div class="variablelist"><table border="0">
252
305
<col align="left" valign="top">
255
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
307
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
256
308
<td> The GUI theme dir.