always check for sidecars by readdir
[geeqie.git] / src / filedata.h
1 /*
2  * Geeqie
3  * (C) 2004 John Ellis
4  * Copyright (C) 2008 - 2010 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 FILEDATA_H
15 #define FILEDATA_H
16
17 #ifdef DEBUG
18 #define DEBUG_FILEDATA
19 #endif
20
21 gchar *text_from_size(gint64 size);
22 gchar *text_from_size_abrev(gint64 size);
23 const gchar *text_from_time(time_t t);
24
25 /* scan for sidecar files - expensive */
26 FileData *file_data_new_simple(const gchar *path_utf8);
27
28 /* should be used on helper files which can't have sidecars */
29 FileData *file_data_new_no_grouping(const gchar *path_utf8);
30
31 /* should be used on dirs */
32 FileData *file_data_new_dir(const gchar *path_utf8);
33
34 #ifdef DEBUG_FILEDATA
35 FileData *file_data_ref_debug(const gchar *file, gint line, FileData *fd);
36 void file_data_unref_debug(const gchar *file, gint line, FileData *fd);
37 #define file_data_ref(fd) file_data_ref_debug(__FILE__, __LINE__, fd)
38 #define file_data_unref(fd) file_data_unref_debug(__FILE__, __LINE__, fd)
39 #else
40 FileData *file_data_ref(FileData *fd);
41 void file_data_unref(FileData *fd);
42 #endif
43
44 gboolean file_data_check_changed_files(FileData *fd);
45
46 void file_data_increment_version(FileData *fd);
47
48 gboolean file_data_add_change_info(FileData *fd, FileDataChangeType type, const gchar *src, const gchar *dest);
49 void file_data_change_info_free(FileDataChangeInfo *fdci, FileData *fd);
50
51 void file_data_disable_grouping(FileData *fd, gboolean disable);
52 void file_data_disable_grouping_list(GList *fd_list, gboolean disable);
53
54 gint filelist_sort_compare_filedata(FileData *fa, FileData *fb);
55 gint filelist_sort_compare_filedata_full(FileData *fa, FileData *fb, SortType method, gboolean ascend);
56 GList *filelist_sort(GList *list, SortType method, gboolean ascend);
57 GList *filelist_insert_sort(GList *list, FileData *fd, SortType method, gboolean ascend);
58 GList *filelist_sort_full(GList *list, SortType method, gboolean ascend, GCompareFunc cb);
59 GList *filelist_insert_sort_full(GList *list, gpointer data, SortType method, gboolean ascend, GCompareFunc cb);
60
61 gboolean filelist_read(FileData *dir_fd, GList **files, GList **dirs);
62 gboolean filelist_read_lstat(FileData *dir_fd, GList **files, GList **dirs);
63 void filelist_free(GList *list);
64 GList *filelist_copy(GList *list);
65 GList *filelist_from_path_list(GList *list);
66 GList *filelist_to_path_list(GList *list);
67
68 GList *filelist_filter(GList *list, gboolean is_dir_list);
69
70 GList *filelist_sort_path(GList *list);
71 GList *filelist_recursive(FileData *dir_fd);
72
73 typedef gboolean (* FileDataGetMarkFunc)(FileData *fd, gint n, gpointer data);
74 typedef gboolean (* FileDataSetMarkFunc)(FileData *fd, gint n, gboolean value, gpointer data);
75 gboolean file_data_register_mark_func(gint n, FileDataGetMarkFunc get_mark_func, FileDataSetMarkFunc set_mark_func, gpointer data, GDestroyNotify notify);
76 void file_data_get_registered_mark_func(gint n, FileDataGetMarkFunc *get_mark_func, FileDataSetMarkFunc *set_mark_func, gpointer *data);
77
78
79 gboolean file_data_get_mark(FileData *fd, gint n);
80 guint file_data_get_marks(FileData *fd);
81 void file_data_set_mark(FileData *fd, gint n, gboolean value);
82 gboolean file_data_filter_marks(FileData *fd, guint filter);
83 GList *file_data_filter_marks_list(GList *list, guint filter);
84
85 gint file_data_get_user_orientation(FileData *fd);
86 void file_data_set_user_orientation(FileData *fd, gint value);
87
88 gchar *file_data_sc_list_to_string(FileData *fd);
89
90 gchar *file_data_get_sidecar_path(FileData *fd, gboolean existing_only);
91
92
93 gboolean file_data_add_ci(FileData *fd, FileDataChangeType type, const gchar *src, const gchar *dest);
94 gboolean file_data_sc_add_ci_copy(FileData *fd, const gchar *dest_path);
95 gboolean file_data_sc_add_ci_move(FileData *fd, const gchar *dest_path);
96 gboolean file_data_sc_add_ci_rename(FileData *fd, const gchar *dest_path);
97 gboolean file_data_sc_add_ci_delete(FileData *fd);
98 gboolean file_data_sc_add_ci_unspecified(FileData *fd, const gchar *dest_path);
99
100 gboolean file_data_sc_add_ci_delete_list(GList *fd_list);
101 gboolean file_data_sc_add_ci_copy_list(GList *fd_list, const gchar *dest);
102 gboolean file_data_sc_add_ci_move_list(GList *fd_list, const gchar *dest);
103 gboolean file_data_sc_add_ci_rename_list(GList *fd_list, const gchar *dest);
104 gboolean file_data_sc_add_ci_unspecified_list(GList *fd_list, const gchar *dest);
105 gboolean file_data_add_ci_write_metadata_list(GList *fd_list);
106
107 gboolean file_data_sc_update_ci_copy_list(GList *fd_list, const gchar *dest);
108 gboolean file_data_sc_update_ci_move_list(GList *fd_list, const gchar *dest);
109 gboolean file_data_sc_update_ci_unspecified_list(GList *fd_list, const gchar *dest);
110
111
112 gboolean file_data_sc_update_ci_copy(FileData *fd, const gchar *dest_path);
113 gboolean file_data_sc_update_ci_move(FileData *fd, const gchar *dest_path);
114 gboolean file_data_sc_update_ci_rename(FileData *fd, const gchar *dest_path);
115 gboolean file_data_sc_update_ci_unspecified(FileData *fd, const gchar *dest_path);
116
117 gchar *file_data_get_error_string(gint error);
118
119 gint file_data_verify_ci(FileData *fd);
120 gint file_data_verify_ci_list(GList *list, gchar **desc, gboolean with_sidecars);
121
122 gboolean file_data_perform_ci(FileData *fd);
123 gboolean file_data_apply_ci(FileData *fd);
124 void file_data_free_ci(FileData *fd);
125 void file_data_free_ci_list(GList *fd_list);
126
127 void file_data_set_regroup_when_finished(FileData *fd, gboolean enable);
128
129 gint file_data_sc_verify_ci(FileData *fd);
130
131 gboolean file_data_sc_perform_ci(FileData *fd);
132 gboolean file_data_sc_apply_ci(FileData *fd);
133 void file_data_sc_free_ci(FileData *fd);
134 void file_data_sc_free_ci_list(GList *fd_list);
135
136 GList *file_data_process_groups_in_selection(GList *list, gboolean ungroup, GList **ungrouped);
137
138
139 typedef void (*FileDataNotifyFunc)(FileData *fd, NotifyType type, gpointer data);
140 gboolean file_data_register_notify_func(FileDataNotifyFunc func, gpointer data, NotifyPriority priority);
141 gboolean file_data_unregister_notify_func(FileDataNotifyFunc func, gpointer data);
142 void file_data_send_notification(FileData *fd, NotifyType type);
143
144 gboolean file_data_register_real_time_monitor(FileData *fd);
145 gboolean file_data_unregister_real_time_monitor(FileData *fd);
146
147 #endif
148 /* vim: set shiftwidth=8 softtabstop=0 cindent cinoptions={1s: */