~ubuntu-branches/ubuntu/jaunty/gimp/jaunty-security

« back to all changes in this revision

Viewing changes to devel-docs/libgimpthumb/html/libgimpthumb-gimpthumb-utils.html

  • Committer: Bazaar Package Importer
  • Author(s): Pedro Fragoso
  • Date: 2008-08-22 11:50:05 UTC
  • mfrom: (0.1.1 upstream)
  • mto: This revision was merged to the branch mainline in revision 34.
  • Revision ID: james.westby@ubuntu.com-20080822115005-yxj5svf3v9x1mkr7
Tags: upstream-2.4.7
Import upstream version 2.4.7

Show diffs side-by-side

added added

removed removed

Lines of Context:
41
41
<div class="refsynopsisdiv">
42
42
<a name="libgimpthumb-gimpthumb-utils.synopsis"></a><h2>Synopsis</h2>
43
43
<pre class="synopsis">
44
 
<a
45
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
46
 
>gboolean</a>            <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-init" title="gimp_thumb_init ()">gimp_thumb_init</a>                     (const <a
47
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
48
 
>gchar</a> *creator,
49
 
                                                         const <a
50
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
51
 
>gchar</a> *thumb_basedir);
52
 
<a
53
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
54
 
>gchar</a>*              <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-find-thumb" title="gimp_thumb_find_thumb ()">gimp_thumb_find_thumb</a>               (const <a
55
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
56
 
>gchar</a> *uri,
 
44
gboolean            <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-init" title="gimp_thumb_init ()">gimp_thumb_init</a>                     (const gchar *creator,
 
45
                                                         const gchar *thumb_basedir);
 
46
gchar*              <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-find-thumb" title="gimp_thumb_find_thumb ()">gimp_thumb_find_thumb</a>               (const gchar *uri,
57
47
                                                         <a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize" title="enum GimpThumbSize">GimpThumbSize</a> *size);
58
 
<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbFileType" title="enum GimpThumbFileType">GimpThumbFileType</a>   <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-file-test" title="gimp_thumb_file_test ()">gimp_thumb_file_test</a>                (const <a
59
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
60
 
>gchar</a> *filename,
61
 
                                                         <a
62
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint64"
63
 
>gint64</a> *mtime,
64
 
                                                         <a
65
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint64"
66
 
>gint64</a> *size,
67
 
                                                         <a
68
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
69
 
>gint</a> *err_no);
70
 
<a
71
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
72
 
>gchar</a>*              <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-name-from-uri" title="gimp_thumb_name_from_uri ()">gimp_thumb_name_from_uri</a>            (const <a
73
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
74
 
>gchar</a> *uri,
75
 
                                                         <a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize" title="enum GimpThumbSize">GimpThumbSize</a> size);
76
 
<a
77
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
78
 
>gboolean</a>            <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-ensure-thumb-dir" title="gimp_thumb_ensure_thumb_dir ()">gimp_thumb_ensure_thumb_dir</a>         (<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize" title="enum GimpThumbSize">GimpThumbSize</a> size,
79
 
                                                         <a
80
 
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
81
 
>GError</a> **error);
82
 
const <a
83
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
84
 
>gchar</a>*        <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-get-thumb-dir" title="gimp_thumb_get_thumb_dir ()">gimp_thumb_get_thumb_dir</a>            (<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize" title="enum GimpThumbSize">GimpThumbSize</a> size);
85
 
void                <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumbs-delete-for-uri" title="gimp_thumbs_delete_for_uri ()">gimp_thumbs_delete_for_uri</a>          (const <a
86
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
87
 
>gchar</a> *uri);
88
 
<a
89
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
90
 
>gchar</a>*              <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-name-from-uri-local" title="gimp_thumb_name_from_uri_local ()">gimp_thumb_name_from_uri_local</a>      (const <a
91
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
92
 
>gchar</a> *uri,
93
 
                                                         <a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize" title="enum GimpThumbSize">GimpThumbSize</a> size);
