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.
22 #include "filefilter.h"
26 #include <gdk-pixbuf/gdk-pixbuf.h>
32 #include "main-defines.h"
35 #include "ui-fileops.h"
38 *-----------------------------------------------------------------------------
40 *-----------------------------------------------------------------------------
43 static GList *filter_list = nullptr;
44 static GList *extension_list = nullptr;
45 static GList *sidecar_ext_list = nullptr;
47 static GList *file_class_extension_list[FILE_FORMAT_CLASSES];
49 static GList *file_writable_list = nullptr; /* writable files */
50 static GList *file_sidecar_list = nullptr; /* files with allowed sidecar */
53 static FilterEntry *filter_entry_new(const gchar *key, const gchar *description,
54 const gchar *extensions, FileFormatClass file_class,
55 gboolean writable, gboolean allow_sidecar, gboolean enabled)
59 fe = g_new0(FilterEntry, 1);
60 fe->key = g_strdup(key);
61 fe->description = g_strdup(description);
62 fe->extensions = g_strdup(extensions);
63 fe->enabled = enabled;
64 fe->file_class = file_class;
65 fe->writable = writable;
66 fe->allow_sidecar = allow_sidecar;
71 static void filter_entry_free(FilterEntry *fe)
76 g_free(fe->description);
77 g_free(fe->extensions);
81 GList *filter_get_list()
86 void filter_remove_entry(FilterEntry *fe)
88 if (!g_list_find(filter_list, fe)) return;
90 filter_list = g_list_remove(filter_list, fe);
91 filter_entry_free(fe);
94 static FilterEntry *filter_get_by_key(const gchar *key)
98 if (!key) return nullptr;
103 auto fe = static_cast<FilterEntry *>(work->data);
106 if (strcmp(fe->key, key) == 0) return fe;
112 static gboolean filter_key_exists(const gchar *key)
114 return (filter_get_by_key(key) != nullptr);
117 void filter_add(const gchar *key, const gchar *description, const gchar *extensions, FileFormatClass file_class, gboolean writable, gboolean allow_sidecar, gboolean enabled)
119 filter_list = g_list_append(filter_list, filter_entry_new(key, description, extensions, file_class, writable, allow_sidecar, enabled));
122 void filter_add_unique(const gchar *description, const gchar *extensions, FileFormatClass file_class, gboolean writable, gboolean allow_sidecar, gboolean enabled)
127 key = g_strdup("user0");
129 while (filter_key_exists(key))
133 key = g_strdup_printf("user%d", n);
137 filter_add(key, description, extensions, file_class, writable, allow_sidecar, enabled);
141 static void filter_add_if_missing(const gchar *key, const gchar *description, const gchar *extensions, FileFormatClass file_class, gboolean writable, gboolean allow_sidecar, gboolean enabled)
150 auto fe = static_cast<FilterEntry *>(work->data);
152 if (fe->key && strcmp(fe->key, key) == 0)
154 if (fe->file_class == FORMAT_CLASS_UNKNOWN)
155 fe->file_class = file_class; /* for compatibility */
157 if (fe->writable && fe->allow_sidecar)
159 fe->writable = writable;
160 fe->allow_sidecar = allow_sidecar;
166 filter_add(key, description, extensions, file_class, writable, allow_sidecar, enabled);
171 g_list_free_full(filter_list, reinterpret_cast<GDestroyNotify>(filter_entry_free));
172 filter_list = nullptr;
175 void filter_add_defaults()
177 /* formats supported by custom loaders */
178 filter_add_if_missing("dds", "DirectDraw Surface", ".dds", FORMAT_CLASS_IMAGE, FALSE, FALSE, TRUE);
180 filter_add_if_missing("pdf", "Portable Document Format", ".pdf", FORMAT_CLASS_DOCUMENT, FALSE, FALSE, TRUE);
183 filter_add_if_missing("heif/avif", "HEIF/AVIF Image", ".heif;.heic;.avif", FORMAT_CLASS_IMAGE, FALSE, TRUE, TRUE);
186 filter_add_if_missing("webp", "WebP Format", ".webp", FORMAT_CLASS_IMAGE, TRUE, FALSE, TRUE);
189 filter_add_if_missing("djvu", "DjVu Format", ".djvu;.djv", FORMAT_CLASS_DOCUMENT, FALSE, FALSE, TRUE);
192 filter_add_if_missing("jxl", "JXL", ".jxl", FORMAT_CLASS_IMAGE, FALSE, TRUE, TRUE);
195 filter_add_if_missing("jp2", "JPEG 2000", ".jp2", FORMAT_CLASS_IMAGE, FALSE, FALSE, TRUE);
198 filter_add_if_missing("zip", "Archive files", ".zip;.rar;.tar;.tar.gz;.tar.bz2;.tar.xz;.tgz;.tbz;.txz;.cbr;.cbz;.gz;.bz2;.xz;.lzh;.lza;.7z", FORMAT_CLASS_ARCHIVE, FALSE, FALSE, TRUE);
200 filter_add_if_missing("scr", "ZX Spectrum screen Format", ".scr", FORMAT_CLASS_IMAGE, FALSE, FALSE, TRUE);
201 filter_add_if_missing("psd", "Adobe Photoshop Document", ".psd", FORMAT_CLASS_IMAGE, FALSE, FALSE, TRUE);
202 filter_add_if_missing("apng", "Animated Portable Network Graphic", ".apng", FORMAT_CLASS_IMAGE, FALSE, FALSE, TRUE);
204 /* formats supported by gdk-pixbuf */
208 list = gdk_pixbuf_get_formats();
212 GdkPixbufFormat *format;
216 GString *filter = nullptr;
219 format = static_cast<GdkPixbufFormat *>(work->data);
222 name = gdk_pixbuf_format_get_name(format);
224 if (strcmp(name, "Digital camera RAW") == 0)
226 DEBUG_1("Skipped '%s' from loader", name);
231 desc = gdk_pixbuf_format_get_description(format);
232 extensions = gdk_pixbuf_format_get_extensions(format);
235 while (extensions[i])
239 filter = g_string_new(".");
240 filter = g_string_append(filter, extensions[i]);
244 filter = g_string_append(filter, ";.");
245 filter = g_string_append(filter, extensions[i]);
250 DEBUG_1("loader reported [%s] [%s] [%s]", name, desc, filter->str);
252 filter_add_if_missing(name, desc, filter->str, FORMAT_CLASS_IMAGE, TRUE, FALSE, TRUE);
256 g_strfreev(extensions);
257 g_string_free(filter, TRUE);
261 /* add defaults even if gdk-pixbuf does not have them, but disabled */
262 filter_add_if_missing("jpeg", "JPEG group", ".jpg;.jpeg;.jpe", FORMAT_CLASS_IMAGE, TRUE, FALSE, FALSE);
263 filter_add_if_missing("png", "Portable Network Graphic", ".png", FORMAT_CLASS_IMAGE, TRUE, FALSE, FALSE);
264 filter_add_if_missing("tiff", "Tiff", ".tif;.tiff", FORMAT_CLASS_IMAGE, TRUE, FALSE, FALSE);
265 filter_add_if_missing("pnm", "Packed Pixel formats", ".pbm;.pgm;.pnm;.ppm", FORMAT_CLASS_IMAGE, TRUE, FALSE, FALSE);
266 filter_add_if_missing("gif", "Graphics Interchange Format", ".gif", FORMAT_CLASS_IMAGE, TRUE, FALSE, FALSE);
267 filter_add_if_missing("xbm", "X bitmap", ".xbm", FORMAT_CLASS_IMAGE, TRUE, FALSE, FALSE);
268 filter_add_if_missing("xpm", "X pixmap", ".xpm", FORMAT_CLASS_IMAGE, TRUE, FALSE, FALSE);
269 filter_add_if_missing("bmp", "Bitmap", ".bmp", FORMAT_CLASS_IMAGE, TRUE, FALSE, FALSE);
270 filter_add_if_missing("ico", "Icon file", ".ico;.cur", FORMAT_CLASS_IMAGE, TRUE, FALSE, FALSE);
271 filter_add_if_missing("ras", "Raster", ".ras", FORMAT_CLASS_IMAGE, TRUE, FALSE, FALSE);
272 filter_add_if_missing("svg", "Scalable Vector Graphics", ".svg", FORMAT_CLASS_IMAGE, TRUE, FALSE, FALSE);
274 /* special formats for stereo */
275 filter_add_if_missing("jps", "Stereo side-by-side jpeg", ".jps", FORMAT_CLASS_IMAGE, TRUE, FALSE, TRUE);
276 filter_add_if_missing("mpo", "Stereo multi-image jpeg", ".mpo", FORMAT_CLASS_IMAGE, FALSE, TRUE, TRUE);
278 /* non-image files that might be desirable to show */
279 filter_add_if_missing("xmp", "XMP sidecar", ".xmp", FORMAT_CLASS_META, TRUE, FALSE, TRUE);
280 filter_add_if_missing("meta", "GQview legacy metadata", GQ_CACHE_EXT_METADATA, FORMAT_CLASS_META, TRUE, FALSE, TRUE);
281 filter_add_if_missing("gqv", GQ_APPNAME " image collection", GQ_COLLECTION_EXT, FORMAT_CLASS_COLLECTION, FALSE, TRUE, TRUE);
282 filter_add_if_missing("pto", "Panorama script file", ".pto", FORMAT_CLASS_META, FALSE, FALSE, TRUE);
284 /* These are the raw camera formats with embedded jpeg/exif.
285 * (see format-raw.cc and/or exiv2.cc)
287 filter_add_if_missing("arw", "Sony raw format", ".arw;.srf;.sr2", FORMAT_CLASS_RAWIMAGE, FALSE, TRUE, TRUE);
288 filter_add_if_missing("crw", "Canon raw format", ".crw;.cr2;.cr3", FORMAT_CLASS_RAWIMAGE, FALSE, TRUE, TRUE);
289 filter_add_if_missing("kdc", "Kodak raw format", ".kdc;.dcr;.k25", FORMAT_CLASS_RAWIMAGE, FALSE, TRUE, TRUE);
290 filter_add_if_missing("raf", "Fujifilm raw format", ".raf", FORMAT_CLASS_RAWIMAGE, FALSE, TRUE, TRUE);
291 filter_add_if_missing("mef", "Mamiya raw format", ".mef;.mos", FORMAT_CLASS_RAWIMAGE, FALSE, TRUE, TRUE);
292 filter_add_if_missing("mrw", "Minolta raw format", ".mrw", FORMAT_CLASS_RAWIMAGE, FALSE, TRUE, TRUE);
293 filter_add_if_missing("nef", "Nikon raw format", ".nef", FORMAT_CLASS_RAWIMAGE, FALSE, TRUE, TRUE);
294 filter_add_if_missing("orf", "Olympus raw format", ".orf", FORMAT_CLASS_RAWIMAGE, FALSE, TRUE, TRUE);
295 filter_add_if_missing("pef", "Pentax or Samsung raw format", ".pef", FORMAT_CLASS_RAWIMAGE, FALSE, TRUE, TRUE);
296 filter_add_if_missing("dng", "Adobe Digital Negative raw format", ".dng", FORMAT_CLASS_RAWIMAGE, FALSE, TRUE, TRUE);
297 filter_add_if_missing("raw", "Panasonic raw format", ".raw", FORMAT_CLASS_RAWIMAGE, FALSE, TRUE, TRUE);
298 filter_add_if_missing("r3d", "Red raw format", ".r3d", FORMAT_CLASS_RAWIMAGE, FALSE, TRUE, TRUE);
299 filter_add_if_missing("3fr", "Hasselblad raw format", ".3fr", FORMAT_CLASS_RAWIMAGE, FALSE, TRUE, TRUE);
300 filter_add_if_missing("erf", "Epson raw format", ".erf", FORMAT_CLASS_RAWIMAGE, FALSE, TRUE, TRUE);
301 filter_add_if_missing("srw", "Samsung raw format", ".srw", FORMAT_CLASS_RAWIMAGE, FALSE, TRUE, TRUE);
302 filter_add_if_missing("rw2", "Panasonic raw format", ".rw2", FORMAT_CLASS_RAWIMAGE, FALSE, TRUE, TRUE);
305 filter_add_if_missing("mp4", "MP4 video file", ".mp4;.m4v;.3gp;.3g2", FORMAT_CLASS_VIDEO, FALSE, FALSE, TRUE);
306 filter_add_if_missing("3gp", "3GP video file", ".3gp;.3g2", FORMAT_CLASS_VIDEO, FALSE, FALSE, TRUE);
307 filter_add_if_missing("mov", "MOV video file", ".mov;.qt", FORMAT_CLASS_VIDEO, FALSE, FALSE, TRUE);
308 filter_add_if_missing("avi", "AVI video file", ".avi", FORMAT_CLASS_VIDEO, FALSE, FALSE, TRUE);
309 filter_add_if_missing("mpg", "MPG video file", ".mpg;.mpeg;.mts;.m2ts", FORMAT_CLASS_VIDEO, FALSE, FALSE, TRUE);
310 filter_add_if_missing("mkv", "Matroska video file", ".mkv;.webm", FORMAT_CLASS_VIDEO, FALSE, FALSE, TRUE);
311 filter_add_if_missing("wmv", "Windows Media Video file", ".wmv;.asf", FORMAT_CLASS_VIDEO, FALSE, FALSE, TRUE);
312 filter_add_if_missing("flv", "Flash Video file", ".flv", FORMAT_CLASS_VIDEO, FALSE, FALSE, TRUE);
315 GList *filter_to_list(const gchar *extensions)
317 GList *list = nullptr;
320 if (!extensions) return nullptr;
327 gint file_class = -1;
331 while (*p != '\0' && *p != ';')
337 ext = g_strndup(b, l);
339 if (g_ascii_strcasecmp(ext, "%image") == 0) file_class = FORMAT_CLASS_IMAGE;
340 else if (g_ascii_strcasecmp(ext, "%raw") == 0) file_class = FORMAT_CLASS_RAWIMAGE;
341 else if (g_ascii_strcasecmp(ext, "%meta") == 0) file_class = FORMAT_CLASS_META;
342 else if (g_ascii_strcasecmp(ext, "%unknown") == 0) file_class = FORMAT_CLASS_UNKNOWN;
344 if (file_class == -1)
346 list = g_list_append(list, ext);
350 list = g_list_concat(list, string_list_copy(file_class_extension_list[file_class]));
360 static gint filter_sort_ext_len_cb(gconstpointer a, gconstpointer b)
362 auto sa = static_cast<const gchar *>(a);
363 auto sb = static_cast<const gchar *>(b);
365 gint len_a = strlen(sa);
366 gint len_b = strlen(sb);
368 if (len_a > len_b) return -1;
369 if (len_a < len_b) return 1;
374 void filter_rebuild()
379 g_list_free_full(extension_list, g_free);
380 extension_list = nullptr;
382 g_list_free_full(file_writable_list, g_free);
383 file_writable_list = nullptr;
385 g_list_free_full(file_sidecar_list, g_free);
386 file_sidecar_list = nullptr;
388 for (i = 0; i < FILE_FORMAT_CLASSES; i++)
390 g_list_free_full(file_class_extension_list[i], g_free);
391 file_class_extension_list[i] = nullptr;
399 fe = static_cast<FilterEntry *>(work->data);
406 ext = filter_to_list(fe->extensions);
407 if (ext) extension_list = g_list_concat(extension_list, ext);
409 if (fe->file_class < FILE_FORMAT_CLASSES)
411 ext = filter_to_list(fe->extensions);
412 if (ext) file_class_extension_list[fe->file_class] = g_list_concat(file_class_extension_list[fe->file_class], ext);
416 log_printf("WARNING: invalid file class %d\n", fe->file_class);
421 ext = filter_to_list(fe->extensions);
422 if (ext) file_writable_list = g_list_concat(file_writable_list, ext);
425 if (fe->allow_sidecar)
427 ext = filter_to_list(fe->extensions);
428 if (ext) file_sidecar_list = g_list_concat(file_sidecar_list, ext);
434 /* make sure registered_extension_from_path finds the longer match first */
435 extension_list = g_list_sort(extension_list, filter_sort_ext_len_cb);
436 sidecar_ext_parse(options->sidecar.ext); /* this must be updated after changed file extensions */
439 /* return the extension part of the name or NULL */
440 static const gchar *filter_name_find(GList *filter, const gchar *name)
449 auto filter = static_cast<gchar *>(work->data);
450 guint lf = strlen(filter);
455 if (g_ascii_strncasecmp(name + ln - lf, filter, lf) == 0) return name + ln - lf;
462 const gchar *registered_extension_from_path(const gchar *name)
464 return filter_name_find(extension_list, name);
467 gboolean filter_name_exists(const gchar *name)
469 if (!extension_list || options->file_filter.disable) return TRUE;
471 return !!filter_name_find(extension_list, name);
474 gboolean filter_file_class(const gchar *name, FileFormatClass file_class)
476 if (file_class >= FILE_FORMAT_CLASSES)
478 log_printf("WARNING: invalid file class %d\n", file_class);
482 return !!filter_name_find(file_class_extension_list[file_class], name);
485 FileFormatClass filter_file_get_class(const gchar *name)
487 if (filter_file_class(name, FORMAT_CLASS_IMAGE)) return FORMAT_CLASS_IMAGE;
488 if (filter_file_class(name, FORMAT_CLASS_RAWIMAGE)) return FORMAT_CLASS_RAWIMAGE;
489 if (filter_file_class(name, FORMAT_CLASS_META)) return FORMAT_CLASS_META;
490 if (filter_file_class(name, FORMAT_CLASS_VIDEO)) return FORMAT_CLASS_VIDEO;
491 if (filter_file_class(name, FORMAT_CLASS_COLLECTION)) return FORMAT_CLASS_COLLECTION;
492 if (filter_file_class(name, FORMAT_CLASS_DOCUMENT)) return FORMAT_CLASS_DOCUMENT;
493 if (filter_file_class(name, FORMAT_CLASS_ARCHIVE)) return FORMAT_CLASS_ARCHIVE;
494 return FORMAT_CLASS_UNKNOWN;
497 gboolean filter_name_is_writable(const gchar *name)
499 return !!filter_name_find(file_writable_list, name);
502 gboolean filter_name_allow_sidecar(const gchar *name)
504 return !!filter_name_find(file_sidecar_list, name);
507 void filter_write_list(GString *outstr, gint indent)
511 WRITE_NL(); WRITE_STRING("<filter>");
517 auto fe = static_cast<FilterEntry *>(work->data);
520 WRITE_NL(); WRITE_STRING("<file_type ");
521 WRITE_CHAR(*fe, key);
522 WRITE_BOOL(*fe, enabled);
523 WRITE_CHAR(*fe, extensions);
524 WRITE_CHAR(*fe, description);
525 WRITE_UINT(*fe, file_class);
526 WRITE_BOOL(*fe, writable);
527 WRITE_BOOL(*fe, allow_sidecar);
531 WRITE_NL(); WRITE_STRING("</filter>");
534 void filter_load_file_type(const gchar **attribute_names, const gchar **attribute_values)
538 memset(&fe, 0, sizeof(fe));
539 while (*attribute_names)
541 const gchar *option = *attribute_names++;
542 const gchar *value = *attribute_values++;
544 if (READ_CHAR(fe, key)) continue;
545 if (READ_BOOL(fe, enabled)) continue;
546 if (READ_CHAR(fe, extensions)) continue;
547 if (READ_CHAR(fe, description)) continue;
548 if (READ_UINT_ENUM(fe, file_class)) continue;
549 if (READ_BOOL(fe, writable)) continue;
550 if (READ_BOOL(fe, allow_sidecar)) continue;
552 log_printf("unknown attribute %s = %s\n", option, value);
554 if (fe.file_class >= FILE_FORMAT_CLASSES) fe.file_class = FORMAT_CLASS_UNKNOWN;
556 if (fe.key && fe.key[0] != 0)
558 old_fe = filter_get_by_key(fe.key);
560 if (old_fe != nullptr) filter_remove_entry(old_fe);
561 filter_add(fe.key, fe.description, fe.extensions, fe.file_class, fe.writable, fe.allow_sidecar, fe.enabled);
564 g_free(fe.extensions);
565 g_free(fe.description);
570 *-----------------------------------------------------------------------------
571 * sidecar extension list
572 *-----------------------------------------------------------------------------
575 GList *sidecar_ext_get_list()
577 return sidecar_ext_list;
580 static void sidecar_ext_free_list()
582 g_list_free_full(sidecar_ext_list, g_free);
583 sidecar_ext_list = nullptr;
586 void sidecar_ext_parse(const gchar *text)
588 sidecar_ext_free_list();
589 if (text == nullptr) return;
591 sidecar_ext_list = filter_to_list(text);
595 /* vim: set shiftwidth=8 softtabstop=0 cindent cinoptions={1s: */