diff options
Diffstat (limited to 'src/options.c')
-rw-r--r-- | src/options.c | 1566 |
1 files changed, 678 insertions, 888 deletions
diff --git a/src/options.c b/src/options.c index 9afa33a..d38ce45 100644 --- a/src/options.c +++ b/src/options.c @@ -1,6 +1,7 @@ /* options.c Copyright (C) 1999-2003 Tom Gilbert. +Copyright (C) 2010-2024 Birte Kristina Friesel. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to @@ -23,23 +24,26 @@ CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ +#include <strings.h> #include "feh.h" #include "filelist.h" #include "options.h" static void check_options(void); -static void feh_parse_option_array(int argc, char **argv); -static void feh_parse_environment_options(void); -static void feh_check_theme_options(int arg, char **argv); +static void feh_getopt_theme(int argc, char **argv); +static void feh_parse_option_array(int argc, char **argv, int finalrun); +static void feh_check_theme_options(char **argv); static void feh_parse_options_from_string(char *opts); static void feh_load_options_for_theme(char *theme); +static void show_usage(void); +static void show_version(void); static char *theme; fehoptions opt; void init_parse_options(int argc, char **argv) { - D_ENTER(4); + /* TODO: sort these to match declaration of __fehoptions */ /* For setting the command hint on X windows */ cmdargc = argc; @@ -49,64 +53,52 @@ void init_parse_options(int argc, char **argv) memset(&opt, 0, sizeof(fehoptions)); opt.display = 1; opt.aspect = 1; - opt.slideshow_delay = -1.0; + opt.slideshow_delay = 0.0; + opt.conversion_timeout = -1; opt.thumb_w = 60; opt.thumb_h = 60; + opt.thumb_redraw = 10; + opt.scroll_step = 20; opt.menu_font = estrdup(DEFAULT_MENU_FONT); - opt.font = estrdup(DEFAULT_FONT); - opt.image_bg = estrdup("default"); - opt.menu_bg = estrdup(PREFIX "/share/feh/images/menubg_default.png"); - opt.menu_style = estrdup(PREFIX "/share/feh/fonts/menu.style"); - opt.menu_border = 4; - - opt.reload_button = 0; - opt.pan_button = 1; - opt.zoom_button = 2; - opt.menu_button = 3; - opt.menu_ctrl_mask = 0; - opt.prev_button = 4; - opt.next_button = 5; - - opt.rotate_button = 2; - opt.no_rotate_ctrl_mask = 0; - opt.blur_button = 1; - opt.no_blur_ctrl_mask = 0; - - opt.no_jump_on_resort = 0; - - opt.builtin_http = 0; - - opt.xinerama = 0; + opt.font = NULL; + opt.max_height = opt.max_width = UINT_MAX; + + opt.zoom_rate = 1.25; + + opt.start_list_at = NULL; + opt.jump_on_resort = 1; + opt.screen_clip = 1; + opt.cache_size = 4; #ifdef HAVE_LIBXINERAMA /* if we're using xinerama, then enable it by default */ opt.xinerama = 1; + opt.xinerama_index = -1; #endif /* HAVE_LIBXINERAMA */ +#ifdef HAVE_INOTIFY + opt.auto_reload = 1; +#endif /* HAVE_INOTIFY */ + opt.use_conversion_cache = 1; - D(3, ("About to parse env options (if any)\n")); - /* Check for and parse any options in FEH_OPTIONS */ - feh_parse_environment_options(); + feh_getopt_theme(argc, argv); - D(3, ("About to parse commandline options\n")); - /* Parse the cmdline args */ - feh_parse_option_array(argc, argv); + D(("About to check for theme configuration\n")); + feh_check_theme_options(argv); - D(3, ("About to check for theme configuration\n")); - feh_check_theme_options(argc, argv); + D(("About to parse commandline options\n")); + /* Parse the cmdline args */ + feh_parse_option_array(argc, argv, 1); /* If we have a filelist to read, do it now */ if (opt.filelistfile) { /* joining two reverse-sorted lists in this manner works nicely for us here, as files specified on the commandline end up at the *end* of the combined filelist, in the specified order. */ - D(3, ("About to load filelist from file\n")); + D(("About to load filelist from file\n")); filelist = gib_list_cat(filelist, feh_read_filelist(opt.filelistfile)); } - D(4, ("Options parsed\n")); - - if (opt.bgmode) - D_RETURN_(4); + D(("Options parsed\n")); filelist_len = gib_list_length(filelist); if (!filelist_len) @@ -115,12 +107,11 @@ void init_parse_options(int argc, char **argv) check_options(); feh_prepare_filelist(); - D_RETURN_(4); + return; } -static void feh_check_theme_options(int arg, char **argv) +static void feh_check_theme_options(char **argv) { - D_ENTER(4); if (!theme) { /* This prevents screw up when running src/feh or ./feh */ char *pos = strrchr(argv[0], '/'); @@ -130,132 +121,151 @@ static void feh_check_theme_options(int arg, char **argv) else theme = estrdup(argv[0]); } - D(3, ("Theme name is %s\n", theme)); + D(("Theme name is %s\n", theme)); feh_load_options_for_theme(theme); free(theme); - D_RETURN_(4); - arg = 0; + return; } static void feh_load_options_for_theme(char *theme) { FILE *fp = NULL; - char *home; + char *home = getenv("HOME"); char *rcpath = NULL; + char *oldrcpath = NULL; + char *confbase = getenv("XDG_CONFIG_HOME"); + // s, s1 and s2 must always have identical size char s[1024], s1[1024], s2[1024]; + int cont = 0; + int bspos; + + if (confbase) + rcpath = estrjoin("/", confbase, "feh/themes", NULL); + else if (home) + rcpath = estrjoin("/", home, ".config/feh/themes", NULL); + else { + weprintf("You have no HOME, cannot read configuration"); + return; + } - D_ENTER(4); + oldrcpath = estrjoin("/", home, ".fehrc", NULL); - if (opt.rcfile) { - if ((fp = fopen(opt.rcfile, "r")) == NULL) { - weprintf("couldn't load the specified rcfile %s\n", opt.rcfile); - D_RETURN_(4); - } - } else { - home = getenv("HOME"); - if (!home) - eprintf("D'oh! Please define HOME in your environment! " - "It would really help me out...\n"); - rcpath = estrjoin("/", home, ".fehrc", NULL); - D(3, ("Trying %s for config\n", rcpath)); - fp = fopen(rcpath, "r"); - - if (!fp && ((fp = fopen("/etc/fehrc", "r")) == NULL)) { - feh_create_default_config(rcpath); - - if ((fp = fopen(rcpath, "r")) == NULL) - D_RETURN_(4); - } + fp = fopen(rcpath, "r"); - free(rcpath); - } + free(rcpath); + + if (!fp && ((fp = fopen(oldrcpath, "r")) != NULL)) + weprintf("The theme config file was moved from ~/.fehrc to " + "~/.config/feh/themes. Run\n" + " mkdir -p ~/.config/feh; mv ~/.fehrc ~/.config/feh/themes\n" + "to fix this."); + + free(oldrcpath); + + if (!fp && ((fp = fopen("/etc/feh/themes", "r")) == NULL)) + return; /* Oooh. We have an options file :) */ for (; fgets(s, sizeof(s), fp);) { s1[0] = '\0'; s2[0] = '\0'; - sscanf(s, "%s %[^\n]\n", (char *) &s1, (char *) &s2); - if (!(*s1) || (!*s2) || (*s1 == '\n') || (*s1 == '#')) - continue; - D(5, ("Got theme/options pair %s/%s\n", s1, s2)); - if (!strcmp(s1, theme)) { - D(4, ("A match. Using options %s\n", s2)); - feh_parse_options_from_string(s2); - break; + + if (cont) { + /* + * fgets ensures that s contains no more than 1023 characters + * (+ 1 null byte) + */ + sscanf(s, " %[^\n]\n", (char *) &s2); + if (!*s2) + break; + D(("Got continued options %s\n", s2)); + } else { + /* + * fgets ensures that s contains no more than 1023 characters + * (+ 1 null byte) + */ + sscanf(s, "%s %[^\n]\n", (char *) &s1, (char *) &s2); + if (!(*s1) || (!*s2) || (*s1 == '\n') || (*s1 == '#')) { + cont = 0; + continue; + } + D(("Got theme/options pair %s/%s\n", s1, s2)); } - } - fclose(fp); - D_RETURN_(4); -} -static void feh_parse_environment_options(void) -{ - char *opts; + if (!strcmp(s1, theme) || cont) { - D_ENTER(4); + bspos = strlen(s2)-1; - if ((opts = getenv("FEH_OPTIONS")) == NULL) - D_RETURN_(4); + if (s2[bspos] == '\\') { + D(("Continued line\n")); + s2[bspos] = '\0'; + cont = 1; + /* A trailing whitespace confuses the option parser */ + if (bspos && (s2[bspos-1] == ' ')) + s2[bspos-1] = '\0'; + } else + cont = 0; - weprintf - ("The FEH_OPTIONS configuration method is depreciated and will soon die.\n" - "Use the .fehrc configuration file instead."); + D(("A match. Using options %s\n", s2)); + feh_parse_options_from_string(s2); - /* We definitely have some options to parse */ - feh_parse_options_from_string(opts); - D_RETURN_(4); + if (!cont) + break; + } + } + fclose(fp); + return; } /* FIXME This function is a crufty bitch ;) */ static void feh_parse_options_from_string(char *opts) { - char **list = NULL; + char *list[sizeof(char *) * 64]; int num = 0; char *s; char *t; char last = 0; - int inquote = 0; + char inquote = 0; int i = 0; - D_ENTER(4); - /* So we don't reinvent the wheel (not again, anyway), we use the getopt_long function to do this parsing as well. This means it has to look like the real argv ;) */ - list = malloc(sizeof(char *)); - list[num++] = estrdup(PACKAGE); for (s = opts, t = opts;; t++) { - if ((*t == ' ') && !(inquote)) { + + if (num > 64) + eprintf(PACKAGE " does not support more than 64 words per " + "theme definition.\n Please shorten your lines."); + + if ((*t == ' ') && !inquote) { *t = '\0'; num++; - list = erealloc(list, sizeof(char *) * num); list[num - 1] = feh_string_normalize(s); s = t + 1; } else if (*t == '\0') { num++; - list = erealloc(list, sizeof(char *) * num); list[num - 1] = feh_string_normalize(s); break; - } else if (*t == '\"' && last != '\\') - inquote = !(inquote); + } else if ((*t == inquote) && (last != '\\')) { + inquote = 0; + } else if (((*t == '\"') || (*t == '\'')) && (last != '\\') && !inquote) + inquote = *t; last = *t; } - feh_parse_option_array(num, list); + feh_parse_option_array(num, list, 0); for (i = 0; i < num; i++) if (list[i]) free(list[i]); - if (list) - free(list); - D_RETURN_(4); + return; } char *feh_string_normalize(char *str) @@ -265,8 +275,7 @@ char *feh_string_normalize(char *str) int i = 0; char last = 0; - D_ENTER(4); - D(4, ("normalizing %s\n", str)); + D(("normalizing %s\n", str)); ret[0] = '\0'; for (s = str;; s++) { @@ -275,6 +284,9 @@ char *feh_string_normalize(char *str) else if ((*s == '\"') && (last == '\\')) ret[i++] = '\"'; else if ((*s == '\"') && (last == 0)); + else if ((*s == '\'') && (last == '\\')) + ret[i++] = '\''; + else if ((*s == '\'') && (last == 0)); else if ((*s == ' ') && (last == '\\')) ret[i++] = ' '; else @@ -282,239 +294,258 @@ char *feh_string_normalize(char *str) last = *s; } - if (i && ret[i - 1] == '\"') + if (i && ((ret[i - 1] == '\"') || (ret[i - 1] == '\''))) ret[i - 1] = '\0'; else ret[i] = '\0'; - D(4, ("normalized to %s\n", ret)); + D(("normalized to %s\n", ret)); - D_RETURN(4, estrdup(ret)); + return(estrdup(ret)); } -static void feh_parse_option_array(int argc, char **argv) +static void feh_getopt_theme(int argc, char **argv) { - static char stropts[] = - "a:A:b:B:cC:dD:e:E:f:Fg:GhH:iIj:klL:mM:nNo:O:pqQrR:sS:tT:uUvVwW:xXy:zZ0:1:2:4:5:8:9:.@:^:~:):|:_:+:"; + static char stropts[] = "-T:"; static struct option lopts[] = { - /* actions */ - {"help", 0, 0, 'h'}, /* okay */ - {"version", 0, 0, 'v'}, /* okay */ - /* toggles */ - {"montage", 0, 0, 'm'}, /* okay */ - {"collage", 0, 0, 'c'}, /* okay */ - {"index", 0, 0, 'i'}, /* okay */ - {"fullindex", 0, 0, 'I'}, /* okay */ - {"verbose", 0, 0, 'V'}, /* okay */ - {"borderless", 0, 0, 'x'}, /* okay */ - {"keep-http", 0, 0, 'k'}, /* okay */ - {"stretch", 0, 0, 's'}, /* okay */ - {"multiwindow", 0, 0, 'w'}, /* okay */ - {"recursive", 0, 0, 'r'}, /* okay */ - {"randomize", 0, 0, 'z'}, /* okay */ - {"list", 0, 0, 'l'}, /* okay */ - {"quiet", 0, 0, 'q'}, /* okay */ - {"loadable", 0, 0, 'U'}, /* okay */ - {"unloadable", 0, 0, 'u'}, /* okay */ - {"no-menus", 0, 0, 'N'}, - {"full-screen", 0, 0, 'F'}, - {"auto-zoom", 0, 0, 'Z'}, - {"ignore-aspect", 0, 0, 'X'}, - {"draw-filename", 0, 0, 'd'}, - {"preload", 0, 0, 'p'}, - {"reverse", 0, 0, 'n'}, - {"thumbnails", 0, 0, 't'}, - {"wget-timestamp", 0, 0, 'G'}, - {"builtin", 0, 0, 'Q'}, - {"scale-down", 0, 0, '.'}, /* okay */ - {"no-jump-on-resort", 0, 0, 220}, - {"hide-pointer", 0, 0, 221}, - {"draw-actions", 0, 0, 222}, - {"cache-thumbnails", 0, 0, 223}, - {"cycle-once", 0, 0, 224}, - {"no-xinerama", 0, 0, 225}, - {"no-rotate-ctrl-mask", 0, 0, 226}, - {"no-blur-ctrl-mask", 0, 0, 227}, - {"menu-ctrl-mask", 0, 0, 228}, /* okay */ - /* options with values */ - {"output", 1, 0, 'o'}, /* okay */ - {"output-only", 1, 0, 'O'}, /* okay */ - {"action", 1, 0, 'A'}, /* okay */ - {"limit-width", 1, 0, 'W'}, /* okay */ - {"limit-height", 1, 0, 'H'}, /* okay */ - {"reload", 1, 0, 'R'}, /* okay */ - {"alpha", 1, 0, 'a'}, /* okay */ - {"sort", 1, 0, 'S'}, /* okay */ - {"theme", 1, 0, 'T'}, /* okay */ - {"filelist", 1, 0, 'f'}, /* okay */ - {"customlist", 1, 0, 'L'}, /* okay */ - {"geometry", 1, 0, 'g'}, /* okay */ - {"menu-font", 1, 0, 'M'}, - {"thumb-width", 1, 0, 'y'}, - {"thumb-height", 1, 0, 'E'}, - {"slideshow-delay", 1, 0, 'D'}, - {"font", 1, 0, 'e'}, - {"title-font", 1, 0, '@'}, - {"title", 1, 0, '^'}, - {"thumb-title", 1, 0, '~'}, - {"bg", 1, 0, 'b'}, - {"fontpath", 1, 0, 'C'}, - {"menu-bg", 1, 0, ')'}, - {"image-bg", 1, 0, 'B'}, - {"reload-button", 1, 0, '0'}, - {"pan-button", 1, 0, '1'}, - {"zoom-button", 1, 0, '2'}, - {"menu-button", 1, 0, '3'}, - {"prev-button", 1, 0, '4'}, - {"next-button", 1, 0, '5'}, - {"rotate-button", 1, 0, '8'}, - {"blur-button", 1, 0, '9'}, - {"start-at", 1, 0, '|'}, - {"rcfile", 1, 0, '_'}, - {"debug-level", 1, 0, '+'}, - {"output-dir", 1, 0, 'j'}, - {"bg-tile", 1, 0, 200}, - {"bg-center", 1, 0, 201}, - {"bg-scale", 1, 0, 202}, - {"bg-seamless", 1, 0, 203}, - {"menu-style", 1, 0, 204}, - {"zoom", 1, 0, 205}, - {"screen-clip", 1, 0, 206}, - {"menu-border", 1, 0, 207}, - {"caption-path", 1, 0, 208}, - {"action1", 1, 0, 209}, - {"action2", 1, 0, 210}, - {"action3", 1, 0, 211}, - {"action4", 1, 0, 212}, - {"action5", 1, 0, 213}, - {"action6", 1, 0, 214}, - {"action7", 1, 0, 215}, - {"action8", 1, 0, 216}, - {"action9", 1, 0, 217}, - {"bg-fill", 1, 0, 218}, - {"index-name", 1, 0, 230}, - {"index-size", 1, 0, 231}, - {"index-dim", 1, 0, 232}, + {"theme", 1, 0, 'T'}, {0, 0, 0, 0} }; int optch = 0, cmdx = 0; - D_ENTER(4); + opterr = 0; + + while ((optch = getopt_long(argc, argv, stropts, lopts, &cmdx)) != EOF) { + if (optch == 'T') + theme = estrdup(optarg); + } + + opterr = 1; + optind = 0; +} + +static void feh_parse_option_array(int argc, char **argv, int finalrun) +{ + int discard; + static char stropts[] = + "a:A:b:B:C:dD:e:E:f:Fg:GhH:iIj:J:kK:lL:mM:nNo:O:pPqrR:sS:tT:uUvVwW:xXy:YzZ" + ".@:^:~:|:+:<:>:"; + + /* (*name, has_arg, *flag, val) See: struct option in getopts.h */ + static struct option lopts[] = { + {"debug" , 0, 0, OPTION_debug}, + {"scale-down" , 0, 0, OPTION_scale_down}, + {"max-dimension" , 1, 0, OPTION_max_dimension}, + {"min-dimension" , 1, 0, OPTION_min_dimension}, + {"title-font" , 1, 0, OPTION_title_font}, + {"action" , 1, 0, OPTION_action}, + {"image-bg" , 1, 0, OPTION_image_bg}, + {"fontpath" , 1, 0, OPTION_fontpath}, + {"slideshow-delay",1, 0, OPTION_slideshow_delay}, + {"thumb-height" , 1, 0, OPTION_thumb_height}, + {"full-screen" , 0, 0, OPTION_fullscreen}, /* deprecated */ + {"fullscreen" , 0, 0, OPTION_fullscreen}, + {"draw-actions" , 0, 0, OPTION_draw_actions}, + {"limit-height" , 1, 0, OPTION_limit_height}, + {"fullindex" , 0, 0, OPTION_fullindex}, + {"thumb-redraw" , 1, 0, OPTION_thumb_redraw}, + {"caption-path" , 1, 0, OPTION_caption_path}, + {"customlist" , 1, 0, OPTION_customlist}, + {"menu-font" , 1, 0, OPTION_menu_font}, + {"no-menus" , 0, 0, OPTION_no_menus}, + {"output-only" , 1, 0, OPTION_output_only}, + {"cache-thumbnails", 0, 0, OPTION_cache_thumbnails}, + {"reload" , 1, 0, OPTION_reload}, + {"sort" , 1, 0, OPTION_sort}, + {"theme" , 1, 0, OPTION_theme}, + {"loadable" , 0, 0, OPTION_loadable}, + {"verbose" , 0, 0, OPTION_verbose}, + {"limit-width" , 1, 0, OPTION_limit_width}, + {"ignore-aspect" , 0, 0, OPTION_ignore_aspect}, + {"hide-pointer" , 0, 0, OPTION_hide_pointer}, + {"auto-zoom" , 0, 0, OPTION_auto_zoom}, + {"title" , 1, 0, OPTION_title}, + {"alpha" , 1, 0, OPTION_alpha}, + {"bg" , 1, 0, OPTION_bg}, + {"draw-filename" , 0, 0, OPTION_draw_filename}, + {"font" , 1, 0, OPTION_font}, + {"filelist" , 1, 0, OPTION_filelist}, + {"geometry" , 1, 0, OPTION_geometry}, + {"help" , 0, 0, OPTION_help}, + {"index" , 0, 0, OPTION_index}, + {"output-dir" , 1, 0, OPTION_output_dir}, + {"keep-http" , 0, 0, OPTION_keep_http}, + {"list" , 0, 0, OPTION_list}, + {"montage" , 0, 0, OPTION_montage}, + {"reverse" , 0, 0, OPTION_reverse}, + {"output" , 1, 0, OPTION_output}, + {"preload" , 0, 0, OPTION_preload}, + {"quiet" , 0, 0, OPTION_quiet}, + {"recursive" , 0, 0, OPTION_recursive}, + {"stretch" , 0, 0, OPTION_stretch}, + {"thumbnails" , 0, 0, OPTION_thumbnails}, + {"unloadable" , 0, 0, OPTION_unloadable}, + {"version" , 0, 0, OPTION_version}, + {"multiwindow" , 0, 0, OPTION_multiwindow}, + {"borderless" , 0, 0, OPTION_borderless}, + {"thumb-width" , 1, 0, OPTION_thumb_width}, + {"randomize" , 0, 0, OPTION_randomize}, + {"start-at" , 1, 0, OPTION_start_at}, + {"thumb-title" , 1, 0, OPTION_thumb_title}, + {"bg-tile" , 0, 0, OPTION_bg_title}, + {"bg-center" , 0, 0, OPTION_bg_center}, + {"bg-scale" , 0, 0, OPTION_bg_scale}, + {"zoom" , 1, 0, OPTION_zoom}, + {"zoom-step" , 1, 0, OPTION_zoom_step}, + {"no-screen-clip", 0, 0, OPTION_no_screen_clip}, + {"index-info" , 1, 0, OPTION_index_info}, + {"magick-timeout", 1, 0, OPTION_magick_timeout}, + {"action1" , 1, 0, OPTION_action1}, + {"action2" , 1, 0, OPTION_action2}, + {"action3" , 1, 0, OPTION_action3}, + {"action4" , 1, 0, OPTION_action4}, + {"action5" , 1, 0, OPTION_action5}, + {"action6" , 1, 0, OPTION_action6}, + {"action7" , 1, 0, OPTION_action7}, + {"action8" , 1, 0, OPTION_action8}, + {"action9" , 1, 0, OPTION_action9}, + {"bg-fill" , 0, 0, OPTION_bg_fill}, + {"bg-max" , 0, 0, OPTION_bg_max}, + {"no-jump-on-resort", 0, 0, OPTION_no_jump_on_resort}, + {"edit" , 0, 0, OPTION_edit}, +#ifdef HAVE_LIBEXIF + {"draw-exif" , 0, 0, OPTION_draw_exif}, + {"auto-rotate" , 0, 0, OPTION_auto_rotate}, +#endif + {"no-xinerama" , 0, 0, OPTION_no_xinerama}, + {"draw-tinted" , 0, 0, OPTION_draw_tinted}, + {"info" , 1, 0, OPTION_info}, + {"tap-zones" , 0, 0, OPTION_tap_zones}, + {"force-aliasing", 0, 0, OPTION_force_aliasing}, + {"no-fehbg" , 0, 0, OPTION_no_fehbg}, + {"keep-zoom-vp" , 0, 0, OPTION_keep_zoom_vp}, + {"scroll-step" , 1, 0, OPTION_scroll_step}, + {"xinerama-index", 1, 0, OPTION_xinerama_index}, + {"insecure" , 0, 0, OPTION_insecure}, + {"no-recursive" , 0, 0, OPTION_no_recursive}, + {"cache-size" , 1, 0, OPTION_cache_size}, + {"on-last-slide" , 1, 0, OPTION_on_last_slide}, + {"conversion-timeout" , 1, 0, OPTION_conversion_timeout}, + {"version-sort" , 0, 0, OPTION_version_sort}, + {"offset" , 1, 0, OPTION_offset}, +#ifdef HAVE_INOTIFY + {"auto-reload" , 0, 0, OPTION_auto_reload}, +#endif + {"class" , 1, 0, OPTION_class}, + {"no-conversion-cache", 0, 0, OPTION_no_conversion_cache}, + {"window-id", 1, 0, OPTION_window_id}, + {0, 0, 0, 0} + }; + int optch = 0, cmdx = 0; - /* Now to pass some optionarinos */ while ((optch = getopt_long(argc, argv, stropts, lopts, &cmdx)) != EOF) { - D(5, ("Got option, getopt calls it %d, or %c\n", optch, optch)); + D(("Got option, getopt calls it %d, or %c\n", optch, optch)); switch (optch) { case 0: break; - case 'h': - show_usage(); - break; - case 'v': - show_version(); - break; - case 'm': - opt.index = 1; - opt.index_show_name = 0; - opt.index_show_size = 0; - opt.index_show_dim = 0; + case OPTION_debug: + opt.debug = 1; break; - case 'c': - opt.collage = 1; + case OPTION_max_dimension: + opt.filter_by_dimensions = 1; + XParseGeometry(optarg, &discard, &discard, &opt.max_width, &opt.max_height); + if (opt.max_width == 0) + opt.max_width = UINT_MAX; + if (opt.max_height == 0) + opt.max_height = UINT_MAX; break; - case 'i': - opt.index = 1; - opt.index_show_name = 1; - opt.index_show_size = 0; - opt.index_show_dim = 0; + case OPTION_min_dimension: + opt.filter_by_dimensions = 1; + XParseGeometry(optarg, &discard, &discard, &opt.min_width, &opt.min_height); break; - case '.': + case OPTION_scale_down: opt.scale_down = 1; break; - case 'I': - opt.index = 1; - opt.index_show_name = 1; - opt.index_show_size = 1; - opt.index_show_dim = 1; - break; - case 'l': - opt.list = 1; - opt.display = 0; - break; - case 'G': - opt.wget_timestamp = 1; - break; - case 'Q': - opt.builtin_http = 1; - break; - case 'L': - opt.customlist = estrdup(optarg); - break; - case 'M': - free(opt.menu_font); - opt.menu_font = estrdup(optarg); - break; - case '+': - opt.debug_level = atoi(optarg); - break; - case 'n': - opt.reverse = 1; + case OPTION_title_font: + opt.title_font = estrdup(optarg); break; - case 'g': - opt.geom_flags = XParseGeometry(optarg, &opt.geom_x, &opt.geom_y, &opt.geom_w, &opt.geom_h); + case OPTION_action: + opt.actions[0] = estrdup(optarg); break; - case 'N': - opt.no_menus = 1; + case OPTION_image_bg: + opt.image_bg = estrdup(optarg); break; - case 'V': - opt.verbose = 1; + case OPTION_fontpath: + D(("adding fontpath %s\n", optarg)); + imlib_add_path_to_font_path(optarg); break; - case 'q': - opt.quiet = 1; + case OPTION_slideshow_delay: + opt.slideshow_delay = atof(optarg); + if (opt.slideshow_delay < 0.0) { + opt.slideshow_delay *= (-1); + opt.paused = 1; + } else { + opt.paused = 0; + } break; - case 'x': - opt.borderless = 1; + case OPTION_thumb_height: + opt.thumb_h = atoi(optarg); break; - case 'k': - opt.keep_http = 1; + case OPTION_fullscreen: + opt.full_screen = 1; break; - case 's': - opt.stretch = 1; + case OPTION_draw_actions: + opt.draw_actions = 1; break; - case 'w': - opt.multiwindow = 1; + case OPTION_limit_height: + opt.limit_h = atoi(optarg); break; - case 'r': - opt.recursive = 1; + case OPTION_fullindex: + opt.index = 1; + opt.index_info = estrdup("%n\n%S\n%wx%h"); break; - case 'z': - opt.randomize = 1; + case OPTION_thumb_redraw: + opt.thumb_redraw = atoi(optarg); break; - case 'd': - opt.draw_filename = 1; + case OPTION_caption_path: + opt.caption_path = estrdup(optarg); break; - case 'F': - opt.full_screen = 1; + case OPTION_customlist: + opt.customlist = estrdup(optarg); + opt.display = 0; break; - case 'Z': - opt.auto_zoom = 1; + case OPTION_menu_font: + free(opt.menu_font); + opt.menu_font = estrdup(optarg); break; - case 'U': - opt.loadables = 1; + case OPTION_no_menus: + opt.no_menus = 1; break; - case 'u': - opt.unloadables = 1; + case OPTION_output_only: + opt.output = 1; + opt.output_file = estrdup(optarg); + opt.display = 0; break; - case 'p': - opt.preload = 1; + case OPTION_cache_thumbnails: + opt.cache_thumbnails = 1; break; - case 'X': - opt.aspect = 0; + case OPTION_reload: + opt.reload = atof(optarg); + opt.use_conversion_cache = 0; +#ifdef HAVE_INOTIFY + opt.auto_reload = 0; +#endif break; - case 'S': + case OPTION_sort: if (!strcasecmp(optarg, "name")) opt.sort = SORT_NAME; + else if (!strcasecmp(optarg, "none")) + opt.sort = SORT_NONE; else if (!strcasecmp(optarg, "filename")) opt.sort = SORT_FILENAME; + else if (!strcasecmp(optarg, "dirname")) + opt.sort = SORT_DIRNAME; + else if (!strcasecmp(optarg, "mtime")) + opt.sort = SORT_MTIME; else if (!strcasecmp(optarg, "width")) opt.sort = SORT_WIDTH; else if (!strcasecmp(optarg, "height")) @@ -530,212 +561,304 @@ static void feh_parse_option_array(int argc, char **argv) "sort by filename", optarg); opt.sort = SORT_FILENAME; } + if (opt.randomize) { + weprintf("commandline contains --randomize and --sort. " + "--randomize has been unset"); + opt.randomize = 0; + } break; - case 'o': - opt.output = 1; - opt.output_file = estrdup(optarg); + case OPTION_theme: + theme = estrdup(optarg); break; - case 'O': - opt.output = 1; - opt.output_file = estrdup(optarg); + case OPTION_loadable: + opt.loadables = 1; opt.display = 0; break; - case 'T': - theme = estrdup(optarg); + case OPTION_verbose: + opt.verbose = 1; break; - case 'C': - D(3, ("adding fontpath %s\n", optarg)); - imlib_add_path_to_font_path(optarg); + case OPTION_limit_width: + opt.limit_w = atoi(optarg); break; - case 'e': - opt.font = estrdup(optarg); + case OPTION_ignore_aspect: + opt.aspect = 0; break; - case '@': - opt.title_font = estrdup(optarg); + case OPTION_hide_pointer: + opt.hide_pointer = 1; + break; + case OPTION_auto_zoom: + opt.zoom_mode = ZOOM_MODE_MAX; break; - case '^': + case OPTION_title: opt.title = estrdup(optarg); break; - case '~': - opt.thumb_title = estrdup(optarg); + case OPTION_alpha: + opt.alpha = 1; + opt.alpha_level = 255 - atoi(optarg); break; - case 'b': + case OPTION_bg: opt.bg = 1; opt.bg_file = estrdup(optarg); break; - case '_': - opt.rcfile = estrdup(optarg); + case OPTION_draw_filename: + opt.draw_filename = 1; break; - case 'A': - opt.actions[0] = estrdup(optarg); + case OPTION_font: + opt.font = estrdup(optarg); break; - case 'W': - opt.limit_w = atoi(optarg); + case OPTION_filelist: + if (!strcmp(optarg, "-")) + opt.filelistfile = estrdup("/dev/stdin"); + else + opt.filelistfile = estrdup(optarg); break; - case 'H': - opt.limit_h = atoi(optarg); + case OPTION_geometry: + opt.geom_enabled = 1; + opt.geom_flags = XParseGeometry(optarg, &opt.geom_x, + &opt.geom_y, &opt.geom_w, &opt.geom_h); break; - case 'y': - opt.thumb_w = atoi(optarg); + case OPTION_help: + show_usage(); break; - case 'E': - opt.thumb_h = atoi(optarg); + case OPTION_index: + opt.index = 1; + opt.index_info = estrdup("%n"); break; - case ')': - free(opt.menu_bg); - opt.menu_bg = estrdup(optarg); + case OPTION_output_dir: + opt.output_dir = estrdup(optarg); break; - case 'B': - free(opt.image_bg); - opt.image_bg = estrdup(optarg); + case OPTION_keep_http: + opt.keep_http = 1; break; - case 'D': - opt.slideshow_delay = atof(optarg); + case OPTION_list: + opt.list = 1; + opt.display = 0; break; - case 'R': - opt.reload = atoi(optarg); + case OPTION_montage: + opt.index = 1; break; - case 'a': - opt.alpha = 1; - opt.alpha_level = 255 - atoi(optarg); + case OPTION_reverse: + opt.reverse = 1; + break; + case OPTION_output: + opt.output = 1; + opt.output_file = estrdup(optarg); break; - case 'f': - opt.filelistfile = estrdup(optarg); + case OPTION_preload: + opt.preload = 1; break; - case '0': - opt.reload_button = atoi(optarg); + case OPTION_quiet: + opt.quiet = 1; break; - case '1': - opt.pan_button = atoi(optarg); + case OPTION_recursive: + opt.recursive = 1; break; - case '2': - opt.zoom_button = atoi(optarg); + case OPTION_stretch: + opt.stretch = 1; break; - case '3': - opt.menu_button = atoi(optarg); + case OPTION_thumbnails: + opt.thumbs = 1; + opt.index_info = estrdup("%n"); break; - case '4': - opt.prev_button = atoi(optarg); + case OPTION_unloadable: + opt.unloadables = 1; + opt.display = 0; break; - case '5': - opt.next_button = atoi(optarg); + case OPTION_version: + show_version(); break; - case '8': - opt.rotate_button = atoi(optarg); + case OPTION_multiwindow: + opt.multiwindow = 1; break; - case '9': - opt.blur_button = atoi(optarg); + case OPTION_borderless: + opt.borderless = 1; break; - case '|': - opt.start_list_at = atoi(optarg); + case OPTION_thumb_width: + opt.thumb_w = atoi(optarg); break; - case 't': - opt.thumbs = 1; - opt.index_show_name = 1; - opt.index_show_size = 0; - opt.index_show_dim = 0; + case OPTION_randomize: + opt.randomize = 1; + if (opt.sort != SORT_NONE) { + weprintf("commandline contains --sort and --randomize. " + "--sort has been unset"); + opt.sort = SORT_NONE; + } break; - case 'j': - opt.output_dir = estrdup(optarg); + case OPTION_start_at: + opt.start_list_at = estrdup(optarg); + break; + case OPTION_thumb_title: + opt.thumb_title = estrdup(optarg); break; - case 200: + case OPTION_bg_title: opt.bgmode = BG_MODE_TILE; - opt.output_file = estrdup(optarg); break; - case 201: + case OPTION_bg_center: opt.bgmode = BG_MODE_CENTER; - opt.output_file = estrdup(optarg); break; - case 202: + case OPTION_bg_scale: opt.bgmode = BG_MODE_SCALE; - opt.output_file = estrdup(optarg); break; - case 203: - opt.bgmode = BG_MODE_SEAMLESS; - opt.output_file = estrdup(optarg); - break; - case 218: - opt.bgmode = BG_MODE_FILL; - opt.output_file = estrdup(optarg); + case OPTION_zoom: + if (!strcmp("fill", optarg)) + opt.zoom_mode = ZOOM_MODE_FILL; + else if (!strcmp("max", optarg)) + opt.zoom_mode = ZOOM_MODE_MAX; + else + opt.default_zoom = atoi(optarg); break; - case 204: - free(opt.menu_style); - opt.menu_style = estrdup(optarg); + case OPTION_no_screen_clip: + opt.screen_clip = 0; break; - case 205: - opt.default_zoom = atoi(optarg); + case OPTION_index_info: + opt.index_info = estrdup(optarg); break; - case 206: - opt.screen_clip = atoi(optarg); - break; - case 207: - opt.menu_border = atoi(optarg); - break; - case 208: - opt.caption_path = estrdup(optarg); + case OPTION_magick_timeout: + weprintf("--magick-timeout is deprecated, please use --conversion-timeout instead"); + opt.conversion_timeout = atoi(optarg); break; - case 209: + case OPTION_action1: opt.actions[1] = estrdup(optarg); break; - case 210: + case OPTION_action2: opt.actions[2] = estrdup(optarg); break; - case 211: + case OPTION_action3: opt.actions[3] = estrdup(optarg); break; - case 212: + case OPTION_action4: opt.actions[4] = estrdup(optarg); break; - case 213: + case OPTION_action5: opt.actions[5] = estrdup(optarg); break; - case 214: + case OPTION_action6: opt.actions[6] = estrdup(optarg); break; - case 215: + case OPTION_action7: opt.actions[7] = estrdup(optarg); break; - case 216: + case OPTION_action8: opt.actions[8] = estrdup(optarg); break; - case 217: + case OPTION_action9: opt.actions[9] = estrdup(optarg); break; - case 220: - opt.no_jump_on_resort = 1; + case OPTION_bg_fill: + opt.bgmode = BG_MODE_FILL; break; - case 221: - opt.hide_pointer = 1; + case OPTION_bg_max: + opt.bgmode = BG_MODE_MAX; break; - case 222: - opt.draw_actions = 1; + case OPTION_no_jump_on_resort: + opt.jump_on_resort = 0; break; - case 223: - opt.cache_thumbnails = 1; + case OPTION_edit: + opt.edit = 1; break; - case 224: - opt.cycle_once = 1; +#ifdef HAVE_LIBEXIF + case OPTION_draw_exif: + opt.draw_exif = 1; break; - case 225: + case OPTION_auto_rotate: +#if defined(IMLIB2_VERSION_MAJOR) && defined(IMLIB2_VERSION_MINOR) && defined(IMLIB2_VERSION_MICRO) && (IMLIB2_VERSION_MAJOR > 1 || IMLIB2_VERSION_MINOR > 7 || IMLIB2_VERSION_MICRO >= 5) + weprintf("This feh release was built with Imlib2 version %d.%d.%d, which transparently adjusts for image orientation according to EXIF data.", IMLIB2_VERSION_MAJOR, IMLIB2_VERSION_MINOR, IMLIB2_VERSION_MICRO); + weprintf("--auto-rotate would rotate an already correctly oriented image, resulting in incorrect orientation. It has been disabled in this build. Rebuild feh with Imlib2 <1.7.5 to enable --auto-rotate."); +#else + opt.auto_rotate = 1; +#endif + break; +#endif + case OPTION_no_xinerama: opt.xinerama = 0; break; - case 226: - opt.no_rotate_ctrl_mask = 1; + case OPTION_draw_tinted: + opt.text_bg = TEXT_BG_TINTED; + break; + case OPTION_info: + opt.info_cmd = estrdup(optarg); + if (opt.info_cmd[0] == ';') { + opt.draw_info = 0; + opt.info_cmd++; + } else { + opt.draw_info = 1; + } + break; + case OPTION_tap_zones: + opt.tap_zones = 1; + break; + case OPTION_force_aliasing: + opt.force_aliasing = 1; + break; + case OPTION_no_fehbg: + opt.no_fehbg = 1; + break; + case OPTION_keep_zoom_vp: + opt.keep_zoom_vp = 1; + break; + case OPTION_scroll_step: + opt.scroll_step = atoi(optarg); + break; + case OPTION_xinerama_index: + opt.xinerama_index = atoi(optarg); + break; + case OPTION_insecure: + opt.insecure_ssl = 1; break; - case 227: - opt.no_blur_ctrl_mask = 1; + case OPTION_no_recursive: + opt.recursive = 0; break; - case 228: - opt.menu_ctrl_mask = 1; + case OPTION_cache_size: + opt.cache_size = atoi(optarg); + if (opt.cache_size < 0) + opt.cache_size = 0; + if (opt.cache_size > 2048) + opt.cache_size = 2048; break; - case 230: - opt.index_show_name = atoi(optarg); + case OPTION_on_last_slide: + if (!strcmp(optarg, "quit")) { + opt.on_last_slide = ON_LAST_SLIDE_QUIT; + } else if (!strcmp(optarg, "hold")) { + opt.on_last_slide = ON_LAST_SLIDE_HOLD; + } else if (!strcmp(optarg, "resume")) { + opt.on_last_slide = ON_LAST_SLIDE_RESUME; + } else { + weprintf("Unrecognized on-last-slide action \"%s\"." + "Supported actions: hold, resume, quit\n", optarg); + } + break; + case OPTION_conversion_timeout: + opt.conversion_timeout = atoi(optarg); + break; + case OPTION_version_sort: + opt.version_sort = 1; + break; + case OPTION_offset: + opt.offset_flags = XParseGeometry(optarg, &opt.offset_x, + &opt.offset_y, (unsigned int *)&discard, (unsigned int *)&discard); + break; +#ifdef HAVE_INOTIFY + case OPTION_auto_reload: + opt.auto_reload = 1; + break; +#endif + case OPTION_class: + opt.x11_class = estrdup(optarg); + break; + case OPTION_no_conversion_cache: + opt.use_conversion_cache = 0; break; - case 231: - opt.index_show_size = atoi(optarg); + case OPTION_window_id: + opt.x11_windowid = strtol(optarg, NULL, 0); break; - case 232: - opt.index_show_dim = atoi(optarg); + case OPTION_zoom_step: + opt.zoom_rate = atof(optarg); + if ((opt.zoom_rate <= 0)) { + weprintf("Zooming disabled due to --zoom-step=%f", opt.zoom_rate); + opt.zoom_rate = 1.0; + } else { + opt.zoom_rate = 1 + ((float)opt.zoom_rate / 100); + } break; default: break; @@ -745,494 +868,161 @@ static void feh_parse_option_array(int argc, char **argv) /* Now the leftovers, which must be files */ if (optind < argc) { while (optind < argc) { + if (opt.reload) + original_file_items = gib_list_add_front(original_file_items, estrdup(argv[optind])); /* If recursive is NOT set, but the only argument is a directory name, we grab all the files in there, but not subdirs */ add_file_to_filelist_recursively(argv[optind++], FILELIST_FIRST); } } + else if (finalrun && !opt.filelistfile && !opt.bgmode) { + /* + * if --start-at is a non-local URL (i.e., does not start with file:///), + * behave as if "feh URL" was called (there is no directory we can load) + */ + if (opt.start_list_at && path_is_url(opt.start_list_at) && (strlen(opt.start_list_at) <= 8 || strncmp(opt.start_list_at, "file:///", 8) != 0)) { + add_file_to_filelist_recursively(opt.start_list_at, FILELIST_FIRST); + /* + * Otherwise, make "feh --start-at dir/file.jpg" behave like + * "feh --start-at dir/file.jpg dir". + */ + } else if (opt.start_list_at && strrchr(opt.start_list_at, '/')) { + /* + * feh can't candle urlencoded path components ("some%20dir" etc). + * Use libcurl to unescape them if --start-at is file://... + */ + if (strlen(opt.start_list_at) > 8 && strncmp(opt.start_list_at, "file:///", 8) == 0) { + char *unescaped_path = feh_http_unescape(opt.start_list_at); + if (unescaped_path != NULL) { + free(opt.start_list_at); + opt.start_list_at = estrdup(unescaped_path + 7); + free(unescaped_path); + } else { + char *new_path = estrdup(opt.start_list_at + 7); + free(opt.start_list_at); + opt.start_list_at = new_path; + } + } + char *target_directory = estrdup(opt.start_list_at); + char *filename_start = strrchr(target_directory, '/'); + if (filename_start) { + *filename_start = '\0'; + } + add_file_to_filelist_recursively(target_directory, FILELIST_FIRST); + original_file_items = gib_list_add_front(original_file_items, estrdup(target_directory)); + free(target_directory); + } else { + add_file_to_filelist_recursively(".", FILELIST_FIRST); + } + } /* So that we can safely be called again */ - optind = 1; - D_RETURN_(4); + optind = 0; + return; } static void check_options(void) { - D_ENTER(4); - if ((opt.index + opt.collage) > 1) { - weprintf("you can't use collage mode and index mode together.\n" - " I'm going with index"); - opt.collage = 0; - } + int i; + char *endptr; - if (opt.full_screen && opt.multiwindow) { - weprintf("you shouldn't combine multiwindow mode with full-screen mode,\n" - " Multiwindow mode has been disabled."); - opt.multiwindow = 0; + for (i = 0; i < 10; i++) { + if (opt.actions[i] && !opt.hold_actions[i] && (opt.actions[i][0] == ';')) { + opt.hold_actions[i] = 1; + opt.actions[i] = opt.actions[i] + 1; + } + opt.action_titles[i] = opt.actions[i]; + if (opt.actions[i] && (opt.actions[i][0] == '[')) { + if (((endptr = strchr(opt.actions[i], ']')) != NULL) + && (opt.actions[i][1] != ' ')) { + opt.action_titles[i] = opt.actions[i] + 1; + opt.actions[i] = endptr + 1; + *endptr = 0; + } + } } - if (opt.list && (opt.multiwindow || opt.index || opt.collage)) { - weprintf("list mode can't be combined with other processing modes,\n" - " list mode disabled."); - opt.list = 0; + if (opt.full_screen && opt.multiwindow) { + eprintf("You cannot combine --fullscreen with --multiwindow"); } - if (opt.sort && opt.randomize) { - weprintf("You cant sort AND randomize the filelist...\n" - "randomize mode has been unset\n"); - opt.randomize = 0; + if (opt.list && (opt.multiwindow || opt.index)) { + eprintf("You cannot combine --list with other modes"); } if (opt.loadables && opt.unloadables) { - weprintf("You cant show loadables AND unloadables...\n" - "you might as well use ls ;)\n" - "loadables only will be shown\n"); - opt.unloadables = 0; + eprintf("You cannot combine --loadable with --unloadable"); } - if (opt.thumb_title && (!opt.thumbs)) { - weprintf("Doesn't make sense to set thumbnail title when not in\n" - "thumbnail mode.\n"); - free(opt.thumb_title); - opt.thumb_title = NULL; - } - D_RETURN_(4); + return; } -void show_version(void) +static void show_version(void) { - printf(PACKAGE " version " VERSION "\n"); + puts(PACKAGE " version " VERSION); + puts("Compile-time switches: " + +#ifdef HAVE_LIBCURL + "curl " +#endif + +#ifdef DEBUG + "debug " +#endif + +#ifdef HAVE_LIBEXIF + "exif " +#endif + +#ifdef HAVE_INOTIFY + "inotify " +#endif + +#ifdef INCLUDE_HELP + "help " +#endif + +#ifdef HAVE_LIBMAGIC + "magic " +#endif + +#if _FILE_OFFSET_BITS == 64 + "stat64 " +#endif + +#ifdef HAVE_STRVERSCMP + "verscmp " +#endif + +#ifdef HAVE_LIBXINERAMA + "xinerama " +#endif + + ); + exit(0); } void show_mini_usage(void) { - fprintf(stdout, PACKAGE " - No loadable images specified.\n" - "Use " PACKAGE " --help for detailed usage information\n"); - exit(0); + fputs(PACKAGE ": No loadable images specified.\n" +#ifdef INCLUDE_HELP + "See '" PACKAGE " --help' or 'man " PACKAGE "' for detailed usage information\n", +#else + "See 'man " PACKAGE "' for detailed usage information\n", +#endif + stderr); + exit(1); } -void show_usage(void) +static void show_usage(void) { - fprintf(stdout, -"Usage : " PACKAGE " [OPTIONS]... FILES...\n" -" Where a FILE is an image file or a directory.\n" -" Multiple files are supported.\n" -" Urls are supported. They must begin with http:// or ftp:// and you must\n" -" have wget installed to download the files for viewing.\n" -" Options can also be specified in the in the feh configuration file. See\n" -" man feh for more details\n" -" -h, --help display this help and exit\n" -" -v, --version output version information and exit\n" -" -V, --verbose output useful information, progress bars, etc\n" -" -q, --quiet Don't report non-fatal errors for failed loads\n" -" Verbose and quiet modes are not mutually exclusive,\n" -" the first controls informational messages, the\n" -" second only errors.\n" -" -T, --theme THEME Load options from config file with name THEME\n" -" see man feh for more info.\n" -" -_, --rcfile FILE Use FILE to parse themes and options from,\n" -" instead of the default ~/.fehrc, /etc/fehrc files.\n" -" -r, --recursive Recursively expand any directories in FILE to\n" -" the content of those directories. (Take it easy)\n" -" -z, --randomize When viewing multiple files in a slideshow,\n" -" randomise the file list before displaying\n" -" --no-jump-on-resort Don't jump to the first image when the filelist\n" -" is resorted.\n" -" -g, --geometry STRING Limit (and don't change) the window size. Takes\n" -" an X-style geometry string like 640x480.\n" -" Note that larger images will be zoomed out to fit\n" -" but you can see them at 1:1 by clicking the zoom\n" -" button.\n" -" -f, --filelist FILE This option is similar to the playlists used by\n" -" music software. If FILE exists, it will be read\n" -" for a list of files to load, in the order they\n" -" appear. The format is a list of image filenames,\n" -" absolute or relative to the current directory,\n" -" one filename per line.\n" -" If FILE doesn't exist, it will be created from the\n" -" internal filelist at the end of a viewing session.\n" -" This is best used to store the results of complex\n" -" sorts (-Spixels for example) for later viewing.\n" -" Any changes to the internal filelist (such as\n" -" deleting a file or it being pruned for being\n" -" unloadable) will be saved to FILE when feh exits.\n" -" You can add files to filelists by specifying them\n" -" on the commandline when also specifying the list.\n" -" -|, --start-at POSITION Start at POSITION in the filelist\n" -" -p, --preload Preload images. This doesn't mean hold them in\n" -" RAM, it means run through and eliminate unloadable\n" -" images first. Otherwise they will be removed as you\n" -" flick through.\n" -" -., --scale-down Automatically scale down images too big for the\n" -" screen. Currently only works with -P\n" -" -F, --full-screen Make the window fullscreen\n" -" -Z, --auto-zoom Zoom picture to screen size in fullscreen mode,\n" -" is affected by the option --stretch\n" -" --zoom PERCENT Zooms images by a PERCENT, when in full screen\n" -" mode or when window geometry is fixed. If combined\n" -" with --auto-zoom, zooming will be limited to the\n" -" the size.\n" -" -w, --multiwindow Disable slideshow mode. With this setting,\n" -" instead of opening multiple files in slideshow\n" -" mode, multiple windows will be opened.\n" -" -x, --borderless Create borderless windows\n" -" -d, --draw-filename Draw the filename at the top-left of the image.\n" -" -^, --title TITLE Use TITLE as the window title in slideshow mode.\n" -" -D, --slideshow-delay NUM For slideshow mode, specifies time delay (seconds,\n" -" can be a decimal) between automatically changing\n" -" slides.\n" -" --cycle-once exit feh after one loop through a slideshow\n" -" -R, --reload NUM Use this option to tell feh to reload an image\n" -" after NUM seconds. Useful for viewing webcams\n" -" via http, or even on your local machine.\n" -" -Q, --builtin Use builtin http grabber to grab remote files\n" -" instead of wget.\n" -" mechanism, useful if don't have wget.\n" -" -k, --keep-http When viewing files using http, feh normally\n" -" deletes the local copies after viewing, or,\n" -" if caching, on exit. This option prevents this\n" -" so that you get to keep the local copies.\n" -" They will be in the current working directory\n" -" with \"feh\" in the name.\n" -" --caption-path PATH Path to directory containing image captions.\n" -" This turns on caption viewing, and if captions\n" -" are found in PATH, which is relative to the\n" -" directory of each image, they are overlayed\n" -" on the displayed image.\n" -" e.g with caption path \"captions\", and viewing\n" -" image images/foo.jpg, caption will be looked for\n" -" as \"images/captions/foo.jpg.txt\"\n" -" -j, --output-dir Output directory for saved files. Really only\n" -" useful with the -k flag.\n" -" -G, --wget-timestamp When viewing http images with reload set (eg\n" -" webcams), try to only reload the image if the\n" -" remote file has changed.\n" -" -l, --list Don't display images. Analyse them and display an\n" -" 'ls' style listing. Useful in scripts hunt out\n" -" images of a certain size/resolution/type etc.\n" -" -L, --customlist FORMAT Use FORMAT as the format specifier for list\n" -" output. FORMAT is a printf-like string containing\n" -" image info specifiers. See FORMAT SPECIFIERS.\n" -" -U, --loadable Don't display images. Just print out their name\n" -" if imlib2 can successfully load them.\n" -" -u, --unloadable Don't display images. Just print out their name\n" -" if imlib2 can NOT successfully load them.\n" -" -S, --sort SORT_TYPE The file list may be sorted according to image\n" -" parameters. Allowed sort types are: name,\n" -" filename, width, height, pixels, size, format.\n" -" For sort modes other than name or filename, a\n" -" preload run will be necessary, causing a delay\n" -" proportional to the number of images in the list\n" -" -n, --reverse Reverse the sort order. Use this to invert the order\n" -" of the filelist. Eg to sort in reverse width order,\n" -" use -nSwidth\n" -" -A, --action ACTION Specify a string as an action to perform on the\n" -" image. In slideshow or multiwindow modes, the action\n" -" in list mode, or loadable|unloadable modes, the\n" -" action will be run for each file.\n" -" The action will be executed by /bin/sh. Use\n" -" format specifiers to refer to image info. See\n" -" FORMAT SPECIFIERS for examples\n" -" Eg. -A \"mv %%f ~/images/%%n\"\n" -" In slideshow mode, the next image will be shown\n" -" after running the command, in multiwindow mode,\n" -" the window will be closed.\n" -" --action1 ACTION These extra action options allow you to specify\n" -" --action2 ACTION multiple additional actions which can be invoked\n" -" ... using the appropriate number key 1-9\n" -" --action9 ACTION\n" -" --draw-actions Show the defined actions and what they do\n" -" -m, --montage Enable montage mode. Montage mode creates a new\n" -" image consisting of a grid of thumbnails of the\n" -" images specified using FILE... When montage mode\n" -" is selected, certain other options become\n" -" available. See MONTAGE MODE OPTIONS\n" -" -c, --collage Same as montage mode, but the thumbnails are\n" -" distributed randomly. You must specify width and\n" -" height or supply a background image or both\n" -" -i, --index Enable Index mode. Index mode is similar to\n" -" montage mode, and accepts the same options. It\n" -" creates an index print of thumbails, printing the\n" -" images name beneath each thumbnail. Index mode\n" -" enables certain other options, see INDEX MODE\n" -" OPTIONS\n" -" -t, --thumbnails As --index, but clicking an image will open it in\n" -" a new viewing window\n" -" --cache-thumbnails Enable thumbnail caching\n" -" -~, --thumb-title STRING Set window title for images opened from thumbnail mode.\n" -" Supports format specifiers, see there.\n" -" -I, --fullindex Same as index mode, but below each thumbnail you\n" -" get image name, size and dimensions\n" -" --index-name BOOL Show/Don't show filename in index/thumbnail mode\n" -" --index-size BOOL Show/Don't show filesize in index/thumbnail mode\n" -" --index-dim BOOL Show/Don't show dimensions in index/thumbnail mode\n" -" --bg-tile FILE Set FILE as tiled desktop background. Feh can\n" -" use enlightenment IPC if you are running it,\n" -" or will fall back to X methods.\n" -" Feh stores the commandline necessary to restore\n" -" the background you chose in ~/.fehbg. So to have\n" -" feh-set backgrounds restored when you restart X,\n" -" add the line \"eval `cat $HOME/.fehbg`\" to your\n" -" X startup script (e.g. ~/.xsession). Note that\n" -" you only need to do this for non E window\n" -" managers\n" -" --bg-center FILE Set FILE as centered desktop background\n" -" --bg-scale FILE Set FILE as scaled desktop background. This will\n" -" fill the whole background, but the images' aspect\n" -" ratio may not be preserved\n" -" --bg-fill FILE Like --bg-scale, but preserves aspect ratio by\n" -" zooming the image until it fits\n" -" --bg-seamless FILE Like --bg-tile, but with blurry corners\n" -" -C, --fontpath PATH Specify an extra directory to look in for fonts,\n" -" can be used multiple times to add multiple paths.\n" -" -M, --menu-font FONT Use FONT for the font in menus.\n" -" --menu-style FILE Use FILE as the style descriptor for menu text.\n" -" -), --menu-bg BG Use BG for the background image in menus.\n" -" --menu-border INT Specify number of pixels that define the menu\n" -" background's border. Borders are not stretched\n" -" when images are scaled.\n" -" -B, --image-bg STYLE Set background for transparent images and the like.\n" -" Accepted values: white, black, default\n" -" -N, --no-menus Don't load or show any menus.\n" -" -0, --reload-button B Use button B to reload the image (defaults to 0)\n" -" -1, --pan-button B Use button B pan the image (hold button down, move\n" -" the mouse to move the image around. Advancesto the\n" -" next image when the mouse is not moved (defaults to\n" -" 1, usually the left button).\n" -" -2, --zoom-button B Use button B to zoom the current image in any\n" -" mode (defaults to 2, usually the middle button).\n" -" -3, --menu-button B Use CTRL+Button B to activate the menu in any\n" -" mode. Set to 0 for any button. This option\n" -" is disabled if the -N or --no-menus option is set\n" -" (defaults to 3, usually the right button).\n" -" --menu-ctrl-mask Require CTRL+Button for menu activation in\n" -" any mode (default=off).\n" -" -4, --prev-button B Use button B to switch to the previous image\n" -" (defaults to 4, which usually is <mousewheel up>).\n" -" -5, --next-button B Use button B to switch to the next image\n" -" (defaults to 5, which usually is <mousewheel down>).\n" -" -8, --rotate-button B Use CTRL+Button B to rotate the current image in\n" -" any mode (default=2).\n" -" --no-rotate-ctrl-mask Don't require CTRL+Button for rotation in\n" -" any mode -- just use the button (default=off).\n" -" -9, --blur-button B Use CTRL+Button B to blur the current image in\n" -" any mode (default=1).\n" -" --no-blur-ctrl-mask Don't require CTRL+Button for blurring in\n" -" any mode -- just use the button (default=off).\n" -" --no-xinerama Disable Xinerama support. Only useful if\n" -" you have Xinerama compiled in.\n" -" --screen-clip [0|1] Enable/disable window clipping based on screen\n" -" size. WARNING: with this option disabled,\n" -" image windows could become very large, making\n" -" them unmanageable in certain window managers.\n" -" --hide-pointer In full screen mode, hide the X mouse pointer.\n" -" FORMAT SPECIFIERS\n" -" %%f image path/filename\n" -" %%n image name\n" -" %%s image size (bytes)\n" -" %%p image pixel size\n" -" %%w image width\n" -" %%h image height\n" -" %%t image format\n" -" %%P prints feh\n" -" %%v prints the version\n" -" %%m prints the mode (slideshow, multiwindow...)\n" -" %%l prints the total number of files in the filelist\n" -" %%u prints the current file number\n" -" \\n prints a newline\n" -" Eg. feh -A \"mv %%f ~/images/%%n\" *\n" -" MONTAGE MODE OPTIONS\n" -" -X, --ignore-aspect By default, the montage thumbnails will retain\n" -" their aspect ratios, while fitting in --thumb-width\n" -" and --thumb-height. This option will force them to\n" -" be the size set by --thumb-width and --thumb-height\n" -" This will prevent any whitespace in the final\n" -" montage\n" -" -s, --stretch Normally, if an image is smaller than the specified\n" -" thumbnail size, it will not be enlarged. If this\n" -" option is set, the image will be scaled up to fit\n" -" the thumbnail size. (Aspect ratio will be maintained\n" -" unless --ignore-aspect is specified)\n" -" -y, --thumb-width NUM Set thumbnail width in pixels\n" -" -E, --thumb-height NUM Set thumbnail height in pixels\n" -" Thumbnails default to 20x20 pixels\n" -" -W, --limit-width NUM Limit the width of the montage in pixels\n" -" -H, --limit-height NUM Limit the height of the montage in pixels\n" -" These options can be used together (to define the\n" -" image size exactly), or separately. If only one is\n" -" specified, theother is calculated from the number\n" -" of files specified and the size of the thumbnails.\n" -" The default is to limit width to 800 pixels and\n" -" calculate the height\n" -" -b, --bg FILE|trans Use FILE as a background for your montage. With\n" -" this option specified, the size of the montage will\n" -" default to the size of FILE if no size restrictions\n" -" are specified. Alternatively, if FILE is \"trans\",\n" -" make the background transparent.\n" -" -a, --alpha NUM When drawing thumbnails onto the background, apply\n" -" them with a transparency level of NUM (0-255).\n" -" -o, --output FILE Save the created montage to FILE\n" -" -O, --output-only FILE Just save the created montage to FILE\n" -" WITHOUT displaying it (use in scripts)\n" -" INDEX MODE OPTIONS\n" -" -e, --font FONT Use FONT to print the information under each\n" -" thumbnail. FONT should be defined in the form\n" -" fontname/size(points). eg -e myfont/12\n" -" -@, --title-font FONT Use FONT to print a title on the index, if no\n" -" font is specified, a title will not be printed\n" -" SLIDESHOW KEYS\n" -" The default mode for viewing mulitple images is Slideshow mode\n" -" When viewing a slideshow, the following keys may be used:\n" -" p, P, <BACKSPACE>, <LEFT> Goto previous slide\n" -" n, N, <SPACE>, <RIGHT> Goto next slide\n" -" r, R Reload image (good for webcams)\n" -" v, V Toggle fullscreen\n" -" m, M Show popup menu\n" -" c, C Caption entry mode. If --caption-path has been\n" -" specified, then this enables caption editing.\n" -" The caption will turn yellow and be editable,\n" -" hit enter to confirm and save the caption, or\n" -" hit escape to cancel and revert the caption.\n" -" w, W Size window to current image dimensions\n" -" h, H Pause the slideshow (only useful when using\n" -" timed reloading or image changes)\n" -" z, Z Jump to a random position in the current filelist\n" -" a, A Toggle action display (--draw-actions)\n" -" d, D Toggle filename display (--draw-filename)\n" -" s, S Save current image to unique filename\n" -" f, F Save current filelist to unique filename\n" -" <, > In place editing, rotate 90 degrees right/left\n" -" <HOME> Goto first slide\n" -" <END> Goto last slide\n" -" <ESCAPE> Quit the slideshow\n" -" +, = Increase reload delay\n" -" -, _ Decrease reload delay\n" -" <DELETE> Remove the currently viewed file from the filelist\n" -" <CTRL+DELETE> Delete the currently viewed file and remove it\n" -" from the filelist\n" -" x, X Close current window\n" -" q, Q Quit the slideshow\n" -" <KEYPAD LEFT> Move the image to the left\n" -" <KEYPAD RIGHT> Move the image to the right\n" -" <KEYPAD UP> Move the image up\n" -" <KEYPAD DOWN> Move the image down\n" -" <KEYPAD BEGIN> Antialias the image\n" -" <KEYPAD +> Zoom in\n" -" <KEYPAD -> Zoom out\n" -" <KEYPAD *> Zoom to 100%%\n" -" <KEYPAD /> Zoom to fit the window\n" -" <ENTER>,0 Run action specified by --action option\n" -" 1-9 Run action 1-9 specified by --action[1-9] options\n" -"\n" -" MOUSE ACTIONS\n" -" When viewing an image, a click of mouse button 1 moves to the next image\n" -" (slideshow mode only), a drag of mouse button 1 pans the image, if the\n" -" viewable window is smaller than the image, button 2 zooms (click and drag\n" -" left->right to zoom in, right->left to zoom out, click once to restore\n" -" 1x zoom), and mouse button 3 pans.\n" -" Ctrl+button 1 blurs or sharpens the image (drag left to blur and right to\n" -" sharpen). Ctrl+button 2 rotates the image around the center point.\n" -" Button 3 activates the context-sensitive menu. Buttons can be redefined\n" -" with the -1 through -9 (or --*-button) cmdline flags. All you people\n" -" with million button mice can remove the ctrl mask with the --no-*-ctrl-mask\n" -" options.\n" "\n" -"See 'man feh' for more detailed information\n" "\n" -"This program is free software see the file COPYING for licensing info.\n" -"Copyright Tom Gilbert (and various contributors) 1999-2003\n" -"Email bugs to <derf@chaosdorf.de>\n"); + fputs( +#ifdef INCLUDE_HELP +#include "help.inc" +#else + "See 'man " PACKAGE "'\n" +#endif + , stdout); exit(0); } - -void feh_create_default_config(char *rcfile) -{ - FILE *fp; - - D_ENTER(4); - - if ((fp = fopen(rcfile, "w")) == NULL) { - weprintf("Unable to create default config file %s\n", rcfile); - D_RETURN_(4); - } - - fprintf(fp, -"# Feh configuration file.\n" -"# Lines starting with # are comments. Don't use comments mid-line.\n" -"\n" -"# Feh expects to find this as ~/.fehrc or /etc/fehrc\n" -"# If both are available, ~/.fehrc will be used\n" -"\n" -"# Options are defined in theme_name/options pairs.\n" -"# Separate themename and options by whitespace.\n" -"\n" -"# There are two ways of specifying the theme. Either use feh -Tthemename,\n" -"# or use a symbolic link to feh with the name of the theme. eg\n" -"# ln -s `which feh` ~/bin/mkindex\n" -"# Now when you run 'mkindex', feh will load the config specified for the\n" -"# mkindex theme.\n" -"\n" -"# ======================\n" -"# Some examples of usage\n" -"# ======================\n" -"\n" -"# Set the default feh options to be recursive and verbose\n" -"# feh -rV\n" -"\n" -"# Multiple options can of course be used. They should all be on one line\n" -"# imagemap -rV --quiet -W 400 -H 300 --thumb-width 40 --thumb-height 30\n" -"\n" -"# ====================\n" -"# A few default themes\n" -"# ====================\n" -"\n" -"# Webcam mode, simply specify the url(s).\n" -"# e.g. feh -Twebcam http://cam1 http://cam2\n" -"webcam --multiwindow --reload 20\n" -"\n" -"# Create an index of the current directory. This version uses . as the\n" -"# current dir, so you don't even need any commandline arguments.\n" -"mkindex -iVO index.jpg .\n" -"\n" -"# More ambitious version...\n" -"imgidx -iVO .fehindex.jpg --limit-width 1200 --thumb-width 90 --thumb-height 90 .\n" -"\n" -"# Show a presentation\n" -"present --full-screen --sort name\n" -"\n" -"# Booth mode ;-)\n" -"booth --full-screen --hide-pointer --slideshow-delay 20\n" -"\n" -"# Screw xscreensaver, use feh =)\n" -"screensave --full-screen --randomize --slideshow-delay 5\n" -"\n" -"# Add <img> tags to your html with ease :-)\n" -"newimg -q -L \"<img src=\\\"%%f\\\" alt=\\\"%%n\\\" border=\\\"0\\\" " -"width=\\\"%%w\\\" height=\\\"%%h\\\">\"\n" -"\n" -"# Different menus\n" -"chrome --menu-bg " -PREFIX "/share/feh/images/menubg_chrome.png\n" -"brushed --menu-bg " -PREFIX "/share/feh/images/menubg_brushed.png\n" -"pastel --menu-bg " -PREFIX "/share/feh/images/menubg_pastel.png\n" -"aluminium --menu-bg " -PREFIX "/share/feh/images/menubg_aluminium.png\n" -"wood --menu-bg " -PREFIX "/share/feh/images/menubg_wood.png\n" -"aqua --menu-bg " -PREFIX "/share/feh/images/menubg_aqua.png\n" -"sky --menu-bg " -PREFIX "/share/feh/images/menubg_sky.png\n" -"orange --menu-bg " -PREFIX "/share/feh/images/menubg_orange.png\n" -"light --menu-bg " -PREFIX "/share/feh/images/menubg_light.png\n" -"black --menu-bg " -PREFIX "/share/feh/images/menubg_black.png" -" --menu-style " -PREFIX "/share/feh/fonts/black.style\n"); - fclose(fp); - - D_RETURN_(4); -} |