94
 
<a
95
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
96
 
>gboolean</a>            <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-ensure-thumb-dir-local" title="gimp_thumb_ensure_thumb_dir_local ()">gimp_thumb_ensure_thumb_dir_local</a>   (const <a
97
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
98
 
>gchar</a> *dirname,
 
48
<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbFileType" title="enum GimpThumbFileType">GimpThumbFileType</a>   <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-file-test" title="gimp_thumb_file_test ()">gimp_thumb_file_test</a>                (const gchar *filename,
 
49
                                                         gint64 *mtime,
 
50
                                                         gint64 *size,
 
51
                                                         gint *err_no);
 
52
gchar*              <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-name-from-uri" title="gimp_thumb_name_from_uri ()">gimp_thumb_name_from_uri</a>            (const gchar *uri,
 
53
                                                         <a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize" title="enum GimpThumbSize">GimpThumbSize</a> size);
 
54
gboolean            <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-ensure-thumb-dir" title="gimp_thumb_ensure_thumb_dir ()">gimp_thumb_ensure_thumb_dir</a>         (<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize" title="enum GimpThumbSize">GimpThumbSize</a> size,
 
55
                                                         GError **error);
 
56
const gchar*        <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-get-thumb-dir" title="gimp_thumb_get_thumb_dir ()">gimp_thumb_get_thumb_dir</a>            (<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize" title="enum GimpThumbSize">GimpThumbSize</a> size);
 
57
void                <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumbs-delete-for-uri" title="gimp_thumbs_delete_for_uri ()">gimp_thumbs_delete_for_uri</a>          (const gchar *uri);
 
58
gchar*              <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-name-from-uri-local" title="gimp_thumb_name_from_uri_local ()">gimp_thumb_name_from_uri_local</a>      (const gchar *uri,
 
59
                                                         <a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize" title="enum GimpThumbSize">GimpThumbSize</a> size);
 
60
gboolean            <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-ensure-thumb-dir-local" title="gimp_thumb_ensure_thumb_dir_local ()">gimp_thumb_ensure_thumb_dir_local</a>   (const gchar *dirname,
99
61
                                                         <a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize" title="enum GimpThumbSize">GimpThumbSize</a> size,
100
 
                                                         <a
101
 
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
102
 
>GError</a> **error);
103
 
<a
104
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
105
 
>gchar</a>*              <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-get-thumb-dir-local" title="gimp_thumb_get_thumb_dir_local ()">gimp_thumb_get_thumb_dir_local</a>      (const <a
106
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
107
 
>gchar</a> *dirname,
 
62
                                                         GError **error);
 
63
gchar*              <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-get-thumb-dir-local" title="gimp_thumb_get_thumb_dir_local ()">gimp_thumb_get_thumb_dir_local</a>      (const gchar *dirname,
108
64
                                                         <a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize" title="enum GimpThumbSize">GimpThumbSize</a> size);
109
 
void                <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumbs-delete-for-uri-local" title="gimp_thumbs_delete_for_uri_local ()">gimp_thumbs_delete_for_uri_local</a>    (const <a
110
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
111
 
>gchar</a> *uri);
 
65
void                <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumbs-delete-for-uri-local" title="gimp_thumbs_delete_for_uri_local ()">gimp_thumbs_delete_for_uri_local</a>    (const gchar *uri);
112
66
</pre>
113
67
</div>
114
68
<div class="refsect1" lang="en">
121
75
<a name="libgimpthumb-gimpthumb-utils.details"></a><h2>Details</h2>
122
76
<div class="refsect2" lang="en">
123
77
<a name="gimp-thumb-init"></a><h3>gimp_thumb_init ()</h3>
124
 
<pre class="programlisting"><a
125
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
126
 
>gboolean</a>            gimp_thumb_init                     (const <a
127
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
128
 
>gchar</a> *creator,
129
 
                                                         const <a
130
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
131
 
>gchar</a> *thumb_basedir);</pre>
 
