simple cache for loaded pixbufs
[geeqie.git] / src / typedefs.h
1 /*
2  * Geeqie
3  * (C) 2006 John Ellis
4  * Copyright (C) 2008 The Geeqie Team
5  *
6  * Author: John Ellis
7  *
8  * This software is released under the GNU General Public License (GNU GPL).
9  * Please read the included file COPYING for more information.
10  * This software comes with no warranty of any kind, use at your own risk!
11  */
12
13
14 #ifndef TYPEDEFS_H
15 #define TYPEDEFS_H
16
17 typedef enum {
18         MOUSE_BUTTON_LEFT       = 1,
19         MOUSE_BUTTON_MIDDLE     = 2,
20         MOUSE_BUTTON_RIGHT      = 3,
21         MOUSE_BUTTON_WHEEL_UP   = 4,
22         MOUSE_BUTTON_WHEEL_DOWN = 5
23 } MouseButton;
24
25 typedef enum {
26         DIRVIEW_LIST,
27         DIRVIEW_TREE
28 } DirViewType;
29
30 typedef enum {
31         FILEVIEW_LIST,
32         FILEVIEW_ICON
33 } FileViewType;
34
35 typedef enum {
36         CMD_COPY = GQ_EDITOR_GENERIC_SLOTS,
37         CMD_MOVE,
38         CMD_RENAME,
39         CMD_DELETE,
40         CMD_FOLDER,
41         GQ_EDITOR_SLOTS
42 } SpecialEditor;
43
44 typedef enum {
45         SORT_NONE,
46         SORT_NAME,
47         SORT_SIZE,
48         SORT_TIME,
49         SORT_PATH,
50         SORT_NUMBER
51 } SortType;
52
53 typedef enum {
54         ALTER_NONE,             /* do nothing */
55         ALTER_ROTATE_90,
56         ALTER_ROTATE_90_CC,     /* counterclockwise */
57         ALTER_ROTATE_180,
58         ALTER_MIRROR,
59         ALTER_FLIP,
60         ALTER_DESATURATE
61 } AlterType;
62
63 typedef enum {
64         LAYOUT_HIDE   = 0,
65         LAYOUT_LEFT   = 1 << 0,
66         LAYOUT_RIGHT  = 1 << 1,
67         LAYOUT_TOP    = 1 << 2,
68         LAYOUT_BOTTOM = 1 << 3
69 } LayoutLocation;
70
71
72 typedef enum {
73         IMAGE_STATE_NONE        = 0,
74         IMAGE_STATE_IMAGE       = 1 << 0,
75         IMAGE_STATE_LOADING     = 1 << 1,
76         IMAGE_STATE_ERROR       = 1 << 2,
77         IMAGE_STATE_COLOR_ADJ   = 1 << 3,
78         IMAGE_STATE_ROTATE_AUTO = 1 << 4,
79         IMAGE_STATE_ROTATE_USER = 1 << 5,
80         IMAGE_STATE_DELAY_FLIP  = 1 << 6
81 } ImageState;
82
83 typedef enum {
84         SPLIT_NONE = 0,
85         SPLIT_VERT,
86         SPLIT_HOR,
87         SPLIT_QUAD,
88 } ImageSplitMode;
89
90 typedef enum {
91         FILEDATA_CHANGE_DELETE,
92         FILEDATA_CHANGE_MOVE,
93         FILEDATA_CHANGE_RENAME,
94         FILEDATA_CHANGE_COPY,
95         FILEDATA_CHANGE_UNSPECIFIED
96 } FileDataChangeType;
97
98 typedef enum {
99         MTS_MODE_MINUS,
100         MTS_MODE_SET,
101         MTS_MODE_OR,
102         MTS_MODE_AND
103 } MarkToSelectionMode;
104
105 typedef enum {
106         STM_MODE_RESET,
107         STM_MODE_SET,
108         STM_MODE_TOGGLE
109 } SelectionToMarkMode;
110
111 typedef enum {
112         FORMAT_CLASS_UNKNOWN,
113         FORMAT_CLASS_IMAGE,
114         FORMAT_CLASS_RAWIMAGE,
115         FORMAT_CLASS_META,
116         FILE_FORMAT_CLASSES
117 } FileFormatClass;
118
119 typedef enum {
120         SS_ERR_NONE = 0,
121         SS_ERR_DISABLED, /**< secsave is disabled. */
122         SS_ERR_OUT_OF_MEM, /**< memory allocation failure */
123
124         /* see err field in SecureSaveInfo */
125         SS_ERR_OPEN_READ,
126         SS_ERR_OPEN_WRITE,
127         SS_ERR_STAT,
128         SS_ERR_ACCESS,
129         SS_ERR_MKSTEMP,
130         SS_ERR_RENAME,
131         SS_ERR_OTHER,
132 } SecureSaveErrno;
133
134 typedef enum {
135         NOTIFY_PRIORITY_HIGH = 0,
136         NOTIFY_PRIORITY_MEDIUM,
137         NOTIFY_PRIORITY_LOW
138 } NotifyPriority;
139         
140 typedef enum {
141         NOTIFY_TYPE_INTERNAL = 0, /* changed internal data only, like marks */
142         NOTIFY_TYPE_REREAD,       /* changed file size, date, etc., file name remains unchanged */
143         NOTIFY_TYPE_CHANGE        /* generic change described by fd->change */
144 } NotifyType;
145
146
147 #define MAX_SPLIT_IMAGES 4
148
149 typedef struct _ImageLoader ImageLoader;
150 typedef struct _ThumbLoader ThumbLoader;
151
152 typedef struct _CollectInfo CollectInfo;
153 typedef struct _CollectionData CollectionData;
154 typedef struct _CollectTable CollectTable;
155 typedef struct _CollectWindow CollectWindow;
156
157 typedef struct _ImageWindow ImageWindow;
158
159 typedef struct _FileData FileData;
160 typedef struct _FileDataChangeInfo FileDataChangeInfo;
161
162 typedef struct _LayoutWindow LayoutWindow;
163
164 typedef struct _ViewDir ViewDir;
165 typedef struct _ViewDirInfoList ViewDirInfoList;
166 typedef struct _ViewDirInfoTree ViewDirInfoTree;
167
168 typedef struct _ViewFile ViewFile;
169 typedef struct _ViewFileInfoList ViewFileInfoList;
170 typedef struct _ViewFileInfoIcon ViewFileInfoIcon;
171
172 typedef struct _SlideShowData SlideShowData;
173 typedef struct _FullScreenData FullScreenData;
174
175 typedef struct _PixmapFolders PixmapFolders;
176 typedef struct _Histogram Histogram;
177
178 typedef struct _SecureSaveInfo SecureSaveInfo;
179
180 typedef struct _ExifData ExifData;
181
182 typedef struct _Editor Editor;
183 struct _Editor {
184         gchar *name;
185         gchar *command;
186 };
187
188 struct _ImageLoader
189 {
190         GdkPixbuf *pixbuf;
191         FileData *fd;
192         gchar *path;
193
194         gint bytes_read;
195         gint bytes_total;
196
197         gint requested_width;
198         gint requested_height;
199         gint shrunk;
200
201         gint done;
202         gint idle_id;
203         gint idle_priority;
204
205         GdkPixbufLoader *loader;
206         gint load_fd;
207
208         void (*func_area_ready)(ImageLoader *, guint x, guint y, guint w, guint h, gpointer);
209         void (*func_error)(ImageLoader *, gpointer);
210         void (*func_done)(ImageLoader *, gpointer);
211         void (*func_percent)(ImageLoader *, gdouble, gpointer);
212
213         gpointer data_area_ready;
214         gpointer data_error;
215         gpointer data_done;
216         gpointer data_percent;
217
218         gint idle_done_id;
219
220         guchar *read_buffer;
221         gint read_buffer_size;
222         gint idle_read_loop_count;
223 };
224
225 typedef void (* ThumbLoaderFunc)(ThumbLoader *tl, gpointer data);
226
227 struct _ThumbLoader
228 {
229         gint standard_loader;
230
231         ImageLoader *il;
232         FileData *fd;           /* fd->pixbuf contains final (scaled) image when done */
233
234         gint cache_enable;
235         gint cache_hit;
236         gdouble percent_done;
237
238         gint max_w;
239         gint max_h;
240
241         ThumbLoaderFunc func_done;
242         ThumbLoaderFunc func_error;
243         ThumbLoaderFunc func_progress;
244
245         gpointer data;
246
247         gint idle_done_id;
248 };
249
250 struct _CollectInfo
251 {
252         FileData *fd;
253         GdkPixbuf *pixbuf;
254         guint flag_mask;
255 };
256
257 struct _CollectionData
258 {
259         gchar *path;
260         gchar *name;
261         GList *list;
262         SortType sort_method;
263
264         ThumbLoader *thumb_loader;
265         CollectInfo *thumb_info;
266
267         void (*info_updated_func)(CollectionData *, CollectInfo *, gpointer);
268         gpointer info_updated_data;
269
270         gint ref;
271
272         /* geometry */
273         gint window_read;
274         gint window_x;
275         gint window_y;
276         gint window_w;
277         gint window_h;
278
279         /* contents changed since save flag */
280         gint changed;
281
282         GHashTable *existence;
283 };
284
285 struct _CollectTable
286 {
287         GtkWidget *scrolled;
288         GtkWidget *listview;
289         gint columns;
290         gint rows;
291
292         CollectionData *cd;
293
294         GList *selection;
295         CollectInfo *prev_selection;
296
297         CollectInfo *click_info;
298
299         GtkWidget *tip_window;
300         gint tip_delay_id;
301         CollectInfo *tip_info;
302
303         GdkWindow *marker_window;
304         CollectInfo *marker_info;
305
306         GtkWidget *status_label;
307         GtkWidget *extra_label;
308
309         gint focus_row;
310         gint focus_column;
311         CollectInfo *focus_info;
312
313         GtkWidget *popup;
314         CollectInfo *drop_info;
315         GList *drop_list;
316
317         gint sync_idle_id;
318         gint drop_idle_id;
319
320         gint show_text;
321 };
322
323 struct _CollectWindow
324 {
325         GtkWidget *window;
326         CollectTable *table;
327         GtkWidget *status_box;
328         GList *list;
329
330         GtkWidget *close_dialog;
331
332         CollectionData *cd;
333 };
334
335 typedef gint (* ImageTileRequestFunc)(ImageWindow *imd, gint x, gint y,
336                                       gint width, gint height, GdkPixbuf *pixbuf, gpointer);
337 typedef void (* ImageTileDisposeFunc)(ImageWindow *imd, gint x, gint y,
338                                       gint width, gint height, GdkPixbuf *pixbuf, gpointer);
339
340 struct _ImageWindow
341 {
342         GtkWidget *widget;      /* use this to add it and show it */
343         GtkWidget *pr;
344         GtkWidget *frame;
345
346         FileData *image_fd;
347
348         gint64 size;            /* file size (bytes) */
349         time_t mtime;           /* file modified time stamp */
350         gint unknown;           /* failed to load image */
351
352         ImageLoader *il;        /* FIXME - image loader should probably go to FileData, but it must first support
353                                    sending callbacks to multiple ImageWindows in parallel */
354
355         gint has_frame;
356
357         /* top level (not necessarily parent) window */
358         gint top_window_sync;   /* resize top_window when image dimensions change */
359         GtkWidget *top_window;  /* window that gets title, and window to resize when 'fitting' */
360         gchar *title;           /* window title to display left of file name */
361         gchar *title_right;     /* window title to display right of file name */
362         gint title_show_zoom;   /* option to include zoom in window title */
363
364         gint completed;
365         ImageState state;       /* mask of IMAGE_STATE_* flags about current image */
366
367         void (*func_update)(ImageWindow *imd, gpointer data);
368         void (*func_complete)(ImageWindow *imd, gint preload, gpointer data);
369         void (*func_state)(ImageWindow *imd, ImageState state, gpointer data);
370         ImageTileRequestFunc func_tile_request;
371         ImageTileDisposeFunc func_tile_dispose;
372
373         gpointer data_update;
374         gpointer data_complete;
375         gpointer data_state;
376         gpointer data_tile;
377
378         /* button, scroll functions */
379         void (*func_button)(ImageWindow *, gint button,
380                             guint32 time, gdouble x, gdouble y, guint state, gpointer);
381         void (*func_drag)(ImageWindow *, gint button,
382                             guint32 time, gdouble x, gdouble y, guint state, gdouble dx, gdouble dy,gpointer);
383         void (*func_scroll)(ImageWindow *, GdkScrollDirection direction,
384                             guint32 time, gdouble x, gdouble y, guint state, gpointer);
385
386         gpointer data_button;
387         gpointer data_drag;
388         gpointer data_scroll;
389
390         /* scroll notification (for scroll bar implementation) */
391         void (*func_scroll_notify)(ImageWindow *, gint x, gint y, gint width, gint height, gpointer);
392
393         gpointer data_scroll_notify;
394
395         /* collection info */
396         CollectionData *collection;
397         CollectInfo *collection_info;
398
399         /* color profiles */
400         gint color_profile_enable;
401         gint color_profile_input;
402         gint color_profile_screen;
403         gint color_profile_use_image;
404         gint color_profile_from_image;
405         gpointer cm;
406
407         AlterType delay_alter_type;
408
409         FileData *read_ahead_fd;
410         ImageLoader *read_ahead_il;
411
412         gint prev_color_row;
413
414         gint auto_refresh_id;
415         gint auto_refresh_interval;
416
417         gint delay_flip;
418         gint orientation;
419         gint desaturate;
420
421         gint overlay_show_zoom; /* set to true if overlay is showing zoom ratio */
422 };
423
424 #define FILEDATA_MARKS_SIZE 6
425
426 struct _FileDataChangeInfo {
427         FileDataChangeType type;
428         gchar *source;
429         gchar *dest;
430 };
431
432 struct _FileData {
433         gint magick;
434         gint type;
435         gchar *original_path; /* key to file_data_pool hash table */
436         gchar *path;
437         const gchar *name;
438         const gchar *extension;
439         gchar *collate_key_name;
440         gchar *collate_key_name_nocase;
441         gint64 size;
442         time_t date;
443         guint marks;
444         GList *sidecar_files;
445         FileData *parent; /* parent file if this is a sidecar file, NULL otherwise */
446         FileDataChangeInfo *change; /* for rename, move ... */
447         GdkPixbuf *thumb_pixbuf;
448
449         GdkPixbuf *pixbuf; /* full-size image */
450
451         gint ref;
452         gint version; /* increased when any field in this structure is changed */
453         gint user_orientation;
454         gint exif_orientation;
455         
456         ExifData *exif;
457 };
458
459 struct _LayoutWindow
460 {
461         FileData *dir_fd;
462
463         /* base */
464
465         GtkWidget *window;
466
467         GtkWidget *main_box;
468
469         GtkWidget *group_box;
470         GtkWidget *h_pane;
471         GtkWidget *v_pane;
472
473         /* menus, path selector */
474
475         GtkActionGroup *action_group;
476         GtkUIManager *ui_manager;
477
478         GtkWidget *path_entry;
479
480         /* image */
481
482         LayoutLocation image_location;
483
484         ImageWindow *image;
485
486         ImageWindow *split_images[MAX_SPLIT_IMAGES];
487         ImageSplitMode split_mode;
488         gint active_split_image;
489
490         GtkWidget *split_image_widget;
491         GtkSizeGroup *split_image_sizegroup;
492
493         gint connect_zoom, connect_scroll;
494
495         /* tools window (float) */
496
497         GtkWidget *tools;
498         GtkWidget *tools_pane;
499
500         gint tools_float;
501         gint tools_hidden;
502
503         /* toolbar */
504
505         GtkWidget *toolbar;
506         gint toolbar_hidden;
507
508         GtkWidget *thumb_button;
509         gint thumbs_enabled;
510         gint marks_enabled;
511
512         /* dir view */
513
514         LayoutLocation dir_location;
515
516         ViewDir *vd;
517         GtkWidget *dir_view;
518
519         DirViewType dir_view_type;
520
521         /* file view */
522
523         LayoutLocation file_location;
524
525         ViewFile *vf;
526         FileViewType file_view_type;
527
528         GtkWidget *file_view;
529
530         SortType sort_method;
531         gint sort_ascend;
532
533         /* status bar */
534
535         GtkWidget *info_box;
536         GtkWidget *info_progress_bar;
537         GtkWidget *info_sort;
538         GtkWidget *info_color;
539         GtkWidget *info_status;
540         GtkWidget *info_details;
541         GtkWidget *info_zoom;
542
543         /* slide show */
544
545         SlideShowData *slideshow;
546
547         /* full screen */
548
549         FullScreenData *full_screen;
550
551         /* dividers */
552
553         gint div_h;
554         gint div_v;
555         gint div_float;
556
557         /* misc */
558
559         GtkWidget *utility_box;
560         GtkWidget *bar_sort;
561         GtkWidget *bar_exif;
562         GtkWidget *bar_info;
563
564         gint bar_sort_enabled;
565         gint bar_exif_enabled;
566         gint bar_info_enabled;
567
568         gint bar_exif_width;
569         gint bar_exif_advanced;
570         gint bar_info_width;
571 };
572
573 struct _ViewDir
574 {
575         DirViewType type;
576         gpointer info;
577
578         GtkWidget *widget;
579         GtkWidget *view;
580
581         FileData *dir_fd;
582
583         FileData *click_fd;
584
585         FileData *drop_fd;
586         GList *drop_list;
587         gint drop_scroll_id;
588
589         /* func list */
590         void (*select_func)(ViewDir *vd, const gchar *path, gpointer data);
591         gpointer select_data;
592
593         void (*dnd_drop_update_func)(ViewDir *vd);
594         void (*dnd_drop_leave_func)(ViewDir *vd);
595
596         LayoutWindow *layout;
597
598         GtkWidget *popup;
599
600         PixmapFolders *pf;
601 };
602
603 struct _ViewDirInfoList
604 {
605         GList *list;
606 };
607
608 struct _ViewDirInfoTree
609 {
610         gint drop_expand_id;
611         gint busy_ref;
612 };
613
614
615 struct _ViewFile
616 {
617         FileViewType type;
618         gpointer info;
619
620         GtkWidget *widget;
621         GtkWidget *listview;
622
623         FileData *dir_fd;
624         GList *list;
625
626         SortType sort_method;
627         gint sort_ascend;
628
629         /* func list */
630         void (*func_thumb_status)(ViewFile *vf, gdouble val, const gchar *text, gpointer data);
631         gpointer data_thumb_status;
632
633         void (*func_status)(ViewFile *vf, gpointer data);
634         gpointer data_status;
635
636         LayoutWindow *layout;
637
638         GtkWidget *popup;
639
640         /* thumbs updates*/
641         gint thumbs_running;
642         ThumbLoader *thumbs_loader;
643         FileData *thumbs_filedata;
644
645         /* marks */
646         gint marks_enabled;
647         gint active_mark;
648         gint clicked_mark;
649         
650         /* refresh */
651         gint refresh_idle_id;
652 };
653
654 struct _ViewFileInfoList
655 {
656         FileData *click_fd;
657         FileData *select_fd;
658
659         gint thumbs_enabled;
660
661         gint select_idle_id;
662 };
663
664 struct _IconData;
665
666 struct _ViewFileInfoIcon
667 {
668         /* table stuff */
669         gint columns;
670         gint rows;
671
672         GList *selection;
673         struct _IconData *prev_selection;
674
675         GtkWidget *tip_window;
676         gint tip_delay_id;
677         struct _IconData *tip_id;
678
679         struct _IconData *click_id;
680
681         struct _IconData *focus_id;
682         gint focus_row;
683         gint focus_column;
684
685         gint show_text;
686 };
687
688 struct _SlideShowData
689 {
690         ImageWindow *imd;
691
692         GList *filelist;
693         CollectionData *cd;
694         FileData *dir_fd;
695         LayoutWindow *layout;
696
697         GList *list;
698         GList *list_done;
699
700         FileData *slide_fd;
701
702         guint slide_count;
703         gint timeout_id;
704
705         gint from_selection;
706
707         void (*stop_func)(SlideShowData *, gpointer);
708         gpointer stop_data;
709
710         gint paused;
711 };
712
713 struct _FullScreenData
714 {
715         GtkWidget *window;
716         ImageWindow *imd;
717
718         GtkWidget *normal_window;
719         ImageWindow *normal_imd;
720
721         gint hide_mouse_id;
722         gint busy_mouse_id;
723         gint cursor_state;
724
725         gint saver_block_id;
726
727         void (*stop_func)(FullScreenData *, gpointer);
728         gpointer stop_data;
729 };
730
731 struct _PixmapFolders
732 {
733         GdkPixbuf *close;
734         GdkPixbuf *open;
735         GdkPixbuf *deny;
736         GdkPixbuf *parent;
737 };
738
739 struct _SecureSaveInfo {
740         FILE *fp; /**< file stream pointer */
741         gchar *file_name; /**< final file name */
742         gchar *tmp_file_name; /**< temporary file name */
743         gint err; /**< set to non-zero value in case of error */
744         gint secure_save; /**< use secure save for this file, internal use only */
745         gint preserve_perms; /**< whether to preserve perms, TRUE by default */
746         gint preserve_mtime; /**< whether to preserve mtime, FALSE by default */
747         gint unlink_on_error; /**< whether to remove temporary file on save failure, TRUE by default */
748 };
749
750
751 #endif