Skip to content
Snippets Groups Projects
options.c 43.7 KiB
Newer Older
		" -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"
		" 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 <feh_sucks@linuxbrit.co.uk>\n");
	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 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"
		"# Here I set some useful themes for you to try out\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);