doc/main_window_menus.html

   1 <?xml version="1.0" encoding="iso-8859-1"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
   3     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   4
   5 <html xmlns="http://www.w3.org/1999/xhtml">
   6 <head>
   7   <meta http-equiv="CONTENT-TYPE" content="text/html; charset=iso-8859-1" />
   8
   9   <title>Menus - Geeqie User Manual</title>
  10   <link rel="stylesheet" type="text/css" href="style.css" media="all" />
  11   <link rel="stylesheet" type="text/css" href="style_screen.css" media="screen" />
  12   <link rel="stylesheet" type="text/css" href="style_print.css" media="print" />
  13 </head>
  14
  15 <body lang="en-US" dir="ltr" xml:lang="en-US">
  16   <div class="navtop">
  17     <table width="100%" border="0" cellpadding="4" cellspacing="0">
  18       <col id="navtop_col1" width="33%"></col>
  19       <col id="navtop_col2" width="33%"></col>
  20       <col id="navtop_col3" width="33%"></col>
  21
  22         <tr>
  23           <th>
  24             <p class="previous"><a href="main_window_navigation.html">Previous</a>
  25             </p>
  26           </th>
  27
  28           <th>
  29             <p class="navtop_title">Menus &ndash; Main Window</p>
  30           </th>
  31
  32           <th>
  33             <p class="next"><a href="main_window_layout.html">Next</a>
  34             </p>
  35           </th>
  36         </tr>
  37     </table>
  38   </div>
  39
  40   <hr />
  41
  42   <h1>Menus</h1>
  43
  44   <p>This section describes the functions of each item on the menu bar in the Geeqie main window.</p>
  45
  46   <h2>File Menu</h2>
  47
  48   <dl class="menu_desc">
  49   <dt>New window</dt><dd>Opens a new main window, with the initial path set to the current folder.</dd>
  50
  51   <dt>New collection</dt><dd>Opens a new collection window, the new collection will be empty.</dd>
  52
  53   <dt>Open collection</dt><dd>Displays a dialog to open a collection stored on disk, the selected collection will then appear in a new window.</dd>
  54
  55   <dt>Open recent</dt><dd>This menu item lists the recently active collections, selecting an item from the list will open that collection in a new window. The most recent item will appear at the top of the list. Maximum number of entries can be modified through <a href="options_advanced.html" class="option_name">Open recent list maximum size</a> option.</dd>
  56
  57   <dt>Search...</dt><dd>Opens a new Search window.</dd>
  58
  59   <dt>Find duplicates...</dt><dd>Opens a new Find Duplicates window.</dd>
  60
  61   <dt>Pan view</dt><dd>Opens the pan view window.</dd>
  62
  63   <dt>Print..</dt><dd>Opens a print dialog.</dd>
  64
  65   <dt>New folder...</dt><dd>Creates a new folder in the current path.</dd>
  66
  67   <dt>Copy...</dt><dd>Opens a dialog to select a destination to copy the currently selected files.</dd>
  68
  69   <dt>Move...</dt><dd>Opens a dialog to select a destination to move currently selected files.</dd>
  70
  71   <dt>Rename...</dt><dd>Renames the current file selection.</dd>
  72
  73   <dt>Delete...</dt><dd>Deletes the current file selection.</dd>
  74
  75   <dt>Copy path</dt><dd>Copy selected item path to clipboard. Enabled by <a href="options_advanced.html" class="option_name">Show "Copy path" menu item</a> option.</dd>
  76
  77   <dt>Close window</dt><dd>Closes the window containing the menu, if the window is the last main window Geeqie will quit.</dd>
  78
  79
  80   <dt>Quit</dt><dd>Quits the Geeqie application, if collections have been changed but not saved, the user will be prompted for confirmation.</dd>
  81   </dl>
  82
  83   <h2>Go menu</h2>
  84   <dl class="menu_desc">
  85
  86   <dt>First Image</dt><dd>Goes tothe first image</dd>
  87   <dt>Previous Image</dt><dd>Goes to the previous image</dd>
  88   <dt>Next Image</dt><dd>Goes to the next image</dd>
  89   <dt>Last Image</dt><dd>Goes to the last image</dd>
  90
  91   </dl>
  92
  93   <h2>Select menu</h2>
  94   <dl class="menu_desc">
  95   <dt>Select all</dt><dd>Selects all files in the current list</dd>
  96   <dt>Select none</dt><dd>Deselects all files</dd>
  97   <dt>Invert Selection</dt><dd>Inverts current selection</dd>
  98   <dt>Show marks</dt><dd>Displays marks in the file list</dd>
  99   <dt>Mark n</dt><dd>Opens submenu for manipulating mark n
 100         <dl class="menu_desc_sublevel1">
 101         <dt>Toggle mark n</dt><dd>Set or unset mark n on selected files</dd>
 102         <dt>Set mark n</dt><dd>Set mark n on selected files</dd>
 103         <dt>Reset mark n</dt><dd>Unset mark n on selected files</dd>
 104         <dt>Select mark n</dt><dd>Selects all files having mark n set</dd>
 105         <dt>Add mark n</dt><dd>Adds files having mark n set to selection</dd>
 106         <dt>Intersection with mark n</dt><dd>Intersects current selection and mark n</dd>
 107         <dt>Unselect mark n</dt><dd>Removes files having mark n set from current selection</dd>
 108         </dl>
 109   </dd>
 110  </dl>
 111
 112
 113   <h2>Edit menu</h2>
 114
 115   <dl class="menu_desc">
 116
 117   <dt>in &lt;command name&gt;...</dt><dd>This will execute the external command associated with &lt;command name&gt;, these can be changed edited on the <a href="options_editor_commands.html">Editors tab</a> of the Option dialog.</dd>
 118
 119   <dt>Adjust</dt><dd>
 120           <dl class="menu_desc_sublevel1">
 121           <dt>Rotate clockwise</dt><dd>Rotates the current image clockwise 90 degrees, does not modify the file on disk.</dd>
 122
 123           <dt>Rotate counterclockwise</dt><dd>Rotates the current image counterclockwise 90 degrees, does not modify the file on disk.</dd>
 124
 125           <dt>Rotate 180</dt><dd>Rotates the current image 180 degrees, does not modify the file on disk.</dd>
 126
 127           <dt>Mirror</dt><dd>Swaps the left and right sides of the image so that the result is similar to that of looking at the image in a mirror, does not modify the file on disk.</dd>
 128
 129           <dt>Flip</dt><dd>Swaps the top and bottom sides of the image, does not modify the file on disk.</dd>
 130
 131           <dt>Toggle grayscale</dt><dd>Shows images converted to grayscale, does not modify files on disk. It is applied to all files until toggled again.</dd>
 132
 133           <dt>Original state</dt><dd>Removes all effects applied through the Adjust menu, reverting image to its original state.</dd>
 134
 135           </dl>
 136   </dd>
 137
 138   <dt>Properties</dt><dd>Opens a Properties Window for the currently selected files.</dd>
 139
 140   <dt>Preferences...</dt><dd>Opens the <a href="options.html">Preferences Dialog</a> for changing of user preferences.</dd>
 141
 142   <dt>Thumbnail maintenance</dt><dd>Opens a dialog with utilities to manage cached thumbnails and keywords data.</dd>
 143
 144   <dt>Set as wallpaper</dt><dd>Renders the current image to the root window (desktop). The resulting image will be tiled to fit the root window if zoom is not set to <em>fit to window</em>; when zoom is set to <em>fit to window</em>, the image will be scaled to fill the root window.</dd>
 145   </dl>
 146
 147   <h2>View menu</h2>
 148
 149   <dl class="menu_desc">
 150
 151   <dt>View in new window</dt><dd>Opens selected image in its own window</dd>
 152
 153   <dt>Zoom</dt><dd>
 154           <dl class="menu_desc_sublevel1">
 155           <dt>Zoom in</dt><dd>Increases the zoom by one increment, resulting in a larger image.</dd>
 156
 157           <dt>Zoom out</dt><dd>Decreases the zoom by one increment, resulting in a smaller image.</dd>
 158
 159           <dt>Zoom to fit</dt><dd>Automatically adjusts the zoom so that the image will fit within the display pane. The effect on images with an original size smaller than the display pane can be changed with the <span class="option_name">Allow enlargement of image for zoom to fit</span> option located on the <a href="options_image.html">Image tab</a> of the preferences dialog.</dd>
 160
 161           <dt>Fit Horizontally</dt><dd>Adjusts the zoom so image height fit within the display pane.</dd>
 162
 163           <dt>Fit Vertically</dt><dd>Adjusts the zoom so image width fit within the display pane.</dd>
 164
 165           <dt>Zoom n:m</dt><dd>Set zoom to the n:m value. 1:1 is the original size of the image. When n is greater than m, zoom in occurs else zoom out occurs.</dd>
 166           </dl>
 167   </dd>
 168
 169   <dt>Connected zoom</dt><dd>Actions in this menu are identical to those in Zoom menu, but apply to all images displayed in splitted view.</dd>
 170
 171   <dt>Split</dt><dd>
 172         <dl class="menu_desc_sublevel1">
 173         <dt>Horizontal</dt><dd>Splits main image view in two horizontal panes.</dd>
 174         <dt>Vertical</dt><dd>Splits main image view in two vertical panes.</dd>
 175         <dt>Quad</dt><dd>Splits main image view in four panes.</dd>
 176         <dt>Single</dt><dd>Reverts to normal view mode (one image).</dd>
 177         </dl>
 178   </dd>
 179
 180   <dt>Thumbnails</dt><dd>Toggles the display of image thumbnails in the file list, this item is not available when the file list is in icon view mode. A check appears next to this item when thumbnails are enabled.</dd>
 181
 182   <dt>List</dt><dd>Changes the file list to display files in list format.</dd>
 183
 184   <dt>Icons</dt><dd>Changes the file list to display files as icons.</dd>
 185
 186   <dt>View Directory as</dt><dd>
 187         <dl class="menu_desc_sublevel1">
 188         <dt>List</dt><dd>Set the folder view mode to list.</dd>
 189         <dt>Tree</dt><dd>Set the folder view mode to tree.</dd>
 190         </dl>
 191   </dd>
 192
 193   <dt>Image Overlay</dt><dd>Displays Image Overlay information box (OSD), use twice to add histogram to it.</dd>
 194   <dt>Histogram channels</dt><dd>Switches channels displayed in the histogram (red, green, blue, RGB, value, maximum value).</dd>
 195   <dt>Histogram log mode</dt><dd>Toggles between linear and logarithmical histogram.</dd>
 196
 197   <dt>Full screen</dt><dd>Toggles the full screen window display.</dd>
 198
 199   <dt>Float file list</dt><dd>Toggles the location of the menu bar, tool bar, status bar, and file lists between the main window and a second window. A check appears next to this item when the location is the second window.</dd>
 200
 201   <dt>Hide file list</dt><dd>Toggles visibility of the menu bar, tool bar, status bar, and file lists.</dd>
 202
 203   <dt>Hide toolbar</dt><dd>Toggles visibility of the tool bar. A check appears next to this item when the tool bar is not visible.</dd>
 204
 205   <dt>Keywords</dt><dd>Toggles display of the Keywords sidebar.</dd>
 206
 207   <dt>Exif data</dt><dd>Toggles display of the EXIF sidebar.</dd>
 208
 209   <dt>Sort manager</dt><dd>Toggles display of the Sort Manager sidebar.</dd>
 210
 211   <dt>Toggle slideshow</dt><dd>Begins or ends a slide show, the slide show status is displayed in the status bar.</dd>
 212
 213   <dt>Pause slideshow</dt><dd>Pauses a slide show, the slide show status is displayed in the status bar.</dd>
 214
 215   <dt>Refresh</dt><dd>Updates the contents of the folder and file lists to match what is currently on disk, the current image will also be reread from disk.</dd>
 216   </dl>
 217
 218   <h2>Help menu</h2>
 219
 220   <dl class="menu_desc">
 221
 222   <dt>Contents</dt><dd>Opens the Geeqie user manual in a new browser window.</dd>
 223
 224   <dt>Keyboard shortcuts</dt><dd>Displays a window listing the default keyboard shortcuts.</dd>
 225
 226   <dt>Release notes</dt><dd>Displays a window containing the release notes for the version of Geeqie in use.</dd>
 227
 228   <dt>About</dt><dd>Opens a window containing the Geeqie version, credits, website, and email contact information.</dd>
 229
 230   <dt>Log window</dt><dd>Opens the log window, mostly used for debugging purposes.</dd>
 231
 232   </dl>
 233   <h2>Tear off menus</h2>
 234
 235   <p>Menus can be permanently displayed by selecting the dotted line item at the top of each menu category. A tear off menu will behave the same as an ordinary window. To close a tear off menu, select the dotted line item at the top of the menu.</p>
 236
 237   <h2>Keyboard shortcuts</h2>
 238
 239   <p>The keyboard sequence associated to each menu entry is listed within the main window menu bar. For reference, the complete list of default keyboard shortcuts can be found in section <a href="reference_keyboard_shortcuts.html">Keyboard Shortcuts</a>.</p>
 240
 241   <h2>Changing the main window menu bar keyboard shortcuts</h2>
 242
 243   <p>The keyboard shortcuts associated with the menu bar items can be changed by editing the accels file located in the Geeqie configuration folder <b>while the Geeqie application is not running</b>:</p>
 244
 245   <p><code>($HOME)/.geeqie/accels</code>
 246   </p>
 247
 248   <p>To change a menu item, first find the line corresponding to the menu item to change. For example the File menu Quit line originally looks like this:</p>
 249
 250   <p><code>; (gtk_accel_path "&lt;main&gt;/File/Quit" "&lt;Control&gt;q")</code>
 251   </p>
 252
 253   <p>To change this menu's keyboard shortcut, first remove the leading semicolon (;), removing the semicolon will tell Geeqie that this menu item has been customized. Then change the keyboard shortcut defined by the text in quotes at the end of the line, be sure to only change the text within the quotes; in this case the text &ldquo;&lt;control&gt;q&rdquo;. For example changing the shortcut associated with Quit to the <span class="key">Q</span> key will result in this line:</p>
 254
 255   <p><code>(gtk_accel_path "&lt;main&gt;/File/Quit" "q")</code>
 256   </p>
 257
 258   <p>Please note the removed semicolon and the change of &ldquo;&lt;control&gt;q&rdquo; to &ldquo;q&rdquo;, be careful not to change any of the other text on the line or Geeqie may ignore the customization. The keyboard modifiers and their respective text are listed below:</p>
 259
 260   <div class="accels_file_syntax">
 261           <table width="60%" border="0" cellpadding="4" cellspacing="0" rules="rows">
 262           <col id="accels_file_syntax_col1" width="50%"></col>
 263           <col id="accels_file_syntax_col2" width="50%"></col>
 264
 265           <thead>
 266             <tr>
 267               <td>
 268                 <p>Key</p>
 269               </td>
 270
 271               <td>
 272                 <p>Text to use in accels file</p>
 273               </td>
 274             </tr>
 275           </thead>
 276
 277           <tbody>
 278             <tr>
 279               <td>
 280                 <p><span class="key">Shift</span></p>
 281               </td>
 282
 283               <td>
 284                 <p>&lt;shift&gt;</p>
 285               </td>
 286             </tr>
 287
 288             <tr>
 289               <td>
 290                 <p><span class="key">Ctrl</span></p>
 291               </td>
 292
 293               <td>
 294                 <p>&lt;control&gt;</p>
 295               </td>
 296             </tr>
 297
 298             <tr>
 299               <td>
 300                 <p><span class="key">Alt</span></p>
 301               </td>
 302
 303               <td>
 304                 <p>&lt;alt&gt;</p>
 305               </td>
 306             </tr>
 307           </tbody>
 308           </table>
 309   </div>
 310
 311   <p>Modifiers can be combined, for example in the exit line above, the text would be &ldquo;&lt;control&gt;&lt;shift&gt;q&rdquo; to set the exit shortcut to <span class="key">Ctrl</span> + <span class="key">Shift</span> + <span class="key">Q</span>.</p>
 312
 313   <hr id="bottomseparator" />
 314
 315   <div class="navbottom">
 316     <table width="100%" border="0" cellpadding="4" cellspacing="0">
 317       <col id="navbottom_col1" width="33%"></col>
 318       <col id="navbottom_col2" width="33%"></col>
 319       <col id="navbottom_col3" width="33%"></col>
 320
 321         <tr>
 322           <th>
 323             <p class="previous"><a href="main_window_navigation.html">Previous</a>
 324             </p>
 325           </th>
 326
 327           <th>
 328             <p class="navbottom_title"><a href="index.html">Contents</a>
 329             </p>
 330           </th>
 331
 332           <th>
 333             <p class="next"><a href="main_window_layout.html">Next</a>
 334             </p>
 335           </th>
 336         </tr>
 337
 338     </table>
 339   </div>
 340
 341   <div class="footer">Geeqie User Manual</div>
 342   <div class="bottomspacer">&nbsp;</div>
 343 </body>
 344 </html>