# HG changeset patch # User zas_ # Date 1226358350 0 # Node ID e09f504d7f1131cde7f07c0a0b6abba8bcebc7d0 # Parent 697b0761c30dd6c4444935f7b6c173f27850b9e1 Update documentation a bit: General, Image, Windows, Filtering, Editors and a part of Advanced (Image Overlay) options. diff -r 697b0761c30d -r e09f504d7f11 doc/options_advanced.html --- a/doc/options_advanced.html Mon Nov 10 21:33:38 2008 +0000 +++ b/doc/options_advanced.html Mon Nov 10 23:05:50 2008 +0000 @@ -57,6 +57,107 @@
This option will execute xscreensaver-command --deactivate once per minute to avoid the screen saver from activating when Geeqie is displayed full screen.
Enable this to have the image overlay info displayed by default
Overlay info is customizable through this template
+Overlay info format string syntax is: %tag[:max_length][:extra]%
To access exif data use the exif name, for example: %Exif.Photo.DateTimeOriginal%
to get the date of the original shot
Pre-formatted exif data is also available:
+ + +
+ You can limit the length of displayed data using :number notation:
+ %formatted.Camera:20%
will truncate the displayed data to 20 characters
+ and will add 3 dots at the end to denote the truncation.
+ If two or more variables are connected with the |-sign, it prints available
+ variables with a separator:
+ %formatted.ShutterSpeed%|%formatted.ISOSpeedRating%|%formatted.FocalLength%
+ could show:
+ "1/20s - 400 - 80 mm"
+ or
+ "1/200 - 80 mm" if there's no ISO information in the Exif data.
+
+ If a line is empty, it is removed. + This allows to add lines that totally disappear when no data is available. +
+ ++ Extra string uses special character '*' to mark the position of the data. + If no '*' is present, then extra string is just appended to data. + Any "\n" is replaced by a newline on display. + Pango mark up is accepted in left and right parts. + If data is empty, nothing will be displayed. +
+ +Examples:
+%name:<i>*</i>\n%
%size:\n%
%formatted.ISOSpeedRating:ISO *%
Collection <b>*</b>\n
Show syntax help
Restore default image overlay template
This field is used to represent the command in the menus of Geeqie, it is intended to describe the application or function that results from executing the command in the Command Line field.
This field is used to represent the command in the menus of Geeqie, it is intended to describe the application or function that results from executing the command in the Command Line field.
+External command Copy/Move/Rename/Delete/New Folder allows to specify commands to use for these operations. When set, internal operations will be disabled and these commands used instead.
+This field is the command to execute. Several macros are available to position image file names within the command. If no macro is specified, the behavior will be to append the filenames onto the end of the command (the result will be the same as “command %f”).
- +
+ %% + |
+
+
+ This will be replaced by one '%'. This is the way to escape '%'. + |
+
+ %d + |
+
+
+ This only makes sense for external commands like copy or move as this is replaced by the destination. + |
+
Enables the display of hidden files and folders, also known as dot files.
Enables the display of the current directory as a dot in the directories views. It may be useful for some drag'n'drop operations.
Files and folders are sorted such that upper case letters occur before lower case letters.
@@ -58,6 +61,10 @@This field defines which extensions will lead to file grouping. Each extension should be separated by a semi-colon and should include the starting dot.
+Grouped files will appear as one in file views. For example, it is useful when browsing directories containing two files for the same image (as raw+jpeg files generated by some cameras).
+This list contains the image formats that are understood by Geeqie. To disable a specific file type from being displayed, uncheck it's corresponding checkbox. Filters can be edited by first selecting the line containing the item to be changed, then clicking the filter or description field, making any changes, then pressing enter; press escape to cancel an active edit. The format for the filter field is a semicolon (;) seperated list of extensions, extensions must include the period (.).
diff -r 697b0761c30d -r e09f504d7f11 doc/options_general.html --- a/doc/options_general.html Mon Nov 10 21:33:38 2008 +0000 +++ b/doc/options_general.html Mon Nov 10 23:05:50 2008 +0000 @@ -44,12 +44,16 @@Enabling this will cause Geeqie to initially open to the specified folder.
Activate this button to change the setting to the current folder.
When checked, Geeqie will recall the last path used on startup.
When enabled, Geeqie attempts to store cached thumbnails closer to the source image. This way multiple users can benefit from a single cache, thereby reducing wasted disk space. The resulting location is the source image's folder, in a sub folder with the name .thumbnails. When the image source folder cannot be written, Geeqie falls back to saving the thumbnail in the user's home folder.
This will speed up thumbnails generation in some cases, but may reduce the quality
Geeqie will extract thumbnail from EXIF data if available instead of generating one. This will speed up thumbnails generation but EXIF thumbnail may be not in sync with the image if it was modified by a tool which didn't take care of the thumbnail data.
xvpics is a common thumbnail caching format used by several applications. Thumbnails are stored locally to the source image in a sub folder with the name .xvpics. Enabling this option will allow Geeqie to read thumbnails saved in the xvpics format.
Note: Support for xvpics is read only, Geeqie can not generate thumbnails in this format.
Enable this to allow Geeqie to increase the image size for images that are smaller than the current view area when the zoom is set to “Fit to Window”.
This percentage will affect the size of the image when Fit image to window is set, instead of using 100% of the window, it will use the specified percentage. It allows to keep a border around the image (values lower than 100%) or to auto zoom the image (values greater than 100%). It affects fullscreen mode too.
Adjusts the step size when zooming in or out on an image. This value corresponds to the percentage of the original image.
This controls the scroll initial position when changing the displayed image.
+ +Enable this to draw the image background (the area around the image) in black.
Enable this to draw the image background (the area around the image) in the specified color.
Use this color chooser to define the color to use as image background.
Note: You may use Limit image size when autofitting option to keep a border around the image in fullscreen mode.
This will maintain the main window size and position between Geeqie sessions.
This will maintain windows size and position between Geeqie sessions.
This will maintain the tool window state between Geeqie sessions.
The Geeqie main window consists of three main panes, their position and order can be changed here. The first four selections represent the basic layout of the main window. The numbers within each selection represent the order of the pane content. The order of the content can be changed by dragging the Tools, Files, or Image with the mouse to the desired location within the list.
+The Geeqie main window consists of three main panes, their position and order can be changed here. The first four selections represent the basic layout of the main window. The numbers within each selection represent the order of the pane content.
+The order of the content can be changed by dragging the Tools, Files, or Image with the mouse to the desired location within the list.
To update the image display in the event that the source file has changed, press the R key.
-A small overlay can be turned on and off by pressing the I key. This overlay displays the image file name, dimensions, file date, and file size. The count of the current image and of all images contained by the window are also displayed in parenthesis. When the window is linked to a collection, the collection title will also appear in the overlay in italics above the file name.
+An histogram is displayed if I key is pressed twice, K key will modify the data displayed, and J key will toggle linear or logarithmic histogram.
+Overlay info is customizable through Image Overlay Template option in Advanced tab in Preferences dialog.