2 * Copyright (C) 2006 John Ellis
3 * Copyright (C) 2008 - 2016 The Geeqie Team
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.
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.
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.
26 ZOOM_RESET_ORIGINAL = 0,
27 ZOOM_RESET_FIT_WINDOW = 1,
36 enum ClipboardDestination {
37 CLIPBOARD_TEXT_PLAIN = 0,
38 CLIPBOARD_TEXT_URI_LIST = 1,
39 CLIPBOARD_X_SPECIAL_GNOME_COPIED_FILES = 2,
40 CLIPBOARD_UTF8_STRING = 3
43 enum ClipboardSelection {
44 CLIPBOARD_PRIMARY = 0,
45 CLIPBOARD_CLIPBOARD = 1,
50 MOUSE_BUTTON_LEFT = 1,
51 MOUSE_BUTTON_MIDDLE = 2,
52 MOUSE_BUTTON_RIGHT = 3,
53 MOUSE_BUTTON_WHEEL_UP = 4,
54 MOUSE_BUTTON_WHEEL_DOWN = 5,
63 DIRVIEW_LAST = DIRVIEW_TREE /**< Keep this up to date! */
70 FILEVIEW_LAST = FILEVIEW_ICON /**< Keep this up to date! */
73 #define CMD_COPY "geeqie-copy-command.desktop"
74 #define CMD_MOVE "geeqie-move-command.desktop"
75 #define CMD_RENAME "geeqie-rename-command.desktop"
76 #define CMD_DELETE "geeqie-delete-command.desktop"
77 #define CMD_FOLDER "geeqie-folder-command.desktop"
88 SORT_EXIFTIMEDIGITIZED,
95 * drag and drop default action
104 ALTER_NONE, /**< do nothing */
106 ALTER_ROTATE_90_CC, /**< counterclockwise */
112 enum LayoutLocation {
114 LAYOUT_LEFT = 1 << 0,
115 LAYOUT_RIGHT = 1 << 1,
117 LAYOUT_BOTTOM = 1 << 3
122 IMAGE_STATE_NONE = 0,
123 IMAGE_STATE_IMAGE = 1 << 0,
124 IMAGE_STATE_LOADING = 1 << 1,
125 IMAGE_STATE_ERROR = 1 << 2,
126 IMAGE_STATE_COLOR_ADJ = 1 << 3,
127 IMAGE_STATE_ROTATE_AUTO = 1 << 4,
128 IMAGE_STATE_ROTATE_USER = 1 << 5,
129 IMAGE_STATE_DELAY_FLIP = 1 << 6
132 enum ImageSplitMode {
140 enum FileDataChangeType {
141 FILEDATA_CHANGE_DELETE,
142 FILEDATA_CHANGE_MOVE,
143 FILEDATA_CHANGE_RENAME,
144 FILEDATA_CHANGE_COPY,
145 FILEDATA_CHANGE_UNSPECIFIED,
146 FILEDATA_CHANGE_WRITE_METADATA
149 enum MarkToSelectionMode {
156 enum SelectionToMarkMode {
162 enum FileFormatClass {
163 FORMAT_CLASS_UNKNOWN,
165 FORMAT_CLASS_RAWIMAGE,
168 FORMAT_CLASS_COLLECTION,
169 FORMAT_CLASS_DOCUMENT,
170 FORMAT_CLASS_ARCHIVE,
174 extern const gchar *format_class_list[]; /**< defined in preferences.cc */
177 * @enum SecureSaveErrno
178 * see err field in #SecureSaveInfo
180 enum SecureSaveErrno {
182 SS_ERR_DISABLED, /**< secsave is disabled. */
183 SS_ERR_OUT_OF_MEM, /**< memory allocation failure */
194 enum NotifyPriority {
195 NOTIFY_PRIORITY_HIGH = 0,
196 NOTIFY_PRIORITY_MEDIUM,
201 NOTIFY_MARKS = 1 << 1, /**< changed marks */
202 NOTIFY_PIXBUF = 1 << 2, /**< image was read into fd->pixbuf */
203 NOTIFY_HISTMAP = 1 << 3, /**< histmap was read into fd->histmap */
204 NOTIFY_ORIENTATION = 1 << 4, /**< image was rotated */
205 NOTIFY_METADATA = 1 << 5, /**< changed image metadata, not yet written */
206 NOTIFY_GROUPING = 1 << 6, /**< change in fd->sidecar_files or fd->parent */
207 NOTIFY_REREAD = 1 << 7, /**< changed file size, date, etc., file name remains unchanged */
208 NOTIFY_CHANGE = 1 << 8 /**< generic change described by fd->change */
213 CHANGE_WARN_DEST_EXISTS = 1 << 0,
214 CHANGE_WARN_NO_WRITE_PERM = 1 << 1,
215 CHANGE_WARN_SAME = 1 << 2,
216 CHANGE_WARN_CHANGED_EXT = 1 << 3,
217 CHANGE_WARN_UNSAVED_META = 1 << 4,
218 CHANGE_WARN_NO_WRITE_PERM_DEST_DIR = 1 << 5,
219 CHANGE_ERROR_MASK = ~0xff, /**< the values below are fatal errors */
220 CHANGE_NO_READ_PERM = 1 << 8,
221 CHANGE_NO_WRITE_PERM_DIR = 1 << 9,
222 CHANGE_NO_DEST_DIR = 1 << 10,
223 CHANGE_DUPLICATE_DEST = 1 << 11,
224 CHANGE_NO_WRITE_PERM_DEST = 1 << 12,
225 CHANGE_DEST_EXISTS = 1 << 13,
226 CHANGE_NO_SRC = 1 << 14,
227 CHANGE_GENERIC_ERROR = 1 << 16
230 enum MetadataFormat {
231 METADATA_PLAIN = 0, /**< format that can be edited and written back */
232 METADATA_FORMATTED = 1 /**< for display only */
236 STARTUP_PATH_CURRENT = 0,
247 enum PixbufRendererStereoMode {
248 PR_STEREO_NONE = 0, /**< do nothing */
249 PR_STEREO_DUAL = 1 << 0, /**< independent stereo buffers, for example nvidia opengl */
250 PR_STEREO_FIXED = 1 << 1, /**< custom position */
251 PR_STEREO_HORIZ = 1 << 2, /**< side by side */
252 PR_STEREO_VERT = 1 << 3, /**< above below */
253 PR_STEREO_RIGHT = 1 << 4, /**< render right buffer */
254 PR_STEREO_ANAGLYPH_RC = 1 << 5, /**< anaglyph red-cyan */
255 PR_STEREO_ANAGLYPH_GM = 1 << 6, /**< anaglyph green-magenta */
256 PR_STEREO_ANAGLYPH_YB = 1 << 7, /**< anaglyph yellow-blue */
257 PR_STEREO_ANAGLYPH_GRAY_RC = 1 << 8, /**< anaglyph gray red-cyan*/
258 PR_STEREO_ANAGLYPH_GRAY_GM = 1 << 9, /**< anaglyph gray green-magenta */
259 PR_STEREO_ANAGLYPH_GRAY_YB = 1 << 10, /**< anaglyph gray yellow-blue */
260 PR_STEREO_ANAGLYPH_DB_RC = 1 << 11, /**< anaglyph dubois red-cyan */
261 PR_STEREO_ANAGLYPH_DB_GM = 1 << 12, /**< anaglyph dubois green-magenta */
262 PR_STEREO_ANAGLYPH_DB_YB = 1 << 13, /**< anaglyph dubois yellow-blue */
263 PR_STEREO_ANAGLYPH = PR_STEREO_ANAGLYPH_RC |
264 PR_STEREO_ANAGLYPH_GM |
265 PR_STEREO_ANAGLYPH_YB |
266 PR_STEREO_ANAGLYPH_GRAY_RC |
267 PR_STEREO_ANAGLYPH_GRAY_GM |
268 PR_STEREO_ANAGLYPH_GRAY_YB |
269 PR_STEREO_ANAGLYPH_DB_RC |
270 PR_STEREO_ANAGLYPH_DB_GM |
271 PR_STEREO_ANAGLYPH_DB_YB, /**< anaglyph mask */
273 PR_STEREO_MIRROR_LEFT = 1 << 14, /**< mirror */
274 PR_STEREO_FLIP_LEFT = 1 << 15, /**< flip */
276 PR_STEREO_MIRROR_RIGHT = 1 << 16, /**< mirror */
277 PR_STEREO_FLIP_RIGHT = 1 << 17, /**< flip */
279 PR_STEREO_MIRROR = PR_STEREO_MIRROR_LEFT | PR_STEREO_MIRROR_RIGHT, /**< mirror mask*/
280 PR_STEREO_FLIP = PR_STEREO_FLIP_LEFT | PR_STEREO_FLIP_RIGHT, /**< flip mask*/
281 PR_STEREO_SWAP = 1 << 18, /**< swap left and right buffers */
282 PR_STEREO_TEMP_DISABLE = 1 << 19, /**< temporarily disable stereo mode if source image is not stereo */
283 PR_STEREO_HALF = 1 << 20
286 enum StereoPixbufData {
287 STEREO_PIXBUF_DEFAULT = 0,
288 STEREO_PIXBUF_SBS = 1,
289 STEREO_PIXBUF_CROSS = 2,
290 STEREO_PIXBUF_NONE = 3
294 BAR_SORT_MODE_FOLDER = 0,
295 BAR_SORT_MODE_COLLECTION,
299 enum SortActionType {
303 BAR_SORT_ACTION_COUNT
306 enum SortSelectionType {
307 BAR_SORT_SELECTION_IMAGE = 0,
308 BAR_SORT_SELECTION_SELECTED,
309 BAR_SORT_SELECTION_COUNT
312 #define MAX_SPLIT_IMAGES 4
316 SELECTION_SELECTED = 1 << 0,
317 SELECTION_PRELIGHT = 1 << 1,
318 SELECTION_FOCUS = 1 << 2
324 struct AnimationData;
327 struct CollectionData;
329 struct CollectWindow;
334 struct FileDataChangeInfo;
337 struct LayoutOptions;
340 struct ViewDirInfoList;
341 struct ViewDirInfoTree;
344 struct ViewFileInfoList;
345 struct ViewFileInfoIcon;
347 struct SlideShowData;
348 struct FullScreenData;
350 struct PixmapFolders;
354 struct SecureSaveInfo;
358 struct EditorDescription;
363 gint histogram_channel; /**< drawing mode for histogram */
364 gint histogram_mode; /**< logarithmical or not */
365 guint vgrid; /**< number of vertical divisions, 0 for none */
366 guint hgrid; /**< number of horizontal divisions, 0 for none */
372 } grid_color; /**< grid color */
380 using ThumbLoaderFunc = void (*)(ThumbLoader *, gpointer);
382 using FileUtilDoneFunc = void (*)(gboolean, const gchar *, gpointer);
386 gboolean standard_loader;
389 FileData *fd; /**< fd->pixbuf contains final (scaled) image when done */
391 gboolean cache_enable;
393 gdouble percent_done;
398 ThumbLoaderFunc func_done;
399 ThumbLoaderFunc func_error;
400 ThumbLoaderFunc func_progress;
404 guint idle_done_id; /**< event source id */
411 GdkPixbufAnimation *gpa;
412 GdkPixbufAnimationIter *iter;
417 GCancellable *cancellable;
419 GFileInputStream *gfstream;
429 struct CollectionData
434 SortType sort_method;
436 ThumbLoader *thumb_loader;
437 CollectInfo *thumb_info;
439 void (*info_updated_func)(CollectionData *, CollectInfo *, gpointer);
440 gpointer info_updated_data;
451 gboolean changed; /**< contents changed since save flag */
453 GHashTable *existence;
455 GtkWidget *dialog_name_entry;
456 gchar *collection_path; /**< Full path to collection including extension */
457 gint collection_append_index;
470 CollectInfo *prev_selection;
472 CollectInfo *click_info;
474 GtkWidget *tip_window;
475 guint tip_delay_id; /**< event source id */
476 CollectInfo *tip_info;
478 GdkWindow *marker_window;
479 CollectInfo *marker_info;
481 GtkWidget *status_label;
482 GtkWidget *extra_label;
486 CollectInfo *focus_info;
489 CollectInfo *drop_info;
492 guint sync_idle_id; /**< event source id */
493 guint drop_idle_id; /**< event source id */
498 GList *editmenu_fd_list; /**< file list for edit menu */
505 GtkWidget *status_box;
507 GtkWidget *close_dialog;
512 using ImageTileRequestFunc = gint (*)(ImageWindow *, gint, gint, gint, gint, GdkPixbuf *, gpointer);
513 using ImageTileDisposeFunc = void (*)(ImageWindow *, gint, gint, gint, gint, GdkPixbuf *, gpointer);
517 GtkWidget *widget; /**< use this to add it and show it */
523 gboolean unknown; /**< failed to load image */
525 ImageLoader *il; /**< @FIXME image loader should probably go to FileData, but it must first support
526 sending callbacks to multiple ImageWindows in parallel */
528 gint has_frame; /**< not boolean, see image_new() */
530 /* top level (not necessarily parent) window */
531 gboolean top_window_sync; /**< resize top_window when image dimensions change */
532 GtkWidget *top_window; /**< window that gets title, and window to resize when 'fitting' */
533 gchar *title; /**< window title to display left of file name */
534 gchar *title_right; /**< window title to display right of file name */
535 gboolean title_show_zoom; /**< option to include zoom in window title */
538 ImageState state; /**< mask of IMAGE_STATE_* flags about current image */
540 void (*func_update)(ImageWindow *imd, gpointer data);
541 void (*func_complete)(ImageWindow *imd, gint preload, gpointer data);
542 void (*func_state)(ImageWindow *imd, ImageState state, gpointer data);
543 ImageTileRequestFunc func_tile_request;
544 ImageTileDisposeFunc func_tile_dispose;
546 gpointer data_update;
547 gpointer data_complete;
551 /* button, scroll functions */
552 void (*func_button)(ImageWindow *, GdkEventButton *event, gpointer);
553 void (*func_drag)(ImageWindow *, GdkEventMotion *event, gdouble dx, gdouble dy, gpointer);
554 void (*func_scroll)(ImageWindow *, GdkEventScroll *event, gpointer);
555 void (*func_focus_in)(ImageWindow *, gpointer);
557 gpointer data_button;
559 gpointer data_scroll;
560 gpointer data_focus_in;
563 * @headerfile func_scroll_notify
564 * scroll notification (for scroll bar implementation)
566 void (*func_scroll_notify)(ImageWindow *, gint x, gint y, gint width, gint height, gpointer);
568 gpointer data_scroll_notify;
570 /* collection info */
571 CollectionData *collection;
572 CollectInfo *collection_info;
575 gboolean color_profile_enable;
576 gint color_profile_input;
577 gboolean color_profile_use_image;
578 gint color_profile_from_image;
581 AlterType delay_alter_type;
583 FileData *read_ahead_fd;
584 ImageLoader *read_ahead_il;
588 gboolean auto_refresh;
593 gboolean overunderexposed;
596 gboolean mouse_wheel_mode;
599 #define FILEDATA_MARKS_SIZE 10
601 struct FileDataChangeInfo {
602 FileDataChangeType type;
606 gboolean regroup_when_finished;
612 gchar *original_path; /**< key to file_data_pool hash table */
615 const gchar *extension;
616 gchar *extended_extension;
617 FileFormatClass format_class;
618 gchar *format_name; /**< set by the image loader */
619 gchar *collate_key_name;
620 gchar *collate_key_name_nocase;
621 gchar *collate_key_name_natural;
622 gchar *collate_key_name_nocase_natural;
626 mode_t mode; /**< this is needed at least for notification in view_dir because it is preserved after the file/directory is deleted */
627 gint sidecar_priority;
629 guint marks; /**< each bit represents one mark */
630 guint valid_marks; /**< zero bit means that the corresponding mark needs to be reread */
633 GList *sidecar_files;
634 FileData *parent; /**< parent file if this is a sidecar file, NULL otherwise */
635 FileDataChangeInfo *change; /**< for rename, move ... */
636 GdkPixbuf *thumb_pixbuf;
638 GdkPixbuf *pixbuf; /**< full-size image, only complete images, NULL during loading
639 all FileData with non-NULL pixbuf are referenced by image_cache */
645 gint version; /**< increased when any field in this structure is changed */
646 gboolean disable_grouping;
648 gint user_orientation;
649 gint exif_orientation;
653 time_t exifdate_digitized;
654 GHashTable *modified_xmp; /**< hash table which contains unwritten xmp metadata in format: key->list of string values */
655 GList *cached_metadata;
657 gboolean metadata_in_idle_loaded;
663 SelectionType selected; /**< Used by view-file-icon. */
676 DirViewType dir_view_type;
677 FileViewType file_view_type;
682 gboolean case_sensitive;
683 } dir_view_list_sort;
688 gboolean case_sensitive;
689 } file_view_list_sort;
691 gboolean show_thumbnails;
693 gboolean show_file_filter;
694 gboolean show_directory_date;
695 gboolean show_info_pixel;
696 gboolean split_pane_sync;
697 gboolean ignore_alpha;
728 gint histogram_channel;
745 } preferences_window;
766 } advanced_exif_window;
768 gboolean tools_float;
769 gboolean tools_hidden;
770 gboolean toolbar_hidden;
775 gboolean tools_float;
776 gboolean tools_hidden;
783 StartUpPath startup_path;
788 SortActionType action;
790 SortSelectionType selection;
796 LayoutOptions options;
806 GtkWidget *group_box;
810 /* menus, path selector */
812 GtkActionGroup *action_group;
813 GtkActionGroup *action_group_editors;
815 GtkUIManager *ui_manager;
816 guint toolbar_merge_id[TOOLBAR_COUNT];
817 GList *toolbar_actions[TOOLBAR_COUNT];
819 GtkWidget *path_entry;
823 LayoutLocation image_location;
827 ImageWindow *split_images[MAX_SPLIT_IMAGES];
828 ImageSplitMode split_mode;
829 gint active_split_image;
831 GtkWidget *split_image_widget;
832 GtkSizeGroup *split_image_sizegroup;
834 /* tools window (float) */
837 GtkWidget *tools_pane;
839 GtkWidget *menu_tool_bar; /**< Combined menu and toolbar box */
840 GtkWidget *menu_bar; /**< referenced by lw, exist during whole lw lifetime */
843 GtkWidget *toolbar[TOOLBAR_COUNT]; /**< referenced by lw, exist during whole lw lifetime */
845 GtkWidget *back_button;
849 LayoutLocation dir_location;
856 LayoutLocation file_location;
860 GtkWidget *file_view;
862 GtkWidget *info_box; /**< status bar */
863 GtkWidget *info_progress_bar; /**< status bar */
864 GtkWidget *info_sort; /**< status bar */
865 GtkWidget *info_status; /**< status bar */
866 GtkWidget *info_details; /**< status bar */
867 GtkWidget *info_zoom; /**< status bar */
868 GtkWidget *info_pixel; /**< status bar */
872 SlideShowData *slideshow;
876 FullScreenData *full_screen;
880 GtkWidget *utility_box; /**< referenced by lw, exist during whole lw lifetime */
881 GtkWidget *utility_paned; /**< between image and bar */
885 gboolean bar_sort_enabled; /**< Set during start-up, and checked when the editors have loaded */
887 GtkWidget *exif_window;
888 GtkWidget *sar_window; /**< Search and Run window */
890 AnimationData *animation;
892 GtkWidget *log_window;
909 guint drop_scroll_id; /**< event source id */
912 void (*select_func)(ViewDir *vd, FileData *fd, gpointer data);
913 gpointer select_data;
915 void (*dnd_drop_update_func)(ViewDir *vd);
916 void (*dnd_drop_leave_func)(ViewDir *vd);
918 LayoutWindow *layout;
925 struct ViewDirInfoList
930 struct ViewDirInfoTree
932 guint drop_expand_id; /**< event source id */
939 FileViewType type; /**< @todo (xsdg): Turn this into a union (see VFLIST and VFICON from view-file.h). */
947 GtkWidget *filter_check[FILEDATA_MARKS_SIZE];
954 gboolean case_sensitive;
960 SortType sort_method;
961 gboolean sort_ascend;
965 void (*func_thumb_status)(ViewFile *vf, gdouble val, const gchar *text, gpointer data);
966 gpointer data_thumb_status;
968 void (*func_status)(ViewFile *vf, gpointer data);
969 gpointer data_status;
971 LayoutWindow *layout;
976 gboolean thumbs_running;
977 ThumbLoader *thumbs_loader;
978 FileData *thumbs_filedata;
981 gboolean marks_enabled;
986 FileData *stars_filedata;
990 guint refresh_idle_id; /**< event source id */
991 time_t time_refresh_set; /**< time when refresh_idle_id was set */
993 GList *editmenu_fd_list; /**< file list for edit menu */
995 guint read_metadata_in_idle_id;
998 struct ViewFileInfoList
1001 FileData *select_fd;
1003 gboolean thumbs_enabled;
1005 guint select_idle_id; /**< event source id */
1008 struct ViewFileInfoIcon
1015 FileData *prev_selection;
1017 GtkWidget *tip_window;
1018 guint tip_delay_id; /**< event source id */
1030 struct SlideShowData
1032 LayoutWindow *lw; /**< use this window to display the slideshow */
1033 ImageWindow *imd; /**< use this window only if lw is not available,
1034 @FIXME it is probably required only by img-view.cc and should be dropped with it */
1046 guint timeout_id; /**< event source id */
1048 gboolean from_selection;
1050 void (*stop_func)(SlideShowData *, gpointer);
1056 struct FullScreenData
1061 GtkWidget *normal_window;
1062 ImageWindow *normal_imd;
1064 guint hide_mouse_id; /**< event source id */
1065 guint busy_mouse_id; /**< event source id */
1069 guint saver_block_id; /**< event source id */
1071 void (*stop_func)(FullScreenData *, gpointer);
1074 gboolean same_region; /**< the returned region will overlap the current location of widget. */
1077 struct PixmapFolders
1084 GdkPixbuf *read_only;
1087 struct SecureSaveInfo {
1088 FILE *fp; /**< file stream pointer */
1089 gchar *file_name; /**< final file name */
1090 gchar *tmp_file_name; /**< temporary file name */
1091 gint err; /**< set to non-zero value in case of error */
1092 gboolean secure_save; /**< use secure save for this file, internal use only */
1093 gboolean preserve_perms; /**< whether to preserve perms, TRUE by default */
1094 gboolean preserve_mtime; /**< whether to preserve mtime, FALSE by default */
1095 gboolean unlink_on_error; /**< whether to remove temporary file on save failure, TRUE by default */
1102 gboolean startup_blank;
1103 gboolean startup_full_screen;
1104 gboolean startup_in_slideshow;
1105 gboolean startup_command_line_collection;
1106 gboolean tools_hide;
1107 gboolean tools_show;
1108 gboolean log_window_show;
1112 GList *collection_list;
1116 SecureSaveInfo *ssi;
1117 gboolean new_instance;
1121 * @struct hard_coded_window_keys
1122 * @brief hard coded window shortcut keys
1124 * Used for two purposes:\n
1125 * to display the shortcuts keys in popup menus\n
1126 * used by ./doc/create-shortcuts-xml.sh to generate shortcut documentation in the Help files
1129 struct hard_coded_window_keys {
1130 GdkModifierType mask; /**< modifier key mask */
1131 guint key_value; /**< GDK_keyval */
1132 const gchar *text; /**< menu item label - NULL if end of list */
1136 /* vim: set shiftwidth=8 softtabstop=0 cindent cinoptions={1s: */