callisto-debian/gimp
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Imported Upstream version 2.4.0~rc3

Browse Source
This commit is contained in:
Ari Pollak
2010-08-11 01:23:08 -04:00
parent 4be5597e32
commit f35d8506c6
668 changed files with 59324 additions and 37769 deletions
Download Patch File Download Diff File Expand all files Collapse all files

558
devel-docs/libgimpthumb/html/GimpThumbnail.html
View File

@ -3,7 +3,7 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>GimpThumbnail</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
<link rel="start" href="index.html" title="GIMP Thumbnail Library Reference Manual">
<link rel="up" href="libgimpthumb.html" title="Part&#160;I.&#160;GIMP Thumbnail Library">
<link rel="prev" href="libgimpthumb.html" title="Part&#160;I.&#160;GIMP Thumbnail Library">
@ -25,20 +25,20 @@
<th width="100%" align="center">GIMP Thumbnail Library Reference Manual</th>
<td><a accesskey="n" href="libgimpthumb-gimpthumb-utils.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2601027" class="shortcut">Top</a>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2583860" class="shortcut">Top</a>
&#160;|&#160;
<a href="#id2592344" class="shortcut">Description</a>
<a href="#id2575177" class="shortcut">Description</a>
&#160;|&#160;
<a href="#id2592184" class="shortcut">Object Hierarchy</a>
<a href="#id2575018" class="shortcut">Object Hierarchy</a>
&#160;|&#160;
<a href="#id2592208" class="shortcut">Properties</a></nobr></td></tr>
<a href="#id2575042" class="shortcut">Properties</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="GimpThumbnail"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id2601027"></a><span class="refentrytitle">GimpThumbnail</span>
<a name="id2583860"></a><span class="refentrytitle">GimpThumbnail</span>
</h2>
<p>GimpThumbnail &#8212; The GimpThumbnail object</p>
</td>
@ -50,97 +50,157 @@
<a class="link" href="GimpThumbnail.html#GimpThumbnail-struct">GimpThumbnail</a>;
<a class="link" href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a>* <a class="link" href="GimpThumbnail.html#gimp-thumbnail-new">gimp_thumbnail_new</a> (void);
void <a class="link" href="GimpThumbnail.html#gimp-thumbnail-set-uri">gimp_thumbnail_set_uri</a> (<a class="link" href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
const gchar *uri);
gboolean <a class="link" href="GimpThumbnail.html#gimp-thumbnail-set-filename">gimp_thumbnail_set_filename</a> (<a class="link" href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
const gchar *filename,
GError **error);
gboolean <a class="link" href="GimpThumbnail.html#gimp-thumbnail-set-from-thumb">gimp_thumbnail_set_from_thumb</a> (<a class="link" href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
const gchar *filename,
GError **error);
<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbState">GimpThumbState</a> <a class="link" href="GimpThumbnail.html#gimp-thumbnail-peek-image">gimp_thumbnail_peek_image</a> (<a class="link" href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail);
<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbState">GimpThumbState</a> <a class="link" href="GimpThumbnail.html#gimp-thumbnail-peek-thumb">gimp_thumbnail_peek_thumb</a> (<a class="link" href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size);
<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbState">GimpThumbState</a> <a class="link" href="GimpThumbnail.html#gimp-thumbnail-check-thumb">gimp_thumbnail_check_thumb</a> (<a class="link" href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size);
GdkPixbuf* <a class="link" href="GimpThumbnail.html#gimp-thumbnail-load-thumb">gimp_thumbnail_load_thumb</a> (<a class="link" href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size,
GError **error);
gboolean <a class="link" href="GimpThumbnail.html#gimp-thumbnail-save-thumb">gimp_thumbnail_save_thumb</a> (<a class="link" href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
GdkPixbuf *pixbuf,
const gchar *software,
GError **error);
gboolean <a class="link" href="GimpThumbnail.html#gimp-thumbnail-save-thumb-local">gimp_thumbnail_save_thumb_local</a> (<a class="link" href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
GdkPixbuf *pixbuf,
const gchar *software,
GError **error);
gboolean <a class="link" href="GimpThumbnail.html#gimp-thumbnail-save-failure">gimp_thumbnail_save_failure</a> (<a class="link" href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
const gchar *software,
GError **error);
void <a class="link" href="GimpThumbnail.html#gimp-thumbnail-delete-failure">gimp_thumbnail_delete_failure</a> (<a class="link" href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail);
void <a class="link" href="GimpThumbnail.html#gimp-thumbnail-delete-others">gimp_thumbnail_delete_others</a> (<a class="link" href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size);
gboolean <a class="link" href="GimpThumbnail.html#gimp-thumbnail-has-failed">gimp_thumbnail_has_failed</a> (<a class="link" href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail);
<a href="GimpThumbnail.html#GimpThumbnail-struct">GimpThumbnail</a>;
<a href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a>* <a href="GimpThumbnail.html#gimp-thumbnail-new">gimp_thumbnail_new</a> (void);
void <a href="GimpThumbnail.html#gimp-thumbnail-set-uri">gimp_thumbnail_set_uri</a> (<a href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *uri);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="GimpThumbnail.html#gimp-thumbnail-set-filename">gimp_thumbnail_set_filename</a> (<a href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *filename,
<a
href="../glib/glib-Error-Reporting.html#GError"
>GError</a> **error);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="GimpThumbnail.html#gimp-thumbnail-set-from-thumb">gimp_thumbnail_set_from_thumb</a> (<a href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *filename,
<a
href="../glib/glib-Error-Reporting.html#GError"
>GError</a> **error);
<a href="libgimpthumb-gimpthumb-enums.html#GimpThumbState">GimpThumbState</a> <a href="GimpThumbnail.html#gimp-thumbnail-peek-image">gimp_thumbnail_peek_image</a> (<a href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail);
<a href="libgimpthumb-gimpthumb-enums.html#GimpThumbState">GimpThumbState</a> <a href="GimpThumbnail.html#gimp-thumbnail-peek-thumb">gimp_thumbnail_peek_thumb</a> (<a href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
<a href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size);
<a href="libgimpthumb-gimpthumb-enums.html#GimpThumbState">GimpThumbState</a> <a href="GimpThumbnail.html#gimp-thumbnail-check-thumb">gimp_thumbnail_check_thumb</a> (<a href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
<a href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size);
<a
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
>GdkPixbuf</a>* <a href="GimpThumbnail.html#gimp-thumbnail-load-thumb">gimp_thumbnail_load_thumb</a> (<a href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
<a href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size,
<a
href="../glib/glib-Error-Reporting.html#GError"
>GError</a> **error);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="GimpThumbnail.html#gimp-thumbnail-save-thumb">gimp_thumbnail_save_thumb</a> (<a href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
<a
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
>GdkPixbuf</a> *pixbuf,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *software,
<a
href="../glib/glib-Error-Reporting.html#GError"
>GError</a> **error);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="GimpThumbnail.html#gimp-thumbnail-save-thumb-local">gimp_thumbnail_save_thumb_local</a> (<a href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
<a
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
>GdkPixbuf</a> *pixbuf,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *software,
<a
href="../glib/glib-Error-Reporting.html#GError"
>GError</a> **error);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="GimpThumbnail.html#gimp-thumbnail-save-failure">gimp_thumbnail_save_failure</a> (<a href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *software,
<a
href="../glib/glib-Error-Reporting.html#GError"
>GError</a> **error);
void <a href="GimpThumbnail.html#gimp-thumbnail-delete-failure">gimp_thumbnail_delete_failure</a> (<a href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail);
void <a href="GimpThumbnail.html#gimp-thumbnail-delete-others">gimp_thumbnail_delete_others</a> (<a href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
<a href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="GimpThumbnail.html#gimp-thumbnail-has-failed">gimp_thumbnail_has_failed</a> (<a href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2592184"></a><h2>Object Hierarchy</h2>
<a name="id2575018"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
GObject
<a
href="../gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a>
+----GimpThumbnail
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2592208"></a><h2>Properties</h2>
<a name="id2575042"></a><h2>Properties</h2>
<pre class="synopsis">
"<a class="link" href="GimpThumbnail.html#GimpThumbnail--image-filesize">image-filesize</a>" gint64 : Read / Write
"<a class="link" href="GimpThumbnail.html#GimpThumbnail--image-height">image-height</a>" gint : Read / Write
"<a class="link" href="GimpThumbnail.html#GimpThumbnail--image-mimetype">image-mimetype</a>" gchararray : Read / Write
"<a class="link" href="GimpThumbnail.html#GimpThumbnail--image-mtime">image-mtime</a>" gint64 : Read / Write
"<a class="link" href="GimpThumbnail.html#GimpThumbnail--image-num-layers">image-num-layers</a>" gint : Read / Write
"<a class="link" href="GimpThumbnail.html#GimpThumbnail--image-state">image-state</a>" <a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbState">GimpThumbState</a> : Read / Write
"<a class="link" href="GimpThumbnail.html#GimpThumbnail--image-type">image-type</a>" gchararray : Read / Write
"<a class="link" href="GimpThumbnail.html#GimpThumbnail--image-uri">image-uri</a>" gchararray : Read / Write
"<a class="link" href="GimpThumbnail.html#GimpThumbnail--image-width">image-width</a>" gint : Read / Write
"<a class="link" href="GimpThumbnail.html#GimpThumbnail--thumb-state">thumb-state</a>" <a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbState">GimpThumbState</a> : Read / Write
"<a href="GimpThumbnail.html#GimpThumbnail--image-filesize">image-filesize</a>" <a
href="../glib/glib-Basic-Types.html#gint64"
>gint64</a> : Read / Write
"<a href="GimpThumbnail.html#GimpThumbnail--image-height">image-height</a>" <a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> : Read / Write
"<a href="GimpThumbnail.html#GimpThumbnail--image-mimetype">image-mimetype</a>" <a
href="../gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Read / Write
"<a href="GimpThumbnail.html#GimpThumbnail--image-mtime">image-mtime</a>" <a
href="../glib/glib-Basic-Types.html#gint64"
>gint64</a> : Read / Write
"<a href="GimpThumbnail.html#GimpThumbnail--image-num-layers">image-num-layers</a>" <a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> : Read / Write
"<a href="GimpThumbnail.html#GimpThumbnail--image-state">image-state</a>" <a href="libgimpthumb-gimpthumb-enums.html#GimpThumbState">GimpThumbState</a> : Read / Write
"<a href="GimpThumbnail.html#GimpThumbnail--image-type">image-type</a>" <a
href="../gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Read / Write
"<a href="GimpThumbnail.html#GimpThumbnail--image-uri">image-uri</a>" <a
href="../gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Read / Write
"<a href="GimpThumbnail.html#GimpThumbnail--image-width">image-width</a>" <a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> : Read / Write
"<a href="GimpThumbnail.html#GimpThumbnail--thumb-state">thumb-state</a>" <a href="libgimpthumb-gimpthumb-enums.html#GimpThumbState">GimpThumbState</a> : Read / Write
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2592344"></a><h2>Description</h2>
<a name="id2575177"></a><h2>Description</h2>
<p>
</p>
</div>
<div class="refsect1" lang="en">
<a name="id2592359"></a><h2>Details</h2>
<a name="id2575193"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2592370"></a><h3>
<a name="id2575204"></a><h3>
<a name="GimpThumbnail-struct"></a>GimpThumbnail</h3>
<a class="indexterm" name="id2532263"></a><pre class="programlisting">typedef struct _GimpThumbnail GimpThumbnail;</pre>
<a class="indexterm" name="id2575216"></a><pre class="programlisting">typedef struct _GimpThumbnail GimpThumbnail;</pre>
<p>
All members of <a class="link" href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> are private and should only be accessed
All members of <a href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> are private and should only be accessed
using object properties.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2532288"></a><h3>
<a name="id2510507"></a><h3>
<a name="gimp-thumbnail-new"></a>gimp_thumbnail_new ()</h3>
<a class="indexterm" name="id2532300"></a><pre class="programlisting"><a class="link" href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a>* gimp_thumbnail_new (void);</pre>
<a class="indexterm" name="id2510520"></a><pre class="programlisting"><a href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a>* gimp_thumbnail_new (void);</pre>
<p>
Creates a new <a class="link" href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> object.</p>
Creates a new <a href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> object.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> a newly allocated GimpThumbnail object
</td>
</tr></tbody>
@ -148,15 +208,17 @@ Creates a new <a class="link" href="GimpThumbnail.html" title="GimpThumbnail"><s
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2532348"></a><h3>
<a name="id2510567"></a><h3>
<a name="gimp-thumbnail-set-uri"></a>gimp_thumbnail_set_uri ()</h3>
<a class="indexterm" name="id2532359"></a><pre class="programlisting">void gimp_thumbnail_set_uri (<a class="link" href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
const gchar *uri);</pre>
<a class="indexterm" name="id2510578"></a><pre class="programlisting">void gimp_thumbnail_set_uri (<a href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *uri);</pre>
<p>
Sets the location of the image file associated with the <span class="type">thumbnail</span>.
</p>
<p>
All informations stored in the <a class="link" href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> are reset.</p>
All informations stored in the <a href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> are reset.</p>
<p>
</p>
@ -164,12 +226,12 @@ All informations stored in the <a class="link" href="GimpThumbnail.html" title="
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>thumbnail</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> object
<td><span class="term"><em class="parameter"><code>thumbnail</code></em>&#160;:</span></td>
<td> a <a href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uri</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>uri</code></em>&#160;:</span></td>
<td> an escaped URI
</td>
</tr>
@ -178,11 +240,17 @@ All informations stored in the <a class="link" href="GimpThumbnail.html" title="
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2532457"></a><h3>
<a name="id2510676"></a><h3>
<a name="gimp-thumbnail-set-filename"></a>gimp_thumbnail_set_filename ()</h3>
<a class="indexterm" name="id2532469"></a><pre class="programlisting">gboolean gimp_thumbnail_set_filename (<a class="link" href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
const gchar *filename,
GError **error);</pre>
<a class="indexterm" name="id2510688"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_thumbnail_set_filename (<a href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *filename,
<a
href="../glib/glib-Error-Reporting.html#GError"
>GError</a> **error);</pre>
<p>
Sets the location of the image file associated with the <span class="type">thumbnail</span>.</p>
<p>
@ -192,24 +260,28 @@ Sets the location of the image file associated with the <span class="type">thumb
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>thumbnail</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> object
<td><span class="term"><em class="parameter"><code>thumbnail</code></em>&#160;:</span></td>
<td> a <a href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>filename</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>filename</code></em>&#160;:</span></td>
<td> a local filename in the encoding of the filesystem
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
<td> return location for possible errors
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <code class="literal">TRUE</code> if the filename was successfully set,
<code class="literal">FALSE</code> otherwise
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the filename was successfully set,
<a
href="../glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> otherwise
</td>
</tr>
</tbody>
@ -217,11 +289,17 @@ Sets the location of the image file associated with the <span class="type">thumb
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2617033"></a><h3>
<a name="id2599870"></a><h3>
<a name="gimp-thumbnail-set-from-thumb"></a>gimp_thumbnail_set_from_thumb ()</h3>
<a class="indexterm" name="id2617044"></a><pre class="programlisting">gboolean gimp_thumbnail_set_from_thumb (<a class="link" href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
const gchar *filename,
GError **error);</pre>
<a class="indexterm" name="id2599881"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_thumbnail_set_from_thumb (<a href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *filename,
<a
href="../glib/glib-Error-Reporting.html#GError"
>GError</a> **error);</pre>
<p>
This function tries to load the thumbnail file pointed to by
<em class="parameter"><code>filename</code></em> and retrieves the URI of the original image file from
@ -238,23 +316,27 @@ directory that contain a valid Thumb::URI tag.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>thumbnail</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> object
<td><span class="term"><em class="parameter"><code>thumbnail</code></em>&#160;:</span></td>
<td> a <a href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>filename</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>filename</code></em>&#160;:</span></td>
<td> filename of a local thumbnail file
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
<td> return location for possible errors
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <code class="literal">TRUE</code> if the pixbuf could be loaded, <code class="literal">FALSE</code> otherwise
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the pixbuf could be loaded, <a
href="../glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> otherwise
</td>
</tr>
</tbody>
@ -262,9 +344,9 @@ directory that contain a valid Thumb::URI tag.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2617182"></a><h3>
<a name="id2600019"></a><h3>
<a name="gimp-thumbnail-peek-image"></a>gimp_thumbnail_peek_image ()</h3>
<a class="indexterm" name="id2617194"></a><pre class="programlisting"><a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbState">GimpThumbState</a> gimp_thumbnail_peek_image (<a class="link" href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail);</pre>
<a class="indexterm" name="id2600031"></a><pre class="programlisting"><a href="libgimpthumb-gimpthumb-enums.html#GimpThumbState">GimpThumbState</a> gimp_thumbnail_peek_image (<a href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail);</pre>
<p>
Checks the image file associated with the <em class="parameter"><code>thumbnail</code></em> and updates
information such as state, filesize and modification time.</p>
@ -275,13 +357,13 @@ information such as state, filesize and modification time.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>thumbnail</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> object
<td><span class="term"><em class="parameter"><code>thumbnail</code></em>&#160;:</span></td>
<td> a <a href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the image's <a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbState"><span class="type">GimpThumbState</span></a> after the update
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> the image's <a href="libgimpthumb-gimpthumb-enums.html#GimpThumbState"><span class="type">GimpThumbState</span></a> after the update
</td>
</tr>
</tbody>
@ -289,10 +371,10 @@ information such as state, filesize and modification time.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2617252"></a><h3>
<a name="id2600114"></a><h3>
<a name="gimp-thumbnail-peek-thumb"></a>gimp_thumbnail_peek_thumb ()</h3>
<a class="indexterm" name="id2617263"></a><pre class="programlisting"><a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbState">GimpThumbState</a> gimp_thumbnail_peek_thumb (<a class="link" href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size);</pre>
<a class="indexterm" name="id2600126"></a><pre class="programlisting"><a href="libgimpthumb-gimpthumb-enums.html#GimpThumbState">GimpThumbState</a> gimp_thumbnail_peek_thumb (<a href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
<a href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size);</pre>
<p>
Checks if a thumbnail file for the <em class="parameter"><code>thumbnail</code></em> exists. It doesn't
load the thumbnail image and thus cannot check if the thumbnail is
@ -301,8 +383,8 @@ valid and uptodate for the image file asosciated with the
</p>
<p>
If you want to check the thumbnail, either attempt to load it using
<a class="link" href="GimpThumbnail.html#gimp-thumbnail-load-thumb"><code class="function">gimp_thumbnail_load_thumb()</code></a>, or, if you don't need the resulting
thumbnail pixbuf, use <a class="link" href="GimpThumbnail.html#gimp-thumbnail-check-thumb"><code class="function">gimp_thumbnail_check_thumb()</code></a>.</p>
<a href="GimpThumbnail.html#gimp-thumbnail-load-thumb"><code class="function">gimp_thumbnail_load_thumb()</code></a>, or, if you don't need the resulting
thumbnail pixbuf, use <a href="GimpThumbnail.html#gimp-thumbnail-check-thumb"><code class="function">gimp_thumbnail_check_thumb()</code></a>.</p>
<p>
</p>
@ -310,18 +392,18 @@ thumbnail pixbuf, use <a class="link" href="GimpThumbnail.html#gimp-thumbnail-ch
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>thumbnail</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> object
<td><span class="term"><em class="parameter"><code>thumbnail</code></em>&#160;:</span></td>
<td> a <a href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>size</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>size</code></em>&#160;:</span></td>
<td> the preferred size of the thumbnail image
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the thumbnail's <a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbState"><span class="type">GimpThumbState</span></a> after the update
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> the thumbnail's <a href="libgimpthumb-gimpthumb-enums.html#GimpThumbState"><span class="type">GimpThumbState</span></a> after the update
</td>
</tr>
</tbody>
@ -329,10 +411,10 @@ thumbnail pixbuf, use <a class="link" href="GimpThumbnail.html#gimp-thumbnail-ch
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2617386"></a><h3>
<a name="id2600262"></a><h3>
<a name="gimp-thumbnail-check-thumb"></a>gimp_thumbnail_check_thumb ()</h3>
<a class="indexterm" name="id2617399"></a><pre class="programlisting"><a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbState">GimpThumbState</a> gimp_thumbnail_check_thumb (<a class="link" href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size);</pre>
<a class="indexterm" name="id2600276"></a><pre class="programlisting"><a href="libgimpthumb-gimpthumb-enums.html#GimpThumbState">GimpThumbState</a> gimp_thumbnail_check_thumb (<a href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
<a href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size);</pre>
<p>
Checks if a thumbnail file for the <em class="parameter"><code>thumbnail</code></em> exists, loads it and
verifies it is valid and uptodate for the image file asosciated
@ -344,18 +426,18 @@ with the <em class="parameter"><code>thumbnail</code></em>.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>thumbnail</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> object
<td><span class="term"><em class="parameter"><code>thumbnail</code></em>&#160;:</span></td>
<td> a <a href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>size</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>size</code></em>&#160;:</span></td>
<td> the preferred size of the thumbnail image
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the thumbnail's <a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbState"><span class="type">GimpThumbState</span></a> after the update
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> the thumbnail's <a href="libgimpthumb-gimpthumb-enums.html#GimpThumbState"><span class="type">GimpThumbState</span></a> after the update
</td>
</tr>
@ -366,16 +448,20 @@ with the <em class="parameter"><code>thumbnail</code></em>.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2617504"></a><h3>
<a name="id2600395"></a><h3>
<a name="gimp-thumbnail-load-thumb"></a>gimp_thumbnail_load_thumb ()</h3>
<a class="indexterm" name="id2617515"></a><pre class="programlisting">GdkPixbuf* gimp_thumbnail_load_thumb (<a class="link" href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size,
GError **error);</pre>
<a class="indexterm" name="id2600407"></a><pre class="programlisting"><a
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
>GdkPixbuf</a>* gimp_thumbnail_load_thumb (<a href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
<a href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size,
<a
href="../glib/glib-Error-Reporting.html#GError"
>GError</a> **error);</pre>
<p>
Attempts to load a thumbnail preview for the image associated with
<em class="parameter"><code>thumbnail</code></em>. Before you use this function you need need to set an
image location using <a class="link" href="GimpThumbnail.html#gimp-thumbnail-set-uri"><code class="function">gimp_thumbnail_set_uri()</code></a> or
<a class="link" href="GimpThumbnail.html#gimp-thumbnail-set-filename"><code class="function">gimp_thumbnail_set_filename()</code></a>. You can also peek at the thumb
image location using <a href="GimpThumbnail.html#gimp-thumbnail-set-uri"><code class="function">gimp_thumbnail_set_uri()</code></a> or
<a href="GimpThumbnail.html#gimp-thumbnail-set-filename"><code class="function">gimp_thumbnail_set_filename()</code></a>. You can also peek at the thumb
before loading it using gimp_thumbnail_peek_thumb.
</p>
<p>
@ -392,23 +478,25 @@ In order to verify if the preview is uptodate, you should check the
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>thumbnail</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> object
<td><span class="term"><em class="parameter"><code>thumbnail</code></em>&#160;:</span></td>
<td> a <a href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>size</code></em>&#160;:</span></p></td>
<td> the preferred <a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize"><span class="type">GimpThumbSize</span></a> for the preview
<td><span class="term"><em class="parameter"><code>size</code></em>&#160;:</span></td>
<td> the preferred <a href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize"><span class="type">GimpThumbSize</span></a> for the preview
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
<td> return location for possible errors
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a preview pixbuf or <code class="literal">NULL</code> if no thumbnail was found
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> a preview pixbuf or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> if no thumbnail was found
</td>
</tr>
</tbody>
@ -416,12 +504,20 @@ In order to verify if the preview is uptodate, you should check the
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2617670"></a><h3>
<a name="id2600578"></a><h3>
<a name="gimp-thumbnail-save-thumb"></a>gimp_thumbnail_save_thumb ()</h3>
<a class="indexterm" name="id2617681"></a><pre class="programlisting">gboolean gimp_thumbnail_save_thumb (<a class="link" href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
GdkPixbuf *pixbuf,
const gchar *software,
GError **error);</pre>
<a class="indexterm" name="id2600590"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_thumbnail_save_thumb (<a href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
<a
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
>GdkPixbuf</a> *pixbuf,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *software,
<a
href="../glib/glib-Error-Reporting.html#GError"
>GError</a> **error);</pre>
<p>
Saves a preview thumbnail for the image associated with <em class="parameter"><code>thumbnail</code></em>.
to the global thumbnail repository.
@ -429,9 +525,9 @@ to the global thumbnail repository.
<p>
The caller is responsible for setting the image file location, it's
filesize, modification time. One way to set this info is to is to
call <a class="link" href="GimpThumbnail.html#gimp-thumbnail-set-uri"><code class="function">gimp_thumbnail_set_uri()</code></a> followed by <a class="link" href="GimpThumbnail.html#gimp-thumbnail-peek-image"><code class="function">gimp_thumbnail_peek_image()</code></a>.
call <a href="GimpThumbnail.html#gimp-thumbnail-set-uri"><code class="function">gimp_thumbnail_set_uri()</code></a> followed by <a href="GimpThumbnail.html#gimp-thumbnail-peek-image"><code class="function">gimp_thumbnail_peek_image()</code></a>.
Since this won't work for remote images, it is left to the user of
<a class="link" href="GimpThumbnail.html#gimp-thumbnail-save-thumb"><code class="function">gimp_thumbnail_save_thumb()</code></a> to do this or to set the information
<a href="GimpThumbnail.html#gimp-thumbnail-save-thumb"><code class="function">gimp_thumbnail_save_thumb()</code></a> to do this or to set the information
using the <em class="parameter"><code>thumbnail</code></em> object properties.
</p>
<p>
@ -444,29 +540,35 @@ set in order to be stored with the preview image.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>thumbnail</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> object
<td><span class="term"><em class="parameter"><code>thumbnail</code></em>&#160;:</span></td>
<td> a <a href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em>&#160;:</span></p></td>
<td> a <span class="type">GdkPixbuf</span> representing the preview thumbnail
<td><span class="term"><em class="parameter"><code>pixbuf</code></em>&#160;:</span></td>
<td> a <a
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
><span class="type">GdkPixbuf</span></a> representing the preview thumbnail
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>software</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>software</code></em>&#160;:</span></td>
<td> a string describing the software saving the thumbnail
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
<td> return location for possible errors
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <code class="literal">TRUE</code> if a thumbnail was successfully written,
<code class="literal">FALSE</code> otherwise
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if a thumbnail was successfully written,
<a
href="../glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> otherwise
</td>
</tr>
</tbody>
@ -474,19 +576,27 @@ set in order to be stored with the preview image.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2617875"></a><h3>
<a name="id2600802"></a><h3>
<a name="gimp-thumbnail-save-thumb-local"></a>gimp_thumbnail_save_thumb_local ()</h3>
<a class="indexterm" name="id2617890"></a><pre class="programlisting">gboolean gimp_thumbnail_save_thumb_local (<a class="link" href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
GdkPixbuf *pixbuf,
const gchar *software,
GError **error);</pre>
<a class="indexterm" name="id2600818"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_thumbnail_save_thumb_local (<a href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
<a
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
>GdkPixbuf</a> *pixbuf,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *software,
<a
href="../glib/glib-Error-Reporting.html#GError"
>GError</a> **error);</pre>
<p>
Saves a preview thumbnail for the image associated with <em class="parameter"><code>thumbnail</code></em>
to the local thumbnail repository. Local thumbnails have been added
with version 0.7 of the spec.
</p>
<p>
Please see also <a class="link" href="GimpThumbnail.html#gimp-thumbnail-save-thumb"><code class="function">gimp_thumbnail_save_thumb()</code></a>. The notes made there
Please see also <a href="GimpThumbnail.html#gimp-thumbnail-save-thumb"><code class="function">gimp_thumbnail_save_thumb()</code></a>. The notes made there
apply here as well.</p>
<p>
@ -495,29 +605,35 @@ apply here as well.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>thumbnail</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> object
<td><span class="term"><em class="parameter"><code>thumbnail</code></em>&#160;:</span></td>
<td> a <a href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em>&#160;:</span></p></td>
<td> a <span class="type">GdkPixbuf</span> representing the preview thumbnail
<td><span class="term"><em class="parameter"><code>pixbuf</code></em>&#160;:</span></td>
<td> a <a
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
><span class="type">GdkPixbuf</span></a> representing the preview thumbnail
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>software</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>software</code></em>&#160;:</span></td>
<td> a string describing the software saving the thumbnail
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
<td> return location for possible errors
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <code class="literal">TRUE</code> if a thumbnail was successfully written,
<code class="literal">FALSE</code> otherwise
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if a thumbnail was successfully written,
<a
href="../glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> otherwise
</td>
</tr>
@ -528,11 +644,17 @@ apply here as well.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2618060"></a><h3>
<a name="id2601007"></a><h3>
<a name="gimp-thumbnail-save-failure"></a>gimp_thumbnail_save_failure ()</h3>
<a class="indexterm" name="id2618072"></a><pre class="programlisting">gboolean gimp_thumbnail_save_failure (<a class="link" href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
const gchar *software,
GError **error);</pre>
<a class="indexterm" name="id2601019"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_thumbnail_save_failure (<a href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *software,
<a
href="../glib/glib-Error-Reporting.html#GError"
>GError</a> **error);</pre>
<p>
Saves a failure thumbnail for the image associated with
<em class="parameter"><code>thumbnail</code></em>. This is an empty pixbuf that indicates that an attempt
@ -545,24 +667,28 @@ prevent the software from further attempts to create this thumbnail.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>thumbnail</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> object
<td><span class="term"><em class="parameter"><code>thumbnail</code></em>&#160;:</span></td>
<td> a <a href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>software</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>software</code></em>&#160;:</span></td>
<td> a string describing the software saving the thumbnail
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
<td> return location for possible errors
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <code class="literal">TRUE</code> if a failure thumbnail was successfully written,
<code class="literal">FALSE</code> otherwise
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if a failure thumbnail was successfully written,
<a
href="../glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> otherwise
</td>
</tr>
</tbody>
@ -570,9 +696,9 @@ prevent the software from further attempts to create this thumbnail.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2618199"></a><h3>
<a name="id2601160"></a><h3>
<a name="gimp-thumbnail-delete-failure"></a>gimp_thumbnail_delete_failure ()</h3>
<a class="indexterm" name="id2618213"></a><pre class="programlisting">void gimp_thumbnail_delete_failure (<a class="link" href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail);</pre>
<a class="indexterm" name="id2601176"></a><pre class="programlisting">void gimp_thumbnail_delete_failure (<a href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail);</pre>
<p>
Removes a failure thumbnail if one exists. This function should be
used after a thumbnail has been successfully created.</p>
@ -582,8 +708,8 @@ used after a thumbnail has been successfully created.</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>thumbnail</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> object
<td><span class="term"><em class="parameter"><code>thumbnail</code></em>&#160;:</span></td>
<td> a <a href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> object
</td>
</tr></tbody>
</table></div>
@ -592,10 +718,10 @@ used after a thumbnail has been successfully created.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2618273"></a><h3>
<a name="id2601243"></a><h3>
<a name="gimp-thumbnail-delete-others"></a>gimp_thumbnail_delete_others ()</h3>
<a class="indexterm" name="id2618287"></a><pre class="programlisting">void gimp_thumbnail_delete_others (<a class="link" href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size);</pre>
<a class="indexterm" name="id2601258"></a><pre class="programlisting">void gimp_thumbnail_delete_others (<a href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail,
<a href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size);</pre>
<p>
Removes all other thumbnails from the global thumbnail
repository. Only the thumbnail for <em class="parameter"><code>size</code></em> is not deleted. This
@ -609,12 +735,12 @@ delete thumbnails.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>thumbnail</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> object
<td><span class="term"><em class="parameter"><code>thumbnail</code></em>&#160;:</span></td>
<td> a <a href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>size</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>size</code></em>&#160;:</span></td>
<td> the thumbnail size which should not be deleted
</td>
</tr>
@ -625,13 +751,15 @@ delete thumbnails.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2618374"></a><h3>
<a name="id2601355"></a><h3>
<a name="gimp-thumbnail-has-failed"></a>gimp_thumbnail_has_failed ()</h3>
<a class="indexterm" name="id2618387"></a><pre class="programlisting">gboolean gimp_thumbnail_has_failed (<a class="link" href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail);</pre>
<a class="indexterm" name="id2582844"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_thumbnail_has_failed (<a href="GimpThumbnail.html" title="GimpThumbnail">GimpThumbnail</a> *thumbnail);</pre>
<p>
Checks if a valid failure thumbnail for the given thumbnail exists
in the global thumbnail repository. This may be the case even if
<a class="link" href="GimpThumbnail.html#gimp-thumbnail-peek-thumb"><code class="function">gimp_thumbnail_peek_thumb()</code></a> doesn't return <a class="link" href="libgimpthumb-gimpthumb-enums.html#GIMP-THUMB-STATE-FAILED:CAPS"><code class="literal">GIMP_THUMB_STATE_FAILED</code></a>
<a href="GimpThumbnail.html#gimp-thumbnail-peek-thumb"><code class="function">gimp_thumbnail_peek_thumb()</code></a> doesn't return <a href="libgimpthumb-gimpthumb-enums.html#GIMP-THUMB-STATE-FAILED:CAPS"><code class="literal">GIMP_THUMB_STATE_FAILED</code></a>
since there might be a real thumbnail and a failure thumbnail for
the same image file.
</p>
@ -645,13 +773,15 @@ valid failure thumbnail exists.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>thumbnail</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> object
<td><span class="term"><em class="parameter"><code>thumbnail</code></em>&#160;:</span></td>
<td> a <a href="GimpThumbnail.html" title="GimpThumbnail"><span class="type">GimpThumbnail</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <code class="literal">TRUE</code> if a failure thumbnail exists or
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if a failure thumbnail exists or
</td>
</tr>
@ -662,88 +792,104 @@ valid failure thumbnail exists.</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id2618489"></a><h2>Property Details</h2>
<a name="id2601458"></a><h2>Property Details</h2>
<div class="refsect2" lang="en">
<a name="id2618498"></a><h3>
<a name="id2601467"></a><h3>
<a name="GimpThumbnail--image-filesize"></a>The "<code class="literal">image-filesize</code>" property</h3>
<a class="indexterm" name="id2618513"></a><pre class="programlisting"> "image-filesize" gint64 : Read / Write</pre>
<a class="indexterm" name="id2601482"></a><pre class="programlisting"> "image-filesize" <a
href="../glib/glib-Basic-Types.html#gint64"
>gint64</a> : Read / Write</pre>
<p>Size of the image file in bytes.</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 0</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2618540"></a><h3>
<a name="id2601509"></a><h3>
<a name="GimpThumbnail--image-height"></a>The "<code class="literal">image-height</code>" property</h3>
<a class="indexterm" name="id2618553"></a><pre class="programlisting"> "image-height" gint : Read / Write</pre>
<a class="indexterm" name="id2601522"></a><pre class="programlisting"> "image-height" <a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> : Read / Write</pre>
<p>Height of the image in pixels.</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 0</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2618580"></a><h3>
<a name="id2601549"></a><h3>
<a name="GimpThumbnail--image-mimetype"></a>The "<code class="literal">image-mimetype</code>" property</h3>
<a class="indexterm" name="id2618594"></a><pre class="programlisting"> "image-mimetype" gchararray : Read / Write</pre>
<a class="indexterm" name="id2601563"></a><pre class="programlisting"> "image-mimetype" <a
href="../gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Read / Write</pre>
<p>Image mimetype.</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2618617"></a><h3>
<a name="id2601586"></a><h3>
<a name="GimpThumbnail--image-mtime"></a>The "<code class="literal">image-mtime</code>" property</h3>
<a class="indexterm" name="id2618630"></a><pre class="programlisting"> "image-mtime" gint64 : Read / Write</pre>
<a class="indexterm" name="id2601599"></a><pre class="programlisting"> "image-mtime" <a
href="../glib/glib-Basic-Types.html#gint64"
>gint64</a> : Read / Write</pre>
<p>Modification time of the image file in seconds since the Epoch.</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 0</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2618657"></a><h3>
<a name="id2601626"></a><h3>
<a name="GimpThumbnail--image-num-layers"></a>The "<code class="literal">image-num-layers</code>" property</h3>
<a class="indexterm" name="id2618672"></a><pre class="programlisting"> "image-num-layers" gint : Read / Write</pre>
<a class="indexterm" name="id2601641"></a><pre class="programlisting"> "image-num-layers" <a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> : Read / Write</pre>
<p>The number of layers in the image.</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 0</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2618699"></a><h3>
<a name="id2601668"></a><h3>
<a name="GimpThumbnail--image-state"></a>The "<code class="literal">image-state</code>" property</h3>
<a class="indexterm" name="id2618712"></a><pre class="programlisting"> "image-state" <a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbState">GimpThumbState</a> : Read / Write</pre>
<a class="indexterm" name="id2601681"></a><pre class="programlisting"> "image-state" <a href="libgimpthumb-gimpthumb-enums.html#GimpThumbState">GimpThumbState</a> : Read / Write</pre>
<p>State of the image associated to the thumbnail object.</p>
<p>Default value: GIMP_THUMB_STATE_UNKNOWN</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2618736"></a><h3>
<a name="id2601705"></a><h3>
<a name="GimpThumbnail--image-type"></a>The "<code class="literal">image-type</code>" property</h3>
<a class="indexterm" name="id2618749"></a><pre class="programlisting"> "image-type" gchararray : Read / Write</pre>
<a class="indexterm" name="id2601718"></a><pre class="programlisting"> "image-type" <a
href="../gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Read / Write</pre>
<p>String describing the type of the image format.</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2618772"></a><h3>
<a name="id2601741"></a><h3>
<a name="GimpThumbnail--image-uri"></a>The "<code class="literal">image-uri</code>" property</h3>
<a class="indexterm" name="id2618785"></a><pre class="programlisting"> "image-uri" gchararray : Read / Write</pre>
<a class="indexterm" name="id2601754"></a><pre class="programlisting"> "image-uri" <a
href="../gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Read / Write</pre>
<p>URI of the image file.</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2618807"></a><h3>
<a name="id2601776"></a><h3>
<a name="GimpThumbnail--image-width"></a>The "<code class="literal">image-width</code>" property</h3>
<a class="indexterm" name="id2618820"></a><pre class="programlisting"> "image-width" gint : Read / Write</pre>
<a class="indexterm" name="id2601789"></a><pre class="programlisting"> "image-width" <a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> : Read / Write</pre>
<p>Width of the image in pixels.</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 0</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2618847"></a><h3>
<a name="id2601816"></a><h3>
<a name="GimpThumbnail--thumb-state"></a>The "<code class="literal">thumb-state</code>" property</h3>
<a class="indexterm" name="id2618860"></a><pre class="programlisting"> "thumb-state" <a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbState">GimpThumbState</a> : Read / Write</pre>
<a class="indexterm" name="id2601829"></a><pre class="programlisting"> "thumb-state" <a href="libgimpthumb-gimpthumb-enums.html#GimpThumbState">GimpThumbState</a> : Read / Write</pre>
<p>State of the thumbnail file.</p>
<p>Default value: GIMP_THUMB_STATE_UNKNOWN</p>
</div>

4
devel-docs/libgimpthumb/html/index.html
View File

@ -3,7 +3,7 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>GIMP Thumbnail Library Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
<link rel="start" href="index.html" title="GIMP Thumbnail Library Reference Manual">
<link rel="next" href="libgimpthumb.html" title="Part&#160;I.&#160;GIMP Thumbnail Library">
<meta name="generator" content="GTK-Doc V1.8 (XML mode)">
@ -19,7 +19,7 @@
<div>
<div><table class="navigation" id="top" width="100%" cellpadding="2" cellspacing="0"><tr><th valign="middle"><p class="title">GIMP Thumbnail Library Reference Manual</p></th></tr></table></div>
<div><p class="releaseinfo">
for GIMP 2.4.0-rc2
for GIMP 2.4.0-rc1
</p></div>
</div>

64
devel-docs/libgimpthumb/html/libgimpthumb-gimpthumb-enums.html
View File

@ -3,7 +3,7 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>gimpthumb-enums</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
<link rel="start" href="index.html" title="GIMP Thumbnail Library Reference Manual">
<link rel="up" href="libgimpthumb.html" title="Part&#160;I.&#160;GIMP Thumbnail Library">
<link rel="prev" href="libgimpthumb-gimpthumb-utils.html" title="gimpthumb-utils">
@ -25,16 +25,16 @@
<th width="100%" align="center">GIMP Thumbnail Library Reference Manual</th>
<td><a accesskey="n" href="libgimpthumb-gimpthumb-error.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2577410" class="shortcut">Top</a>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2597910" class="shortcut">Top</a>
&#160;|&#160;
<a href="#id2581682" class="shortcut">Description</a></nobr></td></tr>
<a href="#id2572844" class="shortcut">Description</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="libgimpthumb-gimpthumb-enums"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id2577410"></a><span class="refentrytitle">gimpthumb-enums</span>
<a name="id2597910"></a><span class="refentrytitle">gimpthumb-enums</span>
</h2>
<p>gimpthumb-enums &#8212; Enumerations used by libgimpthumb</p>
</td>
@ -46,24 +46,24 @@
enum <a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbFileType">GimpThumbFileType</a>;
enum <a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a>;
enum <a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbState">GimpThumbState</a>;
enum <a href="libgimpthumb-gimpthumb-enums.html#GimpThumbFileType">GimpThumbFileType</a>;
enum <a href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a>;
enum <a href="libgimpthumb-gimpthumb-enums.html#GimpThumbState">GimpThumbState</a>;
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2581682"></a><h2>Description</h2>
<a name="id2572844"></a><h2>Description</h2>
<p>
</p>
</div>
<div class="refsect1" lang="en">
<a name="id2577014"></a><h2>Details</h2>
<a name="id2563601"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2577024"></a><h3>
<a name="id2563612"></a><h3>
<a name="GimpThumbFileType"></a>enum GimpThumbFileType</h3>
<a class="indexterm" name="id2577037"></a><pre class="programlisting">typedef enum
<a class="indexterm" name="id2563624"></a><pre class="programlisting">typedef enum
{
GIMP_THUMB_FILE_TYPE_NONE,
GIMP_THUMB_FILE_TYPE_REGULAR,
@ -72,28 +72,28 @@ enum <a class="link" href="libgimpthumb-gimpthumb-enums.html#Gimp
} GimpThumbFileType;
</pre>
<p>
File types as returned by <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-file-test"><code class="function">gimp_thumb_file_test()</code></a>.
File types as returned by <a href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-file-test"><code class="function">gimp_thumb_file_test()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><a name="GIMP-THUMB-FILE-TYPE-NONE:CAPS"></a><code class="literal">GIMP_THUMB_FILE_TYPE_NONE</code></span></p></td>
<td><span class="term"><a name="GIMP-THUMB-FILE-TYPE-NONE:CAPS"></a><code class="literal">GIMP_THUMB_FILE_TYPE_NONE</code></span></td>
<td> file does not exist
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GIMP-THUMB-FILE-TYPE-REGULAR:CAPS"></a><code class="literal">GIMP_THUMB_FILE_TYPE_REGULAR</code></span></p></td>
<td><span class="term"><a name="GIMP-THUMB-FILE-TYPE-REGULAR:CAPS"></a><code class="literal">GIMP_THUMB_FILE_TYPE_REGULAR</code></span></td>
<td> a regular file
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GIMP-THUMB-FILE-TYPE-FOLDER:CAPS"></a><code class="literal">GIMP_THUMB_FILE_TYPE_FOLDER</code></span></p></td>
<td><span class="term"><a name="GIMP-THUMB-FILE-TYPE-FOLDER:CAPS"></a><code class="literal">GIMP_THUMB_FILE_TYPE_FOLDER</code></span></td>
<td> a directory
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GIMP-THUMB-FILE-TYPE-SPECIAL:CAPS"></a><code class="literal">GIMP_THUMB_FILE_TYPE_SPECIAL</code></span></p></td>
<td><span class="term"><a name="GIMP-THUMB-FILE-TYPE-SPECIAL:CAPS"></a><code class="literal">GIMP_THUMB_FILE_TYPE_SPECIAL</code></span></td>
<td> a special file (device node, fifo, socket, ...)
</td>
@ -103,9 +103,9 @@ File types as returned by <a class="link" href="libgimpthumb-gimpthumb-utils.htm
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2578481"></a><h3>
<a name="id2573251"></a><h3>
<a name="GimpThumbSize"></a>enum GimpThumbSize</h3>
<a class="indexterm" name="id2578493"></a><pre class="programlisting">typedef enum
<a class="indexterm" name="id2573264"></a><pre class="programlisting">typedef enum
{
GIMP_THUMB_SIZE_FAIL = 0,
GIMP_THUMB_SIZE_NORMAL = 128,
@ -119,18 +119,18 @@ Possible thumbnail sizes as defined by the Thumbnail Managaging Standard
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><a name="GIMP-THUMB-SIZE-FAIL:CAPS"></a><code class="literal">GIMP_THUMB_SIZE_FAIL</code></span></p></td>
<td><span class="term"><a name="GIMP-THUMB-SIZE-FAIL:CAPS"></a><code class="literal">GIMP_THUMB_SIZE_FAIL</code></span></td>
<td> special size used to indicate a thumbnail
creation failure
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GIMP-THUMB-SIZE-NORMAL:CAPS"></a><code class="literal">GIMP_THUMB_SIZE_NORMAL</code></span></p></td>
<td><span class="term"><a name="GIMP-THUMB-SIZE-NORMAL:CAPS"></a><code class="literal">GIMP_THUMB_SIZE_NORMAL</code></span></td>
<td> normal thumbnail size (128 pixels)
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GIMP-THUMB-SIZE-LARGE:CAPS"></a><code class="literal">GIMP_THUMB_SIZE_LARGE</code></span></p></td>
<td><span class="term"><a name="GIMP-THUMB-SIZE-LARGE:CAPS"></a><code class="literal">GIMP_THUMB_SIZE_LARGE</code></span></td>
<td> large thumbnail size (256 pixels)
</td>
@ -140,9 +140,9 @@ Possible thumbnail sizes as defined by the Thumbnail Managaging Standard
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2576396"></a><h3>
<a name="id2581414"></a><h3>
<a name="GimpThumbState"></a>enum GimpThumbState</h3>
<a class="indexterm" name="id2576409"></a><pre class="programlisting">typedef enum
<a class="indexterm" name="id2581426"></a><pre class="programlisting">typedef enum
{
GIMP_THUMB_STATE_UNKNOWN,
GIMP_THUMB_STATE_REMOTE,
@ -162,47 +162,47 @@ Possible image and thumbnail file states used by libgimpthumb.
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><a name="GIMP-THUMB-STATE-UNKNOWN:CAPS"></a><code class="literal">GIMP_THUMB_STATE_UNKNOWN</code></span></p></td>
<td><span class="term"><a name="GIMP-THUMB-STATE-UNKNOWN:CAPS"></a><code class="literal">GIMP_THUMB_STATE_UNKNOWN</code></span></td>
<td> nothing is known about the file/thumbnail
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GIMP-THUMB-STATE-REMOTE:CAPS"></a><code class="literal">GIMP_THUMB_STATE_REMOTE</code></span></p></td>
<td><span class="term"><a name="GIMP-THUMB-STATE-REMOTE:CAPS"></a><code class="literal">GIMP_THUMB_STATE_REMOTE</code></span></td>
<td> the file is on a remote file system
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GIMP-THUMB-STATE-FOLDER:CAPS"></a><code class="literal">GIMP_THUMB_STATE_FOLDER</code></span></p></td>
<td><span class="term"><a name="GIMP-THUMB-STATE-FOLDER:CAPS"></a><code class="literal">GIMP_THUMB_STATE_FOLDER</code></span></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GIMP-THUMB-STATE-SPECIAL:CAPS"></a><code class="literal">GIMP_THUMB_STATE_SPECIAL</code></span></p></td>
<td><span class="term"><a name="GIMP-THUMB-STATE-SPECIAL:CAPS"></a><code class="literal">GIMP_THUMB_STATE_SPECIAL</code></span></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GIMP-THUMB-STATE-NOT-FOUND:CAPS"></a><code class="literal">GIMP_THUMB_STATE_NOT_FOUND</code></span></p></td>
<td><span class="term"><a name="GIMP-THUMB-STATE-NOT-FOUND:CAPS"></a><code class="literal">GIMP_THUMB_STATE_NOT_FOUND</code></span></td>
<td> the file/thumbnail doesn't exist
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GIMP-THUMB-STATE-EXISTS:CAPS"></a><code class="literal">GIMP_THUMB_STATE_EXISTS</code></span></p></td>
<td><span class="term"><a name="GIMP-THUMB-STATE-EXISTS:CAPS"></a><code class="literal">GIMP_THUMB_STATE_EXISTS</code></span></td>
<td> the file/thumbnail exists
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GIMP-THUMB-STATE-OLD:CAPS"></a><code class="literal">GIMP_THUMB_STATE_OLD</code></span></p></td>
<td><span class="term"><a name="GIMP-THUMB-STATE-OLD:CAPS"></a><code class="literal">GIMP_THUMB_STATE_OLD</code></span></td>
<td> the thumbnail may be outdated
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GIMP-THUMB-STATE-FAILED:CAPS"></a><code class="literal">GIMP_THUMB_STATE_FAILED</code></span></p></td>
<td><span class="term"><a name="GIMP-THUMB-STATE-FAILED:CAPS"></a><code class="literal">GIMP_THUMB_STATE_FAILED</code></span></td>
<td> the thumbnail couldn't be created
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GIMP-THUMB-STATE-OK:CAPS"></a><code class="literal">GIMP_THUMB_STATE_OK</code></span></p></td>
<td><span class="term"><a name="GIMP-THUMB-STATE-OK:CAPS"></a><code class="literal">GIMP_THUMB_STATE_OK</code></span></td>
<td> the thumbnail exists and matches the image
</td>

52
devel-docs/libgimpthumb/html/libgimpthumb-gimpthumb-error.html
View File

@ -3,7 +3,7 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>gimpthumb-error</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
<link rel="start" href="index.html" title="GIMP Thumbnail Library Reference Manual">
<link rel="up" href="libgimpthumb.html" title="Part&#160;I.&#160;GIMP Thumbnail Library">
<link rel="prev" href="libgimpthumb-gimpthumb-enums.html" title="gimpthumb-enums">
@ -25,16 +25,16 @@
<th width="100%" align="center">GIMP Thumbnail Library Reference Manual</th>
<td><a accesskey="n" href="libgimpthumb-index.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2601056" class="shortcut">Top</a>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2586562" class="shortcut">Top</a>
&#160;|&#160;
<a href="#id2604886" class="shortcut">Description</a></nobr></td></tr>
<a href="#id2568722" class="shortcut">Description</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="libgimpthumb-gimpthumb-error"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id2601056"></a><span class="refentrytitle">gimpthumb-error</span>
<a name="id2586562"></a><span class="refentrytitle">gimpthumb-error</span>
</h2>
<p>gimpthumb-error &#8212; Error codes used by libgimpthumb</p>
</td>
@ -46,23 +46,25 @@
enum <a class="link" href="libgimpthumb-gimpthumb-error.html#GimpThumbError">GimpThumbError</a>;
#define <a class="link" href="libgimpthumb-gimpthumb-error.html#GIMP-THUMB-ERROR:CAPS">GIMP_THUMB_ERROR</a>
GQuark <a class="link" href="libgimpthumb-gimpthumb-error.html#gimp-thumb-error-quark">gimp_thumb_error_quark</a> (void);
enum <a href="libgimpthumb-gimpthumb-error.html#GimpThumbError">GimpThumbError</a>;
#define <a href="libgimpthumb-gimpthumb-error.html#GIMP-THUMB-ERROR:CAPS">GIMP_THUMB_ERROR</a>
<a
href="../glib/glib-Quarks.html#GQuark"
>GQuark</a> <a href="libgimpthumb-gimpthumb-error.html#gimp-thumb-error-quark">gimp_thumb_error_quark</a> (void);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2604886"></a><h2>Description</h2>
<a name="id2568722"></a><h2>Description</h2>
<p>
</p>
</div>
<div class="refsect1" lang="en">
<a name="id2575801"></a><h2>Details</h2>
<a name="id2583762"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2575811"></a><h3>
<a name="id2583772"></a><h3>
<a name="GimpThumbError"></a>enum GimpThumbError</h3>
<a class="indexterm" name="id2614805"></a><pre class="programlisting">typedef enum
<a class="indexterm" name="id2581058"></a><pre class="programlisting">typedef enum
{
GIMP_THUMB_ERROR_OPEN, /* open failed */
GIMP_THUMB_ERROR_OPEN_ENOENT, /* file does not exist */
@ -70,24 +72,26 @@ GQuark <a class="link" href="libgimpthumb-gimpthumb-error.html#gimp
} GimpThumbError;
</pre>
<p>
These are the possible error codes used when a <span class="type">GError</span> is set by
These are the possible error codes used when a <a
href="../glib/glib-Error-Reporting.html#GError"
><span class="type">GError</span></a> is set by
libgimpthumb.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><a name="GIMP-THUMB-ERROR-OPEN:CAPS"></a><code class="literal">GIMP_THUMB_ERROR_OPEN</code></span></p></td>
<td><span class="term"><a name="GIMP-THUMB-ERROR-OPEN:CAPS"></a><code class="literal">GIMP_THUMB_ERROR_OPEN</code></span></td>
<td> there was a problem opening the file
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GIMP-THUMB-ERROR-OPEN-ENOENT:CAPS"></a><code class="literal">GIMP_THUMB_ERROR_OPEN_ENOENT</code></span></p></td>
<td><span class="term"><a name="GIMP-THUMB-ERROR-OPEN-ENOENT:CAPS"></a><code class="literal">GIMP_THUMB_ERROR_OPEN_ENOENT</code></span></td>
<td> the file doesn't exist
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GIMP-THUMB-ERROR-MKDIR:CAPS"></a><code class="literal">GIMP_THUMB_ERROR_MKDIR</code></span></p></td>
<td><span class="term"><a name="GIMP-THUMB-ERROR-MKDIR:CAPS"></a><code class="literal">GIMP_THUMB_ERROR_MKDIR</code></span></td>
<td> there was a problem creating a directory
</td>
@ -97,9 +101,9 @@ libgimpthumb.
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2614900"></a><h3>
<a name="id2581153"></a><h3>
<a name="GIMP-THUMB-ERROR:CAPS"></a>GIMP_THUMB_ERROR</h3>
<a class="indexterm" name="id2614911"></a><pre class="programlisting">#define GIMP_THUMB_ERROR (gimp_thumb_error_quark ())
<a class="indexterm" name="id2581165"></a><pre class="programlisting">#define GIMP_THUMB_ERROR (gimp_thumb_error_quark ())
</pre>
<p>
Identifier for the libgimpthumb error domain.
@ -107,19 +111,23 @@ Identifier for the libgimpthumb error domain.
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2614928"></a><h3>
<a name="id2581182"></a><h3>
<a name="gimp-thumb-error-quark"></a>gimp_thumb_error_quark ()</h3>
<a class="indexterm" name="id2582213"></a><pre class="programlisting">GQuark gimp_thumb_error_quark (void);</pre>
<a class="indexterm" name="id2510912"></a><pre class="programlisting"><a
href="../glib/glib-Quarks.html#GQuark"
>GQuark</a> gimp_thumb_error_quark (void);</pre>
<p>
This function is never called directly. Use <a class="link" href="libgimpthumb-gimpthumb-error.html#GIMP-THUMB-ERROR:CAPS"><code class="function">GIMP_THUMB_ERROR()</code></a> instead.</p>
This function is never called directly. Use <a href="libgimpthumb-gimpthumb-error.html#GIMP-THUMB-ERROR:CAPS"><code class="function">GIMP_THUMB_ERROR()</code></a> instead.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the <span class="type">GQuark</span> that defines the GimpThumb error domain.
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> the <a
href="../glib/glib-Quarks.html#GQuark"
><span class="type">GQuark</span></a> that defines the GimpThumb error domain.
</td>
</tr></tbody>
</table></div>

328
devel-docs/libgimpthumb/html/libgimpthumb-gimpthumb-utils.html
View File

@ -3,7 +3,7 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>gimpthumb-utils</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
<link rel="start" href="index.html" title="GIMP Thumbnail Library Reference Manual">
<link rel="up" href="libgimpthumb.html" title="Part&#160;I.&#160;GIMP Thumbnail Library">
<link rel="prev" href="GimpThumbnail.html" title="GimpThumbnail">
@ -25,16 +25,16 @@
<th width="100%" align="center">GIMP Thumbnail Library Reference Manual</th>
<td><a accesskey="n" href="libgimpthumb-gimpthumb-enums.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2605821" class="shortcut">Top</a>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2568544" class="shortcut">Top</a>
&#160;|&#160;
<a href="#id2588537" class="shortcut">Description</a></nobr></td></tr>
<a href="#id2569503" class="shortcut">Description</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="libgimpthumb-gimpthumb-utils"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id2605821"></a><span class="refentrytitle">gimpthumb-utils</span>
<a name="id2568544"></a><span class="refentrytitle">gimpthumb-utils</span>
</h2>
<p>gimpthumb-utils &#8212; Utility functions provided and used by libgimpthumb</p>
</td>
@ -46,43 +46,95 @@
gboolean <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-init">gimp_thumb_init</a> (const gchar *creator,
const gchar *thumb_basedir);
gchar* <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-find-thumb">gimp_thumb_find_thumb</a> (const gchar *uri,
<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> *size);
<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbFileType">GimpThumbFileType</a> <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-file-test">gimp_thumb_file_test</a> (const gchar *filename,
gint64 *mtime,
gint64 *size,
gint *err_no);
gchar* <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-name-from-uri">gimp_thumb_name_from_uri</a> (const gchar *uri,
<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size);
gboolean <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-ensure-thumb-dir">gimp_thumb_ensure_thumb_dir</a> (<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size,
GError **error);
const gchar* <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-get-thumb-dir">gimp_thumb_get_thumb_dir</a> (<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size);
void <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumbs-delete-for-uri">gimp_thumbs_delete_for_uri</a> (const gchar *uri);
gchar* <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-name-from-uri-local">gimp_thumb_name_from_uri_local</a> (const gchar *uri,
<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size);
gboolean <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-ensure-thumb-dir-local">gimp_thumb_ensure_thumb_dir_local</a> (const gchar *dirname,
<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size,
GError **error);
gchar* <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-get-thumb-dir-local">gimp_thumb_get_thumb_dir_local</a> (const gchar *dirname,
<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size);
void <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumbs-delete-for-uri-local">gimp_thumbs_delete_for_uri_local</a> (const gchar *uri);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-init">gimp_thumb_init</a> (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *creator,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *thumb_basedir);
<a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a>* <a href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-find-thumb">gimp_thumb_find_thumb</a> (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *uri,
<a href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> *size);
<a href="libgimpthumb-gimpthumb-enums.html#GimpThumbFileType">GimpThumbFileType</a> <a href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-file-test">gimp_thumb_file_test</a> (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *filename,
<a
href="../glib/glib-Basic-Types.html#gint64"
>gint64</a> *mtime,
<a
href="../glib/glib-Basic-Types.html#gint64"
>gint64</a> *size,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> *err_no);
<a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a>* <a href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-name-from-uri">gimp_thumb_name_from_uri</a> (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *uri,
<a href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-ensure-thumb-dir">gimp_thumb_ensure_thumb_dir</a> (<a href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size,
<a
href="../glib/glib-Error-Reporting.html#GError"
>GError</a> **error);
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a>* <a href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-get-thumb-dir">gimp_thumb_get_thumb_dir</a> (<a href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size);
void <a href="libgimpthumb-gimpthumb-utils.html#gimp-thumbs-delete-for-uri">gimp_thumbs_delete_for_uri</a> (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *uri);
<a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a>* <a href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-name-from-uri-local">gimp_thumb_name_from_uri_local</a> (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *uri,
<a href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-ensure-thumb-dir-local">gimp_thumb_ensure_thumb_dir_local</a> (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *dirname,
<a href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size,
<a
href="../glib/glib-Error-Reporting.html#GError"
>GError</a> **error);
<a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a>* <a href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-get-thumb-dir-local">gimp_thumb_get_thumb_dir_local</a> (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *dirname,
<a href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size);
void <a href="libgimpthumb-gimpthumb-utils.html#gimp-thumbs-delete-for-uri-local">gimp_thumbs_delete_for_uri_local</a> (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *uri);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2588537"></a><h2>Description</h2>
<a name="id2569503"></a><h2>Description</h2>
<p>
</p>
</div>
<div class="refsect1" lang="en">
<a name="id2588552"></a><h2>Details</h2>
<a name="id2569518"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2588563"></a><h3>
<a name="id2569529"></a><h3>
<a name="gimp-thumb-init"></a>gimp_thumb_init ()</h3>
<a class="indexterm" name="id2588576"></a><pre class="programlisting">gboolean gimp_thumb_init (const gchar *creator,
const gchar *thumb_basedir);</pre>
<a class="indexterm" name="id2569542"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_thumb_init (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *creator,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *thumb_basedir);</pre>
<p>
This function initializes the thumbnail system. It must be called
before any other functions from libgimpthumb are used. You may call
@ -97,7 +149,9 @@ of the software that creates the thumbnails. It is used to handle
thumbnail creation failures. See the spec for more details.
</p>
<p>
Usually you will pass <code class="literal">NULL</code> for <em class="parameter"><code>thumb_basedir</code></em>. Thumbnails will
Usually you will pass <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> for <em class="parameter"><code>thumb_basedir</code></em>. Thumbnails will
then be stored in the user's personal thumbnail directory as
defined in the spec. If you wish to use libgimpthumb to store
application-specific thumbnails, you can specify a different base
@ -109,18 +163,22 @@ directory here.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>creator</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>creator</code></em>&#160;:</span></td>
<td> an ASCII string that identifies the thumbnail creator
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>thumb_basedir</code></em>&#160;:</span></p></td>
<td> an absolute path or <code class="literal">NULL</code> to use the default
<td><span class="term"><em class="parameter"><code>thumb_basedir</code></em>&#160;:</span></td>
<td> an absolute path or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> to use the default
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <code class="literal">TRUE</code> if the library was successfully initialized.
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the library was successfully initialized.
</td>
</tr>
</tbody>
@ -128,10 +186,14 @@ directory here.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2579664"></a><h3>
<a name="id2588130"></a><h3>
<a name="gimp-thumb-find-thumb"></a>gimp_thumb_find_thumb ()</h3>
<a class="indexterm" name="id2579675"></a><pre class="programlisting">gchar* gimp_thumb_find_thumb (const gchar *uri,
<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> *size);</pre>
<a class="indexterm" name="id2588142"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a>* gimp_thumb_find_thumb (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *uri,
<a href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> *size);</pre>
<p>
This function attempts to locate a thumbnail for the given
<em class="parameter"><code>uri</code></em>. First it tries the size that is stored at <em class="parameter"><code>size</code></em>. If no
@ -154,19 +216,21 @@ pointer to by <em class="parameter"><code>size</code></em> and the file location
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>uri</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>uri</code></em>&#160;:</span></td>
<td> an escaped URI
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>size</code></em>&#160;:</span></p></td>
<td> pointer to a <a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize"><span class="type">GimpThumbSize</span></a>
<td><span class="term"><em class="parameter"><code>size</code></em>&#160;:</span></td>
<td> pointer to a <a href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize"><span class="type">GimpThumbSize</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> a newly allocated string in the encoding of the
filesystem or <code class="literal">NULL</code> if no thumbnail for <em class="parameter"><code>uri</code></em> was found
filesystem or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> if no thumbnail for <em class="parameter"><code>uri</code></em> was found
</td>
</tr>
</tbody>
@ -174,12 +238,20 @@ pointer to by <em class="parameter"><code>size</code></em> and the file location
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2573407"></a><h3>
<a name="id2588291"></a><h3>
<a name="gimp-thumb-file-test"></a>gimp_thumb_file_test ()</h3>
<a class="indexterm" name="id2573418"></a><pre class="programlisting"><a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbFileType">GimpThumbFileType</a> gimp_thumb_file_test (const gchar *filename,
gint64 *mtime,
gint64 *size,
gint *err_no);</pre>
<a class="indexterm" name="id2588302"></a><pre class="programlisting"><a href="libgimpthumb-gimpthumb-enums.html#GimpThumbFileType">GimpThumbFileType</a> gimp_thumb_file_test (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *filename,
<a
href="../glib/glib-Basic-Types.html#gint64"
>gint64</a> *mtime,
<a
href="../glib/glib-Basic-Types.html#gint64"
>gint64</a> *size,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> *err_no);</pre>
<p>
This is a convenience and portability wrapper around <code class="function">stat()</code>. It
checks if the given <em class="parameter"><code>filename</code></em> exists and returns modification time
@ -191,28 +263,28 @@ and file size in 64bit integer values.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>filename</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>filename</code></em>&#160;:</span></td>
<td> a filename in the encoding of the filesystem
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>mtime</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>mtime</code></em>&#160;:</span></td>
<td> return location for modification time
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>size</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>size</code></em>&#160;:</span></td>
<td> return location for file size
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>err_no</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>err_no</code></em>&#160;:</span></td>
<td> return location for system "errno"
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> The type of the file, or <a class="link" href="libgimpthumb-gimpthumb-enums.html#GIMP-THUMB-FILE-TYPE-NONE:CAPS"><span class="type">GIMP_THUMB_FILE_TYPE_NONE</span></a> if
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> The type of the file, or <a href="libgimpthumb-gimpthumb-enums.html#GIMP-THUMB-FILE-TYPE-NONE:CAPS"><span class="type">GIMP_THUMB_FILE_TYPE_NONE</span></a> if
the file doesn't exist.
</td>
</tr>
@ -221,10 +293,14 @@ and file size in 64bit integer values.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2573566"></a><h3>
<a name="id2588450"></a><h3>
<a name="gimp-thumb-name-from-uri"></a>gimp_thumb_name_from_uri ()</h3>
<a class="indexterm" name="id2594589"></a><pre class="programlisting">gchar* gimp_thumb_name_from_uri (const gchar *uri,
<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size);</pre>
<a class="indexterm" name="id2588461"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a>* gimp_thumb_name_from_uri (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *uri,
<a href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size);</pre>
<p>
Creates the name of the thumbnail file of the specified <em class="parameter"><code>size</code></em> that
belongs to an image file located at the given <em class="parameter"><code>uri</code></em>.</p>
@ -235,19 +311,21 @@ belongs to an image file located at the given <em class="parameter"><code>uri</c
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>uri</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>uri</code></em>&#160;:</span></td>
<td> an escaped URI
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>size</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize"><span class="type">GimpThumbSize</span></a>
<td><span class="term"><em class="parameter"><code>size</code></em>&#160;:</span></td>
<td> a <a href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize"><span class="type">GimpThumbSize</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> a newly allocated filename in the encoding of the
filesystem or <code class="literal">NULL</code> if <em class="parameter"><code>uri</code></em> points to the user's
filesystem or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> if <em class="parameter"><code>uri</code></em> points to the user's
thumbnail repository.
</td>
</tr>
@ -256,10 +334,14 @@ belongs to an image file located at the given <em class="parameter"><code>uri</c
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2594709"></a><h3>
<a name="id2562051"></a><h3>
<a name="gimp-thumb-ensure-thumb-dir"></a>gimp_thumb_ensure_thumb_dir ()</h3>
<a class="indexterm" name="id2594721"></a><pre class="programlisting">gboolean gimp_thumb_ensure_thumb_dir (<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size,
GError **error);</pre>
<a class="indexterm" name="id2562063"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_thumb_ensure_thumb_dir (<a href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size,
<a
href="../glib/glib-Error-Reporting.html#GError"
>GError</a> **error);</pre>
<p>
This function checks if the directory that is required to store
thumbnails for a particular <em class="parameter"><code>size</code></em> exist and attempts to create it
@ -267,7 +349,7 @@ if necessary.
</p>
<p>
You shouldn't have to call this function directly since
<a class="link" href="GimpThumbnail.html#gimp-thumbnail-save-thumb"><code class="function">gimp_thumbnail_save_thumb()</code></a> and <a class="link" href="GimpThumbnail.html#gimp-thumbnail-save-failure"><code class="function">gimp_thumbnail_save_failure()</code></a> will
<a href="GimpThumbnail.html#gimp-thumbnail-save-thumb"><code class="function">gimp_thumbnail_save_thumb()</code></a> and <a href="GimpThumbnail.html#gimp-thumbnail-save-failure"><code class="function">gimp_thumbnail_save_failure()</code></a> will
do this for you.</p>
<p>
@ -276,18 +358,22 @@ do this for you.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>size</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>size</code></em>&#160;:</span></td>
<td> a GimpThumbSize
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
<td> return location for possible errors
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <code class="literal">TRUE</code> is the directory exists, <code class="literal">FALSE</code> if it could not
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> is the directory exists, <a
href="../glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> if it could not
be created
</td>
</tr>
@ -296,12 +382,14 @@ do this for you.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2594851"></a><h3>
<a name="id2562193"></a><h3>
<a name="gimp-thumb-get-thumb-dir"></a>gimp_thumb_get_thumb_dir ()</h3>
<a class="indexterm" name="id2618915"></a><pre class="programlisting">const gchar* gimp_thumb_get_thumb_dir (<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size);</pre>
<a class="indexterm" name="id2562204"></a><pre class="programlisting">const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a>* gimp_thumb_get_thumb_dir (<a href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size);</pre>
<p>
Retrieve the name of the thumbnail folder for a specific size. The
returned pointer will become invalid if <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-init"><code class="function">gimp_thumb_init()</code></a> is used
returned pointer will become invalid if <a href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-init"><code class="function">gimp_thumb_init()</code></a> is used
again. It must not be changed or freed.</p>
<p>
@ -310,12 +398,12 @@ again. It must not be changed or freed.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>size</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>size</code></em>&#160;:</span></td>
<td> a GimpThumbSize
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> the thumbnail directory in the encoding of the filesystem
</td>
</tr>
@ -324,9 +412,11 @@ again. It must not be changed or freed.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2618982"></a><h3>
<a name="id2562278"></a><h3>
<a name="gimp-thumbs-delete-for-uri"></a>gimp_thumbs_delete_for_uri ()</h3>
<a class="indexterm" name="id2618995"></a><pre class="programlisting">void gimp_thumbs_delete_for_uri (const gchar *uri);</pre>
<a class="indexterm" name="id2562293"></a><pre class="programlisting">void gimp_thumbs_delete_for_uri (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *uri);</pre>
<p>
Deletes all thumbnails for the image file specified by <em class="parameter"><code>uri</code></em> from the
user's thumbnail repository.</p>
@ -336,7 +426,7 @@ user's thumbnail repository.</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>uri</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>uri</code></em>&#160;:</span></td>
<td> an escaped URI
</td>
</tr></tbody>
@ -346,10 +436,14 @@ user's thumbnail repository.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2619054"></a><h3>
<a name="id2601881"></a><h3>
<a name="gimp-thumb-name-from-uri-local"></a>gimp_thumb_name_from_uri_local ()</h3>
<a class="indexterm" name="id2619070"></a><pre class="programlisting">gchar* gimp_thumb_name_from_uri_local (const gchar *uri,
<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size);</pre>
<a class="indexterm" name="id2601895"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a>* gimp_thumb_name_from_uri_local (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *uri,
<a href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size);</pre>
<p>
Creates the name of a local thumbnail file of the specified <em class="parameter"><code>size</code></em>
that belongs to an image file located at the given <em class="parameter"><code>uri</code></em>. Local
@ -361,19 +455,21 @@ thumbnails have been introduced with version 0.7 of the spec.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>uri</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>uri</code></em>&#160;:</span></td>
<td> an escaped URI
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>size</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize"><span class="type">GimpThumbSize</span></a>
<td><span class="term"><em class="parameter"><code>size</code></em>&#160;:</span></td>
<td> a <a href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize"><span class="type">GimpThumbSize</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> a newly allocated filename in the encoding of the
filesystem or <code class="literal">NULL</code> if <em class="parameter"><code>uri</code></em> is a remote file or
filesystem or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> if <em class="parameter"><code>uri</code></em> is a remote file or
points to the user's thumbnail repository.
</td>
@ -385,11 +481,17 @@ thumbnails have been introduced with version 0.7 of the spec.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2619199"></a><h3>
<a name="id2602013"></a><h3>
<a name="gimp-thumb-ensure-thumb-dir-local"></a>gimp_thumb_ensure_thumb_dir_local ()</h3>
<a class="indexterm" name="id2619215"></a><pre class="programlisting">gboolean gimp_thumb_ensure_thumb_dir_local (const gchar *dirname,
<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size,
GError **error);</pre>
<a class="indexterm" name="id2602029"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gimp_thumb_ensure_thumb_dir_local (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *dirname,
<a href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size,
<a
href="../glib/glib-Error-Reporting.html#GError"
>GError</a> **error);</pre>
<p>
This function checks if the directory that is required to store
local thumbnails for a particular <em class="parameter"><code>size</code></em> exist and attempts to
@ -397,7 +499,7 @@ create it if necessary.
</p>
<p>
You shouldn't have to call this function directly since
<a class="link" href="GimpThumbnail.html#gimp-thumbnail-save-thumb-local"><code class="function">gimp_thumbnail_save_thumb_local()</code></a> will do this for you.</p>
<a href="GimpThumbnail.html#gimp-thumbnail-save-thumb-local"><code class="function">gimp_thumbnail_save_thumb_local()</code></a> will do this for you.</p>
<p>
</p>
@ -405,23 +507,27 @@ You shouldn't have to call this function directly since
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>dirname</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>dirname</code></em>&#160;:</span></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>size</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>size</code></em>&#160;:</span></td>
<td> a GimpThumbSize
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
<td> return location for possible errors
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <code class="literal">TRUE</code> is the directory exists, <code class="literal">FALSE</code> if it could not
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> is the directory exists, <a
href="../glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> if it could not
be created
</td>
@ -433,13 +539,17 @@ You shouldn't have to call this function directly since
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2619368"></a><h3>
<a name="id2602181"></a><h3>
<a name="gimp-thumb-get-thumb-dir-local"></a>gimp_thumb_get_thumb_dir_local ()</h3>
<a class="indexterm" name="id2619383"></a><pre class="programlisting">gchar* gimp_thumb_get_thumb_dir_local (const gchar *dirname,
<a class="link" href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size);</pre>
<a class="indexterm" name="id2602197"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a>* gimp_thumb_get_thumb_dir_local (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *dirname,
<a href="libgimpthumb-gimpthumb-enums.html#GimpThumbSize">GimpThumbSize</a> size);</pre>
<p>
Retrieve the name of the local thumbnail folder for a specific
size. Unlike <a class="link" href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-get-thumb-dir"><code class="function">gimp_thumb_get_thumb_dir()</code></a> the returned string is not
size. Unlike <a href="libgimpthumb-gimpthumb-utils.html#gimp-thumb-get-thumb-dir"><code class="function">gimp_thumb_get_thumb_dir()</code></a> the returned string is not
constant and should be free'd when it is not any longer needed.</p>
<p>
@ -448,17 +558,17 @@ constant and should be free'd when it is not any longer needed.</p>
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>dirname</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>dirname</code></em>&#160;:</span></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>size</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>size</code></em>&#160;:</span></td>
<td> a GimpThumbSize
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> the thumbnail directory in the encoding of the filesystem
</td>
@ -470,9 +580,11 @@ constant and should be free'd when it is not any longer needed.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2619464"></a><h3>
<a name="id2602299"></a><h3>
<a name="gimp-thumbs-delete-for-uri-local"></a>gimp_thumbs_delete_for_uri_local ()</h3>
<a class="indexterm" name="id2619478"></a><pre class="programlisting">void gimp_thumbs_delete_for_uri_local (const gchar *uri);</pre>
<a class="indexterm" name="id2602314"></a><pre class="programlisting">void gimp_thumbs_delete_for_uri_local (const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *uri);</pre>
<p>
Deletes all thumbnails for the image file specified by <em class="parameter"><code>uri</code></em> from
the local thumbnail repository.</p>
@ -482,7 +594,7 @@ the local thumbnail repository.</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>uri</code></em>&#160;:</span></p></td>
<td><span class="term"><em class="parameter"><code>uri</code></em>&#160;:</span></td>
<td> an escaped URI
</td>
</tr></tbody>

