Include a Other Software section in Help file
[geeqie.git] / src / thumb_standard.c
1 /*
2  * Copyright (C) 2006 John Ellis
3  * Copyright (C) 2008 - 2016 The Geeqie Team
4  *
5  * Author: John Ellis
6  *
7  * This program is free software; you can redistribute it and/or modify
8  * it under the terms of the GNU General Public License as published by
9  * the Free Software Foundation; either version 2 of the License, or
10  * (at your option) any later version.
11  *
12  * This program is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15  * GNU General Public License for more details.
16  *
17  * You should have received a copy of the GNU General Public License along
18  * with this program; if not, write to the Free Software Foundation, Inc.,
19  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
20  */
21
22 #include "main.h"
23 #include "thumb_standard.h"
24
25 #include "cache.h"
26 #include "image-load.h"
27 #include "md5-util.h"
28 #include "pixbuf_util.h"
29 #include "ui_fileops.h"
30 #include "filedata.h"
31 #include "exif.h"
32 #include "metadata.h"
33 #include "color-man.h"
34
35
36 /**
37  * @file
38  * 
39  * This thumbnail caching implementation attempts to conform
40  * to the Thumbnail Managing Standard proposed on freedesktop.org
41  * The standard is documented here: \n
42  *   http://triq.net/~jens/thumbnail-spec/index.html \n
43  *  (why isn't it actually hosted on freedesktop.org?)
44  *
45  * This code attempts to conform to version 0.7.0 of the standard.
46  *
47  * Notes:
48  *   > Validation of the thumb's embedded uri is a simple strcmp between our
49  *   > version of the escaped uri and the thumb's escaped uri. But not all uri
50  *   > escape functions escape the same set of chars, comparing the unescaped
51  *   > versions may be more accurate. \n
52  *   > Only Thumb::URI and Thumb::MTime are stored in a thumb at this time.
53  *     Storing the Size, Width, Height should probably be implemented.
54  */
55
56
57 #define THUMB_SIZE_NORMAL 128
58 #define THUMB_SIZE_LARGE  256
59
60 #define THUMB_MARKER_URI    "tEXt::Thumb::URI"
61 #define THUMB_MARKER_MTIME  "tEXt::Thumb::MTime"
62 #define THUMB_MARKER_SIZE   "tEXt::Thumb::Size"
63 #define THUMB_MARKER_WIDTH  "tEXt::Thumb::Image::Width"
64 #define THUMB_MARKER_HEIGHT "tEXt::Thumb::Image::Height"
65 #define THUMB_MARKER_APP    "tEXt::Software"
66
67 #define THUMB_PERMS_FOLDER 0700
68 #define THUMB_PERMS_THUMB  0600
69
70
71
72 /*
73  *-----------------------------------------------------------------------------
74  * thumbnail loader
75  *-----------------------------------------------------------------------------
76  */
77
78
79 static void thumb_loader_std_error_cb(ImageLoader *il, gpointer data);
80 static gint thumb_loader_std_setup(ThumbLoaderStd *tl, FileData *fd);
81
82
83 ThumbLoaderStd *thumb_loader_std_new(gint width, gint height)
84 {
85         ThumbLoaderStd *tl;
86
87         tl = g_new0(ThumbLoaderStd, 1);
88
89         tl->standard_loader = TRUE;
90         tl->requested_width = width;
91         tl->requested_height = height;
92         tl->cache_enable = options->thumbnails.enable_caching;
93
94         return tl;
95 }
96
97 void thumb_loader_std_set_callbacks(ThumbLoaderStd *tl,
98                                     ThumbLoaderStdFunc func_done,
99                                     ThumbLoaderStdFunc func_error,
100                                     ThumbLoaderStdFunc func_progress,
101                                     gpointer data)
102 {
103         if (!tl) return;
104
105         tl->func_done = func_done;
106         tl->func_error = func_error;
107         tl->func_progress = func_progress;
108         tl->data = data;
109 }
110
111 static void thumb_loader_std_reset(ThumbLoaderStd *tl)
112 {
113         image_loader_free(tl->il);
114         tl->il = NULL;
115
116         file_data_unref(tl->fd);
117         tl->fd = NULL;
118
119         g_free(tl->thumb_path);
120         tl->thumb_path = NULL;
121
122         g_free(tl->thumb_uri);
123         tl->thumb_uri = NULL;
124         tl->local_uri = NULL;
125
126         tl->thumb_path_local = FALSE;
127
128         tl->cache_hit = FALSE;
129
130         tl->source_mtime = 0;
131         tl->source_size = 0;
132         tl->source_mode = 0;
133
134         tl->progress = 0.0;
135 }
136
137 static gchar *thumb_std_cache_path(const gchar *path, const gchar *uri, gboolean local,
138                                    const gchar *cache_subfolder)
139 {
140         gchar *result = NULL;
141         gchar *md5_text;
142         guchar digest[16];
143         gchar *name;
144
145         if (!path || !uri || !cache_subfolder) return NULL;
146
147         md5_get_digest((guchar *)uri, strlen(uri), digest);
148         md5_text = md5_digest_to_text(digest);
149
150         if (!md5_text) return NULL;
151
152         name = g_strconcat(md5_text, THUMB_NAME_EXTENSION, NULL);
153
154         if (local)
155                 {
156                 gchar *base = remove_level_from_path(path);
157
158                 result = g_build_filename(base, THUMB_FOLDER_LOCAL, cache_subfolder, name, NULL);
159                 g_free(base);
160                 }
161         else
162                 {
163                 result = g_build_filename(get_thumbnails_standard_cache_dir(),
164                                                                                                         cache_subfolder, name, NULL);
165                 }
166
167         g_free(name);
168         g_free(md5_text);
169
170         return result;
171 }
172
173 static gchar *thumb_loader_std_cache_path(ThumbLoaderStd *tl, gboolean local, GdkPixbuf *pixbuf, gboolean fail)
174 {
175         const gchar *folder;
176         gint w, h;
177
178         if (!tl->fd || !tl->thumb_uri) return NULL;
179
180         if (pixbuf)
181                 {
182                 w = gdk_pixbuf_get_width(pixbuf);
183                 h = gdk_pixbuf_get_height(pixbuf);
184                 }
185         else
186                 {
187                 w = tl->requested_width;
188                 h = tl->requested_height;
189                 }
190
191         if (fail)
192                 {
193                 folder = THUMB_FOLDER_FAIL;
194                 }
195         else if (w > THUMB_SIZE_NORMAL || h > THUMB_SIZE_NORMAL)
196                 {
197                 folder = THUMB_FOLDER_LARGE;
198                 }
199         else
200                 {
201                 folder = THUMB_FOLDER_NORMAL;
202                 }
203
204         return thumb_std_cache_path(tl->fd->path,
205                                     (local) ?  tl->local_uri : tl->thumb_uri,
206                                     local, folder);
207 }
208
209 static gboolean thumb_loader_std_fail_check(ThumbLoaderStd *tl)
210 {
211         gchar *fail_path;
212         gboolean result = FALSE;
213
214         fail_path = thumb_loader_std_cache_path(tl, FALSE, NULL, TRUE);
215         if (isfile(fail_path))
216                 {
217                 GdkPixbuf *pixbuf;
218
219                 if (tl->cache_retry)
220                         {
221                         pixbuf = NULL;
222                         }
223                 else
224                         {
225                         gchar *pathl;
226
227                         pathl = path_from_utf8(fail_path);
228                         pixbuf = gdk_pixbuf_new_from_file(pathl, NULL);
229                         g_free(pathl);
230                         }
231
232                 if (pixbuf)
233                         {
234                         const gchar *mtime_str;
235
236                         mtime_str = gdk_pixbuf_get_option(pixbuf, THUMB_MARKER_MTIME);
237                         if (mtime_str && strtol(mtime_str, NULL, 10) == tl->source_mtime)
238                                 {
239                                 result = TRUE;
240                                 DEBUG_1("thumb fail valid: %s", tl->fd->path);
241                                 DEBUG_1("           thumb: %s", fail_path);
242                                 }
243
244                         g_object_unref(G_OBJECT(pixbuf));
245                         }
246
247                 if (!result) unlink_file(fail_path);
248                 }
249         g_free(fail_path);
250
251         return result;
252 }
253
254 static gboolean thumb_loader_std_validate(ThumbLoaderStd *tl, GdkPixbuf *pixbuf)
255 {
256         const gchar *valid_uri;
257         const gchar *uri;
258         const gchar *mtime_str;
259         time_t mtime;
260         gint w, h;
261
262         if (!pixbuf) return FALSE;
263
264         w = gdk_pixbuf_get_width(pixbuf);
265         h = gdk_pixbuf_get_height(pixbuf);
266
267         if (w != THUMB_SIZE_NORMAL && w != THUMB_SIZE_LARGE &&
268             h != THUMB_SIZE_NORMAL && h != THUMB_SIZE_LARGE) return FALSE;
269
270         valid_uri = (tl->thumb_path_local) ? tl->local_uri : tl->thumb_uri;
271
272         uri = gdk_pixbuf_get_option(pixbuf, THUMB_MARKER_URI);
273         mtime_str = gdk_pixbuf_get_option(pixbuf, THUMB_MARKER_MTIME);
274
275         if (!mtime_str || !uri || !valid_uri) return FALSE;
276         if (strcmp(uri, valid_uri) != 0) return FALSE;
277
278         mtime = strtol(mtime_str, NULL, 10);
279         if (tl->source_mtime != mtime) return FALSE;
280
281         return TRUE;
282 }
283
284 static void thumb_loader_std_save(ThumbLoaderStd *tl, GdkPixbuf *pixbuf)
285 {
286         gchar *base_path;
287         gchar *tmp_path;
288         gboolean fail;
289
290         if (!tl->cache_enable || tl->cache_hit) return;
291         if (tl->thumb_path) return;
292
293         if (!pixbuf)
294                 {
295                 /* local failures are not stored */
296                 if (tl->cache_local) return;
297
298                 pixbuf = gdk_pixbuf_new(GDK_COLORSPACE_RGB, TRUE, 8, 1, 1);
299                 fail = TRUE;
300                 }
301         else
302                 {
303                 g_object_ref(G_OBJECT(pixbuf));
304                 fail = FALSE;
305                 }
306
307         tl->thumb_path = thumb_loader_std_cache_path(tl, tl->cache_local, pixbuf, fail);
308         if (!tl->thumb_path)
309                 {
310                 g_object_unref(G_OBJECT(pixbuf));
311                 return;
312                 }
313         tl->thumb_path_local = tl->cache_local;
314
315         /* create thumbnail dir if needed */
316         base_path = remove_level_from_path(tl->thumb_path);
317         if (tl->cache_local)
318                 {
319                 if (!isdir(base_path))
320                         {
321                         struct stat st;
322                         gchar *source_base;
323
324                         source_base = remove_level_from_path(tl->fd->path);
325                         if (stat_utf8(source_base, &st))
326                                 {
327                                 recursive_mkdir_if_not_exists(base_path, st.st_mode);
328                                 }
329                         g_free(source_base);
330                         }
331                 }
332         else
333                 {
334                 recursive_mkdir_if_not_exists(base_path, THUMB_PERMS_FOLDER);
335                 }
336         g_free(base_path);
337
338         DEBUG_1("thumb saving: %s", tl->fd->path);
339         DEBUG_1("       saved: %s", tl->thumb_path);
340
341         /* save thumb, using a temp file then renaming into place */
342         tmp_path = unique_filename(tl->thumb_path, ".tmp", "_", 2);
343         if (tmp_path)
344                 {
345                 const gchar *mark_uri;
346                 gchar *mark_app;
347                 gchar *mark_mtime;
348                 gchar *pathl;
349                 gboolean success;
350
351                 mark_uri = (tl->cache_local) ? tl->local_uri :tl->thumb_uri;
352
353                 mark_app = g_strdup_printf("%s %s", GQ_APPNAME, VERSION);
354                 mark_mtime = g_strdup_printf("%llu", (unsigned long long)tl->source_mtime);
355                 pathl = path_from_utf8(tmp_path);
356                 success = gdk_pixbuf_save(pixbuf, pathl, "png", NULL,
357                                           THUMB_MARKER_URI, mark_uri,
358                                           THUMB_MARKER_MTIME, mark_mtime,
359                                           THUMB_MARKER_APP, mark_app,
360                                           NULL);
361                 if (success)
362                         {
363                         chmod(pathl, (tl->cache_local) ? tl->source_mode : THUMB_PERMS_THUMB);
364                         success = rename_file(tmp_path, tl->thumb_path);
365                         }
366
367                 g_free(pathl);
368
369                 g_free(mark_mtime);
370                 g_free(mark_app);
371
372                 g_free(tmp_path);
373                 if (!success)
374                         {
375                         DEBUG_1("thumb save failed: %s", tl->fd->path);
376                         DEBUG_1("            thumb: %s", tl->thumb_path);
377                         }
378
379                 }
380
381         g_object_unref(G_OBJECT(pixbuf));
382 }
383
384 static void thumb_loader_std_set_fallback(ThumbLoaderStd *tl)
385 {
386         if (tl->fd->thumb_pixbuf) g_object_unref(tl->fd->thumb_pixbuf);
387         tl->fd->thumb_pixbuf = pixbuf_fallback(tl->fd, tl->requested_width, tl->requested_height);
388 }
389
390
391 void thumb_loader_std_calibrate_pixbuf(FileData *fd, GdkPixbuf *pixbuf) {
392         ColorMan *cm = NULL;
393         ExifData *exif = NULL;
394         gint color_profile_from_image = COLOR_PROFILE_NONE;
395         ColorManProfileType input_type = COLOR_PROFILE_MEM;
396         ColorManProfileType screen_type;
397         const gchar *input_file = NULL;
398         guchar *profile = NULL;
399         guint profile_len;
400         gint sw, sh;
401
402         if (!options->thumbnails.use_color_management)
403                 {
404                 return;
405                 }
406
407         sw = gdk_pixbuf_get_width(pixbuf);
408         sh = gdk_pixbuf_get_height(pixbuf);
409
410         exif = exif_read_fd(fd);
411
412         if (exif)
413                 {
414                 profile = exif_get_color_profile(exif, &profile_len);
415                 if (profile)
416                         {
417                         DEBUG_1("Found embedded color profile");
418                         color_profile_from_image = COLOR_PROFILE_MEM;
419                         }
420                 else
421                         {
422                         gchar *interop_index = exif_get_data_as_text(exif, "Exif.Iop.InteroperabilityIndex");
423
424                         if (interop_index)
425                                 {
426                                 /* Exif 2.21 specification */
427                                 if (!strcmp(interop_index, "R98"))
428                                         {
429                                         color_profile_from_image = COLOR_PROFILE_SRGB;
430                                         DEBUG_1("Found EXIF 2.21 ColorSpace of sRGB");
431                                         }
432                                 else if (!strcmp(interop_index, "R03"))
433                                         {
434                                         color_profile_from_image = COLOR_PROFILE_ADOBERGB;
435                                         DEBUG_1("Found EXIF 2.21 ColorSpace of AdobeRGB");
436                                         }
437                                 g_free(interop_index);
438                                 }
439                         else
440                                 {
441                                 gint cs;
442
443                                 /* ColorSpace == 1 specifies sRGB per EXIF 2.2 */
444                                 if (!exif_get_integer(exif, "Exif.Photo.ColorSpace", &cs)) cs = 0;
445                                 if (cs == 1)
446                                         {
447                                         color_profile_from_image = COLOR_PROFILE_SRGB;
448                                         DEBUG_1("Found EXIF 2.2 ColorSpace of sRGB");
449                                         }
450                                 else if (cs == 2)
451                                         {
452                                         /* non-standard way of specifying AdobeRGB (used by some software) */
453                                         color_profile_from_image = COLOR_PROFILE_ADOBERGB;
454                                         DEBUG_1("Found EXIF 2.2 ColorSpace of AdobeRGB");
455                                         }
456                                 }
457                         }
458
459                 if(color_profile_from_image != COLOR_PROFILE_NONE)
460                         {
461                                 // transform image, we always use sRGB as target for thumbnails
462                                 screen_type = COLOR_PROFILE_SRGB;
463
464                                 if (profile)
465                                         {
466                                         cm = color_man_new_embedded(NULL, pixbuf,
467                                                                         profile, profile_len,
468                                                                         screen_type, NULL, NULL, 0);
469                                         g_free(profile);
470                                         }
471                                 else
472                                         {
473                                         cm = color_man_new(NULL, pixbuf,
474                                                         input_type, input_file,
475                                                         screen_type, NULL, NULL, 0);
476                                         }
477
478                                 if(cm) {
479                                         color_man_correct_region(cm, cm->pixbuf, 0, 0, sw, sh);
480                                         g_free(cm);
481                                 }
482
483                         }
484                 exif_free_fd(fd, exif);
485                 }
486 }
487
488 static GdkPixbuf *thumb_loader_std_finish(ThumbLoaderStd *tl, GdkPixbuf *pixbuf, gboolean shrunk)
489 {
490         GdkPixbuf *pixbuf_thumb = NULL;
491         GdkPixbuf *result;
492         GdkPixbuf *rotated = NULL;
493         gint sw, sh;
494
495
496         if (!tl->cache_hit && options->image.exif_rotate_enable)
497                 {
498                 if (!tl->fd->exif_orientation)
499                         {
500                         tl->fd->exif_orientation = metadata_read_int(tl->fd, ORIENTATION_KEY, EXIF_ORIENTATION_TOP_LEFT);
501                         }
502
503                 if (tl->fd->exif_orientation != EXIF_ORIENTATION_TOP_LEFT)
504                         {
505                         rotated = pixbuf_apply_orientation(pixbuf, tl->fd->exif_orientation);
506                         pixbuf = rotated;
507                         }
508                 }
509
510         sw = gdk_pixbuf_get_width(pixbuf);
511         sh = gdk_pixbuf_get_height(pixbuf);
512
513         if (tl->cache_enable)
514                 {
515                 if (!tl->cache_hit)
516                         {
517                         gint cache_w, cache_h;
518
519                         if (tl->requested_width > THUMB_SIZE_NORMAL || tl->requested_height > THUMB_SIZE_NORMAL)
520                                 {
521                                 cache_w = cache_h = THUMB_SIZE_LARGE;
522                                 }
523                         else
524                                 {
525                                 cache_w = cache_h = THUMB_SIZE_NORMAL;
526                                 }
527
528                         if (sw > cache_w || sh > cache_h || shrunk)
529                                 {
530                                 gint thumb_w, thumb_h;
531                                 struct stat st;
532
533                                 if (pixbuf_scale_aspect(cache_w, cache_h, sw, sh,
534                                                                   &thumb_w, &thumb_h))
535                                         {
536                                         pixbuf_thumb = gdk_pixbuf_scale_simple(pixbuf, thumb_w, thumb_h,
537                                                                                (GdkInterpType)options->thumbnails.quality);
538                                         }
539                                 else
540                                         {
541                                         pixbuf_thumb = pixbuf;
542                                         g_object_ref(G_OBJECT(pixbuf_thumb));
543                                         }
544
545                                 /* do not save the thumbnail if the source file has changed meanwhile -
546                                    the thumbnail is most probably broken */
547                                 if (stat_utf8(tl->fd->path, &st) &&
548                                     tl->source_mtime == st.st_mtime &&
549                                     tl->source_size == st.st_size)
550                                         {
551                                         thumb_loader_std_save(tl, pixbuf_thumb);
552                                         }
553                                 }
554                         }
555                 else if (tl->cache_hit &&
556                          tl->cache_local && !tl->thumb_path_local)
557                         {
558                         /* A local cache save was requested, but a valid thumb is in $HOME,
559                          * so specifically save as a local thumbnail.
560                          */
561                         g_free(tl->thumb_path);
562                         tl->thumb_path = NULL;
563
564                         tl->cache_hit = FALSE;
565
566                         DEBUG_1("thumb copied: %s", tl->fd->path);
567
568                         thumb_loader_std_save(tl, pixbuf);
569                         }
570                 }
571
572         if (sw <= tl->requested_width && sh <= tl->requested_height)
573                 {
574                 result = pixbuf;
575                 g_object_ref(result);
576                 }
577         else
578                 {
579                 gint thumb_w, thumb_h;
580
581                 if (pixbuf_thumb)
582                         {
583                         pixbuf = pixbuf_thumb;
584                         sw = gdk_pixbuf_get_width(pixbuf);
585                         sh = gdk_pixbuf_get_height(pixbuf);
586                         }
587
588                 if (pixbuf_scale_aspect(tl->requested_width, tl->requested_height, sw, sh,
589                                                   &thumb_w, &thumb_h))
590                         {
591                         result = gdk_pixbuf_scale_simple(pixbuf, thumb_w, thumb_h,
592                                                          (GdkInterpType)options->thumbnails.quality);
593                         }
594                 else
595                         {
596                         result = pixbuf;
597                         g_object_ref(result);
598                         }
599                 }
600
601         // apply color correction, if required
602         thumb_loader_std_calibrate_pixbuf(tl->fd, result);
603
604         if (pixbuf_thumb) g_object_unref(pixbuf_thumb);
605         if (rotated) g_object_unref(rotated);
606
607         return result;
608 }
609
610 static gboolean thumb_loader_std_next_source(ThumbLoaderStd *tl, gboolean remove_broken)
611 {
612         image_loader_free(tl->il);
613         tl->il = NULL;
614
615         if (tl->thumb_path)
616                 {
617                 if (!tl->thumb_path_local && remove_broken)
618                         {
619                         DEBUG_1("thumb broken, unlinking: %s", tl->thumb_path);
620                         unlink_file(tl->thumb_path);
621                         }
622
623                 g_free(tl->thumb_path);
624                 tl->thumb_path = NULL;
625
626                 if (!tl->thumb_path_local)
627                         {
628                         tl->thumb_path = thumb_loader_std_cache_path(tl, TRUE, NULL, FALSE);
629                         if (isfile(tl->thumb_path))
630                                 {
631                                 FileData *fd = file_data_new_no_grouping(tl->thumb_path);
632                                 if (thumb_loader_std_setup(tl, fd))
633                                         {
634                                         file_data_unref(fd);
635                                         tl->thumb_path_local = TRUE;
636                                         return TRUE;
637                                         }
638                                 file_data_unref(fd);
639                                 }
640
641                         g_free(tl->thumb_path);
642                         tl->thumb_path = NULL;
643                         }
644
645                 if (thumb_loader_std_setup(tl, tl->fd)) return TRUE;
646                 }
647
648         thumb_loader_std_save(tl, NULL);
649         return FALSE;
650 }
651
652 static void thumb_loader_std_done_cb(ImageLoader *il, gpointer data)
653 {
654         ThumbLoaderStd *tl = data;
655         GdkPixbuf *pixbuf;
656
657         DEBUG_1("thumb image done: %s", tl->fd ? tl->fd->path : "???");
658         DEBUG_1("            from: %s", image_loader_get_fd(tl->il)->path);
659
660         pixbuf = image_loader_get_pixbuf(tl->il);
661         if (!pixbuf)
662                 {
663                 DEBUG_1("...but no pixbuf");
664                 thumb_loader_std_error_cb(il, data);
665                 return;
666                 }
667
668         if (tl->thumb_path && !thumb_loader_std_validate(tl, pixbuf))
669                 {
670                 if (thumb_loader_std_next_source(tl, TRUE)) return;
671
672                 if (tl->func_error) tl->func_error(tl, tl->data);
673                 return;
674                 }
675
676         tl->cache_hit = (tl->thumb_path != NULL);
677
678         if (tl->fd)
679                 {
680                 if (tl->fd->thumb_pixbuf) g_object_unref(tl->fd->thumb_pixbuf);
681                 tl->fd->thumb_pixbuf = thumb_loader_std_finish(tl, pixbuf, image_loader_get_shrunk(il));
682                 }
683
684         if (tl->func_done) tl->func_done(tl, tl->data);
685 }
686
687 static void thumb_loader_std_error_cb(ImageLoader *il, gpointer data)
688 {
689         ThumbLoaderStd *tl = data;
690
691         /* if at least some of the image is available, go to done */
692         if (image_loader_get_pixbuf(tl->il) != NULL)
693                 {
694                 thumb_loader_std_done_cb(il, data);
695                 return;
696                 }
697
698         DEBUG_1("thumb image error: %s", tl->fd->path);
699         DEBUG_1("             from: %s", image_loader_get_fd(tl->il)->path);
700
701         if (thumb_loader_std_next_source(tl, TRUE)) return;
702
703         thumb_loader_std_set_fallback(tl);
704
705         if (tl->func_error) tl->func_error(tl, tl->data);
706 }
707
708 static void thumb_loader_std_progress_cb(ImageLoader *il, gdouble percent, gpointer data)
709 {
710         ThumbLoaderStd *tl = data;
711
712         tl->progress = (gdouble)percent;
713
714         if (tl->func_progress) tl->func_progress(tl, tl->data);
715 }
716
717 static gboolean thumb_loader_std_setup(ThumbLoaderStd *tl, FileData *fd)
718 {
719         tl->il = image_loader_new(fd);
720         image_loader_set_priority(tl->il, G_PRIORITY_LOW);
721
722         /* this will speed up jpegs by up to 3x in some cases */
723         if (tl->requested_width <= THUMB_SIZE_NORMAL &&
724             tl->requested_height <= THUMB_SIZE_NORMAL)
725                 {
726                 image_loader_set_requested_size(tl->il, THUMB_SIZE_NORMAL, THUMB_SIZE_NORMAL);
727                 }
728         else
729                 {
730                 image_loader_set_requested_size(tl->il, THUMB_SIZE_LARGE, THUMB_SIZE_LARGE);
731                 }
732
733         g_signal_connect(G_OBJECT(tl->il), "error", (GCallback)thumb_loader_std_error_cb, tl);
734         if (tl->func_progress)
735                 {
736                 g_signal_connect(G_OBJECT(tl->il), "percent", (GCallback)thumb_loader_std_progress_cb, tl);
737                 }
738         g_signal_connect(G_OBJECT(tl->il), "done", (GCallback)thumb_loader_std_done_cb, tl);
739
740         if (image_loader_start(tl->il))
741                 {
742                 return TRUE;
743                 }
744
745         image_loader_free(tl->il);
746         tl->il = NULL;
747         return FALSE;
748 }
749
750 /*
751  * Note: Currently local_cache only specifies where to save a _new_ thumb, if
752  *       a valid existing thumb is found anywhere the local thumb will not be created.
753  */
754 void thumb_loader_std_set_cache(ThumbLoaderStd *tl, gboolean enable_cache, gboolean local, gboolean retry_failed)
755 {
756         if (!tl) return;
757
758         tl->cache_enable = enable_cache;
759         tl->cache_local = local;
760         tl->cache_retry = retry_failed;
761 }
762
763 gboolean thumb_loader_std_start(ThumbLoaderStd *tl, FileData *fd)
764 {
765         static gchar *thumb_cache = NULL;
766         struct stat st;
767
768         if (!tl || !fd) return FALSE;
769
770         thumb_loader_std_reset(tl);
771
772
773         tl->fd = file_data_ref(fd);
774         if (!stat_utf8(fd->path, &st) || (tl->fd->format_class != FORMAT_CLASS_IMAGE && tl->fd->format_class != FORMAT_CLASS_RAWIMAGE && tl->fd->format_class != FORMAT_CLASS_VIDEO && tl->fd->format_class != FORMAT_CLASS_COLLECTION && tl->fd->format_class != FORMAT_CLASS_DOCUMENT && !options->file_filter.disable))
775                 {
776                 thumb_loader_std_set_fallback(tl);
777                 return FALSE;
778                 }
779         tl->source_mtime = st.st_mtime;
780         tl->source_size = st.st_size;
781         tl->source_mode = st.st_mode;
782
783         if (!thumb_cache)
784                 {
785                 thumb_cache = g_strdup(get_thumbnails_standard_cache_dir());
786                 }
787
788         if (strncmp(tl->fd->path, thumb_cache, strlen(thumb_cache)) != 0)
789                 {
790                 gchar *pathl;
791
792                 pathl = path_from_utf8(fd->path);
793                 tl->thumb_uri = g_filename_to_uri(pathl, NULL, NULL);
794                 tl->local_uri = filename_from_path(tl->thumb_uri);
795                 g_free(pathl);
796                 }
797
798         if (tl->cache_enable)
799                 {
800                 gint found;
801
802                 tl->thumb_path = thumb_loader_std_cache_path(tl, FALSE, NULL, FALSE);
803                 tl->thumb_path_local = FALSE;
804
805                 found = isfile(tl->thumb_path);
806                 if (found)
807                         {
808                         FileData *fd = file_data_new_no_grouping(tl->thumb_path);
809                         if (thumb_loader_std_setup(tl, fd))
810                                 {
811                                 file_data_unref(fd);
812                                 return TRUE;
813                                 }
814                         file_data_unref(fd);
815                         }
816
817                 if (thumb_loader_std_fail_check(tl) ||
818                     !thumb_loader_std_next_source(tl, found))
819                         {
820                         thumb_loader_std_set_fallback(tl);
821                         return FALSE;
822                         }
823                 return TRUE;
824                 }
825
826         if (!thumb_loader_std_setup(tl, tl->fd))
827                 {
828                 thumb_loader_std_save(tl, NULL);
829                 thumb_loader_std_set_fallback(tl);
830                 return FALSE;
831                 }
832
833         return TRUE;
834 }
835
836 void thumb_loader_std_free(ThumbLoaderStd *tl)
837 {
838         if (!tl) return;
839
840         thumb_loader_std_reset(tl);
841         g_free(tl);
842 }
843
844 GdkPixbuf *thumb_loader_std_get_pixbuf(ThumbLoaderStd *tl)
845 {
846         GdkPixbuf *pixbuf;
847
848         if (tl && tl->fd && tl->fd->thumb_pixbuf)
849                 {
850                 pixbuf = tl->fd->thumb_pixbuf;
851                 g_object_ref(pixbuf);
852                 }
853         else
854                 {
855                 pixbuf = pixbuf_fallback(NULL, tl->requested_width, tl->requested_height);
856                 }
857
858         return pixbuf;
859 }
860
861
862 typedef struct _ThumbValidate ThumbValidate;
863 struct _ThumbValidate
864 {
865         ThumbLoaderStd *tl;
866         gchar *path;
867         gint days;
868
869         void (*func_valid)(const gchar *path, gboolean valid, gpointer data);
870         gpointer data;
871
872         guint idle_id; /* event source id */
873 };
874
875 static void thumb_loader_std_thumb_file_validate_free(ThumbValidate *tv)
876 {
877         thumb_loader_std_free(tv->tl);
878         g_free(tv->path);
879         g_free(tv);
880 }
881
882 void thumb_loader_std_thumb_file_validate_cancel(ThumbLoaderStd *tl)
883 {
884         ThumbValidate *tv;
885
886         if (!tl) return;
887
888         tv = tl->data;
889
890         if (tv->idle_id)
891                 {
892                 g_source_remove(tv->idle_id);
893                 tv->idle_id = 0;
894                 }
895
896         thumb_loader_std_thumb_file_validate_free(tv);
897 }
898
899 static void thumb_loader_std_thumb_file_validate_finish(ThumbValidate *tv, gboolean valid)
900 {
901         if (tv->func_valid) tv->func_valid(tv->path, valid, tv->data);
902
903         thumb_loader_std_thumb_file_validate_free(tv);
904 }
905
906 static void thumb_loader_std_thumb_file_validate_done_cb(ThumbLoaderStd *tl, gpointer data)
907 {
908         ThumbValidate *tv = data;
909         GdkPixbuf *pixbuf;
910         gboolean valid = FALSE;
911
912         /* get the original thumbnail pixbuf (unrotated, with original options)
913            this is called from image_loader done callback, so tv->tl->il must exist*/
914         pixbuf = image_loader_get_pixbuf(tv->tl->il);
915         if (pixbuf)
916                 {
917                 const gchar *uri;
918                 const gchar *mtime_str;
919
920                 uri = gdk_pixbuf_get_option(pixbuf, THUMB_MARKER_URI);
921                 mtime_str = gdk_pixbuf_get_option(pixbuf, THUMB_MARKER_MTIME);
922                 if (uri && mtime_str)
923                         {
924                         if (strncmp(uri, "file:", strlen("file:")) == 0)
925                                 {
926                                 struct stat st;
927                                 gchar *target;
928
929                                 target = g_filename_from_uri(uri, NULL, NULL);
930                                 if (stat(target, &st) == 0 &&
931                                     st.st_mtime == strtol(mtime_str, NULL, 10))
932                                         {
933                                         valid = TRUE;
934                                         }
935                                 g_free(target);
936                                 }
937                         else
938                                 {
939                                 struct stat st;
940
941                                 DEBUG_1("thumb uri foreign, doing day check: %s", uri);
942
943                                 if (stat_utf8(tv->path, &st))
944                                         {
945                                         time_t now;
946
947                                         now = time(NULL);
948                                         if (st.st_atime >= now - (time_t)tv->days * 24 * 60 * 60)
949                                                 {
950                                                 valid = TRUE;
951                                                 }
952                                         }
953                                 }
954                         }
955                 else
956                         {
957                         DEBUG_1("invalid image found in std cache: %s", tv->path);
958                         }
959                 }
960
961         thumb_loader_std_thumb_file_validate_finish(tv, valid);
962 }
963
964 static void thumb_loader_std_thumb_file_validate_error_cb(ThumbLoaderStd *tl, gpointer data)
965 {
966         ThumbValidate *tv = data;
967
968         thumb_loader_std_thumb_file_validate_finish(tv, FALSE);
969 }
970
971 static gboolean thumb_loader_std_thumb_file_validate_idle_cb(gpointer data)
972 {
973         ThumbValidate *tv = data;
974
975         tv->idle_id = 0;
976         thumb_loader_std_thumb_file_validate_finish(tv, FALSE);
977
978         return FALSE;
979 }
980
981 ThumbLoaderStd *thumb_loader_std_thumb_file_validate(const gchar *thumb_path, gint allowed_days,
982                                                      void (*func_valid)(const gchar *path, gboolean valid, gpointer data),
983                                                      gpointer data)
984 {
985         ThumbValidate *tv;
986
987         tv = g_new0(ThumbValidate, 1);
988
989         tv->tl = thumb_loader_std_new(THUMB_SIZE_LARGE, THUMB_SIZE_LARGE);
990         thumb_loader_std_set_callbacks(tv->tl,
991                                        thumb_loader_std_thumb_file_validate_done_cb,
992                                        thumb_loader_std_thumb_file_validate_error_cb,
993                                        NULL,
994                                        tv);
995         thumb_loader_std_reset(tv->tl);
996
997         tv->path = g_strdup(thumb_path);
998         tv->days = allowed_days;
999         tv->func_valid = func_valid;
1000         tv->data = data;
1001
1002         FileData *fd = file_data_new_no_grouping(thumb_path);
1003         if (!thumb_loader_std_setup(tv->tl, fd))
1004                 {
1005                 tv->idle_id = g_idle_add(thumb_loader_std_thumb_file_validate_idle_cb, tv);
1006                 }
1007         else
1008                 {
1009                 tv->idle_id = 0;
1010                 }
1011
1012         file_data_unref(fd);
1013         return tv->tl;
1014 }
1015
1016 static void thumb_std_maint_remove_one(const gchar *source, const gchar *uri, gboolean local,
1017                                        const gchar *subfolder)
1018 {
1019         gchar *thumb_path;
1020
1021         thumb_path = thumb_std_cache_path(source,
1022                                           (local) ? filename_from_path(uri) : uri,
1023                                           local, subfolder);
1024         if (isfile(thumb_path))
1025                 {
1026                 DEBUG_1("thumb removing: %s", thumb_path);
1027                 unlink_file(thumb_path);
1028                 }
1029         g_free(thumb_path);
1030 }
1031
1032 /* this also removes local thumbnails (the source is gone so it makes sense) */
1033 void thumb_std_maint_removed(const gchar *source)
1034 {
1035         gchar *uri;
1036         gchar *sourcel;
1037
1038         sourcel = path_from_utf8(source);
1039         uri = g_filename_to_uri(sourcel, NULL, NULL);
1040         g_free(sourcel);
1041
1042         /* all this to remove a thumbnail? */
1043
1044         thumb_std_maint_remove_one(source, uri, FALSE, THUMB_FOLDER_NORMAL);
1045         thumb_std_maint_remove_one(source, uri, FALSE, THUMB_FOLDER_LARGE);
1046         thumb_std_maint_remove_one(source, uri, FALSE, THUMB_FOLDER_FAIL);
1047         thumb_std_maint_remove_one(source, uri, TRUE, THUMB_FOLDER_NORMAL);
1048         thumb_std_maint_remove_one(source, uri, TRUE, THUMB_FOLDER_LARGE);
1049
1050         g_free(uri);
1051 }
1052
1053 typedef struct _TMaintMove TMaintMove;
1054 struct _TMaintMove
1055 {
1056         gchar *source;
1057         gchar *dest;
1058
1059         ThumbLoaderStd *tl;
1060         gchar *source_uri;
1061         gchar *thumb_path;
1062
1063         gint pass;
1064 };
1065
1066 static GList *thumb_std_maint_move_list = NULL;
1067 static GList *thumb_std_maint_move_tail = NULL;
1068
1069
1070 static void thumb_std_maint_move_step(TMaintMove *tm);
1071 static gboolean thumb_std_maint_move_idle(gpointer data);
1072
1073
1074 static void thumb_std_maint_move_validate_cb(const gchar *path, gboolean valid, gpointer data)
1075 {
1076         TMaintMove *tm = data;
1077         GdkPixbuf *pixbuf;
1078
1079         /* get the original thumbnail pixbuf (unrotated, with original options)
1080            this is called from image_loader done callback, so tm->tl->il must exist*/
1081         pixbuf = image_loader_get_pixbuf(tm->tl->il);
1082         if (pixbuf)
1083                 {
1084                 const gchar *uri;
1085                 const gchar *mtime_str;
1086
1087                 uri = gdk_pixbuf_get_option(pixbuf, THUMB_MARKER_URI);
1088                 mtime_str = gdk_pixbuf_get_option(pixbuf, THUMB_MARKER_MTIME);
1089
1090                 if (uri && mtime_str && strcmp(uri, tm->source_uri) == 0)
1091                         {
1092                         gchar *pathl;
1093
1094                         /* The validation utility abuses ThumbLoader, and we
1095                          * abuse the utility just to load the thumbnail,
1096                          * but the loader needs to look sane for the save to complete.
1097                          */
1098
1099                         tm->tl->cache_enable = TRUE;
1100                         tm->tl->cache_hit = FALSE;
1101                         tm->tl->cache_local = FALSE;
1102                         file_data_unref(tm->tl->fd);
1103                         tm->tl->fd = file_data_new_group(tm->dest);
1104                         tm->tl->source_mtime = strtol(mtime_str, NULL, 10);
1105
1106                         pathl = path_from_utf8(tm->tl->fd->path);
1107                         g_free(tm->tl->thumb_uri);
1108                         tm->tl->thumb_uri = g_filename_to_uri(pathl, NULL, NULL);
1109                         tm->tl->local_uri = filename_from_path(tm->tl->thumb_uri);
1110                         g_free(pathl);
1111
1112                         g_free(tm->tl->thumb_path);
1113                         tm->tl->thumb_path = NULL;
1114                         tm->tl->thumb_path_local = FALSE;
1115
1116                         DEBUG_1("thumb move attempting save:");
1117
1118                         thumb_loader_std_save(tm->tl, pixbuf);
1119                         }
1120
1121                 DEBUG_1("thumb move unlink: %s", tm->thumb_path);
1122                 unlink_file(tm->thumb_path);
1123                 }
1124
1125         thumb_std_maint_move_step(tm);
1126 }
1127
1128 static void thumb_std_maint_move_step(TMaintMove *tm)
1129 {
1130         const gchar *folder;
1131
1132         tm->pass++;
1133         if (tm->pass > 2)
1134                 {
1135                 g_free(tm->source);
1136                 g_free(tm->dest);
1137                 g_free(tm->source_uri);
1138                 g_free(tm->thumb_path);
1139                 g_free(tm);
1140
1141                 if (thumb_std_maint_move_list)
1142                         {
1143                         g_idle_add_full(G_PRIORITY_LOW, thumb_std_maint_move_idle, NULL, NULL);
1144                         }
1145
1146                 return;
1147                 }
1148
1149         folder = (tm->pass == 1) ? THUMB_FOLDER_NORMAL : THUMB_FOLDER_LARGE;
1150
1151         g_free(tm->thumb_path);
1152         tm->thumb_path = thumb_std_cache_path(tm->source, tm->source_uri, FALSE, folder);
1153         tm->tl = thumb_loader_std_thumb_file_validate(tm->thumb_path, 0,
1154                                                       thumb_std_maint_move_validate_cb, tm);
1155 }
1156
1157 static gboolean thumb_std_maint_move_idle(gpointer data)
1158 {
1159         TMaintMove *tm;
1160         gchar *pathl;
1161
1162         if (!thumb_std_maint_move_list) return FALSE;
1163
1164         tm = thumb_std_maint_move_list->data;
1165
1166         thumb_std_maint_move_list = g_list_remove(thumb_std_maint_move_list, tm);
1167         if (!thumb_std_maint_move_list) thumb_std_maint_move_tail = NULL;
1168
1169         pathl = path_from_utf8(tm->source);
1170         tm->source_uri = g_filename_to_uri(pathl, NULL, NULL);
1171         g_free(pathl);
1172
1173         tm->pass = 0;
1174
1175         thumb_std_maint_move_step(tm);
1176
1177         return FALSE;
1178 }
1179
1180 /* This will schedule a move of the thumbnail for source image to dest when idle.
1181  * We do this so that file renaming or moving speed is not sacrificed by
1182  * moving the thumbnails at the same time because:
1183  *
1184  * This cache design requires the tedious task of loading the png thumbnails and saving them.
1185  *
1186  * The thumbnails are processed when the app is idle. If the app
1187  * exits early well too bad - they can simply be regenerated from scratch.
1188  */
1189 /** @FIXME This does not manage local thumbnails (fixme ?)
1190  */
1191 void thumb_std_maint_moved(const gchar *source, const gchar *dest)
1192 {
1193         TMaintMove *tm;
1194
1195         tm = g_new0(TMaintMove, 1);
1196         tm->source = g_strdup(source);
1197         tm->dest = g_strdup(dest);
1198
1199         if (!thumb_std_maint_move_list)
1200                 {
1201                 g_idle_add_full(G_PRIORITY_LOW, thumb_std_maint_move_idle, NULL, NULL);
1202                 }
1203
1204         if (thumb_std_maint_move_tail)
1205                 {
1206                 thumb_std_maint_move_tail = g_list_append(thumb_std_maint_move_tail, tm);
1207                 thumb_std_maint_move_tail = thumb_std_maint_move_tail->next;
1208                 }
1209         else
1210                 {
1211                 thumb_std_maint_move_list = g_list_append(thumb_std_maint_move_list, tm);
1212                 thumb_std_maint_move_tail = thumb_std_maint_move_list;
1213                 }
1214 }
1215 /* vim: set shiftwidth=8 softtabstop=0 cindent cinoptions={1s: */