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