2
devel-docs/libgimpthumb/html/libgimpthumb-index-deprecated.html
View File

@ -3,7 +3,7 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Index of deprecated symbols</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
<link rel="start" href="index.html" title="GIMP Thumbnail Library Reference Manual">
<link rel="up" href="index.html" title="GIMP Thumbnail Library Reference Manual">
<link rel="prev" href="libgimpthumb-index-new-in-2-4.html" title="Index of new symbols in GIMP 2.4">

22
devel-docs/libgimpthumb/html/libgimpthumb-index-new-in-2-2.html
View File

@ -3,7 +3,7 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Index of new symbols in GIMP 2.2</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
<link rel="start" href="index.html" title="GIMP Thumbnail Library Reference Manual">
<link rel="up" href="index.html" title="GIMP Thumbnail Library Reference Manual">
<link rel="prev" href="libgimpthumb-index.html" title="Index">
@ -30,25 +30,25 @@
<div class="index"><div class="indexdiv">
<h3>G</h3>
<dl>
<dt>gimp_thumbnail_check_thumb, <a class="indexterm" href="GimpThumbnail.html#id2617386">gimp_thumbnail_check_thumb ()</a>
<dt>gimp_thumbnail_check_thumb, <a href="GimpThumbnail.html#id2600262">gimp_thumbnail_check_thumb ()</a>
</dt>
<dt>gimp_thumbnail_delete_failure, <a class="indexterm" href="GimpThumbnail.html#id2618199">gimp_thumbnail_delete_failure ()</a>
<dt>gimp_thumbnail_delete_failure, <a href="GimpThumbnail.html#id2601160">gimp_thumbnail_delete_failure ()</a>
</dt>
<dt>gimp_thumbnail_delete_others, <a class="indexterm" href="GimpThumbnail.html#id2618273">gimp_thumbnail_delete_others ()</a>
<dt>gimp_thumbnail_delete_others, <a href="GimpThumbnail.html#id2601243">gimp_thumbnail_delete_others ()</a>
</dt>
<dt>gimp_thumbnail_has_failed, <a class="indexterm" href="GimpThumbnail.html#id2618374">gimp_thumbnail_has_failed ()</a>
<dt>gimp_thumbnail_has_failed, <a href="GimpThumbnail.html#id2601355">gimp_thumbnail_has_failed ()</a>
</dt>
<dt>gimp_thumbnail_save_thumb_local, <a class="indexterm" href="GimpThumbnail.html#id2617875">gimp_thumbnail_save_thumb_local ()</a>
<dt>gimp_thumbnail_save_thumb_local, <a href="GimpThumbnail.html#id2600802">gimp_thumbnail_save_thumb_local ()</a>
</dt>
<dt>gimp_thumbs_delete_for_uri, <a class="indexterm" href="libgimpthumb-gimpthumb-utils.html#id2618982">gimp_thumbs_delete_for_uri ()</a>
<dt>gimp_thumbs_delete_for_uri, <a href="libgimpthumb-gimpthumb-utils.html#id2562278">gimp_thumbs_delete_for_uri ()</a>
</dt>
<dt>gimp_thumbs_delete_for_uri_local, <a class="indexterm" href="libgimpthumb-gimpthumb-utils.html#id2619464">gimp_thumbs_delete_for_uri_local ()</a>
<dt>gimp_thumbs_delete_for_uri_local, <a href="libgimpthumb-gimpthumb-utils.html#id2602299">gimp_thumbs_delete_for_uri_local ()</a>
</dt>
<dt>gimp_thumb_ensure_thumb_dir_local, <a class="indexterm" href="libgimpthumb-gimpthumb-utils.html#id2619199">gimp_thumb_ensure_thumb_dir_local ()</a>
<dt>gimp_thumb_ensure_thumb_dir_local, <a href="libgimpthumb-gimpthumb-utils.html#id2602013">gimp_thumb_ensure_thumb_dir_local ()</a>
</dt>
<dt>gimp_thumb_get_thumb_dir_local, <a class="indexterm" href="libgimpthumb-gimpthumb-utils.html#id2619368">gimp_thumb_get_thumb_dir_local ()</a>
<dt>gimp_thumb_get_thumb_dir_local, <a href="libgimpthumb-gimpthumb-utils.html#id2602181">gimp_thumb_get_thumb_dir_local ()</a>
</dt>
<dt>gimp_thumb_name_from_uri_local, <a class="indexterm" href="libgimpthumb-gimpthumb-utils.html#id2619054">gimp_thumb_name_from_uri_local ()</a>
<dt>gimp_thumb_name_from_uri_local, <a href="libgimpthumb-gimpthumb-utils.html#id2601881">gimp_thumb_name_from_uri_local ()</a>
</dt>
</dl>
</div></div>