78
<pre class="programlisting">gboolean            gimp_thumb_init                     (const gchar *creator,
 
79
                                                         const gchar *thumb_basedir);</pre>
132
80
<p>
133
81
This function initializes the thumbnail system. It must be called
134
82
before any other functions from libgimpthumb are used. You may call
143
91
thumbnail creation failures. See the spec for more details.
144
92
</p>
145
93
<p>
146
 
Usually you will pass <a
147
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
148
 
><code class="literal">NULL</code></a> for <em class="parameter"><code>thumb_basedir</code></em>. Thumbnails will
 
94
Usually you will pass <code class="literal">NULL</code> for <em class="parameter"><code>thumb_basedir</code></em>. Thumbnails will
149
95
then be stored in the user's personal thumbnail directory as
150
96
defined in the spec. If you wish to use libgimpthumb to store
151
97
application-specific thumbnails, you can specify a different base
163
109
</tr>
164
110
<tr>
165
111
<td><p><span class="term"><em class="parameter"><code>thumb_basedir</code></em> :</span></p></td>
166
 
<td> an absolute path or <a
167
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
168
 
><code class="literal">NULL</code></a> to use the default
 
112
<td> an absolute path or <code class="literal">NULL</code> to use the default
169
113
</td>
170
114
</tr>
171
115
<tr>
172
116
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
173
 
<td> <a
174
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
175
 
><code class="literal">TRUE</code></a> if the library was successfully initialized.
 
117
<td> <code class="literal">TRUE</code> if the library was successfully initialized.
176
118
</td>
177
119
</tr>
178
120
</tbody>
181
123
<hr>
182
124
<div class="refsect2" lang="en">
183
125
<a name="gimp-thumb-find-thumb"></a><h3>gimp_thumb_find_thumb ()</h3>
184
 
<pre class="programlisting"><a
185
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
186
 
>gchar</a>*              gimp_thumb_find_thumb               (const <a
187
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
188
 
>gchar</a> *uri,
 
126
<pre class="programlisting">gchar*              gimp_thumb_find_thumb               (const gchar *uri,
189
127
                                                         <a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize" title="enum GimpThumbSize">GimpThumbSize</a> *size);</pre>
190
128
<p>
191
129
This function attempts to locate a thumbnail for the given
221
159
<tr>
222
160
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
223
161
<td> a newly allocated string in the encoding of the
224
 
              filesystem or <a
225
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
226
 
><code class="literal">NULL</code></a> if no thumbnail for <em class="parameter"><code>uri</code></em> was found
 
162
              filesystem or <code class="literal">NULL</code> if no thumbnail for <em class="parameter"><code>uri</code></em> was found
227
163
</td>
228
164
</tr>
229
165
</tbody>
232
168
<hr>
233
169
<div class="refsect2" lang="en">
234
170
<a name="gimp-thumb-file-test"></a><h3>gimp_thumb_file_test ()</h3>
235
 
<pre class="programlisting"><a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbFileType" title="enum GimpThumbFileType">GimpThumbFileType</a>   gimp_thumb_file_test                (const <a
236
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
237
 
>gchar</a> *filename,
238
 
                                                         <a
239
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint64"
240
 
>gint64</a> *mtime,
241
 
                                                         <a
242
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint64"
243
 
>gint64</a> *size,
244
 
                                                         <a
245
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
246
 
>gint</a> *err_no);</pre>
 
171
<pre class="programlisting"><a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbFileType" title="enum GimpThumbFileType">GimpThumbFileType</a>   gimp_thumb_file_test                (const gchar *filename,
 
172
                                                         gint64 *mtime,
 
173
                                                         gint64 *size,
 
174
                                                         gint *err_no);</pre>
247
175
<p>
248
176
This is a convenience and portability wrapper around <code class="function">stat()</code>. It
249
177
checks if the given <em class="parameter"><code>filename</code></em> exists and returns modification time
286
214
<hr>
287
215
<div class="refsect2" lang="en">
288
216
<a name="gimp-thumb-name-from-uri"></a><h3>gimp_thumb_name_from_uri ()</h3>
289
 
