25
<link linkend="GimpThumbnail-struct">GimpThumbnail</link>;
26
<link linkend="GimpThumbnail">GimpThumbnail</link>* <link linkend="gimp-thumbnail-new">gimp_thumbnail_new</link> (void);
27
<link linkend="void">void</link> <link linkend="gimp-thumbnail-set-uri">gimp_thumbnail_set_uri</link> (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail,
28
const <link linkend="gchar">gchar</link> *uri);
29
<link linkend="gboolean">gboolean</link> <link linkend="gimp-thumbnail-set-filename">gimp_thumbnail_set_filename</link> (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail,
30
const <link linkend="gchar">gchar</link> *filename,
31
<link linkend="GError">GError</link> **error);
32
<link linkend="gboolean">gboolean</link> <link linkend="gimp-thumbnail-set-from-thumb">gimp_thumbnail_set_from_thumb</link> (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail,
33
const <link linkend="gchar">gchar</link> *filename,
34
<link linkend="GError">GError</link> **error);
35
<link linkend="GimpThumbState">GimpThumbState</link> <link linkend="gimp-thumbnail-peek-image">gimp_thumbnail_peek_image</link> (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail);
36
<link linkend="GimpThumbState">GimpThumbState</link> <link linkend="gimp-thumbnail-peek-thumb">gimp_thumbnail_peek_thumb</link> (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail,
37
<link linkend="GimpThumbSize">GimpThumbSize</link> size);
38
<link linkend="GimpThumbState">GimpThumbState</link> <link linkend="gimp-thumbnail-check-thumb">gimp_thumbnail_check_thumb</link> (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail,
39
<link linkend="GimpThumbSize">GimpThumbSize</link> size);
40
<link linkend="GdkPixbuf">GdkPixbuf</link>* <link linkend="gimp-thumbnail-load-thumb">gimp_thumbnail_load_thumb</link> (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail,
41
<link linkend="GimpThumbSize">GimpThumbSize</link> size,
42
<link linkend="GError">GError</link> **error);
43
<link linkend="gboolean">gboolean</link> <link linkend="gimp-thumbnail-save-thumb">gimp_thumbnail_save_thumb</link> (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail,
44
<link linkend="GdkPixbuf">GdkPixbuf</link> *pixbuf,
45
const <link linkend="gchar">gchar</link> *software,
46
<link linkend="GError">GError</link> **error);
47
<link linkend="gboolean">gboolean</link> <link linkend="gimp-thumbnail-save-thumb-local">gimp_thumbnail_save_thumb_local</link> (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail,
48
<link linkend="GdkPixbuf">GdkPixbuf</link> *pixbuf,
49
const <link linkend="gchar">gchar</link> *software,
50
<link linkend="GError">GError</link> **error);
51
<link linkend="gboolean">gboolean</link> <link linkend="gimp-thumbnail-save-failure">gimp_thumbnail_save_failure</link> (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail,
52
const <link linkend="gchar">gchar</link> *software,
53
<link linkend="GError">GError</link> **error);
54
<link linkend="void">void</link> <link linkend="gimp-thumbnail-delete-failure">gimp_thumbnail_delete_failure</link> (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail);
55
<link linkend="void">void</link> <link linkend="gimp-thumbnail-delete-others">gimp_thumbnail_delete_others</link> (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail,
56
<link linkend="GimpThumbSize">GimpThumbSize</link> size);
57
<link linkend="gboolean">gboolean</link> <link linkend="gimp-thumbnail-has-failed">gimp_thumbnail_has_failed</link> (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail);
25
<link linkend="GimpThumbnail-struct">GimpThumbnail</link>;
26
<link linkend="GimpThumbnail">GimpThumbnail</link>* <link linkend="gimp-thumbnail-new">gimp_thumbnail_new</link> (void);
27
<link linkend="void">void</link> <link linkend="gimp-thumbnail-set-uri">gimp_thumbnail_set_uri</link> (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail,
28
const <link linkend="gchar">gchar</link> *uri);
29
<link linkend="gboolean">gboolean</link> <link linkend="gimp-thumbnail-set-filename">gimp_thumbnail_set_filename</link> (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail,
30
const <link linkend="gchar">gchar</link> *filename,
31
<link linkend="GError">GError</link> **error);
32
<link linkend="gboolean">gboolean</link> <link linkend="gimp-thumbnail-set-from-thumb">gimp_thumbnail_set_from_thumb</link> (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail,
33
const <link linkend="gchar">gchar</link> *filename,
34
<link linkend="GError">GError</link> **error);
35
<link linkend="GimpThumbState">GimpThumbState</link> <link linkend="gimp-thumbnail-peek-image">gimp_thumbnail_peek_image</link> (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail);
36
<link linkend="GimpThumbState">GimpThumbState</link> <link linkend="gimp-thumbnail-peek-thumb">gimp_thumbnail_peek_thumb</link> (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail,
37
<link linkend="GimpThumbSize">GimpThumbSize</link> size);
38
<link linkend="GimpThumbState">GimpThumbState</link> <link linkend="gimp-thumbnail-check-thumb">gimp_thumbnail_check_thumb</link> (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail,
39
<link linkend="GimpThumbSize">GimpThumbSize</link> size);
40
<link linkend="GdkPixbuf">GdkPixbuf</link>* <link linkend="gimp-thumbnail-load-thumb">gimp_thumbnail_load_thumb</link> (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail,
41
<link linkend="GimpThumbSize">GimpThumbSize</link> size,
42
<link linkend="GError">GError</link> **error);
43
<link linkend="gboolean">gboolean</link> <link linkend="gimp-thumbnail-save-thumb">gimp_thumbnail_save_thumb</link> (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail,
44
<link linkend="GdkPixbuf">GdkPixbuf</link> *pixbuf,
45
const <link linkend="gchar">gchar</link> *software,
46
<link linkend="GError">GError</link> **error);
47
<link linkend="gboolean">gboolean</link> <link linkend="gimp-thumbnail-save-thumb-local">gimp_thumbnail_save_thumb_local</link> (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail,
48
<link linkend="GdkPixbuf">GdkPixbuf</link> *pixbuf,
49
const <link linkend="gchar">gchar</link> *software,
50
<link linkend="GError">GError</link> **error);
51
<link linkend="gboolean">gboolean</link> <link linkend="gimp-thumbnail-save-failure">gimp_thumbnail_save_failure</link> (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail,
52
const <link linkend="gchar">gchar</link> *software,
53
<link linkend="GError">GError</link> **error);
54
<link linkend="void">void</link> <link linkend="gimp-thumbnail-delete-failure">gimp_thumbnail_delete_failure</link> (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail);
55
<link linkend="void">void</link> <link linkend="gimp-thumbnail-delete-others">gimp_thumbnail_delete_others</link> (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail,
56
<link linkend="GimpThumbSize">GimpThumbSize</link> size);
57
<link linkend="gboolean">gboolean</link> <link linkend="gimp-thumbnail-has-failed">gimp_thumbnail_has_failed</link> (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail);
77
77
<title role="properties.title">Properties</title>
80
"<link linkend="GimpThumbnail--image-filesize">image-filesize</link>" <link linkend="gint64">gint64</link> : Read / Write
81
"<link linkend="GimpThumbnail--image-height">image-height</link>" <link linkend="gint">gint</link> : Read / Write
82
"<link linkend="GimpThumbnail--image-mimetype">image-mimetype</link>" <link linkend="gchararray">gchararray</link> : Read / Write
83
"<link linkend="GimpThumbnail--image-mtime">image-mtime</link>" <link linkend="gint64">gint64</link> : Read / Write
84
"<link linkend="GimpThumbnail--image-num-layers">image-num-layers</link>" <link linkend="gint">gint</link> : Read / Write
85
"<link linkend="GimpThumbnail--image-state">image-state</link>" <link linkend="GimpThumbState">GimpThumbState</link> : Read / Write
86
"<link linkend="GimpThumbnail--image-type">image-type</link>" <link linkend="gchararray">gchararray</link> : Read / Write
87
"<link linkend="GimpThumbnail--image-uri">image-uri</link>" <link linkend="gchararray">gchararray</link> : Read / Write
88
"<link linkend="GimpThumbnail--image-width">image-width</link>" <link linkend="gint">gint</link> : Read / Write
89
"<link linkend="GimpThumbnail--thumb-state">thumb-state</link>" <link linkend="GimpThumbState">GimpThumbState</link> : Read / Write
80
"<link linkend="GimpThumbnail--image-filesize">image-filesize</link>" <link linkend="gint64">gint64</link> : Read / Write
81
"<link linkend="GimpThumbnail--image-height">image-height</link>" <link linkend="gint">gint</link> : Read / Write
82
"<link linkend="GimpThumbnail--image-mimetype">image-mimetype</link>" <link linkend="gchararray">gchararray</link> : Read / Write
83
"<link linkend="GimpThumbnail--image-mtime">image-mtime</link>" <link linkend="gint64">gint64</link> : Read / Write
84
"<link linkend="GimpThumbnail--image-num-layers">image-num-layers</link>" <link linkend="gint">gint</link> : Read / Write
85
"<link linkend="GimpThumbnail--image-state">image-state</link>" <link linkend="GimpThumbState">GimpThumbState</link> : Read / Write
86
"<link linkend="GimpThumbnail--image-type">image-type</link>" <link linkend="gchararray">gchararray</link> : Read / Write
87
"<link linkend="GimpThumbnail--image-uri">image-uri</link>" <link linkend="gchararray">gchararray</link> : Read / Write
88
"<link linkend="GimpThumbnail--image-width">image-width</link>" <link linkend="gint">gint</link> : Read / Write
89
"<link linkend="GimpThumbnail--thumb-state">thumb-state</link>" <link linkend="GimpThumbState">GimpThumbState</link> : Read / Write
251
251
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the thumbnail's <link linkend="GimpThumbState"><type>GimpThumbState</type></link> after the update
253
253
</simpara></listitem></varlistentry>
254
</variablelist><para>Since GIMP 2.2
254
</variablelist><para role="since">Since GIMP 2.2
255
255
</para></refsect2>
257
257
<title><anchor id="gimp-thumbnail-load-thumb" role="function"/>gimp_thumbnail_load_thumb ()</title>
258
<indexterm><primary>gimp_thumbnail_load_thumb</primary></indexterm><programlisting><link linkend="GdkPixbuf">GdkPixbuf</link>* gimp_thumbnail_load_thumb (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail,
259
<link linkend="GimpThumbSize">GimpThumbSize</link> size,
260
<link linkend="GError">GError</link> **error);</programlisting>
258
<indexterm><primary>gimp_thumbnail_load_thumb</primary></indexterm><programlisting><link linkend="GdkPixbuf">GdkPixbuf</link>* gimp_thumbnail_load_thumb (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail,
259
<link linkend="GimpThumbSize">GimpThumbSize</link> size,
260
<link linkend="GError">GError</link> **error);</programlisting>
262
262
Attempts to load a thumbnail preview for the image associated with
263
263
<parameter>thumbnail</parameter>. Before you use this function you need need to set an
289
289
</variablelist></refsect2>
291
291
<title><anchor id="gimp-thumbnail-save-thumb" role="function"/>gimp_thumbnail_save_thumb ()</title>
292
<indexterm><primary>gimp_thumbnail_save_thumb</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gimp_thumbnail_save_thumb (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail,
293
<link linkend="GdkPixbuf">GdkPixbuf</link> *pixbuf,
294
const <link linkend="gchar">gchar</link> *software,
295
<link linkend="GError">GError</link> **error);</programlisting>
292
<indexterm><primary>gimp_thumbnail_save_thumb</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gimp_thumbnail_save_thumb (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail,
293
<link linkend="GdkPixbuf">GdkPixbuf</link> *pixbuf,
294
const <link linkend="gchar">gchar</link> *software,
295
<link linkend="GError">GError</link> **error);</programlisting>
297
297
Saves a preview thumbnail for the image associated with <parameter>thumbnail</parameter>.
298
298
to the global thumbnail repository.
329
329
</variablelist></refsect2>
331
331
<title><anchor id="gimp-thumbnail-save-thumb-local" role="function" condition="since:GIMP 2.2"/>gimp_thumbnail_save_thumb_local ()</title>
332
<indexterm role="GIMP 2.2"><primary>gimp_thumbnail_save_thumb_local</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gimp_thumbnail_save_thumb_local (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail,
333
<link linkend="GdkPixbuf">GdkPixbuf</link> *pixbuf,
334
const <link linkend="gchar">gchar</link> *software,
335
<link linkend="GError">GError</link> **error);</programlisting>
332
<indexterm role="GIMP 2.2"><primary>gimp_thumbnail_save_thumb_local</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gimp_thumbnail_save_thumb_local (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail,
333
<link linkend="GdkPixbuf">GdkPixbuf</link> *pixbuf,
334
const <link linkend="gchar">gchar</link> *software,
335
<link linkend="GError">GError</link> **error);</programlisting>
337
337
Saves a preview thumbnail for the image associated with <parameter>thumbnail</parameter>
338
338
to the local thumbnail repository. Local thumbnails have been added
360
360
<link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise
362
362
</simpara></listitem></varlistentry>
363
</variablelist><para>Since GIMP 2.2
363
</variablelist><para role="since">Since GIMP 2.2
364
364
</para></refsect2>
366
366
<title><anchor id="gimp-thumbnail-save-failure" role="function"/>gimp_thumbnail_save_failure ()</title>
367
<indexterm><primary>gimp_thumbnail_save_failure</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gimp_thumbnail_save_failure (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail,
368
const <link linkend="gchar">gchar</link> *software,
369
<link linkend="GError">GError</link> **error);</programlisting>
367
<indexterm><primary>gimp_thumbnail_save_failure</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gimp_thumbnail_save_failure (<link linkend="GimpThumbnail">GimpThumbnail</link> *thumbnail,
368
const <link linkend="gchar">gchar</link> *software,
369
<link linkend="GError">GError</link> **error);</programlisting>
371
371
Saves a failure thumbnail for the image associated with
372
372
<parameter>thumbnail</parameter>. This is an empty pixbuf that indicates that an attempt
445
445
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if a failure thumbnail exists or
447
447
</simpara></listitem></varlistentry>
448
</variablelist><para>Since GIMP 2.2
448
</variablelist><para role="since">Since GIMP 2.2
449
449
</para></refsect2>
452
452
<refsect1 role="property_details">
453
453
<title role="property_details.title">Property Details</title>
454
454
<refsect2><title><anchor id="GimpThumbnail--image-filesize"/>The "<literal>image-filesize</literal>" property</title>
455
<indexterm><primary>GimpThumbnail:image-filesize</primary></indexterm><programlisting> "image-filesize" <link linkend="gint64">gint64</link> : Read / Write</programlisting>
455
<indexterm><primary>GimpThumbnail:image-filesize</primary></indexterm><programlisting> "image-filesize" <link linkend="gint64">gint64</link> : Read / Write</programlisting>
456
456
<para>Size of the image file in bytes.</para><para>Allowed values: >= 0</para>
457
457
<para>Default value: 0</para>
459
459
<refsect2><title><anchor id="GimpThumbnail--image-height"/>The "<literal>image-height</literal>" property</title>
460
<indexterm><primary>GimpThumbnail:image-height</primary></indexterm><programlisting> "image-height" <link linkend="gint">gint</link> : Read / Write</programlisting>
460
<indexterm><primary>GimpThumbnail:image-height</primary></indexterm><programlisting> "image-height" <link linkend="gint">gint</link> : Read / Write</programlisting>
461
461
<para>Height of the image in pixels.</para><para>Allowed values: >= 0</para>
462
462
<para>Default value: 0</para>
464
464
<refsect2><title><anchor id="GimpThumbnail--image-mimetype"/>The "<literal>image-mimetype</literal>" property</title>
465
<indexterm><primary>GimpThumbnail:image-mimetype</primary></indexterm><programlisting> "image-mimetype" <link linkend="gchararray">gchararray</link> : Read / Write</programlisting>
465
<indexterm><primary>GimpThumbnail:image-mimetype</primary></indexterm><programlisting> "image-mimetype" <link linkend="gchararray">gchararray</link> : Read / Write</programlisting>
466
466
<para>Image mimetype.</para><para>Default value: NULL</para>
468
468
<refsect2><title><anchor id="GimpThumbnail--image-mtime"/>The "<literal>image-mtime</literal>" property</title>
469
<indexterm><primary>GimpThumbnail:image-mtime</primary></indexterm><programlisting> "image-mtime" <link linkend="gint64">gint64</link> : Read / Write</programlisting>
469
<indexterm><primary>GimpThumbnail:image-mtime</primary></indexterm><programlisting> "image-mtime" <link linkend="gint64">gint64</link> : Read / Write</programlisting>
470
470
<para>Modification time of the image file in seconds since the Epoch.</para><para>Allowed values: >= 0</para>
471
471
<para>Default value: 0</para>
473
473
<refsect2><title><anchor id="GimpThumbnail--image-num-layers"/>The "<literal>image-num-layers</literal>" property</title>
474
<indexterm><primary>GimpThumbnail:image-num-layers</primary></indexterm><programlisting> "image-num-layers" <link linkend="gint">gint</link> : Read / Write</programlisting>
474
<indexterm><primary>GimpThumbnail:image-num-layers</primary></indexterm><programlisting> "image-num-layers" <link linkend="gint">gint</link> : Read / Write</programlisting>
475
475
<para>The number of layers in the image.</para><para>Allowed values: >= 0</para>
476
476
<para>Default value: 0</para>
478
478
<refsect2><title><anchor id="GimpThumbnail--image-state"/>The "<literal>image-state</literal>" property</title>
479
<indexterm><primary>GimpThumbnail:image-state</primary></indexterm><programlisting> "image-state" <link linkend="GimpThumbState">GimpThumbState</link> : Read / Write</programlisting>
479
<indexterm><primary>GimpThumbnail:image-state</primary></indexterm><programlisting> "image-state" <link linkend="GimpThumbState">GimpThumbState</link> : Read / Write</programlisting>
480
480
<para>State of the image associated to the thumbnail object.</para><para>Default value: GIMP_THUMB_STATE_UNKNOWN</para>
482
482
<refsect2><title><anchor id="GimpThumbnail--image-type"/>The "<literal>image-type</literal>" property</title>
483
<indexterm><primary>GimpThumbnail:image-type</primary></indexterm><programlisting> "image-type" <link linkend="gchararray">gchararray</link> : Read / Write</programlisting>
483
<indexterm><primary>GimpThumbnail:image-type</primary></indexterm><programlisting> "image-type" <link linkend="gchararray">gchararray</link> : Read / Write</programlisting>
484
484
<para>String describing the type of the image format.</para><para>Default value: NULL</para>
486
486
<refsect2><title><anchor id="GimpThumbnail--image-uri"/>The "<literal>image-uri</literal>" property</title>
487
<indexterm><primary>GimpThumbnail:image-uri</primary></indexterm><programlisting> "image-uri" <link linkend="gchararray">gchararray</link> : Read / Write</programlisting>
487
<indexterm><primary>GimpThumbnail:image-uri</primary></indexterm><programlisting> "image-uri" <link linkend="gchararray">gchararray</link> : Read / Write</programlisting>
488
488
<para>URI of the image file.</para><para>Default value: NULL</para>
490
490
<refsect2><title><anchor id="GimpThumbnail--image-width"/>The "<literal>image-width</literal>" property</title>
491
<indexterm><primary>GimpThumbnail:image-width</primary></indexterm><programlisting> "image-width" <link linkend="gint">gint</link> : Read / Write</programlisting>
491
<indexterm><primary>GimpThumbnail:image-width</primary></indexterm><programlisting> "image-width" <link linkend="gint">gint</link> : Read / Write</programlisting>
492
492
<para>Width of the image in pixels.</para><para>Allowed values: >= 0</para>
493
493
<para>Default value: 0</para>
495
495
<refsect2><title><anchor id="GimpThumbnail--thumb-state"/>The "<literal>thumb-state</literal>" property</title>
496
<indexterm><primary>GimpThumbnail:thumb-state</primary></indexterm><programlisting> "thumb-state" <link linkend="GimpThumbState">GimpThumbState</link> : Read / Write</programlisting>
496
<indexterm><primary>GimpThumbnail:thumb-state</primary></indexterm><programlisting> "thumb-state" <link linkend="GimpThumbState">GimpThumbState</link> : Read / Write</programlisting>
497
497
<para>State of the thumbnail file.</para><para>Default value: GIMP_THUMB_STATE_UNKNOWN</para>