2
devel-docs/libgimpthumb/html/libgimpthumb-index-new-in-2-4.html
View File

@ -3,7 +3,7 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Index of new symbols in GIMP 2.4</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
<link rel="start" href="index.html" title="GIMP Thumbnail Library Reference Manual">
<link rel="up" href="index.html" title="GIMP Thumbnail Library Reference Manual">
<link rel="prev" href="libgimpthumb-index-new-in-2-2.html" title="Index of new symbols in GIMP 2.2">

86
devel-docs/libgimpthumb/html/libgimpthumb-index.html
View File

@ -3,7 +3,7 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Index</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
<link rel="start" href="index.html" title="GIMP Thumbnail Library Reference Manual">
<link rel="up" href="index.html" title="GIMP Thumbnail Library Reference Manual">
<link rel="prev" href="libgimpthumb-gimpthumb-error.html" title="gimpthumb-error">
@ -30,89 +30,89 @@
<div class="index"><div class="indexdiv">
<h3>G</h3>
<dl>
<dt>GimpThumbError, <a class="indexterm" href="libgimpthumb-gimpthumb-error.html#id2575811">enum GimpThumbError</a>
<dt>GimpThumbError, <a href="libgimpthumb-gimpthumb-error.html#id2583772">enum GimpThumbError</a>
</dt>
<dt>GimpThumbFileType, <a class="indexterm" href="libgimpthumb-gimpthumb-enums.html#id2577024">enum GimpThumbFileType</a>
<dt>GimpThumbFileType, <a href="libgimpthumb-gimpthumb-enums.html#id2563612">enum GimpThumbFileType</a>
</dt>
<dt>GimpThumbnail, <a class="indexterm" href="GimpThumbnail.html#id2592370">GimpThumbnail</a>
<dt>GimpThumbnail, <a href="GimpThumbnail.html#id2575204">GimpThumbnail</a>
</dt>
<dt>GimpThumbnail:image-filesize, <a class="indexterm" href="GimpThumbnail.html#id2618498">The "image-filesize" property</a>
<dt>GimpThumbnail:image-filesize, <a href="GimpThumbnail.html#id2601467">The "image-filesize" property</a>
</dt>
<dt>GimpThumbnail:image-height, <a class="indexterm" href="GimpThumbnail.html#id2618540">The "image-height" property</a>
<dt>GimpThumbnail:image-height, <a href="GimpThumbnail.html#id2601509">The "image-height" property</a>
</dt>
<dt>GimpThumbnail:image-mimetype, <a class="indexterm" href="GimpThumbnail.html#id2618580">The "image-mimetype" property</a>
<dt>GimpThumbnail:image-mimetype, <a href="GimpThumbnail.html#id2601549">The "image-mimetype" property</a>
</dt>
<dt>GimpThumbnail:image-mtime, <a class="indexterm" href="GimpThumbnail.html#id2618617">The "image-mtime" property</a>
<dt>GimpThumbnail:image-mtime, <a href="GimpThumbnail.html#id2601586">The "image-mtime" property</a>
</dt>
<dt>GimpThumbnail:image-num-layers, <a class="indexterm" href="GimpThumbnail.html#id2618657">The "image-num-layers" property</a>
<dt>GimpThumbnail:image-num-layers, <a href="GimpThumbnail.html#id2601626">The "image-num-layers" property</a>
</dt>
<dt>GimpThumbnail:image-state, <a class="indexterm" href="GimpThumbnail.html#id2618699">The "image-state" property</a>
<dt>GimpThumbnail:image-state, <a href="GimpThumbnail.html#id2601668">The "image-state" property</a>
</dt>
<dt>GimpThumbnail:image-type, <a class="indexterm" href="GimpThumbnail.html#id2618736">The "image-type" property</a>
<dt>GimpThumbnail:image-type, <a href="GimpThumbnail.html#id2601705">The "image-type" property</a>
</dt>
<dt>GimpThumbnail:image-uri, <a class="indexterm" href="GimpThumbnail.html#id2618772">The "image-uri" property</a>
<dt>GimpThumbnail:image-uri, <a href="GimpThumbnail.html#id2601741">The "image-uri" property</a>
</dt>
<dt>GimpThumbnail:image-width, <a class="indexterm" href="GimpThumbnail.html#id2618807">The "image-width" property</a>
<dt>GimpThumbnail:image-width, <a href="GimpThumbnail.html#id2601776">The "image-width" property</a>
</dt>
<dt>GimpThumbnail:thumb-state, <a class="indexterm" href="GimpThumbnail.html#id2618847">The "thumb-state" property</a>
<dt>GimpThumbnail:thumb-state, <a href="GimpThumbnail.html#id2601816">The "thumb-state" property</a>
</dt>
<dt>GimpThumbSize, <a class="indexterm" href="libgimpthumb-gimpthumb-enums.html#id2578481">enum GimpThumbSize</a>
<dt>GimpThumbSize, <a href="libgimpthumb-gimpthumb-enums.html#id2573251">enum GimpThumbSize</a>
</dt>
<dt>GimpThumbState, <a class="indexterm" href="libgimpthumb-gimpthumb-enums.html#id2576396">enum GimpThumbState</a>
<dt>GimpThumbState, <a href="libgimpthumb-gimpthumb-enums.html#id2581414">enum GimpThumbState</a>
</dt>
<dt>gimp_thumbnail_check_thumb, <a class="indexterm" href="GimpThumbnail.html#id2617386">gimp_thumbnail_check_thumb ()</a>
<dt>gimp_thumbnail_check_thumb, <a href="GimpThumbnail.html#id2600262">gimp_thumbnail_check_thumb ()</a>
</dt>
<dt>gimp_thumbnail_delete_failure, <a class="indexterm" href="GimpThumbnail.html#id2618199">gimp_thumbnail_delete_failure ()</a>
<dt>gimp_thumbnail_delete_failure, <a href="GimpThumbnail.html#id2601160">gimp_thumbnail_delete_failure ()</a>
</dt>
<dt>gimp_thumbnail_delete_others, <a class="indexterm" href="GimpThumbnail.html#id2618273">gimp_thumbnail_delete_others ()</a>
<dt>gimp_thumbnail_delete_others, <a href="GimpThumbnail.html#id2601243">gimp_thumbnail_delete_others ()</a>
</dt>
<dt>gimp_thumbnail_has_failed, <a class="indexterm" href="GimpThumbnail.html#id2618374">gimp_thumbnail_has_failed ()</a>
<dt>gimp_thumbnail_has_failed, <a href="GimpThumbnail.html#id2601355">gimp_thumbnail_has_failed ()</a>
</dt>
<dt>gimp_thumbnail_load_thumb, <a class="indexterm" href="GimpThumbnail.html#id2617504">gimp_thumbnail_load_thumb ()</a>
<dt>gimp_thumbnail_load_thumb, <a href="GimpThumbnail.html#id2600395">gimp_thumbnail_load_thumb ()</a>
</dt>
<dt>gimp_thumbnail_new, <a class="indexterm" href="GimpThumbnail.html#id2532288">gimp_thumbnail_new ()</a>
<dt>gimp_thumbnail_new, <a href="GimpThumbnail.html#id2510507">gimp_thumbnail_new ()</a>
</dt>
<dt>gimp_thumbnail_peek_image, <a class="indexterm" href="GimpThumbnail.html#id2617182">gimp_thumbnail_peek_image ()</a>
<dt>gimp_thumbnail_peek_image, <a href="GimpThumbnail.html#id2600019">gimp_thumbnail_peek_image ()</a>
</dt>
<dt>gimp_thumbnail_peek_thumb, <a class="indexterm" href="GimpThumbnail.html#id2617252">gimp_thumbnail_peek_thumb ()</a>
<dt>gimp_thumbnail_peek_thumb, <a href="GimpThumbnail.html#id2600114">gimp_thumbnail_peek_thumb ()</a>
</dt>
<dt>gimp_thumbnail_save_failure, <a class="indexterm" href="GimpThumbnail.html#id2618060">gimp_thumbnail_save_failure ()</a>
<dt>gimp_thumbnail_save_failure, <a href="GimpThumbnail.html#id2601007">gimp_thumbnail_save_failure ()</a>
</dt>
<dt>gimp_thumbnail_save_thumb, <a class="indexterm" href="GimpThumbnail.html#id2617670">gimp_thumbnail_save_thumb ()</a>
<dt>gimp_thumbnail_save_thumb, <a href="GimpThumbnail.html#id2600578">gimp_thumbnail_save_thumb ()</a>
</dt>
<dt>gimp_thumbnail_save_thumb_local, <a class="indexterm" href="GimpThumbnail.html#id2617875">gimp_thumbnail_save_thumb_local ()</a>
<dt>gimp_thumbnail_save_thumb_local, <a href="GimpThumbnail.html#id2600802">gimp_thumbnail_save_thumb_local ()</a>
</dt>
<dt>gimp_thumbnail_set_filename, <a class="indexterm" href="GimpThumbnail.html#id2532457">gimp_thumbnail_set_filename ()</a>
<dt>gimp_thumbnail_set_filename, <a href="GimpThumbnail.html#id2510676">gimp_thumbnail_set_filename ()</a>
</dt>
<dt>gimp_thumbnail_set_from_thumb, <a class="indexterm" href="GimpThumbnail.html#id2617033">gimp_thumbnail_set_from_thumb ()</a>
<dt>gimp_thumbnail_set_from_thumb, <a href="GimpThumbnail.html#id2599870">gimp_thumbnail_set_from_thumb ()</a>
</dt>
<dt>gimp_thumbnail_set_uri, <a class="indexterm" href="GimpThumbnail.html#id2532348">gimp_thumbnail_set_uri ()</a>
<dt>gimp_thumbnail_set_uri, <a href="GimpThumbnail.html#id2510567">gimp_thumbnail_set_uri ()</a>
</dt>
<dt>gimp_thumbs_delete_for_uri, <a class="indexterm" href="libgimpthumb-gimpthumb-utils.html#id2618982">gimp_thumbs_delete_for_uri ()</a>
<dt>gimp_thumbs_delete_for_uri, <a href="libgimpthumb-gimpthumb-utils.html#id2562278">gimp_thumbs_delete_for_uri ()</a>
</dt>
<dt>gimp_thumbs_delete_for_uri_local, <a class="indexterm" href="libgimpthumb-gimpthumb-utils.html#id2619464">gimp_thumbs_delete_for_uri_local ()</a>
<dt>gimp_thumbs_delete_for_uri_local, <a href="libgimpthumb-gimpthumb-utils.html#id2602299">gimp_thumbs_delete_for_uri_local ()</a>
</dt>
<dt>gimp_thumb_ensure_thumb_dir, <a class="indexterm" href="libgimpthumb-gimpthumb-utils.html#id2594709">gimp_thumb_ensure_thumb_dir ()</a>
<dt>gimp_thumb_ensure_thumb_dir, <a href="libgimpthumb-gimpthumb-utils.html#id2562051">gimp_thumb_ensure_thumb_dir ()</a>
</dt>
<dt>gimp_thumb_ensure_thumb_dir_local, <a class="indexterm" href="libgimpthumb-gimpthumb-utils.html#id2619199">gimp_thumb_ensure_thumb_dir_local ()</a>
<dt>gimp_thumb_ensure_thumb_dir_local, <a href="libgimpthumb-gimpthumb-utils.html#id2602013">gimp_thumb_ensure_thumb_dir_local ()</a>
</dt>
<dt>GIMP_THUMB_ERROR, <a class="indexterm" href="libgimpthumb-gimpthumb-error.html#id2614900">GIMP_THUMB_ERROR</a>
<dt>GIMP_THUMB_ERROR, <a href="libgimpthumb-gimpthumb-error.html#id2581153">GIMP_THUMB_ERROR</a>
</dt>
<dt>gimp_thumb_error_quark, <a class="indexterm" href="libgimpthumb-gimpthumb-error.html#id2614928">gimp_thumb_error_quark ()</a>
<dt>gimp_thumb_error_quark, <a href="libgimpthumb-gimpthumb-error.html#id2581182">gimp_thumb_error_quark ()</a>
</dt>
<dt>gimp_thumb_file_test, <a class="indexterm" href="libgimpthumb-gimpthumb-utils.html#id2573407">gimp_thumb_file_test ()</a>
<dt>gimp_thumb_file_test, <a href="libgimpthumb-gimpthumb-utils.html#id2588291">gimp_thumb_file_test ()</a>
</dt>
<dt>gimp_thumb_find_thumb, <a class="indexterm" href="libgimpthumb-gimpthumb-utils.html#id2579664">gimp_thumb_find_thumb ()</a>
<dt>gimp_thumb_find_thumb, <a href="libgimpthumb-gimpthumb-utils.html#id2588130">gimp_thumb_find_thumb ()</a>
</dt>
<dt>gimp_thumb_get_thumb_dir, <a class="indexterm" href="libgimpthumb-gimpthumb-utils.html#id2594851">gimp_thumb_get_thumb_dir ()</a>
<dt>gimp_thumb_get_thumb_dir, <a href="libgimpthumb-gimpthumb-utils.html#id2562193">gimp_thumb_get_thumb_dir ()</a>
</dt>
<dt>gimp_thumb_get_thumb_dir_local, <a class="indexterm" href="libgimpthumb-gimpthumb-utils.html#id2619368">gimp_thumb_get_thumb_dir_local ()</a>
<dt>gimp_thumb_get_thumb_dir_local, <a href="libgimpthumb-gimpthumb-utils.html#id2602181">gimp_thumb_get_thumb_dir_local ()</a>
</dt>
<dt>gimp_thumb_init, <a class="indexterm" href="libgimpthumb-gimpthumb-utils.html#id2588563">gimp_thumb_init ()</a>
<dt>gimp_thumb_init, <a href="libgimpthumb-gimpthumb-utils.html#id2569529">gimp_thumb_init ()</a>
</dt>
<dt>gimp_thumb_name_from_uri, <a class="indexterm" href="libgimpthumb-gimpthumb-utils.html#id2573566">gimp_thumb_name_from_uri ()</a>
<dt>gimp_thumb_name_from_uri, <a href="libgimpthumb-gimpthumb-utils.html#id2588450">gimp_thumb_name_from_uri ()</a>
</dt>
<dt>gimp_thumb_name_from_uri_local, <a class="indexterm" href="libgimpthumb-gimpthumb-utils.html#id2619054">gimp_thumb_name_from_uri_local ()</a>
<dt>gimp_thumb_name_from_uri_local, <a href="libgimpthumb-gimpthumb-utils.html#id2601881">gimp_thumb_name_from_uri_local ()</a>
</dt>
</dl>
</div></div>

2
devel-docs/libgimpthumb/html/libgimpthumb.html
View File

@ -3,7 +3,7 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Part&#160;I.&#160;GIMP Thumbnail Library</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
<link rel="start" href="index.html" title="GIMP Thumbnail Library Reference Manual">
<link rel="up" href="index.html" title="GIMP Thumbnail Library Reference Manual">
<link rel="prev" href="index.html" title="GIMP Thumbnail Library Reference Manual">