Skip to content
Snippets Groups Projects
options.c 43.8 KiB
Newer Older
" -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"
"     --no-screen-clip      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"
" -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"
" INDEX MODE OPTIONS\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");
static void feh_create_default_config(char *rcfile)
	FILE *fp;

	if ((fp = fopen(rcfile, "w")) == NULL) {
		weprintf("Unable to create default config file %s\n", rcfile);
"# 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");