<pre class="programlisting"><a
290
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
291
 
>gchar</a>*              gimp_thumb_name_from_uri            (const <a
292
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
293
 
>gchar</a> *uri,
 
217
<pre class="programlisting">gchar*              gimp_thumb_name_from_uri            (const gchar *uri,
294
218
                                                         <a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize" title="enum GimpThumbSize">GimpThumbSize</a> size);</pre>
295
219
<p>
296
220
Creates the name of the thumbnail file of the specified <em class="parameter"><code>size</code></em> that
314
238
<tr>
315
239
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
316
240
<td> a newly allocated filename in the encoding of the
317
 
              filesystem or <a
318
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
319
 
><code class="literal">NULL</code></a> if <em class="parameter"><code>uri</code></em> points to the user's
 
241
              filesystem or <code class="literal">NULL</code> if <em class="parameter"><code>uri</code></em> points to the user's
320
242
              thumbnail repository.
321
243
</td>
322
244
</tr>
326
248
<hr>
327
249
<div class="refsect2" lang="en">
328
250
<a name="gimp-thumb-ensure-thumb-dir"></a><h3>gimp_thumb_ensure_thumb_dir ()</h3>
329
 
<pre class="programlisting"><a
330
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
331
 
>gboolean</a>            gimp_thumb_ensure_thumb_dir         (<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize" title="enum GimpThumbSize">GimpThumbSize</a> size,
332
 
                                                         <a
333
 
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
334
 
>GError</a> **error);</pre>
 
251
<pre class="programlisting">gboolean            gimp_thumb_ensure_thumb_dir         (<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize" title="enum GimpThumbSize">GimpThumbSize</a> size,
 
252
                                                         GError **error);</pre>
335
253
<p>
336
254
This function checks if the directory that is required to store
337
255
thumbnails for a particular <em class="parameter"><code>size</code></em> exist and attempts to create it
359
277
</tr>
360
278
<tr>
361
279
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
362
 
<td> <a
363
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
364
 
><code class="literal">TRUE</code></a> is the directory exists, <a
365
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
366
 
><code class="literal">FALSE</code></a> if it could not
 
280
<td> <code class="literal">TRUE</code> is the directory exists, <code class="literal">FALSE</code> if it could not
367
281
              be created
368
282
</td>
369
283
</tr>
373
287
<hr>
374
288
<div class="refsect2" lang="en">
375
289
<a name="gimp-thumb-get-thumb-dir"></a><h3>gimp_thumb_get_thumb_dir ()</h3>
376
 
<pre class="programlisting">const <a
377
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
378
 
>gchar</a>*        gimp_thumb_get_thumb_dir            (<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize" title="enum GimpThumbSize">GimpThumbSize</a> size);</pre>
 
290
<pre class="programlisting">const gchar*        gimp_thumb_get_thumb_dir            (<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize" title="enum GimpThumbSize">GimpThumbSize</a> size);</pre>
379
291
<p>
380
292
Retrieve the name of the thumbnail folder for a specific size. The
381
293
returned pointer will become invalid if <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-init" title="gimp_thumb_init ()"><code class="function">gimp_thumb_init()</code></a> is used
402
314
<hr>
403
315
<div class="refsect2" lang="en">
404
316
<a name="gimp-thumbs-delete-for-uri"></a><h3>gimp_thumbs_delete_for_uri ()</h3>
405
 
<pre class="programlisting">void                gimp_thumbs_delete_for_uri          (const <a
406
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
407
 
>gchar</a> *uri);</pre>
 
317
<pre class="programlisting">void                gimp_thumbs_delete_for_uri          (const gchar *uri);</pre>
408
318
<p>
409
319
Deletes all thumbnails for the image file specified by <em class="parameter"><code>uri</code></em> from the
410
320
user's thumbnail repository.</p>
425
335
<hr>
426
336
<div class="refsect2" lang="en">
427
337
<a name="gimp-thumb-name-from-uri-local"></a><h3>gimp_thumb_name_from_uri_local ()</h3>
428
 
<pre class="programlisting"><a
429
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
430
 
>gchar</a>*              gimp_thumb_name_from_uri_local      (const <a
431
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
432
 
>gchar</a> *uri,
 
338
<pre class="programlisting">gchar*              gimp_thumb_name_from_uri_local      (const gchar *uri,
433
339
                                                         <a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize" title="enum GimpThumbSize">GimpThumbSize</a> size);</pre>
434
340
<p>
435
341
Creates the name of a local thumbnail file of the specified <em class="parameter"><code>size</code></em>
454
360
<tr>
455
361
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
456
362
<td> a newly allocated filename in the encoding of the
457
 
              filesystem or <a
458
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
459
 
><code class="literal">NULL</code></a> if <em class="parameter"><code>uri</code></em> is a remote file or
 
363
              filesystem or <code class="literal">NULL</code> if <em class="parameter"><code>uri</code></em> is a remote file or
460
364
              points to the user's thumbnail repository.
461
365
 
462
366
</td>
469
373
<hr>
470
374
<div class="refsect2" lang="en">
471
375
<a name="gimp-thumb-ensure-thumb-dir-local"></a><h3>gimp_thumb_ensure_thumb_dir_local ()</h3>
472
 
<pre class="programlisting"><a
473
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
474
 
>gboolean</a>            gimp_thumb_ensure_thumb_dir_local   (const <a
475
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
476
 
>gchar</a> *dirname,
 
376
<pre class="programlisting">gboolean            gimp_thumb_ensure_thumb_dir_local   (const gchar *dirname,
477
377
                                                         <a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize" title="enum GimpThumbSize">GimpThumbSize</a> size,
478
 
                                                         <a
479
 
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
480
 
>GError</a> **error);</pre>
 
378
                                                         GError **error);</pre>
481
379
<p>
482
380
This function checks if the directory that is required to store
483
381
local thumbnails for a particular <em class="parameter"><code>size</code></em> exist and attempts to
509
407
</tr>
510
408
<tr>
511
409
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
512
 
<td> <a
513
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
514
 
><code class="literal">TRUE</code></a> is the directory exists, <a
515
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
516
 
><code class="literal">FALSE</code></a> if it could not
 
410
<td> <code class="literal">TRUE</code> is the directory exists, <code class="literal">FALSE</code> if it could not
517
411
              be created
518
412
 
519
413
</td>
526
420
<hr>
527
421
<div class="refsect2" lang="en">
528
422
<a name="gimp-thumb-get-thumb-dir-local"></a><h3>gimp_thumb_get_thumb_dir_local ()</h3>
529
 
<pre class="programlisting"><a
530
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
531
 
>gchar</a>*              gimp_thumb_get_thumb_dir_local      (const <a
532
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
533
 
>gchar</a> *dirname,
 
423
<pre class="programlisting">gchar*              gimp_thumb_get_thumb_dir_local      (const gchar *dirname,
534
424
                                                         <a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize" title="enum GimpThumbSize">GimpThumbSize</a> size);</pre>
535
425
<p>
536
426
Retrieve the name of the local thumbnail folder for a specific
566
456
<hr>
567
457
<div class="refsect2" lang="en">
568
458
<a name="gimp-thumbs-delete-for-uri-local"></a><h3>gimp_thumbs_delete_for_uri_local ()</h3>
569
 
<pre class="programlisting">void                gimp_thumbs_delete_for_uri_local    (const <a
570
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
571
 
>gchar</a> *uri);</pre>
 
459
<pre class="programlisting">void                gimp_thumbs_delete_for_uri_local    (const gchar *uri);</pre>
572
460
<p>
573
461
Deletes all thumbnails for the image file specified by <em class="parameter"><code>uri</code></em> from
574
462
the local thumbnail repository.</p>